feat: add option to disable handling wordpress externals

It becomes useful when using wpackio webpack config in external
tools like styleguidist.

Author: swashata

packages/scripts/src/config/CreateWebpackConfig.ts

@@ -172,6 +172,7 @@ export class CreateWebpackConfig {
 			tsBabelOverride,
 			tsBabelPresetOptions,
 			useReactJsxRuntime,
+			disableWordPressExternals,
 		} = this.projectConfig;
 		const { host, port } = this.serverConfig;
 		const helper: WebpackConfigHelper = new WebpackConfigHelper(
@@ -201,6 +202,7 @@ export class CreateWebpackConfig {
 				tsBabelOverride,
 				tsBabelPresetOptions,
 				useReactJsxRuntime,
+				disableWordPressExternals,
 			},
 			this.cwd,
 			this.isDev

packages/scripts/src/config/WebpackConfigHelper.ts

@@ -59,6 +59,8 @@ export interface WebpackConfigHelperConfig {
 	publicPathUrl: string;
 	errorOverlay: ProjectConfig['errorOverlay'];
 	externals: ProjectConfig['externals'];
+	// whether or not to disable wordpress external scripts handling
+	disableWordPressExternals?: boolean;
 }
 
 interface CommonWebpackConfig {
@@ -325,12 +327,14 @@ export class WebpackConfigHelper {
 		}
 
 		// Add wordpress dependency extract plugin
-		plugins.push(
-			new DependencyExtractionWebpackPlugin({
-				gutenbergOptimized: this.file.optimizeForGutenberg ?? false,
-				appDir: this.appDir,
-			})
-		);
+		if (this.config.disableWordPressExternals !== true) {
+			plugins.push(
+				new DependencyExtractionWebpackPlugin({
+					gutenbergOptimized: this.file.optimizeForGutenberg ?? false,
+					appDir: this.appDir,
+				})
+			);
+		}
 
 		// Add development specific plugins
 		if (this.isDev) {

packages/scripts/src/config/project.config.default.ts

@@ -100,6 +100,8 @@ export interface ProjectConfig {
 	packageFiles: string[];
 	packageDirPath: string;
 	zlibLevel?: number;
+	// whether or not to disable wordpress external scripts handling
+	disableWordPressExternals?: boolean;
 }
 
 /**
@@ -187,4 +189,6 @@ export const projectConfigDefault: ProjectConfig = {
 	packageDirPath: 'package',
 	// Level of zlib compression, when creating archive
 	zlibLevel: 4,
+	// whether or not to disable wordpress external scripts handling
+	disableWordPressExternals: false,
 };

packages/scripts/templates/wpackio.project.js.hbs

@@ -96,4 +96,6 @@ module.exports = {
 	],
 	// Path to package directory, relative to the root
 	packageDirPath: 'package',
+	// whether or not to disable wordpress external scripts handling
+	disableWordPressExternals: false,
 };

site/docs/apis/project-configuration.md

@@ -428,3 +428,10 @@ The generated package file will also have name like `<slug>.zip`.
 ## zlibLevel (`number`)
 
 The level of zlib compression to use when creating the zip.
+
+## disableWordPressExternals (`boolean`)
+
+Whether or not to disable wordpress external scripts handling. If this option
+is set to true, then no `@wordpress` name-spaced dependencies will be extracted
+as an external. Also the dependencies json file which the PHP library depends on
+(but will not fail if is not present) will not be created.