chore: import upstream snapshot with attribution

packages/devkit/src/tasks/install-packages-task.ts

@@ -0,0 +1,60 @@
+import { execSync, type ExecSyncOptions } from 'child_process';
+import { join } from 'path';
+
+import {
+  detectPackageManager,
+  getPackageManagerCommand,
+  joinPathFragments,
+  PackageManager,
+  Tree,
+} from 'nx/src/devkit-exports';
+
+/**
+ * Runs `npm install` or `yarn install`. It will skip running the install if
+ * `package.json` hasn't changed at all or it hasn't changed since the last invocation.
+ *
+ * @param tree - the file system tree
+ * @param ensureInstall - ensure install runs even if `package.json` hasn't changed,
+ * unless install already ran this generator cycle.
+ */
+export function installPackagesTask(
+  tree: Tree,
+  ensureInstall: boolean = false,
+  cwd: string = '',
+  packageManager: PackageManager = detectPackageManager(join(tree.root, cwd))
+): void {
+  const packageJsonPath = joinPathFragments(cwd, 'package.json');
+  const packageJsonChanged = tree
+    .listChanges()
+    .some((f) => f.path === packageJsonPath);
+
+  if (!packageJsonChanged && !ensureInstall) {
+    return;
+  }
+
+  const packageJsonValue = tree.read(packageJsonPath, 'utf-8');
+  const storedPackageJsonValue: string = global['__packageJsonInstallCache__'];
+  const installAlreadyRan = storedPackageJsonValue != null;
+  const packageJsonDiffers = storedPackageJsonValue != packageJsonValue;
+
+  if (packageJsonDiffers || (ensureInstall && !installAlreadyRan)) {
+    global['__packageJsonInstallCache__'] = packageJsonValue;
+    const pmc = getPackageManagerCommand(packageManager);
+    const execSyncOptions: ExecSyncOptions = {
+      cwd: join(tree.root, cwd),
+      stdio: process.env.NX_GENERATE_QUIET === 'true' ? 'ignore' : 'inherit',
+      windowsHide: true,
+    };
+    // ensure local registry from process is not interfering with the install
+    // when we start the process from temp folder the local registry would override the custom registry
+    if (
+      process.env.npm_config_registry &&
+      process.env.npm_config_registry.match(
+        /^https:\/\/registry\.(npmjs\.org|yarnpkg\.com)/
+      )
+    ) {
+      delete process.env.npm_config_registry;
+    }
+    execSync(pmc.install, execSyncOptions);
+  }
+}