@plaudit/webpack-extensions 2.85.3 → 2.87.0

package/CHANGELOG.md

@@ -5,6 +5,74 @@ 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.3.0] - 2026-03-16
+### Added
+- A few helper methods for tools that reference this package and care about the entrypoint resolution logic
+
+## [3.2.2] - 2026-03-16
+### Changed
+- Exposed additional aspects of the entrypoint resolution logic to tools that reference this package
+
+## [3.2.1] - 2026-03-16
+### Added
+- A function to expose standard flag sets to tools that reference this package
+
+## [3.2.0] - 2026-03-16
+### Added
+- Support for `Location-Encoding Filenames`
+  - This comes from version `2.86.0`
+- Support for standardized flag sets
+  - This comes from version `2.86.0`
+
+## [3.1.2] - 2026-03-06
+### Fixed
+- `defer` and `async` not being supported strategies in some pipelines
+  - This comes from version `2.85.3`
+
+## [3.1.1] - 2026-03-06
+### Fixed
+- Inlined scripts without any other path query parameters not being placed in the footer by default
+  - This comes from version `2.85.2`
+
+## [3.1.0] - 2026-03-05
+### Added
+- Support for inlining (and otherwise controlling the enqueuing of) assets
+  - This only applies to plain entrypoints and assets declared within block.json files at present
+  - This comes from version `2.85.0`
+
+## [3.0.1] - 2026-02-12
+### Added
+- Release version!
+
+## [3.0.0-rc.3] - 2026-02-12
+### Fixed
+- A missing dependency
+
+## [3.0.0-rc.2] - 2026-02-12
+### Fixed
+- A missing dependency
+
+## [3.0.0-rc.1] - 2026-02-12
+### Changed
+- Updated all postcss plugins to their latest available versions
+
+### Removed
+- Legacy PostCSS features that have been integrated into modern CSS
+- `@extends` support
+
+## [2.87.0] - 2026-03-16
+### Added
+- Support for a directory-based `extensions` layout
+  - This only applies to sites using extensions v2 and higher
+
+### Internals
+- Backported the features from `3.2.x` and `3.3.0`
+
+## [2.86.0] - 2026-03-16
+### Added
+- Support for `Location-Encoding Filenames`
+- Support for standardized flag sets
+
 ## [2.85.3] - 2026-03-06
 ### Fixed
 - `defer` and `async` not being supported strategies in some pipelines

package/USER-GUIDE.md

@@ -28,6 +28,11 @@
     * [Pattern 4: Block Editor Styles](#pattern-4-block-editor-styles)
 * [Reference](#reference)
   * [Root Options](#root-options)
+    * [Standard Flag Sets](#standard-flag-sets)
+  * [Location-Encoding Filenames](#location-encoding-filenames)
+    * [Enqueuing Location](#enqueuing-location)
+    * [Examples](#examples-1)
+      * [Block- and Plain-compatible](#block--and-plain-compatible)
   * [Per-Entrypoint Options](#per-entrypoint-options)
     * [Path Queries](#path-queries)
     * [Boolean-form](#boolean-form)
@@ -138,85 +143,26 @@ The config tells webpack **what** to build and **where** to load it in WordPress
 
 ```javascript
 module.exports = require("@plaudit/webpack-extensions/wordpress-scripts-wrapper")({
-	src: {
-	  // Build all blocks in src/blocks/
-		"blocks": true,
-    
-	  // Build block extensions from src/extensions/
-		"extensions": {directoryLayout: 'extensions'},
-
-	  // Auto-load in the head on frontend
-		"site/index-header.ts": {
-			locations: {
-				clientView: true,
-				registerScriptArgs: false
-			}
-		},
-    
-	  // Auto-load at the bottom of the body on frontend
-		"site/index-footer.ts": {
-			locations: {
-				clientView: true,
-				registerScriptArgs: 'lazy'
-			}
-		},
-	  // Auto-load in admin
-		"site/wp-admin.ts": {
-			locations: {
-				admin: true
-			}
-		},
-	  // Auto-load in admin
-		"site/wp-admin.pcss": {
-			locations: {
-				admin: true
-			}
-		},
-	  // Auto-load in the block editor
-		"site/block-editor.pcss": {
-			locations: {
-				clientEditor: true
-			}
-		},
-	  // Auto-load in the head on frontend
-		"site/public.pcss": {
-			locations: {
-				clientView: true
-			}
-		},
-	  // A script that can be enqueued via its handle, but is not autoloaded
-	  "site/manually-loaded.ts": {
-		  locations: "plaudit-theme/manually-loaded-script"
-	  },
-	  // A script that will be inlined into the footer
-	  "site/inlined-script.ts?inline=true": {
-		  locations: "plaudit-theme/inlined-script"
-	  }
-	},
-	useWebpackResourceFiltering: true, // Always use this!
-	extensionsVersion: 3,
-	plainEntrypointsVersion: 2,
-	srcDir: "src", // Always use this!
-	outputDir: "dist", // Always use this!
-	useUnifiedLoader: true, // Always use this!
+	standard: '2026-03-16',
 	variables: {
 		font_size: 16 // Required for pxAsRem to work; replace the 16 with your site's base font size
 	}
 });
 ```
+The `standard` key is shorthand to the standard set of flags as of the given date. See the [Standard Flag Sets](#standard-flag-sets) section for details.
 
 ### 2. Set Up Your File Structure
 
 **Blocks** (subdirectories with block.json):
-- **Config:** `'blocks': true`
+- **Config:** optional so long as the directory name is `blocks`; `'<dirname>': true` otherwise
 - **File Structure:** [See Here](#file-structure)
 
 **Extensions** (flat files that modify existing blocks):
-- **Config:** `'extensions': {directoryLayout: 'extensions'}`
+- **Config:** optional so long as the directory name is `extensions`; `'<dirname>': {directoryLayout: 'extensions'}` otherwise
 - **File Structure:** [See Here](#file-structure-1)
 
 **Other Files** (scripts, styles):
-- **Config:** List each file individually in `src` object
+- **Config:** Optional so long as you are using [Location-Encoding Filenames](#location-encoding-filenames); List each file that does not encode its own location in `src` object
 - **File Structure:** [See Here](#file-structure-2)
 
 ### 3. Include unified-loader.php in Your Plugin
@@ -357,21 +303,93 @@ src: {
 # Reference
 
 ## Root Options
-| Option                             | Type      | Default      | Description                                                                                                                                                                                  |
-|------------------------------------|-----------|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `src`                              | `object`  | **Required** | Files/directories to process (see the next section for what you can put in here)                                                                                                             |
-| `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!)                                                                                                        |
-| `plainEntrypointsVersion`          | `1\|2`    | `1`          | Use 2 for new sites                                                                                                                                                                          |
-| `extensionsVersion`                | `1\|2\|3` | `1`          | Use 3 for new sites                                                                                                                                                                          |
-| `verbose`                          | `boolean` | `false`      | Verbose logging                                                                                                                                                                              |
-| `variables`                        | `object`  | Auto         | CSS/JS variables. If a variables.js file is present, this will automatically load from that file                                                                                             |
-| `onlyRunPostCSSOnPCSS`             | `boolean` | `false`      | If true, the PostCSS processor will not be run on CSS files. This is true for all new sites and can be safely enabled on most sites if desired.                                              |
-| `assumeGlobalizedPlauditLibraries` | `boolean` | `true`       | **[Advanced]** When `false`, normally-externalized plaudit libraries will be included.<br>**DO NOT USE THIS. IF YOU SEE IT BEING USED, CONTACT JOSH**                                        |
-| `externals`                        | `object`  | -            | **[Advanced]** Allows dependencies to be marked as external. This prevents them from being included in the bundle under the assumption that they will be provided via an alternate mechanism |
-| `targetHandlePrefix`               | `string`  | Auto         | **[Legacy]** Prefix for handles. Auto-detected from composer.json if omitted. Do not set this unless absolutely necessary                                                                    |
+| Option                             | Type      | Default | Description                                                                                                                                                                                  |
+|------------------------------------|-----------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `standard`                         | `enum`    | -       | An identifier for the standard set of flags as of a given date. See the [Standards Flag Sets](#standard-flag-sets) section for values                                                        |
+| `src`                              | `object`  | `{}`    | Files/directories to process (see the next section for what you can put in here)                                                                                                             |
+| `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!)                                                                                                        |
+| `plainEntrypointsVersion`          | `1\|2`    | `1`     | Use 2 for new sites                                                                                                                                                                          |
+| `extensionsVersion`                | `1\|2\|3` | `1`     | Use 3 for new sites                                                                                                                                                                          |
+| `verbose`                          | `boolean` | `false` | Verbose logging                                                                                                                                                                              |
+| `variables`                        | `object`  | Auto    | CSS/JS variables. If a variables.js file is present, this will automatically load from that file                                                                                             |
+| `onlyRunPostCSSOnPCSS`             | `boolean` | `false` | If true, the PostCSS processor will not be run on CSS files. This is true for all new sites and can be safely enabled on most sites if desired.                                              |
+| `assumeGlobalizedPlauditLibraries` | `boolean` | `true`  | **[Advanced]** When `false`, normally-externalized plaudit libraries will be included.<br>**DO NOT USE THIS. IF YOU SEE IT BEING USED, CONTACT JOSH**                                        |
+| `externals`                        | `object`  | -       | **[Advanced]** Allows dependencies to be marked as external. This prevents them from being included in the bundle under the assumption that they will be provided via an alternate mechanism |
+| `targetHandlePrefix`               | `string`  | Auto    | **[Legacy]** Prefix for handles. Auto-detected from composer.json if omitted. Do not set this unless absolutely necessary                                                                    |
+
+### Standard Flag Sets
+Each flag set is identified by the date that it was added to the standards set. Individual values can be overridden by specifying them in the config file
+
+**2026-03-13**
+```javascript
+{
+	useWebpackResourceFiltering: true,
+	extensionsVersion: 3,
+	plainEntrypointsVersion: 2,
+	srcDir: "src",
+	outputDir: "dist",
+	useUnifiedLoader: true,
+	onlyRunPostCSSOnPCSS: true,
+}
+```
+
+---
+
+## Location-Encoding Filenames
+This section covers how asset emission locations can be encoded in filenames.
+While every common flag is accounted for in this schema, there are some things that cannot be encoded in filenames that will require enumeration in the `webpack.config.js` file's `src` object.
+
+Location-encoding filenames are composed of two or more `.`-separated segments (the file extension being one of those segments).
+The following is a brief list of notes followed by a breakdown of the individual segments:
+- The only required segments are the location and type segments (the type segment is the file extension).
+- So long as there is at least one location and type segment (the type segment MUST be last), "invalid" segments are allowed (this is for the purposes of giving human-readable names to files)
+- Each file can enumerate any combination enqueuing locations
+- The first item is special in that, if it encodes a location, in can optionally be suffixed with a type override (see the [Enqueuing Location](#enqueuing-location) section for more details)
+
+Notes on how to read the following table:
+- Brackets in the token column mean "optional section"
+- `(-|=)` means "this can be either a dash or an equal sign"
+- Pipe-separated items in parentheses means "any one of these items can go here"
+
+| Name               | Token                                                       | Usage                                                                                                                                                    |
+|--------------------|-------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Enqueuing Location | `(enqueuing-location)[(-\|=)priority]`                      | This is a special section that is actually a collection of values. See the [Enqueuing Location](#enqueuing-location) section for more details            |
+| Type Override      | `script`, `style`, `script-module`                          | Can be used to override the detected of the asset. Must be the first token in the filename; if used directly, it is shorthand for `both-(Type Override)` |
+| Inline             | `inline[(-\|=)position]`, `strategy(-\|=)inline[-position]` | Indicates that the script should be inlined. `position` can be either `before` or `after`                                                                |
+| Strategy           | `lazy\|eager`, `strategy(-\|=)(lazy\|eager\|defer\|async)`  | Controls the loading strategy. Lazy and eager have shorthand while the remaining values must be prefixed with `strategy`                                 |
+| Fetch Priority     | `fetchpriority(-\|=)(low\|high\|auto)`                      | Controls the fetchpriority property; `auto` is the default                                                                                               |
+| In Footer          | `in-footer`, `in_footer`                                    | Sets the `in_footer` value to `true`; incompatible with `in-header`                                                                                      |
+| In Header          | `in-header`, `in_header`                                    | Sets the `in_footer` value to `false`; incompatible with `in-footer`                                                                                     |
+| Extension          | `([ps]?c\|sa)ss`, `m?[jt]sx?`                               | This determines the type unless it is overridden. This **MUST** be the last token in the name (it is the file extension)                                 |
+
+### Enqueuing Location
+If this is the first token, it can be suffixed with `-script`, `-style`, or `-script-module` to override the type.
+Specifying the type override alone is interpreted as `both-(Type Override)` for compatibility with how blocks expect assets to be named.
+
+Blocks do not support anything other than `view`, `editor`, and `both` (typically written as `script` or `style`).
+
+**Valid Values**:
+
+| Token                                     | Meaning                                                                                                                     |
+|-------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
+| `view`, `client-view`, `clientView`       | Enqueue the asset on the frontend (the part of the site seen by visitors)                                                   |
+| `editor`, `client-editor`, `clientEditor` | Enqueue the asset in the *display* portion of the block editor                                                              |
+| `both`                                    | Shorthand for `view.editor`                                                                                                 |
+| `block-assets`, `block-assets`            | Enqueue the asset in the *wrapper* portion of the block editor                                                              |
+| `admin`                                   | Enqueue the asset in the admin area                                                                                         |
+| `login`                                   | Enqueue the asset on the standard login page                                                                                |
+| `customizer`                              | Enqueue the asset in the legacy customizer interface                                                                        |
+| `analytics`                               | Enqueue the asset when analytics scripts have been accepted by the visitor (this "location" is unique to Plaudit's systems) |
+| `register`                                | Register the asset *without* enqueuing it anywhere (this is primarily useful when localizing the asset)                     |
+
+### Examples
+#### Block- and Plain-compatible
+- **A view script**: `view.ts`
+- **An editor script**: `editor.ts`
+- **A view and editor script**: `script.ts`
 
 ---
 
@@ -380,6 +398,7 @@ This section covers the shared options for entrypoints. See the [Entrypoint Type
 
 ### Path Queries
 - These are URL-style queries added to the end of entrypoint *source* paths and are used to set entrypoint-specific properties in Plain and Block contexts.
+  - If you find yourself using these, consider switching to [Location-Encoding Filenames](#location-encoding-filenames)
   - At present, this is only being used to configure inlining, but expansion to other systems is being considered
   - The available options are: `strategy`, `inline`, `in_footer`, `fetchpriority`, and `position`
 
@@ -482,8 +501,10 @@ This is used to associate additional assets with blocks that are not in control
 [Specially named files](#file-naming) in a single subdirectory of `src`
 ```
 src/extensions/
-├── core-paragraph-view-script.ts
-└── core-paragraph-editor-style.pcss
+├─ core/paragraph/
+│  ├─ view.ts
+│  └─ editor.pcss
+└─ plaudit/block-library/accordion/style.pcss
 ```
 
 #### File Naming
@@ -494,6 +515,9 @@ Filenames **must** follow the pattern: `{kebab-case-block-name}-{type}.{ext}`
   - `script-module`, `view-script-module`
   - `setup` (this allows for PHP code to be loaded only when certain blocks are enabled and is intended for use in plugins, not themes)
 - `ext` **must** be for a [supported file type](#supported-file-types) and **should** correspond with the extension type (basically, don't enqueue a `.css` file as a script)
+- For convenience, everything before the `{type}` can be split into directories on the hyphens
+  - When using this format, the filenames must be [Location-Encoding Filenames](#location-encoding-filenames) or `setup.php`
+  - This is only available in extensions v2 and up
 
 #### Notes
 - In order to have a directory be treated as `extensions`, the config **must** include `directoryLayout: 'extensions'`

package/build/plugins/EnhancedBlockJSONPlugin.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnhancedBlockJSONPlugin = void 0;
 const node_crypto_1 = __importDefault(require("node:crypto"));
-const promises_1 = __importDefault(require("node:fs/promises"));
+const promises_1 = require("node:fs/promises");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const AbstractBiPhasicGroupAndEntryPlugin_1 = require("./AbstractBiPhasicGroupAndEntryPlugin");
@@ -37,8 +37,7 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
             if (asset) {
                 const epBlockJson = entrypoint.name + ".json";
                 if (!applicableBlockJsonFiles[epBlockJson]) {
-                    const blockJsonText = EnhancedBlockJSONPlugin.extractAssetSource(compilation, epBlockJson)
-                        ?? await promises_1.default.readFile(srcPath, 'utf-8');
+                    const blockJsonText = EnhancedBlockJSONPlugin.extractAssetSource(compilation, epBlockJson) ?? await (0, promises_1.readFile)(srcPath, 'utf-8');
                     if (!blockJsonText) {
                         compilation.errors.push((0, shared_1.newWebpackErrorForFile)(`Unable to extract the source for ${epBlockJson}`, srcPath));
                         continue;
@@ -66,10 +65,8 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                     .map(file => [file, (0, shared_1.scriptOrStyleTest)(file, shared_1.scriptExtension)])
                     .filter((item) => item[1] !== '')
                     .map(([file, assetType]) => {
-                    const pathQueryParameters = metadata.pathQueryParameters !== undefined || this.dest.pathQueryParameters !== undefined
-                        ? { ...metadata.pathQueryParameters, ...this.dest.pathQueryParameters }
-                        : undefined;
-                    const { scriptArgsObject, inlinedAsset } = (0, path_query_and_related_helpers_1.parseScriptArgsObjectFromPathQueryParameters)(compilation, file, pathQueryParameters);
+                    const enqueuingFlags = (0, path_query_and_related_helpers_1.mergeTwoScriptEnqueuingControlFlagSets)(file, metadata.enqueuingFlags, this.dest.enqueuingFlags);
+                    const { scriptArgsObject, inlinedAsset } = (0, path_query_and_related_helpers_1.convertEnqueuingControlFlagsToScriptArgsObject)(compilation, file, enqueuingFlags);
                     const wasOriginallyAStyleField = (0, shared_1.isStyleField)(metadata.entrypointField);
                     const outputPath = this.stripOffBlocksDestPrefix(file);
                     if (wasOriginallyAStyleField !== (assetType === "style")) { // This means that the file is extracted

package/build/plugins/ExtensionsConfigFileGeneratorPlugin.d.ts

@@ -1,15 +1,19 @@
 import { AbstractBiPhasicGroupAndEntryPlugin, EntryProvider } from "./AbstractBiPhasicGroupAndEntryPlugin";
-import { ParsedAssetJsonProvider, VerifiedAdvancedOutputConfig } from "../shared";
+import { MinimumViableMetadata, ParsedAssetJsonProvider, VerifiedAdvancedOutputConfig } from "../shared";
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
 import { Compilation, type Compiler } from "webpack";
-export declare class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryPlugin {
+export type ExtensionConfigFileGeneratorMetadata = MinimumViableMetadata & {
+    extensionId: string;
+};
+export declare class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryPlugin<ExtensionConfigFileGeneratorMetadata> {
     private readonly extensionsSrcPath;
     private readonly dest;
     private static readonly semaphore;
     private setupFiles;
-    constructor(config: VerifiedPlauditWordpressWebpackConfig, extensionsSrcPath: string, dest: VerifiedAdvancedOutputConfig, context: string, entry: EntryProvider);
+    constructor(config: VerifiedPlauditWordpressWebpackConfig, extensionsSrcPath: string, dest: VerifiedAdvancedOutputConfig, context: string, entry: EntryProvider<ExtensionConfigFileGeneratorMetadata>);
     get extensionsDestPath(): string;
     apply(compiler: Compiler): void;
+    private walkSubtreeForMetaInfo;
     private generateVersionThreeConfigFile;
     protected attachUniquePhase(compilation: Compilation): void;
     protected processAssets(compilation: Compilation, parsedAssetJsonProvider: ParsedAssetJsonProvider): void;

package/build/plugins/ExtensionsConfigFileGeneratorPlugin.js

@@ -1,11 +1,41 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExtensionsConfigFileGeneratorPlugin = void 0;
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importStar(require("node:path"));
 const php_writer_1 = require("@plaudit/php-writer");
 const expressions_1 = require("@plaudit/php-writer/expressions");
 const AbstractBiPhasicGroupAndEntryPlugin_1 = require("./AbstractBiPhasicGroupAndEntryPlugin");
@@ -34,24 +64,49 @@ class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryP
                 compilation.contextDependencies.add(this.extensionsSrcPath);
             }
             const emissionPromises = [];
-            for await (const { name: setupFilePath } of await promises_1.default.opendir(this.extensionsSrcPath, { encoding: 'utf-8' })) {
+            for await (const { name: setupFilePath } of await (0, promises_1.opendir)(this.extensionsSrcPath, { encoding: 'utf-8' })) {
                 if (setupFilePath.endsWith("-setup.php")) {
                     const setupFileSourcePath = node_path_1.default.join(this.extensionsSrcPath, setupFilePath);
                     compilation.fileDependencies.add(setupFileSourcePath);
-                    emissionPromises.push(promises_1.default.readFile(setupFileSourcePath).then(contents => {
+                    emissionPromises.push((0, promises_1.readFile)(setupFileSourcePath).then(contents => {
                         compilation.emitAsset(node_path_1.default.join(this.dest.destination, setupFilePath), new webpack_1.sources.RawSource(contents), { size: Buffer.byteLength(contents) });
                         const blockSlug = /^(.+?)-setup.php$/i.exec(setupFilePath)?.[1];
                         return [blockSlug, setupFilePath];
                     }));
                 }
             }
+            await this.walkSubtreeForMetaInfo(compilation, this.extensionsSrcPath, this.dest, [], emissionPromises);
             this.setupFiles = (await Promise.all(emissionPromises))
                 .filter((item) => item[0] !== undefined).sort((a, b) => a[0].localeCompare(b[0]));
         });
     }
+    async walkSubtreeForMetaInfo(compilation, srcRoot, dest, parents, emissionPromises) {
+        if (!compilation.contextDependencies.has(srcRoot)) {
+            compilation.contextDependencies.add(srcRoot);
+        }
+        for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
+            if (dirent.name.startsWith("~")) {
+                continue;
+            }
+            if (dirent.isFile()) {
+                if (dirent.name === "setup.php") {
+                    const setupFilePath = (0, node_path_1.join)(...parents, dirent.name);
+                    const setupFileSourcePath = node_path_1.default.join(this.extensionsSrcPath, setupFilePath);
+                    compilation.fileDependencies.add(setupFileSourcePath);
+                    emissionPromises.push((0, promises_1.readFile)(setupFileSourcePath).then(contents => {
+                        compilation.emitAsset(node_path_1.default.join(this.dest.destination, setupFilePath), new webpack_1.sources.RawSource(contents), { size: Buffer.byteLength(contents) });
+                        return [parents.join("-") /* blockSlug */, setupFilePath];
+                    }));
+                }
+            }
+            else if (dirent.isDirectory()) {
+                await this.walkSubtreeForMetaInfo(compilation, (0, node_path_1.join)(srcRoot, dirent.name), dest, [...parents, dirent.name], emissionPromises);
+            }
+        }
+    }
     generateVersionThreeConfigFile(compilation, relevantAssetData, setupFilePaths) {
         const handlePrefix = `${this.config.targetHandlePrefix}_block-extensions`;
-        const regex = /^(.+?)-((?:editor-|view-|)(?:style|script|script-module))\.(?:css|m?js)$/i;
+        const regex = /^(.+?)-((?:editor-|view-|)(?:style|script|script-module))$/i;
         const blockExtensionsConfig = {
             metadata: { version: this.config.extensionsVersion }, scriptHandles: {}, scriptModuleHandles: {}, styleHandles: {}, blocks: {}, setupFiles: {}
         };
@@ -62,7 +117,7 @@ class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryP
             return [assetPath, entry[1]];
         });
         for (const [assetPath, assetData] of normalizedAssetData) {
-            const match = regex.exec(assetPath);
+            const match = regex.exec(assetData.extensionId);
             if (!match) {
                 continue;
             }
@@ -127,7 +182,16 @@ class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryP
         });
     }
     processAssets(compilation, parsedAssetJsonProvider) {
-        const relevantAssetData = this.extractRelevantAssetData(compilation, parsedAssetJsonProvider);
+        const relevantAssetData = Object.fromEntries(this.getRelevantEntrypoints(compilation)
+            .map(({ entrypoint, metadata, srcPath }) => {
+            const providedData = parsedAssetJsonProvider(entrypoint, metadata);
+            if (providedData === undefined) {
+                compilation.errors.push((0, shared_1.newWebpackErrorForFile)(`assets.json did not contain information for ${srcPath}`, srcPath));
+                return undefined;
+            }
+            return [providedData.assetName, { ...providedData.assetData, extensionId: metadata.extensionId }];
+        })
+            .filter(item => item !== undefined));
         const staticallyLoadedEntrypoints = Object.keys(relevantAssetData);
         const generateLoader = (writer) => {
             writer.require(this.extensionsDestPath + "extensions-loader.php", { dirRelative: true, once: true });

package/build/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -302,7 +302,8 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 const isScript = type !== 'style';
                 const dependencies = isScript === entrypointChunkIsScript ? assetData.dependencies : [];
                 const { lazyLoader, locations } = this.dest;
-                const { inlinedAsset, scriptArgsObject } = (0, path_query_and_related_helpers_1.parseScriptArgsObjectFromPathQueryParameters)(compilation, file, (0, path_query_and_related_helpers_1.mergeInPathQueryParameters)(file, locations.registerScriptArgs, this.dest.pathQueryParameters));
+                const { flags } = (0, path_query_and_related_helpers_1.unpackEnqueuingControlFlagsFromPathQueryParameters)(typeof locations.registerScriptArgs === 'object' ? locations.registerScriptArgs : { strategy: locations.registerScriptArgs }, file, "registerScriptArgs");
+                const { inlinedAsset, scriptArgsObject } = (0, path_query_and_related_helpers_1.convertEnqueuingControlFlagsToScriptArgsObject)(compilation, file, (0, path_query_and_related_helpers_1.mergeTwoScriptEnqueuingControlFlagSets)(file, flags, this.dest.enqueuingFlags));
                 const rest = isScript && scriptArgsObject !== undefined ? [dependencies, assetData.version, scriptArgsObject] : [dependencies, assetData.version];
                 const destPath = node_path_1.default.join(compilation.outputOptions.path, file);
                 handles.push({