@clerc/core 1.1.0 → 1.2.0

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.mts

@@ -1,5 +1,5 @@
 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 { DOUBLE_DASH, FlagOptions, IgnoreFunction, InferFlags, InvalidSchemaError, KNOWN_FLAG, PARAMETER, ParsedResult, TypeFunction, TypeValue, UNKNOWN_FLAG, inferDefault } from "@clerc/parser";
 import { CamelCase, DeepPrettify, LiteralUnion, MaybeArray, PartialRequired, Prettify, UnionToIntersection } from "@clerc/utils";
 
 //#region ../advanced-types/src/errors.d.ts
@@ -210,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, index_d_exports as 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, inferDefault, normalizeFlagValue, normalizeParameterValue, resolveCommand };

package/dist/index.mjs

@@ -1,423 +1 @@
-import { t as __exportAll } from "./chunk-15K8U1wQ.mjs";
-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 ../advanced-types/src/errors.ts
-var FlagValidationError = class extends Error {};
-
-//#endregion
-//#region ../advanced-types/src/index.ts
-var src_exports = /* @__PURE__ */ __exportAll({
-	Enum: () => Enum,
-	FlagValidationError: () => FlagValidationError,
-	Range: () => Range,
-	Regex: () => 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
-*/
-function Enum(...values) {
-	const fn = ((value) => {
-		if (!values.includes(value)) throw new FlagValidationError(`Invalid value: ${value}. Must be one of: ${values.join(", ")}`);
-		return value;
-	});
-	fn.display = values.join(" | ");
-	return fn;
-}
-/**
-* 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
-*/
-function Range(min, max) {
-	const fn = ((value) => {
-		const num = Number(value);
-		if (Number.isNaN(num) || num < min || num > max) throw new FlagValidationError(`Invalid value: ${value}. Must be a number between ${min} and ${max}`);
-		return num;
-	});
-	fn.display = `${min} - ${max}`;
-	return fn;
-}
-/**
-* 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
-*/
-function Regex(pattern, description) {
-	const fn = ((value) => {
-		if (!pattern.test(value)) throw new FlagValidationError(`Invalid value: ${value}. Must match pattern: ${pattern}`);
-		return value;
-	});
-	fn.display = description ?? `Regex: ${pattern.toString()}`;
-	return fn;
-}
-
-//#endregion
-//#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, src_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, extractParameterInfo, normalizeFlagValue, normalizeParameterValue, resolveCommand };
+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,inferDefault as c,parse as l}from"@clerc/parser";import{camelCase as u,hasOwn as d,looseIsArray as f,toArray as p}from"@clerc/utils";import{LiteEmit as m}from"lite-emit";var h=class extends Error{},g=e({Enum:()=>_,FlagValidationError:()=>h,Range:()=>v,Regex:()=>y});function _(...e){let t=(t=>{if(!e.includes(t))throw new h(`Invalid value: ${t}. Must be one of: ${e.join(`, `)}`);return t});return t.display=e.join(` | `),t}function v(e,t){let n=(n=>{let r=Number(n);if(Number.isNaN(r)||r<e||r>t)throw new h(`Invalid value: ${n}. Must be a number between ${e} and ${t}`);return r});return n.display=`${e} - ${t}`,n}function y(e,t){let n=(t=>{if(!e.test(t))throw new h(`Invalid value: ${t}. Must match pattern: ${e}`);return t});return n.display=t??`Regex: ${e.toString()}`,n}function b(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 x=class extends Error{constructor(e,t=`No such command: "${e}".`){super(t),this.commandName=e}},S=class extends Error{constructor(e=`No command specified.`){super(e)}},C=class extends Error{},w=class extends Error{constructor(e){super(`CLI ${e} is required.`)}},T=class extends Error{},E=class extends Error{constructor(e){let t=e.length>1?`s`:``;super(`Missing required flag${t}: ${e.join(`, `)}`)}};function D(e){return typeof e==`function`?{enforce:`normal`,handler:e}:{enforce:e.enforce??`normal`,handler:e.handler}}function O(e){let t=e.map(D),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 k=typeof Deno<`u`,A=typeof process<`u`&&!k,j=process.versions.electron&&!process.defaultApp,M=e=>typeof e==`function`||f(e)?{type:e}:e,N=e=>typeof e==`string`?{key:e}:e;function P(e){let t=[];for(let n of e){if(n.startsWith(`-`))break;t.push(n)}return t}const F=/^(<|\[)([\w ]+)(\.\.\.)?(\]|>)$/,I=e=>e.startsWith(`<`)&&e.endsWith(`>`)||e.startsWith(`[`)&&e.endsWith(`]`);function L(e){let t=e.match(F);if(!t||!I(e))throw new T(`Invalid parameter definition: ${e}`);return{name:u(t[2]),isRequired:e.startsWith(`<`),isVariadic:!!t[3]}}function R(e,t){let n={},r=!1;for(let[i,a]of e.entries()){let o=N(a),{name:s,isRequired:c,isVariadic:l}=L(o.key);if(d(n,s))throw new T(`Duplicate parameter name: ${s}`);if(l&&i!==e.length-1)throw new T(`Variadic parameter must be the last parameter in the definition.`);if(c){if(r)throw new T(`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 T(`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 z(e,t,r){let i=e.indexOf(n);if(i===-1)return R(e,t);{let n=e.slice(0,i),a=e.slice(i+1);return{...R(n,t),...R(a,r)}}}const B=A?process.argv.slice(j?1:2):k?Deno.args:[];var V=class e{#e=[];#t=new Map;#n=new m;#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 C(`Command with name "${e}" already exists.`);for(let e of t)if(this.#t.has(e))throw new C(`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=p(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 w(`script name`);if(!this.#u)throw new w(`version`)}#h(e,t){let{flags:n,ignore:r}=t??{};return this.#f(()=>l(e,{flags:{...this.#r,...n},ignore:r}))}async run(){let e=P(this.#e),[t,n]=b(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?z(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 E(i.missingRequiredFlags);if(o)throw o;if(t)await this.#n.emit(t.name,n);else throw e.length>0?new x(e.join(` `)):new S}},l=O([...this.#a,c]);return this.#f(()=>l(s))}parse(e=B){this.#f(()=>this.#m()),Array.isArray(e)&&(e={argv:e});let{argv:t=B,run:n=!0}=e;return this.#e=t,n?this.run():this}};const H=(e,t)=>({...e,handler:t});function U(){let e=!1;return t=>t===o&&!e?(e=!0,!1):e}const W=e=>e;export{V as Clerc,t as DOUBLE_DASH,C as InvalidCommandError,T as InvalidParametersError,r as InvalidSchemaError,i as KNOWN_FLAG,E as MissingRequiredFlagError,w as MissingRequiredMetadataError,S as NoCommandSpecifiedError,x as NoSuchCommandError,a as PARAMETER,g as Types,s as UNKNOWN_FLAG,U as createStopAtFirstParameter,H as defineCommand,W as definePlugin,L as extractParameterInfo,c as inferDefault,M as normalizeFlagValue,N as normalizeParameterValue,b as resolveCommand};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc core",
@@ -38,11 +38,11 @@
   },
   "dependencies": {
     "lite-emit": "^4.0.0",
-    "@clerc/parser": "1.1.0",
-    "@clerc/utils": "1.1.0"
+    "@clerc/parser": "1.2.0",
+    "@clerc/utils": "1.2.0"
   },
   "devDependencies": {
     "is-platform": "^1.0.0",
-    "@clerc/advanced-types": "1.1.0"
+    "@clerc/advanced-types": "1.2.0"
   }
 }

package/dist/chunk-15K8U1wQ.mjs

@@ -1,18 +0,0 @@
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __exportAll = (all, symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-
-//#endregion
-export { __exportAll as t };