gunshi 0.29.3 → 0.29.5

package/lib/bone.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-D4JorBDf.js";
-import { C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, S as NormalizeToGunshiParams, T as RenderingOptions, _ 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 RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-CcuJzRjy.js";
+import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.js";
+import { C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, S as NormalizeToGunshiParams, T as RenderingOptions, _ 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 RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
 
 //#region src/cli/bone.d.ts
 /**

package/lib/bone.js

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

package/lib/{cli-Dq9-F-ZP.js → cli-COx8zjEj.js}

@@ -1,7 +1,6 @@
-import { t as cliCore } from "./core-BabkHGNU.js";
-import { t as plugin } from "./core-eN5xmB3s.js";
-import { a as namespacedId, s as COMMON_ARGS, t as renderer } from "./src-CLiit_Bx.js";
-
+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";
 //#region ../plugin-global/src/types.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
@@ -11,7 +10,6 @@ import { a as namespacedId, s as COMMON_ARGS, t as renderer } from "./src-CLiit_
 * The unique identifier for the global options plugin.
 */
 const pluginId = namespacedId("global");
-
 //#endregion
 //#region ../plugin-global/src/decorator.ts
 /**
@@ -38,11 +36,12 @@ const decorator = (baseRunner) => async (ctx) => {
 		}
 		return;
 	}
-	if (validationError) return await showValidationErrors(validationError);
+	if (validationError) {
+		await showValidationErrors(validationError);
+		throw validationError;
+	}
 	return baseRunner(ctx);
 };
-var decorator_default = decorator;
-
 //#endregion
 //#region ../plugin-global/src/extension.ts
 /**
@@ -88,7 +87,6 @@ function extension(ctx) {
 		}
 	};
 }
-
 //#endregion
 //#region ../plugin-global/src/index.ts
 /**
@@ -132,11 +130,10 @@ function global() {
 		extension,
 		setup(ctx) {
 			for (const [name, schema] of Object.entries(COMMON_ARGS)) ctx.addGlobalOption(name, schema);
-			ctx.decorateCommand(decorator_default);
+			ctx.decorateCommand(decorator);
 		}
 	});
 }
-
 //#endregion
 //#region src/cli/builtin.ts
 /**
@@ -156,6 +153,5 @@ function global() {
 async function cli(args, entry, options = {}) {
 	return cliCore(args, entry, options, [global(), renderer()]);
 }
-
 //#endregion
-export { cli as t };
+export { cli as t };

package/lib/combinators.d.ts

@@ -1,4 +1,4 @@
-import { i as Args, n as ArgSchema } from "./resolver-D4JorBDf.js";
+import { i as Args, n as ArgSchema } from "./resolver-DGtVt298.js";
 
 //#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/combinators.d.ts
 /**

package/lib/combinators.js

@@ -516,6 +516,5 @@ function extend(base, overrides) {
 	for (const key of Object.keys(overrides)) result[key] = overrides[key];
 	return result;
 }
-
 //#endregion
-export { args, boolean, choice, combinator, describe, extend, float, integer, map, merge, multiple, number, positional, required, short, string, unrequired, withDefault };
+export { args, boolean, choice, combinator, describe, extend, float, integer, map, merge, multiple, number, positional, required, short, string, unrequired, withDefault };

package/lib/{constants-QPaYzi6d.d.ts → constants-BKVrvh3H.d.ts}

@@ -1,4 +1,4 @@
-import { m as DefaultGunshiParams, n as CliOptions } from "./types-CcuJzRjy.js";
+import { m as DefaultGunshiParams, n as CliOptions } from "./types-FFgtdrno.js";
 
 //#region src/constants.d.ts
 /**

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

@@ -21,6 +21,5 @@ const CLI_OPTIONS_DEFAULT = {
 	plugins: void 0,
 	fallbackToEntry: false
 };
-
 //#endregion
-export { CLI_OPTIONS_DEFAULT as n, NOOP as r, ANONYMOUS_COMMAND_NAME as t };
+export { CLI_OPTIONS_DEFAULT as n, NOOP as r, ANONYMOUS_COMMAND_NAME as t };

package/lib/context.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, o as ArgToken, r as ArgValues } from "./resolver-D4JorBDf.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-CcuJzRjy.js";
+import { i as Args, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.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-FFgtdrno.js";
 
 //#region src/context.d.ts
 

package/lib/context.js

@@ -1,3 +1,91 @@
-import { t as createCommandContext } from "./context-BSv3I5Ip.js";
-
-export { createCommandContext };
+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";
+//#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.
+* @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 }) {
+	/**
+	* normailize the options schema and values, to avoid prototype pollution
+	*/
+	const _args = Object.entries(args).reduce((acc, [key, value]) => {
+		acc[key] = Object.assign(create(), value);
+		return acc;
+	}, create());
+	/**
+	* setup the environment
+	*/
+	const env = Object.assign(create(), CLI_OPTIONS_DEFAULT, cliOptions);
+	/**
+	* apply Command definition's rendering option with highest priority
+	*/
+	if (command.rendering) {
+		const { header, usage, validationErrors } = command.rendering;
+		if (header !== void 0) env.renderHeader = header;
+		if (usage !== void 0) env.renderUsage = usage;
+		if (validationErrors !== void 0) env.renderValidationErrors = validationErrors;
+	}
+	/**
+	* create the command context
+	*/
+	const core = Object.assign(create(), {
+		name: getCommandName(command),
+		description: command.description,
+		omitted,
+		callMode,
+		commandPath,
+		env,
+		args: _args,
+		explicit,
+		values,
+		positionals,
+		rest,
+		_: argv,
+		tokens,
+		toKebab: command.toKebab,
+		log: cliOptions.usageSilent ? NOOP : log,
+		validationError
+	});
+	/**
+	* extend the command context with extensions
+	*/
+	if (Object.keys(extensions).length > 0) {
+		const ext = create(null);
+		Object.defineProperty(core, "extensions", {
+			value: ext,
+			writable: false,
+			enumerable: true,
+			configurable: true
+		});
+		for (const [key, extension] of Object.entries(extensions)) {
+			ext[key] = await extension.factory(core, command);
+			if (extension.onFactory) await extension.onFactory(core, command);
+		}
+	}
+	return deepFreeze(core, ["extensions"]);
+}
+function getCommandName(cmd) {
+	if (isLazyCommand(cmd)) return cmd.commandName || cmd.name || "(anonymous)";
+	else if (typeof cmd === "object") return cmd.name || "(anonymous)";
+	else return ANONYMOUS_COMMAND_NAME;
+}
+//#endregion
+export { createCommandContext };

package/lib/{core-BabkHGNU.js → core-CDWBHGHv.js}

@@ -1,7 +1,6 @@
-import { i as isLazyCommand, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-DZGPApAe.js";
-import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from "./constants-WviiKqbt.js";
-import { t as createCommandContext } from "./context-BSv3I5Ip.js";
-
+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 { createCommandContext } from "./context.js";
 //#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/parser.js
 const HYPHEN_CHAR = "-";
 const HYPHEN_CODE = HYPHEN_CHAR.codePointAt(0);
@@ -198,7 +197,6 @@ function hasLongOptionPrefix(arg) {
 function hasOptionValue(value) {
 	return !(value == null) && value.codePointAt(0) !== HYPHEN_CODE;
 }
-
 //#endregion
 //#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/resolver.js
 /**
@@ -499,7 +497,6 @@ function checkConflicts(args, explicit, toKebab, actualInputNames) {
 	}
 	return [];
 }
-
 //#endregion
 //#region src/decorators.ts
 const EMPTY_RENDERER = () => Promise.resolve("");
@@ -564,7 +561,6 @@ function createDecorators() {
 		}
 	});
 }
-
 //#endregion
 //#region src/plugin/context.ts
 /**
@@ -619,7 +615,6 @@ function createPluginContext(decorators, initialSubCommands) {
 		}
 	});
 }
-
 //#endregion
 //#region src/plugin/dependency.ts
 /**
@@ -657,7 +652,6 @@ function resolveDependencies(plugins) {
 	for (const plugin of plugins) visit(plugin);
 	return sorted;
 }
-
 //#endregion
 //#region src/cli/core.ts
 /**
@@ -748,7 +742,7 @@ function createInitialSubCommands(options, entryCmd) {
 			const entryCopy = Object.assign(create(), entryCmd, { entry: true });
 			subCommands.set(resolveEntryName(entryCopy), entryCopy);
 		} else if (typeof entryCmd === "function") {
-			const name = entryCmd.name || ANONYMOUS_COMMAND_NAME;
+			const name = entryCmd.name || "(anonymous)";
 			subCommands.set(name, {
 				run: entryCmd,
 				name,
@@ -865,7 +859,7 @@ function resolveCommandTree(tokens, entry, options) {
 	};
 }
 function resolveEntryName(entry) {
-	return isLazyCommand(entry) ? entry.commandName || ANONYMOUS_COMMAND_NAME : entry.name || ANONYMOUS_COMMAND_NAME;
+	return isLazyCommand(entry) ? entry.commandName || "(anonymous)" : entry.name || "(anonymous)";
 }
 function getPluginExtensions(plugins) {
 	const extensions = create();
@@ -893,6 +887,5 @@ async function executeCommand(cmd, ctx, decorators) {
 		throw error;
 	}
 }
-
 //#endregion
-export { resolveArgs as n, parseArgs as r, cliCore as t };
+export { resolveArgs as n, parseArgs as r, cliCore as t };

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

@@ -44,6 +44,5 @@ function plugin(options = {}) {
 		} }
 	});
 }
-
 //#endregion
-export { plugin as t };
+export { plugin as t };

package/lib/definition.d.ts

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

package/lib/definition.js

@@ -1,5 +1,4 @@
-import { t as createCommandContext } from "./context-BSv3I5Ip.js";
-
+import { createCommandContext } from "./context.js";
 //#region src/definition.ts
 /**
 * Define a {@link Command | command}.
@@ -107,6 +106,5 @@ function lazyWithTypes() {
 		return lazy(loader, definition);
 	};
 }
-
 //#endregion
-export { createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };
+export { createCommandContext, define, defineWithTypes, lazy, lazyWithTypes };

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-CcuJzRjy.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, n as CliOptions, r as Command, x as LazyCommand } from "./types-FFgtdrno.js";
 
 //#region src/generator.d.ts
 

package/lib/generator.js

@@ -1,8 +1,5 @@
-import "./core-BabkHGNU.js";
-import { t as create } from "./utils-DZGPApAe.js";
-import "./src-CLiit_Bx.js";
-import { t as cli } from "./cli-Dq9-F-ZP.js";
-
+import { t as create } from "./utils-1JDAM4DH.js";
+import { t as cli } from "./cli-COx8zjEj.js";
 //#region src/generator.ts
 /**
 * The entry for usage generator.
@@ -40,6 +37,5 @@ async function generate(command, entry, options = {}) {
 		usageSilent: true
 	}) || "";
 }
-
 //#endregion
-export { generate };
+export { generate };

package/lib/index.d.ts

@@ -1,8 +1,8 @@
-import { a as resolveArgs, i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, s as parseArgs } from "./resolver-D4JorBDf.js";
-import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, T as RenderingOptions, _ 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 PluginExtension, k as Plugin, 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 RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-CcuJzRjy.js";
+import { a as resolveArgs, i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, s as parseArgs } from "./resolver-DGtVt298.js";
+import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, T as RenderingOptions, _ 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 PluginExtension, k as Plugin, 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 RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./constants-QPaYzi6d.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.js";
 
 //#region ../plugin-i18n/src/types.d.ts
 

package/lib/index.js

@@ -1,11 +1,10 @@
-import { n as resolveArgs, r as parseArgs } from "./core-BabkHGNU.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./constants-WviiKqbt.js";
-import { t as createCommandContext } from "./context-BSv3I5Ip.js";
+import { n as resolveArgs, r as parseArgs } from "./core-CDWBHGHv.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./constants-Bum1xzqZ.js";
+import { createCommandContext } from "./context.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
-import { t as plugin } from "./core-eN5xmB3s.js";
-import { a as namespacedId, o as BUILT_IN_PREFIX } from "./src-CLiit_Bx.js";
-import { t as cli } from "./cli-Dq9-F-ZP.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
 /**
 * Default implementation of {@linkcode TranslationAdapter}.
@@ -69,17 +68,7 @@ var DefaultTranslation = class {
 		});
 	}
 };
-
+namespacedId("i18n");
+"_".codePointAt(0);
 //#endregion
-//#region ../plugin-i18n/src/types.ts
-/**
-* The unique identifier for the i18n plugin.
-*/
-const pluginId = namespacedId("i18n");
-
-//#endregion
-//#region ../plugin-i18n/src/index.ts
-const BUILT_IN_PREFIX_CODE = BUILT_IN_PREFIX.codePointAt(0);
-
-//#endregion
-export { ANONYMOUS_COMMAND_NAME, DefaultTranslation, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };
+export { ANONYMOUS_COMMAND_NAME, DefaultTranslation, cli, createCommandContext, define, defineWithTypes, lazy, lazyWithTypes, parseArgs, plugin, resolveArgs };

package/lib/plugin.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-D4JorBDf.js";
-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-CcuJzRjy.js";
+import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.js";
+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-QPaYzi6d.js";
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.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 };

package/lib/plugin.js

@@ -1,5 +1,4 @@
-import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-WviiKqbt.js";
-import { t as createCommandContext } from "./context-BSv3I5Ip.js";
-import { t as plugin } from "./core-eN5xmB3s.js";
-
-export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext, plugin };
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-Bum1xzqZ.js";
+import { createCommandContext } from "./context.js";
+import { t as plugin } from "./core-x8spYr6g.js";
+export { ANONYMOUS_COMMAND_NAME, CLI_OPTIONS_DEFAULT, createCommandContext, plugin };

package/lib/renderer.d.ts

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

package/lib/renderer.js

@@ -1,3 +1,2 @@
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-CLiit_Bx.js";
-
-export { renderHeader, renderUsage, renderValidationErrors };
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-D_ZSzQUF.js";
+export { renderHeader, renderUsage, renderValidationErrors };

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

@@ -1,19 +1,8 @@
-import { o as resolveLazyCommand, s as kebabnize } from "./utils-DZGPApAe.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./constants-WviiKqbt.js";
-import { t as plugin } from "./core-eN5xmB3s.js";
-
-//#region ../shared/src/constants.ts
-/**
-* @author kazuya kawaguchi (a.k.a. kazupon)
-* @license MIT
-*/
-const BUILT_IN_PREFIX = "_";
-const PLUGIN_PREFIX = "g";
-const ARG_PREFIX = "arg";
-const BUILT_IN_KEY_SEPARATOR = ":";
-const BUILD_IN_PREFIX_AND_KEY_SEPARATOR = `${BUILT_IN_PREFIX}${BUILT_IN_KEY_SEPARATOR}`;
-const ARG_PREFIX_AND_KEY_SEPARATOR = `${ARG_PREFIX}${BUILT_IN_KEY_SEPARATOR}`;
-const ARG_NEGATABLE_PREFIX = "no-";
+import { o as resolveLazyCommand, s as kebabnize } from "./utils-1JDAM4DH.js";
+import "./constants-Bum1xzqZ.js";
+import { t as plugin } from "./core-x8spYr6g.js";
+const BUILD_IN_PREFIX_AND_KEY_SEPARATOR = `_:`;
+const ARG_PREFIX_AND_KEY_SEPARATOR = `arg:`;
 const COMMON_ARGS = {
 	help: {
 		type: "boolean",
@@ -26,7 +15,6 @@ const COMMON_ARGS = {
 		description: "Display this version"
 	}
 };
-
 //#endregion
 //#region ../resources/locales/en-US.json
 var NEGATABLE = "Negatable of";
@@ -45,7 +33,6 @@ var en_US_default = {
 	help: "Display this help message",
 	version: "Display this version"
 };
-
 //#endregion
 //#region ../shared/src/utils.ts
 /**
@@ -63,7 +50,7 @@ var en_US_default = {
 * @returns Prefixed built-in key.
 */
 function resolveBuiltInKey(key) {
-	return `${BUILT_IN_PREFIX}${BUILT_IN_KEY_SEPARATOR}${key}`;
+	return `_:${key}`;
 }
 /**
 * Resolve a namespaced key for argument resources.
@@ -78,7 +65,7 @@ function resolveBuiltInKey(key) {
 * @returns Prefixed argument key.
 */
 function resolveArgKey(key, name) {
-	return `${name ? `${name}${BUILT_IN_KEY_SEPARATOR}` : ""}${ARG_PREFIX}${BUILT_IN_KEY_SEPARATOR}${key}`;
+	return `${name ? `${name}:` : ""}arg:${key}`;
 }
 /**
 * Resolve a namespaced key for non-built-in resources.
@@ -92,7 +79,7 @@ function resolveArgKey(key, name) {
 * @returns Prefixed non-built-in key.
 */
 function resolveKey(key, name) {
-	return `${name ? `${name}${BUILT_IN_KEY_SEPARATOR}` : ""}${key}`;
+	return `${name ? `${name}:` : ""}${key}`;
 }
 /**
 * Resolve command examples.
@@ -115,7 +102,7 @@ async function resolveExamples$1(ctx, examples) {
 * @returns A namespaced key for the plugin.
 */
 function namespacedId(id) {
-	return `${PLUGIN_PREFIX}${BUILT_IN_KEY_SEPARATOR}${id}`;
+	return `g:${id}`;
 }
 /**
 * Generate a short and long option pair for command arguments.
@@ -130,7 +117,6 @@ function makeShortLongOptionPair(schema, name, toKebab) {
 	if (schema.short) key = `-${schema.short}, ${key}`;
 	return key;
 }
-
 //#endregion
 //#region ../shared/src/localization.ts
 /**
@@ -159,8 +145,8 @@ function localizable(ctx, cmd, translate) {
 		if (key.startsWith(namaspacedArgKey)) {
 			let argKey = key.slice(namaspacedArgKey.length);
 			let negatable = false;
-			if (argKey.startsWith(ARG_NEGATABLE_PREFIX)) {
-				argKey = argKey.slice(ARG_NEGATABLE_PREFIX.length);
+			if (argKey.startsWith("no-")) {
+				argKey = argKey.slice(3);
 				negatable = true;
 			}
 			const schema = ctx.args[argKey];
@@ -173,7 +159,6 @@ function localizable(ctx, cmd, translate) {
 	}
 	return localize;
 }
-
 //#endregion
 //#region ../plugin-renderer/src/header.ts
 /**
@@ -186,7 +171,6 @@ function renderHeader(ctx) {
 	const title = ctx.env.description || ctx.env.name || "";
 	return Promise.resolve(title ? `${title} (${ctx.env.name || ""}${ctx.env.version ? ` v${ctx.env.version}` : ""})` : title);
 }
-
 //#endregion
 //#region ../plugin-renderer/src/types.ts
 /**
@@ -197,7 +181,6 @@ function renderHeader(ctx) {
 * The unique identifier for usage renderer plugin.
 */
 const pluginId = namespacedId("renderer");
-
 //#endregion
 //#region ../plugin-renderer/src/usage.ts
 /**
@@ -319,7 +302,7 @@ async function renderCommandsSection(ctx) {
 async function makeCommandSymbol(ctx, cmd) {
 	const optionSymbol = await generateOptionsSymbols(ctx, ctx.args);
 	const positionalSymbol = generatePositionalSymbols(ctx.args);
-	let commandStr = cmd.entry ? cmd.name === void 0 || cmd.name === ANONYMOUS_COMMAND_NAME ? "" : `[${cmd.name}]` : cmd.name || "";
+	let commandStr = cmd.entry ? cmd.name === void 0 || cmd.name === "(anonymous)" ? "" : `[${cmd.name}]` : cmd.name || "";
 	if (optionSymbol) {
 		if (commandStr) commandStr += " ";
 		commandStr += `${optionSymbol}`;
@@ -433,14 +416,14 @@ function getOptionalArgsPairs(ctx) {
 		acc[name] = key;
 		if (schema.type === "boolean" && schema.negatable && !COMMON_ARGS_KEYS.includes(name)) {
 			const displayName = ctx.toKebab || schema.toKebab ? kebabnize(name) : name;
-			acc[`${ARG_NEGATABLE_PREFIX}${name}`] = `--${ARG_NEGATABLE_PREFIX}${displayName}`;
+			acc[`no-${name}`] = `--no-${displayName}`;
 		}
 		return acc;
 	}, Object.create(null));
 }
-const resolveNegatableKey = (key) => key.split(ARG_NEGATABLE_PREFIX)[1];
+const resolveNegatableKey = (key) => key.split("no-")[1];
 function resolveNegatableType(key, ctx) {
-	return ctx.args[key.startsWith(ARG_NEGATABLE_PREFIX) ? resolveNegatableKey(key) : key].type;
+	return ctx.args[key.startsWith("no-") ? resolveNegatableKey(key) : key].type;
 }
 async function generateDefaultDisplayValue(ctx, schema) {
 	return `${await ctx.extensions[pluginId].text(resolveBuiltInKey("DEFAULT"))}: ${schema.default}`;
@@ -468,14 +451,14 @@ async function generateOptionalArgsUsage(ctx, optionsPairs) {
 	const optionSchemaMaxLength = ctx.env.usageOptionType ? Math.max(...Object.entries(optionsPairs).map(([key]) => resolveNegatableType(key, ctx).length)) : 0;
 	return (await Promise.all(Object.entries(optionsPairs).map(async ([key, value]) => {
 		let rawDesc = await ctx.extensions[pluginId].text(resolveArgKey(key, ctx.name));
-		if (!rawDesc && key.startsWith(ARG_NEGATABLE_PREFIX)) {
+		if (!rawDesc && key.startsWith("no-")) {
 			const name = resolveNegatableKey(key);
 			const schema = ctx.args[name];
 			const optionKey = makeShortLongOptionPair(schema, name, ctx.toKebab);
 			rawDesc = `${await ctx.extensions[pluginId].text(resolveBuiltInKey("NEGATABLE"))} ${optionKey}`;
 		}
 		const optionsSchema = ctx.env.usageOptionType ? `[${resolveNegatableType(key, ctx)}] ` : "";
-		const valueDesc = key.startsWith(ARG_NEGATABLE_PREFIX) ? "" : await resolveDisplayValue(ctx, key);
+		const valueDesc = key.startsWith("no-") ? "" : await resolveDisplayValue(ctx, key);
 		const desc = `${optionsSchema ? optionsSchema.padEnd(optionSchemaMaxLength + 3) : ""}${rawDesc}`;
 		const descLength = desc.length + valueDesc.length;
 		const option = `${value.padEnd((descLength > 0 ? optionsMaxLength : 0) + ctx.env.middleMargin)}${desc}${valueDesc ? ` ${valueDesc}` : ""}`;
@@ -502,7 +485,6 @@ function generatePositionalSymbols(args) {
 		return elements.join(" ");
 	}).join(" ") : "";
 }
-
 //#endregion
 //#region ../plugin-renderer/src/validation.ts
 /**
@@ -517,7 +499,6 @@ function renderValidationErrors(_ctx, error) {
 	for (const err of error.errors) messages.push(err.message);
 	return Promise.resolve(messages.join("\n"));
 }
-
 //#endregion
 //#region ../plugin-renderer/src/index.ts
 /**
@@ -593,6 +574,5 @@ function renderer() {
 		}
 	});
 }
-
 //#endregion
-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 };
+export { namespacedId as a, renderHeader as i, renderValidationErrors as n, COMMON_ARGS as o, renderUsage as r, renderer as t };

package/lib/{types-CcuJzRjy.d.ts → types-FFgtdrno.d.ts}

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

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

@@ -19,7 +19,6 @@
 function kebabnize(str) {
 	return str.replace(/[A-Z]/g, (match, offset) => (offset > 0 ? "-" : "") + match.toLowerCase());
 }
-
 //#endregion
 //#region src/utils.ts
 /**
@@ -124,6 +123,5 @@ function deepFreeze(obj, ignores = []) {
 	}
 	return Object.freeze(obj);
 }
-
 //#endregion
-export { log as a, isLazyCommand as i, deepFreeze as n, resolveLazyCommand as o, getCommandSubCommands as r, kebabnize as s, create as t };
+export { log as a, isLazyCommand as i, deepFreeze as n, resolveLazyCommand as o, getCommandSubCommands as r, kebabnize as s, create as t };

package/lib/utils.d.ts

@@ -1,4 +1,4 @@
-import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-CcuJzRjy.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-FFgtdrno.js";
 
 //#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/utils.d.ts
 

package/lib/utils.js

@@ -1,3 +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-DZGPApAe.js";
-
-export { create, deepFreeze, getCommandSubCommands, isLazyCommand, kebabnize, log, resolveLazyCommand };
+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";
+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.3",
+  "version": "0.29.5",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -103,17 +103,17 @@
   },
   "devDependencies": {
     "args-tokens": "^0.24.3",
-    "deno": "^2.7.4",
-    "jsr": "^0.13.5",
+    "deno": "^2.7.11",
+    "jsr": "^0.14.3",
     "jsr-exports-lint": "^0.4.2",
     "publint": "^0.3.18",
     "tsdown": "0.15.12",
     "zod": "^4.3.6",
-    "@gunshi/plugin-i18n": "0.29.3",
-    "@gunshi/plugin-global": "0.29.3",
-    "@gunshi/plugin-renderer": "0.29.3",
-    "@gunshi/resources": "0.29.3",
-    "@gunshi/shared": "0.29.3"
+    "@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"
   },
   "scripts": {
     "build": "tsdown",

package/lib/context-BSv3I5Ip.js

@@ -1,93 +0,0 @@
-import { a as log, i as isLazyCommand, n as deepFreeze, t as create } from "./utils-DZGPApAe.js";
-import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from "./constants-WviiKqbt.js";
-
-//#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.
-* @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 }) {
-	/**
-	* normailize the options schema and values, to avoid prototype pollution
-	*/
-	const _args = Object.entries(args).reduce((acc, [key, value]) => {
-		acc[key] = Object.assign(create(), value);
-		return acc;
-	}, create());
-	/**
-	* setup the environment
-	*/
-	const env = Object.assign(create(), CLI_OPTIONS_DEFAULT, cliOptions);
-	/**
-	* apply Command definition's rendering option with highest priority
-	*/
-	if (command.rendering) {
-		const { header, usage, validationErrors } = command.rendering;
-		if (header !== void 0) env.renderHeader = header;
-		if (usage !== void 0) env.renderUsage = usage;
-		if (validationErrors !== void 0) env.renderValidationErrors = validationErrors;
-	}
-	/**
-	* create the command context
-	*/
-	const core = Object.assign(create(), {
-		name: getCommandName(command),
-		description: command.description,
-		omitted,
-		callMode,
-		commandPath,
-		env,
-		args: _args,
-		explicit,
-		values,
-		positionals,
-		rest,
-		_: argv,
-		tokens,
-		toKebab: command.toKebab,
-		log: cliOptions.usageSilent ? NOOP : log,
-		validationError
-	});
-	/**
-	* extend the command context with extensions
-	*/
-	if (Object.keys(extensions).length > 0) {
-		const ext = create(null);
-		Object.defineProperty(core, "extensions", {
-			value: ext,
-			writable: false,
-			enumerable: true,
-			configurable: true
-		});
-		for (const [key, extension] of Object.entries(extensions)) {
-			ext[key] = await extension.factory(core, command);
-			if (extension.onFactory) await extension.onFactory(core, command);
-		}
-	}
-	return deepFreeze(core, ["extensions"]);
-}
-function getCommandName(cmd) {
-	if (isLazyCommand(cmd)) return cmd.commandName || cmd.name || ANONYMOUS_COMMAND_NAME;
-	else if (typeof cmd === "object") return cmd.name || ANONYMOUS_COMMAND_NAME;
-	else return ANONYMOUS_COMMAND_NAME;
-}
-
-//#endregion
-export { createCommandContext as t };