gunshi 0.2.0 → 0.2.1

package/lib/context-BQKZW5bg.js

@@ -0,0 +1,177 @@
+import { create, deepFreeze, resolveLazyCommand } from "./utils-NHs5DuHk.js";
+
+//#region locales/en-US.json
+var COMMAND = "COMMAND";
+var COMMANDS = "COMMANDS";
+var SUBCOMMAND = "SUBCOMMAND";
+var USAGE = "USAGE";
+var OPTIONS = "OPTIONS";
+var EXAMPLES = "EXAMPLES";
+var FORMORE = "For more info, run any command with the `--help` flag:";
+var help = "Display this help message";
+var version = "Display this version";
+var en_US_default = {
+	COMMAND,
+	COMMANDS,
+	SUBCOMMAND,
+	USAGE,
+	OPTIONS,
+	EXAMPLES,
+	FORMORE,
+	help,
+	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";
+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]) => {
+		acc[key] = Object.assign(create(), value);
+		return acc;
+	}, create());
+	const _values = Object.assign(create(), values);
+	/**
+	* normalize the usage
+	*/
+	const usage = Object.assign(create(), command.usage);
+	const { help: help$1, version: version$1 } = en_US_default;
+	usage.options = Object.assign(create(), usage.options, {
+		help: help$1,
+		version: version$1
+	});
+	/**
+	* setup the environment
+	*/
+	const env = Object.assign(create(), COMMAND_OPTIONS_DEFAULT, commandOptions);
+	const locale = resolveLocale(commandOptions.locale);
+	const localeResources = new Map();
+	const commandResources = new Map();
+	let builtInLoadedResources;
+	/**
+	* load the built-in locale resources
+	*/
+	localeResources.set(DEFAULT_LOCALE, en_US_default);
+	if (DEFAULT_LOCALE !== locale.toString()) try {
+		builtInLoadedResources = await import(`../locales/${locale.toString()}.json`, { with: { type: "json" } });
+		localeResources.set(locale.toString(), builtInLoadedResources);
+	} catch {}
+	/**
+	* define the translation function
+	*/
+	function translation(key) {
+		if (COMMAND_I18N_RESOURCE_KEYS.includes(key)) {
+			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] || "";
+		}
+	}
+	/**
+	* load the sub commands
+	*/
+	let cachedCommands;
+	async function loadCommands() {
+		if (cachedCommands) return cachedCommands;
+		const subCommands = [...env.subCommands || []];
+		return cachedCommands = await Promise.all(subCommands.map(async ([name, cmd]) => await resolveLazyCommand(cmd, name)));
+	}
+	/**
+	* create the context
+	*/
+	const ctx = deepFreeze(Object.assign(create(), {
+		name: command.name,
+		description: command.description,
+		omitted,
+		locale,
+		env,
+		options: _options,
+		values: _values,
+		positionals,
+		usage,
+		loadCommands,
+		translation
+	}));
+	/**
+	* load the command resources
+	*/
+	const loadedOptionsResources = Object.entries(usage.options || create()).map(([key, _]) => {
+		const option = usage.options[key];
+		return [key, option];
+	});
+	const defaultCommandResource = loadedOptionsResources.reduce((res, [key, value]) => {
+		res[key] = value;
+		return res;
+	}, create());
+	defaultCommandResource.description = command.description || "";
+	defaultCommandResource.examples = usage.examples || "";
+	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(), {
+			description: originalResource.description,
+			examples: originalResource.examples
+		}));
+		if (builtInLoadedResources) {
+			resource.help = builtInLoadedResources.help;
+			resource.version = builtInLoadedResources.version;
+		}
+		commandResources.set(locale.toString(), resource);
+	}
+	return ctx;
+}
+function resolveLocale(locale) {
+	return locale instanceof Intl.Locale ? locale : typeof locale === "string" ? new Intl.Locale(locale) : new Intl.Locale(DEFAULT_LOCALE);
+}
+async function loadCommandResource(ctx, command) {
+	let resource;
+	try {
+		resource = await command.resource?.(ctx);
+	} catch {}
+	return resource;
+}
+
+//#endregion
+export { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, DEFAULT_LOCALE, createCommandContext };

package/lib/context.d.ts

@@ -1,7 +1,8 @@
-import type { ArgOptions, ArgValues } from "args-tokens";
-import type { Command, CommandContext, CommandOptions } from "./types.js";
-export declare const DEFAULT_LOCALE = "en-US";
-export declare function createCommandContext<
+import { ArgOptions, ArgValues } from 'args-tokens';
+import { C as Command, a as CommandOptions, b as CommandContext } from './types.d-B3YGxDV6.js';
+
+declare const DEFAULT_LOCALE = "en-US";
+declare function createCommandContext<
 	Options extends ArgOptions,
 	Values = ArgValues<Options>
 >({ options, values, positionals, command, commandOptions, omitted }: {
@@ -12,3 +13,5 @@ export declare function createCommandContext<
 	command: Command<Options>
 	commandOptions: CommandOptions<Options>
 }): Promise<Readonly<CommandContext<Options, Values>>>;
+
+export { DEFAULT_LOCALE, createCommandContext };

package/lib/context.js

@@ -0,0 +1,4 @@
+import { DEFAULT_LOCALE, createCommandContext } from "./context-BQKZW5bg.js";
+import "./utils-NHs5DuHk.js";
+
+export { DEFAULT_LOCALE, createCommandContext };

package/lib/index.d.ts

@@ -1,2 +1,14 @@
-export * from "./cli.js";
-export type * from "./types.js";
+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-B3YGxDV6.js';
+export { f as CommandBuiltinKeys, d as CommandBuiltinOptionsKeys, e as CommandBuiltinResourceKeys, b as CommandContext, g as CommandEnvironment, i as CommandResource, j as CommandResourceFetcher, h as CommandUsageRender, L as LazyCommand } from './types.d-B3YGxDV6.js';
+
+/**
+* Run the command
+* @param args - command line arguments
+* @param entry - a {@link Command | entry command} or an {@link CommandRunner | inline command runner}
+* @param opts - a {@link CommandOptions | command options}
+*/
+declare function cli<Options extends ArgOptions>(args: string[], entry: Command<Options> | CommandRunner<Options>, opts?: CommandOptions<Options>): Promise<void>;
+
+export { Command, CommandOptions, CommandRunner, cli };

package/lib/index.js

@@ -1,643 +1,8 @@
+import { COMMAND_OPTIONS_DEFAULT, COMMON_OPTIONS, createCommandContext } from "./context-BQKZW5bg.js";
+import { create, log, resolveLazyCommand } from "./utils-NHs5DuHk.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-Bo0DibAK.js";
+import { parseArgs, resolveArgs } from "args-tokens";
 
-//#region node_modules/.pnpm/args-tokens@0.10.2/node_modules/args-tokens/lib/parser.js
-const HYPHEN_CHAR = "-";
-const HYPHEN_CODE = HYPHEN_CHAR.codePointAt(0);
-const EQUAL_CHAR = "=";
-const EQUAL_CODE = EQUAL_CHAR.codePointAt(0);
-const TERMINATOR = "--";
-const SHORT_OPTION_PREFIX = HYPHEN_CHAR;
-const LONG_OPTION_PREFIX = "--";
-function parseArgs(args, options = {}) {
-	const { allowCompatible = false } = options;
-	const tokens = [];
-	const remainings = [...args];
-	let index = -1;
-	let groupCount = 0;
-	let hasShortValueSeparator = false;
-	while (remainings.length > 0) {
-		const arg = remainings.shift();
-		if (arg == undefined) break;
-		const nextArg = remainings[0];
-		if (groupCount > 0) groupCount--;
-		else index++;
-		if (arg === TERMINATOR) {
-			tokens.push({
-				kind: "option-terminator",
-				index
-			});
-			const mapped = remainings.map((arg$1) => {
-				return {
-					kind: "positional",
-					index: ++index,
-					value: arg$1
-				};
-			});
-			tokens.push(...mapped);
-			break;
-		}
-		if (isShortOption(arg)) {
-			const shortOption = arg.charAt(1);
-			let value;
-			let inlineValue;
-			if (groupCount) {
-				tokens.push({
-					kind: "option",
-					name: shortOption,
-					rawName: arg,
-					index,
-					value,
-					inlineValue
-				});
-				if (groupCount === 1 && hasOptionValue(nextArg)) {
-					value = remainings.shift();
-					if (hasShortValueSeparator) {
-						inlineValue = true;
-						hasShortValueSeparator = false;
-					}
-					tokens.push({
-						kind: "option",
-						index,
-						value,
-						inlineValue
-					});
-				}
-			} else tokens.push({
-				kind: "option",
-				name: shortOption,
-				rawName: arg,
-				index,
-				value,
-				inlineValue
-			});
-			if (value != null) ++index;
-			continue;
-		}
-		if (isShortOptionGroup(arg)) {
-			const expanded = [];
-			let shortValue = "";
-			for (let i = 1; i < arg.length; i++) {
-				const shortableOption = arg.charAt(i);
-				if (hasShortValueSeparator) shortValue += shortableOption;
-				else if (!allowCompatible && shortableOption.codePointAt(0) === EQUAL_CODE) hasShortValueSeparator = true;
-				else expanded.push(`${SHORT_OPTION_PREFIX}${shortableOption}`);
-			}
-			if (shortValue) expanded.push(shortValue);
-			remainings.unshift(...expanded);
-			groupCount = expanded.length;
-			continue;
-		}
-		if (isLongOption(arg)) {
-			const longOption = arg.slice(2);
-			tokens.push({
-				kind: "option",
-				name: longOption,
-				rawName: arg,
-				index,
-				value: undefined,
-				inlineValue: undefined
-			});
-			continue;
-		}
-		if (isLongOptionAndValue(arg)) {
-			const equalIndex = arg.indexOf(EQUAL_CHAR);
-			const longOption = arg.slice(2, equalIndex);
-			const value = arg.slice(equalIndex + 1);
-			tokens.push({
-				kind: "option",
-				name: longOption,
-				rawName: `${LONG_OPTION_PREFIX}${longOption}`,
-				index,
-				value,
-				inlineValue: true
-			});
-			continue;
-		}
-		tokens.push({
-			kind: "positional",
-			index,
-			value: arg
-		});
-	}
-	return tokens;
-}
-function isShortOption(arg) {
-	return arg.length === 2 && arg.codePointAt(0) === HYPHEN_CODE && arg.codePointAt(1) !== HYPHEN_CODE;
-}
-/**
-* Check if `arg` is a short option group (e.g. `-abc`)
-* @param arg the argument to check
-* @returns whether `arg` is a short option group
-*/
-function isShortOptionGroup(arg) {
-	if (arg.length <= 2) return false;
-	if (arg.codePointAt(0) !== HYPHEN_CODE) return false;
-	if (arg.codePointAt(1) === HYPHEN_CODE) return false;
-	return true;
-}
-/**
-* Check if `arg` is a long option (e.g. `--foo`)
-* @param arg the argument to check
-* @returns whether `arg` is a long option
-*/
-function isLongOption(arg) {
-	return hasLongOptionPrefix(arg) && !arg.includes(EQUAL_CHAR, 3);
-}
-/**
-* Check if `arg` is a long option with value (e.g. `--foo=bar`)
-* @param arg the argument to check
-* @returns whether `arg` is a long option
-*/
-function isLongOptionAndValue(arg) {
-	return hasLongOptionPrefix(arg) && arg.includes(EQUAL_CHAR, 3);
-}
-function hasLongOptionPrefix(arg) {
-	return arg.length > 2 && ~arg.indexOf(LONG_OPTION_PREFIX);
-}
-/**
-* Check if a `value` is an option value
-* @param value a value to check
-* @returns whether a `value` is an option value
-*/
-function hasOptionValue(value) {
-	return !(value == null) && value.codePointAt(0) !== HYPHEN_CODE;
-}
-
-//#endregion
-//#region node_modules/.pnpm/args-tokens@0.10.2/node_modules/args-tokens/lib/resolver.js
-function resolveArgs(options, tokens) {
-	const positionals = [];
-	const longOptionTokens = [];
-	const shortOptionTokens = [];
-	let currentLongOption;
-	let currentShortOption;
-	const expandableShortOptions = [];
-	function toShortValue() {
-		if (expandableShortOptions.length === 0) return undefined;
-		else {
-			const value = expandableShortOptions.map((token) => token.name).join("");
-			expandableShortOptions.length = 0;
-			return value;
-		}
-	}
-	function applyLongOptionValue(value = undefined) {
-		if (currentLongOption) {
-			currentLongOption.value = value;
-			longOptionTokens.push({ ...currentLongOption });
-			currentLongOption = undefined;
-		}
-	}
-	function applyShortOptionValue(value = undefined) {
-		if (currentShortOption) {
-			currentShortOption.value = value || toShortValue();
-			shortOptionTokens.push({ ...currentShortOption });
-			currentShortOption = undefined;
-		}
-	}
-	/**
-	* analyze phase to resolve value
-	* separate tokens into positionals, long and short options, after that resolve values
-	*/
-	for (let i = 0; i < tokens.length; i++) {
-		const token = tokens[i];
-		if (token.kind === "positional") {
-			positionals.push(token.value);
-			applyLongOptionValue(token.value);
-			applyShortOptionValue(token.value);
-		} else if (token.kind === "option") if (token.rawName) {
-			if (hasLongOptionPrefix(token.rawName)) {
-				if (token.inlineValue) longOptionTokens.push({ ...token });
-				else currentLongOption = { ...token };
-				applyShortOptionValue();
-			} else if (isShortOption(token.rawName)) if (currentShortOption) {
-				if (currentShortOption.index === token.index) expandableShortOptions.push({ ...token });
-				else {
-					currentShortOption.value = toShortValue();
-					shortOptionTokens.push({ ...currentShortOption });
-					currentShortOption = { ...token };
-				}
-				applyLongOptionValue();
-			} else {
-				currentShortOption = { ...token };
-				applyLongOptionValue();
-			}
-		} else {
-			if (currentShortOption && currentShortOption.index == token.index && token.inlineValue) {
-				currentShortOption.value = token.value;
-				shortOptionTokens.push({ ...currentShortOption });
-				currentShortOption = undefined;
-			}
-			applyLongOptionValue();
-		}
-		else {
-			applyLongOptionValue();
-			applyShortOptionValue();
-		}
-	}
-	/**
-	* check if the last long or short option is not resolved
-	*/
-	applyLongOptionValue();
-	applyShortOptionValue();
-	/**
-	* resolve values
-	*/
-	const values = Object.create(null);
-	const errors = [];
-	for (const [option, schema] of Object.entries(options)) {
-		if (schema.required) {
-			const found = longOptionTokens.find((token) => token.name === option) || schema.short && shortOptionTokens.find((token) => token.name === schema.short);
-			if (!found) {
-				errors.push(createRequireError(option, schema));
-				continue;
-			}
-		}
-		for (let i = 0; i < longOptionTokens.length; i++) {
-			const token = longOptionTokens[i];
-			if (option === token.name && token.rawName != null && hasLongOptionPrefix(token.rawName)) {
-				const invalid = validateRequire(token, option, schema);
-				if (invalid) {
-					errors.push(invalid);
-					continue;
-				}
-				if (schema.type === "boolean") token.value = undefined;
-				else {
-					const invalid$1 = validateValue(token, option, schema);
-					if (invalid$1) {
-						errors.push(invalid$1);
-						continue;
-					}
-				}
-				values[option] = resolveOptionValue(token, schema);
-				continue;
-			}
-		}
-		for (let i = 0; i < shortOptionTokens.length; i++) {
-			const token = shortOptionTokens[i];
-			if (schema.short === token.name && token.rawName != null && isShortOption(token.rawName)) {
-				const invalid = validateRequire(token, option, schema);
-				if (invalid) {
-					errors.push(invalid);
-					continue;
-				}
-				if (schema.type === "boolean") token.value = undefined;
-				else {
-					const invalid$1 = validateValue(token, option, schema);
-					if (invalid$1) {
-						errors.push(invalid$1);
-						continue;
-					}
-				}
-				values[option] = resolveOptionValue(token, schema);
-				continue;
-			}
-		}
-		if (values[option] == null && schema.default != null) values[option] = schema.default;
-	}
-	return {
-		values,
-		positionals,
-		error: errors.length > 0 ? new AggregateError(errors) : undefined
-	};
-}
-function createRequireError(option, schema) {
-	return new Error(`Option '--${option}' ${schema.short ? `or '-${schema.short}' ` : ""}is required`);
-}
-function validateRequire(token, option, schema) {
-	if (schema.required && schema.type !== "boolean" && !token.value) return createRequireError(option, schema);
-}
-function validateValue(token, option, schema) {
-	switch (schema.type) {
-		case "number": {
-			if (!isNumeric(token.value)) return createTypeError(option, schema);
-			break;
-		}
-		case "string": {
-			if (typeof token.value !== "string") return createTypeError(option, schema);
-			break;
-		}
-	}
-}
-function isNumeric(str) {
-	return str.trim() !== "" && !isNaN(str);
-}
-function createTypeError(option, schema) {
-	return new TypeError(`Option '--${option}' ${schema.short ? `or '-${schema.short}' ` : ""}should be '${schema.type}'`);
-}
-function resolveOptionValue(token, schema) {
-	if (token.value) return schema.type === "number" ? +token.value : token.value;
-	if (schema.type === "boolean") return true;
-	return schema.type === "number" ? +(schema.default || "") : schema.default;
-}
-
-//#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 locales/en-US.json
-var COMMAND = "COMMAND";
-var COMMANDS = "COMMANDS";
-var SUBCOMMAND = "SUBCOMMAND";
-var USAGE = "USAGE";
-var OPTIONS = "OPTIONS";
-var EXAMPLES = "EXAMPLES";
-var FORMORE = "For more info, run any command with the `--help` flag:";
-var help = "Display this help message";
-var version = "Display this version";
-var en_US_default = {
-	COMMAND,
-	COMMANDS,
-	SUBCOMMAND,
-	USAGE,
-	OPTIONS,
-	EXAMPLES,
-	FORMORE,
-	help,
-	version
-};
-
-//#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 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
-//#region src/context.ts
-const DEFAULT_LOCALE = "en-US";
-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]) => {
-		acc[key] = Object.assign(create(), value);
-		return acc;
-	}, create());
-	const _values = Object.assign(create(), values);
-	/**
-	* normalize the usage
-	*/
-	const usage = Object.assign(create(), command.usage);
-	const { help: help$1, version: version$1 } = en_US_default;
-	usage.options = Object.assign(create(), usage.options, {
-		help: help$1,
-		version: version$1
-	});
-	/**
-	* setup the environment
-	*/
-	const env = Object.assign(create(), COMMAND_OPTIONS_DEFAULT, commandOptions);
-	const locale = resolveLocale(commandOptions.locale);
-	const localeResources = new Map();
-	const commandResources = new Map();
-	let builtInLoadedResources;
-	/**
-	* load the built-in locale resources
-	*/
-	localeResources.set(DEFAULT_LOCALE, en_US_default);
-	if (DEFAULT_LOCALE !== locale.toString()) try {
-		builtInLoadedResources = await import(`../locales/${locale.toString()}.json`, { with: { type: "json" } });
-		localeResources.set(locale.toString(), builtInLoadedResources);
-	} catch {}
-	/**
-	* define the translation function
-	*/
-	function translation(key) {
-		if (COMMAND_I18N_RESOURCE_KEYS.includes(key)) {
-			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] || "";
-		}
-	}
-	/**
-	* load the sub commands
-	*/
-	let cachedCommands;
-	async function loadCommands() {
-		if (cachedCommands) return cachedCommands;
-		const subCommands = [...env.subCommands || []];
-		return cachedCommands = await Promise.all(subCommands.map(async ([name, cmd]) => await resolveLazyCommand(cmd, name)));
-	}
-	/**
-	* create the context
-	*/
-	const ctx = deepFreeze(Object.assign(create(), {
-		name: command.name,
-		description: command.description,
-		omitted,
-		locale,
-		env,
-		options: _options,
-		values: _values,
-		positionals,
-		usage,
-		loadCommands,
-		translation
-	}));
-	/**
-	* load the command resources
-	*/
-	const loadedOptionsResources = Object.entries(usage.options || create()).map(([key, _]) => {
-		const option = usage.options[key];
-		return [key, option];
-	});
-	const defaultCommandResource = loadedOptionsResources.reduce((res, [key, value]) => {
-		res[key] = value;
-		return res;
-	}, create());
-	defaultCommandResource.description = command.description || "";
-	defaultCommandResource.examples = usage.examples || "";
-	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(), {
-			description: originalResource.description,
-			examples: originalResource.examples
-		}));
-		if (builtInLoadedResources) {
-			resource.help = builtInLoadedResources.help;
-			resource.version = builtInLoadedResources.version;
-		}
-		commandResources.set(locale.toString(), resource);
-	}
-	return ctx;
-}
-function resolveLocale(locale) {
-	return locale instanceof Intl.Locale ? locale : typeof locale === "string" ? new Intl.Locale(locale) : new Intl.Locale(DEFAULT_LOCALE);
-}
-async function loadCommandResource(ctx, command) {
-	let resource;
-	try {
-		resource = await command.resource?.(ctx);
-	} catch {}
-	return resource;
-}
-
-//#endregion
-//#region src/renderer.ts
-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);
-}
-async function renderUsage(ctx) {
-	const messages = [];
-	if (!ctx.omitted && hasDescription(ctx)) messages.push(ctx.description, "");
-	messages.push(...await renderUsageSection(ctx), "");
-	if (ctx.omitted && await hasCommands(ctx)) messages.push(...await renderCommandsSection(ctx), "");
-	if (hasOptions(ctx)) messages.push(...await renderOptionsSection(ctx), "");
-	if (hasExamples(ctx)) messages.push(...renderExamplesSection(ctx), "");
-	return messages.join("\n");
-}
-function renderValidationErrors(_ctx, error) {
-	const messages = [];
-	for (const err of error.errors) messages.push(err.message);
-	return Promise.resolve(messages.join("\n"));
-}
-async function renderOptionsSection(ctx) {
-	const messages = [];
-	messages.push(`${ctx.translation("OPTIONS")}:`);
-	const optionsPairs = getOptionsPairs(ctx);
-	messages.push(await generateOptionsUsage(ctx, optionsPairs));
-	return messages;
-}
-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);
-	return messages;
-}
-async function renderUsageSection(ctx) {
-	const messages = [`${ctx.translation("USAGE")}:`];
-	if (ctx.omitted) {
-		const defaultCommand = `${resolveEntry(ctx)}${await hasCommands(ctx) ? ` [${resolveSubCommand(ctx)}]` : ""} ${hasOptions(ctx) ? `<${ctx.translation("OPTIONS")}>` : ""} `;
-		messages.push(defaultCommand.padStart(ctx.env.leftMargin + defaultCommand.length));
-		if (await hasCommands(ctx)) {
-			const commandsUsage = `${resolveEntry(ctx)} <${ctx.translation("COMMANDS")}>`;
-			messages.push(commandsUsage.padStart(ctx.env.leftMargin + commandsUsage.length));
-		}
-	} else {
-		const usageStr = `${resolveEntry(ctx)} ${resolveSubCommand(ctx)} ${generateOptionsSymbols(ctx)}`;
-		messages.push(usageStr.padStart(ctx.env.leftMargin + usageStr.length));
-	}
-	return messages;
-}
-async function renderCommandsSection(ctx) {
-	const messages = [`${ctx.translation("COMMANDS")}:`];
-	const loadedCommands = await ctx.loadCommands();
-	const commandMaxLength = Math.max(...loadedCommands.map((cmd) => (cmd.name || "").length));
-	const commandsStr = await Promise.all(loadedCommands.map((cmd) => {
-		const key = cmd.name || "";
-		const desc = cmd.description || "";
-		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(...loadedCommands.map((cmd) => {
-		const commandHelp = `${ctx.env.name} ${cmd.name} --help`;
-		return `${commandHelp.padStart(ctx.env.leftMargin + commandHelp.length)}`;
-	}));
-	return messages;
-}
-function resolveEntry(ctx) {
-	return ctx.env.name || ctx.translation("COMMAND");
-}
-function resolveSubCommand(ctx) {
-	return ctx.name || ctx.translation("SUBCOMMAND");
-}
-function hasDescription(ctx) {
-	return !!ctx.description;
-}
-async function hasCommands(ctx) {
-	const loadedCommands = await ctx.loadCommands();
-	return loadedCommands.length > 1;
-}
-function hasOptions(ctx) {
-	return !!(ctx.options && Object.keys(ctx.options).length > 0);
-}
-function hasExamples(ctx) {
-	return !!ctx.usage.examples;
-}
-function hasAllDefaultOptions(ctx) {
-	return !!(ctx.options && Object.values(ctx.options).every((opt) => opt.default));
-}
-function generateOptionsSymbols(ctx) {
-	return hasOptions(ctx) ? hasAllDefaultOptions(ctx) ? `[${ctx.translation("OPTIONS")}]` : `<${ctx.translation("OPTIONS")}>` : "";
-}
-function getOptionsPairs(ctx) {
-	return Object.entries(ctx.options).reduce((acc, [name, value]) => {
-		let key = `--${name}`;
-		if (value.short) key = `-${value.short}, ${key}`;
-		if (value.type !== "boolean") key = value.default ? `${key} [${name}]` : `${key} <${name}>`;
-		acc[name] = key;
-		return acc;
-	}, create());
-}
-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 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}`;
-		return `${option.padStart(ctx.env.leftMargin + option.length)}`;
-	}));
-	return usages.join("\n");
-}
-
-//#endregion
 //#region src/cli.ts
 async function cli(args, entry, opts = {}) {
 	const tokens = parseArgs(args);

package/lib/renderer-Bo0DibAK.js

@@ -0,0 +1,115 @@
+import { create } from "./utils-NHs5DuHk.js";
+
+//#region src/renderer.ts
+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);
+}
+async function renderUsage(ctx) {
+	const messages = [];
+	if (!ctx.omitted && hasDescription(ctx)) messages.push(ctx.description, "");
+	messages.push(...await renderUsageSection(ctx), "");
+	if (ctx.omitted && await hasCommands(ctx)) messages.push(...await renderCommandsSection(ctx), "");
+	if (hasOptions(ctx)) messages.push(...await renderOptionsSection(ctx), "");
+	if (hasExamples(ctx)) messages.push(...renderExamplesSection(ctx), "");
+	return messages.join("\n");
+}
+function renderValidationErrors(_ctx, error) {
+	const messages = [];
+	for (const err of error.errors) messages.push(err.message);
+	return Promise.resolve(messages.join("\n"));
+}
+async function renderOptionsSection(ctx) {
+	const messages = [];
+	messages.push(`${ctx.translation("OPTIONS")}:`);
+	const optionsPairs = getOptionsPairs(ctx);
+	messages.push(await generateOptionsUsage(ctx, optionsPairs));
+	return messages;
+}
+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);
+	return messages;
+}
+async function renderUsageSection(ctx) {
+	const messages = [`${ctx.translation("USAGE")}:`];
+	if (ctx.omitted) {
+		const defaultCommand = `${resolveEntry(ctx)}${await hasCommands(ctx) ? ` [${resolveSubCommand(ctx)}]` : ""} ${hasOptions(ctx) ? `<${ctx.translation("OPTIONS")}>` : ""} `;
+		messages.push(defaultCommand.padStart(ctx.env.leftMargin + defaultCommand.length));
+		if (await hasCommands(ctx)) {
+			const commandsUsage = `${resolveEntry(ctx)} <${ctx.translation("COMMANDS")}>`;
+			messages.push(commandsUsage.padStart(ctx.env.leftMargin + commandsUsage.length));
+		}
+	} else {
+		const usageStr = `${resolveEntry(ctx)} ${resolveSubCommand(ctx)} ${generateOptionsSymbols(ctx)}`;
+		messages.push(usageStr.padStart(ctx.env.leftMargin + usageStr.length));
+	}
+	return messages;
+}
+async function renderCommandsSection(ctx) {
+	const messages = [`${ctx.translation("COMMANDS")}:`];
+	const loadedCommands = await ctx.loadCommands();
+	const commandMaxLength = Math.max(...loadedCommands.map((cmd) => (cmd.name || "").length));
+	const commandsStr = await Promise.all(loadedCommands.map((cmd) => {
+		const key = cmd.name || "";
+		const desc = cmd.description || "";
+		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(...loadedCommands.map((cmd) => {
+		const commandHelp = `${ctx.env.name} ${cmd.name} --help`;
+		return `${commandHelp.padStart(ctx.env.leftMargin + commandHelp.length)}`;
+	}));
+	return messages;
+}
+function resolveEntry(ctx) {
+	return ctx.env.name || ctx.translation("COMMAND");
+}
+function resolveSubCommand(ctx) {
+	return ctx.name || ctx.translation("SUBCOMMAND");
+}
+function hasDescription(ctx) {
+	return !!ctx.description;
+}
+async function hasCommands(ctx) {
+	const loadedCommands = await ctx.loadCommands();
+	return loadedCommands.length > 1;
+}
+function hasOptions(ctx) {
+	return !!(ctx.options && Object.keys(ctx.options).length > 0);
+}
+function hasExamples(ctx) {
+	return !!ctx.usage.examples;
+}
+function hasAllDefaultOptions(ctx) {
+	return !!(ctx.options && Object.values(ctx.options).every((opt) => opt.default));
+}
+function generateOptionsSymbols(ctx) {
+	return hasOptions(ctx) ? hasAllDefaultOptions(ctx) ? `[${ctx.translation("OPTIONS")}]` : `<${ctx.translation("OPTIONS")}>` : "";
+}
+function getOptionsPairs(ctx) {
+	return Object.entries(ctx.options).reduce((acc, [name, value]) => {
+		let key = `--${name}`;
+		if (value.short) key = `-${value.short}, ${key}`;
+		if (value.type !== "boolean") key = value.default ? `${key} [${name}]` : `${key} <${name}>`;
+		acc[name] = key;
+		return acc;
+	}, create());
+}
+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 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}`;
+		return `${option.padStart(ctx.env.leftMargin + option.length)}`;
+	}));
+	return usages.join("\n");
+}
+
+//#endregion
+export { renderHeader, renderUsage, renderValidationErrors };

package/lib/renderer.d.ts

@@ -1,5 +1,8 @@
-import type { ArgOptions } from "args-tokens";
-import type { CommandContext } from "./types.js";
-export declare function renderHeader<Options extends ArgOptions>(ctx: Readonly<CommandContext<Options>>): Promise<string>;
-export declare function renderUsage<Options extends ArgOptions>(ctx: Readonly<CommandContext<Options>>): Promise<string>;
-export declare function renderValidationErrors<Options extends ArgOptions>(_ctx: CommandContext<Options>, error: AggregateError): Promise<string>;
+import { ArgOptions } from 'args-tokens';
+import { b as CommandContext } from './types.d-B3YGxDV6.js';
+
+declare function renderHeader<Options extends ArgOptions>(ctx: Readonly<CommandContext<Options>>): Promise<string>;
+declare function renderUsage<Options extends ArgOptions>(ctx: Readonly<CommandContext<Options>>): Promise<string>;
+declare function renderValidationErrors<Options extends ArgOptions>(_ctx: CommandContext<Options>, error: AggregateError): Promise<string>;
+
+export { renderHeader, renderUsage, renderValidationErrors };

package/lib/renderer.js

@@ -0,0 +1,4 @@
+import "./utils-NHs5DuHk.js";
+import { renderHeader, renderUsage, renderValidationErrors } from "./renderer-Bo0DibAK.js";
+
+export { renderHeader, renderUsage, renderValidationErrors };

package/lib/{types.d.ts → types.d-B3YGxDV6.d.ts}

@@ -1,4 +1,25 @@
-import type { ArgOptions, ArgValues } from "args-tokens";
+import { ArgOptions, ArgValues } from 'args-tokens';
+
+declare const COMMON_OPTIONS: {
+	readonly help: {
+		readonly type: "boolean"
+		readonly short: "h"
+	}
+	readonly version: {
+		readonly type: "boolean"
+		readonly short: "v"
+	}
+};
+declare const COMMAND_OPTIONS_DEFAULT: CommandOptions<ArgOptions>;
+declare const COMMAND_I18N_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_COMMAND_OPTIONS_DEFAULT: typeof COMMAND_OPTIONS_DEFAULT;
+declare const __constants_COMMON_OPTIONS: typeof COMMON_OPTIONS;
+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 };
+}
+
 /**
 * Define a promise type that can be await from T
 */
@@ -7,22 +28,22 @@ type Awaitable<T> = T | Promise<T>;
 * The command i18n built-in options keys
 * @experimental
 */
-export type CommandBuiltinOptionsKeys = keyof (typeof import("./constants"))["COMMON_OPTIONS"];
+type CommandBuiltinOptionsKeys = keyof (typeof __constants)["COMMON_OPTIONS"];
 /**
 * The command i18n built-in resource keys
 * @experimental
 */
-export type CommandBuiltinResourceKeys = (typeof import("./constants"))["COMMAND_I18N_RESOURCE_KEYS"][number];
+type CommandBuiltinResourceKeys = (typeof __constants)["COMMAND_I18N_RESOURCE_KEYS"][number];
 /**
 * The command i18n built-in keys
 * @description The command i18n built-in keys are used to {@link CommandContext.translation | translate} function
 * @experimental
 */
-export type CommandBuiltinKeys = CommandBuiltinOptionsKeys | CommandBuiltinResourceKeys | "description" | "examples";
+type CommandBuiltinKeys = CommandBuiltinOptionsKeys | CommandBuiltinResourceKeys | "description" | "examples";
 /**
 * The command environment
 */
-export interface CommandEnvironment<Options extends ArgOptions = ArgOptions> {
+interface CommandEnvironment<Options extends ArgOptions = ArgOptions> {
 	/**
 	* The current working directory
 	* @see {@link CommandOptions.cwd}
@@ -83,7 +104,7 @@ export interface CommandEnvironment<Options extends ArgOptions = ArgOptions> {
 /**
 * The command options
 */
-export interface CommandOptions<Options extends ArgOptions> {
+interface CommandOptions<Options extends ArgOptions> {
 	/**
 	* The current working directory
 	* @description This is the current working directory path passed in the context of the run command. This is useful if you need your command about the current execution directory.
@@ -143,7 +164,7 @@ export interface CommandOptions<Options extends ArgOptions> {
 * The command context
 * @description The command context is the context of the command execution
 */
-export interface CommandContext<
+interface CommandContext<
 	Options extends ArgOptions,
 	Values = ArgValues<Options>
 > {
@@ -211,7 +232,7 @@ export interface CommandContext<
 * The command usage render
 * @description if the render function is async, it should return a promise
 */
-export type CommandUsageRender<Options extends ArgOptions> = ((ctx: Readonly<CommandContext<Options>>) => Promise<string>) | string;
+type CommandUsageRender<Options extends ArgOptions> = ((ctx: Readonly<CommandContext<Options>>) => Promise<string>) | string;
 /**
 * The command usage
 */
@@ -228,7 +249,7 @@ interface CommandUsage<Options extends ArgOptions> {
 /**
 * The command interface
 */
-export interface Command<Options extends ArgOptions> {
+interface Command<Options extends ArgOptions> {
 	/**
 	* The command name
 	* @description
@@ -270,7 +291,7 @@ export interface Command<Options extends ArgOptions> {
 * The command resource
 * @experimental
 */
-export interface CommandResource<Options extends ArgOptions> {
+interface CommandResource<Options extends ArgOptions> {
 	/**
 	* The command description resource
 	*/
@@ -288,15 +309,16 @@ export interface CommandResource<Options extends ArgOptions> {
 * The command resource fetcher
 * @experimental
 */
-export type CommandResourceFetcher<Options extends ArgOptions> = (ctx: Readonly<CommandContext<Options>>) => Promise<CommandResource<Options>>;
+type CommandResourceFetcher<Options extends ArgOptions> = (ctx: Readonly<CommandContext<Options>>) => Promise<CommandResource<Options>>;
 /**
 * The command runner interface
 * @param ctx - The {@link CommandContext | command context}
 */
-export type CommandRunner<Options extends ArgOptions> = (ctx: Readonly<CommandContext<Options>>) => Awaitable<void>;
+type CommandRunner<Options extends ArgOptions> = (ctx: Readonly<CommandContext<Options>>) => Awaitable<void>;
 /**
 * The lazy command interface
 * @description The lazy command that's not loaded until it is executed
 */
-export type LazyCommand<Options extends ArgOptions> = () => Awaitable<Command<Options>>;
-export {};
+type LazyCommand<Options extends ArgOptions> = () => Awaitable<Command<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, CommandUsageRender as h, CommandResource as i, CommandResourceFetcher as j };

package/lib/utils-NHs5DuHk.js

@@ -0,0 +1,24 @@
+
+//#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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -88,10 +88,9 @@
     "lint-staged": "^15.4.3",
     "pkg-pr-new": "^0.0.40",
     "prettier": "^3.5.3",
-    "rolldown": "1.0.0-beta.3",
+    "tsdown": "^0.6.4",
     "typescript": "^5.8.2",
     "typescript-eslint": "^8.26.0",
-    "unplugin-isolated-decl": "^0.13.1",
     "vitest": "^3.0.7"
   },
   "prettier": "@kazupon/prettier-config",
@@ -109,7 +108,7 @@
     ]
   },
   "scripts": {
-    "build": "rolldown -c rolldown.config.ts",
+    "build": "tsdown",
     "changelog": "gh-changelogen --repo=kazupon/gunshi",
     "clean": "git clean -df",
     "dev": "pnpx @eslint/config-inspector --config eslint.config.ts",

package/lib/cli.d.ts

@@ -1,9 +0,0 @@
-import type { ArgOptions } from "args-tokens";
-import type { Command, CommandOptions, CommandRunner } from "./types.js";
-/**
-* Run the command
-* @param args - command line arguments
-* @param entry - a {@link Command | entry command} or an {@link CommandRunner | inline command runner}
-* @param opts - a {@link CommandOptions | command options}
-*/
-export declare function cli<Options extends ArgOptions>(args: string[], entry: Command<Options> | CommandRunner<Options>, opts?: CommandOptions<Options>): Promise<void>;

package/lib/constants.d.ts

@@ -1,14 +0,0 @@
-import type { ArgOptions } from "args-tokens";
-import type { CommandOptions } from "./types.js";
-export declare const COMMON_OPTIONS: {
-	readonly help: {
-		readonly type: "boolean"
-		readonly short: "h"
-	}
-	readonly version: {
-		readonly type: "boolean"
-		readonly short: "v"
-	}
-};
-export declare const COMMAND_OPTIONS_DEFAULT: CommandOptions<ArgOptions>;
-export declare const COMMAND_I18N_RESOURCE_KEYS: readonly ["USAGE", "COMMAND", "SUBCOMMAND", "COMMANDS", "OPTIONS", "EXAMPLES", "FORMORE"];

package/lib/utils.d.ts

@@ -1,6 +0,0 @@
-import type { ArgOptions } from "args-tokens";
-import type { Command, LazyCommand } from "./types.js";
-export declare function resolveLazyCommand<Options extends ArgOptions>(cmd: Command<Options> | LazyCommand<Options>, name: string | undefined, entry?: boolean): Promise<Command<Options>>;
-export declare function create<T>(obj?: object | null): T;
-export declare function log(...args: unknown[]): void;
-export declare function deepFreeze<T extends Record<string, any>>(obj: T): Readonly<T>;