gunshi 0.27.0 → 0.27.4

package/lib/bone.d.ts

@@ -1,4 +1,4 @@
-import { A as ValidationErrorsDecorator, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, O as RendererDecorator, S as ExtractExtensions, T as LazyCommand, _ as Commandable, a as Awaitable, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, h as CommandLoader, i as Args, k as RenderingOptions, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, o as CliOptions, p as CommandEnvironment, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-DIfsK4mZ.js";
+import { A as SubCommandable, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, O as RendererDecorator, S as ExtractExtensions, T as LazyCommand, _ as Commandable, a as Awaitable, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, h as CommandLoader, i as Args, j as ValidationErrorsDecorator, k as RenderingOptions, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, o as CliOptions, p as CommandEnvironment, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-B2vSsTAs.js";
 
 //#region src/cli/bone.d.ts
 /**
@@ -46,4 +46,4 @@ declare function cli<E extends ExtendContext = ExtendContext, G extends GunshiPa
  */
 declare function cli<G extends GunshiParams = DefaultGunshiParams>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
 //#endregion
-export { ArgSchema, ArgToken, ArgValues, Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, Prettify, RendererDecorator, RenderingOptions, ValidationErrorsDecorator, cli };
+export { ArgSchema, ArgToken, ArgValues, Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, Prettify, RendererDecorator, RenderingOptions, SubCommandable, ValidationErrorsDecorator, cli };

package/lib/{context-CMrZI9J4.d.ts → context-c3TYozQR.d.ts}

@@ -1,4 +1,4 @@
-import { C as GunshiParams, T as LazyCommand, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, i as Args, l as CommandContext, n as ArgToken, o as CliOptions, r as ArgValues, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-DIfsK4mZ.js";
+import { C as GunshiParams, T as LazyCommand, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, i as Args, l as CommandContext, n as ArgToken, o as CliOptions, r as ArgValues, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-B2vSsTAs.js";
 
 //#region src/context.d.ts
 

package/lib/context.d.ts

@@ -1,3 +1,3 @@
-import "./types-DIfsK4mZ.js";
-import { n as ExtractExtensions, r as createCommandContext, t as CommandContextParams } from "./context-CMrZI9J4.js";
+import "./types-B2vSsTAs.js";
+import { n as ExtractExtensions, r as createCommandContext, t as CommandContextParams } from "./context-c3TYozQR.js";
 export { CommandContextParams, ExtractExtensions, createCommandContext };

package/lib/{definition-BWGhvqMF.d.ts → definition-Bhhx1dzQ.d.ts}

@@ -1,4 +1,4 @@
-import { C as GunshiParams, D as Prettify, S as ExtractExtensions, T as LazyCommand, h as CommandLoader, i as Args, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-DIfsK4mZ.js";
+import { C as GunshiParams, D as Prettify, S as ExtractExtensions, T as LazyCommand, h as CommandLoader, i as Args, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext } from "./types-B2vSsTAs.js";
 
 //#region src/definition.d.ts
 /**

package/lib/definition.d.ts

@@ -1,4 +1,4 @@
-import { C as GunshiParams, T as LazyCommand, g as CommandRunner, h as CommandLoader, i as Args, r as ArgValues, s as Command, t as ArgSchema, v as DefaultGunshiParams, y as ExtendContext } from "./types-DIfsK4mZ.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-CMrZI9J4.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-BWGhvqMF.js";
+import { C as GunshiParams, T as LazyCommand, g as CommandRunner, h as CommandLoader, i as Args, r as ArgValues, s as Command, t as ArgSchema, v as DefaultGunshiParams, y as ExtendContext } from "./types-B2vSsTAs.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-c3TYozQR.js";
+import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-Bhhx1dzQ.js";
 export { ArgSchema, ArgValues, Args, Command, CommandContextParams, CommandLoader, CommandRunner, DefaultGunshiParams, ExtendContext, GunshiParams, LazyCommand, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };

package/lib/generator.d.ts

@@ -1,4 +1,4 @@
-import { T as LazyCommand, o as CliOptions, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-DIfsK4mZ.js";
+import { T as LazyCommand, o as CliOptions, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-B2vSsTAs.js";
 
 //#region src/generator.d.ts
 

package/lib/{index-BDRk6VtJ.d.ts → index-D_NQFhLl.d.ts}

@@ -1,4 +1,4 @@
-import { C as GunshiParams, T as LazyCommand, g as CommandRunner, i as Args$1, o as CliOptions, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, y as ExtendContext } from "./types-DIfsK4mZ.js";
+import { A as SubCommandable, C as GunshiParams, T as LazyCommand, g as CommandRunner, i as Args$1, o as CliOptions, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint, y as ExtendContext } from "./types-B2vSsTAs.js";
 import { parseArgs as parseArgs$1, resolveArgs as resolveArgs$1 } from "args-tokens";
 
 //#region ../plugin-i18n/src/types.d.ts
@@ -104,6 +104,18 @@ declare class DefaultTranslation implements TranslationAdapter {
 }
 //#endregion
 //#region src/cli/builtin.d.ts
+/**
+ * Run the command.
+ *
+ * This overload accepts any command-like object using a loose structural type.
+ * It bypasses TypeScript contravariance issues with callback properties.
+ *
+ * @param args - Command line arguments
+ * @param entry - A command-like object (command, command runner, or lazy command)
+ * @param options - A {@link CliOptions | CLI options}
+ * @returns A rendered usage or undefined. if you will use {@linkcode CliOptions.usageSilent} option, it will return rendered usage string.
+ */
+declare function cli(args: string[], entry: SubCommandable, options?: CliOptions): Promise<string | undefined>;
 /**
  * Run the command.
  *

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-import { A as ValidationErrorsDecorator, B as PluginContext, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, F as PluginFunction, I as PluginOptions, L as PluginWithExtension, M as Plugin, N as PluginDependency, O as RendererDecorator, P as PluginExtension, R as PluginWithoutExtension, S as ExtractExtensions, T as LazyCommand, _ as Commandable, a as Awaitable, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, h as CommandLoader, i as Args, j as OnPluginExtension, k as RenderingOptions, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, o as CliOptions, p as CommandEnvironment, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext, z as plugin } from "./types-DIfsK4mZ.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-CMrZI9J4.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-BWGhvqMF.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./plugin-gv9ogu9N.js";
-import { i as DefaultTranslation, n as resolveArgs, r as cli, t as parseArgs } from "./index-BDRk6VtJ.js";
-import "./utils-BVBpgaJv.js";
-export { ANONYMOUS_COMMAND_NAME, ArgSchema, ArgToken, ArgValues, Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, CommandContextParams, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, DefaultTranslation, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, RenderingOptions, ValidationErrorsDecorator, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };
+import { A as SubCommandable, B as plugin, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, F as PluginExtension, I as PluginFunction, L as PluginOptions, M as OnPluginExtension, N as Plugin, O as RendererDecorator, P as PluginDependency, R as PluginWithExtension, S as ExtractExtensions, T as LazyCommand, V as PluginContext, _ as Commandable, a as Awaitable, b as ExtractArgExplicitlyProvided, c as CommandCallMode, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, h as CommandLoader, i as Args, j as ValidationErrorsDecorator, k as RenderingOptions, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, o as CliOptions, p as CommandEnvironment, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext, z as PluginWithoutExtension } from "./types-B2vSsTAs.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-c3TYozQR.js";
+import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-Bhhx1dzQ.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./plugin-BCYPEeKH.js";
+import { i as DefaultTranslation, n as resolveArgs, r as cli, t as parseArgs } from "./index-D_NQFhLl.js";
+import "./utils-_mX9Q7d9.js";
+export { ANONYMOUS_COMMAND_NAME, ArgSchema, ArgToken, ArgValues, Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, CommandContextParams, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, DefaultTranslation, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, RenderingOptions, SubCommandable, ValidationErrorsDecorator, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };

package/lib/index.js

@@ -66,7 +66,7 @@ var DefaultTranslation = class {
 		if (message === void 0 && locale !== this.#options.fallbackLocale) message = this.getMessage(this.#options.fallbackLocale, key);
 		if (message === void 0) return;
 		return message.replaceAll(/\{\$(\w+)\}/g, (_, name) => {
-			return values[name] == null ? "" : values[name].toString();
+			return values[name] == null ? "" : values[name];
 		});
 	}
 };

package/lib/{plugin-gv9ogu9N.d.ts → plugin-BCYPEeKH.d.ts}

@@ -1,4 +1,4 @@
-import { o as CliOptions, v as DefaultGunshiParams } from "./types-DIfsK4mZ.js";
+import { o as CliOptions, v as DefaultGunshiParams } from "./types-B2vSsTAs.js";
 
 //#region src/constants.d.ts
 /**

package/lib/plugin.d.ts

@@ -1,4 +1,4 @@
-import { A as ValidationErrorsDecorator, B as PluginContext, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, F as PluginFunction, I as PluginOptions, L as PluginWithExtension, M as Plugin, N as PluginDependency, O as RendererDecorator, P as PluginExtension, R as PluginWithoutExtension, S as ExtractExtensions, T as LazyCommand, a as Awaitable, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, i as Args, j as OnPluginExtension, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext, z as plugin } from "./types-DIfsK4mZ.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-CMrZI9J4.js";
-import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./plugin-gv9ogu9N.js";
+import { B as plugin, C as GunshiParams, D as Prettify, E as NormalizeToGunshiParams, F as PluginExtension, I as PluginFunction, L as PluginOptions, M as OnPluginExtension, N as Plugin, O as RendererDecorator, P as PluginDependency, R as PluginWithExtension, S as ExtractExtensions, T as LazyCommand, V as PluginContext, a as Awaitable, d as CommandContextExtension, f as CommandDecorator, g as CommandRunner, i as Args, j as ValidationErrorsDecorator, l as CommandContext, m as CommandExamplesFetcher, n as ArgToken, r as ArgValues, s as Command, t as ArgSchema, u as CommandContextCore, v as DefaultGunshiParams, w as GunshiParamsConstraint, x as ExtractArgs, y as ExtendContext, z as PluginWithoutExtension } from "./types-B2vSsTAs.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-c3TYozQR.js";
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./plugin-BCYPEeKH.js";
 export { ANONYMOUS_COMMAND_NAME, ArgSchema, ArgToken, ArgValues, Args, Awaitable, CLI_OPTIONS_DEFAULT, Command, CommandContext, CommandContextCore, CommandContextExtension, CommandContextParams, CommandDecorator, CommandExamplesFetcher, CommandRunner, DefaultGunshiParams, ExtendContext, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, ValidationErrorsDecorator, createCommandContext, plugin };

package/lib/renderer.d.ts

@@ -1,9 +1,9 @@
-import { C as GunshiParams, l as CommandContext, v as DefaultGunshiParams } from "./types-DIfsK4mZ.js";
-import "./context-CMrZI9J4.js";
-import "./definition-BWGhvqMF.js";
-import "./plugin-gv9ogu9N.js";
-import "./index-BDRk6VtJ.js";
-import "./utils-BVBpgaJv.js";
+import { C as GunshiParams, l as CommandContext, v as DefaultGunshiParams } from "./types-B2vSsTAs.js";
+import "./context-c3TYozQR.js";
+import "./definition-Bhhx1dzQ.js";
+import "./plugin-BCYPEeKH.js";
+import "./index-D_NQFhLl.js";
+import "./utils-_mX9Q7d9.js";
 
 //#region ../plugin-renderer/src/header.d.ts
 /**

package/lib/{types-DIfsK4mZ.d.ts → types-B2vSsTAs.d.ts}

@@ -93,18 +93,18 @@ interface PluginContext<G extends GunshiParamsConstraint = DefaultGunshiParams>
 }
 //#endregion
 //#region src/plugin/core.d.ts
-type ProcessDependency<D, A$1 extends ExtendContext> = D extends string ? D extends keyof A$1 ? { [K in D]: A$1[K] } : {} : D extends {
+type ProcessDependency<D, A extends ExtendContext> = D extends string ? D extends keyof A ? { [K in D]: A[K] } : {} : D extends {
   id: infer ID;
   optional?: any;
-} ? ID extends string ? ID extends keyof A$1 ? D extends {
+} ? ID extends string ? ID extends keyof A ? D extends {
   optional: true;
-} ? { [K in ID]: A$1[K] | undefined } : { [K in ID]: A$1[K] } : {} : never : never;
+} ? { [K in ID]: A[K] | undefined } : { [K in ID]: A[K] } : {} : never : never;
 /**
  * Helper type to infer dependency extensions with optional support
  *
  * @internal
  */
-type InferDependencyExtensions<D extends ReadonlyArray<PluginDependency | string>, A$1 extends ExtendContext> = D extends readonly [] ? {} : D extends readonly [infer First, ...infer Rest] ? ProcessDependency<First, A$1> & (Rest extends ReadonlyArray<PluginDependency | string> ? InferDependencyExtensions<Rest, A$1> : {}) : {};
+type InferDependencyExtensions<D extends ReadonlyArray<PluginDependency | string>, A extends ExtendContext> = D extends readonly [] ? {} : D extends readonly [infer First, ...infer Rest] ? ProcessDependency<First, A> & (Rest extends ReadonlyArray<PluginDependency | string> ? InferDependencyExtensions<Rest, A> : {}) : {};
 /**
  * Plugin dependency definition
  *
@@ -210,11 +210,11 @@ ResolvedDepExt extends GunshiParams = GunshiParams<{
  *
  * @since v0.27.0
  */
-type Plugin<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
+type Plugin<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
   id: string;
   name?: string;
   dependencies?: (PluginDependency | string)[];
-  extension?: CommandContextExtension<E$1>;
+  extension?: CommandContextExtension<E>;
 };
 /**
  * Plugin return type with extension, which includes the plugin ID, name, dependencies, and extension.
@@ -223,7 +223,7 @@ type Plugin<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extens
  *
  * @typeParam E - A type extending {@link GunshiParams} to specify the shape of {@linkcode CommandContext}'s extensions.
  */
-interface PluginWithExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E$1> {
+interface PluginWithExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E> {
   /**
    * Plugin identifier
    */
@@ -239,7 +239,7 @@ interface PluginWithExtension<E$1 extends GunshiParams['extensions'] = DefaultGu
   /**
    * Plugin extension
    */
-  extension: CommandContextExtension<E$1>;
+  extension: CommandContextExtension<E>;
 }
 /**
  * Plugin return type without extension, which includes the plugin ID, name, and dependencies, but no extension.
@@ -248,7 +248,7 @@ interface PluginWithExtension<E$1 extends GunshiParams['extensions'] = DefaultGu
  *
  * @typeParam E - A type extending {@link GunshiParams} to specify the shape of {@linkcode CommandContext}'s extensions.
  */
-interface PluginWithoutExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E$1> {
+interface PluginWithoutExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E> {
   /**
    * Plugin identifier
    */
@@ -572,7 +572,7 @@ interface CliOptions<G extends GunshiParamsConstraint = DefaultGunshiParams> {
   /**
    * Sub commands.
    */
-  subCommands?: Record<string, Command<any> | LazyCommand<any>> | Map<string, Command<any> | LazyCommand<any>>;
+  subCommands?: Record<string, SubCommandable> | Map<string, SubCommandable>;
   /**
    * Left margin of the command output.
    */
@@ -759,7 +759,7 @@ type CommandContextCore<G extends GunshiParamsConstraint = DefaultGunshiParams>
  *
  * @since v0.27.0
  */
-interface CommandContextExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
+interface CommandContextExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
   /**
    * Plugin identifier
    */
@@ -767,7 +767,7 @@ interface CommandContextExtension<E$1 extends GunshiParams['extensions'] = Defau
   /**
    * Plugin extension factory
    */
-  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E$1>;
+  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E>;
   /**
    * Plugin extension factory after hook
    */
@@ -886,6 +886,60 @@ type LazyCommand<G extends GunshiParamsConstraint = DefaultGunshiParams, D exten
  * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command.
  */
 type Commandable<G extends GunshiParamsConstraint = DefaultGunshiParams> = Command<G> | LazyCommand<G, {}>;
+/**
+ * Sub-command entry type for use in subCommands.
+ *
+ * This type uses a loose structural match to bypass TypeScript's contravariance issues
+ * with function parameters, allowing any Command or LazyCommand to be used as a sub-command.
+ *
+ * @since v0.27.1
+ */
+interface SubCommandable {
+  /**
+   * see {@link Command.name}
+   */
+  name?: string;
+  /**
+   * see {@link Command.description}
+   */
+  description?: string;
+  /**
+   * see {@link Command.args}
+   */
+  args?: Args | Record<string, any>;
+  /**
+   * see {@link Command.examples}
+   */
+  examples?: string | ((...args: any[]) => any);
+  /**
+   * see {@link Command.run}
+   */
+  run?: (...args: any[]) => any;
+  /**
+   * see {@link Command.toKebab}
+   */
+  toKebab?: boolean;
+  /**
+   * see {@link Command.internal}
+   */
+  internal?: boolean;
+  /**
+   * see {@link Command.entry}
+   */
+  entry?: boolean;
+  /**
+   * see {@link Command.rendering}
+   */
+  rendering?: any;
+  /**
+   * see {@link LazyCommand.commandName}
+   */
+  commandName?: string;
+  /**
+   * Index signature to allow additional properties
+   */
+  [key: string]: any;
+}
 /**
  * Command examples fetcher.
  *
@@ -958,4 +1012,4 @@ type RendererDecorator<T, G extends GunshiParamsConstraint = DefaultGunshiParams
  */
 type ValidationErrorsDecorator<G extends GunshiParamsConstraint = DefaultGunshiParams> = (baseRenderer: (ctx: Readonly<CommandContext<G>>, error: AggregateError) => Promise<string>, ctx: Readonly<CommandContext<G>>, error: AggregateError) => Promise<string>;
 //#endregion
-export { ValidationErrorsDecorator as A, PluginContext as B, GunshiParams as C, Prettify as D, NormalizeToGunshiParams as E, PluginFunction as F, PluginOptions as I, PluginWithExtension as L, Plugin as M, PluginDependency as N, RendererDecorator as O, PluginExtension as P, PluginWithoutExtension as R, ExtractExtensions as S, LazyCommand as T, Commandable as _, Awaitable as a, ExtractArgExplicitlyProvided as b, CommandCallMode as c, CommandContextExtension as d, CommandDecorator as f, CommandRunner as g, CommandLoader as h, Args$1 as i, OnPluginExtension as j, RenderingOptions as k, CommandContext as l, CommandExamplesFetcher as m, ArgToken$1 as n, CliOptions as o, CommandEnvironment as p, ArgValues$1 as r, Command as s, ArgSchema$1 as t, CommandContextCore as u, DefaultGunshiParams as v, GunshiParamsConstraint as w, ExtractArgs as x, ExtendContext as y, plugin as z };
+export { SubCommandable as A, plugin as B, GunshiParams as C, Prettify as D, NormalizeToGunshiParams as E, PluginExtension as F, PluginFunction as I, PluginOptions as L, OnPluginExtension as M, Plugin as N, RendererDecorator as O, PluginDependency as P, PluginWithExtension as R, ExtractExtensions as S, LazyCommand as T, PluginContext as V, Commandable as _, Awaitable as a, ExtractArgExplicitlyProvided as b, CommandCallMode as c, CommandContextExtension as d, CommandDecorator as f, CommandRunner as g, CommandLoader as h, Args$1 as i, ValidationErrorsDecorator as j, RenderingOptions as k, CommandContext as l, CommandExamplesFetcher as m, ArgToken$1 as n, CliOptions as o, CommandEnvironment as p, ArgValues$1 as r, Command as s, ArgSchema$1 as t, CommandContextCore as u, DefaultGunshiParams as v, GunshiParamsConstraint as w, ExtractArgs as x, ExtendContext as y, PluginWithoutExtension as z };

package/lib/{utils-BVBpgaJv.d.ts → utils-_mX9Q7d9.d.ts}

@@ -1,4 +1,4 @@
-import { T as LazyCommand, _ as Commandable, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-DIfsK4mZ.js";
+import { T as LazyCommand, _ as Commandable, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-B2vSsTAs.js";
 import { kebabnize } from "args-tokens/utils";
 
 //#region src/utils.d.ts
@@ -43,8 +43,6 @@ declare function log(...args: unknown[]): void;
  * @param ignores - Properties to ignore during freezing
  * @returns A frozen object
  */
-declare function deepFreeze<T extends Record<string, any>>(
-// eslint-disable-line @typescript-eslint/no-explicit-any -- NOTE(kazupon): generic type for deepFreeze
-obj: T, ignores?: string[]): Readonly<T>;
+declare function deepFreeze<T extends Record<string, any>>(obj: T, ignores?: string[]): Readonly<T>;
 //#endregion
 export { log as a, kebabnize as i, deepFreeze as n, resolveLazyCommand as o, isLazyCommand as r, create as t };

package/lib/utils.d.ts

@@ -1,3 +1,3 @@
-import "./types-DIfsK4mZ.js";
-import { a as log, i as kebabnize, n as deepFreeze, o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-BVBpgaJv.js";
+import "./types-B2vSsTAs.js";
+import { a as log, i as kebabnize, n as deepFreeze, o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-_mX9Q7d9.js";
 export { create, deepFreeze, isLazyCommand, kebabnize, log, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.27.0",
+  "version": "0.27.4",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -104,12 +104,12 @@
     "jsr-exports-lint": "^0.4.1",
     "publint": "^0.3.16",
     "tsdown": "0.15.12",
-    "zod": "^4.1.13",
-    "@gunshi/plugin-global": "0.27.0",
-    "@gunshi/plugin-renderer": "0.27.0",
-    "@gunshi/resources": "0.27.0",
-    "@gunshi/plugin-i18n": "0.27.0",
-    "@gunshi/shared": "0.27.0"
+    "zod": "^4.2.1",
+    "@gunshi/plugin-i18n": "0.27.4",
+    "@gunshi/plugin-global": "0.27.4",
+    "@gunshi/shared": "0.27.4",
+    "@gunshi/plugin-renderer": "0.27.4",
+    "@gunshi/resources": "0.27.4"
   },
   "scripts": {
     "build": "tsdown",