gunshi 0.27.0-beta.3 → 0.27.0-beta.4

package/lib/bone.d.ts

@@ -1,6 +1,10 @@
-import { 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 } from "./types-DpGOiC0p.js";
+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";
 
 //#region src/cli/bone.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 
 /**
  * Run the command.

package/lib/bone.js

@@ -1,9 +1,13 @@
-import "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
-import { cliCore } from "./core-clRbigv-.js";
+import "./context-DRQZ3doU.js";
+import "./utils-DA31tfdY.js";
+import { t as cliCore } from "./core-D15eimMG.js";
 
 //#region src/cli/bone.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Run the command.
 *
 * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.

package/lib/{cli-B121JwoR.js → cli-CTN-xtKX.js}

@@ -1,9 +1,13 @@
-import { cliCore } from "./core-clRbigv-.js";
-import { plugin } from "./plugin-BRVcC8lF.js";
-import { COMMON_ARGS, namespacedId, renderer } from "./src-hz2EqFqR.js";
+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-DZnfAAwF.js";
 
 //#region ../plugin-global/src/types.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * The unique identifier for the global options plugin.
 */
 const pluginId = namespacedId("global");
@@ -11,6 +15,10 @@ const pluginId = namespacedId("global");
 //#endregion
 //#region ../plugin-global/src/decorator.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Decorator function to extend the command with global options.
 *
 * @param baseRunner - The base command runner
@@ -84,6 +92,35 @@ function extension(ctx) {
 //#endregion
 //#region ../plugin-global/src/index.ts
 /**
+* The entry point of global options plugin
+*
+* @example
+* ```js
+* import global from '@gunshi/plugin-global'
+* import { cli } from 'gunshi'
+*
+* const entry = (ctx) => {
+*   // ...
+* }
+*
+* await cli(process.argv.slice(2), entry, {
+*   // ...
+*
+*   plugins: [
+*     global()
+*   ],
+*
+*   // ...
+* })
+* ```
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * global options plugin
 *
 * @returns A defined plugin as global options
@@ -103,6 +140,10 @@ function global() {
 //#endregion
 //#region src/cli/builtin.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Run the command.
 *
 * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
@@ -117,4 +158,4 @@ async function cli(args, entry, options = {}) {
 }
 
 //#endregion
-export { cli };
+export { cli as t };

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

@@ -1,4 +1,4 @@
-import { ArgToken, ArgValues, Args, CliOptions, Command, CommandCallMode, CommandContext, CommandContextExtension, DefaultGunshiParams, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, GunshiParams, GunshiParamsConstraint, LazyCommand } from "./types-DpGOiC0p.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-DIfsK4mZ.js";
 
 //#region src/context.d.ts
 
@@ -94,4 +94,4 @@ declare function createCommandContext<G extends GunshiParamsConstraint = Default
   extensions: ExtractExtensions<E>;
 }>>>>;
 //#endregion
-export { CommandContextParams, ExtractExtensions, createCommandContext };
+export { ExtractExtensions as n, createCommandContext as r, CommandContextParams as t };

package/lib/{context-CaqWZ3MF.js → context-DRQZ3doU.js}

@@ -1,4 +1,4 @@
-import { create, deepFreeze, isLazyCommand, log } from "./utils-Bh4TdPy8.js";
+import { a as log, n as deepFreeze, r as isLazyCommand, t as create } from "./utils-DA31tfdY.js";
 
 //#region src/constants.ts
 const ANONYMOUS_COMMAND_NAME = "(anonymous)";
@@ -27,6 +27,21 @@ const CLI_OPTIONS_DEFAULT = {
 //#endregion
 //#region src/context.ts
 /**
+* The entry for gunshi context.
+* This module is exported for the purpose of testing the command.
+*
+* @example
+* ```js
+* import { createCommandContext } from 'gunshi/context'
+* ```
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Create a command context.
 *
 * @param param - A {@link CommandContextParams | parameters} to create a command context.
@@ -98,4 +113,4 @@ function getCommandName(cmd) {
 }
 
 //#endregion
-export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, NOOP, createCommandContext };
+export { NOOP as i, ANONYMOUS_COMMAND_NAME as n, CLI_OPTIONS_DEFAULT as r, createCommandContext as t };

package/lib/context.d.ts

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

package/lib/context.js

@@ -1,4 +1,4 @@
-import { createCommandContext } from "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
+import { t as createCommandContext } from "./context-DRQZ3doU.js";
+import "./utils-DA31tfdY.js";
 
 export { createCommandContext };

package/lib/{core-clRbigv-.js → core-D15eimMG.js}

@@ -1,9 +1,9 @@
-import { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, NOOP, createCommandContext } from "./context-CaqWZ3MF.js";
-import { create, isLazyCommand, resolveLazyCommand } from "./utils-Bh4TdPy8.js";
+import { i as NOOP, n as ANONYMOUS_COMMAND_NAME, r as CLI_OPTIONS_DEFAULT, t as createCommandContext } from "./context-DRQZ3doU.js";
+import { o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-DA31tfdY.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/decorators.ts
-const EMPTY_RENDERER = async () => "";
+const EMPTY_RENDERER = () => Promise.resolve("");
 /**
 * Factory function for creating a decorators manager.
 *
@@ -162,6 +162,10 @@ function resolveDependencies(plugins) {
 //#endregion
 //#region src/cli/core.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Run the command.
 *
 * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
@@ -179,7 +183,7 @@ async function cliCore(argv, entry, options, plugins) {
 	const cliOptions = normalizeCliOptions(options, decorators, pluginContext);
 	const tokens = parseArgs(argv);
 	const subCommand = getSubCommand(tokens);
-	const { commandName: name, command, callMode } = await resolveCommand(subCommand, entry, cliOptions);
+	const { commandName: name, command, callMode } = resolveCommand(subCommand, entry, cliOptions);
 	if (!command) throw new Error(`Command not found: ${name || ""}`);
 	const args = resolveArguments(pluginContext, getCommandArgs(command));
 	const { explicit, values, positionals, rest, error } = resolveArgs(args, tokens, {
@@ -262,9 +266,9 @@ function getSubCommand(tokens) {
 	return firstToken && firstToken.kind === "positional" && firstToken.index === 0 && firstToken.value ? firstToken.value : "";
 }
 const CANNOT_RESOLVE_COMMAND = { callMode: "unexpected" };
-async function resolveCommand(sub, entry, options) {
+function resolveCommand(sub, entry, options) {
 	const omitted = !sub;
-	async function doResolveCommand() {
+	function doResolveCommand() {
 		if (typeof entry === "function") if ("commandName" in entry && entry.commandName) return {
 			commandName: entry.commandName,
 			command: entry,
@@ -332,4 +336,4 @@ async function executeCommand(cmd, ctx, decorators) {
 }
 
 //#endregion
-export { cliCore };
+export { cliCore as t };

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

@@ -1,6 +1,10 @@
-import { Args, Command, CommandLoader, DefaultGunshiParams, ExtendContext, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, Prettify } from "./types-DpGOiC0p.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-DIfsK4mZ.js";
 
 //#region src/definition.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 
 /**
  * Infer command properties excluding for {@link define} function
@@ -44,8 +48,8 @@ type CommandDefinitionResult<G extends GunshiParamsConstraint = DefaultGunshiPar
  * @param definition - A {@link Command | command} definition
  * @returns A defined {@link Command | command}
  */
-declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams, A extends Args = ExtractArgs<G>, C extends InferCommandProps<G> = InferCommandProps<G>>(definition: C & Command<{
-  args: A;
+declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams, A$1 extends Args = ExtractArgs<G>, C extends InferCommandProps<G> = InferCommandProps<G>>(definition: C & Command<{
+  args: A$1;
   extensions: ExtractExtensions<G>;
 }>): CommandDefinitionResult<G, C>;
 /**
@@ -55,14 +59,14 @@ declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams,
  *
  * @internal
  */
-type DefineWithTypesReturn<DefaultExtensions extends ExtendContext, DefaultArgs extends Args> = <A extends DefaultArgs = DefaultArgs, C extends Partial<Command<{
-  args: A;
+type DefineWithTypesReturn<DefaultExtensions extends ExtendContext, DefaultArgs extends Args> = <A$1 extends DefaultArgs = DefaultArgs, C extends Partial<Command<{
+  args: A$1;
   extensions: DefaultExtensions;
 }>> = {}>(definition: C & Command<{
-  args: A;
+  args: A$1;
   extensions: DefaultExtensions;
 }>) => CommandDefinitionResult<{
-  args: A;
+  args: A$1;
   extensions: DefaultExtensions;
 }, C>;
 /**
@@ -109,11 +113,11 @@ declare function defineWithTypes<G extends GunshiParamsConstraint>(): DefineWith
  * @param loader - A {@link CommandLoader | command loader}
  * @returns A {@link LazyCommand | lazy command} with loader
  */
-declare function lazy<A extends Args>(loader: CommandLoader<{
-  args: A;
+declare function lazy<A$1 extends Args>(loader: CommandLoader<{
+  args: A$1;
   extensions: {};
 }>): LazyCommand<{
-  args: A;
+  args: A$1;
   extensions: {};
 }, {}>;
 /**
@@ -151,17 +155,17 @@ declare function lazy<A extends Args>(loader: CommandLoader<{
  * @param definition - An optional {@link Command | command} definition
  * @returns A {@link LazyCommand | lazy command} that can be executed later
  */
-declare function lazy<G extends GunshiParamsConstraint = DefaultGunshiParams, A extends ExtractArgs<G> = ExtractArgs<G>, D extends Partial<Command<{
-  args: A;
+declare function lazy<G extends GunshiParamsConstraint = DefaultGunshiParams, A$1 extends ExtractArgs<G> = ExtractArgs<G>, D extends Partial<Command<{
+  args: A$1;
   extensions: {};
 }>> = Partial<Command<{
-  args: A;
+  args: A$1;
   extensions: {};
 }>>>(loader: CommandLoader<{
-  args: A;
+  args: A$1;
   extensions: {};
 }>, definition: D): LazyCommand<{
-  args: A;
+  args: A$1;
   extensions: {};
 }, D>;
 /**
@@ -232,4 +236,4 @@ type LazyWithTypesReturn<FullG extends GunshiParamsConstraint> = <D extends Part
  */
 declare function lazyWithTypes<G extends GunshiParamsConstraint>(): LazyWithTypesReturn<NormalizeGunshiParams<G>>;
 //#endregion
-export { define, defineWithTypes, lazy, lazyWithTypes };
+export { lazyWithTypes as i, defineWithTypes as n, lazy as r, define as t };

package/lib/{definition-qbPc8FcH.js → definition-D5821Sur.js}

@@ -106,4 +106,4 @@ function lazyWithTypes() {
 }
 
 //#endregion
-export { define, defineWithTypes, lazy, lazyWithTypes };
+export { lazyWithTypes as i, defineWithTypes as n, lazy as r, define as t };

package/lib/definition.d.ts

@@ -1,4 +1,4 @@
-import { ArgSchema, ArgValues, Args, Command, CommandLoader, CommandRunner, DefaultGunshiParams, ExtendContext, GunshiParams, LazyCommand } from "./types-DpGOiC0p.js";
-import { CommandContextParams, createCommandContext } from "./context-C7rkDQK3.js";
-import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition-BPAFRYmH.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-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";
 export { ArgSchema, ArgValues, Args, Command, CommandContextParams, CommandLoader, CommandRunner, DefaultGunshiParams, ExtendContext, GunshiParams, LazyCommand, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };

package/lib/definition.js

@@ -1,5 +1,5 @@
-import { createCommandContext } from "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
-import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition-qbPc8FcH.js";
+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";
 
 export { createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };

package/lib/generator.d.ts

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

package/lib/generator.js

@@ -1,12 +1,26 @@
-import "./context-CaqWZ3MF.js";
-import { create } from "./utils-Bh4TdPy8.js";
-import "./core-clRbigv-.js";
-import "./plugin-BRVcC8lF.js";
-import "./src-hz2EqFqR.js";
-import { cli } from "./cli-B121JwoR.js";
+import "./context-DRQZ3doU.js";
+import { t as create } from "./utils-DA31tfdY.js";
+import "./core-D15eimMG.js";
+import "./plugin-bQlPfOlH.js";
+import "./src-DZnfAAwF.js";
+import { t as cli } from "./cli-CTN-xtKX.js";
 
 //#region src/generator.ts
 /**
+* The entry for usage generator.
+*
+* @example
+* ```js
+* import { generate } from 'gunshi/generator'
+* ```
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Generate the command usage.
 *
 * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command parameters.

package/lib/index-BDRk6VtJ.d.ts

@@ -0,0 +1,158 @@
+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 { parseArgs as parseArgs$1, resolveArgs as resolveArgs$1 } from "args-tokens";
+
+//#region ../plugin-i18n/src/types.d.ts
+
+/**
+ * Translation adapter factory options.
+ */
+interface TranslationAdapterFactoryOptions {
+  /**
+   * A locale (BCP 47 language tag).
+   */
+  locale: string;
+  /**
+   * A fallback locale.
+   *
+   * @default DEFAULT_LOCALE ('en-US')
+   */
+  fallbackLocale: string;
+}
+/**
+ * Translation adapter.
+ *
+ * This adapter is used to custom message formatter like {@link https://github.com/intlify/vue-i18n/blob/master/spec/syntax.ebnf | Intlify message format}, {@link https://github.com/tc39/proposal-intl-messageformat | `Intl.MessageFormat` (MF2)}, and etc.
+ * This adapter will support localization with your preferred message format.
+ */
+interface TranslationAdapter<MessageResource = string> {
+  /**
+   * Get a resource of locale.
+   *
+   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+   * @returns A resource of locale. if resource not found, return `undefined`.
+   */
+  getResource(locale: string): Record<string, string> | undefined;
+  /**
+   * Set a resource of locale.
+   *
+   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+   * @param resource - A resource of locale
+   */
+  setResource(locale: string, resource: Record<string, string>): void;
+  /**
+   * Get a message of locale.
+   *
+   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+   * @param key - A key of message resource
+   * @returns A message of locale. if message not found, return `undefined`.
+   */
+  getMessage(locale: string, key: string): MessageResource | undefined;
+  /**
+   * Translate a message.
+   *
+   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+   * @param key - A key of message resource
+   * @param values - A values to be resolved in the message
+   * @returns A translated message, if message is not translated, return `undefined`.
+   */
+  translate(locale: string, key: string, values?: Record<string, unknown>): string | undefined;
+}
+//#endregion
+//#region ../plugin-i18n/src/translation.d.ts
+/**
+ * Default implementation of {@linkcode TranslationAdapter}.
+ */
+declare class DefaultTranslation implements TranslationAdapter {
+  #private;
+  /**
+   * Creates a new instance of DefaultTranslation.
+   *
+   * @param options - Options for the translation adapter, see {@linkcode TranslationAdapterFactoryOptions}
+   */
+  constructor(options: TranslationAdapterFactoryOptions);
+  /**
+   * Get a resource of locale.
+   *
+   * @param locale - A locale of resource (BCP 47 language tag)
+   * @returns A resource of locale. If resource not found, return `undefined`.
+   */
+  getResource(locale: string): Record<string, string> | undefined;
+  /**
+   * Set a resource of locale.
+   *
+   * @param locale - A locale of resource (BCP 47 language tag)
+   * @param resource - A resource of locale
+   */
+  setResource(locale: string, resource: Record<string, string>): void;
+  /**
+   * Get a message of locale.
+   *
+   * @param locale - A locale of message (BCP 47 language tag)
+   * @param key - A key of message resource
+   * @returns A message of locale. If message not found, return `undefined`.
+   */
+  getMessage(locale: string, key: string): string | undefined;
+  /**
+   * Translate a message.
+   *
+   * @param locale - A locale of message (BCP 47 language tag)
+   * @param key - A key of message resource
+   * @param values - A values to interpolate in the message
+   * @returns A translated message, if message is not translated, return `undefined`.
+   */
+  translate(locale: string, key: string, values?: Record<string, unknown>): string | undefined;
+}
+//#endregion
+//#region src/cli/builtin.d.ts
+/**
+ * Run the command.
+ *
+ * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
+ *
+ * @param args - Command line arguments
+ * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<G extends GunshiParamsConstraint>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
+/**
+ * Run the command.
+ *
+ * @typeParam A - The type of {@linkcode Args | arguments} defined in the command and cli options.
+ *
+ * @param args - Command line arguments
+ * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<A extends Args$1 = Args$1, G extends GunshiParams = {
+  args: A;
+  extensions: {};
+}>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
+/**
+ * Run the command.
+ *
+ * @typeParam E - An {@linkcode ExtendContext} type to specify the shape of command and cli options.
+ *
+ * @param args - Command line arguments
+ * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<E extends ExtendContext = ExtendContext, G extends GunshiParams = {
+  args: Args$1;
+  extensions: E;
+}>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
+/**
+ * Run the command.
+ *
+ * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
+ *
+ * @param args - Command line arguments
+ * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<G extends GunshiParams = DefaultGunshiParams>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): 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,161 +1,7 @@
-import { 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, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, RenderingOptions, ValidationErrorsDecorator, plugin } from "./types-DpGOiC0p.js";
-import { CommandContextParams, createCommandContext } from "./context-C7rkDQK3.js";
-import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition-BPAFRYmH.js";
-import { ANONYMOUS_COMMAND_NAME } from "./constants-BX52JB9x.js";
-import { parseArgs, resolveArgs } from "args-tokens";
-
-//#region ../plugin-i18n/src/types.d.ts
-
-/**
- * Translation adapter factory options.
- */
-interface TranslationAdapterFactoryOptions {
-  /**
-   * A locale (BCP 47 language tag).
-   */
-  locale: string;
-  /**
-   * A fallback locale.
-   *
-   * @default DEFAULT_LOCALE ('en-US')
-   */
-  fallbackLocale: string;
-}
-/**
- * Translation adapter.
- *
- * This adapter is used to custom message formatter like {@link https://github.com/intlify/vue-i18n/blob/master/spec/syntax.ebnf | Intlify message format}, {@link https://github.com/tc39/proposal-intl-messageformat | `Intl.MessageFormat` (MF2)}, and etc.
- * This adapter will support localization with your preferred message format.
- */
-interface TranslationAdapter<MessageResource = string> {
-  /**
-   * Get a resource of locale.
-   *
-   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
-   * @returns A resource of locale. if resource not found, return `undefined`.
-   */
-  getResource(locale: string): Record<string, string> | undefined;
-  /**
-   * Set a resource of locale.
-   *
-   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
-   * @param resource - A resource of locale
-   */
-  setResource(locale: string, resource: Record<string, string>): void;
-  /**
-   * Get a message of locale.
-   *
-   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
-   * @param key - A key of message resource
-   * @returns A message of locale. if message not found, return `undefined`.
-   */
-  getMessage(locale: string, key: string): MessageResource | undefined;
-  /**
-   * Translate a message.
-   *
-   * @param locale - A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
-   * @param key - A key of message resource
-   * @param values - A values to be resolved in the message
-   * @returns A translated message, if message is not translated, return `undefined`.
-   */
-  translate(locale: string, key: string, values?: Record<string, unknown>): string | undefined;
-}
-//#endregion
-//#region ../plugin-i18n/src/translation.d.ts
-/**
- * Default implementation of {@linkcode TranslationAdapter}.
- */
-declare class DefaultTranslation implements TranslationAdapter {
-  #private;
-  /**
-   * Creates a new instance of DefaultTranslation.
-   *
-   * @param options - Options for the translation adapter, see {@linkcode TranslationAdapterFactoryOptions}
-   */
-  constructor(options: TranslationAdapterFactoryOptions);
-  /**
-   * Get a resource of locale.
-   *
-   * @param locale - A locale of resource (BCP 47 language tag)
-   * @returns A resource of locale. If resource not found, return `undefined`.
-   */
-  getResource(locale: string): Record<string, string> | undefined;
-  /**
-   * Set a resource of locale.
-   *
-   * @param locale - A locale of resource (BCP 47 language tag)
-   * @param resource - A resource of locale
-   */
-  setResource(locale: string, resource: Record<string, string>): void;
-  /**
-   * Get a message of locale.
-   *
-   * @param locale - A locale of message (BCP 47 language tag)
-   * @param key - A key of message resource
-   * @returns A message of locale. If message not found, return `undefined`.
-   */
-  getMessage(locale: string, key: string): string | undefined;
-  /**
-   * Translate a message.
-   *
-   * @param locale - A locale of message (BCP 47 language tag)
-   * @param key - A key of message resource
-   * @param values - A values to interpolate in the message
-   * @returns A translated message, if message is not translated, return `undefined`.
-   */
-  translate(locale: string, key: string, values?: Record<string, unknown>): string | undefined;
-}
-//#endregion
-//#region src/cli/builtin.d.ts
-/**
- * Run the command.
- *
- * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
- *
- * @param args - Command line arguments
- * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<G extends GunshiParamsConstraint>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
-/**
- * Run the command.
- *
- * @typeParam A - The type of {@linkcode Args | arguments} defined in the command and cli options.
- *
- * @param args - Command line arguments
- * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<A extends Args = Args, G extends GunshiParams = {
-  args: A;
-  extensions: {};
-}>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
-/**
- * Run the command.
- *
- * @typeParam E - An {@linkcode ExtendContext} type to specify the shape of command and cli options.
- *
- * @param args - Command line arguments
- * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<E extends ExtendContext = ExtendContext, G extends GunshiParams = {
-  args: Args;
-  extensions: E;
-}>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
-/**
- * Run the command.
- *
- * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command and cli options.
- *
- * @param args - Command line arguments
- * @param entry - A {@link Command | entry command}, an {@link CommandRunner | inline command runner}, or a {@link LazyCommand | lazily-loaded 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<G extends GunshiParams = DefaultGunshiParams>(args: string[], entry: Command<G> | CommandRunner<G> | LazyCommand<G>, options?: CliOptions<G>): Promise<string | undefined>;
-//#endregion
-export { ANONYMOUS_COMMAND_NAME, ArgSchema, ArgToken, ArgValues, Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, type CommandContextParams, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, DefaultTranslation, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, type OnPluginExtension, type Plugin, type PluginContext, type PluginDependency, type PluginExtension, type PluginFunction, type PluginOptions, type PluginWithExtension, type PluginWithoutExtension, Prettify, RendererDecorator, RenderingOptions, ValidationErrorsDecorator, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };
+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 };

package/lib/index.js

@@ -1,10 +1,10 @@
-import { ANONYMOUS_COMMAND_NAME, createCommandContext } from "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
-import "./core-clRbigv-.js";
-import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition-qbPc8FcH.js";
-import { plugin } from "./plugin-BRVcC8lF.js";
-import { BUILT_IN_PREFIX, namespacedId } from "./src-hz2EqFqR.js";
-import { cli } from "./cli-B121JwoR.js";
+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-DZnfAAwF.js";
+import { t as cli } from "./cli-CTN-xtKX.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region ../plugin-i18n/src/translation.ts

package/lib/{plugin-BRVcC8lF.js → plugin-bQlPfOlH.js}

@@ -46,4 +46,4 @@ function plugin(options = {}) {
 }
 
 //#endregion
-export { plugin };
+export { plugin as t };

package/lib/plugin-gv9ogu9N.d.ts

@@ -0,0 +1,11 @@
+import { o as CliOptions, v as DefaultGunshiParams } from "./types-DIfsK4mZ.js";
+
+//#region src/constants.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+declare const ANONYMOUS_COMMAND_NAME = "(anonymous)";
+declare const CLI_OPTIONS_DEFAULT: CliOptions<DefaultGunshiParams>;
+//#endregion
+export { CLI_OPTIONS_DEFAULT as n, ANONYMOUS_COMMAND_NAME as t };

package/lib/plugin.d.ts

@@ -1,4 +1,4 @@
-import { ArgSchema, ArgToken, ArgValues, Args, Awaitable, Command, CommandContext, CommandContextCore, CommandContextExtension, CommandDecorator, CommandExamplesFetcher, CommandRunner, DefaultGunshiParams, ExtendContext, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, ValidationErrorsDecorator, plugin } from "./types-DpGOiC0p.js";
-import { CommandContextParams, createCommandContext } from "./context-C7rkDQK3.js";
-import { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT } from "./constants-BX52JB9x.js";
-export { ANONYMOUS_COMMAND_NAME, type ArgSchema, type ArgToken, type ArgValues, type Args, type Awaitable, CLI_OPTIONS_DEFAULT, type Command, type CommandContext, type CommandContextCore, type CommandContextExtension, type CommandContextParams, type CommandDecorator, type CommandExamplesFetcher, type CommandRunner, type DefaultGunshiParams, type ExtendContext, type ExtractArgs, type ExtractExtensions, type GunshiParams, type GunshiParamsConstraint, type LazyCommand, type NormalizeToGunshiParams, type OnPluginExtension, type Plugin, type PluginContext, type PluginDependency, type PluginExtension, type PluginFunction, type PluginOptions, type PluginWithExtension, type PluginWithoutExtension, type Prettify, type RendererDecorator, type ValidationErrorsDecorator, createCommandContext, plugin };
+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";
+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 { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext } from "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
-import { plugin } from "./plugin-BRVcC8lF.js";
+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";
 
 export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext, plugin };

package/lib/renderer.d.ts

@@ -1,7 +1,15 @@
-import { CommandContext, DefaultGunshiParams, GunshiParams } from "./types-DpGOiC0p.js";
+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";
 
 //#region ../plugin-renderer/src/header.d.ts
-
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 /**
  * Render the header.
  *

package/lib/renderer.js

@@ -1,6 +1,6 @@
-import "./context-CaqWZ3MF.js";
-import "./utils-Bh4TdPy8.js";
-import "./plugin-BRVcC8lF.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "./src-hz2EqFqR.js";
+import "./context-DRQZ3doU.js";
+import "./utils-DA31tfdY.js";
+import "./plugin-bQlPfOlH.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-DZnfAAwF.js";
 
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{src-hz2EqFqR.js → src-DZnfAAwF.js}

@@ -1,6 +1,6 @@
-import { ANONYMOUS_COMMAND_NAME } from "./context-CaqWZ3MF.js";
-import { kebabnize, resolveLazyCommand } from "./utils-Bh4TdPy8.js";
-import { plugin } from "./plugin-BRVcC8lF.js";
+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";
 
 //#region ../shared/src/constants.ts
 /**
@@ -29,38 +29,30 @@ const COMMON_ARGS = {
 
 //#endregion
 //#region ../resources/locales/en-US.json
-var COMMAND = "COMMAND";
-var COMMANDS = "COMMANDS";
-var SUBCOMMAND = "SUBCOMMAND";
-var USAGE = "USAGE";
-var ARGUMENTS = "ARGUMENTS";
-var OPTIONS = "OPTIONS";
-var EXAMPLES = "EXAMPLES";
-var FORMORE = "For more info, run any command with the `--help` flag";
 var NEGATABLE = "Negatable of";
-var DEFAULT = "default";
-var CHOICES = "choices";
-var help = "Display this help message";
-var version = "Display this version";
 var en_US_default = {
-	COMMAND,
-	COMMANDS,
-	SUBCOMMAND,
-	USAGE,
-	ARGUMENTS,
-	OPTIONS,
-	EXAMPLES,
-	FORMORE,
+	COMMAND: "COMMAND",
+	COMMANDS: "COMMANDS",
+	SUBCOMMAND: "SUBCOMMAND",
+	USAGE: "USAGE",
+	ARGUMENTS: "ARGUMENTS",
+	OPTIONS: "OPTIONS",
+	EXAMPLES: "EXAMPLES",
+	FORMORE: "For more info, run any command with the `--help` flag",
 	NEGATABLE,
-	DEFAULT,
-	CHOICES,
-	help,
-	version
+	DEFAULT: "default",
+	CHOICES: "choices",
+	help: "Display this help message",
+	version: "Display this version"
 };
 
 //#endregion
 //#region ../shared/src/utils.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Resolve a namespaced key for built-in resources.
 *
 * Built-in keys are prefixed with "_:".
@@ -142,6 +134,10 @@ function makeShortLongOptionPair(schema, name, toKebab) {
 //#endregion
 //#region ../shared/src/localization.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Create a localizable function for a command.
 *
 * This function will resolve the translation key based on the command context and the provided translation function.
@@ -169,7 +165,7 @@ function localizable(ctx, cmd, translate) {
 			}
 			const schema = ctx.args[argKey];
 			if (!schema) return argKey;
-			return negatable && schema.type === "boolean" && schema.negatable ? `${en_US_default["NEGATABLE"]} ${makeShortLongOptionPair(schema, argKey, ctx.toKebab)}` : schema.description || "";
+			return negatable && schema.type === "boolean" && schema.negatable ? `${NEGATABLE} ${makeShortLongOptionPair(schema, argKey, ctx.toKebab)}` : schema.description || "";
 		}
 		if (key === resolveKey("description", ctx.name)) return "";
 		else if (key === resolveKey("examples", ctx.name)) return await resolveExamples(ctx, cmd.examples);
@@ -194,12 +190,20 @@ function renderHeader(ctx) {
 //#endregion
 //#region ../plugin-renderer/src/types.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * The unique identifier for usage renderer plugin.
 */
 const pluginId = namespacedId("renderer");
 
 //#endregion
 //#region ../plugin-renderer/src/usage.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const COMMON_ARGS_KEYS = Object.keys(COMMON_ARGS);
 /**
 * Render the usage.
@@ -509,6 +513,35 @@ function renderValidationErrors(_ctx, error) {
 
 //#endregion
 //#region ../plugin-renderer/src/index.ts
+/**
+* The entry point of usage renderer plugin
+*
+* @example
+* ```js
+* import renderer from '@gunshi/plugin-renderer'
+* import { cli } from 'gunshi'
+*
+* const entry = (ctx) => {
+*   // ...
+* }
+*
+* await cli(process.argv.slice(2), entry, {
+*   // ...
+*
+*   plugins: [
+*     renderer()
+*   ],
+*
+*   // ...
+* })
+* ```
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const i18nPluginId = namespacedId("i18n");
 const dependencies = [{
 	id: i18nPluginId,
@@ -524,7 +557,7 @@ function renderer() {
 		id: pluginId,
 		name: "usage renderer",
 		dependencies,
-		extension: async (ctx, cmd) => {
+		extension: (ctx, cmd) => {
 			const i18n = ctx.extensions[i18nPluginId];
 			let cachedCommands;
 			async function loadCommands() {
@@ -555,4 +588,4 @@ function renderer() {
 }
 
 //#endregion
-export { BUILT_IN_PREFIX, COMMON_ARGS, namespacedId, renderHeader, renderUsage, renderValidationErrors, renderer };
+export { namespacedId as a, renderHeader as i, renderValidationErrors as n, BUILT_IN_PREFIX as o, renderUsage as r, COMMON_ARGS as s, renderer as t };

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

@@ -1,6 +1,10 @@
 import { ArgExplicitlyProvided, ArgSchema, ArgSchema as ArgSchema$1, ArgToken, ArgToken as ArgToken$1, ArgValues, ArgValues as ArgValues$1, Args, Args as Args$1 } from "args-tokens";
 
 //#region src/plugin/context.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 
 /**
  * Type helper to create GunshiParams from extracted args and extensions
@@ -89,18 +93,18 @@ interface PluginContext<G extends GunshiParamsConstraint = DefaultGunshiParams>
 }
 //#endregion
 //#region src/plugin/core.d.ts
-type ProcessDependency<D, A extends ExtendContext> = D extends string ? D extends keyof A ? { [K in D]: A[K] } : {} : D extends {
+type ProcessDependency<D, A$1 extends ExtendContext> = D extends string ? D extends keyof A$1 ? { [K in D]: A$1[K] } : {} : D extends {
   id: infer ID;
   optional?: any;
-} ? ID extends string ? ID extends keyof A ? D extends {
+} ? ID extends string ? ID extends keyof A$1 ? D extends {
   optional: true;
-} ? { [K in ID]: A[K] | undefined } : { [K in ID]: A[K] } : {} : never : never;
+} ? { [K in ID]: A$1[K] | undefined } : { [K in ID]: A$1[K] } : {} : never : never;
 /**
  * Helper type to infer dependency extensions with optional support
  *
  * @internal
  */
-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> : {}) : {};
+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> : {}) : {};
 /**
  * Plugin dependency definition
  *
@@ -206,11 +210,11 @@ ResolvedDepExt extends GunshiParams = GunshiParams<{
  *
  * @since v0.27.0
  */
-type Plugin<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
+type Plugin<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
   id: string;
   name?: string;
   dependencies?: (PluginDependency | string)[];
-  extension?: CommandContextExtension<E>;
+  extension?: CommandContextExtension<E$1>;
 };
 /**
  * Plugin return type with extension, which includes the plugin ID, name, dependencies, and extension.
@@ -219,7 +223,7 @@ type Plugin<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensio
  *
  * @typeParam E - A type extending {@link GunshiParams} to specify the shape of {@linkcode CommandContext}'s extensions.
  */
-interface PluginWithExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E> {
+interface PluginWithExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E$1> {
   /**
    * Plugin identifier
    */
@@ -235,7 +239,7 @@ interface PluginWithExtension<E extends GunshiParams['extensions'] = DefaultGuns
   /**
    * Plugin extension
    */
-  extension: CommandContextExtension<E>;
+  extension: CommandContextExtension<E$1>;
 }
 /**
  * Plugin return type without extension, which includes the plugin ID, name, and dependencies, but no extension.
@@ -244,7 +248,7 @@ interface PluginWithExtension<E extends GunshiParams['extensions'] = DefaultGuns
  *
  * @typeParam E - A type extending {@link GunshiParams} to specify the shape of {@linkcode CommandContext}'s extensions.
  */
-interface PluginWithoutExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E> {
+interface PluginWithoutExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> extends Plugin<E$1> {
   /**
    * Plugin identifier
    */
@@ -755,7 +759,7 @@ type CommandContextCore<G extends GunshiParamsConstraint = DefaultGunshiParams>
  *
  * @since v0.27.0
  */
-interface CommandContextExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
+interface CommandContextExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
   /**
    * Plugin identifier
    */
@@ -763,7 +767,7 @@ interface CommandContextExtension<E extends GunshiParams['extensions'] = Default
   /**
    * Plugin extension factory
    */
-  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E>;
+  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E$1>;
   /**
    * Plugin extension factory after hook
    */
@@ -954,4 +958,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 { type ArgSchema$1 as ArgSchema, type ArgToken$1 as ArgToken, type ArgValues$1 as ArgValues, type Args$1 as Args, Awaitable, CliOptions, Command, CommandCallMode, CommandContext, CommandContextCore, CommandContextExtension, CommandDecorator, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandRunner, Commandable, DefaultGunshiParams, ExtendContext, ExtractArgExplicitlyProvided, ExtractArgs, ExtractExtensions, GunshiParams, GunshiParamsConstraint, LazyCommand, NormalizeToGunshiParams, OnPluginExtension, Plugin, PluginContext, PluginDependency, PluginExtension, PluginFunction, PluginOptions, PluginWithExtension, PluginWithoutExtension, Prettify, RendererDecorator, RenderingOptions, ValidationErrorsDecorator, plugin };
+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 };

package/lib/utils-BVBpgaJv.d.ts

@@ -0,0 +1,50 @@
+import { T as LazyCommand, _ as Commandable, s as Command, v as DefaultGunshiParams, w as GunshiParamsConstraint } from "./types-DIfsK4mZ.js";
+import { kebabnize } from "args-tokens/utils";
+
+//#region src/utils.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
+/**
+ * Check if the given command is a {@link LazyCommand}.
+ *
+ * @param cmd - A command to check
+ * @returns `true` if the command is a {@link LazyCommand}, otherwise `false
+ */
+declare function isLazyCommand<G extends GunshiParamsConstraint = DefaultGunshiParams>(cmd: unknown): cmd is LazyCommand<G>;
+/**
+ * Resolve a lazy command to a {@link Command}.
+ *
+ * @param cmd - A {@link Commandable} or {@link LazyCommand} to resolve
+ * @param name - Optional name of the command, if not provided, it will use the name from the command itself.
+ * @param needRunResolving - Whether to run the resolving function of the lazy command.
+ * @returns A resolved {@link Command}
+ */
+declare function resolveLazyCommand<G extends GunshiParamsConstraint = DefaultGunshiParams>(cmd: Commandable<G>, name?: string, needRunResolving?: boolean): Promise<Command<G>>;
+/**
+ * Create an object with the specified prototype. A shorthand for `Object.create`.
+ *
+ * @param obj - An object to use as the prototype for the new object. If `null`, it will create an object with no prototype.
+ * @returns A new object with the specified prototype
+ */
+declare function create<T>(obj?: object | null): T;
+/**
+ * Log a message to the console.
+ *
+ * @param args - Arguments to log
+ */
+declare function log(...args: unknown[]): void;
+/**
+ * Deep freeze an object, making it immutable.
+ *
+ * @param obj - The object to freeze
+ * @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>;
+//#endregion
+export { log as a, kebabnize as i, deepFreeze as n, resolveLazyCommand as o, isLazyCommand as r, create as t };

package/lib/{utils-Bh4TdPy8.js → utils-DA31tfdY.js}

@@ -85,4 +85,4 @@ function deepFreeze(obj, ignores = []) {
 }
 
 //#endregion
-export { create, deepFreeze, isLazyCommand, kebabnize, log, resolveLazyCommand };
+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,46 +1,3 @@
-import { Command, Commandable, DefaultGunshiParams, GunshiParamsConstraint, LazyCommand } from "./types-DpGOiC0p.js";
-import { kebabnize } from "args-tokens/utils";
-
-//#region src/utils.d.ts
-
-/**
- * Check if the given command is a {@link LazyCommand}.
- *
- * @param cmd - A command to check
- * @returns `true` if the command is a {@link LazyCommand}, otherwise `false
- */
-declare function isLazyCommand<G extends GunshiParamsConstraint = DefaultGunshiParams>(cmd: unknown): cmd is LazyCommand<G>;
-/**
- * Resolve a lazy command to a {@link Command}.
- *
- * @param cmd - A {@link Commandable} or {@link LazyCommand} to resolve
- * @param name - Optional name of the command, if not provided, it will use the name from the command itself.
- * @param needRunResolving - Whether to run the resolving function of the lazy command.
- * @returns A resolved {@link Command}
- */
-declare function resolveLazyCommand<G extends GunshiParamsConstraint = DefaultGunshiParams>(cmd: Commandable<G>, name?: string | undefined, needRunResolving?: boolean): Promise<Command<G>>;
-/**
- * Create an object with the specified prototype. A shorthand for `Object.create`.
- *
- * @param obj - An object to use as the prototype for the new object. If `null`, it will create an object with no prototype.
- * @returns A new object with the specified prototype
- */
-declare function create<T>(obj?: object | null): T;
-/**
- * Log a message to the console.
- *
- * @param args - Arguments to log
- */
-declare function log(...args: unknown[]): void;
-/**
- * Deep freeze an object, making it immutable.
- *
- * @param obj - The object to freeze
- * @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>;
-//#endregion
+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";
 export { create, deepFreeze, isLazyCommand, kebabnize, log, resolveLazyCommand };

package/lib/utils.js

@@ -1,3 +1,3 @@
-import { create, deepFreeze, isLazyCommand, kebabnize, log, resolveLazyCommand } from "./utils-Bh4TdPy8.js";
+import { a as log, i as kebabnize, n as deepFreeze, o as resolveLazyCommand, r as isLazyCommand, t as create } from "./utils-DA31tfdY.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-beta.3",
+  "version": "0.27.0-beta.4",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -99,17 +99,17 @@
     "args-tokens": "^0.23.0"
   },
   "devDependencies": {
-    "deno": "^2.5.4",
+    "deno": "^2.5.6",
     "jsr": "^0.13.5",
     "jsr-exports-lint": "^0.4.1",
-    "publint": "^0.3.14",
-    "tsdown": "0.15.9",
-    "zod": "^4.1.12",
-    "@gunshi/plugin-global": "0.27.0-beta.3",
-    "@gunshi/plugin-i18n": "0.27.0-beta.3",
-    "@gunshi/plugin-renderer": "0.27.0-beta.3",
-    "@gunshi/resources": "0.27.0-beta.3",
-    "@gunshi/shared": "0.27.0-beta.3"
+    "publint": "^0.3.15",
+    "tsdown": "0.15.12",
+    "zod": "^4.1.13",
+    "@gunshi/plugin-global": "0.27.0-beta.4",
+    "@gunshi/plugin-i18n": "0.27.0-beta.4",
+    "@gunshi/plugin-renderer": "0.27.0-beta.4",
+    "@gunshi/resources": "0.27.0-beta.4",
+    "@gunshi/shared": "0.27.0-beta.4"
   },
   "scripts": {
     "build": "tsdown",

package/lib/constants-BX52JB9x.d.ts

@@ -1,8 +0,0 @@
-import { CliOptions, DefaultGunshiParams } from "./types-DpGOiC0p.js";
-
-//#region src/constants.d.ts
-
-declare const ANONYMOUS_COMMAND_NAME = "(anonymous)";
-declare const CLI_OPTIONS_DEFAULT: CliOptions<DefaultGunshiParams>;
-//#endregion
-export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT };