@ohos-ports/nx 23.2.1-beta.0 → 23.3.0-beta.0

package/dist/src/utils/package-json.d.ts

@@ -0,0 +1,256 @@
+import { NxJsonConfiguration } from '../config/nx-json';
+import { ProjectConfiguration, ProjectMetadata, TargetConfiguration } from '../config/workspace-json-project-json';
+import type { Tree } from '../generators/tree';
+import { PackageManager, PackageManagerCommands } from './package-manager';
+export interface NxProjectPackageJsonConfiguration extends Partial<ProjectConfiguration> {
+    includedScripts?: string[];
+}
+export type ArrayPackageGroup = {
+    package: string;
+    version: string;
+}[];
+export type MixedPackageGroup = (string | {
+    package: string;
+    version: string;
+})[] | Record<string, string>;
+export type PackageGroup = MixedPackageGroup | ArrayPackageGroup;
+export type PackageJsonDependencySection = 'dependencies' | 'devDependencies' | 'peerDependencies' | 'optionalDependencies';
+export interface NxMigrationsConfiguration {
+    migrations?: string;
+    packageGroup?: PackageGroup;
+    /** Signals the package supports `nx migrate --include`. */
+    supportsOptionalMigrations?: boolean;
+}
+type PackageOverride = {
+    [key: string]: string | PackageOverride;
+};
+export interface PackageJson {
+    name: string;
+    version: string;
+    license?: string;
+    private?: boolean;
+    scripts?: Record<string, string>;
+    type?: 'module' | 'commonjs';
+    main?: string;
+    types?: string;
+    typings?: string;
+    module?: string;
+    exports?: string | Record<string, string | {
+        types?: string;
+        require?: string;
+        import?: string;
+        development?: string;
+        default?: string;
+    }>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional: boolean;
+    }>;
+    resolutions?: Record<string, string>;
+    pnpm?: {
+        overrides?: PackageOverride;
+        onlyBuiltDependencies?: string[];
+        neverBuiltDependencies?: string[];
+        allowBuilds?: Record<string, boolean>;
+        supportedArchitectures?: {
+            os?: string[];
+            cpu?: string[];
+            libc?: string[];
+        };
+        ignoredOptionalDependencies?: string[];
+        packageExtensions?: Record<string, unknown>;
+        patchedDependencies?: Record<string, string>;
+    };
+    overrides?: PackageOverride;
+    allowScripts?: Record<string, boolean>;
+    bin?: Record<string, string> | string;
+    workspaces?: string[] | {
+        packages: string[];
+    };
+    publishConfig?: Record<string, string>;
+    files?: string[];
+    nx?: NxProjectPackageJsonConfiguration;
+    generators?: string;
+    schematics?: string;
+    builders?: string;
+    executors?: string;
+    'nx-migrations'?: string | NxMigrationsConfiguration;
+    'ng-update'?: string | NxMigrationsConfiguration;
+    packageManager?: string;
+    description?: string;
+    keywords?: string[];
+}
+export interface NxPackageJson extends PackageJson {
+    'nx-migrations'?: {
+        migrations?: string;
+        packageGroup?: (string | {
+            package: string;
+            version: string;
+        })[];
+        supportsOptionalMigrations?: boolean;
+    };
+}
+export declare function normalizePackageGroup(packageGroup: PackageGroup): ArrayPackageGroup;
+export declare function readNxMigrateConfig(json: Partial<PackageJson>): NxMigrationsConfiguration & {
+    packageGroup?: ArrayPackageGroup;
+};
+export declare function buildTargetFromScript(script: string, scripts: Record<string, string>, packageManagerCommand: PackageManagerCommands): TargetConfiguration;
+export type PackageJsonProjectMetadata = {
+    targetGroups: {
+        'NPM Scripts'?: Array<string>;
+    };
+    description: string;
+    js: {
+        packageName: PackageJson['name'];
+        packageVersion: PackageJson['version'];
+        packageExports: PackageJson['exports'];
+        packageMain: PackageJson['main'];
+        isInPackageManagerWorkspaces: boolean;
+    };
+};
+export declare function getMetadataFromPackageJson(packageJson: PackageJson, isInPackageManagerWorkspaces: boolean): ProjectMetadata;
+export declare function getTagsFromPackageJson(packageJson: PackageJson): string[];
+export declare function readTargetsFromPackageJson(packageJson: PackageJson, nxJson: NxJsonConfiguration, projectRoot: string, workspaceRoot: string, packageManagerCommand: PackageManagerCommands): Record<string, TargetConfiguration<any>>;
+/**
+ * Uses `require.resolve` to read the package.json for a module.
+ *
+ * This will fail if the module doesn't export package.json
+ *
+ * @returns package json contents and path
+ */
+export declare function readModulePackageJsonWithoutFallbacks(moduleSpecifier: string, requirePaths?: string[]): {
+    packageJson: PackageJson;
+    path: string;
+};
+/**
+ * Reads the package.json file for a specified module.
+ *
+ * Includes a fallback that accounts for modules that don't export package.json
+ *
+ * @param {string} moduleSpecifier The module to look up
+ * @param {string[]} requirePaths List of paths look in. Pass `module.paths` to ensure non-hoisted dependencies are found.
+ *
+ * @example
+ * // Use the caller's lookup paths for non-hoisted dependencies
+ * readModulePackageJson('http-server', module.paths);
+ *
+ * @returns package json contents and path
+ */
+export declare function readModulePackageJson(moduleSpecifier: string, requirePaths?: string[]): {
+    packageJson: PackageJson;
+    path: string;
+};
+/**
+ * Resolve `request` via Node's CJS resolver while neutralising both ways
+ * `require.resolve(req, { paths })` can lie about the `paths` argument:
+ *
+ *   1. Process-wide `Module._pathCache`. It is swapped out for the duration
+ *      of the call, so any cache entries written are discarded and any
+ *      previously-poisoned entries are not read. Without this, an
+ *      in-process load of a second `nx` package (e.g. the temp `nx@latest`
+ *      install used by the daemon's AI-agents and console-status checks)
+ *      can poison the cache key this call uses and make us read the temp
+ *      path instead of the workspace path.
+ *
+ *   2. Package self-reference. When a file inside package `nx` calls
+ *      `require.resolve('nx/...')`, Node returns that calling package's
+ *      own file regardless of `paths`. We avoid that by issuing the
+ *      resolve from a `createRequire` rooted at a synthetic path that is
+ *      outside any package, so the resolver has no "self" to reference
+ *      and must honour `paths`.
+ *
+ * Node's single-threaded synchronous execution means `require.resolve` does
+ * not yield, so no other code in the process can observe the swapped cache.
+ *
+ * Throws like `require.resolve` when nothing matches.
+ */
+export declare function resolveWithoutCachePollution(request: string, requirePaths: string[]): string;
+export declare function installPackageToTmp(pkg: string, requiredVersion: string, packageManager: PackageManager): {
+    tempDir: string;
+    cleanup: () => void;
+};
+export declare function installPackageToTmpAsync(pkg: string, requiredVersion: string, packageManager: PackageManager): Promise<{
+    tempDir: string;
+    cleanup: () => void;
+}>;
+/**
+ * Get the resolved version of a dependency from package.json.
+ *
+ * Retrieves a package version and automatically resolves PNPM catalog references
+ * (e.g., "catalog:default") to their actual version strings. By default, searches
+ * `dependencies` first, then falls back to `devDependencies`.
+ *
+ * **Tree-based usage** (generators and migrations):
+ * Use when you have a `Tree` object, which is typical in Nx generators and migrations.
+ *
+ * **Filesystem-based usage** (CLI commands and scripts):
+ * Use when reading directly from the filesystem without a `Tree` object.
+ *
+ * @example
+ * ```typescript
+ * // Tree-based - from root package.json (checks dependencies then devDependencies)
+ * const reactVersion = getDependencyVersionFromPackageJson(tree, 'react');
+ * // Returns: "^18.0.0" (resolves "catalog:default" if present)
+ *
+ * // Tree-based - check only dependencies section
+ * const version = getDependencyVersionFromPackageJson(
+ *   tree,
+ *   'react',
+ *   'package.json',
+ *   ['dependencies']
+ * );
+ *
+ * // Tree-based - check only devDependencies section
+ * const version = getDependencyVersionFromPackageJson(
+ *   tree,
+ *   'jest',
+ *   'package.json',
+ *   ['devDependencies']
+ * );
+ *
+ * // Tree-based - custom lookup order
+ * const version = getDependencyVersionFromPackageJson(
+ *   tree,
+ *   'pkg',
+ *   'package.json',
+ *   ['devDependencies', 'dependencies', 'peerDependencies']
+ * );
+ *
+ * // Tree-based - with pre-loaded package.json
+ * const packageJson = readJson(tree, 'package.json');
+ * const version = getDependencyVersionFromPackageJson(
+ *   tree,
+ *   'react',
+ *   packageJson,
+ *   ['dependencies']
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Filesystem-based - from current directory
+ * const reactVersion = getDependencyVersionFromPackageJson('react');
+ *
+ * // Filesystem-based - with workspace root
+ * const version = getDependencyVersionFromPackageJson('react', '/path/to/workspace');
+ *
+ * // Filesystem-based - with specific package.json and section
+ * const version = getDependencyVersionFromPackageJson(
+ *   'react',
+ *   '/path/to/workspace',
+ *   'apps/my-app/package.json',
+ *   ['dependencies']
+ * );
+ * ```
+ *
+ * @param dependencyLookup Array of dependency sections to check in order. Defaults to ['dependencies', 'devDependencies']
+ * @returns The resolved version string, or `null` if the package is not found in any of the specified sections
+ */
+export declare function getDependencyVersionFromPackageJson(tree: Tree, packageName: string, packageJsonPath?: string, dependencyLookup?: PackageJsonDependencySection[]): string | null;
+export declare function getDependencyVersionFromPackageJson(tree: Tree, packageName: string, packageJson?: PackageJson, dependencyLookup?: PackageJsonDependencySection[]): string | null;
+export declare function getDependencyVersionFromPackageJson(packageName: string, workspaceRootPath?: string, packageJsonPath?: string, dependencyLookup?: PackageJsonDependencySection[]): string | null;
+export declare function getDependencyVersionFromPackageJson(packageName: string, workspaceRootPath?: string, packageJson?: PackageJson, dependencyLookup?: PackageJsonDependencySection[]): string | null;
+export {};

package/dist/src/utils/package-json.js

@@ -0,0 +1,441 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePackageGroup = normalizePackageGroup;
+exports.readNxMigrateConfig = readNxMigrateConfig;
+exports.buildTargetFromScript = buildTargetFromScript;
+exports.getMetadataFromPackageJson = getMetadataFromPackageJson;
+exports.getTagsFromPackageJson = getTagsFromPackageJson;
+exports.readTargetsFromPackageJson = readTargetsFromPackageJson;
+exports.readModulePackageJsonWithoutFallbacks = readModulePackageJsonWithoutFallbacks;
+exports.readModulePackageJson = readModulePackageJson;
+exports.resolveWithoutCachePollution = resolveWithoutCachePollution;
+exports.installPackageToTmp = installPackageToTmp;
+exports.installPackageToTmpAsync = installPackageToTmpAsync;
+exports.getDependencyVersionFromPackageJson = getDependencyVersionFromPackageJson;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs_1 = require("fs");
+const node_module_1 = tslib_1.__importStar(require("node:module"));
+const path_1 = require("path");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const tmp_1 = require("tmp");
+const json_1 = require("../generators/utils/json");
+const project_configuration_utils_1 = require("../project-graph/utils/project-configuration-utils");
+const target_merging_1 = require("../project-graph/utils/project-configuration/target-merging");
+const catalog_1 = require("./catalog");
+const fileutils_1 = require("./fileutils");
+const has_nx_js_plugin_1 = require("./has-nx-js-plugin");
+const path_2 = require("./path");
+const installation_directory_1 = require("./installation-directory");
+const package_manager_1 = require("./package-manager");
+const workspace_root_1 = require("./workspace-root");
+function normalizePackageGroup(packageGroup) {
+    return Array.isArray(packageGroup)
+        ? packageGroup.map((x) => typeof x === 'string' ? { package: x, version: '*' } : x)
+        : Object.entries(packageGroup).map(([pkg, version]) => ({
+            package: pkg,
+            version,
+        }));
+}
+function readNxMigrateConfig(json) {
+    // Registry fetching uses this value to build a temporary extraction path.
+    // Reject unsupported absolute paths and escaping parent traversal before extraction.
+    const assertContained = (migrations) => {
+        if (!(0, path_2.isContainedRelativePath)(migrations)) {
+            throw new Error(`Invalid migrations path "${migrations}" in package "${json.name ?? 'unknown'}@${json.version ?? 'unknown'}": migration paths must not be absolute or escape their base directory through parent traversal.`);
+        }
+        return migrations;
+    };
+    const parseNxMigrationsConfig = (fromJson) => {
+        if (!fromJson) {
+            return {};
+        }
+        if (typeof fromJson === 'string') {
+            return { migrations: assertContained(fromJson), packageGroup: [] };
+        }
+        return {
+            ...(fromJson.migrations
+                ? { migrations: assertContained(fromJson.migrations) }
+                : {}),
+            ...(fromJson.packageGroup
+                ? { packageGroup: normalizePackageGroup(fromJson.packageGroup) }
+                : {}),
+            ...(fromJson.supportsOptionalMigrations
+                ? { supportsOptionalMigrations: true }
+                : {}),
+        };
+    };
+    return {
+        ...parseNxMigrationsConfig(json['ng-update']),
+        ...parseNxMigrationsConfig(json['nx-migrations']),
+        // In case there's a `migrations` field in `package.json`
+        ...parseNxMigrationsConfig(json),
+    };
+}
+function buildTargetFromScript(script, scripts = {}, packageManagerCommand) {
+    return {
+        executor: 'nx:run-script',
+        options: {
+            script,
+        },
+        metadata: {
+            scriptContent: scripts[script],
+            runCommand: packageManagerCommand.run(script),
+        },
+    };
+}
+function getMetadataFromPackageJson(packageJson, isInPackageManagerWorkspaces) {
+    const { scripts, nx, description, name, exports, main, version } = packageJson;
+    const includedScripts = nx?.includedScripts || Object.keys(scripts ?? {});
+    const metadata = {
+        targetGroups: includedScripts.length
+            ? {
+                'NPM Scripts': includedScripts,
+            }
+            : {},
+        description,
+        js: {
+            packageName: name,
+            packageVersion: version,
+            packageExports: exports,
+            packageMain: main,
+            isInPackageManagerWorkspaces,
+        },
+    };
+    return metadata;
+}
+function getTagsFromPackageJson(packageJson) {
+    const tags = packageJson.private ? ['npm:private'] : ['npm:public'];
+    if (packageJson.keywords?.length) {
+        tags.push(...packageJson.keywords.map((k) => `npm:${k}`));
+    }
+    if (packageJson?.nx?.tags?.length) {
+        tags.push(...packageJson?.nx.tags);
+    }
+    return tags;
+}
+function readTargetsFromPackageJson(packageJson, nxJson, projectRoot, workspaceRoot, packageManagerCommand) {
+    const { scripts, nx, private: isPrivate } = packageJson ?? {};
+    const res = {};
+    const includedScripts = nx?.includedScripts || Object.keys(scripts ?? {});
+    for (const script of includedScripts) {
+        res[script] = buildTargetFromScript(script, scripts, packageManagerCommand);
+    }
+    for (const targetName in nx?.targets) {
+        const nxTarget = nx.targets[targetName];
+        // If the nx target specifies how to run (via executor or command shorthand),
+        // it's incompatible with the inferred nx:run-script target from scripts,
+        // so overwrite instead of merge.
+        if (res[targetName] && (nxTarget.executor || nxTarget.command)) {
+            res[targetName] = nxTarget;
+        }
+        else {
+            res[targetName] = (0, target_merging_1.mergeTargetConfigurations)(nxTarget, res[targetName]);
+        }
+    }
+    /**
+     * Add implicit nx-release-publish target for all package.json files that are
+     * not marked as `"private": true` to allow for lightweight configuration for
+     * package based repos.
+     *
+     * Any targetDefaults for the nx-release-publish target set by the user should
+     * be merged with the implicit target.
+     */
+    if (!isPrivate &&
+        !res['nx-release-publish'] &&
+        (0, has_nx_js_plugin_1.hasNxJsPlugin)(projectRoot, workspaceRoot)) {
+        // No project/plugin context here, so only catch-all entries of a
+        // `targetDefaults` value apply (the reader resolves both the object and
+        // array value forms).
+        const nxReleasePublishTargetDefaults = (0, project_configuration_utils_1.readTargetDefaultsForTarget)('nx-release-publish', nxJson?.targetDefaults, '@nx/js:release-publish') ?? {};
+        res['nx-release-publish'] = {
+            executor: '@nx/js:release-publish',
+            ...nxReleasePublishTargetDefaults,
+            dependsOn: [
+                // For maximum correctness, projects should only ever be published once their dependencies are successfully published
+                '^nx-release-publish',
+                ...(nxReleasePublishTargetDefaults.dependsOn ?? []),
+            ],
+            options: {
+                ...(nxReleasePublishTargetDefaults.options ?? {}),
+            },
+        };
+    }
+    return res;
+}
+/**
+ * Uses `require.resolve` to read the package.json for a module.
+ *
+ * This will fail if the module doesn't export package.json
+ *
+ * @returns package json contents and path
+ */
+function readModulePackageJsonWithoutFallbacks(moduleSpecifier, requirePaths = (0, installation_directory_1.getNxRequirePaths)()) {
+    const packageJsonPath = resolveWithoutCachePollution(`${moduleSpecifier}/package.json`, requirePaths);
+    const packageJson = (0, fileutils_1.readJsonFile)(packageJsonPath);
+    return {
+        path: packageJsonPath,
+        packageJson,
+    };
+}
+/**
+ * Reads the package.json file for a specified module.
+ *
+ * Includes a fallback that accounts for modules that don't export package.json
+ *
+ * @param {string} moduleSpecifier The module to look up
+ * @param {string[]} requirePaths List of paths look in. Pass `module.paths` to ensure non-hoisted dependencies are found.
+ *
+ * @example
+ * // Use the caller's lookup paths for non-hoisted dependencies
+ * readModulePackageJson('http-server', module.paths);
+ *
+ * @returns package json contents and path
+ */
+function readModulePackageJson(moduleSpecifier, requirePaths = (0, installation_directory_1.getNxRequirePaths)()) {
+    let packageJsonPath;
+    let packageJson;
+    try {
+        ({ path: packageJsonPath, packageJson } =
+            readModulePackageJsonWithoutFallbacks(moduleSpecifier, requirePaths));
+    }
+    catch {
+        const entryPoint = resolveWithoutCachePollution(moduleSpecifier, requirePaths);
+        let moduleRootPath = (0, path_1.dirname)(entryPoint);
+        packageJsonPath = (0, path_1.join)(moduleRootPath, 'package.json');
+        while (!(0, fs_1.existsSync)(packageJsonPath)) {
+            moduleRootPath = (0, path_1.dirname)(moduleRootPath);
+            packageJsonPath = (0, path_1.join)(moduleRootPath, 'package.json');
+        }
+        packageJson = (0, fileutils_1.readJsonFile)(packageJsonPath);
+        if (packageJson.name && packageJson.name !== moduleSpecifier) {
+            throw new Error(`Found module ${packageJson.name} while trying to locate ${moduleSpecifier}/package.json`);
+        }
+    }
+    return {
+        packageJson,
+        path: packageJsonPath,
+    };
+}
+/**
+ * Resolve `request` via Node's CJS resolver while neutralising both ways
+ * `require.resolve(req, { paths })` can lie about the `paths` argument:
+ *
+ *   1. Process-wide `Module._pathCache`. It is swapped out for the duration
+ *      of the call, so any cache entries written are discarded and any
+ *      previously-poisoned entries are not read. Without this, an
+ *      in-process load of a second `nx` package (e.g. the temp `nx@latest`
+ *      install used by the daemon's AI-agents and console-status checks)
+ *      can poison the cache key this call uses and make us read the temp
+ *      path instead of the workspace path.
+ *
+ *   2. Package self-reference. When a file inside package `nx` calls
+ *      `require.resolve('nx/...')`, Node returns that calling package's
+ *      own file regardless of `paths`. We avoid that by issuing the
+ *      resolve from a `createRequire` rooted at a synthetic path that is
+ *      outside any package, so the resolver has no "self" to reference
+ *      and must honour `paths`.
+ *
+ * Node's single-threaded synchronous execution means `require.resolve` does
+ * not yield, so no other code in the process can observe the swapped cache.
+ *
+ * Throws like `require.resolve` when nothing matches.
+ */
+function resolveWithoutCachePollution(request, requirePaths) {
+    // `_pathCache` is an internal Node API not exposed in @types/node.
+    const realCache = node_module_1.default._pathCache;
+    node_module_1.default._pathCache = Object.create(null);
+    try {
+        const detachedRequire = (0, node_module_1.createRequire)('/__nx_detached_resolver__/x.js');
+        return detachedRequire.resolve(request, { paths: requirePaths });
+    }
+    finally {
+        node_module_1.default._pathCache = realCache;
+    }
+}
+/**
+ * Prepares all necessary information for installing a package to a temporary directory.
+ * This is used by both sync and async installation functions.
+ */
+function preparePackageInstallation(pkg, requiredVersion, packageManager) {
+    const { dir: tempDir, cleanup } = (0, package_manager_1.createTempNpmDirectory)?.() ?? {
+        dir: (0, tmp_1.dirSync)().name,
+        cleanup: () => { },
+    };
+    console.log(`Fetching ${pkg}...`);
+    const isVerbose = process.env.NX_VERBOSE_LOGGING === 'true';
+    generatePackageManagerFiles(tempDir, packageManager);
+    // For pnpm, `addDev` is `pnpm add -Dw` when the workspace has a
+    // pnpm-workspace.yaml. `createTempNpmDirectory` copies a sanitized copy of
+    // it into the temp dir, so the `-w` here resolves to the temp dir.
+    const pmCommands = (0, package_manager_1.getPackageManagerCommand)(packageManager);
+    const preInstallCommand = pmCommands.preInstall;
+    // Keep peer dependencies out of the temp install. `ensurePackage` puts the
+    // workspace's `node_modules` on `NODE_PATH`, so a loaded package resolves its
+    // peers from the workspace instead of pulling its own (possibly incompatible)
+    // copies into the temp dir.
+    //
+    // npm needs `--legacy-peer-deps` rather than `--omit=peer`: npm marks a package
+    // as a peer if anything in the tree peer-depends on it, so `--omit=peer` also
+    // prunes packages that are real dependencies. Bun's `--omit=peer` does not.
+    //
+    // pnpm has no plain flag for it. Up to 11 it takes `--config.<setting>`;
+    // pnpm 12 gave `--config` a meaning of its own and takes the setting from
+    // the environment instead.
+    const skipPeerDependenciesFlags = {
+        npm: '--legacy-peer-deps',
+        bun: '--omit=peer',
+        pnpm: '--config.auto-install-peers=false',
+    };
+    const skipPeerDependenciesEnv = packageManager === 'pnpm'
+        ? { PNPM_CONFIG_AUTO_INSTALL_PEERS: 'false' }
+        : {};
+    const installCommand = [
+        pmCommands.addDev,
+        `${pkg}@${requiredVersion}`,
+        skipPeerDependenciesFlags[packageManager],
+        pmCommands.ignoreScriptsFlag,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    const execOptions = {
+        cwd: tempDir,
+        stdio: isVerbose ? 'inherit' : 'ignore',
+        windowsHide: true,
+        // Yarn Berry requires an environment variable (not a CLI flag) to disable lifecycle scripts.
+        // Apply this defensively for all package managers when pulling nx@latest to tmp.
+        env: {
+            ...process.env,
+            YARN_ENABLE_SCRIPTS: 'false',
+            ...skipPeerDependenciesEnv,
+        },
+    };
+    return {
+        tempDir,
+        cleanup,
+        preInstallCommand,
+        installCommand,
+        execOptions,
+    };
+}
+function installPackageToTmp(pkg, requiredVersion, packageManager) {
+    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion, packageManager);
+    if (preInstallCommand) {
+        // ensure package.json and repo in tmp folder is set to a proper package manager state
+        (0, child_process_1.execSync)(preInstallCommand, execOptions);
+    }
+    (0, child_process_1.execSync)(installCommand, execOptions);
+    return {
+        tempDir,
+        cleanup,
+    };
+}
+async function installPackageToTmpAsync(pkg, requiredVersion, packageManager) {
+    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion, packageManager);
+    try {
+        if (preInstallCommand) {
+            // ensure package.json and repo in tmp folder is set to a proper package manager state
+            await execAsync(preInstallCommand, execOptions);
+        }
+        await execAsync(installCommand, execOptions);
+        return {
+            tempDir,
+            cleanup,
+        };
+    }
+    catch (error) {
+        // Clean up on error
+        cleanup();
+        throw error;
+    }
+}
+function getDependencyVersionFromPackageJson(treeOrPackageName, packageNameOrRoot, packageJsonPathOrObjectOrRoot, dependencyLookup) {
+    if (typeof treeOrPackageName !== 'string') {
+        return getDependencyVersionFromPackageJsonFromTree(treeOrPackageName, packageNameOrRoot, packageJsonPathOrObjectOrRoot, dependencyLookup);
+    }
+    else {
+        return getDependencyVersionFromPackageJsonFromFileSystem(treeOrPackageName, packageNameOrRoot, packageJsonPathOrObjectOrRoot, dependencyLookup);
+    }
+}
+/**
+ * Tree-based implementation for getDependencyVersionFromPackageJson
+ */
+function getDependencyVersionFromPackageJsonFromTree(tree, packageName, packageJsonPathOrObject = 'package.json', dependencyLookup = [
+    'dependencies',
+    'devDependencies',
+]) {
+    let packageJson;
+    if (typeof packageJsonPathOrObject === 'object') {
+        packageJson = packageJsonPathOrObject;
+    }
+    else if (tree.exists(packageJsonPathOrObject)) {
+        packageJson = (0, json_1.readJson)(tree, packageJsonPathOrObject);
+    }
+    else {
+        return null;
+    }
+    let version = null;
+    for (const section of dependencyLookup) {
+        const foundVersion = packageJson[section]?.[packageName];
+        if (foundVersion) {
+            version = foundVersion;
+            break;
+        }
+    }
+    // Resolve catalog reference if needed
+    const manager = (0, catalog_1.getCatalogManager)(tree.root);
+    if (version && manager?.isCatalogReference(version)) {
+        version = manager.resolveCatalogReference(tree, packageName, version);
+    }
+    return version;
+}
+/**
+ * Filesystem-based implementation for getDependencyVersionFromPackageJson
+ */
+function getDependencyVersionFromPackageJsonFromFileSystem(packageName, root = workspace_root_1.workspaceRoot, packageJsonPathOrObject = 'package.json', dependencyLookup = [
+    'dependencies',
+    'devDependencies',
+]) {
+    let packageJson;
+    if (typeof packageJsonPathOrObject === 'object') {
+        packageJson = packageJsonPathOrObject;
+    }
+    else {
+        const packageJsonPath = (0, path_1.resolve)(root, packageJsonPathOrObject);
+        if ((0, fs_1.existsSync)(packageJsonPath)) {
+            packageJson = (0, fileutils_1.readJsonFile)(packageJsonPath);
+        }
+        else {
+            return null;
+        }
+    }
+    let version = null;
+    for (const section of dependencyLookup) {
+        const foundVersion = packageJson[section]?.[packageName];
+        if (foundVersion) {
+            version = foundVersion;
+            break;
+        }
+    }
+    // Resolve catalog reference if needed
+    const manager = (0, catalog_1.getCatalogManager)(root);
+    if (version && manager?.isCatalogReference(version)) {
+        version = manager.resolveCatalogReference(root, packageName, version);
+    }
+    return version;
+}
+/**
+ * Generates necessary files needed for the package manager to work
+ * and for the node_modules to be accessible.
+ */
+function generatePackageManagerFiles(root, packageManager = (0, package_manager_1.detectPackageManager)()) {
+    const [pmMajor] = (0, package_manager_1.getPackageManagerVersion)(packageManager).split('.');
+    switch (packageManager) {
+        case 'yarn':
+            if (+pmMajor >= 2) {
+                (0, fs_1.writeFileSync)((0, path_1.join)(root, '.yarnrc.yml'), 'nodeLinker: node-modules\nenableScripts: false');
+            }
+            break;
+    }
+}