chore: replace lodash with es-toolkit (#6502)

wojtekmaj · merceyz · web-flow · commit 6f8114f6dd5a · 2025-07-26T10:19:10.000+02:00
## What's the problem this PR addresses? es-toolkit is a modern lodash alternative that claims to be much faster and lighter, potentially improving Yarn overall performance: https://es-toolkit.slash.page/intro.html ## How did you fix it? The lazy way, frankly: using es-toolkit/compat to provide practically drop-in lodash replacement with minimal effort. ## Checklist    - [x] I have read the [Contributing Guide](https://yarnpkg.com/advanced/contributing).   - [x] I have set the packages that need to be released for my changes to be effective.   - [x] I will check that all automated PR checks pass before the PR gets reviewed. --------- Co-authored-by: Kristoffer K. <merceyz@users.noreply.github.com>
diff --git a/.pnp.cjs b/.pnp.cjs
diff --git a/.yarn/cache/es-toolkit-npm-1.39.7-e794fb407f-19e95de0e6.zip b/.yarn/cache/es-toolkit-npm-1.39.7-e794fb407f-19e95de0e6.zip
diff --git a/.yarn/versions/4251696d.yml b/.yarn/versions/4251696d.yml
@@ -0,0 +1,35 @@
+releases:
+  "@yarnpkg/core": patch
+  "@yarnpkg/plugin-constraints": patch
+  "@yarnpkg/plugin-essentials": patch
+  "@yarnpkg/plugin-git": patch
+  "@yarnpkg/plugin-npm": patch
+  "@yarnpkg/plugin-version": patch
+  "@yarnpkg/plugin-workspace-tools": patch
+  "@yarnpkg/sdks": patch
+
+declined:
+  - "@yarnpkg/plugin-compat"
+  - "@yarnpkg/plugin-dlx"
+  - "@yarnpkg/plugin-exec"
+  - "@yarnpkg/plugin-file"
+  - "@yarnpkg/plugin-github"
+  - "@yarnpkg/plugin-http"
+  - "@yarnpkg/plugin-init"
+  - "@yarnpkg/plugin-interactive-tools"
+  - "@yarnpkg/plugin-jsr"
+  - "@yarnpkg/plugin-link"
+  - "@yarnpkg/plugin-nm"
+  - "@yarnpkg/plugin-npm-cli"
+  - "@yarnpkg/plugin-pack"
+  - "@yarnpkg/plugin-patch"
+  - "@yarnpkg/plugin-pnp"
+  - "@yarnpkg/plugin-pnpm"
+  - "@yarnpkg/plugin-stage"
+  - "@yarnpkg/plugin-typescript"
+  - "@yarnpkg/builder"
+  - "@yarnpkg/cli"
+  - "@yarnpkg/doctor"
+  - "@yarnpkg/extensions"
+  - "@yarnpkg/nm"
+  - "@yarnpkg/pnpify"
diff --git a/packages/acceptance-tests/pkg-tests-specs/package.json b/packages/acceptance-tests/pkg-tests-specs/package.json
@@ -21,7 +21,7 @@
     "@yarnpkg/monorepo": "workspace:^",
     "@yarnpkg/parsers": "workspace:^",
     "@yarnpkg/pnp": "workspace:^",
-    "lodash": "^4.17.15",
+    "es-toolkit": "^1.39.7",
     "pkg-tests-core": "workspace:^",
     "tar": "^6.0.5",
     "tslib": "^2.4.0"
diff --git a/packages/acceptance-tests/pkg-tests-specs/sources/plugins/plugin-typescript.test.ts b/packages/acceptance-tests/pkg-tests-specs/sources/plugins/plugin-typescript.test.ts
@@ -1,6 +1,6 @@
 import {Manifest}                 from '@yarnpkg/core';
 import {PortablePath, ppath, xfs} from '@yarnpkg/fslib';
-import {merge}                    from 'lodash';
+import {merge}                    from 'es-toolkit/compat';
 import {fs, yarn}                 from 'pkg-tests-core';
 
 const {unpackToDirectory} = fs;
diff --git a/packages/docusaurus/config/remark/commandLineHighlight.ts b/packages/docusaurus/config/remark/commandLineHighlight.ts
@@ -1,8 +1,8 @@
 import {YarnCli, getCli}        from '@yarnpkg/cli';
 import {parseShell}             from '@yarnpkg/parsers';
 import type {Definition, Token} from 'clipanion';
+import {capitalize}             from 'es-toolkit/compat';
 import {fromJs}                 from 'esast-util-from-js';
-import {capitalize}             from 'lodash';
 import type {MdxJsxFlowElement} from 'mdast-util-mdx-jsx';
 import type {Parent, Root}      from 'mdast';
 import type {Transformer}       from 'unified';
diff --git a/packages/docusaurus/package.json b/packages/docusaurus/package.json
@@ -38,13 +38,13 @@
     "clsx": "^1.2.1",
     "docusaurus-plugin-typedoc-api": "patch:docusaurus-plugin-typedoc-api@npm%3A4.4.0#~/.yarn/patches/docusaurus-plugin-typedoc-api-npm-4.4.0-2657a63517.patch",
     "dompurify": "^3.0.5",
+    "es-toolkit": "^1.39.7",
     "esast-util-from-js": "^2.0.1",
     "esbuild-loader": "^2.20.0",
     "fast-glob": "^3.2.2",
     "git-url-parse": "^13.1.0",
     "github-markdown-css": "^5.1.0",
     "jiti": "^1.21.0",
-    "lodash": "^4.17.15",
     "markdown-it": "^13.0.1",
     "marked": "^5.1.1",
     "monaco-editor": "^0.24.0",
@@ -79,7 +79,6 @@
     "@docusaurus/types": "^3.7.0",
     "@types/dompurify": "^3",
     "@types/git-url-parse": "^9.0.0",
-    "@types/lodash": "^4.14.136",
     "@types/markdown-it": "^12.2.3",
     "@types/marked": "^5.0.0",
     "@types/mdast": "^4.0.3",
diff --git a/packages/plugin-constraints/package.json b/packages/plugin-constraints/package.json
@@ -15,7 +15,7 @@
   "dependencies": {
     "@yarnpkg/fslib": "workspace:^",
     "clipanion": "^4.0.0-rc.2",
-    "lodash": "^4.17.15",
+    "es-toolkit": "^1.39.7",
     "tau-prolog": "^0.2.66",
     "tslib": "^2.4.0"
   },
@@ -24,7 +24,6 @@
     "@yarnpkg/core": "workspace:^"
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.136",
     "@yarnpkg/builder": "workspace:^",
     "@yarnpkg/cli": "workspace:^",
     "@yarnpkg/core": "workspace:^",
diff --git a/packages/plugin-constraints/sources/constraintUtils.ts b/packages/plugin-constraints/sources/constraintUtils.ts
@@ -1,9 +1,6 @@
 import {Configuration, formatUtils, Manifest, miscUtils, nodeUtils, Project, treeUtils, Workspace} from '@yarnpkg/core';
 import {PortablePath}                                                                              from '@yarnpkg/fslib';
-import get                                                                                         from 'lodash/get';
-import set                                                                                         from 'lodash/set';
-import toPath                                                                                      from 'lodash/toPath';
-import unset                                                                                       from 'lodash/unset';
+import {get, set, toPath, unset}                                                                   from 'es-toolkit/compat';
 
 export type ProcessResult = {
   manifestUpdates: Map<PortablePath, Map<string, Map<any, Set<nodeUtils.Caller>>>>;
diff --git a/packages/plugin-constraints/sources/tauModule.ts b/packages/plugin-constraints/sources/tauModule.ts
@@ -2,7 +2,7 @@
 
 import {Project, structUtils} from '@yarnpkg/core';
 import {PortablePath}         from '@yarnpkg/fslib';
-import getPath                from 'lodash/get';
+import {get as getPath}       from 'es-toolkit/compat';
 import pl                     from 'tau-prolog';
 import vm                     from 'vm';
 
diff --git a/packages/plugin-essentials/package.json b/packages/plugin-essentials/package.json
@@ -13,7 +13,7 @@
     "ci-info": "^4.0.0",
     "clipanion": "^4.0.0-rc.2",
     "enquirer": "^2.3.6",
-    "lodash": "^4.17.15",
+    "es-toolkit": "^1.39.7",
     "micromatch": "^4.0.2",
     "semver": "^7.1.2",
     "tslib": "^2.4.0",
@@ -25,7 +25,6 @@
     "@yarnpkg/plugin-git": "workspace:^"
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/semver": "^7.1.0",
     "@yarnpkg/cli": "workspace:^",
diff --git a/packages/plugin-essentials/sources/commands/config/get.ts b/packages/plugin-essentials/sources/commands/config/get.ts
@@ -1,7 +1,7 @@
 import {BaseCommand}                            from '@yarnpkg/cli';
 import {Configuration, StreamReport, miscUtils} from '@yarnpkg/core';
 import {Command, Option, Usage, UsageError}     from 'clipanion';
-import getPath                                  from 'lodash/get';
+import {get as getPath}                         from 'es-toolkit/compat';
 import {inspect}                                from 'util';
 
 // eslint-disable-next-line arca/no-default-export
diff --git a/packages/plugin-essentials/sources/commands/config/set.ts b/packages/plugin-essentials/sources/commands/config/set.ts
@@ -1,9 +1,7 @@
 import {BaseCommand}                                         from '@yarnpkg/cli';
 import {Configuration, StreamReport, MessageName, miscUtils} from '@yarnpkg/core';
 import {Command, Option, Usage, UsageError}                  from 'clipanion';
-import cloneDeep                                             from 'lodash/cloneDeep';
-import getPath                                               from 'lodash/get';
-import setPath                                               from 'lodash/set';
+import {cloneDeep, get as getPath, set as setPath}           from 'es-toolkit/compat';
 import {inspect}                                             from 'util';
 
 // eslint-disable-next-line arca/no-default-export
diff --git a/packages/plugin-essentials/sources/commands/config/unset.ts b/packages/plugin-essentials/sources/commands/config/unset.ts
@@ -1,9 +1,7 @@
-import {BaseCommand}                              from '@yarnpkg/cli';
-import {Configuration, StreamReport, MessageName} from '@yarnpkg/core';
-import {Command, Option, Usage, UsageError}       from 'clipanion';
-import cloneDeep                                  from 'lodash/cloneDeep';
-import hasPath                                    from 'lodash/has';
-import unsetPath                                  from 'lodash/unset';
+import {BaseCommand}                                   from '@yarnpkg/cli';
+import {Configuration, StreamReport, MessageName}      from '@yarnpkg/core';
+import {Command, Option, Usage, UsageError}            from 'clipanion';
+import {cloneDeep, has as hasPath, unset as unsetPath} from 'es-toolkit/compat';
 
 // eslint-disable-next-line arca/no-default-export
 export default class ConfigUnsetCommand extends BaseCommand {
diff --git a/packages/plugin-git/package.json b/packages/plugin-git/package.json
@@ -11,8 +11,8 @@
     "@types/semver": "^7.1.0",
     "@yarnpkg/fslib": "workspace:^",
     "clipanion": "^4.0.0-rc.2",
+    "es-toolkit": "^1.39.7",
     "git-url-parse": "^13.1.0",
-    "lodash": "^4.17.15",
     "semver": "^7.1.2",
     "tslib": "^2.4.0"
   },
@@ -21,7 +21,6 @@
   },
   "devDependencies": {
     "@types/git-url-parse": "^9.0.0",
-    "@types/lodash": "^4.14.136",
     "@yarnpkg/core": "workspace:^"
   },
   "repository": {
diff --git a/packages/plugin-git/sources/gitUtils.ts b/packages/plugin-git/sources/gitUtils.ts
@@ -1,8 +1,8 @@
 import {Configuration, Hooks, Locator, Project, execUtils, httpUtils, miscUtils, semverUtils, structUtils, ReportError, MessageName, formatUtils} from '@yarnpkg/core';
 import {Filename, npath, PortablePath, ppath, xfs}                                                                                                from '@yarnpkg/fslib';
 import {UsageError}                                                                                                                               from 'clipanion';
+import {capitalize}                                                                                                                               from 'es-toolkit/compat';
 import GitUrlParse                                                                                                                                from 'git-url-parse';
-import capitalize                                                                                                                                 from 'lodash/capitalize';
 import querystring                                                                                                                                from 'querystring';
 import semver                                                                                                                                     from 'semver';
 
diff --git a/packages/plugin-npm/package.json b/packages/plugin-npm/package.json
@@ -10,7 +10,7 @@
   "dependencies": {
     "@yarnpkg/fslib": "workspace:^",
     "enquirer": "^2.3.6",
-    "lodash": "^4.17.15",
+    "es-toolkit": "^1.39.7",
     "semver": "^7.1.2",
     "sigstore": "^3.1.0",
     "ssri": "^12.0.0",
@@ -21,7 +21,6 @@
     "@yarnpkg/plugin-pack": "workspace:^"
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.136",
     "@types/semver": "^7.1.0",
     "@types/ssri": "^7.1.5",
     "@yarnpkg/core": "workspace:^",
diff --git a/packages/plugin-npm/sources/npmHttpUtils.ts b/packages/plugin-npm/sources/npmHttpUtils.ts
@@ -2,7 +2,7 @@ import {Configuration, Ident, formatUtils, httpUtils, nodeUtils, StreamReport, s
 import {MessageName, ReportError}                                                                                                 from '@yarnpkg/core';
 import {Filename, PortablePath, ppath, xfs}                                                                                       from '@yarnpkg/fslib';
 import {prompt}                                                                                                                   from 'enquirer';
-import pick                                                                                                                       from 'lodash/pick';
+import {pick}                                                                                                                     from 'es-toolkit/compat';
 import semver                                                                                                                     from 'semver';
 
 import {Hooks}                                                                                                                    from './index';
diff --git a/packages/plugin-version/package.json b/packages/plugin-version/package.json
@@ -12,8 +12,8 @@
     "@yarnpkg/libui": "workspace:^",
     "@yarnpkg/parsers": "workspace:^",
     "clipanion": "^4.0.0-rc.2",
+    "es-toolkit": "^1.39.7",
     "ink": "^3.2.0",
-    "lodash": "^4.17.15",
     "react": "^17.0.2",
     "semver": "^7.1.2",
     "tslib": "^2.4.0"
@@ -24,7 +24,6 @@
     "@yarnpkg/plugin-git": "workspace:^"
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.136",
     "@types/react": "^16.8.0",
     "@types/semver": "^7.1.0",
     "@yarnpkg/builder": "workspace:^",
diff --git a/packages/plugin-version/sources/versionUtils.ts b/packages/plugin-version/sources/versionUtils.ts
@@ -3,7 +3,7 @@ import {PortablePath, npath, ppath, xfs}
 import {parseSyml, stringifySyml}                                                                                                            from '@yarnpkg/parsers';
 import {gitUtils}                                                                                                                            from '@yarnpkg/plugin-git';
 import {UsageError}                                                                                                                          from 'clipanion';
-import omit                                                                                                                                  from 'lodash/omit';
+import {omit}                                                                                                                                from 'es-toolkit/compat';
 import semver                                                                                                                                from 'semver';
 
 // Basically we only support auto-upgrading the ranges that are very simple (^x.y.z, ~x.y.z, >=x.y.z, and of course x.y.z)
diff --git a/packages/plugin-workspace-tools/package.json b/packages/plugin-workspace-tools/package.json
@@ -10,6 +10,7 @@
   "dependencies": {
     "@yarnpkg/fslib": "workspace:^",
     "clipanion": "^4.0.0-rc.2",
+    "es-toolkit": "^1.39.7",
     "micromatch": "^4.0.2",
     "p-limit": "^2.2.0",
     "tslib": "^2.4.0",
@@ -21,7 +22,6 @@
     "@yarnpkg/plugin-git": "workspace:^"
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@yarnpkg/builder": "workspace:^",
     "@yarnpkg/cli": "workspace:^",
diff --git a/packages/yarnpkg-core/package.json b/packages/yarnpkg-core/package.json
@@ -25,10 +25,10 @@
     "cross-spawn": "^7.0.3",
     "diff": "^5.1.0",
     "dotenv": "^16.3.1",
+    "es-toolkit": "^1.39.7",
     "fast-glob": "^3.2.2",
     "got": "^11.7.0",
     "hpagent": "^1.2.0",
-    "lodash": "^4.17.15",
     "micromatch": "^4.0.2",
     "p-limit": "^2.2.0",
     "semver": "^7.1.2",
@@ -46,7 +46,6 @@
     "@types/comment-json": "^1.1.1",
     "@types/cross-spawn": "6.0.0",
     "@types/diff": "^5.0.0",
-    "@types/lodash": "^4.14.136",
     "@types/micromatch": "^4.0.1",
     "@types/node": "^18.17.15",
     "@types/tar": "^4.0.4",
diff --git a/packages/yarnpkg-core/sources/Project.ts b/packages/yarnpkg-core/sources/Project.ts
@@ -4,7 +4,7 @@ import {parseSyml, stringifySyml}                                       from '@y
 import {UsageError}                                                     from 'clipanion';
 import {createHash}                                                     from 'crypto';
 import {structuredPatch}                                                from 'diff';
-import pick                                                             from 'lodash/pick';
+import {pick}                                                           from 'es-toolkit/compat';
 import pLimit                                                           from 'p-limit';
 import semver                                                           from 'semver';
 import internal                                                         from 'stream';
diff --git a/packages/yarnpkg-core/sources/Report.ts b/packages/yarnpkg-core/sources/Report.ts
@@ -1,4 +1,4 @@
-import throttle               from 'lodash/throttle';
+import {throttle}             from 'es-toolkit/compat';
 import {PassThrough}          from 'stream';
 import {StringDecoder}        from 'string_decoder';
 
diff --git a/packages/yarnpkg-core/sources/miscUtils.ts b/packages/yarnpkg-core/sources/miscUtils.ts
@@ -1,7 +1,6 @@
 import {PortablePath, npath, xfs} from '@yarnpkg/fslib';
 import {UsageError}               from 'clipanion';
-import isEqual                    from 'lodash/isEqual';
-import mergeWith                  from 'lodash/mergeWith';
+import {isEqual, mergeWith}       from 'es-toolkit/compat';
 import micromatch                 from 'micromatch';
 import pLimit, {Limit}            from 'p-limit';
 import semver                     from 'semver';
diff --git a/packages/yarnpkg-core/sources/scriptUtils.ts b/packages/yarnpkg-core/sources/scriptUtils.ts
@@ -2,7 +2,7 @@ import {CwdFS, Filename, NativePath, PortablePath} from '@yarnpkg/fslib';
 import {xfs, npath, ppath}                         from '@yarnpkg/fslib';
 import {ZipOpenFS}                                 from '@yarnpkg/libzip';
 import {execute}                                   from '@yarnpkg/shell';
-import capitalize                                  from 'lodash/capitalize';
+import {capitalize}                                from 'es-toolkit/compat';
 import pLimit                                      from 'p-limit';
 import {PassThrough, Readable, Writable}           from 'stream';
 
diff --git a/packages/yarnpkg-sdks/package.json b/packages/yarnpkg-sdks/package.json
@@ -17,12 +17,11 @@
     "chalk": "^4.1.2",
     "clipanion": "^4.0.0-rc.2",
     "comment-json": "^2.2.0",
-    "lodash": "^4.17.15",
+    "es-toolkit": "^1.39.7",
     "tslib": "^2.4.0"
   },
   "devDependencies": {
     "@types/comment-json": "^1.1.1",
-    "@types/lodash": "^4.14.136",
     "@yarnpkg/monorepo": "workspace:^",
     "@yarnpkg/pnp": "workspace:^"
   },
diff --git a/packages/yarnpkg-sdks/sources/generateSdk.ts b/packages/yarnpkg-sdks/sources/generateSdk.ts
@@ -4,8 +4,7 @@ import {parseSyml, stringifySyml}                                   from '@yarnp
 import {PnpApi}                                                     from '@yarnpkg/pnp';
 import chalk                                                        from 'chalk';
 import {UsageError}                                                 from 'clipanion';
-import capitalize                                                   from 'lodash/capitalize';
-import startCase                                                    from 'lodash/startCase';
+import {capitalize, startCase}                                      from 'es-toolkit/compat';
 
 import {dynamicRequire}                                             from './dynamicRequire';
 import {BASE_SDKS}                                                  from './sdks/base';
diff --git a/yarn.config.cjs b/yarn.config.cjs
@@ -209,6 +209,7 @@ module.exports = defineConfig({
     enforceConsistentDependenciesAcrossTheProject(ctx);
     enforceWorkspaceDependenciesWhenPossible(ctx);
     forbidDependency(ctx, `inquirer`, `Don't depend on inquirer - we use enquirer instead`);
+    forbidDependency(ctx, `lodash`, `Don't depend on lodash - we use es-toolkit instead`);
     enforceDependencyRelationship(ctx, `typescript`, `tslib`, true);
     enforceUpdateLocalScripts(ctx);
     enforcePrepackScripts(ctx);
diff --git a/yarn.lock b/yarn.lock
