argue-cli 3.0.0 → 3.1.0

package/README.md

@@ -102,6 +102,23 @@ Reads the next argument and returns it. Throws an error if there are no argument
 const fileName = read() // 'sort-imports'
 ```
 
+### rest
+
+```ts
+function rest(): string[]
+```
+
+Reads all remaining arguments and returns them. Returns an empty array if there are none — unlike [`read`](#read), it never throws.
+
+```ts
+// my-cli format a.js b.js c.js
+expect('format')
+
+const files = rest() // ['a.js', 'b.js', 'c.js']
+
+end() // always passes after rest()
+```
+
 ### end
 
 ```ts
@@ -149,6 +166,22 @@ alias('install', 'i')
 alias('saveDev', 'save-dev', 'D')
 ```
 
+### autocase
+
+```ts
+function autocase(argRef: ArgRef): ArgRef
+```
+
+Describes an argument that matches both camelCase and kebab-case forms. The name can be given in either form — the twin form is added as an alias. Aliases longer than one character are autocased too. Use it anywhere an argument name is expected.
+
+```ts
+autocase('firstRelease')
+// --firstRelease and --first-release are both accepted
+
+autocase(alias('save-dev', 'D'))
+// --save-dev, --saveDev and -D
+```
+
 ### option
 
 ```ts
@@ -162,13 +195,29 @@ Describes an option with a value of the given type, to be read by [`readOptions`
 - `Boolean` — a flag without a value, `true` when present: `--verbose`
 - `Array` — splits the next argument by commas; repeated options are merged: `--plugins eslint,swc --plugins tsc` → `['eslint', 'swc', 'tsc']`
 
+### flag
+
+```ts
+function flag(argRef: ArgRef): OptionReader
+```
+
+Describes a boolean flag with `--no-*` negation support, to be read by [`readOptions`](#readoptions): `--verbose` sets `true`, `--no-verbose` sets `false`. Use `option(argRef, Boolean)` when negation is not wanted.
+
+```ts
+const options = readOptions(
+  flag(autocase('firstRelease'))
+)
+// --first-release → { firstRelease: true }
+// --no-first-release, --no-firstRelease → { firstRelease: false }
+```
+
 ### readOptions
 
 ```ts
 function readOptions(...optionReaders: OptionReader[]): OptionResult
 ```
 
-Scans the arguments and reads all described options. Both `--option` and `-o` prefixes are accepted. Arguments that don't match any described option are left untouched, so you can continue reading them afterwards.
+Scans the arguments and reads all described options. Both `--option` and `-o` prefixes are accepted, and a value can be passed either as the next argument or inline: `--workspace packages/app` and `--workspace=packages/app` are equivalent. Arguments that don't match any described option are left untouched, so you can continue reading them afterwards.
 
 The result is a strongly typed object, where every property is optional — an option simply may not be passed:
 

package/dist/args.d.ts

@@ -7,6 +7,13 @@ import type { AliasArgRef, ArgRef, PrimitiveConstructor, OptionsReaderState, Opt
  * @returns Description of argument with aliases..
  */
 export declare function alias<T extends string>(name: T, alias: string, ...restAliases: string[]): AliasArgRef<T>;
+/**
+ * Describe argument that matches both camelCase and kebab-case forms.
+ * Name and every alias longer than one character get the twin form as an alias.
+ * @param argRef - Argument name in either form.
+ * @returns Description of argument with the twin forms as aliases.
+ */
+export declare function autocase<T extends string>(argRef: ArgRef<T>): ArgRef<T>;
 /**
  * Describe option with value.
  * @param argRef - Option name.
@@ -14,4 +21,10 @@ export declare function alias<T extends string>(name: T, alias: string, ...restA
  * @returns Option reader.
  */
 export declare function option<T extends string, K extends PrimitiveConstructor>(argRef: ArgRef<T>, type: K): (option: string, read: OptionsReaderRead, options: OptionsReaderState) => OptionResult<T, K> | null;
+/**
+ * Describe boolean flag with `--no-*` negation support.
+ * @param argRef - Flag name.
+ * @returns Option reader.
+ */
+export declare function flag<T extends string>(argRef: ArgRef<T>): (option: string) => OptionResult<T, BooleanConstructor> | null;
 //# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACb,MAAM,YAAY,CAAA;AAGnB;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAKxG;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,YA8B/E,MAAM,QAAQ,iBAAiB,WAAW,kBAAkB,+BA6B/E"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACb,MAAM,YAAY,CAAA;AAGnB;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAKxG;AAUD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAuBvE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,YA8B/E,MAAM,QAAQ,iBAAiB,WAAW,kBAAkB,+BA6B/E;AAID;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,YACtC,MAAM,gDAiBvB"}

package/dist/core.d.ts

@@ -5,6 +5,11 @@ import type { ArgRef } from './types.js';
  * @returns Next argument.
  */
 export declare function read(): string;
+/**
+ * Read all remaining arguments.
+ * @returns Remaining arguments, empty array if none.
+ */
+export declare function rest(): string[];
 /**
  * Expectation of the end.
  * Throws an error if there are more arguments left.

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAIxC;;;;GAIG;AACH,wBAAgB,IAAI,WAQnB;AAED;;;GAGG;AACH,wBAAgB,GAAG,SAIlB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KASpE"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAIxC;;;;GAIG;AACH,wBAAgB,IAAI,WAQnB;AAED;;;GAGG;AACH,wBAAgB,IAAI,aAEnB;AAED;;;GAGG;AACH,wBAAgB,GAAG,SAIlB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KASpE"}

package/dist/index.js

@@ -60,6 +60,13 @@ function read() {
 	return value;
 }
 /**
+* Read all remaining arguments.
+* @returns Remaining arguments, empty array if none.
+*/
+function rest() {
+	return argv.splice(0, argv.length);
+}
+/**
 * Expectation of the end.
 * Throws an error if there are more arguments left.
 */
@@ -92,6 +99,33 @@ function alias(name, alias, ...restAliases) {
 		aliases: [alias, ...restAliases]
 	};
 }
+function caseTwin(name) {
+	return name.length > 1 ? name.includes("-") ? name.replace(/-+(.)/g, (_, char) => char.toUpperCase()) : name.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`) : name;
+}
+/**
+* Describe argument that matches both camelCase and kebab-case forms.
+* Name and every alias longer than one character get the twin form as an alias.
+* @param argRef - Argument name in either form.
+* @returns Description of argument with the twin forms as aliases.
+*/
+function autocase(argRef) {
+	let name;
+	let aliases;
+	if (typeof argRef === "string") {
+		name = argRef;
+		aliases = /* @__PURE__ */ new Set();
+	} else {
+		name = argRef.name;
+		aliases = new Set(argRef.aliases.concat(argRef.aliases.map(caseTwin)));
+	}
+	aliases.add(caseTwin(name));
+	aliases.delete(name);
+	if (!aliases.size) return argRef;
+	return {
+		name,
+		aliases: [...aliases]
+	};
+}
 /**
 * Describe option with value.
 * @param argRef - Option name.
@@ -124,6 +158,24 @@ function option(argRef, type) {
 		return null;
 	};
 }
+const NEGATION_PREFIX = "no-";
+/**
+* Describe boolean flag with `--no-*` negation support.
+* @param argRef - Flag name.
+* @returns Option reader.
+*/
+function flag(argRef) {
+	return (option) => {
+		let value = true;
+		let argName = matchArgName(argRef, option);
+		if (!argName && option.startsWith(NEGATION_PREFIX)) {
+			value = false;
+			argName = matchArgName(argRef, option.slice(3));
+		}
+		if (argName) return { [argName]: value };
+		return null;
+	};
+}
 //#endregion
 //#region src/options.ts
 function isOption(arg) {
@@ -132,6 +184,10 @@ function isOption(arg) {
 function removePrefix(arg) {
 	return arg.replace(/^--?/, "");
 }
+function splitOption(arg) {
+	const eqIndex = arg.indexOf("=");
+	return eqIndex === -1 ? [arg] : [arg.slice(0, eqIndex), arg.slice(eqIndex + 1)];
+}
 function createOptionReader(optionReaders) {
 	return optionReaders.reduceRight((readNextOption, readOption) => {
 		if (!readNextOption) return readOption;
@@ -151,13 +207,20 @@ function readOptions(...optionReaders) {
 	let i = 0;
 	let arg = argv[i];
 	let optionResult;
+	let optionEqValue;
 	const next = () => {
 		arg = argv[++i];
 	};
 	const remove = () => {
+		if (optionEqValue !== void 0) throw new Error(`Unexpected value for "${arg}"`);
 		argv.splice(i--, 1);
 	};
 	const read = () => {
+		if (optionEqValue !== void 0) {
+			const value = optionEqValue;
+			optionEqValue = void 0;
+			return value;
+		}
 		next();
 		remove();
 		if (!arg) throw new Error("Unexpected end of arguments");
@@ -165,6 +228,7 @@ function readOptions(...optionReaders) {
 	};
 	while (arg) {
 		if (isOption(arg)) {
+			[arg, optionEqValue] = splitOption(arg);
 			optionResult = readOption(removePrefix(arg), read, options);
 			if (optionResult) {
 				remove();
@@ -176,6 +240,6 @@ function readOptions(...optionReaders) {
 	return options;
 }
 //#endregion
-export { alias, argv, end, expect, option, read, readOptions, resetArgs, setArgs };
+export { alias, argv, autocase, end, expect, flag, option, read, readOptions, resetArgs, rest, setArgs };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/argv.ts","../src/utils.ts","../src/core.ts","../src/args.ts","../src/options.ts"],"sourcesContent":["\nconst ARGV_START_INDEX = 2\n\n/**\n * Internal state of arguments.\n */\nexport const argv = process.argv.slice(ARGV_START_INDEX)\n\n/**\n * Reset arguments state.\n */\nexport function resetArgs() {\n  argv.splice(0, argv.length)\n  argv.push(...process.argv.slice(ARGV_START_INDEX))\n}\n\n/**\n * Set arguments state.\n * @param args\n */\nexport function setArgs(...args: string[]) {\n  argv.splice(0, argv.length)\n  argv.push(...args)\n}\n","\nimport type { ArgRef } from './types.js'\n\ntype FlatMerge<T> = T extends infer U ? { [K in keyof U]: U[K] } : never\n\nexport type Merge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R]\n  ? FlatMerge<NonNullable<L> & Merge<R>>\n  : unknown\n\nexport type UnionMerge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R]\n  ? L | Merge<R>\n  // oxlint-disable-next-line typescript/no-explicit-any\n  : any\n\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyFunction = (...args: any[]) => any\n\nexport type ReturnTypes<T extends readonly [...AnyFunction[]]> = T extends [infer L, ...infer R]\n  ? L extends AnyFunction\n    ? R extends AnyFunction[]\n      ? [ReturnType<L>, ...ReturnTypes<R>]\n      : []\n    : []\n  : []\n\n/**\n * Match reference with argument.\n * @param argRef\n * @param arg\n * @returns Full name or null.\n */\nexport function matchArgName<T extends string>(argRef: ArgRef<T>, arg: string) {\n  if (typeof argRef === 'string') {\n    return argRef === arg\n      ? argRef\n      : null\n  }\n\n  if (argRef.name === arg) {\n    return argRef.name\n  }\n\n  return argRef.aliases.includes(arg)\n    ? argRef.name\n    : null\n}\n\n/**\n * Find full argument name in references.\n * @param argRefs\n * @param arg\n * @returns Found argument's full name or null.\n */\nexport function findArgName<T extends string>(argRefs: [...ArgRef<T>[]], arg: string) {\n  let argRef: ArgRef<T>\n  let argName: T | null\n\n  for (argRef of argRefs) {\n    argName = matchArgName(argRef, arg)\n\n    if (argName) {\n      return argName\n    }\n  }\n\n  return null\n}\n","import type { ArgRef } from './types.js'\nimport { argv } from './argv.js'\nimport { findArgName } from './utils.js'\n\n/**\n * Read next argument.\n * Throws error if no next argument.\n * @returns Next argument.\n */\nexport function read() {\n  const value = argv.shift()\n\n  if (!value) {\n    throw new Error('Unexpected end of arguments')\n  }\n\n  return value\n}\n\n/**\n * Expectation of the end.\n * Throws an error if there are more arguments left.\n */\nexport function end() {\n  if (argv.length) {\n    throw new Error(`Unexpected argument \"${argv[0]}\"`)\n  }\n}\n\n/**\n * Expect one of the given arguments.\n * @param argRefs\n * @returns Expected full argument name.\n */\nexport function expect<T extends string>(...argRefs: [...ArgRef<T>[]]) {\n  const arg = read()\n  const argName = findArgName(argRefs, arg)\n\n  if (!argName) {\n    throw new Error(`Unexpected argument \"${arg}\"`)\n  }\n\n  return argName\n}\n","import type {\n  AliasArgRef,\n  ArgRef,\n  PrimitiveConstructor,\n  OptionsReaderState,\n  OptionsReaderRead,\n  OptionResult\n} from './types.js'\nimport { matchArgName } from './utils.js'\n\n/**\n * Describe argument with aliases.\n * @param name - Main name.\n * @param alias - Alias name.\n * @param restAliases - Rest aliases.\n * @returns Description of argument with aliases..\n */\nexport function alias<T extends string>(name: T, alias: string, ...restAliases: string[]): AliasArgRef<T> {\n  return {\n    name,\n    aliases: [alias, ...restAliases]\n  }\n}\n\n/**\n * Describe option with value.\n * @param argRef - Option name.\n * @param type - Value type.\n * @returns Option reader.\n */\nexport function option<T extends string, K extends PrimitiveConstructor>(argRef: ArgRef<T>, type: K) {\n  if (type === String) {\n    return (option: string, read: OptionsReaderRead) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        return {\n          [argName]: read()\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  if (type === Number) {\n    return (option: string, read: OptionsReaderRead) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        return {\n          [argName]: parseFloat(read())\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  if (type === Array) {\n    return (option: string, read: OptionsReaderRead, options: OptionsReaderState) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        const prevValues = options[argName]\n        const values = read().split(',')\n\n        return {\n          [argName]: Array.isArray(prevValues)\n            ? prevValues.concat(values)\n            : values\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  return (option: string) => {\n    const argName = matchArgName(argRef, option)\n\n    if (argName) {\n      return {\n        [argName]: true\n      } as OptionResult<T, K>\n    }\n\n    return null\n  }\n}\n","import type {\n  OptionReader,\n  OptionResult\n} from './types.js'\nimport type {\n  Merge,\n  ReturnTypes,\n  UnionMerge\n} from './utils.js'\nimport { argv } from './argv.js'\n\nfunction isOption(arg: string) {\n  return /^--?[^-].*/.test(arg)\n}\n\nfunction removePrefix(arg: string) {\n  return arg.replace(/^--?/, '')\n}\n\nfunction createOptionReader<T extends OptionReader[]>(optionReaders: [...T]) {\n  const optionReader = optionReaders.reduceRight<OptionReader | null>(\n    (readNextOption, readOption) => {\n      if (!readNextOption) {\n        return readOption\n      }\n\n      return (option, read, options) => readOption(option, read, options) ?? readNextOption(option, read, options)\n    },\n    null\n  )\n\n  return optionReader as OptionReader<UnionMerge<ReturnTypes<T>>> | null\n}\n\n/**\n * Read options from arguments.\n * @param optionReaders\n * @returns Options with values.\n */\nexport function readOptions<T extends OptionReader[]>(...optionReaders: [...T]): Partial<Merge<ReturnTypes<T>>> {\n  if (!argv.length) {\n    return {}\n  }\n\n  const readOption = createOptionReader(optionReaders)\n\n  if (!readOption) {\n    return {}\n  }\n\n  const options = {}\n  let i = 0\n  let arg = argv[i]\n  let optionResult: OptionResult | null\n  const next = () => {\n    arg = argv[++i]\n  }\n  const remove = () => {\n    argv.splice(i--, 1)\n  }\n  const read = () => {\n    next()\n    remove()\n\n    if (!arg) {\n      throw new Error('Unexpected end of arguments')\n    }\n\n    return arg\n  }\n\n  // oxlint-disable-next-line eslint/no-unmodified-loop-condition\n  while (arg) {\n    if (isOption(arg)) {\n      optionResult = readOption(removePrefix(arg), read, options)\n\n      if (optionResult) {\n        remove()\n        Object.assign(options, optionResult)\n      }\n    }\n\n    next()\n  }\n\n  return options\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/argv.ts","../src/utils.ts","../src/core.ts","../src/args.ts","../src/options.ts"],"sourcesContent":["\nconst ARGV_START_INDEX = 2\n\n/**\n * Internal state of arguments.\n */\nexport const argv = process.argv.slice(ARGV_START_INDEX)\n\n/**\n * Reset arguments state.\n */\nexport function resetArgs() {\n  argv.splice(0, argv.length)\n  argv.push(...process.argv.slice(ARGV_START_INDEX))\n}\n\n/**\n * Set arguments state.\n * @param args\n */\nexport function setArgs(...args: string[]) {\n  argv.splice(0, argv.length)\n  argv.push(...args)\n}\n","\nimport type { ArgRef } from './types.js'\n\ntype FlatMerge<T> = T extends infer U ? { [K in keyof U]: U[K] } : never\n\nexport type Merge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R]\n  ? FlatMerge<NonNullable<L> & Merge<R>>\n  : unknown\n\nexport type UnionMerge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R]\n  ? L | Merge<R>\n  // oxlint-disable-next-line typescript/no-explicit-any\n  : any\n\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyFunction = (...args: any[]) => any\n\nexport type ReturnTypes<T extends readonly [...AnyFunction[]]> = T extends [infer L, ...infer R]\n  ? L extends AnyFunction\n    ? R extends AnyFunction[]\n      ? [ReturnType<L>, ...ReturnTypes<R>]\n      : []\n    : []\n  : []\n\n/**\n * Match reference with argument.\n * @param argRef\n * @param arg\n * @returns Full name or null.\n */\nexport function matchArgName<T extends string>(argRef: ArgRef<T>, arg: string) {\n  if (typeof argRef === 'string') {\n    return argRef === arg\n      ? argRef\n      : null\n  }\n\n  if (argRef.name === arg) {\n    return argRef.name\n  }\n\n  return argRef.aliases.includes(arg)\n    ? argRef.name\n    : null\n}\n\n/**\n * Find full argument name in references.\n * @param argRefs\n * @param arg\n * @returns Found argument's full name or null.\n */\nexport function findArgName<T extends string>(argRefs: [...ArgRef<T>[]], arg: string) {\n  let argRef: ArgRef<T>\n  let argName: T | null\n\n  for (argRef of argRefs) {\n    argName = matchArgName(argRef, arg)\n\n    if (argName) {\n      return argName\n    }\n  }\n\n  return null\n}\n","import type { ArgRef } from './types.js'\nimport { argv } from './argv.js'\nimport { findArgName } from './utils.js'\n\n/**\n * Read next argument.\n * Throws error if no next argument.\n * @returns Next argument.\n */\nexport function read() {\n  const value = argv.shift()\n\n  if (!value) {\n    throw new Error('Unexpected end of arguments')\n  }\n\n  return value\n}\n\n/**\n * Read all remaining arguments.\n * @returns Remaining arguments, empty array if none.\n */\nexport function rest() {\n  return argv.splice(0, argv.length)\n}\n\n/**\n * Expectation of the end.\n * Throws an error if there are more arguments left.\n */\nexport function end() {\n  if (argv.length) {\n    throw new Error(`Unexpected argument \"${argv[0]}\"`)\n  }\n}\n\n/**\n * Expect one of the given arguments.\n * @param argRefs\n * @returns Expected full argument name.\n */\nexport function expect<T extends string>(...argRefs: [...ArgRef<T>[]]) {\n  const arg = read()\n  const argName = findArgName(argRefs, arg)\n\n  if (!argName) {\n    throw new Error(`Unexpected argument \"${arg}\"`)\n  }\n\n  return argName\n}\n","import type {\n  AliasArgRef,\n  ArgRef,\n  PrimitiveConstructor,\n  OptionsReaderState,\n  OptionsReaderRead,\n  OptionResult\n} from './types.js'\nimport { matchArgName } from './utils.js'\n\n/**\n * Describe argument with aliases.\n * @param name - Main name.\n * @param alias - Alias name.\n * @param restAliases - Rest aliases.\n * @returns Description of argument with aliases..\n */\nexport function alias<T extends string>(name: T, alias: string, ...restAliases: string[]): AliasArgRef<T> {\n  return {\n    name,\n    aliases: [alias, ...restAliases]\n  }\n}\n\nfunction caseTwin(name: string) {\n  return name.length > 1\n    ? name.includes('-')\n      ? name.replace(/-+(.)/g, (_, char: string) => char.toUpperCase())\n      : name.replace(/[A-Z]/g, char => `-${char.toLowerCase()}`)\n    : name\n}\n\n/**\n * Describe argument that matches both camelCase and kebab-case forms.\n * Name and every alias longer than one character get the twin form as an alias.\n * @param argRef - Argument name in either form.\n * @returns Description of argument with the twin forms as aliases.\n */\nexport function autocase<T extends string>(argRef: ArgRef<T>): ArgRef<T> {\n  let name\n  let aliases\n\n  if (typeof argRef === 'string') {\n    name = argRef\n    aliases = new Set<string>()\n  } else {\n    name = argRef.name\n    aliases = new Set(argRef.aliases.concat(argRef.aliases.map(caseTwin)))\n  }\n\n  aliases.add(caseTwin(name))\n  aliases.delete(name)\n\n  if (!aliases.size) {\n    return argRef\n  }\n\n  return {\n    name,\n    aliases: [...aliases]\n  }\n}\n\n/**\n * Describe option with value.\n * @param argRef - Option name.\n * @param type - Value type.\n * @returns Option reader.\n */\nexport function option<T extends string, K extends PrimitiveConstructor>(argRef: ArgRef<T>, type: K) {\n  if (type === String) {\n    return (option: string, read: OptionsReaderRead) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        return {\n          [argName]: read()\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  if (type === Number) {\n    return (option: string, read: OptionsReaderRead) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        return {\n          [argName]: parseFloat(read())\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  if (type === Array) {\n    return (option: string, read: OptionsReaderRead, options: OptionsReaderState) => {\n      const argName = matchArgName(argRef, option)\n\n      if (argName) {\n        const prevValues = options[argName]\n        const values = read().split(',')\n\n        return {\n          [argName]: Array.isArray(prevValues)\n            ? prevValues.concat(values)\n            : values\n        } as OptionResult<T, K>\n      }\n\n      return null\n    }\n  }\n\n  return (option: string) => {\n    const argName = matchArgName(argRef, option)\n\n    if (argName) {\n      return {\n        [argName]: true\n      } as OptionResult<T, K>\n    }\n\n    return null\n  }\n}\n\nconst NEGATION_PREFIX = 'no-'\n\n/**\n * Describe boolean flag with `--no-*` negation support.\n * @param argRef - Flag name.\n * @returns Option reader.\n */\nexport function flag<T extends string>(argRef: ArgRef<T>) {\n  return (option: string) => {\n    let value = true\n    let argName = matchArgName(argRef, option)\n\n    if (!argName && option.startsWith(NEGATION_PREFIX)) {\n      value = false\n      argName = matchArgName(argRef, option.slice(NEGATION_PREFIX.length))\n    }\n\n    if (argName) {\n      return {\n        [argName]: value\n      } as OptionResult<T, BooleanConstructor>\n    }\n\n    return null\n  }\n}\n","import type {\n  OptionReader,\n  OptionResult\n} from './types.js'\nimport type {\n  Merge,\n  ReturnTypes,\n  UnionMerge\n} from './utils.js'\nimport { argv } from './argv.js'\n\nfunction isOption(arg: string) {\n  return /^--?[^-].*/.test(arg)\n}\n\nfunction removePrefix(arg: string) {\n  return arg.replace(/^--?/, '')\n}\n\nfunction splitOption(arg: string): [name: string, value?: string] {\n  const eqIndex = arg.indexOf('=')\n\n  return eqIndex === -1\n    ? [arg]\n    : [arg.slice(0, eqIndex), arg.slice(eqIndex + 1)]\n}\n\nfunction createOptionReader<T extends OptionReader[]>(optionReaders: [...T]) {\n  const optionReader = optionReaders.reduceRight<OptionReader | null>(\n    (readNextOption, readOption) => {\n      if (!readNextOption) {\n        return readOption\n      }\n\n      return (option, read, options) => readOption(option, read, options) ?? readNextOption(option, read, options)\n    },\n    null\n  )\n\n  return optionReader as OptionReader<UnionMerge<ReturnTypes<T>>> | null\n}\n\n/**\n * Read options from arguments.\n * @param optionReaders\n * @returns Options with values.\n */\nexport function readOptions<T extends OptionReader[]>(...optionReaders: [...T]): Partial<Merge<ReturnTypes<T>>> {\n  if (!argv.length) {\n    return {}\n  }\n\n  const readOption = createOptionReader(optionReaders)\n\n  if (!readOption) {\n    return {}\n  }\n\n  const options = {}\n  let i = 0\n  let arg = argv[i]\n  let optionResult: OptionResult | null\n  let optionEqValue: string | undefined\n  const next = () => {\n    arg = argv[++i]\n  }\n  const remove = () => {\n    if (optionEqValue !== undefined) {\n      throw new Error(`Unexpected value for \"${arg}\"`)\n    }\n\n    argv.splice(i--, 1)\n  }\n  const read = () => {\n    if (optionEqValue !== undefined) {\n      const value = optionEqValue\n\n      optionEqValue = undefined\n\n      return value\n    }\n\n    next()\n    remove()\n\n    if (!arg) {\n      throw new Error('Unexpected end of arguments')\n    }\n\n    return arg\n  }\n\n  // oxlint-disable-next-line eslint/no-unmodified-loop-condition\n  while (arg) {\n    if (isOption(arg)) {\n      [arg, optionEqValue] = splitOption(arg)\n      optionResult = readOption(removePrefix(arg), read, options)\n\n      if (optionResult) {\n        remove()\n        Object.assign(options, optionResult)\n      }\n    }\n\n    next()\n  }\n\n  return options\n}\n"],"mappings":"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"}

package/dist/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EAEZ,MAAM,YAAY,CAAA;AA0BnB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CA+C9G"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EAEZ,MAAM,YAAY,CAAA;AAkCnB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CA6D9G"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "argue-cli",
   "type": "module",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "A thin and strongly typed CLI arguments parser for Node.js.",
   "author": "dangreen",
   "license": "MIT",
@@ -21,7 +21,7 @@
     "terminal"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=22"
   },
   "types": "./dist/index.d.ts",
   "exports": {