@scriptc/compiler 0.0.33 → 0.0.35

package/dist/frontend/input-tracker.js

@@ -0,0 +1,380 @@
+import { createHash } from "node:crypto";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+export function frontendSourceDigest(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
+function pathKind(path) {
+    try {
+        const info = statSync(path);
+        return info.isFile()
+            ? "file"
+            : info.isDirectory()
+                ? "directory"
+                : "other";
+    }
+    catch {
+        return "missing";
+    }
+}
+const activeTracker = new AsyncLocalStorage();
+export class FrontendInputTracker {
+    probes = new Map();
+    stable = true;
+    run(fn) {
+        const parent = activeTracker.getStore();
+        if (parent === undefined || parent === this)
+            return activeTracker.run(this, fn);
+        return activeTracker.run(this, () => {
+            const result = fn();
+            for (const probe of this.probes.values())
+                parent.record(probe);
+            return result;
+        });
+    }
+    record(probe) {
+        const key = `${probe.op}\0${probe.path}`;
+        const previous = this.probes.get(key);
+        if (previous !== undefined && JSON.stringify(previous) !== JSON.stringify(probe)) {
+            // An input changed while this frontend was running.  The build may
+            // still finish normally, but it is not safe to publish as a cache key.
+            this.stable = false;
+        }
+        this.probes.set(key, probe);
+        if (probe.op === "file") {
+            // A successful content read supersedes earlier existence probes for the
+            // same path only when they also observed a file. A missing/non-file
+            // answer followed by a successful read means the input changed during
+            // the frontend and the mixed observation must never be published.
+            const previousKind = this.probes.get(`kind\0${probe.path}`);
+            if (previousKind?.op === "kind" && previousKind.kind !== "file")
+                this.stable = false;
+            this.probes.delete(`kind\0${probe.path}`);
+            const failedRead = this.probes.get(`read-error\0${probe.path}`);
+            if (failedRead !== undefined)
+                this.stable = false;
+            this.probes.delete(`read-error\0${probe.path}`);
+        }
+        else if (probe.op === "read-error") {
+            // A path can remain a regular file while its readability changes.
+            // Keep the failed operation itself, rather than reducing it to a kind
+            // probe, so a permission/ACL repair invalidates the cached frontend.
+            const successfulRead = this.probes.get(`file\0${probe.path}`);
+            if (successfulRead !== undefined)
+                this.stable = false;
+            this.probes.delete(`file\0${probe.path}`);
+        }
+    }
+    snapshot() {
+        return {
+            version: 1,
+            probes: [...this.probes.values()].sort((a, b) => a.path === b.path ? a.op.localeCompare(b.op) : a.path.localeCompare(b.path)),
+            stable: this.stable,
+        };
+    }
+}
+export function frontendInputTrackingActive() {
+    return activeTracker.getStore() !== undefined;
+}
+function record(probe) {
+    activeTracker.getStore()?.record(probe);
+}
+export function trackedReadFile(path) {
+    path = resolve(path);
+    try {
+        const text = readFileSync(path, "utf8");
+        record({ op: "file", path, digest: frontendSourceDigest(text) });
+        return text;
+    }
+    catch {
+        record({ op: "read-error", path });
+        return null;
+    }
+}
+export function trackedFileExists(path) {
+    path = resolve(path);
+    const kind = pathKind(path);
+    record({ op: "kind", path, kind });
+    return kind === "file";
+}
+export function trackedDirectoryExists(path) {
+    path = resolve(path);
+    const kind = pathKind(path);
+    record({ op: "kind", path, kind });
+    return kind === "directory";
+}
+export function trackedExists(path) {
+    path = resolve(path);
+    const kind = pathKind(path);
+    record({ op: "kind", path, kind });
+    return kind !== "missing";
+}
+export function trackedRealpath(path) {
+    path = resolve(path);
+    try {
+        const target = realpathSync(path);
+        record({ op: "realpath", path, target });
+        return target;
+    }
+    catch {
+        record({ op: "realpath", path, target: null });
+        return null;
+    }
+}
+export function trackedAccessibleEntries(path) {
+    path = resolve(path);
+    try {
+        const files = [];
+        const directories = [];
+        for (const entry of readdirSync(path, { withFileTypes: true })) {
+            const kind = entry.isSymbolicLink() ? pathKind(resolve(path, entry.name)) : null;
+            if (entry.isFile() || kind === "file")
+                files.push(entry.name);
+            if (entry.isDirectory() || kind === "directory")
+                directories.push(entry.name);
+        }
+        files.sort();
+        directories.sort();
+        const answer = { files, directories };
+        record({ op: "entries", path, ...answer });
+        return answer;
+    }
+    catch {
+        // Enumeration can fail even while the path remains a directory. Preserve
+        // the failed operation itself so a permission/ACL repair invalidates the
+        // cached frontend rather than replaying only the unchanged path kind.
+        record({ op: "entries-error", path });
+        return null;
+    }
+}
+/** Re-run every recorded probe against the current filesystem. */
+export function frontendInputsStillMatch(snapshot, exclusions = {}) {
+    if (snapshot.version !== 1 || snapshot.stable !== true || !Array.isArray(snapshot.probes)) {
+        return false;
+    }
+    const outputPaths = new Set([...(exclusions.outputPaths ?? [])].map((path) => resolve(path)));
+    const outputDirectories = new Set([...(exclusions.outputDirectories ?? [])].map((path) => resolve(path)));
+    const generatedOnlyDirectory = (directory) => {
+        const allowedFiles = new Set();
+        for (const output of outputPaths) {
+            if (dirname(output) === directory)
+                allowedFiles.add(basename(output));
+        }
+        const allowedDirectories = new Map();
+        for (const outputDir of outputDirectories) {
+            if (outputDir !== directory && dirname(outputDir) === directory) {
+                allowedDirectories.set(basename(outputDir), outputDir);
+            }
+        }
+        try {
+            return readdirSync(directory).every((name) => {
+                if (allowedFiles.has(name))
+                    return true;
+                const child = allowedDirectories.get(name);
+                return child !== undefined && generatedOnlyDirectory(child);
+            });
+        }
+        catch {
+            return false;
+        }
+    };
+    return snapshot.probes.every((probe) => {
+        if (outputPaths.has(probe.path))
+            return true;
+        if (outputDirectories.has(probe.path)) {
+            // A fresh output directory can be absent while the frontend runs and
+            // created only when emission starts. Admit it only while its current
+            // contents are exactly the named compiler artifacts; a user file that
+            // appears there still invalidates module resolution.
+            if (probe.op === "kind" && probe.kind === "missing") {
+                return pathKind(probe.path) === "missing" || generatedOnlyDirectory(probe.path);
+            }
+            if (probe.op === "entries-error") {
+                try {
+                    readdirSync(probe.path);
+                    return generatedOnlyDirectory(probe.path);
+                }
+                catch {
+                    return true;
+                }
+            }
+            if (probe.op === "realpath" && probe.target === null) {
+                try {
+                    realpathSync(probe.path);
+                    return generatedOnlyDirectory(probe.path);
+                }
+                catch {
+                    return true;
+                }
+            }
+        }
+        switch (probe.op) {
+            case "file": {
+                try {
+                    return frontendSourceDigest(readFileSync(probe.path, "utf8")) === probe.digest;
+                }
+                catch {
+                    return false;
+                }
+            }
+            case "read-error": {
+                try {
+                    readFileSync(probe.path, "utf8");
+                    return false;
+                }
+                catch {
+                    return true;
+                }
+            }
+            case "kind":
+                return pathKind(probe.path) === probe.kind;
+            case "entries": {
+                try {
+                    const ignored = new Set();
+                    for (const output of outputPaths) {
+                        if (dirname(output) === probe.path)
+                            ignored.add(basename(output));
+                    }
+                    for (const outputDir of outputDirectories) {
+                        if (dirname(outputDir) !== probe.path)
+                            continue;
+                        const name = basename(outputDir);
+                        // If the directory existed during the frontend, keep tracking its
+                        // presence. Only suppress a directory introduced by this build.
+                        if (!probe.files.includes(name) &&
+                            !probe.directories.includes(name) &&
+                            generatedOnlyDirectory(outputDir)) {
+                            ignored.add(name);
+                        }
+                    }
+                    const files = [];
+                    const directories = [];
+                    for (const entry of readdirSync(probe.path, { withFileTypes: true })) {
+                        const kind = entry.isSymbolicLink() ? pathKind(resolve(probe.path, entry.name)) : null;
+                        if (entry.isFile() || kind === "file")
+                            files.push(entry.name);
+                        if (entry.isDirectory() || kind === "directory")
+                            directories.push(entry.name);
+                    }
+                    files.sort();
+                    directories.sort();
+                    return JSON.stringify(files.filter((name) => !ignored.has(name))) ===
+                        JSON.stringify(probe.files.filter((name) => !ignored.has(name))) &&
+                        JSON.stringify(directories.filter((name) => !ignored.has(name))) ===
+                            JSON.stringify(probe.directories.filter((name) => !ignored.has(name)));
+                }
+                catch {
+                    return false;
+                }
+            }
+            case "entries-error": {
+                try {
+                    readdirSync(probe.path, { withFileTypes: true });
+                    return false;
+                }
+                catch {
+                    return true;
+                }
+            }
+            case "realpath": {
+                try {
+                    return realpathSync(probe.path) === probe.target;
+                }
+                catch {
+                    return probe.target === null;
+                }
+            }
+        }
+    });
+}
+/**
+ * Validate all non-source frontend probes exactly while allowing only
+ * caller-approved semantic-equivalent file edits. The old source text is a
+ * cache payload; every unchanged input remains content-hash checked.
+ */
+export function frontendInputsSemanticallyMatch(snapshot, previousSources, isSemanticEquivalent, exclusions = {}) {
+    if (!validFrontendInputSnapshot(snapshot))
+        return null;
+    const sourceProbes = new Map(snapshot.probes
+        .filter((probe) => probe.op === "file")
+        .map((probe) => [probe.path, probe]));
+    for (const [path, previous] of previousSources) {
+        if (sourceProbes.get(path)?.digest !== frontendSourceDigest(previous))
+            return null;
+    }
+    const changed = [];
+    const currentSources = new Map();
+    const adjusted = {
+        ...snapshot,
+        probes: snapshot.probes.map((probe) => {
+            if (probe.op !== "file")
+                return probe;
+            let current;
+            try {
+                current = readFileSync(probe.path, "utf8");
+            }
+            catch {
+                return probe;
+            }
+            const previous = previousSources.get(probe.path);
+            const currentDigest = frontendSourceDigest(current);
+            if (previous === undefined || frontendSourceDigest(previous) !== probe.digest)
+                return probe;
+            currentSources.set(probe.path, current);
+            if (currentDigest === probe.digest)
+                return probe;
+            if (!isSemanticEquivalent(probe.path, previous, current))
+                return probe;
+            changed.push({ path: probe.path, previous, current });
+            return { ...probe, digest: currentDigest };
+        }),
+    };
+    if (!frontendInputsStillMatch(adjusted, exclusions))
+        return null;
+    for (const [path, previous] of previousSources) {
+        if (!currentSources.has(path)) {
+            try {
+                currentSources.set(path, readFileSync(path, "utf8"));
+            }
+            catch {
+                currentSources.set(path, previous);
+            }
+        }
+    }
+    return { changed, currentSources, snapshot: adjusted };
+}
+/** Pure validator used by the persistent-cache reader before any path probes. */
+export function validFrontendInputSnapshot(snapshot) {
+    if (snapshot === null || typeof snapshot !== "object")
+        return false;
+    const candidate = snapshot;
+    if (candidate.version !== 1 || candidate.stable !== true || !Array.isArray(candidate.probes))
+        return false;
+    return candidate.probes.every((probe) => {
+        if (probe === null || typeof probe !== "object")
+            return false;
+        const value = probe;
+        if (typeof value.path !== "string" || typeof value.op !== "string")
+            return false;
+        switch (value.op) {
+            case "file":
+                return typeof value.digest === "string" && /^[0-9a-f]{64}$/.test(value.digest);
+            case "read-error":
+                return true;
+            case "kind":
+                return value.kind === "file" || value.kind === "directory" || value.kind === "other" ||
+                    value.kind === "missing";
+            case "entries":
+                return Array.isArray(value.files) && value.files.every((entry) => typeof entry === "string") &&
+                    Array.isArray(value.directories) && value.directories.every((entry) => typeof entry === "string");
+            case "entries-error":
+                return true;
+            case "realpath":
+                return value.target === null || typeof value.target === "string";
+            default:
+                return false;
+        }
+    });
+}
+//# sourceMappingURL=input-tracker.js.map

package/dist/frontend/input-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-tracker.js","sourceRoot":"","sources":["../../src/frontend/input-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CvD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,EAAE;YAClB,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;gBAClB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,OAAO,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAwB,CAAC;AAEpE,MAAM,OAAO,oBAAoB;IACd,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IACxD,MAAM,GAAG,IAAI,CAAC;IAEtB,GAAG,CAAI,EAAW;QAChB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChF,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE;YAClC,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;gBAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAyB;QAC9B,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACjF,mEAAmE;YACnE,uEAAuE;YACvE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACxB,wEAAwE;YACxE,oEAAoE;YACpE,sEAAsE;YACtE,kEAAkE;YAClE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,IAAI,YAAY,EAAE,EAAE,KAAK,MAAM,IAAI,YAAY,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACrF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAChE,IAAI,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,KAAK,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YACrC,kEAAkE;YAClE,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,IAAI,cAAc,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC5E;YACD,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,aAAa,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,MAAM,CAAC,KAAyB;IACvC,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,WAAW,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,SAAS,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAY;IAEZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjF,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,KAAK,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9D,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,WAAW;gBAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,WAAW,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,yEAAyE;QACzE,sEAAsE;QACtE,MAAM,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,wBAAwB,CACtC,QAA+B,EAC/B,aAAsC,EAAE;IAExC,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACvE,CAAC;IACF,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAW,EAAE;QAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS;gBAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACrD,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;YAC1C,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC3C,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACxC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO,KAAK,KAAK,SAAS,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,qEAAqE;YACrE,qEAAqE;YACrE,sEAAsE;YACtE,qDAAqD;YACrD,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACpD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,KAAK,CAAC,EAAE,KAAK,eAAe,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxB,OAAO,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACrD,IAAI,CAAC;oBACH,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACzB,OAAO,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,KAAK,CAAC,EAAE,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,CAAC;oBACH,OAAO,oBAAoB,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC;gBACjF,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,IAAI,CAAC;oBACH,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACjC,OAAO,KAAK,CAAC;gBACf,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC;YAC7C,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;oBAClC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;wBACjC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI;4BAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;oBACpE,CAAC;oBACD,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;wBAC1C,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,IAAI;4BAAE,SAAS;wBAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;wBACjC,kEAAkE;wBAClE,gEAAgE;wBAChE,IACE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;4BAC3B,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;4BACjC,sBAAsB,CAAC,SAAS,CAAC,EACjC,CAAC;4BACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBACpB,CAAC;oBACH,CAAC;oBACD,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,MAAM,WAAW,GAAa,EAAE,CAAC;oBACjC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;wBACrE,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;wBACvF,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,KAAK,MAAM;4BAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC9D,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,WAAW;4BAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAChF,CAAC;oBACD,KAAK,CAAC,IAAI,EAAE,CAAC;oBACb,WAAW,CAAC,IAAI,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;wBAC7D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;wBAClE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;4BAC9D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7E,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC;oBACH,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;oBACjD,OAAO,KAAK,CAAC;gBACf,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,IAAI,CAAC;oBACH,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA+B,EAC/B,eAA4C,EAC5C,oBAAkF,EAClF,aAAsC,EAAE;IAExC,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,MAAM;SACZ,MAAM,CAAC,CAAC,KAAK,EAAwD,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;SAC5F,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CACvC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC;QAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,oBAAoB,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IACrF,CAAC;IACD,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,MAAM,QAAQ,GAA0B;QACtC,GAAG,QAAQ;QACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACpC,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;YACtC,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,QAAQ,KAAK,SAAS,IAAI,oBAAoB,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC5F,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxC,IAAI,aAAa,KAAK,KAAK,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACjD,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAC7C,CAAC,CAAC;KACH,CAAC;IACF,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,0BAA0B,CAAC,QAAiB;IAC1D,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,SAAS,GAAG,QAA0C,CAAC;IAC7D,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3G,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAoC,CAAC;QACnD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACjF,QAAQ,KAAK,CAAC,EAAE,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,OAAO,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjF,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAClF,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;YAC7B,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;oBAC1F,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;YACtG,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC;YACd,KAAK,UAAU;gBACb,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;YACnE;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/frontend/input-tracker.test.d.ts

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

package/dist/frontend/input-tracker.test.js

@@ -0,0 +1,137 @@
+import { chmod, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, expect, test } from "vitest";
+import { FrontendInputTracker, frontendInputsStillMatch, trackedAccessibleEntries, trackedDirectoryExists, trackedFileExists, trackedReadFile, validFrontendInputSnapshot, } from "./input-tracker.js";
+const scratch = [];
+afterEach(async () => {
+    await Promise.all(scratch.splice(0).map((path) => rm(path, { recursive: true, force: true })));
+});
+test("tracked frontend reads invalidate on byte edits", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const file = join(dir, "entry.ts");
+    await writeFile(file, "export const answer = 1;\n");
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => expect(trackedReadFile(file)).toContain("answer"));
+    const snapshot = tracker.snapshot();
+    expect(validFrontendInputSnapshot(snapshot)).toBe(true);
+    expect(frontendInputsStillMatch(snapshot)).toBe(true);
+    await writeFile(file, "export const answer = 2;\n");
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("failed frontend reads invalidate when the same file becomes readable", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const file = join(dir, "unreadable.ts");
+    await writeFile(file, "export const repaired = true;\n");
+    await chmod(file, 0o000);
+    const tracker = new FrontendInputTracker();
+    const result = tracker.run(() => trackedReadFile(file));
+    if (result !== null) {
+        // Windows and privileged test users may not enforce POSIX mode bits.
+        await chmod(file, 0o600);
+        return;
+    }
+    const snapshot = tracker.snapshot();
+    expect(snapshot.probes).toContainEqual({ op: "read-error", path: file });
+    expect(frontendInputsStillMatch(snapshot)).toBe(true);
+    await chmod(file, 0o600);
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("failed resolution candidates invalidate when a file appears", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const candidate = join(dir, "dependency.ts");
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => expect(trackedFileExists(candidate)).toBe(false));
+    const snapshot = tracker.snapshot();
+    expect(frontendInputsStillMatch(snapshot)).toBe(true);
+    await writeFile(candidate, "export const loaded = true;\n");
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("a candidate appearing during the frontend prevents cache publication", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const candidate = join(dir, "dependency.ts");
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => expect(trackedFileExists(candidate)).toBe(false));
+    await writeFile(candidate, "export const loaded = true;\n");
+    tracker.run(() => expect(trackedReadFile(candidate)).toContain("loaded"));
+    const snapshot = tracker.snapshot();
+    expect(snapshot.stable).toBe(false);
+    expect(validFrontendInputSnapshot(snapshot)).toBe(false);
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("directory enumeration invalidates workspace discovery", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const packages = join(dir, "packages");
+    await mkdir(packages);
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => expect(trackedAccessibleEntries(packages)?.directories).toEqual([]));
+    const snapshot = tracker.snapshot();
+    await mkdir(join(packages, "new-member"));
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("compiler outputs do not invalidate a fresh output directory", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const generatedRoot = join(dir, "generated");
+    const outDir = join(generatedRoot, "nested");
+    const generated = join(outDir, "entry.lib.c");
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => {
+        expect(trackedAccessibleEntries(dir)?.directories).toEqual([]);
+        expect(trackedDirectoryExists(generatedRoot)).toBe(false);
+        expect(trackedDirectoryExists(outDir)).toBe(false);
+        expect(trackedAccessibleEntries(outDir)).toBeNull();
+    });
+    const snapshot = tracker.snapshot();
+    const exclusions = {
+        outputPaths: [generated],
+        outputDirectories: [dir, generatedRoot, outDir],
+    };
+    await mkdir(outDir, { recursive: true });
+    await writeFile(generated, "/* generated */\n");
+    expect(frontendInputsStillMatch(snapshot, exclusions)).toBe(true);
+    await writeFile(join(outDir, "new-source.ts"), "export const appeared = true;\n");
+    expect(frontendInputsStillMatch(snapshot, exclusions)).toBe(false);
+});
+test("failed directory enumeration invalidates when the operation starts succeeding", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const packages = join(dir, "packages");
+    await writeFile(packages, "not a directory\n");
+    const tracker = new FrontendInputTracker();
+    tracker.run(() => expect(trackedAccessibleEntries(packages)).toBeNull());
+    const snapshot = tracker.snapshot();
+    expect(snapshot.probes).toContainEqual({ op: "entries-error", path: packages });
+    expect(frontendInputsStillMatch(snapshot)).toBe(true);
+    await rm(packages);
+    await mkdir(packages);
+    expect(frontendInputsStillMatch(snapshot)).toBe(false);
+});
+test("failed directory enumeration invalidates when access is restored", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scriptc-inputs-"));
+    scratch.push(dir);
+    const packages = join(dir, "packages");
+    await mkdir(packages);
+    await writeFile(join(packages, "member.ts"), "export const member = true;\n");
+    await chmod(packages, 0o000);
+    try {
+        const tracker = new FrontendInputTracker();
+        const result = tracker.run(() => trackedAccessibleEntries(packages));
+        if (result !== null)
+            return; // Windows and privileged users may ignore POSIX mode bits.
+        const snapshot = tracker.snapshot();
+        expect(snapshot.probes).toContainEqual({ op: "entries-error", path: packages });
+        expect(frontendInputsStillMatch(snapshot)).toBe(true);
+        await chmod(packages, 0o700);
+        expect(frontendInputsStillMatch(snapshot)).toBe(false);
+    }
+    finally {
+        await chmod(packages, 0o700);
+    }
+});
+//# sourceMappingURL=input-tracker.test.js.map

package/dist/frontend/input-tracker.test.js.map

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

package/dist/frontend/lowering/lower-builtins.js

@@ -2,7 +2,6 @@
  * crypto, child_process spawn/spawnSync and child/stats/spawn-result
  * methods), JSON.parse/stringify, process properties/methods and
  * process.env access, and console.log detection. */
-import { readFileSync } from "node:fs";
 import { builtinModules } from "node:module";
 import { dirname, resolve } from "node:path";
 import * as ts from "../ts7/adapter.js";
@@ -11,6 +10,7 @@ import { canonicalBuiltinModule, isJsSourceFile, locOf, requireSpecOf } from "..
 import { isRelativeSpecifier } from "../shared.js";
 import { probeNodeRequireRefusal } from "../npm.js";
 import { isNpmStaticPackage } from "../npm-static.js";
+import { trackedReadFile } from "../input-tracker.js";
 import { invalidJsonModuleDiag, requiresDynamicImportDiag } from "../../diagnostics/diagnostic.js";
 import { builtinModuleFnOf, FS_READDIR_DOCUMENTED_OPTIONS, FS_WATCH_DOCUMENTED_OPTIONS, FS_WRITE_FILE_DOCUMENTED_OPTIONS, QS_PARSE_DOCUMENTED_OPTIONS, QS_STRINGIFY_DOCUMENTED_OPTIONS, READLINE_DOCUMENTED_OPTIONS, builtinConstLit, fenceOrDropOptionKey, isChildSurfaceMember, } from "./surfaces.js";
 import { conditionalSpreadOf, droppableStatic, lowerDynObjectLiteral } from "./lower-exprs.js";
@@ -370,13 +370,7 @@ export function lowerCreateRequireCall(L, call, loc) {
         const abs = spec.startsWith("/")
             ? spec
             : resolve(dirname(cr.baseFile.fileName), spec);
-        let text = null;
-        try {
-            text = readFileSync(abs, "utf8");
-        }
-        catch {
-            /* the fence below speaks */
-        }
+        const text = trackedReadFile(abs);
         if (text === null) {
             L.noLowering(`createRequire's require of '${spec}' (no file at ${abs})`, call, "the required document resolves at build time — check the path against the requiring file");
         }
@@ -1736,7 +1730,7 @@ export function lowerSpawnSyncCall(L, expr, loc) {
             }
             // A runtime string whose TYPE pins every possible value to the
             // supported literals — the modes resolve at the call instead.
-            const arms = t.isUnionType() ? t.getTypes() : [t];
+            const arms = t.isUnionType() ? ts.constituentTypes(t) : [t];
             if (arms.length > 0 &&
                 arms.every((a) => a.isStringLiteralType() &&
                     (a.value === "pipe" || a.value === "ignore" || a.value === "inherit"))) {
@@ -4029,7 +4023,7 @@ export function lowerFileHandleMethodCall(L, call, access) {
         if (!node)
             return dflt;
         const nodeType = L.typeOf(node);
-        const parts = nodeType.isUnionType() ? nodeType.getTypes() : [nodeType];
+        const parts = nodeType.isUnionType() ? ts.constituentTypes(nodeType) : [nodeType];
         const supported = parts.every((t) => (t.flags & (ts.TypeFlags.Undefined | ts.TypeFlags.Void | ts.TypeFlags.Null)) !== 0 ||
             (t.isStringLiteralType() && (t.value === "utf8" || t.value === "utf-8")));
         if (!supported) {