terser 5.16.1 → 5.17.7

package/CHANGELOG.md

@@ -1,5 +1,85 @@
 # Changelog
 
+## v5.17.7
+ - Update some dependencies
+ - Add consistent sorting for `v` RegExp flag
+ - Add `inert` DOM attribute to domprops
+
+## v5.17.6
+ - Fixes to mozilla AST input and output, for class properties, private properties and static blocks
+ - Fix outputting a shorthand property in quotes when safari10 and ecma=2015 options are enabled
+ - `configurable` and `enumerable`, used in Object.defineProperty, added to domprops (#1393)
+
+## v5.17.5
+ - Take into account the non-deferred bits of a class, such as static properties, while dropping unused code.
+
+## v5.17.4
+
+ - Fix crash when trying to negate a class (`!class{}`)
+ - Avoid outputting comments between `yield`/`await` and its argument
+ - Fix detection of left-hand-side of assignment, to avoid optimizing it like any other expression in some edge cases
+
+## v5.17.3
+
+ - Fix issue with trimming a static class property's contents accessing the class as `this`.
+
+## v5.17.2
+ - Be less conservative when detecting use-before-definition of `var` in hoisted functions.
+ - Support unusual (but perfectly valid) initializers of for-in and for-of loops.
+ - Fix issue where hoisted function would be dropped if it was after a `continue` statement
+
+## v5.17.1
+ - Fix evaluating `.length` when the source array might've been mutated
+
+## v5.17.0
+ - Drop vestigial `= undefined` default argument in IIFE calls (#1366)
+ - Evaluate known arrays' `.length` property when statically determinable
+ - Add `@__KEY__` annotation to mangle string literals (#1365)
+
+## v5.16.9
+ - Fix parentheses in output of optional chains (`a?.b`) (#1374)
+ - More documentation on source maps (#1368)
+ - New `lhs_constants` option, allowing to stop Terser from swapping comparison operands (#1361)
+
+## v5.16.8
+
+ - Become even less conservative around function definitions for `reduce_vars`
+ - Fix parsing context of `import.meta` expressions such that method calls are allowed
+
+## v5.16.6
+
+ - Become less conservative with analyzing function definitions for `reduce_vars`
+ - Parse `import.meta` as a real AST node and not an `object.property`
+
+## v5.16.5
+
+ - Correctly handle AST transform functions that mutate children arrays
+ - Don't mutate the options object passed to Terser (#1342)
+ - Do not treat BigInt like a number
+
+## v5.16.4
+
+ - Keep `(defaultArg = undefined) => ...`, because default args don't count for function length
+ - Prevent inlining variables into `?.` optional chains
+ - Avoid removing unused arguments while transforming
+ - Optimize iterating AST node lists
+ - Make sure `catch` and `finally` aren't children of `try` in the AST
+ - Use modern unicode property escapes (`\p{...}`) to parse identifiers when available
+
+## v5.16.3
+
+ - Ensure function definitions, don't assume the values of variables defined after them.
+
+## v5.16.2
+
+ - Fix sourcemaps with non-ascii characters (#1318)
+ - Support string module name and export * as (#1336)
+ - Do not move `let` out of `for` initializers, as it can change scoping
+ - Fix a corner case that would generate the invalid syntax `if (something) let x` ("let" in braceless if body)
+ - Knowledge of more native object properties (#1330)
+ - Got rid of Travis (#1323)
+ - Added semi-secret `asObject` sourcemap option to typescript defs (#1321)
+
 ## v5.16.1
 
  - Properly handle references in destructurings (`const { [reference]: val } = ...`)

package/README.md

@@ -2,7 +2,7 @@
 
   [![NPM Version][npm-image]][npm-url]
   [![NPM Downloads][downloads-image]][downloads-url]
-  [![Travis Build][travis-image]][travis-url]
+  [![CI pipeline][ci-image]][ci-url]
   [![Opencollective financial contributors][opencollective-contributors]][opencollective-url]
 
 A JavaScript mangler/compressor toolkit for ES6+.
@@ -21,8 +21,8 @@ Find the changelog in [CHANGELOG.md](https://github.com/terser/terser/blob/maste
 [npm-url]: https://npmjs.org/package/terser
 [downloads-image]: https://img.shields.io/npm/dm/terser.svg
 [downloads-url]: https://npmjs.org/package/terser
-[travis-image]: https://app.travis-ci.com/terser/terser.svg?branch=master
-[travis-url]: https://app.travis-ci.com/github/terser/terser
+[ci-image]: https://github.com/terser/terser/actions/workflows/ci.yml/badge.svg
+[ci-url]: https://github.com/terser/terser/actions/workflows/ci.yml
 [opencollective-contributors]: https://opencollective.com/terser/tiers/badge.svg
 [opencollective-url]: https://opencollective.com/terser
 
@@ -708,7 +708,8 @@ If you happen to need the source map as a raw object, set `sourceMap.asObject` t
 
 - `comparisons` (default: `true`) -- apply certain optimizations to binary nodes,
   e.g. `!(a <= b) → a > b` (only when `unsafe_comps`), attempts to negate binary
-  nodes, e.g. `a = !b && !c && !d && !e → a=!(b||c||d||e)` etc.
+  nodes, e.g. `a = !b && !c && !d && !e → a=!(b||c||d||e)` etc. Note: `comparisons`
+  works best with `lhs_constants` enabled.
 
 - `computed_props` (default: `true`) -- Transforms constant computed properties
   into regular ones: `{["computed"]: 1}` is converted to `{computed: 1}`.
@@ -758,7 +759,7 @@ If you happen to need the source map as a raw object, set `sourceMap.asObject` t
   - `3` -- inline functions with arguments and variables
   - `true` -- same as `3`
 
-- `join_vars` (default: `true`) -- join consecutive `var` statements
+- `join_vars` (default: `true`) -- join consecutive `var`, `let` and `const` statements
 
 - `keep_classnames` (default: `false`) -- Pass `true` to prevent the compressor from
   discarding class names. Pass a regular expression to only keep class names matching
@@ -775,6 +776,9 @@ If you happen to need the source map as a raw object, set `sourceMap.asObject` t
 - `keep_infinity` (default: `false`) -- Pass `true` to prevent `Infinity` from
   being compressed into `1/0`, which may cause performance issues on Chrome.
 
+- `lhs_constants` (default: `true`) -- Moves constant values to the left-hand side
+  of binary nodes. `foo == 42 → 42 == foo`
+
 - `loops` (default: `true`) -- optimizations for `do`, `while` and `for` loops
   when we can statically determine the condition.
 
@@ -1184,6 +1188,7 @@ Annotations in Terser are a way to tell it to treat a certain function call diff
  * `/*@__INLINE__*/` - forces a function to be inlined somewhere.
  * `/*@__NOINLINE__*/` - Makes sure the called function is not inlined into the call site.
  * `/*@__PURE__*/` - Marks a function call as pure. That means, it can safely be dropped.
+ * `/*@__KEY__*/` - Marks a string literal as a property to also mangle it when mangling properties.
 
 You can use either a `@` sign at the start, or a `#`.
 
@@ -1197,6 +1202,9 @@ function_always_inlined_here()
 function_cant_be_inlined_into_here()
 
 const x = /*#__PURE__*/i_am_dropped_if_x_is_not_used()
+
+function lookup(object, key) { return object[key]; }
+lookup({ i_will_be_mangled_too: "bar" }, /*@__KEY__*/ "i_will_be_mangled_too");
 ```
 
 ### ESTree / SpiderMonkey AST
@@ -1267,6 +1275,12 @@ expected as code is optimized and mappings are often simply not possible as
 some code no longer exists. For highest fidelity in source map debugging
 disable the `compress` option and just use `mangle`.
 
+When debugging, make sure you enable the **"map scopes"** feature to map mangled variable names back to their original names.  
+Without this, all variable values will be `undefined`. See https://github.com/terser/terser/issues/1367 for more details.
+<br/><br/>
+
+![image](https://user-images.githubusercontent.com/27283110/230441652-ac5cf6b0-5dc5-4ffc-9d8b-bd02875484f4.png)
+
 ### Compiler assumptions
 
 To allow for better optimizations, the compiler makes various assumptions: