Update yargs 17.7.2 → 18.0.0 (major)

[depfu]

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ yargs (17.7.2 → 18.0.0) · Repo · Changelog

Release Notes

18.0.0

18.0.0 (2025-05-26)

⚠ BREAKING CHANGES

• command names are not derived from modules passed to command.
• singleton usage of yargs yargs.foo, yargs().argv, has been removed.
• minimum node.js versions now ^20.19.0 || ^22.12.0 || >=23.
• yargs is now ESM first

Features

• commandDir now works with ESM files (#2461) (27eec18)
• locale: adds hebrew translation (#2357) (4266485)
• yargs is now ESM first (d90af45)
• zsh: Add default completion as fallback (#2331) (e02c91b)

Bug Fixes

• addDirectory do not support absolute command dir (#2465) (3a40a78)
• allows ESM modules commands to be extensible using visit option (#2468) (200e1aa)
• browser: fix shims so that yargs continues working in browser context (#2457) (4ae5f57)
• build: address problems with typescript compilation (#2445) (8d72fb3)
• coerce should play well with parser configuration (#2308) (8343c66)
• deps: update dependency yargs-parser to v22 (#2470) (639130d)
• exit after async handler done (#2313) (e326cde)
• handle spaces in bash completion (#2452) (83b7788)
• parser-configuration should work well with generated completion script (#2332) (888db19)
• propagate Dictionary including undefined in value type (#2393) (2b2f7f5)
• zsh: completion no longer requires double tab when using autoloaded (0dd8fe4)

Code Refactoring

• command names are not derived from modules passed to command. (d90af45)
• singleton usage of yargs yargs.foo, yargs().argv, has been removed. (d90af45)

Build System

• minimum node.js versions now ^20.19.0 || ^22.12.0 || >=23. (d90af45)

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by 33 commits:

• chore(main): release 18.0.0 (#2325)
• fix(deps): update dependency yargs-parser to v22 (#2470)
• fix: allows ESM modules commands to be extensible using visit option (#2468)
• fix: parser-configuration should work well with generated completion script (#2332)
• fix: addDirectory do not support absolute command dir (#2465)
• docs: remove to old slack channel (#2466)
• fix(zsh): completion no longer requires double tab when using autoloaded
• feat: commandDir now works with ESM files (#2461)
• docs: update examples to run from examples folder (#2463)
• feat(zsh): Add default completion as fallback (#2331)
• docs: remove dead link in README (#2458)
• deps: align Deno yargs_parser version with package.json version. (#2306)
• fix(browser): fix shims so that yargs continues working in browser context (#2457)
• build: move `types` condition to the front where needed (#2327)
• docs: use describe rather than desc (#2373)
• deps: align browser shim version (#2350)
• fix: handle spaces in bash completion (#2452)
• docs: an example of using inquirer to prompt user (#2385)
• feat!: yargs is now ESM first
• docs: add example for objects using ENV vars (#2436)
• docs: improve readme (#2440)
• fix(build): address problems with typescript compilation (#2445)
• fix: propagate Dictionary including undefined in value type (#2393)
• doc: switch legacy .argv to .parse() (#2346)
• feat(locale): adds hebrew translation (#2357)
• chore(deps): update dependency @types/node to v20 (#2370)
• docs: fix typos in .terminalWidth example (#2382)
• fix(build): update typescript / eslint / rollup deps fixing bundling of yargs (#2384)
• docs: missing return in usage builder function (#2328)
• fix: exit after async handler done (#2313)
• fix: coerce should play well with parser configuration (#2308)
• docs: Fix example of coerce (#2316)
• build: add watch run-script

---

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@​depfu rebase

Rebases against your default branch and redoes this update

@​depfu recreate

Recreates this PR, overwriting any edits that you've made to it

@​depfu merge

Merges this PR once your tests are passing and conflicts are resolved

@​depfu cancel merge

Cancels automatic merging of this PR

@​depfu close

Closes this PR and deletes the branch

@​depfu reopen

Restores the branch and reopens this PR (if it's closed)

@​depfu pause

Ignores all future updates for this dependency and closes this PR

@​depfu pause [minor|major]

Ignores all future minor/major updates for this dependency and closes this PR

@​depfu resume

Future versions of this dependency will create PRs again (leaves this PR as is)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.03%. Comparing base (1a1dc60) to head (98b8344).
Report is 2 commits behind head on main.

Additional details and impacted files

@@ Coverage Diff @@## main #5477 +/- ##
=======================================
Coverage 86.03% 86.03% =======================================
Files 312 312 Lines 30364 30364 Branches 8296 8296 =======================================
Hits 26125 26125 Misses 3644 3644 Partials 595 595 

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[canova]

LGTM. The place we use yargs is inside the server.js file. Tested that part and it work as expected.

It looks like the major version bump removes the use of singleton usage of yargs along with some smaller changes, which we don't use.