|
- "use strict";
-
- /** @typedef {import("@jridgewell/trace-mapping").SourceMapInput} SourceMapInput */
- /** @typedef {import("terser").FormatOptions} TerserFormatOptions */
- /** @typedef {import("terser").MinifyOptions} TerserOptions */
- /** @typedef {import("terser").CompressOptions} TerserCompressOptions */
- /** @typedef {import("terser").ECMA} TerserECMA */
- /** @typedef {import("./index.js").ExtractCommentsOptions} ExtractCommentsOptions */
- /** @typedef {import("./index.js").ExtractCommentsFunction} ExtractCommentsFunction */
- /** @typedef {import("./index.js").ExtractCommentsCondition} ExtractCommentsCondition */
- /** @typedef {import("./index.js").Input} Input */
- /** @typedef {import("./index.js").MinimizedResult} MinimizedResult */
- /** @typedef {import("./index.js").PredefinedOptions} PredefinedOptions */
- /** @typedef {import("./index.js").CustomOptions} CustomOptions */
-
- /**
- * @typedef {Array<string>} ExtractedComments
- */
-
- const notSettled = Symbol(`not-settled`);
-
- /**
- * @template T
- * @typedef {() => Promise<T>} Task
- */
-
- /**
- * Run tasks with limited concurrency.
- * @template T
- * @param {number} limit - Limit of tasks that run at once.
- * @param {Task<T>[]} tasks - List of tasks to run.
- * @returns {Promise<T[]>} A promise that fulfills to an array of the results
- */
- function throttleAll(limit, tasks) {
- if (!Number.isInteger(limit) || limit < 1) {
- throw new TypeError(`Expected \`limit\` to be a finite number > 0, got \`${limit}\` (${typeof limit})`);
- }
- if (!Array.isArray(tasks) || !tasks.every(task => typeof task === `function`)) {
- throw new TypeError(`Expected \`tasks\` to be a list of functions returning a promise`);
- }
- return new Promise((resolve, reject) => {
- const result = Array(tasks.length).fill(notSettled);
- const entries = tasks.entries();
- const next = () => {
- const {
- done,
- value
- } = entries.next();
- if (done) {
- const isLast = !result.includes(notSettled);
- if (isLast) resolve( /** @type{T[]} **/result);
- return;
- }
- const [index, task] = value;
-
- /**
- * @param {T} x
- */
- const onFulfilled = x => {
- result[index] = x;
- next();
- };
- task().then(onFulfilled, reject);
- };
- Array(limit).fill(0).forEach(next);
- });
- }
-
- /* istanbul ignore next */
- /**
- * @param {Input} input
- * @param {SourceMapInput | undefined} sourceMap
- * @param {PredefinedOptions & CustomOptions} minimizerOptions
- * @param {ExtractCommentsOptions | undefined} extractComments
- * @return {Promise<MinimizedResult>}
- */
- async function terserMinify(input, sourceMap, minimizerOptions, extractComments) {
- /**
- * @param {any} value
- * @returns {boolean}
- */
- const isObject = value => {
- const type = typeof value;
- return value != null && (type === "object" || type === "function");
- };
-
- /**
- * @param {TerserOptions & { sourceMap: undefined } & ({ output: TerserFormatOptions & { beautify: boolean } } | { format: TerserFormatOptions & { beautify: boolean } })} terserOptions
- * @param {ExtractedComments} extractedComments
- * @returns {ExtractCommentsFunction}
- */
- const buildComments = (terserOptions, extractedComments) => {
- /** @type {{ [index: string]: ExtractCommentsCondition }} */
- const condition = {};
- let comments;
- if (terserOptions.format) {
- ({
- comments
- } = terserOptions.format);
- } else if (terserOptions.output) {
- ({
- comments
- } = terserOptions.output);
- }
- condition.preserve = typeof comments !== "undefined" ? comments : false;
- if (typeof extractComments === "boolean" && extractComments) {
- condition.extract = "some";
- } else if (typeof extractComments === "string" || extractComments instanceof RegExp) {
- condition.extract = extractComments;
- } else if (typeof extractComments === "function") {
- condition.extract = extractComments;
- } else if (extractComments && isObject(extractComments)) {
- condition.extract = typeof extractComments.condition === "boolean" && extractComments.condition ? "some" : typeof extractComments.condition !== "undefined" ? extractComments.condition : "some";
- } else {
- // No extract
- // Preserve using "commentsOpts" or "some"
- condition.preserve = typeof comments !== "undefined" ? comments : "some";
- condition.extract = false;
- }
-
- // Ensure that both conditions are functions
- ["preserve", "extract"].forEach(key => {
- /** @type {undefined | string} */
- let regexStr;
- /** @type {undefined | RegExp} */
- let regex;
- switch (typeof condition[key]) {
- case "boolean":
- condition[key] = condition[key] ? () => true : () => false;
- break;
- case "function":
- break;
- case "string":
- if (condition[key] === "all") {
- condition[key] = () => true;
- break;
- }
- if (condition[key] === "some") {
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => (comment.type === "comment2" || comment.type === "comment1") && /@preserve|@lic|@cc_on|^\**!/i.test(comment.value);
- break;
- }
- regexStr = /** @type {string} */condition[key];
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => new RegExp( /** @type {string} */regexStr).test(comment.value);
- break;
- default:
- regex = /** @type {RegExp} */condition[key];
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => /** @type {RegExp} */regex.test(comment.value);
- }
- });
-
- // Redefine the comments function to extract and preserve
- // comments according to the two conditions
- return (astNode, comment) => {
- if ( /** @type {{ extract: ExtractCommentsFunction }} */
- condition.extract(astNode, comment)) {
- const commentText = comment.type === "comment2" ? `/*${comment.value}*/` : `//${comment.value}`;
-
- // Don't include duplicate comments
- if (!extractedComments.includes(commentText)) {
- extractedComments.push(commentText);
- }
- }
- return /** @type {{ preserve: ExtractCommentsFunction }} */condition.preserve(astNode, comment);
- };
- };
-
- /**
- * @param {PredefinedOptions & TerserOptions} [terserOptions={}]
- * @returns {TerserOptions & { sourceMap: undefined } & { compress: TerserCompressOptions } & ({ output: TerserFormatOptions & { beautify: boolean } } | { format: TerserFormatOptions & { beautify: boolean } })}
- */
- const buildTerserOptions = (terserOptions = {}) => {
- // Need deep copy objects to avoid https://github.com/terser/terser/issues/366
- return {
- ...terserOptions,
- compress: typeof terserOptions.compress === "boolean" ? terserOptions.compress ? {} : false : {
- ...terserOptions.compress
- },
- // ecma: terserOptions.ecma,
- // ie8: terserOptions.ie8,
- // keep_classnames: terserOptions.keep_classnames,
- // keep_fnames: terserOptions.keep_fnames,
- mangle: terserOptions.mangle == null ? true : typeof terserOptions.mangle === "boolean" ? terserOptions.mangle : {
- ...terserOptions.mangle
- },
- // module: terserOptions.module,
- // nameCache: { ...terserOptions.toplevel },
- // the `output` option is deprecated
- ...(terserOptions.format ? {
- format: {
- beautify: false,
- ...terserOptions.format
- }
- } : {
- output: {
- beautify: false,
- ...terserOptions.output
- }
- }),
- parse: {
- ...terserOptions.parse
- },
- // safari10: terserOptions.safari10,
- // Ignoring sourceMap from options
- // eslint-disable-next-line no-undefined
- sourceMap: undefined
- // toplevel: terserOptions.toplevel
- };
- };
-
- // eslint-disable-next-line global-require
- const {
- minify
- } = require("terser");
- // Copy `terser` options
- const terserOptions = buildTerserOptions(minimizerOptions);
-
- // Let terser generate a SourceMap
- if (sourceMap) {
- // @ts-ignore
- terserOptions.sourceMap = {
- asObject: true
- };
- }
-
- /** @type {ExtractedComments} */
- const extractedComments = [];
- if (terserOptions.output) {
- terserOptions.output.comments = buildComments(terserOptions, extractedComments);
- } else if (terserOptions.format) {
- terserOptions.format.comments = buildComments(terserOptions, extractedComments);
- }
- if (terserOptions.compress) {
- // More optimizations
- if (typeof terserOptions.compress.ecma === "undefined") {
- terserOptions.compress.ecma = terserOptions.ecma;
- }
-
- // https://github.com/webpack/webpack/issues/16135
- if (terserOptions.ecma === 5 && typeof terserOptions.compress.arrows === "undefined") {
- terserOptions.compress.arrows = false;
- }
- }
- const [[filename, code]] = Object.entries(input);
- const result = await minify({
- [filename]: code
- }, terserOptions);
- return {
- code: ( /** @type {string} **/result.code),
- // @ts-ignore
- // eslint-disable-next-line no-undefined
- map: result.map ? ( /** @type {SourceMapInput} **/result.map) : undefined,
- extractedComments
- };
- }
-
- /**
- * @returns {string | undefined}
- */
- terserMinify.getMinimizerVersion = () => {
- let packageJson;
- try {
- // eslint-disable-next-line global-require
- packageJson = require("terser/package.json");
- } catch (error) {
- // Ignore
- }
- return packageJson && packageJson.version;
- };
-
- /* istanbul ignore next */
- /**
- * @param {Input} input
- * @param {SourceMapInput | undefined} sourceMap
- * @param {PredefinedOptions & CustomOptions} minimizerOptions
- * @param {ExtractCommentsOptions | undefined} extractComments
- * @return {Promise<MinimizedResult>}
- */
- async function uglifyJsMinify(input, sourceMap, minimizerOptions, extractComments) {
- /**
- * @param {any} value
- * @returns {boolean}
- */
- const isObject = value => {
- const type = typeof value;
- return value != null && (type === "object" || type === "function");
- };
-
- /**
- * @param {import("uglify-js").MinifyOptions & { sourceMap: undefined } & { output: import("uglify-js").OutputOptions & { beautify: boolean }}} uglifyJsOptions
- * @param {ExtractedComments} extractedComments
- * @returns {ExtractCommentsFunction}
- */
- const buildComments = (uglifyJsOptions, extractedComments) => {
- /** @type {{ [index: string]: ExtractCommentsCondition }} */
- const condition = {};
- const {
- comments
- } = uglifyJsOptions.output;
- condition.preserve = typeof comments !== "undefined" ? comments : false;
- if (typeof extractComments === "boolean" && extractComments) {
- condition.extract = "some";
- } else if (typeof extractComments === "string" || extractComments instanceof RegExp) {
- condition.extract = extractComments;
- } else if (typeof extractComments === "function") {
- condition.extract = extractComments;
- } else if (extractComments && isObject(extractComments)) {
- condition.extract = typeof extractComments.condition === "boolean" && extractComments.condition ? "some" : typeof extractComments.condition !== "undefined" ? extractComments.condition : "some";
- } else {
- // No extract
- // Preserve using "commentsOpts" or "some"
- condition.preserve = typeof comments !== "undefined" ? comments : "some";
- condition.extract = false;
- }
-
- // Ensure that both conditions are functions
- ["preserve", "extract"].forEach(key => {
- /** @type {undefined | string} */
- let regexStr;
- /** @type {undefined | RegExp} */
- let regex;
- switch (typeof condition[key]) {
- case "boolean":
- condition[key] = condition[key] ? () => true : () => false;
- break;
- case "function":
- break;
- case "string":
- if (condition[key] === "all") {
- condition[key] = () => true;
- break;
- }
- if (condition[key] === "some") {
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => (comment.type === "comment2" || comment.type === "comment1") && /@preserve|@lic|@cc_on|^\**!/i.test(comment.value);
- break;
- }
- regexStr = /** @type {string} */condition[key];
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => new RegExp( /** @type {string} */regexStr).test(comment.value);
- break;
- default:
- regex = /** @type {RegExp} */condition[key];
- condition[key] = /** @type {ExtractCommentsFunction} */
- (astNode, comment) => /** @type {RegExp} */regex.test(comment.value);
- }
- });
-
- // Redefine the comments function to extract and preserve
- // comments according to the two conditions
- return (astNode, comment) => {
- if ( /** @type {{ extract: ExtractCommentsFunction }} */
- condition.extract(astNode, comment)) {
- const commentText = comment.type === "comment2" ? `/*${comment.value}*/` : `//${comment.value}`;
-
- // Don't include duplicate comments
- if (!extractedComments.includes(commentText)) {
- extractedComments.push(commentText);
- }
- }
- return /** @type {{ preserve: ExtractCommentsFunction }} */condition.preserve(astNode, comment);
- };
- };
-
- /**
- * @param {PredefinedOptions & import("uglify-js").MinifyOptions} [uglifyJsOptions={}]
- * @returns {import("uglify-js").MinifyOptions & { sourceMap: undefined } & { output: import("uglify-js").OutputOptions & { beautify: boolean }}}
- */
- const buildUglifyJsOptions = (uglifyJsOptions = {}) => {
- // eslint-disable-next-line no-param-reassign
- delete minimizerOptions.ecma;
- // eslint-disable-next-line no-param-reassign
- delete minimizerOptions.module;
-
- // Need deep copy objects to avoid https://github.com/terser/terser/issues/366
- return {
- ...uglifyJsOptions,
- // warnings: uglifyJsOptions.warnings,
- parse: {
- ...uglifyJsOptions.parse
- },
- compress: typeof uglifyJsOptions.compress === "boolean" ? uglifyJsOptions.compress : {
- ...uglifyJsOptions.compress
- },
- mangle: uglifyJsOptions.mangle == null ? true : typeof uglifyJsOptions.mangle === "boolean" ? uglifyJsOptions.mangle : {
- ...uglifyJsOptions.mangle
- },
- output: {
- beautify: false,
- ...uglifyJsOptions.output
- },
- // Ignoring sourceMap from options
- // eslint-disable-next-line no-undefined
- sourceMap: undefined
- // toplevel: uglifyJsOptions.toplevel
- // nameCache: { ...uglifyJsOptions.toplevel },
- // ie8: uglifyJsOptions.ie8,
- // keep_fnames: uglifyJsOptions.keep_fnames,
- };
- };
-
- // eslint-disable-next-line global-require, import/no-extraneous-dependencies
- const {
- minify
- } = require("uglify-js");
-
- // Copy `uglify-js` options
- const uglifyJsOptions = buildUglifyJsOptions(minimizerOptions);
-
- // Let terser generate a SourceMap
- if (sourceMap) {
- // @ts-ignore
- uglifyJsOptions.sourceMap = true;
- }
-
- /** @type {ExtractedComments} */
- const extractedComments = [];
-
- // @ts-ignore
- uglifyJsOptions.output.comments = buildComments(uglifyJsOptions, extractedComments);
- const [[filename, code]] = Object.entries(input);
- const result = await minify({
- [filename]: code
- }, uglifyJsOptions);
- return {
- code: result.code,
- // eslint-disable-next-line no-undefined
- map: result.map ? JSON.parse(result.map) : undefined,
- errors: result.error ? [result.error] : [],
- warnings: result.warnings || [],
- extractedComments
- };
- }
-
- /**
- * @returns {string | undefined}
- */
- uglifyJsMinify.getMinimizerVersion = () => {
- let packageJson;
- try {
- // eslint-disable-next-line global-require, import/no-extraneous-dependencies
- packageJson = require("uglify-js/package.json");
- } catch (error) {
- // Ignore
- }
- return packageJson && packageJson.version;
- };
-
- /* istanbul ignore next */
- /**
- * @param {Input} input
- * @param {SourceMapInput | undefined} sourceMap
- * @param {PredefinedOptions & CustomOptions} minimizerOptions
- * @return {Promise<MinimizedResult>}
- */
- async function swcMinify(input, sourceMap, minimizerOptions) {
- /**
- * @param {PredefinedOptions & import("@swc/core").JsMinifyOptions} [swcOptions={}]
- * @returns {import("@swc/core").JsMinifyOptions & { sourceMap: undefined } & { compress: import("@swc/core").TerserCompressOptions }}
- */
- const buildSwcOptions = (swcOptions = {}) => {
- // Need deep copy objects to avoid https://github.com/terser/terser/issues/366
- return {
- ...swcOptions,
- compress: typeof swcOptions.compress === "boolean" ? swcOptions.compress ? {} : false : {
- ...swcOptions.compress
- },
- mangle: swcOptions.mangle == null ? true : typeof swcOptions.mangle === "boolean" ? swcOptions.mangle : {
- ...swcOptions.mangle
- },
- // ecma: swcOptions.ecma,
- // keep_classnames: swcOptions.keep_classnames,
- // keep_fnames: swcOptions.keep_fnames,
- // module: swcOptions.module,
- // safari10: swcOptions.safari10,
- // toplevel: swcOptions.toplevel
- // eslint-disable-next-line no-undefined
- sourceMap: undefined
- };
- };
-
- // eslint-disable-next-line import/no-extraneous-dependencies, global-require
- const swc = require("@swc/core");
- // Copy `swc` options
- const swcOptions = buildSwcOptions(minimizerOptions);
-
- // Let `swc` generate a SourceMap
- if (sourceMap) {
- // @ts-ignore
- swcOptions.sourceMap = true;
- }
- if (swcOptions.compress) {
- // More optimizations
- if (typeof swcOptions.compress.ecma === "undefined") {
- swcOptions.compress.ecma = swcOptions.ecma;
- }
-
- // https://github.com/webpack/webpack/issues/16135
- if (swcOptions.ecma === 5 && typeof swcOptions.compress.arrows === "undefined") {
- swcOptions.compress.arrows = false;
- }
- }
- const [[filename, code]] = Object.entries(input);
- const result = await swc.minify(code, swcOptions);
- let map;
- if (result.map) {
- map = JSON.parse(result.map);
-
- // TODO workaround for swc because `filename` is not preset as in `swc` signature as for `terser`
- map.sources = [filename];
- delete map.sourcesContent;
- }
- return {
- code: result.code,
- map
- };
- }
-
- /**
- * @returns {string | undefined}
- */
- swcMinify.getMinimizerVersion = () => {
- let packageJson;
- try {
- // eslint-disable-next-line global-require, import/no-extraneous-dependencies
- packageJson = require("@swc/core/package.json");
- } catch (error) {
- // Ignore
- }
- return packageJson && packageJson.version;
- };
-
- /* istanbul ignore next */
- /**
- * @param {Input} input
- * @param {SourceMapInput | undefined} sourceMap
- * @param {PredefinedOptions & CustomOptions} minimizerOptions
- * @return {Promise<MinimizedResult>}
- */
- async function esbuildMinify(input, sourceMap, minimizerOptions) {
- /**
- * @param {PredefinedOptions & import("esbuild").TransformOptions} [esbuildOptions={}]
- * @returns {import("esbuild").TransformOptions}
- */
- const buildEsbuildOptions = (esbuildOptions = {}) => {
- // eslint-disable-next-line no-param-reassign
- delete esbuildOptions.ecma;
- if (esbuildOptions.module) {
- // eslint-disable-next-line no-param-reassign
- esbuildOptions.format = "esm";
- }
-
- // eslint-disable-next-line no-param-reassign
- delete esbuildOptions.module;
-
- // Need deep copy objects to avoid https://github.com/terser/terser/issues/366
- return {
- minify: true,
- legalComments: "inline",
- ...esbuildOptions,
- sourcemap: false
- };
- };
-
- // eslint-disable-next-line import/no-extraneous-dependencies, global-require
- const esbuild = require("esbuild");
-
- // Copy `esbuild` options
- const esbuildOptions = buildEsbuildOptions(minimizerOptions);
-
- // Let `esbuild` generate a SourceMap
- if (sourceMap) {
- esbuildOptions.sourcemap = true;
- esbuildOptions.sourcesContent = false;
- }
- const [[filename, code]] = Object.entries(input);
- esbuildOptions.sourcefile = filename;
- const result = await esbuild.transform(code, esbuildOptions);
- return {
- code: result.code,
- // eslint-disable-next-line no-undefined
- map: result.map ? JSON.parse(result.map) : undefined,
- warnings: result.warnings.length > 0 ? result.warnings.map(item => {
- const plugin = item.pluginName ? `\nPlugin Name: ${item.pluginName}` : "";
- const location = item.location ? `\n\n${item.location.file}:${item.location.line}:${item.location.column}:\n ${item.location.line} | ${item.location.lineText}\n\nSuggestion: ${item.location.suggestion}` : "";
- const notes = item.notes.length > 0 ? `\n\nNotes:\n${item.notes.map(note => `${note.location ? `[${note.location.file}:${note.location.line}:${note.location.column}] ` : ""}${note.text}${note.location ? `\nSuggestion: ${note.location.suggestion}` : ""}${note.location ? `\nLine text:\n${note.location.lineText}\n` : ""}`).join("\n")}` : "";
- return `${item.text} [${item.id}]${plugin}${location}${item.detail ? `\nDetails:\n${item.detail}` : ""}${notes}`;
- }) : []
- };
- }
-
- /**
- * @returns {string | undefined}
- */
- esbuildMinify.getMinimizerVersion = () => {
- let packageJson;
- try {
- // eslint-disable-next-line global-require, import/no-extraneous-dependencies
- packageJson = require("esbuild/package.json");
- } catch (error) {
- // Ignore
- }
- return packageJson && packageJson.version;
- };
-
- /**
- * @template T
- * @param fn {(function(): any) | undefined}
- * @returns {function(): T}
- */
- function memoize(fn) {
- let cache = false;
- /** @type {T} */
- let result;
- return () => {
- if (cache) {
- return result;
- }
- result = /** @type {function(): any} */fn();
- cache = true;
- // Allow to clean up memory for fn
- // and all dependent resources
- // eslint-disable-next-line no-undefined, no-param-reassign
- fn = undefined;
- return result;
- };
- }
- module.exports = {
- throttleAll,
- memoize,
- terserMinify,
- uglifyJsMinify,
- swcMinify,
- esbuildMinify
- };
|