@plaudit/webpack-extensions 3.16.0 → 3.18.0

package/CHANGELOG.md

@@ -5,6 +5,51 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.18.0] - 2026-08-18
+### Added
+- David's improvements to build pipeline efficiency (Credit: David)
+  - This comes from version `2.97.0`
+- Support for David's `@plaudit/dev-webpack-plugin` (Credit: David)
+  - This comes from version `2.97.0`
+
+### Changed
+- To Webpack's standard plugin interface (`WebpackPluginInstance`)
+  - This comes from version `2.97.0`
+
+### Removed
+- Browsersync and its tests (Credit: David)
+  - This comes from version `2.97.0`
+
+## [3.17.0] - 2026-08-18
+### Added
+- A port of WordPress's Dependency Extraction Webpack Plugin because they keep breaking it
+  - This comes from version `2.96.0`
+- Warnings and additional info for entrypoints that are lazy-loaded and assigned to actual locations
+  - This comes from version `2.96.0`
+- An `externalize` that is not a string, an array, an object, or false is now rejected rather than silently ignored
+  - This matches with what webpack's `output.library` config supports
+
+### Changed
+- `handle` callbacks are now passed the un-prefixed nice name rather than the fully-prefixed handle
+  - The `{basename}` token in the string form has always substituted the un-prefixed name, so the two spellings of the option disagreed. A callback like ``name => `acme.cb-${name}` `` was producing `acme.cb-my-theme/thing`
+- Nice names taken from a filename are now kebab-cased, the way the basename-derived handle they replace already was
+  - `view.MyThing.ts` is `<prefix>/my-thing` rather than `<prefix>/MyThing`
+  - This is for web-safety
+- `pathQueryParameters` to be an explicitly internal property instead of just asking people to not set it directly
+  - This fixes a few potential "bugs" that could happen if somebody set it anyway
+
+### Fixed
+- `targetNamespace` being derived eagerly for every config, which failed any build run from a directory with no adjacent `composer.json` *or* `style.css`
+  - Only the `lazyLoader` emitters read it, so it now falls back to an empty namespace (this matches the pre-`3.10.0` behavior)
+  - A missing `style.css` also no longer surfaces as a raw `ENOENT`
+
+### Removed
+- `processTranslationConfigs` because it should not be used and didn't actually do anything
+  - This comes from version `2.96.2`
+
+### Internals
+- Added more integration tests
+
 ## [3.16.0] - 2026-08-04
 ### Added
 - Logic so that files and directories with names equal to "example" or "examples" or that include "example" as a name segment are skipped
@@ -230,6 +275,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Legacy PostCSS features that have been integrated into modern CSS
 - `@extends` support
 
+## [2.97.0] - 2026-08-18
+### Added
+- David's improvements to build pipeline efficiency
+- Support for David's `@plaudit/dev-webpack-plugin`
+
+### Changed
+- To Webpack's standard plugin interface (`WebpackPluginInstance`)
+
+### Removed
+- Browsersync tests
+
+## [2.96.3] - 2026-08-11
+### Added
+- A few more validation checks
+
+## [2.96.2] - 2026-08-11
+### Removed
+- `processTranslationConfigs` because it should not be used and didn't actually do anything
+
+### Internals
+- Added more integration tests
+
+## [2.96.1] - 2026-08-10
+### Fixed
+- An error in how externalized dependencies were resolved that caused jquery to never be emitted as a dependency
+
+## [2.96.0] - 2026-08-07
+### Added
+- A port of WordPress's Dependency Extraction Webpack Plugin because they keep breaking it
+- Warnings and additional info for entrypoints that are lazy-loaded and assigned to actual locations
+
+### Removed
+- "combineAssetMetadata" - it has never actually been a valid prop
+
+### Fixed
+- Path-query handle handling
+- Double emission of CSS from entrypoint.json files when module processing is enabled
+- A bug that could result in writes outside the webpack context root
+
+### Changed
+- Backported the hook_name fix from the 3.x branch
+
 ## [2.95.0] - 2026-08-04
 ### Added
 - Logic so that files and directories with names equal to "example" or "examples" or that include "example" as a name segment are skipped
@@ -465,7 +552,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.72.1] - 2025-10-29
 ### Fixed
-- The wrapper being unable to find the `DependencyExtractionWebpackPlugin` due to version desyncs
+- The wrapper being unable to find the `EnhancedDependencyExtractionWebpackPlugin` due to version desyncs
   - This isn't so much a "fix" as it is a "mitigation" - version desyncs are not fixable at the library level
 
 ## [2.72.0] - 2025-10-13

package/README.md

@@ -1,5 +1,5 @@
 # Plaudit Webpack Extensions
-A webpack configuration and plugin suite designed specifically for WordPress development workflows. This package extends `@wordpress/scripts` with custom webpack plugins, PostCSS configurations, and build optimizations tailored for Plaudit's WordPress projects. It includes specialized handling for Gutenberg blocks, asset management, internationalization (WPML), and development tooling like BrowserSync integration.
+A webpack configuration and plugin suite designed specifically for WordPress development workflows. This package extends `@wordpress/scripts` with custom webpack plugins, PostCSS configurations, and build optimizations tailored for Plaudit's WordPress projects. It includes specialized handling for Gutenberg blocks, asset management, internationalization (WPML), and a same-origin CSS-inject / live-reload client for `wp-scripts start`.
 
 # Requirements
 - All block- and extension-related capabilities require that the `plaudit/plaudit-common` composer library be installed.
@@ -23,7 +23,27 @@ This suite generates loader code that uses the most efficient mechanisms availab
 The same file structure (both in the webpack.config.js file and the actual directory tree) can be used in plugins and themes.
 
 # Usage
-Check out the [User Guide](USER-GUIDE.md) file.
+Config, entry types, and handles: [User Guide](USER-GUIDE.md).
+
+## `dist` vs `dist-dev`
+
+With the unified loader (site `standard`), `outputDir` is `dist`. When `SERVER_MODE` is `development` (the default if unset on the host) and `omitDistDev` is off, webpack writes **`dist-dev`**. WordPress in development loads that folder via `dist/unified-loader.php` when `dist-dev/unified-loader.php` exists. Production WordPress always uses **`dist`**.
+
+`SERVER_MODE` chooses the folder. The compiler (`mode`, minify, webpack cache) is always production for `dist`. For `dist-dev` it follows `NODE_ENV`: `wp-scripts start` is development (no minify, cache on); `wp-scripts build` is production (minify, cache off) still written to `dist-dev`.
+
+`dev-reload.js` / overlay run only for `pnpm run dev` (`BROWSER_SYNC` + watch) and only under `dist-dev`. Pass `--no-dev-reload` after `--` (or `DEV_RELOAD=0`) to skip the overlay and live reload: `pnpm run dev -- --no-dev-reload`. Docker still starts and the browser still opens. The `--` is required so webpack-cli does not treat the flag as an unknown option.
+
+| Command                                 | Folder     | Compiler                                                         | Overlay |
+|-----------------------------------------|------------|------------------------------------------------------------------|---------|
+| `pnpm run dev`                          | `dist-dev` | development (no minify, cache on)                                | yes     |
+| `pnpm run dev -- --no-dev-reload`       | `dist-dev` | development (no minify, cache on)                                | no      |
+| `pnpm run watch`                        | `dist-dev` | development (no minify, cache on)                                | no      |
+| `pnpm run build`                        | `dist-dev` | production (minify, cache off)                                   | no      |
+| `SERVER_MODE=production pnpm run build` | `dist`     | same production compiler as `pnpm run build` (minify, cache off) | no      |
+
+The last row is the same compile as a local `build`; only the folder changes. That is what ships: `@plaudit/toolbox` (`toolbox init`) installs a **pre-commit** hook that runs `pnpm … build` with `SERVER_MODE=production` and stages `wp-content/**/dist/**`. A plain `pnpm run build` on your machine does **not** update `dist` unless you set `SERVER_MODE` yourself. `SKIP_BUILD=1` skips the hook build.
+
+See [Plaudit - Dev Webpack Plugin](https://github.com/plaudit/dev-webpack-plugin#readme) for more details
 
 # Development
 

package/USER-GUIDE.md

@@ -109,7 +109,7 @@ However, if you need to do something unusual or just want to know what everythin
 - All file names are informational placeholders. They can be whatever you want provided that they are web-safe (basically, don't do things like calling the email address block "✉️" and you'll be fine)
 
 ### Examples
-- Any uses of `acme-my-plugin` should be replaced with your plugin or theme's kebab-case name (ex: `acme-my-plugin.wp-admin` => `plaudit-base.wp-admin`)
+- Any uses of `acme-my-plugin` should be replaced with your plugin or theme's kebab-case name (ex: `acme-my-plugin/wp-admin` => `plaudit-base/wp-admin`)
 
 ---
 
@@ -190,11 +190,13 @@ This file automatically:
 - Sets up blocks and extensions
 
 ### 4. Run Build Commands
-While you *can* manually run these commands, using `theapp pack dev/watch/build` is preferred
+While you *can* manually run these commands, using `theapp pack dev/watch/build` is preferred.
+
+Typical theme/plugin scripts are `watch`, `dev`, and `build`. Which folder they write (`dist` vs `dist-dev`) and whether the compiler minifies is in the package [README](README.md#dist-vs-dist-dev) — a local `pnpm run build` is a production compile into `dist-dev`, not into `dist`.
 
 ```bash
-pnpm run watch   # Development mode (watches for changes)
-pnpm run build   # Production build
+pnpm run watch   # Watch; writes dist-dev
+pnpm run build   # One-shot production compile into dist-dev
 ```
 
 ---
@@ -205,8 +207,11 @@ After building, each asset gets a handle you can reference in PHP.
 
 ### Handle Format
 
-**Plain:** `{prefix}.{filename}`
-- Example: `acme-my-plugin.admin-editor`
+**Plain:** `{prefix}/{filename}`
+- Example: `acme-my-plugin/admin-editor`
+- If the filename carries a nice-name segment, that segment *replaces* the location-derived name rather than being appended to it, and it is kebab-cased on the way in
+  - `view.MyThing.ts` is `acme-my-plugin/my-thing`, not `acme-my-plugin/view-my-thing`
+  - Because the location is dropped, two files that differ only by location cannot share a nice name
 
 **Blocks:** `{prefix}_blocks_{block-name}-{type}`
 - Example: `acme-my-plugin_blocks_hero-banner-editor-script`
@@ -231,14 +236,14 @@ After building, each asset gets a handle you can reference in PHP.
 add_action('admin_enqueue_scripts', function($hook) {
 	if ($hook === 'post.php') {
 		// Localize data first (optional)
-		wp_localize_script('acme-my-plugin.admin-editor', 'myData', [
+		wp_localize_script('acme-my-plugin/admin-editor', 'myData', [
 			'ajaxUrl' => admin_url('admin-ajax.php'),
 			'nonce' => wp_create_nonce('my_ajax_action'),
 		]);
 		
 		// Then enqueue
-		wp_enqueue_script('acme-my-plugin.admin-editor');
-		wp_enqueue_style('acme-my-plugin.admin-editor');
+		wp_enqueue_script('acme-my-plugin/admin-editor');
+		wp_enqueue_style('acme-my-plugin/admin-editor');
 	}
 });
 ```
@@ -277,7 +282,7 @@ src: {
 // In your plugin
 add_action('admin_enqueue_scripts', function($hook) {
 	if ($hook === 'post.php') {
-		wp_enqueue_script('acme-my-plugin.post-editor');
+		wp_enqueue_script('acme-my-plugin/post-editor');
 	}
 });
 ```
@@ -315,7 +320,7 @@ src: {
 | `srcDir`                           | `string`  | `""`    | Source directory (**Required** on new sites)                                                                                                                                                 |
 | `outputDir`                        | `string`  | `""`    | Output directory (**Required** on new sites)                                                                                                                                                 |
 | `useUnifiedLoader`                 | `boolean` | `false` | Generate unified-loader.php (always set to `true` on new sites!)                                                                                                                             |
-| `useWebpackResourceFiltering`      | `boolean` | `false` | Generates versioned copies of images, fonts, etc (always set to `true` on new sites!)                                                                                                        |
+| `useWebpackResourceFiltering`      | `boolean` | `true`  | Generates versioned copies of images, fonts, etc (always set to `true` on new sites!)                                                                                                        |
 | `plainEntrypointsVersion`          | `1\|2`    | `1`     | Use 2 for new sites                                                                                                                                                                          |
 | `extensionsVersion`                | `1\|2\|3` | `1`     | Use 3 for new sites                                                                                                                                                                          |
 | `verbose`                          | `boolean` | `false` | Verbose logging                                                                                                                                                                              |
@@ -571,11 +576,11 @@ This is the form that *should* be used. It has two categories of keys: control f
 
 **Control Flags:**
 
-| Key                  | Type                                                                     | Default | Description                                                                                                                                      |
-|----------------------|--------------------------------------------------------------------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------|
-| `handle`             | `string \| fn(string) => string`                                         | Auto    | The handle by which the entrypoint will be referenced. The function form is passed the default handle for manual tweaking                        |
-| `register`           | `boolean \| number`                                                      | `true`  | **[Advanced]** Whether the entrypoint should be registered at all or, if a number, the priority of the hook in which the registration will occur |
-| `registerScriptArgs` | `boolean` \| `'lazy'` \| [`WordPressScriptArgs`](#wordpress-script-args) | Auto    | The loading flags (strategy, in_footer, and fetchpriority) for the script.<br>'lazy' is an alias for `{strategy: 'defer', in_footer: true}`      |
+| Key                  | Type                                                                     | Default | Description                                                                                                                                                             |
+|----------------------|--------------------------------------------------------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `handle`             | `string \| fn(string) => string`                                         | Auto    | The handle by which the entrypoint will be referenced. The function form is passed the default handle for manual tweaking, and may return nothing to accept the default |
+| `register`           | `boolean \| number`                                                      | `true`  | **[Advanced]** Whether the entrypoint should be registered at all or, if a number, the priority of the hook in which the registration will occur                        |
+| `registerScriptArgs` | `boolean` \| `'lazy'` \| [`WordPressScriptArgs`](#wordpress-script-args) | Auto    | The loading flags (strategy, in_footer, and fetchpriority) for the script.<br>'lazy' is an alias for `{strategy: 'defer', in_footer: true}`                             |
 
 **Location Identifiers:**
 

package/dist/plugins/AbstractBiPhasicGroupAndEntryPlugin.d.ts

@@ -2,7 +2,7 @@ import { MinimumViableMetadata, ParsedAssetJsonProvider, ParsedAssetsJson } from
 import type { ExtensibleEntryObject, VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
 import { PseudoSemaphore } from "../utils/pseduo-semaphore";
 import { AbstractBiPhasicGroupPlugin } from "./AbstractBiPhasicGroupPlugin";
-import { Compilation, Compiler, Entrypoint } from "webpack";
+import { type Compilation, type Compiler, type Entrypoint } from "webpack";
 export type EntryProvider<M extends MinimumViableMetadata = MinimumViableMetadata> = () => ExtensibleEntryObject<M> | Promise<ExtensibleEntryObject<M>>;
 export declare abstract class AbstractBiPhasicGroupAndEntryPlugin<M extends MinimumViableMetadata = MinimumViableMetadata> extends AbstractBiPhasicGroupPlugin {
     private readonly context;

package/dist/plugins/AbstractBiPhasicGroupPlugin.d.ts

@@ -1,7 +1,7 @@
-import { Compilation, Compiler } from "webpack";
+import { Compilation, Compiler, type WebpackPluginInstance } from "webpack";
 import { PseudoSemaphore } from "../utils/pseduo-semaphore";
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
-import { type ParsedAssetJsonProvider, WebpackPlugin } from "../shared";
+import { type ParsedAssetJsonProvider } from "../shared";
 type TapWithAssetsJsonOptions = {
     name?: string;
     stage?: (typeof Compilation.PROCESS_ASSETS_STAGE_REPORT) | (typeof Compilation.PROCESS_ASSETS_STAGE_ANALYSE);
@@ -9,7 +9,7 @@ type TapWithAssetsJsonOptions = {
 };
 type TapWithAssetsJsonFn = Parameters<Compilation['hooks']['processAssets']['tapPromise']>[1];
 type TapWithParsedAssetsJsonFn = (parsedAssetJsonProvider: ParsedAssetJsonProvider, assets: Parameters<TapWithAssetsJsonFn>[0]) => Promise<void> | void;
-export declare abstract class AbstractBiPhasicGroupPlugin implements WebpackPlugin {
+export declare abstract class AbstractBiPhasicGroupPlugin implements WebpackPluginInstance {
     protected readonly config: VerifiedPlauditWordpressWebpackConfig;
     readonly group: string;
     private readonly semaphores;

package/dist/plugins/EnhancedBlockJSONPlugin.d.ts

@@ -24,6 +24,7 @@ export declare class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEnt
     constructor(config: VerifiedPlauditWordpressWebpackConfig, dest: VerifiedAdvancedOutputConfig, webpackRemoveEmptyScriptsPlugin: WebpackRemoveEmptyScriptsPlugin, context: string, entry: EntryProvider<BlockEntrypointInfo>);
     protected processAssets(compilation: Compilation, parsedAssetJsonProvider: ParsedAssetJsonProvider): Promise<void>;
     private emitBlockLoaderFile;
+    private static readonly THEME_JSON_FLAG_PROPS;
     private static pickOutFlagPropsFromBlockSupports;
     private callRegisterFunction;
     private transformBlocks;

package/dist/plugins/EnhancedBlockJSONPlugin.js

@@ -226,37 +226,48 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
             compilation.emitAsset((0, node_path_1.join)(this.dest.destination, "blockdir.config.php"), new webpack_1.sources.RawSource((0, shared_1.makeEmittableConfigPHP)(blockDirConfig, true)));
         }
     }
-    // This isn't strictly necessary, but it allows us to trivially eliminate commonly-used block supports flags that aren't used in theme.json
-    // private static readonly IGNORED_THEME_JSON_FLAG_PROPS = ['align', 'alignWide', 'anchor', 'contentRole', 'inserter', 'interactivity', 'listView', 'plaudit'];
+    /*
+     * The block supports that have a boolean counterpart under theme.json's settings, as
+     * `settings key -> {support prop: settings prop}`. This is an allow-list rather than an ignore-list
+     * because most supports (align, alignWide, anchor, contentRole, inserter, interactivity, listView,
+     * plaudit, ...) have no theme.json settings equivalent at all, and the ones that do don't always
+     * share a name: typography's fontSize is settings.typography.customFontSize, and Gutenberg still
+     * ships several of these under an __experimental prefix.
+     */
+    static THEME_JSON_FLAG_PROPS = {
+        color: { background: 'background', link: 'link', text: 'text' },
+        dimensions: { aspectRatio: 'aspectRatio', minHeight: 'minHeight' },
+        spacing: { blockGap: 'blockGap', margin: 'margin', padding: 'padding' },
+        typography: {
+            fontSize: 'customFontSize',
+            lineHeight: 'lineHeight',
+            textAlign: 'textAlign',
+            fontStyle: 'fontStyle', __experimentalFontStyle: 'fontStyle',
+            fontWeight: 'fontWeight', __experimentalFontWeight: 'fontWeight',
+            letterSpacing: 'letterSpacing', __experimentalLetterSpacing: 'letterSpacing',
+            textDecoration: 'textDecoration', __experimentalTextDecoration: 'textDecoration',
+            textTransform: 'textTransform', __experimentalTextTransform: 'textTransform',
+            writingMode: 'writingMode', __experimentalWritingMode: 'writingMode'
+        }
+    };
     static pickOutFlagPropsFromBlockSupports(supports) {
         function isRecord(value) {
             return typeof value === 'object' && !!value && !Array.isArray(value);
         }
         let addedProp = false;
         const res = {};
-        if ('color' in supports) {
-            const color = supports.color;
-            if (isRecord(color)) {
-                const colorFlags = {};
-                for (const prop of ['background', 'link', 'text']) {
-                    if (supports[prop]) {
-                        colorFlags[prop] = true;
-                        res.color = colorFlags;
-                        addedProp = true;
-                    }
-                }
+        for (const [settingsKey, props] of Object.entries(EnhancedBlockJSONPlugin.THEME_JSON_FLAG_PROPS)) {
+            const support = supports[settingsKey];
+            if (!isRecord(support)) {
+                continue;
             }
-        }
-        if ('dimensions' in supports) {
-            const dimensions = supports.dimensions;
-            if (isRecord(dimensions)) {
-                const dimensionsFlags = {};
-                for (const prop of ['aspectRatio']) {
-                    if (supports[prop]) {
-                        dimensionsFlags[prop] = true;
-                        res.color = dimensionsFlags;
-                        addedProp = true;
-                    }
+            const flags = {};
+            for (const [supportProp, settingsProp] of Object.entries(props)) {
+                // A sided support such as `"margin": ["top", "bottom"]` is still just "on" as far as theme.json is concerned
+                if (support[supportProp]) {
+                    flags[settingsProp] = true;
+                    res[settingsKey] = flags;
+                    addedProp = true;
                 }
             }
         }
@@ -536,7 +547,7 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
             }
             delete blockJson[invalidTemplateLocation];
             if (renderTemplate.length > 1) {
-                compilation.warnings.push((0, shared_1.newWebpackErrorForFile)("Encountered a block with multiple possible render files. Please set the render key in block.json to the proper one", (0, node_path_1.join)(sourceDir, 'block.json')));
+                compilation.warnings.push((0, shared_1.newWebpackErrorForFile)("Encountered a block with multiple possible render files. Please set the render key in block.json to the intended one", (0, node_path_1.join)(sourceDir, 'block.json')));
                 blockJson[validTemplateLocation] = renderTemplate.find(p => p.endsWith(".php")) ?? renderTemplate[0];
             }
             else {

package/dist/plugins/MiniCSSExtractPluginErrorCleaner.d.ts

@@ -1,5 +1,4 @@
-import type { Compiler } from "webpack";
-import type { WebpackPlugin } from "../shared";
-export declare class MiniCSSExtractPluginErrorCleaner implements WebpackPlugin {
+import type { Compiler, WebpackPluginInstance } from "webpack";
+export declare class MiniCSSExtractPluginErrorCleaner implements WebpackPluginInstance {
     apply(compiler: Compiler): void;
 }

package/dist/plugins/PackageConfigSanityChecker.d.ts

@@ -1,5 +1,4 @@
-import type { Compiler } from "webpack";
-import type { WebpackPlugin } from "../shared";
-export declare class PackageConfigSanityChecker implements WebpackPlugin {
+import type { Compiler, WebpackPluginInstance } from "webpack";
+export declare class PackageConfigSanityChecker implements WebpackPluginInstance {
     apply(compiler: Compiler): void;
 }

package/dist/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -41,20 +41,20 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 for (let count = 0; finalHandleName in handleNameMap && handleNameMap[finalHandleName] !== src;) {
                     finalHandleName = `${baseFinalHandleName}-${++count}`;
                 }
-                if (typeof handleName === 'string' || typeof handleName === 'function' || (handleName && 'niceName' in handleName)) {
+                if (handleName !== undefined) {
                     finalHandleName = (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(handleName, handlePrefix, finalHandleName.substring(handlePrefix.length + 1));
                 }
                 handleNameMap[finalHandleName] = src;
                 plainEntrypointsConfig[`${type}Handles`][finalHandleName] = { src, rest, locations, type, lazyLoader, ...otherProps };
             }
         }
-        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists('script', Object.entries(plainEntrypointsConfig.scriptHandles)
+        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists(compilation, 'script', Object.entries(plainEntrypointsConfig.scriptHandles)
             .toSorted(([a], [b]) => a.localeCompare(b)), handleLists);
-        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists('script_module', Object.entries(plainEntrypointsConfig.script_moduleHandles)
+        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists(compilation, 'script_module', Object.entries(plainEntrypointsConfig.script_moduleHandles)
             .toSorted(([a], [b]) => a.localeCompare(b)), handleLists);
         const sortedStyleHandles = Object.entries(plainEntrypointsConfig.styleHandles)
             .toSorted(([a], [b]) => a.localeCompare(b));
-        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists('style', sortedStyleHandles, handleLists);
+        PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists(compilation, 'style', sortedStyleHandles, handleLists);
         const callItemSorter = (a, b) => a.handle.localeCompare(b.handle);
         for (const list of Object.values(handleLists)) {
             list.sort(callItemSorter);
@@ -113,8 +113,10 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 writer.return(editorSettings);
             }, { functionArgParameters: [editorSettings], accountForAlreadyDoing: false });
         }
-        const lazyLoadedHandles = Object.values(handleLists)
-            .flatMap(handleList => handleList.map(handle => [handle.data.lazyLoader, handle]))
+        // Only the register and inline lists, which are mutually exclusive, so each handle is collected
+        // exactly once. Flattening every list instead would collect a handle once per location it declares.
+        const lazyLoadedHandles = [...handleLists.register, ...handleLists.inline]
+            .map(handle => [handle.data.lazyLoader, handle])
             .filter((entry) => entry[0] !== undefined)
             .sort((a, b) => a[0].localeCompare(b[0]) || a[1].priority - b[1].priority);
         if (lazyLoadedHandles.length > 0) {
@@ -134,7 +136,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
         }
         (0, shared_1.emitPHPWriterAsAsset)(file, compilation, "plain-entrypoints-loader.php");
     }
-    static addHandlesToHandleLists(type, handles, handleLists) {
+    static addHandlesToHandleLists(compilation, type, handles, handleLists) {
         const defaultPriority = 10;
         for (const [handle, data] of handles) {
             if (data.locations.register !== false) {
@@ -143,6 +145,19 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
             else if (data.inlinedAsset !== undefined) {
                 handleLists.inline.push({ handle, type, data, priority: typeof data.locations.inline === 'number' ? data.locations.inline : 10 });
             }
+            if (data.lazyLoader !== undefined) {
+                // A lazily loaded handle is enqueued by its generated function and never by an action, so it
+                // is deliberately kept out of the location lists. Those lists are also what the lazy function
+                // is built from, and a handle present in several of them would be enqueued once per list.
+                const declaredLocations = (0, shared_1.constantKeys)(shared_1.standardLocationNamesMeta)
+                    .filter(location => data.locations[location] || typeof data.locations[location] === 'number');
+                if (declaredLocations.length > 0) {
+                    const locText = declaredLocations.length === 1 ? "location" : "locations";
+                    compilation.warnings.push((0, shared_1.newWebpackErrorForFile)(`The handle "${handle}" declares both a lazyLoader (${data.lazyLoader}) and the ${declaredLocations.join(", ")} ${locText}.`
+                        + ` It will only be enqueued by ${data.lazyLoader}(); remove either the ${locText} or the lazyLoader.`, data.src));
+                }
+                continue;
+            }
             for (const location of (0, shared_1.constantKeys)(shared_1.standardLocationNamesMeta)) {
                 let priority, hook_name;
                 const dataLocation = data.locations[location];
@@ -186,7 +201,6 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
         }
     }
     static appendEnqueuingHandleLists(writer, handleLists) {
-        const lazyLoadableHandles = {};
         for (const [sln, { action, supports_hook_name, additional_action_code }] of (0, shared_1.constantEntries)(shared_1.standardLocationNamesMeta)) {
             const handleList = handleLists[sln];
             if (handleList.length > 0) {
@@ -226,7 +240,6 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 }
             }
         }
-        return lazyLoadableHandles;
     }
     static separateHandleListByPriority(handleItems) {
         const lists = new Map();

package/dist/plugins/VariablesJSMonitorPlugin.d.ts

@@ -1,7 +1,6 @@
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
-import type { Compiler } from "webpack";
-import type { WebpackPlugin } from "../shared";
-export declare class VariablesJSMonitorPlugin implements WebpackPlugin {
+import type { Compiler, WebpackPluginInstance } from "webpack";
+export declare class VariablesJSMonitorPlugin implements WebpackPluginInstance {
     private readonly config;
     constructor(config: VerifiedPlauditWordpressWebpackConfig);
     apply(compiler: Compiler): void;

package/dist/plugins/WPMLConfigBuilder.d.ts

@@ -1,7 +1,6 @@
-import { type WebpackPlugin } from "../shared";
 import { AbstractBiPhasicGroupAndEntryPlugin } from "./AbstractBiPhasicGroupAndEntryPlugin";
-import { type Compiler } from "webpack";
-export declare class WPMLConfigBuilderPlugin implements WebpackPlugin {
+import { type Compiler, type WebpackPluginInstance } from "webpack";
+export declare class WPMLConfigBuilderPlugin implements WebpackPluginInstance {
     private readonly destDir;
     private readonly referencePlugin;
     private static jsdomInstance?;

package/dist/plugins/dependency-extraction-webpack-plugin-config-builder.d.ts

@@ -1,7 +1,4 @@
-import DependencyExtractionWebpackPlugin from "@wordpress/dependency-extraction-webpack-plugin";
-import { Externals } from "../shared";
+import type { Externals } from "../shared";
+import { EnhancedDependencyExtractionWebpackPlugin } from "../wordpress-ports/dependency-extraction-webpack-plugin";
 import type { Configuration } from "webpack";
-export declare function makeDependencyExtractionPlugin(externals: Externals | undefined, assumeGlobalizedPlauditLibraries: boolean, wantsGroupedDepData: boolean, externalizing: Required<Configuration>['output']['library']): {
-    instance: DependencyExtractionWebpackPlugin;
-    addExternalizedDep: (dep: string) => void;
-};
+export declare function makeDependencyExtractionPlugin(externals: Externals | undefined, assumeGlobalizedPlauditLibraries: boolean, externalizing: Required<Configuration>['output']['library']): EnhancedDependencyExtractionWebpackPlugin;

package/dist/plugins/dependency-extraction-webpack-plugin-config-builder.js

@@ -1,19 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeDependencyExtractionPlugin = makeDependencyExtractionPlugin;
-const dependency_extraction_webpack_plugin_1 = __importDefault(require("@wordpress/dependency-extraction-webpack-plugin"));
-function makeDependencyExtractionPlugin(externals, assumeGlobalizedPlauditLibraries, wantsGroupedDepData, externalizing) {
-    const baseProps = makeDependencyExtractionPluginProps(externals, assumeGlobalizedPlauditLibraries, externalizing);
-    const instance = new dependency_extraction_webpack_plugin_1.default(wantsGroupedDepData ? { ...baseProps, outputFormat: "json", combineAssets: true } : baseProps);
-    return {
-        instance,
-        addExternalizedDep: (dep) => {
-            instance.externalizedDeps.add(dep);
-        }
-    };
+const dependency_extraction_webpack_plugin_1 = require("../wordpress-ports/dependency-extraction-webpack-plugin");
+const util_1 = require("../wordpress-ports/dependency-extraction-webpack-plugin/util");
+function makeDependencyExtractionPlugin(externals, assumeGlobalizedPlauditLibraries, externalizing) {
+    return new dependency_extraction_webpack_plugin_1.EnhancedDependencyExtractionWebpackPlugin(makeDependencyExtractionPluginProps(externals, assumeGlobalizedPlauditLibraries, externalizing));
 }
 function makeDependencyExtractionPluginProps(externals, assumeGlobalizedPlauditLibraries, externalizing) {
     if (!externals) {
@@ -93,7 +84,7 @@ const EXTERNALIZABLE_PLAUDIT_LIBRARIES = {
     ...Object.fromEntries(['@plaudit/frontend-apis', '@plaudit/library-extensions', '@plaudit/block-supports', '@plaudit/gutenberg-api-extensions']
         .map(req => {
         return [req, {
-                import: ['plaudit', camelCaseDash(req.substring(PLAUDIT_NAMESPACE.length))],
+                import: ['plaudit', (0, util_1.camelCaseDash)(req.substring(PLAUDIT_NAMESPACE.length))],
                 handle: `plaudit-${req.substring(PLAUDIT_NAMESPACE.length)}`
             }];
     })),
@@ -116,12 +107,6 @@ function normalizeRequest(request) {
 function curryRequestHandlers(primary, secondary) {
     return (...args) => primary(...args) ?? secondary(...args);
 }
-/**
- * Copied from @wordpress/dependency-extraction-webpack-plugin for consistency
- */
-function camelCaseDash(string) {
-    return string.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
-}
 function handleExternalizingEqualsPossibleExternal(possibleExternal, ext) {
     if (!ext || !possibleExternal) {
         return possibleExternal;
@@ -151,7 +136,9 @@ function handleExternalizingEqualsPossibleExternal(possibleExternal, ext) {
     }
     else {
         for (const key of ['amd', 'commonjs', 'root']) {
-            if (key in ext && handleExternalizingEqualsPossibleExternal(possibleExternal, ext[key])) {
+            // The recursion returns the external when it should be kept and undefined when it matched, so
+            // only an undefined result means this umd name is the thing being built and must not externalize.
+            if (key in ext && handleExternalizingEqualsPossibleExternal(possibleExternal, ext[key]) === undefined) {
                 return undefined;
             }
         }