@wordpress/build 0.9.0 → 0.10.0

package/.eslintrc.cjs

@@ -4,5 +4,11 @@ module.exports = {
 	rules: {
 		// Console should be allowed in a build tool
 		'no-console': 'off',
+		/*
+		 * These rules are designed for source files processed by esbuild, not for the build script itself,
+		 * which runs directly in Node.js.
+		 */
+		'@wordpress/no-wp-process-env': 'off',
+		'@wordpress/wp-global-usage': 'off',
 	},
 };

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.10.0 (2026-03-18)
+
+### Breaking Changes
+
+- `@wordpress/boot`, `@wordpress/route`, `@wordpress/theme`, and `@wordpress/private-apis` are no longer bundled. They are now expected to be provided by WordPress Core (7.0+) or the Gutenberg plugin.
+
+### Enhancements
+
+- Avoid unexpected results when typecasting `IS_GUTENBERG_PLUGIN` and `IS_WORDPRESS_CORE` values to Booleans ([#75844](https://github.com/WordPress/gutenberg/pull/75844)).
+- Skip PHP transforms during builds when building for WordPress Core ([#75844](https://github.com/WordPress/gutenberg/pull/75844)).
+
 ## 0.9.0 (2026-03-04)
 
 ## 0.8.0 (2026-02-18)

package/lib/build.mjs

@@ -113,12 +113,32 @@ const HANDLE_PREFIX = WP_PLUGIN_CONFIG.handlePrefix || PACKAGE_NAMESPACE;
 const EXTERNAL_NAMESPACES = WP_PLUGIN_CONFIG.externalNamespaces || {};
 const PAGES = WP_PLUGIN_CONFIG.pages || [];
 
+/**
+ * Interprets a configuration value as a boolean, where `"true"` and `"1"`
+ * are considered true while all other values are false.
+ *
+ * @param {string|undefined} value The configuration value to interpret.
+ * @return {boolean|undefined} Boolean interpretation of the given configuration value, or undefined if not set.
+ */
+const boolConfigVal = ( value ) => {
+	if ( value === undefined ) {
+		return undefined;
+	}
+	return [ 'true', '1' ].includes( value.toLowerCase() );
+};
+
 const baseDefine = {
 	'globalThis.IS_GUTENBERG_PLUGIN': JSON.stringify(
-		Boolean( process.env.npm_package_config_IS_GUTENBERG_PLUGIN )
+		boolConfigVal( process.env.IS_GUTENBERG_PLUGIN ) ??
+			boolConfigVal(
+				process.env.npm_package_config_IS_GUTENBERG_PLUGIN
+			) ??
+			false
 	),
 	'globalThis.IS_WORDPRESS_CORE': JSON.stringify(
-		Boolean( process.env.npm_package_config_IS_WORDPRESS_CORE )
+		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
+			boolConfigVal( process.env.npm_package_config_IS_WORDPRESS_CORE ) ??
+			false
 	),
 };
 const getDefine = ( scriptDebug ) => ( {
@@ -266,8 +286,11 @@ const wasmInlinePlugin = {
 				try {
 					const resolved = require.resolve( args.path );
 					return {
-						path: resolved,
+						path: normalizePath(
+							path.relative( ROOT_DIR, resolved )
+						),
 						namespace: 'wasm-inline',
+						pluginData: { resolvedPath: resolved },
 					};
 				} catch {
 					// If resolution fails, let other plugins handle it.
@@ -281,7 +304,9 @@ const wasmInlinePlugin = {
 		build.onLoad(
 			{ filter: /.*/, namespace: 'wasm-inline' },
 			async ( args ) => {
-				const wasmBuffer = await readFile( args.path );
+				const wasmBuffer = await readFile(
+					args.pluginData.resolvedPath
+				);
 				const base64 = wasmBuffer.toString( 'base64' );
 				const dataUrl = `data:application/wasm;base64,${ base64 }`;
 
@@ -315,6 +340,19 @@ function transformPhpContent( content, transforms ) {
 
 	content = content.toString();
 
+	/*
+	 * Transforms are used to modify PHP files that are committed to version
+	 * control in their wordpress-develop state (`wp_` function prefixes, `WP_`
+	 * class prefixes, etc.). When building for WordPress Core, it's not
+	 * necessary to perform these steps.
+	 */
+	if (
+		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
+		boolConfigVal( process.env.npm_package_config_IS_WORDPRESS_CORE )
+	) {
+		return content;
+	}
+
 	if ( prefixFunctions.length ) {
 		content = content.replace(
 			new RegExp( prefixFunctions.join( '|' ), 'g' ),
@@ -1771,11 +1809,23 @@ async function buildAll( baseUrlExpression ) {
 			id: page.id,
 			init: page.init || [],
 			title: page.title || undefined,
+			experimental: page.experimental || false,
 		};
 	} );
 
-	const pageData = normalizedPages.map( ( page ) => {
-		const pageRoutes = routes.filter( ( r ) => r.page === page.id );
+	// When building for WordPress Core, exclude experimental pages.
+	const isCoreBuild =
+		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
+		boolConfigVal( process.env.npm_package_config_IS_WORDPRESS_CORE );
+	const activePages = isCoreBuild
+		? normalizedPages.filter( ( page ) => ! page.experimental )
+		: normalizedPages;
+
+	const activePageIds = new Set( activePages.map( ( p ) => p.id ) );
+	const activeRoutes = routes.filter( ( r ) => activePageIds.has( r.page ) );
+
+	const pageData = activePages.map( ( page ) => {
+		const pageRoutes = activeRoutes.filter( ( r ) => r.page === page.id );
 		return {
 			slug: page.id,
 			routes: pageRoutes,
@@ -1784,51 +1834,6 @@ async function buildAll( baseUrlExpression ) {
 		};
 	} );
 
-	// Bundle boot, route, and theme packages from node_modules when pages exist
-	if ( pageData.length > 0 ) {
-		try {
-			const { createRequire } = await import( 'module' );
-			const require = createRequire( import.meta.url );
-
-			// Resolve the @wordpress packages directory from node_modules
-			const bootPackageJson = require.resolve(
-				'@wordpress/boot/package.json',
-				{ paths: [ ROOT_DIR ] }
-			);
-			const wordpressPackagesDir = path.dirname(
-				path.dirname( bootPackageJson )
-			);
-
-			// Bundle boot, route, theme, and private-apis packages
-			const externalPackages = [
-				'boot',
-				'route',
-				'theme',
-				'private-apis',
-			];
-			for ( const pkgName of externalPackages ) {
-				const result = await bundlePackage( pkgName, {
-					sourceDir: wordpressPackagesDir,
-					handlePrefix: 'wp',
-					scriptGlobal: 'wp',
-					packageNamespace: 'wordpress',
-				} );
-
-				if ( result && result.modules ) {
-					modules.push( ...result.modules );
-				}
-				if ( result && result.scripts ) {
-					scripts.push( ...result.scripts );
-				}
-			}
-		} catch ( error ) {
-			console.warn(
-				'\n⚠️  Warning: Could not bundle WordPress packages for pages:',
-				error.message
-			);
-		}
-	}
-
 	console.log( '\n📄 Generating PHP registration files...\n' );
 	const phpReplacements = await getPhpReplacements(
 		ROOT_DIR,
@@ -1840,8 +1845,8 @@ async function buildAll( baseUrlExpression ) {
 		generateScriptRegistrationPhp( scripts, phpReplacements ),
 		generateStyleRegistrationPhp( styles, phpReplacements ),
 		generateConstantsPhp( phpReplacements ),
-		generateRoutesRegistry( routes, phpReplacements ),
-		generateRoutesPhp( routes, phpReplacements ),
+		generateRoutesRegistry( activeRoutes, phpReplacements ),
+		generateRoutesPhp( activeRoutes, phpReplacements ),
 		generatePagesPhp( pageData, phpReplacements ),
 	] );
 	console.log( '   ✔ Generated build/build.php' );
@@ -2130,7 +2135,13 @@ async function main() {
 			},
 			'base-url': {
 				type: 'string',
-				default: 'plugin_dir_url( __FILE__ )',
+				default:
+					boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
+					boolConfigVal(
+						process.env.npm_package_config_IS_WORDPRESS_CORE
+					)
+						? "includes_url( 'build/' )"
+						: 'plugin_dir_url( __FILE__ )',
 			},
 		},
 		strict: false,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/build",
-	"version": "0.9.0",
+	"version": "0.10.0",
 	"description": "Build tool for WordPress plugins.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -77,5 +77,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "8bfc179b9aed74c0a6dd6e8edf7a49e40e4f87cc"
+	"gitHead": "c20787b1778ae64c2db65643b1c236309d68e6ba"
 }

package/templates/module-registration.php.template

@@ -6,44 +6,52 @@
  * @package {{PREFIX}}
  */
 
-if ( ! function_exists( '{{PREFIX}}_register_script_modules' ) ) {
-	/**
-	 * Register all script modules.
-	 */
-	function {{PREFIX}}_register_script_modules() {
-		// Load build constants
-		$build_constants = require __DIR__ . '/constants.php';
-		$modules_dir     = __DIR__ . '/modules';
-		$modules_file    = $modules_dir . '/registry.php';
-
-		if ( ! file_exists( $modules_file ) ) {
-			return;
-		}
-
-		$modules = require $modules_file;
-		$base_url = $build_constants['build_url'] . 'modules/';
-		$extension = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '.js' : '.min.js';
-
-		foreach ( $modules as $module ) {
-			$asset_path = $modules_dir . '/' . $module['asset'];
-			$asset = file_exists( $asset_path ) ? require $asset_path : array();
-
-			// Deregister first to override any previously registered version
-			// (e.g., Core's default modules when running as a plugin).
-			wp_deregister_script_module( $module['id'] );
-
-			wp_register_script_module(
-				$module['id'],
-				$base_url . $module['path'] . $extension,
-				$asset['module_dependencies'] ?? array(),
-				$asset['version'] ?? false,
-				array(
-					'fetchpriority' => 'low',
-					'in_footer'     => true,
-				)
-			);
-		}
+/**
+ * Register all script modules.
+ */
+function {{PREFIX}}_register_script_modules() {
+	// Ensure this only runs once. wp_default_scripts can fire multiple times,
+	// and each wp_deregister_script_module() call also dequeues the module.
+	// If a module was enqueued between calls, repeated deregister/register
+	// cycles would lose the enqueue state.
+	static $already_registered = false;
+	if ( $already_registered ) {
+		return;
+	}
+	$already_registered = true;
+
+	// Load build constants
+	$build_constants = require __DIR__ . '/constants.php';
+	$modules_dir     = __DIR__ . '/modules';
+	$modules_file    = $modules_dir . '/registry.php';
+
+	if ( ! file_exists( $modules_file ) ) {
+		return;
 	}
 
-	add_action( 'wp_default_scripts', '{{PREFIX}}_register_script_modules' );
+	$modules = require $modules_file;
+	$base_url = $build_constants['build_url'] . 'modules/';
+	$extension = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '.js' : '.min.js';
+
+	foreach ( $modules as $module ) {
+		$asset_path = $modules_dir . '/' . $module['asset'];
+		$asset = file_exists( $asset_path ) ? require $asset_path : array();
+
+		// Deregister first to override any previously registered version
+		// (e.g., Core's default modules when running as a plugin).
+		wp_deregister_script_module( $module['id'] );
+
+		wp_register_script_module(
+			$module['id'],
+			$base_url . $module['path'] . $extension,
+			$asset['module_dependencies'] ?? array(),
+			$asset['version'] ?? false,
+			array(
+				'fetchpriority' => 'low',
+				'in_footer'     => true,
+			)
+		);
+	}
 }
+
+add_action( 'wp_default_scripts', '{{PREFIX}}_register_script_modules' );