Let wp-scripts packages-update install packages for a specific vers…

…ion of WordPress.

This is to mitigate the problems related to DEWP usage mentioned in WordPress#35630.

This allows a plugin developer to install to-be-extracted dependencies at the lowest version of their plugin targets. To be able to run local tests and linters against that version. To give some insight to the developer, on what is the lowest anticipated version of an individual package.

packages/scripts/README.md

@@ -301,7 +301,17 @@ _Example:_
 
 #### Advanced information
 
-The command checks which packages whose name starts with `@wordpress/` are used in the project by reading the package.json file, and then executes `npm install @wordpress/package1@latest @wordpress/package2@latest ... --save` to change the package versions to the latest one.
+The command checks which packages whose name starts with `@wordpress/` are used in the project by reading the `package.json` file, and then executes `npm install @wordpress/package1@latest @wordpress/package2@latest ... --save` to change the package versions to the latest one.
+
+##### `--wpVersion`
+
+You may use this command to update your local dependencies, to the versions delivered by a specific WordPress version. This is especially usefull when you use [`@wordpress/dependency-extraction-webpack-plugin`](https://www.npmjs.com/package/@wordpress/dependency-extraction-webpack-plugin). You may want to install the dependencies at versions used by the lowest WordPress version your plugin supports, for local testing, etc.
+
+```sh
+wp-scripts packages-update --wpVersion=5.6
+```
+
+Please note, this command updates all `@wordpress/*` packages that intersects your `package.json` and given WordPress version's. It will **not** check your `dependency-extraction-webpack-plugin` setup, to update only extracted ones.
 
 ### `start`
 

packages/scripts/package.json

@@ -66,6 +66,7 @@
 		"merge-deep": "^3.0.3",
 		"mini-css-extract-plugin": "^2.1.0",
 		"minimist": "^1.2.0",
+		"node-fetch": "^3.0.0",
 		"npm-package-json-lint": "^5.0.0",
 		"postcss": "^8.2.15",
 		"postcss-loader": "^6.1.1",

packages/scripts/scripts/packages-update.js

@@ -4,12 +4,25 @@
  */
 const fs = require( 'fs' );
 const spawn = require( 'cross-spawn' );
+// CJS version of module-only: import fetch from 'node-fetch'`;
+const fetch = ( ...args ) =>
+	import( 'node-fetch' ).then( ( { default: nodeFetch } ) =>
+		nodeFetch( ...args )
+	);
+
+/**
+ * Internal dependencies
+ */
+const { getArgFromCLI } = require( '../utils' );
 
 /**
  * Constants
  */
 const WORDPRESS_PACKAGES_PREFIX = '@wordpress/';
 
+const sourceOfWPPackagesVersions = ( wpVersion ) =>
+	`https://raw.githubusercontent.com/WordPress/wordpress-develop/${ wpVersion }/package.json`;
+
 function readJSONFile( fileName ) {
 	const data = fs.readFileSync( fileName, 'utf8' );
 	return JSON.parse( data );
@@ -43,11 +56,13 @@ function getPackageVersionDiff( initialPackageJSON, finalPackageJSON ) {
 	return diff.sort( ( a, b ) => a.dependency.localeCompare( b.dependency ) );
 }
 
-function updatePackagesToLatestVersion( packages ) {
-	const packagesWithLatest = packages.map(
-		( packageName ) => `${ packageName }@latest`
-	);
-	return spawn.sync( 'npm', [ 'install', ...packagesWithLatest, '--save' ], {
+/**
+ * Installs the given npm packages.
+ *
+ * @param {Array<string>} packagesWithVersion List of package names and their versions in the `name@semver` format.
+ */
+function updatePackages( packagesWithVersion ) {
+	return spawn.sync( 'npm', [ 'install', ...packagesWithVersion, '--save' ], {
 		stdio: 'inherit',
 	} );
 }
@@ -63,10 +78,39 @@ function outputPackageDiffReport( packageDiff ) {
 	);
 }
 
-function updatePackageJSON() {
+/**
+ * Fetches `dev-` & `dependencies` for a given WordPress version.
+ *
+ * @param {string} wpVersion WordPress version to fetch the data for.
+ * @return {Object<string,string>} Concatenated dependencies and devDependencies.
+ */
+async function fetchRemoteWordPressPackages( wpVersion = 'master' ) {
+	const response = await fetch( sourceOfWPPackagesVersions( wpVersion ) );
+	const { dependencies, devDependencies } = await response.json();
+	return { ...dependencies, ...devDependencies };
+}
+
+async function updatePackageJSON() {
 	const initialPackageJSON = readJSONFile( 'package.json' );
 	const packages = getWordPressPackages( initialPackageJSON );
-	const result = updatePackagesToLatestVersion( packages );
+	const wpVersion = getArgFromCLI( '--wpVersion' );
+	let packagesWithVersion;
+	if ( wpVersion ) {
+		const remoteVersions = await fetchRemoteWordPressPackages( wpVersion );
+		// Get remote versions for intersecting/local packages.
+		const common = Object.entries(
+			remoteVersions
+		).filter( ( [ packageName ] ) => packages.includes( packageName ) );
+		// Stringify name & version in `npm install` format.
+		packagesWithVersion = common.map(
+			( [ packageName, version ] ) => `${ packageName }@${ version }`
+		);
+	} else {
+		packagesWithVersion = packages.map(
+			( packageName ) => `${ packageName }@latest`
+		);
+	}
+	const result = updatePackages( packagesWithVersion );
 	const finalPackageJSON = readJSONFile( 'package.json' );
 	outputPackageDiffReport(
 		getPackageVersionDiff( initialPackageJSON, finalPackageJSON )