@yarnpkg/plugin-essentials 3.3.0 → 3.5.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;
@@ -81,9 +82,9 @@ class AddCommand extends cli_1.BaseCommand {
                 : core_3.structUtils.tryParseDescriptor(pseudoDescriptor);
             const unsupportedPrefix = pseudoDescriptor.match(/^(https?:|git@github)/);
             if (unsupportedPrefix)
-                throw new clipanion_1.UsageError(`It seems you are trying to add a package using a ${core_1.formatUtils.pretty(configuration, `${unsupportedPrefix[0]}...`, core_1.FormatType.RANGE)} url; we now require package names to be explicitly specified.\nTry running the command again with the package name prefixed: ${core_1.formatUtils.pretty(configuration, `yarn add`, core_1.FormatType.CODE)} ${core_1.formatUtils.pretty(configuration, core_3.structUtils.makeDescriptor(core_3.structUtils.makeIdent(null, `my-package`), `${unsupportedPrefix[0]}...`), core_1.FormatType.DESCRIPTOR)}`);
+                throw new clipanion_1.UsageError(`It seems you are trying to add a package using a ${core_1.formatUtils.pretty(configuration, `${unsupportedPrefix[0]}...`, core_1.formatUtils.Type.RANGE)} url; we now require package names to be explicitly specified.\nTry running the command again with the package name prefixed: ${core_1.formatUtils.pretty(configuration, `yarn add`, core_1.formatUtils.Type.CODE)} ${core_1.formatUtils.pretty(configuration, core_3.structUtils.makeDescriptor(core_3.structUtils.makeIdent(null, `my-package`), `${unsupportedPrefix[0]}...`), core_1.formatUtils.Type.DESCRIPTOR)}`);
             if (!request)
-                throw new clipanion_1.UsageError(`The ${core_1.formatUtils.pretty(configuration, pseudoDescriptor, core_1.FormatType.CODE)} string didn't match the required format (package-name@range). Did you perhaps forget to explicitly reference the package name?`);
+                throw new clipanion_1.UsageError(`The ${core_1.formatUtils.pretty(configuration, pseudoDescriptor, core_1.formatUtils.Type.CODE)} string didn't match the required format (package-name@range). Did you perhaps forget to explicitly reference the package name?`);
             const targetList = suggestTargetList(workspace, request, {
                 dev: this.dev,
                 peer: this.peer,
@@ -207,7 +208,6 @@ class AddCommand extends cli_1.BaseCommand {
         return installReport.exitCode();
     }
 }
-exports.default = AddCommand;
 AddCommand.paths = [
     [`add`],
 ];
@@ -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`],
 ];
@@ -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,
@@ -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.d.ts

@@ -6,6 +6,6 @@ export default class LinkCommand extends BaseCommand {
     all: boolean;
     private: boolean;
     relative: boolean;
-    destination: string;
+    destinations: string[];
     execute(): Promise<1 | 0>;
 }

package/lib/commands/link.js

@@ -9,15 +9,15 @@ class LinkCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
         this.all = clipanion_1.Option.Boolean(`-A,--all`, false, {
-            description: `Link all workspaces belonging to the target project to the current one`,
+            description: `Link all workspaces belonging to the target projects to the current one`,
         });
         this.private = clipanion_1.Option.Boolean(`-p,--private`, false, {
-            description: `Also link private workspaces belonging to the target project to the current one`,
+            description: `Also link private workspaces belonging to the target projects to the current one`,
         });
         this.relative = clipanion_1.Option.Boolean(`-r,--relative`, false, {
             description: `Link workspaces using relative paths instead of absolute paths`,
         });
-        this.destination = clipanion_1.Option.String();
+        this.destinations = clipanion_1.Option.Rest();
     }
     async execute() {
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
@@ -28,29 +28,35 @@ class LinkCommand extends cli_1.BaseCommand {
         await project.restoreInstallState({
             restoreResolutions: false,
         });
-        const absoluteDestination = fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(this.destination));
-        const configuration2 = await core_1.Configuration.find(absoluteDestination, this.context.plugins, { useRc: false, strict: false });
-        const { project: project2, workspace: workspace2 } = await core_1.Project.find(configuration2, absoluteDestination);
-        if (project.cwd === project2.cwd)
-            throw new clipanion_1.UsageError(`Invalid destination; Can't link the project to itself`);
-        if (!workspace2)
-            throw new cli_1.WorkspaceRequiredError(project2.cwd, absoluteDestination);
         const topLevelWorkspace = project.topLevelWorkspace;
         const linkedWorkspaces = [];
-        if (this.all) {
-            for (const workspace of project2.workspaces)
-                if (workspace.manifest.name && (!workspace.manifest.private || this.private))
-                    linkedWorkspaces.push(workspace);
-            if (linkedWorkspaces.length === 0) {
-                throw new clipanion_1.UsageError(`No workspace found to be linked in the target project`);
+        for (const destination of this.destinations) {
+            const absoluteDestination = fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(destination));
+            const configuration2 = await core_1.Configuration.find(absoluteDestination, this.context.plugins, { useRc: false, strict: false });
+            const { project: project2, workspace: workspace2 } = await core_1.Project.find(configuration2, absoluteDestination);
+            if (project.cwd === project2.cwd)
+                throw new clipanion_1.UsageError(`Invalid destination '${destination}'; Can't link the project to itself`);
+            if (!workspace2)
+                throw new cli_1.WorkspaceRequiredError(project2.cwd, absoluteDestination);
+            if (this.all) {
+                let found = false;
+                for (const workspace of project2.workspaces) {
+                    if (workspace.manifest.name && (!workspace.manifest.private || this.private)) {
+                        linkedWorkspaces.push(workspace);
+                        found = true;
+                    }
+                }
+                if (!found) {
+                    throw new clipanion_1.UsageError(`No workspace found to be linked in the target project: ${destination}`);
+                }
+            }
+            else {
+                if (!workspace2.manifest.name)
+                    throw new clipanion_1.UsageError(`The target workspace at '${destination}' doesn't have a name and thus cannot be linked`);
+                if (workspace2.manifest.private && !this.private)
+                    throw new clipanion_1.UsageError(`The target workspace at '${destination}' is marked private - use the --private flag to link it anyway`);
+                linkedWorkspaces.push(workspace2);
             }
-        }
-        else {
-            if (!workspace2.manifest.name)
-                throw new clipanion_1.UsageError(`The target workspace doesn't have a name and thus cannot be linked`);
-            if (workspace2.manifest.private && !this.private)
-                throw new clipanion_1.UsageError(`The target workspace is marked private - use the --private flag to link it anyway`);
-            linkedWorkspaces.push(workspace2);
         }
         for (const workspace of linkedWorkspaces) {
             const fullName = core_1.structUtils.stringifyIdent(workspace.locator);
@@ -71,7 +77,6 @@ class LinkCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = LinkCommand;
 LinkCommand.paths = [
     [`link`],
 ];
@@ -81,10 +86,11 @@ LinkCommand.usage = clipanion_1.Command.Usage({
       This command will set a new \`resolutions\` field in the project-level manifest and point it to the workspace at the specified location (even if part of another project).
     `,
     examples: [[
-            `Register a remote workspace for use in the current project`,
-            `$0 link ~/ts-loader`,
+            `Register one or more remote workspaces for use in the current project`,
+            `$0 link ~/ts-loader ~/jest`,
         ], [
             `Register all workspaces from a remote project for use in the current project`,
             `$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.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-/// <reference types="node" />
 import { BaseCommand } from '@yarnpkg/cli';
 import { Project, Report } from '@yarnpkg/core';
 import { Usage } from 'clipanion';

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

@@ -89,7 +89,7 @@ class RemoveCommand extends cli_1.BaseCommand {
             ? `any`
             : `this`;
         if (unreferencedPatterns.length > 0)
-            throw new clipanion_1.UsageError(`${patterns} ${core_1.formatUtils.prettyList(configuration, unreferencedPatterns, core_1.FormatType.CODE)} ${dont} match any packages referenced by ${which} workspace`);
+            throw new clipanion_1.UsageError(`${patterns} ${core_1.formatUtils.prettyList(configuration, unreferencedPatterns, core_1.formatUtils.Type.CODE)} ${dont} match any packages referenced by ${which} workspace`);
         if (hasChanged) {
             await configuration.triggerMultipleHooks((hooks) => hooks.afterWorkspaceDependencyRemoval, afterWorkspaceDependencyRemovalList);
             const report = await core_2.StreamReport.start({
@@ -103,7 +103,6 @@ class RemoveCommand extends cli_1.BaseCommand {
         return 0;
     }
 }
-exports.default = RemoveCommand;
 RemoveCommand.paths = [
     [`remove`],
 ];
@@ -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.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-/// <reference types="node" />
 import { BaseCommand } from '@yarnpkg/cli';
 import { Configuration, Report } from '@yarnpkg/core';
 import { Usage } from 'clipanion';

package/lib/commands/set/version.js

@@ -63,11 +63,11 @@ class SetVersionCommand extends cli_1.BaseCommand {
             const filePrefix = `file://`;
             let bundleBuffer;
             if (bundleUrl.startsWith(filePrefix)) {
-                report.reportInfo(core_1.MessageName.UNNAMED, `Downloading ${core_2.formatUtils.pretty(configuration, bundleUrl, core_1.FormatType.URL)}`);
+                report.reportInfo(core_1.MessageName.UNNAMED, `Downloading ${core_2.formatUtils.pretty(configuration, bundleUrl, core_2.formatUtils.Type.URL)}`);
                 bundleBuffer = await fslib_1.xfs.readFilePromise(fslib_1.npath.toPortablePath(bundleUrl.slice(filePrefix.length)));
             }
             else {
-                report.reportInfo(core_1.MessageName.UNNAMED, `Retrieving ${core_2.formatUtils.pretty(configuration, bundleUrl, core_1.FormatType.PATH)}`);
+                report.reportInfo(core_1.MessageName.UNNAMED, `Retrieving ${core_2.formatUtils.pretty(configuration, bundleUrl, core_2.formatUtils.Type.PATH)}`);
                 bundleBuffer = await core_2.httpUtils.get(bundleUrl, { configuration });
             }
             await setVersion(configuration, null, bundleBuffer, { report });
@@ -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

@@ -136,9 +136,9 @@ class UpCommand extends cli_1.BaseCommand {
             }
         }
         if (unreferencedPatterns.length > 1)
-            throw new clipanion_1.UsageError(`Patterns ${core_3.formatUtils.prettyList(configuration, unreferencedPatterns, core_3.FormatType.CODE)} don't match any packages referenced by any workspace`);
+            throw new clipanion_1.UsageError(`Patterns ${core_3.formatUtils.prettyList(configuration, unreferencedPatterns, core_3.formatUtils.Type.CODE)} don't match any packages referenced by any workspace`);
         if (unreferencedPatterns.length > 0)
-            throw new clipanion_1.UsageError(`Pattern ${core_3.formatUtils.prettyList(configuration, unreferencedPatterns, core_3.FormatType.CODE)} doesn't match any packages referenced by any workspace`);
+            throw new clipanion_1.UsageError(`Pattern ${core_3.formatUtils.prettyList(configuration, unreferencedPatterns, core_3.formatUtils.Type.CODE)} doesn't match any packages referenced by any workspace`);
         const allSuggestions = await Promise.all(allSuggestionsPromises);
         const checkReport = await core_3.LightReport.start({
             configuration,
@@ -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`],
 ];
@@ -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

@@ -27,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`],
 ];
@@ -45,3 +44,4 @@ WorkspaceCommand.usage = clipanion_1.Command.Usage({
             `yarn workspace components run build`,
         ]],
 });
+exports.default = WorkspaceCommand;

package/lib/commands/workspaces/list.js

@@ -84,7 +84,6 @@ class WorkspacesListCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = WorkspacesListCommand;
 WorkspacesListCommand.paths = [
     [`workspaces`, `list`],
 ];
@@ -103,3 +102,4 @@ WorkspacesListCommand.usage = clipanion_1.Command.Usage({
       - 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 }) => {

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;

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@yarnpkg/plugin-essentials",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "license": "BSD-2-Clause",
   "main": "./lib/index.js",
   "dependencies": {
-    "@yarnpkg/fslib": "^2.9.0",
-    "@yarnpkg/json-proxy": "^2.1.1",
-    "@yarnpkg/parsers": "^2.5.1",
+    "@yarnpkg/fslib": "^2.10.4",
+    "@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.3.0",
-    "@yarnpkg/core": "^3.3.0",
-    "@yarnpkg/plugin-git": "^2.6.3"
+    "@yarnpkg/cli": "^3.8.0",
+    "@yarnpkg/core": "^3.7.0",
+    "@yarnpkg/plugin-git": "^2.6.8"
   },
   "devDependencies": {
     "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/semver": "^7.1.0",
-    "@types/treeify": "^1.0.0",
-    "@yarnpkg/cli": "^3.3.0",
-    "@yarnpkg/core": "^3.3.0",
-    "@yarnpkg/plugin-git": "^2.6.3"
+    "@yarnpkg/cli": "^3.8.0",
+    "@yarnpkg/core": "^3.7.0",
+    "@yarnpkg/plugin-git": "^2.6.8"
   },
   "repository": {
     "type": "git",