@plaudit/webpack-extensions 2.83.1 → 2.84.0

package/CHANGELOG.md

@@ -5,6 +5,10 @@ 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.84.0] - 2026-01-30
+### Added
+- Support for using `lazyLoader` on plain entrypoints
+
 ## [2.83.1] - 2026-01-27
 ### Fixed
 - An issue wherein the theme-level styles would pollute the editor's UI styles

package/build/plugins/PlainEntrypointsConfigFileGeneratorPlugin.d.ts

@@ -1,14 +1,14 @@
-import { BlockEntrypointInfo, ParsedAssetJsonProvider, NormalizedUsageLocations } from "../shared";
+import { BlockEntrypointInfo, ParsedAssetJsonProvider, VerifiedAdvancedOutputConfig } from "../shared";
 import type { VerifiedPlauditWordpressWebpackConfig } from "../utils/common-config-helpers";
 import { AbstractBiPhasicGroupAndEntryPlugin, EntryProvider } from "./AbstractBiPhasicGroupAndEntryPlugin";
 import { Compilation } from "webpack";
 export declare class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryPlugin<BlockEntrypointInfo> {
     private readonly buildRoot;
     private readonly outputDir;
-    private readonly usageLocations;
+    private readonly dest;
     private readonly useUnifiedLoader;
     private static readonly semaphore;
-    constructor(config: VerifiedPlauditWordpressWebpackConfig, buildRoot: string, outputDir: string, usageLocations: NormalizedUsageLocations, useUnifiedLoader: boolean, context: string, entry: EntryProvider<BlockEntrypointInfo>);
+    constructor(config: VerifiedPlauditWordpressWebpackConfig, buildRoot: string, outputDir: string, dest: VerifiedAdvancedOutputConfig, useUnifiedLoader: boolean, context: string, entry: EntryProvider<BlockEntrypointInfo>);
     private generatePlainEntrypointsLoader;
     private static addHandlesToHandleLists;
     private static appendEnqueuingHandleLists;

package/build/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -15,14 +15,14 @@ const webpack_1 = require("webpack");
 class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAndEntryPlugin_1.AbstractBiPhasicGroupAndEntryPlugin {
     buildRoot;
     outputDir;
-    usageLocations;
+    dest;
     useUnifiedLoader;
     static semaphore = new pseduo_semaphore_1.PseudoSemaphore("Plain");
-    constructor(config, buildRoot, outputDir, usageLocations, useUnifiedLoader, context, entry) {
+    constructor(config, buildRoot, outputDir, dest, useUnifiedLoader, context, entry) {
         super(config, "plain-entrypoints-v2", [PlainEntrypointsConfigFileGeneratorPlugin.semaphore, UnifiedLoaderGenerator_1.UnifiedLoaderGenerator.semaphore], context, entry);
         this.buildRoot = buildRoot;
         this.outputDir = outputDir;
-        this.usageLocations = usageLocations;
+        this.dest = dest;
         this.useUnifiedLoader = useUnifiedLoader;
     }
     generatePlainEntrypointsLoader(compilation, assets) {
@@ -41,7 +41,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 .map(handle => [handle.handleName, handle.src]))]));
         const plainEntrypointsConfig = { scriptHandles: {}, script_moduleHandles: {}, styleHandles: {} };
         for (const { handles, handlePrefix } of assets) {
-            for (const { src, rest, locations, type, handleName } of handles) {
+            for (const { src, rest, locations, type, handleName, lazyLoader } of handles) {
                 const basename = node_path_1.default.basename(src).replace(/_(?:script(?:-\d+)?\.js|style(?:-\d+)?\.css)$|(?<!_(script|style))\.(js|css)$/, "");
                 let finalHandleName;
                 if (typeof handleName === 'string') {
@@ -55,12 +55,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                     }
                     handleNameMap[finalHandleName] = src;
                 }
-                plainEntrypointsConfig[`${type}Handles`][finalHandleName] = {
-                    src,
-                    rest,
-                    locations,
-                    type
-                };
+                plainEntrypointsConfig[`${type}Handles`][finalHandleName] = { src, rest, locations, type, lazyLoader };
             }
         }
         PlainEntrypointsConfigFileGeneratorPlugin.addHandlesToHandleLists('script', Object.entries(plainEntrypointsConfig.scriptHandles)
@@ -105,6 +100,25 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 writer.call("add_editor_style", [(0, shared_1.leadingSlashIt)(handlePath)]);
             }
         }
+        const lazyLoadedHandles = Object.values(handleLists)
+            .flatMap(handleList => handleList.map(handle => [handle.data.lazyLoader, handle]))
+            .filter((entry) => entry[0] !== undefined)
+            .sort((a, b) => a[0].localeCompare(b[0]) || a[1].priority - b[1].priority);
+        if (lazyLoadedHandles.length > 0) {
+            writer.linebreak();
+            const groupedLazyLoadedHandles = Object.entries(lazyLoadedHandles
+                .reduce((a, b) => {
+                (a[b[0]] ??= []).push(b[1]);
+                return a;
+            }, {}));
+            for (const [lazyLoader, handles] of groupedLazyLoadedHandles) {
+                writer.function(lazyLoader, [], 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");
     }
     static addHandlesToHandleLists(type, handles, handleLists) {
@@ -151,11 +165,12 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 else {
                     continue;
                 }
-                handleLists[location].push({ handle, type, priority, hook_name });
+                handleLists[location].push({ data, handle, type, priority, hook_name });
             }
         }
     }
     static appendEnqueuingHandleLists(writer, handleLists) {
+        const lazyLoadableHandles = {};
         for (const [sln, { action, supports_hook_name, additional_action_code }] of (0, shared_1.constantEntries)(shared_1.standardLocationNamesMeta)) {
             const handleList = handleLists[sln];
             if (handleList.length > 0) {
@@ -189,6 +204,7 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 }
             }
         }
+        return lazyLoadableHandles;
     }
     static separateHandleListByPriority(handleItems) {
         const lists = new Map();
@@ -261,13 +277,14 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
                 const type = extension === ".js" ? 'script' : (extension === ".mjs" ? 'script_module' : 'style');
                 const isScript = type !== 'style';
                 const dependencies = isScript === entrypointChunkIsScript ? assetData.dependencies : [];
-                const rest = isScript && this.usageLocations.registerScriptArgs !== undefined
-                    ? [dependencies, assetData.version, this.usageLocations.registerScriptArgs] : [dependencies, assetData.version];
+                const { registerScriptArgs } = this.dest.locations;
+                const rest = isScript && registerScriptArgs !== undefined ? [dependencies, assetData.version, registerScriptArgs] : [dependencies, assetData.version];
                 const destPath = node_path_1.default.join(compilation.outputOptions.path, file);
                 handles.push({
                     src: destPath, rest, type,
-                    locations: this.usageLocations,
-                    handleName: useHandleName ? this.usageLocations.handle : undefined,
+                    locations: this.dest.locations,
+                    handleName: useHandleName ? this.dest.locations.handle : undefined,
+                    lazyLoader: this.dest.lazyLoader
                 });
             }
             myAssetHandles.push({ handles, handlePrefix: this.config.targetHandlePrefix });

package/build/wordpress-scripts-wrapper.js

@@ -548,7 +548,7 @@ function processIndividualWebpackConfig(config, webpackConfig, sources, canClean
                     const entry = srcIsDirectory // This being true implies that srcRoot is not an array
                         ? (0, common_config_helpers_1.resolveEntryFromDirectory)(commonConfig, srcRoot, dest)
                         : () => ({ [baseDest]: { import: Array.isArray(srcRoot) ? srcRoot : [srcRoot], plauditMetadata: { purpose: "plain-entrypoint", dest, absoluteSrc } } });
-                    plugin = new PlainEntrypointsConfigFileGeneratorPlugin_1.PlainEntrypointsConfigFileGeneratorPlugin(config, process.cwd(), config.outputDir, dest.locations, config.useUnifiedLoader, contextPath, entry);
+                    plugin = new PlainEntrypointsConfigFileGeneratorPlugin_1.PlainEntrypointsConfigFileGeneratorPlugin(config, process.cwd(), config.outputDir, dest, config.useUnifiedLoader, contextPath, entry);
                 }
                 else {
                     if (srcIsDirectory) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaudit/webpack-extensions",
-  "version": "2.83.1",
+  "version": "2.84.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "/build",
@@ -25,7 +25,7 @@
   "devDependencies": {
     "@plaudit/gutenberg-api-extensions": "^2.84.3",
     "@types/browser-sync-webpack-plugin": "^2.2.5",
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.1.0",
     "@types/postcss-functions": "^4.0.4",
     "@types/tapable": "^2.3.0",
     "@types/webpack": "^5.28.5",
@@ -42,9 +42,9 @@
     "@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.38.0",
-    "@wordpress/scripts": "^31.3.0",
-    "autoprefixer": "^10.4.23",
+    "@wordpress/dependency-extraction-webpack-plugin": "^6.39.0",
+    "@wordpress/scripts": "^31.4.0",
+    "autoprefixer": "^10.4.24",
     "browser-sync": "^3.0.4",
     "copy-webpack-plugin": "10.2.4",
     "css-minimizer-webpack-plugin": "^6.0.0",