@plaudit/webpack-extensions 3.15.0 → 3.16.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.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
+  - This is done to allow us to include example files
+  - This comes from version `2.95.0`
+- Updated the user guide with this information
+  - This comes from version `2.95.0`
+
+### Fixed
+- The TOC in the user guide being out of date
+
+## [3.15.1] - 2026-07-20
+### Fixed
+- A bug that caused all styles bound for editor use to be emitted as inline CSS
+  - This comes from version `2.94.1`
+
 ## [3.15.0] - 2026-07-17
 ### Changed
 - The `add_editor_style()` enqueue path to use `block_editor_settings_all` to avoid a litany of bugs courtesy of WordPress's high-quality code
@@ -214,6 +230,16 @@ 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.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
+  - This is done to allow us to include example files
+- Updated the user guide with this information
+
+## [2.94.1] - 2026-07-20
+### Fixed
+- A bug that caused all styles bound for editor use to be emitted as inline CSS
+
 ## [2.94.0] - 2026-07-17
 ### Changed
 - The `add_editor_style()` enqueue path to use `block_editor_settings_all` to avoid a litany of bugs courtesy of WordPress's high-quality code

package/USER-GUIDE.md

@@ -8,6 +8,7 @@
     * [Examples](#examples)
   * [Best Practices](#best-practices)
     * [Folder Structure](#folder-structure)
+    * [Enforced Naming Conventions](#enforced-naming-conventions)
     * [Blocks](#blocks)
     * [Extensions](#extensions)
     * [Plain Assets](#plain-assets)
@@ -104,7 +105,7 @@ However, if you need to do something unusual or just want to know what everythin
 - Any time that `dist` is referenced in a path, it should be replaced with the value of `outputDir` in your WebPack file
   - As with `src`, the value of `outputDir` *should be* `dist`; however, this might not be the case in some inherited or older code
 - Keys in the `src` *object* are all assumed to be paths relative to `srcDir` if it is specified or the folder in which the `webpack.config.js` file is located if it is not specified
-- Paths in values in the `src` *object* are all assumed to be paths relative to `outputDir` if it is specified or the folder in which the `webpack.config.js` file is located if it is not specified
+- Paths in *values* in the `src` object are all assumed to be paths relative to `outputDir` if it is specified or the folder in which the `webpack.config.js` file is located if it is not specified
 - 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
@@ -117,6 +118,10 @@ However, if you need to do something unusual or just want to know what everythin
 - All folder and file names should be in kebab-case
 - Assets *should not* be in the root of the `src` folder. Assets that aren't block- or extension-bound should be in the `site` folder (or in a folder named after where they'll be used like, `admin` or `map-page`)
 
+### Enforced Naming Conventions
+- Directory and file names that start with a "~" are interpreted as "backup code" and are, therefore, not built.
+- File and directory names that are equal to "example" or "examples", or have "example" as a name segment (see [Location-Encoding Filenames](#location-encoding-filenames) for details on what a name-segment is) are treated as example code and are also not built
+
 ### Blocks
 - Block folder names *should* match the local portion of their name (ex: `plaudit-query-loop-maps/address-wrapper` should be stored in `address-wrapper`)
 
@@ -354,16 +359,17 @@ Notes on how to read the following table:
 - `(-|=)` 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)                                 |
+| 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)                                 |
+| Example Code Marker | `example`                                                   | This informs the build system that the file contains example code and, therefore, should not be build                                                    |
 
 ### Enqueuing Location
 If this is the first token, it can be suffixed with `-script`, `-style`, or `-script-module` to override the type.

package/dist/plugins/EnhancedBlockJSONPlugin.d.ts

@@ -1,15 +1,17 @@
 import { Compilation } from "webpack";
 import type WebpackRemoveEmptyScriptsPlugin from "webpack-remove-empty-scripts";
 import { AbstractBiPhasicGroupAndEntryPlugin, EntryProvider } from "./AbstractBiPhasicGroupAndEntryPlugin";
-import { BlockEntrypointInfo, FileSegmentBlockEntrypointInfo, InlinedAsset, ParsedAssetJsonProvider, ParsedAssetsJson, ScriptArgsObject, VerifiedAdvancedOutputConfig } from "../shared";
+import { AssetMetaSegment, BlockEntrypointInfo, FileSegmentBlockEntrypointInfo, ParsedAssetJsonProvider, ParsedAssetsJson, ScriptArgsObject, VerifiedAdvancedOutputConfig } from "../shared";
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
 type WorkableBlockEntrypointInfo = Omit<FileSegmentBlockEntrypointInfo, 'originalValue' | 'pathQueryParameters'> & Partial<Pick<FileSegmentBlockEntrypointInfo, 'originalValue'>> & {
     outputPath: string;
     assetData: ParsedAssetsJson[string];
     hash: string;
     scriptArgsObject: ScriptArgsObject | undefined;
-    inlinedAsset: InlinedAsset | undefined;
-};
+} & (AssetMetaSegment | {
+    inlinedAsset?: undefined;
+    assetContents?: string;
+});
 type CollatedWorkableBlockInfo = Record<string, {
     sourcePath?: string;
     workableBlockEntrypointsInfo: WorkableBlockEntrypointInfo[];

package/dist/plugins/EnhancedBlockJSONPlugin.js

@@ -65,8 +65,8 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                     .filter((item) => item[1] !== '')
                     .map(([file, assetType]) => {
                     const enqueuingFlags = (0, path_query_and_related_helpers_1.mergeTwoEnqueuingControlFlagSets)(file, metadata.enqueuingFlags, this.dest.enqueuingFlags);
-                    const { scriptArgsObject, inlinedAsset } = (0, path_query_and_related_helpers_1.convertEnqueuingControlFlagsToScriptArgsObject)(compilation, file, enqueuingFlags);
-                    if (inlinedAsset !== undefined) {
+                    const { scriptArgsObject, assetMeta } = (0, path_query_and_related_helpers_1.convertEnqueuingControlFlagsToScriptArgsObject)(compilation, file, enqueuingFlags);
+                    if (assetMeta?.inlinedAsset !== undefined) {
                         staticallyLoadedEntrypoints.push(file);
                     }
                     const wasOriginallyAStyleField = (0, shared_1.isStyleField)(metadata.entrypointField);
@@ -75,10 +75,10 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                         const entrypointField = (0, shared_1.convertEntrypointFieldForAssetType)(metadata.entrypointField, assetType);
                         return {
                             ...metadata, outputPath, assetData, originalValue: undefined, hash: entrypointChunk.hash ?? "",
-                            entrypointField, handleGroup: (0, shared_1.getHandleGroup)(entrypointField), scriptArgsObject, inlinedAsset
+                            entrypointField, handleGroup: (0, shared_1.getHandleGroup)(entrypointField), scriptArgsObject, ...assetMeta
                         };
                     }
-                    return { ...metadata, outputPath, assetData, hash: entrypointChunk.hash ?? "", scriptArgsObject, inlinedAsset };
+                    return { ...metadata, outputPath, assetData, hash: entrypointChunk.hash ?? "", scriptArgsObject, ...assetMeta };
                 });
                 if (applicableBlockJsonFiles[epBlockJson]) {
                     applicableBlockJsonFiles[epBlockJson].workableBlockEntrypointsInfo.push(...workableBlockEntrypointsInfo);
@@ -127,7 +127,7 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                     const { inlinedAsset, ...finalizedHandle } = handleData;
                     if (inlinedAsset !== undefined) {
                         finalizedHandle.src = false;
-                        inlinedAssets.push([handle, type, inlinedAsset, handleData, handleData.src]);
+                        inlinedAssets.push([handle, type, handleData]);
                     }
                     registerableHandles[handle] = finalizedHandle;
                 }
@@ -327,7 +327,10 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                     .convertToScriptHandles(handleData.filter(hd => !(0, shared_1.isStyleField)(hd.entrypointField) && (0, shared_1.isScriptModuleField)(hd.entrypointField)))),
                 styleHandles: Object.fromEntries(handleData.filter(hd => (0, shared_1.isStyleField)(hd.entrypointField))
                     .map(hd => {
-                    return [hd.handle, { src: hd.outputPath, rest: [hd.originalValue !== undefined ? hd.assetData.dependencies : [], hd.assetData.version], inlinedAsset: hd.inlinedAsset }];
+                    if (hd.inlinedAsset === undefined) {
+                        return [hd.handle, { src: hd.outputPath, rest: [hd.originalValue !== undefined ? hd.assetData.dependencies : [], hd.assetData.version], assetContents: hd.assetContents }];
+                    }
+                    return [hd.handle, { src: hd.outputPath, rest: [hd.originalValue !== undefined ? hd.assetData.dependencies : [], hd.assetData.version], inlinedAsset: hd.inlinedAsset, assetContents: hd.assetContents }];
                 })),
                 bindableBlockAttributes
             },
@@ -340,7 +343,7 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
     }
     static convertToScriptHandles(handleData) {
         return handleData.map(hd => {
-            const { inlinedAsset, originalValue, outputPath, entrypointField, scriptArgsObject: rawScriptArgsObject, assetData, handle } = hd;
+            const { assetContents, inlinedAsset, originalValue, outputPath, entrypointField, scriptArgsObject: rawScriptArgsObject, assetData, handle } = hd;
             const { dependencies = [], module_dependencies = undefined } = originalValue !== undefined ? assetData : {};
             let scriptArgsObject;
             if (rawScriptArgsObject !== undefined) {
@@ -366,7 +369,13 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
                     }
                 }
             }
-            return [handle, { src: outputPath, rest: scriptArgsObject !== undefined ? [dependencies, assetData.version, scriptArgsObject] : [dependencies, assetData.version], inlinedAsset }];
+            const rest = scriptArgsObject !== undefined ? [dependencies, assetData.version, scriptArgsObject] : [dependencies, assetData.version];
+            if (inlinedAsset) {
+                return [handle, { src: outputPath, rest, inlinedAsset, assetContents }];
+            }
+            else {
+                return [handle, { src: outputPath, rest, assetContents }];
+            }
         });
     }
     static doFileOrHandleReplacements(compilation, blockJson, workableBlockEntrypointsInfo, getter) {

package/dist/plugins/ExtensionsConfigFileGeneratorPlugin.js

@@ -52,7 +52,7 @@ class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryP
             compilation.contextDependencies.add(srcRoot);
         }
         for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
-            if (dirent.name.startsWith("~")) {
+            if ((0, shared_1.shouldBeSkipped)(dirent.name)) {
                 continue;
             }
             if (dirent.isFile()) {

package/dist/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -70,13 +70,12 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 writer.action("init", writer => {
                     writer.call("plaudit_webpack_extensions__resolve_base_uri", [expressions_1.Constants.__DIR__], { assignTo: baseUriVar });
                     for (const { handle, type, data } of prioritizedHandleList) {
-                        const { inlinedAsset, rest, src } = data;
-                        const emittedSrc = inlinedAsset === undefined
-                            ? expressions_1.Op.concat(baseUriVar, (0, node_path_1.relative)(emitDir, src))
-                            : false;
-                        writer.call(`wp_register_${type}`, [handle, emittedSrc, ...rest]);
-                        if (inlinedAsset !== undefined) {
-                            (0, shared_1.appendAddInlineAssetCall)(compilation, writer, handle, type, inlinedAsset, data, src);
+                        if (data.inlinedAsset !== undefined) {
+                            writer.call(`wp_register_${type}`, [handle, false, ...data.rest]);
+                            (0, shared_1.appendAddInlineAssetCall)(compilation, writer, handle, type, data);
+                        }
+                        else {
+                            writer.call(`wp_register_${type}`, [handle, expressions_1.Op.concat(baseUriVar, (0, node_path_1.relative)(emitDir, data.src)), ...data.rest]);
                         }
                     }
                 }, { priority, accountForAlreadyDoing: this.config.includePostInitFallback });
@@ -85,10 +84,9 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 writer.action("init", writer => {
                     writer.call("plaudit_webpack_extensions__resolve_base_uri", [expressions_1.Constants.__DIR__], { assignTo: baseUriVar });
                     for (const { handle, type, data } of prioritizedHandleList) {
-                        const { inlinedAsset, rest, src } = data;
-                        writer.call(`wp_register_${type}`, [handle, false, ...rest]);
-                        if (inlinedAsset !== undefined) {
-                            (0, shared_1.appendAddInlineAssetCall)(compilation, writer, handle, type, inlinedAsset, data, src);
+                        writer.call(`wp_register_${type}`, [handle, false, ...data.rest]);
+                        if (data.inlinedAsset !== undefined) {
+                            (0, shared_1.appendAddInlineAssetCall)(compilation, writer, handle, type, data);
                         }
                     }
                 }, { priority, accountForAlreadyDoing: this.config.includePostInitFallback });
@@ -107,7 +105,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
             const editorSettings = new expressions_1.Var("editor_settings");
             writer.filter("block_editor_settings_all", writer => {
                 for (const [handle, data] of sortedEditorStyleHandles) {
-                    const contents = data.inlinedAsset?.contents;
+                    const contents = data.assetContents;
                     if (contents) {
                         writer.appendExpr(new expressions_1.Assignment(new expressions_1.ArrayAccess(editorSettings, "styles"), new expressions_1.PHPArray({ css: (0, shared_1.wrapInlineAssetContents)(compilation, "plaudit_editor_style", handle, contents) }), true));
                     }
@@ -302,7 +300,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 const { dependencies = [], module_dependencies = undefined } = isScript === entrypointChunkIsScript ? assetData : {};
                 const { lazyLoader, locations } = this.dest;
                 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.mergeTwoEnqueuingControlFlagSets)(file, flags, this.dest.enqueuingFlags), type === 'style' && (!!locations.clientEditor || locations.clientEditor === 0));
+                const { assetMeta, scriptArgsObject } = (0, path_query_and_related_helpers_1.convertEnqueuingControlFlagsToScriptArgsObject)(compilation, file, (0, path_query_and_related_helpers_1.mergeTwoEnqueuingControlFlagSets)(file, flags, this.dest.enqueuingFlags), type === 'style' && (!!locations.clientEditor || locations.clientEditor === 0));
                 const completeScriptArgsObject = module_dependencies?.length ? { ...scriptArgsObject, module_dependencies } : scriptArgsObject;
                 const rest = isScript && completeScriptArgsObject !== undefined ? [dependencies, assetData.version, completeScriptArgsObject] : [dependencies, assetData.version];
                 const destPath = (0, node_path_1.join)(compilation.outputOptions.path, file);
@@ -313,7 +311,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                     locations,
                     handleName: useHandleName ? locations.handle : undefined,
                     lazyLoader,
-                    inlinedAsset
+                    ...assetMeta
                 });
             }
             myAssetHandles.push({ handles, handlePrefix: this.config.targetHandlePrefix });

package/dist/shared.d.ts

@@ -15,22 +15,29 @@ export type ParsedAssetsJson = Record<string, {
     module_dependencies?: (string | WPModuleDependency)[];
 }>;
 export declare function isParsedAssetsJson(thing: any): thing is ParsedAssetsJson;
+type BaseRestType = [/* dependencies: */ string[], /* version: */ string];
+export type AssetMetaSegment = {
+    inlinedAsset: InlinedAsset;
+    assetContents: string;
+};
+export type BaseHandleData = {
+    src: string;
+    rest: BaseRestType | [...BaseRestType, ScriptArgsObject];
+};
 export type ScriptArgsObject = {
     strategy?: 'defer' | 'async';
     in_footer?: boolean;
     fetchpriority?: 'auto' | 'low' | 'high';
     module_dependencies?: (string | WPModuleDependency)[];
 };
-type BaseRestType = [/* dependencies: */ string[], /* version: */ string];
 export type InlinedAsset = {
-    contents: string;
     position?: 'before' | 'after';
 };
-export type HandleData = {
-    src: string;
-    rest: BaseRestType | [...BaseRestType, ScriptArgsObject];
-    inlinedAsset?: InlinedAsset;
-};
+export type IAHandleData = BaseHandleData & AssetMetaSegment;
+export type HandleData = BaseHandleData & (AssetMetaSegment | {
+    inlinedAsset?: undefined;
+    assetContents?: string;
+});
 export declare const standardLocationNamesMeta: {
     readonly clientView: {
         readonly action: "wp_enqueue_scripts";
@@ -260,11 +267,9 @@ export declare function resolveLegacyBlockScriptsInFolder(folder: string): strin
  * @param writer
  * @param handle
  * @param type 'script_module' is NOT supported at this time; however, it is *handled* in this function
- * @param inlinedAsset
  * @param handleData
- * @param file something that represents the file that is being inlined (this is purely for error-reporting purposes)
  */
-export declare function appendAddInlineAssetCall(compilation: Compilation, writer: PHPWriter, handle: string, type: 'script' | 'style' | 'script_module', inlinedAsset: InlinedAsset, handleData: HandleData, file: string): void;
+export declare function appendAddInlineAssetCall(compilation: Compilation, writer: PHPWriter, handle: string, type: 'script' | 'style' | 'script_module', handleData: IAHandleData): void;
 export declare function wrapInlineAssetContents(compilation: Compilation, wrapperIdPrefix: string, handle: string, contents: string): HereOrNowDoc;
 export declare function synchronousDirIterator(dirPath: string): Generator<import("node:fs").Dirent<string>, void, unknown>;
 /**
@@ -273,3 +278,7 @@ export declare function synchronousDirIterator(dirPath: string): Generator<impor
  * @link https://dev.to/jdbar
  */
 export declare function instanceOfNodeError<T extends new (...args: any) => Error>(value: unknown, errorType: T): value is InstanceType<T> & NodeJS.ErrnoException;
+/**
+ * This tests if the name starts with a "~", is equal to "example" or "examples", or includes "example" as a name segment
+ */
+export declare function shouldBeSkipped(name: string): boolean;

package/dist/shared.js

@@ -55,6 +55,7 @@ exports.appendAddInlineAssetCall = appendAddInlineAssetCall;
 exports.wrapInlineAssetContents = wrapInlineAssetContents;
 exports.synchronousDirIterator = synchronousDirIterator;
 exports.instanceOfNodeError = instanceOfNodeError;
+exports.shouldBeSkipped = shouldBeSkipped;
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
@@ -390,19 +391,17 @@ function resolveLegacyBlockScriptsInFolder(folder) {
  * @param writer
  * @param handle
  * @param type 'script_module' is NOT supported at this time; however, it is *handled* in this function
- * @param inlinedAsset
  * @param handleData
- * @param file something that represents the file that is being inlined (this is purely for error-reporting purposes)
  */
-function appendAddInlineAssetCall(compilation, writer, handle, type, inlinedAsset, handleData, file) {
+function appendAddInlineAssetCall(compilation, writer, handle, type, handleData) {
     if (type === 'script_module') {
-        throw newWebpackErrorForFile("WordPress does not support inlined script modules", file);
+        throw newWebpackErrorForFile("WordPress does not support inlined script modules", handleData.src);
     }
     if (handleData.rest[0]?.length) { // If there are any dependencies
         compilation.errors.push(newWebpackErrorForFile("Inlined scripts MUST NOT have dependencies. It WILL cause runtime inconsistencies and potentially cause sever performance issues", handleData.src));
     }
-    const args = [handle, wrapInlineAssetContents(compilation, `plaudit_inlined_${type}`, handle, inlinedAsset.contents)];
-    if (type === 'script' && inlinedAsset.position === 'before') {
+    const args = [handle, wrapInlineAssetContents(compilation, `plaudit_inlined_${type}`, handle, handleData.assetContents)];
+    if (type === 'script' && handleData.inlinedAsset.position === 'before') {
         args.push('before');
     }
     writer.call(`wp_add_inline_${type}`, args);
@@ -434,3 +433,9 @@ function* synchronousDirIterator(dirPath) {
 function instanceOfNodeError(value, errorType) {
     return !!value && value instanceof errorType;
 }
+/**
+ * This tests if the name starts with a "~", is equal to "example" or "examples", or includes "example" as a name segment
+ */
+function shouldBeSkipped(name) {
+    return name.startsWith("~") || name === "example" || name === "examples" || name.startsWith("example.") || name.includes(".example.");
+}

package/dist/utils/common-config-helpers.js

@@ -126,7 +126,7 @@ function resolveEntryFromDirectory(commonConfig, srcRoot, dest) {
         const seenExplicitHandles = { scriptHandles: {}, styleHandles: {}, scriptModuleHandles: {} };
         const loadingEntrypoints = [];
         for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
-            if (!dirent.isDirectory() || dirent.name.startsWith("~")) {
+            if (!dirent.isDirectory() || (0, shared_1.shouldBeSkipped)(dirent.name)) {
                 continue;
             }
             const dir = joinPossiblyAbsolutePaths(srcRoot, dirent.name);

package/dist/utils/location-encoding-filename-parser.js

@@ -7,7 +7,7 @@ const node_path_1 = require("node:path");
 const shared_1 = require("../shared");
 function parseLocationEncodingFilename(filename) {
     const { name, ext } = (0, node_path_1.parse)(filename);
-    if (name.startsWith("~")) {
+    if ((0, shared_1.shouldBeSkipped)(name)) {
         return undefined;
     }
     let type = /^\.(?:s[ac]|p?c)ss$/i.test(ext) ? 'style' : /^\.m[jt]sx?/i.test(ext) ? 'script-module' : /^\.[jt]sx?/i.test(ext) ? 'script' : false;

package/dist/utils/path-query-and-related-helpers.d.ts

@@ -55,5 +55,11 @@ export declare function unpackEnqueuingControlFlagsFromPathQueryParameters(pathQ
  */
 export declare function convertEnqueuingControlFlagsToScriptArgsObject(compilation: Compilation, file: string, flags: NormalizedEnqueuingControlFlags | undefined, forceRecordContents?: boolean): {
     scriptArgsObject?: ScriptArgsObject;
-    inlinedAsset?: InlinedAsset;
+    assetMeta?: {
+        inlinedAsset: InlinedAsset;
+        assetContents: string;
+    } | {
+        inlinedAsset?: undefined;
+        assetContents: string | undefined;
+    };
 };

package/dist/utils/path-query-and-related-helpers.js

@@ -196,11 +196,15 @@ function unpackEnqueuingControlFlagsFromPathQueryParameters(pathQueryParameters,
  */
 function convertEnqueuingControlFlagsToScriptArgsObject(compilation, file, flags, forceRecordContents = false) {
     if (flags === undefined) {
+        if (forceRecordContents) {
+            return { assetMeta: { assetContents: getAssetFileContents(compilation, file) } };
+        }
         return {};
     }
     const { strategy, in_footer, inline, position, fetchpriority } = flags;
     const scriptArgsObject = {};
     let inlinedAsset = undefined;
+    let assetContents = undefined;
     switch (strategy) {
         case 'async':
         case 'defer':
@@ -231,7 +235,8 @@ function convertEnqueuingControlFlagsToScriptArgsObject(compilation, file, flags
         scriptArgsObject.in_footer = in_footer;
     }
     if (inline) {
-        inlinedAsset = { contents: getAssetFileContents(compilation, file) };
+        inlinedAsset = {};
+        assetContents = getAssetFileContents(compilation, file);
         removeFileAndAssetPHP(compilation, file);
         if (position !== undefined) {
             if (!isValidPositionForInlineStrategy(position)) {
@@ -247,7 +252,7 @@ function convertEnqueuingControlFlagsToScriptArgsObject(compilation, file, flags
         }
     }
     else if (forceRecordContents) {
-        inlinedAsset = { contents: getAssetFileContents(compilation, file) };
+        assetContents = getAssetFileContents(compilation, file);
     }
     if (fetchpriority !== undefined) {
         if (!isValidFetchPriority(fetchpriority)) {
@@ -258,7 +263,8 @@ function convertEnqueuingControlFlagsToScriptArgsObject(compilation, file, flags
         }
         scriptArgsObject.fetchpriority = fetchpriority;
     }
-    return Object.keys(scriptArgsObject).length > 0 ? { scriptArgsObject, inlinedAsset } : { inlinedAsset };
+    const assetMeta = inlinedAsset ? { inlinedAsset, assetContents: assetContents } : { assetContents };
+    return Object.keys(scriptArgsObject).length > 0 ? { scriptArgsObject, assetMeta } : { assetMeta };
 }
 function removeFileAndAssetPHP(compilation, file) {
     const pathParts = (0, node_path_1.parse)(file);

package/dist/wordpress-scripts-wrapper.js

@@ -511,7 +511,7 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
                 const entry = async () => {
                     const rawEntrypoints = [];
                     for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
-                        if (dirent.name.startsWith("~")) {
+                        if ((0, shared_1.shouldBeSkipped)(dirent.name)) {
                             continue;
                         }
                         if (dirent.isFile()) {
@@ -579,7 +579,7 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
 async function walkExtensionsTree(srcRoot, dest, applicableExtensionTest, parents) {
     const res = [];
     for await (const dirent of await (0, promises_1.opendir)(srcRoot)) {
-        if (dirent.name.startsWith("~")) {
+        if ((0, shared_1.shouldBeSkipped)(dirent.name)) {
             continue;
         }
         if (dirent.isFile()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaudit/webpack-extensions",
-  "version": "3.15.0",
+  "version": "3.16.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "/dist",
@@ -57,7 +57,7 @@
     "http-proxy-middleware": "^3.0.7",
     "jsdom": "^29.1.1",
     "json2php": "0.0.12",
-    "postcss": "^8.5.19",
+    "postcss": "^8.5.20",
     "postcss-calc": "^10.1.1",
     "postcss-functions": "^4.0.2",
     "postcss-import": "^16.1.1",