legend-doctor 0.1.0

package/dist/src/project/analyze-path/source-declarations.js

@@ -0,0 +1,121 @@
+import { collectReactComponentWrappers, isReactComponentWrapper, } from "../../core/react-component-wrappers.js";
+import ts from "typescript";
+import { unwrapTransparentExpression } from "../../core/analysis-ast.js";
+const HOOK_BINDING_PATTERN = /^use[A-Z0-9]/u;
+export function importedHookBindings(sourceFile) {
+    return sourceFile.statements.flatMap((statement) => statementHookBindings(statement));
+}
+function statementHookBindings(statement) {
+    if (!ts.isImportDeclaration(statement) || statement.importClause?.isTypeOnly) {
+        return [];
+    }
+    const clause = statement.importClause;
+    const defaultBinding = clause?.name && HOOK_BINDING_PATTERN.test(clause.name.text) ? [clause.name.text] : [];
+    return [...defaultBinding, ...namedHookBindings(clause?.namedBindings)];
+}
+function namedHookBindings(namedBindings) {
+    if (!namedBindings || !ts.isNamedImports(namedBindings)) {
+        return [];
+    }
+    return namedBindings.elements
+        .filter((element) => !element.isTypeOnly && HOOK_BINDING_PATTERN.test(element.name.text))
+        .map((element) => element.name.text);
+}
+export function findHookDeclaration(sourceFile, localName) {
+    for (const statement of sourceFile.statements) {
+        const owner = statementHookOwner(statement, localName);
+        if (owner) {
+            return owner;
+        }
+    }
+    return null;
+}
+function statementHookOwner(statement, localName) {
+    if (ts.isFunctionDeclaration(statement)) {
+        return statement.name?.text === localName && statement.body ? statement : null;
+    }
+    if (!ts.isVariableStatement(statement)) {
+        return null;
+    }
+    for (const declaration of statement.declarationList.declarations) {
+        const owner = declarationHookOwner(declaration, localName);
+        if (owner) {
+            return owner;
+        }
+    }
+    return null;
+}
+function declarationHookOwner(declaration, localName) {
+    if (!ts.isIdentifier(declaration.name) ||
+        declaration.name.text !== localName ||
+        !declaration.initializer) {
+        return null;
+    }
+    const initializer = unwrapTransparentExpression(declaration.initializer);
+    return ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer)
+        ? initializer
+        : null;
+}
+export function findComponentDeclaration(query) {
+    const reactWrappers = collectReactComponentWrappers(query.sourceFile);
+    for (const statement of query.sourceFile.statements) {
+        const source = statementComponentSource(statement, query, reactWrappers);
+        if (source) {
+            return source;
+        }
+    }
+    return null;
+}
+function statementComponentSource(statement, query, reactWrappers) {
+    if (ts.isFunctionDeclaration(statement)) {
+        return statement.name?.text === query.localName && statement.body
+            ? {
+                body: statement.body,
+                deferredCallbackHooks: query.deferredCallbackHooks,
+                file: query.file,
+                owner: statement,
+                reactWrapped: false,
+            }
+            : null;
+    }
+    if (!ts.isVariableStatement(statement)) {
+        return null;
+    }
+    for (const declaration of statement.declarationList.declarations) {
+        const source = declarationComponentSource(declaration, query, reactWrappers);
+        if (source) {
+            return source;
+        }
+    }
+    return null;
+}
+function declarationComponentSource(declaration, query, reactWrappers) {
+    if (!ts.isIdentifier(declaration.name) ||
+        declaration.name.text !== query.localName ||
+        !declaration.initializer) {
+        return null;
+    }
+    const unwrapped = unwrapTransparentExpression(declaration.initializer);
+    const wrapped = wrapperRenderFunction(unwrapped, reactWrappers);
+    const initializer = wrapped ?? unwrapped;
+    if (!ts.isArrowFunction(initializer) && !ts.isFunctionExpression(initializer)) {
+        return null;
+    }
+    return {
+        body: initializer.body,
+        deferredCallbackHooks: query.deferredCallbackHooks,
+        file: query.file,
+        owner: initializer,
+        reactWrapped: wrapped !== null,
+    };
+}
+function wrapperRenderFunction(initializer, reactWrappers) {
+    if (!ts.isCallExpression(initializer) ||
+        !isReactComponentWrapper(initializer.expression, reactWrappers) ||
+        initializer.arguments.length === 0) {
+        return null;
+    }
+    const inner = unwrapTransparentExpression(initializer.arguments[0]);
+    return wrapperRenderFunction(inner, reactWrappers) ?? inner;
+}
+//# sourceMappingURL=source-declarations.js.map

package/dist/src/project/analyze-path/source-declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-declarations.js","sourceRoot":"","sources":["../../../../src/project/analyze-path/source-declarations.ts"],"names":[],"mappings":"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"}

package/dist/src/project/capabilities.d.ts

@@ -0,0 +1,9 @@
+import type { InstalledLegendState } from "../core/types.js";
+/** Toolchain facts that decide which rules apply to one analyzed file. */
+export interface FileCapabilities {
+    readonly legendState: InstalledLegendState | null;
+    /** The file's nearest package or bundler config enables the React Compiler. */
+    readonly reactCompiler: boolean;
+}
+export declare const NO_CAPABILITIES: FileCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/src/project/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/project/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,eAAe,EAAE,gBAA8D,CAAC"}

package/dist/src/project/capabilities.js

@@ -0,0 +1,2 @@
+export const NO_CAPABILITIES = { legendState: null, reactCompiler: false };
+//# sourceMappingURL=capabilities.js.map

package/dist/src/project/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/project/capabilities.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAAqB,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC"}

package/dist/src/project/git-scope-error.d.ts

@@ -0,0 +1,5 @@
+/** A scope flag could not be honoured: git is missing, the target is not a work tree, or a ref is unknown. */
+export declare class GitScopeError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=git-scope-error.d.ts.map

package/dist/src/project/git-scope-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-scope-error.d.ts","sourceRoot":"","sources":["../../../src/project/git-scope-error.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,qBAAa,aAAc,SAAQ,KAAK;gBACnB,OAAO,EAAE,MAAM;CAInC"}

package/dist/src/project/git-scope-error.js

@@ -0,0 +1,8 @@
+/** A scope flag could not be honoured: git is missing, the target is not a work tree, or a ref is unknown. */
+export class GitScopeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GitScopeError";
+    }
+}
+//# sourceMappingURL=git-scope-error.js.map

package/dist/src/project/git-scope-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-scope-error.js","sourceRoot":"","sources":["../../../src/project/git-scope-error.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/src/project/git-scope.d.ts

@@ -0,0 +1,17 @@
+export { GitScopeError } from "./git-scope-error.js";
+export type ScanScopeMode = "changed" | "since" | "staged";
+export type ScanScope = {
+    readonly mode: "changed" | "staged";
+} | {
+    readonly mode: "since";
+    readonly ref: string;
+};
+/**
+ * Resolves the files a scope flag selects under `root`, as path identity keys of absolute paths.
+ * `changed` and `since` include uncommitted and untracked work; `staged` reads the index.
+ * Deleted paths are dropped because there is nothing left to analyze. Git output stays relative
+ * to `root` rather than the repository top level, which git reports as a realpath that would not
+ * match a symlinked scan root.
+ */
+export declare function resolveScopedFiles(root: string, scope: ScanScope): Promise<ReadonlySet<string>>;
+//# sourceMappingURL=git-scope.d.ts.map

package/dist/src/project/git-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-scope.d.ts","sourceRoot":"","sources":["../../../src/project/git-scope.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,GACvC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAgErD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAK9B"}

package/dist/src/project/git-scope.js

@@ -0,0 +1,108 @@
+import { GitScopeError } from "./git-scope-error.js";
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { pathIdentityKey } from "../core/path-identity.js";
+import { promisify } from "node:util";
+export { GitScopeError } from "./git-scope-error.js";
+const run = promisify(execFile);
+/** 64 MiB, enough for the path list of any repository git can diff in one call. */
+const GIT_OUTPUT_LIMIT = 67_108_864;
+class GitCommands {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async assertWorkTree() {
+        await this.stdout(["rev-parse", "--is-inside-work-tree"]);
+    }
+    async hasHead() {
+        try {
+            await this.stdout(["rev-parse", "--verify", "--quiet", "HEAD"]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async mergeBase(ref) {
+        try {
+            const output = await this.stdout(["merge-base", ref, "HEAD"]);
+            return output.trim();
+        }
+        catch (error) {
+            throw new GitScopeError(`--since needs a ref that shares history with HEAD; git could not resolve '${ref}': ${gitFailure(error).detail}`);
+        }
+    }
+    async pathList(args) {
+        const output = await this.stdout([...args, "-z"]);
+        return output.split("\0").filter((entry) => entry.length > 0);
+    }
+    async stdout(args) {
+        try {
+            const { stdout } = await run("git", args, {
+                cwd: this.cwd,
+                encoding: "utf8",
+                maxBuffer: GIT_OUTPUT_LIMIT,
+            });
+            return stdout;
+        }
+        catch (error) {
+            throw this.describe(gitFailure(error), args);
+        }
+    }
+    describe(failure, args) {
+        if (failure.kind === "git-missing") {
+            return new GitScopeError("scope flags need git on PATH; git was not found");
+        }
+        if (failure.kind === "git-exited" && args[1] === "--is-inside-work-tree") {
+            return new GitScopeError(`scope flags need a git work tree; '${this.cwd}' is not inside one: ${failure.detail}`);
+        }
+        return failure.cause instanceof Error ? failure.cause : new Error(failure.detail);
+    }
+}
+/**
+ * Resolves the files a scope flag selects under `root`, as path identity keys of absolute paths.
+ * `changed` and `since` include uncommitted and untracked work; `staged` reads the index.
+ * Deleted paths are dropped because there is nothing left to analyze. Git output stays relative
+ * to `root` rather than the repository top level, which git reports as a realpath that would not
+ * match a symlinked scan root.
+ */
+export async function resolveScopedFiles(root, scope) {
+    const git = new GitCommands(root);
+    await git.assertWorkTree();
+    const relativePaths = await scopedPaths(git, scope);
+    return new Set(relativePaths.map((relative) => pathIdentityKey(path.join(root, relative))));
+}
+async function scopedPaths(git, scope) {
+    const hasHead = await git.hasHead();
+    if (!hasHead) {
+        return scope.mode === "staged"
+            ? git.pathList(["ls-files", "--cached"])
+            : git.pathList(["ls-files", "--cached", "--others", "--exclude-standard"]);
+    }
+    if (scope.mode === "staged") {
+        return git.pathList(["diff", "--name-only", "--relative", "--diff-filter=d", "--cached"]);
+    }
+    const base = scope.mode === "since" ? await git.mergeBase(scope.ref) : "HEAD";
+    const [tracked, untracked] = await Promise.all([
+        git.pathList(["diff", "--name-only", "--relative", "--diff-filter=d", base]),
+        git.pathList(["ls-files", "--others", "--exclude-standard"]),
+    ]);
+    return [...tracked, ...untracked];
+}
+function isProcessFailure(cause) {
+    return cause instanceof Error && Object.hasOwn(cause, "code");
+}
+/** Parses a rejected child-process promise at the boundary into a named failure. */
+function gitFailure(cause) {
+    if (!isProcessFailure(cause)) {
+        const detail = cause instanceof Error ? cause.message : String(cause);
+        return { cause, detail, kind: "unexpected" };
+    }
+    const detail = cause.stderr?.trim().split("\n")[0] || cause.message;
+    if (cause.code === "ENOENT") {
+        return { cause, detail, kind: "git-missing" };
+    }
+    return { cause, detail, kind: Number.isInteger(cause.code) ? "git-exited" : "unexpected" };
+}
+//# sourceMappingURL=git-scope.js.map

package/dist/src/project/git-scope.js.map

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

package/dist/src/project/legend-state-package.d.ts

@@ -0,0 +1,4 @@
+import type { InstalledLegendState } from "../core/types.js";
+export type { InstalledLegendState, SyncExport, UseValueExport } from "../core/types.js";
+export declare function resolveInstalledLegendState(root: string): Promise<InstalledLegendState | null>;
+//# sourceMappingURL=legend-state-package.d.ts.map

package/dist/src/project/legend-state-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend-state-package.d.ts","sourceRoot":"","sources":["../../../src/project/legend-state-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAA8B,MAAM,kBAAkB,CAAC;AAIzF,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAmBzF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAE9F"}

package/dist/src/project/legend-state-package.js

@@ -0,0 +1,109 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+const REACT_TYPE_CANDIDATES = [
+    "react.d.ts",
+    path.join("react", "index.d.ts"),
+    path.join("dist", "react.d.ts"),
+];
+const DECLARATION_FILE_PATTERN = /\.d\.[cm]?ts$/u;
+const USE_VALUE_ALIAS_PATTERN = /\buseSelector\s+as\s+useValue\b/u;
+const USE_VALUE_PATTERN = /\buseValue\b/u;
+const SYNC_ENTRY = "./sync";
+const SYNC_DECLARATION_FILE = "sync.d.ts";
+export function resolveInstalledLegendState(root) {
+    return resolveFromAncestor(path.resolve(root));
+}
+async function resolveFromAncestor(directory) {
+    const packageDirectory = path.join(directory, "node_modules", "@legendapp", "state");
+    const manifest = await readJson(path.join(packageDirectory, "package.json"));
+    if (isJsonObject(manifest)) {
+        return resolveFromManifest(packageDirectory, manifest);
+    }
+    const parent = path.dirname(directory);
+    return parent === directory ? null : resolveFromAncestor(parent);
+}
+async function resolveFromManifest(packageDirectory, manifest) {
+    const { version } = manifest;
+    if (!isJsonString(version) || version.length === 0) {
+        return null;
+    }
+    const [syncExport, useValueExport] = await Promise.all([
+        resolveSyncExport(packageDirectory, manifest),
+        resolveUseValueExport(packageDirectory, manifest),
+    ]);
+    return { syncExport, useValueExport, version };
+}
+async function resolveSyncExport(packageDirectory, manifest) {
+    const exportsField = manifest["exports"];
+    if (isJsonObject(exportsField)) {
+        return Object.hasOwn(exportsField, SYNC_ENTRY) ? "available" : "missing";
+    }
+    const declaration = await readText(path.join(packageDirectory, SYNC_DECLARATION_FILE));
+    return declaration === null ? "unknown" : "available";
+}
+async function resolveUseValueExport(packageDirectory, manifest) {
+    const candidates = [...reactTypesFromExports(manifest), ...REACT_TYPE_CANDIDATES];
+    const declarations = await Promise.all(candidates.map((candidate) => readText(path.join(packageDirectory, candidate))));
+    const declaration = declarations.find((text) => text !== null && text.length > 0) ?? null;
+    if (declaration === null) {
+        return "unknown";
+    }
+    if (USE_VALUE_ALIAS_PATTERN.test(declaration)) {
+        return "alias";
+    }
+    return USE_VALUE_PATTERN.test(declaration) ? "distinct" : "missing";
+}
+function reactTypesFromExports(manifest) {
+    const exportsField = manifest["exports"];
+    if (!isJsonObject(exportsField)) {
+        return [];
+    }
+    const candidates = [];
+    collectDeclarationFiles(exportsField["./react"], candidates);
+    return candidates;
+}
+function collectDeclarationFiles(entry, candidates) {
+    if (isJsonString(entry)) {
+        if (DECLARATION_FILE_PATTERN.test(entry)) {
+            candidates.push(entry);
+        }
+        return;
+    }
+    if (!isJsonCollection(entry)) {
+        return;
+    }
+    for (const value of Object.values(entry)) {
+        collectDeclarationFiles(value, candidates);
+    }
+}
+function isJsonCollection(value) {
+    return value instanceof Object;
+}
+function isJsonObject(value) {
+    return value instanceof Object && !Array.isArray(value);
+}
+function isJsonString(value) {
+    return value?.constructor === String;
+}
+async function readJson(filePath) {
+    const text = await readText(filePath);
+    if (!text) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+async function readText(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=legend-state-package.js.map

package/dist/src/project/legend-state-package.js.map

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

package/dist/src/project/react-compiler-package.d.ts

@@ -0,0 +1,8 @@
+export declare class ReactCompilerResolver {
+    private readonly directories;
+    packageCompilesFile(filePath: string): Promise<boolean>;
+    compilesDirectory(directory: string): Promise<boolean>;
+    private directoryCompiles;
+    private resolveDirectory;
+}
+//# sourceMappingURL=react-compiler-package.d.ts.map

package/dist/src/project/react-compiler-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-compiler-package.d.ts","sourceRoot":"","sources":["../../../src/project/react-compiler-package.ts"],"names":[],"mappings":"AAuCA,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAE5D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,OAAO,CAAC,iBAAiB;YAUX,gBAAgB;CAU/B"}

package/dist/src/project/react-compiler-package.js

@@ -0,0 +1,139 @@
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+const COMPILER_PACKAGES = ["babel-plugin-react-compiler", "react-compiler-runtime"];
+const DEPENDENCY_FIELDS = ["dependencies", "devDependencies", "peerDependencies"];
+const CONFIG_FILES = [
+    "app.json",
+    "app.config.js",
+    "app.config.ts",
+    "app.config.cjs",
+    "app.config.mjs",
+    "app.config.json",
+    "babel.config.js",
+    "babel.config.cjs",
+    "babel.config.mjs",
+    "babel.config.ts",
+    "babel.config.json",
+    ".babelrc",
+    ".babelrc.js",
+    ".babelrc.cjs",
+    ".babelrc.json",
+    "vite.config.js",
+    "vite.config.ts",
+    "vite.config.mjs",
+    "vite.config.mts",
+    "vite.config.cjs",
+    "next.config.js",
+    "next.config.ts",
+    "next.config.mjs",
+    "next.config.cjs",
+    "next.config.mts",
+];
+// Matches every known enablement spelling: the Babel plugin name (Babel, Vite,
+// Metro configs), the pre-19 runtime package, @vitejs/plugin-react's
+// ReactCompilerPreset, and the `reactCompiler: true | {...}` config key used by
+// Next.js and Expo `experiments`. `reactCompiler: false` stays unmatched.
+const CONFIG_MARKER = /babel-plugin-react-compiler|react-compiler-runtime|reactCompilerPreset|\breactCompiler\b['"]?\s*:\s*(?:true|\{)/u;
+export class ReactCompilerResolver {
+    directories = new Map();
+    packageCompilesFile(filePath) {
+        return this.directoryCompiles(path.dirname(path.resolve(filePath)));
+    }
+    compilesDirectory(directory) {
+        return this.directoryCompiles(path.resolve(directory));
+    }
+    directoryCompiles(directory) {
+        const cached = this.directories.get(directory);
+        if (cached) {
+            return cached;
+        }
+        const result = this.resolveDirectory(directory);
+        this.directories.set(directory, result);
+        return result;
+    }
+    async resolveDirectory(directory) {
+        if (await manifestDeclaresReactCompiler(path.join(directory, "package.json"))) {
+            return true;
+        }
+        if (await configEnablesReactCompiler(directory)) {
+            return true;
+        }
+        const parent = path.dirname(directory);
+        return parent === directory ? false : this.directoryCompiles(parent);
+    }
+}
+async function manifestDeclaresReactCompiler(manifestPath) {
+    const text = await readText(manifestPath);
+    if (text === null) {
+        return false;
+    }
+    const facts = readManifestFacts(text);
+    if (facts === null) {
+        return false;
+    }
+    return facts.declaresCompilerDependency || CONFIG_MARKER.test(facts.babelConfigText);
+}
+function readManifestFacts(text) {
+    const manifest = parseJsonObject(text);
+    if (manifest === null) {
+        return null;
+    }
+    const babel = manifest.get("babel");
+    return {
+        babelConfigText: babel === undefined ? "" : JSON.stringify(babel),
+        declaresCompilerDependency: DEPENDENCY_FIELDS.some((field) => {
+            const dependencies = manifest.get(field);
+            const names = dependencies instanceof Object ? Object.keys(dependencies) : [];
+            return COMPILER_PACKAGES.some((packageName) => names.includes(packageName));
+        }),
+    };
+}
+async function configEnablesReactCompiler(directory) {
+    const names = await directoryEntryNames(directory);
+    const candidates = names ? CONFIG_FILES.filter((name) => names.has(name)) : CONFIG_FILES;
+    return anyFileMarksCompiler(candidates.map((name) => path.join(directory, name)));
+}
+async function directoryEntryNames(directory) {
+    try {
+        // Keep case-insensitive filesystem matches; readFile still decides whether a candidate exists.
+        const entries = await readdir(directory);
+        return new Set(entries.map((name) => name.toLowerCase()));
+    }
+    catch {
+        // Searchable directories can permit known-file reads without permitting a listing.
+        return null;
+    }
+}
+async function anyFileMarksCompiler(filePaths) {
+    const [head, ...rest] = filePaths;
+    if (head === undefined) {
+        return false;
+    }
+    const text = await readText(head);
+    if (text !== null && CONFIG_MARKER.test(text)) {
+        return true;
+    }
+    return anyFileMarksCompiler(rest);
+}
+function parseJsonObject(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!(parsed instanceof Object)) {
+            return null;
+        }
+        const entries = Object.entries(parsed);
+        return new Map(entries);
+    }
+    catch {
+        return null;
+    }
+}
+async function readText(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=react-compiler-package.js.map

package/dist/src/project/react-compiler-package.js.map

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

package/dist/src/project/semantic-context/identity-program.d.ts

@@ -0,0 +1,7 @@
+import type { SemanticContextResult } from "./model.js";
+import type { AnalysisFile } from "../analysis-project.js";
+import ts from "typescript";
+export declare function createIdentityPreservingProgram(parsedConfig: ts.ParsedCommandLine, files: readonly AnalysisFile[]): ts.Program;
+/** Reports the first way the Program failed to adopt the cached analysis files, if any. */
+export declare function identityFailure(program: ts.Program, files: readonly AnalysisFile[]): SemanticContextResult | null;
+//# sourceMappingURL=identity-program.d.ts.map

package/dist/src/project/semantic-context/identity-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-program.d.ts","sourceRoot":"","sources":["../../../../src/project/semantic-context/identity-program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,EAAE,CAAC,iBAAiB,EAClC,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,EAAE,CAAC,OAAO,CAcZ;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,qBAAqB,GAAG,IAAI,CAoB9B"}