gunshi 0.29.5 → 0.30.0

package/lib/bone.d.ts

@@ -46,5 +46,12 @@ 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>;
+//#endregion
+//#region src/bone.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
 //#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, SubCommandable, ValidationErrorsDecorator, cli };

package/lib/bone.js

@@ -1,4 +1,4 @@
-import { t as cliCore } from "./core-CDWBHGHv.js";
+import { t as cliCore } from "./core-BQot-D_g.js";
 //#region src/cli/bone.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
@@ -18,4 +18,10 @@ async function cli(args, entry, options = {}) {
 	return cliCore(args, entry, options, []);
 }
 //#endregion
+//#region src/bone.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { cli };

package/lib/{cli-COx8zjEj.js → cli-BIViXHPa.js}

@@ -1,6 +1,6 @@
-import { t as cliCore } from "./core-CDWBHGHv.js";
-import { t as plugin } from "./core-x8spYr6g.js";
-import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-D_ZSzQUF.js";
+import { t as plugin } from "./core-D1daCTTE.js";
+import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-Dwp0BoQ5.js";
+import { t as cliCore } from "./core-BQot-D_g.js";
 //#region ../plugin-global/src/types.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
@@ -45,6 +45,10 @@ const decorator = (baseRunner) => async (ctx) => {
 //#endregion
 //#region ../plugin-global/src/extension.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Extends the command context for global options plugin.
 *
 * @param ctx - The {@linkcode CommandContextCore | command context} core
@@ -154,4 +158,10 @@ async function cli(args, entry, options = {}) {
 	return cliCore(args, entry, options, [global(), renderer()]);
 }
 //#endregion
+//#region src/cli.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { cli as t };

package/lib/combinators.d.ts

@@ -635,5 +635,12 @@ declare function merge<T extends Args[]>(...schemas: T): MergeArgs<T>;
  */
 declare function extend<T extends Args, U extends Args>(base: T, overrides: U): Omit<T, keyof U> & U;
 //#endregion
+//#endregion
+//#region src/combinators.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
 //#endregion
 export { type BaseOptions, type BooleanOptions, type Combinator, type CombinatorOptions, type CombinatorSchema, type FloatOptions, type IntegerOptions, type NumberOptions, type StringOptions, args, boolean, choice, combinator, describe, extend, float, integer, map, merge, multiple, number, positional, required, short, string, unrequired, withDefault };

package/lib/combinators.js

@@ -517,4 +517,10 @@ function extend(base, overrides) {
 	return result;
 }
 //#endregion
+//#region src/combinators.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { args, boolean, choice, combinator, describe, extend, float, integer, map, merge, multiple, number, positional, required, short, string, unrequired, withDefault };

package/lib/{constants-Bum1xzqZ.js → constants-D_ixLD32.js}

@@ -1,4 +1,8 @@
 //#region src/constants.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const ANONYMOUS_COMMAND_NAME = "(anonymous)";
 /**
 * A no-operation function.

package/lib/context.js

@@ -1,5 +1,5 @@
-import { a as log, i as isLazyCommand, n as deepFreeze, t as create } from "./utils-1JDAM4DH.js";
-import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from "./constants-Bum1xzqZ.js";
+import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from "./constants-D_ixLD32.js";
+import { a as log, i as isLazyCommand, n as deepFreeze, t as create } from "./utils-CMJNteYK.js";
 //#region src/context.ts
 /**
 * The entry for gunshi context.
@@ -22,7 +22,7 @@ import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from
 * @param param - A {@link CommandContextParams | parameters} to create a command context.
 * @returns A {@link CommandContext | command context}, which is readonly.
 */
-async function createCommandContext({ args = {}, explicit = {}, values = {}, positionals = [], rest = [], argv = [], tokens = [], command = {}, extensions = {}, cliOptions = {}, callMode = "entry", commandPath = [], omitted = false, validationError = void 0 }) {
+async function createCommandContext({ args = {}, explicit = {}, values = {}, positionals = [], rest = [], argv = [], tokens = [], command = {}, extensions = {}, cliOptions = {}, callMode = "entry", commandPath = [], omitted = false, validationError }) {
 	/**
 	* normailize the options schema and values, to avoid prototype pollution
 	*/

package/lib/{core-CDWBHGHv.js → core-BQot-D_g.js}

@@ -1,5 +1,5 @@
-import { i as isLazyCommand, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-1JDAM4DH.js";
-import { n as CLI_OPTIONS_DEFAULT, r as NOOP } from "./constants-Bum1xzqZ.js";
+import { n as CLI_OPTIONS_DEFAULT, r as NOOP } from "./constants-D_ixLD32.js";
+import { i as isLazyCommand, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-CMJNteYK.js";
 import { createCommandContext } from "./context.js";
 //#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/parser.js
 const HYPHEN_CHAR = "-";
@@ -498,7 +498,17 @@ function checkConflicts(args, explicit, toKebab, actualInputNames) {
 	return [];
 }
 //#endregion
+//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/index.js
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 //#region src/decorators.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const EMPTY_RENDERER = () => Promise.resolve("");
 /**
 * Factory function for creating a decorators manager.
@@ -564,6 +574,10 @@ function createDecorators() {
 //#endregion
 //#region src/plugin/context.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Factory function for creating a plugin context.
 *
 * @typeParam G - A type extending {@linkcode GunshiParams} to specify the shape of command parameters.
@@ -618,6 +632,10 @@ function createPluginContext(decorators, initialSubCommands) {
 //#endregion
 //#region src/plugin/dependency.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Resolve plugin dependencies using topological sort
 *
 * @param plugins - Array of plugins to resolve

package/lib/{core-x8spYr6g.js → core-D1daCTTE.js}

@@ -1,4 +1,8 @@
 //#region src/plugin/core.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const NOOP_EXTENSION = () => {
 	return Object.create(null);
 };

package/lib/definition.js

@@ -1,6 +1,10 @@
 import { createCommandContext } from "./context.js";
 //#region src/definition.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Define a {@link Command | command}.
 *
 * @typeParam G - A {@link GunshiParamsConstraint} type

package/lib/generator.js

@@ -1,5 +1,5 @@
-import { t as create } from "./utils-1JDAM4DH.js";
-import { t as cli } from "./cli-COx8zjEj.js";
+import { t as create } from "./utils-CMJNteYK.js";
+import { t as cli } from "./cli-BIViXHPa.js";
 //#region src/generator.ts
 /**
 * The entry for usage generator.

package/lib/index.d.ts

@@ -5,6 +5,10 @@ import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
 import { t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.js";
 
 //#region ../plugin-i18n/src/types.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 
 /**
  * Translation adapter factory options.
@@ -174,5 +178,12 @@ declare function cli<G extends GunshiParams = DefaultGunshiParams>(args: string[
  * @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
+//#region src/index.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
 //#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, SubCommandable, ValidationErrorsDecorator, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };

package/lib/index.js

@@ -1,12 +1,16 @@
-import { n as resolveArgs, r as parseArgs } from "./core-CDWBHGHv.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./constants-Bum1xzqZ.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./constants-D_ixLD32.js";
 import { createCommandContext } from "./context.js";
+import { t as plugin } from "./core-D1daCTTE.js";
+import { a as namespacedId } from "./src-Dwp0BoQ5.js";
+import { n as resolveArgs, r as parseArgs } from "./core-BQot-D_g.js";
+import { t as cli } from "./cli-BIViXHPa.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
-import { t as plugin } from "./core-x8spYr6g.js";
-import { a as namespacedId } from "./src-D_ZSzQUF.js";
-import { t as cli } from "./cli-COx8zjEj.js";
 //#region ../plugin-i18n/src/translation.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Default implementation of {@linkcode TranslationAdapter}.
 */
 var DefaultTranslation = class {
@@ -68,7 +72,21 @@ var DefaultTranslation = class {
 		});
 	}
 };
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 namespacedId("i18n");
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 "_".codePointAt(0);
 //#endregion
+//#region src/index.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { ANONYMOUS_COMMAND_NAME, DefaultTranslation, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };

package/lib/plugin.d.ts

@@ -2,4 +2,12 @@ import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./reso
 import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, f as CommandRunner, h as ExtendContext, j as PluginExtension, k as Plugin, m as DefaultGunshiParams, o as CommandContextCore, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.js";
+
+//#region src/plugin.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
+//#endregion
 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 };

package/lib/plugin.js

@@ -1,4 +1,10 @@
-import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-Bum1xzqZ.js";
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-D_ixLD32.js";
 import { createCommandContext } from "./context.js";
-import { t as plugin } from "./core-x8spYr6g.js";
+import { t as plugin } from "./core-D1daCTTE.js";
+//#region src/plugin.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext, plugin };

package/lib/renderer.d.ts

@@ -32,5 +32,12 @@ declare function renderUsage<G extends GunshiParams = DefaultGunshiParams>(ctx:
  * @returns A rendered validation error.
  */
 declare function renderValidationErrors<G extends GunshiParams = DefaultGunshiParams>(_ctx: CommandContext<G>, error: AggregateError): Promise<string>;
+//#endregion
+//#region src/renderer.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+
 //#endregion
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/renderer.js

@@ -1,2 +1,8 @@
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-D_ZSzQUF.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-Dwp0BoQ5.js";
+//#region src/renderer.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{src-D_ZSzQUF.js → src-Dwp0BoQ5.js}

@@ -1,6 +1,10 @@
-import { o as resolveLazyCommand, s as kebabnize } from "./utils-1JDAM4DH.js";
-import "./constants-Bum1xzqZ.js";
-import { t as plugin } from "./core-x8spYr6g.js";
+import "./constants-D_ixLD32.js";
+import { o as resolveLazyCommand, s as kebabnize } from "./utils-CMJNteYK.js";
+import { t as plugin } from "./core-D1daCTTE.js";
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const BUILD_IN_PREFIX_AND_KEY_SEPARATOR = `_:`;
 const ARG_PREFIX_AND_KEY_SEPARATOR = `arg:`;
 const COMMON_ARGS = {
@@ -160,8 +164,18 @@ function localizable(ctx, cmd, translate) {
 	return localize;
 }
 //#endregion
+//#region ../shared/src/index.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
 //#region ../plugin-renderer/src/header.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Render the header.
 *
 * @param ctx - A {@link CommandContext | command context}
@@ -488,6 +502,10 @@ function generatePositionalSymbols(args) {
 //#endregion
 //#region ../plugin-renderer/src/validation.ts
 /**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Render the validation errors.
 *
 * @param _ctx - A {@link CommandContext | command context}

package/lib/{utils-1JDAM4DH.js → utils-CMJNteYK.js}

@@ -22,6 +22,10 @@ function kebabnize(str) {
 //#endregion
 //#region src/utils.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

package/lib/utils.js

@@ -1,2 +1,2 @@
-import { a as log, i as isLazyCommand, n as deepFreeze, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-1JDAM4DH.js";
+import { a as log, i as isLazyCommand, n as deepFreeze, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-CMJNteYK.js";
 export { create, deepFreeze, getCommandSubCommands, isLazyCommand, kebabnize, log, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.29.5",
+  "version": "0.30.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -28,7 +28,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">= 20"
+    "node": ">= 22"
   },
   "type": "module",
   "files": [
@@ -103,17 +103,17 @@
   },
   "devDependencies": {
     "args-tokens": "^0.24.3",
-    "deno": "^2.7.11",
+    "deno": "^2.7.14",
     "jsr": "^0.14.3",
     "jsr-exports-lint": "^0.4.2",
-    "publint": "^0.3.18",
-    "tsdown": "0.15.12",
-    "zod": "^4.3.6",
-    "@gunshi/plugin-global": "0.29.5",
-    "@gunshi/plugin-renderer": "0.29.5",
-    "@gunshi/plugin-i18n": "0.29.5",
-    "@gunshi/shared": "0.29.5",
-    "@gunshi/resources": "0.29.5"
+    "publint": "^0.3.20",
+    "tsdown": "0.21.0",
+    "zod": "^4.4.3",
+    "@gunshi/resources": "0.30.0",
+    "@gunshi/plugin-global": "0.30.0",
+    "@gunshi/plugin-i18n": "0.30.0",
+    "@gunshi/shared": "0.30.0",
+    "@gunshi/plugin-renderer": "0.30.0"
   },
   "scripts": {
     "build": "tsdown",