argue-cli 2.0.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,28 +18,28 @@
 [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
 
-[build]: https://img.shields.io/github/workflow/status/TrigenSoftware/Argue/CI.svg
-[build-url]: https://github.com/TrigenSoftware/Argue/actions
+[size]: https://packagephobia.com/badge?p=argue-cli
+[size-url]: https://packagephobia.com/result?p=argue-cli
 
-[coverage]: https://img.shields.io/coveralls/TrigenSoftware/Argue.svg
-[coverage-url]: https://coveralls.io/r/TrigenSoftware/Argue
+[build]: https://img.shields.io/github/actions/workflow/status/TrigenSoftware/Argue/tests.yml?branch=master
+[build-url]: https://github.com/TrigenSoftware/Argue/actions
 
-[size]: https://img.shields.io/bundlephobia/minzip/argue-cli
-[size-url]: https://bundlephobia.com/package/argue-cli
+[coverage]: https://img.shields.io/codecov/c/github/TrigenSoftware/Argue.svg
+[coverage-url]: https://app.codecov.io/gh/TrigenSoftware/Argue
 
-A thin and strongly typed CLI argument parser for Node.js.
+A thin and strongly typed CLI arguments parser for Node.js.
 
 ## Usage
 
 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';
+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,SAAS,CAAA;AAGhB;;;;;;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';
+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,SAAS,CAAA;AAGhC;;;;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,6 +1,6 @@
-export * from './types';
-export * from './argv';
-export * from './core';
-export * from './args';
-export * from './options';
+export type * from './types.js';
+export * from './argv.js';
+export * from './core.js';
+export * from './args.js';
+export * from './options.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,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,210 +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, alias1, ...restAliases) {
-    return {
-        name,
-        aliases: [
-            alias1,
-            ...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 (option1, read)=>{
-            const argName = matchArgName(argRef, option1);
-            if (argName) {
-                return {
-                    [argName]: read()
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Number) {
-        return (option2, read)=>{
-            const argName = matchArgName(argRef, option2);
-            if (argName) {
-                return {
-                    [argName]: parseFloat(read())
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Array) {
-        return (option3, read, options)=>{
-            const argName = matchArgName(argRef, option3);
-            if (argName) {
-                const prevValues = options[argName];
-                const values = read().split(',');
-                return {
-                    [argName]: Array.isArray(prevValues) ? prevValues.concat(values) : values
-                };
-            }
-            return null;
-        };
-    }
-    return (option4)=>{
-        const argName = matchArgName(argRef, option4);
-        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'\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'\nimport { ArgRef } from './types'\nimport { findArgName } from './utils'\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'\nimport { matchArgName } from './utils'\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'\nimport { OptionReader, OptionResult } from './types'\nimport { Merge, ReturnTypes, UnionMerge } from './utils'\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';
-import { Merge, ReturnTypes } from './utils';
+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,SAAS,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAc,MAAM,SAAS,CAAA;AAyBxD;;;;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';
-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,SAAS,CAAA;AAEhC,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.0.0",
-  "description": "A thin and strongly typed CLI argument parser for Node.js.",
+  "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"
@@ -12,24 +13,6 @@
   "bugs": {
     "url": "https://github.com/TrigenSoftware/Argue/issues"
   },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
-  "publishConfig": {
-    "main": "./dist/index.cjs",
-    "module": "./dist/index.js",
-    "exports": {
-      "import": {
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "default": "./dist/index.cjs"
-      }
-    },
-    "directory": "package"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  },
   "keywords": [
     "cli",
     "arguments",
@@ -37,18 +20,15 @@
     "console",
     "terminal"
   ],
+  "engines": {
+    "node": ">=24"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js"
+  },
   "files": [
     "dist"
-  ],
-  "readme": "",
-  "scripts": {},
-  "module": "./dist/index.js",
-  "exports": {
-    "import": {
-      "default": "./dist/index.js"
-    },
-    "require": {
-      "default": "./dist/index.cjs"
-    }
-  }
+  ]
 }

package/dist/index.cjs

@@ -1,223 +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, alias1, ...restAliases) {
-    return {
-        name,
-        aliases: [
-            alias1,
-            ...restAliases
-        ]
-    };
-}
-/**
- * Describe option with value.
- * @param argRef - Option name.
- * @param type - Value type.
- * @returns Option reader.
- */ function option(argRef, type) {
-    if (type === String) {
-        return (option1, read)=>{
-            const argName = matchArgName(argRef, option1);
-            if (argName) {
-                return {
-                    [argName]: read()
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Number) {
-        return (option2, read)=>{
-            const argName = matchArgName(argRef, option2);
-            if (argName) {
-                return {
-                    [argName]: parseFloat(read())
-                };
-            }
-            return null;
-        };
-    }
-    if (type === Array) {
-        return (option3, read, options)=>{
-            const argName = matchArgName(argRef, option3);
-            if (argName) {
-                const prevValues = options[argName];
-                const values = read().split(',');
-                return {
-                    [argName]: Array.isArray(prevValues) ? prevValues.concat(values) : values
-                };
-            }
-            return null;
-        };
-    }
-    return (option4)=>{
-        const argName = matchArgName(argRef, option4);
-        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;
-        }
-        var ref;
-        return (option, read, options)=>(ref = readOption(option, read, options)) !== null && ref !== void 0 ? ref : 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'\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'\nimport { ArgRef } from './types'\nimport { findArgName } from './utils'\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'\nimport { matchArgName } from './utils'\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'\nimport { OptionReader, OptionResult } from './types'\nimport { Merge, ReturnTypes, UnionMerge } from './utils'\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":";;;;AACA,MAAMA,gBAAgB,GAAG,CAAC;AAE1B;;IAGY,MAACC,IAAI,GAAGC,OAAO,CAACD,IAAI,CAACE,KAAK,CAACH,gBAAgB;AAEvD;;aAGgBI,SAAS,GAAG;IAC1BH,IAAI,CAACI,MAAM,CAAC,CAAC,EAAEJ,IAAI,CAACK,MAAM;IAC1BL,IAAI,CAACM,IAAI,IAAIL,OAAO,CAACD,IAAI,CAACE,KAAK,CAACH,gBAAgB;AAClD,CAAC;AAED;;;aAIgBQ,OAAO,IAAIC,IAAI,EAAY;IACzCR,IAAI,CAACI,MAAM,CAAC,CAAC,EAAEJ,IAAI,CAACK,MAAM;IAC1BL,IAAI,CAACM,IAAI,IAAIE,IAAI;AACnB;;ACEA;;;;;aAMgBC,YAAY,CAAmBC,MAAiB,EAAEC,GAAW,EAAE;IAC7E,IAAI,OAAOD,MAAM,KAAK,UAAU;QAC9B,OAAOA,MAAM,KAAKC,GAAG,GACjBD,MAAM,GACN,IAAI;KACT;IAED,IAAIA,MAAM,CAACE,IAAI,KAAKD,GAAG,EAAE;QACvB,OAAOD,MAAM,CAACE,IAAI;KACnB;IAED,OAAOF,MAAM,CAACG,OAAO,CAACC,QAAQ,CAACH,GAAG,IAC9BD,MAAM,CAACE,IAAI,GACX,IAAI;AACV,CAAC;AAED;;;;;aAMgBG,WAAW,CAAmBC,OAAyB,EAAEL,GAAW,EAAE;IACpF,IAAID,MAAM;IACV,IAAIO,OAAO;IAEX,KAAKP,MAAM,IAAIM,OAAO,CAAE;QACtBC,OAAO,GAAGR,YAAY,CAACC,MAAM,EAAEC,GAAG;QAElC,IAAIM,OAAO,EAAE;YACX,OAAOA,OAAO;SACf;KACF;IAED,OAAO,IAAI;AACb;;AC9DA;;;;aAKgBC,IAAI,GAAG;IACrB,MAAMC,KAAK,GAAGnB,IAAI,CAACoB,KAAK;IAExB,KAAKD,KAAK,EAAE;QACV,MAAM,IAAIE,KAAK,CAAC;KACjB;IAED,OAAOF,KAAK;AACd,CAAC;AAED;;;aAIgBG,GAAG,GAAG;IACpB,IAAItB,IAAI,CAACK,MAAM,EAAE;QACf,MAAM,IAAIgB,KAAK,EAAE,qBAAqB,EAAErB,IAAI,CAAC,CAAC,EAAE,CAAC;KAClD;AACH,CAAC;AAED;;;;aAKgBuB,MAAM,IAAsBP,OAAO,EAAoB;IACrE,MAAML,GAAG,GAAGO,IAAI;IAChB,MAAMD,OAAO,GAAGF,WAAW,CAACC,OAAO,EAAEL,GAAG;IAExC,KAAKM,OAAO,EAAE;QACZ,MAAM,IAAII,KAAK,EAAE,qBAAqB,EAAEV,GAAG,CAAC,CAAC;KAC9C;IAED,OAAOM,OAAO;AAChB;;ACjCA;;;;;;aAOgBO,KAAK,CAAmBZ,IAAO,EAAEY,MAAa,KAAKC,WAAW,EAA4B;IACxG,OAAO;QACLb,IAAI;QACJC,OAAO,EAAE;YAACW,MAAK;eAAKC,WAAW;SAAC;KACjC;AACH,CAAC;AAED;;;;;aAMgBC,MAAM,CAAmDhB,MAAiB,EAAEiB,IAAO,EAAE;IACnG,IAAIA,IAAI,KAAKC,MAAM,EAAE;QACnB,QAAQF,OAAc,EAAER,IAAuB,GAAK;YAClD,MAAMD,OAAO,GAAGR,YAAY,CAACC,MAAM,EAAEgB,OAAM;YAE3C,IAAIT,OAAO,EAAE;gBACX,OAAO;qBACJA,OAAO,GAAGC,IAAI;iBAChB;aACF;YAED,OAAO,IAAI;SACZ;KACF;IAED,IAAIS,IAAI,KAAKE,MAAM,EAAE;QACnB,QAAQH,OAAc,EAAER,IAAuB,GAAK;YAClD,MAAMD,OAAO,GAAGR,YAAY,CAACC,MAAM,EAAEgB,OAAM;YAE3C,IAAIT,OAAO,EAAE;gBACX,OAAO;qBACJA,OAAO,GAAGa,UAAU,CAACZ,IAAI;iBAC3B;aACF;YAED,OAAO,IAAI;SACZ;KACF;IAED,IAAIS,IAAI,KAAKI,KAAK,EAAE;QAClB,QAAQL,OAAc,EAAER,IAAuB,EAAEc,OAA2B,GAAK;YAC/E,MAAMf,OAAO,GAAGR,YAAY,CAACC,MAAM,EAAEgB,OAAM;YAE3C,IAAIT,OAAO,EAAE;gBACX,MAAMgB,UAAU,GAAGD,OAAO,CAACf,OAAO;gBAClC,MAAMiB,MAAM,GAAGhB,IAAI,GAAGiB,KAAK,CAAC;gBAE5B,OAAO;qBACJlB,OAAO,GAAGc,KAAK,CAACK,OAAO,CAACH,UAAU,IAC/BA,UAAU,CAACI,MAAM,CAACH,MAAM,IACxBA,MAAM;iBACX;aACF;YAED,OAAO,IAAI;SACZ;KACF;IAED,QAAQR,OAAc,GAAK;QACzB,MAAMT,OAAO,GAAGR,YAAY,CAACC,MAAM,EAAEgB,OAAM;QAE3C,IAAIT,OAAO,EAAE;YACX,OAAO;iBACJA,OAAO,GAAG,IAAI;aAChB;SACF;QAED,OAAO,IAAI;KACZ;AACH;;SCrFSqB,QAAQ,CAAC3B,GAAW,EAAE;IAC7B,oBAAoB4B,IAAI,CAAC5B,GAAG;AAC9B,CAAC;SAEQ6B,YAAY,CAAC7B,GAAW,EAAE;IACjC,OAAOA,GAAG,CAAC8B,OAAO,SAAS;AAC7B,CAAC;SAEQC,kBAAkB,CAA2BC,aAAqB,EAAE;IAC3E,MAAMC,YAAY,GAAGD,aAAa,CAACE,WAAW,EAC3CC,cAAc,EAAEC,UAAU,GAAK;QAC9B,KAAKD,cAAc,EAAE;YACnB,OAAOC,UAAU;SAClB;YAEiCA,GAAiC;QAAnE,QAAQrB,MAAM,EAAER,IAAI,EAAEc,OAAO,IAAKe,GAAiC,GAAjCA,UAAU,CAACrB,MAAM,EAAER,IAAI,EAAEc,OAAO,eAAhCe,GAAiC,cAAjCA,GAAiC,GAAID,cAAc,CAACpB,MAAM,EAAER,IAAI,EAAEc,OAAO;;KAC5G,EACD,IAAI;IAGN,OAAOY,YAAY;AACrB,CAAC;AAED;;;;aAKgBI,WAAW,IAA8BL,aAAa,EAA0C;IAC9G,KAAK3C,IAAI,CAACK,MAAM,EAAE;QAChB,OAAO,EAAE;KACV;IAED,MAAM0C,UAAU,GAAGL,kBAAkB,CAACC,aAAa;IAEnD,KAAKI,UAAU,EAAE;QACf,OAAO,EAAE;KACV;IAED,MAAMf,OAAO,GAAG,EAAE;IAClB,IAAIiB,CAAC,GAAG,CAAC;IACT,IAAItC,GAAG,GAAGX,IAAI,CAACiD,CAAC;IAChB,IAAIC,YAAY;IAChB,MAAMC,IAAI,OAAS;QACjBxC,GAAG,GAAGX,IAAI,GAAGiD,CAAC;KACf;IACD,MAAMG,MAAM,OAAS;QACnBpD,IAAI,CAACI,MAAM,CAAC6C,CAAC,IAAI,CAAC;KACnB;IACD,MAAM/B,IAAI,OAAS;QACjBiC,IAAI;QACJC,MAAM;QAEN,KAAKzC,GAAG,EAAE;YACR,MAAM,IAAIU,KAAK,CAAC;SACjB;QAED,OAAOV,GAAG;KACX;;UAGMA,GAAG,CAAE;QACV,IAAI2B,QAAQ,CAAC3B,GAAG,GAAG;YACjBuC,YAAY,GAAGH,UAAU,CAACP,YAAY,CAAC7B,GAAG,GAAGO,IAAI,EAAEc,OAAO;YAE1D,IAAIkB,YAAY,EAAE;gBAChBE,MAAM;gBACNC,MAAM,CAACC,MAAM,CAACtB,OAAO,EAAEkB,YAAY;aACpC;SACF;QAEDC,IAAI;KACL;IAED,OAAOnB,OAAO;AAChB;;;;;;;;;;;;"}