@10up/wp-vite-plugins 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/index.js

@@ -1,5 +1,5 @@
-import { resolve, join, relative, dirname, extname } from 'path';
-import { readdirSync, existsSync, readFileSync, realpathSync } from 'fs';
+import { resolve, join, relative, dirname, extname, isAbsolute } from 'path';
+import { readdirSync, existsSync, readFileSync, rmSync, mkdirSync, writeFileSync, realpathSync } from 'fs';
 import crypto, { createHash } from 'crypto';
 import fg from 'fast-glob';
 import { init, parse } from 'es-module-lexer';
@@ -874,6 +874,599 @@ function ${prefix}_register_page_routes( $page_routes, $register_function_name )
 ${pageFunctions}
 `;
 }
+function renderDevServerPhp(ctx) {
+  const prefixUnderscore = toUnderscore(ctx.prefix);
+  const fn = `${prefixUnderscore}_wp_vite_dev`;
+  const client = `${ctx.prefix}-vite-client`;
+  const checkConstant = `${prefixUnderscore.toUpperCase()}_WP_VITE_CHECK_DEV_SERVER`;
+  const checkFilter = `${prefixUnderscore}_wp_vite_check_dev_server`;
+  return `<?php
+/**
+ * Vite dev-server bridge.
+ * Auto-generated by build process. Do not edit this file manually.
+ *
+ * Require it once, unconditionally, next to the rest of your dist requires:
+ *
+ *     $wp_vite_dev = __DIR__ . '/dist/dev-server.php';
+ *     if ( file_exists( $wp_vite_dev ) ) {
+ *         require_once $wp_vite_dev;
+ *     }
+ *
+ * With no dev server running it costs a single \`file_exists()\` and returns.
+ * When ${ctx.hotFile} is sitting next to it, it repoints every script,
+ * stylesheet and Script Module WordPress would have loaded out of this
+ * directory at the running Vite server instead.
+ *
+ * @package ${ctx.prefix}
+ */
+
+/*
+ * Two loaders, a theme that also boots its own mu-plugin: requiring this file
+ * twice must not redeclare anything or stack a second set of filters.
+ *
+ * The guard has to *wrap* the declarations rather than \`return\` above them.
+ * PHP binds an unconditionally-declared top-level function when it compiles the
+ * file \u2014 before a single statement in it runs \u2014 so an early return would fatal
+ * on the second require anyway. Conditional declarations are bound at run time,
+ * which is what makes the check mean something.
+ */
+if ( ! function_exists( '${fn}_hot' ) ) :
+
+/**
+ * Whether ${fn}_hot() should verify the dev server is actually reachable
+ * before trusting the hot file's mere presence.
+ *
+ * Off by default. Every other check in this bridge is a single
+ * \`file_exists()\` because a running dev server keeps that contract
+ * deliberately \u2014 write on 'listening', delete on exit, exit handlers bound
+ * once. The one hole is a \`kill -9\`'d process, which leaves the file behind
+ * pointing at a socket nothing is listening on any more. Closing that hole
+ * costs a real HTTP request \u2014 timed short, but still a round trip \u2014 on every
+ * single request this bridge participates in, so it stays opt-in rather than
+ * something every site pays for.
+ *
+ * Enable it with the \`${checkConstant}\` constant, or the
+ * \`${checkFilter}\` filter for anything more dynamic (e.g. only inside a
+ * container where \`kill -9\`ing the dev server is routine).
+ *
+ * @return bool
+ */
+function ${fn}_should_verify_dev_server() {
+	$default = defined( '${checkConstant}' ) && constant( '${checkConstant}' );
+
+	/**
+	 * Filters whether the dev-server bridge verifies the running server is
+	 * reachable before trusting the hot file.
+	 *
+	 * @param bool $verify Whether to probe. Default from the
+	 *                      ${checkConstant} constant, else false.
+	 */
+	return (bool) apply_filters( '${checkFilter}', $default );
+}
+
+/**
+ * The decoded hot file, or null when no dev server is running.
+ *
+ * The presence of the file is the entire protocol \u2014 a running server writes it
+ * on 'listening' and deletes it on exit. Cached in a static because this is on
+ * the request path for every enqueued asset.
+ *
+ * @return array|null Array with 'origin', 'base' and 'plugins' keys, or null.
+ */
+function ${fn}_hot() {
+	static $hot = false;
+
+	if ( false !== $hot ) {
+		return $hot;
+	}
+
+	$hot      = null;
+	$hot_file = __DIR__ . '/${ctx.hotFile}';
+
+	if ( ! file_exists( $hot_file ) ) {
+		return $hot;
+	}
+
+	// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
+	$contents = file_get_contents( $hot_file );
+	$decoded  = is_string( $contents ) ? json_decode( $contents, true ) : null;
+
+	if ( ! is_array( $decoded ) || empty( $decoded['origin'] ) || ! is_string( $decoded['origin'] ) ) {
+		return $hot;
+	}
+
+	$base = isset( $decoded['base'] ) && is_string( $decoded['base'] ) ? $decoded['base'] : '/';
+	$base = '/' . ltrim( $base, '/' );
+	if ( '/' !== substr( $base, -1 ) ) {
+		$base .= '/';
+	}
+
+	$hot = array(
+		'origin'  => rtrim( $decoded['origin'], '/' ),
+		'base'    => $base,
+		'plugins' => isset( $decoded['plugins'] ) && is_array( $decoded['plugins'] ) ? $decoded['plugins'] : array(),
+	);
+
+	// Stale hot file: the file is there, but nothing answers for it (a
+	// \`kill -9\`'d dev server). See ${fn}_should_verify_dev_server() above \u2014
+	// off by default, so this whole block is skipped on the common path.
+	if ( ${fn}_should_verify_dev_server() && function_exists( 'wp_remote_head' ) ) {
+		$response = wp_remote_head(
+			$hot['origin'] . $hot['base'] . '@vite/client',
+			array( 'timeout' => 0.2, 'blocking' => true )
+		);
+
+		$status_code = is_wp_error( $response ) ? 0 : (int) wp_remote_retrieve_response_code( $response );
+
+		if ( $status_code < 200 || $status_code >= 400 ) {
+			$hot = null;
+		}
+	}
+
+	return $hot;
+}
+
+/**
+ * Turn a project-relative source path into the URL the dev server serves it at.
+ *
+ * @param string $source Project-relative path from an .asset.php 'source' key.
+ * @return string Absolute URL, or '' when no dev server is running.
+ */
+function ${fn}_url( $source ) {
+	$hot = ${fn}_hot();
+
+	if ( null === $hot ) {
+		return '';
+	}
+
+	return $hot['origin'] . $hot['base'] . ltrim( (string) $source, '/' );
+}
+
+/**
+ * URL of the directory this file lives in.
+ *
+ * Derived from __DIR__ rather than configured, so the same generated file works
+ * whether it was built into a theme, a plugin or an mu-plugin. The candidates
+ * are tried most-specific first: content_url() is the general answer, but a
+ * theme under a custom theme root \u2014 or anything reached through a symlink \u2014 is
+ * only spelled correctly by its own helper.
+ *
+ * @return string Trailing-slashed URL, or '' when this directory is outside
+ *                every location WordPress can build a URL for.
+ */
+function ${fn}_dist_url() {
+	static $dist_url = false;
+
+	if ( false !== $dist_url ) {
+		return $dist_url;
+	}
+
+	$dist_url = '';
+	$dir      = rtrim( str_replace( '\\\\', '/', __DIR__ ), '/' );
+	$roots    = array();
+
+	if ( function_exists( 'get_stylesheet_directory' ) && function_exists( 'get_stylesheet_directory_uri' ) ) {
+		$roots[] = array( get_stylesheet_directory(), get_stylesheet_directory_uri() );
+	}
+	if ( function_exists( 'get_template_directory' ) && function_exists( 'get_template_directory_uri' ) ) {
+		$roots[] = array( get_template_directory(), get_template_directory_uri() );
+	}
+	if ( defined( 'WPMU_PLUGIN_DIR' ) && defined( 'WPMU_PLUGIN_URL' ) ) {
+		$roots[] = array( WPMU_PLUGIN_DIR, WPMU_PLUGIN_URL );
+	}
+	if ( defined( 'WP_PLUGIN_DIR' ) && defined( 'WP_PLUGIN_URL' ) ) {
+		$roots[] = array( WP_PLUGIN_DIR, WP_PLUGIN_URL );
+	}
+	if ( defined( 'WP_CONTENT_DIR' ) && function_exists( 'content_url' ) ) {
+		$roots[] = array( WP_CONTENT_DIR, content_url() );
+	}
+
+	foreach ( $roots as $root ) {
+		list( $root_dir, $root_url ) = $root;
+
+		if ( ! is_string( $root_dir ) || ! is_string( $root_url ) || '' === $root_dir || '' === $root_url ) {
+			continue;
+		}
+
+		$root_dir = rtrim( str_replace( '\\\\', '/', $root_dir ), '/' );
+
+		if ( '' === $root_dir || 0 !== strpos( $dir . '/', $root_dir . '/' ) ) {
+			continue;
+		}
+
+		$dist_url = rtrim( $root_url, '/' ) . substr( $dir, strlen( $root_dir ) ) . '/';
+		break;
+	}
+
+	return $dist_url;
+}
+
+/**
+ * Map an asset URL pointing into this directory back to the file the dev
+ * server serves it from.
+ *
+ * The lookup is the .asset.php sidecar next to where the built file would have
+ * been: dist-relative URL, extension stripped, '.asset.php' appended. Its
+ * 'source' key \u2014 written by both a build and a running dev server \u2014 is the
+ * project-relative path of the file Vite compiles on demand.
+ *
+ * @param string $url Asset URL as WordPress is about to print it, '?ver=' and all.
+ * @return string|null Project-relative source path, or null when this URL is
+ *                     not ours or has no sidecar.
+ */
+function ${fn}_source( $url ) {
+	static $cache = array();
+
+	if ( ! is_string( $url ) || '' === $url ) {
+		return null;
+	}
+
+	$dist_url = ${fn}_dist_url();
+
+	if ( '' === $dist_url ) {
+		return null;
+	}
+
+	// The filters hand us the versioned URL; the sidecar lives at the
+	// unversioned path.
+	$query = strpos( $url, '?' );
+	if ( false !== $query ) {
+		$url = substr( $url, 0, $query );
+	}
+
+	if ( array_key_exists( $url, $cache ) ) {
+		return $cache[ $url ];
+	}
+
+	$cache[ $url ] = null;
+	$relative      = null;
+
+	// A protocol-relative src, and an http/https mismatch between the enqueued
+	// URL and content_url(), are both routine; neither should stop a match. The
+	// path-only form additionally catches root-relative and CDN-fronted srcs.
+	$path_only = preg_replace( '#^([a-z][a-z0-9+.-]*:)?//[^/]*#i', '', $dist_url );
+	foreach ( array( $dist_url, is_string( $path_only ) ? $path_only : '' ) as $prefix ) {
+		if ( '' === $prefix ) {
+			continue;
+		}
+
+		$bare_prefix = preg_replace( '#^[a-z][a-z0-9+.-]*:#i', '', $prefix );
+		$bare_url    = preg_replace( '#^[a-z][a-z0-9+.-]*:#i', '', $url );
+
+		if ( 0 !== strpos( $bare_url, $bare_prefix ) ) {
+			continue;
+		}
+
+		$relative = substr( $bare_url, strlen( $bare_prefix ) );
+		break;
+	}
+
+	// The relative path reaches a require(), and it came out of a URL. Nothing
+	// but the shape a build actually emits gets through.
+	if ( null === $relative || ! preg_match( '#^[A-Za-z0-9_][A-Za-z0-9_./-]*$#', $relative ) || false !== strpos( $relative, '..' ) ) {
+		return null;
+	}
+
+	$asset_file = __DIR__ . '/' . preg_replace( '/\\.(js|mjs|css)$/', '', $relative ) . '.asset.php';
+
+	if ( ! file_exists( $asset_file ) ) {
+		return null;
+	}
+
+	$asset = require $asset_file;
+
+	if ( ! is_array( $asset ) || empty( $asset['source'] ) || ! is_string( $asset['source'] ) ) {
+		return null;
+	}
+
+	$cache[ $url ] = $asset['source'];
+
+	return $cache[ $url ];
+}
+
+/**
+ * Registry of handles whose <script> tag has to be stamped type="module".
+ *
+ * Everything the dev server serves is ESM \u2014 that is the point of dev mode \u2014 so
+ * every handle this file repoints joins the set.
+ *
+ * @param string $handle Script handle.
+ * @param bool   $mark   Add the handle to the registry.
+ * @return bool Whether the handle prints as a module.
+ */
+function ${fn}_is_module( $handle, $mark = false ) {
+	static $handles = array();
+
+	if ( $mark ) {
+		$handles[ $handle ] = true;
+	}
+
+	return isset( $handles[ $handle ] );
+}
+
+// Nothing below this line matters when no dev server is running.
+if ( null === ${fn}_hot() ) {
+	return;
+}
+
+/**
+ * Register and enqueue Vite's HMR client, early.
+ *
+ * It opens the websocket, applies hot updates, and renders the error overlay.
+ * Every handle this file repoints gets it as a dependency, so it is always the
+ * first module in the document.
+ */
+function ${fn}_enqueue_client() {
+	$src = ${fn}_url( '@vite/client' );
+
+	if ( '' === $src ) {
+		return;
+	}
+
+	wp_register_script( '${client}', $src, array(), null, false );
+	wp_enqueue_script( '${client}' );
+	${fn}_is_module( '${client}', true );
+
+	${fn}_enqueue_react_refresh_preamble();
+}
+add_action( 'wp_enqueue_scripts', '${fn}_enqueue_client', -1000 );
+add_action( 'admin_enqueue_scripts', '${fn}_enqueue_client', -1000 );
+
+/**
+ * Attach the React Fast Refresh preamble to the vite-client handle, when the
+ * running dev server reports \`vite:react-refresh\` in the hot file's plugin
+ * list.
+ *
+ * The preamble has to run before any React component module evaluates \u2014
+ * @vitejs/plugin-react's transform assumes \`window.$RefreshReg$\` already
+ * exists, and every transformed component module throws otherwise. Attaching
+ * it to the vite-client handle rather than to each rewritten script gets that
+ * ordering for free, two different ways depending on how the component reaches
+ * the page:
+ *
+ *   - **Classic scripts.** ${fn}_prepare() (below) makes the client a
+ *     dependency of every classic handle this bridge repoints, so WordPress's
+ *     own dependency graph orders the client \u2014 and the inline block
+ *     \`wp_add_inline_script( \u2026, 'after' )\` attaches to it \u2014 before them.
+ *   - **Script Modules.** There is no cross-system dependency a classic handle
+ *     can declare on a Script Module, so this relies on where WordPress prints
+ *     each group instead: the client is a classic-registered handle (its
+ *     \`type="module"\` is only a printed attribute, stamped by
+ *     ${fn}_script_tag() below), and every generated page in this package
+ *     prints classic scripts \u2014 the client included \u2014 before it prints Script
+ *     Modules. Same-document module scripts without \`async\` execute in that
+ *     print order, so the preamble still runs first.
+ *
+ * Same mechanics vite-for-wp uses for the classic-script half.
+ *
+ * Guarded by a static so a request that somehow fires both enqueue hooks
+ * cannot attach the preamble, and its type="module" filter, twice.
+ */
+function ${fn}_enqueue_react_refresh_preamble() {
+	static $attached = false;
+
+	if ( $attached ) {
+		return;
+	}
+
+	$hot = ${fn}_hot();
+
+	if ( null === $hot || ! in_array( 'vite:react-refresh', $hot['plugins'], true ) ) {
+		return;
+	}
+
+	$attached = true;
+
+	$preamble = sprintf(
+		'import RefreshRuntime from "%1$s"
+RefreshRuntime.injectIntoGlobalHook(window)
+window.$RefreshReg$ = () => {}
+window.$RefreshSig$ = () => (type) => type
+window.__vite_plugin_react_preamble_installed__ = true',
+		esc_js( ${fn}_url( '@react-refresh' ) )
+	);
+
+	wp_add_inline_script( '${client}', $preamble, 'after' );
+	add_filter( 'wp_inline_script_attributes', '${fn}_react_refresh_inline_attributes' );
+}
+
+/**
+ * Stamp type="module" on exactly the inline block ${fn}_enqueue_react_refresh_preamble()
+ * attached \u2014 the preamble is a top-level \`import\`, so it must not print as a
+ * classic inline script the way an 'after' block otherwise would.
+ *
+ * WordPress assigns an inline block printed at the 'after' position the id
+ * \`<handle>-js-after\`; matching on it (rather than the handle alone) is what
+ * keeps this from touching some other inline script attached to the same
+ * vite-client handle by unrelated code.
+ *
+ * @param array $attributes Attributes about to be printed on the inline <script> tag.
+ * @return array
+ */
+function ${fn}_react_refresh_inline_attributes( $attributes ) {
+	if ( is_array( $attributes ) && isset( $attributes['id'] ) && '${client}-js-after' === $attributes['id'] ) {
+		$attributes['type'] = 'module';
+	}
+
+	return $attributes;
+}
+
+/**
+ * The one pass that has to happen while the queues are still mutable: wire the
+ * HMR client into everything about to be repointed, and swap this directory's
+ * stylesheets for the JS modules Vite serves them as.
+ *
+ * Runs last on the enqueue hooks \u2014 the URL rewriting itself happens later, in
+ * script_loader_src, which also catches handles registered after this point.
+ */
+function ${fn}_prepare() {
+	$claimed = array();
+
+	if ( function_exists( 'wp_scripts' ) && function_exists( 'wp_script_is' ) ) {
+		$has_client = wp_script_is( '${client}', 'registered' );
+
+		foreach ( wp_scripts()->registered as $handle => $script ) {
+			if ( '${client}' === $handle || empty( $script->src ) ) {
+				continue;
+			}
+
+			$source = ${fn}_source( $script->src );
+
+			if ( null === $source ) {
+				continue;
+			}
+
+			$claimed[ $source ] = true;
+
+			// Ordering only. A missing client handle would make WordPress drop
+			// the script entirely, so never depend on one that isn't there.
+			if ( $has_client && is_array( $script->deps ) && ! in_array( '${client}', $script->deps, true ) ) {
+				$script->deps[] = '${client}';
+			}
+		}
+	}
+
+	if ( ! function_exists( 'wp_styles' ) ) {
+		return;
+	}
+
+	$styles = wp_styles();
+
+	foreach ( $styles->queue as $handle ) {
+		if ( ! isset( $styles->registered[ $handle ] ) || empty( $styles->registered[ $handle ]->src ) ) {
+			continue;
+		}
+
+		$source = ${fn}_source( $styles->registered[ $handle ]->src );
+
+		if ( null === $source ) {
+			continue;
+		}
+
+		wp_dequeue_style( $handle );
+
+		// A stylesheet whose source is already served by a repointed script is
+		// covered: in dev the entry imports its own CSS.
+		if ( isset( $claimed[ $source ] ) ) {
+			continue;
+		}
+
+		$claimed[ $source ] = true;
+		$shim               = $handle . '-vite-dev';
+
+		wp_register_script(
+			$shim,
+			${fn}_url( $source ),
+			wp_script_is( '${client}', 'registered' ) ? array( '${client}' ) : array(),
+			null,
+			false
+		);
+		wp_enqueue_script( $shim );
+		${fn}_is_module( $shim, true );
+	}
+}
+add_action( 'wp_enqueue_scripts', '${fn}_prepare', PHP_INT_MAX );
+add_action( 'admin_enqueue_scripts', '${fn}_prepare', PHP_INT_MAX );
+
+/**
+ * Repoint a classic script at the dev server.
+ *
+ * @param string $src    Script URL.
+ * @param string $handle Script handle.
+ * @return string Rewritten URL, or the original.
+ */
+function ${fn}_script_src( $src, $handle ) {
+	$source = ${fn}_source( $src );
+
+	if ( null === $source ) {
+		return $src;
+	}
+
+	// script_loader_src always runs before script_loader_tag for the same
+	// handle (both live in WP_Scripts::do_item()), so marking here is enough.
+	${fn}_is_module( $handle, true );
+
+	return ${fn}_url( $source );
+}
+add_filter( 'script_loader_src', '${fn}_script_src', 10, 2 );
+
+/**
+ * Stamp type="module" on the handles this file repointed.
+ *
+ * @param string $tag    Script tag HTML.
+ * @param string $handle Script handle.
+ * @return string Rewritten tag.
+ */
+function ${fn}_script_tag( $tag, $handle ) {
+	if ( ! is_string( $tag ) || ! ${fn}_is_module( $handle ) ) {
+		return $tag;
+	}
+
+	// WP 6.2+. Without it, the crude rewrite is still better than letting an
+	// ESM file load as a classic script and throw on its first import.
+	if ( ! class_exists( 'WP_HTML_Tag_Processor' ) ) {
+		return false === strpos( $tag, 'type="module"' )
+			? str_replace( '<script ', '<script type="module" ', $tag )
+			: $tag;
+	}
+
+	$processor = new WP_HTML_Tag_Processor( $tag );
+
+	while ( $processor->next_tag( 'script' ) ) {
+		// Inline blocks attached to the same handle stay classic; only the
+		// src'd tag is the module.
+		if ( null === $processor->get_attribute( 'src' ) ) {
+			continue;
+		}
+
+		$processor->set_attribute( 'type', 'module' );
+	}
+
+	return $processor->get_updated_html();
+}
+add_filter( 'script_loader_tag', '${fn}_script_tag', 10, 2 );
+
+/**
+ * Repoint a Script Module at the dev server.
+ *
+ * script_module_loader_src (WP 6.5+) is the single choke point inside
+ * WP_Script_Modules::get_src() for all three Script Module outputs \u2014 the
+ * <script type="module"> tag, its <link rel="modulepreload">, and the import
+ * map \u2014 so one filter keeps all three consistent and no consumer registration
+ * has to change.
+ *
+ * @param string $src Script Module URL.
+ * @param string $id  Script Module identifier.
+ * @return string Rewritten URL, or the original.
+ */
+function ${fn}_script_module_src( $src, $id ) {
+	$source = ${fn}_source( $src );
+
+	return null === $source ? $src : ${fn}_url( $source );
+}
+add_filter( 'script_module_loader_src', '${fn}_script_module_src', 10, 2 );
+
+/**
+ * Last resort for a stylesheet ${fn}_prepare() never saw \u2014 one registered
+ * after the enqueue hooks, or pulled in as another stylesheet's dependency.
+ *
+ * Vite's '?direct' serves the compiled CSS with a text/css content type instead
+ * of the JS module a bare .css request returns. Correct styles, no hot reload.
+ *
+ * @param string $src    Stylesheet URL.
+ * @param string $handle Stylesheet handle.
+ * @return string Rewritten URL, or the original.
+ */
+function ${fn}_style_src( $src, $handle ) {
+	$source = ${fn}_source( $src );
+
+	return null === $source ? $src : ${fn}_url( $source ) . '?direct';
+}
+add_filter( 'style_loader_src', '${fn}_style_src', 10, 2 );
+
+endif;
+`;
+}
 function generatePhpFiles(ctx, pages) {
   const files = [
     { fileName: "build.php", source: renderBuildPhp(ctx) },
@@ -1815,37 +2408,135 @@ function isBarePackageName(name) {
   }
   return name.length > 0 && !name.includes("/") && !name.startsWith(".");
 }
+function entrySourcePath(facadeModuleId, root) {
+  if (!facadeModuleId) return null;
+  const relativePath = relative(root, facadeModuleId).replace(/\\/g, "/");
+  if (relativePath === "" || relativePath === ".." || relativePath.startsWith("../")) {
+    return null;
+  }
+  if (isAbsolute(relativePath)) return null;
+  return relativePath;
+}
+function phpSingleQuoteEscape(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
 var DEFAULT_VENDOR = {
   react: { global: "React", handle: "react" },
   "react-dom": { global: "ReactDOM", handle: "react-dom" },
   "react-dom/client": { global: "ReactDOM", handle: "react-dom" },
-  "react/jsx-runtime": { global: "ReactJSXRuntime", handle: "react-jsx-runtime" },
-  "react/jsx-dev-runtime": { global: "ReactJSXRuntime", handle: "react-jsx-runtime" },
+  "react/jsx-runtime": {
+    global: "ReactJSXRuntime",
+    handle: "react-jsx-runtime"
+  },
+  "react/jsx-dev-runtime": {
+    global: "ReactJSXRuntime",
+    handle: "react-jsx-runtime"
+  },
   moment: { global: "moment", handle: "moment" },
   jquery: { global: "jQuery", handle: "jquery" },
   lodash: { global: "lodash", handle: "lodash" },
   "lodash-es": { global: "lodash", handle: "lodash" }
 };
 var CJS_GLOBAL_SHIM_PREFIX = "\0wp-external-global:";
-var JS_IDENTIFIER = "[A-Za-z_$][\\w$]*";
-function rewriteImport(importStatement, globalAccess) {
-  const match = importStatement.match(/^\s*import\s+(.*?)\s+from\s+['"][^'"]+['"]\s*;?\s*$/s);
-  if (!match || !match[1]) return "";
-  const bindings = match[1].trim();
-  const namespaceImport = bindings.match(new RegExp(`^\\*\\s+as\\s+(${JS_IDENTIFIER})$`));
-  if (namespaceImport) return `const ${namespaceImport[1]} = ${globalAccess};`;
-  const defaultWithNamed = bindings.match(
-    new RegExp(`^(${JS_IDENTIFIER})\\s*,\\s*\\{(.+)\\}$`, "s")
-  );
-  if (defaultWithNamed) {
-    return [
-      `const ${defaultWithNamed[1]} = (${globalAccess} && ${globalAccess}.default) || ${globalAccess};`,
-      `const { ${namedImportsToDestructuring(defaultWithNamed[2].trim())} } = ${globalAccess};`
-    ].join(" ");
+function matchesScriptModuleNamespace(packageName, scriptModuleNamespaces) {
+  if (!packageName.startsWith("@")) return false;
+  const slashIndex = packageName.indexOf("/");
+  if (slashIndex < 0) return false;
+  const namespace = packageName.slice(1, slashIndex);
+  for (const pattern of scriptModuleNamespaces) {
+    if (pattern.endsWith("*")) {
+      if (namespace.startsWith(pattern.slice(0, -1))) return true;
+    } else if (namespace === pattern) {
+      return true;
+    }
+  }
+  return false;
+}
+function resolveExternal(specifier, options) {
+  const projectRoot = options.projectRoot;
+  const vendorExternals = options.vendorExternals ?? DEFAULT_VENDOR;
+  const externalNamespaces = options.externalNamespaces ?? {};
+  const scriptModuleNamespaces = options.scriptModuleNamespaces ?? [];
+  const bundledPackages = options.bundledPackages instanceof Set ? options.bundledPackages : new Set(options.bundledPackages ?? []);
+  if (bundledPackages.has(splitImport(specifier).name)) return null;
+  if (vendorExternals[specifier]) {
+    const vendor = vendorExternals[specifier];
+    return {
+      global: vendor.global,
+      handle: vendor.handle,
+      specifier,
+      moduleEligible: false,
+      scriptEligible: true
+    };
+  }
+  const { name, subpath } = splitImport(specifier);
+  if (name.startsWith("@wordpress/")) {
+    const meta = readPackageMetadata(name, projectRoot);
+    if (!meta) {
+      return null;
+    }
+    const shortName = name.slice("@wordpress/".length);
+    const moduleEligible = isScriptModule(meta, subpath);
+    const scriptEligible = !!meta.wpScript;
+    if (!moduleEligible && !scriptEligible) {
+      return null;
+    }
+    return {
+      global: scriptEligible ? `wp.${camelize(shortName)}` : null,
+      handle: scriptEligible ? `wp-${shortName}` : null,
+      specifier,
+      moduleEligible,
+      scriptEligible
+    };
+  }
+  for (const [namespace, config] of Object.entries(externalNamespaces)) {
+    if (name.startsWith(`@${namespace}/`)) {
+      const shortName = name.slice(`@${namespace}/`.length);
+      return {
+        global: `${config.global}.${camelize(shortName)}`,
+        handle: `${config.handlePrefix}-${shortName}`,
+        specifier,
+        moduleEligible: false,
+        scriptEligible: true
+      };
+    }
+  }
+  if (matchesScriptModuleNamespace(name, scriptModuleNamespaces)) {
+    return {
+      global: null,
+      handle: null,
+      specifier,
+      moduleEligible: true,
+      scriptEligible: false
+    };
+  }
+  return null;
+}
+var JS_IDENTIFIER = "[A-Za-z_$][\\w$]*";
+var SIDE_EFFECT_IMPORT = /^\s*import\s*['"][^'"]+['"]\s*;?\s*$/;
+function rewriteImport(importStatement, globalAccess) {
+  if (SIDE_EFFECT_IMPORT.test(importStatement)) return "";
+  const match = importStatement.match(/^\s*import\s*(.*?)\s*from\s*['"][^'"]+['"]\s*;?\s*$/s);
+  if (!match || !match[1]) return null;
+  const bindings = match[1].trim();
+  const namespaceImport = bindings.match(new RegExp(`^\\*\\s*as\\s+(${JS_IDENTIFIER})$`));
+  if (namespaceImport) return `const ${namespaceImport[1]} = ${globalAccess};`;
+  const defaultWithNamed = bindings.match(
+    new RegExp(`^(${JS_IDENTIFIER})\\s*,\\s*\\{(.+)\\}$`, "s")
+  );
+  if (defaultWithNamed) {
+    const destructured = namedImportsToDestructuring(defaultWithNamed[2].trim());
+    if (destructured === null) return null;
+    return [
+      `const ${defaultWithNamed[1]} = (${globalAccess} && ${globalAccess}.default) || ${globalAccess};`,
+      `const { ${destructured} } = ${globalAccess};`
+    ].join(" ");
   }
   if (bindings.startsWith("{")) {
     const namedImports = bindings.replace(/^\{|\}$/g, "").trim();
-    return `const { ${namedImportsToDestructuring(namedImports)} } = ${globalAccess};`;
+    const destructured = namedImportsToDestructuring(namedImports);
+    if (destructured === null) return null;
+    return `const { ${destructured} } = ${globalAccess};`;
   }
   if (new RegExp(`^${JS_IDENTIFIER}$`).test(bindings)) {
     return `const ${bindings} = (${globalAccess} && ${globalAccess}.default) || ${globalAccess};`;
@@ -1854,10 +2545,23 @@ function rewriteImport(importStatement, globalAccess) {
 }
 function namedImportsToDestructuring(namedImports) {
   const aliasPattern = new RegExp(`^(${JS_IDENTIFIER})\\s+as\\s+(${JS_IDENTIFIER})$`);
-  return namedImports.split(",").map((binding) => binding.trim()).filter(Boolean).map((binding) => {
+  const plainPattern = new RegExp(`^${JS_IDENTIFIER}$`);
+  const bindings = [];
+  for (const raw of namedImports.split(",")) {
+    const binding = raw.trim();
+    if (!binding) continue;
     const aliased = binding.match(aliasPattern);
-    return aliased ? `${aliased[1]}: ${aliased[2]}` : binding;
-  }).join(", ");
+    if (aliased) {
+      bindings.push(`${aliased[1]}: ${aliased[2]}`);
+      continue;
+    }
+    if (plainPattern.test(binding)) {
+      bindings.push(binding);
+      continue;
+    }
+    return null;
+  }
+  return bindings.join(", ");
 }
 function wpExternals(options = {}) {
   const projectRoot = options.projectRoot ?? process.cwd();
@@ -1867,6 +2571,7 @@ function wpExternals(options = {}) {
   const moduleEntryMatchers = options.moduleEntryMatchers ?? [];
   const wpBuildAssetMatchers = options.wpBuildAssetMatchers ?? [];
   const scriptModuleNamespaces = options.scriptModuleNamespaces ?? [];
+  const globalsSink = options.globalsSink;
   for (const name of options.bundle ?? []) {
     if (isBarePackageName(name)) continue;
     const { name: rootName, subpath } = splitImport(name);
@@ -1875,24 +2580,22 @@ function wpExternals(options = {}) {
     );
   }
   const bundledPackages = /* @__PURE__ */ new Set([...DEFAULT_BUNDLED_PACKAGES, ...options.bundle ?? []]);
-  function matchesScriptModuleNamespace(packageName) {
-    if (!packageName.startsWith("@")) return false;
-    const slashIndex = packageName.indexOf("/");
-    if (slashIndex < 0) return false;
-    const namespace = packageName.slice(1, slashIndex);
-    for (const pattern of scriptModuleNamespaces) {
-      if (pattern.endsWith("*")) {
-        if (namespace.startsWith(pattern.slice(0, -1))) return true;
-      } else if (namespace === pattern) {
-        return true;
-      }
-    }
-    return false;
+  const resolveExternalOptions = {
+    projectRoot,
+    vendorExternals,
+    externalNamespaces,
+    scriptModuleNamespaces,
+    bundledPackages
+  };
+  function resolveExternalForThisPlugin(specifier) {
+    const external = resolveExternal(specifier, resolveExternalOptions);
+    if (external?.global) globalsSink?.set(external.specifier, external.global);
+    return external;
   }
   function buildModeForFile(moduleId) {
-    const filePath = moduleId.split("?")[0] ?? moduleId;
+    const filePath = (moduleId.split("?")[0] ?? moduleId).replace(/\\/g, "/");
     for (const pattern of moduleEntryMatchers) {
-      if (filePath.includes(pattern)) return "module";
+      if (filePath.includes(pattern.replace(/\\/g, "/"))) return "module";
     }
     return buildType;
   }
@@ -1904,61 +2607,6 @@ function wpExternals(options = {}) {
     }
     return false;
   }
-  function resolveExternal(specifier) {
-    if (bundledPackages.has(splitImport(specifier).name)) return null;
-    if (vendorExternals[specifier]) {
-      const vendor = vendorExternals[specifier];
-      return {
-        global: vendor.global,
-        handle: vendor.handle,
-        specifier,
-        moduleEligible: false,
-        scriptEligible: true
-      };
-    }
-    const { name, subpath } = splitImport(specifier);
-    if (name.startsWith("@wordpress/")) {
-      const meta = readPackageMetadata(name, projectRoot);
-      if (!meta) {
-        return null;
-      }
-      const shortName = name.slice("@wordpress/".length);
-      const moduleEligible = isScriptModule(meta, subpath);
-      const scriptEligible = !!meta.wpScript;
-      if (!moduleEligible && !scriptEligible) {
-        return null;
-      }
-      return {
-        global: scriptEligible ? `wp.${camelize(shortName)}` : null,
-        handle: scriptEligible ? `wp-${shortName}` : null,
-        specifier,
-        moduleEligible,
-        scriptEligible
-      };
-    }
-    for (const [namespace, config] of Object.entries(externalNamespaces)) {
-      if (name.startsWith(`@${namespace}/`)) {
-        const shortName = name.slice(`@${namespace}/`.length);
-        return {
-          global: `${config.global}.${camelize(shortName)}`,
-          handle: `${config.handlePrefix}-${shortName}`,
-          specifier,
-          moduleEligible: false,
-          scriptEligible: true
-        };
-      }
-    }
-    if (matchesScriptModuleNamespace(name)) {
-      return {
-        global: null,
-        handle: null,
-        specifier,
-        moduleEligible: true,
-        scriptEligible: false
-      };
-    }
-    return null;
-  }
   function moduleImportKind(specifier, isDynamic) {
     if (specifier === "@wordpress/interactivity") return "static";
     return isDynamic ? "dynamic" : "static";
@@ -1979,7 +2627,7 @@ function wpExternals(options = {}) {
     enforce: "pre",
     resolveId(source, _importer, options2) {
       const isRequireCall = options2?.kind === "require-call";
-      const external = resolveExternal(source);
+      const external = resolveExternalForThisPlugin(source);
       if (external) {
         if (isRequireCall) {
           if (external.global) {
@@ -1994,7 +2642,7 @@ function wpExternals(options = {}) {
         return { id: source, external: true };
       }
       const commonjsMatch = source.match(/^\0([^?]+)\?commonjs-external$/);
-      if (commonjsMatch && commonjsMatch[1] && resolveExternal(commonjsMatch[1])) {
+      if (commonjsMatch && commonjsMatch[1] && resolveExternalForThisPlugin(commonjsMatch[1])) {
         return source;
       }
       return null;
@@ -2002,7 +2650,7 @@ function wpExternals(options = {}) {
     load(id) {
       if (id.startsWith(CJS_GLOBAL_SHIM_PREFIX)) {
         const specifier = id.slice(CJS_GLOBAL_SHIM_PREFIX.length);
-        const external2 = resolveExternal(specifier);
+        const external2 = resolveExternalForThisPlugin(specifier);
         if (!external2 || !external2.global) return null;
         if (external2.handle) recordDeps(handleDepsByModule, id, [external2.handle]);
         return `module.exports = (typeof window !== "undefined" ? window.${external2.global} : {});
@@ -2010,7 +2658,7 @@ function wpExternals(options = {}) {
       }
       const commonjsMatch = id.match(/^\0([^?]+)\?commonjs-external$/);
       if (!commonjsMatch || !commonjsMatch[1]) return null;
-      const external = resolveExternal(commonjsMatch[1]);
+      const external = resolveExternalForThisPlugin(commonjsMatch[1]);
       if (!external) return null;
       if (buildModeForFile(id) === "module" && external.moduleEligible) {
         return `export default {};`;
@@ -2022,9 +2670,13 @@ function wpExternals(options = {}) {
       return `const __wpExternal = (typeof window !== "undefined" ? window.${external.global} : {}); export default __wpExternal;`;
     }
   };
+  let resolvedRoot = projectRoot;
   const transformPlugin = {
     name: `wp-externals(${buildType})`,
     enforce: "post",
+    configResolved(config) {
+      resolvedRoot = config.root;
+    },
     async transform(code, id) {
       if (!code.includes("@wordpress/") && !Object.keys(vendorExternals).some((packageName) => code.includes(packageName)) && !Object.keys(externalNamespaces).some(
         (namespace) => code.includes(`@${namespace}/`)
@@ -2064,7 +2716,7 @@ Most likely cause: JSX in a file that isn't .jsx/.tsx. JSX must live in .jsx/.ts
       for (const importRecord of imports) {
         const importedSpecifier = importRecord.n;
         if (importedSpecifier === void 0) continue;
-        const external = resolveExternal(importedSpecifier);
+        const external = resolveExternalForThisPlugin(importedSpecifier);
         if (!external) continue;
         const isDynamic = importRecord.d > -1;
         if (fileMode === "script") {
@@ -2198,6 +2850,10 @@ Most likely cause: JSX in a file that isn't .jsx/.tsx. JSX must live in .jsx/.ts
         }
         fields.push(`'version' => '${version}'`);
         if (entryMode === "module") fields.push(`'type' => 'module'`);
+        const sourcePath = entrySourcePath(output.facadeModuleId, resolvedRoot);
+        if (sourcePath) {
+          fields.push(`'source' => '${phpSingleQuoteEscape(sourcePath)}'`);
+        }
         this.emitFile({
           type: "asset",
           fileName: fileName.replace(/\.m?js$/, ".asset.php"),
@@ -2326,15 +2982,47 @@ function parseImportClause(statement) {
   }
   return rest === "" ? clause : null;
 }
+function exportClauseRange(code, exports) {
+  let firstName = Number.POSITIVE_INFINITY;
+  let lastName = -1;
+  for (const record of exports) {
+    firstName = Math.min(firstName, record.s, record.ls >= 0 ? record.ls : record.s);
+    lastName = Math.max(lastName, record.e, record.le >= 0 ? record.le : record.e);
+  }
+  if (lastName < 0) return null;
+  const brace = code.lastIndexOf("{", firstName);
+  if (brace < 0) return null;
+  const beforeBrace = code.slice(0, brace).trimEnd();
+  if (!beforeBrace.endsWith("export")) return null;
+  const start = beforeBrace.length - "export".length;
+  if (start > 0 && /[\w$]/.test(code[start - 1])) return null;
+  const close = code.indexOf("}", lastName);
+  if (close < 0) return null;
+  let end = close + 1;
+  while (end < code.length && /\s/.test(code[end])) end += 1;
+  if (code[end] === ";") end += 1;
+  if (!/^export\s*\{[^{}]*\}\s*;?$/.test(code.slice(start, end))) return null;
+  return { start, end };
+}
 function toInlineExpression(code) {
   const [imports, exports] = parse(code);
   if (imports.length > 0) return null;
-  const body = code.replace(/^[ \t]*export\s*\{[^}]*\}\s*;?[ \t]*$/gm, "");
-  if (body === code && exports.length > 0) return null;
-  if (/^\s*(?:import|export)\b/m.test(body)) return null;
+  let body = code;
+  if (exports.length > 0) {
+    const range = exportClauseRange(code, exports);
+    if (!range) return null;
+    body = code.slice(0, range.start) + code.slice(range.end);
+  }
+  try {
+    const [bodyImports, bodyExports] = parse(body);
+    if (bodyImports.length > 0 || bodyExports.length > 0) return null;
+  } catch {
+    return null;
+  }
   const returned = exports.map((record) => `${objectKey(record.n)}: ${record.ln ?? record.n}`).join(", ");
   return `(() => {
 ${body.trim()}
+;
 return { ${returned} };
 })()`;
 }
@@ -2363,32 +3051,46 @@ function wpScriptDedupe() {
     // and normal buckets.
     enforce: "pre",
     apply: "build",
-    async resolveId(source, importer, options) {
-      if (!importer) return null;
-      if (source.includes("\0")) return null;
-      const key = `${importer}
+    resolveId: {
+      // `enforce: 'pre'` alone only puts this plugin in the pre bucket —
+      // *within* it, array position decides, and any pre-bucket resolver
+      // registered earlier answers first and hands back an untagged id.
+      // wpExternals' force-bundle resolver is exactly that: it answers
+      // `wp-vite-bundled:@wordpress/icons` itself, so the barrel came back
+      // unpartitioned and its whole subtree inherited one marker minted
+      // from the barrel — identical for every entry, i.e. a shared chunk
+      // (issue #23). Hook-level `order: 'pre'` puts this resolver ahead of
+      // every other resolveId hook no matter how the plugins are composed;
+      // it delegates through `this.resolve`, so those resolvers still
+      // decide *what* an id resolves to. This plugin only tags the answer.
+      order: "pre",
+      async handler(source, importer, options) {
+        if (!importer) return null;
+        if (source.includes("\0")) return null;
+        const key = `${importer}
 ${source}`;
-      if (inFlight.has(key)) return null;
-      const marker = markerOf(importer) ?? mintMarker(importer);
-      inFlight.add(key);
-      let resolved;
-      try {
-        resolved = await this.resolve(
-          stripEntryMarker(source),
-          stripEntryMarker(importer),
-          {
-            // `kind` rides along so plugins keying on `require-call`
-            // (wpExternals' CJS shim) still see the truth.
-            ...options,
-            skipSelf: true
-          }
-        );
-      } finally {
-        inFlight.delete(key);
+        if (inFlight.has(key)) return null;
+        const marker = markerOf(importer) ?? mintMarker(importer);
+        inFlight.add(key);
+        let resolved;
+        try {
+          resolved = await this.resolve(
+            stripEntryMarker(source),
+            stripEntryMarker(importer),
+            {
+              // `kind` rides along so plugins keying on `require-call`
+              // (wpExternals' CJS shim) still see the truth.
+              ...options,
+              skipSelf: true
+            }
+          );
+        } finally {
+          inFlight.delete(key);
+        }
+        if (!resolved || resolved.external) return resolved;
+        if (!isPartitionable(resolved.id)) return resolved;
+        return { ...resolved, id: withMarker(resolved.id, marker) };
       }
-      if (!resolved || resolved.external) return resolved;
-      if (!isPartitionable(resolved.id)) return resolved;
-      return { ...resolved, id: withMarker(resolved.id, marker) };
     },
     generateBundle: {
       // Load-bearing, not cosmetic: wpExternals emits its `.asset.php`
@@ -2512,7 +3214,14 @@ var CLASSIC_SCRIPT_DEFINE = {
   "import.meta.resolve": "undefined"
 };
 var LIVE_MODULE_STATEMENT = /^[ \t]*(?:import\s*(?:[{*"']|[A-Za-z_$][\w$]*\s*(?:,|from\b))|export\s*(?:[{*]|(?:default|const|let|var|function|class|async)\b))[^\n]*/m;
-function wpScriptIife() {
+var ROLLDOWN_REQUIRE_SHIM = /typeof\s+require\s*(?:<|!==?|===?)/;
+var REQUIRE_CALL = /(?:^|[^.\w$])require\s*\(/;
+function buildRequireShim(globals) {
+  const cases = [...globals.entries()].map(([specifier, global]) => `case ${JSON.stringify(specifier)}:return window.${global};`).join("");
+  return `const require=(id)=>{switch(id){${cases}}throw new Error('require("'+id+'") is not mapped to a global in this classic script.');};`;
+}
+function wpScriptIife(options = {}) {
+  const globals = options.globals ?? /* @__PURE__ */ new Map();
   return {
     name: "wp-script-iife",
     // Build-only. Vite filters plugins by `apply` before it runs `config`,
@@ -2528,34 +3237,68 @@ function wpScriptIife() {
       }
       return Object.keys(define).length > 0 ? { define } : null;
     },
-    async writeBundle(options, bundle) {
+    async writeBundle(options2, bundle) {
       const { readFile, writeFile } = await import('fs/promises');
-      const { join: join5 } = await import('path');
-      const outDir = options.dir ?? ".";
+      const { join: join6 } = await import('path');
+      const outDir = options2.dir ?? ".";
+      const pending = [];
+      const failures = [];
       for (const [fileName, output] of Object.entries(bundle)) {
         if (output.type !== "chunk") continue;
         if (!fileName.endsWith(".js") && !fileName.endsWith(".mjs")) continue;
         if (!output.isEntry && !output.isDynamicEntry) continue;
-        const filePath = join5(outDir, fileName);
+        const filePath = join6(outDir, fileName);
         let chunkSource = await readFile(filePath, "utf8");
-        const sideEffectImport = /^\s*import\s+["'][^"']+["'];?\s*\n?/;
+        const sideEffectImport = /^\s*import\s*["'][^"']+["'];?\s*\n?/;
         while (sideEffectImport.test(chunkSource)) {
           chunkSource = chunkSource.replace(sideEffectImport, "");
         }
-        assertClassicScript(fileName, chunkSource, output.isEntry !== true);
-        await writeFile(filePath, `(()=>{
+        const failure = classicScriptFailure(
+          fileName,
+          chunkSource,
+          output.isEntry !== true
+        );
+        if (failure) {
+          failures.push(failure);
+          continue;
+        }
+        if (ROLLDOWN_REQUIRE_SHIM.test(chunkSource)) {
+          pending.push({
+            filePath,
+            body: `${buildRequireShim(globals)}(()=>{
 ${chunkSource}
+})();`
+          });
+          continue;
+        }
+        if (globals.size > 0 && REQUIRE_CALL.test(chunkSource)) {
+          this.warn(
+            `${fileName} calls \`require()\` but carries none of Rolldown's runtime require shim, so no global mapping was injected. If this is a CJS dependency reaching for an external, it will throw at runtime \u2014 please report it, as the shim's shape may have changed.`
+          );
+        }
+        pending.push({ filePath, body: chunkSource });
+      }
+      if (failures.length > 0) {
+        throw new Error(
+          `wp-script-iife: ${failures.length} chunk(s) are not valid as classic scripts, so nothing was wrapped:
+
+${failures.join("\n\n")}`
+        );
+      }
+      for (const { filePath, body } of pending) {
+        await writeFile(filePath, `(()=>{
+${body}
 })();
 `);
       }
     }
   };
 }
-function assertClassicScript(fileName, code, isDynamicOnly = false) {
+function classicScriptFailure(fileName, code, isDynamicOnly = false) {
   let parseError;
   try {
     new Function(code);
-    return;
+    return null;
   } catch (error) {
     if (!(error instanceof SyntaxError)) throw error;
     parseError = error;
@@ -2563,24 +3306,19 @@ function assertClassicScript(fileName, code, isDynamicOnly = false) {
   const liveStatement = code.match(LIVE_MODULE_STATEMENT);
   if (liveStatement) {
     const specifiers = [...code.matchAll(/^[ \t]*(?:import|export)\b[^\n]*?["']([^"']+)["']/gm)].map((match) => match[1]).filter((specifier, index, all) => all.indexOf(specifier) === index);
-    throw new Error(
-      `wp-script-iife: ${fileName} still contains a top-level module statement, which is a SyntaxError once WordPress enqueues it as a classic script:
+    return `wp-script-iife: ${fileName} still contains a top-level module statement, which is a SyntaxError once WordPress enqueues it as a classic script:
     ${liveStatement[0].trim()}
 ` + (specifiers.length > 0 ? `  Imported chunk(s): ${specifiers.join(", ")}
-` : "") + (isDynamicOnly ? `  This file is a dynamic-import chunk, so it needs its \`export\`s and cannot be an IIFE. A script-mode entry can't lazily load one either (WP has no module context to resolve it in) \u2014 drop the dynamic \`import()\`, or build this entry in module mode.` : `  This is almost always a shared chunk: a module two or more script-mode entries import gets hoisted into its own chunk instead of being duplicated into each entry. Add the wpScriptDedupe() plugin (auto-included by wp() in script mode \u2014 check you haven't set \`scriptDedupe: false\`), or build this entry in module mode.`)
-    );
+` : "") + (isDynamicOnly ? `  This file is a dynamic-import chunk, so it needs its \`export\`s and cannot be an IIFE. A script-mode entry can't lazily load one either (WP has no module context to resolve it in) \u2014 drop the dynamic \`import()\`, or build this entry in module mode.` : `  This is almost always a shared chunk: a module two or more script-mode entries import gets hoisted into its own chunk instead of being duplicated into each entry. Add the wpScriptDedupe() plugin (auto-included by wp() in script mode \u2014 check you haven't set \`scriptDedupe: false\`), or build this entry in module mode.
+  If the specifier above is a bare \`@wordpress/*\` package rather than a relative chunk path, this is instead a module-only package (no \`wpScript\` in its package.json) imported into a script-mode entry \u2014 wpExternals warns about it by name earlier in the build. Move that import to a viewScriptModule entry, or build this entry in module mode.`);
   }
   if (/\bimport\.meta\b/.test(code)) {
-    throw new Error(
-      `wp-script-iife: ${fileName} references \`import.meta\`, which is a SyntaxError once WordPress enqueues it as a classic script.
-  Vite injects its module-preload helper (which reads \`import.meta.url\`) whenever the bundled graph contains a dynamic \`import()\` \u2014 \`build.modulePreload: false\` does not remove it. This plugin's \`config()\` hook defines \`import.meta.url\`/\`import.meta.resolve\` away; a surviving reference means either that define was overridden, or the code touches another \`import.meta\` member. Extend \`define\` in your Vite config, or move this entry to module mode.`
-    );
+    return `wp-script-iife: ${fileName} references \`import.meta\`, which is a SyntaxError once WordPress enqueues it as a classic script.
+  Vite injects its module-preload helper (which reads \`import.meta.url\`) whenever the bundled graph contains a dynamic \`import()\` \u2014 \`build.modulePreload: false\` does not remove it. This plugin's \`config()\` hook defines \`import.meta.url\`/\`import.meta.resolve\` away; a surviving reference means either that define was overridden, or the code touches another \`import.meta\` member. Extend \`define\` in your Vite config, or move this entry to module mode.`;
   }
-  throw new Error(
-    `wp-script-iife: ${fileName} does not parse as a classic script, so WordPress could not load it:
+  return `wp-script-iife: ${fileName} does not parse as a classic script, so WordPress could not load it:
     ${parseError.message}
-  Nothing in this plugin's usual suspects (a shared chunk's \`import\`, an \`import.meta\` reference) explains it \u2014 inspect the written file, and report it upstream if the source is valid.`
-  );
+  Nothing in this plugin's usual suspects (a shared chunk's \`import\`, an \`import.meta\` reference) explains it \u2014 inspect the written file, and report it upstream if the source is valid.`;
 }
 
 // src/wp-clean-css-chunks.ts
@@ -2599,17 +3337,37 @@ function wpCleanCssChunks() {
   };
 }
 var STYLESHEET_EXTENSION = /\.(css|scss|sass)$/i;
+function tryRealpath(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return path;
+  }
+}
+function entrySourcePath2(sourcePath, root) {
+  const relativePath = relative(tryRealpath(root), tryRealpath(sourcePath)).replace(/\\/g, "/");
+  if (relativePath === "" || relativePath === ".." || relativePath.startsWith("../")) {
+    return null;
+  }
+  if (isAbsolute(relativePath)) return null;
+  return relativePath;
+}
+function phpSingleQuoteEscape2(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
 function wpCssAssetInfo() {
   const cssEntries = /* @__PURE__ */ new Map();
+  let resolvedRoot = process.cwd();
   return {
     name: "wp-css-asset-info",
     configResolved(config) {
       cssEntries.clear();
+      resolvedRoot = config.root;
       const input = config.build?.rollupOptions?.input;
       if (!input || typeof input !== "object" || Array.isArray(input)) return;
       for (const [entryName, source] of Object.entries(input)) {
         if (typeof source === "string" && STYLESHEET_EXTENSION.test(source)) {
-          cssEntries.set(entryName, source);
+          cssEntries.set(entryName, resolve(config.root, source));
         }
       }
     },
@@ -2626,10 +3384,13 @@ function wpCssAssetInfo() {
           const assetPhpFileName = cssAsset.fileName.replace(/\.css$/i, ".asset.php");
           if (bundle[assetPhpFileName]) continue;
           const version = crypto.createHash("md5").update(cssAsset.source).digest("hex");
+          const fields = [`'dependencies' => array()`, `'version' => '${version}'`];
+          const source = entrySourcePath2(sourcePath, resolvedRoot);
+          if (source) fields.push(`'source' => '${phpSingleQuoteEscape2(source)}'`);
           this.emitFile({
             type: "asset",
             fileName: assetPhpFileName,
-            source: `<?php return array( 'dependencies' => array(), 'version' => '${version}' );
+            source: `<?php return array( ${fields.join(", ")} );
 `
           });
         }
@@ -2647,6 +3408,681 @@ function findCssAsset(bundle, expectedFileName, sourcePath) {
   }
   return void 0;
 }
+var HOT_FILE_NAME = ".wp-vite-dev.json";
+var DEV_SERVER_PHP_NAME = "dev-server.php";
+var DEFAULT_PHP_PREFIX = "wp-vite";
+var REPORTED_PLUGINS = ["vite:react-refresh"];
+var SCAN_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+var STYLESHEET_EXTENSION2 = /\.(css|scss|sass)$/i;
+var JSX_SOURCE_EXTENSION = /\.[jt]sx$/i;
+var JSX_RUNTIME_SPECIFIER = "react/jsx-runtime";
+var DEFAULT_MAX_SCAN_DEPTH = 24;
+var REDISCOVER_DEBOUNCE_MS = 50;
+function wpDevServer(options = {}) {
+  const projectRoot = options.projectRoot ?? process.cwd();
+  const emitManifest = options.emitManifest ?? true;
+  const buildType = options.buildType ?? "script";
+  const skip = new Set(options.skip ?? []);
+  const maxScanDepth = options.maxScanDepth ?? DEFAULT_MAX_SCAN_DEPTH;
+  const moduleEntryMatchers = options.moduleEntryMatchers;
+  const wpBuildAssetMatchers = (options.wpBuildAssetMatchers ?? []).map(toPosix);
+  const resolveExternalOptions = {
+    projectRoot,
+    ...options.additionalExternals ? { vendorExternals: options.additionalExternals } : {},
+    ...options.externalNamespaces ? { externalNamespaces: options.externalNamespaces } : {},
+    ...options.scriptModuleNamespaces ? { scriptModuleNamespaces: options.scriptModuleNamespaces } : {},
+    ...options.bundledPackages ? { bundledPackages: options.bundledPackages } : {}
+  };
+  const blocksDirAbs = options.blocksDir ? resolve(process.cwd(), options.blocksDir) : null;
+  const blockStylesDirAbs = options.blocksStylesDir ? resolve(process.cwd(), options.blocksStylesDir) : null;
+  const adminPagesDirAbs = options.adminPagesDir ? resolve(process.cwd(), options.adminPagesDir) : null;
+  let config;
+  let outDirAbs = "";
+  let entries = [];
+  let configuredEntries = {};
+  let entriesByFile = /* @__PURE__ */ new Map();
+  let writtenSidecars = /* @__PURE__ */ new Set();
+  let writtenBlockFiles = /* @__PURE__ */ new Set();
+  const collectEntries = () => discoverDevEntries({
+    blocksDirAbs,
+    blockStylesDirAbs,
+    adminPagesDirAbs,
+    skip,
+    configuredEntries,
+    buildType
+  });
+  const syncModuleEntryMatchers = () => {
+    if (!moduleEntryMatchers) return;
+    for (const entry of entries) {
+      if (entry.mode !== "module" || entry.kind !== "js") continue;
+      const matcher = toPosix(entry.file);
+      if (!moduleEntryMatchers.includes(matcher)) moduleEntryMatchers.push(matcher);
+    }
+  };
+  return {
+    name: "wp-dev-server",
+    // Build is untouched: every write below exists only because there is no
+    // bundle to emit into.
+    apply: "serve",
+    /**
+     * WordPress ships the *production* JSX runtime and nothing else. Core's
+     * `react-jsx-runtime` handle is built from `react/jsx-runtime`, so
+     * `window.ReactJSXRuntime` carries `jsx`, `jsxs` and `Fragment` — there
+     * is no `jsxDEV` on it, in `SCRIPT_DEBUG` or out of it.
+     *
+     * Vite's serve default is the opposite: JSX compiles against the dev
+     * runtime, `react/jsx-dev-runtime`. `wpExternals` then does exactly what
+     * it is supposed to and rewrites that import to the global WordPress
+     * registers for it, so every block editor script with JSX in it comes
+     * out as `const { jsxDEV: _jsxDEV } = (window.ReactJSXRuntime)` —
+     * `undefined`, and a `_jsxDEV is not a function` the moment anything
+     * renders. Builds never see it (`development` is off there), which makes
+     * it a dev-only cliff that a passing build tells you nothing about.
+     *
+     * Filled in only where the user has no opinion, the same rule
+     * `wpScriptIife`'s `define` injection and `wpModuleEntrySignatures`
+     * follow. The cost is the `__source`/`__self` debug props; the benefit is
+     * that the editor script runs at all.
+     */
+    config(userConfig) {
+      const oxc = userConfig.oxc;
+      if (oxc === false) return null;
+      const jsx = oxc?.jsx;
+      if (jsx === "preserve") return null;
+      if (jsx && typeof jsx === "object" && jsx.development !== void 0) return null;
+      return { oxc: { jsx: { development: false } } };
+    },
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+      outDirAbs = resolve(resolvedConfig.root, resolvedConfig.build.outDir);
+      configuredEntries = readConfiguredEntries(resolvedConfig);
+      entries = collectEntries();
+      syncModuleEntryMatchers();
+    },
+    /**
+     * Answer for the bare specifiers the escape above hands back to the
+     * browser.
+     *
+     * `installBareSpecifierEscape` rewrites the served code *after*
+     * import-analysis, which means Vite's module graph still holds the
+     * `/@id/@wordpress/interactivity` form it produced — and Vite eagerly
+     * pre-transforms every import it recorded. That request resolves to a
+     * bare specifier nothing on disk backs, and the console gets a red
+     * `Pre-transform error: Failed to load url @wordpress/interactivity` for
+     * every Script Module entry, on a server that is working perfectly.
+     *
+     * An empty module makes the warm-up succeed and changes nothing else:
+     * the URL is not in the code any browser receives, so it is never
+     * fetched — WordPress's import map resolves the specifier instead.
+     * Narrow by construction: only ids `resolveExternal()` recognizes (i.e.
+     * an installed package whose own metadata says it is externalizable),
+     * and never a path, so a genuinely missing module still fails loudly.
+     */
+    load(id) {
+      if (id.startsWith(".") || id.startsWith("/") || id.startsWith("\0")) return null;
+      if (isAbsolute(id) || !resolveExternal(id, resolveExternalOptions)) return null;
+      return "export {};\n";
+    },
+    async configureServer(server) {
+      installBareSpecifierEscape(server, config, resolveExternalOptions);
+      const refreshAll = async () => {
+        const { index, written } = await writeAllSidecars({
+          entries,
+          outDirAbs,
+          root: config.root,
+          resolveExternalOptions,
+          wpBuildAssetMatchers,
+          maxScanDepth
+        });
+        entriesByFile = index;
+        pruneStale(writtenSidecars, written);
+        writtenSidecars = written;
+      };
+      const refreshFor = async (file) => {
+        const affected = entriesByFile.get(toPosix(file));
+        if (!affected || affected.size === 0) return;
+        const subset = entries.filter((entry) => affected.has(entry.name));
+        const { index: rescanned } = await writeAllSidecars({
+          entries: subset,
+          outDirAbs,
+          root: config.root,
+          resolveExternalOptions,
+          wpBuildAssetMatchers,
+          maxScanDepth
+        });
+        for (const [scannedFile, names] of rescanned) {
+          const existing = entriesByFile.get(scannedFile);
+          if (existing) for (const name of names) existing.add(name);
+          else entriesByFile.set(scannedFile, new Set(names));
+        }
+      };
+      const refreshBlocksTree = () => {
+        const written = writeBlocksTree({ blocksDirAbs, outDirAbs, emitManifest, skip });
+        pruneStale(writtenBlockFiles, written);
+        writtenBlockFiles = written;
+      };
+      const addWatchDirs = () => {
+        for (const dir of [blocksDirAbs, blockStylesDirAbs, adminPagesDirAbs]) {
+          if (dir && existsSync(dir)) server.watcher.add(dir);
+        }
+      };
+      const rediscover = () => {
+        addWatchDirs();
+        refreshBlocksTree();
+        configuredEntries = readConfiguredEntries(config);
+        entries = collectEntries();
+        syncModuleEntryMatchers();
+        return refreshAll();
+      };
+      refreshBlocksTree();
+      writeFileTree(
+        join(outDirAbs, DEV_SERVER_PHP_NAME),
+        renderDevServerPhp({
+          prefix: resolvePhpPrefix(options.phpPrefix, config.root),
+          hotFile: HOT_FILE_NAME
+        })
+      );
+      await refreshAll();
+      addWatchDirs();
+      watchSources({
+        server,
+        sourceDirs: [blocksDirAbs, blockStylesDirAbs, adminPagesDirAbs],
+        blocksDirAbs,
+        onRediscover: rediscover,
+        onFileChange: (file) => refreshFor(file)
+      });
+      const hotFilePath = join(outDirAbs, HOT_FILE_NAME);
+      const httpServer = server.httpServer;
+      if (httpServer) {
+        httpServer.once("listening", () => {
+          const hotFile = buildHotFile(config, httpServer.address());
+          writeFileTree(hotFilePath, `${JSON.stringify(hotFile, null, "	")}
+`);
+          registerHotFileCleanup(hotFilePath);
+        });
+      }
+    },
+    /**
+     * Vite closes the plugin container on `server.close()`, which is what
+     * makes this fire for a programmatically-created server (tests, a
+     * wrapper process). The `process` handlers registered above cover the
+     * interactive case, where nothing calls `close()` at all.
+     */
+    closeBundle() {
+      removeHotFile(join(outDirAbs, HOT_FILE_NAME));
+    }
+  };
+}
+function wpDevServerPhp(options = {}) {
+  let projectRoot = options.projectRoot ?? process.cwd();
+  return {
+    name: "wp-dev-server-php",
+    apply: "build",
+    configResolved(resolvedConfig) {
+      projectRoot = options.projectRoot ?? resolvedConfig.root;
+    },
+    generateBundle() {
+      this.emitFile({
+        type: "asset",
+        fileName: DEV_SERVER_PHP_NAME,
+        source: renderDevServerPhp({
+          prefix: resolvePhpPrefix(options.phpPrefix, projectRoot),
+          hotFile: HOT_FILE_NAME
+        })
+      });
+    }
+  };
+}
+function resolvePhpPrefix(explicit, projectRoot) {
+  const fromOption = sanitizePhpPrefix(explicit);
+  if (fromOption) return fromOption;
+  let packageJson = {};
+  try {
+    packageJson = JSON.parse(readFileSync(join(projectRoot, "package.json"), "utf8"));
+  } catch {
+  }
+  return sanitizePhpPrefix(packageJson.wpPlugin?.name) ?? sanitizePhpPrefix(packageJson.name?.replace(/^@[^/]+\//, "")) ?? DEFAULT_PHP_PREFIX;
+}
+function sanitizePhpPrefix(value) {
+  if (!value) return null;
+  const cleaned = value.replace(/[^A-Za-z0-9_-]/g, "-").replace(/^-+|-+$/g, "");
+  return cleaned !== "" && isValidPhpIdentifier(cleaned) ? cleaned : null;
+}
+function buildHotFile(config, address) {
+  return {
+    origin: resolveDevOrigin(config, address),
+    base: config.base,
+    plugins: REPORTED_PLUGINS.filter(
+      (name) => config.plugins.some((plugin) => plugin.name === name)
+    )
+  };
+}
+var UNPUBLISHABLE_ADDRESSES = /* @__PURE__ */ new Set([
+  "0.0.0.0",
+  "::",
+  "::0",
+  "0000:0000:0000:0000:0000:0000:0000:0000",
+  "127.0.0.1",
+  "::1",
+  "0000:0000:0000:0000:0000:0000:0000:0001"
+]);
+function resolveDevOrigin(config, address) {
+  const explicitOrigin = config.server?.origin;
+  if (typeof explicitOrigin === "string" && explicitOrigin.length > 0) {
+    return explicitOrigin.replace(/\/+$/, "");
+  }
+  const hmr = typeof config.server?.hmr === "object" ? config.server.hmr : null;
+  const hmrProtocol = hmr && "protocol" in hmr ? hmr.protocol : void 0;
+  const protocol = hmrProtocol ? hmrProtocol === "wss" ? "https" : "http" : config.server?.https ? "https" : "http";
+  const hmrHost = hmr && "host" in hmr && typeof hmr.host === "string" ? hmr.host : void 0;
+  const configHost = typeof config.server?.host === "string" ? config.server.host : void 0;
+  const boundHost = address && typeof address === "object" ? address.address : void 0;
+  const host = hmrHost ?? configHost ?? (boundHost ? normalizeBoundHost(boundHost) : "localhost");
+  const hmrClientPort = hmr && "clientPort" in hmr && typeof hmr.clientPort === "number" ? hmr.clientPort : void 0;
+  const boundPort = address && typeof address === "object" ? address.port : void 0;
+  const port = hmrClientPort ?? boundPort;
+  return port === void 0 ? `${protocol}://${host}` : `${protocol}://${host}:${port}`;
+}
+function normalizeBoundHost(host) {
+  if (UNPUBLISHABLE_ADDRESSES.has(host)) return "localhost";
+  if (host.includes(":") && !host.startsWith("[")) return `[${host}]`;
+  return host;
+}
+var pendingHotFiles = /* @__PURE__ */ new Set();
+var hotFileHandlersBound = false;
+function registerHotFileCleanup(hotFilePath) {
+  pendingHotFiles.add(hotFilePath);
+  if (hotFileHandlersBound) return;
+  hotFileHandlersBound = true;
+  const cleanAll = () => {
+    for (const filePath of pendingHotFiles) removeHotFile(filePath);
+    pendingHotFiles.clear();
+  };
+  process.on("exit", cleanAll);
+  for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+    process.on(signal, () => {
+      cleanAll();
+      process.exit();
+    });
+  }
+}
+function removeHotFile(hotFilePath) {
+  pendingHotFiles.delete(hotFilePath);
+  try {
+    rmSync(hotFilePath, { force: true });
+  } catch {
+  }
+}
+var decoratedEnvironments = /* @__PURE__ */ new WeakSet();
+function installBareSpecifierEscape(server, config, resolveExternalOptions) {
+  const base = config.base ?? "/";
+  const wrappedPrefix = `${base.replace(/\/+$/, "")}/@id/`;
+  const pattern = new RegExp(`(["'])${escapeRegExp2(wrappedPrefix)}([^"'\\s]+)\\1`, "g");
+  const unwrap = (code) => code.replace(
+    pattern,
+    (match, quote, specifier) => resolveExternal(specifier, resolveExternalOptions) ? `${quote}${specifier}${quote}` : match
+  );
+  for (const environment of Object.values(server.environments)) {
+    if (decoratedEnvironments.has(environment)) continue;
+    decoratedEnvironments.add(environment);
+    const original = environment.transformRequest.bind(environment);
+    environment.transformRequest = async (url) => {
+      const result = await original(url);
+      if (!result || typeof result.code !== "string") return result;
+      if (!result.code.includes(wrappedPrefix)) return result;
+      const code = unwrap(result.code);
+      return code === result.code ? result : { ...result, code };
+    };
+  }
+}
+function escapeRegExp2(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function discoverDevEntries(options) {
+  const { blocksDirAbs, blockStylesDirAbs, adminPagesDirAbs, skip } = options;
+  const byName = /* @__PURE__ */ new Map();
+  const add = (entry) => {
+    if (!byName.has(entry.name)) byName.set(entry.name, entry);
+  };
+  if (blocksDirAbs && existsSync(blocksDirAbs)) {
+    for (const [name, file] of Object.entries(discoverEntries(blocksDirAbs, "module", skip))) {
+      add({ name, file, mode: "module", kind: entryKind(file) });
+    }
+    for (const [name, file] of Object.entries(discoverEntries(blocksDirAbs, "script", skip))) {
+      add({ name, file, mode: "script", kind: entryKind(file) });
+    }
+  }
+  if (blockStylesDirAbs && existsSync(blockStylesDirAbs)) {
+    const stylesheets = fg.sync(`${toPosix(blockStylesDirAbs)}/**/*.{css,scss,sass}`, {
+      absolute: true
+    });
+    for (const file of stylesheets) {
+      const blockName = relative(blockStylesDirAbs, file).replace(extname(file), "").replace(/\\/g, "/");
+      add({ name: `autoenqueue/${blockName}`, file, mode: "script", kind: "css" });
+    }
+  }
+  if (adminPagesDirAbs && existsSync(adminPagesDirAbs)) {
+    for (const page of discoverPages(adminPagesDirAbs)) {
+      add({
+        name: `modules/${page.dirName}/content`,
+        file: page.content,
+        mode: "module",
+        kind: "js"
+      });
+      if (page.route) {
+        add({
+          name: `modules/${page.dirName}/route`,
+          file: page.route,
+          mode: "module",
+          kind: "js"
+        });
+      }
+      for (const subRoute of page.subRoutes) {
+        const base = `modules/${page.dirName}/routes/${subRoute.name}`;
+        if (subRoute.content) {
+          add({
+            name: `${base}/content`,
+            file: subRoute.content,
+            mode: "module",
+            kind: "js"
+          });
+        }
+        if (subRoute.route) {
+          add({
+            name: `${base}/route`,
+            file: subRoute.route,
+            mode: "module",
+            kind: "js"
+          });
+        }
+      }
+    }
+  }
+  for (const [name, file] of Object.entries(options.configuredEntries ?? {})) {
+    add({ name, file, mode: options.buildType ?? "script", kind: entryKind(file) });
+  }
+  return [...byName.values()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+}
+function readConfiguredEntries(config) {
+  const input = config.build?.rollupOptions?.input;
+  if (!input || typeof input !== "object" || Array.isArray(input)) return {};
+  const entries = {};
+  for (const [name, source] of Object.entries(input)) {
+    if (typeof source !== "string") continue;
+    const file = resolve(config.root, source);
+    if (existsSync(file)) entries[name] = file;
+  }
+  return entries;
+}
+function entryKind(file) {
+  return STYLESHEET_EXTENSION2.test(file) ? "css" : "js";
+}
+async function scanEntryDependencies(entryFile, options) {
+  const maxDepth = options.maxDepth ?? DEFAULT_MAX_SCAN_DEPTH;
+  const moduleIds = /* @__PURE__ */ new Set();
+  const dynamicModuleIds = /* @__PURE__ */ new Set();
+  const handles = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const files = [];
+  let hasJsxSource = false;
+  await init;
+  const queue = [{ file: entryFile, depth: 0 }];
+  while (queue.length > 0) {
+    const { file, depth } = queue.shift();
+    const key = toPosix(file);
+    if (visited.has(key)) continue;
+    visited.add(key);
+    files.push(key);
+    if (JSX_SOURCE_EXTENSION.test(key)) hasJsxSource = true;
+    if (depth >= maxDepth) continue;
+    if (STYLESHEET_EXTENSION2.test(file)) continue;
+    let code;
+    try {
+      code = readFileSync(file, "utf8");
+    } catch {
+      continue;
+    }
+    for (const { specifier, isDynamic } of lexImports(code, file)) {
+      if (specifier.startsWith(".") || isAbsolute(specifier)) {
+        const resolved = resolveLocalImport(specifier, file);
+        if (resolved) queue.push({ file: resolved, depth: depth + 1 });
+        continue;
+      }
+      const external = resolveExternal(specifier, options.resolveExternalOptions);
+      if (!external) continue;
+      if (options.mode === "module" && external.moduleEligible) {
+        if (isDynamic && specifier !== "@wordpress/interactivity") {
+          dynamicModuleIds.add(external.specifier);
+        } else {
+          moduleIds.add(external.specifier);
+        }
+        continue;
+      }
+      if (external.handle) handles.add(external.handle);
+    }
+  }
+  if (hasJsxSource) {
+    const jsxRuntime = resolveExternal(JSX_RUNTIME_SPECIFIER, options.resolveExternalOptions);
+    if (jsxRuntime?.handle) handles.add(jsxRuntime.handle);
+  }
+  for (const id of moduleIds) dynamicModuleIds.delete(id);
+  return {
+    moduleIds: [...moduleIds].sort(),
+    dynamicModuleIds: [...dynamicModuleIds].sort(),
+    handles: [...handles].sort(),
+    files
+  };
+}
+function lexImports(code, file) {
+  try {
+    const [imports] = parse(code, file);
+    const found = [];
+    for (const importRecord of imports) {
+      if (importRecord.n === void 0) continue;
+      found.push({ specifier: importRecord.n, isDynamic: importRecord.d > -1 });
+    }
+    return found;
+  } catch {
+    return regexImports(code);
+  }
+}
+function stripComments(code) {
+  return code.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:"'`\\])\/\/[^\n]*/g, "$1");
+}
+var DYNAMIC_IMPORT_RE = /\bimport\s*\(\s*(['"])([^'"]+)\1\s*\)/g;
+var STATIC_FROM_RE = /(?:^|[\s;}(])(?:import|export)\b[^;]*?\bfrom\s*(['"])([^'"]+)\1/g;
+var BARE_IMPORT_RE = /(?:^|[\s;}])import\s*(['"])([^'"]+)\1/g;
+function regexImports(code) {
+  const source = stripComments(code);
+  const found = /* @__PURE__ */ new Map();
+  const record = (specifier, isDynamic) => {
+    const existing = found.get(specifier);
+    if (existing && !existing.isDynamic) return;
+    found.set(specifier, { specifier, isDynamic });
+  };
+  for (const match of source.matchAll(DYNAMIC_IMPORT_RE)) record(match[2], true);
+  for (const match of source.matchAll(STATIC_FROM_RE)) record(match[2], false);
+  for (const match of source.matchAll(BARE_IMPORT_RE)) record(match[2], false);
+  return [...found.values()];
+}
+function resolveLocalImport(specifier, importerFile) {
+  const withoutQuery = specifier.split("?")[0] ?? specifier;
+  const target = isAbsolute(withoutQuery) ? withoutQuery : join(dirname(importerFile), withoutQuery);
+  if (existsSync(target) && !isDirectory(target)) return target;
+  const candidates = [];
+  const withoutJsExtension = target.replace(/\.[mc]?js$/, "");
+  for (const extension of SCAN_EXTENSIONS) {
+    candidates.push(`${target}${extension}`);
+    if (withoutJsExtension !== target) candidates.push(`${withoutJsExtension}${extension}`);
+  }
+  for (const extension of SCAN_EXTENSIONS) candidates.push(join(target, `index${extension}`));
+  return candidates.find((candidate) => existsSync(candidate)) ?? null;
+}
+function isDirectory(filePath) {
+  try {
+    return existsSync(filePath) && extname(filePath) === "";
+  } catch {
+    return false;
+  }
+}
+function renderDevAssetPhp(input) {
+  const { scan, mode, kind, source } = input;
+  const phpList = (items) => items.length > 0 ? ` ${items.join(", ")} ` : "";
+  const quoted = (items) => items.map((item) => `'${phpSingleQuoteEscape3(item)}'`);
+  const fields = [];
+  if (kind === "css") {
+    fields.push(`'dependencies' => array()`);
+  } else if (input.wpBuildShape) {
+    fields.push(`'dependencies' => array(${phpList(quoted(scan.handles))})`);
+    const moduleDependencies = [
+      ...scan.moduleIds.map(
+        (id) => `array( 'id' => '${phpSingleQuoteEscape3(id)}', 'import' => 'static' )`
+      ),
+      ...scan.dynamicModuleIds.map(
+        (id) => `array( 'id' => '${phpSingleQuoteEscape3(id)}', 'import' => 'dynamic' )`
+      )
+    ];
+    if (moduleDependencies.length > 0) {
+      fields.push(`'module_dependencies' => array(${phpList(moduleDependencies)})`);
+    }
+  } else if (mode === "module") {
+    const moduleDependencies = [
+      ...quoted(scan.moduleIds),
+      ...scan.dynamicModuleIds.map(
+        (id) => `array( 'id' => '${phpSingleQuoteEscape3(id)}', 'import' => 'dynamic' )`
+      )
+    ];
+    fields.push(`'dependencies' => array(${phpList(moduleDependencies)})`);
+    if (scan.handles.length > 0) {
+      fields.push(`'script_dependencies' => array(${phpList(quoted(scan.handles))})`);
+    }
+  } else {
+    fields.push(`'dependencies' => array(${phpList(quoted(scan.handles))})`);
+  }
+  fields.push(`'version' => null`);
+  if (kind === "js" && mode === "module") fields.push(`'type' => 'module'`);
+  if (source) fields.push(`'source' => '${phpSingleQuoteEscape3(source)}'`);
+  fields.push(`'dev' => true`);
+  return `<?php return array( ${fields.join(", ")} );
+`;
+}
+async function writeAllSidecars(options) {
+  const index = /* @__PURE__ */ new Map();
+  const written = /* @__PURE__ */ new Set();
+  for (const entry of options.entries) {
+    const scan = entry.kind === "css" ? { moduleIds: [], dynamicModuleIds: [], handles: [], files: [toPosix(entry.file)] } : await scanEntryDependencies(entry.file, {
+      mode: entry.mode,
+      resolveExternalOptions: options.resolveExternalOptions,
+      maxDepth: options.maxScanDepth
+    });
+    const php = renderDevAssetPhp({
+      scan,
+      mode: entry.mode,
+      kind: entry.kind,
+      source: projectRelativeSource(entry.file, options.root),
+      wpBuildShape: options.wpBuildAssetMatchers.some(
+        (matcher) => toPosix(entry.file).includes(matcher)
+      )
+    });
+    const sidecarPath = join(options.outDirAbs, `${entry.name}.asset.php`);
+    writeFileTree(sidecarPath, php);
+    written.add(sidecarPath);
+    for (const file of scan.files) {
+      let names = index.get(file);
+      if (!names) index.set(file, names = /* @__PURE__ */ new Set());
+      names.add(entry.name);
+    }
+  }
+  return { index, written };
+}
+function pruneStale(previous, current) {
+  for (const filePath of previous) {
+    if (current.has(filePath)) continue;
+    try {
+      rmSync(filePath, { force: true });
+    } catch {
+    }
+  }
+}
+function projectRelativeSource(file, root) {
+  const relativePath = relative(root, file).replace(/\\/g, "/");
+  if (relativePath === "" || relativePath === ".." || relativePath.startsWith("../")) return null;
+  if (isAbsolute(relativePath)) return null;
+  return relativePath;
+}
+function phpSingleQuoteEscape3(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function writeBlocksTree(options) {
+  const { blocksDirAbs, outDirAbs, emitManifest, skip } = options;
+  const written = /* @__PURE__ */ new Set();
+  if (!blocksDirAbs || !existsSync(blocksDirAbs)) return written;
+  const files = fg.sync(
+    [`${toPosix(blocksDirAbs)}/**/block.json`, `${toPosix(blocksDirAbs)}/**/*.php`],
+    { absolute: true }
+  );
+  for (const file of files) {
+    const relativePath = relative(blocksDirAbs, file).replace(/\\/g, "/");
+    const blockDirName = relativePath.replace(/\/?[^/]+$/, "");
+    if (blockDirName && skip.has(blockDirName)) continue;
+    const source = relativePath.endsWith("block.json") ? transformBlockJson(readFileSync(file, "utf8"), file) : readFileSync(file);
+    const target = join(outDirAbs, "blocks", relativePath);
+    writeFileTree(target, source);
+    written.add(target);
+  }
+  if (!emitManifest) return written;
+  const manifest = buildBlocksManifest(blocksDirAbs, skip);
+  if (manifest) {
+    const target = join(outDirAbs, "blocks-manifest.php");
+    writeFileTree(target, manifest);
+    written.add(target);
+  }
+  return written;
+}
+function watchSources(options) {
+  const { server, blocksDirAbs } = options;
+  const sourceDirs = options.sourceDirs.filter((dir) => !!dir).map((dir) => `${toPosix(dir)}/`);
+  const isUnderSourceDir = (posixFile) => sourceDirs.some((dir) => posixFile.startsWith(dir));
+  const isBlocksMetadata = (posixFile) => {
+    if (!blocksDirAbs) return false;
+    if (!posixFile.startsWith(`${toPosix(blocksDirAbs)}/`)) return false;
+    return posixFile.endsWith("/block.json") || posixFile.endsWith(".php");
+  };
+  const run = (work, file) => {
+    void Promise.resolve(work).catch((error) => {
+      server.config.logger.error(
+        `[wp-dev-server] failed to refresh after ${file}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    });
+  };
+  let pending = null;
+  const scheduleRediscover = (file) => {
+    if (pending) clearTimeout(pending);
+    pending = setTimeout(() => {
+      pending = null;
+      run(options.onRediscover(), file);
+    }, REDISCOVER_DEBOUNCE_MS);
+    pending.unref?.();
+  };
+  const handle = (event, file) => {
+    const posixFile = toPosix(file);
+    if (isBlocksMetadata(posixFile) || event !== "change" && isUnderSourceDir(posixFile)) {
+      scheduleRediscover(file);
+      return;
+    }
+    run(options.onFileChange(file), file);
+  };
+  for (const event of ["add", "change", "unlink"]) {
+    server.watcher.on(event, (file) => handle(event, file));
+  }
+}
+function writeFileTree(filePath, contents) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, contents);
+}
+function toPosix(filePath) {
+  return filePath.replace(/\\/g, "/");
+}
 
 // src/wp.ts
 function wpModuleEntrySignatures() {
@@ -2654,17 +4090,27 @@ function wpModuleEntrySignatures() {
     name: "wp-module-entry-signatures",
     config(userConfig) {
       if (userConfig.build?.rollupOptions?.preserveEntrySignatures !== void 0) return null;
-      return { build: { rollupOptions: { preserveEntrySignatures: "exports-only" } } };
+      return {
+        build: { rollupOptions: { preserveEntrySignatures: "exports-only" } }
+      };
     }
   };
 }
 function wp(options = {}) {
   const buildType = options.buildType ?? "script";
   const plugins = [];
+  const globalsSink = /* @__PURE__ */ new Map();
+  let activeBlocksDir;
+  let activeBlocksSkip;
+  let activeEmitManifest;
+  let activeBlockStylesDir;
   if (options.blocks !== false) {
     const blocksOptions = typeof options.blocks === "object" ? options.blocks : void 0;
     const blocksDir = blocksOptions?.blocksDir ?? options.blocksDir;
     if (blocksDir) {
+      activeBlocksDir = blocksDir;
+      activeBlocksSkip = blocksOptions?.skip;
+      activeEmitManifest = blocksOptions?.emitManifest;
       plugins.push(
         wpBlocks({
           blocksDir,
@@ -2678,6 +4124,7 @@ function wp(options = {}) {
     const blockStylesOptions = typeof options.blockStyles === "object" ? options.blockStyles : void 0;
     const blocksStylesDir = blockStylesOptions?.blocksStylesDir ?? options.blocksStylesDir;
     if (blocksStylesDir) {
+      activeBlockStylesDir = blocksStylesDir;
       plugins.push(
         wpBlockStyles({
           blocksStylesDir,
@@ -2714,26 +4161,66 @@ function wp(options = {}) {
       );
     }
   }
+  const externalsOptions = typeof options.externals === "object" ? options.externals : void 0;
+  const wpBuildAssetMatchers = [...externalsOptions?.wpBuildAssetMatchers ?? []];
+  if (activeAdminPagesDir) {
+    const matcher = resolve(process.cwd(), activeAdminPagesDir).replace(/\\/g, "/");
+    if (!wpBuildAssetMatchers.includes(matcher)) wpBuildAssetMatchers.push(matcher);
+  }
+  const moduleEntryMatchers = [...externalsOptions?.moduleEntryMatchers ?? []];
   if (options.externals !== false) {
-    const externalsOptions = typeof options.externals === "object" ? options.externals : void 0;
-    const wpBuildAssetMatchers = [...externalsOptions?.wpBuildAssetMatchers ?? []];
-    if (activeAdminPagesDir) {
-      const matcher = resolve(process.cwd(), activeAdminPagesDir).replace(/\\/g, "/");
-      if (!wpBuildAssetMatchers.includes(matcher)) wpBuildAssetMatchers.push(matcher);
-    }
     plugins.push(
       ...wpExternals({
         buildType,
         ...externalsOptions,
+        moduleEntryMatchers,
+        // After the spread, deliberately: `globalsSink` is an internal
+        // out-param, not user config. A consumer passing their own Map
+        // through `externals: { globalsSink }` would otherwise sever the
+        // wiring — wpExternals would fill their map, wpScriptIife would
+        // read an empty one, and every shimmed `require()` would throw
+        // at runtime with nothing said at build time.
+        globalsSink,
         ...wpBuildAssetMatchers.length > 0 ? { wpBuildAssetMatchers } : {}
       })
     );
   }
+  if (options.devServer !== false) {
+    const devServerOptions = typeof options.devServer === "object" ? options.devServer : void 0;
+    plugins.push(
+      wpDevServer({
+        // The mode the *declared* entries (`build.rollupOptions.input`)
+        // are served in. Block and admin-page entries carry their own
+        // verdict from discovery, so this only decides the project's own.
+        buildType,
+        ...activeBlocksDir ? { blocksDir: activeBlocksDir } : {},
+        ...activeBlockStylesDir ? { blocksStylesDir: activeBlockStylesDir } : {},
+        ...activeAdminPagesDir ? { adminPagesDir: activeAdminPagesDir } : {},
+        ...activeBlocksSkip ? { skip: activeBlocksSkip } : {},
+        ...activeEmitManifest !== void 0 ? { emitManifest: activeEmitManifest } : {},
+        // The dev dependency scan has to reach the same externalization
+        // verdicts `wpExternals` does, so it gets the same inputs.
+        ...externalsOptions?.projectRoot ? { projectRoot: externalsOptions.projectRoot } : {},
+        ...externalsOptions?.externalNamespaces ? { externalNamespaces: externalsOptions.externalNamespaces } : {},
+        ...externalsOptions?.additionalExternals ? { additionalExternals: externalsOptions.additionalExternals } : {},
+        ...externalsOptions?.scriptModuleNamespaces ? { scriptModuleNamespaces: externalsOptions.scriptModuleNamespaces } : {},
+        ...externalsOptions?.bundle ? { bundledPackages: [...DEFAULT_BUNDLED_PACKAGES, ...externalsOptions.bundle] } : {},
+        moduleEntryMatchers,
+        ...wpBuildAssetMatchers.length > 0 ? { wpBuildAssetMatchers } : {},
+        ...devServerOptions
+      })
+    );
+    plugins.push(
+      wpDevServerPhp(
+        devServerOptions?.phpPrefix ? { phpPrefix: devServerOptions.phpPrefix } : {}
+      )
+    );
+  }
   if (buildType === "script" && options.scriptDedupe !== false) {
     plugins.push(wpScriptDedupe());
   }
   if (buildType === "script" && options.iife !== false) {
-    plugins.push(wpScriptIife());
+    plugins.push(wpScriptIife({ globals: globalsSink }));
   }
   if (options.cleanCssChunks !== false) {
     plugins.push(wpCleanCssChunks());
@@ -2747,6 +4234,6 @@ function wp(options = {}) {
   return plugins;
 }
 
-export { DEFAULT_BUNDLED_PACKAGES, wp, wpAdminPages, wpBlockStyles, wpBlocks, wpCleanCssChunks, wpCopyAssets, wpCssAssetInfo, wpExternals, wpScriptDedupe, wpScriptIife };
+export { DEFAULT_BUNDLED_PACKAGES, DEV_SERVER_PHP_NAME, HOT_FILE_NAME, wp, wpAdminPages, wpBlockStyles, wpBlocks, wpCleanCssChunks, wpCopyAssets, wpCssAssetInfo, wpDevServer, wpDevServerPhp, wpExternals, wpScriptDedupe, wpScriptIife };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map