@plaudit/webpack-extensions 4.0.0-rc.1 → 4.1.0

package/dist/api/entries/index.js

@@ -0,0 +1,22 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dependencies"), exports);
+__exportStar(require("./flag-logic"), exports);
+__exportStar(require("./identifiers"), exports);
+__exportStar(require("./locations"), exports);
+__exportStar(require("./manager"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/entries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/entries/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B"}

package/dist/api/entries/locations.d.ts

@@ -0,0 +1,135 @@
+import type { PHPWriter } from "@plaudit/php-writer";
+import type { ScriptArgsObject } from "../asset-information-emission";
+import type { HandleConfig } from "./dependencies";
+import type { InliningPosition } from "./flag-logic";
+type OptionalLocationMeta = {
+    supports_hook_name?: boolean;
+    additional_action_code?: {
+        before?(writer: PHPWriter): unknown;
+        after?(writer: PHPWriter): unknown;
+    };
+    alternate_names?: [string, ...string[]];
+};
+export declare const standardLocationNamesMeta: {
+    readonly clientView: {
+        readonly action: "wp_enqueue_scripts";
+        readonly alternate_names: ["client-view", "view"];
+    };
+    readonly clientEditor: {
+        readonly action: "enqueue_block_editor_assets";
+        readonly alternate_names: ["client-editor", "editor"];
+    };
+    readonly blockAssets: {
+        readonly action: "enqueue_block_assets";
+        readonly alternate_names: ["block-assets"];
+    };
+    readonly admin: {
+        readonly action: "admin_enqueue_scripts";
+        readonly supports_hook_name: true;
+    };
+    readonly login: {
+        readonly action: "login_enqueue_scripts";
+    };
+    readonly customizer: {
+        readonly action: "customize_controls_enqueue_scripts";
+    };
+    readonly analytics: {
+        readonly action: "plaudit_enqueue_analytics";
+    };
+    readonly lazyLoader: {
+        readonly action: false;
+        readonly supports_hook_name: true;
+        readonly alternate_names: ["lazy-loader"];
+    };
+};
+export type StandardLocationNameMeta = {
+    action: typeof standardLocationNamesMeta[keyof typeof standardLocationNamesMeta]['action'];
+} & OptionalLocationMeta;
+export type StandardLocationNames = keyof typeof standardLocationNamesMeta;
+export declare function isStandardLocationName(name: string): name is StandardLocationNames;
+export type LocationsWithHookNameSupport = {
+    [key in StandardLocationNames]: typeof standardLocationNamesMeta[key] extends {
+        supports_hook_name: true;
+    } ? key : never;
+}[StandardLocationNames];
+export declare function isLocationNameWithHookNameSupport(name: string): name is LocationsWithHookNameSupport;
+export type LocationsWithActionSupport = {
+    [key in StandardLocationNames]: typeof standardLocationNamesMeta[key] extends {
+        action: false;
+    } ? never : key;
+}[StandardLocationNames];
+export declare function isLocationNameWithActionSupport(name: string): name is LocationsWithActionSupport;
+export type LocationsWithActionAndHookNameSupport = {
+    [key in StandardLocationNames]: typeof standardLocationNamesMeta[key] extends {
+        supports_hook_name: true;
+    } ? typeof standardLocationNamesMeta[key] extends {
+        action: false;
+    } ? never : key : never;
+}[StandardLocationNames];
+export declare function iterableStandardLocationNamesMeta(): [StandardLocationNames, StandardLocationNameMeta][];
+export declare function normalizeLocationName(name: string): StandardLocationNames | 'register' | undefined;
+type LocationWithHookNameSupport = boolean | string | string[];
+export type NormalizedLocationWithHookNameSupport = [string, ...string[]];
+type LocationWithActionAndHookNameSupport = LocationWithHookNameSupport | number | {
+    hook_name?: string | string[];
+    priority?: number | true;
+};
+export type NormalizedLocationWithActionAndHookNameSupport = {
+    hook_name?: string[];
+    priority: number;
+};
+export type InputRegisterScriptArgs = ScriptArgsObject | 'lazy' | 'eager' | 'inline' | boolean;
+export type RealUsageLocations = {
+    [K in StandardLocationNames]?: K extends LocationsWithHookNameSupport ? (K extends LocationsWithActionSupport ? LocationWithActionAndHookNameSupport : LocationWithHookNameSupport) : (K extends LocationsWithActionSupport ? boolean | number : never);
+};
+export type PseudoUsageLocations = {
+    register?: boolean | number;
+};
+export type DeprecatedUsageLocations = {
+    handle?: HandleConfig;
+    inline?: boolean | InliningPosition;
+    registerScriptArgs?: InputRegisterScriptArgs;
+};
+export type UsageLocations = RealUsageLocations & PseudoUsageLocations;
+export type NormalizedUsageLocations = {
+    [K in keyof UsageLocations]?: K extends keyof typeof standardLocationNamesMeta ? K extends LocationsWithHookNameSupport ? (K extends LocationsWithActionSupport ? NormalizedLocationWithActionAndHookNameSupport : NormalizedLocationWithHookNameSupport) : (K extends LocationsWithActionSupport ? Exclude<UsageLocations[K], boolean> : never) : Exclude<UsageLocations[K], boolean>;
+};
+declare const enqueuedAssetTypes: readonly ['script', 'script_module', 'style'];
+export type EnqueuedAssetType = typeof enqueuedAssetTypes[number];
+export declare function isEnqueuedAssetType(value: unknown): value is EnqueuedAssetType;
+export declare const entrypointFields: {
+    readonly editorStyle: 'non-module';
+    readonly viewStyle: 'non-module';
+    readonly style: 'non-module';
+    readonly editorScript: 'non-module';
+    readonly viewScript: 'non-module';
+    readonly script: 'non-module';
+    readonly viewScriptModule: 'module';
+};
+export type EntrypointField = keyof typeof entrypointFields;
+export type EntrypointFields = EntrypointField[];
+export declare function isEntrypointField(value: unknown): value is EntrypointField;
+export declare function getLoadableEntrypointFields(processingModules: boolean): EntrypointFields;
+export declare function convertEntrypointFieldForAssetType(entrypointField: EntrypointField, assetType: 'script' | 'style'): EntrypointField;
+export declare function leadingSlashIt(pathOrSomething: string): string;
+export declare const isScriptExtensionRegex: RegExp;
+export declare const scriptExtension: RegExp;
+export declare const scriptWithoutModuleExtension: RegExp;
+export declare const scriptWithModuleExtension: RegExp;
+export declare const styleExtension: RegExp;
+export declare function scriptOrStyleTest(entryPath: string, scriptExtension: RegExp): "" | "script" | "style";
+/**
+ * @return The first element is the name excluding the JS/CSS extension if it was present.
+ *         The second element is either the extension (with a leading ".") if it was present or the empty string if it wasn't.
+ */
+export declare function extractNameAndScriptOrStyleExt(assetPath: string): Readonly<[string, string]>;
+export declare function isStyleField(field: string): field is 'style' | 'viewStyle' | 'editorStyle';
+export declare function isScriptField(field: string): field is 'script' | 'viewScript' | 'editorScript';
+export declare function isScriptModuleField(field: string): field is 'viewScriptModule';
+export declare function getFieldType(field: string): EnqueuedAssetType;
+export declare function getAssetType(assetPath: string): EnqueuedAssetType | false;
+export declare function getHandleGroup(field: string): 'styleHandles' | 'scriptHandles' | 'scriptModuleHandles';
+export declare function convertHookLocationToNamesAndPriority(hookLocation: NonNullable<Exclude<UsageLocations[keyof typeof standardLocationNamesMeta], false>>): [string[], number];
+export declare function convertHookLocationToRawNamesAndPriority(hookLocation: NonNullable<Exclude<UsageLocations[keyof typeof standardLocationNamesMeta], false>>): [[string, ...string[]] | undefined, number | undefined];
+export {};
+//# sourceMappingURL=locations.d.ts.map

package/dist/api/entries/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../../src/api/entries/locations.ts"],"names":[],"mappings":"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"}

package/dist/api/entries/locations.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.styleExtension = exports.scriptWithModuleExtension = exports.scriptWithoutModuleExtension = exports.scriptExtension = exports.isScriptExtensionRegex = exports.entrypointFields = exports.standardLocationNamesMeta = void 0;
+exports.isStandardLocationName = isStandardLocationName;
+exports.isLocationNameWithHookNameSupport = isLocationNameWithHookNameSupport;
+exports.isLocationNameWithActionSupport = isLocationNameWithActionSupport;
+exports.iterableStandardLocationNamesMeta = iterableStandardLocationNamesMeta;
+exports.normalizeLocationName = normalizeLocationName;
+exports.isEnqueuedAssetType = isEnqueuedAssetType;
+exports.isEntrypointField = isEntrypointField;
+exports.getLoadableEntrypointFields = getLoadableEntrypointFields;
+exports.convertEntrypointFieldForAssetType = convertEntrypointFieldForAssetType;
+exports.leadingSlashIt = leadingSlashIt;
+exports.scriptOrStyleTest = scriptOrStyleTest;
+exports.extractNameAndScriptOrStyleExt = extractNameAndScriptOrStyleExt;
+exports.isStyleField = isStyleField;
+exports.isScriptField = isScriptField;
+exports.isScriptModuleField = isScriptModuleField;
+exports.getFieldType = getFieldType;
+exports.getAssetType = getAssetType;
+exports.getHandleGroup = getHandleGroup;
+exports.convertHookLocationToNamesAndPriority = convertHookLocationToNamesAndPriority;
+exports.convertHookLocationToRawNamesAndPriority = convertHookLocationToRawNamesAndPriority;
+const utils_1 = require("../../utils");
+const identifiers_1 = require("./identifiers");
+exports.standardLocationNamesMeta = {
+    clientView: { action: "wp_enqueue_scripts", alternate_names: ['client-view', 'view'] },
+    clientEditor: { action: "enqueue_block_editor_assets", alternate_names: ['client-editor', 'editor'] },
+    blockAssets: { action: "enqueue_block_assets", alternate_names: ['block-assets'] },
+    admin: { action: "admin_enqueue_scripts", supports_hook_name: true },
+    login: { action: "login_enqueue_scripts" },
+    customizer: { action: "customize_controls_enqueue_scripts" },
+    analytics: { action: "plaudit_enqueue_analytics" },
+    lazyLoader: { action: false, supports_hook_name: true, alternate_names: ['lazy-loader'] },
+};
+function isStandardLocationName(name) {
+    return Object.hasOwn(exports.standardLocationNamesMeta, name);
+}
+function isLocationNameWithHookNameSupport(name) {
+    const def = exports.standardLocationNamesMeta[name];
+    return typeof def === 'object' && !!def && ('supports_hook_name' in def) && def.supports_hook_name;
+}
+function isLocationNameWithActionSupport(name) {
+    const def = exports.standardLocationNamesMeta[name];
+    return typeof def === 'object' && !!def && def.action !== false;
+}
+function iterableStandardLocationNamesMeta() {
+    return (0, utils_1.constantEntries)(exports.standardLocationNamesMeta);
+}
+function normalizeLocationName(name) {
+    if (isStandardLocationName(name) || name === 'register') {
+        return name;
+    }
+    for (const [standardName, { alternate_names }] of iterableStandardLocationNamesMeta()) {
+        if (alternate_names?.includes(name)) {
+            return standardName;
+        }
+    }
+    return undefined;
+}
+const enqueuedAssetTypes = ['script', 'script_module', 'style'];
+function isEnqueuedAssetType(value) {
+    return typeof value === 'string' && enqueuedAssetTypes.includes(value);
+}
+exports.entrypointFields = {
+    "editorStyle": 'non-module',
+    "viewStyle": 'non-module',
+    "style": 'non-module',
+    "editorScript": 'non-module',
+    "viewScript": 'non-module',
+    "script": 'non-module',
+    "viewScriptModule": 'module',
+};
+function isEntrypointField(value) {
+    return typeof value === 'string' && Object.hasOwn(exports.entrypointFields, value);
+}
+function getLoadableEntrypointFields(processingModules) {
+    const check = processingModules ? 'module' : 'non-module';
+    return (0, utils_1.constantEntries)(exports.entrypointFields).filter(e => e[1] === check).map(e => e[0]);
+}
+//TODO: Remove this
+function convertEntrypointFieldForAssetType(entrypointField, assetType) {
+    // Using these word fragments instead of the full words allows us to avoid having to deal with the capitalization of the first letter
+    const searchRep = assetType === 'script' ? ['tyle', 'cript'] : [/cript(?:Module)?/, 'tyle'];
+    return entrypointField.replace(...searchRep);
+}
+function leadingSlashIt(pathOrSomething) {
+    return pathOrSomething.startsWith('/') ? pathOrSomething : ('/' + pathOrSomething);
+}
+exports.isScriptExtensionRegex = /\.m?[jt]sx?$/i;
+exports.scriptExtension = /(?<filename>.+)(?<extension>\.m?[jt]sx?)$/i;
+exports.scriptWithoutModuleExtension = /(?<filename>.+)(?<extension>\.[jt]sx?)($|\?)/i;
+exports.scriptWithModuleExtension = /(?<filename>.+)(?<extension>\.m[jt]sx?)($|\?)/i;
+exports.styleExtension = /(?<filename>.+)(?<extension>\.([ps]?c|sa)ss)($|\?)/i;
+function scriptOrStyleTest(entryPath, scriptExtension) {
+    return scriptExtension.test(entryPath) ? "script" : (exports.styleExtension.test(entryPath) ? "style" : "");
+}
+/**
+ * @return The first element is the name excluding the JS/CSS extension if it was present.
+ *         The second element is either the extension (with a leading ".") if it was present or the empty string if it wasn't.
+ */
+function extractNameAndScriptOrStyleExt(assetPath) {
+    const { filename, extension } = (exports.scriptExtension.exec(assetPath) ?? exports.styleExtension.exec(assetPath))?.groups ?? {};
+    return filename && extension ? [filename, extension] : [assetPath, ""];
+}
+function isStyleField(field) {
+    return field.endsWith("tyle");
+}
+function isScriptField(field) {
+    return field.endsWith("cript");
+}
+function isScriptModuleField(field) {
+    return /[sS]cript[mM]odule$/.test(field);
+}
+function getFieldType(field) {
+    if (isStyleField(field)) {
+        return 'style';
+    }
+    if (isScriptField(field)) {
+        return 'script';
+    }
+    if (isScriptModuleField(field)) {
+        return 'script_module';
+    }
+    throw new Error(`Unrecognized field: ${field}`);
+}
+function getAssetType(assetPath) {
+    return exports.styleExtension.test(assetPath) ? 'style' : exports.scriptWithModuleExtension.test(assetPath) ? 'script_module' : exports.scriptWithoutModuleExtension.test(assetPath) ? 'script' : false;
+}
+function getHandleGroup(field) {
+    if (isStyleField(field)) {
+        return 'styleHandles';
+    }
+    if (isScriptModuleField(field)) {
+        return 'scriptModuleHandles';
+    }
+    return 'scriptHandles';
+}
+function convertHookLocationToNamesAndPriority(hookLocation) {
+    if (typeof hookLocation === 'string') {
+        return [[hookLocation], identifiers_1.DEFAULT_WP_HOOK_PRIORITY];
+    }
+    if (typeof hookLocation === 'number') {
+        return [[], hookLocation];
+    }
+    if (typeof hookLocation === 'boolean') {
+        return [[], identifiers_1.DEFAULT_WP_HOOK_PRIORITY];
+    }
+    if (Array.isArray(hookLocation)) {
+        return [hookLocation, identifiers_1.DEFAULT_WP_HOOK_PRIORITY];
+    }
+    // if it's in object-form
+    return [typeof hookLocation.hook_name === 'string' ? [hookLocation.hook_name] : hookLocation.hook_name ?? [], hookLocation.priority === true ? identifiers_1.DEFAULT_WP_HOOK_PRIORITY : hookLocation.priority ?? identifiers_1.DEFAULT_WP_HOOK_PRIORITY];
+}
+function convertHookLocationToRawNamesAndPriority(hookLocation) {
+    if (typeof hookLocation === 'string') {
+        return [[hookLocation], undefined];
+    }
+    if (typeof hookLocation === 'number') {
+        return [undefined, hookLocation];
+    }
+    if (typeof hookLocation === 'boolean') {
+        return [undefined, identifiers_1.DEFAULT_WP_HOOK_PRIORITY];
+    }
+    if (Array.isArray(hookLocation)) {
+        return [(0, utils_1.hasAtLeastOneItem)(hookLocation) ? hookLocation : undefined, undefined];
+    }
+    // if it's in object-form
+    return [
+        typeof hookLocation.hook_name === 'string' ? [hookLocation.hook_name] : (0, utils_1.hasAtLeastOneItem)(hookLocation.hook_name) ? hookLocation.hook_name : undefined,
+        hookLocation.priority === true ? identifiers_1.DEFAULT_WP_HOOK_PRIORITY : hookLocation.priority
+    ];
+}
+//# sourceMappingURL=locations.js.map

package/dist/api/entries/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../../src/api/entries/locations.ts"],"names":[],"mappings":"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"}

package/dist/api/entries/manager.d.ts

@@ -0,0 +1,12 @@
+import { type Compilation, type Compiler } from "webpack";
+import { type EntryOptions, type NoOverrides } from "./dependencies";
+export type EntryManager = {
+    addDependency: (dep: Parameters<Compilation['addEntry']>[1], options: EntryOptions) => void;
+    addEntry: <T extends object = object>(descOrSrc: string | string[], simpleOptions: NoOverrides<T, keyof EntryOptions | 'name'> & Omit<EntryOptions, 'name'> & {
+        name: string;
+    }) => void;
+    addEntryInjectionPromise: (promise: Promise<unknown>) => void;
+    waitHook: () => Promise<unknown>;
+};
+export declare function makeEntryManager(compiler: Compiler, compilation: Compilation, context: string, coordinatedLoaderName: string): EntryManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/api/entries/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/api/entries/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAiC,MAAM,SAAS,CAAC;AAIxF,OAAO,EAAC,KAAK,YAAY,EAAyB,KAAK,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAE1F,MAAM,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5F,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAC,MAAM,EAAE,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,YAAY,GAAC,MAAM,CAAC,GAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,KAAK,IAAI,CAAC;IAC9K,wBAAwB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9D,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,YAAY,CA+B3I"}

package/dist/api/entries/manager.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeEntryManager = makeEntryManager;
+const webpack_1 = require("webpack");
+const utils_1 = require("../../utils");
+const dependencies_1 = require("./dependencies");
+function makeEntryManager(compiler, compilation, context, coordinatedLoaderName) {
+    const promises = [];
+    const addDependency = (dep, options) => {
+        promises.push(new Promise((resolve, reject) => {
+            compilation.addEntry(context, dep, { ...options, coordinatedLoaderName }, err => void (err ? reject(err) : resolve()));
+        }));
+    };
+    return {
+        addDependency,
+        addEntry: (descOrSrc, options) => {
+            if (!Array.isArray(descOrSrc) || (0, utils_1.hasAtLeastOneItem)(descOrSrc)) {
+                let desc;
+                if ((0, dependencies_1.isPlauditEntryOptions)(options) && options.additionalSrcs?.length) {
+                    desc = { import: typeof descOrSrc === 'string' ? [descOrSrc, ...options.additionalSrcs] : [...descOrSrc, ...options.additionalSrcs] };
+                }
+                else {
+                    desc = { import: typeof descOrSrc === 'string' ? [descOrSrc] : descOrSrc };
+                }
+                const opts = { ...webpack_1.EntryOptionPlugin.entryDescriptionToOptions(compiler, options.name, desc), ...options };
+                for (const src of desc.import) {
+                    addDependency(webpack_1.EntryPlugin.createDependency(src, opts), opts);
+                }
+            }
+        },
+        addEntryInjectionPromise: promise => void promises.push(promise),
+        waitHook: () => Promise.all(promises),
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/api/entries/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/api/entries/manager.ts"],"names":[],"mappings":";;;AAAA,qCAAwF;AAExF,uCAA8C;AAE9C,iDAA0F;AAS1F,0BAAiC,QAAkB,EAAE,WAAwB,EAAE,OAAe,EAAE,qBAA6B;IAC5H,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,aAAa,GAAkC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACrE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,WAAW,CAAC,QAAQ,CACnB,OAAO,EACP,GAAG,EACH,EAAC,GAAG,OAAO,EAAE,qBAAqB,EAA4B,EAC9D,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAC3C,CAAC;QACH,CAAC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,OAAO;QACN,aAAa;QACb,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAA,yBAAiB,EAAC,SAAS,CAAC,EAAE,CAAC;gBAC/D,IAAI,IAAwB,CAAC;gBAC7B,IAAI,IAAA,oCAAqB,EAAC,OAAO,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;oBACtE,IAAI,GAAG,EAAC,MAAM,EAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,EAAC,CAAA;gBACpI,CAAC;qBAAM,CAAC;oBACP,IAAI,GAAG,EAAC,MAAM,EAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAC,CAAC;gBAC1E,CAAC;gBACD,MAAM,IAAI,GAAG,EAAC,GAAG,2BAAiB,CAAC,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,EAAC,CAAC;gBACxG,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAC/B,aAAa,CAAC,qBAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC9D,CAAC;YACF,CAAC;QACF,CAAC;QACD,wBAAwB,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAChE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACZ,CAAC"}

package/dist/api/handle-derivation.d.ts

@@ -0,0 +1,32 @@
+import type { HandleConfig, PlauditEntryOptions } from "./entries";
+/**
+ * The type of mechanism via which the handle was derived.
+ * These are used when determining which handles can be safely modified by conflict-avoidance code when a conflict occurs.
+ */
+export declare enum HandleDerivationMechanism {
+    /**
+     * Indicates that the entirety of the handle was specified by the user.
+     * Handles derived via this mechanism cannot be modified by conflict-avoidance code, and will, therefore, throw errors if a conflict occurs.
+     */
+    manual = 0,
+    /**
+     * Indicates that the suffix of the handle was specified by the user declaring the "nice name" of the file.
+     * Handles derived via this mechanism cannot be modified by conflict-avoidance code, and will, therefore, throw errors if a conflict occurs.
+     */
+    niceName = 1,
+    /**
+     * Indicates that the handle was generated by the build script. This is the most common method of handle derivation.
+     * Handles derived via this mechanism can be modified by conflict-avoidance code, and will, therefore, not throw errors if a conflict occurs.
+     * This is possible because the user is not supposed to interact with generated handles directly.
+     */
+    generation = 2
+}
+export declare function handleCannotBeModifiedForConflictAvoidance(derivationMechanism: HandleDerivationMechanism | Pick<HandleAndDerivationMechanism, 'derivation'>): boolean;
+export type HandleAndDerivationMechanism = {
+    handle: string;
+    fallbackHandleProducer?: () => HandleAndDerivationMechanism;
+    derivation: HandleDerivationMechanism;
+};
+export declare function convertHandleConfigToEmittableHandle<T extends Record<string, unknown> = Record<string, unknown>>(handle: HandleConfig<PlauditEntryOptions<T>> | undefined, handlePrefix: string, handleSuffix: string, options: Omit<PlauditEntryOptions<T>, 'initialHandleName'>): HandleAndDerivationMechanism;
+export declare function makeEmittableConfigPHP(data: unknown, asFullFile: boolean, parentIndent?: string): string;
+//# sourceMappingURL=handle-derivation.d.ts.map

package/dist/api/handle-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-derivation.d.ts","sourceRoot":"","sources":["../../src/api/handle-derivation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAE,mBAAmB,EAAC,MAAM,WAAW,CAAC;AAEjE;;;GAGG;AACH,oBAAY,yBAAyB;IACpC;;;OAGG;IACH,MAAM,IAAA;IACN;;;OAGG;IACH,QAAQ,IAAA;IACR;;;;OAIG;IACH,UAAU,IAAA;CACV;AACD,wBAAgB,0CAA0C,CAAC,mBAAmB,EAAE,yBAAyB,GAAC,IAAI,CAAC,4BAA4B,EAAE,YAAY,CAAC,WAEzJ;AAED,MAAM,MAAM,4BAA4B,GAAG;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,4BAA4B,CAAC;IAAC,UAAU,EAAE,yBAAyB,CAAA;CAAC,CAAC;AAEhK,wBAAgB,oCAAoC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/G,MAAM,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAC5J,4BAA4B,CAgC9B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,SAAK,UAO3F"}

package/dist/api/handle-derivation.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandleDerivationMechanism = void 0;
+exports.handleCannotBeModifiedForConflictAvoidance = handleCannotBeModifiedForConflictAvoidance;
+exports.convertHandleConfigToEmittableHandle = convertHandleConfigToEmittableHandle;
+exports.makeEmittableConfigPHP = makeEmittableConfigPHP;
+const php_writer_1 = require("@plaudit/php-writer");
+/**
+ * The type of mechanism via which the handle was derived.
+ * These are used when determining which handles can be safely modified by conflict-avoidance code when a conflict occurs.
+ */
+var HandleDerivationMechanism;
+(function (HandleDerivationMechanism) {
+    /**
+     * Indicates that the entirety of the handle was specified by the user.
+     * Handles derived via this mechanism cannot be modified by conflict-avoidance code, and will, therefore, throw errors if a conflict occurs.
+     */
+    HandleDerivationMechanism[HandleDerivationMechanism["manual"] = 0] = "manual";
+    /**
+     * Indicates that the suffix of the handle was specified by the user declaring the "nice name" of the file.
+     * Handles derived via this mechanism cannot be modified by conflict-avoidance code, and will, therefore, throw errors if a conflict occurs.
+     */
+    HandleDerivationMechanism[HandleDerivationMechanism["niceName"] = 1] = "niceName";
+    /**
+     * Indicates that the handle was generated by the build script. This is the most common method of handle derivation.
+     * Handles derived via this mechanism can be modified by conflict-avoidance code, and will, therefore, not throw errors if a conflict occurs.
+     * This is possible because the user is not supposed to interact with generated handles directly.
+     */
+    HandleDerivationMechanism[HandleDerivationMechanism["generation"] = 2] = "generation";
+})(HandleDerivationMechanism || (exports.HandleDerivationMechanism = HandleDerivationMechanism = {}));
+function handleCannotBeModifiedForConflictAvoidance(derivationMechanism) {
+    return (typeof derivationMechanism === 'object' ? derivationMechanism.derivation : derivationMechanism) !== HandleDerivationMechanism.generation;
+}
+function convertHandleConfigToEmittableHandle(handle, handlePrefix, handleSuffix, options) {
+    const generatedHandle = `${handlePrefix}/${handleSuffix}`;
+    if (!handle) {
+        return { handle: generatedHandle, derivation: HandleDerivationMechanism.generation };
+    }
+    let emittableHandle, derivation;
+    if (typeof handle === 'string') {
+        emittableHandle = handle;
+        derivation = HandleDerivationMechanism.manual;
+    }
+    else if (typeof handle === 'function') {
+        const functionResult = handle(generatedHandle, options);
+        emittableHandle = !functionResult || typeof functionResult === 'string' ? functionResult : functionResult.handle;
+        if (!emittableHandle) {
+            return { handle: generatedHandle, derivation: HandleDerivationMechanism.generation };
+        }
+        derivation = HandleDerivationMechanism.manual;
+    }
+    else if (handle.niceName) {
+        emittableHandle = `${handlePrefix}/${handle.niceName}`;
+        derivation = handle.derivation ?? HandleDerivationMechanism.niceName;
+        let fallbackHandleProducer;
+        if (handle.fallbackNiceName) {
+            fallbackHandleProducer = () => {
+                const emittableHandle = `${handlePrefix}/${handle.fallbackNiceName}`;
+                return { handle: emittableHandle.replaceAll("{basename}", handleSuffix), derivation: HandleDerivationMechanism.generation };
+            };
+        }
+        return { handle: emittableHandle.replaceAll("{basename}", handleSuffix), fallbackHandleProducer, derivation };
+    }
+    else {
+        return { handle: generatedHandle, derivation: HandleDerivationMechanism.generation };
+    }
+    // A callback is free to return nothing, which means "use the handle you would have generated"
+    return { handle: emittableHandle.replaceAll("{basename}", handleSuffix), derivation };
+}
+function makeEmittableConfigPHP(data, asFullFile, parentIndent = "") {
+    const prettyPrintedMetadata = php_writer_1.json2php.make({ indent: "\t", linebreak: "\n", shortArraySyntax: true })(data, parentIndent)
+        .replaceAll(/(\n\t*)\[\s+],/gs, "$1[],")
+        .replaceAll(/\[\n\t+([^\n]+)\n\t+]/gs, (_, inner) => `[${inner.trim()}]`)
+        .replaceAll(/'rest' => \[\n\t+(\[(?:'[^']+')?]),\n\t+('[^']+')(?:,\n\t+(\[[^\n]+]))?\n\t+]/gs, (_, deps, hash, args) => `'rest' => [${[deps, hash, args].filter(value => !!value).join(", ")}]`);
+    return asFullFile ? `<?php return ${prettyPrintedMetadata};` : prettyPrintedMetadata.trim();
+}
+//# sourceMappingURL=handle-derivation.js.map

package/dist/api/handle-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-derivation.js","sourceRoot":"","sources":["../../src/api/handle-derivation.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./asset-information-emission";
+export * from "./configuration";
+export * from "./coordinatable-emitter";
+export * from "./entries";
+export * from "./handle-derivation";
+export * from "./shared-types";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,23 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./asset-information-emission"), exports);
+__exportStar(require("./configuration"), exports);
+__exportStar(require("./coordinatable-emitter"), exports);
+__exportStar(require("./entries"), exports);
+__exportStar(require("./handle-derivation"), exports);
+__exportStar(require("./shared-types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,kDAAgC;AAChC,0DAAwC;AACxC,4CAA0B;AAC1B,sDAAoC;AACpC,iDAA+B"}