🚀 developit/microbundle - Release Notes

### Patch Changes

-   [`cebafa1`](https://github.com/developit/microbundle/commit/cebafa121953a771f010b3cfd250a83bfc754e2c) [#961](https://github.com/developit/microbundle/pull/961) Thanks [@zyrong](https://github.com/zyrong)! - Fix for when multiple entries reference different CSS, only the CSS referenced by the first entry will be packaged


-   [`9a4e2b2`](https://github.com/developit/microbundle/commit/9a4e2b2096d3824661738edb142b4658cf3d9d0b) [#954](https://github.com/developit/microbundle/pull/954) Thanks [@rschristian](https://github.com/rschristian)! - Bumps Node target to v12


-   [`4ad4b76`](https://github.com/developit/microbundle/commit/4ad4b768f0ef6f434b753c4a42cdcfe85d01c404) [#967](https://github.com/developit/microbundle/pull/967) Thanks [@agilgur5](https://github.com/agilgur5)! - deps: upgrade rpt2 to latest v0.32.0 to fix monorepos


-   [`6018e58`](https://github.com/developit/microbundle/commit/6018e586b91125233026ca977a97b72bb6082ec6) [#956](https://github.com/developit/microbundle/pull/956) Thanks [@rschristian](https://github.com/rschristian)! - Silences warnings when using Node builtins with the 'node:...' protocol on imports. Warnings related to bare usage of these builtins were already silenced.


-   [`88241dd`](https://github.com/developit/microbundle/commit/88241ddf8fc3ac18cfc1ca8ced99a413f8d2b488) [#968](https://github.com/developit/microbundle/pull/968) Thanks [@PeterBurner](https://github.com/PeterBurner)! - deps: upgrade babel-plugin-transform-async-to-promises to latest v0.8.18 to fix #565


-   [`e72377a`](https://github.com/developit/microbundle/commit/e72377a001cc5925ff25aadbe26fdb96a0dab3a4) [#964](https://github.com/developit/microbundle/pull/964) Thanks [@rschristian](https://github.com/rschristian)! - Fixes filename generation for es & modern outputs. Both 'jsnext:main' and 'esmodule' were incorrectly ignored.

### Minor Changes

-   [`6f6e080`](https://github.com/developit/microbundle/commit/6f6e080f3b9ec9a223d79d24eb6e6c8dd5d72cf7) [#950](https://github.com/developit/microbundle/pull/950) Thanks [@rschristian](https://github.com/rschristian)! - Microbundle will now output ESM using `.mjs` as the file extension when the package type is CJS


-   [`242754f`](https://github.com/developit/microbundle/commit/242754f43cce1c25a6c475be64bbd2a525eb7cf0) [#949](https://github.com/developit/microbundle/pull/949) Thanks [@rschristian](https://github.com/rschristian)! - Add --visualize flag to generate build output stats

### Patch Changes

-   [`c4532cc`](https://github.com/developit/microbundle/commit/c4532cc9ccd846e6bc8176414ddf2c0fc22af1f1) [#940](https://github.com/developit/microbundle/pull/940) Thanks [@rschristian](https://github.com/rschristian)! - Adds information about `--compress` flag's default value w/ different targets


-   [`b51b855`](https://github.com/developit/microbundle/commit/b51b855794866f3e6a0ef7dfc5672d5c1c717831) [#935](https://github.com/developit/microbundle/pull/935) Thanks [@mycoin](https://github.com/mycoin)! - Don't attempt to write build stats in watch mode when there has been a build error/sizeInfo is `undefined`


-   [`1d0e305`](https://github.com/developit/microbundle/commit/1d0e305d89ad010793c57fc451991a79907e1f3f) [#941](https://github.com/developit/microbundle/pull/941) Thanks [@rschristian](https://github.com/rschristian)! - Ensures TS plugin will begin its search for a 'tsconfig.json' in the set cwd


-   [`f04c85a`](https://github.com/developit/microbundle/commit/f04c85a1885a28a16c767665a1d5f17b13834406) [#926](https://github.com/developit/microbundle/pull/926) Thanks [@developit](https://github.com/developit)! - Fix mangle.json being overwritten with `[object Object]`


-   [`ecb0b02`](https://github.com/developit/microbundle/commit/ecb0b022912397bcf98550c1a783e9e0534f33e5) [#947](https://github.com/developit/microbundle/pull/947) Thanks [@rschristian](https://github.com/rschristian)! - Ensures hoisted node_modules are excluded from babel


-   [`392d63e`](https://github.com/developit/microbundle/commit/392d63ef437f25403c03826f77790722d0234b58) [#919](https://github.com/developit/microbundle/pull/919) Thanks [@rschristian](https://github.com/rschristian)! - Fixes CSS output from being overwritten when also generating .cjs


-   [`fb0a437`](https://github.com/developit/microbundle/commit/fb0a43780a7462f4876955c3412638e51a7adb97) [#930](https://github.com/developit/microbundle/pull/930) Thanks [@rschristian](https://github.com/rschristian)! - Documenting --jsxFragment flag


-   [`8223eba`](https://github.com/developit/microbundle/commit/8223ebaee8d750e9757b9ddbfef6384fa00f22ac) [#948](https://github.com/developit/microbundle/pull/948) Thanks [@rschristian](https://github.com/rschristian)! - Corrects formatting in build completion message w/ dynamic import is used

### Patch Changes

-   [`dd0bdde`](https://github.com/developit/microbundle/commit/dd0bdde9c6ae7d0690fa73aead1c1744ae3b086a) [#904](https://github.com/developit/microbundle/pull/904) Thanks [@rschristian](https://github.com/rschristian)! - Added missing CLI doc for 'jsxImportSource' and correcting the Examples section of the '--help' output

### Patch Changes

-   [`2a0ca88`](https://github.com/developit/microbundle/commit/2a0ca8843f34c3773bb41eb3f8f571fb6b2b2d52) [#882](https://github.com/developit/microbundle/pull/882) Thanks [@MiKr13](https://github.com/MiKr13)! - feat: :sparkles: Closes #497: preserve trailing newline in mangle.json


-   [`26f382a`](https://github.com/developit/microbundle/commit/26f382a989e86fdcc5149f73f7b6c9d314a4bf37) [#895](https://github.com/developit/microbundle/pull/895) Thanks [@rschristian](https://github.com/rschristian)! - Completion message shows pkg's actual name, rather than safe name

### Minor Changes

-   [`1b61029`](https://github.com/developit/microbundle/commit/1b6102966440bd7000e0e457f8c0b7eeb7e05593) [#867](https://github.com/developit/microbundle/pull/867) Thanks [@bouchenoiremarc](https://github.com/bouchenoiremarc)! - - Add support for Module Workers with a new `--workers` flag

### Patch Changes

-   [`5e93a0e`](https://github.com/developit/microbundle/commit/5e93a0e4cc28ea8f080a08e3a8530b6bfdf25f42) [#853](https://github.com/developit/microbundle/pull/853) Thanks [@developit](https://github.com/developit)! - Fix crash when traversing `"exports"` objects (#852)


-   [`96b85da`](https://github.com/developit/microbundle/commit/96b85da1e32b4ffbef9d83387ff399d8b3ee3852) [#887](https://github.com/developit/microbundle/pull/887) Thanks [@developit](https://github.com/developit)! - When using `--target node`, resolve "node" conditional Package Export keys, otherwise resolve "browser" keys.


-   [`5d0465b`](https://github.com/developit/microbundle/commit/5d0465b39bccff31673d351fc9d29cb4c470407d) [#875](https://github.com/developit/microbundle/pull/875) Thanks [@dwightjack](https://github.com/dwightjack)! - Preserve terser annotations in compressed bundle


-   [`b1a6374`](https://github.com/developit/microbundle/commit/b1a637486234a2ae784ccf0c512321e2d3efef7c) [#858](https://github.com/developit/microbundle/pull/858) Thanks [@bouchenoiremarc](https://github.com/bouchenoiremarc)! - - Allow the minify options `compress` and `mangle` to be set as booleans


-   [`2980336`](https://github.com/developit/microbundle/commit/29803364fe54cc1a7a8543d61e694c90b4cdce6a) [#865](https://github.com/developit/microbundle/pull/865) Thanks [@rschristian](https://github.com/rschristian)! - Expands generateTypes flag to support libs with TS entrypoints

### Patch Changes

-   [`3534815`](https://github.com/developit/microbundle/commit/3534815ddabecc080cdec42cd1f6009a81a48ec9) [#848](https://github.com/developit/microbundle/pull/848) Thanks [@developit](https://github.com/developit)! - Bugfix: re-enable support for Terser annotations like `/*@__NOINLINE__*/` (these were incorrectly being removed during the Babel pass)

### Patch Changes

-   [`e3f1933`](https://github.com/developit/microbundle/commit/e3f1933773fd17bb1d97de0dad94d899acee7598) [#847](https://github.com/developit/microbundle/pull/847) Thanks [@developit](https://github.com/developit)! - - Upgrade to Terser [5.7](https://github.com/terser/terser/blob/master/CHANGELOG.md#v570) to re-enable support for `reduce_funcs:false` in `mangle.json` configuration.


-   [`86371f0`](https://github.com/developit/microbundle/commit/86371f0db6386089c66cd474a7121d9dbee4c0cf) [#784](https://github.com/developit/microbundle/pull/784) Thanks [@rschristian](https://github.com/rschristian)! - Allows users to customize the modern output's filename using "exports" like they can with "esmodules"

### Patch Changes

-   [`54402ac`](https://github.com/developit/microbundle/commit/54402ac43cc2f7ccb85fe5df2e9828c7f24091a0) [#830](https://github.com/developit/microbundle/pull/830) Thanks [@JounQin](https://github.com/JounQin)! - fix: add generateTypes cli option, check false value correctly


-   [`edcd777`](https://github.com/developit/microbundle/commit/edcd777cfaedfdb436c62b5dcb3cff6291268e4c) [#823](https://github.com/developit/microbundle/pull/823) Thanks [@rschristian](https://github.com/rschristian)! - Ensures ambient type declaration for CSS Modules is included in the published bundle


-   [`d87a5dc`](https://github.com/developit/microbundle/commit/d87a5dc286a1edba92ca3ec5b534807688c90854) Thanks [@developit](https://github.com/developit)! - - Fix `--sourcemap=false` to match `--no-sourcemap` and actually turn sourcemaps off.


-   [`6f1a20f`](https://github.com/developit/microbundle/commit/6f1a20fa17467176f9bc1acc2b0f78784d28d110) [#777](https://github.com/developit/microbundle/pull/777) Thanks [@rschristian](https://github.com/rschristian)! - Fixing a bug that would cause a CSS file to be generated to match each JS build output


-   [`25b73d2`](https://github.com/developit/microbundle/commit/25b73d22caeac7cf74b0533401318a5becc29c11) [#834](https://github.com/developit/microbundle/pull/834) Thanks [@cometkim](https://github.com/cometkim)! - Add support for configuration overrides using the `publishConfig` package.json field.


-   [`a7f7265`](https://github.com/developit/microbundle/commit/a7f7265727222da4f7af103454fc800416f0fd9a) [#802](https://github.com/developit/microbundle/pull/802) Thanks [@aheissenberger](https://github.com/aheissenberger)! - fix default extension to cjs for package.json "type":"module"


-   [`4f7fbc4`](https://github.com/developit/microbundle/commit/4f7fbc4a0b9e03b9c33d10b21c66b8ddef7524a7) Thanks [@developit](https://github.com/developit)! - Fix `transform-fast-rest` to support referencing `...rest` params from within closures.


-   [`0c91795`](https://github.com/developit/microbundle/commit/0c917959570c788929766c6f4cd55f3b49433920) [#841](https://github.com/developit/microbundle/pull/841) Thanks [@rschristian](https://github.com/rschristian)! - Ensures JS format is not included in CSS filename output

### Minor Changes

-   [`bd5d15e`](https://github.com/developit/microbundle/commit/bd5d15e17c882f2090f519d342dd89e694456ab8) [#738](https://github.com/developit/microbundle/pull/738) Thanks [@wardpeet](https://github.com/wardpeet)! - Upgrade rollup to version latest and upgrade all its dependencies


-   [`967f8d5`](https://github.com/developit/microbundle/commit/967f8d532785aa7bf8636c5a759759a3e72dcf56) [#769](https://github.com/developit/microbundle/pull/769) Thanks [@developit](https://github.com/developit)! - Add `--css inline` option. The default CSS output for all formats is now external files (as it was supposed to be).


-   [`8142704`](https://github.com/developit/microbundle/commit/8142704399efe6b4f34219c711a3932431781b36) [#741](https://github.com/developit/microbundle/pull/741) Thanks [@whitetrefoil](https://github.com/whitetrefoil)! - Use user's typescript first, fallback to bundled

### Patch Changes

-   [`12668b9`](https://github.com/developit/microbundle/commit/12668b993906a0267c53c3601ce89d1c0ddfbc27) [#687](https://github.com/developit/microbundle/pull/687) Thanks [@developit](https://github.com/developit)! - Add friendly microbundle-specific errors when modules can't be resolved.


-   [`8b60fc8`](https://github.com/developit/microbundle/commit/8b60fc86cbc493e23230a58cd0c99e2e0c675974) [#754](https://github.com/developit/microbundle/pull/754) Thanks [@stipsan](https://github.com/stipsan)! - Enable sourcemaps for CSS


-   [`fdafaf7`](https://github.com/developit/microbundle/commit/fdafaf7a4ad76b1757e2c0ff39050f8e11e2f1d5) [#764](https://github.com/developit/microbundle/pull/764) Thanks [@bakerkretzmar](https://github.com/bakerkretzmar)! - Add support for generating inline sourcemaps


-   [`52a1771`](https://github.com/developit/microbundle/commit/52a177190eb45791cb4b44d4bf04732b8b98d9c3) [#768](https://github.com/developit/microbundle/pull/768) Thanks [@developit](https://github.com/developit)! - Add ambient typescript declaration for CSS Modules

### Patch Changes

-   [`ffcc9d9`](https://github.com/developit/microbundle/commit/ffcc9d9b7d9518ae2fa31b2af4d1fd4f98599560) [#713](https://github.com/developit/microbundle/pull/713) Thanks [@developit](https://github.com/developit)! - Support [extending a UMD global](https://rollupjs.org/guide/en/#outputextend) by prefixing the package.json `"amdName"` field (eg: `"global.xyz"`).


-   [`0527862`](https://github.com/developit/microbundle/commit/052786223edce8258c73a72a49238e41e5b24850) [#722](https://github.com/developit/microbundle/pull/722) Thanks [@developit](https://github.com/developit)! - Support "esm" (`-f esm`) as an alias of "es" format.


-   [`d08f977`](https://github.com/developit/microbundle/commit/d08f977aa6b19b267cf8d12861cc5cc34380d025) [#702](https://github.com/developit/microbundle/pull/702) Thanks [@wardpeet](https://github.com/wardpeet)! - Use @babel/preset-env with bugfixes instead of preset-modules to enable "Optional chaining" & "nullish coalescing" by default.


-   [`d33a7ba`](https://github.com/developit/microbundle/commit/d33a7ba2f5475e870d1a0f659b0c3ec0c459a850) [#731](https://github.com/developit/microbundle/pull/731) Thanks [@vaneenige](https://github.com/vaneenige)! - Add jsxImportSource flag for new JSX runtime


-   [`0fec414`](https://github.com/developit/microbundle/commit/0fec41493c39669270ba2b58401dc591e551d96d) [#716](https://github.com/developit/microbundle/pull/716) Thanks [@wardpeet](https://github.com/wardpeet)! - Don't transpile generators and async for Node


-   [`ba1c047`](https://github.com/developit/microbundle/commit/ba1c047512356e0e48911f5f037be798c5c2b9eb) [#701](https://github.com/developit/microbundle/pull/701) Thanks [@wardpeet](https://github.com/wardpeet)! - re-enable unpkg alias for umd bundles as described in the readme


-   [`3488411`](https://github.com/developit/microbundle/commit/34884116e21408305b337a9f6267f6c2ddc9e72d) [#700](https://github.com/developit/microbundle/pull/700) Thanks [@wardpeet](https://github.com/wardpeet)! - Disable warnings for node's builtin-modules when using node as a target environment.

### Features & Improvements

- New `onStart`, `onError` callbacks for programmatic Microbundle usage! (#668, thanks @katywings!)
- allow multi-file output and code splitting (#674, thanks @katywings!)
- Strip comments from output (#548)

### Bug Fixes

- don't mark `--alias` modules as externals (#671, thanks @katywings!)

- Updated Babel and `preset-env` to 7.10 (#660)
- Fixed an version conflict caused by multiple copies of Babel (#664)
- Fixed `globals` generation when `--external` values include dashes (#667, thanks @katywings!)

### Features

- New `--no-pkg-main` option for disabling filename inference (#658, thanks @katywings)
- Allow the use of `import.meta` (#627, thanks @developit)

### Bugfixes

- Fix non-alphanumeric values for `--external` (#650, thanks @katywings)
- Preserve comments when `--no-compress` is enabled (#648, thanks @developit)
- Fix TypeScript issue when "module" is set to "CommonJS" (#638, thanks @marvinhagemeister)
- Fix TypeScript declaration emit target (#629, thanks @marvinhagemeister)
- Fix TypeScript `declarationDir` option so it respects the cwd (#643) (#646, thanks @katywings)
- Fix TypeScript Fragments breaking when jsxFactory is set (#623, thanks @marvinhagemeister)

### General Improvements

- Dependency updates (#634 #616, thanks @teodragovic, @merceyz)
- Documentation updates for 0.12 and `--externals` (#636 #628 #625 #609 #611 #614, thanks @gtrufitt, @developit, @SeanBannister, @adrienpoly & @i-like-robots)

- Output [modern JavaScript](https://github.com/babel/preset-modules) with `--format modern` (#413, thanks @JoviDeCroock & @marvinhagemeister)
- `--define` can now replace expressions (#348, thanks @jviide)
- a new `--css-modules` option controls whether `.css` files are modular by default (#370, thanks @maraisr)
- the `"source"` package.json field can now be an Array (#372, thanks @maraisr)
- no more warnings about deprecations or built-ins
- moved to Rollup 2 (#361, thanks @ForsakenHarmony)
- switched from Bublé to Babel (#362, thanks @wardpeet & @ForsakenHarmony)
- added support for [babel-macros](https://github.com/kentcdodds/babel-plugin-macros) (#268, thanks @FezVrasta & @ForsakenHarmony)
- Add support for customizing the `mangle.json` file path (#432, thanks @andrewiggins & @ForsakenHarmony)
- Improvements and corrections for generated TypeScript filenames and definitions (#587 etc)

### Breaking Changes

- `.babelrc` is now detected and supported - it was previously ignored.
- Microbundle now requires Node 10+

- Fix accidental bundle size increase due to core-js version (#550)
- Use [preset-modules](https://github.com/babel/preset-modules) for modern output (#557, thanks @JoviDeCroock)
- Add `--css-modules` option for `*.css` files in addition to `*.module.css` (#370, thanks @maraisr)
- Fix a bug that caused modern output to be not modern (#570)
- Add support for `--define @expression=replacement` (#588)
- Silence a bunch of unnecessary warnings
- Reduce bundle size when using async/await, in particular `for await ()` (#596)
- Fix output filename generation when using `.ts` entry modules (#587)

New `mangle.json` / `package.json` configuration for Terser!

```js
{
  // "minify" for Terser (https://github.com/terser-js/terser#minify-options-structure)
  // Note: works as a key in both package.json or mangle.json
  "minify": {
    // Legacy/convenient way to set mangle.properties.{regex,reserved}:
    "properties": "^_",
    "reserved": ["_dom", "_constructor"],

    // Optionally specify Terser compress configuration.
    // Supported values: https://github.com/terser-js/terser#compress-options
    "compress": {
      "hoist_vars": true,
      "reduce_funcs": false
    },

    // Optionally specify Terser mangle configuration
    // Supported values: https://github.com/terser-js/terser#mangle-options
    "mangle": {}
  }
}
```

🐧 **new `--define` option!** Inlines constants (great for Dead Code Elimination):

```sh
microbundle --define process.env.NODE_ENV=production,DEBUG=false
```

🐺 **new `--alias` option!** Remap imports from one module to another:

```sh
microbundle --alias react=preact,react-dom=preact
```

🦊 Lovely refactoring from @MatiasOlivera and @ForsakenHarmony :)

🦑We turned minification up to 11!! (#321, thanks @jviide)

### Breaking Changes 

- Remove import pruning: #265 (thx @marvinhagemeister ❤️)

(also added bors to not break master)

### Patches 

- Fix importing superagent: #245 (thx @luisrudge ❤️, sorry for not releasing a minor)
- Fix tests and async not being transpiled in Typescript: #262 & #269 (thx @marvinhagemeister ❤️)
- Fix hoisted packages: #271 (thx @FezVrasta ❤️)
- Update snapshots to fix tests and add cross-env for windows: 🙃

- Upstream fix: pin tiny-glob to 0.2.4 while we wait for a fix for terkelg/tiny-glob@cc4a295.

This fixes 0.8.0 which was broken

### Patches 

- Add back shebang handling: #256 (thx @marvinhagemeister ❤️)

### Features

- Fix the jsx error that's been haunting us for some time: #252 (thx @marvinhagemeister ❤️)

### Patches 

- Fix linting error that caused ci to fail: #248 (thx @marvinhagemeister ❤️)

### Possibly breaking

- Change default target to web & Don't minify by default for target == "node": #234 (me)
- Change "module" field from .m.js to .mjs: #213 (thx @Loilo ❤️)

### Features

- Add `--jsx` as a cli option to specify the pragma: #163 (thx @luxp ❤️)
- Add `--raw` option to display the raw byte count: #174 (thx @andrewiggins ❤️)
- Brotli sizes: #180 (thx @kristoferbaxter ❤️)
- Supports --globals config (rename global dependencies): #186 (thx @Ayc0 ❤️)
- Support TypeScript 3: #192 (thx @texastoland ❤️)
- Migrate to terser from uglify-js: #137 (thx @Andarist and @chocolateboy ❤️)
- Support for TypeScript sourcemaps: #227 (thx @alexbenic ❤️)

### Bugfixes / Patches

- Fix issue when using cwd and package.source: #176 (thx @gribnoysup ❤️)
- Switch jest environment to node to fix tests: #179 (thx @gribnoysup ❤️)
- Use async version of brotli-size (0.0.3): #182 (thx @developit ❤️)
- Add cache folder for each format in typescript to fix a cache issue: (thx @alexbenic ❤️)
- Don't compress microbundle dist: #231 (me)

- Updates for dependencies (thx @greenkeeper[bot] 🙃 and @joelgallant ❤️)

- Microbundle now uses the `.mjs` file extension for JS Module files, and will auto-detect them as source code.
- Update to the latest and greatest Rollup.

Special thanks to @Andarist and @ForsakenHarmony for their awesome work keeping Microbundle moving forward! 🙇‍♂️

- **Breaking Change:** `--external all` is now the default. Modules listed in your package.json's `"dependencies"` and `"peerDependencies"` will be linked as imports/require statements  (thanks @Andarist)
- Importing subdirectories from packages now treats them as external (#83, thanks @Andarist)
- When builds fail, actually output some useful information (#120, thanks @jesstelford)
- Output much more helpful Rollup errors (#128, thanks @gribnoysup)
- Fix error reporting in watch mode and make fatal watch errors exit with an error code (#153, thanks @mattdesl)
- Minify CSS assets with cssnano (#121, thanks @nicksrandall)
- Add `.tsx` support! (thanks @jaredpalmer)
- Updated to Rollup 0.60+
- watch mode can now also be activated via a `--watch` flag (thanks @ngryman)

- New API: `options.onBuild`. You supply a function, it gets called on each build in watch mode (thanks @fwilkerson)
- Switch to `rollup-plugin-typescript2` 🔥 (thanks @freeman)
- Add `--source-map` option (use `--no-source-map` to disable them, thanks @cristianbote)

### Changes & Features

- Switch to the latest typescript & fix issue with importHelpers (#69, thanks @tymondesigns)
- Switch to `uglify-es` by default for [better compression](https://github.com/developit/microbundle/commit/ad7204764638bf1b479df13aceb27522473ad1bd)!

### Bugs Fixed

- Fix flowtype issue "Cannot read property 'code' of undefined" (#64, thanks @tlvince)
- Fix "Unknown plugin 'jsx'" (workaround until oligot/rollup-plugin-nodent#6 is merged)

- Fix Nodent JSX parsing (thanks @songawee)
- Show error details when compilation fails

- Fix sourcemaps!

- Support for TypeScript! (#16, thanks @tymondesigns!!)
- Support for scoped packages (#51, thanks @Andarist!)
- Simpler warnings for missing/erroneous `package.json`
- Fix `acorn-jsx` issue (we hope!)