@guanghechen/commander 4.6.0 → 4.7.0

package/lib/types/{index.d.ts → node.d.ts}

@@ -128,6 +128,23 @@ interface ICommandPresetConfig {
     /** Default preset envs file */
     env?: string;
 }
+/** Runtime file stats abstraction */
+interface ICommandRuntimeStats {
+    isDirectory(): boolean;
+}
+/** Runtime abstraction for environment-dependent operations */
+interface ICommandRuntime {
+    /** Current working directory */
+    cwd(): string;
+    /** Path absolute check */
+    isAbsolute(filepath: string): boolean;
+    /** Resolve paths into an absolute path */
+    resolve(...paths: string[]): string;
+    /** Read UTF-8 text file */
+    readFile(filepath: string): Promise<string>;
+    /** Stat file system entry */
+    stat(filepath: string): Promise<ICommandRuntimeStats>;
+}
 /** Command configuration */
 interface ICommandConfig {
     /** Command name (only for root command) */
@@ -142,6 +159,8 @@ interface ICommandConfig {
     preset?: ICommandPresetConfig;
     /** Default reporter for this command */
     reporter?: IReporter;
+    /** Runtime adapter for environment-dependent operations */
+    runtime?: ICommandRuntime;
 }
 /** Command interface */
 interface ICommand {
@@ -372,6 +391,14 @@ interface ICompletionCommandConfig {
     paths?: Partial<ICompletionPaths>;
 }
 
+/**
+ * Node runtime adapter
+ *
+ * @module @guanghechen/commander
+ */
+
+declare function createNodeCommandRuntime(): ICommandRuntime;
+
 /**
  * Command class - CLI command builder with fluent API
  *
@@ -428,51 +455,6 @@ declare function isIpv6(rawValue: string): boolean;
 declare function isIp(rawValue: string): boolean;
 declare function isDomain(rawValue: string): boolean;
 
-/**
- * Shell completion generators
- *
- * @module @guanghechen/commander
- */
-
-/**
- * Built-in completion command that generates shell completion scripts.
- *
- * @example
- * ```typescript
- * const root = new Command({ name: 'mycli', desc: 'My CLI' })
- * root.subcommand('completion', new CompletionCommand(root, {
- *   paths: {
- *     bash: `~/.local/share/bash-completion/completions/mycli`,
- *     fish: `~/.config/fish/completions/mycli.fish`,
- *     pwsh: `~/.config/powershell/Microsoft.PowerShell_profile.ps1`,
- *   }
- * }))
- *
- * // Usage:
- * // mycli completion --bash > ~/.local/share/bash-completion/completions/mycli
- * // mycli completion --fish --write  (writes to default path)
- * // mycli completion --fish --write /custom/path.fish
- * ```
- */
-declare class CompletionCommand extends Command {
-    constructor(root: Command, config?: ICompletionCommandConfig);
-}
-declare class BashCompletion {
-    #private;
-    constructor(meta: ICompletionMeta, programName: string);
-    generate(): string;
-}
-declare class FishCompletion {
-    #private;
-    constructor(meta: ICompletionMeta, programName: string);
-    generate(): string;
-}
-declare class PwshCompletion {
-    #private;
-    constructor(meta: ICompletionMeta, programName: string);
-    generate(): string;
-}
-
 /**
  * Pre-defined common options for @guanghechen/commander
  *
@@ -556,5 +538,67 @@ declare const logColorfulOption: ICommandOptionConfig<boolean>;
  */
 declare const silentOption: ICommandOptionConfig<boolean>;
 
-export { BashCompletion, Coerce, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, isDomain, isIp, isIpv4, isIpv6, logColorfulOption, logDateOption, logLevelOption, 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, ICommandShiftResult, ICommandToken, ICommandTokenType, ICommandTokenizeResult, ICommanderErrorKind, ICompletionCommandConfig, ICompletionMeta, ICompletionOptionMeta, ICompletionPaths, ICompletionShellType, IHelpCommandLine, IHelpData, IHelpExampleLine, IHelpOptionLine, ISubcommandEntry };
+/**
+ * Browser runtime adapter
+ *
+ * @module @guanghechen/commander
+ */
+
+declare function createBrowserCommandRuntime(): ICommandRuntime;
+
+/**
+ * Runtime adapters
+ *
+ * @module @guanghechen/commander
+ */
+
+declare function getDefaultCommandRuntime(): ICommandRuntime;
+declare function setDefaultCommandRuntime(runtime: ICommandRuntime): void;
+
+/**
+ * Shell completion generators
+ *
+ * @module @guanghechen/commander
+ */
+
+/**
+ * Built-in completion command that generates shell completion scripts.
+ *
+ * @example
+ * ```typescript
+ * const root = new Command({ name: 'mycli', desc: 'My CLI' })
+ * root.subcommand('completion', new CompletionCommand(root, {
+ *   paths: {
+ *     bash: `~/.local/share/bash-completion/completions/mycli`,
+ *     fish: `~/.config/fish/completions/mycli.fish`,
+ *     pwsh: `~/.config/powershell/Microsoft.PowerShell_profile.ps1`,
+ *   }
+ * }))
+ *
+ * // Usage:
+ * // mycli completion --bash > ~/.local/share/bash-completion/completions/mycli
+ * // mycli completion --fish --write  (writes to default path)
+ * // mycli completion --fish --write /custom/path.fish
+ * ```
+ */
+declare class CompletionCommand extends Command {
+    constructor(root: Command, config?: ICompletionCommandConfig);
+}
+declare class BashCompletion {
+    #private;
+    constructor(meta: ICompletionMeta, programName: string);
+    generate(): string;
+}
+declare class FishCompletion {
+    #private;
+    constructor(meta: ICompletionMeta, programName: string);
+    generate(): string;
+}
+declare class PwshCompletion {
+    #private;
+    constructor(meta: ICompletionMeta, programName: string);
+    generate(): string;
+}
+
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanghechen/commander",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "A minimal, type-safe command-line interface builder with fluent API",
   "author": {
     "name": "guanghechen",
@@ -20,17 +20,20 @@
   ],
   "type": "module",
   "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "source": "./src/index.ts",
-      "import": "./lib/esm/index.mjs",
-      "require": "./lib/cjs/index.cjs"
+    ".": null,
+    "./browser": {
+      "types": "./lib/types/browser.d.ts",
+      "source": "./src/runtime/browser/entry.ts",
+      "import": "./lib/esm/browser.mjs",
+      "require": "./lib/cjs/browser.cjs"
+    },
+    "./node": {
+      "types": "./lib/types/node.d.ts",
+      "source": "./src/runtime/node/index.ts",
+      "import": "./lib/esm/node.mjs",
+      "require": "./lib/cjs/node.cjs"
     }
   },
-  "source": "./src/index.ts",
-  "main": "./lib/cjs/index.cjs",
-  "module": "./lib/esm/index.mjs",
-  "types": "./lib/types/index.d.ts",
   "license": "MIT",
   "files": [
     "lib/",
@@ -41,8 +44,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@guanghechen/env": "^2.0.2",
-    "@guanghechen/reporter": "^3.3.0"
+    "@guanghechen/reporter": "^3.3.0",
+    "@guanghechen/env": "^2.0.2"
   },
   "scripts": {
     "build": "rollup -c ../../rollup.config.mjs",