gunshi 0.24.0 → 0.25.0

package/lib/{cli-BVD3QITm.js → cli-BtS9kKar.js}

@@ -1,6 +1,6 @@
-import { ANONYMOUS_COMMAND_NAME, COMMAND_OPTIONS_DEFAULT, COMMON_ARGS, create, isLazyCommand, resolveLazyCommand } from "./utils-D41C8Abf.js";
-import { createCommandContext } from "./context-COFfMm-R.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-kzo45gaB.js";
+import { ANONYMOUS_COMMAND_NAME, COMMAND_OPTIONS_DEFAULT, COMMON_ARGS, create, isLazyCommand, resolveLazyCommand } from "./utils-B_QNzw5q.js";
+import { createCommandContext } from "./context-DT5PgSdv.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-CTx2DsBI.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/cli.ts
@@ -19,7 +19,8 @@ async function cli(argv, entry, options = {}) {
 	if (!command) throw new Error(`Command not found: ${name || ""}`);
 	const args = resolveArguments(getCommandArgs(command));
 	const { values, positionals, rest, error } = resolveArgs(args, tokens, {
-		optionGrouping: true,
+		shortGrouping: true,
+		toKebab: command.toKebab,
 		skipPositional: cliOptions.subCommands.size > 0 ? 0 : -1
 	});
 	const omitted = !subCommand;

package/lib/{context-COFfMm-R.js → context-DT5PgSdv.js}

@@ -1,4 +1,4 @@
-import { ANONYMOUS_COMMAND_NAME, BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, DEFAULT_LOCALE$1 as DEFAULT_LOCALE, NOOP, create, deepFreeze, isLazyCommand, log, mapResourceWithBuiltinKey, resolveArgKey, resolveExamples, resolveLazyCommand } from "./utils-D41C8Abf.js";
+import { ANONYMOUS_COMMAND_NAME, BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, DEFAULT_LOCALE$1 as DEFAULT_LOCALE, NOOP, create, deepFreeze, isLazyCommand, log, mapResourceWithBuiltinKey, resolveArgKey, resolveExamples, resolveLazyCommand } from "./utils-B_QNzw5q.js";
 
 //#region src/locales/en-US.json
 var COMMAND = "COMMAND";
@@ -137,6 +137,7 @@ async function createCommandContext({ args, values, positionals, rest, argv, tok
 		rest,
 		_: argv,
 		tokens,
+		toKebab: command.toKebab,
 		log: cliOptions.usageSilent ? NOOP : log,
 		loadCommands,
 		translate

package/lib/context.d.ts

@@ -1,4 +1,4 @@
-import { CliOptions, Command, CommandCallMode, CommandContext, LazyCommand } from "./types-BDWiiycu.js";
+import { CliOptions, Command, CommandCallMode, CommandContext, LazyCommand } from "./types-B7j6WSjQ.js";
 import { ArgToken, ArgValues, Args } from "args-tokens";
 
 //#region src/context.d.ts

package/lib/context.js

@@ -1,4 +1,4 @@
-import "./utils-D41C8Abf.js";
-import { createCommandContext } from "./context-COFfMm-R.js";
+import "./utils-B_QNzw5q.js";
+import { createCommandContext } from "./context-DT5PgSdv.js";
 
 export { createCommandContext };

package/lib/{definition-zTfMFgKw.d.ts → definition-C3eTsvXE.d.ts}

@@ -1,4 +1,4 @@
-import { Command, CommandLoader, LazyCommand } from "./types-BDWiiycu.js";
+import { Command, CommandLoader, LazyCommand } from "./types-B7j6WSjQ.js";
 import { ArgSchema, ArgValues as ArgValues$1, Args, Args as Args$1 } from "args-tokens";
 
 //#region src/definition.d.ts

package/lib/{definition-DyVBFqB7.js → definition-wq1Kmbvq.js}

@@ -20,6 +20,7 @@ function lazy(loader, definition) {
 		loader.args = definition.args;
 		loader.examples = definition.examples;
 		loader.resource = definition.resource;
+		loader.toKebab = definition.toKebab;
 	}
 	return loader;
 }

package/lib/definition.d.ts

@@ -1,3 +1,3 @@
-import "./types-BDWiiycu.js";
-import { ArgSchema, ArgValues, Args, define$1 as define, lazy$1 as lazy } from "./definition-zTfMFgKw.js";
+import "./types-B7j6WSjQ.js";
+import { ArgSchema, ArgValues, Args, define$1 as define, lazy$1 as lazy } from "./definition-C3eTsvXE.js";
 export { ArgSchema, ArgValues, Args, define, lazy };

package/lib/definition.js

@@ -1,3 +1,3 @@
-import { define, lazy } from "./definition-DyVBFqB7.js";
+import { define, lazy } from "./definition-wq1Kmbvq.js";
 
 export { define, lazy };

package/lib/generator.d.ts

@@ -1,4 +1,4 @@
-import { CliOptions, Command, LazyCommand } from "./types-BDWiiycu.js";
+import { CliOptions, Command, LazyCommand } from "./types-B7j6WSjQ.js";
 import { Args } from "args-tokens";
 
 //#region src/generator.d.ts

package/lib/generator.js

@@ -1,7 +1,7 @@
-import { create } from "./utils-D41C8Abf.js";
-import "./context-COFfMm-R.js";
-import "./renderer-kzo45gaB.js";
-import { cli } from "./cli-BVD3QITm.js";
+import { create } from "./utils-B_QNzw5q.js";
+import "./context-DT5PgSdv.js";
+import "./renderer-CTx2DsBI.js";
+import { cli } from "./cli-BtS9kKar.js";
 
 //#region src/generator.ts
 /**

package/lib/index.d.ts

@@ -1,5 +1,5 @@
-import { CliOptions, Command, CommandArgKeys, CommandBuiltinArgsKeys, CommandBuiltinKeys, CommandBuiltinResourceKeys, CommandCallMode, CommandContext, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandResource, CommandResourceFetcher, CommandRunner, Commandable, DEFAULT_LOCALE, GenerateNamespacedKey, KeyOfArgs, LazyCommand, RemovedIndex, TranslationAdapter, TranslationAdapterFactory, TranslationAdapterFactoryOptions } from "./types-BDWiiycu.js";
-import { define$1 as define, lazy$1 as lazy } from "./definition-zTfMFgKw.js";
+import { CliOptions, Command, CommandArgKeys, CommandBuiltinArgsKeys, CommandBuiltinKeys, CommandBuiltinResourceKeys, CommandCallMode, CommandContext, CommandEnvironment, CommandExamplesFetcher, CommandLoader, CommandResource, CommandResourceFetcher, CommandRunner, Commandable, DEFAULT_LOCALE, GenerateNamespacedKey, KeyOfArgs, LazyCommand, RemovedIndex, TranslationAdapter, TranslationAdapterFactory, TranslationAdapterFactoryOptions } from "./types-B7j6WSjQ.js";
+import { define$1 as define, lazy$1 as lazy } from "./definition-C3eTsvXE.js";
 import { ArgSchema, ArgValues, Args, Args as Args$1, parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/cli.d.ts

package/lib/index.js

@@ -1,8 +1,8 @@
-import { DEFAULT_LOCALE$1 as DEFAULT_LOCALE } from "./utils-D41C8Abf.js";
-import { DefaultTranslation } from "./context-COFfMm-R.js";
-import { define, lazy } from "./definition-DyVBFqB7.js";
-import "./renderer-kzo45gaB.js";
-import { cli } from "./cli-BVD3QITm.js";
+import { DEFAULT_LOCALE$1 as DEFAULT_LOCALE } from "./utils-B_QNzw5q.js";
+import { DefaultTranslation } from "./context-DT5PgSdv.js";
+import { define, lazy } from "./definition-wq1Kmbvq.js";
+import "./renderer-CTx2DsBI.js";
+import { cli } from "./cli-BtS9kKar.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 export { DEFAULT_LOCALE, DefaultTranslation, cli, define, lazy, parseArgs, resolveArgs };

package/lib/{renderer-kzo45gaB.js → renderer-CTx2DsBI.js}

@@ -1,4 +1,4 @@
-import { COMMON_ARGS, create, resolveArgKey, resolveBuiltInKey, resolveExamples } from "./utils-D41C8Abf.js";
+import { COMMON_ARGS, create, kebabnize, resolveArgKey, resolveBuiltInKey, resolveExamples } from "./utils-B_QNzw5q.js";
 
 //#region src/renderer/header.ts
 /**
@@ -187,8 +187,9 @@ function hasAllDefaultOptions(ctx) {
 function generateOptionsSymbols(ctx) {
 	return hasOptionalArgs(ctx) ? hasAllDefaultOptions(ctx) ? `[${ctx.translate(resolveBuiltInKey("OPTIONS"))}]` : `<${ctx.translate(resolveBuiltInKey("OPTIONS"))}>` : "";
 }
-function makeShortLongOptionPair(schema, name) {
-	let key = `--${name}`;
+function makeShortLongOptionPair(schema, name, toKebab) {
+	const displayName = toKebab || schema.toKebab ? kebabnize(name) : name;
+	let key = `--${displayName}`;
 	if (schema.short) key = `-${schema.short}, ${key}`;
 	return key;
 }
@@ -198,12 +199,18 @@ function makeShortLongOptionPair(schema, name) {
 * @returns Options pairs for usage
 */
 function getOptionalArgsPairs(ctx) {
-	return Object.entries(ctx.args).reduce((acc, [name, value]) => {
-		if (value.type === "positional") return acc;
-		let key = makeShortLongOptionPair(value, name);
-		if (value.type !== "boolean") key = value.default ? `${key} [${name}]` : `${key} <${name}>`;
+	return Object.entries(ctx.args).reduce((acc, [name, schema]) => {
+		if (schema.type === "positional") return acc;
+		let key = makeShortLongOptionPair(schema, name, ctx.toKebab);
+		if (schema.type !== "boolean") {
+			const displayName = ctx.toKebab || schema.toKebab ? kebabnize(name) : name;
+			key = schema.default ? `${key} [${displayName}]` : `${key} <${displayName}>`;
+		}
 		acc[name] = key;
-		if (value.type === "boolean" && value.negatable && !COMMON_ARGS_KEYS.includes(name)) acc[`no-${name}`] = `--no-${name}`;
+		if (schema.type === "boolean" && schema.negatable && !COMMON_ARGS_KEYS.includes(name)) {
+			const displayName = ctx.toKebab || schema.toKebab ? kebabnize(name) : name;
+			acc[`no-${name}`] = `--no-${displayName}`;
+		}
 		return acc;
 	}, create());
 }
@@ -217,7 +224,7 @@ function generateDefaultDisplayValue(ctx, schema) {
 function resolveDisplayValue(ctx, key) {
 	if (COMMON_ARGS_KEYS.includes(key)) return "";
 	const schema = ctx.args[key];
-	if ((schema.type === "boolean" || schema.type === "number" || schema.type === "string") && schema.default !== void 0) return `(${generateDefaultDisplayValue(ctx, schema)})`;
+	if ((schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "custom") && schema.default !== void 0) return `(${generateDefaultDisplayValue(ctx, schema)})`;
 	if (schema.type === "enum") {
 		const _default = schema.default !== void 0 ? generateDefaultDisplayValue(ctx, schema) : "";
 		const choices = `${ctx.translate(resolveBuiltInKey("CHOICES"))}: ${schema.choices.join(" | ")}`;
@@ -239,7 +246,7 @@ async function generateOptionalArgsUsage(ctx, optionsPairs) {
 		if (!rawDesc && key.startsWith("no-")) {
 			const name = resolveNegatableKey(key);
 			const schema = ctx.args[name];
-			const optionKey = makeShortLongOptionPair(schema, name);
+			const optionKey = makeShortLongOptionPair(schema, name, ctx.toKebab);
 			rawDesc = `${ctx.translate(resolveBuiltInKey("NEGATABLE"))} ${optionKey}`;
 		}
 		const optionsSchema = ctx.env.usageOptionType ? `[${resolveNegatableType(key, ctx)}] ` : "";

package/lib/renderer.d.ts

@@ -1,4 +1,4 @@
-import { CommandContext } from "./types-BDWiiycu.js";
+import { CommandContext } from "./types-B7j6WSjQ.js";
 import { Args } from "args-tokens";
 
 //#region src/renderer/header.d.ts

package/lib/renderer.js

@@ -1,4 +1,4 @@
-import "./utils-D41C8Abf.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-kzo45gaB.js";
+import "./utils-B_QNzw5q.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-CTx2DsBI.js";
 
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{types-BDWiiycu.d.ts → types-B7j6WSjQ.d.ts}

@@ -271,6 +271,11 @@ interface CommandContext<A extends Args = Args, V = ArgValues<A>> {
    * The command call mode is `entry` when the command is executed as an entry command, and `subCommand` when the command is executed as a sub-command.
    */
   callMode: CommandCallMode;
+  /**
+   * Whether to convert the camel-case style argument name to kebab-case.
+   * This context value is set from {@link Command.toKebab} option.
+   */
+  toKebab?: boolean;
   /**
    * Output a message.
    * If {@link CommandEnvironment.usageSilent} is true, the message is not output.
@@ -324,6 +329,11 @@ interface Command<A extends Args = Args> {
    * Command resource fetcher.
    */
   resource?: CommandResourceFetcher<A>;
+  /**
+   * Whether to convert the camel-case style argument name to kebab-case.
+   * If you will set to `true`, All {@link Command.args} names will be converted to kebab-case.
+   */
+  toKebab?: boolean;
 }
 /**
  * Command resource.

package/lib/{utils-D41C8Abf.js → utils-B_QNzw5q.js}

@@ -72,6 +72,14 @@ async function resolveLazyCommand(cmd, name, needRunResolving = false) {
 function resolveBuiltInKey(key) {
 	return `${BUILT_IN_PREFIX}${BUILT_IN_KEY_SEPARATOR}${key}`;
 }
+/**
+* Convert a camelCase string to kebab-case
+* @param str The string to convert
+* @returns The kebab-case version of the string
+*/
+function kebabnize(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
 function resolveArgKey(key) {
 	return `${ARG_PREFIX}${BUILT_IN_KEY_SEPARATOR}${key}`;
 }
@@ -100,4 +108,4 @@ function deepFreeze(obj) {
 }
 
 //#endregion
-export { ANONYMOUS_COMMAND_NAME, BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, COMMON_ARGS, DEFAULT_LOCALE as DEFAULT_LOCALE$1, NOOP, create, deepFreeze, isLazyCommand, log, mapResourceWithBuiltinKey, resolveArgKey, resolveBuiltInKey, resolveExamples, resolveLazyCommand };
+export { ANONYMOUS_COMMAND_NAME, BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, COMMON_ARGS, DEFAULT_LOCALE as DEFAULT_LOCALE$1, NOOP, create, deepFreeze, isLazyCommand, kebabnize, log, mapResourceWithBuiltinKey, resolveArgKey, resolveBuiltInKey, resolveExamples, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -78,7 +78,7 @@
     }
   },
   "dependencies": {
-    "args-tokens": "^0.18.0"
+    "args-tokens": "^0.19.0"
   },
   "devDependencies": {
     "@eslint/markdown": "^6.4.0",
@@ -86,13 +86,13 @@
     "@kazupon/eslint-config": "^0.29.0",
     "@kazupon/prettier-config": "^0.1.1",
     "@types/node": "^22.15.21",
-    "@typescript/native-preview": "7.0.0-dev.20250522.2",
-    "@vitest/eslint-plugin": "^1.2.0",
+    "@typescript/native-preview": "7.0.0-dev.20250526.1",
+    "@vitest/eslint-plugin": "^1.2.1",
     "bumpp": "^10.1.1",
     "deno": "^2.3.3",
     "eslint": "^9.27.0",
     "eslint-config-prettier": "^10.1.5",
-    "eslint-import-resolver-typescript": "^4.3.5",
+    "eslint-import-resolver-typescript": "^4.4.1",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsonc": "^2.20.1",
     "eslint-plugin-module-interop": "^0.3.1",
@@ -104,26 +104,27 @@
     "eslint-plugin-vue-composable": "^1.0.0",
     "eslint-plugin-yml": "^1.18.0",
     "gh-changelogen": "^0.2.8",
-    "gunshi019": "npm:gunshi@0.23.1",
+    "gunshi019": "npm:gunshi@0.19.0",
     "jsr": "^0.13.4",
     "jsr-exports-lint": "^0.4.0",
-    "knip": "^5.57.2",
+    "knip": "^5.58.0",
     "lint-staged": "^16.0.0",
     "messageformat": "4.0.0-12",
     "mitata": "^1.0.34",
     "pkg-pr-new": "^0.0.50",
     "prettier": "^3.5.3",
     "publint": "^0.3.12",
-    "tsdown": "^0.12.2",
+    "tsdown": "^0.12.3",
     "typedoc": "^0.28.4",
     "typedoc-plugin-markdown": "^4.6.3",
     "typedoc-vitepress-theme": "^1.1.2",
     "typescript-eslint": "^8.32.1",
     "vitepress": "^1.6.3",
     "vitepress-plugin-group-icons": "^1.5.5",
-    "vitepress-plugin-llms": "^1.3.3",
+    "vitepress-plugin-llms": "^1.3.4",
     "vitest": "^3.1.4",
-    "vue": "^3.5.14"
+    "vue": "^3.5.14",
+    "zod": "^3.25.28"
   },
   "prettier": "@kazupon/prettier-config",
   "lint-staged": {