@guanghechen/commander 4.7.0 → 4.7.2

package/lib/types/node.d.ts

@@ -65,9 +65,9 @@ interface ICommandOptionConfig<T = unknown> {
     apply?: (value: T, ctx: ICommandContext) => void;
 }
 /** Argument kind */
-type ICommandArgumentKind = 'required' | 'optional' | 'variadic';
+type ICommandArgumentKind = 'required' | 'optional' | 'variadic' | 'some';
 /** Argument value type */
-type ICommandArgumentType = 'string' | 'number';
+type ICommandArgumentType = 'string' | 'choice';
 /**
  * Positional argument configuration.
  *
@@ -85,15 +85,17 @@ interface ICommandArgumentConfig<T = unknown> {
     desc: string;
     /** Argument kind: required / optional / variadic */
     kind: ICommandArgumentKind;
-    /** Value type, defaults to 'string' */
-    type?: ICommandArgumentType;
+    /** Value type */
+    type: ICommandArgumentType;
+    /** Allowed values for choice type */
+    choices?: ReadonlyArray<string>;
     /** Default value when not provided (only for optional arguments) */
     default?: T;
     /** Custom value transformation (takes precedence over type conversion) */
     coerce?: (rawValue: string) => T;
 }
 interface ICommandBuiltinOptionConfig {
-    /** Enable built-in --version option (root only, requires configured version) */
+    /** Enable built-in --version option (requires configured version on target command) */
     version?: boolean;
     /** Enable built-in --color/--no-color option for help rendering (defaults respect NO_COLOR) */
     color?: boolean;
@@ -317,6 +319,11 @@ interface IHelpOptionLine {
     sig: string;
     desc: string;
 }
+/** Help argument line (internal) */
+interface IHelpArgumentLine {
+    sig: string;
+    desc: string;
+}
 /** Help command line (internal) */
 interface IHelpCommandLine {
     name: string;
@@ -332,6 +339,7 @@ interface IHelpExampleLine {
 interface IHelpData {
     desc: string;
     usage: string;
+    arguments: IHelpArgumentLine[];
     options: IHelpOptionLine[];
     commands: IHelpCommandLine[];
     examples: IHelpExampleLine[];
@@ -361,6 +369,17 @@ interface ICompletionOptionMeta {
     /** Allowed values */
     choices?: string[];
 }
+/** Argument metadata for completion */
+interface ICompletionArgumentMeta {
+    /** Argument name */
+    name: string;
+    /** Argument kind */
+    kind: ICommandArgumentKind;
+    /** Argument type */
+    type: ICommandArgumentType;
+    /** Allowed values (only for type='choice') */
+    choices?: string[];
+}
 /** Command metadata for completion */
 interface ICompletionMeta {
     /** Command name */
@@ -371,6 +390,8 @@ interface ICompletionMeta {
     aliases: string[];
     /** Options */
     options: ICompletionOptionMeta[];
+    /** Positional arguments */
+    arguments: ICompletionArgumentMeta[];
     /** Subcommands */
     subcommands: ICompletionMeta[];
 }
@@ -601,4 +622,4 @@ declare class PwshCompletion {
 }
 
 export { BashCompletion, Coerce, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, createBrowserCommandRuntime, createNodeCommandRuntime, getDefaultCommandRuntime, isDomain, isIp, isIpv4, isIpv6, logColorfulOption, logDateOption, logLevelOption, setDefaultCommandRuntime, silentOption };
-export type { ICommand, ICommandAction, ICommandActionParams, ICommandArgumentConfig, ICommandArgumentKind, ICommandArgumentType, ICommandBuiltinConfig, ICommandBuiltinOptionConfig, ICommandBuiltinOptionResolved, ICommandBuiltinResolved, ICommandConfig, ICommandContext, ICommandControlScanResult, ICommandControls, ICommandExample, ICommandInputSources, ICommandOptionArgs, ICommandOptionConfig, ICommandOptionType, ICommandParseResult, ICommandParsedArgs, ICommandParsedOpts, ICommandPresetConfig, ICommandPresetResult, ICommandResolveResult, ICommandRouteResult, ICommandRunParams, ICommandRuntime, ICommandRuntimeStats, ICommandShiftResult, ICommandToken, ICommandTokenType, ICommandTokenizeResult, ICommanderErrorKind, ICompletionCommandConfig, ICompletionMeta, ICompletionOptionMeta, ICompletionPaths, ICompletionShellType, IHelpCommandLine, IHelpData, IHelpExampleLine, IHelpOptionLine, ISubcommandEntry };
+export type { ICommand, ICommandAction, ICommandActionParams, ICommandArgumentConfig, ICommandArgumentKind, ICommandArgumentType, ICommandBuiltinConfig, ICommandBuiltinOptionConfig, ICommandBuiltinOptionResolved, ICommandBuiltinResolved, ICommandConfig, ICommandContext, ICommandControlScanResult, ICommandControls, ICommandExample, ICommandInputSources, ICommandOptionArgs, ICommandOptionConfig, ICommandOptionType, ICommandParseResult, ICommandParsedArgs, ICommandParsedOpts, ICommandPresetConfig, ICommandPresetResult, ICommandResolveResult, ICommandRouteResult, ICommandRunParams, ICommandRuntime, ICommandRuntimeStats, ICommandShiftResult, ICommandToken, ICommandTokenType, ICommandTokenizeResult, ICommanderErrorKind, ICompletionArgumentMeta, ICompletionCommandConfig, ICompletionMeta, ICompletionOptionMeta, ICompletionPaths, ICompletionShellType, IHelpArgumentLine, IHelpCommandLine, IHelpData, IHelpExampleLine, IHelpOptionLine, ISubcommandEntry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanghechen/commander",
-  "version": "4.7.0",
+  "version": "4.7.2",
   "description": "A minimal, type-safe command-line interface builder with fluent API",
   "author": {
     "name": "guanghechen",
@@ -44,8 +44,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@guanghechen/reporter": "^3.3.0",
-    "@guanghechen/env": "^2.0.2"
+    "@guanghechen/env": "^2.0.2",
+    "@guanghechen/reporter": "^3.3.0"
   },
   "scripts": {
     "build": "rollup -c ../../rollup.config.mjs",