terser 5.47.0 → 5.48.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## v5.48.0
+
+ - Support `import source ...` and `import defer ...` (#1682)
+
+## v5.47.1
+
+ - Fix crash when using `mangle.keep_fnames` with destructuring
+
 ## v5.47.0
 
  - Add `builtins_ecma` and `builtins_pure` options

package/dist/bundle.min.js

@@ -2578,7 +2578,7 @@ function parse($TEXT, options) {
             return new_(allow_calls);
         }
         if (is("name", "import") && is_token(peek(), "punc", ".")) {
-            return import_meta(allow_calls);
+            return parse_import_expr(allow_calls);
         }
         var start = S.token;
         var peeked;
@@ -3018,6 +3018,17 @@ function parse($TEXT, options) {
     function import_statement() {
         var start = prev();
 
+        // import source x from "..."
+        // import defer * as x from "..."
+        var phase = null;
+        if (is("name", "source") || is("name", "defer")) {
+            var peeked = peek();
+            if (!is_token(peeked, "name", "from") && !is_token(peeked, "punc", ",")) {
+                phase = S.token.value;
+                next();
+            }
+        }
+
         var imported_name;
         var imported_names;
         if (is("name")) {
@@ -3052,14 +3063,33 @@ function parse($TEXT, options) {
                 end: mod_str,
             }),
             attributes,
+            phase,
             end: S.token,
         });
     }
 
-    function import_meta(allow_calls) {
+    //   import.meta
+    //   import.source("module")
+    //   import.defer("module")
+    function parse_import_expr(allow_calls) {
         var start = S.token;
         expect_token("name", "import");
         expect_token("punc", ".");
+        if (is("name", "source") || is("name", "defer")) {
+            var phase = S.token.value;
+            next();
+            if (!is("punc", "(")) {
+                croak("'import." + phase + "' can only be used in a dynamic import");
+            }
+            next();
+            var args = expr_list(")");
+            return subscripts(new AST_DynamicImport({
+                start: start,
+                phase: phase,
+                args: args,
+                end: prev()
+            }), allow_calls);
+        }
         expect_token("name", "meta");
         return subscripts(new AST_ImportMeta({
             start: start,
@@ -5292,9 +5322,10 @@ var AST_NameMapping = DEFNODE("NameMapping", "foreign_name name", function AST_N
 
 var AST_Import = DEFNODE(
     "Import",
-    "imported_name imported_names module_name attributes",
+    "phase imported_name imported_names module_name attributes",
     function AST_Import(props) {
         if (props) {
+            this.phase = props.phase;
             this.imported_name = props.imported_name;
             this.imported_names = props.imported_names;
             this.module_name = props.module_name;
@@ -5308,6 +5339,7 @@ var AST_Import = DEFNODE(
     {
         $documentation: "An `import` statement",
         $propdoc: {
+            phase: "[string?] Phase keyword: 'source', 'defer', or null.",
             imported_name: "[AST_SymbolImport] The name of the variable holding the module's default export.",
             imported_names: "[AST_NameMapping*] The names of non-default imported variables",
             module_name: "[AST_String] String literal describing where this module came from",
@@ -5348,6 +5380,40 @@ var AST_ImportMeta = DEFNODE("ImportMeta", null, function AST_ImportMeta(props)
     $documentation: "A reference to import.meta",
 });
 
+var AST_DynamicImport = DEFNODE(
+    "DynamicImport",
+    "phase args",
+    function AST_DynamicImport(props) {
+        if (props) {
+            this.phase = props.phase;
+            this.args = props.args;
+            this.start = props.start;
+            this.end = props.end;
+        }
+
+        this.flags = 0;
+    },
+    {
+        $documentation: "A phased dynamic import expression: `import.source(specifier [, options])` or `import.defer(specifier [, options])`. Plain `import(x)` continues to be parsed as an AST_Call with a synthetic `import` SymbolRef callee.",
+        $propdoc: {
+            phase: "[string] Phase keyword ('source' or 'defer').",
+            args: "[AST_Node*] specifier followed by optional options argument"
+        },
+        _walk: function(visitor) {
+            return visitor._visit(this, function() {
+                var args = this.args;
+                for (var i = 0, len = args.length; i < len; i++) {
+                    args[i]._walk(visitor);
+                }
+            });
+        },
+        _children_backwards(push) {
+            let i = this.args.length;
+            while (i--) push(this.args[i]);
+        },
+    }
+);
+
 var AST_Export = DEFNODE(
     "Export",
     "exported_definition exported_value is_default exported_names module_name attributes",
@@ -7811,7 +7877,8 @@ def_transform(AST_PrefixedTemplateString, function(self, tw) {
                 imported_name: imported_name,
                 imported_names : imported_names,
                 module_name : from_moz(M.source),
-                attributes: import_attributes_from_moz(M.attributes || M.assertions)
+                attributes: import_attributes_from_moz(M.attributes || M.assertions),
+                phase: M.phase || null
             });
         },
 
@@ -7842,6 +7909,14 @@ def_transform(AST_PrefixedTemplateString, function(self, tw) {
             if (M.options) {
                 args.push(from_moz(M.options));
             }
+            if (M.phase) {
+                return new AST_DynamicImport({
+                    start: my_start_token(M),
+                    end: my_end_token(M),
+                    phase: M.phase,
+                    args: args
+                });
+            }
             return new AST_Call({
                 start: my_start_token(M),
                 end: my_end_token(M),
@@ -8441,6 +8516,16 @@ def_transform(AST_PrefixedTemplateString, function(self, tw) {
         };
     });
 
+    def_to_moz(AST_DynamicImport, function To_Moz_ImportExpression(M) {
+        const [source, options] = M.args.map(to_moz);
+        return {
+            type: "ImportExpression",
+            source,
+            options: options || null,
+            phase: M.phase
+        };
+    });
+
     def_to_moz(AST_Toplevel, function To_Moz_Program(M) {
         return to_moz_scope("Program", M);
     });
@@ -8705,12 +8790,14 @@ def_transform(AST_PrefixedTemplateString, function(self, tw) {
                 });
             }
         }
-        return {
+        var moz = {
             type: "ImportDeclaration",
             specifiers: specifiers,
             source: to_moz(M.module_name),
             attributes: import_attributes_to_moz(M.attributes)
         };
+        if (M.phase) moz.phase = M.phase;
+        return moz;
     });
 
     def_to_moz(AST_ImportMeta, function To_Moz_MetaProperty() {
@@ -11003,6 +11090,10 @@ function OutputStream(options) {
     DEFPRINT(AST_Import, function(self, output) {
         output.print("import");
         output.space();
+        if (self.phase) {
+            output.print(self.phase);
+            output.space();
+        }
         if (self.imported_name) {
             self.imported_name.print(output);
         }
@@ -11043,6 +11134,15 @@ function OutputStream(options) {
     DEFPRINT(AST_ImportMeta, function(self, output) {
         output.print("import.meta");
     });
+    DEFPRINT(AST_DynamicImport, function(self, output) {
+        output.print("import." + self.phase);
+        output.with_parens(function() {
+            self.args.forEach(function(arg, i) {
+                if (i) output.comma();
+                arg.print(output);
+            });
+        });
+    });
 
     DEFPRINT(AST_NameMapping, function(self, output) {
         var is_import = output.parent() instanceof AST_Import;
@@ -11895,11 +11995,18 @@ AST_VarDefLike.prototype.shallow_cmp = function(other) {
 AST_NameMapping.prototype.shallow_cmp = pass_through;
 
 AST_Import.prototype.shallow_cmp = function(other) {
-    return (this.imported_name == null ? other.imported_name == null : this.imported_name === other.imported_name) && (this.imported_names == null ? other.imported_names == null : this.imported_names === other.imported_names) && (this.attributes == null ? other.attributes == null : this.attributes === other.attributes);
+    return (this.imported_name || null) === (other.imported_name || null)
+        && (this.imported_names || null) === (other.imported_names || null)
+        && (this.attributes || null) === (other.attributes || null)
+        && (this.phase || null) === (other.phase || null);
 };
 
 AST_ImportMeta.prototype.shallow_cmp = pass_through;
 
+AST_DynamicImport.prototype.shallow_cmp = function(other) {
+    return (this.phase || null) === (other.phase || null) && this.args.length === other.args.length;
+};
+
 AST_Export.prototype.shallow_cmp = function(other) {
     return (this.exported_definition == null ? other.exported_definition == null : this.exported_definition === other.exported_definition) && (this.exported_value == null ? other.exported_value == null : this.exported_value === other.exported_value) && (this.exported_names == null ? other.exported_names == null : this.exported_names === other.exported_names) && (this.attributes == null ? other.attributes == null : this.attributes === other.attributes) && this.module_name === other.module_name && this.is_default === other.is_default;
 };
@@ -12795,6 +12902,7 @@ AST_Toplevel.DEFMETHOD("mangle_names", function(options) {
         if (
             function_defs
             && node instanceof AST_VarDef
+            && node.name instanceof AST_Symbol
             && node.value instanceof AST_Lambda
             && !node.value.name
             && keep_name(options.keep_fnames, node.name.name)
@@ -13187,6 +13295,11 @@ AST_Import.prototype._size = function () {
 
 AST_ImportMeta.prototype._size = () => 11;
 
+AST_DynamicImport.prototype._size = function () {
+    // `import.` + phase + `()` + arg overhead
+    return 9 + this.phase.length + list_overhead(this.args);
+};
+
 AST_Export.prototype._size = function () {
     let size = 7 + (this.is_default ? 8 : 0);
 
@@ -14655,6 +14768,10 @@ function is_nullish(node, compressor) {
             || this.alternative && this.alternative.has_side_effects(compressor);
     });
     def_has_side_effects(AST_ImportMeta, return_false);
+    def_has_side_effects(AST_DynamicImport, function() {
+        // `import.source(x)` only compiles the module, which is side-effect free
+        return this.phase !== "source";
+    });
     def_has_side_effects(AST_LabeledStatement, function(compressor) {
         return this.body.has_side_effects(compressor);
     });
@@ -15978,6 +16095,12 @@ def_drop_side_effect_free(AST_Call, function (compressor, first_in_statement) {
     return args && make_sequence(this, args);
 });
 
+def_drop_side_effect_free(AST_DynamicImport, function (compressor, first_in_statement) {
+    if (this.phase !== "source") return this;
+    var args = trim(this.args, compressor, first_in_statement);
+    return args && make_sequence(this, args);
+});
+
 def_drop_side_effect_free(AST_Accessor, return_null);
 
 def_drop_side_effect_free(AST_Function, return_null);

package/lib/ast.js

@@ -1535,9 +1535,10 @@ var AST_NameMapping = DEFNODE("NameMapping", "foreign_name name", function AST_N
 
 var AST_Import = DEFNODE(
     "Import",
-    "imported_name imported_names module_name attributes",
+    "phase imported_name imported_names module_name attributes",
     function AST_Import(props) {
         if (props) {
+            this.phase = props.phase;
             this.imported_name = props.imported_name;
             this.imported_names = props.imported_names;
             this.module_name = props.module_name;
@@ -1551,6 +1552,7 @@ var AST_Import = DEFNODE(
     {
         $documentation: "An `import` statement",
         $propdoc: {
+            phase: "[string?] Phase keyword: 'source', 'defer', or null.",
             imported_name: "[AST_SymbolImport] The name of the variable holding the module's default export.",
             imported_names: "[AST_NameMapping*] The names of non-default imported variables",
             module_name: "[AST_String] String literal describing where this module came from",
@@ -1591,6 +1593,40 @@ var AST_ImportMeta = DEFNODE("ImportMeta", null, function AST_ImportMeta(props)
     $documentation: "A reference to import.meta",
 });
 
+var AST_DynamicImport = DEFNODE(
+    "DynamicImport",
+    "phase args",
+    function AST_DynamicImport(props) {
+        if (props) {
+            this.phase = props.phase;
+            this.args = props.args;
+            this.start = props.start;
+            this.end = props.end;
+        }
+
+        this.flags = 0;
+    },
+    {
+        $documentation: "A phased dynamic import expression: `import.source(specifier [, options])` or `import.defer(specifier [, options])`. Plain `import(x)` continues to be parsed as an AST_Call with a synthetic `import` SymbolRef callee.",
+        $propdoc: {
+            phase: "[string] Phase keyword ('source' or 'defer').",
+            args: "[AST_Node*] specifier followed by optional options argument"
+        },
+        _walk: function(visitor) {
+            return visitor._visit(this, function() {
+                var args = this.args;
+                for (var i = 0, len = args.length; i < len; i++) {
+                    args[i]._walk(visitor);
+                }
+            });
+        },
+        _children_backwards(push) {
+            let i = this.args.length;
+            while (i--) push(this.args[i]);
+        },
+    }
+);
+
 var AST_Export = DEFNODE(
     "Export",
     "exported_definition exported_value is_default exported_names module_name attributes",
@@ -3375,6 +3411,7 @@ export {
     AST_Function,
     AST_Hole,
     AST_If,
+    AST_DynamicImport,
     AST_Import,
     AST_ImportMeta,
     AST_Infinity,

package/lib/compress/drop-side-effect-free.js

@@ -58,6 +58,7 @@ import {
     AST_Constant,
     AST_DefClass,
     AST_Dot,
+    AST_DynamicImport,
     AST_Expansion,
     AST_Function,
     AST_Node,
@@ -152,6 +153,12 @@ def_drop_side_effect_free(AST_Call, function (compressor, first_in_statement) {
     return args && make_sequence(this, args);
 });
 
+def_drop_side_effect_free(AST_DynamicImport, function (compressor, first_in_statement) {
+    if (this.phase !== "source") return this;
+    var args = trim(this.args, compressor, first_in_statement);
+    return args && make_sequence(this, args);
+});
+
 def_drop_side_effect_free(AST_Accessor, return_null);
 
 def_drop_side_effect_free(AST_Function, return_null);

package/lib/compress/inference.js

@@ -69,6 +69,7 @@ import {
   AST_Function,
   AST_If,
   AST_Import,
+  AST_DynamicImport,
   AST_ImportMeta,
   AST_Jump,
   AST_LabeledStatement,
@@ -403,6 +404,10 @@ export function is_nullish(node, compressor) {
             || this.alternative && this.alternative.has_side_effects(compressor);
     });
     def_has_side_effects(AST_ImportMeta, return_false);
+    def_has_side_effects(AST_DynamicImport, function() {
+        // `import.source(x)` only compiles the module, which is side-effect free
+        return this.phase !== "source";
+    });
     def_has_side_effects(AST_LabeledStatement, function(compressor) {
         return this.body.has_side_effects(compressor);
     });

package/lib/equivalent-to.js

@@ -29,6 +29,7 @@ import {
     AST_ForOf,
     AST_If,
     AST_Import,
+    AST_DynamicImport,
     AST_ImportMeta,
     AST_Jump,
     AST_LabeledStatement,
@@ -193,11 +194,18 @@ AST_VarDefLike.prototype.shallow_cmp = function(other) {
 AST_NameMapping.prototype.shallow_cmp = pass_through;
 
 AST_Import.prototype.shallow_cmp = function(other) {
-    return (this.imported_name == null ? other.imported_name == null : this.imported_name === other.imported_name) && (this.imported_names == null ? other.imported_names == null : this.imported_names === other.imported_names) && (this.attributes == null ? other.attributes == null : this.attributes === other.attributes);
+    return (this.imported_name || null) === (other.imported_name || null)
+        && (this.imported_names || null) === (other.imported_names || null)
+        && (this.attributes || null) === (other.attributes || null)
+        && (this.phase || null) === (other.phase || null);
 };
 
 AST_ImportMeta.prototype.shallow_cmp = pass_through;
 
+AST_DynamicImport.prototype.shallow_cmp = function(other) {
+    return (this.phase || null) === (other.phase || null) && this.args.length === other.args.length;
+};
+
 AST_Export.prototype.shallow_cmp = function(other) {
     return (this.exported_definition == null ? other.exported_definition == null : this.exported_definition === other.exported_definition) && (this.exported_value == null ? other.exported_value == null : this.exported_value === other.exported_value) && (this.exported_names == null ? other.exported_names == null : this.exported_names === other.exported_names) && (this.attributes == null ? other.attributes == null : this.attributes === other.attributes) && this.module_name === other.module_name && this.is_default === other.is_default;
 };

package/lib/mozilla-ast.js

@@ -91,6 +91,7 @@ import {
     AST_Function,
     AST_Hole,
     AST_If,
+    AST_DynamicImport,
     AST_Import,
     AST_ImportMeta,
     AST_Label,
@@ -585,7 +586,8 @@ import { is_basic_identifier_string } from "./parse.js";
                 imported_name: imported_name,
                 imported_names : imported_names,
                 module_name : from_moz(M.source),
-                attributes: import_attributes_from_moz(M.attributes || M.assertions)
+                attributes: import_attributes_from_moz(M.attributes || M.assertions),
+                phase: M.phase || null
             });
         },
 
@@ -616,6 +618,14 @@ import { is_basic_identifier_string } from "./parse.js";
             if (M.options) {
                 args.push(from_moz(M.options));
             }
+            if (M.phase) {
+                return new AST_DynamicImport({
+                    start: my_start_token(M),
+                    end: my_end_token(M),
+                    phase: M.phase,
+                    args: args
+                });
+            }
             return new AST_Call({
                 start: my_start_token(M),
                 end: my_end_token(M),
@@ -1215,6 +1225,16 @@ import { is_basic_identifier_string } from "./parse.js";
         };
     });
 
+    def_to_moz(AST_DynamicImport, function To_Moz_ImportExpression(M) {
+        const [source, options] = M.args.map(to_moz);
+        return {
+            type: "ImportExpression",
+            source,
+            options: options || null,
+            phase: M.phase
+        };
+    });
+
     def_to_moz(AST_Toplevel, function To_Moz_Program(M) {
         return to_moz_scope("Program", M);
     });
@@ -1479,12 +1499,14 @@ import { is_basic_identifier_string } from "./parse.js";
                 });
             }
         }
-        return {
+        var moz = {
             type: "ImportDeclaration",
             specifiers: specifiers,
             source: to_moz(M.module_name),
             attributes: import_attributes_to_moz(M.attributes)
         };
+        if (M.phase) moz.phase = M.phase;
+        return moz;
     });
 
     def_to_moz(AST_ImportMeta, function To_Moz_MetaProperty() {

package/lib/output.js

@@ -103,6 +103,7 @@ import {
     AST_Function,
     AST_Hole,
     AST_If,
+    AST_DynamicImport,
     AST_Import,
     AST_ImportMeta,
     AST_Jump,
@@ -1766,6 +1767,10 @@ function OutputStream(options) {
     DEFPRINT(AST_Import, function(self, output) {
         output.print("import");
         output.space();
+        if (self.phase) {
+            output.print(self.phase);
+            output.space();
+        }
         if (self.imported_name) {
             self.imported_name.print(output);
         }
@@ -1806,6 +1811,15 @@ function OutputStream(options) {
     DEFPRINT(AST_ImportMeta, function(self, output) {
         output.print("import.meta");
     });
+    DEFPRINT(AST_DynamicImport, function(self, output) {
+        output.print("import." + self.phase);
+        output.with_parens(function() {
+            self.args.forEach(function(arg, i) {
+                if (i) output.comma();
+                arg.print(output);
+            });
+        });
+    });
 
     DEFPRINT(AST_NameMapping, function(self, output) {
         var is_import = output.parent() instanceof AST_Import;

package/lib/parse.js

@@ -99,6 +99,7 @@ import {
     AST_Function,
     AST_Hole,
     AST_If,
+    AST_DynamicImport,
     AST_Import,
     AST_ImportMeta,
     AST_Infinity,
@@ -2428,7 +2429,7 @@ function parse($TEXT, options) {
             return new_(allow_calls);
         }
         if (is("name", "import") && is_token(peek(), "punc", ".")) {
-            return import_meta(allow_calls);
+            return parse_import_expr(allow_calls);
         }
         var start = S.token;
         var peeked;
@@ -2868,6 +2869,17 @@ function parse($TEXT, options) {
     function import_statement() {
         var start = prev();
 
+        // import source x from "..."
+        // import defer * as x from "..."
+        var phase = null;
+        if (is("name", "source") || is("name", "defer")) {
+            var peeked = peek();
+            if (!is_token(peeked, "name", "from") && !is_token(peeked, "punc", ",")) {
+                phase = S.token.value;
+                next();
+            }
+        }
+
         var imported_name;
         var imported_names;
         if (is("name")) {
@@ -2902,14 +2914,33 @@ function parse($TEXT, options) {
                 end: mod_str,
             }),
             attributes,
+            phase,
             end: S.token,
         });
     }
 
-    function import_meta(allow_calls) {
+    //   import.meta
+    //   import.source("module")
+    //   import.defer("module")
+    function parse_import_expr(allow_calls) {
         var start = S.token;
         expect_token("name", "import");
         expect_token("punc", ".");
+        if (is("name", "source") || is("name", "defer")) {
+            var phase = S.token.value;
+            next();
+            if (!is("punc", "(")) {
+                croak("'import." + phase + "' can only be used in a dynamic import");
+            }
+            next();
+            var args = expr_list(")");
+            return subscripts(new AST_DynamicImport({
+                start: start,
+                phase: phase,
+                args: args,
+                end: prev()
+            }), allow_calls);
+        }
         expect_token("name", "meta");
         return subscripts(new AST_ImportMeta({
             start: start,

package/lib/scope.js

@@ -858,6 +858,7 @@ AST_Toplevel.DEFMETHOD("mangle_names", function(options) {
         if (
             function_defs
             && node instanceof AST_VarDef
+            && node.name instanceof AST_Symbol
             && node.value instanceof AST_Lambda
             && !node.value.name
             && keep_name(options.keep_fnames, node.name.name)

package/lib/size.js

@@ -35,6 +35,7 @@ import {
     AST_Hole,
     AST_If,
     AST_Import,
+    AST_DynamicImport,
     AST_ImportMeta,
     AST_Infinity,
     AST_LabeledStatement,
@@ -276,6 +277,11 @@ AST_Import.prototype._size = function () {
 
 AST_ImportMeta.prototype._size = () => 11;
 
+AST_DynamicImport.prototype._size = function () {
+    // `import.` + phase + `()` + arg overhead
+    return 9 + this.phase.length + list_overhead(this.args);
+};
+
 AST_Export.prototype._size = function () {
     let size = 7 + (this.is_default ? 8 : 0);
 

package/package.json

@@ -4,7 +4,7 @@
   "homepage": "https://terser.org",
   "author": "Mihai Bazon <mihai.bazon@gmail.com> (http://lisperator.net/)",
   "license": "BSD-2-Clause",
-  "version": "5.47.0",
+  "version": "5.48.0",
   "engines": {
     "node": ">=10"
   },