Changeset 61487 for trunk/src/wp-includes/script-loader.php

Timestamp:

01/15/2026 12:55:21 PM (4 months ago)

Author:

youknowriad

Message:

Build/Test Tools: Restore React Refresh scripts for hot reloading.

Restores the wp_register_development_scripts() function and associated
build infrastructure to enable hot module replacement (HMR) when using
@wordpress/scripts with the --hot flag.

The React Refresh scripts were removed in [61438] as part of the Gutenberg
build restructuring, but they are still needed for plugin developers using
wp-scripts start --hot for block development.

Props jsnajdr, wildworks, manzoorwanijk.
See #64393.

File:

• trunk/src/wp-includes/script-loader.php (modified) (2 diffs)

trunk/src/wp-includes/script-loader.php

@@ -164 +164 @@
         'after'
     );
+}
+
+/**
+ * Registers development scripts that integrate with `@wordpress/scripts`.
+ *
+ * These scripts enable hot module replacement (HMR) for block development
+ * when using `wp-scripts start --hot`.
+ *
+ * @see https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts#start
+ *
+ * @since 6.0.0
+ *
+ * @param WP_Scripts $scripts WP_Scripts object.
+ */
+function wp_register_development_scripts( $scripts ) {
+    if (
+        ! defined( 'SCRIPT_DEBUG' ) || ! SCRIPT_DEBUG
+        || empty( $scripts->registered['react'] )
+        || defined( 'WP_RUN_CORE_TESTS' )
+    ) {
+        return;
+    }
+
+    // React Refresh runtime - exposes ReactRefreshRuntime global.
+    // No dependencies.
+    $scripts->add(
+        'wp-react-refresh-runtime',
+        '/wp-includes/js/dist/development/react-refresh-runtime.js',
+        array(),
+        '0.14.0'
+    );
+
+    // React Refresh entry - injects runtime into global hook.
+    // Must load before React to set up hooks.
+    $scripts->add(
+        'wp-react-refresh-entry',
+        '/wp-includes/js/dist/development/react-refresh-entry.js',
+        array( 'wp-react-refresh-runtime' ),
+        '0.14.0'
+    );
+
+    // Add entry as a dependency of React so it loads first.
+    // See https://github.com/pmmmwh/react-refresh-webpack-plugin/blob/main/docs/TROUBLESHOOTING.md#externalising-react.
+    $scripts->registered['react']->deps[] = 'wp-react-refresh-entry';
 }
 
@@ -619 +663 @@
 function wp_default_packages( $scripts ) {
     wp_default_packages_vendor( $scripts );
+    wp_register_development_scripts( $scripts );
     wp_register_tinymce_scripts( $scripts );
     wp_default_packages_scripts( $scripts );