From bbec60473659cafec38fafa3eb883775534f58c8 Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Tue, 18 May 2021 18:39:06 +0200
Subject: [PATCH 1/3] doc: document null target pattern

---
 doc/api/packages.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/api/packages.md b/doc/api/packages.md
index f91184208af43e..9536601b38bc63 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -383,6 +383,26 @@ treating the right hand side target pattern as a `**` glob against the list of
 files within the package. Because `node_modules` paths are forbidden in exports
 targets, this expansion is dependent on only the files of the package itself.
 
+To exclude private subfolders from patterns, `null` targets can be used:
+
+```json
+// ./node_modules/es-module-package/package.json
+{
+  "exports": {
+    "./features/*": "./src/features/*.js",
+    "./features/private-internal/*": null
+  }
+}
+```
+
+```js
+import featureInternal from 'es-module-package/features/private-internal/m';
+// Throws: ERR_PACKAGE_PATH_NOT_EXPORTED
+
+import featureX from 'es-module-package/features/x';
+// Loads ./node_modules/es-module-package/src/features/x.js
+```
+
 ### Subpath folder mappings
 <!-- YAML
 changes:

From 250b21299751f7f4b78312d03cc62bf23581e622 Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Wed, 19 May 2021 14:07:25 +0200
Subject: [PATCH 2/3] clarify deep matching

---
 doc/api/packages.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/packages.md b/doc/api/packages.md
index 9536601b38bc63..8b9982ca82149d 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -358,6 +358,9 @@ For these use cases, subpath export patterns can be used instead:
 }
 ```
 
+**`*` matches expose nested subpaths as it is a string replacement syntax 
+only.**
+
 The left hand matching pattern must always end in `*`. All instances of `*` on
 the right hand side will then be replaced with this value, including if it
 contains any `/` separators.

From 1dc3e771498778fd9504ef64a49a0f8ded3411ab Mon Sep 17 00:00:00 2001
From: Guy Bedford <guybedford@gmail.com>
Date: Wed, 19 May 2021 14:10:57 +0200
Subject: [PATCH 3/3] lint fix

---
 doc/api/packages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/packages.md b/doc/api/packages.md
index 8b9982ca82149d..6e87336a0095c6 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -358,7 +358,7 @@ For these use cases, subpath export patterns can be used instead:
 }
 ```
 
-**`*` matches expose nested subpaths as it is a string replacement syntax 
+**`*` maps expose nested subpaths as it is a string replacement syntax
 only.**
 
 The left hand matching pattern must always end in `*`. All instances of `*` on