gunshi 0.7.0 → 0.9.0

package/README.md

@@ -10,7 +10,7 @@
 
 Gunshi is a modern javascript command-line library
 
-> [!TIP]
+> [!TIP] <!-- eslint-disable-line markdown/no-missing-label-refs -->
 > 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".
 
 ## ✨ Features
@@ -64,7 +64,7 @@ import { cli } from 'gunshi'
 
 const args = process.argv.slice(2)
 // run a simple command
-cli(args, () => {
+await cli(args, () => {
   // something logic ...
   console.log('Hello from Gunshi!', args)
 })
@@ -103,7 +103,7 @@ const command = {
 
 // run a command that is defined above
 // (the 3rd argument of `cli` is the command option)
-cli(process.argv.slice(2), command, {
+await cli(process.argv.slice(2), command, {
   name: 'my-app',
   version: '1.0.0',
   description: 'My CLI application'
@@ -201,7 +201,7 @@ const mainCommand = {
 }
 
 // run the CLI with composable sub-commands
-cli(process.argv.slice(2), mainCommand, {
+await cli(process.argv.slice(2), mainCommand, {
   name: 'my-app',
   version: '1.0.0',
   subCommands
@@ -239,7 +239,7 @@ const subCommands = new Map()
 subCommands.set('lazy', lazyCommand)
 
 // run the CLI with lazy-loaded commands
-cli(
+await cli(
   process.argv.slice(2),
   { name: 'main', run: () => {} },
   {
@@ -281,7 +281,7 @@ const command = {
 }
 
 // run with --help to see the automatically generated usage information
-cli(process.argv.slice(2), command, {
+await cli(process.argv.slice(2), command, {
   name: 'my-app',
   version: '1.0.0'
 })
@@ -324,7 +324,7 @@ const customUsageRenderer = ctx => {
 }
 
 // run with custom renderers
-cli(
+await cli(
   process.argv.slice(2),
   { name: 'app', run: () => {} },
   {
@@ -371,7 +371,7 @@ const command = {
 }
 
 // run with locale support
-cli(process.argv.slice(2), command, {
+await cli(process.argv.slice(2), command, {
   name: 'my-app',
   version: '1.0.0',
   // set the locale via an environment variable
@@ -394,7 +394,8 @@ If you are interested in contributing to `gunshi`, I highly recommend checking o
 
 This project is inspired and powered by:
 
-- [`citty`](https://github.com/unjs/citty), created by UnJS team and contributors
+- [`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!

package/lib/{context-CEZVz8Dg.js → context-DeTM_Qpg.js}

@@ -1,4 +1,4 @@
-import { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, DEFAULT_LOCALE, create, deepFreeze, mapResourceWithBuiltinKey, resolveLazyCommand } from "./utils-B39blQOf.js";
+import { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, DEFAULT_LOCALE, NOOP, create, deepFreeze, log, mapResourceWithBuiltinKey, resolveLazyCommand } from "./utils-jm146hfy.js";
 
 //#region locales/en-US.json
 var COMMAND = "COMMAND";
@@ -22,6 +22,40 @@ var en_US_default = {
 	version
 };
 
+//#endregion
+//#region src/translation.ts
+function createTranslationAdapter(options) {
+	return new DefaultTranslation(options);
+}
+var DefaultTranslation = class {
+	#resources = new Map();
+	options;
+	constructor(options) {
+		this.options = options;
+		this.#resources = new Map();
+	}
+	getResource(locale) {
+		return this.#resources.get(locale);
+	}
+	setResource(locale, resource) {
+		this.#resources.set(locale, resource);
+	}
+	getMessage(locale, key) {
+		const resource = this.getResource(locale);
+		if (resource) return resource[key];
+		return void 0;
+	}
+	translate(locale, key, _values = create()) {
+		/**
+		* NOTE:
+		* DefaultTranslation support static message only
+		* If you want to resolve message with values and use the complex message format,
+		* you should inherit this class or implement your own translation adapter.
+		*/
+		return this.getMessage(locale, key) || this.getMessage(this.options.fallbackLocale, key);
+	}
+};
+
 //#endregion
 //#region src/context.ts
 const BUILT_IN_PREFIX_CODE = BUILT_IN_PREFIX.codePointAt(0);
@@ -48,8 +82,12 @@ async function createCommandContext({ options, values, positionals, command, com
 	*/
 	const env = Object.assign(create(), COMMAND_OPTIONS_DEFAULT, commandOptions);
 	const locale = resolveLocale(commandOptions.locale);
+	const translationAdapterFactory = commandOptions.translationAdapterFactory || createTranslationAdapter;
+	const adapter = translationAdapterFactory({
+		locale: locale.toString(),
+		fallbackLocale: DEFAULT_LOCALE
+	});
 	const localeResources = new Map();
-	const commandResources = new Map();
 	let builtInLoadedResources;
 	/**
 	* load the built-in locale resources
@@ -63,14 +101,12 @@ async function createCommandContext({ options, values, positionals, command, com
 	* define the translation function, which is used to {@link CommandContext.translate}.
 	*
 	*/
-	function translate(key) {
-		if (key.codePointAt(0) === BUILT_IN_PREFIX_CODE) {
+	function translate(key, values$1 = create()) {
+		const strKey = key;
+		if (strKey.codePointAt(0) === BUILT_IN_PREFIX_CODE) {
 			const resource = localeResources.get(locale.toString()) || localeResources.get(DEFAULT_LOCALE);
-			return resource[key] || key;
-		} else {
-			const resource = commandResources.get(locale.toString()) || commandResources.get(DEFAULT_LOCALE);
-			return resource[key] || "";
-		}
+			return resource[strKey] || strKey;
+		} else return adapter.translate(locale.toString(), strKey, values$1) || "";
 	}
 	/**
 	* load the sub commands
@@ -94,6 +130,7 @@ async function createCommandContext({ options, values, positionals, command, com
 		values: _values,
 		positionals,
 		usage,
+		log: commandOptions.usageSilent ? NOOP : log,
 		loadCommands,
 		translate
 	}));
@@ -110,7 +147,7 @@ async function createCommandContext({ options, values, positionals, command, com
 	}, create());
 	defaultCommandResource.description = command.description || "";
 	defaultCommandResource.examples = usage.examples || "";
-	commandResources.set(DEFAULT_LOCALE, defaultCommandResource);
+	adapter.setResource(DEFAULT_LOCALE, defaultCommandResource);
 	const originalResource = await loadCommandResource(ctx, command);
 	if (originalResource) {
 		const resource = Object.assign(create(), {
@@ -121,7 +158,7 @@ async function createCommandContext({ options, values, positionals, command, com
 			resource.help = builtInLoadedResources.help;
 			resource.version = builtInLoadedResources.version;
 		}
-		commandResources.set(locale.toString(), resource);
+		adapter.setResource(locale.toString(), resource);
 	}
 	return ctx;
 }
@@ -137,4 +174,4 @@ async function loadCommandResource(ctx, command) {
 }
 
 //#endregion
-export { createCommandContext };
+export { DefaultTranslation, createCommandContext };

package/lib/context.d.ts

@@ -1,5 +1,5 @@
 import { ArgOptions, ArgValues } from 'args-tokens';
-import { C as Command, a as CommandOptions, b as CommandContext } from './types.d-BvzTOO8I.js';
+import { C as Command, a as CommandOptions, b as CommandContext } from './types.d-Dp0YJQNw.js';
 
 /**
 * Parameters of {@link createCommandContext}

package/lib/context.js

@@ -1,4 +1,4 @@
-import { createCommandContext } from "./context-CEZVz8Dg.js";
-import "./utils-B39blQOf.js";
+import { createCommandContext } from "./context-DeTM_Qpg.js";
+import "./utils-jm146hfy.js";
 
 export { createCommandContext };

package/lib/index.d.ts

@@ -1,7 +1,7 @@
 import { ArgOptions } from 'args-tokens';
 export { ArgOptionSchema, ArgOptions, ArgValues } from 'args-tokens';
-import { C as Command, c as CommandRunner, a as CommandOptions } from './types.d-BvzTOO8I.js';
-export { f as CommandBuiltinKeys, d as CommandBuiltinOptionsKeys, e as CommandBuiltinResourceKeys, b as CommandContext, g as CommandEnvironment, h as CommandResource, i as CommandResourceFetcher, j as Commandable, G as GenerateNamespacedKey, L as LazyCommand } from './types.d-BvzTOO8I.js';
+import { C as Command, c as CommandRunner, a as CommandOptions, T as TranslationAdapter, d as TranslationAdapterFactoryOptions } from './types.d-Dp0YJQNw.js';
+export { g as CommandBuiltinKeys, e as CommandBuiltinOptionsKeys, f as CommandBuiltinResourceKeys, b as CommandContext, h as CommandEnvironment, i as CommandResource, j as CommandResourceFetcher, l as Commandable, G as GenerateNamespacedKey, L as LazyCommand, k as TranslationAdapterFactory } from './types.d-Dp0YJQNw.js';
 
 /**
 * Run the command
@@ -11,4 +11,14 @@ export { f as CommandBuiltinKeys, d as CommandBuiltinOptionsKeys, e as CommandBu
 */
 declare function cli<Options extends ArgOptions = ArgOptions>(args: string[], entry: Command<Options> | CommandRunner<Options>, opts?: CommandOptions<Options>): Promise<string | undefined>;
 
-export { Command, CommandOptions, CommandRunner, cli };
+declare class DefaultTranslation implements TranslationAdapter {
+	#private;
+	options: TranslationAdapterFactoryOptions;
+	constructor(options: TranslationAdapterFactoryOptions);
+	getResource(locale: string): Record<string, string> | undefined;
+	setResource(locale: string, resource: Record<string, string>): void;
+	getMessage(locale: string, key: string): string | undefined;
+	translate(locale: string, key: string, _values?: Record<string, unknown>): string | undefined;
+}
+
+export { Command, CommandOptions, CommandRunner, DefaultTranslation, TranslationAdapter, TranslationAdapterFactoryOptions, cli };

package/lib/index.js

@@ -1,6 +1,6 @@
-import { createCommandContext } from "./context-CEZVz8Dg.js";
-import { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, create, log, resolveLazyCommand } from "./utils-B39blQOf.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-CD-yc-xk.js";
+import { DefaultTranslation, createCommandContext } from "./context-DeTM_Qpg.js";
+import { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, create, resolveLazyCommand } from "./utils-jm146hfy.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-DIRwkoRd.js";
 import { parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/cli.ts
@@ -56,41 +56,41 @@ async function showUsage(ctx) {
 	if (ctx.env.renderUsage === null) return;
 	const usage = await (ctx.env.renderUsage || renderUsage)(ctx);
 	if (usage) {
-		log(usage);
+		ctx.log(usage);
 		return usage;
 	}
 }
 function showVersion(ctx) {
-	log(ctx.env.version);
+	ctx.log(ctx.env.version);
 }
 async function showHeader(ctx) {
 	if (ctx.env.renderHeader === null) return;
 	const header = await (ctx.env.renderHeader || renderHeader)(ctx);
 	if (header) {
-		log(header);
-		log();
+		ctx.log(header);
+		ctx.log();
 		return header;
 	}
 }
 async function showValidationErrors(ctx, error) {
 	if (ctx.env.renderValidationErrors === null) return;
 	const render = ctx.env.renderValidationErrors || renderValidationErrors;
-	log(await render(ctx, error));
+	ctx.log(await render(ctx, error));
 }
 async function resolveCommand(sub, entry, options) {
 	const omitted = !sub;
-	if (typeof entry === "function") return [undefined, {
+	if (typeof entry === "function") return [void 0, {
 		run: entry,
 		default: true
 	}];
-	else if (omitted) return typeof entry === "object" ? [entry.name, await resolveLazyCommand(entry, undefined, true)] : [undefined, undefined];
+	else if (omitted) return typeof entry === "object" ? [entry.name, await resolveLazyCommand(entry, void 0, true)] : [void 0, void 0];
 	else {
-		if (options.subCommands == null) return [sub, undefined];
+		if (options.subCommands == null) return [sub, void 0];
 		const cmd = options.subCommands?.get(sub);
-		if (cmd == null) return [sub, undefined];
+		if (cmd == null) return [sub, void 0];
 		return [sub, await resolveLazyCommand(cmd, sub)];
 	}
 }
 
 //#endregion
-export { cli };
+export { DefaultTranslation, cli };

package/lib/renderer/index.d.ts

@@ -1,5 +1,5 @@
 import { ArgOptions } from 'args-tokens';
-import { b as CommandContext } from '../types.d-BvzTOO8I.js';
+import { b as CommandContext } from '../types.d-Dp0YJQNw.js';
 
 /**
 * Render the header

package/lib/renderer/index.js

@@ -1,4 +1,4 @@
-import "../utils-B39blQOf.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "../renderer-CD-yc-xk.js";
+import "../utils-jm146hfy.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "../renderer-DIRwkoRd.js";
 
 export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{renderer-CD-yc-xk.js → renderer-DIRwkoRd.js}

@@ -1,4 +1,4 @@
-import { create, resolveBuiltInKey } from "./utils-B39blQOf.js";
+import { create, resolveBuiltInKey } from "./utils-jm146hfy.js";
 
 //#region src/renderer/header.ts
 function renderHeader(ctx) {

package/lib/{types.d-BvzTOO8I.d.ts → types.d-Dp0YJQNw.d.ts}

@@ -6,6 +6,7 @@ import { ArgOptions, ArgValues } from 'args-tokens';
 declare const DEFAULT_LOCALE = "en-US";
 declare const BUILT_IN_PREFIX = "_";
 declare const BUILT_IN_KEY_SEPARATOR = ":";
+declare const NOOP: () => void;
 type CommonOptionType = {
 	readonly help: {
 		readonly type: "boolean"
@@ -26,8 +27,9 @@ declare const __constants_COMMAND_BUILTIN_RESOURCE_KEYS: typeof COMMAND_BUILTIN_
 declare const __constants_COMMAND_OPTIONS_DEFAULT: typeof COMMAND_OPTIONS_DEFAULT;
 declare const __constants_COMMON_OPTIONS: typeof COMMON_OPTIONS;
 declare const __constants_DEFAULT_LOCALE: typeof DEFAULT_LOCALE;
+declare const __constants_NOOP: typeof NOOP;
 declare namespace __constants {
-  export { __constants_BUILT_IN_KEY_SEPARATOR as BUILT_IN_KEY_SEPARATOR, __constants_BUILT_IN_PREFIX as BUILT_IN_PREFIX, __constants_COMMAND_BUILTIN_RESOURCE_KEYS as COMMAND_BUILTIN_RESOURCE_KEYS, __constants_COMMAND_OPTIONS_DEFAULT as COMMAND_OPTIONS_DEFAULT, __constants_COMMON_OPTIONS as COMMON_OPTIONS, __constants_DEFAULT_LOCALE as DEFAULT_LOCALE };
+  export { __constants_BUILT_IN_KEY_SEPARATOR as BUILT_IN_KEY_SEPARATOR, __constants_BUILT_IN_PREFIX as BUILT_IN_PREFIX, __constants_COMMAND_BUILTIN_RESOURCE_KEYS as COMMAND_BUILTIN_RESOURCE_KEYS, __constants_COMMAND_OPTIONS_DEFAULT as COMMAND_OPTIONS_DEFAULT, __constants_COMMON_OPTIONS as COMMON_OPTIONS, __constants_DEFAULT_LOCALE as DEFAULT_LOCALE, __constants_NOOP as NOOP };
 }
 
 /**
@@ -98,6 +100,12 @@ interface CommandEnvironment<Options extends ArgOptions = ArgOptions> {
 	*/
 	usageOptionType: boolean;
 	/**
+	* Whether to display the command usage
+	* @default false
+	* @see {@link}
+	*/
+	usageSilent: boolean;
+	/**
 	* Sub commands
 	* @see {@link CommandOptions.subCommands}
 	*/
@@ -157,6 +165,10 @@ interface CommandOptions<Options extends ArgOptions = ArgOptions> {
 	*/
 	usageOptionType?: boolean;
 	/**
+	* Whether to display the command usage
+	*/
+	usageSilent?: boolean;
+	/**
 	* Render function the command usage
 	*/
 	renderUsage?: ((ctx: Readonly<CommandContext<Options>>) => Promise<string>) | null;
@@ -168,6 +180,11 @@ interface CommandOptions<Options extends ArgOptions = ArgOptions> {
 	* Render function the validation errors
 	*/
 	renderValidationErrors?: ((ctx: Readonly<CommandContext<Options>>, error: AggregateError) => Promise<string>) | null;
+	/**
+	* Translation adapter factory
+	* @experimental
+	*/
+	translationAdapterFactory?: TranslationAdapterFactory;
 }
 /**
 * Command context
@@ -221,6 +238,13 @@ interface CommandContext<
 	*/
 	usage: CommandUsage<Options>;
 	/**
+	* Output a message
+	* @description 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}
+	*/
+	log: (message?: any, ...optionalParams: any[]) => void;
+	/**
 	* Load sub-commands
 	* @description The loaded commands are cached and returned when called again
 	* @returns loaded commands
@@ -229,13 +253,14 @@ interface CommandContext<
 	/**
 	* Translate function
 	* @param key the key to be translated
+	* @param values the values to be formatted
 	* @returns A translated string
 	* @experimental
 	*/
 	translate: <
 		T extends string = CommandBuiltinKeys,
 		Key = CommandBuiltinKeys | keyof Options | T
-	>(key: Key) => string;
+	>(key: Key, values?: Record<string, unknown>) => string;
 }
 /**
 * Command usage
@@ -315,6 +340,59 @@ type CommandResource<Options extends ArgOptions = ArgOptions> = {
 */
 type CommandResourceFetcher<Options extends ArgOptions = ArgOptions> = (ctx: Readonly<CommandContext<Options>>) => Promise<CommandResource<Options>>;
 /**
+* Translation adapter factory
+*/
+type TranslationAdapterFactory = (options: TranslationAdapterFactoryOptions) => TranslationAdapter;
+/**
+* Translation adapter factory options
+*/
+interface TranslationAdapterFactoryOptions {
+	/**
+	* A locale
+	*/
+	locale: string;
+	/**
+	* A fallback locale
+	*/
+	fallbackLocale: string;
+}
+/**
+* Translation adapter
+*
+* @description
+* This adapter is used to custom message formatter like {@link https://github.com/intlify/vue-i18n/blob/master/spec/syntax.ebnf | Intlify message format}, {@link https://github.com/tc39/proposal-intl-messageformat | `Intl.MessageFormat` (MF2)}, and etc.
+* This adapter will support localization with your preferred message format
+*/
+interface TranslationAdapter<MessageResource = string> {
+	/**
+	* Get a resource of locale
+	* @param locale A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+	* @returns A resource of locale. if resource not found, return `undefined`
+	*/
+	getResource(locale: string): Record<string, string> | undefined;
+	/**
+	* Set a resource of locale
+	* @param locale A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+	* @param resource A resource of locale
+	*/
+	setResource(locale: string, resource: Record<string, string>): void;
+	/**
+	* Get a message of locale
+	* @param locale A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+	* @param key A key of message resource
+	* @returns A message of locale. if message not found, return `undefined`
+	*/
+	getMessage(locale: string, key: string): MessageResource | undefined;
+	/**
+	* Translate a message
+	* @param locale A Locale at the time of command execution. That is Unicord locale ID (BCP 47)
+	* @param key A key of message resource
+	* @param values A values to be resolved in the message
+	* @returns A translated message, if message is not translated, return `undefined`
+	*/
+	translate(locale: string, key: string, values?: Record<string, unknown>): string | undefined;
+}
+/**
 * Command runner
 * @param ctx A {@link CommandContext | command context}
 */
@@ -329,4 +407,4 @@ type LazyCommand<Options extends ArgOptions = ArgOptions> = () => Awaitable<Comm
 */
 type Commandable<Options extends ArgOptions> = Command<Options> | LazyCommand<Options>;
 
-export type { Command as C, GenerateNamespacedKey as G, LazyCommand as L, CommandOptions as a, CommandContext as b, CommandRunner as c, CommandBuiltinOptionsKeys as d, CommandBuiltinResourceKeys as e, CommandBuiltinKeys as f, CommandEnvironment as g, CommandResource as h, CommandResourceFetcher as i, Commandable as j };
+export type { Command as C, GenerateNamespacedKey as G, LazyCommand as L, TranslationAdapter as T, CommandOptions as a, CommandContext as b, CommandRunner as c, TranslationAdapterFactoryOptions as d, CommandBuiltinOptionsKeys as e, CommandBuiltinResourceKeys as f, CommandBuiltinKeys as g, CommandEnvironment as h, CommandResource as i, CommandResourceFetcher as j, TranslationAdapterFactory as k, Commandable as l };

package/lib/{utils-B39blQOf.js → utils-jm146hfy.js}

@@ -3,6 +3,7 @@
 const DEFAULT_LOCALE = "en-US";
 const BUILT_IN_PREFIX = "_";
 const BUILT_IN_KEY_SEPARATOR = ":";
+const NOOP = () => {};
 const COMMON_OPTIONS = {
 	help: {
 		type: "boolean",
@@ -14,17 +15,19 @@ const COMMON_OPTIONS = {
 	}
 };
 const COMMAND_OPTIONS_DEFAULT = {
-	name: undefined,
-	description: undefined,
-	version: undefined,
-	cwd: undefined,
-	subCommands: undefined,
+	name: void 0,
+	description: void 0,
+	version: void 0,
+	cwd: void 0,
+	usageSilent: false,
+	subCommands: void 0,
 	leftMargin: 2,
 	middleMargin: 10,
 	usageOptionType: false,
-	renderHeader: undefined,
-	renderUsage: undefined,
-	renderValidationErrors: undefined
+	renderHeader: void 0,
+	renderUsage: void 0,
+	renderValidationErrors: void 0,
+	translationAdapterFactory: void 0
 };
 
 //#endregion
@@ -59,4 +62,4 @@ function deepFreeze(obj) {
 }
 
 //#endregion
-export { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, DEFAULT_LOCALE, create, deepFreeze, log, mapResourceWithBuiltinKey, resolveBuiltInKey, resolveLazyCommand };
+export { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, DEFAULT_LOCALE, NOOP, create, deepFreeze, log, mapResourceWithBuiltinKey, resolveBuiltInKey, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -71,27 +71,34 @@
   },
   "devDependencies": {
     "@eslint/markdown": "^6.2.2",
-    "@kazupon/eslint-config": "^0.22.0",
+    "@intlify/core": "next",
+    "@kazupon/eslint-config": "^0.26.1",
     "@kazupon/prettier-config": "^0.1.1",
     "@types/node": "^22.13.9",
     "@vitest/eslint-plugin": "^1.1.36",
     "bumpp": "^10.0.3",
-    "eslint": "^9.21.0",
+    "eslint": "^9.22.0",
     "eslint-config-prettier": "^10.0.2",
+    "eslint-import-resolver-typescript": "^4.2.2",
+    "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsonc": "^2.19.1",
+    "eslint-plugin-module-interop": "^0.3.0",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-regexp": "^2.7.0",
     "eslint-plugin-unicorn": "^57.0.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
     "eslint-plugin-yml": "^1.17.0",
     "gh-changelogen": "^0.2.8",
     "jsr": "^0.13.4",
     "knip": "^5.45.0",
     "lint-staged": "^15.4.3",
+    "messageformat": "4.0.0-10",
     "pkg-pr-new": "^0.0.41",
     "prettier": "^3.5.3",
     "tsdown": "^0.6.4",
     "typescript": "^5.4.2",
     "typescript-eslint": "^8.26.0",
+    "vitepress": "^1.6.3",
     "vitest": "^3.0.7"
   },
   "prettier": "@kazupon/prettier-config",
@@ -114,6 +121,9 @@
     "clean": "git clean -df",
     "dev": "pnpx @eslint/config-inspector --config eslint.config.ts",
     "dev:eslint": "pnpx @eslint/config-inspector --config eslint.config.ts",
+    "docs:build": "vitepress build docs",
+    "docs:dev": "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",