@clerc/core 1.0.3 → 1.1.1

package/README.md

@@ -2,7 +2,9 @@
 
 [![NPM version](https://img.shields.io/npm/v/@clerc/core?color=a1b858&label=)](https://www.npmjs.com/package/@clerc/core)
 
-See [Clerc](https://github.com/clercjs/clerc) for documentation.
+## Documenation
+
+Read the [documentation](https://clerc.so1ve.dev) for more details.
 
 ## 📝 License
 

package/dist/chunk-rq_z9THO.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n&&e(r,Symbol.toStringTag,{value:`Module`}),r};export{t};

package/dist/{index.d.ts → index.d.mts}

@@ -1,8 +1,51 @@
-import * as Types from "@clerc/advanced-types";
 import * as Parser from "@clerc/parser";
 import { DOUBLE_DASH, FlagOptions, IgnoreFunction, InferFlags, InvalidSchemaError, KNOWN_FLAG, PARAMETER, ParsedResult, TypeFunction, TypeValue, UNKNOWN_FLAG } from "@clerc/parser";
 import { CamelCase, DeepPrettify, LiteralUnion, MaybeArray, PartialRequired, Prettify, UnionToIntersection } from "@clerc/utils";
 
+//#region ../advanced-types/src/errors.d.ts
+declare class FlagValidationError extends Error {}
+declare namespace index_d_exports {
+  export { Enum, FlagValidationError, Range, Regex };
+}
+/**
+* Creates a Enum type function that validates the input against allowed values.
+* The display name will be formatted as "value1 | value2 | ..." for help
+* output.
+*
+* @example
+*
+* ```typescript
+* const format = Enum(["json", "yaml", "xml"]);
+* // Help output will show: json | yaml | xml
+* ```
+*
+* @param values - Array of allowed string values
+* @returns A TypeFunction that validates and returns the input value
+* @throws {Error} If the value is not in the allowed values list
+*/
+declare function Enum<T extends string>(...values: T[]): TypeFunction<T>;
+/**
+* Creates a range type function that validates the input is a number within the
+* specified range.
+*
+* @param min - The minimum acceptable value (inclusive)
+* @param max - The maximum acceptable value (inclusive)
+* @returns A TypeFunction that validates the input value
+* @throws {Error} If the value is not a number or is outside the specified
+*   range
+*/
+declare function Range(min: number, max: number): TypeFunction<number>;
+/**
+* Creates a regex type function that validates the input against the provided
+* pattern.
+*
+* @param pattern - The regular expression pattern to validate against
+* @param description - Optional description for display purposes
+* @returns A TypeFunction that validates the input value
+* @throws {Error} If the value does not match the regex pattern
+*/
+declare function Regex(pattern: RegExp, description?: string): TypeFunction<string>;
+//#endregion
 //#region src/types/clerc.d.ts
 type ErrorHandler = (error: unknown) => void;
 //#endregion
@@ -48,7 +91,8 @@ interface CommandOptions<Parameters extends readonly ParameterDefinitionValue[]
   parameters?: Parameters;
   flags?: Flags;
   /**
-  * A callback function to conditionally stop parsing. When it returns true, parsing stops and remaining arguments are preserved in ignored.
+  * A callback function to conditionally stop parsing. When it returns true,
+  * parsing stops and remaining arguments are preserved in ignored.
   */
   ignore?: IgnoreFunction;
 }
@@ -70,8 +114,7 @@ type CommandHandler<C extends Command = Command, GF extends ClercFlagsDefinition
 //#region src/types/interceptor.d.ts
 type InterceptorContext<C extends Command = Command, GF extends ClercFlagsDefinition = {}> = DeepPrettify<BaseContext<C, GF>>;
 /**
-* Function to call the next interceptor in the chain.
-* **MUST** be awaited.
+* Function to call the next interceptor in the chain. **MUST** be awaited.
 */
 type InterceptorNext = () => void | Promise<void>;
 type InterceptorHandler<C extends Command = Command, GF extends ClercFlagsDefinition = {}> = (context: InterceptorContext<C, GF>, next: InterceptorNext) => void | Promise<void>;
@@ -167,4 +210,4 @@ declare const definePlugin: (plugin: Plugin) => Plugin;
 declare const normalizeFlagValue: (flag: ClercFlagDefinitionValue) => ClercFlagOptions;
 declare const normalizeParameterValue: (parameter: ParameterDefinitionValue) => ParameterOptions;
 //#endregion
-export { BaseContext, Clerc, ClercFlagDefinitionValue, ClercFlagOptions, ClercFlagsDefinition, Command, CommandCustomOptions, CommandHandler, CommandHandlerContext, CommandOptions, CommandWithHandler, CommandsMap, CommandsRecord, ContextStore, type CreateOptions, DOUBLE_DASH, ErrorHandler, FlagCustomOptions, InferParameters, Interceptor, InterceptorContext, InterceptorHandler, InterceptorNext, InterceptorObject, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MakeEmitterEvents, MissingRequiredFlagError, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, ParameterCustomOptions, ParameterDefinitionValue, ParameterOptions, type ParseOptions, type Parser, Plugin, Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, extractParameterInfo, normalizeFlagValue, normalizeParameterValue, resolveCommand };
+export { BaseContext, Clerc, ClercFlagDefinitionValue, ClercFlagOptions, ClercFlagsDefinition, Command, CommandCustomOptions, CommandHandler, CommandHandlerContext, CommandOptions, CommandWithHandler, CommandsMap, CommandsRecord, ContextStore, type CreateOptions, DOUBLE_DASH, ErrorHandler, FlagCustomOptions, InferParameters, Interceptor, InterceptorContext, InterceptorHandler, InterceptorNext, InterceptorObject, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MakeEmitterEvents, MissingRequiredFlagError, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, ParameterCustomOptions, ParameterDefinitionValue, ParameterOptions, type ParseOptions, type Parser, Plugin, index_d_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, extractParameterInfo, normalizeFlagValue, normalizeParameterValue, resolveCommand };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"./chunk-rq_z9THO.mjs";import{DOUBLE_DASH as t,DOUBLE_DASH as n,InvalidSchemaError as r,KNOWN_FLAG as i,PARAMETER as a,PARAMETER as o,UNKNOWN_FLAG as s,parse as c}from"@clerc/parser";import{camelCase as l,looseIsArray as u,toArray as d}from"@clerc/utils";import{LiteEmit as f}from"lite-emit";var p=class extends Error{},m=e({Enum:()=>h,FlagValidationError:()=>p,Range:()=>g,Regex:()=>_});function h(...e){let t=(t=>{if(!e.includes(t))throw new p(`Invalid value: ${t}. Must be one of: ${e.join(`, `)}`);return t});return t.display=e.join(` | `),t}function g(e,t){let n=(n=>{let r=Number(n);if(Number.isNaN(r)||r<e||r>t)throw new p(`Invalid value: ${n}. Must be a number between ${e} and ${t}`);return r});return n.display=`${e} - ${t}`,n}function _(e,t){let n=(t=>{if(!e.test(t))throw new p(`Invalid value: ${t}. Must match pattern: ${e}`);return t});return n.display=t??`Regex: ${e.toString()}`,n}function v(e,t){for(let n=t.length;n>=0;n--){let r=t.slice(0,n).join(` `);if(e.has(r))return[e.get(r),r]}return[void 0,void 0]}var y=class extends Error{constructor(e,t=`No such command: "${e}".`){super(t),this.commandName=e}},b=class extends Error{constructor(e=`No command specified.`){super(e)}},x=class extends Error{},S=class extends Error{constructor(e){super(`CLI ${e} is required.`)}},C=class extends Error{},w=class extends Error{constructor(e){let t=e.length>1?`s`:``;super(`Missing required flag${t}: ${e.join(`, `)}`)}};function T(e){return typeof e==`function`?{enforce:`normal`,handler:e}:{enforce:e.enforce??`normal`,handler:e.handler}}function E(e){let t=e.map(T),n=t.filter(e=>e.enforce===`pre`),r=t.filter(e=>e.enforce===`normal`),i=t.filter(e=>e.enforce===`post`),a=[...n,...r,...i];return async e=>{let t=0;async function n(){t>=a.length||await a[t++].handler(e,n)}await n()}}const D=typeof Deno<`u`,O=typeof process<`u`&&!D,k=process.versions.electron&&!process.defaultApp,A=e=>typeof e==`function`||u(e)?{type:e}:e,j=e=>typeof e==`string`?{key:e}:e;function M(e){let t=[];for(let n of e){if(n.startsWith(`-`))break;t.push(n)}return t}const N=/^(<|\[)([\w ]+)(\.\.\.)?(\]|>)$/,P=e=>e.startsWith(`<`)&&e.endsWith(`>`)||e.startsWith(`[`)&&e.endsWith(`]`);function F(e){let t=e.match(N);if(!t||!P(e))throw new C(`Invalid parameter definition: ${e}`);return{name:l(t[2]),isRequired:e.startsWith(`<`),isVariadic:!!t[3]}}function I(e,t){let n={},r=!1;for(let[i,a]of e.entries()){let o=j(a),{name:s,isRequired:c,isVariadic:l}=F(o.key);if(s in n)throw new C(`Duplicate parameter name: ${s}`);if(l&&i!==e.length-1)throw new C(`Variadic parameter must be the last parameter in the definition.`);if(c){if(r)throw new C(`Required parameter "${s}" cannot appear after an optional parameter.`)}else r=!0;let u=l?t.slice(i):t[i];if(c&&(l?u.length===0:u===void 0))throw new C(`Missing required ${l?`variadic `:``}parameter: ${s}`);o.type?l?n[s]=u.map(e=>o.type(e)):u===void 0?n[s]=u:n[s]=o.type(u):n[s]=u}return n}function L(e,t,r){let i=e.indexOf(n);if(i===-1)return I(e,t);{let n=e.slice(0,i),a=e.slice(i+1);return{...I(n,t),...I(a,r)}}}const R=O?process.argv.slice(k?1:2):D?Deno.args:[];var z=class e{#e=[];#t=new Map;#n=new f;#r={};#i={};#a=[];#o=[];#s=``;#c=``;#l=``;#u=``;constructor({name:e,scriptName:t,description:n,version:r}={}){e&&(this.#s=e),t&&(this.#c=t),n&&(this.#l=n),r&&(this.#u=r)}get _name(){return this.#s||this.#c}get _scriptName(){return this.#c}get _description(){return this.#l}get _version(){return this.#u}get _commands(){return this.#t}get _globalFlags(){return this.#r}get store(){return this.#i}static create(t){return new e(t)}name(e){return this.#s=e,this}scriptName(e){return this.#c=e,this}description(e){return this.#l=e,this}version(e){return this.#u=e,this}use(e){return e.setup(this),this}errorHandler(e){return this.#o.push(e),this}#d(e){if(this.#o.length>0)for(let t of this.#o)t(e);else throw e}#f(e){try{let t=e();return t instanceof Promise?t.catch(e=>{this.#d(e)}):t}catch(e){throw this.#d(e),e}}#p(e,t){if(this.#t.has(e))throw new x(`Command with name "${e}" already exists.`);for(let e of t)if(this.#t.has(e))throw new x(`Command with name "${e}" already exists.`)}command(e,t,n){if(Array.isArray(e)){for(let t of e)this.command(t);return this}let r=typeof t==`string`,i=typeof e==`string`?{name:e,description:r?t:void 0,...r?n:t}:e,a=d(i?.alias??[]);this.#f(()=>this.#p(i.name,a)),this.#t.set(i.name,i);for(let e of a)this.#t.set(e,{...i,__isAlias:!0});return i.handler&&this.on(i.name,i.handler),this}globalFlag(e,t,n){let r=typeof t==`string`;return this.#r[e]={description:r?t:void 0,...r?n:t},this}interceptor(e){return this.#a.push(e),this}on(e,t){return this.#n.on(e,t),this}#m(){if(!this.#c)throw new S(`script name`);if(!this.#u)throw new S(`version`)}#h(e,t){let{flags:n,ignore:r}=t??{};return this.#f(()=>c(e,{flags:{...this.#r,...n},ignore:r}))}async run(){let e=M(this.#e),[t,n]=v(this.#t,e),r=t&&n.length>0?this.#e.slice(n.split(` `).length):this.#e,i=this.#f(()=>this.#h(r,t)),a={},o;try{a=t?.parameters?L(t.parameters,i.parameters,i.doubleDash):{}}catch(e){o=e}let s={command:t,calledAs:n,parameters:a,flags:i.flags,ignored:i.ignored,rawParsed:i,store:{...this.#i}},c={enforce:`post`,handler:async n=>{if(i.missingRequiredFlags.length>0)throw new w(i.missingRequiredFlags);if(o)throw o;if(t)await this.#n.emit(t.name,n);else throw e.length>0?new y(e.join(` `)):new b}},l=E([...this.#a,c]);return this.#f(()=>l(s))}parse(e=R){this.#f(()=>this.#m()),Array.isArray(e)&&(e={argv:e});let{argv:t=R,run:n=!0}=e;return this.#e=t,n?this.run():this}};const B=(e,t)=>({...e,handler:t});function V(){let e=!1;return t=>t===o&&!e?(e=!0,!1):e}const H=e=>e;export{z as Clerc,t as DOUBLE_DASH,x as InvalidCommandError,C as InvalidParametersError,r as InvalidSchemaError,i as KNOWN_FLAG,w as MissingRequiredFlagError,S as MissingRequiredMetadataError,b as NoCommandSpecifiedError,y as NoSuchCommandError,a as PARAMETER,m as Types,s as UNKNOWN_FLAG,V as createStopAtFirstParameter,B as defineCommand,H as definePlugin,F as extractParameterInfo,A as normalizeFlagValue,j as normalizeParameterValue,v as resolveCommand};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc core",
@@ -24,19 +24,12 @@
   "license": "MIT",
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "*": [
-        "./dist/*",
-        "./dist/index.d.ts"
-      ]
-    }
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
   },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
@@ -45,11 +38,11 @@
   },
   "dependencies": {
     "lite-emit": "^4.0.0",
-    "@clerc/advanced-types": "1.0.3",
-    "@clerc/parser": "1.0.3",
-    "@clerc/utils": "1.0.3"
+    "@clerc/utils": "1.1.1",
+    "@clerc/parser": "1.1.1"
   },
   "devDependencies": {
-    "is-platform": "^1.0.0"
+    "is-platform": "^1.0.0",
+    "@clerc/advanced-types": "1.1.1"
   }
 }

package/dist/index.js

@@ -1,350 +0,0 @@
-import * as Types from "@clerc/advanced-types";
-import { DOUBLE_DASH, DOUBLE_DASH as DOUBLE_DASH$1, InvalidSchemaError, KNOWN_FLAG, PARAMETER, PARAMETER as PARAMETER$1, UNKNOWN_FLAG, parse } from "@clerc/parser";
-import { camelCase, looseIsArray, toArray } from "@clerc/utils";
-import { LiteEmit } from "lite-emit";
-
-//#region src/command.ts
-function resolveCommand(commandsMap, parameters) {
-	for (let i = parameters.length; i >= 0; i--) {
-		const name = parameters.slice(0, i).join(" ");
-		if (commandsMap.has(name)) return [commandsMap.get(name), name];
-	}
-	return [void 0, void 0];
-}
-
-//#endregion
-//#region src/errors.ts
-var NoSuchCommandError = class extends Error {
-	constructor(commandName, text = `No such command: "${commandName}".`) {
-		super(text);
-		this.commandName = commandName;
-	}
-};
-var NoCommandSpecifiedError = class extends Error {
-	constructor(text = "No command specified.") {
-		super(text);
-	}
-};
-var InvalidCommandError = class extends Error {};
-var MissingRequiredMetadataError = class extends Error {
-	constructor(metadataName) {
-		super(`CLI ${metadataName} is required.`);
-	}
-};
-var InvalidParametersError = class extends Error {};
-var MissingRequiredFlagError = class extends Error {
-	constructor(flags) {
-		const s = flags.length > 1 ? "s" : "";
-		super(`Missing required flag${s}: ${flags.join(", ")}`);
-	}
-};
-
-//#endregion
-//#region src/interceptor.ts
-function normalizeInspector(inspector) {
-	if (typeof inspector === "function") return {
-		enforce: "normal",
-		handler: inspector
-	};
-	return {
-		enforce: inspector.enforce ?? "normal",
-		handler: inspector.handler
-	};
-}
-function compose(inspectors) {
-	const normalized = inspectors.map(normalizeInspector);
-	const pre = normalized.filter((i) => i.enforce === "pre");
-	const normal = normalized.filter((i) => i.enforce === "normal");
-	const post = normalized.filter((i) => i.enforce === "post");
-	const orderedInspectors = [
-		...pre,
-		...normal,
-		...post
-	];
-	return async (context) => {
-		let index = 0;
-		async function dispatch() {
-			if (index >= orderedInspectors.length) return;
-			await orderedInspectors[index++].handler(context, dispatch);
-		}
-		await dispatch();
-	};
-}
-
-//#endregion
-//#region ../../node_modules/.pnpm/is-platform@1.0.0/node_modules/is-platform/dist/index.mjs
-const IS_DENO = typeof Deno !== "undefined";
-const IS_NODE = typeof process !== "undefined" && !IS_DENO;
-const IS_ELECTRON = process.versions.electron && !process.defaultApp;
-
-//#endregion
-//#region src/utils.ts
-const normalizeFlagValue = (flag) => typeof flag === "function" || looseIsArray(flag) ? { type: flag } : flag;
-const normalizeParameterValue = (parameter) => typeof parameter === "string" ? { key: parameter } : parameter;
-
-//#endregion
-//#region src/parameter.ts
-function getParametersToResolve(argv) {
-	const parameters = [];
-	for (const arg of argv) {
-		if (arg.startsWith("-")) break;
-		parameters.push(arg);
-	}
-	return parameters;
-}
-const PARAMETER_REGEX = /^(<|\[)([\w ]+)(\.\.\.)?(\]|>)$/;
-const isParameterDefinitionBracketsValid = (definition) => definition.startsWith("<") && definition.endsWith(">") || definition.startsWith("[") && definition.endsWith("]");
-function extractParameterInfo(key) {
-	const match = key.match(PARAMETER_REGEX);
-	if (!match || !isParameterDefinitionBracketsValid(key)) throw new InvalidParametersError(`Invalid parameter definition: ${key}`);
-	return {
-		name: camelCase(match[2]),
-		isRequired: key.startsWith("<"),
-		isVariadic: !!match[3]
-	};
-}
-function _parseParameters(definitions, parameters) {
-	const result = {};
-	let hasOptional = false;
-	for (const [i, def] of definitions.entries()) {
-		const normalized = normalizeParameterValue(def);
-		const { name, isRequired, isVariadic } = extractParameterInfo(normalized.key);
-		if (name in result) throw new InvalidParametersError(`Duplicate parameter name: ${name}`);
-		if (isVariadic && i !== definitions.length - 1) throw new InvalidParametersError("Variadic parameter must be the last parameter in the definition.");
-		if (isRequired) {
-			if (hasOptional) throw new InvalidParametersError(`Required parameter "${name}" cannot appear after an optional parameter.`);
-		} else hasOptional = true;
-		const value = isVariadic ? parameters.slice(i) : parameters[i];
-		if (isRequired && (isVariadic ? value.length === 0 : value === void 0)) throw new InvalidParametersError(`Missing required ${isVariadic ? "variadic " : ""}parameter: ${name}`);
-		if (normalized.type) if (isVariadic) result[name] = value.map((v) => normalized.type(v));
-		else if (value === void 0) result[name] = value;
-		else result[name] = normalized.type(value);
-		else result[name] = value;
-	}
-	return result;
-}
-function parseParameters(definitions, parameters, doubleDashParameters) {
-	const doubleDashIndex = definitions.indexOf(DOUBLE_DASH$1);
-	if (doubleDashIndex === -1) return _parseParameters(definitions, parameters);
-	else {
-		const definitionBeforeDoubleDash = definitions.slice(0, doubleDashIndex);
-		const definitionAfterDoubleDash = definitions.slice(doubleDashIndex + 1);
-		return {
-			..._parseParameters(definitionBeforeDoubleDash, parameters),
-			..._parseParameters(definitionAfterDoubleDash, doubleDashParameters)
-		};
-	}
-}
-
-//#endregion
-//#region src/platform.ts
-const platformArgv = IS_NODE ? process.argv.slice(IS_ELECTRON ? 1 : 2) : IS_DENO ? Deno.args : [];
-
-//#endregion
-//#region src/cli.ts
-var Clerc = class Clerc {
-	#argv = [];
-	#commands = /* @__PURE__ */ new Map();
-	#emitter = new LiteEmit();
-	#globalFlags = {};
-	#store = {};
-	#interceptors = [];
-	#errorHandlers = [];
-	#name = "";
-	#scriptName = "";
-	#description = "";
-	#version = "";
-	constructor({ name, scriptName, description, version } = {}) {
-		if (name) this.#name = name;
-		if (scriptName) this.#scriptName = scriptName;
-		if (description) this.#description = description;
-		if (version) this.#version = version;
-	}
-	get _name() {
-		return this.#name || this.#scriptName;
-	}
-	get _scriptName() {
-		return this.#scriptName;
-	}
-	get _description() {
-		return this.#description;
-	}
-	get _version() {
-		return this.#version;
-	}
-	get _commands() {
-		return this.#commands;
-	}
-	get _globalFlags() {
-		return this.#globalFlags;
-	}
-	get store() {
-		return this.#store;
-	}
-	static create(options) {
-		return new Clerc(options);
-	}
-	name(name) {
-		this.#name = name;
-		return this;
-	}
-	scriptName(scriptName) {
-		this.#scriptName = scriptName;
-		return this;
-	}
-	description(description) {
-		this.#description = description;
-		return this;
-	}
-	version(version) {
-		this.#version = version;
-		return this;
-	}
-	use(plugin) {
-		plugin.setup(this);
-		return this;
-	}
-	errorHandler(handler) {
-		this.#errorHandlers.push(handler);
-		return this;
-	}
-	#handleError(error) {
-		if (this.#errorHandlers.length > 0) for (const callback of this.#errorHandlers) callback(error);
-		else throw error;
-	}
-	#callWithErrorHandler(fn) {
-		try {
-			const result = fn();
-			if (result instanceof Promise) return result.catch((error) => {
-				this.#handleError(error);
-			});
-			return result;
-		} catch (error) {
-			this.#handleError(error);
-			throw error;
-		}
-	}
-	#validateCommandNameAndAlias(name, aliases) {
-		if (this.#commands.has(name)) throw new InvalidCommandError(`Command with name "${name}" already exists.`);
-		for (const alias of aliases) if (this.#commands.has(alias)) throw new InvalidCommandError(`Command with name "${alias}" already exists.`);
-	}
-	command(nameOrCommandObjectOrCommandArray, descriptionOrOptions, options) {
-		if (Array.isArray(nameOrCommandObjectOrCommandArray)) {
-			for (const command$1 of nameOrCommandObjectOrCommandArray) this.command(command$1);
-			return this;
-		}
-		const isDescription = typeof descriptionOrOptions === "string";
-		const command = typeof nameOrCommandObjectOrCommandArray === "string" ? {
-			name: nameOrCommandObjectOrCommandArray,
-			description: isDescription ? descriptionOrOptions : void 0,
-			...isDescription ? options : descriptionOrOptions
-		} : nameOrCommandObjectOrCommandArray;
-		const aliases = toArray(command?.alias ?? []);
-		this.#callWithErrorHandler(() => this.#validateCommandNameAndAlias(command.name, aliases));
-		this.#commands.set(command.name, command);
-		for (const alias of aliases) this.#commands.set(alias, {
-			...command,
-			__isAlias: true
-		});
-		if (command.handler) this.on(command.name, command.handler);
-		return this;
-	}
-	globalFlag(name, descriptionOrOptions, options) {
-		const isDescription = typeof descriptionOrOptions === "string";
-		this.#globalFlags[name] = {
-			description: isDescription ? descriptionOrOptions : void 0,
-			...isDescription ? options : descriptionOrOptions
-		};
-		return this;
-	}
-	interceptor(interceptor) {
-		this.#interceptors.push(interceptor);
-		return this;
-	}
-	on(name, handler) {
-		this.#emitter.on(name, handler);
-		return this;
-	}
-	#validate() {
-		if (!this.#scriptName) throw new MissingRequiredMetadataError("script name");
-		if (!this.#version) throw new MissingRequiredMetadataError("version");
-	}
-	#parseArgv(argv, command) {
-		const { flags, ignore } = command ?? {};
-		return this.#callWithErrorHandler(() => parse(argv, {
-			flags: {
-				...this.#globalFlags,
-				...flags
-			},
-			ignore
-		}));
-	}
-	async run() {
-		const parametersToResolve = getParametersToResolve(this.#argv);
-		const [command, calledAs] = resolveCommand(this.#commands, parametersToResolve);
-		const argvToPass = command && calledAs.length > 0 ? this.#argv.slice(calledAs.split(" ").length) : this.#argv;
-		const parsed = this.#callWithErrorHandler(() => this.#parseArgv(argvToPass, command));
-		let parameters = {};
-		let parametersError;
-		try {
-			parameters = command?.parameters ? parseParameters(command.parameters, parsed.parameters, parsed.doubleDash) : {};
-		} catch (e) {
-			parametersError = e;
-		}
-		const context = {
-			command,
-			calledAs,
-			parameters,
-			flags: parsed.flags,
-			ignored: parsed.ignored,
-			rawParsed: parsed,
-			store: { ...this.#store }
-		};
-		const emitInterceptor = {
-			enforce: "post",
-			handler: async (ctx) => {
-				if (parsed.missingRequiredFlags.length > 0) throw new MissingRequiredFlagError(parsed.missingRequiredFlags);
-				if (parametersError) throw parametersError;
-				if (command) await this.#emitter.emit(command.name, ctx);
-				else throw parametersToResolve.length > 0 ? new NoSuchCommandError(parametersToResolve.join(" ")) : new NoCommandSpecifiedError();
-			}
-		};
-		const composedInterceptor = compose([...this.#interceptors, emitInterceptor]);
-		return this.#callWithErrorHandler(() => composedInterceptor(context));
-	}
-	parse(argvOrOptions = platformArgv) {
-		this.#callWithErrorHandler(() => this.#validate());
-		if (Array.isArray(argvOrOptions)) argvOrOptions = { argv: argvOrOptions };
-		const { argv = platformArgv, run = true } = argvOrOptions;
-		this.#argv = argv;
-		if (run) return this.run();
-		return this;
-	}
-};
-
-//#endregion
-//#region src/helpers.ts
-const defineCommand = (command, handler) => ({
-	...command,
-	handler
-});
-
-//#endregion
-//#region src/ignore.ts
-function createStopAtFirstParameter() {
-	let encounteredParameter = false;
-	return (type) => {
-		if (type === PARAMETER$1 && !encounteredParameter) {
-			encounteredParameter = true;
-			return false;
-		}
-		return encounteredParameter;
-	};
-}
-
-//#endregion
-//#region src/plugin.ts
-const definePlugin = (plugin) => plugin;
-
-//#endregion
-export { Clerc, DOUBLE_DASH, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MissingRequiredFlagError, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, extractParameterInfo, normalizeFlagValue, normalizeParameterValue, resolveCommand };