@yarnpkg/plugin-essentials 3.2.3 → 3.4.0

package/lib/commands/add.js

@@ -61,17 +61,18 @@ class AddCommand extends cli_1.BaseCommand {
             restoreResolutions: false,
         });
         const interactive = (_a = this.interactive) !== null && _a !== void 0 ? _a : configuration.get(`preferInteractive`);
+        const reuse = interactive || configuration.get(`preferReuse`);
         const modifier = suggestUtils.getModifier(this, project);
         const strategies = [
-            ...interactive ? [
-                suggestUtils.Strategy.REUSE,
-            ] : [],
+            reuse ?
+                suggestUtils.Strategy.REUSE
+                : undefined,
             suggestUtils.Strategy.PROJECT,
-            ...this.cached ? [
-                suggestUtils.Strategy.CACHE,
-            ] : [],
+            this.cached ?
+                suggestUtils.Strategy.CACHE
+                : undefined,
             suggestUtils.Strategy.LATEST,
-        ];
+        ].filter((strategy) => typeof strategy !== `undefined`);
         const maxResults = interactive
             ? Infinity
             : 1;
@@ -207,7 +208,6 @@ class AddCommand extends cli_1.BaseCommand {
         return installReport.exitCode();
     }
 }
-exports.default = AddCommand;
 AddCommand.paths = [
     [`add`],
 ];
@@ -234,7 +234,7 @@ AddCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
 
@@ -260,6 +260,7 @@ AddCommand.usage = clipanion_1.Command.Usage({
             `$0 add lodash-es@lodash/lodash#es`,
         ]],
 });
+exports.default = AddCommand;
 function suggestTargetList(workspace, ident, { dev, peer, preferDev, optional }) {
     const hasRegular = workspace.manifest[suggestUtils.Target.REGULAR].has(ident.identHash);
     const hasDev = workspace.manifest[suggestUtils.Target.DEVELOPMENT].has(ident.identHash);

package/lib/commands/bin.js

@@ -58,7 +58,6 @@ class BinCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = BinCommand;
 BinCommand.paths = [
     [`bin`],
 ];
@@ -77,3 +76,4 @@ BinCommand.usage = clipanion_1.Command.Usage({
             `$0 bin eslint`,
         ]],
 });
+exports.default = BinCommand;

package/lib/commands/cache/clean.js

@@ -35,7 +35,6 @@ class CacheCleanCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = CacheCleanCommand;
 CacheCleanCommand.paths = [
     [`cache`, `clean`],
     [`cache`, `clear`],
@@ -53,3 +52,4 @@ CacheCleanCommand.usage = clipanion_1.Command.Usage({
             `$0 cache clean --mirror`,
         ]],
 });
+exports.default = CacheCleanCommand;

package/lib/commands/config/get.js

@@ -57,7 +57,6 @@ class ConfigGetCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ConfigGetCommand;
 ConfigGetCommand.paths = [
     [`config`, `get`],
 ];
@@ -85,3 +84,4 @@ ConfigGetCommand.usage = clipanion_1.Command.Usage({
             `yarn config get packageExtensions --json`,
         ]],
 });
+exports.default = ConfigGetCommand;

package/lib/commands/config/set.js

@@ -79,7 +79,6 @@ class ConfigSetCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ConfigSetCommand;
 ConfigSetCommand.paths = [
     [`config`, `set`],
 ];
@@ -112,3 +111,4 @@ ConfigSetCommand.usage = clipanion_1.Command.Usage({
             `yarn config set 'npmRegistries["//npm.example.com"].npmAuthToken' "ffffffff-ffff-ffff-ffff-ffffffffffff"`,
         ]],
 });
+exports.default = ConfigSetCommand;

package/lib/commands/config/unset.js

@@ -57,7 +57,6 @@ class ConfigUnsetCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ConfigUnsetCommand;
 ConfigUnsetCommand.paths = [
     [`config`, `unset`],
 ];
@@ -77,3 +76,4 @@ ConfigUnsetCommand.usage = clipanion_1.Command.Usage({
             `yarn config unset npmScopes.company.npmRegistryServer`,
         ]],
 });
+exports.default = ConfigUnsetCommand;

package/lib/commands/config.js

@@ -85,7 +85,6 @@ class ConfigCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ConfigCommand;
 ConfigCommand.paths = [
     [`config`],
 ];
@@ -99,3 +98,4 @@ ConfigCommand.usage = clipanion_1.Command.Usage({
             `$0 config`,
         ]],
 });
+exports.default = ConfigCommand;

package/lib/commands/dedupe.js

@@ -72,7 +72,6 @@ class DedupeCommand extends cli_1.BaseCommand {
         }
     }
 }
-exports.default = DedupeCommand;
 DedupeCommand.paths = [
     [`dedupe`],
 ];
@@ -91,7 +90,7 @@ DedupeCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
 
@@ -124,3 +123,4 @@ DedupeCommand.usage = clipanion_1.Command.Usage({
             `$0 dedupe --check`,
         ]],
 });
+exports.default = DedupeCommand;

package/lib/commands/entries/clipanion.js

@@ -33,7 +33,7 @@ class ClipanionCommand extends cli_1.BaseCommand {
         this.context.stdout.write(`${JSON.stringify(clipanionDefinitions, null, 2)}\n`);
     }
 }
-exports.default = ClipanionCommand;
 ClipanionCommand.paths = [
     [`--clipanion=definitions`],
 ];
+exports.default = ClipanionCommand;

package/lib/commands/entries/help.js

@@ -7,9 +7,9 @@ class HelpCommand extends cli_1.BaseCommand {
         this.context.stdout.write(this.cli.usage(null));
     }
 }
-exports.default = HelpCommand;
 HelpCommand.paths = [
     [`help`],
     [`--help`],
     [`-h`],
 ];
+exports.default = HelpCommand;

package/lib/commands/entries/version.js

@@ -8,8 +8,8 @@ class VersionCommand extends cli_1.BaseCommand {
         this.context.stdout.write(`${core_1.YarnVersion || `<unknown>`}\n`);
     }
 }
-exports.default = VersionCommand;
 VersionCommand.paths = [
     [`-v`],
     [`--version`],
 ];
+exports.default = VersionCommand;

package/lib/commands/exec.js

@@ -24,7 +24,6 @@ class ExecCommand extends cli_1.BaseCommand {
         });
     }
 }
-exports.default = ExecCommand;
 ExecCommand.paths = [
     [`exec`],
 ];
@@ -43,3 +42,4 @@ ExecCommand.usage = clipanion_1.Command.Usage({
             `$0 exec "tsc & babel src --out-dir lib"`,
         ]],
 });
+exports.default = ExecCommand;

package/lib/commands/explain/peerRequirements.js

@@ -62,7 +62,6 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ExplainPeerRequirementsCommand;
 ExplainPeerRequirementsCommand.paths = [
     [`explain`, `peer-requirements`],
 ];
@@ -85,6 +84,7 @@ ExplainPeerRequirementsCommand.usage = clipanion_1.Command.Usage({
             `$0 explain peer-requirements`,
         ]],
 });
+exports.default = ExplainPeerRequirementsCommand;
 async function explainPeerRequirements(peerRequirementsHash, project, opts) {
     const { configuration } = project;
     const requirement = project.peerRequirements.get(peerRequirementsHash);

package/lib/commands/explain.js

@@ -78,7 +78,6 @@ class ExplainCommand extends cli_1.BaseCommand {
         }
     }
 }
-exports.default = ExplainCommand;
 ExplainCommand.paths = [
     [`explain`],
 ];
@@ -97,3 +96,4 @@ ExplainCommand.usage = clipanion_1.Command.Usage({
             `$0 explain`,
         ]],
 });
+exports.default = ExplainCommand;

package/lib/commands/info.js

@@ -308,7 +308,6 @@ class InfoCommand extends cli_1.BaseCommand {
         });
     }
 }
-exports.default = InfoCommand;
 InfoCommand.paths = [
     [`info`],
 ];
@@ -328,3 +327,4 @@ InfoCommand.usage = clipanion_1.Command.Usage({
             `$0 info lodash`,
         ]],
 });
+exports.default = InfoCommand;

package/lib/commands/install.js

@@ -246,7 +246,6 @@ class YarnCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = YarnCommand;
 YarnCommand.paths = [
     [`install`],
     clipanion_1.Command.Default,
@@ -276,7 +275,7 @@ YarnCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
     `,
@@ -291,6 +290,7 @@ YarnCommand.usage = clipanion_1.Command.Usage({
             `$0 install --immutable --immutable-cache --check-cache`,
         ]],
 });
+exports.default = YarnCommand;
 const MERGE_CONFLICT_ANCESTOR = `|||||||`;
 const MERGE_CONFLICT_END = `>>>>>>>`;
 const MERGE_CONFLICT_SEP = `=======`;

package/lib/commands/link.js

@@ -71,7 +71,6 @@ class LinkCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = LinkCommand;
 LinkCommand.paths = [
     [`link`],
 ];
@@ -88,3 +87,4 @@ LinkCommand.usage = clipanion_1.Command.Usage({
             `$0 link ~/jest --all`,
         ]],
 });
+exports.default = LinkCommand;

package/lib/commands/node.js

@@ -12,7 +12,6 @@ class NodeCommand extends cli_1.BaseCommand {
         return this.cli.run([`exec`, `node`, ...this.args]);
     }
 }
-exports.default = NodeCommand;
 NodeCommand.paths = [
     [`node`],
 ];
@@ -28,3 +27,4 @@ NodeCommand.usage = clipanion_1.Command.Usage({
             `$0 node ./my-script.js`,
         ]],
 });
+exports.default = NodeCommand;

package/lib/commands/plugin/import/sources.js

@@ -56,7 +56,6 @@ class PluginDlSourcesCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = PluginDlSourcesCommand;
 PluginDlSourcesCommand.paths = [
     [`plugin`, `import`, `from`, `sources`],
 ];
@@ -76,6 +75,7 @@ PluginDlSourcesCommand.usage = clipanion_1.Command.Usage({
             `$0 plugin import from sources exec`,
         ]],
 });
+exports.default = PluginDlSourcesCommand;
 async function buildAndSavePlugin(pluginSpec, { context, noMinify }, { project, report, target }) {
     const pluginName = pluginSpec.replace(/@yarnpkg\//, ``);
     const { configuration } = project;

package/lib/commands/plugin/import.js

@@ -69,7 +69,6 @@ class PluginDlCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = PluginDlCommand;
 PluginDlCommand.paths = [
     [`plugin`, `import`],
 ];
@@ -101,6 +100,7 @@ PluginDlCommand.usage = clipanion_1.Command.Usage({
             `$0 plugin import ./path/to/plugin.js`,
         ]],
 });
+exports.default = PluginDlCommand;
 async function savePlugin(pluginSpec, pluginBuffer, { project, report }) {
     const { configuration } = project;
     const vmExports = {};

package/lib/commands/plugin/list.js

@@ -39,7 +39,6 @@ class PluginDlCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = PluginDlCommand;
 PluginDlCommand.paths = [
     [`plugin`, `list`],
 ];
@@ -54,3 +53,4 @@ PluginDlCommand.usage = clipanion_1.Command.Usage({
             `$0 plugin list`,
         ]],
 });
+exports.default = PluginDlCommand;

package/lib/commands/plugin/remove.js

@@ -45,7 +45,6 @@ class PluginRemoveCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = PluginRemoveCommand;
 PluginRemoveCommand.paths = [
     [`plugin`, `remove`],
 ];
@@ -65,3 +64,4 @@ PluginRemoveCommand.usage = clipanion_1.Command.Usage({
             `$0 plugin remove my-local-plugin`,
         ]],
 });
+exports.default = PluginRemoveCommand;

package/lib/commands/plugin/runtime.js

@@ -30,7 +30,6 @@ class PluginListCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = PluginListCommand;
 PluginListCommand.paths = [
     [`plugin`, `runtime`],
 ];
@@ -45,3 +44,4 @@ PluginListCommand.usage = clipanion_1.Command.Usage({
             `$0 plugin runtime`,
         ]],
 });
+exports.default = PluginListCommand;

package/lib/commands/rebuild.js

@@ -46,7 +46,6 @@ class RunCommand extends cli_1.BaseCommand {
         return installReport.exitCode();
     }
 }
-exports.default = RunCommand;
 RunCommand.paths = [
     [`rebuild`],
 ];
@@ -67,3 +66,4 @@ RunCommand.usage = clipanion_1.Command.Usage({
             `$0 rebuild fsevents`,
         ]],
 });
+exports.default = RunCommand;

package/lib/commands/remove.js

@@ -103,7 +103,6 @@ class RemoveCommand extends cli_1.BaseCommand {
         return 0;
     }
 }
-exports.default = RemoveCommand;
 RemoveCommand.paths = [
     [`remove`],
 ];
@@ -114,7 +113,7 @@ RemoveCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
 
@@ -137,3 +136,4 @@ RemoveCommand.usage = clipanion_1.Command.Usage({
             `$0 remove 'react-{dom,helmet}'`,
         ]],
 });
+exports.default = RemoveCommand;

package/lib/commands/run.d.ts

@@ -7,6 +7,7 @@ export default class RunCommand extends BaseCommand {
     inspectBrk: string | boolean;
     topLevel: boolean;
     binariesOnly: boolean;
+    require: string | undefined;
     silent: boolean | undefined;
     scriptName: string;
     args: string[];

package/lib/commands/run.js

@@ -22,6 +22,9 @@ class RunCommand extends cli_1.BaseCommand {
         this.binariesOnly = clipanion_1.Option.Boolean(`-B,--binaries-only`, false, {
             description: `Ignore any user defined scripts and only check for binaries`,
         });
+        this.require = clipanion_1.Option.String(`--require`, {
+            description: `Forwarded to the underlying Node process when executing a binary`,
+        });
         // The v1 used to print the Yarn version header when using "yarn run", which
         // was messing with the output of things like `--version` & co. We don't do
         // this anymore, but many workflows use `yarn run --silent` to make sure that
@@ -64,6 +67,8 @@ class RunCommand extends cli_1.BaseCommand {
                     nodeArgs.push(`--inspect-brk`);
                 }
             }
+            if (this.require)
+                nodeArgs.push(`--require=${this.require}`);
             return await core_2.scriptUtils.executePackageAccessibleBinary(effectiveLocator, this.scriptName, this.args, {
                 cwd: this.context.cwd,
                 project,
@@ -112,7 +117,6 @@ class RunCommand extends cli_1.BaseCommand {
         }
     }
 }
-exports.default = RunCommand;
 RunCommand.paths = [
     [`run`],
 ];
@@ -140,3 +144,4 @@ RunCommand.usage = clipanion_1.Command.Usage({
             `$0 run --inspect-brk webpack`,
         ]],
 });
+exports.default = RunCommand;

package/lib/commands/runIndex.js

@@ -32,7 +32,7 @@ class RunCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = RunCommand;
 RunCommand.paths = [
     [`run`],
 ];
+exports.default = RunCommand;

package/lib/commands/set/resolution.js

@@ -37,7 +37,6 @@ class SetResolutionCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = SetResolutionCommand;
 SetResolutionCommand.paths = [
     [`set`, `resolution`],
 ];
@@ -55,3 +54,4 @@ SetResolutionCommand.usage = clipanion_1.Command.Usage({
             `$0 set resolution lodash@npm:^1.2.3 1.5.0`,
         ]],
 });
+exports.default = SetResolutionCommand;

package/lib/commands/set/version/sources.js

@@ -86,7 +86,6 @@ class SetVersionSourcesCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = SetVersionSourcesCommand;
 SetVersionSourcesCommand.paths = [
     [`set`, `version`, `from`, `sources`],
 ];
@@ -102,6 +101,7 @@ SetVersionSourcesCommand.usage = clipanion_1.Command.Usage({
             `$0 set version from sources`,
         ]],
 });
+exports.default = SetVersionSourcesCommand;
 async function runWorkflow(workflow, { configuration, context, target }) {
     for (const [fileName, ...args] of workflow) {
         const usePipe = args[args.length - 1] === `|`;

package/lib/commands/set/version.js

@@ -75,7 +75,6 @@ class SetVersionCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = SetVersionCommand;
 SetVersionCommand.paths = [
     [`set`, `version`],
 ];
@@ -84,7 +83,7 @@ SetVersionCommand.usage = clipanion_1.Command.Usage({
     details: `
       This command will download a specific release of Yarn directly from the Yarn GitHub repository, will store it inside your project, and will change the \`yarnPath\` settings from your project \`.yarnrc.yml\` file to point to the new file.
 
-      A very good use case for this command is to enforce the version of Yarn used by the any single member of your team inside a same project - by doing this you ensure that you have control on Yarn upgrades and downgrades (including on your deployment servers), and get rid of most of the headaches related to someone using a slightly different version and getting a different behavior than you.
+      A very good use case for this command is to enforce the version of Yarn used by any single member of your team inside the same project - by doing this you ensure that you have control over Yarn upgrades and downgrades (including on your deployment servers), and get rid of most of the headaches related to someone using a slightly different version and getting different behavior.
 
       The version specifier can be:
 
@@ -130,6 +129,7 @@ SetVersionCommand.usage = clipanion_1.Command.Usage({
             `$0 set version self`,
         ]],
 });
+exports.default = SetVersionCommand;
 async function resolveRange(configuration, request) {
     const data = await core_2.httpUtils.get(`https://repo.yarnpkg.com/tags`, { configuration, jsonResponse: true });
     const candidates = data.tags.filter(version => core_2.semverUtils.satisfiesWithPrereleases(version, request));

package/lib/commands/unlink.js

@@ -72,7 +72,6 @@ class UnlinkCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = UnlinkCommand;
 UnlinkCommand.paths = [
     [`unlink`],
 ];
@@ -95,3 +94,4 @@ UnlinkCommand.usage = clipanion_1.Command.Usage({
             `$0 unlink '@babel/*' 'pkg-{a,b}'`,
         ]],
 });
+exports.default = UnlinkCommand;

package/lib/commands/up.js

@@ -185,7 +185,7 @@ class UpCommand extends cli_1.BaseCommand {
                 ({ answer: selected } = await (0, enquirer_1.prompt)({
                     type: `select`,
                     name: `answer`,
-                    message: `Which range to you want to use in ${core_1.structUtils.prettyWorkspace(configuration, workspace)} ❯ ${target}?`,
+                    message: `Which range do you want to use in ${core_1.structUtils.prettyWorkspace(configuration, workspace)} ❯ ${target}?`,
                     choices: suggestions.map(({ descriptor, name, reason }) => descriptor ? {
                         name,
                         hint: reason,
@@ -235,7 +235,6 @@ class UpCommand extends cli_1.BaseCommand {
         return installReport.exitCode();
     }
 }
-exports.default = UpCommand;
 UpCommand.paths = [
     [`up`],
 ];
@@ -252,7 +251,7 @@ UpCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
 
@@ -285,3 +284,4 @@ UpCommand.usage = clipanion_1.Command.Usage({
 UpCommand.schema = [
     t.hasKeyRelationship(`recursive`, t.KeyRelationship.Forbids, [`interactive`, `exact`, `tilde`, `caret`], { ignore: [undefined, false] }),
 ];
+exports.default = UpCommand;

package/lib/commands/why.js

@@ -38,7 +38,6 @@ class WhyCommand extends cli_1.BaseCommand {
         });
     }
 }
-exports.default = WhyCommand;
 WhyCommand.paths = [
     [`why`],
 ];
@@ -54,6 +53,7 @@ WhyCommand.usage = clipanion_1.Command.Usage({
             `$0 why lodash`,
         ]],
 });
+exports.default = WhyCommand;
 function whySimple(project, identHash, { configuration, peers }) {
     const sortedPackages = core_3.miscUtils.sortMap(project.storedPackages.values(), pkg => {
         return core_3.structUtils.stringifyLocator(pkg);

package/lib/commands/workspace.js

@@ -18,10 +18,7 @@ class WorkspaceCommand extends cli_1.BaseCommand {
         if (!cwdWorkspace)
             throw new cli_1.WorkspaceRequiredError(project.cwd, this.context.cwd);
         const candidates = project.workspaces;
-        const candidatesByName = new Map(candidates.map((workspace) => {
-            const ident = core_2.structUtils.convertToIdent(workspace.locator);
-            return [core_2.structUtils.stringifyIdent(ident), workspace];
-        }));
+        const candidatesByName = new Map(candidates.map(workspace => [core_2.structUtils.stringifyIdent(workspace.locator), workspace]));
         const workspace = candidatesByName.get(this.workspaceName);
         if (workspace === undefined) {
             const otherNames = Array.from(candidatesByName.keys()).sort();
@@ -30,7 +27,6 @@ class WorkspaceCommand extends cli_1.BaseCommand {
         return this.cli.run([this.commandName, ...this.args], { cwd: workspace.cwd });
     }
 }
-exports.default = WorkspaceCommand;
 WorkspaceCommand.paths = [
     [`workspace`],
 ];
@@ -48,3 +44,4 @@ WorkspaceCommand.usage = clipanion_1.Command.Usage({
             `yarn workspace components run build`,
         ]],
 });
+exports.default = WorkspaceCommand;

package/lib/commands/workspaces/list.d.ts

@@ -5,6 +5,7 @@ export default class WorkspacesListCommand extends BaseCommand {
     static usage: Usage;
     since: string | boolean | undefined;
     recursive: boolean;
+    noPrivate: boolean | undefined;
     verbose: boolean;
     json: boolean;
     execute(): Promise<1 | 0>;

package/lib/commands/workspaces/list.js

@@ -15,6 +15,9 @@ class WorkspacesListCommand extends cli_1.BaseCommand {
         this.recursive = clipanion_1.Option.Boolean(`-R,--recursive`, false, {
             description: `Find packages via dependencies/devDependencies instead of using the workspaces field`,
         });
+        this.noPrivate = clipanion_1.Option.Boolean(`--no-private`, {
+            description: `Exclude workspaces that have the private field set to true`,
+        });
         this.verbose = clipanion_1.Option.Boolean(`-v,--verbose`, false, {
             description: `Also return the cross-dependencies between workspaces`,
         });
@@ -40,6 +43,8 @@ class WorkspacesListCommand extends cli_1.BaseCommand {
                         workspaces.add(dependent);
             for (const workspace of workspaces) {
                 const { manifest } = workspace;
+                if (manifest.private && this.noPrivate)
+                    continue;
                 let extra;
                 if (this.verbose) {
                     const workspaceDependencies = new Set();
@@ -79,7 +84,6 @@ class WorkspacesListCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = WorkspacesListCommand;
 WorkspacesListCommand.paths = [
     [`workspaces`, `list`],
 ];
@@ -93,6 +97,9 @@ WorkspacesListCommand.usage = clipanion_1.Command.Usage({
 
       - If \`-R,--recursive\` is set, Yarn will find workspaces to run the command on by recursively evaluating \`dependencies\` and \`devDependencies\` fields, instead of looking at the \`workspaces\` fields.
 
+      - If \`--no-private\` is set, Yarn will not list any workspaces that have the \`private\` field set to \`true\`.
+
       - If both the \`-v,--verbose\` and \`--json\` options are set, Yarn will also return the cross-dependencies between each workspaces (useful when you wish to automatically generate Buck / Bazel rules).
     `,
 });
+exports.default = WorkspacesListCommand;

package/lib/dedupeUtils.js

@@ -15,7 +15,7 @@ var Strategy;
      * - dependencies are never downgraded
      */
     Strategy["HIGHEST"] = "highest";
-})(Strategy = exports.Strategy || (exports.Strategy = {}));
+})(Strategy || (exports.Strategy = Strategy = {}));
 exports.acceptedStrategies = new Set(Object.values(Strategy));
 const DEDUPE_ALGORITHMS = {
     highest: async (project, patterns, { resolver, fetcher, resolveOptions, fetchOptions }) => {
@@ -93,7 +93,7 @@ async function dedupe(project, { strategy, patterns, cache, report }) {
         const algorithm = DEDUPE_ALGORITHMS[strategy];
         const dedupePromises = await algorithm(project, patterns, { resolver, resolveOptions, fetcher, fetchOptions });
         const progress = core_1.Report.progressViaCounter(dedupePromises.length);
-        report.reportProgress(progress);
+        await report.reportProgress(progress);
         let dedupedPackageCount = 0;
         await Promise.all(dedupePromises.map(dedupePromise => dedupePromise
             .then(dedupe => {

package/lib/index.d.ts

@@ -42,6 +42,7 @@ declare module '@yarnpkg/core' {
     interface ConfigurationValueMap {
         enableImmutableInstalls: boolean;
         defaultSemverRangePrefix: `^` | `~` | ``;
+        preferReuse: boolean;
     }
 }
 declare const plugin: Plugin;

package/lib/index.js

@@ -57,6 +57,11 @@ const plugin = {
             values: [`^`, `~`, ``],
             default: suggestUtils.Modifier.CARET,
         },
+        preferReuse: {
+            description: `If true, \`yarn add\` will attempt to reuse the most common dependency range in other workspaces.`,
+            type: core_1.SettingsType.BOOLEAN,
+            default: false,
+        },
     },
     commands: [
         clean_1.default,

package/lib/suggestUtils.js

@@ -12,19 +12,19 @@ var Target;
     Target["REGULAR"] = "dependencies";
     Target["DEVELOPMENT"] = "devDependencies";
     Target["PEER"] = "peerDependencies";
-})(Target = exports.Target || (exports.Target = {}));
+})(Target || (exports.Target = Target = {}));
 var Modifier;
 (function (Modifier) {
     Modifier["CARET"] = "^";
     Modifier["TILDE"] = "~";
     Modifier["EXACT"] = "";
-})(Modifier = exports.Modifier || (exports.Modifier = {}));
+})(Modifier || (exports.Modifier = Modifier = {}));
 var WorkspaceModifier;
 (function (WorkspaceModifier) {
     WorkspaceModifier["CARET"] = "^";
     WorkspaceModifier["TILDE"] = "~";
     WorkspaceModifier["EXACT"] = "*";
-})(WorkspaceModifier = exports.WorkspaceModifier || (exports.WorkspaceModifier = {}));
+})(WorkspaceModifier || (exports.WorkspaceModifier = WorkspaceModifier = {}));
 var Strategy;
 (function (Strategy) {
     /**
@@ -52,7 +52,7 @@ var Strategy;
      * versions of the package that are already within our cache.
      */
     Strategy["CACHE"] = "cache";
-})(Strategy = exports.Strategy || (exports.Strategy = {}));
+})(Strategy || (exports.Strategy = Strategy = {}));
 function getModifier(flags, project) {
     if (flags.exact)
         return Modifier.EXACT;
@@ -109,7 +109,7 @@ async function findProjectDescriptors(ident, { project, target }) {
         if (target === Target.PEER) {
             const peerDescriptor = workspace.manifest.peerDependencies.get(ident.identHash);
             if (peerDescriptor !== undefined) {
-                getDescriptorEntry(peerDescriptor).locators.push(workspace.locator);
+                getDescriptorEntry(peerDescriptor).locators.push(workspace.anchoredLocator);
             }
         }
         else {
@@ -117,18 +117,18 @@ async function findProjectDescriptors(ident, { project, target }) {
             const developmentDescriptor = workspace.manifest.devDependencies.get(ident.identHash);
             if (target === Target.DEVELOPMENT) {
                 if (developmentDescriptor !== undefined) {
-                    getDescriptorEntry(developmentDescriptor).locators.push(workspace.locator);
+                    getDescriptorEntry(developmentDescriptor).locators.push(workspace.anchoredLocator);
                 }
                 else if (regularDescriptor !== undefined) {
-                    getDescriptorEntry(regularDescriptor).locators.push(workspace.locator);
+                    getDescriptorEntry(regularDescriptor).locators.push(workspace.anchoredLocator);
                 }
             }
             else {
                 if (regularDescriptor !== undefined) {
-                    getDescriptorEntry(regularDescriptor).locators.push(workspace.locator);
+                    getDescriptorEntry(regularDescriptor).locators.push(workspace.anchoredLocator);
                 }
                 else if (developmentDescriptor !== undefined) {
-                    getDescriptorEntry(developmentDescriptor).locators.push(workspace.locator);
+                    getDescriptorEntry(developmentDescriptor).locators.push(workspace.anchoredLocator);
                 }
             }
         }

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@yarnpkg/plugin-essentials",
-  "version": "3.2.3",
+  "version": "3.4.0",
   "license": "BSD-2-Clause",
   "main": "./lib/index.js",
   "dependencies": {
-    "@yarnpkg/fslib": "^2.8.0",
-    "@yarnpkg/json-proxy": "^2.1.1",
-    "@yarnpkg/parsers": "^2.5.1",
+    "@yarnpkg/fslib": "^2.10.3",
+    "@yarnpkg/parsers": "^2.6.0",
     "ci-info": "^3.2.0",
     "clipanion": "3.2.0-rc.4",
     "enquirer": "^2.3.6",
@@ -17,18 +16,17 @@
     "typanion": "^3.3.0"
   },
   "peerDependencies": {
-    "@yarnpkg/cli": "^3.2.4",
-    "@yarnpkg/core": "^3.2.5",
-    "@yarnpkg/plugin-git": "^2.6.2"
+    "@yarnpkg/cli": "^3.7.0",
+    "@yarnpkg/core": "^3.6.0",
+    "@yarnpkg/plugin-git": "^2.6.7"
   },
   "devDependencies": {
     "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/semver": "^7.1.0",
-    "@types/treeify": "^1.0.0",
-    "@yarnpkg/cli": "^3.2.4",
-    "@yarnpkg/core": "^3.2.5",
-    "@yarnpkg/plugin-git": "^2.6.2"
+    "@yarnpkg/cli": "^3.7.0",
+    "@yarnpkg/core": "^3.6.0",
+    "@yarnpkg/plugin-git": "^2.6.7"
   },
   "repository": {
     "type": "git",