@clerc/core 0.22.0 → 0.23.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _clerc_utils from '@clerc/utils';
-import { MaybeArray, Dict, CamelCase, LiteralUnion } from '@clerc/utils';
+import { Dict, MaybeArray as MaybeArray$1, CamelCase, LiteralUnion } from '@clerc/utils';
 
 declare const DOUBLE_DASH = "--";
 type TypeFunction<ReturnType = any> = (value: any) => ReturnType;
@@ -56,7 +56,7 @@ type FlagSchemaDefault<TF, DefaultType = any> = FlagSchemaBase<TF> & {
 };
 type FlagSchema<TF = FlagType> = (FlagSchemaBase<TF> | FlagSchemaDefault<TF>);
 type FlagTypeOrSchema<ExtraOptions = Record<string, unknown>> = FlagType | (FlagSchema & ExtraOptions);
-type Flags<ExtraOptions = Record<string, unknown>> = Record<string, FlagTypeOrSchema<ExtraOptions>>;
+type Flags$1<ExtraOptions = Record<string, unknown>> = Record<string, FlagTypeOrSchema<ExtraOptions>>;
 type InferFlagType<Flag extends FlagTypeOrSchema> = (Flag extends (TypeFunctionArray<infer T> | FlagSchema<TypeFunctionArray<infer T>>) ? (Flag extends FlagSchemaDefault<TypeFunctionArray<T>, infer D> ? T[] | D : T[]) : (Flag extends TypeFunction<infer T> | FlagSchema<TypeFunction<infer T>> ? (Flag extends FlagSchemaDefault<TypeFunction<T>, infer D> ? T | D : T | undefined) : never));
 interface ParsedFlags<Schemas = Record<string, unknown>> {
     flags: Schemas;
@@ -65,7 +65,7 @@ interface ParsedFlags<Schemas = Record<string, unknown>> {
         [DOUBLE_DASH]: string[];
     };
 }
-type TypeFlag<Schemas extends Flags> = ParsedFlags<{
+type TypeFlag<Schemas extends Flags$1> = ParsedFlags<{
     [flag in keyof Schemas]: InferFlagType<Schemas[flag]>;
 }>;
 
@@ -76,9 +76,10 @@ type FlagOptions = FlagSchema & {
 type Flag = FlagOptions & {
     name: string;
 };
+type Flags = Dict<FlagOptions>;
 declare interface CommandCustomProperties {
 }
-interface CommandOptions<P extends string[] = string[], A extends MaybeArray<string | RootType> = MaybeArray<string | RootType>, F extends Dict<FlagOptions> = Dict<FlagOptions>> extends CommandCustomProperties {
+interface CommandOptions<P extends string[] = string[], A extends MaybeArray$1<string | RootType> = MaybeArray$1<string | RootType>, F extends Flags = Flags> extends CommandCustomProperties {
     alias?: A;
     parameters?: P;
     flags?: F;
@@ -93,7 +94,7 @@ type CommandAlias<N extends string | RootType = string, O extends CommandOptions
     __isAlias?: true;
 };
 type CommandWithHandler<N extends string | RootType = string, O extends CommandOptions = CommandOptions> = Command<N, O> & {
-    handler?: HandlerInCommand<Record<N, Command<N, O>> & Record<never, never>, N>;
+    handler?: HandlerInCommand<HandlerContext<Record<N, Command<N, O>> & Record<never, never>, N>>;
 };
 type StripBrackets<Parameter extends string> = (Parameter extends `<${infer ParameterName}>` | `[${infer ParameterName}]` ? (ParameterName extends `${infer SpreadName}...` ? SpreadName : ParameterName) : never);
 type ParameterType<Parameter extends string> = (Parameter extends `<${infer _ParameterName}...>` | `[${infer _ParameterName}...]` ? string[] : Parameter extends `<${infer _ParameterName}>` ? string : Parameter extends `[${infer _ParameterName}]` ? string | undefined : never);
@@ -105,34 +106,33 @@ type MakeEventMap<T extends CommandRecord> = {
 };
 type PossibleInputKind = string | number | boolean | Dict<any>;
 type NonNullableParameters<T extends string[] | undefined> = T extends undefined ? [] : NonNullable<T>;
-type TransformParameters<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> = {
-    [Parameter in [...NonNullableParameters<C[N]["parameters"]>][number] as CamelCase<StripBrackets<Parameter>>]: ParameterType<Parameter>;
+type TransformParameters<C extends Command> = {
+    [Parameter in NonNullableParameters<C["parameters"]>[number] as CamelCase<StripBrackets<Parameter>>]: ParameterType<Parameter>;
 };
-type TransformFlags<F extends Record<string, FlagSchema>> = {
-    [K in keyof F]: F[K]["type"] extends any[] ? F[K]["default"] extends never[] ? F[K] & {
-        default: any[];
-    } : F[K] : F[K];
-};
-type TypeFlagWithDefault<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> = TypeFlag<TransformFlags<NonNullable<C[N]["flags"]>>>;
-type Raw<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> = TypeFlagWithDefault<C, N> & {
+type TypeFlagWithDefault<C extends Command> = TypeFlag<NonNullable<C["flags"]>>;
+type Raw<C extends Command> = TypeFlagWithDefault<C> & {
     parameters: string[];
-    mergedFlags: TypeFlagWithDefault<C, N>["flags"] & TypeFlagWithDefault<C, N>["unknownFlags"];
+    mergedFlags: TypeFlagWithDefault<C>["flags"] & TypeFlagWithDefault<C>["unknownFlags"];
 };
 interface HandlerContext<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> {
-    name: N extends keyof C ? N : N | undefined;
+    name?: N;
     called?: string | RootType;
-    resolved: N extends keyof C ? true : boolean;
+    resolved: boolean;
     hasRootOrAlias: boolean;
     hasRoot: boolean;
-    raw: Raw<C, N>;
-    parameters: TransformParameters<C, N>;
+    raw: {
+        [K in keyof Raw<C[N]>]: Raw<C[N]>[K];
+    };
+    parameters: {
+        [K in keyof TransformParameters<C[N]>]: TransformParameters<C[N]>[K];
+    };
     unknownFlags: ParsedFlags["unknownFlags"];
-    flags: TypeFlagWithDefault<C, N>["flags"];
+    flags: TypeFlagWithDefault<C[N]>["flags"];
     cli: Clerc<C>;
 }
 type Handler<C extends CommandRecord = CommandRecord, K extends keyof C = keyof C> = (ctx: HandlerContext<C, K>) => void;
-type HandlerInCommand<C extends CommandRecord = CommandRecord, K extends keyof C = keyof C> = (ctx: HandlerContext<C, K> & {
-    name: K;
+type HandlerInCommand<C extends HandlerContext> = (ctx: {
+    [K in keyof C]: C[K];
 }) => void;
 type FallbackType<T, U> = {} extends T ? U : T;
 type InspectorContext<C extends CommandRecord = CommandRecord> = HandlerContext<C> & {
@@ -230,8 +230,8 @@ declare class Clerc<C extends CommandRecord = {}> {
      *   })
      * ```
      */
-    command<N extends string | RootType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string | RootType> = MaybeArray<string | RootType>, F extends Dict<FlagOptions> = Dict<FlagOptions>>(c: CommandWithHandler<N, O & CommandOptions<[...P], A, F>>): this & Clerc<C & Record<N, Command<N, O>>>;
-    command<N extends string | RootType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string | RootType> = MaybeArray<string | RootType>, F extends Dict<FlagOptions> = Dict<FlagOptions>>(name: N, description: string, options?: O & CommandOptions<[...P], A, F>): this & Clerc<C & Record<N, Command<N, O>>>;
+    command<N extends string | RootType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray$1<string | RootType> = MaybeArray$1<string | RootType>, F extends Flags = Flags>(c: CommandWithHandler<N, O & CommandOptions<[...P], A, F>>): this & Clerc<C & Record<N, Command<N, O>>>;
+    command<N extends string | RootType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray$1<string | RootType> = MaybeArray$1<string | RootType>, F extends Flags = Flags>(name: N, description: string, options?: O & CommandOptions<[...P], A, F>): this & Clerc<C & Record<N, Command<N, O>>>;
     /**
      * Register a handler
      * @param name
@@ -285,18 +285,20 @@ declare class Clerc<C extends CommandRecord = {}> {
     parse(argv?: string[]): this;
 }
 
+type MaybeArray<T> = T | T[];
+
 declare const definePlugin: <T extends Clerc<{}>, U extends Clerc<{}>>(p: Plugin<T, U>) => Plugin<T, U>;
 declare const defineHandler: <C extends Clerc<{}>, K extends keyof C["_commands"]>(_cli: C, _key: K, handler: Handler<C["_commands"], K>) => Handler<C["_commands"], K>;
 declare const defineInspector: <C extends Clerc<{}>>(_cli: C, inspector: Inspector<C["_commands"]>) => Inspector<C["_commands"]>;
-declare const defineCommand: <N extends string | typeof Root, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string> = MaybeArray<string>, F extends Dict<FlagOptions> = Dict<FlagOptions>>(command: CommandWithHandler<N, O & CommandOptions<[...P], A, F>>) => CommandWithHandler<N, O & CommandOptions<[...P], A, F>>;
+declare const defineCommand: <N extends string | typeof Root, O extends CommandOptions<[...P], MaybeArray<string | typeof Root>, Flags>, P extends string[]>(command: Command<N, O & CommandOptions<[...P], MaybeArray<string | typeof Root>, Flags>>, handler?: HandlerInCommand<HandlerContext<Record<N, Command<N, O>> & Record<never, never>, N>> | undefined) => CommandWithHandler<N, O & CommandOptions<[...P], MaybeArray<string | typeof Root>, Flags>>;
 
 declare class CommandExistsError extends Error {
-    name: string;
-    constructor(name: string);
+    commandName: string;
+    constructor(commandName: string);
 }
 declare class NoSuchCommandError extends Error {
-    name: string;
-    constructor(name: string);
+    commandName: string;
+    constructor(commandName: string);
 }
 declare class NoCommandGivenError extends Error {
     constructor();
@@ -316,25 +318,19 @@ declare class VersionNotSetError extends Error {
     constructor();
 }
 declare class InvalidCommandNameError extends Error {
-    name: string;
-    constructor(name: string);
+    commandName: string;
+    constructor(commandName: string);
 }
 
-declare function resolveFlattenCommands(commands: CommandRecord): Map<string[] | typeof Root, CommandAlias<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, _clerc_utils.Dict<FlagOptions>>>>;
+declare function resolveFlattenCommands(commands: CommandRecord): Map<string[] | typeof Root, CommandAlias<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, Flags>>>;
 declare function resolveCommand(commands: CommandRecord, name: string | string[] | RootType): Command<string | RootType> | undefined;
-declare function resolveSubcommandsByParent(commands: CommandRecord, parent: string | string[], depth?: number): Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, _clerc_utils.Dict<FlagOptions>>>[];
-declare const resolveRootCommands: (commands: CommandRecord) => Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, _clerc_utils.Dict<FlagOptions>>>[];
+declare function resolveSubcommandsByParent(commands: CommandRecord, parent: string | string[], depth?: number): Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, Flags>>[];
+declare const resolveRootCommands: (commands: CommandRecord) => Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof Root>, Flags>>[];
 declare function resolveParametersBeforeFlag(argv: string[]): string[];
 declare const resolveArgv: () => string[];
 declare function compose(inspectors: Inspector[]): (getCtx: () => InspectorContext) => void;
-declare const isInvalidName: (name: CommandType) => boolean;
-
-interface ParsedParameter {
-    name: string;
-    required: boolean;
-    spread: boolean;
-}
-declare function parseParameters(parameters: string[]): ParsedParameter[];
-declare function mapParametersToArguments(mapping: Record<string, string | string[]>, parameters: ParsedParameter[], cliArguments: string[]): Error | undefined;
+declare const isInvalidName: (name: CommandType) => boolean;
+declare const withBrackets: (s: string, isOptional?: boolean) => string;
+declare const formatCommandName: (name: string | string[] | RootType) => string;
 
-export { Clerc, Command, CommandAlias, CommandCustomProperties, CommandExistsError, CommandNameConflictError, CommandOptions, CommandRecord, CommandType, CommandWithHandler, DescriptionNotSetError, FallbackType, Flag, FlagOptions, Handler, HandlerContext, HandlerInCommand, Inspector, InspectorContext, InspectorFn, InspectorObject, InvalidCommandNameError, MakeEventMap, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Plugin, PossibleInputKind, Root, RootType, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };
+export { Clerc, Command, CommandAlias, CommandCustomProperties, CommandExistsError, CommandNameConflictError, CommandOptions, CommandRecord, CommandType, CommandWithHandler, DescriptionNotSetError, FallbackType, Flag, FlagOptions, Flags, Handler, HandlerContext, HandlerInCommand, Inspector, InspectorContext, InspectorFn, InspectorObject, InvalidCommandNameError, MakeEventMap, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Plugin, PossibleInputKind, Root, RootType, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, formatCommandName, isInvalidName, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent, withBrackets };

package/dist/index.js

@@ -4,15 +4,15 @@ import { toArray, arrayStartsWith, camelCase } from '@clerc/utils';
 import { isNode, isDeno } from 'is-platform';
 
 class CommandExistsError extends Error {
-  constructor(name) {
-    super(`Command "${name}" exists.`);
-    this.name = name;
+  constructor(commandName) {
+    super(`Command "${commandName}" exists.`);
+    this.commandName = commandName;
   }
 }
 class NoSuchCommandError extends Error {
-  constructor(name) {
-    super(`No such command: ${name}`);
-    this.name = name;
+  constructor(commandName) {
+    super(`No such command: ${commandName}`);
+    this.commandName = commandName;
   }
 }
 class NoCommandGivenError extends Error {
@@ -43,9 +43,9 @@ class VersionNotSetError extends Error {
   }
 }
 class InvalidCommandNameError extends Error {
-  constructor(name) {
-    super(`Bad name format: ${name}`);
-    this.name = name;
+  constructor(commandName) {
+    super(`Bad name format: ${commandName}`);
+    this.commandName = commandName;
   }
 }
 
@@ -113,18 +113,24 @@ function resolveParametersBeforeFlag(argv) {
 }
 const resolveArgv = () => isNode() ? process.argv.slice(2) : isDeno() ? Deno.args : [];
 function compose(inspectors) {
-  const preInspectors = [];
-  const normalInspectors = [];
-  const postInspectors = [];
+  const inspectorMap = {
+    pre: [],
+    normal: [],
+    post: []
+  };
   for (const inspector of inspectors) {
     const objectInspector = typeof inspector === "object" ? inspector : { fn: inspector };
-    const { enforce } = objectInspector;
-    (enforce === "pre" ? preInspectors : enforce === "post" ? postInspectors : normalInspectors).push(objectInspector.fn);
+    const { enforce, fn } = objectInspector;
+    if (enforce === "post" || enforce === "pre") {
+      inspectorMap[enforce].push(fn);
+    } else {
+      inspectorMap.normal.push(fn);
+    }
   }
   const mergedInspectorFns = [
-    ...preInspectors,
-    ...normalInspectors,
-    ...postInspectors
+    ...inspectorMap.pre,
+    ...inspectorMap.normal,
+    ...inspectorMap.post
   ];
   return (getCtx) => {
     return dispatch(0);
@@ -135,6 +141,9 @@ function compose(inspectors) {
   };
 }
 const isInvalidName = (name) => typeof name === "string" && (name.startsWith(" ") || name.endsWith(" "));
+const withBrackets = (s, isOptional) => isOptional ? `[${s}]` : `<${s}>`;
+const ROOT = "<Root>";
+const formatCommandName = (name) => Array.isArray(name) ? name.join(" ") : typeof name === "string" ? name : ROOT;
 
 const { stringify } = JSON;
 function parseParameters(parameters) {
@@ -223,7 +232,7 @@ const _Clerc = class {
     __privateAdd(this, _inspectors, []);
     __privateAdd(this, _commands, {});
     __privateAdd(this, _commandEmitter, new LiteEmit());
-    __privateAdd(this, _usedNames, []);
+    __privateAdd(this, _usedNames, /* @__PURE__ */ new Set());
     __privateSet(this, _name, name || __privateGet(this, _name));
     __privateSet(this, _description, description || __privateGet(this, _description));
     __privateSet(this, _version, version || __privateGet(this, _version));
@@ -262,9 +271,6 @@ const _Clerc = class {
     const checkIsCommandObject = (nameOrCommand2) => !(typeof nameOrCommand2 === "string" || nameOrCommand2 === Root);
     const isCommandObject = checkIsCommandObject(nameOrCommand);
     const name = !isCommandObject ? nameOrCommand : nameOrCommand.name;
-    if (__privateGet(this, _commands)[name]) {
-      throw new CommandExistsError(typeof name === "symbol" ? "" : name);
-    }
     if (isInvalidName(name)) {
       throw new InvalidCommandNameError(name);
     }
@@ -272,12 +278,13 @@ const _Clerc = class {
     const nameList = [commandToSave.name];
     commandToSave.alias && nameList.push(...toArray(commandToSave.alias));
     for (const name2 of nameList) {
-      if (__privateGet(this, _usedNames).includes(name2)) {
-        throw new CommandExistsError(name2);
+      if (__privateGet(this, _usedNames).has(name2)) {
+        throw new CommandExistsError(formatCommandName(name2));
       }
     }
     __privateGet(this, _commands)[name] = commandToSave;
-    __privateGet(this, _usedNames).push(commandToSave.name, ...toArray(commandToSave.alias) || []);
+    __privateGet(this, _usedNames).add(commandToSave.name);
+    (toArray(commandToSave.alias) || []).forEach((a) => __privateGet(this, _usedNames).add(a));
     isCommandObject && handler && this.on(nameOrCommand.name, handler);
     return this;
   }
@@ -341,7 +348,7 @@ const _Clerc = class {
       const mergedFlags = { ...flags, ...unknownFlags };
       const context = {
         name: command == null ? void 0 : command.name,
-        called: name.length === 0 ? Root : stringName,
+        called: name.length === 0 && (command == null ? void 0 : command.name) ? Root : stringName,
         resolved: isCommandResolved,
         hasRootOrAlias: __privateGet(this, _hasRootOrAlias, hasRootOrAlias_get),
         hasRoot: __privateGet(this, _hasRoot, hasRoot_get),
@@ -388,16 +395,16 @@ _commandEmitter = new WeakMap();
 _usedNames = new WeakMap();
 _hasRootOrAlias = new WeakSet();
 hasRootOrAlias_get = function() {
-  return __privateGet(this, _usedNames).includes(Root);
+  return __privateGet(this, _usedNames).has(Root);
 };
 _hasRoot = new WeakSet();
 hasRoot_get = function() {
-  return !!__privateGet(this, _commands)[Root];
+  return Object.prototype.hasOwnProperty.call(this._commands, Root);
 };
 
 const definePlugin = (p) => p;
 const defineHandler = (_cli, _key, handler) => handler;
 const defineInspector = (_cli, inspector) => inspector;
-const defineCommand = (command) => command;
+const defineCommand = (command, handler) => ({ ...command, handler });
 
-export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Root, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };
+export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Root, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, formatCommandName, isInvalidName, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent, withBrackets };

package/dist/index.mjs

@@ -4,15 +4,15 @@ import { toArray, arrayStartsWith, camelCase } from '@clerc/utils';
 import { isNode, isDeno } from 'is-platform';
 
 class CommandExistsError extends Error {
-  constructor(name) {
-    super(`Command "${name}" exists.`);
-    this.name = name;
+  constructor(commandName) {
+    super(`Command "${commandName}" exists.`);
+    this.commandName = commandName;
   }
 }
 class NoSuchCommandError extends Error {
-  constructor(name) {
-    super(`No such command: ${name}`);
-    this.name = name;
+  constructor(commandName) {
+    super(`No such command: ${commandName}`);
+    this.commandName = commandName;
   }
 }
 class NoCommandGivenError extends Error {
@@ -43,9 +43,9 @@ class VersionNotSetError extends Error {
   }
 }
 class InvalidCommandNameError extends Error {
-  constructor(name) {
-    super(`Bad name format: ${name}`);
-    this.name = name;
+  constructor(commandName) {
+    super(`Bad name format: ${commandName}`);
+    this.commandName = commandName;
   }
 }
 
@@ -113,18 +113,24 @@ function resolveParametersBeforeFlag(argv) {
 }
 const resolveArgv = () => isNode() ? process.argv.slice(2) : isDeno() ? Deno.args : [];
 function compose(inspectors) {
-  const preInspectors = [];
-  const normalInspectors = [];
-  const postInspectors = [];
+  const inspectorMap = {
+    pre: [],
+    normal: [],
+    post: []
+  };
   for (const inspector of inspectors) {
     const objectInspector = typeof inspector === "object" ? inspector : { fn: inspector };
-    const { enforce } = objectInspector;
-    (enforce === "pre" ? preInspectors : enforce === "post" ? postInspectors : normalInspectors).push(objectInspector.fn);
+    const { enforce, fn } = objectInspector;
+    if (enforce === "post" || enforce === "pre") {
+      inspectorMap[enforce].push(fn);
+    } else {
+      inspectorMap.normal.push(fn);
+    }
   }
   const mergedInspectorFns = [
-    ...preInspectors,
-    ...normalInspectors,
-    ...postInspectors
+    ...inspectorMap.pre,
+    ...inspectorMap.normal,
+    ...inspectorMap.post
   ];
   return (getCtx) => {
     return dispatch(0);
@@ -135,6 +141,9 @@ function compose(inspectors) {
   };
 }
 const isInvalidName = (name) => typeof name === "string" && (name.startsWith(" ") || name.endsWith(" "));
+const withBrackets = (s, isOptional) => isOptional ? `[${s}]` : `<${s}>`;
+const ROOT = "<Root>";
+const formatCommandName = (name) => Array.isArray(name) ? name.join(" ") : typeof name === "string" ? name : ROOT;
 
 const { stringify } = JSON;
 function parseParameters(parameters) {
@@ -223,7 +232,7 @@ const _Clerc = class {
     __privateAdd(this, _inspectors, []);
     __privateAdd(this, _commands, {});
     __privateAdd(this, _commandEmitter, new LiteEmit());
-    __privateAdd(this, _usedNames, []);
+    __privateAdd(this, _usedNames, /* @__PURE__ */ new Set());
     __privateSet(this, _name, name || __privateGet(this, _name));
     __privateSet(this, _description, description || __privateGet(this, _description));
     __privateSet(this, _version, version || __privateGet(this, _version));
@@ -262,9 +271,6 @@ const _Clerc = class {
     const checkIsCommandObject = (nameOrCommand2) => !(typeof nameOrCommand2 === "string" || nameOrCommand2 === Root);
     const isCommandObject = checkIsCommandObject(nameOrCommand);
     const name = !isCommandObject ? nameOrCommand : nameOrCommand.name;
-    if (__privateGet(this, _commands)[name]) {
-      throw new CommandExistsError(typeof name === "symbol" ? "" : name);
-    }
     if (isInvalidName(name)) {
       throw new InvalidCommandNameError(name);
     }
@@ -272,12 +278,13 @@ const _Clerc = class {
     const nameList = [commandToSave.name];
     commandToSave.alias && nameList.push(...toArray(commandToSave.alias));
     for (const name2 of nameList) {
-      if (__privateGet(this, _usedNames).includes(name2)) {
-        throw new CommandExistsError(name2);
+      if (__privateGet(this, _usedNames).has(name2)) {
+        throw new CommandExistsError(formatCommandName(name2));
       }
     }
     __privateGet(this, _commands)[name] = commandToSave;
-    __privateGet(this, _usedNames).push(commandToSave.name, ...toArray(commandToSave.alias) || []);
+    __privateGet(this, _usedNames).add(commandToSave.name);
+    (toArray(commandToSave.alias) || []).forEach((a) => __privateGet(this, _usedNames).add(a));
     isCommandObject && handler && this.on(nameOrCommand.name, handler);
     return this;
   }
@@ -341,7 +348,7 @@ const _Clerc = class {
       const mergedFlags = { ...flags, ...unknownFlags };
       const context = {
         name: command == null ? void 0 : command.name,
-        called: name.length === 0 ? Root : stringName,
+        called: name.length === 0 && (command == null ? void 0 : command.name) ? Root : stringName,
         resolved: isCommandResolved,
         hasRootOrAlias: __privateGet(this, _hasRootOrAlias, hasRootOrAlias_get),
         hasRoot: __privateGet(this, _hasRoot, hasRoot_get),
@@ -388,16 +395,16 @@ _commandEmitter = new WeakMap();
 _usedNames = new WeakMap();
 _hasRootOrAlias = new WeakSet();
 hasRootOrAlias_get = function() {
-  return __privateGet(this, _usedNames).includes(Root);
+  return __privateGet(this, _usedNames).has(Root);
 };
 _hasRoot = new WeakSet();
 hasRoot_get = function() {
-  return !!__privateGet(this, _commands)[Root];
+  return Object.prototype.hasOwnProperty.call(this._commands, Root);
 };
 
 const definePlugin = (p) => p;
 const defineHandler = (_cli, _key, handler) => handler;
 const defineInspector = (_cli, inspector) => inspector;
-const defineCommand = (command) => command;
+const defineCommand = (command, handler) => ({ ...command, handler });
 
-export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Root, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };
+export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Root, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, formatCommandName, isInvalidName, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent, withBrackets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "author": "Ray <nn_201312@163.com> (https://github.com/so1ve)",
   "description": "Clerc core",
   "keywords": [
@@ -50,7 +50,7 @@
     "is-platform": "^0.2.0",
     "lite-emit": "^1.4.0",
     "type-flag": "^3.0.0",
-    "@clerc/utils": "0.22.0"
+    "@clerc/utils": "0.23.0"
   },
   "scripts": {
     "build": "puild",