Clean up changelog, comments and option name

bin/packages/get-babel-config.js

@@ -12,7 +12,7 @@ module.exports = ( environment = '', file ) => {
 		},
 	};
 	// Add `@wordpress/polyfill` import where needed.
-	callerOpts.caller.addPolyfillImport = true;
+	callerOpts.caller.addPolyfillComments = true;
 	switch ( environment ) {
 		case 'main':
 			// To be merged as a presetEnv option.

packages/babel-preset-default/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## Unreleased
 
-- Added `addPolyfillImport` option. When used, it will automatically add `@wordpress/polyfill` imports where needed.
+- Added `addPolyfillComments` option. When used, it will automatically add magic comments to mark files that need `wp-polyfill`.
 
 ## 8.7.0 (2024-09-05)
 

packages/babel-preset-default/index.js

@@ -33,7 +33,7 @@ module.exports = ( api ) => {
 				'proposal-nullish-coalescing-operator',
 				'proposal-logical-assignment-operators',
 			],
-			...( wpBuildOpts.addPolyfillImport
+			...( wpBuildOpts.addPolyfillComments
 				? {
 						useBuiltIns: 'usage',
 						exclude: exclusions,
@@ -95,7 +95,7 @@ module.exports = ( api ) => {
 				},
 			],
 			maybeGetPluginTransformRuntime(),
-			wpBuildOpts.addPolyfillImport && replacePolyfills,
+			wpBuildOpts.addPolyfillComments && replacePolyfills,
 		].filter( Boolean ),
 	};
 };

packages/babel-preset-default/replace-polyfills.js

@@ -1,5 +1,6 @@
 // Babel plugin that looks for `core-js` imports (or requires)
-// and replaces them with `@wordpress/polyfill`.
+// and replaces them magic comments to mark the file as depending
+// on wp-polyfill.
 function replacePolyfills() {
 	return {
 		pre() {
@@ -10,10 +11,7 @@ function replacePolyfills() {
 				exit( path ) {
 					if ( this.hasAddedPolyfills ) {
 						// Add magic comment to top of file.
-						path.addComment(
-							'leading',
-							' wordpress: needs wp-polyfill '
-						);
+						path.addComment( 'leading', ' wp:polyfill ' );
 					}
 				},
 			},

packages/dependency-extraction-webpack-plugin/lib/index.js

@@ -287,11 +287,7 @@ class DependencyExtractionWebpackPlugin {
 			// Prepare to look for magic comments, in order to decide whether
 			// `wp-polyfill` is needed.
 			const processContentsForMagicComments = ( content ) => {
-				if (
-					content
-						.toString()
-						.includes( '/* wordpress: needs wp-polyfill */' )
-				) {
+				if ( content.toString().includes( '/* wp:polyfill */' ) ) {
 					chunkStaticDeps.add( 'wp-polyfill' );
 				}
 			};

tools/webpack/shared.js

@@ -25,7 +25,7 @@ const baseConfig = {
 				parallel: true,
 				terserOptions: {
 					output: {
-						comments: /(translators|wordpress):/i,
+						comments: /(translators|wp):/i,
 					},
 					compress: {
 						passes: 2,