summaryrefslogtreecommitdiff
path: root/node_modules/webpack/lib/util/chainedImports.js
diff options
context:
space:
mode:
authorlittleblack111 <littleblack11111@gmail.com>2024-08-30 17:21:18 +0800
committerlittleblack111 <littleblack11111@gmail.com>2024-08-30 17:21:18 +0800
commitefbc2ffe6a1ee5ec38a4396305561d6515d0943e (patch)
tree2b4c94f18f2c792dfda813050755d5c0273fae22 /node_modules/webpack/lib/util/chainedImports.js
parent43acceb75957c880a5ba5a31aae221394a36d5f6 (diff)
node fixes, updates
Diffstat (limited to 'node_modules/webpack/lib/util/chainedImports.js')
-rw-r--r--node_modules/webpack/lib/util/chainedImports.js97
1 files changed, 97 insertions, 0 deletions
diff --git a/node_modules/webpack/lib/util/chainedImports.js b/node_modules/webpack/lib/util/chainedImports.js
new file mode 100644
index 00000000..295233b7
--- /dev/null
+++ b/node_modules/webpack/lib/util/chainedImports.js
@@ -0,0 +1,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;
+}