gunshi 0.25.0 → 0.26.0

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

@@ -1,6 +1,6 @@
-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 { ANONYMOUS_COMMAND_NAME, COMMAND_OPTIONS_DEFAULT, COMMON_ARGS, create, isLazyCommand, resolveLazyCommand } from "./utils-D41C8Abf.js";
+import { createCommandContext } from "./context-D_EmfRNA.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-BzRfaLdJ.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/cli.ts

package/lib/{context-DT5PgSdv.js → context-D_EmfRNA.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-B_QNzw5q.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-D41C8Abf.js";
 
 //#region src/locales/en-US.json
 var COMMAND = "COMMAND";

package/lib/context.d.ts

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

package/lib/context.js

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

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

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

package/lib/definition.d.ts

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

package/lib/generator.d.ts

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

package/lib/generator.js

@@ -1,7 +1,7 @@
-import { create } from "./utils-B_QNzw5q.js";
-import "./context-DT5PgSdv.js";
-import "./renderer-CTx2DsBI.js";
-import { cli } from "./cli-BtS9kKar.js";
+import { create } from "./utils-D41C8Abf.js";
+import "./context-D_EmfRNA.js";
+import "./renderer-BzRfaLdJ.js";
+import { cli } from "./cli-DVGNVw3h.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-B7j6WSjQ.js";
-import { define$1 as define, lazy$1 as lazy } from "./definition-C3eTsvXE.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-DtEE4hKC.js";
+import { define$1 as define, lazy$1 as lazy } from "./definition-CKKX4Yvy.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-B_QNzw5q.js";
-import { DefaultTranslation } from "./context-DT5PgSdv.js";
+import { DEFAULT_LOCALE$1 as DEFAULT_LOCALE } from "./utils-D41C8Abf.js";
+import { DefaultTranslation } from "./context-D_EmfRNA.js";
 import { define, lazy } from "./definition-wq1Kmbvq.js";
-import "./renderer-CTx2DsBI.js";
-import { cli } from "./cli-BtS9kKar.js";
+import "./renderer-BzRfaLdJ.js";
+import { cli } from "./cli-DVGNVw3h.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 export { DEFAULT_LOCALE, DefaultTranslation, cli, define, lazy, parseArgs, resolveArgs };

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

@@ -1,4 +1,5 @@
-import { COMMON_ARGS, create, kebabnize, resolveArgKey, resolveBuiltInKey, resolveExamples } from "./utils-B_QNzw5q.js";
+import { COMMON_ARGS, create, resolveArgKey, resolveBuiltInKey, resolveExamples } from "./utils-D41C8Abf.js";
+import { kebabnize } from "args-tokens/utils";
 
 //#region src/renderer/header.ts
 /**

package/lib/renderer.d.ts

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

package/lib/renderer.js

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

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

@@ -281,6 +281,7 @@ interface CommandContext<A extends Args = Args, V = ArgValues<A>> {
    * If {@link CommandEnvironment.usageSilent} is true, the message is not output.
    * @param message an output message, @see {@link console.log}
    * @param optionalParams an optional parameters, @see {@link console.log}
+   * @internal
    */
   log: (message?: any, ...optionalParams: any[]) => void;
   /**

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

@@ -72,14 +72,6 @@ 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}`;
 }
@@ -108,4 +100,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, kebabnize, 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, log, mapResourceWithBuiltinKey, resolveArgKey, resolveBuiltInKey, resolveExamples, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -13,7 +13,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kazupon/gunshi.git"
+    "url": "git+https://github.com/kazupon/gunshi.git",
+    "directory": "packages/gunshi"
   },
   "keywords": [
     "command",
@@ -78,96 +79,21 @@
     }
   },
   "dependencies": {
-    "args-tokens": "^0.19.0"
+    "args-tokens": "^0.20.1"
   },
   "devDependencies": {
-    "@eslint/markdown": "^6.4.0",
     "@intlify/core": "next",
-    "@kazupon/eslint-config": "^0.29.0",
-    "@kazupon/prettier-config": "^0.1.1",
-    "@types/node": "^22.15.21",
-    "@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.4.1",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsonc": "^2.20.1",
-    "eslint-plugin-module-interop": "^0.3.1",
-    "eslint-plugin-promise": "^7.2.1",
-    "eslint-plugin-regexp": "^2.7.0",
-    "eslint-plugin-unicorn": "^58.0.0",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "eslint-plugin-vue": "^10.1.0",
-    "eslint-plugin-vue-composable": "^1.0.0",
-    "eslint-plugin-yml": "^1.18.0",
-    "gh-changelogen": "^0.2.8",
-    "gunshi019": "npm:gunshi@0.19.0",
     "jsr": "^0.13.4",
     "jsr-exports-lint": "^0.4.0",
-    "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.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.4",
-    "vitest": "^3.1.4",
-    "vue": "^3.5.14",
     "zod": "^3.25.28"
   },
-  "prettier": "@kazupon/prettier-config",
-  "lint-staged": {
-    "*.ts?(x)": [
-      "prettier --parser=typescript --write",
-      "eslint --fix"
-    ],
-    "*.{js,mjs,cjs}": [
-      "prettier --write",
-      "eslint --fix"
-    ],
-    "*.{json,jsonc,json5,md,yml,yaml}": [
-      "prettier --write"
-    ]
-  },
   "scripts": {
-    "bench:mitata": "node --expose-gc bench/mitata.js",
-    "bench:vitest": "vitest bench --run",
     "build": "tsdown",
-    "changelog": "gh-changelogen --repo=kazupon/gunshi",
-    "clean": "git clean -df",
-    "dev": "pnpx @eslint/config-inspector --config eslint.config.ts",
-    "dev:eslint": "pnpx @eslint/config-inspector --config eslint.config.ts",
-    "dev:typedoc": "typedoc --watch --preserveWatchOutput",
-    "docs:build": "pnpm run docs:build:typedoc && pnpm docs:build:vitepress",
-    "docs:build:typedoc": "typedoc --excludeInternal",
-    "docs:build:vitepress": "vitepress build docs",
-    "docs:dev": "pnpm run docs:build:typedoc && pnpm docs:dev:vitepress",
-    "docs:dev:vitepress": "vitepress dev docs",
-    "docs:preview": "vitepress preview docs",
-    "fix": "pnpm run --stream --color \"/^fix:/\"",
-    "fix:eslint": "eslint . --fix",
-    "fix:knip": "knip --fix --no-exit-code",
-    "fix:prettier": "prettier . --write",
-    "lint": "pnpm run --stream --color \"/^lint:/\"",
-    "lint:eslint": "eslint .",
     "lint:jsr": "jsr publish --dry-run --allow-dirty",
-    "lint:knip": "knip",
-    "lint:prettier": "prettier . --check",
-    "release": "bumpp --commit \"release: v%s\" --all --push --tag",
-    "test": "vitest --typecheck run",
-    "typecheck": "pnpm run --stream --color \"/^typecheck:/\"",
-    "typecheck:deno": "deno check --all ./src",
-    "typecheck:tsc": "tsgo --noEmit"
+    "typecheck:deno": "deno check --all ./src"
   }
 }

package/README.md

@@ -1,142 +0,0 @@
-<p align="center">
-	<img width="196" src="./assets/logo.png">
-</p>
-<h1 align="center">🏯 Gunshi</h1>
-
-[![Version][npm-version-src]][npm-version-href]
-[![CI][ci-src]][ci-href]
-[![InstallSize][install-size-src]][install-size-src]
-[![JSR][jsr-src]][jsr-href]
-
-Gunshi is a modern javascript command-line library
-
-<!-- eslint-disable markdown/no-missing-label-refs -->
-
-> [!TIP]
-> gunshi (軍師) is a position in ancient Japanese samurai battle in which a samurai devised strategies and gave orders. That name is inspired by the word "command".
-
-<!-- eslint-enable markdown/no-missing-label-refs -->
-
-## ✨ Features
-
-Gunshi is designed to simplify the creation of modern command-line interfaces:
-
-- 📏 **Simple & Universal**: Run the commands with simple API and support universal runtime.
-- ⚙️ **Declarative configuration**: Configure command modules declaratively for better organization and maintainability.
-- 🛡️ **Type Safe**: TypeScript support with type-safe argument parsing and option resolution by [args-tokens](https://github.com/kazupon/args-tokens)
-- 🧩 **Composable**: Create modular sub-commands that can be composed together for complex CLIs.
-- ⏳ **Lazy & Async**: Load command modules lazily and execute them asynchronously for better performance.
-- 📜 **Auto usage generation**: Generate helpful usage messages automatically for your commands.
-- 🎨 **Custom usage generation**: Customize how usage messages are generated to match your CLI's style.
-- 🌍 **Internationalization**: Support multiple languages with built-in i18n, locale resource lazy loading and i18n library integration.
-
-## 💿 Installation
-
-```sh
-# npm
-npm install --save gunshi
-
-## pnpm
-pnpm add gunshi
-
-## yarn
-yarn add gunshi
-
-## deno
-deno add jsr:@kazupon/gunshi
-
-## bun
-bun add gunshi
-```
-
-## 🚀 Usage
-
-```js
-import { cli } from 'gunshi'
-
-// define a command with declarative configuration, using commandable object
-const command = {
-  name: 'greet',
-  description: 'A greeting command',
-  options: {
-    name: {
-      type: 'string',
-      short: 'n',
-      description: 'Name to greet'
-    },
-    greeting: {
-      type: 'string',
-      short: 'g',
-      default: 'Hello',
-      description: 'Greeting to use (default: "Hello")'
-    },
-    times: {
-      type: 'number',
-      short: 't',
-      default: 1,
-      description: 'Number of times to repeat the greeting (default: 1)'
-    }
-  },
-  run: ctx => {
-    const { name = 'World', greeting, times } = ctx.values
-    for (let i = 0; i < times; i++) {
-      console.log(`${greeting}, ${name}!`)
-    }
-  }
-}
-
-// run a command that is defined above
-// (the 3rd argument of `cli` is the command option)
-await cli(process.argv.slice(2), command, {
-  name: 'my-app',
-  version: '1.0.0',
-  description: 'My CLI application'
-})
-```
-
-About more details and usage, see [documentations](https://gunshi.dev)
-
-## 💁‍♀️ Showcases
-
-- [pnpmc](https://github.com/kazupon/pnpmc): PNPM Catalogs Tooling
-- [sourcemap-publisher](https://github.com/es-tooling/sourcemap-publisher): A tool to publish sourcemaps externally and rewrite sourcemap URLs at pre-publish time
-- [curxy](https://github.com/ryoppippi/curxy): An proxy worker for using ollama in cursor
-
-## 🙌 Contributing guidelines
-
-If you are interested in contributing to `gunshi`, I highly recommend checking out [the contributing guidelines](/CONTRIBUTING.md) here. You'll find all the relevant information such as [how to make a PR](/CONTRIBUTING.md#pull-request-guidelines), [how to setup development](/CONTRIBUTING.md#development-setup)) etc., there.
-
-## 💖 Credits
-
-This project is inspired and powered by:
-
-- [`citty`](https://github.com/unjs/citty), created by [UnJS team](https://github.com/unjs) and contributors
-- [`ordana`](https://github.com/sapphi-red/ordana), createdy by [sapphi-red](https://github.com/sapphi-red), inspired documentation generation
-- cline and claude 3.7 sonnet, examples and docs is generated
-
-Thank you!
-
-## 🤝 Sponsors
-
-The development of Gunshi is supported by my OSS sponsors!
-
-<p align="center">
-  <a href="https://cdn.jsdelivr.net/gh/kazupon/sponsors/sponsors.svg">
-    <img src='https://cdn.jsdelivr.net/gh/kazupon/sponsors/sponsors.svg'/>
-  </a>
-</p>
-
-## ©️ License
-
-[MIT](http://opensource.org/licenses/MIT)
-
-<!-- Badges -->
-
-[npm-version-src]: https://img.shields.io/npm/v/gunshi?style=flat
-[npm-version-href]: https://npmjs.com/package/gunshi
-[jsr-src]: https://jsr.io/badges/@kazupon/gunshi
-[jsr-href]: https://jsr.io/@kazupon/gunshi
-[install-size-src]: https://pkg-size.dev/badge/install/72346
-[install-size-href]: https://pkg-size.dev/gunshi
-[ci-src]: https://github.com/kazupon/gunshi/actions/workflows/ci.yml/badge.svg
-[ci-href]: https://github.com/kazupon/gunshi/actions/workflows/ci.yml