@wordpress/build 0.10.1-next.v.202603161435.0 → 0.11.0

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 ## Unreleased
 
-## 0.10.0-next.0 (2026-03-16)
+## 0.11.0 (2026-04-01)
+
+### Bug Fixes
+
+-   Derive `data-wp-hash` from the transformed CSS instead of the raw source to prevent style mismatches when multiple build pipelines process the same source file ([#76743](https://github.com/WordPress/gutenberg/pull/76743)).
+
+## 0.10.0 (2026-03-18)
 
 ### Breaking Changes
 

package/lib/build.mjs

@@ -118,22 +118,27 @@ const PAGES = WP_PLUGIN_CONFIG.pages || [];
  * are considered true while all other values are false.
  *
  * @param {string|undefined} value The configuration value to interpret.
- * @return {boolean} Boolean interpretation of the given configuration value.
+ * @return {boolean|undefined} Boolean interpretation of the given configuration value, or undefined if not set.
  */
 const boolConfigVal = ( value ) => {
-	return (
-		value !== undefined && [ 'true', '1' ].includes( value.toLowerCase() )
-	);
+	if ( value === undefined ) {
+		return undefined;
+	}
+	return [ 'true', '1' ].includes( value.toLowerCase() );
 };
 
 const baseDefine = {
 	'globalThis.IS_GUTENBERG_PLUGIN': JSON.stringify(
-		boolConfigVal( process.env.IS_GUTENBERG_PLUGIN ) ||
-			boolConfigVal( 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(
-		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ||
-			boolConfigVal( 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 ) => ( {
@@ -177,12 +182,6 @@ function getSassOptions( workingDir ) {
 
 function compileInlineStyle( { cssModules = false, minify = true } = {} ) {
 	return async function styleType( cssText, _dirname, filePath ) {
-		// Always hash the untransformed code.
-		const hash = createHash( 'sha1' )
-			.update( cssText )
-			.digest( 'hex' )
-			.slice( 0, 10 );
-
 		let moduleExports = null;
 
 		// Transform the code: token fallbacks, CSS modules and minification.
@@ -209,6 +208,13 @@ function compileInlineStyle( { cssModules = false, minify = true } = {} ) {
 			map: false,
 		} );
 
+		// Hash the transformed CSS so that the dedup key reflects the actual
+		// injected content, including mangled CSS module class names.
+		const hash = createHash( 'sha1' )
+			.update( css )
+			.digest( 'hex' )
+			.slice( 0, 10 );
+
 		let cssModule = `if (typeof document !== 'undefined' && process.env.NODE_ENV !== 'test' && !document.head.querySelector("style[data-wp-hash='${ hash }']")) {
 	const style = document.createElement("style");
 	style.setAttribute("data-wp-hash", "${ hash }");
@@ -341,7 +347,10 @@ function transformPhpContent( content, transforms ) {
 	 * class prefixes, etc.). When building for WordPress Core, it's not
 	 * necessary to perform these steps.
 	 */
-	if ( boolConfigVal( process.env.IS_WORDPRESS_CORE ) ) {
+	if (
+		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
+		boolConfigVal( process.env.npm_package_config_IS_WORDPRESS_CORE )
+	) {
 		return content;
 	}
 
@@ -583,6 +592,15 @@ async function bundlePackage( packageName, options = {} ) {
 			const entryPoint = path.join( packageDir, exportPath );
 			const baseFileName = path.basename( fileName );
 
+			// Skip non-minified build for WASM-inlined workers (e.g., vips).
+			// These are ~16MB of base64-encoded WASM with no debugging value
+			// over the minified version.
+			const isWasmWorker =
+				packageJson.wpWorkers &&
+				Object.keys( packageJson.wpWorkers ).some(
+					( key ) => key.replace( /^\.\//, '' ) === fileName
+				);
+
 			builds.push(
 				esbuild.build( {
 					entryPoints: [ entryPoint ],
@@ -605,31 +623,36 @@ async function bundlePackage( packageName, options = {} ) {
 							true // Generate asset file for minified build
 						),
 					],
-				} ),
-				esbuild.build( {
-					entryPoints: [ entryPoint ],
-					outfile: path.join(
-						rootBuildModuleDir,
-						`${ fileName }.js`
-					),
-					bundle: true,
-					sourcemap: true,
-					format: 'esm',
-					target,
-					platform: 'browser',
-					minify: false,
-					define: getDefine( true ),
-					plugins: [
-						wordpressExternalsPlugin(
-							`${ baseFileName }.min`,
-							'esm',
-							[],
-							false // Skip asset file for non-minified build
-						),
-					],
 				} )
 			);
 
+			if ( ! isWasmWorker ) {
+				builds.push(
+					esbuild.build( {
+						entryPoints: [ entryPoint ],
+						outfile: path.join(
+							rootBuildModuleDir,
+							`${ fileName }.js`
+						),
+						bundle: true,
+						sourcemap: true,
+						format: 'esm',
+						target,
+						platform: 'browser',
+						minify: false,
+						define: getDefine( true ),
+						plugins: [
+							wordpressExternalsPlugin(
+								`${ baseFileName }.min`,
+								'esm',
+								[],
+								false // Skip asset file for non-minified build
+							),
+						],
+					} )
+				);
+			}
+
 			const scriptModuleId =
 				exportName === '.'
 					? `@${ packageNamespace }/${ packageName }`
@@ -639,6 +662,7 @@ async function bundlePackage( packageName, options = {} ) {
 				id: scriptModuleId,
 				path: `${ packageName }/${ fileName }`,
 				asset: `${ packageName }/${ fileName }.min.asset.php`,
+				min_only: isWasmWorker,
 			} );
 		}
 	}
@@ -901,6 +925,7 @@ async function generateModuleRegistrationPhp( modules, replacements ) {
 				`\t\t'id' => '${ module.id }',\n` +
 				`\t\t'path' => '${ module.path }',\n` +
 				`\t\t'asset' => '${ module.asset }',\n` +
+				( module.min_only ? `\t\t'min_only' => true,\n` : '' ) +
 				`\t),`
 		)
 		.join( '\n' );
@@ -1807,7 +1832,7 @@ async function buildAll( baseUrlExpression ) {
 
 	// When building for WordPress Core, exclude experimental pages.
 	const isCoreBuild =
-		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ||
+		boolConfigVal( process.env.IS_WORDPRESS_CORE ) ??
 		boolConfigVal( process.env.npm_package_config_IS_WORDPRESS_CORE );
 	const activePages = isCoreBuild
 		? normalizedPages.filter( ( page ) => ! page.experimental )
@@ -2127,9 +2152,13 @@ async function main() {
 			},
 			'base-url': {
 				type: 'string',
-				default: boolConfigVal( process.env.IS_WORDPRESS_CORE )
-					? "includes_url( 'build/' )"
-					: '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.10.1-next.v.202603161435.0+ab4981c4f",
+	"version": "0.11.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": "748f4e4564fcc0e6ae90200d90bb993a3cef5828"
+	"gitHead": "2cea90674d11aa521ec3f71652fb3a6a4c383969"
 }

package/templates/module-registration.php.template

@@ -10,6 +10,16 @@
  * 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';
@@ -21,9 +31,13 @@ function {{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 ) {
+		// WASM-only modules (e.g., vips worker) only have .min.js; use it even when SCRIPT_DEBUG is `true`.
+		$extension = ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG && empty( $module['min_only'] ) )
+			? '.js'
+			: '.min.js';
+
 		$asset_path = $modules_dir . '/' . $module['asset'];
 		$asset = file_exists( $asset_path ) ? require $asset_path : array();