优化QC模块样式统一和功能完善

啊鑫

2025-07-17 eaa506e57403d1b8502f16ca5dd6e82c347724d0

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
85
86
87
88
89
90
91
92
93
94
95
96
97
/*
    MIT License http://www.opensource.org/licenses/mit-license.php
    Author Tobias Koppers @sokra
*/
 
"use strict";
 
/** @typedef {import("../Dependency")} Dependency */
/** @typedef {import("../Module")} Module */
/** @typedef {import("../ModuleGraph")} ModuleGraph */
/** @typedef {import("../javascript/JavascriptParser").Range} Range */
 
/**
 * @summary Get the subset of ids and their corresponding range in an id chain that should be re-rendered by webpack.
 * Only those in the chain that are actually referring to namespaces or imports should be re-rendered.
 * Deeper member accessors on the imported object should not be re-rendered.  If deeper member accessors are re-rendered,
 * there is a potential loss of meaning with rendering a quoted accessor as an unquoted accessor, or vice versa,
 * because minifiers treat quoted accessors differently.  e.g. import { a } from "./module"; a["b"] vs a.b
 * @param {string[]} untrimmedIds chained ids
 * @param {Range} untrimmedRange range encompassing allIds
 * @param {Range[] | undefined} ranges cumulative range of ids for each of allIds
 * @param {ModuleGraph} moduleGraph moduleGraph
 * @param {Dependency} dependency dependency
 * @returns {{trimmedIds: string[], trimmedRange: Range}} computed trimmed ids and cumulative range of those ids
 */
module.exports.getTrimmedIdsAndRange = (
    untrimmedIds,
    untrimmedRange,
    ranges,
    moduleGraph,
    dependency
) => {
    let trimmedIds = trimIdsToThoseImported(
        untrimmedIds,
        moduleGraph,
        dependency
    );
    let trimmedRange = untrimmedRange;
    if (trimmedIds.length !== untrimmedIds.length) {
        // The array returned from dep.idRanges is right-aligned with the array returned from dep.names.
        // Meaning, the two arrays may not always have the same number of elements, but the last element of
        // dep.idRanges corresponds to [the expression fragment to the left of] the last element of dep.names.
        // Use this to find the correct replacement range based on the number of ids that were trimmed.
        const idx =
            ranges === undefined
                ? -1 /* trigger failure case below */
                : ranges.length + (trimmedIds.length - untrimmedIds.length);
        if (idx < 0 || idx >= /** @type {Range[]} */ (ranges).length) {
            // cspell:ignore minifiers
            // Should not happen but we can't throw an error here because of backward compatibility with
            // external plugins in wp5.  Instead, we just disable trimming for now.  This may break some minifiers.
            trimmedIds = untrimmedIds;
            // TODO webpack 6 remove the "trimmedIds = ids" above and uncomment the following line instead.
            // throw new Error("Missing range starts data for id replacement trimming.");
        } else {
            trimmedRange = /** @type {Range[]} */ (ranges)[idx];
        }
    }
 
    return { trimmedIds, trimmedRange };
};
 
/**
 * @summary Determine which IDs in the id chain are actually referring to namespaces or imports,
 * and which are deeper member accessors on the imported object.
 * @param {string[]} ids untrimmed ids
 * @param {ModuleGraph} moduleGraph moduleGraph
 * @param {Dependency} dependency dependency
 * @returns {string[]} trimmed ids
 */
function trimIdsToThoseImported(ids, moduleGraph, dependency) {
    /** @type {string[]} */
    let trimmedIds = [];
    let currentExportsInfo = moduleGraph.getExportsInfo(
        /** @type {Module} */ (moduleGraph.getModule(dependency))
    );
    for (let i = 0; i < ids.length; i++) {
        if (i === 0 && ids[i] === "default") {
            continue; // ExportInfo for the next level under default is still at the root ExportsInfo, so don't advance currentExportsInfo
        }
        const exportInfo = currentExportsInfo.getExportInfo(ids[i]);
        if (exportInfo.provided === false) {
            // json imports have nested ExportInfo for elements that things that are not actually exported, so check .provided
            trimmedIds = ids.slice(0, i);
            break;
        }
        const nestedInfo = exportInfo.getNestedExportsInfo();
        if (!nestedInfo) {
            // once all nested exports are traversed, the next item is the actual import so stop there
            trimmedIds = ids.slice(0, i + 1);
            break;
        }
        currentExportsInfo = nestedInfo;
    }
    // Never trim to nothing.  This can happen for invalid imports (e.g. import { notThere } from "./module", or import { anything } from "./missingModule")
    return trimmedIds.length ? trimmedIds : ids;
}