@hugojosefson/cli 0.11.0 → 0.12.0

package/esm/node_modules/@simple-libs/stream-utils/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@simple-libs/stream-utils",
+  "type": "module",
+  "version": "2.0.0",
+  "description": "A small set of utilities for streams.",
+  "author": {
+    "name": "Dan Onoshko",
+    "email": "danon0404@gmail.com",
+    "url": "https://github.com/dangreen"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/TrigenSoftware/simple-libs/tree/main/packages/stream-utils#readme",
+  "funding": "https://ko-fi.com/dangreen",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TrigenSoftware/simple-libs.git",
+    "directory": "packages/stream-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/TrigenSoftware/simple-libs/issues"
+  },
+  "keywords": [
+    "stream",
+    "streams",
+    "utilities",
+    "utils"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ]
+}

package/esm/node_modules/argue-cli/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 - present, TrigenSoftware
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/esm/node_modules/argue-cli/README.md

@@ -0,0 +1,239 @@
+# 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]
+
+[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
+
+[node]: https://img.shields.io/node/v/argue-cli.svg
+[node-url]: https://nodejs.org
+
+[deps]: https://img.shields.io/librariesio/release/npm/argue-cli
+[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/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
+
+A thin and strongly typed CLI arguments parser for Node.js.
+
+## Usage
+
+1. Install
+
+```bash
+# pnpm
+pnpm add argue-cli
+# yarn
+yarn add argue-cli
+# npm
+npm i argue-cli
+```
+
+2. Import in your code and use it!
+
+```ts
+import { read, end, expect, alias, option, readOptions } from 'argue-cli'
+
+/**
+ * Expect and read one of the commands
+ */
+const command = expect(
+  alias('install', 'i'),
+  'remove'
+)
+let options = {}
+
+if (command === 'install') {
+  /**
+   * Read passed options
+   */
+  options = readOptions(
+    option(alias('save', 'S'), Boolean),
+    option(alias('saveDev', 'save-dev', 'D'), Boolean),
+    option('workspace', String)
+  )
+}
+
+/**
+ * Read next argument
+ */
+const packageName = read()
+
+/**
+ * Expect end of the arguments
+ */
+end()
+
+/* ... */
+```
+
+## API
+
+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
+```
+
+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'
+```
+
+### rest
+
+```ts
+function rest(): string[]
+```
+
+Reads all remaining arguments and returns them. Returns an empty array if there are none — unlike [`read`](#read), it never throws.
+
+```ts
+// my-cli format a.js b.js c.js
+expect('format')
+
+const files = rest() // ['a.js', 'b.js', 'c.js']
+
+end() // always passes after rest()
+```
+
+### end
+
+```ts
+function end(): void
+```
+
+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
+```
+
+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
+```
+
+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')
+```
+
+### autocase
+
+```ts
+function autocase(argRef: ArgRef): ArgRef
+```
+
+Describes an argument that matches both camelCase and kebab-case forms. The name can be given in either form — the twin form is added as an alias. Aliases longer than one character are autocased too. Use it anywhere an argument name is expected.
+
+```ts
+autocase('firstRelease')
+// --firstRelease and --first-release are both accepted
+
+autocase(alias('save-dev', 'D'))
+// --save-dev, --saveDev and -D
+```
+
+### option
+
+```ts
+function option(argRef: ArgRef, type: OptionConstructor): OptionReader
+```
+
+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']`
+- `[String]` or `[Number]` — takes the next argument as a whole; repeated options are collected: `--match '*.{js,ts}' --match '*.css'` → `['*.{js,ts}', '*.css']`. Use it instead of `Array` for values that may contain commas of their own
+
+### flag
+
+```ts
+function flag(argRef: ArgRef): OptionReader
+```
+
+Describes a boolean flag with `--no-*` negation support, to be read by [`readOptions`](#readoptions): `--verbose` sets `true`, `--no-verbose` sets `false`. Use `option(argRef, Boolean)` when negation is not wanted.
+
+```ts
+const options = readOptions(
+  flag(autocase('firstRelease'))
+)
+// --first-release → { firstRelease: true }
+// --no-first-release, --no-firstRelease → { firstRelease: false }
+```
+
+### readOptions
+
+```ts
+function readOptions(...optionReaders: OptionReader[]): OptionResult
+```
+
+Scans the arguments and reads all described options. Both `--option` and `-o` prefixes are accepted, and a value can be passed either as the next argument or inline: `--workspace packages/app` and `--workspace=packages/app` are equivalent. Arguments that don't match any described option are left untouched, so you can continue reading them afterwards.
+
+The result is a strongly typed object, where every property is optional — an option simply may not be passed:
+
+```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 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/esm/node_modules/argue-cli/dist/args.d.ts

@@ -0,0 +1,30 @@
+import type { AliasArgRef, ArgRef, OptionConstructor, OptionsReaderState, OptionsReaderRead, OptionResult } from './types.js';
+/**
+ * Describe argument with aliases.
+ * @param name - Main name.
+ * @param alias - Alias name.
+ * @param restAliases - Rest aliases.
+ * @returns Description of argument with aliases..
+ */
+export declare function alias<T extends string>(name: T, alias: string, ...restAliases: string[]): AliasArgRef<T>;
+/**
+ * Describe argument that matches both camelCase and kebab-case forms.
+ * Name and every alias longer than one character get the twin form as an alias.
+ * @param argRef - Argument name in either form.
+ * @returns Description of argument with the twin forms as aliases.
+ */
+export declare function autocase<T extends string>(argRef: ArgRef<T>): ArgRef<T>;
+/**
+ * Describe option with value.
+ * @param argRef - Option name.
+ * @param type - Value type.
+ * @returns Option reader.
+ */
+export declare function option<T extends string, K extends OptionConstructor>(argRef: ArgRef<T>, type: K): (option: string, read: OptionsReaderRead, options: OptionsReaderState) => OptionResult<T, K> | null;
+/**
+ * Describe boolean flag with `--no-*` negation support.
+ * @param argRef - Flag name.
+ * @returns Option reader.
+ */
+export declare function flag<T extends string>(argRef: ArgRef<T>): (option: string) => OptionResult<T, BooleanConstructor> | null;
+//# sourceMappingURL=args.d.ts.map

package/esm/node_modules/argue-cli/dist/args.d.ts.map

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

package/esm/node_modules/argue-cli/dist/argv.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internal state of arguments.
+ */
+export declare const argv: string[];
+/**
+ * Reset arguments state.
+ */
+export declare function resetArgs(): void;
+/**
+ * Set arguments state.
+ * @param args
+ */
+export declare function setArgs(...args: string[]): void;
+//# sourceMappingURL=argv.d.ts.map

package/esm/node_modules/argue-cli/dist/argv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,IAAI,UAAuC,CAAA;AAExD;;GAEG;AACH,wBAAgB,SAAS,SAGxB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,QAGxC"}

package/esm/node_modules/argue-cli/dist/core.d.ts

@@ -0,0 +1,24 @@
+import type { ArgRef } from './types.js';
+/**
+ * Read next argument.
+ * Throws error if no next argument.
+ * @returns Next argument.
+ */
+export declare function read(): string;
+/**
+ * Read all remaining arguments.
+ * @returns Remaining arguments, empty array if none.
+ */
+export declare function rest(): string[];
+/**
+ * Expectation of the end.
+ * Throws an error if there are more arguments left.
+ */
+export declare function end(): void;
+/**
+ * Expect one of the given arguments.
+ * @param argRefs
+ * @returns Expected full argument name.
+ */
+export declare function expect<T extends string>(...argRefs: [...ArgRef<T>[]]): T;
+//# sourceMappingURL=core.d.ts.map

package/esm/node_modules/argue-cli/dist/core.d.ts.map

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

package/esm/node_modules/argue-cli/dist/index.d.ts

@@ -0,0 +1,6 @@
+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/esm/node_modules/argue-cli/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/node_modules/argue-cli/dist/index.js

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

package/esm/node_modules/argue-cli/dist/index.js.map

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