1

wwl

2025-07-30 61b58bd03d04d2eb50ac2d93a188c819fe67e01e

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
/*
    MIT License http://www.opensource.org/licenses/mit-license.php
    Author Tobias Koppers @sokra
*/
 
"use strict";
 
const { ModuleExternalInitFragment } = require("./ExternalModule");
const ExternalModuleFactoryPlugin = require("./ExternalModuleFactoryPlugin");
const ConcatenatedModule = require("./optimize/ConcatenatedModule");
 
/** @typedef {import("../declarations/WebpackOptions").Externals} Externals */
/** @typedef {import("./Compiler")} Compiler */
/** @typedef {import("./optimize/ConcatenatedModule").ConcatenatedModuleInfo} ConcatenatedModuleInfo */
 
const PLUGIN_NAME = "ExternalsPlugin";
 
class ExternalsPlugin {
    /**
     * @param {string | undefined} type default external type
     * @param {Externals} externals externals config
     */
    constructor(type, externals) {
        this.type = type;
        this.externals = externals;
    }
 
    /**
     * Apply the plugin
     * @param {Compiler} compiler the compiler instance
     * @returns {void}
     */
    apply(compiler) {
        compiler.hooks.compile.tap(PLUGIN_NAME, ({ normalModuleFactory }) => {
            new ExternalModuleFactoryPlugin(this.type, this.externals).apply(
                normalModuleFactory
            );
        });
 
        compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
            const { concatenatedModuleInfo } =
                ConcatenatedModule.getCompilationHooks(compilation);
            concatenatedModuleInfo.tap(PLUGIN_NAME, (updatedInfo, moduleInfo) => {
                const rawExportMap =
                    /** @type {ConcatenatedModuleInfo} */ updatedInfo.rawExportMap;
 
                if (!rawExportMap) {
                    return;
                }
 
                const chunkInitFragments =
                    /** @type {ConcatenatedModuleInfo} */ moduleInfo.chunkInitFragments;
                const moduleExternalInitFragments = chunkInitFragments
                    ? chunkInitFragments.filter(
                            (fragment) => fragment instanceof ModuleExternalInitFragment
                        )
                    : [];
 
                let initFragmentChanged = false;
 
                for (const fragment of moduleExternalInitFragments) {
                    const imported = fragment.getImported();
 
                    if (Array.isArray(imported)) {
                        const newImported = imported.map(([specifier, finalName]) => [
                            specifier,
                            rawExportMap.has(specifier)
                                ? rawExportMap.get(specifier)
                                : finalName
                        ]);
                        fragment.setImported(newImported);
                        initFragmentChanged = true;
                    }
                }
 
                if (initFragmentChanged) {
                    return true;
                }
            });
        });
    }
}
 
module.exports = ExternalsPlugin;