gunshi 0.37.2 → 0.37.3

package/lib/bone.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, r as ArgValues, u as ArgToken } from "./resolver-D7DEcpu-.js";
-import { C as NormalizeToGunshiParams, D as SubCommandable, E as RenderingOptions, O as ValidationErrorsDecorator, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { i as Args, l as ArgToken, n as ArgSchema, r as ArgValues } from "./resolver-CbDvcwY3.js";
+import { C as NormalizeToGunshiParams, D as SubCommandable, E as RenderingOptions, O as ValidationErrorsDecorator, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-H9nag_2Z.js";
 
 //#region src/cli/bone.d.ts
 /**

package/lib/bone.js

@@ -1,4 +1,4 @@
-import { t as cliCore } from "./core-Ce6x0is5.js";
+import { t as cliCore } from "./core-CLzX86kY.js";
 //#region src/cli/bone.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{cli-xU__0QWJ.js → cli-BnmSo-DW.js}

@@ -1,7 +1,7 @@
-import { r as hasPriorityValidationError } from "./error-CBijJN5L.js";
-import { t as plugin } from "./plugin-Cvf6mYto.js";
-import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-yiBqxwCm.js";
-import { t as cliCore } from "./core-Ce6x0is5.js";
+import { r as hasPriorityValidationError } from "./error-B5QxSzk9.js";
+import { t as plugin } from "./plugin-DneW3Toi.js";
+import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-80_afJQM.js";
+import { t as cliCore } from "./core-CLzX86kY.js";
 //#region ../plugin-global/src/types.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/combinators.d.ts

@@ -1,6 +1,6 @@
-import { i as Args, n as ArgSchema } from "./resolver-D7DEcpu-.js";
+import { i as Args, n as ArgSchema } from "./resolver-CbDvcwY3.js";
 
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/combinators.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/combinators.d.ts
 
 //#region src/combinators.d.ts
 /**
@@ -671,7 +671,6 @@ 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)

package/lib/combinators.js

@@ -1,6 +1,6 @@
-import { t as formatChoices } from "./utils-oPJNnmOb.js";
-import { n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-dsINFnU2.js";
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/combinators.js
+import { t as formatChoices } from "./utils-DbRhwNIU.js";
+import { n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-D5skgYcF.js";
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/combinators.js
 /**
 * Parser combinator factory functions for composable argument schema construction.
 *

package/lib/context.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, r as ArgValues, u as ArgToken } from "./resolver-D7DEcpu-.js";
-import { _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, m as DefaultGunshiParams, n as CliOptions, r as Command, s as CommandContextExtension, x as LazyCommand, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { i as Args, l as ArgToken, r as ArgValues } from "./resolver-CbDvcwY3.js";
+import { _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, m as DefaultGunshiParams, n as CliOptions, r as Command, s as CommandContextExtension, x as LazyCommand, y as GunshiParams } from "./types-H9nag_2Z.js";
 
 //#region src/context.d.ts
 

package/lib/{core-Ce6x0is5.js → core-CLzX86kY.js}

@@ -1,8 +1,8 @@
 import { i as NOOP, r as CLI_OPTIONS_DEFAULT, t as createCommandContext } from "./context-CAPhwgJJ.js";
-import { n as kebabnize } from "./utils-oPJNnmOb.js";
+import { n as kebabnize } from "./utils-DbRhwNIU.js";
 import { create, getCommandSubCommands, isLazyCommand, resolveLazyCommand } from "./utils.js";
-import { a as parseArgs, i as resolveArgs, n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-dsINFnU2.js";
-import { n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-CBijJN5L.js";
+import { a as parseArgs, i as resolveArgs, n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-D5skgYcF.js";
+import { n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-B5QxSzk9.js";
 //#region src/decorators.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/definition.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, r as ArgValues } from "./resolver-D7DEcpu-.js";
-import { C as NormalizeToGunshiParams, _ as ExtractArgs, b as GunshiParamsConstraint, d as CommandLoader, f as CommandRunner, h as ExtendContext, m as DefaultGunshiParams, r as Command, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { i as Args, n as ArgSchema, r as ArgValues } from "./resolver-CbDvcwY3.js";
+import { C as NormalizeToGunshiParams, _ as ExtractArgs, b as GunshiParamsConstraint, d as CommandLoader, f as CommandRunner, h as ExtendContext, m as DefaultGunshiParams, r as Command, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-H9nag_2Z.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 
 //#region src/definition.d.ts

package/lib/error-B5QxSzk9.js

@@ -0,0 +1,139 @@
+import { n as ArgsValidationErrorKeys, r as isArgsValidationError$1, t as ArgsValidationError } from "./resolver-D5skgYcF.js";
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/index.js
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+//#endregion
+//#region src/error.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
+* Command not found error resource keys.
+*/
+const CommandNotFoundErrorKeys = { notFound: "err:cmd:not-found" };
+/**
+* Brand that marks {@link CommandNotFoundError} instances.
+*
+* The brand is looked up in the global symbol registry with `Symbol.for`, so it stays
+* identical across bundled copies of gunshi (`gunshi`, `@gunshi/plugin`, `@gunshi/bone`)
+* and across realms. It lets {@link isCommandNotFoundError} recognize errors created by
+* another copy, where `instanceof` cannot match.
+*/
+const COMMAND_NOT_FOUND_ERROR_BRAND = Symbol.for("gunshi.CommandNotFoundError");
+/**
+* Error raised when a command cannot be resolved.
+*
+* Each instance carries a non-enumerable brand keyed by
+* `Symbol.for('gunshi.CommandNotFoundError')`, so that {@link isCommandNotFoundError}
+* recognizes it even when it was created by another bundled copy of gunshi.
+*/
+var CommandNotFoundError = class extends Error {
+	code;
+	values;
+	commandName;
+	candidates;
+	commandPath;
+	/**
+	* Create a command-not-found error.
+	*
+	* @param message - Fallback error message
+	* @param options - Command-not-found metadata
+	*/
+	constructor(message, options) {
+		super(message, { cause: options.cause });
+		this.name = "CommandNotFoundError";
+		this.code = options.code;
+		this.values = options.values || {};
+		this.commandName = options.commandName;
+		this.candidates = options.candidates || [];
+		this.commandPath = options.commandPath || [];
+		Object.defineProperty(this, COMMAND_NOT_FOUND_ERROR_BRAND, {
+			value: true,
+			enumerable: false,
+			writable: false,
+			configurable: false
+		});
+	}
+};
+/**
+* Check whether an error is a {@link CommandNotFoundError}.
+*
+* `instanceof` alone is not enough: `@gunshi/plugin` is bundled with its own copy of this
+* class (`noExternal: ['gunshi/plugin']`), so an error thrown by `gunshi` is never an instance
+* of the class a plugin imports. Errors from another copy are recognized through the
+* `Symbol.for('gunshi.CommandNotFoundError')` brand, which does not depend on `error.name`.
+*
+* @param error - An unknown error
+* @returns `true` if the error is a {@link CommandNotFoundError}
+*/
+function isCommandNotFoundError(error) {
+	if (error instanceof CommandNotFoundError) return true;
+	if (!isRecord(error) || !hasCommandNotFoundErrorShape(error)) return false;
+	if (Object.hasOwn(error, COMMAND_NOT_FOUND_ERROR_BRAND) && error[COMMAND_NOT_FOUND_ERROR_BRAND] === true) return true;
+	return error instanceof Error && error.name === "CommandNotFoundError";
+}
+/**
+* Check whether an error is an {@link ArgsValidationError}.
+*
+* Prefer this over the `args-tokens` guard of the same name. Both recognize errors from another
+* bundled copy through the `Symbol.for('args-tokens.ArgsValidationError')` brand that
+* `args-tokens` 0.29.0 or later sets, including subclasses such as `ArgResolveError` that
+* override `name` with the argument name. This guard additionally:
+*
+* - recognizes direct `ArgsValidationError` instances from copies bundling `args-tokens`
+*   older than 0.29.0, which do not set the brand
+* - checks that `code` and `values` of an error from another copy have the expected types
+*
+* The guard narrows only to {@link ArgsValidationError}: across copies,
+* `instanceof ArgResolveError` still fails, so do not rely on `type` or `schema` for such errors.
+*
+* @param error - An unknown error
+* @returns `true` if the error is an {@link ArgsValidationError}
+*/
+function isArgsValidationError(error) {
+	if (error instanceof ArgsValidationError) return true;
+	if (!isRecord(error) || !hasArgsValidationErrorShape(error)) return false;
+	if (isArgsValidationError$1(error)) return true;
+	return error instanceof Error && error.name === "ArgsValidationError";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+/**
+* Check whether `code` is an own or inherited property that is a string or `undefined`.
+*
+* Constructors always assign `code`, even when the option is omitted.
+*
+* @param error - An error from another copy
+* @returns `true` if `code` has the expected type
+*/
+function hasOptionalStringCode(error) {
+	return "code" in error && (error.code === void 0 || typeof error.code === "string");
+}
+function hasCommandNotFoundErrorShape(error) {
+	return hasOptionalStringCode(error) && isRecord(error.values) && typeof error.commandName === "string" && isStringArray(error.candidates) && isStringArray(error.commandPath);
+}
+function hasArgsValidationErrorShape(error) {
+	return hasOptionalStringCode(error) && isRecord(error.values);
+}
+/**
+* Check whether validation errors should be handled before version, help, or command execution.
+*
+* @param error - An aggregate validation error
+* @returns `true` if the validation error must be handled with priority
+*/
+function hasPriorityValidationError(error) {
+	return error?.errors.some((error) => isCommandNotFoundError(error) || isArgsValidationError(error) && error.code === ArgsValidationErrorKeys.unknownOption) ?? false;
+}
+//#endregion
+export { isCommandNotFoundError as a, isArgsValidationError as i, CommandNotFoundErrorKeys as n, hasPriorityValidationError as r, CommandNotFoundError as t };

package/lib/{error-Ck8cJsi0.d.ts → error-DHF6LJCG.d.ts}

@@ -1,4 +1,5 @@
-import { m as DefaultGunshiParams, n as CliOptions } from "./types-CdM9C6VD.js";
+import { a as ArgsValidationError } from "./resolver-CbDvcwY3.js";
+import { m as DefaultGunshiParams, n as CliOptions } from "./types-H9nag_2Z.js";
 
 //#region src/constants.d.ts
 /**
@@ -9,10 +10,6 @@ declare const ANONYMOUS_COMMAND_NAME = "(anonymous)";
 declare const CLI_OPTIONS_DEFAULT: CliOptions<DefaultGunshiParams>;
 //#endregion
 //#region src/error.d.ts
-/**
- * @author kazuya kawaguchi (a.k.a. kazupon)
- * @license MIT
- */
 /**
  * Command not found error resource keys.
  */
@@ -54,6 +51,10 @@ type CommandNotFoundErrorOptions = {
 };
 /**
  * Error raised when a command cannot be resolved.
+ *
+ * Each instance carries a non-enumerable brand keyed by
+ * `Symbol.for('gunshi.CommandNotFoundError')`, so that {@link isCommandNotFoundError}
+ * recognizes it even when it was created by another bundled copy of gunshi.
  */
 declare class CommandNotFoundError extends Error {
   readonly code?: CommandNotFoundErrorCode;
@@ -72,10 +73,34 @@ declare class CommandNotFoundError extends Error {
 /**
  * Check whether an error is a {@link CommandNotFoundError}.
  *
+ * `instanceof` alone is not enough: `@gunshi/plugin` is bundled with its own copy of this
+ * class (`noExternal: ['gunshi/plugin']`), so an error thrown by `gunshi` is never an instance
+ * of the class a plugin imports. Errors from another copy are recognized through the
+ * `Symbol.for('gunshi.CommandNotFoundError')` brand, which does not depend on `error.name`.
+ *
  * @param error - An unknown error
  * @returns `true` if the error is a {@link CommandNotFoundError}
  */
 declare function isCommandNotFoundError(error: unknown): error is CommandNotFoundError;
+/**
+ * Check whether an error is an {@link ArgsValidationError}.
+ *
+ * Prefer this over the `args-tokens` guard of the same name. Both recognize errors from another
+ * bundled copy through the `Symbol.for('args-tokens.ArgsValidationError')` brand that
+ * `args-tokens` 0.29.0 or later sets, including subclasses such as `ArgResolveError` that
+ * override `name` with the argument name. This guard additionally:
+ *
+ * - recognizes direct `ArgsValidationError` instances from copies bundling `args-tokens`
+ *   older than 0.29.0, which do not set the brand
+ * - checks that `code` and `values` of an error from another copy have the expected types
+ *
+ * The guard narrows only to {@link ArgsValidationError}: across copies,
+ * `instanceof ArgResolveError` still fails, so do not rely on `type` or `schema` for such errors.
+ *
+ * @param error - An unknown error
+ * @returns `true` if the error is an {@link ArgsValidationError}
+ */
+declare function isArgsValidationError(error: unknown): error is ArgsValidationError;
 /**
  * Check whether validation errors should be handled before version, help, or command execution.
  *
@@ -84,4 +109,4 @@ declare function isCommandNotFoundError(error: unknown): error is CommandNotFoun
  */
 declare function hasPriorityValidationError(error: AggregateError | undefined): boolean;
 //#endregion
-export { hasPriorityValidationError as a, CLI_OPTIONS_DEFAULT as c, CommandNotFoundErrorOptions as i, CommandNotFoundErrorCode as n, isCommandNotFoundError as o, CommandNotFoundErrorKeys as r, ANONYMOUS_COMMAND_NAME as s, CommandNotFoundError as t };
+export { hasPriorityValidationError as a, ANONYMOUS_COMMAND_NAME as c, CommandNotFoundErrorOptions as i, CLI_OPTIONS_DEFAULT as l, CommandNotFoundErrorCode as n, isArgsValidationError as o, CommandNotFoundErrorKeys as r, isCommandNotFoundError as s, CommandNotFoundError as t };

package/lib/generator.d.ts

@@ -1,4 +1,4 @@
-import { b as GunshiParamsConstraint, m as DefaultGunshiParams, n as CliOptions, r as Command, x as LazyCommand } from "./types-CdM9C6VD.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, n as CliOptions, r as Command, x as LazyCommand } from "./types-H9nag_2Z.js";
 
 //#region src/generator.d.ts
 

package/lib/generator.js

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

package/lib/index.d.ts

@@ -1,8 +1,8 @@
-import { a as ArgsValidationError, c as isArgsValidationError, d as parseArgs, i as Args, l as resolveArgs, n as ArgSchema, o as ArgsValidationErrorCode, r as ArgValues, s as ArgsValidationErrorKeys, u as ArgToken } from "./resolver-D7DEcpu-.js";
-import { A as Plugin, C as NormalizeToGunshiParams, D as SubCommandable, E as RenderingOptions, F as PluginWithExtension, I as PluginWithoutExtension, L as plugin, M as PluginExtension, N as PluginFunction, O as ValidationErrorsDecorator, P as PluginOptions, R as PluginContext, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, j as PluginDependency, k as OnPluginExtension, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { a as ArgsValidationError, c as resolveArgs, i as Args, l as ArgToken, n as ArgSchema, o as ArgsValidationErrorCode, r as ArgValues, s as ArgsValidationErrorKeys, u as parseArgs } from "./resolver-CbDvcwY3.js";
+import { A as Plugin, C as NormalizeToGunshiParams, D as SubCommandable, E as RenderingOptions, F as PluginWithExtension, I as PluginWithoutExtension, L as plugin, M as PluginExtension, N as PluginFunction, O as ValidationErrorsDecorator, P as PluginOptions, R as PluginContext, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, j as PluginDependency, k as OnPluginExtension, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-H9nag_2Z.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
-import { a as hasPriorityValidationError, i as CommandNotFoundErrorOptions, n as CommandNotFoundErrorCode, o as isCommandNotFoundError, r as CommandNotFoundErrorKeys, s as ANONYMOUS_COMMAND_NAME, t as CommandNotFoundError } from "./error-Ck8cJsi0.js";
+import { a as hasPriorityValidationError, c as ANONYMOUS_COMMAND_NAME, i as CommandNotFoundErrorOptions, n as CommandNotFoundErrorCode, o as isArgsValidationError, r as CommandNotFoundErrorKeys, s as isCommandNotFoundError, t as CommandNotFoundError } from "./error-DHF6LJCG.js";
 
 //#region ../plugin-i18n/src/types.d.ts
 /**

package/lib/index.js

@@ -1,9 +1,9 @@
 import { n as ANONYMOUS_COMMAND_NAME, t as createCommandContext } from "./context-CAPhwgJJ.js";
-import { a as parseArgs, i as resolveArgs, n as ArgsValidationErrorKeys, r as isArgsValidationError, t as ArgsValidationError } from "./resolver-dsINFnU2.js";
-import { i as isCommandNotFoundError, n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-CBijJN5L.js";
-import { t as plugin } from "./plugin-Cvf6mYto.js";
-import { a as namespacedId } from "./src-yiBqxwCm.js";
-import { t as cli } from "./cli-xU__0QWJ.js";
+import { a as parseArgs, i as resolveArgs, n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-D5skgYcF.js";
+import { a as isCommandNotFoundError, i as isArgsValidationError, n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-B5QxSzk9.js";
+import { t as plugin } from "./plugin-DneW3Toi.js";
+import { a as namespacedId } from "./src-80_afJQM.js";
+import { t as cli } from "./cli-BnmSo-DW.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
 //#region ../plugin-i18n/src/translation.ts
 /**

package/lib/{plugin-Cvf6mYto.js → plugin-DneW3Toi.js}

@@ -1,4 +1,4 @@
-import "./error-CBijJN5L.js";
+import "./error-B5QxSzk9.js";
 //#region src/plugin/core.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/plugin.d.ts

@@ -1,7 +1,7 @@
-import { a as ArgsValidationError, c as isArgsValidationError, i as Args, n as ArgSchema, o as ArgsValidationErrorCode, r as ArgValues, s as ArgsValidationErrorKeys, u as ArgToken } from "./resolver-D7DEcpu-.js";
-import { A as Plugin, C as NormalizeToGunshiParams, F as PluginWithExtension, I as PluginWithoutExtension, L as plugin, M as PluginExtension, N as PluginFunction, O as ValidationErrorsDecorator, P as PluginOptions, R as PluginContext, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, f as CommandRunner, h as ExtendContext, j as PluginDependency, k as OnPluginExtension, m as DefaultGunshiParams, o as CommandContextCore, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { a as ArgsValidationError, i as Args, l as ArgToken, n as ArgSchema, o as ArgsValidationErrorCode, r as ArgValues, s as ArgsValidationErrorKeys } from "./resolver-CbDvcwY3.js";
+import { A as Plugin, C as NormalizeToGunshiParams, F as PluginWithExtension, I as PluginWithoutExtension, L as plugin, M as PluginExtension, N as PluginFunction, O as ValidationErrorsDecorator, P as PluginOptions, R as PluginContext, S as MergeGunshiExtensions, T as RendererDecorator, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, f as CommandRunner, h as ExtendContext, j as PluginDependency, k as OnPluginExtension, m as DefaultGunshiParams, o as CommandContextCore, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as Prettify, x as LazyCommand, y as GunshiParams } from "./types-H9nag_2Z.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
-import { a as hasPriorityValidationError, c as CLI_OPTIONS_DEFAULT, i as CommandNotFoundErrorOptions, n as CommandNotFoundErrorCode, o as isCommandNotFoundError, r as CommandNotFoundErrorKeys, s as ANONYMOUS_COMMAND_NAME, t as CommandNotFoundError } from "./error-Ck8cJsi0.js";
+import { a as hasPriorityValidationError, c as ANONYMOUS_COMMAND_NAME, i as CommandNotFoundErrorOptions, l as CLI_OPTIONS_DEFAULT, n as CommandNotFoundErrorCode, o as isArgsValidationError, r as CommandNotFoundErrorKeys, s as isCommandNotFoundError, t as CommandNotFoundError } from "./error-DHF6LJCG.js";
 
 //#region src/plugin.d.ts
 /**

package/lib/plugin.js

@@ -1,5 +1,5 @@
 import { n as ANONYMOUS_COMMAND_NAME, r as CLI_OPTIONS_DEFAULT, t as createCommandContext } from "./context-CAPhwgJJ.js";
-import { n as ArgsValidationErrorKeys, r as isArgsValidationError, t as ArgsValidationError } from "./resolver-dsINFnU2.js";
-import { i as isCommandNotFoundError, n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-CBijJN5L.js";
-import { t as plugin } from "./plugin-Cvf6mYto.js";
+import { n as ArgsValidationErrorKeys, t as ArgsValidationError } from "./resolver-D5skgYcF.js";
+import { a as isCommandNotFoundError, i as isArgsValidationError, n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-B5QxSzk9.js";
+import { t as plugin } from "./plugin-DneW3Toi.js";
 export { ANONYMOUS_COMMAND_NAME, ArgsValidationError, ArgsValidationErrorKeys, CLI_OPTIONS_DEFAULT, CommandNotFoundError, CommandNotFoundErrorKeys, createCommandContext, hasPriorityValidationError, isArgsValidationError, isCommandNotFoundError, plugin };

package/lib/renderer.d.ts

@@ -1,4 +1,4 @@
-import { a as CommandContext, m as DefaultGunshiParams, y as GunshiParams } from "./types-CdM9C6VD.js";
+import { a as CommandContext, m as DefaultGunshiParams, y as GunshiParams } from "./types-H9nag_2Z.js";
 
 //#region ../plugin-renderer/src/header.d.ts
 /**

package/lib/renderer.js

@@ -1,4 +1,4 @@
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-yiBqxwCm.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-80_afJQM.js";
 //#region src/renderer.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{resolver-D7DEcpu-.d.ts → resolver-CbDvcwY3.d.ts}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/parser-DT7Ztcch.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/parser-DT7Ztcch.d.ts
 //#region src/parser.d.ts
 /**
  * Entry point of argument parser.
@@ -88,7 +88,7 @@ declare function parseArgs(args: string[], options?: ParserOptions): ArgToken[];
  * @returns Whether `arg` is a short option.
  */
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/resolver.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/resolver.d.ts
 //#region src/resolver.d.ts
 /**
  * An argument schema definition for command-line argument parsing.
@@ -568,6 +568,10 @@ type ArgsValidationErrorCode = (typeof ArgsValidationErrorKeys)[keyof typeof Arg
  * The `message` remains the English fallback message. Renderers can use `code`
  * and `values` to localize the error, falling back to `message` when localization
  * is unavailable.
+ *
+ * Each instance carries a non-enumerable brand keyed by
+ * `Symbol.for('args-tokens.ArgsValidationError')`, which {@link isArgsValidationError}
+ * uses to recognize instances created by another bundled copy of `args-tokens`.
  */
 declare class ArgsValidationError extends Error {
   /**
@@ -592,13 +596,6 @@ declare class ArgsValidationError extends Error {
     cause?: unknown;
   });
 }
-/**
- * Check whether the given value is an {@link ArgsValidationError}.
- *
- * @param error - value to check
- * @returns `true` when the value is an `ArgsValidationError`
- */
-declare function isArgsValidationError(error: unknown): error is ArgsValidationError;
 /**
  * An object that contains {@link ArgSchema | argument schema}.
  *
@@ -730,8 +727,5 @@ declare function resolveArgs<A extends Args>(args: A, tokens: ArgToken[], {
   error: AggregateError | undefined;
   explicit: ArgExplicitlyProvided<A>;
 };
-/**
- * An error type for {@link ArgResolveError}.
- */
 //#endregion
-export { ArgsValidationError as a, isArgsValidationError as c, parseArgs as d, Args as i, resolveArgs as l, ArgSchema as n, ArgsValidationErrorCode as o, ArgValues as r, ArgsValidationErrorKeys as s, ArgExplicitlyProvided as t, ArgToken as u };
+export { ArgsValidationError as a, resolveArgs as c, Args as i, ArgToken as l, ArgSchema as n, ArgsValidationErrorCode as o, ArgValues as r, ArgsValidationErrorKeys as s, ArgExplicitlyProvided as t, parseArgs as u };

package/lib/{resolver-dsINFnU2.js → resolver-D5skgYcF.js}

@@ -1,5 +1,5 @@
-import { n as kebabnize, t as formatChoices } from "./utils-oPJNnmOb.js";
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/parser.js
+import { n as kebabnize, t as formatChoices } from "./utils-DbRhwNIU.js";
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/parser.js
 /**
 * forked from `nodejs/node` (`pkgjs/parseargs`)
 * repository url: https://github.com/nodejs/node (https://github.com/pkgjs/parseargs)
@@ -204,7 +204,7 @@ function hasOptionValue(value) {
 	return !(value == null) && value.codePointAt(0) !== HYPHEN_CODE;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/resolver.js
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/resolver.js
 /**
 * Entry point of argument options resolver.
 *
@@ -229,11 +229,24 @@ const ArgsValidationErrorKeys = {
 	unknownOption: "err:arg:unknown-option"
 };
 /**
+* Brand that marks {@link ArgsValidationError} instances.
+*
+* The brand is looked up in the global symbol registry with `Symbol.for`, so it stays
+* identical across bundled copies of this module and across realms. It lets
+* {@link isArgsValidationError} recognize errors created by another copy of `args-tokens`,
+* where `instanceof` cannot match.
+*/
+const ARGS_VALIDATION_ERROR_BRAND = Symbol.for("args-tokens.ArgsValidationError");
+/**
 * An error that contains structured metadata for argument validation failures.
 *
 * The `message` remains the English fallback message. Renderers can use `code`
 * and `values` to localize the error, falling back to `message` when localization
 * is unavailable.
+*
+* Each instance carries a non-enumerable brand keyed by
+* `Symbol.for('args-tokens.ArgsValidationError')`, which {@link isArgsValidationError}
+* uses to recognize instances created by another bundled copy of `args-tokens`.
 */
 var ArgsValidationError = class extends Error {
 	/**
@@ -257,16 +270,35 @@ var ArgsValidationError = class extends Error {
 		this.name = "ArgsValidationError";
 		this.code = options.code;
 		this.values = options.values ?? {};
+		Object.defineProperty(this, ARGS_VALIDATION_ERROR_BRAND, {
+			value: true,
+			enumerable: false,
+			writable: false,
+			configurable: false
+		});
 	}
 };
 /**
 * Check whether the given value is an {@link ArgsValidationError}.
 *
+* This guard also recognizes errors created by another bundled copy of `args-tokens`
+* (0.29.0 or later), where `instanceof` does not match. Such an error must have an own brand
+* keyed by `Symbol.for('args-tokens.ArgsValidationError')` set to `true`, and a `values` object.
+* The guard does not rely on `error.name`, so subclasses such as {@link ArgResolveError} that
+* override `name` are still recognized.
+*
+* The guard narrows to `ArgsValidationError` only. Across bundled copies,
+* `instanceof ArgResolveError` still does not match.
+*
 * @param error - value to check
 * @returns `true` when the value is an `ArgsValidationError`
 */
 function isArgsValidationError(error) {
-	return error instanceof ArgsValidationError;
+	if (error instanceof ArgsValidationError) return true;
+	if (typeof error !== "object" || error === null) return false;
+	if (!Object.hasOwn(error, ARGS_VALIDATION_ERROR_BRAND) || error[ARGS_VALIDATION_ERROR_BRAND] !== true) return false;
+	const values = error.values;
+	return typeof values === "object" && values !== null;
 }
 const SKIP_POSITIONAL_DEFAULT = -1;
 /**
@@ -649,10 +681,8 @@ function createChoiceError(rawArg, option, schema, actual) {
 	});
 }
 function createCustomParseError(error, rawArg, option, schema, value) {
-	if (isArgsValidationError(error)) {
-		augmentValidationError(error, rawArg, option, schema, value);
-		return error;
-	}
+	const reused = reuseValidationError(error, rawArg, option, schema, value);
+	if (reused) return reused;
 	const reason = getErrorReason(error);
 	return new ArgsValidationError(reason, {
 		code: ArgsValidationErrorKeys.customParse,
@@ -664,6 +694,26 @@ function createCustomParseError(error, rawArg, option, schema, value) {
 		cause: error
 	});
 }
+/**
+* Reuse an {@link ArgsValidationError} thrown from a custom `parse` function, filling in missing values.
+*
+* @param error - The value thrown from `parse`
+* @param rawArg - The argument key in the schema
+* @param option - The option name used on the command line
+* @param schema - The argument schema
+* @param value - The raw input value
+* @returns The same error when it can be reused, otherwise `undefined` so the caller wraps it.
+* Inspecting or updating the thrown value can throw, for example when its `values` object is frozen
+* or an accessor throws; such values are not reused, so a custom `parse` cannot make `resolveArgs` throw this way.
+*/
+function reuseValidationError(error, rawArg, option, schema, value) {
+	try {
+		if (isArgsValidationError(error)) {
+			augmentValidationError(error, rawArg, option, schema, value);
+			return error;
+		}
+	} catch {}
+}
 function augmentValidationError(error, rawArg, option, schema, value) {
 	const values = error.values;
 	values.name ??= rawArg;

package/lib/{src-yiBqxwCm.js → src-80_afJQM.js}

@@ -1,9 +1,9 @@
 import "./context-CAPhwgJJ.js";
-import { n as kebabnize } from "./utils-oPJNnmOb.js";
+import { n as kebabnize } from "./utils-DbRhwNIU.js";
 import { resolveLazyCommand } from "./utils.js";
-import { n as ArgsValidationErrorKeys, r as isArgsValidationError } from "./resolver-dsINFnU2.js";
-import { i as isCommandNotFoundError } from "./error-CBijJN5L.js";
-import { t as plugin } from "./plugin-Cvf6mYto.js";
+import { n as ArgsValidationErrorKeys } from "./resolver-D5skgYcF.js";
+import { a as isCommandNotFoundError, i as isArgsValidationError } from "./error-B5QxSzk9.js";
+import { t as plugin } from "./plugin-DneW3Toi.js";
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
 * @license MIT

package/lib/{types-CdM9C6VD.d.ts → types-H9nag_2Z.d.ts}

@@ -1,4 +1,4 @@
-import { i as Args, n as ArgSchema, r as ArgValues, t as ArgExplicitlyProvided, u as ArgToken } from "./resolver-D7DEcpu-.js";
+import { i as Args, l as ArgToken, n as ArgSchema, r as ArgValues, t as ArgExplicitlyProvided } from "./resolver-CbDvcwY3.js";
 
 //#region src/plugin/context.d.ts
 /**

package/lib/{utils-oPJNnmOb.js → utils-DbRhwNIU.js}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/utils.js
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/utils.js
 /**
 * Entry point of utils.
 *

package/lib/utils.d.ts

@@ -1,6 +1,10 @@
-import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-CdM9C6VD.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-H9nag_2Z.js";
 
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/utils.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.29.0/node_modules/args-tokens/lib/utils.d.ts
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 
 //#region src/utils.d.ts
 /**
@@ -21,12 +25,6 @@ import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable
  * @returns Converted string into kebab-case.
  */
 declare function kebabnize(str: string): string;
-/**
- * Format allowed argument choices for validation error values and fallback messages.
- *
- * @param choices - Choice values to format
- * @returns JSON-quoted choices joined with `, `.
- */
 //#endregion
 //#region src/utils.d.ts
 /**

package/lib/utils.js

@@ -1,4 +1,4 @@
-import { n as kebabnize } from "./utils-oPJNnmOb.js";
+import { n as kebabnize } from "./utils-DbRhwNIU.js";
 //#region src/utils.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.37.2",
+  "version": "0.37.3",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -108,7 +108,8 @@
     }
   },
   "devDependencies": {
-    "args-tokens": "^0.28.2",
+    "@types/node": "^25.6.2",
+    "args-tokens": "^0.29.0",
     "deno": "^2.7.14",
     "jsr": "^0.14.3",
     "jsr-exports-lint": "^0.4.2",
@@ -116,11 +117,11 @@
     "std-env": "^4.1.0",
     "tsdown": "0.21.0",
     "zod": "^4.4.3",
-    "@gunshi/plugin-i18n": "0.37.2",
-    "@gunshi/plugin-global": "0.37.2",
-    "@gunshi/resources": "0.37.2",
-    "@gunshi/plugin-renderer": "0.37.2",
-    "@gunshi/shared": "0.37.2"
+    "@gunshi/plugin-global": "0.37.3",
+    "@gunshi/plugin-i18n": "0.37.3",
+    "@gunshi/resources": "0.37.3",
+    "@gunshi/shared": "0.37.3",
+    "@gunshi/plugin-renderer": "0.37.3"
   },
   "scripts": {
     "build": "tsdown",

package/lib/error-CBijJN5L.js

@@ -1,65 +0,0 @@
-import { n as ArgsValidationErrorKeys, r as isArgsValidationError } from "./resolver-dsINFnU2.js";
-//#region ../../node_modules/.pnpm/args-tokens@0.28.2/node_modules/args-tokens/lib/index.js
-/**
-* @author kazuya kawaguchi (a.k.a. kazupon)
-* @license MIT
-*/
-/**
-* @author kazuya kawaguchi (a.k.a. kazupon)
-* @license MIT
-*/
-//#endregion
-//#region src/error.ts
-/**
-* @author kazuya kawaguchi (a.k.a. kazupon)
-* @license MIT
-*/
-/**
-* Command not found error resource keys.
-*/
-const CommandNotFoundErrorKeys = { notFound: "err:cmd:not-found" };
-/**
-* Error raised when a command cannot be resolved.
-*/
-var CommandNotFoundError = class extends Error {
-	code;
-	values;
-	commandName;
-	candidates;
-	commandPath;
-	/**
-	* Create a command-not-found error.
-	*
-	* @param message - Fallback error message
-	* @param options - Command-not-found metadata
-	*/
-	constructor(message, options) {
-		super(message, { cause: options.cause });
-		this.name = "CommandNotFoundError";
-		this.code = options.code;
-		this.values = options.values || {};
-		this.commandName = options.commandName;
-		this.candidates = options.candidates || [];
-		this.commandPath = options.commandPath || [];
-	}
-};
-/**
-* Check whether an error is a {@link CommandNotFoundError}.
-*
-* @param error - An unknown error
-* @returns `true` if the error is a {@link CommandNotFoundError}
-*/
-function isCommandNotFoundError(error) {
-	return error instanceof CommandNotFoundError;
-}
-/**
-* Check whether validation errors should be handled before version, help, or command execution.
-*
-* @param error - An aggregate validation error
-* @returns `true` if the validation error must be handled with priority
-*/
-function hasPriorityValidationError(error) {
-	return error?.errors.some((error) => isCommandNotFoundError(error) || isArgsValidationError(error) && error.code === ArgsValidationErrorKeys.unknownOption) ?? false;
-}
-//#endregion
-export { isCommandNotFoundError as i, CommandNotFoundErrorKeys as n, hasPriorityValidationError as r, CommandNotFoundError as t };