gunshi 0.6.1 → 0.7.0

package/README.md

@@ -317,7 +317,7 @@ const customUsageRenderer = ctx => {
 
   for (const [key, option] of Object.entries(ctx.options || Object.create(null))) {
     const shortFlag = option.short ? `-${option.short}, ` : '    '
-    lines.push(`  ${shortFlag}--${key.padEnd(10)} ${ctx.translation(key)}`)
+    lines.push(`  ${shortFlag}--${key.padEnd(10)} ${ctx.translate(key)}`)
   }
 
   return Promise.resolve(lines.join('\n'))
@@ -365,7 +365,7 @@ const command = {
   },
   run: ctx => {
     const { name = 'World', formal } = ctx.values
-    const greeting = formal ? ctx.translation('formal') : ctx.translation('informal')
+    const greeting = formal ? ctx.translate('formal_greeting') : ctx.translate('informal_greeting')
     console.log(`${greeting}, ${name}!`)
   }
 }

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

@@ -1,4 +1,4 @@
-import { create, deepFreeze, resolveLazyCommand } from "./utils-NHs5DuHk.js";
+import { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, DEFAULT_LOCALE, create, deepFreeze, mapResourceWithBuiltinKey, resolveLazyCommand } from "./utils-B39blQOf.js";
 
 //#region locales/en-US.json
 var COMMAND = "COMMAND";
@@ -22,49 +22,14 @@ var en_US_default = {
 	version
 };
 
-//#endregion
-//#region src/constants.ts
-const COMMON_OPTIONS = {
-	help: {
-		type: "boolean",
-		short: "h"
-	},
-	version: {
-		type: "boolean",
-		short: "v"
-	}
-};
-const COMMAND_OPTIONS_DEFAULT = {
-	name: undefined,
-	description: undefined,
-	version: undefined,
-	cwd: undefined,
-	subCommands: undefined,
-	leftMargin: 2,
-	middleMargin: 10,
-	usageOptionType: false,
-	renderHeader: undefined,
-	renderUsage: undefined,
-	renderValidationErrors: undefined
-};
-const COMMAND_I18N_RESOURCE_KEYS = [
-	"USAGE",
-	"COMMAND",
-	"SUBCOMMAND",
-	"COMMANDS",
-	"OPTIONS",
-	"EXAMPLES",
-	"FORMORE"
-];
-
 //#endregion
 //#region src/context.ts
-const DEFAULT_LOCALE = "en-US";
+const BUILT_IN_PREFIX_CODE = BUILT_IN_PREFIX.codePointAt(0);
 async function createCommandContext({ options, values, positionals, command, commandOptions, omitted = false }) {
 	/**
 	* tweak the options and values
 	*/
-	const _options = options == null ? undefined : Object.entries(options).reduce((acc, [key, value]) => {
+	const _options = Object.entries(options).reduce((acc, [key, value]) => {
 		acc[key] = Object.assign(create(), value);
 		return acc;
 	}, create());
@@ -89,17 +54,17 @@ async function createCommandContext({ options, values, positionals, command, com
 	/**
 	* load the built-in locale resources
 	*/
-	localeResources.set(DEFAULT_LOCALE, en_US_default);
+	localeResources.set(DEFAULT_LOCALE, mapResourceWithBuiltinKey(en_US_default));
 	if (DEFAULT_LOCALE !== locale.toString()) try {
 		builtInLoadedResources = await import(`../locales/${locale.toString()}.json`, { with: { type: "json" } });
-		localeResources.set(locale.toString(), builtInLoadedResources);
+		localeResources.set(locale.toString(), mapResourceWithBuiltinKey(builtInLoadedResources));
 	} catch {}
 	/**
-	* define the translation function, which is used to {@link CommandContext.translation}.
+	* define the translation function, which is used to {@link CommandContext.translate}.
 	*
 	*/
-	function translation(key) {
-		if (COMMAND_I18N_RESOURCE_KEYS.includes(key)) {
+	function translate(key) {
+		if (key.codePointAt(0) === BUILT_IN_PREFIX_CODE) {
 			const resource = localeResources.get(locale.toString()) || localeResources.get(DEFAULT_LOCALE);
 			return resource[key] || key;
 		} else {
@@ -130,7 +95,7 @@ async function createCommandContext({ options, values, positionals, command, com
 		positionals,
 		usage,
 		loadCommands,
-		translation
+		translate
 	}));
 	/**
 	* load the command resources
@@ -148,13 +113,10 @@ async function createCommandContext({ options, values, positionals, command, com
 	commandResources.set(DEFAULT_LOCALE, defaultCommandResource);
 	const originalResource = await loadCommandResource(ctx, command);
 	if (originalResource) {
-		const resource = Object.entries(originalResource.options).reduce((res, [key, value]) => {
-			res[key] = value;
-			return res;
-		}, Object.assign(create(), {
+		const resource = Object.assign(create(), {
 			description: originalResource.description,
 			examples: originalResource.examples
-		}));
+		}, originalResource);
 		if (builtInLoadedResources) {
 			resource.help = builtInLoadedResources.help;
 			resource.version = builtInLoadedResources.version;
@@ -175,4 +137,4 @@ async function loadCommandResource(ctx, command) {
 }
 
 //#endregion
-export { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, DEFAULT_LOCALE, createCommandContext };
+export { createCommandContext };

package/lib/context.d.ts

@@ -1,10 +1,6 @@
 import { ArgOptions, ArgValues } from 'args-tokens';
-import { C as Command, a as CommandOptions, b as CommandContext } from './types.d-CxaX4FVV.js';
+import { C as Command, a as CommandOptions, b as CommandContext } from './types.d-BvzTOO8I.js';
 
-/**
-* The default locale string, which format is BCP 47 language tag
-*/
-declare const DEFAULT_LOCALE = "en-US";
 /**
 * Parameters of {@link createCommandContext}
 */
@@ -15,7 +11,7 @@ interface CommandContextParams<
 	/**
 	* An options of target command
 	*/
-	options: Options | undefined;
+	options: Options;
 	/**
 	* A values of target command
 	*/
@@ -47,4 +43,4 @@ declare function createCommandContext<
 	Values = ArgValues<Options>
 >({ options, values, positionals, command, commandOptions, omitted }: CommandContextParams<Options, Values>): Promise<Readonly<CommandContext<Options, Values>>>;
 
-export { DEFAULT_LOCALE, createCommandContext };
+export { createCommandContext };

package/lib/context.js

@@ -1,4 +1,4 @@
-import { DEFAULT_LOCALE, createCommandContext } from "./context-DmZAeiph.js";
-import "./utils-NHs5DuHk.js";
+import { createCommandContext } from "./context-CEZVz8Dg.js";
+import "./utils-B39blQOf.js";
 
-export { DEFAULT_LOCALE, createCommandContext };
+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-CxaX4FVV.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, L as LazyCommand } from './types.d-CxaX4FVV.js';
+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';
 
 /**
 * Run the command

package/lib/index.js

@@ -1,16 +1,15 @@
-import { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, createCommandContext } from "./context-DmZAeiph.js";
-import { create, log, resolveLazyCommand } from "./utils-NHs5DuHk.js";
-import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-v5Uq0km9.js";
+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 { parseArgs, resolveArgs } from "args-tokens";
 
 //#region src/cli.ts
 async function cli(args, entry, opts = {}) {
 	const tokens = parseArgs(args);
 	const subCommand = getSubCommand(tokens);
-	const resolvedCommandOptions = resolveCommandOptions(opts);
+	const resolvedCommandOptions = resolveCommandOptions(opts, entry);
 	const [name, command] = await resolveCommand(subCommand, entry, resolvedCommandOptions);
 	if (!command) throw new Error(`Command not found: ${name || ""}`);
-	if (command.name && !resolvedCommandOptions.subCommands.has(command.name)) resolvedCommandOptions.subCommands.set(command.name, command);
 	const options = resolveArgOptions(command.options);
 	const { values, positionals, error } = resolveArgs(options, tokens);
 	const omitted = !subCommand;
@@ -20,7 +19,7 @@ async function cli(args, entry, opts = {}) {
 		positionals,
 		omitted,
 		command,
-		commandOptions: opts
+		commandOptions: resolvedCommandOptions
 	});
 	if (values.version) {
 		showVersion(ctx);
@@ -43,9 +42,11 @@ async function cli(args, entry, opts = {}) {
 function resolveArgOptions(options) {
 	return Object.assign(create(), options, COMMON_OPTIONS);
 }
-function resolveCommandOptions(options) {
+function resolveCommandOptions(options, entry) {
 	const subCommands = new Map(options.subCommands);
-	return Object.assign(create(), COMMAND_OPTIONS_DEFAULT, { subCommands }, options);
+	if (typeof entry === "object" && entry.name) subCommands.set(entry.name, entry);
+	const resolvedOptions = Object.assign(create(), COMMAND_OPTIONS_DEFAULT, options, { subCommands });
+	return resolvedOptions;
 }
 function getSubCommand(tokens) {
 	const firstToken = tokens[0];

package/lib/renderer/index.d.ts

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

package/lib/renderer/index.js

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

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

@@ -1,4 +1,4 @@
-import { create } from "./utils-NHs5DuHk.js";
+import { create, resolveBuiltInKey } from "./utils-B39blQOf.js";
 
 //#region src/renderer/header.ts
 function renderHeader(ctx) {
@@ -27,9 +27,8 @@ async function renderUsage(ctx) {
 */
 async function renderOptionsSection(ctx) {
 	const messages = [];
-	messages.push(`${ctx.translation("OPTIONS")}:`);
-	const optionsPairs = getOptionsPairs(ctx);
-	messages.push(await generateOptionsUsage(ctx, optionsPairs));
+	messages.push(`${ctx.translate(resolveBuiltInKey("OPTIONS"))}:`);
+	messages.push(await generateOptionsUsage(ctx, getOptionsPairs(ctx)));
 	return messages;
 }
 /**
@@ -40,7 +39,7 @@ async function renderOptionsSection(ctx) {
 function renderExamplesSection(ctx) {
 	const messages = [];
 	const examples = ctx.usage.examples.split("\n").map((example) => example.padStart(ctx.env.leftMargin + example.length));
-	messages.push(`${ctx.translation("EXAMPLES")}:`, ...examples);
+	messages.push(`${ctx.translate(resolveBuiltInKey("EXAMPLES"))}:`, ...examples);
 	return messages;
 }
 /**
@@ -49,12 +48,12 @@ function renderExamplesSection(ctx) {
 * @returns A rendered usage section
 */
 async function renderUsageSection(ctx) {
-	const messages = [`${ctx.translation("USAGE")}:`];
+	const messages = [`${ctx.translate(resolveBuiltInKey("USAGE"))}:`];
 	if (ctx.omitted) {
-		const defaultCommand = `${resolveEntry(ctx)}${await hasCommands(ctx) ? ` [${resolveSubCommand(ctx)}]` : ""} ${hasOptions(ctx) ? `<${ctx.translation("OPTIONS")}>` : ""} `;
+		const defaultCommand = `${resolveEntry(ctx)}${await hasCommands(ctx) ? ` [${resolveSubCommand(ctx)}]` : ""} ${hasOptions(ctx) ? `<${ctx.translate(resolveBuiltInKey("OPTIONS"))}>` : ""} `;
 		messages.push(defaultCommand.padStart(ctx.env.leftMargin + defaultCommand.length));
 		if (await hasCommands(ctx)) {
-			const commandsUsage = `${resolveEntry(ctx)} <${ctx.translation("COMMANDS")}>`;
+			const commandsUsage = `${resolveEntry(ctx)} <${ctx.translate(resolveBuiltInKey("COMMANDS"))}>`;
 			messages.push(commandsUsage.padStart(ctx.env.leftMargin + commandsUsage.length));
 		}
 	} else {
@@ -69,7 +68,7 @@ async function renderUsageSection(ctx) {
 * @returns A rendered commands section
 */
 async function renderCommandsSection(ctx) {
-	const messages = [`${ctx.translation("COMMANDS")}:`];
+	const messages = [`${ctx.translate(resolveBuiltInKey("COMMANDS"))}:`];
 	const loadedCommands = await ctx.loadCommands();
 	const commandMaxLength = Math.max(...loadedCommands.map((cmd) => (cmd.name || "").length));
 	const commandsStr = await Promise.all(loadedCommands.map((cmd) => {
@@ -78,7 +77,7 @@ async function renderCommandsSection(ctx) {
 		const command = `${key.padEnd(commandMaxLength + ctx.env.middleMargin)}${desc} `;
 		return `${command.padStart(ctx.env.leftMargin + command.length)} `;
 	}));
-	messages.push(...commandsStr, "", ctx.translation("FORMORE"));
+	messages.push(...commandsStr, "", ctx.translate(resolveBuiltInKey("FORMORE")));
 	messages.push(...loadedCommands.map((cmd) => {
 		const commandHelp = `${ctx.env.name} ${cmd.name} --help`;
 		return `${commandHelp.padStart(ctx.env.leftMargin + commandHelp.length)}`;
@@ -91,7 +90,7 @@ async function renderCommandsSection(ctx) {
 * @returns The entry command name
 */
 function resolveEntry(ctx) {
-	return ctx.env.name || ctx.translation("COMMAND");
+	return ctx.env.name || ctx.translate(resolveBuiltInKey("COMMAND"));
 }
 /**
 * Resolve the sub command name
@@ -99,7 +98,7 @@ function resolveEntry(ctx) {
 * @returns The sub command name
 */
 function resolveSubCommand(ctx) {
-	return ctx.name || ctx.translation("SUBCOMMAND");
+	return ctx.name || ctx.translate(resolveBuiltInKey("SUBCOMMAND"));
 }
 /**
 * Resolve the command description
@@ -107,7 +106,7 @@ function resolveSubCommand(ctx) {
 * @returns resolved command description
 */
 function resolveDescription(ctx) {
-	return ctx.translation("description") || ctx.description || "";
+	return ctx.translate("description") || ctx.description || "";
 }
 /**
 * Check if the command has sub commands
@@ -148,7 +147,7 @@ function hasAllDefaultOptions(ctx) {
 * @returns Options symbols for usage
 */
 function generateOptionsSymbols(ctx) {
-	return hasOptions(ctx) ? hasAllDefaultOptions(ctx) ? `[${ctx.translation("OPTIONS")}]` : `<${ctx.translation("OPTIONS")}>` : "";
+	return hasOptions(ctx) ? hasAllDefaultOptions(ctx) ? `[${ctx.translate("_:OPTIONS")}]` : `<${ctx.translate("_:OPTIONS")}>` : "";
 }
 /**
 * Get options pairs for usage
@@ -174,7 +173,7 @@ async function generateOptionsUsage(ctx, optionsPairs) {
 	const optionsMaxLength = Math.max(...Object.entries(optionsPairs).map(([_, value]) => value.length));
 	const optionSchemaMaxLength = ctx.env.usageOptionType ? Math.max(...Object.entries(optionsPairs).map(([key, _]) => ctx.options[key].type.length)) : 0;
 	const usages = await Promise.all(Object.entries(optionsPairs).map(([key, value]) => {
-		const rawDesc = ctx.translation(key);
+		const rawDesc = ctx.translate(key);
 		const optionsSchema = ctx.env.usageOptionType ? `[${ctx.options[key].type}] ` : "";
 		const desc = `${optionsSchema ? optionsSchema.padEnd(optionSchemaMaxLength + 3) : ""}${rawDesc}`;
 		const option = `${value.padEnd(optionsMaxLength + ctx.env.middleMargin)}${desc}`;

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

@@ -1,5 +1,11 @@
 import { ArgOptions, ArgValues } from 'args-tokens';
 
+/**
+* The default locale string, which format is BCP 47 language tag
+*/
+declare const DEFAULT_LOCALE = "en-US";
+declare const BUILT_IN_PREFIX = "_";
+declare const BUILT_IN_KEY_SEPARATOR = ":";
 type CommonOptionType = {
 	readonly help: {
 		readonly type: "boolean"
@@ -12,19 +18,26 @@ type CommonOptionType = {
 };
 declare const COMMON_OPTIONS: CommonOptionType;
 declare const COMMAND_OPTIONS_DEFAULT: CommandOptions<ArgOptions>;
-declare const COMMAND_I18N_RESOURCE_KEYS: readonly ["USAGE", "COMMAND", "SUBCOMMAND", "COMMANDS", "OPTIONS", "EXAMPLES", "FORMORE"];
+declare const COMMAND_BUILTIN_RESOURCE_KEYS: readonly ["USAGE", "COMMAND", "SUBCOMMAND", "COMMANDS", "OPTIONS", "EXAMPLES", "FORMORE"];
 
-declare const __constants_COMMAND_I18N_RESOURCE_KEYS: typeof COMMAND_I18N_RESOURCE_KEYS;
+declare const __constants_BUILT_IN_KEY_SEPARATOR: typeof BUILT_IN_KEY_SEPARATOR;
+declare const __constants_BUILT_IN_PREFIX: typeof BUILT_IN_PREFIX;
+declare const __constants_COMMAND_BUILTIN_RESOURCE_KEYS: typeof COMMAND_BUILTIN_RESOURCE_KEYS;
 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 namespace __constants {
-  export { __constants_COMMAND_I18N_RESOURCE_KEYS as COMMAND_I18N_RESOURCE_KEYS, __constants_COMMAND_OPTIONS_DEFAULT as COMMAND_OPTIONS_DEFAULT, __constants_COMMON_OPTIONS as COMMON_OPTIONS };
+  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 };
 }
 
 /**
 * Define a promise type that can be await from T
 */
 type Awaitable<T> = T | Promise<T>;
+type GenerateNamespacedKey<
+	Key extends string,
+	Prefixed extends string = typeof BUILT_IN_PREFIX
+> = `${Prefixed}${typeof BUILT_IN_KEY_SEPARATOR}${Key}`;
 /**
 * Command i18n built-in options keys
 * @experimental
@@ -34,13 +47,13 @@ type CommandBuiltinOptionsKeys = keyof (typeof __constants)["COMMON_OPTIONS"];
 * Command i18n built-in resource keys
 * @experimental
 */
-type CommandBuiltinResourceKeys = (typeof __constants)["COMMAND_I18N_RESOURCE_KEYS"][number];
+type CommandBuiltinResourceKeys = (typeof __constants)["COMMAND_BUILTIN_RESOURCE_KEYS"][number];
 /**
 * Command i18n built-in keys
-* @description The command i18n built-in keys are used to {@link CommandContext.translation | translate} function
+* @description The command i18n built-in keys are used to {@link CommandContext.translate | translate} function
 * @experimental
 */
-type CommandBuiltinKeys = CommandBuiltinOptionsKeys | CommandBuiltinResourceKeys | "description" | "examples";
+type CommandBuiltinKeys = GenerateNamespacedKey<CommandBuiltinOptionsKeys> | GenerateNamespacedKey<CommandBuiltinResourceKeys> | "description" | "examples";
 /**
 * Command environment
 */
@@ -187,7 +200,7 @@ interface CommandContext<
 	* Command options, that is the options of the command that is executed
 	* @description The command options is same {@link Command.options}
 	*/
-	options: Options | undefined;
+	options: Options;
 	/**
 	* Command values, that is the values of the command that is executed
 	* @description Resolve values with `resolveArgs` from command arguments and {@link Command.options}
@@ -214,14 +227,14 @@ interface CommandContext<
 	*/
 	loadCommands: () => Promise<Command<Options>[]>;
 	/**
-	* Translation function
+	* Translate function
 	* @param key the key to be translated
 	* @returns A translated string
 	* @experimental
 	*/
-	translation: <
-		T = CommandBuiltinKeys,
-		Key = CommandBuiltinKeys | T
+	translate: <
+		T extends string = CommandBuiltinKeys,
+		Key = CommandBuiltinKeys | keyof Options | T
 	>(key: Key) => string;
 }
 /**
@@ -282,20 +295,18 @@ interface Command<Options extends ArgOptions = ArgOptions> {
 * Command resource
 * @experimental
 */
-interface CommandResource<Options extends ArgOptions = ArgOptions> {
+type CommandResource<Options extends ArgOptions = ArgOptions> = {
 	/**
 	* Command description
 	*/
-	description: string;
-	/**
-	* Options usage
-	*/
-	options: { [Option in keyof Options] : string };
+	description: string
 	/**
 	* Examples usage
 	*/
-	examples: string;
-}
+	examples: string
+} & { [Option in keyof Options] : string } & {
+	[key: string]: string
+};
 /**
 * Command resource fetcher
 * @param ctx A {@link CommandContext | command context}
@@ -318,4 +329,4 @@ type LazyCommand<Options extends ArgOptions = ArgOptions> = () => Awaitable<Comm
 */
 type Commandable<Options extends ArgOptions> = Command<Options> | LazyCommand<Options>;
 
-export type { Command as C, 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, 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 };

package/lib/utils-B39blQOf.js

@@ -0,0 +1,62 @@
+
+//#region src/constants.ts
+const DEFAULT_LOCALE = "en-US";
+const BUILT_IN_PREFIX = "_";
+const BUILT_IN_KEY_SEPARATOR = ":";
+const COMMON_OPTIONS = {
+	help: {
+		type: "boolean",
+		short: "h"
+	},
+	version: {
+		type: "boolean",
+		short: "v"
+	}
+};
+const COMMAND_OPTIONS_DEFAULT = {
+	name: undefined,
+	description: undefined,
+	version: undefined,
+	cwd: undefined,
+	subCommands: undefined,
+	leftMargin: 2,
+	middleMargin: 10,
+	usageOptionType: false,
+	renderHeader: undefined,
+	renderUsage: undefined,
+	renderValidationErrors: undefined
+};
+
+//#endregion
+//#region src/utils.ts
+async function resolveLazyCommand(cmd, name, entry = false) {
+	const resolved = Object.assign(create(), typeof cmd == "function" ? await cmd() : cmd, { default: entry });
+	if (resolved.name == null && name) resolved.name = name;
+	return deepFreeze(resolved);
+}
+function resolveBuiltInKey(key) {
+	return `${BUILT_IN_PREFIX}${BUILT_IN_KEY_SEPARATOR}${key}`;
+}
+function mapResourceWithBuiltinKey(resource) {
+	return Object.entries(resource).reduce((acc, [key, value]) => {
+		acc[resolveBuiltInKey(key)] = value;
+		return acc;
+	}, create());
+}
+function create(obj = null) {
+	return Object.create(obj);
+}
+function log(...args) {
+	console.log(...args);
+}
+function deepFreeze(obj) {
+	if (obj === null || typeof obj !== "object") return obj;
+	for (const key of Object.keys(obj)) {
+		const value = obj[key];
+		if (typeof value === "object" && value !== null) deepFreeze(value);
+	}
+	return Object.freeze(obj);
+}
+
+//#endregion
+export { BUILT_IN_PREFIX, COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, DEFAULT_LOCALE, create, deepFreeze, log, mapResourceWithBuiltinKey, resolveBuiltInKey, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"

package/lib/utils-NHs5DuHk.js

@@ -1,24 +0,0 @@
-
-//#region src/utils.ts
-async function resolveLazyCommand(cmd, name, entry = false) {
-	const resolved = Object.assign(create(), typeof cmd == "function" ? await cmd() : cmd, { default: entry });
-	if (resolved.name == null && name) resolved.name = name;
-	return deepFreeze(resolved);
-}
-function create(obj = null) {
-	return Object.create(obj);
-}
-function log(...args) {
-	console.log(...args);
-}
-function deepFreeze(obj) {
-	if (obj === null || typeof obj !== "object") return obj;
-	for (const key of Object.keys(obj)) {
-		const value = obj[key];
-		if (typeof value === "object" && value !== null) deepFreeze(value);
-	}
-	return Object.freeze(obj);
-}
-
-//#endregion
-export { create, deepFreeze, log, resolveLazyCommand };