From bbec60473659cafec38fafa3eb883775534f58c8 Mon Sep 17 00:00:00 2001 From: Guy Bedford 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