@plaudit/webpack-extensions 2.82.3 → 2.83.1

package/CHANGELOG.md

@@ -0,0 +1,486 @@
+# Changelog
+
+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).
+
+## [2.83.1] - 2026-01-27
+### Fixed
+- An issue wherein the theme-level styles would pollute the editor's UI styles
+  - This was done by reverting the changes from `2.73.1`
+
+### Internals
+- Removed `build` from git
+
+## [2.83.0] - 2026-01-20
+### Added
+- Support for `hook_name` condition to the `admin` location for plain entrypoints
+
+## [2.82.3] - 2026-01-07
+### Fixed
+- ESM module *files* in script attributes not being processed
+
+## [2.82.2] - 2026-01-06
+### Fixed
+- Additional issues in how WordPress handles ESM modules
+- CSS generated from module files getting put in `styleModule` instead of `style`
+
+### Removed
+- Support for the `scriptModule` field because it turns out that that isn't a thing
+
+## [2.82.1] - 2026-01-06
+### Fixed
+- The modules mode being dropped even when building with module support
+
+## [2.82.0] - 2025-12-29
+### Added
+- The `onlyRunPostCSSOnPCSS` flag to allow for PostCSS processing to be disabled for `.css` files
+- The [`CSSMinimizerPlugin`](https://github.com/webpack/css-minimizer-webpack-plugin)
+
+## [2.81.0] - 2025-12-24
+### Removed
+- The old absolute-path enforcement logic now that our local dev Docker images no longer need it
+
+## [2.80.1] - 2025-12-19
+### Fixed
+- The `google.maps` "externalizable" library causing a crash due to not being fully real
+
+## [2.80.0] - 2025-12-18
+### Added
+- `google.maps` as an "externalizable" library
+  - Technically, there's nothing there to externalize per-se; however, it *does* need to be associated with a handle, which is part of the externalization process
+
+## [2.79.0] - 2025-12-17
+### Added
+- A flag to disable the `-dev` features: `omitDistDev`
+  - This is pretty much for Josh's use only
+
+## [2.78.1] - 2025-12-17
+### Added
+- Code to handle a missing `dist` directory when building for dev 
+
+## [2.78.0] - 2025-12-16
+### Added
+- Logic that separates out dev and prod builds
+  - Credit to David for the idea and pseudocode
+- `'lazy'` as an alias for `{strategy: 'defer', in_footer: true}`
+- An improved [User Guide](USER-GUIDE.md)
+  - Credit to David for the initial draft, structure, and ideal inclusions list
+
+## [2.77.0] - 2025-12-11
+### Added
+- `@plaudit/wp-consent-api` to the list of externalizable packages
+- `@plaudit/analytics-integrations-api` to the list of externalizable packages
+
+## [2.76.2] - 2025-12-05
+### Fixed
+- Excess `.asset.php` files being emitted
+
+## [2.76.1] - 2025-12-05
+### Fixed
+- The computed version-hashes not being emitted when in plain entrypoints v1 mode
+
+## [2.76.0] - 2025-12-05
+### Added
+- Proper version-hash computation for stylesheets
+  - This replaces other long-standing attempts at accounting for WordPress's broken computation method
+
+## [2.75.0] - 2025-12-01
+### Added
+- The ability to exclude blocks from the build by prefixing their folder with a tilde (`~`)
+
+## [2.74.0] - 2025-11-26
+### Added
+- Support for WordPress 6.9's upcoming `fetchpriority` flag on scripts and styles
+
+## [2.73.2] - 2025-11-13
+### Fixed
+- A compatibility issue with WPML that broke blocks on non-default-language pages
+  - Credit to Melanie for the report
+- The extensions v1 generator saving the path to generated CSS files with the ".js" extension
+  - Credit to Melanie for the report
+
+## [2.73.1] - 2025-11-11
+### Fixed
+- The styles enqueued via `clientEditor` being "enqueued" using WordPress' legacy `add_editor_style` mechanism
+
+## [2.73.0] - 2025-10-30
+### Added
+- The function used to find legacy blocks in a folder to the `@plaudit/webpack-extensions/shared` export
+  - This is for use by `@plaudit/scaffold`
+
+## [2.72.1] - 2025-10-29
+### Fixed
+- The wrapper being unable to find the `DependencyExtractionWebpackPlugin` 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
+### Changed
+- Extracted the PHP writing utilities into their own package.
+
+## [2.71.0] - 2025-10-10
+### Added
+- Support for the `lazyLoader` attribute to `PlainEntrypointsStyleBlockJSONPlugin`
+
+### Changed
+- The default value of `includePostInitFallback` to `false`
+  - This was originally a stopgap measure to prevent issues when plaudit-common's asset loader was triggered too late, but that has since been fixed at a
+    structural level, so, we can safely make it default to `false`
+
+## [2.70.1] - 2025-10-09
+### Added
+- `shared.ts` to the exports list
+
+## [2.70.0] - 2025-10-01
+### Added
+- `includePostInitFallback` to the config
+
+### Changed
+- Reverted everything from version `2.69.0` except for renaming `plainEntrypointsHandlePrefix` to `targetHandlePrefix`
+
+## [2.69.0] - 2025-09-30
+### Added
+- `plainEntrypointsSettings` to the config
+- `plainEntrypointsSettings.includePostInitFallback` to allow emitting a fallback for the loader being called too late to be opted out of 
+
+### Changed
+- Renamed `plainEntrypointsHandlePrefix` to `targetHandlePrefix` because it's not just being used for `Plain Entrypoints`
+  - The old name of the setting will still work
+- Moved `plainEntrypointsVersion` to `plainEntrypointsSettings.version`
+    - The old name of the setting will still work
+
+## [2.68.1] - 2025-09-24
+### Internals
+- Reworked how the enqueuing location data is stored to make editing it easier in the future
+
+## [2.68.0] - 2025-09-24
+### Added
+- Support for enqueuing plain entrypoints within the `enqueue_block_assets` action via the `blockAssets` location
+
+## [2.67.0] - 2025-09-23
+### Removed
+- `postcss-fallback`, `postcss-inline-svg`, and `postcss-quantity-queries`
+  - They weren't being used but were causing dependency graph issues
+
+## [2.66.6] - 2025-09-18
+### Fixed
+- Handles for extracted assets inheriting dependencies of the entrypoint from which they were extracted
+
+## [2.66.5] - 2025-09-17
+### Fixed
+- Handle deduplication not accounting for extracted files in `PlainEntrypointsStyleBlockJSONPlugin`
+
+### Changed
+- Replaced a `trailingslashit` call in the generated `Extensions V3` loader with `.'/'`
+
+## [2.66.4] - 2025-09-15
+### Fixed
+- `*-setup.php` files causing a fatal error in `Extensions V3`
+
+## [2.66.3] - 2025-09-11
+### Fixed
+- The `lazyLoad` attribute not being respected
+
+## [2.66.2] - 2025-09-11
+### Removed
+- An unnecessary variable allocation from the emitted `Extensions V3` code
+
+## [2.66.1] - 2025-09-11
+### Removed
+- An unnecessary suffixing of `__DIR__` in the `Extensions V3` emitter
+
+## [2.66.0] - 2025-09-11
+### Added
+- Support for `Extensions V3`
+  - This resolves some handle consistency issues that V2 had
+  - `Extensions V3` is an automatic upgrade as a result
+
+### Fixed
+- Handle consistency issues in `Extensions V2`
+
+## [2.65.3] - 2025-09-08
+### Fixed
+- `Plain Entrypoints` not getting their proper handle prefix
+
+### Added
+- Standardized functions for `require` and `include` to `PHPWriter`
+
+## [2.65.2] - 2025-09-04
+### Fixed
+- `block.json` files causing `block.asset.php` files to be emitted
+
+## [2.65.1] - 2025-09-04
+### Fixed
+- Lingering issues in the dependency extractor
+- Random `.asset.php` files being output when they should not have been
+
+### Internals
+- Removed the need to split builds on `additionalDependencies`
+
+## [2.65.0] - 2025-09-03
+### Added
+- Full backwards compatibility
+- Multi-source support for `Extensions`
+
+### Internals
+- Refactored almost every plugin to eliminate as much duplicated code as I could.
+- Massively cleaned up the logic
+
+## [2.64.0] - 2025-09-03
+### Added
+- Proper monobuild support!
+
+### Internals
+- Fundamentally changed how we load entrypoints and batch builds. This should vastly reduce build times.
+- Refactored most of the plugins to share more code
+
+## [2.63.2] - 2025-09-03
+### Fixed
+- Builds being self-deleting
+  - WordPress switched to a different way of handling cleaning
+
+## [2.63.1] - 2025-09-03
+### Fixed
+- Builds not working
+  - This is a horrible and hastily-thrown-together version of the monobuild prototype. The entire implementation is subject to change.
+
+## [2.63.0] - 2025-09-03
+### Added
+- The ability to dynamically load extensions
+  - This is done by setting the `locations` property to a string, which, in turn, will be used to name a function that contains the extensions loader code
+- An initial version of dynamic handle names for Plain Entrypoints
+
+### Internals
+- Made further improvements to `PHPWriter`
+- Made a bit more progress on working out how to get monobuilds working
+
+## [2.62.3] - 2025-09-01
+### Fixed
+- A missed case in the validation for the `Assignment` expression in `php-writer.ts`
+
+## [2.62.2] - 2025-09-01
+### Fixed
+- An issue caused by returning an Iterator instead of an Iterable
+
+## [2.62.1] - 2025-09-01
+### Fixed
+- A couple of minor teething issues with the new logic
+
+### Internals
+- Did a massive refactor of `PHPWriter` to make it more flexible
+  - This was entirely for fun, so it doesn't count as a "feature"
+- Started refactoring plugins to share code
+  - This is in prep for Monobuild support
+
+## [2.62.0] - 2025-08-31
+### Added
+- Proper script module support in Extension- and Plain Entrypoint-style outputs
+
+### Changed
+- Rewrote `BlockJsonManagingPlugin` to use proper WebPack features instead of crazy hacks
+- Updated the Blocks loader to emit a call to `BlockManager::autoloadSubfoldersV3()`
+  - This requires `plaudit-common` version `2.24.0` or higher
+
+### Fixed
+- Module scripts being included improperly when included a directory in Plain Entrypoints mode
+
+## [2.61.2] - 2025-08-28
+### Removed
+- An unnecessary `accountForAlreadyDoing` flag from the code generated by `SpecialAssetHandlingPlugin` 
+
+## [2.61.1] - 2025-08-28
+### Fixed
+- Legacy Blocks not loading properly
+
+## [2.61.0] - 2025-08-26
+### Changed
+- `ExtensionsConfigFileGeneratorPlugin` to use plaudit-common's `GutenbergUtils` instead of plaudit-base's `ThemeUtils` for registering extensions
+
+## [2.60.2] - 2025-08-26
+### Fixed
+- `use` declarations being emitted by `PHPWriter`s in subwriter mode
+
+## [2.60.1] - 2025-08-25
+### Changed
+- All `init` hooks emitted as part of the generated loader code to check for whether they're already in an init hook
+- Made some crazy improvements to `PHPWriter`
+
+## [2.60.0] - 2025-08-25
+### Added
+- Support for using `DEV_TARGET` to further filter whether the BrowserSync plugin should be started
+  - This is intended to make recursive commands a viable option
+
+### Removed
+- `CleanWebpackPlugin` because it was significantly more trouble than it was ever worth
+
+### Changed
+- Started refactoring some of the plugins to better-match the pattern that WebPack expects plugins to follow
+
+## [2.59.0] - 2025-08-22
+### Changed
+- Replaced a lingering dependence on `theapp` within the `BrowserSyncPlugin` with some code that does the same basic thing
+
+## [2.58.4] - 2025-08-21
+### Fixed
+- Unnecessary emission of the `plaudit_webpack_extensions__resolve_base_uri` function in the `Unified Loader`
+  - This doesn't actually cause any problems - I just disliked seeing it emitted unnecessarily
+
+## [2.58.3] - 2025-08-20
+### Changed
+- The `return` method in `PHPWriter` to handle its argument as a php value instead of as formatted code
+### Fixed
+- A race condition in the `ExtensionsConfigFileGeneratorPlugin`
+
+## [2.58.2] - 2025-08-15
+### Changed
+- Reworked how postprocessing pipelines are implemented to avoid some of the async hackery that I've previously used
+  - This is in prep for a total rewrite of the block.json handling logic
+
+## [2.58.1] - 2025-08-14
+### Added
+- Automatic variable unsetting via "scope"s to PHPWriter
+  - I added this entirely for fun
+
+## [2.58.0] - 2025-08-13
+### Added
+- The ability to specify the handle for manually-enqueued scripts by setting the location property to a string
+
+## [2.57.3] - 2025-08-13
+### Removed
+- A whole `trailingslashit` call from the `Unified Loader` code!
+  - This is a comically pointless micro-optimization
+
+## [2.57.2] - 2025-08-12
+### Fixed
+- An incorrect default value
+
+## [2.57.1] - 2025-08-12
+### Changed
+- Made the unified loader opt-in in order to avoid a ton of duplicated code
+
+## [2.57.0] - 2025-08-12
+### Added
+- Unified Loader Generation
+  - At last, users are free from having to load each output type!
+- Automatic computation of the `plainEntrypointsHandlePrefix` setting
+  - The prefixes were just the kebab'd plugin or theme names, so automatically grabbing those removes some unnecessary config burden from the user
+
+## [2.56.4] - 2025-08-08
+### Fixed
+- A bug that caused all plain entrypoint scripts to processed be regardless of module-ness 
+
+## [2.56.3] - 2025-08-07
+### Fixed
+- The generation logic for `plaudit_webpack_extensions__resolve_base_uri` not taking the lack of namespaces into account
+
+## [2.56.2] - 2025-08-06
+### Changed
+- Removed a now-unnecessary sorting step in `PseudoSemaphore`
+
+## [2.56.1] - 2025-08-06
+### Fixed
+- The Automatic Destination Calculator adding the wrong handle suffixes for scripts and styles
+
+### Changed
+- How generated handles are trimmed down to make them more aesthetically pleasing
+
+## [2.56.0] - 2025-08-06
+### Added
+- Automatic Destination Calculation for all Entrypoints
+  - Requires Plain Entrypoints V2 for Plain Entrypoints
+  - Works best in projects that have a single root src directory
+  - In short, this means that the destination property is optional
+- The `srcPrefixes` config property
+  - Allows Automatic Destination Calculation to be used in projects that have multiple source roots
+- Support for `true` as a valid value for src that have an entirely-derived configuration
+
+## [2.55.1] - 2025-08-06
+### Fixed
+- Unnecessary newlines being added by PHPWriter
+
+## [2.55.0] - 2025-08-04
+### Added
+- Plain Entrypoints V2
+  - This feature removes the need to enqueue scripts and styles separately from their build declarations
+  - It requires `outputDir` and `plainEntrypointsHandlePrefix` to be set
+  - It requires modifications to the current theme, so it's not a drop-in upgrade
+- `plainEntrypointsVersion` to the root config object. It can be either 1 or 2 (default: 1)
+- `plainEntrypointsHandlePrefix` to the root config object
+
+## [2.54.0] - 2025-07-26
+### Added
+- Block Extensions V2
+  - This has the same feature set as Block Extensions V1, but uses the "single-file" output that BlockJSON V3 uses
+  - This is entirely for performance reasons. From a features perspective, there should not be any outward difference
+  - Requires `plaudit-base` version 2.98.0 or higher
+- `extensionsVersion` to the root config object. It can be either 1 or 2 (default: 1)
+
+### Changed
+- Refactored the synchronization logic used in `BlockJSONManagingPlugin` into its own class
+
+## [2.53.1] - 2025-07-25
+### Fixed
+- Updated the PNPM overrides to fix a build error
+
+## [2.53.0] - 2025-07-25
+### Changed
+- Files prefixed with `~` in the extensions directory are excluded from the build
+
+## [2.52.1] - 2025-06-20
+### Fixed
+- Hid excessive "asset too large" warnings for incompressible assets
+
+## [2.52.0] - 2025-06-11
+### Added
+- Support for inlining SVGs in PCSS files
+
+## [2.51.0] - 2025-06-10
+### Added
+- Support for running the `webpack-bundle-analyzer` on code
+
+## [2.50.0] - 2025-06-03
+### Added
+- Checks for common conflicting config files
+  - Primarily: `postcss.config.js`, `babel-transform.js`, and Babel's config files
+
+### Changed
+- Replaced all default exports with standard ones for consistency
+
+## [2.49.0] - 2025-05-20
+### Added
+- The `@plaudit/block-supports` library to the externalizable libraries list
+
+## [2.48.0] - 2025-05-19
+### Added
+- Support for generating `<link>` tags from preload and fetchPriority parameters in asset references.
+  - This feature requires `useWebpackResourceFiltering` to be set to `true`
+- A flag to switch to using Webpack's native handling for all assets regardless of whether the path starts with a "/"
+  - The flag is `useWebpackResourceFiltering`. It defaults to `false`
+
+## [2.47.0] - 2025-05-16
+### Added
+- Support for externalizing non-plaudit libraries.
+- Automatic detection of whether a library is currently being externalized (this prevents infinite loops in the generated dependency list)
+
+### Fixed
+- Corrected the readme
+
+## [2.46.0] - 2025-05-15
+### Added
+- This changelog
+
+### Changed
+- Made the handle-generation code for Blocks include the block's full name in the handle instead of its folder name
+- Switched to using a shared publishing script
+
+### Removed
+- The old project-specific deployment script
+
+## [2.45.1] - 2025-04-30
+### Fixed
+- Resolved the "extensions" module including the phantom JS files generated by "MiniCssExtractPlugin" in the "mapping.config" file.
+
+## [2.45.0] - 2025-04-22
+### Changed
+- Upgraded to PostCSS-8-compatible versions of shorthand plugins.

package/build/plugins/PlainEntrypointsConfigFileGeneratorPlugin.d.ts

@@ -13,6 +13,12 @@ export declare class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractB
     private static addHandlesToHandleLists;
     private static appendEnqueuingHandleLists;
     private static separateHandleListByPriority;
+    /**
+     * This is used to allow scripts and styles to be grouped based on hook_name for the admin handle
+     * @param handleItems
+     * @private
+     */
+    private static separateHandleListByHookName;
     protected attachUniquePhase(compilation: Compilation): void;
     protected processAssets(compilation: Compilation, parsedAssetJsonProvider: ParsedAssetJsonProvider): void;
 }

package/build/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -90,32 +90,101 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
             }
         }
         PlainEntrypointsConfigFileGeneratorPlugin.appendEnqueuingHandleLists(writer, handleLists);
+        const sortedEditorStyleHandles = sortedStyleHandles
+            .filter(([_, { locations: { clientEditor }, type }]) => type === 'style' && (clientEditor || typeof clientEditor === 'number'))
+            .sort((a, b) => {
+            const aPriority = typeof a[1].locations.clientEditor === 'boolean' ? 10 : a[1].locations.clientEditor;
+            const bPriority = typeof b[1].locations.clientEditor === 'boolean' ? 10 : b[1].locations.clientEditor;
+            return aPriority - bPriority;
+        })
+            .map(info => info[1].src);
+        if (sortedEditorStyleHandles.length > 0) {
+            writer.linebreak();
+            for (const handleSrc of sortedEditorStyleHandles) {
+                const handlePath = node_path_1.default.join(this.outputDir, node_path_1.default.relative(emitDir, handleSrc));
+                writer.call("add_editor_style", [(0, shared_1.leadingSlashIt)(handlePath)]);
+            }
+        }
         (0, shared_1.emitPHPWriterAsAsset)(writer, compilation, "plain-entrypoints-loader.php");
     }
     static addHandlesToHandleLists(type, handles, handleLists) {
+        const defaultPriority = 10;
         for (const [handle, data] of handles) {
             if (data.locations.register !== false) {
                 handleLists.register.push({ handle, type, data, priority: typeof data.locations.register === 'number' ? data.locations.register : 10 });
             }
             for (const location of (0, shared_1.constantKeys)(shared_1.standardLocationNamesMeta)) {
-                if (typeof data.locations[location] === 'number') {
-                    handleLists[location].push({ handle, type, priority: data.locations[location] });
+                let priority, hook_name;
+                const dataLocation = data.locations[location];
+                if (location === 'clientEditor' && type === 'style') {
+                    // We don't include editor styles in the handle list because editor styles are enqueued via a completely separate mechanism at runtime and, therefore,
+                    // cannot be handled by the same code as every other enqueueable item
+                    continue;
+                }
+                if (typeof dataLocation === 'number') {
+                    priority = dataLocation;
+                    hook_name = undefined;
+                }
+                else if (dataLocation) {
+                    if (typeof dataLocation === 'string') {
+                        priority = defaultPriority;
+                        hook_name = dataLocation;
+                    }
+                    else if (Array.isArray(dataLocation)) {
+                        if (!(0, shared_1.hasAtLeastOneItem)(dataLocation)) {
+                            continue;
+                        }
+                        priority = defaultPriority;
+                        hook_name = dataLocation;
+                    }
+                    else if (typeof dataLocation === 'object') {
+                        priority = dataLocation.priority ?? defaultPriority;
+                        hook_name = Array.isArray(dataLocation.hook_name)
+                            ? (0, shared_1.hasAtLeastOneItem)(dataLocation.hook_name) ? dataLocation.hook_name : undefined
+                            : dataLocation.hook_name ? dataLocation.hook_name : undefined;
+                    }
+                    else {
+                        priority = defaultPriority;
+                        hook_name = undefined;
+                    }
                 }
-                else if (data.locations[location]) {
-                    handleLists[location].push({ handle, type, priority: 10 });
+                else {
+                    continue;
                 }
+                handleLists[location].push({ handle, type, priority, hook_name });
             }
         }
     }
     static appendEnqueuingHandleLists(writer, handleLists) {
-        const enqueuingHandleActions = (0, shared_1.constantEntries)(shared_1.standardLocationNamesMeta).map(([sln, { action }]) => [action, handleLists[sln]]);
-        for (const [action, handleList] of enqueuingHandleActions) {
+        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) {
+                writer.linebreak();
                 for (const [priority, prioritizedHandleList] of PlainEntrypointsConfigFileGeneratorPlugin.separateHandleListByPriority(handleList)) {
+                    if (supports_hook_name) {
+                        const hookNamedHandleLists = PlainEntrypointsConfigFileGeneratorPlugin.separateHandleListByHookName(prioritizedHandleList);
+                        if (!(0, shared_1.arrayIsLength)(hookNamedHandleLists, 1) || hookNamedHandleLists[0][0] !== "") {
+                            const hook_name_var = new expressions_1.Var("hook_name", "?string");
+                            writer.action(action, writer => {
+                                additional_action_code?.before?.(writer);
+                                for (const [hook_name, handles] of hookNamedHandleLists) {
+                                    writer.if(expressions_1.Op.binary(hook_name_var, " === ", hook_name));
+                                    for (const handle of handles) {
+                                        writer.call(`wp_enqueue_${handle.type}`, [handle.handle]);
+                                    }
+                                    writer.endIf();
+                                }
+                                additional_action_code?.after?.(writer);
+                            }, { priority, functionArgParameters: [hook_name_var] });
+                            continue;
+                        }
+                    }
                     writer.action(action, writer => {
+                        additional_action_code?.before?.(writer);
                         for (const handle of prioritizedHandleList) {
                             writer.call(`wp_enqueue_${handle.type}`, [handle.handle]);
                         }
+                        additional_action_code?.after?.(writer);
                     }, { priority });
                 }
             }
@@ -134,6 +203,35 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
         }
         return lists.entries().toArray().sort((a, b) => a[0] - b[0]);
     }
+    /**
+     * This is used to allow scripts and styles to be grouped based on hook_name for the admin handle
+     * @param handleItems
+     * @private
+     */
+    static separateHandleListByHookName(handleItems) {
+        const lists = new Map();
+        for (const handleItem of handleItems) {
+            const hook_name = handleItem.hook_name ?? "";
+            for (const hn of Array.isArray(hook_name) ? hook_name : [hook_name]) {
+                const list = lists.get(hn);
+                if (list) {
+                    list.push(handleItem);
+                }
+                else {
+                    lists.set(hn, [handleItem]);
+                }
+            }
+        }
+        return lists.entries().toArray().sort((a, b) => {
+            if (a[0] === "") {
+                return b[0] === "" ? 0 : -1;
+            }
+            else if (b[0] === "") {
+                return 1;
+            }
+            return a[0].localeCompare(b[0]);
+        });
+    }
     attachUniquePhase(compilation) {
         compilation.hooks.processAssets.tapPromise({ name: this.constructor.name, stage: webpack_1.Compilation.PROCESS_ASSETS_STAGE_REPORT }, async () => {
             this.generatePlainEntrypointsLoader(compilation, (await PlainEntrypointsConfigFileGeneratorPlugin.semaphore.wait()).flat());

package/build/shared.d.ts

@@ -28,6 +28,7 @@ export declare const standardLocationNamesMeta: {
     };
     readonly admin: {
         readonly action: "admin_enqueue_scripts";
+        readonly supports_hook_name: true;
     };
     readonly login: {
         readonly action: "login_enqueue_scripts";
@@ -39,9 +40,23 @@ export declare const standardLocationNamesMeta: {
         readonly action: "plaudit_enqueue_analytics";
     };
 };
+export type StandardLocationNameMeta = {
+    action: typeof standardLocationNamesMeta[keyof typeof standardLocationNamesMeta]['action'];
+    supports_hook_name?: boolean;
+    additional_action_code?: {
+        before?(writer: PHPWriter): unknown;
+        after?(writer: PHPWriter): unknown;
+    };
+};
 export type StandardLocationNames = keyof typeof standardLocationNamesMeta;
+type LocationWithHookNameSupport = boolean | number | string | string[] | {
+    hook_name?: string | string[];
+    priority?: number;
+};
 export type UsageLocations = {
-    [K in StandardLocationNames]?: boolean | number;
+    [K in StandardLocationNames]?: typeof standardLocationNamesMeta[K] extends {
+        supports_hook_name: true;
+    } ? LocationWithHookNameSupport : boolean | number;
 } & {
     register?: boolean | number;
     handle?: string | ((generatedHandle: string) => string);

package/build/shared.js

@@ -49,9 +49,13 @@ function isParsedAssetsJson(thing) {
     return true;
 }
 exports.standardLocationNamesMeta = {
-    clientView: { action: "wp_enqueue_scripts" }, clientEditor: { action: "enqueue_block_editor_assets" }, blockAssets: { action: "enqueue_block_assets" },
-    admin: { action: "admin_enqueue_scripts" }, login: { action: "login_enqueue_scripts" }, customizer: { action: "customize_controls_enqueue_scripts" },
-    analytics: { action: "plaudit_enqueue_analytics" }
+    clientView: { action: "wp_enqueue_scripts" },
+    clientEditor: { action: "enqueue_block_editor_assets" },
+    blockAssets: { action: "enqueue_block_assets" },
+    admin: { action: "admin_enqueue_scripts", supports_hook_name: true },
+    login: { action: "login_enqueue_scripts" },
+    customizer: { action: "customize_controls_enqueue_scripts" },
+    analytics: { action: "plaudit_enqueue_analytics" },
 };
 function isNormalizedUsageLocations(usageLocations) {
     return typeof usageLocations.registerScriptArgs !== 'string';

package/build/wordpress-scripts-wrapper.js

@@ -2,9 +2,9 @@
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-const node_fs_1 = __importDefault(require("node:fs"));
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
 const shared_1 = require("./shared");
 const common_config_helpers_1 = require("./utils/common-config-helpers");
 const AdditionalDependencyInjectorPlugin_1 = require("./plugins/AdditionalDependencyInjectorPlugin");
@@ -34,8 +34,8 @@ function testForDuplicatedEntryPaths(sources) {
     for (const sameNamePaths of seenPaths.values()) {
         if (sameNamePaths.length > 1) {
             if (projectPrefix === undefined) {
-                for (let p = process.cwd(); p.length > 1; p = node_path_1.default.dirname(p)) {
-                    if (node_fs_1.default.existsSync(node_path_1.default.join(p, "docker-compose.yml"))) {
+                for (let p = process.cwd(); p.length > 1; p = (0, node_path_1.dirname)(p)) {
+                    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(p, "docker-compose.yml"))) {
                         projectPrefix = new RegExp(`^${p}`);
                         break;
                     }
@@ -44,7 +44,7 @@ function testForDuplicatedEntryPaths(sources) {
                     projectPrefix = /^/;
                 }
             }
-            duplicatedPaths += `\n* ${node_path_1.default.dirname(sameNamePaths[0]).replace(projectPrefix, '')}/[${sameNamePaths.map(p => node_path_1.default.basename(p)).join(', ')}]`;
+            duplicatedPaths += `\n* ${(0, node_path_1.dirname)(sameNamePaths[0]).replace(projectPrefix, '')}/[${sameNamePaths.map(p => (0, node_path_1.basename)(p)).join(', ')}]`;
         }
     }
     if (duplicatedPaths.length !== 0) {
@@ -190,11 +190,11 @@ function buildVerifiedConfig(config) {
     }
     const normalizeSrcAndDestination = ([src, dest]) => {
         if (srcDir) {
-            src = node_path_1.default.join(srcDir, src);
+            src = (0, node_path_1.join)(srcDir, src);
         }
-        src = node_path_1.default.isAbsolute(src) ? node_path_1.default.relative(process.cwd(), src) : src;
-        if (dest.destination !== undefined && node_path_1.default.isAbsolute(dest.destination)) {
-            dest = { ...dest, destination: node_path_1.default.relative(process.cwd(), dest.destination) };
+        src = (0, node_path_1.isAbsolute)(src) ? (0, node_path_1.relative)(process.cwd(), src) : src;
+        if (dest.destination !== undefined && (0, node_path_1.isAbsolute)(dest.destination)) {
+            dest = { ...dest, destination: (0, node_path_1.relative)(process.cwd(), dest.destination) };
         }
         return [src, dest];
     };
@@ -207,7 +207,7 @@ function buildVerifiedConfig(config) {
     let variablesFilePath = undefined;
     const currentVariables = rawVariables ?? {};
     if (!rawVariables) {
-        variablesFilePath = ["variables.js", "src/site/variables.js"].map(p => node_path_1.default.join(process.cwd(), p)).filter(p => node_fs_1.default.existsSync(p))[0];
+        variablesFilePath = ["variables.js", "src/site/variables.js"].map(p => (0, node_path_1.join)(process.cwd(), p)).filter(p => (0, node_fs_1.existsSync)(p))[0];
     }
     let extensionsVersion = config.extensionsVersion ?? 1;
     if (extensionsVersion === 2) {
@@ -259,8 +259,8 @@ function buildVerifiedConfig(config) {
     return cfg.outputDir ? { cfg, sources } : withDerivedOutputDir(cfg, sources);
 }
 function toEffectiveWebpackDestination(destination) {
-    const pathParts = node_path_1.default.parse(destination);
-    return node_path_1.default.join(pathParts.dir, pathParts.name);
+    const pathParts = (0, node_path_1.parse)(destination);
+    return (0, node_path_1.join)(pathParts.dir, pathParts.name);
 }
 function deriveNaiveDestinationFromUnverifiedSourceEntry([src, { destination }], srcPrefixes) {
     if (destination !== undefined) {
@@ -289,7 +289,7 @@ function finalizeEntryDestination(entry, dynamicEffectiveDestinationsWithExpecte
     if (entry[1].staticallyDeclaredDestination) {
         return entry;
     }
-    const extension = node_path_1.default.extname(entry[1].destination);
+    const extension = (0, node_path_1.extname)(entry[1].destination);
     const filename = dynamicEffectiveDestinationsWithExpectedNaiveDuplicates[entry[1].effectiveDestination]
         ? entry[1].effectiveDestination + (extension === '.css' ? "_style" : "_script")
         : entry[1].effectiveDestination;
@@ -308,7 +308,7 @@ function deriveDefaultHandlePrefixFromComposerJsonOrThemeName() {
     }
     let composerJson;
     try {
-        composerJson = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(process.cwd(), "composer.json"), 'utf-8'));
+        composerJson = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), "composer.json"), 'utf-8'));
     }
     catch {
         // Then composer.json doesn't exist
@@ -320,7 +320,7 @@ function deriveDefaultHandlePrefixFromComposerJsonOrThemeName() {
     return (0, shared_1.kebabCase)(composerJson.name.replace(/plaudit\/plaudit/, 'plaudit'));
 }
 function deriveDefaultHandlePrefixFromThemeName() {
-    const styleFileContents = node_fs_1.default.readFileSync(node_path_1.default.join(process.cwd(), "style.css"), 'utf-8');
+    const styleFileContents = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), "style.css"), 'utf-8');
     const themeName = /^\W*Theme\s*Name:\s*(.+)$/im.exec(styleFileContents)?.[1]?.trim();
     if (!themeName) {
         throw new ReferenceError("targetHandlePrefix was not set and the adjacent style.css file does not have a valid name in it");
@@ -348,8 +348,8 @@ function withDerivedOutputDir(cfg, sources) {
 function handleDisablingTSCheckerIfNecessary(srcRoot, scriptExtension, plugins) {
     if (process.env["NO_TS_CHECKER"] !== "true") {
         const include = (Array.isArray(srcRoot) ? srcRoot : [srcRoot])
-            .filter(sr => node_path_1.default.extname(sr).length === 0 || (0, shared_1.scriptOrStyleTest)(sr, scriptExtension) === "script")
-            .map(sr => node_path_1.default.extname(sr).length > 0 ? sr : node_path_1.default.join(sr, "**", "*"));
+            .filter(sr => (0, node_path_1.extname)(sr).length === 0 || (0, shared_1.scriptOrStyleTest)(sr, scriptExtension) === "script")
+            .map(sr => (0, node_path_1.extname)(sr).length > 0 ? sr : (0, node_path_1.join)(sr, "**", "*"));
         if (include.length > 0) {
             plugins.push(new fork_ts_checker_webpack_plugin_1.default({
                 async: true,
@@ -482,10 +482,10 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
     const { processingModules, scriptExtension } = commonConfig;
     const allSrcRoots = sources.map(([src, dest]) => {
         const srcRoots = (dest.withLegacyBlocksIn
-            ? [...src.split(','), ...(0, shared_1.resolveLegacyBlockScriptsInFolder)(node_path_1.default.join(config.srcDir, dest.withLegacyBlocksIn))]
+            ? [...src.split(','), ...(0, shared_1.resolveLegacyBlockScriptsInFolder)((0, node_path_1.join)(config.srcDir, dest.withLegacyBlocksIn))]
             : src.split(',')).filter(s => s.endsWith(".json") || !s.substring(s.lastIndexOf('/')).includes('.') || processingModules === shared_1.scriptWithModuleExtension.test(s));
         const srcRoot = srcRoots.length < 2 ? (0, common_config_helpers_1.joinPossiblyAbsolutePaths)(process.cwd(), src) : srcRoots.map(s => (0, common_config_helpers_1.joinPossiblyAbsolutePaths)(process.cwd(), s));
-        const srcIsDirectory = !Array.isArray(srcRoot) && node_fs_1.default.lstatSync(srcRoot, { throwIfNoEntry: false })?.isDirectory();
+        const srcIsDirectory = !Array.isArray(srcRoot) && (0, node_fs_1.lstatSync)(srcRoot, { throwIfNoEntry: false })?.isDirectory();
         if (srcIsDirectory === undefined) {
             return undefined;
         }
@@ -521,11 +521,11 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
                 }
                 const entry = async () => {
                     const rawEntrypoints = [];
-                    for await (const dirent of await promises_1.default.opendir(srcRoot)) {
+                    for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
                         if (dirent.isFile() && !dirent.name.startsWith("~")) {
                             if (commonConfig.scriptExtension.test(dirent.name) || shared_1.styleExtension.test(dirent.name)) {
                                 const absoluteSrc = (0, common_config_helpers_1.joinPossiblyAbsolutePaths)(srcRoot, dirent.name);
-                                rawEntrypoints.push([node_path_1.default.join(dest.destination, node_path_1.default.basename(absoluteSrc, node_path_1.default.extname(absoluteSrc))), { import: [absoluteSrc], plauditMetadata: { dest, absoluteSrc } }]);
+                                rawEntrypoints.push([(0, node_path_1.join)(dest.destination, (0, node_path_1.basename)(absoluteSrc, (0, node_path_1.extname)(absoluteSrc))), { import: [absoluteSrc], plauditMetadata: { dest, absoluteSrc } }]);
                             }
                         }
                     }
@@ -580,7 +580,7 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
     }).filter(cfg => cfg !== undefined);
 }
 function stripExtension(filepath) {
-    return node_path_1.default.join(node_path_1.default.dirname(filepath), node_path_1.default.basename(filepath, node_path_1.default.extname(filepath)));
+    return (0, node_path_1.join)((0, node_path_1.dirname)(filepath), (0, node_path_1.basename)(filepath, (0, node_path_1.extname)(filepath)));
 }
 module.exports = function (config, webpackConfig = require("@wordpress/scripts/config/webpack.config")) {
     const { cfg, sources } = buildVerifiedConfig(config);

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@plaudit/webpack-extensions",
-  "version": "2.82.3",
+  "version": "2.83.1",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
-    "/build"
+    "/build",
+    "README.md",
+    "LICENSE.md",
+    "CHANGELOG.md"
   ],
   "exports": {
     "./wordpress-scripts-wrapper": "./build/wordpress-scripts-wrapper.js",
@@ -20,9 +23,9 @@
     }
   },
   "devDependencies": {
-    "@plaudit/gutenberg-api-extensions": "^2.83.0",
+    "@plaudit/gutenberg-api-extensions": "^2.84.3",
     "@types/browser-sync-webpack-plugin": "^2.2.5",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "@types/postcss-functions": "^4.0.4",
     "@types/tapable": "^2.3.0",
     "@types/webpack": "^5.28.5",
@@ -33,14 +36,14 @@
     "webpack-bundle-analyzer": "^4.10.2"
   },
   "dependencies": {
-    "@plaudit/php-writer": "^1.3.2",
+    "@plaudit/php-writer": "^1.3.3",
     "@plaudit/postcss-color-function": "^5.0.0",
     "@plaudit/postcss-legacy-shorthand": "^1.0.0",
     "@plaudit/postcss-silent-extend": "^3.0.0",
     "@plaudit/postcss-strip-units": "^3.0.0",
     "@plaudit/postcss-variables": "^1.1.0",
-    "@wordpress/dependency-extraction-webpack-plugin": "^6.37.0",
-    "@wordpress/scripts": "^31.2.0",
+    "@wordpress/dependency-extraction-webpack-plugin": "^6.38.0",
+    "@wordpress/scripts": "^31.3.0",
     "autoprefixer": "^10.4.23",
     "browser-sync": "^3.0.4",
     "copy-webpack-plugin": "10.2.4",