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)

17.7.2 (2023-04-27)

Bug Fixes

• do not crash completion when having negated options (#2322) (7f42848)

17.7.1 (2023-02-21)

Bug Fixes

• address display bug with default sub-commands (#2303) (9aa2490)

17.7.0 (2023-02-13)

Features

• add method to hide option extras (#2156) (2c144c4)
• convert line break to whitespace for the description of the option (#2271) (4cb41dc)

Bug Fixes

• copy the description of the option to its alias in completion (#2269) (f37ee6f)

17.6.2 (2022-11-03)

Bug Fixes

• deps: update dependency yargs-parser to v21.1.1 (#2231) (75b4d52)
• lang: typo in Finnish unknown argument singular form (#2222) (a6dfd0a)

17.6.1 (2022-11-02)

Bug Fixes

• lang: fix "Not enough non-option arguments" message for the Czech language (#2242) (3987b13)

17.6.0 (2022-10-01)

Features

• lang: Czech locale (#2220) (5895cf1)
• usage: add YARGS_DISABLE_WRAP env variable to disable wrap (#2210) (b680ace)

Bug Fixes

• deno: use 'globalThis' instead of 'window' (#2186) (#2215) (561fc7a)
• deps: cliui with forced strip-ansi update (#2241) (38e8df1)
• dont clobber description for multiple option calls (#2171) (f91d9b3)
• typescript: address warning with objectKeys (394f5f8)

17.5.1 (2022-05-16)

Bug Fixes

• add missing entries to published files (#2185) (5685382)
• address bug when strict and async middleware used together (#2164) (cbc2eb7)
• completion: correct zsh installation instructions (22e9af2)
• handle multiple node_modules folders determining mainFilename for ESM (#2123) (e0823dd)
• lang: add missing terms to Russian translation (#2181) (1c331f2)
• prevent infinite loop with empty locale (#2179) (b672e70)
• veriadic arguments override array provided in config (the same as multiple dash arguments). (4dac5b8)

17.5.0 (2022-05-11)

Features

• add browser.d.ts and check for existence of Error.captureStackTrace() (#2144) (6192990)

Bug Fixes

• completion: support for default flags (db35423)
• import yargs/yargs in esm projects (#2151) (95aed1c)

17.4.1 (2022-04-09)

Bug Fixes

• coerce pollutes argv (#2161) (2d1136d)
• completion: don't show positional args choices with option choices (#2148) (b58b5bc)
• hide hidden options from completion (#2143) (e086dfa), closes #2142
• show message when showHelpOnFail is chained globally (#2154) (ad9fcac)