@yarnpkg/plugin-essentials 3.0.0-rc.9 → 3.1.0-rc.10

package/lib/commands/install.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
 const parsers_1 = require("@yarnpkg/parsers");
+const ci_info_1 = (0, tslib_1.__importDefault)(require("ci-info"));
 const clipanion_1 = require("clipanion");
+const t = (0, tslib_1.__importStar)(require("typanion"));
 // eslint-disable-next-line arca/no-default-export
 class YarnCommand extends cli_1.BaseCommand {
     constructor() {
@@ -24,8 +27,9 @@ class YarnCommand extends cli_1.BaseCommand {
         this.inlineBuilds = clipanion_1.Option.Boolean(`--inline-builds`, {
             description: `Verbosely print the output of the build steps of dependencies`,
         });
-        this.skipBuilds = clipanion_1.Option.Boolean(`--skip-builds`, false, {
-            description: `Skip the build step altogether`,
+        this.mode = clipanion_1.Option.String(`--mode`, {
+            description: `Change what artifacts installs generate`,
+            validator: t.isEnum(core_1.InstallMode),
         });
         // Legacy flags; will emit errors or warnings when used
         this.cacheFolder = clipanion_1.Option.String(`--cache-folder`, { hidden: true });
@@ -36,14 +40,13 @@ class YarnCommand extends cli_1.BaseCommand {
         this.production = clipanion_1.Option.Boolean(`--production`, { hidden: true });
         this.registry = clipanion_1.Option.String(`--registry`, { hidden: true });
         this.silent = clipanion_1.Option.Boolean(`--silent`, { hidden: true });
+        this.networkTimeout = clipanion_1.Option.String(`--network-timeout`, { hidden: true });
     }
     async execute() {
         var _a;
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
         if (typeof this.inlineBuilds !== `undefined`)
             configuration.useWithSource(`<cli>`, { enableInlineBuilds: this.inlineBuilds }, configuration.startingCwd, { overwrite: true });
-        const isZeitNow = !!process.env.NOW_BUILDER;
-        const isNetlify = !!process.env.NETLIFY;
         // These variables are used in Google Cloud Platform environment
         // in process of deploying Google Cloud Functions and
         // Google App Engine
@@ -76,7 +79,7 @@ class YarnCommand extends cli_1.BaseCommand {
         // it would definitely be a configuration setting.
         if (typeof this.ignoreEngines !== `undefined`) {
             const exitCode = await reportDeprecation(`The --ignore-engines option is deprecated; engine checking isn't a core feature anymore`, {
-                error: !isZeitNow,
+                error: !ci_info_1.default.VERCEL,
             });
             if (exitCode !== null) {
                 return exitCode;
@@ -102,7 +105,7 @@ class YarnCommand extends cli_1.BaseCommand {
         // let someone implement this "resolver-that-reads-the-cache" logic.
         if (typeof this.preferOffline !== `undefined`) {
             const exitCode = await reportDeprecation(`The --prefer-offline flag is deprecated; use the --cached flag with 'yarn add' instead`, {
-                error: !isZeitNow,
+                error: !ci_info_1.default.VERCEL,
             });
             if (exitCode !== null) {
                 return exitCode;
@@ -145,7 +148,7 @@ class YarnCommand extends cli_1.BaseCommand {
         // Yarn commands would use different caches, causing unexpected behaviors.
         if (typeof this.cacheFolder !== `undefined`) {
             const exitCode = await reportDeprecation(`The cache-folder option has been deprecated; use rc settings instead`, {
-                error: !isNetlify,
+                error: !ci_info_1.default.NETLIFY,
             });
             if (exitCode !== null) {
                 return exitCode;
@@ -174,7 +177,7 @@ class YarnCommand extends cli_1.BaseCommand {
             try {
                 content = await fslib_1.xfs.readFilePromise(fslib_1.ppath.join(projectCwd, fslib_1.Filename.lockfile), `utf8`);
             }
-            catch (_b) { }
+            catch { }
             // If migrating from a v1 install, we automatically enable the node-modules linker,
             // since that's likely what the author intended to do.
             if (content === null || content === void 0 ? void 0 : content.includes(`yarn lockfile v1`)) {
@@ -234,7 +237,7 @@ class YarnCommand extends cli_1.BaseCommand {
             stdout: this.context.stdout,
             includeLogs: true,
         }, async (report) => {
-            await project.install({ cache, report, immutable, skipBuild: this.skipBuilds });
+            await project.install({ cache, report, immutable, mode: this.mode });
         });
         return report.exitCode();
     }
@@ -247,15 +250,15 @@ YarnCommand.paths = [
 YarnCommand.usage = clipanion_1.Command.Usage({
     description: `install the project dependencies`,
     details: `
-      This command setup your project if needed. The installation is splitted in four different steps that each have their own characteristics:
+      This command sets up your project if needed. The installation is split into four different steps that each have their own characteristics:
 
       - **Resolution:** First the package manager will resolve your dependencies. The exact way a dependency version is privileged over another isn't standardized outside of the regular semver guarantees. If a package doesn't resolve to what you would expect, check that all dependencies are correctly declared (also check our website for more information: ).
 
-      - **Fetch:** Then we download all the dependencies if needed, and make sure that they're all stored within our cache (check the value of \`cacheFolder\` in \`yarn config\` to see where are stored the cache files).
+      - **Fetch:** Then we download all the dependencies if needed, and make sure that they're all stored within our cache (check the value of \`cacheFolder\` in \`yarn config\` to see where the cache files are stored).
 
-      - **Link:** Then we send the dependency tree information to internal plugins tasked from writing them on the disk in some form (for example by generating the .pnp.cjs file you might know).
+      - **Link:** Then we send the dependency tree information to internal plugins tasked with writing them on the disk in some form (for example by generating the .pnp.cjs file you might know).
 
-      - **Build:** Once the dependency tree has been written on the disk, the package manager will now be free to run the build scripts for all packages that might need it, in a topological order compatible with the way they depend on one another.
+      - **Build:** Once the dependency tree has been written on the disk, the package manager will now be free to run the build scripts for all packages that might need it, in a topological order compatible with the way they depend on one another. See https://yarnpkg.com/advanced/lifecycle-scripts for detail.
 
       Note that running this command is not part of the recommended workflow. Yarn supports zero-installs, which means that as long as you store your cache and your .pnp.cjs file inside your repository, everything will work without requiring any install right after cloning your repository or switching branches.
 
@@ -267,7 +270,11 @@ YarnCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--inline-builds\` option is set, Yarn will verbosely print the output of the build steps of your dependencies (instead of writing them into individual files). This is likely useful mostly for debug purposes only when using Docker-like environments.
 
-      If the \`--skip-builds\` option is set, Yarn 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.
+      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.
+
+      - \`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.
     `,
     examples: [[
             `Install the project`,
@@ -299,8 +306,8 @@ async function autofixMergeConflicts(configuration, immutable) {
     let parsedLeft;
     let parsedRight;
     try {
-        parsedLeft = parsers_1.parseSyml(left);
-        parsedRight = parsers_1.parseSyml(right);
+        parsedLeft = (0, parsers_1.parseSyml)(left);
+        parsedRight = (0, parsers_1.parseSyml)(right);
     }
     catch (error) {
         throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_FAILED_TO_PARSE, `The individual variants of the lockfile failed to parse`);
@@ -316,7 +323,7 @@ async function autofixMergeConflicts(configuration, immutable) {
     for (const [key, value] of Object.entries(merged))
         if (typeof value === `string`)
             delete merged[key];
-    await fslib_1.xfs.changeFilePromise(lockfilePath, parsers_1.stringifySyml(merged), {
+    await fslib_1.xfs.changeFilePromise(lockfilePath, (0, parsers_1.stringifySyml)(merged), {
         automaticNewlines: true,
     });
     return true;

package/lib/commands/link.d.ts

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

package/lib/commands/plugin/import/sources.d.ts

@@ -12,7 +12,7 @@ export default class PluginDlSourcesCommand extends BaseCommand {
     noMinify: boolean;
     force: boolean;
     name: string;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }
 export declare type BuildAndSavePluginsSpec = {
     context: CommandContext;

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

@@ -38,7 +38,7 @@ class PluginDlSourcesCommand extends cli_1.BaseCommand {
         const configuration = await core_2.Configuration.find(this.context.cwd, this.context.plugins);
         const target = typeof this.installPath !== `undefined`
             ? fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(this.installPath))
-            : fslib_1.ppath.resolve(fslib_1.npath.toPortablePath(os_1.tmpdir()), `yarnpkg-sources`, core_1.hashUtils.makeHash(this.repository).slice(0, 6));
+            : fslib_1.ppath.resolve(fslib_1.npath.toPortablePath((0, os_1.tmpdir)()), `yarnpkg-sources`, core_1.hashUtils.makeHash(this.repository).slice(0, 6));
         const report = await core_2.StreamReport.start({
             configuration,
             stdout: this.context.stdout,
@@ -46,11 +46,11 @@ class PluginDlSourcesCommand extends cli_1.BaseCommand {
             const { project } = await core_2.Project.find(configuration, this.context.cwd);
             const ident = core_1.structUtils.parseIdent(this.name.replace(/^((@yarnpkg\/)?plugin-)?/, `@yarnpkg/plugin-`));
             const identStr = core_1.structUtils.stringifyIdent(ident);
-            const data = await list_1.getAvailablePlugins(configuration);
+            const data = await (0, list_1.getAvailablePlugins)(configuration);
             if (!Object.prototype.hasOwnProperty.call(data, identStr))
                 throw new core_2.ReportError(core_2.MessageName.PLUGIN_NAME_NOT_FOUND, `Couldn't find a plugin named "${identStr}" on the remote registry. Note that only the plugins referenced on our website (https://github.com/yarnpkg/berry/blob/master/plugins.yml) can be built and imported from sources.`);
             const pluginSpec = identStr;
-            await sources_1.prepareRepo(this, { configuration, report, target });
+            await (0, sources_1.prepareRepo)(this, { configuration, report, target });
             await buildAndSavePlugin(pluginSpec, this, { project, report, target });
         });
         return report.exitCode();
@@ -82,13 +82,13 @@ async function buildAndSavePlugin(pluginSpec, { context, noMinify }, { project,
     report.reportSeparator();
     report.reportInfo(core_2.MessageName.UNNAMED, `Building a fresh ${pluginName}`);
     report.reportSeparator();
-    await sources_1.runWorkflow(buildWorkflow({
+    await (0, sources_1.runWorkflow)(buildWorkflow({
         pluginName,
         noMinify,
     }, target), { configuration, context, target });
     report.reportSeparator();
     const pluginPath = fslib_1.ppath.resolve(target, `packages/${pluginName}/bundles/${pluginSpec}.js`);
     const pluginBuffer = await fslib_1.xfs.readFilePromise(pluginPath);
-    await import_1.savePlugin(pluginSpec, pluginBuffer, { project, report });
+    await (0, import_1.savePlugin)(pluginSpec, pluginBuffer, { project, report });
 }
 exports.buildAndSavePlugin = buildAndSavePlugin;

package/lib/commands/plugin/import.d.ts

@@ -6,7 +6,7 @@ export default class PluginDlCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     name: string;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }
 export declare function savePlugin(pluginSpec: string, pluginBuffer: Buffer, { project, report }: {
     project: Project;

package/lib/commands/plugin/import.js

@@ -7,7 +7,7 @@ const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
 const clipanion_1 = require("clipanion");
-const semver_1 = tslib_1.__importDefault(require("semver"));
+const semver_1 = (0, tslib_1.__importDefault)(require("semver"));
 const url_1 = require("url");
 const vm_1 = require("vm");
 const list_1 = require("./list");
@@ -38,7 +38,7 @@ class PluginDlCommand extends cli_1.BaseCommand {
                     try {
                         new url_1.URL(this.name);
                     }
-                    catch (_a) {
+                    catch {
                         throw new core_1.ReportError(core_1.MessageName.INVALID_PLUGIN_REFERENCE, `Plugin specifier "${this.name}" is neither a plugin name nor a valid url`);
                     }
                     pluginSpec = this.name;
@@ -49,7 +49,7 @@ class PluginDlCommand extends cli_1.BaseCommand {
                     if (locator.reference !== `unknown` && !semver_1.default.valid(locator.reference))
                         throw new core_1.ReportError(core_1.MessageName.UNNAMED, `Official plugins only accept strict version references. Use an explicit URL if you wish to download them from another location.`);
                     const identStr = core_2.structUtils.stringifyIdent(locator);
-                    const data = await list_1.getAvailablePlugins(configuration);
+                    const data = await (0, list_1.getAvailablePlugins)(configuration);
                     if (!Object.prototype.hasOwnProperty.call(data, identStr))
                         throw new core_1.ReportError(core_1.MessageName.PLUGIN_NAME_NOT_FOUND, `Couldn't find a plugin named "${identStr}" on the remote registry. Note that only the plugins referenced on our website (https://github.com/yarnpkg/berry/blob/master/plugins.yml) can be referenced by their name; any other plugin will have to be referenced through its public url (for example https://github.com/yarnpkg/berry/raw/master/packages/plugin-typescript/bin/%40yarnpkg/plugin-typescript.js).`);
                     pluginSpec = identStr;
@@ -105,7 +105,7 @@ async function savePlugin(pluginSpec, pluginBuffer, { project, report }) {
     const { configuration } = project;
     const vmExports = {};
     const vmModule = { exports: vmExports };
-    vm_1.runInNewContext(pluginBuffer.toString(), {
+    (0, vm_1.runInNewContext)(pluginBuffer.toString(), {
         module: vmModule,
         exports: vmExports,
     });
@@ -127,7 +127,7 @@ async function savePlugin(pluginSpec, pluginBuffer, { project, report }) {
                 ? entry.path
                 : entry;
             const pluginPath = fslib_1.ppath.resolve(project.cwd, fslib_1.npath.toPortablePath(userProvidedPath));
-            const { name } = core_1.miscUtils.dynamicRequire(fslib_1.npath.fromPortablePath(pluginPath));
+            const { name } = core_1.miscUtils.dynamicRequire(pluginPath);
             if (name !== pluginName) {
                 plugins.push(entry);
             }

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

@@ -8,5 +8,5 @@ export default class PluginDlCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     json: boolean;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/plugin/list.js

@@ -8,7 +8,7 @@ const clipanion_1 = require("clipanion");
 const REMOTE_REGISTRY = `https://raw.githubusercontent.com/yarnpkg/berry/master/plugins.yml`;
 async function getAvailablePlugins(configuration) {
     const raw = await core_1.httpUtils.get(REMOTE_REGISTRY, { configuration });
-    const data = parsers_1.parseSyml(raw.toString());
+    const data = (0, parsers_1.parseSyml)(raw.toString());
     return data;
 }
 exports.getAvailablePlugins = getAvailablePlugins;

package/lib/commands/plugin/remove.d.ts

@@ -4,5 +4,5 @@ export default class PluginRemoveCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     name: string;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/plugin/runtime.d.ts

@@ -4,5 +4,5 @@ export default class PluginListCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     json: boolean;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/rebuild.d.ts

@@ -4,5 +4,5 @@ export default class RunCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     idents: string[];
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/remove.d.ts

@@ -1,9 +1,11 @@
 import { BaseCommand } from '@yarnpkg/cli';
+import { InstallMode } from '@yarnpkg/core';
 import { Usage } from 'clipanion';
 export default class RemoveCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     all: boolean;
+    mode: InstallMode | undefined;
     patterns: string[];
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/remove.js

@@ -6,8 +6,9 @@ const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
 const core_3 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
-const suggestUtils = tslib_1.__importStar(require("../suggestUtils"));
+const micromatch_1 = (0, tslib_1.__importDefault)(require("micromatch"));
+const t = (0, tslib_1.__importStar)(require("typanion"));
+const suggestUtils = (0, tslib_1.__importStar)(require("../suggestUtils"));
 // eslint-disable-next-line arca/no-default-export
 class RemoveCommand extends cli_1.BaseCommand {
     constructor() {
@@ -15,6 +16,10 @@ class RemoveCommand extends cli_1.BaseCommand {
         this.all = clipanion_1.Option.Boolean(`-A,--all`, false, {
             description: `Apply the operation to all workspaces from the current project`,
         });
+        this.mode = clipanion_1.Option.String(`--mode`, {
+            description: `Change what artifacts installs generate`,
+            validator: t.isEnum(core_2.InstallMode),
+        });
         this.patterns = clipanion_1.Option.Rest();
     }
     async execute() {
@@ -44,7 +49,7 @@ class RemoveCommand extends cli_1.BaseCommand {
             const pseudoIdent = core_3.structUtils.parseIdent(pattern);
             for (const workspace of affectedWorkspaces) {
                 const peerDependenciesMeta = [...workspace.manifest.peerDependenciesMeta.keys()];
-                for (const stringifiedIdent of micromatch_1.default(peerDependenciesMeta, pattern)) {
+                for (const stringifiedIdent of (0, micromatch_1.default)(peerDependenciesMeta, pattern)) {
                     workspace.manifest.peerDependenciesMeta.delete(stringifiedIdent);
                     hasChanged = true;
                     isReferenced = true;
@@ -54,7 +59,7 @@ class RemoveCommand extends cli_1.BaseCommand {
                     const stringifiedIdents = [...descriptors.values()].map(descriptor => {
                         return core_3.structUtils.stringifyIdent(descriptor);
                     });
-                    for (const stringifiedIdent of micromatch_1.default(stringifiedIdents, core_3.structUtils.stringifyIdent(pseudoIdent))) {
+                    for (const stringifiedIdent of (0, micromatch_1.default)(stringifiedIdents, core_3.structUtils.stringifyIdent(pseudoIdent))) {
                         const { identHash } = core_3.structUtils.parseIdent(stringifiedIdent);
                         const removedDescriptor = descriptors.get(identHash);
                         if (typeof removedDescriptor === `undefined`)
@@ -91,7 +96,7 @@ class RemoveCommand extends cli_1.BaseCommand {
                 configuration,
                 stdout: this.context.stdout,
             }, async (report) => {
-                await project.install({ cache, report });
+                await project.install({ cache, report, mode: this.mode });
             });
             return report.exitCode();
         }
@@ -107,6 +112,12 @@ RemoveCommand.usage = clipanion_1.Command.Usage({
     details: `
       This command will remove the packages matching the specified patterns from the current workspace.
 
+      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.
+
+      - \`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.
+
       This command accepts glob patterns as arguments (if valid Idents and supported by [micromatch](https://github.com/micromatch/micromatch)). Make sure to escape the patterns, to prevent your own shell from trying to expand them.
     `,
     examples: [[

package/lib/commands/run.js

@@ -16,12 +16,12 @@ class RunCommand extends cli_1.BaseCommand {
             tolerateBoolean: true,
             description: `Forwarded to the underlying Node process when executing a binary`,
         });
-        // This flag is mostly used to give users a way to configure node-gyp. They
-        // just have to add it as a top-level workspace.
-        this.topLevel = clipanion_1.Option.Boolean(`-T,--top-level`, false, { hidden: true });
-        // Some tools (for example text editors) want to call the real binaries, not
-        // what their users might have remapped them to in their `scripts` field.
-        this.binariesOnly = clipanion_1.Option.Boolean(`-B,--binaries-only`, false, { hidden: true });
+        this.topLevel = clipanion_1.Option.Boolean(`-T,--top-level`, false, {
+            description: `Check the root workspace for scripts and/or binaries instead of the current one`,
+        });
+        this.binariesOnly = clipanion_1.Option.Boolean(`-B,--binaries-only`, false, {
+            description: `Ignore any user defined scripts and only check for binaries`,
+        });
         // 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

package/lib/commands/runIndex.d.ts

@@ -1,5 +1,5 @@
 import { BaseCommand } from '@yarnpkg/cli';
 export default class RunCommand extends BaseCommand {
     static paths: string[][];
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/runIndex.js

@@ -26,7 +26,7 @@ class RunCommand extends cli_1.BaseCommand {
                 return Math.max(max, key.length);
             }, 0);
             for (const [key, value] of scripts.entries()) {
-                report.reportInfo(null, `${key.padEnd(maxKeyLength, ` `)}   ${util_1.inspect(value, inspectConfig)}`);
+                report.reportInfo(null, `${key.padEnd(maxKeyLength, ` `)}   ${(0, util_1.inspect)(value, inspectConfig)}`);
             }
         });
         return report.exitCode();

package/lib/commands/set/resolution.d.ts

@@ -6,5 +6,5 @@ export default class SetResolutionCommand extends BaseCommand {
     save: boolean;
     descriptor: string;
     resolution: string;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/set/version/sources.d.ts

@@ -12,7 +12,7 @@ export default class SetVersionSourcesCommand extends BaseCommand {
     noMinify: boolean;
     force: boolean;
     skipPlugins: boolean;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }
 export declare function runWorkflow(workflow: Array<Array<string>>, { configuration, context, target }: {
     configuration: Configuration;

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

@@ -63,7 +63,7 @@ class SetVersionSourcesCommand extends cli_1.BaseCommand {
         const { project } = await core_1.Project.find(configuration, this.context.cwd);
         const target = typeof this.installPath !== `undefined`
             ? fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(this.installPath))
-            : fslib_1.ppath.resolve(fslib_1.npath.toPortablePath(os_1.tmpdir()), `yarnpkg-sources`, core_1.hashUtils.makeHash(this.repository).slice(0, 6));
+            : fslib_1.ppath.resolve(fslib_1.npath.toPortablePath((0, os_1.tmpdir)()), `yarnpkg-sources`, core_1.hashUtils.makeHash(this.repository).slice(0, 6));
         const report = await core_1.StreamReport.start({
             configuration,
             stdout: this.context.stdout,
@@ -76,7 +76,7 @@ class SetVersionSourcesCommand extends cli_1.BaseCommand {
             report.reportSeparator();
             const bundlePath = fslib_1.ppath.resolve(target, `packages/yarnpkg-cli/bundles/yarn.js`);
             const bundleBuffer = await fslib_1.xfs.readFilePromise(bundlePath);
-            await version_1.setVersion(configuration, `sources`, bundleBuffer, {
+            await (0, version_1.setVersion)(configuration, `sources`, bundleBuffer, {
                 report,
             });
             if (!this.skipPlugins) {
@@ -156,11 +156,11 @@ async function prepareRepo(spec, { configuration, report, target }) {
 }
 exports.prepareRepo = prepareRepo;
 async function updatePlugins(context, { project, report, target }) {
-    const data = await list_1.getAvailablePlugins(project.configuration);
+    const data = await (0, list_1.getAvailablePlugins)(project.configuration);
     const contribPlugins = new Set(Object.keys(data));
     for (const name of project.configuration.plugins.keys()) {
         if (!contribPlugins.has(name))
             continue;
-        await sources_1.buildAndSavePlugin(name, context, { project, report, target });
+        await (0, sources_1.buildAndSavePlugin)(name, context, { project, report, target });
     }
 }

package/lib/commands/set/version.d.ts

@@ -2,14 +2,19 @@
 import { BaseCommand } from '@yarnpkg/cli';
 import { Configuration, Report } from '@yarnpkg/core';
 import { Usage } from 'clipanion';
+export declare type Tags = {
+    latest: Record<string, string>;
+    tags: Array<string>;
+};
 export default class SetVersionCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     onlyIfNeeded: boolean;
     version: string;
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }
-export declare function findVersion(configuration: Configuration, request: `stable` | `canary`): Promise<any>;
+export declare function resolveRange(configuration: Configuration, request: string): Promise<string>;
+export declare function resolveTag(configuration: Configuration, request: `stable` | `canary`): Promise<string>;
 export declare function setVersion(configuration: Configuration, bundleVersion: string | null, bundleBuffer: Buffer, { report }: {
     report: Report;
 }): Promise<void>;

package/lib/commands/set/version.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setVersion = exports.findVersion = void 0;
+exports.setVersion = exports.resolveTag = exports.resolveRange = void 0;
 const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
 const clipanion_1 = require("clipanion");
-const semver_1 = tslib_1.__importDefault(require("semver"));
+const semver_1 = (0, tslib_1.__importDefault)(require("semver"));
 // eslint-disable-next-line arca/no-default-export
 class SetVersionCommand extends cli_1.BaseCommand {
     constructor() {
@@ -30,9 +30,9 @@ class SetVersionCommand extends cli_1.BaseCommand {
         if (this.version === `self`)
             bundleUrl = getBundlePath();
         else if (this.version === `latest` || this.version === `berry` || this.version === `stable`)
-            bundleUrl = `https://repo.yarnpkg.com/${await findVersion(configuration, `stable`)}/packages/yarnpkg-cli/bin/yarn.js`;
+            bundleUrl = `https://repo.yarnpkg.com/${await resolveTag(configuration, `stable`)}/packages/yarnpkg-cli/bin/yarn.js`;
         else if (this.version === `canary`)
-            bundleUrl = `https://repo.yarnpkg.com/${await findVersion(configuration, `canary`)}/packages/yarnpkg-cli/bin/yarn.js`;
+            bundleUrl = `https://repo.yarnpkg.com/${await resolveTag(configuration, `canary`)}/packages/yarnpkg-cli/bin/yarn.js`;
         else if (this.version === `classic`)
             bundleUrl = `https://nightly.yarnpkg.com/latest.js`;
         else if (this.version.match(/^\.{0,2}[\\/]/) || fslib_1.npath.isAbsolute(this.version))
@@ -42,7 +42,7 @@ class SetVersionCommand extends cli_1.BaseCommand {
         else if (core_2.semverUtils.satisfiesWithPrereleases(this.version, `^0.x || ^1.x`))
             bundleUrl = `https://github.com/yarnpkg/yarn/releases/download/v${this.version}/yarn-${this.version}.js`;
         else if (core_2.semverUtils.validRange(this.version))
-            throw new clipanion_1.UsageError(`Support for ranges got removed - please use the exact version you want to install, or 'latest' to get the latest build available`);
+            bundleUrl = `https://repo.yarnpkg.com/${await resolveRange(configuration, this.version)}/packages/yarnpkg-cli/bin/yarn.js`;
         else
             throw new clipanion_1.UsageError(`Invalid version descriptor "${this.version}"`);
         const report = await core_1.StreamReport.start({
@@ -75,28 +75,64 @@ SetVersionCommand.usage = clipanion_1.Command.Usage({
       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.
+
+      The version specifier can be:
+
+      - a tag:
+        - \`latest\` / \`berry\` / \`stable\` -> the most recent stable berry (\`>=2.0.0\`) release
+        - \`canary\` -> the most recent canary (release candidate) berry (\`>=2.0.0\`) release
+        - \`classic\` -> the most recent classic (\`^0.x || ^1.x\`) release
+
+      - a semver range (e.g. \`2.x\`) -> the most recent version satisfying the range (limited to berry releases)
+
+      - a semver version (e.g. \`2.4.1\`, \`1.22.1\`)
+
+      - a local file referenced through either a relative or absolute path
+
+      - \`self\` -> the version used to invoke the command
     `,
     examples: [[
             `Download the latest release from the Yarn repository`,
             `$0 set version latest`,
+        ], [
+            `Download the latest canary release from the Yarn repository`,
+            `$0 set version canary`,
         ], [
             `Download the latest classic release from the Yarn repository`,
             `$0 set version classic`,
+        ], [
+            `Download the most recent Yarn 3 build`,
+            `$0 set version 3.x`,
         ], [
             `Download a specific Yarn 2 build`,
             `$0 set version 2.0.0-rc.30`,
         ], [
             `Switch back to a specific Yarn 1 release`,
             `$0 set version 1.22.1`,
+        ], [
+            `Use a release from the local filesystem`,
+            `$0 set version ./yarn.cjs`,
+        ], [
+            `Download the version used to invoke the command`,
+            `$0 set version self`,
         ]],
 });
-async function findVersion(configuration, request) {
+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));
+    if (candidates.length === 0)
+        throw new clipanion_1.UsageError(`No matching release found for range ${core_2.formatUtils.pretty(configuration, request, core_2.formatUtils.Type.RANGE)}.`);
+    // The tags on the website are sorted by semver descending
+    return candidates[0];
+}
+exports.resolveRange = resolveRange;
+async function resolveTag(configuration, request) {
     const data = await core_2.httpUtils.get(`https://repo.yarnpkg.com/tags`, { configuration, jsonResponse: true });
     if (!data.latest[request])
-        throw new clipanion_1.UsageError(`Tag '${request}' not found`);
+        throw new clipanion_1.UsageError(`Tag ${core_2.formatUtils.pretty(configuration, request, core_2.formatUtils.Type.RANGE)} not found`);
     return data.latest[request];
 }
-exports.findVersion = findVersion;
+exports.resolveTag = resolveTag;
 async function setVersion(configuration, bundleVersion, bundleBuffer, { report }) {
     var _a;
     if (bundleVersion === null) {
@@ -123,8 +159,7 @@ async function setVersion(configuration, bundleVersion, bundleBuffer, { report }
     report.reportInfo(core_1.MessageName.UNNAMED, `Saving the new release in ${core_2.formatUtils.pretty(configuration, displayPath, `magenta`)}`);
     await fslib_1.xfs.removePromise(fslib_1.ppath.dirname(absolutePath));
     await fslib_1.xfs.mkdirPromise(fslib_1.ppath.dirname(absolutePath), { recursive: true });
-    await fslib_1.xfs.writeFilePromise(absolutePath, bundleBuffer);
-    await fslib_1.xfs.chmodPromise(absolutePath, 0o755);
+    await fslib_1.xfs.writeFilePromise(absolutePath, bundleBuffer, { mode: 0o755 });
     if (updateConfig) {
         await core_1.Configuration.updateConfiguration(projectCwd, {
             yarnPath: projectPath,

package/lib/commands/unlink.d.ts

@@ -5,5 +5,5 @@ export default class UnlinkCommand extends BaseCommand {
     static usage: Usage;
     all: boolean;
     leadingArguments: string[];
-    execute(): Promise<0 | 1>;
+    execute(): Promise<1 | 0>;
 }

package/lib/commands/unlink.js

@@ -5,7 +5,7 @@ const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
 const clipanion_1 = require("clipanion");
-const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
+const micromatch_1 = (0, tslib_1.__importDefault)(require("micromatch"));
 // eslint-disable-next-line arca/no-default-export
 class UnlinkCommand extends cli_1.BaseCommand {
     constructor() {
@@ -54,7 +54,7 @@ class UnlinkCommand extends cli_1.BaseCommand {
                 }
                 else {
                     const fullNames = [...topLevelWorkspace.manifest.resolutions.map(({ pattern }) => pattern.descriptor.fullName)];
-                    for (const fullName of micromatch_1.default(fullNames, leadingArgument)) {
+                    for (const fullName of (0, micromatch_1.default)(fullNames, leadingArgument)) {
                         workspacesToUnlink.add(fullName);
                     }
                 }