@plaudit/webpack-extensions 3.21.2 → 4.0.0

package/dist/api/configuration.d.ts

@@ -0,0 +1,102 @@
+import { AsyncParallelHook, AsyncSeriesHook, SyncBailHook } from "tapable";
+import type { Configuration, WebpackPluginInstance } from "webpack";
+import type { RootCoordinatorPlugin } from "./coordinatable-emitter";
+import type { EntrypointField } from "./entries";
+import type { VerifiedAdvancedDestinationConfig, VerifiedPlauditWordpressWebpackConfig } from "./shared-types";
+export interface AutoRegisteringPlugin {
+    readonly plauditWebpackExtensionsPlugin: true;
+    register(wrapperManager: WrapperManager): void | Promise<void>;
+}
+export declare function isAutoRegisteringPlugin(thing: unknown): thing is AutoRegisteringPlugin;
+export type ResolvedDestination = {
+    srcRoots: string[];
+    src: string;
+    dest: VerifiedAdvancedDestinationConfig;
+} & ({
+    srcRoot: string | [string, ...string[]];
+    srcIsDirectory: false;
+} | {
+    srcRoot: string;
+    srcIsDirectory: true;
+});
+export type ConfigLevelProps = {
+    config: VerifiedPlauditWordpressWebpackConfig;
+    hasAnyNonModuleBuilds: boolean;
+    webpackConfig: Omit<Configuration, 'plugins'>;
+};
+export type WPConfigFinalizeProps = Omit<ConfigLevelProps, 'webpackConfig'> & {
+    isProductionBuild: boolean;
+};
+export declare class WrapperManager {
+    readonly coordinator: RootCoordinatorPlugin;
+    readonly config: Readonly<VerifiedPlauditWordpressWebpackConfig>;
+    readonly hooks: {
+        readonly webpackConfig: {
+            /**
+             * This is used to modify the module rules for Webpack.
+             * It is intended to allow plugins to fix up issues that can come from how WordPress configures the rules by default and to patch in additional file handling.
+             * It uses immer to ensure that the changes cannot be leaked to other {@link Configuration} instances.
+             * It fires once per Webpack {@link Configuration}.
+             */
+            readonly rules: AsyncSeriesHook<[("" | "..." | 0 | false | import("webpack").RuleSetRule | null | undefined)[], ConfigLevelProps & RulesTimeConfig], import("tapable").UnsetAdditionalOptions>;
+            /**
+             * This is used to allow for modifying the Webpack {@link Configuration} after everything else is done.
+             * It uses immer to ensure that the changes cannot be leaked to other {@link Configuration} instances.
+             * It fires once per Webpack {@link Configuration}.
+             */
+            readonly finalize: AsyncSeriesHook<[Configuration, WPConfigFinalizeProps], import("tapable").UnsetAdditionalOptions>;
+        };
+        /**
+         * This is used to set up the taps for each batch. It fires once per {@link IndividualBatchProcessor}
+         */
+        readonly batch: AsyncSeriesHook<[IndividualBatchProcessor, ConfigLevelProps], import("tapable").UnsetAdditionalOptions>;
+    };
+    readonly emitterPlugins: ((props: ConfigLevelProps, item: ResolvedDestination, destinationHandler: DestinationHandler) => undefined | WebpackPluginInstance | WebpackPluginInstance[])[];
+    readonly supportedSourceTypes: Set<string>;
+    constructor(coordinator: RootCoordinatorPlugin, config: Readonly<VerifiedPlauditWordpressWebpackConfig>);
+}
+export type WebpackRules = NonNullable<NonNullable<Configuration['module']>['rules']>;
+export type RulesTimeConfig = {
+    getVariableValue: (name: string) => unknown;
+    entrypointFields: ReadonlyArray<EntrypointField>;
+    scriptExtension: RegExp;
+};
+export type DestinationHandler = {
+    sourceType: string;
+    plugin?: WebpackPluginInstance | WebpackPluginInstance[];
+    supportsAssetCopying?: boolean;
+};
+export declare class IndividualBatchProcessor {
+    readonly plugins: readonly WebpackPluginInstance[];
+    readonly canClean: boolean;
+    readonly hasAnyNonModuleBuilds: boolean;
+    readonly entrypointFields: ReadonlyArray<EntrypointField>;
+    readonly scriptExtension: RegExp;
+    readonly hooks: {
+        /**
+         * This fires before the batch has been processed to allow logic that should be executed in parallel to be used without making the batch hook parallel
+         */
+        readonly beforeBatch: AsyncParallelHook<[], import("tapable").UnsetAdditionalOptions>;
+        /**
+         * Fires before the destination handler has been resolved. This fires regardless of whether the resolution is successful.
+         */
+        readonly beforeDestinationHandler: AsyncParallelHook<[ResolvedDestination], import("tapable").UnsetAdditionalOptions>;
+        /**
+         * Used to determine the logic that will handle the ResolvedDestination. If none of the taps returns anything, the destination is skipped.
+         */
+        readonly destinationHandler: SyncBailHook<[ResolvedDestination], DestinationHandler | undefined, import("tapable").UnsetAdditionalOptions>;
+        /**
+         * Fires after the destination handler has been resolved. This DOES NOT fire if the resolution was unsuccessful.
+         * This is intended for use in adding plugins that do additional processing work like {@link CopyPlugin}
+         */
+        readonly afterDestinationHandler: AsyncSeriesHook<[ResolvedDestination, DestinationHandler | undefined], import("tapable").UnsetAdditionalOptions>;
+        /**
+         * Fires after the batch has been processed, but before it is finalized into a single config object.
+         * This is intended to allow logic that collects data over the course of the batch being processed to use it
+         */
+        readonly afterBatch: AsyncSeriesHook<[WebpackPluginInstance[]], import("tapable").UnsetAdditionalOptions>;
+    };
+    readonly metadata: Map<unknown, unknown>;
+    constructor(plugins: readonly WebpackPluginInstance[], canClean: boolean, hasAnyNonModuleBuilds: boolean, entrypointFields: ReadonlyArray<EntrypointField>, scriptExtension: RegExp);
+}
+//# sourceMappingURL=configuration.d.ts.map

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

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

package/dist/api/configuration.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndividualBatchProcessor = exports.WrapperManager = void 0;
+exports.isAutoRegisteringPlugin = isAutoRegisteringPlugin;
+const tapable_1 = require("tapable");
+function isAutoRegisteringPlugin(thing) {
+    return !!thing && typeof thing === 'object' &&
+        'plauditWebpackExtensionsPlugin' in thing && thing.plauditWebpackExtensionsPlugin === true &&
+        'register' in thing && typeof thing.register === 'function';
+}
+class WrapperManager {
+    coordinator;
+    config;
+    hooks = {
+        webpackConfig: {
+            /**
+             * This is used to modify the module rules for Webpack.
+             * It is intended to allow plugins to fix up issues that can come from how WordPress configures the rules by default and to patch in additional file handling.
+             * It uses immer to ensure that the changes cannot be leaked to other {@link Configuration} instances.
+             * It fires once per Webpack {@link Configuration}.
+             */
+            rules: new tapable_1.AsyncSeriesHook(["rules", "rulesTimeConfig"], "webpackConfigRules"),
+            /**
+             * This is used to allow for modifying the Webpack {@link Configuration} after everything else is done.
+             * It uses immer to ensure that the changes cannot be leaked to other {@link Configuration} instances.
+             * It fires once per Webpack {@link Configuration}.
+             */
+            finalize: new tapable_1.AsyncSeriesHook(["webpackConfig", "props"], "webpackConfigFinalize"),
+        },
+        /**
+         * This is used to set up the taps for each batch. It fires once per {@link IndividualBatchProcessor}
+         */
+        batch: new tapable_1.AsyncSeriesHook(["batch", "props"]),
+    };
+    emitterPlugins = [];
+    supportedSourceTypes = new Set();
+    constructor(coordinator, config) {
+        this.coordinator = coordinator;
+        this.config = config;
+    }
+}
+exports.WrapperManager = WrapperManager;
+class IndividualBatchProcessor {
+    plugins;
+    canClean;
+    hasAnyNonModuleBuilds;
+    entrypointFields;
+    scriptExtension;
+    hooks = {
+        /**
+         * This fires before the batch has been processed to allow logic that should be executed in parallel to be used without making the batch hook parallel
+         */
+        beforeBatch: new tapable_1.AsyncParallelHook([], "beforeBatch"),
+        /**
+         * Fires before the destination handler has been resolved. This fires regardless of whether the resolution is successful.
+         */
+        beforeDestinationHandler: new tapable_1.AsyncParallelHook(["item"], "beforeDestinationHandler"),
+        /**
+         * Used to determine the logic that will handle the ResolvedDestination. If none of the taps returns anything, the destination is skipped.
+         */
+        destinationHandler: new tapable_1.SyncBailHook(["item"], "destinationHandler"),
+        /**
+         * Fires after the destination handler has been resolved. This DOES NOT fire if the resolution was unsuccessful.
+         * This is intended for use in adding plugins that do additional processing work like {@link CopyPlugin}
+         */
+        afterDestinationHandler: new tapable_1.AsyncSeriesHook(["item", "destinationHandler"], "afterDestinationHandler"),
+        /**
+         * Fires after the batch has been processed, but before it is finalized into a single config object.
+         * This is intended to allow logic that collects data over the course of the batch being processed to use it
+         */
+        afterBatch: new tapable_1.AsyncSeriesHook(["plugins"], "afterBatch"),
+    };
+    metadata = new Map();
+    constructor(plugins, canClean, hasAnyNonModuleBuilds, entrypointFields, scriptExtension) {
+        this.plugins = plugins;
+        this.canClean = canClean;
+        this.hasAnyNonModuleBuilds = hasAnyNonModuleBuilds;
+        this.entrypointFields = entrypointFields;
+        this.scriptExtension = scriptExtension;
+    }
+}
+exports.IndividualBatchProcessor = IndividualBatchProcessor;
+//# sourceMappingURL=configuration.js.map

package/dist/api/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/api/configuration.ts"],"names":[],"mappings":";;;;AACA,qCAAyE;AAWzE,iCAAwC,KAAc;IACrD,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC1C,gCAAgC,IAAI,KAAK,IAAI,KAAK,CAAC,8BAA8B,KAAK,IAAI;QAC1F,UAAU,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC9D,CAAC;AAgBD;IA2BkB,WAAW;IACX,MAAM;IA3BP,KAAK,GAAG;QACvB,aAAa,EAAE;YACd;;;;;eAKG;YACH,KAAK,EAAE,IAAI,yBAAe,CAAqD,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;YAClI;;;;eAIG;YACH,QAAQ,EAAE,IAAI,yBAAe,CAAyC,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,uBAAuB,CAAC;SACjH;QACV;;WAEG;QACH,KAAK,EAAE,IAAI,yBAAe,CAA+C,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;KACnF,CAAC;IAEK,cAAc,GAAgK,EAAE,CAAC;IACjL,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzD,YACiB,WAAkC,EAClC,MAAuD;2BADvD,WAAW;sBACX,MAAM;IACpB,CAAC;CACJ;;AAWD;IA8BkB,OAAO;IACP,QAAQ;IACR,qBAAqB;IACrB,gBAAgB;IAChB,eAAe;IAjChB,KAAK,GAAG;QACvB;;WAEG;QACH,WAAW,EAAE,IAAI,2BAAiB,CAAK,EAAE,EAAE,aAAa,CAAC;QAEzD;;WAEG;QACH,wBAAwB,EAAE,IAAI,2BAAiB,CAAwB,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;QAC5G;;WAEG;QACH,kBAAkB,EAAE,IAAI,sBAAY,CAAsD,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;QACzH;;;WAGG;QACH,uBAAuB,EAAE,IAAI,yBAAe,CAAsD,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;QAE5J;;;WAGG;QACH,UAAU,EAAE,IAAI,yBAAe,CAA4B,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;KAC5E,CAAC;IACK,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEvD,YACiB,OAAyC,EACzC,QAAiB,EACjB,qBAA8B,EAC9B,gBAAgD,EAChD,eAAuB;uBAJvB,OAAO;wBACP,QAAQ;qCACR,qBAAqB;gCACrB,gBAAgB;+BAChB,eAAe;IAC7B,CAAC;CACJ"}

package/dist/api/coordinatable-emitter.d.ts

@@ -0,0 +1,27 @@
+import type { Compilation, Compiler, Configuration, WebpackPluginInstance } from "webpack";
+import type { UnifiedAssetsCacheEntry } from "./asset-information-emission";
+import { makeEntryManager } from "./entries";
+export type CoordinatedEmissionTargetBuilder = Readonly<[string, (baseConfig: Configuration, coordinator: RootCoordinatorPlugin) => Configuration]>;
+/**
+ * NOTE: Each instance of a given plugin MUST be restricted to a single compiler
+ */
+export declare abstract class CoordinatableEmitter implements WebpackPluginInstance {
+    abstract getCoordinatedEmissionTargets(): CoordinatedEmissionTargetBuilder[];
+    protected abstract readonly coordinator: RootCoordinatorPlugin;
+    abstract readonly provides: ReadonlyArray<string>;
+    abstract readonly requires: ReadonlyArray<string>;
+    abstract readonly defaultCompilationName: string | undefined;
+    apply(compiler: Compiler): void;
+    makeEntryManager(compiler: Compiler, compilation: Compilation, context: string, coordinatedLoaderName?: string | undefined): ReturnType<typeof makeEntryManager>;
+}
+export interface RootCoordinatorPlugin extends WebpackPluginInstance {
+    enableAssetPhpFileEmission(coordinatedLoaderName: string): void;
+    /**
+     * This is called automatically from within {@link CoordinatableEmitter#apply()}
+     */
+    registerDataEmitter(compiler: Compiler, emitter: CoordinatableEmitter, ...emissionTargets: string[]): void;
+    reportData(compilation: Compilation, emitter: CoordinatableEmitter, emissionTarget: string, data: Record<string, unknown> | unknown[]): void;
+    getHandles(compilation: Compilation): Promise<Record<string, UnifiedAssetsCacheEntry>>;
+    getData<T extends Record<string, unknown> | unknown[]>(emissionTarget: string): T[];
+}
+//# sourceMappingURL=coordinatable-emitter.d.ts.map

package/dist/api/coordinatable-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinatable-emitter.d.ts","sourceRoot":"","sources":["../../src/api/coordinatable-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,qBAAqB,EAAC,MAAM,SAAS,CAAC;AAEzF,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAC,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAE3C,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,KAAK,aAAa,CAAC,CAAC,CAAC;AAEpJ;;GAEG;AACH,8BAAsB,oBAAqB,YAAW,qBAAqB;IAC1E,QAAQ,CAAC,6BAA6B,IAAI,gCAAgC,EAAE,CAAC;IAE7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAA;IAE9D,kBAAyB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzD,kBAAyB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzD,kBAAyB,sBAAsB,EAAE,MAAM,GAAC,SAAS,CAAC;IAElE,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE9B;IAED,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,qBAAmB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAK7J;CACD;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IACnE,0BAA0B,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE3G,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAE3I,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAEvF,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAC,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CAClF"}

package/dist/api/coordinatable-emitter.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoordinatableEmitter = void 0;
+const entries_1 = require("./entries");
+/**
+ * NOTE: Each instance of a given plugin MUST be restricted to a single compiler
+ */
+class CoordinatableEmitter {
+    apply(compiler) {
+        this.coordinator.registerDataEmitter(compiler, this, ...this.provides);
+    }
+    makeEntryManager(compiler, compilation, context, coordinatedLoaderName = this.provides[0]) {
+        if (coordinatedLoaderName === undefined) {
+            throw new Error("A coordinated emitter name was somehow not provided. Please report this to Josh immediately");
+        }
+        return (0, entries_1.makeEntryManager)(compiler, compilation, context, coordinatedLoaderName);
+    }
+}
+exports.CoordinatableEmitter = CoordinatableEmitter;
+//# sourceMappingURL=coordinatable-emitter.js.map

package/dist/api/coordinatable-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinatable-emitter.js","sourceRoot":"","sources":["../../src/api/coordinatable-emitter.ts"],"names":[],"mappings":";;;AAGA,uCAA2C;AAI3C;;GAEG;AACH;IASC,KAAK,CAAC,QAAkB;QACvB,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED,gBAAgB,CAAC,QAAkB,EAAE,WAAwB,EAAE,OAAe,EAAE,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvH,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,6FAA6F,CAAC,CAAC;QAChH,CAAC;QACD,OAAO,IAAA,0BAAgB,EAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAChF,CAAC;CACD"}

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

@@ -0,0 +1,69 @@
+import type { EntryOptionPlugin, Entrypoint } from "webpack";
+import type { BaseHandleData, UnifiedAssetsCacheEntry } from "../asset-information-emission";
+import { type HandleAndDerivationMechanism, type HandleDerivationMechanism } from "../handle-derivation";
+import type { NormalizedEnqueuingControlFlags } from "./flag-logic";
+import { type EnqueuedAssetType, type EntrypointField, type NormalizedUsageLocations } from "./locations";
+export type MinEntryInfo = {
+    absoluteSrc: string;
+    name: string;
+    type: EnqueuedAssetType;
+};
+export type EntryOptions = ReturnType<typeof EntryOptionPlugin.entryDescriptionToOptions>;
+type PlauditEntryExtras = MinEntryInfo & {
+    flags: NormalizedEnqueuingControlFlags;
+    locations: NormalizedUsageLocations;
+    additionalDependencies: string[];
+    initialHandleName: HandleAndDerivationMechanism | false;
+    additionalSrcs?: string[];
+    baseDestination: string;
+    coordinatedLoaderName?: string;
+    staticallyLoaded?: boolean;
+    /**
+     * Defaults to false; note: this function returning true DOES NOT mean that the asset WILL be inlined - it just means that it MAY be inlined
+     */
+    mayInline?: (file: string, options: PlauditEntryOptions) => boolean;
+    /**
+     * This defaults to true if the asset is not going to be inlined and false otherwise
+     */
+    writeToDisk?: (file: string, options: PlauditEntryOptions) => boolean;
+    shouldOmitRegistration?: boolean;
+    computedHandleName?: string;
+    computedHandleArguments?: BaseHandleData['rest'];
+    intermediateInlineConfig?: {
+        deleteWhenDone: boolean;
+    };
+};
+export type NoOverrides<T extends object, Reserved> = Extract<keyof T, keyof Reserved> extends never ? T : never;
+export type PlauditEntryOptions<T extends object = object> = PlauditEntryExtras & EntryOptions & NoOverrides<T, PlauditEntryExtras | EntryOptions | 'handleConfig'>;
+export type HandleConfig<T extends PlauditEntryOptions = PlauditEntryOptions> = string | ((generatedHandle: string, options: Omit<T, 'initialHandleName'>) => string | undefined | HandleAndDerivationMechanism) | {
+    niceName: string;
+    fallbackNiceName?: string;
+    derivation?: HandleDerivationMechanism;
+};
+export type MinPlauditEntryOptions<T extends PlauditEntryOptions = PlauditEntryOptions> = Omit<T, Exclude<keyof EntryOptions, 'name'> | 'initialHandleName'>;
+export declare function makePlauditEntryOptions<T extends PlauditEntryOptions>(handleConfig: HandleConfig<T> | undefined, handlePrefix: string, handleSuffix: string, options: Omit<T, 'initialHandleName'>): Omit<T, 'initialHandleName'> & {
+    initialHandleName: HandleAndDerivationMechanism;
+};
+export declare function isPlauditEntryOptions(options: object | undefined): options is PlauditEntryOptions;
+export declare function getPlauditEntryOptions(entrypoint: Entrypoint): PlauditEntryOptions | undefined;
+export type BlockEntryOptions = PlauditEntryOptions<{
+    blockJsonAssetAbsoluteSrc: string;
+    originalEntrypointFieldValue?: string;
+    entrypointField: EntrypointField;
+}>;
+export declare function isBlockEntryOptions(options: PlauditEntryOptions): options is BlockEntryOptions;
+export declare function isBlockEntryOptionsHolder(entry: UnifiedAssetsCacheEntry): entry is UnifiedAssetsCacheEntry<BlockEntryOptions>;
+export type ExtensionEntryOptions = PlauditEntryOptions<{
+    blockSlug: string;
+    entrypointField: EntrypointField;
+}>;
+export declare function isExtensionEntryOptions(options: PlauditEntryOptions): options is ExtensionEntryOptions;
+export declare function isExtensionEntryOptionsHolder(entry: UnifiedAssetsCacheEntry): entry is UnifiedAssetsCacheEntry<ExtensionEntryOptions>;
+export type ObjectEntrypointJsonParseResult = {
+    entrypointName: string;
+    filename: string;
+    additionalSrcFilenames?: string[];
+};
+export declare function parseEntrypointsJson(entrypointsJsonPath: string): Promise<(string | ObjectEntrypointJsonParseResult)[]>;
+export {};
+//# sourceMappingURL=dependencies.d.ts.map

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

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

package/dist/api/entries/dependencies.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makePlauditEntryOptions = makePlauditEntryOptions;
+exports.isPlauditEntryOptions = isPlauditEntryOptions;
+exports.getPlauditEntryOptions = getPlauditEntryOptions;
+exports.isBlockEntryOptions = isBlockEntryOptions;
+exports.isBlockEntryOptionsHolder = isBlockEntryOptionsHolder;
+exports.isExtensionEntryOptions = isExtensionEntryOptions;
+exports.isExtensionEntryOptionsHolder = isExtensionEntryOptionsHolder;
+exports.parseEntrypointsJson = parseEntrypointsJson;
+const promises_1 = require("node:fs/promises");
+const utils_1 = require("../../utils");
+const handle_derivation_1 = require("../handle-derivation");
+const locations_1 = require("./locations");
+function makePlauditEntryOptions(handleConfig, handlePrefix, handleSuffix, options) {
+    return { ...options, initialHandleName: (0, handle_derivation_1.convertHandleConfigToEmittableHandle)(handleConfig, handlePrefix, handleSuffix, options) };
+}
+function isPlauditEntryOptions(options) {
+    return !!options &&
+        ('type' in options && (0, locations_1.isEnqueuedAssetType)(options.type)) &&
+        ('flags' in options && typeof options.flags === 'object' && !!options.flags) &&
+        ('locations' in options && typeof options.locations === 'object' && !!options.locations) &&
+        ('baseDestination' in options && typeof options.baseDestination === 'string');
+}
+function getPlauditEntryOptions(entrypoint) {
+    return isPlauditEntryOptions(entrypoint.options) ? entrypoint.options : undefined;
+}
+function isBlockEntryOptions(options) {
+    return ('blockJsonAssetAbsoluteSrc' in options && typeof options.blockJsonAssetAbsoluteSrc === 'string') &&
+        ('entrypointField' in options && (0, locations_1.isEntrypointField)(options.entrypointField));
+}
+function isBlockEntryOptionsHolder(entry) {
+    return isBlockEntryOptions(entry.options);
+}
+function isExtensionEntryOptions(options) {
+    return ('blockSlug' in options && typeof options.blockSlug === 'string') && ('entrypointField' in options && (0, locations_1.isEntrypointField)(options.entrypointField));
+}
+function isExtensionEntryOptionsHolder(entry) {
+    return isExtensionEntryOptions(entry.options);
+}
+async function parseEntrypointsJson(entrypointsJsonPath) {
+    const entrypointsJson = JSON.parse(await (0, promises_1.readFile)(entrypointsJsonPath, 'utf-8'));
+    if (Array.isArray(entrypointsJson)) {
+        return entrypointsJson;
+    }
+    //TODO: CONSIDER: While this is more correct than the prior behavior (which was ignoring the key), it could cause errors
+    return Object.entries(entrypointsJson)
+        .map(([key, value]) => {
+        if (!Array.isArray(value)) {
+            if (value.import !== undefined) {
+                value = value.import;
+            }
+            else {
+                return undefined;
+            }
+        }
+        return (0, utils_1.hasAtLeastOneItem)(value) ? { entrypointName: key, filename: value[0], additionalSrcFilenames: value.slice(1) } : undefined;
+    })
+        .filter(v => v !== undefined);
+}
+//# sourceMappingURL=dependencies.js.map

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

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

package/dist/api/entries/flag-logic.d.ts

@@ -0,0 +1,37 @@
+declare const wordPressLoadingStrategies: readonly ['defer', 'async'];
+declare const namedStrategies: readonly ["defer", "async", "eager", "lazy"];
+export type LoadingStrategy = typeof namedStrategies[number];
+export type WordPressSupportedLoadingStrategy = typeof wordPressLoadingStrategies[number];
+export type ShorthandLoadingStrategy = Exclude<LoadingStrategy, WordPressSupportedLoadingStrategy>;
+export declare function isValidNamedStrategy(strategy: unknown): strategy is LoadingStrategy;
+export declare function isWordPressSupportedLoadingStrategy(strategy: unknown): strategy is WordPressSupportedLoadingStrategy;
+export declare function newInvalidLoadingStrategyError(strategy: unknown, file?: string): import("webpack").WebpackError;
+export declare function isDeferringLoadingStrategy(strategy: unknown): strategy is "async" | "defer";
+export type InFooter = boolean;
+export declare function isValidInFooter(in_footer: unknown): in_footer is InFooter;
+export declare function invalidInFooterError(in_footer: unknown, file?: string): import("webpack").WebpackError;
+declare const validFetchPriorities: readonly ["auto", "low", "high"];
+export type FetchPriority = typeof validFetchPriorities[number];
+export declare function isValidFetchPriority(fetchpriority: unknown): fetchpriority is FetchPriority;
+export declare function newInvalidFetchPriorityError(fetchpriority: unknown, file?: string): import("webpack").WebpackError;
+declare const validInliningPositionValues: readonly ['before', 'after'];
+export type InliningPosition = typeof validInliningPositionValues[number];
+export declare const defaultInliningPosition = "after";
+export declare function isValidInliningPositionValue(position: unknown): position is InliningPosition;
+export declare function newInvalidInliningPositionValueError(position: unknown, file?: string, useDefaultValueValue?: string): import("webpack").WebpackError;
+export declare function isEnqueuingControlFlag(prop: string): prop is keyof NormalizedEnqueuingControlFlags;
+export type NormalizedEnqueuingControlFlags = {
+    strategy?: WordPressSupportedLoadingStrategy;
+    in_footer?: InFooter;
+    inline?: InliningPosition;
+    fetchpriority?: FetchPriority;
+};
+export type EnqueuingControlFlags = {
+    [key in Exclude<keyof NormalizedEnqueuingControlFlags, 'strategy' | 'inline'>]?: NormalizedEnqueuingControlFlags[key] | false;
+} & {
+    strategy?: LoadingStrategy | false;
+    inline?: boolean | InliningPosition;
+};
+export declare function normalizeAndMergeEnqueuingControlFlags(rawFlags: EnqueuingControlFlags | undefined, computedFlags: NormalizedEnqueuingControlFlags | undefined, file?: string): NormalizedEnqueuingControlFlags;
+export {};
+//# sourceMappingURL=flag-logic.d.ts.map

package/dist/api/entries/flag-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-logic.d.ts","sourceRoot":"","sources":["../../../src/api/entries/flag-logic.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,0BAA0B,YAAI,OAAO,EAAE,OAAO,CAAU,CAAC;AAC/D,QAAA,MAAM,eAAe,8CAA4D,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,iCAAiC,GAAG,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC1F,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;AACnG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,eAAe,CAEnF;AACD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,iCAAiC,CAEpH;AACD,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,kCAI9E;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,iCAE3D;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAC/B,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,QAAQ,CAEzE;AACD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,kCAErE;AAED,QAAA,MAAM,oBAAoB,YAAI,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAChE,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,GAAG,aAAa,IAAI,aAAa,CAE3F;AACD,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,kCAEjF;AAED,QAAA,MAAM,2BAA2B,YAAI,QAAQ,EAAE,OAAO,CAAU,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAC1E,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAC/C,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,gBAAgB,CAE5F;AACD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,oBAAoB,SAAc,kCAKxH;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,+BAA+B,CAElG;AACD,MAAM,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,CAAC,EAAE,iCAAiC,CAAC;IAC7C,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;KAAE,GAAG,IAAI,OAAO,CAAC,MAAM,+BAA+B,EAAE,UAAU,GAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,+BAA+B,CAAC,GAAG,CAAC,GAAC,KAAK;CAAC,GAAC;IAAC,QAAQ,CAAC,EAAE,eAAe,GAAC,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,GAAC,gBAAgB,CAAA;CAAC,CAAC;AAEtO,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,qBAAqB,GAAC,SAAS,EAAE,aAAa,EAAE,+BAA+B,GAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,+BAA+B,CA4C1M"}

package/dist/api/entries/flag-logic.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultInliningPosition = void 0;
+exports.isValidNamedStrategy = isValidNamedStrategy;
+exports.isWordPressSupportedLoadingStrategy = isWordPressSupportedLoadingStrategy;
+exports.newInvalidLoadingStrategyError = newInvalidLoadingStrategyError;
+exports.isDeferringLoadingStrategy = isDeferringLoadingStrategy;
+exports.isValidInFooter = isValidInFooter;
+exports.invalidInFooterError = invalidInFooterError;
+exports.isValidFetchPriority = isValidFetchPriority;
+exports.newInvalidFetchPriorityError = newInvalidFetchPriorityError;
+exports.isValidInliningPositionValue = isValidInliningPositionValue;
+exports.newInvalidInliningPositionValueError = newInvalidInliningPositionValueError;
+exports.isEnqueuingControlFlag = isEnqueuingControlFlag;
+exports.normalizeAndMergeEnqueuingControlFlags = normalizeAndMergeEnqueuingControlFlags;
+const utils_1 = require("../../utils");
+const wordPressLoadingStrategies = ['defer', 'async'];
+const namedStrategies = [...wordPressLoadingStrategies, 'eager', 'lazy'];
+function isValidNamedStrategy(strategy) {
+    return namedStrategies.includes(strategy);
+}
+function isWordPressSupportedLoadingStrategy(strategy) {
+    return wordPressLoadingStrategies.includes(strategy);
+}
+function newInvalidLoadingStrategyError(strategy, file) {
+    return (0, utils_1.newWebpackErrorForFile)({
+        text: "The strategy value is invalid", received: strategy, expected: `boolean|'${namedStrategies.join("'|'")}'|undefined`, display: 'type'
+    }, file);
+}
+function isDeferringLoadingStrategy(strategy) {
+    return strategy === 'async' || strategy === 'defer';
+}
+function isValidInFooter(in_footer) {
+    return typeof in_footer === 'boolean';
+}
+function invalidInFooterError(in_footer, file) {
+    return (0, utils_1.newWebpackErrorForFile)({ text: "The in_footer value is invalid", received: in_footer, expected: "boolean|undefined", display: 'type' }, file);
+}
+const validFetchPriorities = ["auto", "low", "high"];
+function isValidFetchPriority(fetchpriority) {
+    return validFetchPriorities.includes(fetchpriority);
+}
+function newInvalidFetchPriorityError(fetchpriority, file) {
+    return (0, utils_1.newWebpackErrorForFile)({ text: "The fetchpriority value is invalid", received: fetchpriority, expected: "'auto'|'low'|'high'|undefined", display: 'type' }, file);
+}
+const validInliningPositionValues = ['before', 'after'];
+exports.defaultInliningPosition = 'after';
+function isValidInliningPositionValue(position) {
+    return validInliningPositionValues.includes(position);
+}
+function newInvalidInliningPositionValueError(position, file, useDefaultValueValue = 'undefined') {
+    return (0, utils_1.newWebpackErrorForFile)({
+        text: "The inlining position value is invalid", received: position,
+        expected: `'${validInliningPositionValues.join("'|'")}'|${useDefaultValueValue}`, display: 'type'
+    }, file);
+}
+function isEnqueuingControlFlag(prop) {
+    return ['strategy', 'in_footer', 'inline', 'fetchpriority', 'lazyLoader'].includes(prop);
+}
+function normalizeAndMergeEnqueuingControlFlags(rawFlags, computedFlags, file) {
+    if (rawFlags === undefined || !Object.values(rawFlags).some(v => v !== undefined)) {
+        return computedFlags ?? {};
+    }
+    const res = computedFlags ? { ...computedFlags } : {};
+    if (rawFlags.strategy === 'eager') {
+        res.in_footer = false;
+    }
+    else if (rawFlags.strategy === 'lazy') {
+        res.strategy = 'defer';
+        res.in_footer = true;
+    }
+    else if (isWordPressSupportedLoadingStrategy(rawFlags.strategy)) {
+        res.strategy = rawFlags.strategy;
+    }
+    else if (rawFlags.strategy === false) {
+        delete res.strategy;
+    }
+    else if (rawFlags.strategy !== undefined) {
+        throw (0, utils_1.newWebpackErrorForFile)(`Encountered an unsupported strategy value: '${rawFlags.strategy}'. Please resolve the issue or report it immediately if you believe that this message is in incorrect`, file);
+    }
+    if (rawFlags.in_footer !== undefined) {
+        if (typeof rawFlags.in_footer !== 'boolean') {
+            throw (0, utils_1.newWebpackErrorForFile)(`Encountered an unsupported in_footer value: '${rawFlags.strategy}'. Please resolve the issue or report it immediately if you believe that this message is in incorrect`, file);
+        }
+        res.in_footer = rawFlags.in_footer;
+    }
+    if (rawFlags.inline === true) {
+        res.inline ??= exports.defaultInliningPosition;
+    }
+    else if (rawFlags.inline === false) {
+        delete res.inline;
+    }
+    else if (isValidInliningPositionValue(rawFlags.inline)) {
+        res.inline = rawFlags.inline;
+    }
+    else if (rawFlags.inline !== undefined) {
+        throw newInvalidInliningPositionValueError(rawFlags.inline, file, 'boolean|undefined');
+    }
+    if (rawFlags.fetchpriority === false) {
+        delete res.fetchpriority;
+    }
+    else if (isValidFetchPriority(rawFlags.fetchpriority)) {
+        res.fetchpriority = rawFlags.fetchpriority;
+    }
+    else if (rawFlags.fetchpriority !== undefined) {
+        throw newInvalidFetchPriorityError(rawFlags.fetchpriority, file);
+    }
+    return res;
+}
+//# sourceMappingURL=flag-logic.js.map

package/dist/api/entries/flag-logic.js.map

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