wp-build dashboards: translate JavaScript strings (load catalogs + stamp text domains)

.pnpm-patches/@wordpress__build.patch

@@ -0,0 +1,32 @@
+diff --git a/templates/page-wp-admin.php.template b/templates/page-wp-admin.php.template
+index 96c4627..48fcf28 100644
+--- a/templates/page-wp-admin.php.template
++++ b/templates/page-wp-admin.php.template
+@@ -171,7 +171,26 @@ function {{PREFIX}}_{{PAGE_SLUG_UNDERSCORE}}_wp_admin_enqueue_scripts( $hook_suf
+ 		( mountId, routes, initModules ) => {
+ 			const run = async () => {
+ 				const mod = await import( "@wordpress/boot" );
+-				mod.initSinglePage( { mountId, routes, initModules } );
++				/*
++				 * Run the init modules here instead of delegating to
++				 * initSinglePage(): WordPress cores that bundle an older
++				 * @wordpress/boot (initModules support postdates WP 7.0's copy,
++				 * and the import map resolves @wordpress/boot to core's bundle
++				 * when core provides one) silently ignore the option, so init
++				 * modules would never execute. Running them before
++				 * initSinglePage() gives identical behavior on every core.
++				 */
++				for ( const id of initModules ?? [] ) {
++					try {
++						const initModule = await import( id );
++						if ( typeof initModule.init === "function" ) {
++							await initModule.init();
++						}
++					} catch ( error ) {
++						console.warn( "Failed to run boot init module:", id, error );
++					}
++				}
++				mod.initSinglePage( { mountId, routes } );
+ 			};
+ 			if ( document.readyState === "loading" ) {
+ 				document.addEventListener( "DOMContentLoaded", run );

pnpm-workspace.yaml

@@ -91,3 +91,10 @@ patchedDependencies:
   # uuid up to v11 had CommonJS files with ESM content too.
   # No bug report, because it's already fixed in the latest versions.
   "uuid@<11": .pnpm-patches/uuid.patch
+
+  # The wp-admin page template delegates boot init modules to initSinglePage(),
+  # but WordPress cores bundling an older @wordpress/boot (e.g. WP 7.0) ignore
+  # the option, so init modules never run there. The patch runs them in the
+  # inline bootstrap instead. Remove once the template runs init modules itself
+  # upstream (or Jetpack's WP floor ships a boot with initModules support).
+  "@wordpress/build": .pnpm-patches/@wordpress__build.patch

projects/js-packages/babel-plugin-replace-textdomain/README.md

@@ -31,6 +31,9 @@ Plugin options are:
   The default function list handles the `__`, `_x`, `_n`, and `_nx` functions provided by [@wordpress/i18n]. This list may be accessed as `require( '@automattic/babel-plugin-replace-textdomain' ).defaultFunctions`.
 
 - `i18nModule`: Specify the module name used for resolving import aliases. When a function is imported from this module and called under an alias, the plugin will still recognize it. Defaults to `@wordpress/i18n`.
+- `requireI18nSource`: Skip calls whose callee provably resolves to something other than `i18nModule`. Defaults to false.
+
+  By default any call matching the function list is rewritten, including member calls like `cache.__( key )`. That is fine for hand-written source, but when the plugin runs over a whole bundle — where a dependency's own helpers sit in the same file as the real gettext calls — it rewrites calls that have nothing to do with i18n. With this option a callee is left alone once it can be traced to another module, while a callee whose origin can't be determined is still rewritten (so an unrecognized bundler shape doesn't silently leave a bundle untranslated).
 
 To report instances of the specified i18n functions called without a domain or with an improper value for the domain, set the `DEBUG` environment variable to include `@automattic/babel-plugin-replace-textdomain`.
 

projects/js-packages/babel-plugin-replace-textdomain/changelog/add-wp-build-dashboards-js-i18n

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Add a `requireI18nSource` option to skip gettext-shaped calls whose callee provably comes from a module other than the i18n one — needed when the plugin runs over whole bundles rather than hand-written source.

projects/js-packages/babel-plugin-replace-textdomain/src/index.js

@@ -1,5 +1,6 @@
 const pluginName = require( '../package.json' ).name;
 const debug = require( 'debug' )( pluginName ); // eslint-disable-line import/order
+const { resolveGettextCallee } = require( './resolve-gettext-callee.js' );
 
 const defaultFunctions = Object.freeze( {
 	__: 1,
@@ -10,36 +11,14 @@ const defaultFunctions = Object.freeze( {
 
 const defaultI18nModule = '@wordpress/i18n';
 
-/**
- * Checks whether a given function name is an alias for an i18n module import.
- * @param {object} path       - The Babel path object.
- * @param {string} name       - The function name to check.
- * @param {string} i18nModule - The module name to match against.
- * @return {string|null} The resolved function name, or null if the function name is not an alias.
- */
-function resolveI18nAlias( path, name, i18nModule ) {
-	const binding = path.scope.getBinding( name );
-	if ( ! binding ) {
-		return null;
-	}
-	const bindingPath = binding.path;
-	if ( ! bindingPath.isImportSpecifier() ) {
-		return null;
-	}
-	const importDecl = bindingPath.parentPath;
-	if ( ! importDecl.isImportDeclaration() || importDecl.node.source.value !== i18nModule ) {
-		return null;
-	}
-	return bindingPath.node.imported.name;
-}
-
 module.exports = ( babel, opts ) => {
 	const { types: t } = babel;
 	const seenDomains = {};
 
 	let functions = defaultFunctions;
 	let i18nModule = defaultI18nModule;
 	let replacementDomain;
+	const requireI18nSource = !! opts.requireI18nSource;
 
 	if ( typeof opts.textdomain === 'undefined' ) {
 		throw new Error( `${ pluginName }: The \`textdomain\` option is not set.` );
@@ -78,21 +57,13 @@ module.exports = ( babel, opts ) => {
 		name: pluginName,
 		visitor: {
 			CallExpression( path ) {
-				let callee = path.node.callee;
-				if ( t.isSequenceExpression( callee ) ) {
-					callee = callee.expressions[ callee.expressions.length - 1 ];
-				}
-				const calleeName = t.isMemberExpression( callee ) ? callee.property.name : callee.name;
-
-				let funcName = calleeName;
-				if ( ! Object.hasOwn( functions, funcName ) ) {
-					if ( t.isMemberExpression( callee ) ) {
-						return;
-					}
-					funcName = resolveI18nAlias( path, calleeName, i18nModule );
-					if ( ! funcName || ! Object.hasOwn( functions, funcName ) ) {
-						return;
-					}
+				const funcName = resolveGettextCallee( t, path, {
+					functions,
+					i18nModule,
+					requireI18nSource,
+				} );
+				if ( ! funcName ) {
+					return;
 				}
 				const idx = functions[ funcName ];
 
@@ -149,3 +120,5 @@ module.exports = ( babel, opts ) => {
 };
 
 module.exports.defaultFunctions = defaultFunctions;
+module.exports.defaultI18nModule = defaultI18nModule;
+module.exports.resolveGettextCallee = resolveGettextCallee;