@clerc/core 1.0.0-beta.17 → 1.0.0-beta.19

package/dist/chunk-CYeTv9WL.js

@@ -0,0 +1,42 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (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;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget, symbols) => {
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+		secondTarget && __defProp(secondTarget, Symbol.toStringTag, { value: "Module" });
+	}
+	__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default");
+};
+
+//#endregion
+export { __reExport as n, __export as t };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { ErrorHandler as ErrorHandler$1 } from "lite-emit";
+import { n as __reExport, t as __export } from "./chunk-CYeTv9WL.js";
+import { Clerc as Clerc$1, CreateOptions as CreateOptions$1, Plugin as Plugin$1 } from "@clerc/core";
 
 //#region ../parser/src/errors.d.ts
 declare class InvalidSchemaError extends Error {
@@ -8,23 +9,6 @@ declare class MissingRequiredFlagError extends Error {
   constructor(name: string);
 }
 //#endregion
-//#region ../parser/src/flag-types.d.ts
-/**
-* Creates a Enum type function that validates the input against allowed values.
-* The display name will be formatted as "value1 | value2 | ..." for help output.
-*
-* @param values - Array of allowed string values
-* @returns A FlagTypeFunction that validates and returns the input value
-* @throws {Error} If the value is not in the allowed values list
-*
-* @example
-* ```typescript
-* const format = Enum(['json', 'yaml', 'xml']);
-* // Help output will show: json | yaml | xml
-* ```
-*/
-declare function Enum<T extends string>(...values: T[]): FlagTypeFunction<T>;
-//#endregion
 //#region ../utils/src/types/type-fest.d.ts
 type LiteralUnion<LiteralType, BaseType> = LiteralType | (BaseType & Record<never, never>);
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
@@ -43,6 +27,11 @@ type PartialRequired<T, K$1 extends keyof T> = T & { [P in K$1]-?: T[P] };
 type UnionToIntersection<U$1> = (U$1 extends any ? (k: U$1) => void : never) extends ((k: infer I) => void) ? I : never;
 type CamelCase<S extends string> = S extends `${infer Head} ${infer Tail}` ? `${Head}${Capitalize<CamelCase<Tail>>}` : S extends `${infer Head}-${infer Tail}` ? `${Head}${Capitalize<CamelCase<Tail>>}` : S;
 //#endregion
+//#region ../parser/src/iterator.d.ts
+declare const KNOWN_FLAG = "known-flag";
+declare const UNKNOWN_FLAG = "unknown-flag";
+declare const PARAMETER = "parameter";
+//#endregion
 //#region ../parser/src/types.d.ts
 interface FlagDefaultValueFunction<T> {
   (): T;
@@ -172,10 +161,40 @@ type _InferFlags<T extends FlagsDefinition> = { [K in keyof T]: IsTypeAny<T[K]>
 */
 type InferFlags<T extends FlagsDefinition> = Prettify<_InferFlags<T>>;
 //#endregion
-//#region ../parser/src/iterator.d.ts
-declare const KNOWN_FLAG = "known-flag";
-declare const UNKNOWN_FLAG = "unknown-flag";
-declare const PARAMETER = "parameter";
+//#region ../parser/src/flag-types.d.ts
+/**
+* Creates a Enum type function that validates the input against allowed values.
+* The display name will be formatted as "value1 | value2 | ..." for help output.
+*
+* @param values - Array of allowed string values
+* @returns A FlagTypeFunction that validates and returns the input value
+* @throws {Error} If the value is not in the allowed values list
+*
+* @example
+* ```typescript
+* const format = Enum(['json', 'yaml', 'xml']);
+* // Help output will show: json | yaml | xml
+* ```
+*/
+declare function Enum<T extends string>(...values: T[]): FlagTypeFunction<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 FlagTypeFunction 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): FlagTypeFunction<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 FlagTypeFunction that validates the input value
+* @throws {Error} If the value does not match the regex pattern
+*/
+declare function Regex(pattern: RegExp, description?: string): FlagTypeFunction<string>;
 //#endregion
 //#region ../parser/src/parse.d.ts
 declare const DOUBLE_DASH = "--";
@@ -185,7 +204,7 @@ declare function createParser<T extends FlagsDefinition>(options?: ParserOptions
 };
 declare const parse: <T extends FlagsDefinition>(args: string[], options?: ParserOptions<T>) => ParsedResult<InferFlags<T>>;
 declare namespace index_d_exports {
-  export { BaseFlagOptions, DOUBLE_DASH, Enum, FlagDefaultValue, FlagDefaultValueFunction, FlagDefinitionValue, FlagOptions, FlagType, FlagTypeFunction, FlagsDefinition, IgnoreFunction, InferFlags, InvalidSchemaError, KNOWN_FLAG, MissingRequiredFlagError, ObjectInputType, PARAMETER, ParsedResult, ParserOptions, RawInputType, UNKNOWN_FLAG, createParser, parse };
+  export { BaseFlagOptions, DOUBLE_DASH, Enum, FlagDefaultValue, FlagDefaultValueFunction, FlagDefinitionValue, FlagOptions, FlagType, FlagTypeFunction, FlagsDefinition, IgnoreFunction, InferFlags, InvalidSchemaError, KNOWN_FLAG, MissingRequiredFlagError, ObjectInputType, PARAMETER, ParsedResult, ParserOptions, Range, RawInputType, Regex, UNKNOWN_FLAG, createParser, parse };
 }
 //#endregion
 //#region src/types/clerc.d.ts
@@ -193,32 +212,20 @@ type ErrorHandler = (error: unknown) => void;
 //#endregion
 //#region src/types/flag.d.ts
 interface FlagCustomOptions {}
-type ClercFlagOptions = FlagOptions & FlagCustomOptions;
-type ClercGlobalFlagDefinitionValue = ClercFlagOptions | FlagType;
-type ClercFlagOptionsWithDescription = ClercFlagOptions & {
+type ClercFlagOptions = FlagOptions & {
   description?: string;
-};
-type ClercFlagsDefinition = Record<string, ClercFlagOptionsWithDescription>;
-//#endregion
-//#region src/types/constraint.d.ts
-/**
-* Creates an enum constraint function that validates the input against a set of allowed values.
-*
-* @template T - The union type of allowed string values. Just a marker type to help with inference.
-*/
-interface ConstraintFunction<T = string> {
-  (value: string): void;
-  display?: string;
-}
+} & FlagCustomOptions;
+type ClercFlagDefinitionValue = ClercFlagOptions | FlagType;
+type ClercFlagsDefinition = Record<string, ClercFlagDefinitionValue>;
 //#endregion
 //#region src/types/parameters.d.ts
 type InferStringParameter<T extends string, Type$1 = string> = T extends `<${infer Name extends string}...>` | `[${infer Name extends string}...]` ? Record<CamelCase<Name>, Type$1[]> : T extends `<${infer Name extends string}>` ? Record<CamelCase<Name>, Type$1> : T extends `[${infer Name extends string}]` ? Record<CamelCase<Name>, Type$1 | undefined> : never;
-type InferParameter<T extends Parameter> = T extends string ? InferStringParameter<T> : T extends ParameterDefinition ? T["constraint"] extends ConstraintFunction<infer U> ? InferStringParameter<T["key"], U> : InferStringParameter<T["key"]> : never;
+type InferParameter<T extends Parameter> = T extends string ? InferStringParameter<T> : T extends ParameterDefinition ? T["type"] extends FlagTypeFunction<infer U> ? InferStringParameter<T["key"], U> : InferStringParameter<T["key"]> : never;
 type InferParameters<T extends readonly Parameter[]> = T extends readonly (infer U extends Parameter)[] ? Prettify<UnionToIntersection<InferParameter<U>>> : never;
 interface ParameterDefinition {
   key: string;
   description?: string;
-  constraint?: ConstraintFunction;
+  type?: FlagTypeFunction;
 }
 type Parameter = string | ParameterDefinition;
 //#endregion
@@ -235,7 +242,7 @@ interface BaseContext<C extends Command = Command, GF extends ClercFlagsDefiniti
   ignored: string[];
   rawParsed: ParsedResult<InferFlagsWithGlobal<C, GF>>;
   missingParameters: boolean;
-  store: ContextStore;
+  store: Partial<ContextStore>;
 }
 //#endregion
 //#region src/types/command.d.ts
@@ -303,19 +310,19 @@ declare class Clerc<Commands extends CommandsRecord = {}, GlobalFlags extends Cl
   get _version(): string;
   get _commands(): CommandsMap;
   get _globalFlags(): GlobalFlags;
-  get store(): ContextStore;
+  get store(): Partial<ContextStore>;
   static create(options?: CreateOptions): Clerc;
   name(name: string): this;
   scriptName(scriptName: string): this;
   description(description: string): this;
   version(version: string): this;
   use(plugin: Plugin): this;
-  errorHandler(handler: ErrorHandler$1): this;
+  errorHandler(handler: ErrorHandler): this;
   command<Name$1 extends string, const Parameters extends readonly Parameter[], Flags extends ClercFlagsDefinition = {}>(command: CommandWithHandler<Name$1, Parameters, Flags>): Clerc<Commands & Record<string, CommandWithHandler<Name$1, Parameters, Flags>>, GlobalFlags>;
   command<Name$1 extends string, const Parameters extends readonly Parameter[], Flags extends ClercFlagsDefinition = {}>(name: Name$1 extends keyof Commands ? ["COMMAND ALREADY EXISTS"] : Name$1, options?: CommandOptions<Parameters, Flags>): Clerc<Commands & Record<Name$1, Command<Name$1, Parameters, Flags>>, GlobalFlags>;
   command<Name$1 extends string, const Parameters extends readonly Parameter[], Flags extends ClercFlagsDefinition = {}>(name: Name$1 extends keyof Commands ? ["COMMAND ALREADY EXISTS"] : Name$1, description: string, options?: CommandOptions<Parameters, Flags>): Clerc<Commands & Record<Name$1, Command<Name$1, Parameters, Flags>>, GlobalFlags>;
-  globalFlag<Name$1 extends string, Flag extends ClercGlobalFlagDefinitionValue>(name: Name$1, description: string, options: Flag): Clerc<Commands, GlobalFlags & Record<Name$1, Flag>>;
-  globalFlag<Name$1 extends string, Flag extends ClercGlobalFlagDefinitionValue>(name: Name$1, options: Flag): Clerc<Commands, GlobalFlags & Record<Name$1, Flag>>;
+  globalFlag<Name$1 extends string, Flag extends ClercFlagDefinitionValue>(name: Name$1, description: string, options: Flag): Clerc<Commands, GlobalFlags & Record<Name$1, Flag>>;
+  globalFlag<Name$1 extends string, Flag extends ClercFlagDefinitionValue>(name: Name$1, options: Flag): Clerc<Commands, GlobalFlags & Record<Name$1, Flag>>;
   interceptor(interceptor: Interceptor<Command, GlobalFlags>): this;
   on<Name$1 extends LiteralUnion<keyof Commands, string>>(name: Name$1, handler: CommandHandler<Commands[Name$1], GlobalFlags>): this;
   run(): Promise<void>;
@@ -324,45 +331,6 @@ declare class Clerc<Commands extends CommandsRecord = {}, GlobalFlags extends Cl
 //#endregion
 //#region src/commands.d.ts
 declare function resolveCommand(commandsMap: CommandsMap, parameters: string[]): [Command, string] | [undefined, undefined];
-declare namespace constraint_d_exports {
-  export { Custom, Enum$1 as Enum, Range, Regex };
-}
-/**
-* Creates an enum constraint function that validates the input against a set of allowed values.
-*
-* @param values - Array of allowed string values
-* @returns A ConstraintFunction that validates the input value
-* @throws {Error} If the value is not in the allowed values list
-*/
-declare function Enum$1<T extends string>(...values: T[]): ConstraintFunction<T>;
-/**
-* Creates a range constraint 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 ConstraintFunction 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): ConstraintFunction;
-/**
-* Creates a regex constraint 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 ConstraintFunction that validates the input value
-* @throws {Error} If the value does not match the regex pattern
-*/
-declare function Regex(pattern: RegExp, description?: string): ConstraintFunction;
-/**
-* Just an utility to create custom constraints, helps you set the display name.
-*
-* @param validator - A function that validates the input value. Should return true if valid, false or throw an error if invalid.
-* @param display - Optional display name for the constraint, useful in help output.
-* @param errorMessage - Optional function to generate a custom error message when validation fails.
-* @returns A ConstraintFunction that applies the custom validation logic.
-* @throws {Error} If the validator returns false or throws an error.
-*/
-declare function Custom(validator: (value: string) => boolean | void, display?: string, errorMessage?: (value: string) => string): ConstraintFunction;
 //#endregion
 //#region src/errors.d.ts
 declare class NoSuchCommandError extends Error {
@@ -382,7 +350,7 @@ declare class InvalidParametersError extends Error {
   constructor(message: string);
 }
 declare namespace flag_types_d_exports {
-  export { Enum };
+  export { Enum, Range, Regex };
 }
 //#endregion
 //#region src/helpers.d.ts
@@ -394,4 +362,203 @@ declare function createStopAtFirstParameter(): IgnoreFunction;
 //#region src/plugin.d.ts
 declare const definePlugin: (plugin: Plugin) => Plugin;
 //#endregion
-export { BaseContext, Clerc, ClercFlagOptions, ClercFlagOptionsWithDescription, ClercFlagsDefinition, ClercGlobalFlagDefinitionValue, Command, CommandCustomOptions, CommandHandler, CommandHandlerContext, CommandOptions, CommandWithHandler, CommandsMap, CommandsRecord, ConstraintFunction, constraint_d_exports as Constraints, ContextStore, type CreateOptions, DOUBLE_DASH, ErrorHandler, FlagCustomOptions, InferParameters, Interceptor, InterceptorContext, InterceptorHandler, InterceptorNext, InterceptorObject, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MakeEmitterEvents, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, Parameter, ParameterDefinition, type ParseOptions, type index_d_exports as Parser, Plugin, flag_types_d_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };
+//#region ../plugin-completions/src/index.d.ts
+declare module "@clerc/core" {
+  interface CommandCustomOptions {
+    /**
+    * Completions options for the command.
+    */
+    completions?: {
+      /**
+      * Whether to show the command in completions output.
+      *
+      * @default true
+      */
+      show?: boolean;
+    };
+  }
+}
+interface CompletionsPluginOptions {
+  /**
+  * Whether to register the `completions install` and `completions uninstall` commands.
+  * @default true
+  */
+  managementCommands?: boolean;
+}
+declare const completionsPlugin: (options?: CompletionsPluginOptions) => Plugin$1;
+//#endregion
+//#region ../plugin-friendly-error/src/index.d.ts
+interface FriendlyErrorPluginOptions {
+  target?: (str: string) => void;
+}
+declare const friendlyErrorPlugin: ({
+  target
+}?: FriendlyErrorPluginOptions) => Plugin$1;
+//#endregion
+//#region ../plugin-help/src/types.d.ts
+interface Formatters {
+  formatFlagType: (type: FlagType) => string;
+  formatFlagDefault: <T>(value: FlagDefaultValue<T>) => string;
+}
+/**
+* A group definition as a tuple of [key, displayName].
+* The key is used in help options to assign items to groups.
+* The displayName is shown in the help output.
+*/
+type GroupDefinition = [key: string, name: string];
+/**
+* Options for defining groups in help output.
+*/
+interface GroupsOptions {
+  /**
+  * Groups for commands.
+  * Each group is defined as `[key, name]`.
+  */
+  commands?: GroupDefinition[];
+  /**
+  * Groups for command-specific flags.
+  * Each group is defined as `[key, name]`.
+  */
+  flags?: GroupDefinition[];
+  /**
+  * Groups for global flags.
+  * Each group is defined as `[key, name]`.
+  */
+  globalFlags?: GroupDefinition[];
+}
+//#endregion
+//#region ../plugin-help/src/formatters.d.ts
+declare const defaultFormatters: Formatters;
+//#endregion
+//#region ../plugin-help/src/index.d.ts
+interface HelpOptions {
+  /**
+  * The group this item belongs to.
+  * The group must be defined in the `groups` option of `helpPlugin()`.
+  */
+  group?: string;
+}
+interface CommandHelpOptions extends HelpOptions {
+  /**
+  * Whether to show the command in help output.
+  *
+  * @default true
+  */
+  show?: boolean;
+  /**
+  * Notes to show in the help output.
+  */
+  notes?: string[];
+  /**
+  * Examples to show in the help output.
+  * Each example is a tuple of `[command, description]`.
+  */
+  examples?: [string, string][];
+}
+declare module "@clerc/core" {
+  interface CommandCustomOptions {
+    /**
+    * Help options for the command.
+    */
+    help?: CommandHelpOptions;
+  }
+  interface FlagCustomOptions {
+    /**
+    * Help options for the flag.
+    */
+    help?: HelpOptions;
+  }
+}
+interface HelpPluginOptions {
+  /**
+  * Whether to register the `help` command.
+  *
+  * @default true
+  */
+  command?: boolean;
+  /**
+  * Whether to register the `--help` global flag.
+  *
+  * @default true
+  */
+  flag?: boolean;
+  /**
+  * Whether to show help when no command is specified.
+  *
+  * @default true
+  */
+  showHelpWhenNoCommandSpecified?: boolean;
+  /**
+  * Notes to show in the help output.
+  */
+  notes?: string[];
+  /**
+  * Examples to show in the help output.
+  * Each example is a tuple of `[command, description]`.
+  */
+  examples?: [string, string][];
+  /**
+  * A banner to show before the help output.
+  */
+  banner?: string;
+  /**
+  * Custom formatters for rendering help.
+  */
+  formatters?: Partial<Formatters>;
+  /**
+  * Group definitions for commands and flags.
+  * Groups allow organizing commands and flags into logical sections in help output.
+  * Each group is defined as `[key, name]` where `key` is the identifier used in help options
+  * and `name` is the display name shown in help output.
+  */
+  groups?: GroupsOptions;
+}
+declare const helpPlugin: ({
+  command,
+  flag,
+  showHelpWhenNoCommandSpecified,
+  notes,
+  examples,
+  banner,
+  formatters,
+  groups
+}?: HelpPluginOptions) => Plugin$1;
+//#endregion
+//#region ../plugin-not-found/src/index.d.ts
+declare const notFoundPlugin: () => Plugin$1;
+//#endregion
+//#region ../plugin-strict-flags/src/index.d.ts
+declare const strictFlagsPlugin: () => Plugin$1;
+//#endregion
+//#region ../plugin-version/src/index.d.ts
+interface VersionPluginOptions {
+  /**
+  * Whether to register the version command.
+  *
+  * @default true
+  */
+  command?: boolean;
+  /**
+  * Whether to register the global version flag.
+  *
+  * @default true
+  */
+  flag?: boolean;
+}
+declare const versionPlugin: ({
+  command,
+  flag
+}?: VersionPluginOptions) => Plugin$1;
+declare namespace re_exports_d_exports {
+  export { CommandHelpOptions, CompletionsPluginOptions, FriendlyErrorPluginOptions, GroupDefinition, GroupsOptions, HelpOptions, HelpPluginOptions, completionsPlugin, defaultFormatters, friendlyErrorPlugin, helpPlugin, notFoundPlugin, strictFlagsPlugin, versionPlugin };
+}
+import * as import___clerc_core from "@clerc/core";
+declare namespace index_d_exports$1 {
+  export { Cli, CommandHelpOptions, CompletionsPluginOptions, FriendlyErrorPluginOptions, GroupDefinition, GroupsOptions, HelpOptions, HelpPluginOptions, completionsPlugin, defaultFormatters, friendlyErrorPlugin, helpPlugin, notFoundPlugin, strictFlagsPlugin, versionPlugin };
+}
+declare const Cli: (options?: CreateOptions$1) => Clerc$1;
+//#endregion
+//#region src/utils.d.ts
+declare const normalizeFlagValue: (flag: index_d_exports$1.ClercFlagDefinitionValue) => index_d_exports$1.ClercFlagOptions;
+//#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, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, Parameter, ParameterDefinition, type ParseOptions, type index_d_exports as Parser, Plugin, flag_types_d_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, normalizeFlagValue, resolveCommand };

package/dist/index.js

@@ -1,8 +1,9 @@
-import { t as __export } from "./chunk-BAz01cYq.js";
-import { DOUBLE_DASH, DOUBLE_DASH as DOUBLE_DASH$1, Enum, InvalidSchemaError, KNOWN_FLAG, PARAMETER, PARAMETER as PARAMETER$1, UNKNOWN_FLAG, parse } from "@clerc/parser";
+import { t as __export } from "./chunk-CYeTv9WL.js";
+import { DOUBLE_DASH, DOUBLE_DASH as DOUBLE_DASH$1, Enum, InvalidSchemaError, KNOWN_FLAG, PARAMETER, PARAMETER as PARAMETER$1, Range, Regex, UNKNOWN_FLAG, parse } from "@clerc/parser";
 import { LiteEmit } from "lite-emit";
 
 //#region ../utils/src/index.ts
+const looseIsArray = (arr) => Array.isArray(arr);
 const toArray = (a) => Array.isArray(a) ? a : [a];
 /**
 * Converts a dash- or space-separated string to camelCase.
@@ -125,11 +126,10 @@ function _parseParameters(definitions, parameters) {
 		} 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 (typeof definition !== "string" && definition.constraint) {
-			if (isVariadic) for (const v of value) definition.constraint(v);
-			else if (value !== void 0) definition.constraint(value);
-		}
-		result[name] = value;
+		if (typeof definition !== "string" && definition.type) if (isVariadic) result[name] = value.map((v) => definition.type(v));
+		else if (value === void 0) result[name] = value;
+		else result[name] = definition.type(value);
+		else result[name] = value;
 	}
 	return result;
 }
@@ -161,7 +161,7 @@ const platformArgv = IS_NODE ? process.argv.slice(IS_ELECTRON ? 1 : 2) : IS_DENO
 var Clerc = class Clerc {
 	#argv = [];
 	#commands = /* @__PURE__ */ new Map();
-	#emitter = new LiteEmit({ errorHandler: (error) => this.#handleError(error) });
+	#emitter = new LiteEmit();
 	#globalFlags = {};
 	#store = {};
 	#interceptors = [];
@@ -316,9 +316,9 @@ var Clerc = class Clerc {
 		};
 		const emitInterceptor = {
 			enforce: "post",
-			handler: (ctx) => {
+			handler: async (ctx) => {
 				if (parametersError) throw parametersError;
-				if (command) this.#emitter.emit(command.name, ctx);
+				if (command) await this.#emitter.emit(command.name, ctx);
 				else throw parametersToResolve.length > 0 ? new NoSuchCommandError(parametersToResolve.join(" ")) : new NoCommandSpecifiedError();
 			}
 		};
@@ -336,78 +336,12 @@ var Clerc = class Clerc {
 };
 
 //#endregion
-//#region src/constraint.ts
-var constraint_exports = /* @__PURE__ */ __export({
-	Custom: () => Custom,
-	Enum: () => Enum$1,
+//#region src/flag-types.ts
+var flag_types_exports = /* @__PURE__ */ __export({
+	Enum: () => Enum,
 	Range: () => Range,
 	Regex: () => Regex
 });
-/**
-* Creates an enum constraint function that validates the input against a set of allowed values.
-*
-* @param values - Array of allowed string values
-* @returns A ConstraintFunction that validates the input value
-* @throws {Error} If the value is not in the allowed values list
-*/
-function Enum$1(...values) {
-	function fn(value) {
-		if (!values.includes(value)) throw new Error(`Invalid value: ${value}. Must be one of: ${values.join(", ")}`);
-	}
-	fn.display = values.join(" | ");
-	return fn;
-}
-/**
-* Creates a range constraint 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 ConstraintFunction that validates the input value
-* @throws {Error} If the value is not a number or is outside the specified range
-*/
-function Range(min, max) {
-	function fn(value) {
-		const num = Number(value);
-		if (Number.isNaN(num) || num < min || num > max) throw new Error(`Invalid value: ${value}. Must be a number between ${min} and ${max}`);
-	}
-	fn.display = `${min}-${max}`;
-	return fn;
-}
-/**
-* Creates a regex constraint 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 ConstraintFunction that validates the input value
-* @throws {Error} If the value does not match the regex pattern
-*/
-function Regex(pattern, description) {
-	function fn(value) {
-		if (!pattern.test(value)) throw new Error(`Invalid value: ${value}. Must match pattern: ${pattern}`);
-	}
-	fn.display = description ?? pattern.toString();
-	return fn;
-}
-/**
-* Just an utility to create custom constraints, helps you set the display name.
-*
-* @param validator - A function that validates the input value. Should return true if valid, false or throw an error if invalid.
-* @param display - Optional display name for the constraint, useful in help output.
-* @param errorMessage - Optional function to generate a custom error message when validation fails.
-* @returns A ConstraintFunction that applies the custom validation logic.
-* @throws {Error} If the validator returns false or throws an error.
-*/
-function Custom(validator, display, errorMessage) {
-	function fn(value) {
-		if (validator(value) === false) throw new Error(errorMessage ? errorMessage(value) : `Invalid value: ${value}`);
-	}
-	fn.display = display;
-	return fn;
-}
-
-//#endregion
-//#region src/flag-types.ts
-var flag_types_exports = /* @__PURE__ */ __export({ Enum: () => Enum });
 
 //#endregion
 //#region src/helpers.ts
@@ -434,4 +368,8 @@ function createStopAtFirstParameter() {
 const definePlugin = (plugin) => plugin;
 
 //#endregion
-export { Clerc, constraint_exports as Constraints, DOUBLE_DASH, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, flag_types_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };
+//#region src/utils.ts
+const normalizeFlagValue = (flag) => typeof flag === "function" || looseIsArray(flag) ? { type: flag } : flag;
+
+//#endregion
+export { Clerc, DOUBLE_DASH, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, flag_types_exports as Types, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, normalizeFlagValue, resolveCommand };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "1.0.0-beta.17",
+  "version": "1.0.0-beta.19",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc core",
@@ -44,11 +44,11 @@
     "access": "public"
   },
   "dependencies": {
-    "lite-emit": "^3.1.0",
-    "@clerc/parser": "^1.0.0-beta.17"
+    "lite-emit": "^4.0.0",
+    "@clerc/parser": "^1.0.0-beta.19"
   },
   "devDependencies": {
     "is-platform": "^1.0.0",
-    "@clerc/utils": "1.0.0-beta.17"
+    "@clerc/utils": "1.0.0-beta.19"
   }
 }

package/dist/chunk-BAz01cYq.js

@@ -1,18 +0,0 @@
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __export = (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 { __export as t };