bumpcheck 0.0.0-stage → 0.1.0

package/dist/npm/imports.js

@@ -0,0 +1,215 @@
+import path from 'node:path';
+import ts from 'typescript';
+import { isInside, isTargetSpecifier } from './program.js';
+export function toLocation(repoRoot, sf, node) {
+    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    return { file: relPosix(repoRoot, sf.fileName), line: line + 1, column: character + 1 };
+}
+export function relPosix(root, file) {
+    return path.relative(root, file).split(path.sep).join('/');
+}
+function specifierOf(node) {
+    return node && ts.isStringLiteralLike(node) ? node.text : undefined;
+}
+function isRequireCall(node) {
+    return (ts.isCallExpression(node) &&
+        ts.isIdentifier(node.expression) &&
+        node.expression.text === 'require' &&
+        node.arguments.length === 1 &&
+        ts.isStringLiteralLike(node.arguments[0]));
+}
+/**
+ * Finds every import of the target package in repo source files and records
+ * the exported names that are actually used. Namespace imports are followed
+ * to their member accesses; anything we cannot reduce to a name is reported
+ * as unanalyzed rather than guessed.
+ */
+export function scanImports(repoRoot, built, pkg, overlay) {
+    const { program, checker } = built;
+    const refs = new Map();
+    const unanalyzed = new Map();
+    const files = new Set();
+    const localNames = new Map();
+    const addRef = (specifier, name, loc) => {
+        const key = `${specifier}\u0000${name}`;
+        const existing = refs.get(key);
+        if (existing)
+            existing.locations.push(loc);
+        else
+            refs.set(key, { name, specifier, locations: [loc] });
+    };
+    const addUnanalyzed = (reason, loc) => {
+        const existing = unanalyzed.get(reason);
+        if (existing)
+            existing.locations.push(loc);
+        else
+            unanalyzed.set(reason, { reason, locations: [loc] });
+    };
+    const bindLocal = (sf, local, name, specifier) => {
+        let m = localNames.get(sf.fileName);
+        if (!m)
+            localNames.set(sf.fileName, (m = new Map()));
+        m.set(local, { name, specifier });
+    };
+    for (const sf of program.getSourceFiles()) {
+        if (sf.isDeclarationFile)
+            continue;
+        if (!isInside(repoRoot, sf.fileName) || isInside(overlay, sf.fileName))
+            continue;
+        if (sf.fileName.includes(`${path.sep}node_modules${path.sep}`))
+            continue;
+        /** Namespace-style bindings in this file: local symbol -> specifier. */
+        const namespaces = new Map();
+        let touched = false;
+        const visitTop = (node) => {
+            if (ts.isImportDeclaration(node)) {
+                const spec = specifierOf(node.moduleSpecifier);
+                if (!spec || !isTargetSpecifier(spec, pkg))
+                    return;
+                touched = true;
+                const clause = node.importClause;
+                if (!clause) {
+                    // Side-effect import; no symbols to track.
+                    return;
+                }
+                if (clause.name) {
+                    addRef(spec, 'default', toLocation(repoRoot, sf, clause.name));
+                    bindLocal(sf, clause.name.text, 'default', spec);
+                }
+                const nb = clause.namedBindings;
+                if (nb && ts.isNamedImports(nb)) {
+                    for (const el of nb.elements) {
+                        const exported = (el.propertyName ?? el.name).text;
+                        addRef(spec, exported, toLocation(repoRoot, sf, el));
+                        bindLocal(sf, el.name.text, exported, spec);
+                    }
+                }
+                else if (nb && ts.isNamespaceImport(nb)) {
+                    const sym = checker.getSymbolAtLocation(nb.name);
+                    if (sym)
+                        namespaces.set(sym, spec);
+                }
+                return;
+            }
+            if (ts.isImportEqualsDeclaration(node) && ts.isExternalModuleReference(node.moduleReference)) {
+                const spec = specifierOf(node.moduleReference.expression);
+                if (!spec || !isTargetSpecifier(spec, pkg))
+                    return;
+                touched = true;
+                const sym = checker.getSymbolAtLocation(node.name);
+                if (sym)
+                    namespaces.set(sym, spec);
+                return;
+            }
+            if (ts.isExportDeclaration(node)) {
+                const spec = specifierOf(node.moduleSpecifier);
+                if (!spec || !isTargetSpecifier(spec, pkg))
+                    return;
+                touched = true;
+                if (node.exportClause && ts.isNamedExports(node.exportClause)) {
+                    for (const el of node.exportClause.elements) {
+                        addRef(spec, (el.propertyName ?? el.name).text, toLocation(repoRoot, sf, el));
+                    }
+                }
+                else {
+                    addUnanalyzed(`re-exports everything from "${spec}"`, toLocation(repoRoot, sf, node));
+                }
+                return;
+            }
+            if (ts.isVariableStatement(node)) {
+                for (const decl of node.declarationList.declarations) {
+                    const init = decl.initializer;
+                    if (!init || !isRequireCall(init))
+                        continue;
+                    const spec = init.arguments[0].text;
+                    if (!isTargetSpecifier(spec, pkg))
+                        continue;
+                    touched = true;
+                    if (ts.isObjectBindingPattern(decl.name)) {
+                        for (const el of decl.name.elements) {
+                            if (el.dotDotDotToken) {
+                                addUnanalyzed(`rest-destructures "${spec}"`, toLocation(repoRoot, sf, el));
+                                continue;
+                            }
+                            const prop = el.propertyName ?? el.name;
+                            const exported = ts.isIdentifier(prop) ? prop.text : undefined;
+                            if (!exported) {
+                                addUnanalyzed(`computed destructure of "${spec}"`, toLocation(repoRoot, sf, el));
+                                continue;
+                            }
+                            addRef(spec, exported, toLocation(repoRoot, sf, el));
+                            if (ts.isIdentifier(el.name))
+                                bindLocal(sf, el.name.text, exported, spec);
+                        }
+                    }
+                    else if (ts.isIdentifier(decl.name)) {
+                        const sym = checker.getSymbolAtLocation(decl.name);
+                        if (sym)
+                            namespaces.set(sym, spec);
+                    }
+                    else {
+                        addUnanalyzed(`unusual require() binding of "${spec}"`, toLocation(repoRoot, sf, decl));
+                    }
+                }
+            }
+        };
+        ts.forEachChild(sf, visitTop);
+        // Second pass: dynamic imports, inline require().member, namespace member access.
+        const visitAll = (node) => {
+            if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+                const spec = specifierOf(node.arguments[0]);
+                if (spec && isTargetSpecifier(spec, pkg)) {
+                    touched = true;
+                    addUnanalyzed(`dynamic import("${spec}")`, toLocation(repoRoot, sf, node));
+                }
+            }
+            else if (isRequireCall(node) && !(node.parent && ts.isVariableDeclaration(node.parent))) {
+                const spec = node.arguments[0].text;
+                if (isTargetSpecifier(spec, pkg)) {
+                    touched = true;
+                    const parent = node.parent;
+                    if (parent && ts.isPropertyAccessExpression(parent) && parent.expression === node) {
+                        addRef(spec, parent.name.text, toLocation(repoRoot, sf, parent.name));
+                    }
+                    else {
+                        addUnanalyzed(`inline require("${spec}") used as a whole`, toLocation(repoRoot, sf, node));
+                    }
+                }
+            }
+            else if (ts.isIdentifier(node) && namespaces.size > 0) {
+                const sym = checker.getSymbolAtLocation(node);
+                const spec = sym ? namespaces.get(sym) : undefined;
+                if (spec) {
+                    const parent = node.parent;
+                    const isBinding = (parent && ts.isImportClause(parent)) ||
+                        (parent && ts.isNamespaceImport(parent)) ||
+                        (parent && ts.isImportEqualsDeclaration(parent)) ||
+                        (parent && ts.isVariableDeclaration(parent) && parent.name === node);
+                    if (!isBinding) {
+                        if (parent && ts.isPropertyAccessExpression(parent) && parent.expression === node) {
+                            addRef(spec, parent.name.text, toLocation(repoRoot, sf, parent.name));
+                        }
+                        else if (parent && ts.isQualifiedName(parent) && parent.left === node) {
+                            addRef(spec, parent.right.text, toLocation(repoRoot, sf, parent.right));
+                        }
+                        else {
+                            addUnanalyzed(`uses the whole module "${spec}" as a value`, toLocation(repoRoot, sf, node));
+                        }
+                    }
+                }
+            }
+            ts.forEachChild(node, visitAll);
+        };
+        visitAll(sf);
+        if (touched)
+            files.add(relPosix(repoRoot, sf.fileName));
+    }
+    const sortedRefs = [...refs.values()].sort((a, b) => a.specifier === b.specifier ? a.name.localeCompare(b.name) : a.specifier.localeCompare(b.specifier));
+    return {
+        files: [...files].sort(),
+        refs: sortedRefs,
+        unanalyzed: [...unanalyzed.values()],
+        localNames,
+    };
+}
+//# sourceMappingURL=imports.js.map

package/dist/npm/imports.js.map

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

package/dist/npm/program.d.ts

@@ -0,0 +1,32 @@
+import ts from 'typescript';
+export interface RepoConfig {
+    options: ts.CompilerOptions;
+    fileNames: string[];
+    /** Where the options came from, for the report's meta. */
+    source: 'tsconfig' | 'default';
+    /** Config problems that change what can be proven, e.g. an unresolved `extends`. */
+    warnings: string[];
+}
+export interface Target {
+    pkg: string;
+    /** Overlay root containing `node_modules/<pkg>`. */
+    overlay: string;
+}
+export interface BuiltProgram {
+    program: ts.Program;
+    checker: ts.TypeChecker;
+    /** Resolve a specifier (`pkg` or `pkg/sub`) against the overlay. */
+    resolveTarget(specifier: string): ts.ResolvedModuleWithFailedLookupLocations;
+}
+export declare function isInside(root: string, file: string): boolean;
+export declare function isTargetSpecifier(specifier: string, pkg: string): boolean;
+/** `@scope/name/sub` -> `@scope/name`; `name/sub` -> `name`; relative -> undefined. */
+export declare function packageNameOf(specifier: string): string | undefined;
+export declare function walkSources(root: string): string[];
+export declare function loadRepoConfig(repoRoot: string): RepoConfig;
+/**
+ * Builds a program over the repo where every import of the target package is
+ * resolved from the overlay instead of the repo's own node_modules. Files
+ * inside the overlay resolve normally, so the package's own dependencies work.
+ */
+export declare function buildProgram(repoRoot: string, config: RepoConfig, target: Target): BuiltProgram;

package/dist/npm/program.js

@@ -0,0 +1,187 @@
+import path from 'node:path';
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import semver from 'semver';
+import ts from 'typescript';
+const SOURCE_EXT = new Set(['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs']);
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'out', 'coverage', '.next', '.turbo']);
+export function isInside(root, file) {
+    const rel = path.relative(root, file);
+    return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+export function isTargetSpecifier(specifier, pkg) {
+    return specifier === pkg || specifier.startsWith(pkg + '/');
+}
+/** `@scope/name/sub` -> `@scope/name`; `name/sub` -> `name`; relative -> undefined. */
+export function packageNameOf(specifier) {
+    if (specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('node:'))
+        return undefined;
+    const parts = specifier.split('/');
+    return specifier.startsWith('@') ? (parts.length >= 2 ? `${parts[0]}/${parts[1]}` : undefined) : parts[0];
+}
+function readManifest(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Options we always force. We never emit, we never check library files, and
+ * we do not want incremental state leaking across the two runs.
+ */
+function sanitize(options) {
+    const out = { ...options };
+    out.noEmit = true;
+    out.skipLibCheck = true;
+    delete out.incremental;
+    delete out.composite;
+    delete out.tsBuildInfoFile;
+    delete out.outDir;
+    delete out.outFile;
+    delete out.declaration;
+    delete out.declarationDir;
+    delete out.declarationMap;
+    delete out.sourceMap;
+    delete out.emitDeclarationOnly;
+    return out;
+}
+export function walkSources(root) {
+    const out = [];
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        for (const entry of readdirSync(dir)) {
+            if (SKIP_DIRS.has(entry))
+                continue;
+            const full = path.join(dir, entry);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                stack.push(full);
+            else if (SOURCE_EXT.has(path.extname(entry)) && !entry.endsWith('.d.ts'))
+                out.push(full);
+        }
+    }
+    return out.sort();
+}
+function parseConfig(configPath) {
+    const raw = ts.readConfigFile(configPath, ts.sys.readFile);
+    if (raw.error)
+        return undefined;
+    return ts.parseJsonConfigFileContent(raw.config, ts.sys, path.dirname(configPath), undefined, configPath);
+}
+function configWarnings(configPath, parsed) {
+    return parsed.errors
+        .filter((e) => e.category === ts.DiagnosticCategory.Error)
+        .map((e) => ts.flattenDiagnosticMessageText(e.messageText, ' '))
+        .filter((m) => /extends|not found|cannot read/i.test(m))
+        .map((m) => `${path.basename(configPath)}: ${m} (analyzed without it; strictness may differ from your build)`);
+}
+/**
+ * A config that lists files is one project. A solution-style config, with
+ * `files: []` and `references` as Vite templates ship, owns no files, so the
+ * projects it references stand in for it.
+ */
+function collectProjects(configPath, seen) {
+    if (seen.has(configPath))
+        return [];
+    seen.add(configPath);
+    const parsed = parseConfig(configPath);
+    if (!parsed)
+        return [];
+    if (parsed.fileNames.length > 0) {
+        return [{ config: configPath, fileNames: parsed.fileNames, options: parsed.options, warnings: configWarnings(configPath, parsed) }];
+    }
+    return (parsed.projectReferences ?? []).flatMap((ref) => collectProjects(ts.resolveProjectReferencePath(ref), seen));
+}
+export function loadRepoConfig(repoRoot) {
+    const configPath = ts.findConfigFile(repoRoot, ts.sys.fileExists, 'tsconfig.json');
+    if (configPath && (isInside(repoRoot, configPath) || path.dirname(configPath) === repoRoot)) {
+        const projects = collectProjects(configPath, new Set());
+        const first = projects[0];
+        if (first) {
+            const warnings = projects.flatMap((p) => p.warnings);
+            if (first.config !== configPath) {
+                // tsc -b checks each referenced project with its own options. One
+                // program cannot, so the first project's options apply to all.
+                const names = projects.map((p) => path.relative(repoRoot, p.config)).join(', ');
+                warnings.push(`${path.basename(configPath)}: no files of its own; analyzed the ${projects.length} project${projects.length === 1 ? '' : 's'} it references (${names}) as one program with the options of ${path.relative(repoRoot, first.config)} (tsc -b checks each on its own; strictness may differ from your build)`);
+            }
+            const fileNames = [...new Set(projects.flatMap((p) => p.fileNames))];
+            return { options: sanitize(first.options), fileNames, source: 'tsconfig', warnings };
+        }
+    }
+    return {
+        options: sanitize({
+            allowJs: true,
+            checkJs: true,
+            strict: true,
+            target: ts.ScriptTarget.ES2022,
+            module: ts.ModuleKind.ESNext,
+            moduleResolution: ts.ModuleResolutionKind.Bundler,
+            jsx: ts.JsxEmit.Preserve,
+            esModuleInterop: true,
+            resolveJsonModule: true,
+        }),
+        fileNames: walkSources(repoRoot),
+        source: 'default',
+        warnings: [],
+    };
+}
+/**
+ * Builds a program over the repo where every import of the target package is
+ * resolved from the overlay instead of the repo's own node_modules. Files
+ * inside the overlay resolve normally, so the package's own dependencies work.
+ */
+export function buildProgram(repoRoot, config, target) {
+    const host = ts.createCompilerHost(config.options, true);
+    const anchor = path.join(target.overlay, '__bumpcheck_anchor__.ts');
+    const repoCache = ts.createModuleResolutionCache(repoRoot, host.getCanonicalFileName, config.options);
+    const overlayCache = ts.createModuleResolutionCache(target.overlay, host.getCanonicalFileName, config.options);
+    const resolveTarget = (specifier) => ts.resolveModuleName(specifier, anchor, config.options, host, overlayCache);
+    // The package's own dependencies come from the repo when the repo's
+    // installed version satisfies the declared range, which is what npm's
+    // dedupe does. Otherwise two copies of a shared dependency (say
+    // @nestjs/common) would produce "types have separate declarations" errors
+    // that no real install has.
+    const manifest = readManifest(path.join(target.overlay, 'node_modules', target.pkg, 'package.json'));
+    const ranges = {
+        ...manifest?.optionalDependencies,
+        ...manifest?.dependencies,
+        ...manifest?.peerDependencies,
+    };
+    const repoAnchor = path.join(repoRoot, '__bumpcheck_anchor__.ts');
+    const repoVersions = new Map();
+    const repoSatisfies = (name) => {
+        const range = ranges[name];
+        if (!range)
+            return false;
+        if (!repoVersions.has(name)) {
+            repoVersions.set(name, readManifest(path.join(repoRoot, 'node_modules', name, 'package.json'))?.version);
+        }
+        const version = repoVersions.get(name);
+        return !!version && semver.satisfies(version, range, { includePrerelease: true });
+    };
+    host.resolveModuleNameLiterals = (literals, containingFile, redirectedReference, options) => literals.map((lit) => {
+        const fromOverlay = isInside(target.overlay, containingFile);
+        if (isTargetSpecifier(lit.text, target.pkg) && !fromOverlay) {
+            return resolveTarget(lit.text);
+        }
+        if (fromOverlay) {
+            const dep = packageNameOf(lit.text);
+            if (dep && dep !== target.pkg && repoSatisfies(dep)) {
+                return ts.resolveModuleName(lit.text, repoAnchor, options, host, repoCache, redirectedReference);
+            }
+        }
+        return ts.resolveModuleName(lit.text, containingFile, options, host, repoCache, redirectedReference);
+    });
+    const program = ts.createProgram({ rootNames: config.fileNames, options: config.options, host });
+    return { program, checker: program.getTypeChecker(), resolveTarget };
+}
+//# sourceMappingURL=program.js.map

package/dist/npm/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/npm/program.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,YAAY,CAAC;AAwB5B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE3G,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAY;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,GAAW;IAC9D,OAAO,SAAS,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9G,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AASD,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,OAA2B;IAC3C,MAAM,GAAG,GAAuB,EAAE,GAAG,OAAO,EAAE,CAAC;IAC/C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;IACxB,OAAO,GAAG,CAAC,WAAW,CAAC;IACvB,OAAO,GAAG,CAAC,SAAS,CAAC;IACrB,OAAO,GAAG,CAAC,eAAe,CAAC;IAC3B,OAAO,GAAG,CAAC,MAAM,CAAC;IAClB,OAAO,GAAG,CAAC,OAAO,CAAC;IACnB,OAAO,GAAG,CAAC,WAAW,CAAC;IACvB,OAAO,GAAG,CAAC,cAAc,CAAC;IAC1B,OAAO,GAAG,CAAC,cAAc,CAAC;IAC1B,OAAO,GAAG,CAAC,SAAS,CAAC;IACrB,OAAO,GAAG,CAAC,mBAAmB,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,IAAI,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,EAAE,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBAClC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB;IACrC,MAAM,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC5G,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB,EAAE,MAA4B;IACtE,OAAO,MAAM,CAAC,MAAM;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC;SACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;SAC/D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;AACnH,CAAC;AASD;;;;GAIG;AACH,SAAS,eAAe,CAAC,UAAkB,EAAE,IAAiB;IAC5D,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACtI,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACnF,IAAI,UAAU,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5F,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACrD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChC,kEAAkE;gBAClE,+DAA+D;gBAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChF,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,uCAAuC,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,KAAK,wCAAwC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,yEAAyE,CAC5S,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC;YAChB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;YAC9B,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;YAC5B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO;YACjD,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;YACxB,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,IAAI;SACxB,CAAC;QACF,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAkB,EAAE,MAAc;IAC/E,MAAM,IAAI,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,EAAE,CAAC,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACtG,MAAM,YAAY,GAAG,EAAE,CAAC,2BAA2B,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/G,MAAM,aAAa,GAAG,CAAC,SAAiB,EAA8C,EAAE,CACtF,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAE9E,oEAAoE;IACpE,sEAAsE;IACtE,gEAAgE;IAChE,0EAA0E;IAC1E,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACrG,MAAM,MAAM,GAA2B;QACrC,GAAG,QAAQ,EAAE,oBAAoB;QACjC,GAAG,QAAQ,EAAE,YAAY;QACzB,GAAG,QAAQ,EAAE,gBAAgB;KAC9B,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC3D,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3G,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC;IAEF,IAAI,CAAC,yBAAyB,GAAG,CAAC,QAAQ,EAAE,cAAc,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,CAC1F,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC7D,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5D,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,GAAG,IAAI,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,OAAO,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;YACnG,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,CAAC;AACvE,CAAC"}

package/dist/registry/provider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A PackageProvider materializes `<pkg>@<version>` into an overlay directory
+ * shaped like `<overlay>/node_modules/<pkg>/...`, with the package's own
+ * dependencies installed beside it so its declaration files resolve.
+ *
+ * Returning the overlay root (not the package dir) lets TypeScript's normal
+ * node_modules walk do the rest.
+ */
+export interface PackageProvider {
+    ensure(pkg: string, version: string): Promise<string>;
+}
+export interface NpmProviderOptions {
+    cacheDir?: string;
+    registry?: string;
+    /** Override for tests or exotic setups. Defaults to `npm` on PATH. */
+    npmBinary?: string;
+}
+/**
+ * Installs the exact version with npm into a per-version overlay and caches it.
+ * Scripts never run. Peer dependencies are installed so declaration files
+ * that import them still resolve.
+ */
+export declare class NpmProvider implements PackageProvider {
+    private readonly cacheDir;
+    private readonly registry;
+    private readonly npm;
+    private readonly inflight;
+    constructor(opts?: NpmProviderOptions);
+    ensure(pkg: string, version: string): Promise<string>;
+    private install;
+}
+/** `@scope/name` becomes `@types/scope__name`, as DefinitelyTyped does. */
+export declare function definitelyTypedName(pkg: string): string;
+/**
+ * Copies a local directory into an overlay. Used by tests and for air-gapped
+ * runs where the package contents are already on disk.
+ */
+export interface LocalSource {
+    dir: string;
+    /** Extra packages to place beside it in the overlay, as a real install would. */
+    deps?: Record<string, string>;
+}
+export declare class LocalProvider implements PackageProvider {
+    private readonly sources;
+    private readonly workDir;
+    private readonly inflight;
+    constructor(sources: Record<string, string | LocalSource>, workDir: string);
+    ensure(pkg: string, version: string): Promise<string>;
+    private materialize;
+}