@yarnpkg/plugin-essentials 3.1.0-rc.8 → 3.2.0-rc.10

package/lib/commands/add.js

@@ -7,8 +7,8 @@ const core_2 = require("@yarnpkg/core");
 const core_3 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
 const enquirer_1 = require("enquirer");
-const t = (0, tslib_1.__importStar)(require("typanion"));
-const suggestUtils = (0, tslib_1.__importStar)(require("../suggestUtils"));
+const t = tslib_1.__importStar(require("typanion"));
+const suggestUtils = tslib_1.__importStar(require("../suggestUtils"));
 // eslint-disable-next-line arca/no-default-export
 class AddCommand extends cli_1.BaseCommand {
     constructor() {

package/lib/commands/config/get.js

@@ -4,7 +4,7 @@ const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const get_1 = (0, tslib_1.__importDefault)(require("lodash/get"));
+const get_1 = tslib_1.__importDefault(require("lodash/get"));
 const util_1 = require("util");
 // eslint-disable-next-line arca/no-default-export
 class ConfigGetCommand extends cli_1.BaseCommand {

package/lib/commands/config/set.js

@@ -4,9 +4,9 @@ const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const cloneDeep_1 = (0, tslib_1.__importDefault)(require("lodash/cloneDeep"));
-const get_1 = (0, tslib_1.__importDefault)(require("lodash/get"));
-const set_1 = (0, tslib_1.__importDefault)(require("lodash/set"));
+const cloneDeep_1 = tslib_1.__importDefault(require("lodash/cloneDeep"));
+const get_1 = tslib_1.__importDefault(require("lodash/get"));
+const set_1 = tslib_1.__importDefault(require("lodash/set"));
 const util_1 = require("util");
 // eslint-disable-next-line arca/no-default-export
 class ConfigSetCommand extends cli_1.BaseCommand {

package/lib/commands/config/unset.js

@@ -4,9 +4,9 @@ const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const cloneDeep_1 = (0, tslib_1.__importDefault)(require("lodash/cloneDeep"));
-const has_1 = (0, tslib_1.__importDefault)(require("lodash/has"));
-const unset_1 = (0, tslib_1.__importDefault)(require("lodash/unset"));
+const cloneDeep_1 = tslib_1.__importDefault(require("lodash/cloneDeep"));
+const has_1 = tslib_1.__importDefault(require("lodash/has"));
+const unset_1 = tslib_1.__importDefault(require("lodash/unset"));
 // eslint-disable-next-line arca/no-default-export
 class ConfigUnsetCommand extends cli_1.BaseCommand {
     constructor() {

package/lib/commands/dedupe.js

@@ -17,8 +17,8 @@ const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const t = (0, tslib_1.__importStar)(require("typanion"));
-const dedupeUtils = (0, tslib_1.__importStar)(require("../dedupeUtils"));
+const t = tslib_1.__importStar(require("typanion"));
+const dedupeUtils = tslib_1.__importStar(require("../dedupeUtils"));
 // eslint-disable-next-line arca/no-default-export
 class DedupeCommand extends cli_1.BaseCommand {
     constructor() {

package/lib/commands/explain/peerRequirements.js

@@ -5,7 +5,7 @@ const tslib_1 = require("tslib");
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
-const t = (0, tslib_1.__importStar)(require("typanion"));
+const t = tslib_1.__importStar(require("typanion"));
 // eslint-disable-next-line arca/no-default-export
 class ExplainPeerRequirementsCommand extends cli_1.BaseCommand {
     constructor() {

package/lib/commands/explain.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '@yarnpkg/cli';
+import { Configuration } from '@yarnpkg/core';
+export declare function getErrorCodeDetails(configuration: Configuration): Promise<Map<string, string>>;
+export default class ExplainCommand extends BaseCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    code: string | undefined;
+    json: boolean;
+    execute(): Promise<void>;
+}

package/lib/commands/explain.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorCodeDetails = void 0;
+const tslib_1 = require("tslib");
+const cli_1 = require("@yarnpkg/cli");
+const core_1 = require("@yarnpkg/core");
+const clipanion_1 = require("clipanion");
+const t = tslib_1.__importStar(require("typanion"));
+const version_1 = require("./set/version");
+function getCodeName(code) {
+    return core_1.MessageName[(0, core_1.parseMessageName)(code)];
+}
+const ERROR_CODE_DOC_REGEXP = /## (?<code>YN[0-9]{4}) - `(?<name>[A-Z_]+)`\n\n(?<details>(?:.(?!##))+)/gs;
+async function getErrorCodeDetails(configuration) {
+    const version = core_1.miscUtils.isTaggedYarnVersion(core_1.YarnVersion)
+        ? core_1.YarnVersion
+        : await (0, version_1.resolveTag)(configuration, `canary`);
+    const errorCodesUrl = `https://repo.yarnpkg.com/${version}/packages/gatsby/content/advanced/error-codes.md`;
+    const raw = await core_1.httpUtils.get(errorCodesUrl, { configuration });
+    return new Map(Array.from(raw.toString().matchAll(ERROR_CODE_DOC_REGEXP), ({ groups }) => {
+        if (!groups)
+            throw new Error(`Assertion failed: Expected the match to have been successful`);
+        const expectedName = getCodeName(groups.code);
+        if (groups.name !== expectedName)
+            throw new Error(`Assertion failed: Invalid error code data: Expected "${groups.name}" to be named "${expectedName}"`);
+        return [groups.code, groups.details];
+    }));
+}
+exports.getErrorCodeDetails = getErrorCodeDetails;
+// eslint-disable-next-line arca/no-default-export
+class ExplainCommand extends cli_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        this.code = clipanion_1.Option.String({
+            required: false,
+            validator: t.applyCascade(t.isString(), [
+                t.matchesRegExp(/^YN[0-9]{4}$/),
+            ]),
+        });
+        this.json = clipanion_1.Option.Boolean(`--json`, false, {
+            description: `Format the output as an NDJSON stream`,
+        });
+    }
+    async execute() {
+        const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
+        if (typeof this.code !== `undefined`) {
+            const name = getCodeName(this.code);
+            const prettyName = core_1.formatUtils.pretty(configuration, name, core_1.formatUtils.Type.CODE);
+            const header = this.cli.format().header(`${this.code} - ${prettyName}`);
+            const errorCodeDetails = await getErrorCodeDetails(configuration);
+            const details = errorCodeDetails.get(this.code);
+            const content = typeof details !== `undefined`
+                ? core_1.formatUtils.jsonOrPretty(this.json, configuration, core_1.formatUtils.tuple(core_1.formatUtils.Type.MARKDOWN, {
+                    text: details,
+                    format: this.cli.format(),
+                    paragraphs: true,
+                }))
+                : `This error code does not have a description.\n\nYou can help us by editing this page on GitHub 🙂:\n${core_1.formatUtils.jsonOrPretty(this.json, configuration, core_1.formatUtils.tuple(core_1.formatUtils.Type.URL, `https://github.com/yarnpkg/berry/blob/master/packages/gatsby/content/advanced/error-codes.md`))}\n`;
+            if (this.json) {
+                this.context.stdout.write(`${JSON.stringify({ code: this.code, name, details: content })}\n`);
+            }
+            else {
+                this.context.stdout.write(`${header}\n\n${content}\n`);
+            }
+        }
+        else {
+            const tree = {
+                children: core_1.miscUtils.mapAndFilter(Object.entries(core_1.MessageName), ([key, value]) => {
+                    if (Number.isNaN(Number(key)))
+                        return core_1.miscUtils.mapAndFilter.skip;
+                    return {
+                        label: (0, core_1.stringifyMessageName)(Number(key)),
+                        value: core_1.formatUtils.tuple(core_1.formatUtils.Type.CODE, value),
+                    };
+                }),
+            };
+            core_1.treeUtils.emitTree(tree, { configuration, stdout: this.context.stdout, json: this.json });
+        }
+    }
+}
+exports.default = ExplainCommand;
+ExplainCommand.paths = [
+    [`explain`],
+];
+ExplainCommand.usage = clipanion_1.Command.Usage({
+    description: `explain an error code`,
+    details: `
+      When the code argument is specified, this command prints its name and its details.
+
+      When used without arguments, this command lists all error codes and their names.
+    `,
+    examples: [[
+            `Explain an error code`,
+            `$0 explain YN0006`,
+        ], [
+            `List all error codes`,
+            `$0 explain`,
+        ]],
+});

package/lib/commands/info.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 = (0, tslib_1.__importDefault)(require("micromatch"));
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
 // eslint-disable-next-line arca/no-default-export
 class InfoCommand extends cli_1.BaseCommand {
     constructor() {
@@ -160,7 +160,7 @@ class InfoCommand extends cli_1.BaseCommand {
         const infoTreeChildren = {};
         const infoTree = { children: infoTreeChildren };
         const fetcher = configuration.makeFetcher();
-        const fetcherOptions = { project, fetcher, cache, checksums: project.storedChecksums, report: new core_1.ThrowReport(), skipIntegrityCheck: true };
+        const fetcherOptions = { project, fetcher, cache, checksums: project.storedChecksums, report: new core_1.ThrowReport(), cacheOptions: { skipIntegrityCheck: true }, skipIntegrityCheck: true };
         const builtinInfoBuilders = [
             // Manifest fields
             async (pkg, extra, registerData) => {
@@ -185,8 +185,12 @@ class InfoCommand extends cli_1.BaseCommand {
                 var _a;
                 if (!extra.has(`cache`))
                     return;
+                const cacheOptions = {
+                    mockedPackages: project.disabledLocators,
+                    unstablePackages: project.conditionalLocators,
+                };
                 const checksum = (_a = project.storedChecksums.get(pkg.locatorHash)) !== null && _a !== void 0 ? _a : null;
-                const cachePath = cache.getLocatorPath(pkg, checksum);
+                const cachePath = cache.getLocatorPath(pkg, checksum, cacheOptions);
                 let stat;
                 if (cachePath !== null) {
                     try {

package/lib/commands/install.d.ts

@@ -18,5 +18,6 @@ export default class YarnCommand extends BaseCommand {
     production: boolean | undefined;
     registry: string | undefined;
     silent: boolean | undefined;
+    networkTimeout: string | undefined;
     execute(): Promise<1 | 0>;
 }

package/lib/commands/install.js

@@ -5,8 +5,9 @@ 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 = tslib_1.__importDefault(require("ci-info"));
 const clipanion_1 = require("clipanion");
-const t = (0, tslib_1.__importStar)(require("typanion"));
+const t = tslib_1.__importStar(require("typanion"));
 // eslint-disable-next-line arca/no-default-export
 class YarnCommand extends cli_1.BaseCommand {
     constructor() {
@@ -39,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
@@ -79,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;
@@ -105,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;
@@ -148,13 +148,17 @@ 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;
             }
         }
-        const immutable = (_a = this.immutable) !== null && _a !== void 0 ? _a : configuration.get(`enableImmutableInstalls`);
+        const updateMode = this.mode === core_1.InstallMode.UpdateLockfile;
+        if (updateMode && (this.immutable || this.immutableCache))
+            throw new clipanion_1.UsageError(`${core_1.formatUtils.pretty(configuration, `--immutable`, core_1.formatUtils.Type.CODE)} and ${core_1.formatUtils.pretty(configuration, `--immutable-cache`, core_1.formatUtils.Type.CODE)} cannot be used with ${core_1.formatUtils.pretty(configuration, `--mode=update-lockfile`, core_1.formatUtils.Type.CODE)}`);
+        const immutable = ((_a = this.immutable) !== null && _a !== void 0 ? _a : configuration.get(`enableImmutableInstalls`)) && !updateMode;
+        const immutableCache = this.immutableCache && !updateMode;
         if (configuration.projectCwd !== null) {
             const fixReport = await core_1.StreamReport.start({
                 configuration,
@@ -218,7 +222,7 @@ class YarnCommand extends cli_1.BaseCommand {
             }
         }
         const { project, workspace } = await core_1.Project.find(configuration, this.context.cwd);
-        const cache = await core_1.Cache.find(configuration, { immutable: this.immutableCache, check: this.checkCache });
+        const cache = await core_1.Cache.find(configuration, { immutable: immutableCache, check: this.checkCache });
         if (!workspace)
             throw new cli_1.WorkspaceRequiredError(project.cwd, this.context.cwd);
         await project.restoreInstallState({

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 = (0, tslib_1.__importDefault)(require("semver"));
+const semver_1 = tslib_1.__importDefault(require("semver"));
 const url_1 = require("url");
 const vm_1 = require("vm");
 const list_1 = require("./list");

package/lib/commands/remove.js

@@ -6,9 +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 = (0, tslib_1.__importDefault)(require("micromatch"));
-const t = (0, tslib_1.__importStar)(require("typanion"));
-const suggestUtils = (0, tslib_1.__importStar)(require("../suggestUtils"));
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
+const t = tslib_1.__importStar(require("typanion"));
+const suggestUtils = tslib_1.__importStar(require("../suggestUtils"));
 // eslint-disable-next-line arca/no-default-export
 class RemoveCommand extends cli_1.BaseCommand {
     constructor() {

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

@@ -21,11 +21,11 @@ function getBranchRef(branch) {
 const cloneWorkflow = ({ repository, branch }, target) => [
     [`git`, `init`, fslib_1.npath.fromPortablePath(target)],
     [`git`, `remote`, `add`, `origin`, repository],
-    [`git`, `fetch`, `origin`, getBranchRef(branch)],
+    [`git`, `fetch`, `origin`, `--depth=1`, getBranchRef(branch)],
     [`git`, `reset`, `--hard`, `FETCH_HEAD`],
 ];
 const updateWorkflow = ({ branch }) => [
-    [`git`, `fetch`, `origin`, getBranchRef(branch), `--force`],
+    [`git`, `fetch`, `origin`, `--depth=1`, getBranchRef(branch), `--force`],
     [`git`, `reset`, `--hard`, `FETCH_HEAD`],
     [`git`, `clean`, `-dfx`],
 ];

package/lib/commands/set/version.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 = (0, tslib_1.__importDefault)(require("semver"));
+const semver_1 = tslib_1.__importDefault(require("semver"));
 // eslint-disable-next-line arca/no-default-export
 class SetVersionCommand extends cli_1.BaseCommand {
     constructor() {
@@ -165,8 +165,10 @@ async function setVersion(configuration, bundleVersion, bundleBuffer, { report }
             yarnPath: projectPath,
         });
         const manifest = (await core_1.Manifest.tryFind(projectCwd)) || new core_1.Manifest();
-        if (bundleVersion && core_2.miscUtils.isTaggedYarnVersion(bundleVersion))
-            manifest.packageManager = `yarn@${bundleVersion}`;
+        manifest.packageManager = `yarn@${bundleVersion && core_2.miscUtils.isTaggedYarnVersion(bundleVersion)
+            ? bundleVersion
+            // If the version isn't tagged, we use the latest stable version as the wrapper
+            : await resolveTag(configuration, `stable`)}`;
         const data = {};
         manifest.exportTo(data);
         const path = fslib_1.ppath.join(projectCwd, core_1.Manifest.fileName);

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 = (0, tslib_1.__importDefault)(require("micromatch"));
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
 // eslint-disable-next-line arca/no-default-export
 class UnlinkCommand extends cli_1.BaseCommand {
     constructor() {

package/lib/commands/up.js

@@ -7,9 +7,9 @@ const core_2 = require("@yarnpkg/core");
 const core_3 = require("@yarnpkg/core");
 const clipanion_1 = require("clipanion");
 const enquirer_1 = require("enquirer");
-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"));
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
+const t = tslib_1.__importStar(require("typanion"));
+const suggestUtils = tslib_1.__importStar(require("../suggestUtils"));
 // eslint-disable-next-line arca/no-default-export
 class UpCommand extends cli_1.BaseCommand {
     constructor() {

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

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

package/lib/commands/workspaces/list.js

@@ -2,11 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const cli_1 = require("@yarnpkg/cli");
 const core_1 = require("@yarnpkg/core");
+const plugin_git_1 = require("@yarnpkg/plugin-git");
 const clipanion_1 = require("clipanion");
 // eslint-disable-next-line arca/no-default-export
 class WorkspacesListCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
+        this.since = clipanion_1.Option.String(`--since`, {
+            description: `Only include workspaces that have been changed since the specified ref.`,
+            tolerateBoolean: true,
+        });
+        this.recursive = clipanion_1.Option.Boolean(`-R,--recursive`, false, {
+            description: `Find packages via dependencies/devDependencies instead of using the workspaces field`,
+        });
         this.verbose = clipanion_1.Option.Boolean(`-v,--verbose`, false, {
             description: `Also return the cross-dependencies between workspaces`,
         });
@@ -22,7 +30,15 @@ class WorkspacesListCommand extends cli_1.BaseCommand {
             json: this.json,
             stdout: this.context.stdout,
         }, async (report) => {
-            for (const workspace of project.workspaces) {
+            const candidates = this.since
+                ? await plugin_git_1.gitUtils.fetchChangedWorkspaces({ ref: this.since, project })
+                : project.workspaces;
+            const workspaces = new Set(candidates);
+            if (this.recursive)
+                for (const dependents of [...candidates].map(candidate => candidate.getRecursiveWorkspaceDependents()))
+                    for (const dependent of dependents)
+                        workspaces.add(dependent);
+            for (const workspace of workspaces) {
                 const { manifest } = workspace;
                 let extra;
                 if (this.verbose) {
@@ -71,6 +87,12 @@ WorkspacesListCommand.usage = clipanion_1.Command.Usage({
     category: `Workspace-related commands`,
     description: `list all available workspaces`,
     details: `
-      This command will print the list of all workspaces in the project. If both the \`-v,--verbose\` and \`--json\` options are set, Yarn will also return the cross-dependencies between each workspaces (useful when you wish to automatically generate Buck / Bazel rules).
+      This command will print the list of all workspaces in the project.
+
+      - If \`--since\` is set, Yarn will only list workspaces that have been modified since the specified ref. By default Yarn will use the refs specified by the \`changesetBaseRefs\` configuration option.
+
+      - If \`-R,--recursive\` is set, Yarn will find workspaces to run the command on by recursively evaluating \`dependencies\` and \`devDependencies\` fields, instead of looking at the \`workspaces\` fields.
+
+      - If both the \`-v,--verbose\` and \`--json\` options are set, Yarn will also return the cross-dependencies between each workspaces (useful when you wish to automatically generate Buck / Bazel rules).
     `,
 });

package/lib/dedupeUtils.js

@@ -4,7 +4,7 @@ exports.dedupe = exports.acceptedStrategies = exports.Strategy = void 0;
 const tslib_1 = require("tslib");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
-const micromatch_1 = (0, tslib_1.__importDefault)(require("micromatch"));
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
 var Strategy;
 (function (Strategy) {
     /**
@@ -79,6 +79,9 @@ async function dedupe(project, { strategy, patterns, cache, report }) {
         project,
         report: throwReport,
         skipIntegrityCheck: true,
+        cacheOptions: {
+            skipIntegrityCheck: true,
+        },
     };
     const resolveOptions = {
         project,

package/lib/index.d.ts

@@ -4,9 +4,36 @@ import * as dedupeUtils from './dedupeUtils';
 import * as suggestUtils from './suggestUtils';
 export { dedupeUtils, suggestUtils, };
 export interface Hooks {
+    /**
+     * Called when a new dependency is added to a workspace. Note that this hook
+     * is only called by the CLI commands like `yarn add` - manually adding the
+     * dependencies into the manifest and running `yarn install` won't trigger
+     * it.
+     */
     afterWorkspaceDependencyAddition?: (workspace: Workspace, target: suggestUtils.Target, descriptor: Descriptor, strategies: Array<suggestUtils.Strategy>) => Promise<void>;
+    /**
+     * Called when a dependency range is replaced inside a workspace. Note that
+     * this hook is only called by the CLI commands like `yarn add` - manually
+     * updating the dependencies from the manifest and running `yarn install`
+     * won't trigger it.
+     */
     afterWorkspaceDependencyReplacement?: (workspace: Workspace, target: suggestUtils.Target, fromDescriptor: Descriptor, toDescriptor: Descriptor) => Promise<void>;
+    /**
+     * Called when a dependency range is removed from a workspace. Note that
+     * this hook is only called by the CLI commands like `yarn remove` - manually
+     * removing the dependencies from the manifest and running `yarn install`
+     * won't trigger it.
+     */
     afterWorkspaceDependencyRemoval?: (workspace: Workspace, target: suggestUtils.Target, descriptor: Descriptor) => Promise<void>;
+    /**
+     * Called by `yarn info`. The `extra` field is the set of parameters passed
+     * to the `-X,--extra` flag. Calling `registerData` will add a new set of
+     * data that will be added to the package information.
+     *
+     * For instance, an "audit" plugin could check in `extra` whether the user
+     * requested audit information (via `-X audit`), and call `registerData`
+     * with those information (retrieved dynamically) if they did.
+     */
     fetchPackageInfo?: (pkg: Package, extra: Set<string>, registerData: (namespace: string, data: Array<formatUtils.Tuple> | {
         [key: string]: formatUtils.Tuple | undefined;
     }) => void) => Promise<void>;

package/lib/index.js

@@ -4,44 +4,45 @@ exports.suggestUtils = exports.dedupeUtils = void 0;
 const tslib_1 = require("tslib");
 const core_1 = require("@yarnpkg/core");
 const ci_info_1 = require("ci-info");
-const add_1 = (0, tslib_1.__importDefault)(require("./commands/add"));
-const bin_1 = (0, tslib_1.__importDefault)(require("./commands/bin"));
-const clean_1 = (0, tslib_1.__importDefault)(require("./commands/cache/clean"));
-const get_1 = (0, tslib_1.__importDefault)(require("./commands/config/get"));
-const set_1 = (0, tslib_1.__importDefault)(require("./commands/config/set"));
-const unset_1 = (0, tslib_1.__importDefault)(require("./commands/config/unset"));
-const config_1 = (0, tslib_1.__importDefault)(require("./commands/config"));
-const dedupe_1 = (0, tslib_1.__importDefault)(require("./commands/dedupe"));
-const clipanion_1 = (0, tslib_1.__importDefault)(require("./commands/entries/clipanion"));
-const help_1 = (0, tslib_1.__importDefault)(require("./commands/entries/help"));
-const run_1 = (0, tslib_1.__importDefault)(require("./commands/entries/run"));
-const version_1 = (0, tslib_1.__importDefault)(require("./commands/entries/version"));
-const exec_1 = (0, tslib_1.__importDefault)(require("./commands/exec"));
-const peerRequirements_1 = (0, tslib_1.__importDefault)(require("./commands/explain/peerRequirements"));
-const info_1 = (0, tslib_1.__importDefault)(require("./commands/info"));
-const install_1 = (0, tslib_1.__importDefault)(require("./commands/install"));
-const link_1 = (0, tslib_1.__importDefault)(require("./commands/link"));
-const node_1 = (0, tslib_1.__importDefault)(require("./commands/node"));
-const sources_1 = (0, tslib_1.__importDefault)(require("./commands/plugin/import/sources"));
-const import_1 = (0, tslib_1.__importDefault)(require("./commands/plugin/import"));
-const list_1 = (0, tslib_1.__importDefault)(require("./commands/plugin/list"));
-const remove_1 = (0, tslib_1.__importDefault)(require("./commands/plugin/remove"));
-const runtime_1 = (0, tslib_1.__importDefault)(require("./commands/plugin/runtime"));
-const rebuild_1 = (0, tslib_1.__importDefault)(require("./commands/rebuild"));
-const remove_2 = (0, tslib_1.__importDefault)(require("./commands/remove"));
-const runIndex_1 = (0, tslib_1.__importDefault)(require("./commands/runIndex"));
-const run_2 = (0, tslib_1.__importDefault)(require("./commands/run"));
-const resolution_1 = (0, tslib_1.__importDefault)(require("./commands/set/resolution"));
-const sources_2 = (0, tslib_1.__importDefault)(require("./commands/set/version/sources"));
-const version_2 = (0, tslib_1.__importDefault)(require("./commands/set/version"));
-const unlink_1 = (0, tslib_1.__importDefault)(require("./commands/unlink"));
-const up_1 = (0, tslib_1.__importDefault)(require("./commands/up"));
-const why_1 = (0, tslib_1.__importDefault)(require("./commands/why"));
-const list_2 = (0, tslib_1.__importDefault)(require("./commands/workspaces/list"));
-const workspace_1 = (0, tslib_1.__importDefault)(require("./commands/workspace"));
-const dedupeUtils = (0, tslib_1.__importStar)(require("./dedupeUtils"));
+const add_1 = tslib_1.__importDefault(require("./commands/add"));
+const bin_1 = tslib_1.__importDefault(require("./commands/bin"));
+const clean_1 = tslib_1.__importDefault(require("./commands/cache/clean"));
+const get_1 = tslib_1.__importDefault(require("./commands/config/get"));
+const set_1 = tslib_1.__importDefault(require("./commands/config/set"));
+const unset_1 = tslib_1.__importDefault(require("./commands/config/unset"));
+const config_1 = tslib_1.__importDefault(require("./commands/config"));
+const dedupe_1 = tslib_1.__importDefault(require("./commands/dedupe"));
+const clipanion_1 = tslib_1.__importDefault(require("./commands/entries/clipanion"));
+const help_1 = tslib_1.__importDefault(require("./commands/entries/help"));
+const run_1 = tslib_1.__importDefault(require("./commands/entries/run"));
+const version_1 = tslib_1.__importDefault(require("./commands/entries/version"));
+const exec_1 = tslib_1.__importDefault(require("./commands/exec"));
+const peerRequirements_1 = tslib_1.__importDefault(require("./commands/explain/peerRequirements"));
+const explain_1 = tslib_1.__importDefault(require("./commands/explain"));
+const info_1 = tslib_1.__importDefault(require("./commands/info"));
+const install_1 = tslib_1.__importDefault(require("./commands/install"));
+const link_1 = tslib_1.__importDefault(require("./commands/link"));
+const node_1 = tslib_1.__importDefault(require("./commands/node"));
+const sources_1 = tslib_1.__importDefault(require("./commands/plugin/import/sources"));
+const import_1 = tslib_1.__importDefault(require("./commands/plugin/import"));
+const list_1 = tslib_1.__importDefault(require("./commands/plugin/list"));
+const remove_1 = tslib_1.__importDefault(require("./commands/plugin/remove"));
+const runtime_1 = tslib_1.__importDefault(require("./commands/plugin/runtime"));
+const rebuild_1 = tslib_1.__importDefault(require("./commands/rebuild"));
+const remove_2 = tslib_1.__importDefault(require("./commands/remove"));
+const runIndex_1 = tslib_1.__importDefault(require("./commands/runIndex"));
+const run_2 = tslib_1.__importDefault(require("./commands/run"));
+const resolution_1 = tslib_1.__importDefault(require("./commands/set/resolution"));
+const sources_2 = tslib_1.__importDefault(require("./commands/set/version/sources"));
+const version_2 = tslib_1.__importDefault(require("./commands/set/version"));
+const unlink_1 = tslib_1.__importDefault(require("./commands/unlink"));
+const up_1 = tslib_1.__importDefault(require("./commands/up"));
+const why_1 = tslib_1.__importDefault(require("./commands/why"));
+const list_2 = tslib_1.__importDefault(require("./commands/workspaces/list"));
+const workspace_1 = tslib_1.__importDefault(require("./commands/workspace"));
+const dedupeUtils = tslib_1.__importStar(require("./dedupeUtils"));
 exports.dedupeUtils = dedupeUtils;
-const suggestUtils = (0, tslib_1.__importStar)(require("./suggestUtils"));
+const suggestUtils = tslib_1.__importStar(require("./suggestUtils"));
 exports.suggestUtils = suggestUtils;
 const plugin = {
     configuration: {
@@ -76,6 +77,7 @@ const plugin = {
         dedupe_1.default,
         exec_1.default,
         peerRequirements_1.default,
+        explain_1.default,
         info_1.default,
         install_1.default,
         link_1.default,

package/lib/suggestUtils.js

@@ -5,7 +5,7 @@ const tslib_1 = require("tslib");
 const core_1 = require("@yarnpkg/core");
 const core_2 = require("@yarnpkg/core");
 const fslib_1 = require("@yarnpkg/fslib");
-const semver_1 = (0, tslib_1.__importDefault)(require("semver"));
+const semver_1 = tslib_1.__importDefault(require("semver"));
 const WORKSPACE_PROTOCOL = `workspace:`;
 var Target;
 (function (Target) {
@@ -313,7 +313,7 @@ async function fetchDescriptorFrom(ident, range, { project, cache, workspace, pr
     const report = new core_1.ThrowReport();
     const fetcher = project.configuration.makeFetcher();
     const resolver = project.configuration.makeResolver();
-    const fetchOptions = { project, fetcher, cache, checksums: project.storedChecksums, report, skipIntegrityCheck: true };
+    const fetchOptions = { project, fetcher, cache, checksums: project.storedChecksums, report, cacheOptions: { skipIntegrityCheck: true }, skipIntegrityCheck: true };
     const resolveOptions = { ...fetchOptions, resolver, fetchOptions };
     // The descriptor has to be bound for the resolvers that need a parent locator. (e.g. FileResolver)
     // If we didn't bind it, `yarn add ./folder` wouldn't work.

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@yarnpkg/plugin-essentials",
-  "version": "3.1.0-rc.8",
+  "version": "3.2.0-rc.10",
   "license": "BSD-2-Clause",
   "main": "./lib/index.js",
   "dependencies": {
-    "@yarnpkg/fslib": "^2.6.0-rc.8",
+    "@yarnpkg/fslib": "^2.6.1-rc.7",
     "@yarnpkg/json-proxy": "^2.1.1",
-    "@yarnpkg/parsers": "^2.4.1-rc.8",
-    "ci-info": "^2.0.0",
-    "clipanion": "^3.0.1",
+    "@yarnpkg/parsers": "^2.5.0-rc.10",
+    "ci-info": "^3.2.0",
+    "clipanion": "^3.2.0-rc.4",
     "enquirer": "^2.3.6",
     "lodash": "^4.17.15",
     "micromatch": "^4.0.2",
@@ -17,17 +17,18 @@
     "typanion": "^3.3.0"
   },
   "peerDependencies": {
-    "@yarnpkg/cli": "^3.1.0-rc.8",
-    "@yarnpkg/core": "^3.1.0-rc.9"
+    "@yarnpkg/cli": "^3.2.0-rc.12",
+    "@yarnpkg/core": "^3.2.0-rc.12",
+    "@yarnpkg/plugin-git": "^2.6.0-rc.12"
   },
   "devDependencies": {
-    "@types/ci-info": "^2",
     "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/semver": "^7.1.0",
     "@types/treeify": "^1.0.0",
-    "@yarnpkg/cli": "^3.1.0-rc.8",
-    "@yarnpkg/core": "^3.1.0-rc.9"
+    "@yarnpkg/cli": "^3.2.0-rc.12",
+    "@yarnpkg/core": "^3.2.0-rc.12",
+    "@yarnpkg/plugin-git": "^2.6.0-rc.12"
   },
   "repository": {
     "type": "git",
@@ -48,6 +49,6 @@
   "engines": {
     "node": ">=12 <14 || 14.2 - 14.9 || >14.10.0"
   },
-  "stableVersion": "3.0.0",
+  "stableVersion": "3.1.0",
   "typings": "./lib/index.d.ts"
 }