@yarnpkg/plugin-essentials 4.1.1 → 4.2.0

package/lib/commands/explain/peerRequirements.d.ts

@@ -1,13 +1,15 @@
-/// <reference types="node" />
 import { BaseCommand } from '@yarnpkg/cli';
 import { Project } from '@yarnpkg/core';
 import { Writable } from 'stream';
 export default class ExplainPeerRequirementsCommand extends BaseCommand {
     static paths: string[][];
     static usage: import("clipanion").Usage;
-    hash: string;
+    hash: string | undefined;
     execute(): Promise<0 | 1>;
 }
-export declare function explainPeerRequirements(peerRequirementsHash: string, project: Project, opts: {
+export declare function explainPeerRequirement(peerRequirementsHash: string, project: Project, opts: {
+    stdout: Writable;
+}): Promise<0 | 1>;
+export declare function explainPeerRequirements(project: Project, opts: {
     stdout: Writable;
 }): Promise<0 | 1>;

package/lib/commands/explain/peerRequirements.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.explainPeerRequirements = void 0;
+exports.explainPeerRequirement = explainPeerRequirement;
+exports.explainPeerRequirements = explainPeerRequirements;
 const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
@@ -11,6 +12,7 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
         this.hash = clipanion_1.Option.String({
+            required: false,
             validator: t.cascade(t.isString(), [
                 t.matchesRegExp(/^p[0-9a-f]{5}$/),
             ]),
@@ -23,9 +25,16 @@ class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
             restoreResolutions: false,
         });
         await project.applyLightResolution();
-        return await explainPeerRequirements(this.hash, project, {
-            stdout: this.context.stdout,
-        });
+        if (typeof this.hash !== `undefined`) {
+            return await explainPeerRequirement(this.hash, project, {
+                stdout: this.context.stdout,
+            });
+        }
+        else {
+            return await explainPeerRequirements(project, {
+                stdout: this.context.stdout,
+            });
+        }
     }
 }
 ExplainPeerRequirementsCommand.paths = [
@@ -34,29 +43,51 @@ ExplainPeerRequirementsCommand.paths = [
 ExplainPeerRequirementsCommand.usage = clipanion_1.Command.Usage({
     description: `explain a set of peer requirements`,
     details: `
-      A set of peer requirements represents all peer requirements that a dependent must satisfy when providing a given peer request to a requester and its descendants.
+      A peer requirement represents all peer requests that a subject must satisfy when providing a requested package to requesters.
 
-      When the hash argument is specified, this command prints a detailed explanation of all requirements of the set corresponding to the hash and whether they're satisfied or not.
+      When the hash argument is specified, this command prints a detailed explanation of the peer requirement corresponding to the hash and whether it is satisfied or not.
 
-      When used without arguments, this command lists all sets of peer requirements and the corresponding hash that can be used to get detailed information about a given set.
+      When used without arguments, this command lists all peer requirements and the corresponding hash that can be used to get detailed information about a given requirement.
 
       **Note:** A hash is a six-letter p-prefixed code that can be obtained from peer dependency warnings or from the list of all peer requirements (\`yarn explain peer-requirements\`).
     `,
     examples: [[
-            `Explain the corresponding set of peer requirements for a hash`,
+            `Explain the corresponding peer requirement for a hash`,
             `$0 explain peer-requirements p1a4ed`,
         ], [
-            `List all sets of peer requirements`,
+            `List all peer requirements`,
             `$0 explain peer-requirements`,
         ]],
 });
 exports.default = ExplainPeerRequirementsCommand;
-async function explainPeerRequirements(peerRequirementsHash, project, opts) {
+async function explainPeerRequirement(peerRequirementsHash, project, opts) {
+    const root = project.peerRequirementNodes.get(peerRequirementsHash);
+    if (typeof root === `undefined`)
+        throw new Error(`No peerDependency requirements found for hash: "${peerRequirementsHash}"`);
+    const seen = new Set();
+    const makeTreeNode = (request) => {
+        if (seen.has(request.requester.locatorHash)) {
+            return {
+                value: core_1.formatUtils.tuple(core_1.formatUtils.Type.DEPENDENT, { locator: request.requester, descriptor: request.descriptor }),
+                children: request.children.size > 0
+                    ? [{ value: core_1.formatUtils.tuple(core_1.formatUtils.Type.NO_HINT, `...`) }]
+                    : [],
+            };
+        }
+        seen.add(request.requester.locatorHash);
+        return {
+            value: core_1.formatUtils.tuple(core_1.formatUtils.Type.DEPENDENT, { locator: request.requester, descriptor: request.descriptor }),
+            children: Object.fromEntries(Array.from(request.children.values(), child => {
+                return [
+                    core_1.structUtils.stringifyLocator(child.requester),
+                    makeTreeNode(child),
+                ];
+            })),
+        };
+    };
     const warning = project.peerWarnings.find(warning => {
         return warning.hash === peerRequirementsHash;
     });
-    if (typeof warning === `undefined`)
-        throw new Error(`No peerDependency requirements found for hash: "${peerRequirementsHash}"`);
     const report = await core_1.StreamReport.start({
         configuration: project.configuration,
         stdout: opts.stdout,
@@ -64,73 +95,98 @@ async function explainPeerRequirements(peerRequirementsHash, project, opts) {
         includePrefix: false,
     }, async (report) => {
         const Marks = core_1.formatUtils.mark(project.configuration);
-        switch (warning.type) {
-            case core_1.PeerWarningType.NotCompatibleAggregate:
-                {
-                    report.reportInfo(core_1.MessageName.UNNAMED, `We have a problem with ${core_1.formatUtils.pretty(project.configuration, warning.requested, core_1.formatUtils.Type.IDENT)}, which is provided with version ${core_1.structUtils.prettyReference(project.configuration, warning.version)}.`);
-                    report.reportInfo(core_1.MessageName.UNNAMED, `It is needed by the following direct dependencies of workspaces in your project:`);
-                    report.reportSeparator();
-                    for (const dependent of warning.requesters.values()) {
-                        const dependentPkg = project.storedPackages.get(dependent.locatorHash);
-                        if (!dependentPkg)
-                            throw new Error(`Assertion failed: Expected the package to be registered`);
-                        const descriptor = dependentPkg?.peerDependencies.get(warning.requested.identHash);
-                        if (!descriptor)
-                            throw new Error(`Assertion failed: Expected the package to list the peer dependency`);
-                        const mark = core_1.semverUtils.satisfiesWithPrereleases(warning.version, descriptor.range)
-                            ? Marks.Check
-                            : Marks.Cross;
-                        report.reportInfo(null, `  ${mark} ${core_1.structUtils.prettyLocator(project.configuration, dependent)} (via ${core_1.structUtils.prettyRange(project.configuration, descriptor.range)})`);
-                    }
-                    const transitiveLinks = [...warning.links.values()].filter(link => {
-                        return !warning.requesters.has(link.locatorHash);
-                    });
-                    if (transitiveLinks.length > 0) {
-                        report.reportSeparator();
-                        report.reportInfo(core_1.MessageName.UNNAMED, `However, those packages themselves have more dependencies listing ${core_1.structUtils.prettyIdent(project.configuration, warning.requested)} as peer dependency:`);
-                        report.reportSeparator();
-                        for (const link of transitiveLinks) {
-                            const linkPkg = project.storedPackages.get(link.locatorHash);
-                            if (!linkPkg)
-                                throw new Error(`Assertion failed: Expected the package to be registered`);
-                            const descriptor = linkPkg?.peerDependencies.get(warning.requested.identHash);
-                            if (!descriptor)
-                                throw new Error(`Assertion failed: Expected the package to list the peer dependency`);
-                            const mark = core_1.semverUtils.satisfiesWithPrereleases(warning.version, descriptor.range)
-                                ? Marks.Check
-                                : Marks.Cross;
-                            report.reportInfo(null, `  ${mark} ${core_1.structUtils.prettyLocator(project.configuration, link)} (via ${core_1.structUtils.prettyRange(project.configuration, descriptor.range)})`);
-                        }
-                    }
-                    const allRanges = Array.from(warning.links.values(), locator => {
-                        const pkg = project.storedPackages.get(locator.locatorHash);
-                        if (typeof pkg === `undefined`)
-                            throw new Error(`Assertion failed: Expected the package to be registered`);
-                        const peerDependency = pkg.peerDependencies.get(warning.requested.identHash);
-                        if (typeof peerDependency === `undefined`)
-                            throw new Error(`Assertion failed: Expected the ident to be registered`);
-                        return peerDependency.range;
-                    });
-                    if (allRanges.length > 1) {
-                        const resolvedRange = core_1.semverUtils.simplifyRanges(allRanges);
-                        report.reportSeparator();
-                        if (resolvedRange === null) {
-                            report.reportInfo(core_1.MessageName.UNNAMED, `Unfortunately, put together, we found no single range that can satisfy all those peer requirements.`);
-                            report.reportInfo(core_1.MessageName.UNNAMED, `Your best option may be to try to upgrade some dependencies with ${core_1.formatUtils.pretty(project.configuration, `yarn up`, core_1.formatUtils.Type.CODE)}, or silence the warning via ${core_1.formatUtils.pretty(project.configuration, `logFilters`, core_1.formatUtils.Type.CODE)}.`);
-                        }
-                        else {
-                            report.reportInfo(core_1.MessageName.UNNAMED, `Put together, the final range we computed is ${core_1.formatUtils.pretty(project.configuration, resolvedRange, core_1.formatUtils.Type.RANGE)}`);
-                        }
-                    }
+        const mark = warning ? Marks.Cross : Marks.Check;
+        report.reportInfo(core_1.MessageName.UNNAMED, `Package ${core_1.formatUtils.pretty(project.configuration, root.subject, core_1.formatUtils.Type.LOCATOR)} is requested to provide ${core_1.formatUtils.pretty(project.configuration, root.ident, core_1.formatUtils.Type.IDENT)} by its descendants`);
+        report.reportSeparator();
+        report.reportInfo(core_1.MessageName.UNNAMED, core_1.formatUtils.pretty(project.configuration, root.subject, core_1.formatUtils.Type.LOCATOR));
+        core_1.treeUtils.emitTree({
+            children: Object.fromEntries(Array.from(root.requests.values(), request => {
+                return [
+                    core_1.structUtils.stringifyLocator(request.requester),
+                    makeTreeNode(request),
+                ];
+            })),
+        }, {
+            configuration: project.configuration,
+            stdout: opts.stdout,
+            json: false,
+        });
+        report.reportSeparator();
+        if (root.provided.range === `missing:`) {
+            const problem = warning ? `` : ` , but all peer requests are optional`;
+            report.reportInfo(core_1.MessageName.UNNAMED, `${mark} Package ${core_1.formatUtils.pretty(project.configuration, root.subject, core_1.formatUtils.Type.LOCATOR)} does not provide ${core_1.formatUtils.pretty(project.configuration, root.ident, core_1.formatUtils.Type.IDENT)}${problem}.`);
+        }
+        else {
+            const providedLocatorHash = project.storedResolutions.get(root.provided.descriptorHash);
+            if (!providedLocatorHash)
+                throw new Error(`Assertion failed: Expected the descriptor to be registered`);
+            const providedPackage = project.storedPackages.get(providedLocatorHash);
+            if (!providedPackage)
+                throw new Error(`Assertion failed: Expected the package to be registered`);
+            report.reportInfo(core_1.MessageName.UNNAMED, `${mark} Package ${core_1.formatUtils.pretty(project.configuration, root.subject, core_1.formatUtils.Type.LOCATOR)} provides ${core_1.formatUtils.pretty(project.configuration, root.ident, core_1.formatUtils.Type.IDENT)} with version ${core_1.structUtils.prettyReference(project.configuration, providedPackage.version ?? `0.0.0`)}, ${warning ? `which does not satisfy all requests.` : `which satisfies all requests`}`);
+            if (warning?.type === core_1.PeerWarningType.NodeNotCompatible) {
+                if (warning.range) {
+                    report.reportInfo(core_1.MessageName.UNNAMED, `  The combined requested range is ${core_1.formatUtils.pretty(project.configuration, warning.range, core_1.formatUtils.Type.RANGE)}`);
                 }
-                break;
-            default:
-                {
-                    report.reportInfo(core_1.MessageName.UNNAMED, `The ${core_1.formatUtils.pretty(project.configuration, `yarn explain peer-requirements`, core_1.formatUtils.Type.CODE)} command doesn't support this warning type yet.`);
+                else {
+                    report.reportInfo(core_1.MessageName.UNNAMED, `  Unfortunately, the requested ranges have no overlap`);
                 }
-                break;
+            }
+        }
+    });
+    return report.exitCode();
+}
+async function explainPeerRequirements(project, opts) {
+    const report = await core_1.StreamReport.start({
+        configuration: project.configuration,
+        stdout: opts.stdout,
+        includeFooter: false,
+        includePrefix: false,
+    }, async (report) => {
+        const Marks = core_1.formatUtils.mark(project.configuration);
+        const sorted = core_1.miscUtils.sortMap(project.peerRequirementNodes, [
+            ([, requirement]) => core_1.structUtils.stringifyLocator(requirement.subject),
+            ([, requirement]) => core_1.structUtils.stringifyIdent(requirement.ident),
+        ]);
+        for (const [, peerRequirement] of sorted.values()) {
+            if (!peerRequirement.root)
+                continue;
+            const warning = project.peerWarnings.find(warning => {
+                return warning.hash === peerRequirement.hash;
+            });
+            const allRequests = [...core_1.structUtils.allPeerRequests(peerRequirement)];
+            let andOthers;
+            if (allRequests.length > 2)
+                andOthers = ` and ${allRequests.length - 1} other dependencies`;
+            else if (allRequests.length === 2)
+                andOthers = ` and 1 other dependency`;
+            else
+                andOthers = ``;
+            if (peerRequirement.provided.range !== `missing:`) {
+                const providedResolution = project.storedResolutions.get(peerRequirement.provided.descriptorHash);
+                if (!providedResolution)
+                    throw new Error(`Assertion failed: Expected the resolution to have been registered`);
+                const providedPkg = project.storedPackages.get(providedResolution);
+                if (!providedPkg)
+                    throw new Error(`Assertion failed: Expected the provided package to have been registered`);
+                const message = `${core_1.formatUtils.pretty(project.configuration, peerRequirement.hash, core_1.formatUtils.Type.CODE)} → ${warning ? Marks.Cross : Marks.Check} ${core_1.structUtils.prettyLocator(project.configuration, peerRequirement.subject)} provides ${core_1.structUtils.prettyLocator(project.configuration, providedPkg)} to ${core_1.structUtils.prettyLocator(project.configuration, allRequests[0].requester)}${andOthers}`;
+                if (warning) {
+                    report.reportWarning(core_1.MessageName.UNNAMED, message);
+                }
+                else {
+                    report.reportInfo(core_1.MessageName.UNNAMED, message);
+                }
+            }
+            else {
+                const message = `${core_1.formatUtils.pretty(project.configuration, peerRequirement.hash, core_1.formatUtils.Type.CODE)} → ${warning ? Marks.Cross : Marks.Check} ${core_1.structUtils.prettyLocator(project.configuration, peerRequirement.subject)} doesn't provide ${core_1.structUtils.prettyIdent(project.configuration, peerRequirement.ident)} to ${core_1.structUtils.prettyLocator(project.configuration, allRequests[0].requester)}${andOthers}`;
+                if (warning) {
+                    report.reportWarning(core_1.MessageName.UNNAMED, message);
+                }
+                else {
+                    report.reportInfo(core_1.MessageName.UNNAMED, message);
+                }
+            }
         }
     });
     return report.exitCode();
 }
-exports.explainPeerRequirements = explainPeerRequirements;

package/lib/commands/explain.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getErrorCodeDetails = void 0;
+exports.getErrorCodeDetails = getErrorCodeDetails;
 const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
@@ -26,7 +26,6 @@ async function getErrorCodeDetails(configuration) {
         return [groups.code, groups.details];
     }));
 }
-exports.getErrorCodeDetails = getErrorCodeDetails;
 // eslint-disable-next-line arca/no-default-export
 class ExplainCommand extends cli_1.BaseCommand {
     constructor() {

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAndSavePlugin = void 0;
+exports.buildAndSavePlugin = buildAndSavePlugin;
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
@@ -91,4 +91,3 @@ async function buildAndSavePlugin(pluginSpec, { context, noMinify }, { project,
     const pluginBuffer = await fslib_1.xfs.readFilePromise(pluginPath);
     await (0, import_1.savePlugin)(pluginSpec, pluginBuffer, { project, report });
 }
-exports.buildAndSavePlugin = buildAndSavePlugin;

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

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

package/lib/commands/plugin/import.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.savePlugin = void 0;
+exports.savePlugin = savePlugin;
 const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
@@ -133,4 +133,3 @@ async function savePlugin(pluginSpec, pluginBuffer, { checksum = true, project,
         pluginMeta.checksum = core_2.hashUtils.makeHash(pluginBuffer);
     await core_1.Configuration.addPlugin(project.cwd, [pluginMeta]);
 }
-exports.savePlugin = savePlugin;

package/lib/commands/plugin/list.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAvailablePlugins = void 0;
+exports.getAvailablePlugins = getAvailablePlugins;
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const parsers_1 = require("@yarnpkg/parsers");
@@ -13,7 +13,6 @@ async function getAvailablePlugins(configuration, version) {
         return !version || core_1.semverUtils.satisfiesWithPrereleases(version, pluginData.range ?? `<4.0.0-rc.1`);
     }));
 }
-exports.getAvailablePlugins = getAvailablePlugins;
 // eslint-disable-next-line arca/no-default-export
 class PluginListCommand extends cli_1.BaseCommand {
     constructor() {

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.prepareRepo = exports.runWorkflow = void 0;
+exports.runWorkflow = runWorkflow;
+exports.prepareRepo = prepareRepo;
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
@@ -141,7 +142,6 @@ async function runWorkflow(workflow, { configuration, context, target }) {
         }
     }
 }
-exports.runWorkflow = runWorkflow;
 async function prepareRepo(spec, { configuration, report, target }) {
     let ready = false;
     if (!spec.force && fslib_1.xfs.existsSync(fslib_1.ppath.join(target, `.git`))) {
@@ -164,7 +164,6 @@ async function prepareRepo(spec, { configuration, report, target }) {
         await runWorkflow(cloneWorkflow(spec, target), { configuration, context: spec.context, target });
     }
 }
-exports.prepareRepo = prepareRepo;
 async function updatePlugins(context, version, { project, report, target }) {
     const data = await (0, list_1.getAvailablePlugins)(project.configuration, version);
     const contribPlugins = new Set(Object.keys(data));

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

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

package/lib/commands/set/version.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setVersion = exports.resolveTag = exports.resolveRange = void 0;
+exports.resolveRange = resolveRange;
+exports.resolveTag = resolveTag;
+exports.setVersion = setVersion;
 const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
@@ -146,14 +148,12 @@ async function resolveRange(configuration, request) {
     // 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 ${core_2.formatUtils.pretty(configuration, request, core_2.formatUtils.Type.RANGE)} not found`);
     return data.latest[request];
 }
-exports.resolveTag = resolveTag;
 async function setVersion(configuration, bundleVersion, fetchBuffer, { report, useYarnPath }) {
     let bundleBuffer;
     const ensureBuffer = async () => {
@@ -225,4 +225,3 @@ async function setVersion(configuration, bundleVersion, fetchBuffer, { report, u
         bundleVersion: bundleVersion,
     };
 }
-exports.setVersion = setVersion;

package/lib/commands/why.js

@@ -139,15 +139,15 @@ function whyRecursive(project, identHash, { configuration, peers }) {
         };
         const key = core_3.structUtils.stringifyLocator(pkg);
         parentChildren[key] = node;
+        // We don't want to print the children of our transitive workspace
+        // dependencies, as they will be printed in their own top-level branch
+        if (dependency !== null && project.tryWorkspaceByLocator(pkg))
+            return;
         // We don't want to reprint the children for a package that already got
         // printed as part of another branch
         if (printed.has(pkg.locatorHash))
             return;
         printed.add(pkg.locatorHash);
-        // We don't want to print the children of our transitive workspace
-        // dependencies, as they will be printed in their own top-level branch
-        if (dependency !== null && project.tryWorkspaceByLocator(pkg))
-            return;
         for (const dependency of pkg.dependencies.values()) {
             if (!peers && pkg.peerDependencies.has(dependency.identHash))
                 continue;

package/lib/dedupeUtils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dedupe = exports.acceptedStrategies = exports.Strategy = void 0;
+exports.acceptedStrategies = exports.Strategy = void 0;
+exports.dedupe = dedupe;
 const tslib_1 = require("tslib");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
@@ -160,4 +161,3 @@ async function dedupe(project, { strategy, patterns, cache, report }) {
         return dedupedPackageCount;
     });
 }
-exports.dedupe = dedupe;

package/lib/suggestUtils.js

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchDescriptorFrom = exports.getSuggestedDescriptors = exports.extractDescriptorFromPath = exports.findProjectDescriptors = exports.makeWorkspaceDescriptor = exports.toWorkspaceModifier = exports.applyModifier = exports.extractRangeModifier = exports.getModifier = exports.Strategy = exports.WorkspaceModifier = exports.Modifier = exports.Target = void 0;
+exports.Strategy = exports.WorkspaceModifier = exports.Modifier = exports.Target = void 0;
+exports.getModifier = getModifier;
+exports.extractRangeModifier = extractRangeModifier;
+exports.applyModifier = applyModifier;
+exports.toWorkspaceModifier = toWorkspaceModifier;
+exports.makeWorkspaceDescriptor = makeWorkspaceDescriptor;
+exports.findProjectDescriptors = findProjectDescriptors;
+exports.extractDescriptorFromPath = extractDescriptorFromPath;
+exports.getSuggestedDescriptors = getSuggestedDescriptors;
+exports.fetchDescriptorFrom = fetchDescriptorFrom;
 const tslib_1 = require("tslib");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
@@ -62,20 +71,17 @@ function getModifier(flags, project) {
         return Modifier.TILDE;
     return project.configuration.get(`defaultSemverRangePrefix`);
 }
-exports.getModifier = getModifier;
 const SIMPLE_SEMVER = /^([\^~]?)[0-9]+(?:\.[0-9]+){0,2}(?:-\S+)?$/;
 function extractRangeModifier(range, { project }) {
     const match = range.match(SIMPLE_SEMVER);
     return match ? match[1] : project.configuration.get(`defaultSemverRangePrefix`);
 }
-exports.extractRangeModifier = extractRangeModifier;
 function applyModifier(descriptor, modifier) {
     let { protocol, source, params, selector } = core_2.structUtils.parseRange(descriptor.range);
     if (semver_1.default.valid(selector))
         selector = `${modifier}${descriptor.range}`;
     return core_2.structUtils.makeDescriptor(descriptor, core_2.structUtils.makeRange({ protocol, source, params, selector }));
 }
-exports.applyModifier = applyModifier;
 function toWorkspaceModifier(modifier) {
     switch (modifier) {
         case Modifier.CARET:
@@ -88,11 +94,9 @@ function toWorkspaceModifier(modifier) {
             throw new Error(`Assertion failed: Unknown modifier: "${modifier}"`);
     }
 }
-exports.toWorkspaceModifier = toWorkspaceModifier;
 function makeWorkspaceDescriptor(workspace, modifier) {
     return core_2.structUtils.makeDescriptor(workspace.anchoredDescriptor, `${WORKSPACE_PROTOCOL}${toWorkspaceModifier(modifier)}`);
 }
-exports.makeWorkspaceDescriptor = makeWorkspaceDescriptor;
 async function findProjectDescriptors(ident, { project, target }) {
     const matches = new Map();
     const getDescriptorEntry = (descriptor) => {
@@ -135,7 +139,6 @@ async function findProjectDescriptors(ident, { project, target }) {
     }
     return matches;
 }
-exports.findProjectDescriptors = findProjectDescriptors;
 async function extractDescriptorFromPath(path, { cwd, workspace }) {
     // We use a temporary cache so that we don't pollute the project cache with temporary archives
     return await makeTemporaryCache(async (cache) => {
@@ -164,7 +167,6 @@ async function extractDescriptorFromPath(path, { cwd, workspace }) {
         return core_2.structUtils.makeDescriptor(manifest.name, path);
     });
 }
-exports.extractDescriptorFromPath = extractDescriptorFromPath;
 async function getSuggestedDescriptors(request, { project, workspace, cache, target, fixed, modifier, strategies, maxResults = Infinity }) {
     if (!(maxResults >= 0))
         throw new Error(`Invalid maxResults (${maxResults})`);
@@ -306,7 +308,6 @@ async function getSuggestedDescriptors(request, { project, workspace, cache, tar
         rejections: rejected.slice(0, maxResults),
     };
 }
-exports.getSuggestedDescriptors = getSuggestedDescriptors;
 async function fetchDescriptorFrom(ident, range, { project, cache, workspace, preserveModifier = true, modifier }) {
     const latestDescriptor = project.configuration.normalizeDependency(core_2.structUtils.makeDescriptor(ident, range));
     const report = new core_1.ThrowReport();
@@ -354,7 +355,6 @@ async function fetchDescriptorFrom(ident, range, { project, cache, workspace, pr
     }
     return core_2.structUtils.makeDescriptor(bestLocator, core_2.structUtils.makeRange({ protocol, source, params, selector }));
 }
-exports.fetchDescriptorFrom = fetchDescriptorFrom;
 async function makeTemporaryCache(cb) {
     return await fslib_1.xfs.mktempPromise(async (cacheDir) => {
         const configuration = core_1.Configuration.create(cacheDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yarnpkg/plugin-essentials",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "license": "BSD-2-Clause",
   "main": "./lib/index.js",
   "exports": {
@@ -8,8 +8,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@yarnpkg/fslib": "^3.0.2",
-    "@yarnpkg/parsers": "^3.0.0",
+    "@yarnpkg/fslib": "^3.1.0",
+    "@yarnpkg/parsers": "^3.0.2",
     "ci-info": "^3.2.0",
     "clipanion": "^4.0.0-rc.2",
     "enquirer": "^2.3.6",
@@ -20,16 +20,16 @@
     "typanion": "^3.14.0"
   },
   "peerDependencies": {
-    "@yarnpkg/cli": "^4.1.1",
-    "@yarnpkg/core": "^4.0.3",
+    "@yarnpkg/cli": "^4.3.0",
+    "@yarnpkg/core": "^4.1.0",
     "@yarnpkg/plugin-git": "^3.0.0"
   },
   "devDependencies": {
     "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/semver": "^7.1.0",
-    "@yarnpkg/cli": "^4.1.1",
-    "@yarnpkg/core": "^4.0.3",
+    "@yarnpkg/cli": "^4.3.0",
+    "@yarnpkg/core": "^4.1.0",
     "@yarnpkg/plugin-git": "^3.0.0"
   },
   "repository": {