source: frontend/node_modules/webpack/lib/web/FetchCompileWasmPlugin.js

/*
        MIT License http://www.opensource.org/licenses/mit-license.php
        Author Tobias Koppers @sokra
*/

"use strict";

const { WEBASSEMBLY_MODULE_TYPE_SYNC } = require("../ModuleTypeConstants");
const RuntimeGlobals = require("../RuntimeGlobals");
const WasmChunkLoadingRuntimeModule = require("../wasm-sync/WasmChunkLoadingRuntimeModule");

/** @typedef {import("../Chunk")} Chunk */
/** @typedef {import("../Compiler")} Compiler */

/**
 * Options that influence how synchronous WebAssembly modules are emitted for
 * the fetch-based wasm loading runtime.
 * @typedef {object} FetchCompileWasmPluginOptions
 * @property {boolean=} mangleImports mangle imports
 */

const PLUGIN_NAME = "FetchCompileWasmPlugin";

/**
 * Enables synchronous WebAssembly chunk loading that fetches `.wasm` files and
 * compiles them in browser-like environments.
 */
class FetchCompileWasmPlugin {
        /**
         * Stores options that affect generated synchronous WebAssembly runtime code.
         * @param {FetchCompileWasmPluginOptions=} options options
         */
        constructor(options = {}) {
                /** @type {FetchCompileWasmPluginOptions} */
                this.options = options;
        }

        /**
         * Registers compilation hooks that attach the fetch-based synchronous wasm
         * runtime module to chunks containing sync WebAssembly modules.
         * @param {Compiler} compiler the compiler instance
         * @returns {void}
         */
        apply(compiler) {
                compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
                        const globalWasmLoading = compilation.outputOptions.wasmLoading;
                        /**
                         * Determines whether the chunk should load synchronous WebAssembly
                         * binaries through the `fetch` backend.
                         * @param {Chunk} chunk chunk
                         * @returns {boolean} true, if wasm loading is enabled for the chunk
                         */
                        const isEnabledForChunk = (chunk) => {
                                const options = chunk.getEntryOptions();
                                const wasmLoading =
                                        options && options.wasmLoading !== undefined
                                                ? options.wasmLoading
                                                : globalWasmLoading;
                                return wasmLoading === "fetch";
                        };
                        /**
                         * Generates the runtime expression that downloads the emitted wasm
                         * binary for a module.
                         * @param {string} path path to the wasm file
                         * @returns {string} code to load the wasm file
                         */
                        const generateLoadBinaryCode = (path) =>
                                `fetch(${RuntimeGlobals.publicPath} + ${path})`;

                        compilation.hooks.runtimeRequirementInTree
                                .for(RuntimeGlobals.ensureChunkHandlers)
                                .tap(PLUGIN_NAME, (chunk, set, { chunkGraph }) => {
                                        if (!isEnabledForChunk(chunk)) return;
                                        if (
                                                !chunkGraph.hasModuleInGraph(
                                                        chunk,
                                                        (m) => m.type === WEBASSEMBLY_MODULE_TYPE_SYNC
                                                )
                                        ) {
                                                return;
                                        }
                                        set.add(RuntimeGlobals.moduleCache);
                                        set.add(RuntimeGlobals.publicPath);
                                        compilation.addRuntimeModule(
                                                chunk,
                                                new WasmChunkLoadingRuntimeModule({
                                                        generateLoadBinaryCode,
                                                        supportsStreaming: true,
                                                        mangleImports: this.options.mangleImports,
                                                        runtimeRequirements: set
                                                })
                                        );
                                });
                });
        }
}

module.exports = FetchCompileWasmPlugin;