aboutsummaryrefslogtreecommitdiff
path: root/node_modules/webpack/lib/Template.js
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/webpack/lib/Template.js')
-rw-r--r--node_modules/webpack/lib/Template.js466
1 files changed, 290 insertions, 176 deletions
diff --git a/node_modules/webpack/lib/Template.js b/node_modules/webpack/lib/Template.js
index 57a8b9730..572d4b5ed 100644
--- a/node_modules/webpack/lib/Template.js
+++ b/node_modules/webpack/lib/Template.js
@@ -1,176 +1,290 @@
-/*
- MIT License http://www.opensource.org/licenses/mit-license.php
- Author Tobias Koppers @sokra
-*/
-"use strict";
-
-const Tapable = require("tapable");
-const ConcatSource = require("webpack-sources").ConcatSource;
-
-const START_LOWERCASE_ALPHABET_CODE = "a".charCodeAt(0);
-const START_UPPERCASE_ALPHABET_CODE = "A".charCodeAt(0);
-const DELTA_A_TO_Z = "z".charCodeAt(0) - START_LOWERCASE_ALPHABET_CODE + 1;
-const FUNCTION_CONTENT_REGEX = /^function\s?\(\)\s?\{\n?|\n?\}$/g;
-const INDENT_MULTILINE_REGEX = /^\t/mg;
-const IDENTIFIER_NAME_REPLACE_REGEX = /^[^a-zA-Z$_]/;
-const IDENTIFIER_ALPHA_NUMERIC_NAME_REPLACE_REGEX = /[^a-zA-Z0-9$_]/g;
-const PATH_NAME_NORMALIZE_REPLACE_REGEX = /[^a-zA-Z0-9_!§$()=\-^°]+/g;
-const MATCH_PADDED_HYPHENS_REPLACE_REGEX = /^-|-$/g;
-
-module.exports = class Template extends Tapable {
- constructor(outputOptions) {
- super();
- this.outputOptions = outputOptions || {};
- }
-
- static getFunctionContent(fn) {
- return fn.toString().replace(FUNCTION_CONTENT_REGEX, "").replace(INDENT_MULTILINE_REGEX, "");
- }
-
- static toIdentifier(str) {
- if(typeof str !== "string") return "";
- return str.replace(IDENTIFIER_NAME_REPLACE_REGEX, "_").replace(IDENTIFIER_ALPHA_NUMERIC_NAME_REPLACE_REGEX, "_");
- }
-
- static toPath(str) {
- if(typeof str !== "string") return "";
- return str.replace(PATH_NAME_NORMALIZE_REPLACE_REGEX, "-").replace(MATCH_PADDED_HYPHENS_REPLACE_REGEX, "");
- }
-
- // map number to a single character a-z, A-Z or <_ + number> if number is too big
- static numberToIdentifer(n) {
- // lower case
- if(n < DELTA_A_TO_Z) return String.fromCharCode(START_LOWERCASE_ALPHABET_CODE + n);
-
- // upper case
- n -= DELTA_A_TO_Z;
- if(n < DELTA_A_TO_Z) return String.fromCharCode(START_UPPERCASE_ALPHABET_CODE + n);
-
- // fall back to _ + number
- n -= DELTA_A_TO_Z;
- return "_" + n;
- }
-
- indent(str) {
- if(Array.isArray(str)) {
- return str.map(this.indent.bind(this)).join("\n");
- } else {
- str = str.trimRight();
- if(!str) return "";
- var ind = (str[0] === "\n" ? "" : "\t");
- return ind + str.replace(/\n([^\n])/g, "\n\t$1");
- }
- }
-
- prefix(str, prefix) {
- if(Array.isArray(str)) {
- str = str.join("\n");
- }
- str = str.trim();
- if(!str) return "";
- const ind = (str[0] === "\n" ? "" : prefix);
- return ind + str.replace(/\n([^\n])/g, "\n" + prefix + "$1");
- }
-
- asString(str) {
- if(Array.isArray(str)) {
- return str.join("\n");
- }
- return str;
- }
-
- getModulesArrayBounds(modules) {
- if(!modules.every(moduleIdIsNumber))
- return false;
- var maxId = -Infinity;
- var minId = Infinity;
- modules.forEach(function(module) {
- if(maxId < module.id) maxId = module.id;
- if(minId > module.id) minId = module.id;
- });
- if(minId < 16 + ("" + minId).length) {
- // add minId x ',' instead of 'Array(minId).concat(...)'
- minId = 0;
- }
- var objectOverhead = modules.map(function(module) {
- var idLength = (module.id + "").length;
- return idLength + 2;
- }).reduce(function(a, b) {
- return a + b;
- }, -1);
- var arrayOverhead = minId === 0 ? maxId : 16 + ("" + minId).length + maxId;
- return arrayOverhead < objectOverhead ? [minId, maxId] : false;
- }
-
- renderChunkModules(chunk, moduleTemplate, dependencyTemplates, prefix) {
- if(!prefix) prefix = "";
- var source = new ConcatSource();
- if(chunk.getNumberOfModules() === 0) {
- source.add("[]");
- return source;
- }
- var removedModules = chunk.removedModules;
- var allModules = chunk.mapModules(function(module) {
- return {
- id: module.id,
- source: moduleTemplate.render(module, dependencyTemplates, chunk)
- };
- });
- if(removedModules && removedModules.length > 0) {
- removedModules.forEach(function(id) {
- allModules.push({
- id: id,
- source: "false"
- });
- });
- }
- var bounds = this.getModulesArrayBounds(allModules);
-
- if(bounds) {
- // Render a spare array
- var minId = bounds[0];
- var maxId = bounds[1];
- if(minId !== 0) source.add("Array(" + minId + ").concat(");
- source.add("[\n");
- var modules = {};
- allModules.forEach(function(module) {
- modules[module.id] = module;
- });
- for(var idx = minId; idx <= maxId; idx++) {
- var module = modules[idx];
- if(idx !== minId) source.add(",\n");
- source.add("/* " + idx + " */");
- if(module) {
- source.add("\n");
- source.add(module.source);
- }
- }
- source.add("\n" + prefix + "]");
- if(minId !== 0) source.add(")");
- } else {
- // Render an object
- source.add("{\n");
- allModules
- .sort(stringifyIdSortPredicate)
- .forEach(function(module, idx) {
- if(idx !== 0) source.add(",\n");
- source.add(`\n/***/ ${JSON.stringify(module.id)}:\n`);
- source.add(module.source);
- });
- source.add("\n\n" + prefix + "}");
- }
- return source;
- }
-};
-
-function stringifyIdSortPredicate(a, b) {
- var aId = a.id + "";
- var bId = b.id + "";
- if(aId < bId) return -1;
- if(aId > bId) return 1;
- return 0;
-}
-
-function moduleIdIsNumber(module) {
- return typeof module.id === "number";
-}
+/*
+ MIT License http://www.opensource.org/licenses/mit-license.php
+ Author Tobias Koppers @sokra
+*/
+/** @typedef {import("./Module")} Module */
+/** @typedef {import("./Chunk")} Chunk */
+/** @typedef {import("./ModuleTemplate")} ModuleTemplate */
+/** @typedef {import("webpack-sources").ConcatSource} ConcatSource */
+
+const { ConcatSource } = require("webpack-sources");
+const HotUpdateChunk = require("./HotUpdateChunk");
+
+const START_LOWERCASE_ALPHABET_CODE = "a".charCodeAt(0);
+const START_UPPERCASE_ALPHABET_CODE = "A".charCodeAt(0);
+const DELTA_A_TO_Z = "z".charCodeAt(0) - START_LOWERCASE_ALPHABET_CODE + 1;
+const FUNCTION_CONTENT_REGEX = /^function\s?\(\)\s?\{\r?\n?|\r?\n?\}$/g;
+const INDENT_MULTILINE_REGEX = /^\t/gm;
+const LINE_SEPARATOR_REGEX = /\r?\n/g;
+const IDENTIFIER_NAME_REPLACE_REGEX = /^([^a-zA-Z$_])/;
+const IDENTIFIER_ALPHA_NUMERIC_NAME_REPLACE_REGEX = /[^a-zA-Z0-9$]+/g;
+const COMMENT_END_REGEX = /\*\//g;
+const PATH_NAME_NORMALIZE_REPLACE_REGEX = /[^a-zA-Z0-9_!§$()=\-^°]+/g;
+const MATCH_PADDED_HYPHENS_REPLACE_REGEX = /^-|-$/g;
+
+/** @typedef {import("webpack-sources").Source} Source */
+
+/**
+ * @typedef {Object} HasId
+ * @property {number | string} id
+ */
+
+/**
+ * @typedef {function(Module, number): boolean} ModuleFilterPredicate
+ */
+
+/**
+ * @param {HasId} a first id object to be sorted
+ * @param {HasId} b second id object to be sorted against
+ * @returns {-1|0|1} the sort value
+ */
+const stringifyIdSortPredicate = (a, b) => {
+ const aId = a.id + "";
+ const bId = b.id + "";
+ if (aId < bId) return -1;
+ if (aId > bId) return 1;
+ return 0;
+};
+
+class Template {
+ /**
+ *
+ * @param {Function} fn - a runtime function (.runtime.js) "template"
+ * @returns {string} the updated and normalized function string
+ */
+ static getFunctionContent(fn) {
+ return fn
+ .toString()
+ .replace(FUNCTION_CONTENT_REGEX, "")
+ .replace(INDENT_MULTILINE_REGEX, "")
+ .replace(LINE_SEPARATOR_REGEX, "\n");
+ }
+
+ /**
+ * @param {string} str the string converted to identifier
+ * @returns {string} created identifier
+ */
+ static toIdentifier(str) {
+ if (typeof str !== "string") return "";
+ return str
+ .replace(IDENTIFIER_NAME_REPLACE_REGEX, "_$1")
+ .replace(IDENTIFIER_ALPHA_NUMERIC_NAME_REPLACE_REGEX, "_");
+ }
+ /**
+ *
+ * @param {string} str string to be converted to commented in bundle code
+ * @returns {string} returns a commented version of string
+ */
+ static toComment(str) {
+ if (!str) return "";
+ return `/*! ${str.replace(COMMENT_END_REGEX, "* /")} */`;
+ }
+
+ /**
+ *
+ * @param {string} str string to be converted to "normal comment"
+ * @returns {string} returns a commented version of string
+ */
+ static toNormalComment(str) {
+ if (!str) return "";
+ return `/* ${str.replace(COMMENT_END_REGEX, "* /")} */`;
+ }
+
+ /**
+ * @param {string} str string path to be normalized
+ * @returns {string} normalized bundle-safe path
+ */
+ static toPath(str) {
+ if (typeof str !== "string") return "";
+ return str
+ .replace(PATH_NAME_NORMALIZE_REPLACE_REGEX, "-")
+ .replace(MATCH_PADDED_HYPHENS_REPLACE_REGEX, "");
+ }
+
+ // map number to a single character a-z, A-Z or <_ + number> if number is too big
+ /**
+ *
+ * @param {number} n number to convert to ident
+ * @returns {string} returns single character ident
+ */
+ static numberToIdentifer(n) {
+ // lower case
+ if (n < DELTA_A_TO_Z) {
+ return String.fromCharCode(START_LOWERCASE_ALPHABET_CODE + n);
+ }
+
+ // upper case
+ if (n < DELTA_A_TO_Z * 2) {
+ return String.fromCharCode(
+ START_UPPERCASE_ALPHABET_CODE + n - DELTA_A_TO_Z
+ );
+ }
+
+ // use multiple letters
+ return (
+ Template.numberToIdentifer(n % (2 * DELTA_A_TO_Z)) +
+ Template.numberToIdentifer(Math.floor(n / (2 * DELTA_A_TO_Z)))
+ );
+ }
+
+ /**
+ *
+ * @param {string | string[]} s string to convert to identity
+ * @returns {string} converted identity
+ */
+ static indent(s) {
+ if (Array.isArray(s)) {
+ return s.map(Template.indent).join("\n");
+ } else {
+ const str = s.trimRight();
+ if (!str) return "";
+ const ind = str[0] === "\n" ? "" : "\t";
+ return ind + str.replace(/\n([^\n])/g, "\n\t$1");
+ }
+ }
+
+ /**
+ *
+ * @param {string|string[]} s string to create prefix for
+ * @param {string} prefix prefix to compose
+ * @returns {string} returns new prefix string
+ */
+ static prefix(s, prefix) {
+ const str = Template.asString(s).trim();
+ if (!str) return "";
+ const ind = str[0] === "\n" ? "" : prefix;
+ return ind + str.replace(/\n([^\n])/g, "\n" + prefix + "$1");
+ }
+
+ /**
+ *
+ * @param {string|string[]} str string or string collection
+ * @returns {string} returns a single string from array
+ */
+ static asString(str) {
+ if (Array.isArray(str)) {
+ return str.join("\n");
+ }
+ return str;
+ }
+
+ /**
+ * @typedef {Object} WithId
+ * @property {string|number} id
+ */
+
+ /**
+ * @param {WithId[]} modules a collection of modules to get array bounds for
+ * @returns {[number, number] | false} returns the upper and lower array bounds
+ * or false if not every module has a number based id
+ */
+ static getModulesArrayBounds(modules) {
+ let maxId = -Infinity;
+ let minId = Infinity;
+ for (const module of modules) {
+ if (typeof module.id !== "number") return false;
+ if (maxId < module.id) maxId = /** @type {number} */ (module.id);
+ if (minId > module.id) minId = /** @type {number} */ (module.id);
+ }
+ if (minId < 16 + ("" + minId).length) {
+ // add minId x ',' instead of 'Array(minId).concat(…)'
+ minId = 0;
+ }
+ const objectOverhead = modules
+ .map(module => (module.id + "").length + 2)
+ .reduce((a, b) => a + b, -1);
+ const arrayOverhead =
+ minId === 0 ? maxId : 16 + ("" + minId).length + maxId;
+ return arrayOverhead < objectOverhead ? [minId, maxId] : false;
+ }
+
+ /**
+ * @param {Chunk} chunk chunk whose modules will be rendered
+ * @param {ModuleFilterPredicate} filterFn function used to filter modules from chunk to render
+ * @param {ModuleTemplate} moduleTemplate ModuleTemplate instance used to render modules
+ * @param {TODO | TODO[]} dependencyTemplates templates needed for each module to render dependencies
+ * @param {string=} prefix applying prefix strings
+ * @returns {ConcatSource} rendered chunk modules in a Source object
+ */
+ static renderChunkModules(
+ chunk,
+ filterFn,
+ moduleTemplate,
+ dependencyTemplates,
+ prefix = ""
+ ) {
+ const source = new ConcatSource();
+ const modules = chunk.getModules().filter(filterFn);
+ let removedModules;
+ if (chunk instanceof HotUpdateChunk) {
+ removedModules = chunk.removedModules;
+ }
+ if (
+ modules.length === 0 &&
+ (!removedModules || removedModules.length === 0)
+ ) {
+ source.add("[]");
+ return source;
+ }
+ /** @type {{id: string|number, source: Source|string}[]} */
+ const allModules = modules.map(module => {
+ return {
+ id: module.id,
+ source: moduleTemplate.render(module, dependencyTemplates, {
+ chunk
+ })
+ };
+ });
+ if (removedModules && removedModules.length > 0) {
+ for (const id of removedModules) {
+ allModules.push({
+ id,
+ source: "false"
+ });
+ }
+ }
+ const bounds = Template.getModulesArrayBounds(allModules);
+ if (bounds) {
+ // Render a spare array
+ const minId = bounds[0];
+ const maxId = bounds[1];
+ if (minId !== 0) {
+ source.add(`Array(${minId}).concat(`);
+ }
+ source.add("[\n");
+ const modules = new Map();
+ for (const module of allModules) {
+ modules.set(module.id, module);
+ }
+ for (let idx = minId; idx <= maxId; idx++) {
+ const module = modules.get(idx);
+ if (idx !== minId) {
+ source.add(",\n");
+ }
+ source.add(`/* ${idx} */`);
+ if (module) {
+ source.add("\n");
+ source.add(module.source);
+ }
+ }
+ source.add("\n" + prefix + "]");
+ if (minId !== 0) {
+ source.add(")");
+ }
+ } else {
+ // Render an object
+ source.add("{\n");
+ allModules.sort(stringifyIdSortPredicate).forEach((module, idx) => {
+ if (idx !== 0) {
+ source.add(",\n");
+ }
+ source.add(`\n/***/ ${JSON.stringify(module.id)}:\n`);
+ source.add(module.source);
+ });
+ source.add(`\n\n${prefix}}`);
+ }
+ return source;
+ }
+}
+
+module.exports = Template;