@yarnpkg/plugin-essentials 4.0.0-rc.8 → 4.0.0

package/lib/commands/add.d.ts

@@ -18,5 +18,5 @@ export default class AddCommand extends BaseCommand {
     mode: InstallMode | undefined;
     silent: boolean | undefined;
     packages: string[];
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

package/lib/commands/add.js

@@ -54,7 +54,6 @@ class AddCommand extends cli_1.BaseCommand {
         this.packages = clipanion_1.Option.Rest();
     }
     async execute() {
-        var _a;
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
         const { project, workspace } = await core_2.Project.find(configuration, this.context.cwd);
         const cache = await core_1.Cache.find(configuration);
@@ -64,7 +63,7 @@ class AddCommand extends cli_1.BaseCommand {
             restoreResolutions: false,
         });
         const fixed = this.fixed;
-        const interactive = (_a = this.interactive) !== null && _a !== void 0 ? _a : configuration.get(`preferInteractive`);
+        const interactive = this.interactive ?? configuration.get(`preferInteractive`);
         const reuse = interactive || configuration.get(`preferReuse`);
         const modifier = suggestUtils.getModifier(this, project);
         const strategies = [
@@ -86,24 +85,27 @@ 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?`);
-            const target = suggestTarget(workspace, request, {
+                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,
                 preferDev: this.preferDev,
                 optional: this.optional,
             });
-            const suggestions = await suggestUtils.getSuggestedDescriptors(request, { project, workspace, cache, fixed, target, modifier, strategies, maxResults });
-            return [request, suggestions, target];
-        }));
+            const results = await Promise.all(targetList.map(async (target) => {
+                const suggestedDescriptors = await suggestUtils.getSuggestedDescriptors(request, { project, workspace, cache, fixed, target, modifier, strategies, maxResults });
+                return { request, suggestedDescriptors, target };
+            }));
+            return results;
+        })).then(results => results.flat());
         const checkReport = await core_1.LightReport.start({
             configuration,
             stdout: this.context.stdout,
             suggestInstall: false,
         }, async (report) => {
-            for (const [request, { suggestions, rejections }] of allSuggestions) {
+            for (const { request, suggestedDescriptors: { suggestions, rejections } } of allSuggestions) {
                 const nonNullSuggestions = suggestions.filter(suggestion => {
                     return suggestion.descriptor !== null;
                 });
@@ -125,7 +127,7 @@ class AddCommand extends cli_1.BaseCommand {
         let askedQuestions = false;
         const afterWorkspaceDependencyAdditionList = [];
         const afterWorkspaceDependencyReplacementList = [];
-        for (const [/*request*/ , { suggestions }, target] of allSuggestions) {
+        for (const { suggestedDescriptors: { suggestions }, target } of allSuggestions) {
             let selected;
             const nonNullSuggestions = suggestions.filter(suggestion => {
                 return suggestion.descriptor !== null;
@@ -198,18 +200,16 @@ class AddCommand extends cli_1.BaseCommand {
         await configuration.triggerMultipleHooks((hooks) => hooks.afterWorkspaceDependencyReplacement, afterWorkspaceDependencyReplacementList);
         if (askedQuestions)
             this.context.stdout.write(`\n`);
-        const installReport = await core_2.StreamReport.start({
-            configuration,
+        return await project.installWithNewReport({
             json: this.json,
             stdout: this.context.stdout,
-            includeLogs: !this.context.quiet,
-        }, async (report) => {
-            await project.install({ cache, report, mode: this.mode });
+            quiet: this.context.quiet,
+        }, {
+            cache,
+            mode: this.mode,
         });
-        return installReport.exitCode();
     }
 }
-exports.default = AddCommand;
 AddCommand.paths = [
     [`add`],
 ];
@@ -236,7 +236,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.
 
@@ -262,7 +262,8 @@ AddCommand.usage = clipanion_1.Command.Usage({
             `$0 add lodash-es@lodash/lodash#es`,
         ]],
 });
-function suggestTarget(workspace, ident, { dev, peer, preferDev, optional }) {
+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);
     const hasPeer = workspace.manifest[suggestUtils.Target.PEER].has(ident.identHash);
@@ -276,13 +277,21 @@ function suggestTarget(workspace, ident, { dev, peer, preferDev, optional }) {
         throw new clipanion_1.UsageError(`Package "${core_3.structUtils.prettyIdent(workspace.project.configuration, ident)}" is already listed as a peer dependency - remove the -O flag or add the -P flag or remove it from your peer dependencies first`);
     if ((dev || preferDev) && optional)
         throw new clipanion_1.UsageError(`Package "${core_3.structUtils.prettyIdent(workspace.project.configuration, ident)}" cannot simultaneously be a dev dependency and an optional dependency`);
+    // When the program executes this line, the command is expected to be legal
+    const targetList = [];
     if (peer)
-        return suggestUtils.Target.PEER;
+        targetList.push(suggestUtils.Target.PEER);
     if (dev || preferDev)
-        return suggestUtils.Target.DEVELOPMENT;
-    if (hasRegular)
-        return suggestUtils.Target.REGULAR;
+        targetList.push(suggestUtils.Target.DEVELOPMENT);
+    if (optional)
+        targetList.push(suggestUtils.Target.REGULAR);
+    // The user explicitly define the targets
+    if (targetList.length > 0)
+        return targetList;
+    // The user does not define the targets, find it from the `workspace.manifest`
     if (hasDev)
-        return suggestUtils.Target.DEVELOPMENT;
-    return suggestUtils.Target.REGULAR;
+        return [suggestUtils.Target.DEVELOPMENT];
+    if (hasPeer)
+        return [suggestUtils.Target.PEER];
+    return [suggestUtils.Target.REGULAR];
 }

package/lib/commands/bin.d.ts

@@ -6,5 +6,5 @@ export default class BinCommand extends BaseCommand {
     verbose: boolean;
     json: boolean;
     name: string | undefined;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

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.d.ts

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

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.d.ts

@@ -3,8 +3,9 @@ import { Usage } from 'clipanion';
 export default class ConfigGetCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
+    why: boolean;
     json: boolean;
     unsafe: boolean;
     name: string;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

package/lib/commands/config/get.js

@@ -10,6 +10,9 @@ const util_1 = require("util");
 class ConfigGetCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
+        this.why = clipanion_1.Option.Boolean(`--why`, false, {
+            description: `Print the explanation for why a setting has its value`,
+        });
         this.json = clipanion_1.Option.Boolean(`--json`, false, {
             description: `Format the output as an NDJSON stream`,
         });
@@ -57,7 +60,6 @@ class ConfigGetCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ConfigGetCommand;
 ConfigGetCommand.paths = [
     [`config`, `get`],
 ];
@@ -85,3 +87,4 @@ ConfigGetCommand.usage = clipanion_1.Command.Usage({
             `yarn config get packageExtensions --json`,
         ]],
 });
+exports.default = ConfigGetCommand;

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

@@ -7,5 +7,5 @@ export default class ConfigSetCommand extends BaseCommand {
     home: boolean;
     name: string;
     value: string;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

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.d.ts

@@ -5,5 +5,5 @@ export default class ConfigUnsetCommand extends BaseCommand {
     static usage: Usage;
     home: boolean;
     name: string;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

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.d.ts

@@ -3,8 +3,10 @@ import { Usage } from 'clipanion';
 export default class ConfigCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
-    verbose: boolean;
-    why: boolean;
+    noDefaults: boolean;
     json: boolean;
-    execute(): Promise<1 | 0>;
+    verbose: boolean | undefined;
+    why: boolean | undefined;
+    names: string[];
+    execute(): Promise<0 | 1>;
 }

package/lib/commands/config.js

@@ -2,31 +2,50 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 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 util_1 = require("util");
 // eslint-disable-next-line arca/no-default-export
 class ConfigCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
-        this.verbose = clipanion_1.Option.Boolean(`-v,--verbose`, false, {
-            description: `Print the setting description on top of the regular key/value information`,
-        });
-        this.why = clipanion_1.Option.Boolean(`--why`, false, {
-            description: `Print the reason why a setting is set a particular way`,
+        this.noDefaults = clipanion_1.Option.Boolean(`--no-defaults`, false, {
+            description: `Omit the default values from the display`,
         });
         this.json = clipanion_1.Option.Boolean(`--json`, false, {
             description: `Format the output as an NDJSON stream`,
         });
+        // Legacy flags; will emit errors or warnings when used
+        this.verbose = clipanion_1.Option.Boolean(`-v,--verbose`, { hidden: true });
+        this.why = clipanion_1.Option.Boolean(`--why`, { hidden: true });
+        this.names = clipanion_1.Option.Rest();
     }
     async execute() {
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins, {
             strict: false,
         });
+        const deprecationExitCode = await (0, core_1.reportOptionDeprecations)({
+            configuration,
+            stdout: this.context.stdout,
+            forceError: this.json,
+        }, [{
+                option: this.verbose,
+                message: `The --verbose option is deprecated, the settings' descriptions are now always displayed`,
+            }, {
+                option: this.why,
+                message: `The --why option is deprecated, the settings' sources are now always displayed`,
+            }]);
+        if (deprecationExitCode !== null)
+            return deprecationExitCode;
+        const names = this.names.length > 0
+            ? [...new Set(this.names)].sort()
+            : [...configuration.settings.keys()].sort();
+        let trailingValue;
         const report = await core_1.StreamReport.start({
             configuration,
             json: this.json,
             stdout: this.context.stdout,
+            includeFooter: false,
         }, async (report) => {
             if (configuration.invalid.size > 0 && !this.json) {
                 for (const [key, source] of configuration.invalid)
@@ -34,58 +53,95 @@ class ConfigCommand extends cli_1.BaseCommand {
                 report.reportSeparator();
             }
             if (this.json) {
-                const keys = core_2.miscUtils.sortMap(configuration.settings.keys(), key => key);
-                for (const key of keys) {
-                    const data = configuration.settings.get(key);
-                    const effective = configuration.getSpecial(key, {
+                for (const name of names) {
+                    const data = configuration.settings.get(name);
+                    if (typeof data === `undefined`)
+                        report.reportError(core_1.MessageName.INVALID_CONFIGURATION_KEY, `No configuration key named "${name}"`);
+                    const effective = configuration.getSpecial(name, {
                         hideSecrets: true,
                         getNativePaths: true,
                     });
-                    const source = configuration.sources.get(key);
-                    if (this.verbose) {
-                        report.reportJson({ key, effective, source });
-                    }
-                    else {
-                        report.reportJson({ key, effective, source, ...data });
-                    }
+                    const source = configuration.sources.get(name) ?? `<default>`;
+                    const sourceAsNativePath = source && source[0] !== `<`
+                        ? fslib_1.npath.fromPortablePath(source)
+                        : source;
+                    report.reportJson({ key: name, effective, source: sourceAsNativePath, ...data });
                 }
             }
             else {
-                const keys = core_2.miscUtils.sortMap(configuration.settings.keys(), key => key);
-                const maxKeyLength = keys.reduce((max, key) => Math.max(max, key.length), 0);
                 const inspectConfig = {
                     breakLength: Infinity,
                     colors: configuration.get(`enableColors`),
                     maxArrayLength: 2,
                 };
-                if (this.why || this.verbose) {
-                    const keysAndDescriptions = keys.map(key => {
-                        const setting = configuration.settings.get(key);
-                        if (!setting)
-                            throw new Error(`Assertion failed: This settings ("${key}") should have been registered`);
-                        const description = this.why
-                            ? configuration.sources.get(key) || `<default>`
-                            : setting.description;
-                        return [key, description];
-                    });
-                    const maxDescriptionLength = keysAndDescriptions.reduce((max, [, description]) => {
-                        return Math.max(max, description.length);
-                    }, 0);
-                    for (const [key, description] of keysAndDescriptions) {
-                        report.reportInfo(null, `${key.padEnd(maxKeyLength, ` `)}   ${description.padEnd(maxDescriptionLength, ` `)}   ${(0, util_1.inspect)(configuration.getSpecial(key, { hideSecrets: true, getNativePaths: true }), inspectConfig)}`);
+                const configTreeChildren = {};
+                const configTree = { children: configTreeChildren };
+                for (const name of names) {
+                    if (this.noDefaults && !configuration.sources.has(name))
+                        continue;
+                    const setting = configuration.settings.get(name);
+                    const source = configuration.sources.get(name) ?? `<default>`;
+                    const value = configuration.getSpecial(name, { hideSecrets: true, getNativePaths: true });
+                    const fields = {
+                        Description: {
+                            label: `Description`,
+                            value: core_1.formatUtils.tuple(core_1.formatUtils.Type.MARKDOWN, { text: setting.description, format: this.cli.format(), paragraphs: false }),
+                        },
+                        Source: {
+                            label: `Source`,
+                            value: core_1.formatUtils.tuple(source[0] === `<` ? core_1.formatUtils.Type.CODE : core_1.formatUtils.Type.PATH, source),
+                        },
+                    };
+                    configTreeChildren[name] = {
+                        value: core_1.formatUtils.tuple(core_1.formatUtils.Type.CODE, name),
+                        children: fields,
+                    };
+                    const setValueTo = (node, value) => {
+                        for (const [key, subValue] of value) {
+                            if (subValue instanceof Map) {
+                                const subFields = {};
+                                node[key] = { children: subFields };
+                                setValueTo(subFields, subValue);
+                            }
+                            else {
+                                node[key] = {
+                                    label: key,
+                                    value: core_1.formatUtils.tuple(core_1.formatUtils.Type.NO_HINT, (0, util_1.inspect)(subValue, inspectConfig)),
+                                };
+                            }
+                        }
+                    };
+                    if (value instanceof Map) {
+                        setValueTo(fields, value);
                     }
-                }
-                else {
-                    for (const key of keys) {
-                        report.reportInfo(null, `${key.padEnd(maxKeyLength, ` `)}   ${(0, util_1.inspect)(configuration.getSpecial(key, { hideSecrets: true, getNativePaths: true }), inspectConfig)}`);
+                    else {
+                        fields.Value = {
+                            label: `Value`,
+                            value: core_1.formatUtils.tuple(core_1.formatUtils.Type.NO_HINT, (0, util_1.inspect)(value, inspectConfig)),
+                        };
                     }
                 }
+                if (names.length !== 1)
+                    trailingValue = undefined;
+                core_1.treeUtils.emitTree(configTree, {
+                    configuration,
+                    json: this.json,
+                    stdout: this.context.stdout,
+                    separators: 2,
+                });
             }
         });
+        if (!this.json && typeof trailingValue !== `undefined`) {
+            const name = names[0];
+            const value = (0, util_1.inspect)(configuration.getSpecial(name, { hideSecrets: true, getNativePaths: true }), {
+                colors: configuration.get(`enableColors`),
+            });
+            this.context.stdout.write(`\n`);
+            this.context.stdout.write(`${value}\n`);
+        }
         return report.exitCode();
     }
 }
-exports.default = ConfigCommand;
 ConfigCommand.paths = [
     [`config`],
 ];
@@ -99,3 +155,4 @@ ConfigCommand.usage = clipanion_1.Command.Usage({
             `$0 config`,
         ]],
 });
+exports.default = ConfigCommand;

package/lib/commands/dedupe.d.ts

@@ -22,5 +22,5 @@ export default class DedupeCommand extends BaseCommand {
     json: boolean;
     mode: InstallMode | undefined;
     patterns: string[];
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }

package/lib/commands/dedupe.js

@@ -61,18 +61,16 @@ class DedupeCommand extends cli_1.BaseCommand {
             return dedupedPackageCount ? 1 : 0;
         }
         else {
-            const installReport = await core_1.StreamReport.start({
-                configuration,
-                stdout: this.context.stdout,
+            return await project.installWithNewReport({
                 json: this.json,
-            }, async (report) => {
-                await project.install({ cache, report, mode: this.mode });
+                stdout: this.context.stdout,
+            }, {
+                cache,
+                mode: this.mode,
             });
-            return installReport.exitCode();
         }
     }
 }
-exports.default = DedupeCommand;
 DedupeCommand.paths = [
     [`dedupe`],
 ];
@@ -91,7 +89,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 +122,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.d.ts

@@ -6,8 +6,8 @@ export default class ExplainPeerRequirementsCommand extends BaseCommand {
     static paths: string[][];
     static usage: import("clipanion").Usage;
     hash: string | undefined;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }
 export declare function explainPeerRequirements(peerRequirementsHash: string, project: Project, opts: {
     stdout: Writable;
-}): Promise<1 | 0>;
+}): Promise<0 | 1>;

package/lib/commands/explain/peerRequirements.js

@@ -35,7 +35,6 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
             stdout: this.context.stdout,
             includeFooter: false,
         }, async (report) => {
-            var _a;
             const sortCriterias = [
                 ([, requirement]) => core_1.structUtils.stringifyLocator(project.storedPackages.get(requirement.subject)),
                 ([, requirement]) => core_1.structUtils.stringifyIdent(requirement.requested),
@@ -47,7 +46,7 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
                 const rootRequester = project.storedPackages.get(requirement.rootRequester);
                 if (typeof rootRequester === `undefined`)
                     throw new Error(`Assertion failed: Expected the root package to have been registered`);
-                const providedDescriptor = (_a = subject.dependencies.get(requirement.requested.identHash)) !== null && _a !== void 0 ? _a : null;
+                const providedDescriptor = subject.dependencies.get(requirement.requested.identHash) ?? null;
                 const prettyHash = core_1.formatUtils.pretty(configuration, hash, core_1.formatUtils.Type.CODE);
                 const prettySubject = core_1.structUtils.prettyLocator(configuration, subject);
                 const prettyIdent = core_1.structUtils.prettyIdent(configuration, requirement.requested);
@@ -62,7 +61,6 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
         return report.exitCode();
     }
 }
-exports.default = ExplainPeerRequirementsCommand;
 ExplainPeerRequirementsCommand.paths = [
     [`explain`, `peer-requirements`],
 ];
@@ -85,6 +83,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);
@@ -95,14 +94,13 @@ async function explainPeerRequirements(peerRequirementsHash, project, opts) {
         stdout: opts.stdout,
         includeFooter: false,
     }, async (report) => {
-        var _a, _b;
         const subject = project.storedPackages.get(requirement.subject);
         if (typeof subject === `undefined`)
             throw new Error(`Assertion failed: Expected the subject package to have been registered`);
         const rootRequester = project.storedPackages.get(requirement.rootRequester);
         if (typeof rootRequester === `undefined`)
             throw new Error(`Assertion failed: Expected the root package to have been registered`);
-        const providedDescriptor = (_a = subject.dependencies.get(requirement.requested.identHash)) !== null && _a !== void 0 ? _a : null;
+        const providedDescriptor = subject.dependencies.get(requirement.requested.identHash) ?? null;
         const providedResolution = providedDescriptor !== null
             ? project.storedResolutions.get(providedDescriptor.descriptorHash)
             : null;
@@ -130,7 +128,7 @@ async function explainPeerRequirements(peerRequirementsHash, project, opts) {
             const satisfiesAllRanges = allRequesters.every(({ peerDependency }) => {
                 return core_1.semverUtils.satisfiesWithPrereleases(provided.version, peerDependency.range);
             });
-            report.reportInfo(core_1.MessageName.UNNAMED, `${core_1.structUtils.prettyLocator(configuration, subject)} provides ${core_1.structUtils.prettyLocator(configuration, provided)} with version ${core_1.structUtils.prettyReference(configuration, (_b = provided.version) !== null && _b !== void 0 ? _b : `<missing>`)}, which ${satisfiesAllRanges ? `satisfies` : `doesn't satisfy`} the following requirements:`);
+            report.reportInfo(core_1.MessageName.UNNAMED, `${core_1.structUtils.prettyLocator(configuration, subject)} provides ${core_1.structUtils.prettyLocator(configuration, provided)} with version ${core_1.structUtils.prettyReference(configuration, provided.version ?? `<missing>`)}, which ${satisfiesAllRanges ? `satisfies` : `doesn't satisfy`} the following requirements:`);
         }
         else {
             report.reportInfo(core_1.MessageName.UNNAMED, `${core_1.structUtils.prettyLocator(configuration, subject)} doesn't provide ${core_1.structUtils.prettyIdent(configuration, requirement.requested)}, breaking the following requirements:`);

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;