argue-cli 2.1.0 → 3.0.0

package/README.md

@@ -1,11 +1,15 @@
 # argue-cli
 
+[![ESM-only package][package]][package-url]
 [![NPM version][npm]][npm-url]
 [![Node version][node]][node-url]
 [![Dependencies status][deps]][deps-url]
+[![Install size][size]][size-url]
 [![Build status][build]][build-url]
 [![Coverage status][coverage]][coverage-url]
-[![Bundle size][size]][size-url]
+
+[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
+[package-url]: https://nodejs.org/api/esm.html
 
 [npm]: https://img.shields.io/npm/v/argue-cli.svg
 [npm-url]: https://www.npmjs.com/package/argue-cli
@@ -14,17 +18,17 @@
 [node-url]: https://nodejs.org
 
 [deps]: https://img.shields.io/librariesio/release/npm/argue-cli
-[deps-url]: https://libraries.io/npm/argue-cli/tree
+[deps-url]: https://libraries.io/npm/argue-cli
+
+[size]: https://packagephobia.com/badge?p=argue-cli
+[size-url]: https://packagephobia.com/result?p=argue-cli
 
-[build]: https://img.shields.io/github/workflow/status/TrigenSoftware/Argue/CI.svg
+[build]: https://img.shields.io/github/actions/workflow/status/TrigenSoftware/Argue/tests.yml?branch=master
 [build-url]: https://github.com/TrigenSoftware/Argue/actions
 
 [coverage]: https://img.shields.io/codecov/c/github/TrigenSoftware/Argue.svg
 [coverage-url]: https://app.codecov.io/gh/TrigenSoftware/Argue
 
-[size]: https://img.shields.io/bundlephobia/minzip/argue-cli
-[size-url]: https://bundlephobia.com/package/argue-cli
-
 A thin and strongly typed CLI arguments parser for Node.js.
 
 ## Usage
@@ -32,10 +36,10 @@ A thin and strongly typed CLI arguments parser for Node.js.
 1. Install
 
 ```bash
-# yarn
-yarn add argue-cli
 # pnpm
 pnpm add argue-cli
+# yarn
+yarn add argue-cli
 # npm
 npm i argue-cli
 ```
@@ -80,89 +84,106 @@ end()
 
 ## API
 
-<table>
-  <thead>
-    <tr>
-      <th>Method</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-<td>
+Argue reads arguments sequentially from an internal state, which is initialized with `process.argv`. Every call consumes the arguments it reads, so you describe your CLI step by step: expect a command, read its options, read positional arguments, and finally assert the end.
+
+> [!TIP]
+> The internal state can be controlled manually with `setArgs(...args)` and `resetArgs()` — handy in tests.
+
+### read
 
 ```ts
 function read(): string
 ```
 
-</td>
-<td>
-  Read next argument. Throws error if no next argument.
-</td>
-    </tr>
-    <tr>
-<td>
+Reads the next argument and returns it. Throws an error if there are no arguments left.
+
+```ts
+// my-cli sort-imports
+const fileName = read() // 'sort-imports'
+```
+
+### end
 
 ```ts
 function end(): void
 ```
 
-</td>
-<td>
-  Expectation of the end. Throws an error if there are more arguments left.
-</td>
-    </tr>
-    <tr>
-<td>
+Asserts that all arguments were consumed. Throws an error if there are any arguments left — useful to catch typos and unexpected input.
+
+```ts
+// my-cli install --sav
+expect('install')
+readOptions(
+  option(alias('save', 'S'), Boolean)
+)
+end() // throws: Unexpected argument "--sav"
+```
+
+### expect
 
 ```ts
 function expect(...argRefs: ArgRef[]): string
 ```
 
-</td>
-<td>
-  Expect one of the given arguments.
-</td>
-    </tr>
-    <tr>
-<td>
+Expects the next argument to be one of the given ones and returns the matched name. If an [alias](#alias) matches, the main name is returned. Throws an error on any other input.
+
+The return type is inferred as a union of the given names:
+
+```ts
+// my-cli i
+const command = expect(alias('install', 'i'), 'remove')
+// typeof command: 'install' | 'remove'
+// command === 'install'
+```
+
+### alias
 
 ```ts
 function alias(name: string, ...aliases: string[]): AliasArgRef
 ```
 
-</td>
-<td>
-  Describe argument with aliases.
-</td>
-    </tr>
-    <tr>
-<td>
+Describes an argument that has alternative names. Use it anywhere an argument name is expected — in [`expect`](#expect) and [`option`](#option).
+
+```ts
+alias('install', 'i')
+alias('saveDev', 'save-dev', 'D')
+```
+
+### option
 
 ```ts
 function option(argRef: ArgRef, type: PrimitiveConstructor): OptionReader
 ```
 
-</td>
-<td>
-  Describe option with value.
-</td>
-    </tr>
-    <tr>
-<td>
+Describes an option with a value of the given type, to be read by [`readOptions`](#readoptions):
+
+- `String` — takes the next argument as a value: `--workspace packages/app`
+- `Number` — parses the next argument as a number: `--port 8080`
+- `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']`
+
+### readOptions
 
 ```ts
 function readOptions(...optionReaders: OptionReader[]): OptionResult
 ```
 
-</td>
-<td>
-  Read options from arguments.
-</td>
-    </tr>
-  </tbody>
-</table>
+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.
+
+The result is a strongly typed object, where every property is optional — an option simply may not be passed:
+
+```ts
+// my-cli --save-dev --workspace packages/app my-package
+const options = readOptions(
+  option(alias('saveDev', 'save-dev', 'D'), Boolean),
+  option('workspace', String)
+)
+// typeof options: { saveDev?: boolean, workspace?: string }
+// options: { saveDev: true, workspace: 'packages/app' }
+
+const packageName = read() // 'my-package'
+```
 
 ## TypeScript
 
-In [API section](#API) types are described in a simplified way. Detailed example of the types you can see [here](test/argue.test-d.ts).
+In the [API section](#api) types are described in a simplified way. A detailed example of the inferred types you can see in [type tests](src/types.spec.ts).

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-import { AliasArgRef, ArgRef, PrimitiveConstructor, OptionsReaderState, OptionsReaderRead, OptionResult } from './types.js';
+import type { AliasArgRef, ArgRef, PrimitiveConstructor, OptionsReaderState, OptionsReaderRead, OptionResult } from './types.js';
 /**
  * Describe argument with aliases.
  * @param name - Main name.

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,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;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"}

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { ArgRef } from './types.js';
+import type { ArgRef } from './types.js';
 /**
  * Read next argument.
  * Throws error if no next argument.

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGnC;;;;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,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.d.ts

@@ -1,4 +1,4 @@
-export * from './types.js';
+export type * from './types.js';
 export * from './argv.js';
 export * from './core.js';
 export * from './args.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -1,209 +1,181 @@
+//#region src/argv.ts
 const ARGV_START_INDEX = 2;
 /**
- * Internal state of arguments.
- */ const argv = process.argv.slice(ARGV_START_INDEX);
+* Internal state of arguments.
+*/
+const argv = process.argv.slice(ARGV_START_INDEX);
 /**
- * Reset arguments state.
- */ function resetArgs() {
-    argv.splice(0, argv.length);
-    argv.push(...process.argv.slice(ARGV_START_INDEX));
+* Reset arguments state.
+*/
+function resetArgs() {
+	argv.splice(0, argv.length);
+	argv.push(...process.argv.slice(ARGV_START_INDEX));
 }
 /**
- * Set arguments state.
- * @param args
- */ function setArgs(...args) {
-    argv.splice(0, argv.length);
-    argv.push(...args);
+* Set arguments state.
+* @param args
+*/
+function setArgs(...args) {
+	argv.splice(0, argv.length);
+	argv.push(...args);
 }
-
+//#endregion
+//#region src/utils.ts
 /**
- * Match reference with argument.
- * @param argRef
- * @param arg
- * @returns Full name or null.
- */ function matchArgName(argRef, arg) {
-    if (typeof argRef === "string") {
-        return argRef === arg ? argRef : null;
-    }
-    if (argRef.name === arg) {
-        return argRef.name;
-    }
-    return argRef.aliases.includes(arg) ? argRef.name : null;
+* Match reference with argument.
+* @param argRef
+* @param arg
+* @returns Full name or null.
+*/
+function matchArgName(argRef, arg) {
+	if (typeof argRef === "string") return argRef === arg ? argRef : null;
+	if (argRef.name === arg) return argRef.name;
+	return argRef.aliases.includes(arg) ? argRef.name : null;
 }
 /**
- * Find full argument name in references.
- * @param argRefs
- * @param arg
- * @returns Found argument's full name or null.
- */ function findArgName(argRefs, arg) {
-    let argRef;
-    let argName;
-    for (argRef of argRefs){
-        argName = matchArgName(argRef, arg);
-        if (argName) {
-            return argName;
-        }
-    }
-    return null;
+* Find full argument name in references.
+* @param argRefs
+* @param arg
+* @returns Found argument's full name or null.
+*/
+function findArgName(argRefs, arg) {
+	let argRef;
+	let argName;
+	for (argRef of argRefs) {
+		argName = matchArgName(argRef, arg);
+		if (argName) return argName;
+	}
+	return null;
 }
-
+//#endregion
+//#region src/core.ts
 /**
- * Read next argument.
- * Throws error if no next argument.
- * @returns Next argument.
- */ function read() {
-    const value = argv.shift();
-    if (!value) {
-        throw new Error("Unexpected end of arguments");
-    }
-    return value;
+* Read next argument.
+* Throws error if no next argument.
+* @returns Next argument.
+*/
+function read() {
+	const value = argv.shift();
+	if (!value) throw new Error("Unexpected end of arguments");
+	return value;
 }
 /**
- * Expectation of the end.
- * Throws an error if there are more arguments left.
- */ function end() {
-    if (argv.length) {
-        throw new Error(`Unexpected argument "${argv[0]}"`);
-    }
+* Expectation of the end.
+* Throws an error if there are more arguments left.
+*/
+function end() {
+	if (argv.length) throw new Error(`Unexpected argument "${argv[0]}"`);
 }
 /**
- * Expect one of the given arguments.
- * @param argRefs
- * @returns Expected full argument name.
- */ function expect(...argRefs) {
-    const arg = read();
-    const argName = findArgName(argRefs, arg);
-    if (!argName) {
-        throw new Error(`Unexpected argument "${arg}"`);
-    }
-    return argName;
+* Expect one of the given arguments.
+* @param argRefs
+* @returns Expected full argument name.
+*/
+function expect(...argRefs) {
+	const arg = read();
+	const argName = findArgName(argRefs, arg);
+	if (!argName) throw new Error(`Unexpected argument "${arg}"`);
+	return argName;
 }
-
+//#endregion
+//#region src/args.ts
 /**
- * Describe argument with aliases.
- * @param name - Main name.
- * @param alias - Alias name.
- * @param restAliases - Rest aliases.
- * @returns Description of argument with aliases..
- */ function alias(name, alias, ...restAliases) {
-    return {
-        name,
-        aliases: [
-            alias,
-            ...restAliases
-        ]
-    };
+* Describe argument with aliases.
+* @param name - Main name.
+* @param alias - Alias name.
+* @param restAliases - Rest aliases.
+* @returns Description of argument with aliases..
+*/
+function alias(name, alias, ...restAliases) {
+	return {
+		name,
+		aliases: [alias, ...restAliases]
+	};
 }
 /**
- * Describe option with value.
- * @param argRef - Option name.
- * @param type - Value type.
- * @returns Option reader.
- */ function option(argRef, type) {
-    if (type === String) {
-        return (option, read)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                return {
-                    [argName]: read()
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Number) {
-        return (option, read)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                return {
-                    [argName]: parseFloat(read())
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Array) {
-        return (option, read, options)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                const prevValues = options[argName];
-                const values = read().split(",");
-                return {
-                    [argName]: Array.isArray(prevValues) ? prevValues.concat(values) : values
-                };
-            }
-            return null;
-        };
-    }
-    return (option)=>{
-        const argName = matchArgName(argRef, option);
-        if (argName) {
-            return {
-                [argName]: true
-            };
-        }
-        return null;
-    };
+* Describe option with value.
+* @param argRef - Option name.
+* @param type - Value type.
+* @returns Option reader.
+*/
+function option(argRef, type) {
+	if (type === String) return (option, read) => {
+		const argName = matchArgName(argRef, option);
+		if (argName) return { [argName]: read() };
+		return null;
+	};
+	if (type === Number) return (option, read) => {
+		const argName = matchArgName(argRef, option);
+		if (argName) return { [argName]: parseFloat(read()) };
+		return null;
+	};
+	if (type === Array) return (option, read, options) => {
+		const argName = matchArgName(argRef, option);
+		if (argName) {
+			const prevValues = options[argName];
+			const values = read().split(",");
+			return { [argName]: Array.isArray(prevValues) ? prevValues.concat(values) : values };
+		}
+		return null;
+	};
+	return (option) => {
+		const argName = matchArgName(argRef, option);
+		if (argName) return { [argName]: true };
+		return null;
+	};
 }
-
+//#endregion
+//#region src/options.ts
 function isOption(arg) {
-    return /^--?[^-].*/.test(arg);
+	return /^--?[^-].*/.test(arg);
 }
 function removePrefix(arg) {
-    return arg.replace(/^--?/, "");
+	return arg.replace(/^--?/, "");
 }
 function createOptionReader(optionReaders) {
-    const optionReader = optionReaders.reduceRight((readNextOption, readOption)=>{
-        if (!readNextOption) {
-            return readOption;
-        }
-        return (option, read, options)=>readOption(option, read, options) ?? readNextOption(option, read, options);
-    }, null);
-    return optionReader;
+	return optionReaders.reduceRight((readNextOption, readOption) => {
+		if (!readNextOption) return readOption;
+		return (option, read, options) => readOption(option, read, options) ?? readNextOption(option, read, options);
+	}, null);
 }
 /**
- * Read options from arguments.
- * @param optionReaders
- * @returns Options with values.
- */ function readOptions(...optionReaders) {
-    if (!argv.length) {
-        return {};
-    }
-    const readOption = createOptionReader(optionReaders);
-    if (!readOption) {
-        return {};
-    }
-    const options = {};
-    let i = 0;
-    let arg = argv[i];
-    let optionResult;
-    const next = ()=>{
-        arg = argv[++i];
-    };
-    const remove = ()=>{
-        argv.splice(i--, 1);
-    };
-    const read = ()=>{
-        next();
-        remove();
-        if (!arg) {
-            throw new Error("Unexpected end of arguments");
-        }
-        return arg;
-    };
-    // eslint-disable-next-line no-unmodified-loop-condition
-    while(arg){
-        if (isOption(arg)) {
-            optionResult = readOption(removePrefix(arg), read, options);
-            if (optionResult) {
-                remove();
-                Object.assign(options, optionResult);
-            }
-        }
-        next();
-    }
-    return options;
+* Read options from arguments.
+* @param optionReaders
+* @returns Options with values.
+*/
+function readOptions(...optionReaders) {
+	if (!argv.length) return {};
+	const readOption = createOptionReader(optionReaders);
+	if (!readOption) return {};
+	const options = {};
+	let i = 0;
+	let arg = argv[i];
+	let optionResult;
+	const next = () => {
+		arg = argv[++i];
+	};
+	const remove = () => {
+		argv.splice(i--, 1);
+	};
+	const read = () => {
+		next();
+		remove();
+		if (!arg) throw new Error("Unexpected end of arguments");
+		return arg;
+	};
+	while (arg) {
+		if (isOption(arg)) {
+			optionResult = readOption(removePrefix(arg), read, options);
+			if (optionResult) {
+				remove();
+				Object.assign(options, optionResult);
+			}
+		}
+		next();
+	}
+	return options;
 }
-
+//#endregion
 export { alias, argv, end, expect, option, read, readOptions, resetArgs, setArgs };
-//# sourceMappingURL=index.js.map
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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 { 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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  : any\n\n// eslint-disable-next-line @typescript-eslint/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 { argv } from './argv.js'\nimport { ArgRef } from './types.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 {\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 { argv } from './argv.js'\nimport { OptionReader, OptionResult } from './types.js'\nimport { Merge, ReturnTypes, UnionMerge } from './utils.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  // eslint-disable-next-line 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"],"names":["ARGV_START_INDEX","argv","process","slice","resetArgs","splice","length","push","setArgs","args","matchArgName","argRef","arg","name","aliases","includes","findArgName","argRefs","argName","read","value","shift","Error","end","expect","alias","restAliases","option","type","String","Number","parseFloat","Array","options","prevValues","values","split","isArray","concat","isOption","test","removePrefix","replace","createOptionReader","optionReaders","optionReader","reduceRight","readNextOption","readOption","readOptions","i","optionResult","next","remove","Object","assign"],"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 * 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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"}

package/dist/options.d.ts

@@ -1,5 +1,5 @@
-import { OptionReader } from './types.js';
-import { Merge, ReturnTypes } from './utils.js';
+import type { OptionReader } from './types.js';
+import type { Merge, ReturnTypes } from './utils.js';
 /**
  * Read options from arguments.
  * @param optionReaders

package/dist/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAA;AAyB3D;;;;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;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"}

package/dist/types.d.ts

@@ -1,14 +1,14 @@
-export declare type SimpleArgRef<T extends string> = T;
+export type SimpleArgRef<T extends string> = T;
 export interface AliasArgRef<T extends string> {
     name: T;
     aliases: string[];
 }
-export declare type ArgRef<T extends string> = SimpleArgRef<T> | AliasArgRef<T>;
-export declare type ArgRefName<T extends ArgRef<string>> = T extends AliasArgRef<string> ? T['name'] : T;
-export declare type OptionsReaderState = Record<string, unknown>;
-export declare type OptionsReaderRead = () => string;
-export declare type PrimitiveConstructor = StringConstructor | NumberConstructor | ArrayConstructor | BooleanConstructor;
-export declare type OptionValueType<T extends PrimitiveConstructor> = T extends StringConstructor ? string : T extends NumberConstructor ? number : T extends ArrayConstructor ? string[] : boolean;
-export declare type OptionResult<T extends string = string, K extends PrimitiveConstructor = PrimitiveConstructor> = Record<T, OptionValueType<K>>;
-export declare type OptionReader<T extends OptionResult = OptionResult> = (option: string, read: OptionsReaderRead, options: OptionsReaderState) => T | null;
+export type ArgRef<T extends string> = SimpleArgRef<T> | AliasArgRef<T>;
+export type ArgRefName<T extends ArgRef<string>> = T extends AliasArgRef<string> ? T['name'] : T;
+export type OptionsReaderState = Record<string, unknown>;
+export type OptionsReaderRead = () => string;
+export type PrimitiveConstructor = StringConstructor | NumberConstructor | ArrayConstructor | BooleanConstructor;
+export type OptionValueType<T extends PrimitiveConstructor> = T extends StringConstructor ? string : T extends NumberConstructor ? number : T extends ArrayConstructor ? string[] : boolean;
+export type OptionResult<T extends string = string, K extends PrimitiveConstructor = PrimitiveConstructor> = Record<T, OptionValueType<K>>;
+export type OptionReader<T extends OptionResult = OptionResult> = (option: string, read: OptionsReaderRead, options: OptionsReaderState) => T | null;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAA;AAE9C,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM;IAC3C,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,oBAAY,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEvE,oBAAY,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,IAC7C,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,GACzB,CAAC,CAAC,MAAM,CAAC,GACT,CAAC,CAAA;AAEP,oBAAY,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAExD,oBAAY,iBAAiB,GAAG,MAAM,MAAM,CAAA;AAE5C,oBAAY,oBAAoB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;AAEhH,oBAAY,eAAe,CAAC,CAAC,SAAS,oBAAoB,IACxD,CAAC,SAAS,iBAAiB,GACvB,MAAM,GACN,CAAC,SAAS,iBAAiB,GACzB,MAAM,GACN,CAAC,SAAS,gBAAgB,GACxB,MAAM,EAAE,GACR,OAAO,CAAA;AAEjB,oBAAY,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,IAAI,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;AAE1I,oBAAY,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAC5D,CACE,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,KACxB,CAAC,GAAG,IAAI,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAA;AAE9C,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM;IAC3C,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEvE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,IAC7C,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,GACzB,CAAC,CAAC,MAAM,CAAC,GACT,CAAC,CAAA;AAEP,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAExD,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAA;AAE5C,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;AAEhH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,oBAAoB,IACxD,CAAC,SAAS,iBAAiB,GACvB,MAAM,GACN,CAAC,SAAS,iBAAiB,GACzB,MAAM,GACN,CAAC,SAAS,gBAAgB,GACxB,MAAM,EAAE,GACR,OAAO,CAAA;AAEjB,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,IAAI,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;AAE1I,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAC5D,CACE,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,KACxB,CAAC,GAAG,IAAI,CAAA"}

package/dist/utils.d.ts

@@ -1,11 +1,11 @@
-import { ArgRef } from './types.js';
-declare type FlatMerge<T> = T extends infer U ? {
+import type { ArgRef } from './types.js';
+type FlatMerge<T> = T extends infer U ? {
     [K in keyof U]: U[K];
 } : never;
-export declare type Merge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R] ? FlatMerge<NonNullable<L> & Merge<R>> : unknown;
-export declare type UnionMerge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R] ? L | Merge<R> : any;
-declare type AnyFunction = (...args: any[]) => any;
-export declare type ReturnTypes<T extends readonly [...AnyFunction[]]> = T extends [infer L, ...infer R] ? L extends AnyFunction ? R extends AnyFunction[] ? [ReturnType<L>, ...ReturnTypes<R>] : [] : [] : [];
+export type Merge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R] ? FlatMerge<NonNullable<L> & Merge<R>> : unknown;
+export type UnionMerge<T extends readonly [...unknown[]]> = T extends [infer L, ...infer R] ? L | Merge<R> : any;
+type AnyFunction = (...args: any[]) => any;
+export type ReturnTypes<T extends readonly [...AnyFunction[]]> = T extends [infer L, ...infer R] ? L extends AnyFunction ? R extends AnyFunction[] ? [ReturnType<L>, ...ReturnTypes<R>] : [] : [] : [];
 /**
  * Match reference with argument.
  * @param argRef

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,aAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,KAAK,CAAA;AAExE,oBAAY,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAClF,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GACpC,OAAO,CAAA;AAEX,oBAAY,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GACvF,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAEZ,GAAG,CAAA;AAGP,aAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;AAE1C,oBAAY,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAC5F,CAAC,SAAS,WAAW,GACnB,CAAC,SAAS,WAAW,EAAE,GACrB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAClC,EAAE,GACJ,EAAE,GACJ,EAAE,CAAA;AAEN;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,YAc5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,YAanF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,KAAK,CAAA;AAExE,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAClF,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GACpC,OAAO,CAAA;AAEX,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GACvF,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAEZ,GAAG,CAAA;AAGP,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;AAE1C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAC5F,CAAC,SAAS,WAAW,GACnB,CAAC,SAAS,WAAW,EAAE,GACrB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAClC,EAAE,GACJ,EAAE,GACJ,EAAE,CAAA;AAEN;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,YAc5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,YAanF"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "argue-cli",
   "type": "module",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "A thin and strongly typed CLI arguments parser for Node.js.",
   "author": "dangreen",
   "license": "MIT",
+  "funding": "https://ko-fi.com/dangreen",
   "repository": {
     "type": "git",
     "url": "https://github.com/TrigenSoftware/Argue.git"
@@ -20,19 +21,14 @@
     "terminal"
   ],
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=24"
   },
   "types": "./dist/index.d.ts",
   "exports": {
-    "import": "./dist/index.js",
-    "require": "./dist/index.cjs"
-  },
-  "publishConfig": {
-    "directory": "package"
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js"
   },
   "files": [
     "dist"
-  ],
-  "readme": "",
-  "scripts": {}
+  ]
 }

package/dist/index.cjs

@@ -1,221 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-const ARGV_START_INDEX = 2;
-/**
- * Internal state of arguments.
- */ const argv = process.argv.slice(ARGV_START_INDEX);
-/**
- * Reset arguments state.
- */ function resetArgs() {
-    argv.splice(0, argv.length);
-    argv.push(...process.argv.slice(ARGV_START_INDEX));
-}
-/**
- * Set arguments state.
- * @param args
- */ function setArgs(...args) {
-    argv.splice(0, argv.length);
-    argv.push(...args);
-}
-
-/**
- * Match reference with argument.
- * @param argRef
- * @param arg
- * @returns Full name or null.
- */ function matchArgName(argRef, arg) {
-    if (typeof argRef === "string") {
-        return argRef === arg ? argRef : null;
-    }
-    if (argRef.name === arg) {
-        return argRef.name;
-    }
-    return argRef.aliases.includes(arg) ? argRef.name : null;
-}
-/**
- * Find full argument name in references.
- * @param argRefs
- * @param arg
- * @returns Found argument's full name or null.
- */ function findArgName(argRefs, arg) {
-    let argRef;
-    let argName;
-    for (argRef of argRefs){
-        argName = matchArgName(argRef, arg);
-        if (argName) {
-            return argName;
-        }
-    }
-    return null;
-}
-
-/**
- * Read next argument.
- * Throws error if no next argument.
- * @returns Next argument.
- */ function read() {
-    const value = argv.shift();
-    if (!value) {
-        throw new Error("Unexpected end of arguments");
-    }
-    return value;
-}
-/**
- * Expectation of the end.
- * Throws an error if there are more arguments left.
- */ function end() {
-    if (argv.length) {
-        throw new Error(`Unexpected argument "${argv[0]}"`);
-    }
-}
-/**
- * Expect one of the given arguments.
- * @param argRefs
- * @returns Expected full argument name.
- */ function expect(...argRefs) {
-    const arg = read();
-    const argName = findArgName(argRefs, arg);
-    if (!argName) {
-        throw new Error(`Unexpected argument "${arg}"`);
-    }
-    return argName;
-}
-
-/**
- * Describe argument with aliases.
- * @param name - Main name.
- * @param alias - Alias name.
- * @param restAliases - Rest aliases.
- * @returns Description of argument with aliases..
- */ function alias(name, alias, ...restAliases) {
-    return {
-        name,
-        aliases: [
-            alias,
-            ...restAliases
-        ]
-    };
-}
-/**
- * Describe option with value.
- * @param argRef - Option name.
- * @param type - Value type.
- * @returns Option reader.
- */ function option(argRef, type) {
-    if (type === String) {
-        return (option, read)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                return {
-                    [argName]: read()
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Number) {
-        return (option, read)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                return {
-                    [argName]: parseFloat(read())
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Array) {
-        return (option, read, options)=>{
-            const argName = matchArgName(argRef, option);
-            if (argName) {
-                const prevValues = options[argName];
-                const values = read().split(",");
-                return {
-                    [argName]: Array.isArray(prevValues) ? prevValues.concat(values) : values
-                };
-            }
-            return null;
-        };
-    }
-    return (option)=>{
-        const argName = matchArgName(argRef, option);
-        if (argName) {
-            return {
-                [argName]: true
-            };
-        }
-        return null;
-    };
-}
-
-function isOption(arg) {
-    return /^--?[^-].*/.test(arg);
-}
-function removePrefix(arg) {
-    return arg.replace(/^--?/, "");
-}
-function createOptionReader(optionReaders) {
-    const optionReader = optionReaders.reduceRight((readNextOption, readOption)=>{
-        if (!readNextOption) {
-            return readOption;
-        }
-        return (option, read, options)=>readOption(option, read, options) ?? readNextOption(option, read, options);
-    }, null);
-    return optionReader;
-}
-/**
- * Read options from arguments.
- * @param optionReaders
- * @returns Options with values.
- */ function readOptions(...optionReaders) {
-    if (!argv.length) {
-        return {};
-    }
-    const readOption = createOptionReader(optionReaders);
-    if (!readOption) {
-        return {};
-    }
-    const options = {};
-    let i = 0;
-    let arg = argv[i];
-    let optionResult;
-    const next = ()=>{
-        arg = argv[++i];
-    };
-    const remove = ()=>{
-        argv.splice(i--, 1);
-    };
-    const read = ()=>{
-        next();
-        remove();
-        if (!arg) {
-            throw new Error("Unexpected end of arguments");
-        }
-        return arg;
-    };
-    // eslint-disable-next-line no-unmodified-loop-condition
-    while(arg){
-        if (isOption(arg)) {
-            optionResult = readOption(removePrefix(arg), read, options);
-            if (optionResult) {
-                remove();
-                Object.assign(options, optionResult);
-            }
-        }
-        next();
-    }
-    return options;
-}
-
-exports.alias = alias;
-exports.argv = argv;
-exports.end = end;
-exports.expect = expect;
-exports.option = option;
-exports.read = read;
-exports.readOptions = readOptions;
-exports.resetArgs = resetArgs;
-exports.setArgs = setArgs;
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","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 { 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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  : any\n\n// eslint-disable-next-line @typescript-eslint/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 { argv } from './argv.js'\nimport { ArgRef } from './types.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 {\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 { argv } from './argv.js'\nimport { OptionReader, OptionResult } from './types.js'\nimport { Merge, ReturnTypes, UnionMerge } from './utils.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  // eslint-disable-next-line 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"],"names":["ARGV_START_INDEX","argv","process","slice","resetArgs","splice","length","push","setArgs","args","matchArgName","argRef","arg","name","aliases","includes","findArgName","argRefs","argName","read","value","shift","Error","end","expect","alias","restAliases","option","type","String","Number","parseFloat","Array","options","prevValues","values","split","isArray","concat","isOption","test","removePrefix","replace","createOptionReader","optionReaders","optionReader","reduceRight","readNextOption","readOption","readOptions","i","optionResult","next","remove","Object","assign"],"mappings":"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"}