Squashed commit of the following:

commit fe2733dba65ebe471e4b1a9736a0e7106d0cd3c6
Author: Stephan Schreiber <[email protected]>
Date:   Sat Feb 5 19:39:09 2022 +0100

    Pre 4.0

commit a39cceea0bf6f6d0e6cf888416d277ce73da9792
Author: Stephan Schreiber <[email protected]>
Date:   Sat Feb 5 18:20:25 2022 +0100

    Updates tests

commit ce5d5a0be1703fe99ba79b259019b3532c5d7790
Author: Stephan Schreiber <[email protected]>
Date:   Sat Feb 5 18:20:04 2022 +0100

    Update dependencies

Author: Septh

.eslintrc

@@ -17,14 +17,6 @@
         "no-unused-vars": "off",
         "prefer-const": "warn",
         "no-inner-declarations": "off",
-        "@typescript-eslint/no-explicit-any": "off",
-        "@typescript-eslint/no-unused-vars": "off",
-        "@typescript-eslint/no-this-alias": [
-            "error",
-            {
-                "allowDestructuring": true,
-                "allowedNames": ["self"]
-            }
-        ]
+        "@typescript-eslint/no-unused-vars": "off"
     }
 }

.gitignore

@@ -1,2 +1,4 @@
 node_modules
 dist
+out
+zz*

.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Plugin",
+            "type": "pwa-node",
+            "request": "launch",
+            "skipFiles": [
+                "<node_internals>/**",
+                "${workspaceFolder}/node_modules/**"
+            ],
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/node_modules/rollup/dist/bin/rollup",
+            "windows": {
+                "program": "${workspaceFolder}\\node_modules\\rollup\\dist\\bin\\rollup"
+            },
+            "args": [ "-c", "zz_rollup.config.js" ],
+            "outputCapture": "std"
+        }
+    ]
+}

README.md

@@ -1,7 +1,13 @@
 # rollup-plugin-node-externals
-A Rollup plugin that automatically declares NodeJS built-in modules as `external`. Can also handle npm dependencies, devDependencies, peerDependencies and optionalDependencies. Works in monorepos too!
+A Rollup plugin that automatically declares NodeJS built-in modules as `external`. Also handles npm dependencies, devDependencies, peerDependencies and optionalDependencies. Works in monorepos too!
+
+> ## Breaking changes in version 4
+> - In previous versions, the `deps` option (see below) defaulted to `false`. This was practial, but often wrong: when bundling for distribution, you want your own dependencies to be installed by the package manager alongside your package, so they should not be bundled in the code. Therefore, the `deps` option now defaults to `true`.
+> - `rollup-plugin-node-externals` now requires Node 14 (up from Node 12 for previous versions).
+> - `rollup-plugin-node-externals` now has a _peer dependency_ on Rollup 2.60.0.
 
 ## Why?
+<details><summary>(click to expand)</summary>
 By default, Rollup doesn't know a thing about NodeJS, so trying to bundle simple things like `import * as path from 'path'` in your code generates an `Unresolved dependencies` warning.
 
 The solution here is quite simple: you must tell Rollup that the `path` module is in fact `external`. This way, Rollup won't try to bundle it in and rather leave the `import` statement as is (or translate it to a `require()` call if bundling for CommonJS).
@@ -10,17 +16,42 @@ However, this must be done for each and every NodeJS built-in you happen to use
 
 So the primary goal of this plugin is simply to automatically declare all NodeJS built-in modules as `external`.
 
-As an added bonus, this plugin will also allow you to declare your dependencies (as per in your local or monorepo `package.json` file) as external.
-
+As an added bonus, this plugin will also allow you to declare your dependencies (as per your local or monorepo `package.json` file(s)) as external.
+</details>
 
 ## Installation
 Use your favorite package manager. Mine is [npm](https://www.npmjs.com).
 ```sh
 npm install --save-dev rollup-plugin-node-externals
 ```
 
-
 ## Usage
+
+- To bundle _a package that depends on other packages **at runtime**_ (e.g., a library or a NodeJS CLI), install your own dependencies with `--save`. Then, the built-in defaults are just what you need:
+```typescript
+export default {
+  ...
+  plugins: [
+    externals(),  // Make all Node builtins, deps, devDeps, peerDeps and optDeps external
+  ]
+}
+```
+
+- To bundle _a standalone app_ (such as a browser app):
+```typescript
+export default {
+  ...
+  plugins: [
+    externals({
+      deps: false,    // If you installed your own deps with --save
+      devDeps: false  // If you installed your own deps with --save-dev
+    }),
+  ]
+}
+```
+
+### Options
+
 ```typescript
 import externals from 'rollup-plugin-node-externals'
 
@@ -37,7 +68,7 @@ export default {
       // Treat prefixed builtins as their unprefixed counterpart. Optional. Default: 'strip'
       prefixedBuiltins?: boolean | 'strip',
 
-      // Make pkg.dependencies external. Optional. Default: false
+      // Make pkg.dependencies external. Optional. Default: true
       deps?: boolean,
 
       // Make pkg.devDependencies external. Optional. Default: true
@@ -59,59 +90,42 @@ export default {
 }
 ```
 
-### Options
-Most of the time, the built-in defaults are just what you need:
-```typescript
-import externals from 'rollup-plugin-node-externals'
-
-export default {
-  ...
-  plugins: [
-    externals(),  // Bundle deps in; make all Node builtins, devDeps, peerDeps and optDeps external
-  ]
-}
-```
-
 #### packagePath?: string | string[] = []
 If you're working with monorepos, the `packagePath` is made for you. It can take a path, or an array of paths, to your package.json file(s). If not specified, the default is to start with the current directory's package.json then go up scan for all package.json files in parent directories recursively until either the root git directory is reached or until no other package.json can be found.
 
 #### builtins?: boolean = true
 Set the `builtins` option to `false` if you'd like to use some shims for those. You'll most certainly need [an other plugin](https://github.com/rollup/plugins/tree/master/packages/node-resolve/#resolving-built-ins-like-fs) for this.
 
 #### prefixedBuiltins?: boolean | 'strip' = 'strip'
-How to handle the `node:` (or sometimes `nodejs:`) prefix some authors use in their code (i.e., `import path from 'node:path'`). If `false`, the import is used as-is to determine if it is external, meaning that `'node:path'` and `'path'` are considered two distincts imports. If `true`, prefixed builtins are treated as their unprefixed equivalent. If `strip` (default), the prefix is also removed from the name and other plugins will never know it was there.
-
-#### deps?: boolean = false
-Set the `deps` option to `true` to externalize your normal dependencies, therefore preventing Rollup from bundling them with your code.
+How to handle the `node:` (or sometimes `nodejs:`) prefix some authors use in their code (i.e., `import path from 'node:path'`). If `false`, the import is used as-is to determine if it is external, meaning that `'node:path'` and `'path'` are considered two distincts imports. If `true`, prefixed builtins are treated as their unprefixed equivalent. If `strip` (the default), the prefix is also removed from the name and other plugins will never know it was there.
 
+#### deps?: boolean = true
 #### devDeps?: boolean = true
 #### peerDeps?: boolean = true
 #### optDeps?: boolean = true
-Set the `devDeps`, `peerDeps` and `optDeps` options to `false` to prevent the corresponding dependencies from being externalized, therefore letting Rollup bundle them with your code. Note that bundling these dependencies is quite meaningless but it might be useful as a transitional step before migrating them to `dependencies`.
+Set the `deps`, `devDeps`, `peerDeps` and `optDeps` options to `false` to prevent the corresponding dependencies from being externalized, therefore letting Rollup bundle them with your code.
 
 #### include?: string | RegExp | (string | RegExp)[] = []
 #### exclude?: string | RegExp | (string | RegExp)[] = []
 Use the `include` option to force certain dependencies into the list of externals:
 ```typescript
 externals({
-  deps: false,          // Deps will be bundled in
-  include: /^fsevents/  // Except for fsevents
+  deps: false,                // Deps will be bundled in
+  include: /^fsevents/        // Except for fsevents
 })
 ```
 
 Conversely, use the `exclude` option to remove certain dependencies from the list of externals:
 ```typescript
 externals({
-  deps: true,           // Deps are external
-  exclude: [
-    'electron-reload'   // Yet we want `electron-reload` bundled in
-  ]
+  deps: true,                 // Deps are external
+  exclude: 'electron-reload'  // Yet we want `electron-reload` bundled in
 })
 ```
 
 ## Notes
 ### 1/ This plugin is smart
-Falsy values in `include` and `exclude` are silently ignored. This allows for conditional constructs like so: `exclude: process.env.NODE_ENV === 'production' && /my-prod-only-dep/`.
+Falsy values in `include` and `exclude` are silently ignored. This allows for conditional constructs like so: `exclude: process.env.NODE_ENV === 'production' && 'my-prod-only-dep'`.
 
 ### 2/ This plugin is not _that_ smart
 It uses an exact match against your imports, so if your are using some kind of path substitution in your code, eg.:
@@ -127,6 +141,9 @@ externals({
 })
 ```
 
+However, subpath imports are supported with regexes, meaning that `include: /^lodash/` will also externalize `loadash/map`, `lodash/merge`, etc.
+
+
 ### 3/ Order matters
 If you're also using `@rollup/plugin-node-resolve`, make sure this plugin comes _before_ it in the `plugins` array:
 ```typescript
@@ -150,19 +167,5 @@ As a general rule of thumb, you might want to always make this plugin the first
 Rollup's own `external` configuration option always takes precedence over this plugin. This is intentional.
 
 
-## Migrating from version 1.x
-- In 1.x, normal dependencies were externalized by default. This is no more true since 2.0, so you'll need to change:
-```typescript
-externals()
-```
-to:
-```typescript
-externals({ deps: true })
-```
-if you want the same behavior.
-
-- The `except` option from 1.x has been deprecated in 2.0 and removed in 3.0. Use the Rollup-friendlier `exclude` option instead.
-
-
 ## Licence
 MIT