@plaudit/webpack-extensions 3.9.4 → 3.10.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.10.0] - 2026-06-15
+### Added
+- Support for emitting namespaced code
+
+### Changed
+- All emitted lazyLoaders to be namespaced
+  - This is *technically* a breaking change; however, it's used in a total of three plugins, so I'm just going to update them manually
+
+## [3.9.5] - 2026-06-11
+### Added
+- Text to the `Error` instances thrown in `pseudo-semaphore.ts`
+
 ## [3.9.4] - 2026-06-10
 ### Fixed
 - Libraries externalizing in a way that does not account for the variable potentially being undeclared

package/dist/plugins/EnhancedBlockJSONPlugin.js

@@ -99,7 +99,7 @@ class EnhancedBlockJSONPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.Abst
         const lazyLoader = this.dest.lazyLoader;
         if (lazyLoader) {
             try {
-                action = writer => writer.function(lazyLoader, [], generateLoader, { returnType: 'void' });
+                action = writer => writer.function(new expressions_1.NamespacedReference(this.config.targetNamespace, lazyLoader, 'function'), [], generateLoader, { returnType: 'void' });
             }
             catch (e) {
                 compilation.errors.push((0, shared_1.newWebpackErrorForFile)(["An error occurred while emitting a function for lazily loading blocks", { cause: e }], this.dest.destination));

package/dist/plugins/ExtensionsConfigFileGeneratorPlugin.js

@@ -168,7 +168,7 @@ class ExtensionsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryP
         const lazyLoader = this.dest.lazyLoader;
         if (lazyLoader) {
             try {
-                action = writer => writer.function(lazyLoader, [], generateLoader, { returnType: 'void' });
+                action = writer => writer.function(new expressions_1.NamespacedReference(this.config.targetNamespace, lazyLoader, 'function'), [], generateLoader, { returnType: 'void' });
             }
             catch (e) {
                 compilation.errors.push((0, shared_1.newWebpackErrorForFile)(["An error occurred while emitting a function for lazily loading extensions", { cause: e }], this.extensionsSrcPath));

package/dist/plugins/ExtensionsConfigFileGeneratorPluginV1.js

@@ -36,10 +36,9 @@ class ExtensionsConfigFileGeneratorPluginV1 extends AbstractBiPhasicGroupAndEntr
             }
         }
         compilation.emitAsset(node_path_1.default.join(this.extensionsDest, "mapping.config"), new webpack_1.sources.RawSource((0, php_writer_1.phpSerialize)(mapping)));
-        UnifiedLoaderGenerator_1.UnifiedLoaderGenerator.semaphore.resolve(this.id, { group: `extensions-config-v1-${this.extensionsDest}`, requiresBaseURI: false, action: writer => {
-                writer
-                    .use("Plaudit\\Common\\Lib\\GutenbergUtils")
-                    .call("GutenbergUtils::installExtensionsSupport", [expressions_1.Op.concat(expressions_1.Constants.__DIR__, this.extensionsDest)]);
+        UnifiedLoaderGenerator_1.UnifiedLoaderGenerator.semaphore.resolve(this.id, { group: `extensions-config-v1-${this.extensionsDest}`, requiresBaseURI: false, action: file => {
+                file
+                    .call("Plaudit\\Common\\Lib\\GutenbergUtils::installExtensionsSupport", [expressions_1.Op.concat(expressions_1.Constants.__DIR__, this.extensionsDest)]);
             } });
     }
 }

package/dist/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -68,7 +68,8 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
         for (const list of Object.values(handleLists)) {
             list.sort(callItemSorter);
         }
-        const writer = new php_writer_1.PHPWriter();
+        const file = new php_writer_1.PHPFile();
+        const writer = file.getWriter("");
         if (handleLists.register.length > 0) {
             if (!this.useUnifiedLoader) {
                 (0, shared_1.emitResolveBaseUriFunction)(writer);
@@ -130,14 +131,14 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 return a;
             }, {}));
             for (const [lazyLoader, handles] of groupedLazyLoadedHandles) {
-                writer.function(lazyLoader, [], writer => {
+                file.function(new expressions_1.NamespacedReference(this.config.targetNamespace, lazyLoader, 'function'), [], writer => {
                     for (const handle of handles) {
                         writer.call(`wp_enqueue_${handle.type}`, [handle.handle]);
                     }
                 }, { returnType: "void" });
             }
         }
-        (0, shared_1.emitPHPWriterAsAsset)(writer, compilation, "plain-entrypoints-loader.php");
+        (0, shared_1.emitPHPWriterAsAsset)(file, compilation, "plain-entrypoints-loader.php");
     }
     static addHandlesToHandleLists(type, handles, handleLists) {
         const defaultPriority = 10;

package/dist/plugins/SpecialAssetHandlingPlugin.js

@@ -49,7 +49,7 @@ class SpecialAssetHandlingPlugin extends AbstractBiPhasicGroupPlugin_1.AbstractB
                 }
                 SpecialAssetHandlingPlugin.semaphore.resolve(this.id, specialAssetData);
                 UnifiedLoaderGenerator_1.UnifiedLoaderGenerator.semaphore.resolve(this.id, Object.keys(specialAssetData).length > 0
-                    ? { group: 'special-assets', requiresBaseURI: true, action: writer => writer.require("/special-assets.php", { dirRelative: true, once: true }) }
+                    ? { group: 'special-assets', requiresBaseURI: true, action: file => file.require("/special-assets.php", { dirRelative: true, once: true }) }
                     : undefined);
             }
             catch (e) {

package/dist/plugins/UnifiedLoaderGenerator.d.ts

@@ -1,11 +1,11 @@
-import { PHPWriter } from "@plaudit/php-writer";
+import { PHPFile } from "@plaudit/php-writer";
 import { AbstractBiPhasicGroupPlugin } from "./AbstractBiPhasicGroupPlugin";
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
 import { PseudoSemaphore } from "../utils/pseduo-semaphore";
 import { Compilation } from "webpack";
 export type LoaderInfo = {
     group: string;
-    action(writer: PHPWriter): void;
+    action(writer: PHPFile): void;
     requiresBaseURI: boolean;
     staticallyLoadedEntrypoints?: string[];
     priority?: number;

package/dist/plugins/UnifiedLoaderGenerator.js

@@ -90,36 +90,38 @@ class UnifiedLoaderGenerator extends AbstractBiPhasicGroupPlugin_1.AbstractBiPha
             }
             if (this.config.useUnifiedLoader) {
                 compilation.hooks.afterProcessAssets.tap(this.constructor.name, () => {
-                    let writer;
+                    let phpFile;
                     if (compilation.outputOptions.path?.endsWith("-dev")) {
                         compilation['.gitignore' in compilation.assets ? 'updateAsset' : 'emitAsset']('.gitignore', new webpack_1.sources.RawSource('**'), { size: 2 });
                         this.ensureDistExists(compilation.outputOptions.path);
-                        writer = new php_writer_1.PHPWriter();
+                        phpFile = new php_writer_1.PHPFile();
                     }
                     else {
-                        writer = this.withDistDevLoader();
+                        phpFile = this.withDistDevLoader();
                     }
                     if (groupedLoaderInfo.some(wc => wc.requiresBaseURI)) {
-                        (0, shared_1.emitResolveBaseUriFunction)(writer);
+                        (0, shared_1.emitResolveBaseUriFunction)(phpFile);
                     }
                     for (const { action } of groupedLoaderInfo) {
-                        action(writer);
+                        action(phpFile);
                     }
-                    (0, shared_1.emitPHPWriterAsAsset)(writer, compilation, "unified-loader.php");
+                    (0, shared_1.emitPHPWriterAsAsset)(phpFile, compilation, "unified-loader.php");
                 });
             }
         });
     }
     withDistDevLoader() {
         if (this.config.omitDistDev) {
-            return new php_writer_1.PHPWriter();
+            return new php_writer_1.PHPFile();
         }
         const devLoaderPath = expressions_1.Op.concat(expressions_1.Constants.__DIR__, '-dev/unified-loader.php');
-        return new php_writer_1.PHPWriter()
+        const res = new php_writer_1.PHPFile();
+        res.getWriter("")
             .if(expressions_1.Op.binary(expressions_1.Op.binary(expressions_1.Expr.call('wp_get_environment_type', []), ' === ', 'development'), ' && ', expressions_1.Expr.call('file_exists', [devLoaderPath])))
             .require(devLoaderPath, { once: true })
             .append("return;")
             .endIf();
+        return res;
     }
     async ensureDistExists(outputPath) {
         if (outputPath.endsWith("-dev")) {

package/dist/shared.d.ts

@@ -1,4 +1,4 @@
-import { PHPWriter } from "@plaudit/php-writer";
+import { PHPFile, PHPWriter } from "@plaudit/php-writer";
 import type { Options as PostcssFunctionsOptions } from "postcss-functions";
 import { type AssetInfo, type Compilation, type Configuration, type Entrypoint, WebpackError, type Compiler } from "webpack";
 import { SourceType } from "./utils/entrypoint-resolution-logic";
@@ -147,6 +147,7 @@ export type PlauditWordpressWebpackConfig = {
     includePostInitFallback?: boolean;
     omitDistDev?: boolean;
     onlyRunPostCSSOnPCSS?: boolean;
+    targetNamespace?: string;
 };
 export declare function applyStandards(config: PlauditWordpressWebpackConfig): {
     readonly standard?: "2026-03-13";
@@ -173,6 +174,7 @@ export declare function applyStandards(config: PlauditWordpressWebpackConfig): {
     readonly includePostInitFallback?: boolean;
     readonly omitDistDev?: boolean;
     onlyRunPostCSSOnPCSS?: boolean;
+    readonly targetNamespace?: string;
 };
 export declare function resolveStandard(standard: PlauditWordpressWebpackConfig['standard']): {
     readonly useWebpackResourceFiltering: true;
@@ -226,6 +228,7 @@ export type TupleOf<T, N extends number> = N extends N ? number extends N ? T[]
 type _TupleOf<T, N extends number, R extends unknown[]> = R['length'] extends N ? R : _TupleOf<T, N, [T, ...R]>;
 export declare function arrayIsLength<T, N extends number>(arr: T[] | null | undefined, length: N): arr is TupleOf<T, N>;
 export declare function kebabCase(value: string): string;
+export declare function camelCaseForPHPLabels(value: string): string;
 export declare function loadEnvFile(filePath: string): Promise<Record<string, string>>;
 export declare function parseEnvFile(contents: string): Record<string, string>;
 export declare function newCleanWebpackError(error: string | ConstructorParameters<typeof WebpackError>): WebpackError;
@@ -233,7 +236,7 @@ export declare function newWebpackErrorForFile(error: string | ConstructorParame
 /**
  * The primary benefit of emitting a function instead of baking its contents into each function that uses it is that it allows us to avoid recomputing the base uri multiple times
  */
-export declare function emitResolveBaseUriFunction(writer: PHPWriter): void;
+export declare function emitResolveBaseUriFunction(writer: PHPFile | PHPWriter): void;
 export declare function getAssetsJson(compilation: Compilation): ParsedAssetsJson;
 export type ParsedAssetJsonProvider = (entrypoint: Entrypoint, metadata: MinimumViableMetadata) => {
     assetName: string;
@@ -243,7 +246,7 @@ export declare function getParsedAssetsJsonDataForEntrypoint(compilation: Compil
     assetName: string;
     assetData: ParsedAssetsJson[string];
 } | undefined;
-export declare function emitPHPWriterAsAsset(writer: PHPWriter, compilation: Compilation, file: string, assetInfo?: AssetInfo): void;
+export declare function emitPHPWriterAsAsset(writer: PHPWriter | PHPFile, compilation: Compilation, file: string, assetInfo?: AssetInfo): void;
 export declare function dedent(text: TemplateStringsArray): string;
 export declare function resolveLegacyBlockScriptsInFolder(folder: string): string[];
 /**

package/dist/shared.js

@@ -39,6 +39,7 @@ exports.getHandleGroup = getHandleGroup;
 exports.hasAtLeastOneItem = hasAtLeastOneItem;
 exports.arrayIsLength = arrayIsLength;
 exports.kebabCase = kebabCase;
+exports.camelCaseForPHPLabels = camelCaseForPHPLabels;
 exports.loadEnvFile = loadEnvFile;
 exports.parseEnvFile = parseEnvFile;
 exports.newCleanWebpackError = newCleanWebpackError;
@@ -222,6 +223,18 @@ function kebabCase(value) {
     const kebabCaseRegexes = [[/([a-z])([A-Z])/g, "$1-$2"], [/[\s_.\-]+/g, "-"]];
     return kebabCaseRegexes.reduce((str, [pattern, replacement]) => str.replace(pattern, replacement), value).toLowerCase();
 }
+function camelCaseForPHPLabels(value) {
+    return value
+        .replaceAll("/", "\\")
+        .split("\\")
+        .map(part => {
+        part = part
+            .replaceAll(/[^a-zA-Z0-9\x7f-\xff](\w|$)/ig, (_, chr) => typeof chr === 'string' ? chr.toUpperCase() : "")
+            .replaceAll(/\d[a-z]/g, match => match.toUpperCase());
+        return part.length > 1 ? part.substring(0, 1).toUpperCase() + part.substring(1) : part.toUpperCase();
+    })
+        .join("\\");
+}
 async function loadEnvFile(filePath) {
     return (0, promises_1.readFile)(filePath, 'utf-8').then(parseEnvFile, () => ({}));
 }

package/dist/utils/pseduo-semaphore.js

@@ -11,7 +11,7 @@ class PseudoSemaphore {
     }
     register(id) {
         if (this.flags.has(id)) {
-            throw new Error();
+            throw new Error(`A semaphore with an id of "${id}" already exists`);
         }
         this.initializeFlag(id);
         this.resolve(id, undefined);
@@ -45,10 +45,10 @@ class PseudoSemaphore {
     }
     getFlag(id) {
         const flag = this.flags.get(id);
-        if (flag) {
-            return flag;
+        if (flag === undefined) {
+            throw new Error(`A semaphore with an id of "${id}" does not exist`);
         }
-        throw new Error();
+        return flag;
     }
     initializeFlag(id) {
         const controller = {};

package/dist/wordpress-scripts-wrapper.js

@@ -183,7 +183,7 @@ function buildVerifiedConfig(config) {
     let targetHandlePrefix = config.targetHandlePrefix ?? config.plainEntrypointsHandlePrefix ?? "";
     if (plainEntrypointsVersion > 1) {
         if (!targetHandlePrefix) {
-            targetHandlePrefix = deriveDefaultHandlePrefixFromComposerJsonOrThemeName();
+            targetHandlePrefix = deriveDefaultHandlePrefixFromComposerJsonOrThemeName(shared_1.kebabCase);
             if (!targetHandlePrefix) {
                 throw new Error("Plain Entrypoints V2 and higher require either 'targetHandlePrefix' to be set or an adjacent composer.json or style.css file to be present");
             }
@@ -192,6 +192,7 @@ function buildVerifiedConfig(config) {
             throw new Error("Plain Entrypoints V2 and higher require 'outputDir' to be set");
         }
     }
+    const targetNamespace = config.targetNamespace || deriveDefaultHandlePrefixFromComposerJsonOrThemeName(shared_1.camelCaseForPHPLabels, true);
     const { staticEntrypoints, dynamicEntrypoints } = (0, entrypoint_resolution_logic_1.resolveAllConfigLevelEntrypoints)(config);
     const rawSources = [...staticEntrypoints, ...dynamicEntrypoints];
     let variablesFilePath = undefined;
@@ -206,7 +207,7 @@ function buildVerifiedConfig(config) {
     const cfg = {
         currentVariables, postcss, standaloneBlocks, stats, variablesFilePath, verbose, externals, assumeGlobalizedPlauditLibraries, processTranslationConfigs, combineAssetMetadata,
         useWebpackResourceFiltering, outputDir, extensionsVersion, plainEntrypointsVersion, srcDir, srcPrefixes, targetHandlePrefix, useUnifiedLoader, includePostInitFallback, omitDistDev,
-        onlyRunPostCSSOnPCSS
+        onlyRunPostCSSOnPCSS, targetNamespace
     };
     // Destination -> source map
     const allocatedDestinations = {};
@@ -287,7 +288,7 @@ function finalizeEntryDestination(entry, dynamicEffectiveDestinationsWithExpecte
     return [entry[0], { ...entry[1], destination: derivedDestination }];
 }
 let defaultHandlePrefix = undefined;
-function deriveDefaultHandlePrefixFromComposerJsonOrThemeName() {
+function deriveDefaultHandlePrefixFromComposerJsonOrThemeName(stringTransformer, keepPlauditSep = false) {
     if (defaultHandlePrefix !== undefined) {
         return defaultHandlePrefix;
     }
@@ -297,20 +298,20 @@ function deriveDefaultHandlePrefixFromComposerJsonOrThemeName() {
     }
     catch {
         // Then composer.json doesn't exist
-        return deriveDefaultHandlePrefixFromThemeName();
+        return deriveDefaultHandlePrefixFromThemeName(stringTransformer);
     }
     if (typeof composerJson !== 'object' || typeof composerJson.name !== 'string' || !composerJson.name) {
         throw new ReferenceError("targetHandlePrefix was not set and the adjacent composer.json file does not have a valid name in it");
     }
-    return (0, shared_1.kebabCase)(composerJson.name.replace(/plaudit\/plaudit/, 'plaudit'));
+    return stringTransformer(keepPlauditSep ? composerJson.name.replace(/plaudit\/plaudit-/, 'plaudit/') : composerJson.name.replace(/plaudit\/plaudit/, 'plaudit'));
 }
-function deriveDefaultHandlePrefixFromThemeName() {
+function deriveDefaultHandlePrefixFromThemeName(stringTransformer) {
     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");
     }
-    return (0, shared_1.kebabCase)(themeName);
+    return stringTransformer(themeName);
 }
 function withDerivedOutputDir(cfg, sources) {
     const destinations = sources.map(([_, { destination }]) => destination.split(/[\/\\]/g));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaudit/webpack-extensions",
-  "version": "3.9.4",
+  "version": "3.10.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "/dist",
@@ -31,16 +31,18 @@
     "@plaudit/gutenberg-api-extensions": "^2.97.1",
     "@types/browser-sync-webpack-plugin": "^2.2.5",
     "@types/jsdom": "^28.0.3",
-    "@types/node": "^25.9.2",
+    "@types/node": "^25.9.3",
     "@types/postcss-functions": "^4.0.4",
     "@types/postcss-import": "^14.0.3",
     "@types/tapable": "^2.3.0",
     "@types/webpack-sources": "^3.2.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typescript": "^6.0.3",
     "webpack-bundle-analyzer": "^5.3.0"
   },
   "dependencies": {
-    "@plaudit/php-writer": "^1.4.5",
+    "@plaudit/php-writer": "^1.5.0",
     "@plaudit/postcss-color-function": "^5.1.0",
     "@plaudit/postcss-strip-units": "^3.0.0",
     "@plaudit/postcss-variables": "^2.0.1",
@@ -52,7 +54,7 @@
     "css-minimizer-webpack-plugin": "^8.0.0",
     "cssnano": "^7.1.9",
     "fork-ts-checker-webpack-plugin": "^9.1.0",
-    "http-proxy-middleware": "^3.0.6",
+    "http-proxy-middleware": "^3.0.7",
     "jsdom": "^29.1.1",
     "json2php": "^0.0.12",
     "postcss": "^8.5.15",