packageOptionalDependencies?: PluginDependencySpecMap;

bundledManifest?: PluginManifest;

bundledManifestPath?: string;

rawPackageManifest?: PackageManifest;

};

export type PluginDiscoveryResult = {

origin: PluginOrigin;

rejectHardlinks: boolean;

rootRealPath?: string;

packageManifestCache?: Map<string, PackageManifest | null>;

}): PackageManifest | null {

if (params.origin === "bundled") {

return readTrustedPackageManifest(params.dir);

const trustMode =

params.origin === "bundled"

? "trusted"

: params.rejectHardlinks

? "external-reject"

: "external-allow";

const cacheKey = `${trustMode}:${params.rootRealPath ?? path.resolve(params.dir)}`;

const cached = params.packageManifestCache?.get(cacheKey);

if (cached !== undefined) {

return cached;

}

return readPackageManifest(params.dir, params.rejectHardlinks, params.rootRealPath);

const manifest =

params.origin === "bundled"

? readTrustedPackageManifest(params.dir)

: readPackageManifest(params.dir, params.rejectHardlinks, params.rootRealPath);

params.packageManifestCache?.set(cacheKey, manifest);

return manifest;

}

function deriveIdHint(params: {

packageManifest: getPackageManifestMetadata(manifest ?? undefined),

packageDependencies: packageDependencies.dependencies,

packageOptionalDependencies: packageDependencies.optionalDependencies,

rawPackageManifest: manifest ?? undefined,

bundledManifest: params.bundledManifest,

bundledManifestPath: params.bundledManifestPath,

});

diagnostics: PluginDiagnostic[];

seen: Set<string>;

realpathCache: Map<string, string>;

packageManifestCache?: Map<string, PackageManifest | null>;

recurseDirectories?: boolean;

skipDirectories?: Set<string>;

visitedDirectories?: Set<string>;

origin: params.origin,

rejectHardlinks,

...(fullPathRealPath !== undefined ? { rootRealPath: fullPathRealPath } : {}),

packageManifestCache: params.packageManifestCache,

});

const extensionResolution = resolvePackageExtensionEntries(manifest ?? undefined);

if (

diagnostics: PluginDiagnostic[];

seen: Set<string>;

realpathCache: Map<string, string>;

packageManifestCache?: Map<string, PackageManifest | null>;

}) {

const resolved = resolveUserPath(params.rawPath, params.env);

if (!fs.existsSync(resolved)) {

origin: params.origin,

rejectHardlinks,

...(resolvedRealPath !== undefined ? { rootRealPath: resolvedRealPath } : {}),

packageManifestCache: params.packageManifestCache,

});

const extensionResolution = resolvePackageExtensionEntries(manifest ?? undefined);

if (

diagnostics: params.diagnostics,

seen: params.seen,

realpathCache: params.realpathCache,

packageManifestCache: params.packageManifestCache,

...(params.requireBuiltRuntimeEntry !== undefined

? { requireBuiltRuntimeEntry: params.requireBuiltRuntimeEntry }

: {}),

const result = createDiscoveryResult();

const seen = new Set<string>();

const realpathCache = new Map<string, string>();

const packageManifestCache = new Map<string, PackageManifest | null>();

const extra = params.extraPaths ?? [];

for (const extraPath of extra) {

if (typeof extraPath !== "string") {

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

}

const workspaceMatchesBundledRoot = resolvesToSameDirectory(

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

}

return result;

const result = createDiscoveryResult();

const seen = new Set<string>();

const realpathCache = new Map<string, string>();

const packageManifestCache = new Map<string, PackageManifest | null>();

for (const sourceOverlayDir of listBundledSourceOverlayDirs({

bundledRoot: roots.stock,

env,

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

result.diagnostics.push({

level: "warn",

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

}

const sourceCheckoutExtensionsDir = resolveBundledSourceCheckoutExtensionsDir(roots.stock);

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

skipDirectories: readChildDirectoryNames(roots.stock),

});

}

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

}

// Keep auto-discovered global extensions behind bundled plugins.

diagnostics: result.diagnostics,

seen,

realpathCache,

packageManifestCache,

});

return result;

},