meow

• Add helpIndent option (#241) e9a55cd

v13.1.0...v13.2.0

• Remove hardRejection option 99fe7a6
  • It's the default behavior in Node.js since Node.js 16.

v13.0.0...v13.1.0

Breaking

• Require Node.js 18 2ecd29d

Improvements

• Update dependencies 2ecd29d

v12.1.1...v13.0.0

• Fix TypeScript types (#245) 8a4cecd

v12.1.0...v12.1.1

• Bundle dependencies (#242) 41e628c
  • meow is now dependency-less!

v12.0.1...v12.1.0

• Fix flag default values validation (#238) c3bf62b

v12.0.0...v12.0.1

Breaking

• Require Node.js 16 (#235) 24d5e9c
• Rename alias flag option to shortFlag (#225) 14e870d
  • Short flag is a more correct term for what alias was previously used for. We now have a separate aliases option for actual aliases.
• As a reminder, Meow continues to require ESM. For TypeScript users, this includes having "module": "node16", "moduleResolution": "node16" in your tsconfig.

Improvements

• Add aliases flag option (#226) 901b9fc
• Add choices flag option (#228) 149d7af
• Add error when flag.default isn't a valid choice (#231) b2d7ce7
• Don't indent single line help / description text (#232) a5d15e8

---

Thanks to @tommy-mitchell for doing most of the work on this release 🙌

---

v11.0.0...v12.0.0

Breaking

• Require Node.js 14 01cf2a5

Improvements

• Improve TypeScript types (#218) 6c57fc8

v10.1.5...v11.0.0

• Fix for custom config for help (#217) d0dc0d7

https://github.com/sindresorhus/meow/compare/v10.1.4...v10.1.5

• Fix autoHelp and autoVersion with allowUnknownFlags set to false (#215) 25a0903

https://github.com/sindresorhus/meow/compare/v10.1.3...v10.1.4

• Fix return type for .showHelp() (#213) db55316

https://github.com/sindresorhus/meow/compare/v10.1.2...v10.1.3

• Fix engines field (#203) 1368ae0

https://github.com/sindresorhus/meow/compare/v10.1.1...v10.1.2

• Fix failure with isMultiple when isRequired function returns false (#194) e1f0e24

https://github.com/sindresorhus/meow/compare/v10.1.0...v10.1.1

• Upgrade dependencies 829aab0
• Allow default property of Flag types to accept arrays (#190) ae73466

https://github.com/sindresorhus/meow/compare/v10.0.1...v10.1.0

• Upgrade dependencies (#185) a0daf20

https://github.com/sindresorhus/meow/compare/v10.0.0...v10.0.1

Breaking

• Require Node.js 12 (#181) 05320ac
• This package is now pure ESM. Please read this.
• You must now pass in the importMeta option so meow can find your package.json:

 const cli = meow(…, {
+	importMeta: import.meta
 });

Previously, meow used some tricks to infer the location of your package.json, but this no longer works in ESM.

https://github.com/sindresorhus/meow/compare/v9.0.0...v10.0.0

Breaking

• Strictly validate flag config (#168) 1609709 This is a breaking change if you incorrectly used kebab-case format for flags (was never officially supported) in the meow config:

 meow(``, {
 	flags: {
-		'foo-bar': {
+		fooBar: {
 			type: 'boolean'
 		}
 	}
 });

https://github.com/sindresorhus/meow/compare/v8.1.0...v9.0.0

• Fix reporting missing required flags (#168) 1609709

https://github.com/sindresorhus/meow/compare/v8.1.0...v8.1.1

• Add allowUnknownFlags options (#169) a27ff12

https://github.com/sindresorhus/meow/compare/v8.0.0...v8.1.0

Breaking

• Default isMultiple option to empty array (#163) 14924de
• Make isMultiple option non-greedy (#162) 49ce74d

Fixes

• Gracefully handle package.json not being found (#167) ef7ae5d

https://github.com/sindresorhus/meow/compare/v7.1.1...v8.0.0

• Fix compatibility with vercel/ncc (#159) 71d640e

https://github.com/sindresorhus/meow/compare/v7.1.0...v7.1.1

• Improve flags option TypeScript types to acknowledge isMultiple and isRequired options (#154) e38789f

https://github.com/sindresorhus/meow/compare/v7.0.1...v7.1.0

• Fix isMultiple not handling multi-word flags (#150) e08eb4d

https://github.com/sindresorhus/meow/compare/v7.0.0...v7.0.1

Breaking

• Require Node.js 10 ea3fd99

Improvements

• Add isRequired flag option (#141) 1eede6a
• Add isMultiple flag option (#143) c4c5ee2

https://github.com/sindresorhus/meow/compare/v6.1.1...v7.0.0

• Update dependencies f85b546

https://github.com/sindresorhus/meow/compare/v6.1.0...v6.1.1

• Update yargs-parser dependency (#137) 4527b45

https://github.com/sindresorhus/meow/compare/v6.0.1...v6.1.0

• Improve the TypeScript types (#135) 16640f1

https://github.com/sindresorhus/meow/compare/v6.0.0...v6.0.1

Breaking

• Require Node.js 8 cd635d4
• Remove flag's aliases from the flags property (#108) f36715c
• Only consider enabling autoHelp/autoVersion in case there is only one argument in process.argv (#114) cd29865
• Switch from loud-rejection to hard-rejection f60c26e

Enhancements

• Add TypeScript definition (#116) f1036df
• Add support for number flag type (#103) 5ef9478
• Add hardRejection option 2bcfee7

https://github.com/sindresorhus/meow/compare/v5.0.0...v6.0.0

• Drops support for Node.js 4
• Switches the argument parser from minimist, which is no longer maintained, to yargs-parser. It should be fully compatible, but let us know if something breaks.
• Add booleanDefault option. https://github.com/sindresorhus/meow/commit/09f7ef0e427d30741d57f4a3918b133c39a7d30f

https://github.com/sindresorhus/meow/compare/v4.0.1...v5.0.0

Meow 4 is finally out ✨

Highlights

• Requires Node.js 4 or higher.
• Changed how minimist options are specified. (See more below) https://github.com/sindresorhus/meow/commit/43401c39ee442db308288f50d6f213cd0e6e602c https://github.com/sindresorhus/meow/commit/554119b0af09cb33aea4e709c0572043cd00586d
• Disabled type inference by default. It can lead to some surprising behavior. Can be enabled again with the inferType option. https://github.com/sindresorhus/meow/commit/1662881674c6b243226314e35d46115ea66329ff
• Removed support for using an array in the help option. Just use a template literal. https://github.com/sindresorhus/meow/commit/c80321d2ec6733d502335edb29d173f12bbf1111
• Removed support for the pkg option accepting a string. https://github.com/sindresorhus/meow/commit/2d4d89043c41030d60ee9eb5130a4fa62935ca37
• Removed support for setting the help and version options to false. Instead, use the new autoHelp and autoVersion options. https://github.com/sindresorhus/meow/commit/59dda7a9caf8400ce602d2b1cf663aa1b35bdfca
• Uses exit code 2 when manually calling cli.showHelp() now. https://github.com/sindresorhus/meow/commit/6a32bbc3acc9c41068234d80188e9d2e865f50fa

https://github.com/sindresorhus/meow/compare/v3.7.0...v4.0.0

Changed how minimist options are specified

In Meow v3 you specified minimist options top-level just like documented in the minimist readme. Now you specify them in a flags option, grouped by flag name instead of option type.

Before

const cli = meow(
	`
		Help text
	`,
	{
		boolean: [
			'unicorn'
		],
		string: [
			'fooBar'
		],
		alias: {
			u: 'unicorn'
		},
		default: {
			foobar: 'foo'
		}
	}
});

After

const cli = meow(
	`
		Help text
	`,
	flags: {
		unicorn: {
			type: 'boolean',
			alias: 'u'
		},
		fooBar: {
			type: 'string',
			default: 'foo'
		}
	}
});

I would strongly recommend specifying the type property whenever possible to reduce CLI argument parsing ambiguity.