@plaudit/webpack-extensions 3.11.0-wp.demo → 3.12.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.12.0] - 2026-06-23
+### Added
+- Logic to treat the nice name of a file as the suffix of its handle
+
+### Changed
+- The handle-part-separator for plain entrypoints from `.` to `/`
+
 ## [3.11.0] - 2026-06-22
 ### Added
 - Logic to allow our internal PostCSS plugins to be "optional"

package/dist/plugins/PlainEntrypointsConfigFileGeneratorPlugin.js

@@ -43,15 +43,15 @@ class PlainEntrypointsConfigFileGeneratorPlugin extends AbstractBiPhasicGroupAnd
             for (const { src, rest, locations, type, handleName, lazyLoader, ...otherProps } of handles) {
                 const cleanBasename = (0, node_path_1.basename)(src).replace(/_(?:script(?:-\d+)?\.js|style(?:-\d+)?\.css)$|(?<!_(script|style))\.(js|css)$/, "");
                 let finalHandleName;
-                if (typeof handleName === 'string') {
-                    finalHandleName = (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(handleName, cleanBasename);
+                const handleNameMap = usedHandleNames[type];
+                const baseFinalHandleName = finalHandleName = `${handlePrefix}/${(0, shared_1.convertUsageLocationsHandleToEmittableHandle)((0, shared_1.kebabCase)(cleanBasename), cleanBasename)}`;
+                for (let count = 0; finalHandleName in handleNameMap && handleNameMap[finalHandleName] !== src;) {
+                    finalHandleName = `${baseFinalHandleName}-${++count}`;
+                }
+                if (typeof handleName === 'string' || typeof handleName === 'function') {
+                    finalHandleName = (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(handleName, finalHandleName);
                 }
                 else {
-                    const handleNameMap = usedHandleNames[type];
-                    const baseFinalHandleName = finalHandleName = `${handlePrefix}.${(0, shared_1.convertUsageLocationsHandleToEmittableHandle)((0, shared_1.kebabCase)(cleanBasename), cleanBasename)}`;
-                    for (let count = 0; finalHandleName in handleNameMap && handleNameMap[finalHandleName] !== src;) {
-                        finalHandleName = `${baseFinalHandleName}-${++count}`;
-                    }
                     handleNameMap[finalHandleName] = src;
                 }
                 plainEntrypointsConfig[`${type}Handles`][finalHandleName] = { src, rest, locations, type, lazyLoader, ...otherProps };

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

@@ -40,13 +40,13 @@ function mapToRealEntrypoints(entrypoint, dir, supportedExtensions, args) {
         .map(([ep, rawPathQueryParameters]) => {
         const parsedEntrypoint = (0, node_path_1.parse)(ep);
         const entrypointField = shared_1.styleExtension.test(ep) ? 'style' : shared_1.scriptWithModuleExtension.test(ep) ? 'viewScriptModule' : 'script';
-        const { flags: enqueuingFlags, remainder: pathQueryParameters } = (0, path_query_and_related_helpers_1.unpackEnqueuingControlFlagsFromPathQueryParameters)(rawPathQueryParameters, ep, 'path query parameters');
+        const { flags: enqueuingFlags, remainder: pathQueryParameters, handle } = (0, path_query_and_related_helpers_1.unpackEnqueuingControlFlagsFromPathQueryParameters)(rawPathQueryParameters, ep, 'path query parameters');
         const fakeEntrypointInfo = {
             blockJsonOrigin: args.entrypointJsonOrigin,
             entrypointField,
             originalValue: ep,
             entrypointName: parsedEntrypoint.name,
-            handle: (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(dest.locations.handle, parsedEntrypoint.name),
+            handle: (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(handle ?? dest.locations.handle, parsedEntrypoint.name),
             handleGroup: (0, shared_1.getHandleGroup)(entrypointField),
             dest,
             absoluteSrc: ep,
@@ -228,6 +228,15 @@ function resolveEntryFromDirectory(commonConfig, srcRoot, dest) {
                         a[entry.entrypointName] = (a[entry.entrypointName] !== undefined);
                         return a;
                     }, {});
+                    const getDefaultHandle = (presentEntrypoint) => {
+                        const baseSuffix = `_${(0, shared_1.isStyleField)(presentEntrypoint.entrypointField) ? "style" : "script"}`;
+                        let count = 0, suffix = baseSuffix, deduplicatedEntrypointName;
+                        while (((deduplicatedEntrypointName = (presentEntrypoint.entrypointName + suffix)) in allocatedDestinations)
+                            && allocatedDestinations[deduplicatedEntrypointName] !== presentEntrypoint.originalValue) {
+                            suffix = baseSuffix + "_" + (++count);
+                        }
+                        return { count, suffix, deduplicatedEntrypointName };
+                    };
                     const handlePrefix = blockJson['name']?.toString() ?? `__UNKNOWN_PREFIX__/${dirent.name}`;
                     const allocatedDestinations = {};
                     const resolvedBlockEntrypoints = presentEntrypoints
@@ -236,11 +245,17 @@ function resolveEntryFromDirectory(commonConfig, srcRoot, dest) {
                         const overallSourceRelativeName = (0, node_path_1.relative)(overallSource, (0, node_path_1.normalize)((0, node_path_1.join)(blockJsonOrigin, (0, node_path_1.relative)(overallSource, presentEntrypoint.extensionlessExpectedSrc))));
                         const handleSuffix = (0, shared_1.convertUsageLocationsHandleToEmittableHandle)(dest.locations.handle, overallSourceRelativeName);
                         const handleGroup = (0, shared_1.getHandleGroup)(presentEntrypoint.entrypointField);
-                        if (presentEntrypoint.handle) {
-                            (seenExplicitHandles[handleGroup][presentEntrypoint.handle] ??= []).push(overallSource);
+                        const explicitlySetHandle = typeof presentEntrypoint.handle === 'string'
+                            ? presentEntrypoint.handle
+                            : presentEntrypoint.handle?.(getDefaultHandle(presentEntrypoint).deduplicatedEntrypointName);
+                        if (explicitlySetHandle) {
+                            if (explicitlySetHandle.length < 5) {
+                                throw (0, shared_1.newWebpackErrorForFile)(`The handle was invalid. Received: ${explicitlySetHandle}. Expected: a string that is at least 5 characters long`, overallSourceRelativeName);
+                            }
+                            (seenExplicitHandles[handleGroup][explicitlySetHandle] ??= []).push(overallSource);
                         }
                         if (!entrypointNamesWithEffectiveDuplicates[presentEntrypoint.entrypointName]) {
-                            return { blockJsonOrigin, ...presentEntrypoint, handle: presentEntrypoint.handle ?? `${handlePrefix}/${handleSuffix}`, dest, handleGroup };
+                            return { blockJsonOrigin, ...presentEntrypoint, handle: explicitlySetHandle ?? `${handlePrefix}/${handleSuffix}`, dest, handleGroup };
                         }
                         const baseSuffix = `_${(0, shared_1.isStyleField)(presentEntrypoint.entrypointField) ? "style" : "script"}`;
                         let count = 0, suffix = baseSuffix, deduplicatedEntrypointName;
@@ -255,7 +270,7 @@ function resolveEntryFromDirectory(commonConfig, srcRoot, dest) {
                             ...presentEntrypoint,
                             entrypointName: deduplicatedEntrypointName,
                             extensionlessExpectedSrc: deduplicatedExtensionlessExpectedSrc,
-                            handle: presentEntrypoint.handle ?? `${handlePrefix}/${count ? handleSuffix + "_" + count : handleSuffix}`, handleGroup,
+                            handle: explicitlySetHandle ?? `${handlePrefix}/${count ? handleSuffix + "_" + count : handleSuffix}`, handleGroup,
                             dest
                         };
                     });

package/dist/utils/location-encoding-filename-parser.d.ts

@@ -1,10 +1,10 @@
-import { RealUsageLocations } from "../shared";
+import { RealUsageLocations, UsageLocations } from "../shared";
 import { NormalizedEnqueuingControlFlags } from "./path-query-and-related-helpers";
 export type ParsedLocationEncodingFilename = {
     type: 'script' | 'style' | 'script-module';
     locations: RealUsageLocations & {
         register?: boolean | number;
-    };
+    } & Pick<UsageLocations, 'handle'>;
     flags: NormalizedEnqueuingControlFlags;
     niceName?: string;
 };

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

@@ -78,6 +78,12 @@ function parseLocationEncodingFilename(filename) {
     if (Object.values(locations).length === 0) {
         return undefined;
     }
+    if (niceName !== undefined) {
+        locations.handle = generatedHandle => {
+            const lastSlash = generatedHandle.lastIndexOf('/');
+            return (lastSlash > 0 ? generatedHandle.substring(0, lastSlash) : generatedHandle) + "/" + niceName;
+        };
+    }
     return { type, locations, flags, niceName };
 }
 function parseLocationEncodingFilenameForBlock(filename, errorBuilder = shared_1.newWebpackErrorForFile) {

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

@@ -1,5 +1,5 @@
 import type { Compilation } from "webpack";
-import { type InlinedAsset, type PathQueryParameters, type ScriptArgsObject } from "../shared";
+import { type InlinedAsset, type PathQueryParameters, type ScriptArgsObject, type UsageLocations } from "../shared";
 export declare function getAssetFileContents(compilation: Compilation, name: string): string;
 export declare function unpackPotentiallyPrefixedFilePath(filePath: string): [string, PathQueryParameters | undefined];
 /**
@@ -39,7 +39,7 @@ export type NormalizedEnqueuingControlFlags = {
 export declare function mergeTwoEnqueuingControlFlagSets(file: string, ...argsBlocks: (NormalizedEnqueuingControlFlags | undefined)[]): NormalizedEnqueuingControlFlags | undefined;
 export declare function unpackEnqueuingControlFlagsFromPathQueryParameters(pathQueryParameters: PathQueryParameters | undefined, file: string, sourceType: 'registerScriptArgs' | 'path query parameters'): {
     flags?: NormalizedEnqueuingControlFlags;
-    handle?: string;
+    handle?: UsageLocations['handle'];
     remainder?: PathQueryParameters;
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaudit/webpack-extensions",
-  "version": "3.11.0-wp.demo",
+  "version": "3.12.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "/dist",
@@ -43,9 +43,12 @@
   },
   "dependencies": {
     "@plaudit/php-writer": "^1.5.2",
+    "@plaudit/postcss-color-function": "^5.1.0",
+    "@plaudit/postcss-strip-units": "^3.0.0",
+    "@plaudit/postcss-variables": "^2.0.1",
     "@wordpress/dependency-extraction-webpack-plugin": "^6.48.1",
     "@wordpress/scripts": "^32.4.1",
-    "autoprefixer": "^10.5.0",
+    "autoprefixer": "^10.5.1",
     "browser-sync": "^3.0.4",
     "copy-webpack-plugin": "10.2.4",
     "css-minimizer-webpack-plugin": "^8.0.0",