gunshi 0.27.3 → 0.27.5

package/lib/bone.d.ts

@@ -1,4 +1,4 @@
-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-n4yrH5jq.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-Bh6G4DvQ.js";
 
 //#region src/cli/bone.d.ts
 /**

package/lib/{cli-CvbMnupQ.js → cli-BtnhCdFu.js}

@@ -1,6 +1,6 @@
 import { t as cliCore } from "./core-D15eimMG.js";
-import { t as plugin } from "./plugin-bQlPfOlH.js";
-import { a as namespacedId, s as COMMON_ARGS, t as renderer } from "./src-CY4_1ike.js";
+import { t as plugin } from "./plugin-vBhmK2n3.js";
+import { a as namespacedId, s as COMMON_ARGS, t as renderer } from "./src-BXKp6yTi.js";
 
 //#region ../plugin-global/src/types.ts
 /**

package/lib/{context-Pe5vk9kJ.d.ts → context-DZzjf_Et.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-n4yrH5jq.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-Bh6G4DvQ.js";
 
 //#region src/context.d.ts
 

package/lib/context.d.ts

@@ -1,3 +1,3 @@
-import "./types-n4yrH5jq.js";
-import { n as ExtractExtensions, r as createCommandContext, t as CommandContextParams } from "./context-Pe5vk9kJ.js";
+import "./types-Bh6G4DvQ.js";
+import { n as ExtractExtensions, r as createCommandContext, t as CommandContextParams } from "./context-DZzjf_Et.js";
 export { CommandContextParams, ExtractExtensions, createCommandContext };

package/lib/{definition-BNViywAg.d.ts → definition-DhDR8aNJ.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-n4yrH5jq.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-Bh6G4DvQ.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-n4yrH5jq.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-Pe5vk9kJ.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-BNViywAg.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-Bh6G4DvQ.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-DZzjf_Et.js";
+import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-DhDR8aNJ.js";
 export { ArgSchema, ArgValues, Args, Command, CommandContextParams, CommandLoader, CommandRunner, DefaultGunshiParams, ExtendContext, GunshiParams, LazyCommand, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };

package/lib/definition.js

@@ -1,5 +1,112 @@
 import { t as createCommandContext } from "./context-DRQZ3doU.js";
 import "./utils-DA31tfdY.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-D5821Sur.js";
 
+//#region src/definition.ts
+/**
+* Define a {@link Command | command}.
+*
+* @typeParam G - A {@link GunshiParamsConstraint} type
+*
+* @param definition - A {@link Command | command} definition
+* @returns A defined {@link Command | command}
+*/
+function define(definition) {
+	return definition;
+}
+/**
+* Define a {@link Command | command} with types
+*
+* This helper function allows specifying the type parameter of {@link GunshiParams}
+* while inferring the {@link Args} type, {@link ExtendContext} type from the definition.
+*
+* @example
+* ```ts
+* // Define a command with specific extensions type
+* type MyExtensions = { logger: { log: (message: string) => void } }
+*
+* const command = defineWithTypes<{ extensions: MyExtensions }>()({
+*   name: 'greet',
+*   args: {
+*     name: { type: 'string' }
+*   },
+*   run: ctx => {
+*     // ctx.values is inferred as { name?: string }
+*     // ctx.extensions is MyExtensions
+*   }
+* })
+* ```
+*
+* @typeParam G - A {@link GunshiParams} type
+*
+* @returns A function that takes a command definition via {@link define}
+*
+* @since v0.27.0
+*/
+function defineWithTypes() {
+	return (definition) => {
+		return define(definition);
+	};
+}
+/**
+* Define a {@link LazyCommand | lazy command} with or without definition.
+*
+* @param loader - A {@link CommandLoader | command loader} function that returns a command definition
+* @param definition - An optional {@link Command | command} definition
+* @returns A {@link LazyCommand | lazy command} that can be executed later
+*/
+function lazy(loader, definition) {
+	const lazyCommand = loader;
+	if (definition != null) {
+		lazyCommand.commandName = definition.name;
+		lazyCommand.description = definition.description;
+		lazyCommand.args = definition.args;
+		lazyCommand.examples = definition.examples;
+		lazyCommand.internal = definition.internal;
+		lazyCommand.entry = definition.entry;
+		lazyCommand.toKebab = definition.toKebab;
+		if ("resource" in definition) lazyCommand.resource = definition.resource;
+	}
+	return lazyCommand;
+}
+/**
+* Define a {@link LazyCommand | lazy command} with specific type parameters.
+*
+* This helper function allows specifying the type parameter of {@link GunshiParams}
+* while inferring the {@link Args} type, {@link ExtendContext} type from the definition.
+*
+* @example
+* ```ts
+* type MyExtensions = { logger: { log: (message: string) => void } }
+*
+* const command = lazyWithTypes<{ extensions: MyExtensions }>()(
+*   () => {
+*     return ctx => {
+*       // Command runner implementation
+*       ctx.extensions.logger?.log('Command executed')
+*   },
+*  {
+*   name: 'lazy-command',
+*   args: {
+*     opt: {
+*       type: 'string',
+*       description: 'An optional string argument',
+*       required: false,
+*     },
+*   },
+* )
+* ```
+*
+* @typeParam G - A {@link GunshiParams} type
+*
+* @returns A function that takes a lazy command definition via {@link lazy}
+*
+* @since v0.27.0
+*/
+function lazyWithTypes() {
+	return (loader, definition) => {
+		return lazy(loader, definition);
+	};
+}
+
+//#endregion
 export { 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-n4yrH5jq.js";
+import { T as LazyCommand, o as CliOptions, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-Bh6G4DvQ.js";
 
 //#region src/generator.d.ts
 

package/lib/generator.js

@@ -1,9 +1,9 @@
 import "./context-DRQZ3doU.js";
 import { t as create } from "./utils-DA31tfdY.js";
 import "./core-D15eimMG.js";
-import "./plugin-bQlPfOlH.js";
-import "./src-CY4_1ike.js";
-import { t as cli } from "./cli-CvbMnupQ.js";
+import "./plugin-vBhmK2n3.js";
+import "./src-BXKp6yTi.js";
+import { t as cli } from "./cli-BtnhCdFu.js";
 
 //#region src/generator.ts
 /**

package/lib/{index-CCtD9wBS.d.ts → index-DuyhzAeh.d.ts}

@@ -1,4 +1,4 @@
-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-n4yrH5jq.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-Bh6G4DvQ.js";
 import { parseArgs as parseArgs$1, resolveArgs as resolveArgs$1 } from "args-tokens";
 
 //#region ../plugin-i18n/src/types.d.ts
@@ -104,18 +104,6 @@ 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.
  *
@@ -166,5 +154,22 @@ declare function cli<E extends ExtendContext = ExtendContext, G extends GunshiPa
  * @returns A rendered usage or undefined. if you will use {@linkcode CliOptions.usageSilent} option, it will return rendered usage string.
  */
 declare function cli<G extends GunshiParams = DefaultGunshiParams>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
+/**
+ * Run the command.
+ *
+ * This overload accepts any command-like object using a loose structural type.
+ * It bypasses TypeScript contravariance issues with callback properties.
+ *
+ * Note: This overload MUST be last in the overload list. TypeScript checks overloads
+ * in declaration order and selects the first matching one. The SubCommandable type
+ * is intentionally loose and would match any command, so placing it first would
+ * prevent proper type inference for more specific command types.
+ *
+ * @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>;
 //#endregion
 export { DefaultTranslation as i, resolveArgs$1 as n, cli as r, parseArgs$1 as t };

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-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-n4yrH5jq.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-Pe5vk9kJ.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-BNViywAg.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./plugin-aAXfXUT6.js";
-import { i as DefaultTranslation, n as resolveArgs, r as cli, t as parseArgs } from "./index-CCtD9wBS.js";
-import "./utils-BV37YoO0.js";
+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-Bh6G4DvQ.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-DZzjf_Et.js";
+import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-DhDR8aNJ.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./plugin-DvvZ2zsE.js";
+import { i as DefaultTranslation, n as resolveArgs, r as cli, t as parseArgs } from "./index-DuyhzAeh.js";
+import "./utils-DPF_9WLN.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

@@ -1,10 +1,10 @@
 import { n as ANONYMOUS_COMMAND_NAME, t as createCommandContext } from "./context-DRQZ3doU.js";
 import "./utils-DA31tfdY.js";
 import "./core-D15eimMG.js";
-import { i as lazyWithTypes, n as defineWithTypes, r as lazy, t as define } from "./definition-D5821Sur.js";
-import { t as plugin } from "./plugin-bQlPfOlH.js";
-import { a as namespacedId, o as BUILT_IN_PREFIX } from "./src-CY4_1ike.js";
-import { t as cli } from "./cli-CvbMnupQ.js";
+import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
+import { t as plugin } from "./plugin-vBhmK2n3.js";
+import { a as namespacedId, o as BUILT_IN_PREFIX } from "./src-BXKp6yTi.js";
+import { t as cli } from "./cli-BtnhCdFu.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region ../plugin-i18n/src/translation.ts
@@ -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-aAXfXUT6.d.ts → plugin-DvvZ2zsE.d.ts}

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

package/lib/plugin.d.ts

@@ -1,4 +1,4 @@
-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-n4yrH5jq.js";
-import { r as createCommandContext, t as CommandContextParams } from "./context-Pe5vk9kJ.js";
-import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./plugin-aAXfXUT6.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-Bh6G4DvQ.js";
+import { r as createCommandContext, t as CommandContextParams } from "./context-DZzjf_Et.js";
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./plugin-DvvZ2zsE.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/plugin.js

@@ -1,5 +1,5 @@
 import { n as ANONYMOUS_COMMAND_NAME, r as CLI_OPTIONS_DEFAULT, t as createCommandContext } from "./context-DRQZ3doU.js";
 import "./utils-DA31tfdY.js";
-import { t as plugin } from "./plugin-bQlPfOlH.js";
+import { t as plugin } from "./plugin-vBhmK2n3.js";
 
 export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext, plugin };

package/lib/renderer.d.ts

@@ -1,9 +1,9 @@
-import { C as GunshiParams, l as CommandContext, v as DefaultGunshiParams } from "./types-n4yrH5jq.js";
-import "./context-Pe5vk9kJ.js";
-import "./definition-BNViywAg.js";
-import "./plugin-aAXfXUT6.js";
-import "./index-CCtD9wBS.js";
-import "./utils-BV37YoO0.js";
+import { C as GunshiParams, l as CommandContext, v as DefaultGunshiParams } from "./types-Bh6G4DvQ.js";
+import "./context-DZzjf_Et.js";
+import "./definition-DhDR8aNJ.js";
+import "./plugin-DvvZ2zsE.js";
+import "./index-DuyhzAeh.js";
+import "./utils-DPF_9WLN.js";
 
 //#region ../plugin-renderer/src/header.d.ts
 /**

package/lib/renderer.js

@@ -1,6 +1,6 @@
 import "./context-DRQZ3doU.js";
 import "./utils-DA31tfdY.js";
-import "./plugin-bQlPfOlH.js";
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-CY4_1ike.js";
+import "./plugin-vBhmK2n3.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-BXKp6yTi.js";
 
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{src-CY4_1ike.js → src-BXKp6yTi.js}

@@ -1,6 +1,6 @@
 import { n as ANONYMOUS_COMMAND_NAME } from "./context-DRQZ3doU.js";
 import { i as kebabnize, o as resolveLazyCommand } from "./utils-DA31tfdY.js";
-import { t as plugin } from "./plugin-bQlPfOlH.js";
+import { t as plugin } from "./plugin-vBhmK2n3.js";
 
 //#region ../shared/src/constants.ts
 /**

package/lib/{types-n4yrH5jq.d.ts → types-Bh6G4DvQ.d.ts}

@@ -895,27 +895,49 @@ type Commandable<G extends GunshiParamsConstraint = DefaultGunshiParams> = Comma
  * @since v0.27.1
  */
 interface SubCommandable {
-  /** Command name */
+  /**
+   * see {@link Command.name}
+   */
   name?: string;
-  /** Command description */
+  /**
+   * see {@link Command.description}
+   */
   description?: string;
-  /** Command arguments - accepts any args structure */
+  /**
+   * see {@link Command.args}
+   */
   args?: Args | Record<string, any>;
-  /** Command examples */
+  /**
+   * see {@link Command.examples}
+   */
   examples?: string | ((...args: any[]) => any);
-  /** Command runner */
+  /**
+   * see {@link Command.run}
+   */
   run?: (...args: any[]) => any;
-  /** Whether to convert camelCase to kebab-case */
+  /**
+   * see {@link Command.toKebab}
+   */
   toKebab?: boolean;
-  /** Whether this is an internal command */
+  /**
+   * see {@link Command.internal}
+   */
   internal?: boolean;
-  /** Whether this is an entry command */
+  /**
+   * see {@link Command.entry}
+   */
   entry?: boolean;
-  /** Rendering options */
+  /**
+   * see {@link Command.rendering}
+   */
   rendering?: any;
-  /** Command name for lazy commands */
+  /**
+   * see {@link LazyCommand.commandName}
+   */
   commandName?: string;
-  /** Index signature to allow additional properties */
+  /**
+   * Index signature to allow additional properties
+   */
   [key: string]: any;
 }
 /**

package/lib/{utils-BV37YoO0.d.ts → utils-DPF_9WLN.d.ts}

@@ -1,4 +1,4 @@
-import { T as LazyCommand, _ as Commandable, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-n4yrH5jq.js";
+import { T as LazyCommand, _ as Commandable, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-Bh6G4DvQ.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-n4yrH5jq.js";
-import { a as log, i as kebabnize, n as deepFreeze, o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-BV37YoO0.js";
+import "./types-Bh6G4DvQ.js";
+import { a as log, i as kebabnize, n as deepFreeze, o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-DPF_9WLN.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.3",
+  "version": "0.27.5",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -99,17 +99,17 @@
     "args-tokens": "^0.23.0"
   },
   "devDependencies": {
-    "deno": "^2.5.6",
+    "deno": "^2.6.3",
     "jsr": "^0.13.5",
     "jsr-exports-lint": "^0.4.1",
     "publint": "^0.3.16",
     "tsdown": "0.15.12",
     "zod": "^4.2.1",
-    "@gunshi/plugin-global": "0.27.3",
-    "@gunshi/plugin-renderer": "0.27.3",
-    "@gunshi/resources": "0.27.3",
-    "@gunshi/shared": "0.27.3",
-    "@gunshi/plugin-i18n": "0.27.3"
+    "@gunshi/plugin-global": "0.27.5",
+    "@gunshi/plugin-renderer": "0.27.5",
+    "@gunshi/plugin-i18n": "0.27.5",
+    "@gunshi/shared": "0.27.5",
+    "@gunshi/resources": "0.27.5"
   },
   "scripts": {
     "build": "tsdown",

package/lib/definition-D5821Sur.js

@@ -1,109 +0,0 @@
-//#region src/definition.ts
-/**
-* Define a {@link Command | command}.
-*
-* @typeParam G - A {@link GunshiParamsConstraint} type
-*
-* @param definition - A {@link Command | command} definition
-* @returns A defined {@link Command | command}
-*/
-function define(definition) {
-	return definition;
-}
-/**
-* Define a {@link Command | command} with types
-*
-* This helper function allows specifying the type parameter of {@link GunshiParams}
-* while inferring the {@link Args} type, {@link ExtendContext} type from the definition.
-*
-* @example
-* ```ts
-* // Define a command with specific extensions type
-* type MyExtensions = { logger: { log: (message: string) => void } }
-*
-* const command = defineWithTypes<{ extensions: MyExtensions }>()({
-*   name: 'greet',
-*   args: {
-*     name: { type: 'string' }
-*   },
-*   run: ctx => {
-*     // ctx.values is inferred as { name?: string }
-*     // ctx.extensions is MyExtensions
-*   }
-* })
-* ```
-*
-* @typeParam G - A {@link GunshiParams} type
-*
-* @returns A function that takes a command definition via {@link define}
-*
-* @since v0.27.0
-*/
-function defineWithTypes() {
-	return (definition) => {
-		return define(definition);
-	};
-}
-/**
-* Define a {@link LazyCommand | lazy command} with or without definition.
-*
-* @param loader - A {@link CommandLoader | command loader} function that returns a command definition
-* @param definition - An optional {@link Command | command} definition
-* @returns A {@link LazyCommand | lazy command} that can be executed later
-*/
-function lazy(loader, definition) {
-	const lazyCommand = loader;
-	if (definition != null) {
-		lazyCommand.commandName = definition.name;
-		lazyCommand.description = definition.description;
-		lazyCommand.args = definition.args;
-		lazyCommand.examples = definition.examples;
-		lazyCommand.internal = definition.internal;
-		lazyCommand.entry = definition.entry;
-		lazyCommand.toKebab = definition.toKebab;
-		if ("resource" in definition) lazyCommand.resource = definition.resource;
-	}
-	return lazyCommand;
-}
-/**
-* Define a {@link LazyCommand | lazy command} with specific type parameters.
-*
-* This helper function allows specifying the type parameter of {@link GunshiParams}
-* while inferring the {@link Args} type, {@link ExtendContext} type from the definition.
-*
-* @example
-* ```ts
-* type MyExtensions = { logger: { log: (message: string) => void } }
-*
-* const command = lazyWithTypes<{ extensions: MyExtensions }>()(
-*   () => {
-*     return ctx => {
-*       // Command runner implementation
-*       ctx.extensions.logger?.log('Command executed')
-*   },
-*  {
-*   name: 'lazy-command',
-*   args: {
-*     opt: {
-*       type: 'string',
-*       description: 'An optional string argument',
-*       required: false,
-*     },
-*   },
-* )
-* ```
-*
-* @typeParam G - A {@link GunshiParams} type
-*
-* @returns A function that takes a lazy command definition via {@link lazy}
-*
-* @since v0.27.0
-*/
-function lazyWithTypes() {
-	return (loader, definition) => {
-		return lazy(loader, definition);
-	};
-}
-
-//#endregion
-export { lazyWithTypes as i, defineWithTypes as n, lazy as r, define as t };