@clerc/core 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -78,7 +78,7 @@ type Flag = FlagOptions & {
 };
 declare interface CommandCustomProperties {
 }
-interface CommandOptions<P extends string[] = string[], A extends MaybeArray<string> = MaybeArray<string>, F extends Dict<FlagOptions> = Dict<FlagOptions>> extends CommandCustomProperties {
+interface CommandOptions<P extends string[] = string[], A extends MaybeArray<string | SingleCommandType> = MaybeArray<string | SingleCommandType>, F extends Dict<FlagOptions> = Dict<FlagOptions>> extends CommandCustomProperties {
     alias?: A;
     parameters?: P;
     flags?: F;
@@ -120,8 +120,10 @@ type Raw<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> =
 };
 interface HandlerContext<C extends CommandRecord = CommandRecord, N extends keyof C = keyof C> {
     name: N extends keyof C ? N : N | undefined;
+    called?: string | SingleCommandType;
     resolved: N extends keyof C ? true : boolean;
-    isSingleCommand: boolean;
+    hasSingleCommandOrAlias: boolean;
+    hasSingleCommand: boolean;
     raw: Raw<C, N>;
     parameters: TransformParameters<C, N>;
     unknownFlags: ParsedFlags["unknownFlags"];
@@ -164,7 +166,7 @@ declare class Clerc<C extends CommandRecord = {}> {
      * const cli = Clerc.create()
      * ```
      */
-    static create(): Clerc<{}>;
+    static create(name?: string, description?: string, version?: string): Clerc<{}>;
     /**
      * Set the name of the cli
      * @param name
@@ -228,8 +230,8 @@ declare class Clerc<C extends CommandRecord = {}> {
      *   })
      * ```
      */
-    command<N extends string | SingleCommandType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string> = MaybeArray<string>, 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 | SingleCommandType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string> = MaybeArray<string>, 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 | SingleCommandType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string | SingleCommandType> = MaybeArray<string | SingleCommandType>, 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 | SingleCommandType, O extends CommandOptions<[...P], A, F>, P extends string[] = string[], A extends MaybeArray<string | SingleCommandType> = MaybeArray<string | SingleCommandType>, F extends Dict<FlagOptions> = Dict<FlagOptions>>(name: N, description: string, options?: O & CommandOptions<[...P], A, F>): this & Clerc<C & Record<N, Command<N, O>>>;
     /**
      * Register a handler
      * @param name
@@ -288,25 +290,20 @@ declare const defineHandler: <C extends Clerc<{}>, K extends keyof C["_commands"
 declare const defineInspector: <C extends Clerc<{}>>(_cli: C, inspector: Inspector<C["_commands"]>) => Inspector<C["_commands"]>;
 declare const defineCommand: <N extends string | typeof SingleCommand, 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 class SingleCommandError extends Error {
-    constructor();
-}
-declare class SingleCommandAliasError extends Error {
-    constructor();
-}
 declare class CommandExistsError extends Error {
+    name: string;
     constructor(name: string);
 }
-declare class CommonCommandExistsError extends Error {
-    constructor();
-}
 declare class NoSuchCommandError extends Error {
+    name: string;
     constructor(name: string);
 }
 declare class NoCommandGivenError extends Error {
     constructor();
 }
 declare class CommandNameConflictError extends Error {
+    n1: string;
+    n2: string;
     constructor(n1: string, n2: string);
 }
 declare class NameNotSetError extends Error {
@@ -319,14 +316,15 @@ declare class VersionNotSetError extends Error {
     constructor();
 }
 declare class InvalidCommandNameError extends Error {
+    name: string;
     constructor(name: string);
 }
 
-declare function resolveFlattenCommands(commands: CommandRecord): Map<string[], CommandAlias<string, CommandOptions<string[], _clerc_utils.MaybeArray<string>, _clerc_utils.Dict<FlagOptions>>>>;
-declare function resolveCommand(commands: CommandRecord, name: string | string[] | SingleCommandType): Command | undefined;
-declare function resolveSubcommandsByParent(commands: CommandRecord, parent: string | string[], depth?: number): Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string>, _clerc_utils.Dict<FlagOptions>>>[];
-declare const resolveRootCommands: (commands: CommandRecord) => Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string>, _clerc_utils.Dict<FlagOptions>>>[];
-declare function resolveParametersBeforeFlag(argv: string[], isSingleCommand: boolean): string[];
+declare function resolveFlattenCommands(commands: CommandRecord): Map<string[] | typeof SingleCommand, CommandAlias<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof SingleCommand>, _clerc_utils.Dict<FlagOptions>>>>;
+declare function resolveCommand(commands: CommandRecord, name: string | string[] | SingleCommandType): Command<string | SingleCommandType> | undefined;
+declare function resolveSubcommandsByParent(commands: CommandRecord, parent: string | string[], depth?: number): Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof SingleCommand>, _clerc_utils.Dict<FlagOptions>>>[];
+declare const resolveRootCommands: (commands: CommandRecord) => Command<string, CommandOptions<string[], _clerc_utils.MaybeArray<string | typeof SingleCommand>, _clerc_utils.Dict<FlagOptions>>>[];
+declare function resolveParametersBeforeFlag(argv: string[]): string[];
 declare const resolveArgv: () => string[];
 declare function compose(inspectors: Inspector[]): (getCtx: () => InspectorContext) => void;
 declare const isInvalidName: (name: CommandType) => boolean;
@@ -339,4 +337,4 @@ interface ParsedParameter {
 declare function parseParameters(parameters: string[]): ParsedParameter[];
 declare function mapParametersToArguments(mapping: Record<string, string | string[]>, parameters: ParsedParameter[], cliArguments: string[]): Error | undefined;
 
-export { Clerc, Command, CommandAlias, CommandCustomProperties, CommandExistsError, CommandNameConflictError, CommandOptions, CommandRecord, CommandType, CommandWithHandler, CommonCommandExistsError, DescriptionNotSetError, FallbackType, Flag, FlagOptions, Handler, HandlerContext, HandlerInCommand, Inspector, InspectorContext, InspectorFn, InspectorObject, InvalidCommandNameError, MakeEventMap, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Plugin, PossibleInputKind, SingleCommand, SingleCommandAliasError, SingleCommandError, SingleCommandType, 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, Handler, HandlerContext, HandlerInCommand, Inspector, InspectorContext, InspectorFn, InspectorObject, InvalidCommandNameError, MakeEventMap, NameNotSetError, NoCommandGivenError, NoSuchCommandError, Plugin, PossibleInputKind, SingleCommand, SingleCommandType, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };

package/dist/index.js

@@ -3,29 +3,16 @@ import { typeFlag } from 'type-flag';
 import { toArray, arrayStartsWith, camelCase } from '@clerc/utils';
 import { isNode, isDeno } from 'is-platform';
 
-class SingleCommandError extends Error {
-  constructor() {
-    super("Single command mode enabled.");
-  }
-}
-class SingleCommandAliasError extends Error {
-  constructor() {
-    super("Single command cannot have alias.");
-  }
-}
 class CommandExistsError extends Error {
   constructor(name) {
     super(`Command "${name}" exists.`);
-  }
-}
-class CommonCommandExistsError extends Error {
-  constructor() {
-    super("Common command exists.");
+    this.name = name;
   }
 }
 class NoSuchCommandError extends Error {
   constructor(name) {
     super(`No such command: ${name}`);
+    this.name = name;
   }
 }
 class NoCommandGivenError extends Error {
@@ -36,6 +23,8 @@ class NoCommandGivenError extends Error {
 class CommandNameConflictError extends Error {
   constructor(n1, n2) {
     super(`Command name ${n1} conflicts with ${n2}. Maybe caused by alias.`);
+    this.n1 = n1;
+    this.n2 = n2;
   }
 }
 class NameNotSetError extends Error {
@@ -56,21 +45,29 @@ class VersionNotSetError extends Error {
 class InvalidCommandNameError extends Error {
   constructor(name) {
     super(`Bad name format: ${name}`);
+    this.name = name;
   }
 }
 
+function setCommand(commandsMap, commands, command) {
+  if (command.alias) {
+    const aliases = toArray(command.alias);
+    for (const alias of aliases) {
+      if (alias in commands) {
+        throw new CommandNameConflictError(commands[alias].name, command.name);
+      }
+      commandsMap.set(typeof alias === "symbol" ? alias : alias.split(" "), { ...command, __isAlias: true });
+    }
+  }
+}
 function resolveFlattenCommands(commands) {
   const commandsMap = /* @__PURE__ */ new Map();
+  if (commands[SingleCommand]) {
+    commandsMap.set(SingleCommand, commands[SingleCommand]);
+    setCommand(commandsMap, commands, commands[SingleCommand]);
+  }
   for (const command of Object.values(commands)) {
-    if (command.alias) {
-      const aliases = toArray(command.alias);
-      for (const alias of aliases) {
-        if (alias in commands) {
-          throw new CommandNameConflictError(commands[alias].name, command.name);
-        }
-        commandsMap.set(alias.split(" "), { ...command, __isAlias: true });
-      }
-    }
+    setCommand(commandsMap, commands, command);
     commandsMap.set(command.name.split(" "), command);
   }
   return commandsMap;
@@ -84,7 +81,12 @@ function resolveCommand(commands, name) {
   let current;
   let currentName;
   commandsMap.forEach((v, k) => {
-    if (arrayStartsWith(nameArr, k) && (!currentName || k.length > currentName.length)) {
+    if (k === SingleCommand) {
+      current = commandsMap.get(SingleCommand);
+      currentName = SingleCommand;
+      return;
+    }
+    if (arrayStartsWith(nameArr, k) && (!currentName || currentName === SingleCommand || k.length > currentName.length)) {
       current = v;
       currentName = k;
     }
@@ -99,10 +101,7 @@ function resolveSubcommandsByParent(commands, parent, depth = Infinity) {
   });
 }
 const resolveRootCommands = (commands) => resolveSubcommandsByParent(commands, "", 1);
-function resolveParametersBeforeFlag(argv, isSingleCommand) {
-  if (isSingleCommand) {
-    return [];
-  }
+function resolveParametersBeforeFlag(argv) {
   const parameters = [];
   for (const arg of argv) {
     if (arg.startsWith("-")) {
@@ -212,12 +211,12 @@ var __privateSet = (obj, member, value, setter) => {
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
-var _name, _description, _version, _inspectors, _commands, _commandEmitter, _usedNames, _isSingleCommand, isSingleCommand_get, _hasCommands, hasCommands_get;
+var _name, _description, _version, _inspectors, _commands, _commandEmitter, _usedNames, _hasSingleCommandOrAlias, hasSingleCommandOrAlias_get, _hasSingleCommand, hasSingleCommand_get;
 const SingleCommand = Symbol("SingleCommand");
 const _Clerc = class {
-  constructor() {
-    __privateAdd(this, _isSingleCommand);
-    __privateAdd(this, _hasCommands);
+  constructor(name, description, version) {
+    __privateAdd(this, _hasSingleCommandOrAlias);
+    __privateAdd(this, _hasSingleCommand);
     __privateAdd(this, _name, "");
     __privateAdd(this, _description, "");
     __privateAdd(this, _version, "");
@@ -225,6 +224,9 @@ const _Clerc = class {
     __privateAdd(this, _commands, {});
     __privateAdd(this, _commandEmitter, new LiteEmit());
     __privateAdd(this, _usedNames, []);
+    __privateSet(this, _name, name || __privateGet(this, _name));
+    __privateSet(this, _description, description || __privateGet(this, _description));
+    __privateSet(this, _version, version || __privateGet(this, _version));
   }
   get _name() {
     return __privateGet(this, _name);
@@ -241,8 +243,8 @@ const _Clerc = class {
   get _commands() {
     return __privateGet(this, _commands);
   }
-  static create() {
-    return new _Clerc();
+  static create(name, description, version) {
+    return new _Clerc(name, description, version);
   }
   name(name) {
     __privateSet(this, _name, name);
@@ -256,27 +258,16 @@ const _Clerc = class {
     __privateSet(this, _version, version);
     return this;
   }
-  command(nameOrCommand, description, options) {
+  command(nameOrCommand, description, options = {}) {
     const checkIsCommandObject = (nameOrCommand2) => !(typeof nameOrCommand2 === "string" || nameOrCommand2 === SingleCommand);
     const isCommandObject = checkIsCommandObject(nameOrCommand);
     const name = !isCommandObject ? nameOrCommand : nameOrCommand.name;
     if (__privateGet(this, _commands)[name]) {
-      if (name === SingleCommand) {
-        throw new CommandExistsError("SingleCommand");
-      }
+      throw new CommandExistsError(typeof name === "symbol" ? "" : name);
     }
     if (isInvalidName(name)) {
       throw new InvalidCommandNameError(name);
     }
-    if (__privateGet(this, _isSingleCommand, isSingleCommand_get)) {
-      throw new SingleCommandError();
-    }
-    if (name === SingleCommand && __privateGet(this, _hasCommands, hasCommands_get)) {
-      throw new CommonCommandExistsError();
-    }
-    if (name === SingleCommand && (isCommandObject ? nameOrCommand : options).alias) {
-      throw new SingleCommandAliasError();
-    }
     const { handler = void 0, ...commandToSave } = isCommandObject ? nameOrCommand : { name, description, ...options };
     const nameList = [commandToSave.name];
     commandToSave.alias && nameList.push(...toArray(commandToSave.alias));
@@ -311,9 +302,9 @@ const _Clerc = class {
     if (!__privateGet(this, _version)) {
       throw new VersionNotSetError();
     }
-    const name = resolveParametersBeforeFlag(argv, __privateGet(this, _isSingleCommand, isSingleCommand_get));
+    const name = resolveParametersBeforeFlag(argv);
     const stringName = name.join(" ");
-    const getCommand = () => __privateGet(this, _isSingleCommand, isSingleCommand_get) ? __privateGet(this, _commands)[SingleCommand] : resolveCommand(__privateGet(this, _commands), name);
+    const getCommand = () => resolveCommand(__privateGet(this, _commands), name);
     const mapErrors = [];
     const getContext = () => {
       mapErrors.length = 0;
@@ -321,7 +312,7 @@ const _Clerc = class {
       const isCommandResolved = !!command;
       const parsed = typeFlag((command == null ? void 0 : command.flags) || {}, [...argv]);
       const { _: args, flags, unknownFlags } = parsed;
-      let parameters = __privateGet(this, _isSingleCommand, isSingleCommand_get) || !isCommandResolved ? args : args.slice(command.name.split(" ").length);
+      let parameters = !isCommandResolved || command.name === SingleCommand ? args : args.slice(command.name.split(" ").length);
       let commandParameters = (command == null ? void 0 : command.parameters) || [];
       const hasEof = commandParameters.indexOf("--");
       const eofParameters = commandParameters.slice(hasEof + 1) || [];
@@ -350,8 +341,10 @@ const _Clerc = class {
       const mergedFlags = { ...flags, ...unknownFlags };
       const context = {
         name: command == null ? void 0 : command.name,
+        called: name.length === 0 ? SingleCommand : stringName,
         resolved: isCommandResolved,
-        isSingleCommand: __privateGet(this, _isSingleCommand, isSingleCommand_get),
+        hasSingleCommandOrAlias: __privateGet(this, _hasSingleCommandOrAlias, hasSingleCommandOrAlias_get),
+        hasSingleCommand: __privateGet(this, _hasSingleCommand, hasSingleCommand_get),
         raw: { ...parsed, parameters, mergedFlags },
         parameters: mapping,
         flags,
@@ -393,13 +386,13 @@ _inspectors = new WeakMap();
 _commands = new WeakMap();
 _commandEmitter = new WeakMap();
 _usedNames = new WeakMap();
-_isSingleCommand = new WeakSet();
-isSingleCommand_get = function() {
-  return __privateGet(this, _commands)[SingleCommand] !== void 0;
+_hasSingleCommandOrAlias = new WeakSet();
+hasSingleCommandOrAlias_get = function() {
+  return __privateGet(this, _usedNames).includes(SingleCommand);
 };
-_hasCommands = new WeakSet();
-hasCommands_get = function() {
-  return Object.keys(__privateGet(this, _commands)).length > 0;
+_hasSingleCommand = new WeakSet();
+hasSingleCommand_get = function() {
+  return !!__privateGet(this, _commands)[SingleCommand];
 };
 
 const definePlugin = (p) => p;
@@ -407,4 +400,4 @@ const defineHandler = (_cli, _key, handler) => handler;
 const defineInspector = (_cli, inspector) => inspector;
 const defineCommand = (command) => command;
 
-export { Clerc, CommandExistsError, CommandNameConflictError, CommonCommandExistsError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, SingleCommand, SingleCommandAliasError, SingleCommandError, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };
+export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, SingleCommand, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };

package/dist/index.mjs

@@ -3,29 +3,16 @@ import { typeFlag } from 'type-flag';
 import { toArray, arrayStartsWith, camelCase } from '@clerc/utils';
 import { isNode, isDeno } from 'is-platform';
 
-class SingleCommandError extends Error {
-  constructor() {
-    super("Single command mode enabled.");
-  }
-}
-class SingleCommandAliasError extends Error {
-  constructor() {
-    super("Single command cannot have alias.");
-  }
-}
 class CommandExistsError extends Error {
   constructor(name) {
     super(`Command "${name}" exists.`);
-  }
-}
-class CommonCommandExistsError extends Error {
-  constructor() {
-    super("Common command exists.");
+    this.name = name;
   }
 }
 class NoSuchCommandError extends Error {
   constructor(name) {
     super(`No such command: ${name}`);
+    this.name = name;
   }
 }
 class NoCommandGivenError extends Error {
@@ -36,6 +23,8 @@ class NoCommandGivenError extends Error {
 class CommandNameConflictError extends Error {
   constructor(n1, n2) {
     super(`Command name ${n1} conflicts with ${n2}. Maybe caused by alias.`);
+    this.n1 = n1;
+    this.n2 = n2;
   }
 }
 class NameNotSetError extends Error {
@@ -56,21 +45,29 @@ class VersionNotSetError extends Error {
 class InvalidCommandNameError extends Error {
   constructor(name) {
     super(`Bad name format: ${name}`);
+    this.name = name;
   }
 }
 
+function setCommand(commandsMap, commands, command) {
+  if (command.alias) {
+    const aliases = toArray(command.alias);
+    for (const alias of aliases) {
+      if (alias in commands) {
+        throw new CommandNameConflictError(commands[alias].name, command.name);
+      }
+      commandsMap.set(typeof alias === "symbol" ? alias : alias.split(" "), { ...command, __isAlias: true });
+    }
+  }
+}
 function resolveFlattenCommands(commands) {
   const commandsMap = /* @__PURE__ */ new Map();
+  if (commands[SingleCommand]) {
+    commandsMap.set(SingleCommand, commands[SingleCommand]);
+    setCommand(commandsMap, commands, commands[SingleCommand]);
+  }
   for (const command of Object.values(commands)) {
-    if (command.alias) {
-      const aliases = toArray(command.alias);
-      for (const alias of aliases) {
-        if (alias in commands) {
-          throw new CommandNameConflictError(commands[alias].name, command.name);
-        }
-        commandsMap.set(alias.split(" "), { ...command, __isAlias: true });
-      }
-    }
+    setCommand(commandsMap, commands, command);
     commandsMap.set(command.name.split(" "), command);
   }
   return commandsMap;
@@ -84,7 +81,12 @@ function resolveCommand(commands, name) {
   let current;
   let currentName;
   commandsMap.forEach((v, k) => {
-    if (arrayStartsWith(nameArr, k) && (!currentName || k.length > currentName.length)) {
+    if (k === SingleCommand) {
+      current = commandsMap.get(SingleCommand);
+      currentName = SingleCommand;
+      return;
+    }
+    if (arrayStartsWith(nameArr, k) && (!currentName || currentName === SingleCommand || k.length > currentName.length)) {
       current = v;
       currentName = k;
     }
@@ -99,10 +101,7 @@ function resolveSubcommandsByParent(commands, parent, depth = Infinity) {
   });
 }
 const resolveRootCommands = (commands) => resolveSubcommandsByParent(commands, "", 1);
-function resolveParametersBeforeFlag(argv, isSingleCommand) {
-  if (isSingleCommand) {
-    return [];
-  }
+function resolveParametersBeforeFlag(argv) {
   const parameters = [];
   for (const arg of argv) {
     if (arg.startsWith("-")) {
@@ -212,12 +211,12 @@ var __privateSet = (obj, member, value, setter) => {
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
-var _name, _description, _version, _inspectors, _commands, _commandEmitter, _usedNames, _isSingleCommand, isSingleCommand_get, _hasCommands, hasCommands_get;
+var _name, _description, _version, _inspectors, _commands, _commandEmitter, _usedNames, _hasSingleCommandOrAlias, hasSingleCommandOrAlias_get, _hasSingleCommand, hasSingleCommand_get;
 const SingleCommand = Symbol("SingleCommand");
 const _Clerc = class {
-  constructor() {
-    __privateAdd(this, _isSingleCommand);
-    __privateAdd(this, _hasCommands);
+  constructor(name, description, version) {
+    __privateAdd(this, _hasSingleCommandOrAlias);
+    __privateAdd(this, _hasSingleCommand);
     __privateAdd(this, _name, "");
     __privateAdd(this, _description, "");
     __privateAdd(this, _version, "");
@@ -225,6 +224,9 @@ const _Clerc = class {
     __privateAdd(this, _commands, {});
     __privateAdd(this, _commandEmitter, new LiteEmit());
     __privateAdd(this, _usedNames, []);
+    __privateSet(this, _name, name || __privateGet(this, _name));
+    __privateSet(this, _description, description || __privateGet(this, _description));
+    __privateSet(this, _version, version || __privateGet(this, _version));
   }
   get _name() {
     return __privateGet(this, _name);
@@ -241,8 +243,8 @@ const _Clerc = class {
   get _commands() {
     return __privateGet(this, _commands);
   }
-  static create() {
-    return new _Clerc();
+  static create(name, description, version) {
+    return new _Clerc(name, description, version);
   }
   name(name) {
     __privateSet(this, _name, name);
@@ -256,27 +258,16 @@ const _Clerc = class {
     __privateSet(this, _version, version);
     return this;
   }
-  command(nameOrCommand, description, options) {
+  command(nameOrCommand, description, options = {}) {
     const checkIsCommandObject = (nameOrCommand2) => !(typeof nameOrCommand2 === "string" || nameOrCommand2 === SingleCommand);
     const isCommandObject = checkIsCommandObject(nameOrCommand);
     const name = !isCommandObject ? nameOrCommand : nameOrCommand.name;
     if (__privateGet(this, _commands)[name]) {
-      if (name === SingleCommand) {
-        throw new CommandExistsError("SingleCommand");
-      }
+      throw new CommandExistsError(typeof name === "symbol" ? "" : name);
     }
     if (isInvalidName(name)) {
       throw new InvalidCommandNameError(name);
     }
-    if (__privateGet(this, _isSingleCommand, isSingleCommand_get)) {
-      throw new SingleCommandError();
-    }
-    if (name === SingleCommand && __privateGet(this, _hasCommands, hasCommands_get)) {
-      throw new CommonCommandExistsError();
-    }
-    if (name === SingleCommand && (isCommandObject ? nameOrCommand : options).alias) {
-      throw new SingleCommandAliasError();
-    }
     const { handler = void 0, ...commandToSave } = isCommandObject ? nameOrCommand : { name, description, ...options };
     const nameList = [commandToSave.name];
     commandToSave.alias && nameList.push(...toArray(commandToSave.alias));
@@ -311,9 +302,9 @@ const _Clerc = class {
     if (!__privateGet(this, _version)) {
       throw new VersionNotSetError();
     }
-    const name = resolveParametersBeforeFlag(argv, __privateGet(this, _isSingleCommand, isSingleCommand_get));
+    const name = resolveParametersBeforeFlag(argv);
     const stringName = name.join(" ");
-    const getCommand = () => __privateGet(this, _isSingleCommand, isSingleCommand_get) ? __privateGet(this, _commands)[SingleCommand] : resolveCommand(__privateGet(this, _commands), name);
+    const getCommand = () => resolveCommand(__privateGet(this, _commands), name);
     const mapErrors = [];
     const getContext = () => {
       mapErrors.length = 0;
@@ -321,7 +312,7 @@ const _Clerc = class {
       const isCommandResolved = !!command;
       const parsed = typeFlag((command == null ? void 0 : command.flags) || {}, [...argv]);
       const { _: args, flags, unknownFlags } = parsed;
-      let parameters = __privateGet(this, _isSingleCommand, isSingleCommand_get) || !isCommandResolved ? args : args.slice(command.name.split(" ").length);
+      let parameters = !isCommandResolved || command.name === SingleCommand ? args : args.slice(command.name.split(" ").length);
       let commandParameters = (command == null ? void 0 : command.parameters) || [];
       const hasEof = commandParameters.indexOf("--");
       const eofParameters = commandParameters.slice(hasEof + 1) || [];
@@ -350,8 +341,10 @@ const _Clerc = class {
       const mergedFlags = { ...flags, ...unknownFlags };
       const context = {
         name: command == null ? void 0 : command.name,
+        called: name.length === 0 ? SingleCommand : stringName,
         resolved: isCommandResolved,
-        isSingleCommand: __privateGet(this, _isSingleCommand, isSingleCommand_get),
+        hasSingleCommandOrAlias: __privateGet(this, _hasSingleCommandOrAlias, hasSingleCommandOrAlias_get),
+        hasSingleCommand: __privateGet(this, _hasSingleCommand, hasSingleCommand_get),
         raw: { ...parsed, parameters, mergedFlags },
         parameters: mapping,
         flags,
@@ -393,13 +386,13 @@ _inspectors = new WeakMap();
 _commands = new WeakMap();
 _commandEmitter = new WeakMap();
 _usedNames = new WeakMap();
-_isSingleCommand = new WeakSet();
-isSingleCommand_get = function() {
-  return __privateGet(this, _commands)[SingleCommand] !== void 0;
+_hasSingleCommandOrAlias = new WeakSet();
+hasSingleCommandOrAlias_get = function() {
+  return __privateGet(this, _usedNames).includes(SingleCommand);
 };
-_hasCommands = new WeakSet();
-hasCommands_get = function() {
-  return Object.keys(__privateGet(this, _commands)).length > 0;
+_hasSingleCommand = new WeakSet();
+hasSingleCommand_get = function() {
+  return !!__privateGet(this, _commands)[SingleCommand];
 };
 
 const definePlugin = (p) => p;
@@ -407,4 +400,4 @@ const defineHandler = (_cli, _key, handler) => handler;
 const defineInspector = (_cli, inspector) => inspector;
 const defineCommand = (command) => command;
 
-export { Clerc, CommandExistsError, CommandNameConflictError, CommonCommandExistsError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, SingleCommand, SingleCommandAliasError, SingleCommandError, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };
+export { Clerc, CommandExistsError, CommandNameConflictError, DescriptionNotSetError, InvalidCommandNameError, NameNotSetError, NoCommandGivenError, NoSuchCommandError, SingleCommand, VersionNotSetError, compose, defineCommand, defineHandler, defineInspector, definePlugin, isInvalidName, mapParametersToArguments, parseParameters, resolveArgv, resolveCommand, resolveFlattenCommands, resolveParametersBeforeFlag, resolveRootCommands, resolveSubcommandsByParent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "0.19.0",
+  "version": "0.21.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.19.0"
+    "@clerc/utils": "0.21.0"
   },
   "scripts": {
     "build": "puild",