app-builder-lib 26.4.0 → 26.5.0

package/out/node-module-collector/moduleManager.d.ts

@@ -0,0 +1,52 @@
+import { PackageJson } from "./types";
+import * as fs from "fs-extra";
+export type Package = {
+    packageDir: string;
+    packageJson: PackageJson;
+};
+type JsonCache = Record<string, Promise<PackageJson | null>>;
+type RealPathCache = Record<string, Promise<string>>;
+type ExistsCache = Record<string, Promise<boolean>>;
+type LstatCache = Record<string, Promise<fs.Stats | null>>;
+type PackageCache = Record<string, Promise<Package | null>>;
+export declare class ModuleManager {
+    /** Cache for package.json contents (readJson) */
+    readonly json: JsonCache;
+    /** Cache for resolved real paths (if symlink, realpath; otherwise resolve) */
+    readonly realPath: RealPathCache;
+    /** Cache for file/directory existence checks */
+    readonly exists: ExistsCache;
+    /** Cache for lstat results */
+    readonly lstat: LstatCache;
+    /** Cache for package lookups (key: "packageName||fromDir||semverRange"). Use helper function `versionedCacheKey` */
+    readonly packageData: PackageCache;
+    private readonly jsonMap;
+    private readonly realPathMap;
+    private readonly existsMap;
+    private readonly lstatMap;
+    private readonly packageDataMap;
+    constructor();
+    private createAsyncProxy;
+    versionedCacheKey(pkg: {
+        name: string;
+        path: string;
+        semver?: string;
+    }): string;
+    protected locatePackageVersionFromCacheKey(key: string): Promise<Package | null>;
+    locatePackageVersion({ parentDir, pkgName, requiredRange }: {
+        parentDir: string;
+        pkgName: string;
+        requiredRange?: string;
+    }): Promise<Package | null>;
+    private semverSatisfies;
+    /**
+     * Upward search (hoisted)
+     */
+    private upwardSearch;
+    /**
+     * Breadth-first downward search from parentDir/node_modules
+     * Looks for node_modules/\*\/node_modules/pkgName (and deeper)
+     */
+    private downwardSearch;
+}
+export {};

package/out/node-module-collector/moduleManager.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleManager = void 0;
+const builder_util_1 = require("builder-util");
+const fs = require("fs-extra");
+const path = require("path");
+const semver = require("semver");
+class ModuleManager {
+    constructor() {
+        this.jsonMap = new Map();
+        this.realPathMap = new Map();
+        this.existsMap = new Map();
+        this.lstatMap = new Map();
+        this.packageDataMap = new Map();
+        this.exists = this.createAsyncProxy(this.existsMap, (p) => (0, builder_util_1.exists)(p));
+        this.json = this.createAsyncProxy(this.jsonMap, (p) => fs.readJson(p).catch(() => null));
+        this.lstat = this.createAsyncProxy(this.lstatMap, (p) => fs.lstat(p).catch(() => null));
+        this.packageData = this.createAsyncProxy(this.packageDataMap, (p) => this.locatePackageVersionFromCacheKey(p).catch(() => null));
+        this.realPath = this.createAsyncProxy(this.realPathMap, async (p) => {
+            const filePath = path.resolve(p);
+            const stat = await this.lstat[filePath];
+            return (stat === null || stat === void 0 ? void 0 : stat.isSymbolicLink()) ? fs.realpath(filePath) : filePath;
+        });
+    }
+    // this allows dot-notation access while still supporting async retrieval
+    // e.g., cache.packageJson[somePath] returns Promise<PackageJson>
+    createAsyncProxy(map, compute) {
+        return new Proxy({}, {
+            async get(_, key) {
+                if (map.has(key)) {
+                    return Promise.resolve(map.get(key));
+                }
+                return await Promise.resolve(compute(key)).then(value => {
+                    map.set(key, value);
+                    return value;
+                });
+            },
+            set(_, key, value) {
+                map.set(key, value);
+                return true;
+            },
+            has(_, key) {
+                return map.has(key);
+            },
+        });
+    }
+    versionedCacheKey(pkg) {
+        return [pkg.name, pkg.path, pkg.semver || ""].join("||");
+    }
+    async locatePackageVersionFromCacheKey(key) {
+        const [name, fromDir, semverRange] = key.split("||");
+        const result = await this.locatePackageVersion({ parentDir: fromDir, pkgName: name, requiredRange: semverRange });
+        if (result == null) {
+            return null;
+        }
+        return { ...result, packageDir: await this.realPath[result.packageDir] };
+    }
+    async locatePackageVersion({ parentDir, pkgName, requiredRange }) {
+        // 1) check direct parent node_modules/pkgName first
+        const direct = path.join(path.resolve(parentDir), "node_modules", pkgName, "package.json");
+        if (await this.exists[direct]) {
+            const json = await this.json[direct];
+            if (json && this.semverSatisfies(json.version, requiredRange)) {
+                return { packageDir: path.dirname(direct), packageJson: json };
+            }
+        }
+        // 2) upward hoisted search, then 3) downward non-hoisted search
+        return (await this.upwardSearch(parentDir, pkgName, requiredRange)) || (await this.downwardSearch(parentDir, pkgName, requiredRange)) || null;
+    }
+    semverSatisfies(found, range) {
+        if ((0, builder_util_1.isEmptyOrSpaces)(range) || range === "*") {
+            return true;
+        }
+        if (range === found) {
+            return true;
+        }
+        if (semver.validRange(range) == null) {
+            // ignore, we can't verify non-semver ranges
+            // e.g. git urls, file:, patch:, etc. Example:
+            // "@ai-sdk/google": "patch:@ai-sdk/google@npm%3A2.0.43#~/.yarn/patches/@ai-sdk-google-npm-2.0.43-689ed559b3.patch"
+            builder_util_1.log.debug({ found, range }, "unable to validate semver version range, assuming match");
+            return true;
+        }
+        try {
+            return semver.satisfies(found, range);
+        }
+        catch {
+            // fallback: simple equality or basic prefix handling (^, ~)
+            if (range.startsWith("^") || range.startsWith("~")) {
+                const r = range.slice(1);
+                return r === found;
+            }
+            // if range is like "8.x" or "8.*" match major
+            const m = range.match(/^(\d+)[.(*|x)]*/);
+            const fm = found.match(/^(\d+)\./);
+            if (m && fm) {
+                return m[1] === fm[1];
+            }
+            return false;
+        }
+    }
+    /**
+     * Upward search (hoisted)
+     */
+    async upwardSearch(parentDir, pkgName, requiredRange) {
+        let current = path.resolve(parentDir);
+        const root = path.parse(current).root;
+        while (true) {
+            const candidate = path.join(current, "node_modules", pkgName, "package.json");
+            if (await this.exists[candidate]) {
+                const json = await this.json[candidate];
+                if (json && this.semverSatisfies(json.version, requiredRange)) {
+                    return { packageDir: path.dirname(candidate), packageJson: json };
+                }
+                // otherwise keep searching upward (we may find a different hoisted version)
+            }
+            if (current === root) {
+                break;
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                break;
+            }
+            current = parent;
+        }
+        return null;
+    }
+    /**
+     * Breadth-first downward search from parentDir/node_modules
+     * Looks for node_modules/\*\/node_modules/pkgName (and deeper)
+     */
+    async downwardSearch(parentDir, pkgName, requiredRange, maxExplored = 2000, maxDepth = 6) {
+        var _a, _b, _c, _d;
+        const start = path.join(path.resolve(parentDir), "node_modules");
+        if (!(await this.exists[start]) || !((_a = (await this.lstat[start])) === null || _a === void 0 ? void 0 : _a.isDirectory())) {
+            return null;
+        }
+        const visited = new Set();
+        const queue = [{ dir: start, depth: 0 }];
+        let explored = 0;
+        while (queue.length > 0) {
+            const { dir, depth } = queue.shift();
+            if (explored++ > maxExplored) {
+                break;
+            }
+            if (depth > maxDepth) {
+                continue;
+            }
+            let entries;
+            try {
+                entries = await fs.readdir(dir);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (entry.startsWith(".")) {
+                    continue;
+                }
+                const entryPath = path.join(dir, entry);
+                // handle scoped packages @scope/name
+                if (entry.startsWith("@")) {
+                    // queue the scope directory itself to explore its children
+                    if ((await this.exists[entryPath]) && ((_b = (await this.lstat[entryPath])) === null || _b === void 0 ? void 0 : _b.isDirectory())) {
+                        const scopeEntries = await fs.readdir(entryPath);
+                        for (const sc of scopeEntries) {
+                            const scPath = path.join(entryPath, sc);
+                            // check scPath/node_modules/pkgName
+                            const candidatePkgJson = path.join(scPath, "node_modules", pkgName, "package.json");
+                            if (await this.exists[candidatePkgJson]) {
+                                const json = await this.json[candidatePkgJson];
+                                if (json && this.semverSatisfies(json.version, requiredRange)) {
+                                    return { packageDir: path.dirname(candidatePkgJson), packageJson: json };
+                                }
+                            }
+                            // enqueue scPath/node_modules to explore further
+                            const scNodeModules = path.join(scPath, "node_modules");
+                            if ((await this.exists[scNodeModules]) && ((_c = (await this.lstat[scNodeModules])) === null || _c === void 0 ? void 0 : _c.isDirectory())) {
+                                if (!visited.has(scNodeModules)) {
+                                    visited.add(scNodeModules);
+                                    queue.push({ dir: scNodeModules, depth: depth + 1 });
+                                }
+                            }
+                        }
+                    }
+                    continue;
+                }
+                // check for direct candidate: entry/node_modules/pkgName
+                try {
+                    const stat = await this.lstat[entryPath];
+                    if (!(stat === null || stat === void 0 ? void 0 : stat.isDirectory())) {
+                        continue;
+                    }
+                }
+                catch {
+                    continue;
+                }
+                const candidatePkgJson = path.join(entryPath, "node_modules", pkgName, "package.json");
+                if (await this.exists[candidatePkgJson]) {
+                    const json = await this.json[candidatePkgJson];
+                    if (json && this.semverSatisfies(json.version, requiredRange)) {
+                        return { packageDir: path.dirname(candidatePkgJson), packageJson: json };
+                    }
+                }
+                // also check entry/node_modules directly for pkgName (some layouts)
+                const candidateDirect = path.join(entryPath, pkgName, "package.json");
+                if (await this.exists[candidateDirect]) {
+                    const json = await this.json[candidateDirect];
+                    if (json && this.semverSatisfies(json.version, requiredRange)) {
+                        return { packageDir: path.dirname(candidateDirect), packageJson: json };
+                    }
+                }
+                // enqueue entry/node_modules for deeper traversal
+                const nextNodeModules = path.join(entryPath, "node_modules");
+                if ((await this.exists[nextNodeModules]) && ((_d = (await this.lstat[nextNodeModules])) === null || _d === void 0 ? void 0 : _d.isDirectory())) {
+                    if (!visited.has(nextNodeModules)) {
+                        visited.add(nextNodeModules);
+                        queue.push({ dir: nextNodeModules, depth: depth + 1 });
+                    }
+                }
+            }
+        }
+        return null;
+    }
+}
+exports.ModuleManager = ModuleManager;
+//# sourceMappingURL=moduleManager.js.map

package/out/node-module-collector/moduleManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleManager.js","sourceRoot":"","sources":["../../src/node-module-collector/moduleManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { exists, isEmptyOrSpaces, log } from \"builder-util\"\nimport { PackageJson } from \"./types\"\nimport * as fs from \"fs-extra\"\nimport * as path from \"path\"\nimport * as semver from \"semver\"\n\nexport type Package = { packageDir: string; packageJson: PackageJson }\n\n// Type aliases for clarity\ntype JsonCache = Record<string, Promise<PackageJson | null>>\ntype RealPathCache = Record<string, Promise<string>>\ntype ExistsCache = Record<string, Promise<boolean>>\ntype LstatCache = Record<string, Promise<fs.Stats | null>>\ntype PackageCache = Record<string, Promise<Package | null>>\n\nexport class ModuleManager {\n  /** Cache for package.json contents (readJson) */\n  readonly json: JsonCache\n  /** Cache for resolved real paths (if symlink, realpath; otherwise resolve) */\n  readonly realPath: RealPathCache\n  /** Cache for file/directory existence checks */\n  readonly exists: ExistsCache\n  /** Cache for lstat results */\n  readonly lstat: LstatCache\n  /** Cache for package lookups (key: \"packageName||fromDir||semverRange\"). Use helper function `versionedCacheKey` */\n  readonly packageData: PackageCache\n\n  private readonly jsonMap: Map<string, PackageJson | null> = new Map()\n  private readonly realPathMap: Map<string, string> = new Map()\n  private readonly existsMap: Map<string, boolean> = new Map()\n  private readonly lstatMap: Map<string, fs.Stats | null> = new Map()\n  private readonly packageDataMap: Map<string, Package | null> = new Map()\n\n  constructor() {\n    this.exists = this.createAsyncProxy(this.existsMap, (p: string) => exists(p))\n    this.json = this.createAsyncProxy(this.jsonMap, (p: string) => fs.readJson(p).catch(() => null))\n    this.lstat = this.createAsyncProxy(this.lstatMap, (p: string) => fs.lstat(p).catch(() => null))\n    this.packageData = this.createAsyncProxy(this.packageDataMap, (p: string) => this.locatePackageVersionFromCacheKey(p).catch(() => null))\n    this.realPath = this.createAsyncProxy(this.realPathMap, async (p: string) => {\n      const filePath = path.resolve(p)\n      const stat = await this.lstat[filePath]\n      return stat?.isSymbolicLink() ? fs.realpath(filePath) : filePath\n    })\n  }\n\n  // this allows dot-notation access while still supporting async retrieval\n  // e.g., cache.packageJson[somePath] returns Promise<PackageJson>\n  private createAsyncProxy<T>(map: Map<string, T>, compute: (key: string) => T | Promise<T>): Record<string, Promise<T>> {\n    return new Proxy({} as Record<string, Promise<T>>, {\n      async get(_, key: string) {\n        if (map.has(key)) {\n          return Promise.resolve(map.get(key)!)\n        }\n        return await Promise.resolve(compute(key)).then(value => {\n          map.set(key, value)\n          return value\n        })\n      },\n      set(_, key: string, value: T) {\n        map.set(key, value)\n        return true\n      },\n      has(_, key: string) {\n        return map.has(key)\n      },\n    })\n  }\n\n  versionedCacheKey(pkg: { name: string; path: string; semver?: string }): string {\n    return [pkg.name, pkg.path, pkg.semver || \"\"].join(\"||\")\n  }\n\n  protected async locatePackageVersionFromCacheKey(key: string): Promise<Package | null> {\n    const [name, fromDir, semverRange] = key.split(\"||\")\n    const result = await this.locatePackageVersion({ parentDir: fromDir, pkgName: name, requiredRange: semverRange })\n    if (result == null) {\n      return null\n    }\n    return { ...result, packageDir: await this.realPath[result.packageDir] }\n  }\n\n  public async locatePackageVersion({ parentDir, pkgName, requiredRange }: { parentDir: string; pkgName: string; requiredRange?: string }): Promise<Package | null> {\n    // 1) check direct parent node_modules/pkgName first\n    const direct = path.join(path.resolve(parentDir), \"node_modules\", pkgName, \"package.json\")\n    if (await this.exists[direct]) {\n      const json = await this.json[direct]\n      if (json && this.semverSatisfies(json.version, requiredRange)) {\n        return { packageDir: path.dirname(direct), packageJson: json }\n      }\n    }\n\n    // 2) upward hoisted search, then 3) downward non-hoisted search\n    return (await this.upwardSearch(parentDir, pkgName, requiredRange)) || (await this.downwardSearch(parentDir, pkgName, requiredRange)) || null\n  }\n\n  private semverSatisfies(found: string, range?: string): boolean {\n    if (isEmptyOrSpaces(range) || range === \"*\") {\n      return true\n    }\n\n    if (range === found) {\n      return true\n    }\n\n    if (semver.validRange(range) == null) {\n      // ignore, we can't verify non-semver ranges\n      // e.g. git urls, file:, patch:, etc. Example:\n      // \"@ai-sdk/google\": \"patch:@ai-sdk/google@npm%3A2.0.43#~/.yarn/patches/@ai-sdk-google-npm-2.0.43-689ed559b3.patch\"\n      log.debug({ found, range }, \"unable to validate semver version range, assuming match\")\n      return true\n    }\n\n    try {\n      return semver.satisfies(found, range)\n    } catch {\n      // fallback: simple equality or basic prefix handling (^, ~)\n      if (range.startsWith(\"^\") || range.startsWith(\"~\")) {\n        const r = range.slice(1)\n        return r === found\n      }\n      // if range is like \"8.x\" or \"8.*\" match major\n      const m = range.match(/^(\\d+)[.(*|x)]*/)\n      const fm = found.match(/^(\\d+)\\./)\n      if (m && fm) {\n        return m[1] === fm[1]\n      }\n      return false\n    }\n  }\n\n  /**\n   * Upward search (hoisted)\n   */\n  private async upwardSearch(parentDir: string, pkgName: string, requiredRange?: string): Promise<Package | null> {\n    let current = path.resolve(parentDir)\n    const root = path.parse(current).root\n    while (true) {\n      const candidate = path.join(current, \"node_modules\", pkgName, \"package.json\")\n      if (await this.exists[candidate]) {\n        const json = await this.json[candidate]\n        if (json && this.semverSatisfies(json.version, requiredRange)) {\n          return { packageDir: path.dirname(candidate), packageJson: json }\n        }\n        // otherwise keep searching upward (we may find a different hoisted version)\n      }\n      if (current === root) {\n        break\n      }\n      const parent = path.dirname(current)\n      if (parent === current) {\n        break\n      }\n      current = parent\n    }\n    return null\n  }\n\n  /**\n   * Breadth-first downward search from parentDir/node_modules\n   * Looks for node_modules/\\*\\/node_modules/pkgName (and deeper)\n   */\n  private async downwardSearch(parentDir: string, pkgName: string, requiredRange?: string, maxExplored = 2000, maxDepth = 6): Promise<Package | null> {\n    const start = path.join(path.resolve(parentDir), \"node_modules\")\n    if (!(await this.exists[start]) || !(await this.lstat[start])?.isDirectory()) {\n      return null\n    }\n\n    const visited = new Set<string>()\n    const queue: Array<{ dir: string; depth: number }> = [{ dir: start, depth: 0 }]\n    let explored = 0\n\n    while (queue.length > 0) {\n      const { dir, depth } = queue.shift()!\n      if (explored++ > maxExplored) {\n        break\n      }\n      if (depth > maxDepth) {\n        continue\n      }\n      let entries: string[]\n      try {\n        entries = await fs.readdir(dir)\n      } catch {\n        continue\n      }\n      for (const entry of entries) {\n        if (entry.startsWith(\".\")) {\n          continue\n        }\n        const entryPath = path.join(dir, entry)\n        // handle scoped packages @scope/name\n        if (entry.startsWith(\"@\")) {\n          // queue the scope directory itself to explore its children\n          if ((await this.exists[entryPath]) && (await this.lstat[entryPath])?.isDirectory()) {\n            const scopeEntries = await fs.readdir(entryPath)\n            for (const sc of scopeEntries) {\n              const scPath = path.join(entryPath, sc)\n              // check scPath/node_modules/pkgName\n              const candidatePkgJson = path.join(scPath, \"node_modules\", pkgName, \"package.json\")\n              if (await this.exists[candidatePkgJson]) {\n                const json = await this.json[candidatePkgJson]\n                if (json && this.semverSatisfies(json.version, requiredRange)) {\n                  return { packageDir: path.dirname(candidatePkgJson), packageJson: json }\n                }\n              }\n              // enqueue scPath/node_modules to explore further\n              const scNodeModules = path.join(scPath, \"node_modules\")\n              if ((await this.exists[scNodeModules]) && (await this.lstat[scNodeModules])?.isDirectory()) {\n                if (!visited.has(scNodeModules)) {\n                  visited.add(scNodeModules)\n                  queue.push({ dir: scNodeModules, depth: depth + 1 })\n                }\n              }\n            }\n          }\n          continue\n        }\n\n        // check for direct candidate: entry/node_modules/pkgName\n        try {\n          const stat = await this.lstat[entryPath]\n          if (!stat?.isDirectory()) {\n            continue\n          }\n        } catch {\n          continue\n        }\n\n        const candidatePkgJson = path.join(entryPath, \"node_modules\", pkgName, \"package.json\")\n        if (await this.exists[candidatePkgJson]) {\n          const json = await this.json[candidatePkgJson]\n          if (json && this.semverSatisfies(json.version, requiredRange)) {\n            return { packageDir: path.dirname(candidatePkgJson), packageJson: json }\n          }\n        }\n\n        // also check entry/node_modules directly for pkgName (some layouts)\n        const candidateDirect = path.join(entryPath, pkgName, \"package.json\")\n        if (await this.exists[candidateDirect]) {\n          const json = await this.json[candidateDirect]\n          if (json && this.semverSatisfies(json.version, requiredRange)) {\n            return { packageDir: path.dirname(candidateDirect), packageJson: json }\n          }\n        }\n\n        // enqueue entry/node_modules for deeper traversal\n        const nextNodeModules = path.join(entryPath, \"node_modules\")\n        if ((await this.exists[nextNodeModules]) && (await this.lstat[nextNodeModules])?.isDirectory()) {\n          if (!visited.has(nextNodeModules)) {\n            visited.add(nextNodeModules)\n            queue.push({ dir: nextNodeModules, depth: depth + 1 })\n          }\n        }\n      }\n    }\n\n    return null\n  }\n}\n"]}

package/out/node-module-collector/nodeModulesCollector.d.ts

@@ -1,24 +1,33 @@
 import { TmpDir } from "builder-util";
-import { CancellationToken } from "builder-util-runtime";
 import { Lazy } from "lazy-val";
-import { ModuleCache } from "./moduleCache";
+import { ModuleManager } from "./moduleManager";
 import { PM } from "./packageManager";
-import type { Dependency, DependencyGraph, NodeModuleInfo } from "./types";
-type Result = {
-    packageDir: string;
-    version: string;
-} | null;
+import type { Dependency, DependencyGraph, NodeModuleInfo, PackageJson } from "./types";
 export declare abstract class NodeModulesCollector<ProdDepType extends Dependency<ProdDepType, OptionalDepType>, OptionalDepType> {
     protected readonly rootDir: string;
     private readonly tempDirManager;
     private readonly nodeModules;
     protected readonly allDependencies: Map<string, ProdDepType>;
     protected readonly productionGraph: DependencyGraph;
-    protected readonly cache: ModuleCache;
+    protected readonly cache: ModuleManager;
     protected isHoisted: Lazy<boolean>;
     constructor(rootDir: string, tempDirManager: TmpDir);
-    getNodeModules({ cancellationToken, packageName }: {
-        cancellationToken: CancellationToken;
+    /**
+     * Retrieves and collects all Node.js modules for a given package.
+     *
+     * This method orchestrates the entire module collection process by:
+     * 1. Fetching the dependency tree from the package manager
+     * 2. Collecting all dependencies recursively
+     * 3. Extracting workspace references if applicable
+     * 4. Building a production dependency graph
+     * 5. Hoisting the dependencies to their final locations
+     * 6. Resolving and returning module information
+     *
+     * @param options - Configuration object
+     * @param options.packageName - The name of the package to collect modules for
+     * @returns Promise resolving to an array of NodeModuleInfo objects representing all collected modules
+     */
+    getNodeModules({ packageName }: {
         packageName: string;
     }): Promise<NodeModuleInfo[]>;
     abstract readonly installOptions: {
@@ -26,20 +35,81 @@ export declare abstract class NodeModulesCollector<ProdDepType extends Dependenc
         lockfile: string;
     };
     protected abstract getArgs(): string[];
-    protected abstract parseDependenciesTree(jsonBlob: string): Promise<ProdDepType>;
     protected abstract extractProductionDependencyGraph(tree: Dependency<ProdDepType, OptionalDepType>, dependencyId: string): Promise<void>;
     protected abstract collectAllDependencies(tree: Dependency<ProdDepType, OptionalDepType>, appPackageName: string): Promise<void>;
+    /**
+     * Retrieves the dependency tree from the package manager.
+     *
+     * Executes the appropriate package manager command to fetch the dependency tree and writes
+     * the output to a temporary file. Includes retry logic to handle transient failures such as
+     * incomplete JSON output or missing files. Will retry up to 1 time with exponential backoff.
+     *
+     * @param pm - The package manager to use (npm, yarn, pnpm, etc.)
+     * @returns Promise resolving to the parsed dependency tree
+     * @throws {Error} If the dependency tree cannot be retrieved after retries
+     */
     protected getDependenciesTree(pm: PM): Promise<ProdDepType>;
+    /**
+     * Parses the dependencies tree from shell command output.
+     *
+     **/
+    protected parseDependenciesTree(shellOutput: string): ProdDepType | Promise<ProdDepType>;
+    /**
+     *
+     * This method attempts to extract and parse JSON data from shell output that may contain
+     * additional non-JSON content (like warnings or informational messages). It first tries
+     * to parse the entire output as JSON, and if that fails, it intelligently searches for
+     * JSON content within the output by:
+     * 1. Finding the first line that starts with `{` or `[`
+     * 2. Tracking bracket depth to find the matching closing bracket
+     * 3. Extracting only the valid JSON portion
+     *
+     * @param shellOutput - The raw output from a shell command, potentially containing JSON
+     * @returns The parsed dependencies tree object
+     * @throws {Error} If no JSON content is found in the output
+     * @throws {Error} If no matching closing bracket is found in the output
+     * @throws {SyntaxError} If the extracted content is not valid JSON
+     */
+    protected extractJsonFromPollutedOutput<T>(shellOutput: string): T;
     protected cacheKey(pkg: Pick<ProdDepType, "name" | "version" | "path">): string;
     protected packageVersionString(pkg: Pick<ProdDepType, "name" | "version">): string;
+    /**
+     * Determines if a given dependency is a production dependency of a package.
+     *
+     * Checks both the dependencies and optionalDependencies of a package to see if
+     * the specified dependency name is listed.
+     *
+     * @param depName - The name of the dependency to check
+     * @param pkg - The package to search for the dependency in
+     * @returns True if the dependency is found in either dependencies or optionalDependencies, false otherwise
+     */
     protected isProdDependency(depName: string, pkg: ProdDepType): boolean;
+    protected locatePackageWithVersion(depTree: Pick<ProdDepType, "name" | "version" | "path">): Promise<{
+        packageDir: string;
+        packageJson: PackageJson;
+    } | null>;
     /**
-     * Parse a dependency identifier like "@scope/pkg@1.2.3" or "pkg@1.2.3"
+     * Parses a dependency identifier string into name and version components.
+     *
+     * Handles both scoped packages (e.g., "@scope/pkg@1.2.3") and regular packages (e.g., "pkg@1.2.3").
+     * If the identifier is malformed or cannot be parsed, defaults to treating the entire string as
+     * the package name with an "unknown" version.
      */
     protected parseNameVersion(identifier: string): {
         name: string;
         version: string;
     };
+    /**
+     * Retrieves the dependency tree and handles workspace package self-references.
+     *
+     * If the project is a workspace project, this method removes the root package's self-reference
+     * from the dependency tree to avoid circular dependencies. It promotes the root package's
+     * direct dependencies to the top level of the tree.
+     *
+     * @param tree - The original dependency tree
+     * @param packageName - The name of the package to check for and remove from the tree
+     * @returns Promise resolving to the pruned dependency tree
+     */
     protected getTreeFromWorkspaces(tree: ProdDepType, packageName: string): Promise<ProdDepType>;
     private transformToHoisterTree;
     private _getNodeModules;
@@ -47,18 +117,21 @@ export declare abstract class NodeModulesCollector<ProdDepType extends Dependenc
         stdout: string | undefined;
         stderr: string | undefined;
     }>;
-    streamCollectorCommandToFile(command: string, args: string[], cwd: string, tempOutputFile: string): Promise<void>;
-    protected locatePackageVersion(parentDir: string, pkgName: string, requiredRange?: string): Promise<Result | null>;
-    protected readPackageVersion(pkgJsonPath: string): Promise<string | null>;
-    protected semverSatisfies(found: string, range?: string): boolean;
     /**
-     * Upward search (hoisted)
+     * Executes a command and streams its output to a file.
+     *
+     * Spawns a child process to execute the specified command with arguments, capturing stdout
+     * to a file. Handles Windows-specific quirks by wrapping .cmd files in a temporary .bat file
+     * when necessary. Enables corepack strict mode by default but allows process.env overrides.
+     *
+     * Special handling for `npm list` exit code 1, which is expected in certain scenarios.
+     *
+     * @param command - The command to execute
+     * @param args - Array of command-line arguments
+     * @param cwd - The working directory to execute the command in
+     * @param tempOutputFile - The path to the temporary file where stdout will be written
+     * @returns Promise that resolves when the command completes successfully or rejects if it fails
+     * @throws {Error} If the child process spawn fails or exits with a non-zero code
      */
-    private upwardSearch;
-    /**
-     * Breadth-first downward search from parentDir/node_modules
-     * Looks for node_modules/\*\/node_modules/pkgName (and deeper)
-     */
-    private downwardSearch;
+    streamCollectorCommandToFile(command: string, args: string[], cwd: string, tempOutputFile: string): Promise<void>;
 }
-export {};