@wordpress/build 0.7.1-next.v.202602091733.0 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## 0.8.0 (2026-02-18)
+
 ## 0.7.0 (2026-01-29)
 
 - Update documentation to describe `wpPlugin.name`

package/README.md

@@ -132,6 +132,42 @@ Files to copy with optional PHP transformations:
 }
 ```
 
+### `wpWorkers`
+
+Worker bundle definitions for packages that need self-contained Web Worker files.
+Workers are bundled with all dependencies included and can be loaded via Blob URLs.
+
+**String shorthand** — entry path only:
+
+```json
+{
+	"wpWorkers": {
+		"./worker": "./src/worker.ts"
+	}
+}
+```
+
+**Object format** — entry path with module resolve redirects:
+
+```json
+{
+	"wpWorkers": {
+		"./worker": {
+			"entry": "./src/worker.ts",
+			"resolve": {
+				"vips-es6.js": "vips.js"
+			}
+		}
+	}
+}
+```
+
+The `resolve` map redirects module loads during bundling. Keys are filename
+patterns to match; values are replacement filenames in the same directory.
+This is useful when a dependency's ES module entry point uses `import.meta.url`,
+which fails in Blob URL Worker contexts. By redirecting to an alternative
+entry point (e.g., a CommonJS version), the issue is avoided.
+
 ## Root Configuration
 
 Configure your root `package.json` with a `wpPlugin` object to control global namespace and externalization behavior:

package/lib/worker-build.mjs

@@ -14,6 +14,92 @@ import { readFile, writeFile, access } from 'fs/promises';
 import path from 'path';
 import esbuild from 'esbuild';
 
+/**
+ * Creates an esbuild plugin that redirects module loads based on filename patterns.
+ *
+ * This is useful when bundling workers for Blob URL contexts where certain
+ * ES module entry points use `import.meta.url` (which resolves to an invalid
+ * `blob:` URL at runtime). By redirecting to an alternative entry point
+ * (e.g., a CommonJS version), the issue is avoided.
+ *
+ * Packages declare redirects in their `wpWorkers` config:
+ *
+ *   "wpWorkers": {
+ *     "./worker": {
+ *       "entry": "./src/worker.ts",
+ *       "resolve": {
+ *         "vips-es6.js": "vips.js"
+ *       }
+ *     }
+ *   }
+ *
+ * @param {Object} resolveMap An object mapping source filenames to target
+ *                            filenames. When esbuild loads a file whose path
+ *                            ends with a source key, the plugin rewrites it
+ *                            to re-export from the corresponding target file
+ *                            in the same directory.
+ * @return {Object} An esbuild plugin.
+ */
+function createModuleRedirectPlugin( resolveMap ) {
+	// Build a single regex that matches any of the source filenames.
+	const escapedKeys = Object.keys( resolveMap ).map( ( key ) =>
+		key.replace( /[.*+?^${}()|[\]\\]/g, '\\$&' )
+	);
+	const pattern = new RegExp( `(${ escapedKeys.join( '|' ) })$` );
+
+	return {
+		name: 'module-redirect',
+		setup( build ) {
+			build.onLoad( { filter: pattern }, ( args ) => {
+				// Find which key matched.
+				const matchedKey = Object.keys( resolveMap ).find( ( key ) =>
+					args.path.endsWith( key )
+				);
+				const targetPath = args.path.replace(
+					matchedKey,
+					resolveMap[ matchedKey ]
+				);
+				return {
+					contents: `export { default } from ${ JSON.stringify(
+						targetPath
+					) };`,
+					loader: 'js',
+				};
+			} );
+		},
+	};
+}
+
+/**
+ * Extracts the entry path from a wpWorkers config value.
+ *
+ * Supports both the string shorthand and the object format:
+ *   - String: "./src/worker.ts"
+ *   - Object: { "entry": "./src/worker.ts", "resolve": { ... } }
+ *
+ * @param {string|Object} workerConfig The worker configuration value.
+ * @return {string} The entry file path.
+ */
+function getWorkerEntryPath( workerConfig ) {
+	if ( typeof workerConfig === 'string' ) {
+		return workerConfig;
+	}
+	return workerConfig.entry;
+}
+
+/**
+ * Extracts the resolve map from a wpWorkers config value, if present.
+ *
+ * @param {string|Object} workerConfig The worker configuration value.
+ * @return {Object|undefined} The resolve map, or undefined if not configured.
+ */
+function getWorkerResolveMap( workerConfig ) {
+	if ( typeof workerConfig === 'string' ) {
+		return undefined;
+	}
+	return workerConfig.resolve;
+}
+
 /**
  * Generate placeholder worker-code.ts for packages with wpWorkers.
  *
@@ -78,7 +164,9 @@ export async function buildWorkers(
 			? Object.entries( packageJson.wpWorkers )
 			: [];
 
-	for ( const [ outputName, entryPath ] of workerEntries ) {
+	for ( const [ outputName, workerConfig ] of workerEntries ) {
+		const entryPath = getWorkerEntryPath( workerConfig );
+		const resolveMap = getWorkerResolveMap( workerConfig );
 		const workerEntryPoint = path.join( packageDir, entryPath );
 		const workerOutputName = outputName.replace( /^\.\//, '' );
 
@@ -98,7 +186,12 @@ export async function buildWorkers(
 					sourcemap: true,
 					// Bundle everything - workers need to be self-contained.
 					external: [],
-					plugins: [ wasmInlinePlugin ],
+					plugins: [
+						wasmInlinePlugin,
+						...( resolveMap
+							? [ createModuleRedirectPlugin( resolveMap ) ]
+							: [] ),
+					],
 					define: {
 						'process.env.NODE_ENV': JSON.stringify(
 							process.env.NODE_ENV || 'production'

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/build",
-	"version": "0.7.1-next.v.202602091733.0+daa0b19c4",
+	"version": "0.8.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": "74f59922b25e30904319373dda91bf8e81f3544e"
+	"gitHead": "376124aa10dbc2cc0c81c964ec00b99fcfee5382"
 }

package/templates/page-wp-admin.php.template

@@ -96,8 +96,9 @@ if ( ! function_exists( '{{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_wp_admin_preload_da
 	 */
 	function {{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_wp_admin_preload_data() {
 		// Define paths to preload - same for all pages
+		// Please also change packages/core-data/src/entities.js when changing this.
 		$preload_paths = array(
-			'/?_fields=description,gmt_offset,home,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front',
+			'/?_fields=description,gmt_offset,home,image_sizes,image_size_threshold,image_output_formats,jpeg_interlaced,png_interlaced,gif_interlaced,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front',
 			array( '/wp/v2/settings', 'OPTIONS' ),
 		);
 

package/templates/page.php.template

@@ -97,8 +97,9 @@ if ( ! function_exists( '{{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_preload_data' ) ) {
 	 */
 	function {{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_preload_data() {
 		// Define paths to preload - same for all pages
+		// Please also change packages/core-data/src/entities.js when changing this.
 		$preload_paths = array(
-			'/?_fields=description,gmt_offset,home,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front',
+			'/?_fields=description,gmt_offset,home,image_sizes,image_size_threshold,image_output_formats,jpeg_interlaced,png_interlaced,gif_interlaced,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front',
 			array( '/wp/v2/settings', 'OPTIONS' ),
 		);