convoker 0.3.3 → 0.4.0

package/dist/index-Cnx4H4D-.d.mts

@@ -0,0 +1,316 @@
+import { n as Theme } from "./index-BtbthYjp.mjs";
+import { i as Input, o as Option, r as InferInput, s as Positional } from "./index-ClhbwSD8.mjs";
+
+//#region src/command/error.d.ts
+
+/**
+ * A Convoker-related error. These are usually handled by default.
+ */
+declare class ConvokerError extends Error {
+  /**
+   * The command this error happened on.
+   */
+  command: Command<any>;
+  /**
+   * Creates a new Convoker error.
+   * @param message The message.
+   * @param command The command.
+   */
+  constructor(message: string, command: Command<any>);
+  /**
+   * Prints the error's message.
+   */
+  print(): void;
+}
+/**
+ * When the user asks for help.
+ */
+declare class HelpAskedError extends ConvokerError {
+  /**
+   * Creates a new help asked error.
+   * @param command The command.
+   */
+  constructor(command: Command<any>);
+}
+/**
+ * When you pass too many arguments.
+ */
+declare class TooManyArgumentsError extends ConvokerError {
+  /**
+   * Creates a new too many arguments error.
+   * @param command The command.
+   */
+  constructor(command: Command<any>);
+}
+/**
+ * When you pass an unknown option, when unknown options aren't allowed.
+ */
+declare class UnknownOptionError extends ConvokerError {
+  /**
+   * The option key.
+   */
+  key: string;
+  /**
+   * Creates a new unknown option error.
+   * @param command The command.
+   * @param key The key.
+   */
+  constructor(command: Command<any>, key: string);
+}
+/**
+ * When a required option is missing.
+ */
+declare class MissingRequiredOptionError extends ConvokerError {
+  /**
+   * The option key.
+   */
+  key: string;
+  /**
+   * The option entry.
+   */
+  entry: Option<any, any, any>;
+  /**
+   * Creates a new missing required option error.
+   * @param command The command.
+   * @param key The key.
+   * @param entry The entry.
+   */
+  constructor(command: Command<any>, key: string, entry: Option<any, any, any>);
+}
+declare class MissingRequiredArgumentError extends ConvokerError {
+  /**
+   * The argument key.
+   */
+  key: string;
+  /**
+   * The argument entry.
+   */
+  entry: Positional<any, any, any>;
+  /**
+   * Creates a new missing required argument error.
+   * @param command The command.
+   * @param key The key.
+   * @param entry The entry.
+   */
+  constructor(command: Command<any>, key: string, entry: Positional<any, any, any>);
+}
+//#endregion
+//#region src/command/index.d.ts
+/**
+ * What the command is an alias for.
+ */
+interface CommandAlias<T extends Input = Input> {
+  /**
+   * A pointer to the command.
+   */
+  command: Command<T>;
+  /**
+   * The name of the command this is an alias for.
+   */
+  alias?: string;
+}
+/**
+ * The result of the `Command.parse` function.
+ */
+interface ParseResult<T extends Input> {
+  /**
+   * A pointer to the command to run.
+   */
+  command: Command<T>;
+  /**
+   * The input to pass into the command.
+   */
+  input: InferInput<T>;
+  /**
+   * Errors collected during parsing.
+   */
+  errors: ConvokerError[];
+  /**
+   * If this should result in displaying the version of the command.
+   */
+  isVersion: boolean;
+  /**
+   * If this should result in displaying a help screen.
+   */
+  isHelp: boolean;
+}
+/**
+ * Command action function.
+ */
+type ActionFn<T extends Input> = (input: InferInput<T>) => any | Promise<any>;
+/**
+ * Command middleware function.
+ */
+type MiddlewareFn<T extends Input = Input> = (input: InferInput<T>, next: () => Promise<any>) => any | Promise<any>;
+/**
+ * Command error handler.
+ */
+type ErrorFn<T extends Input> = (command: Command<T>, errors: Error[], input: Partial<InferInput<T>>) => void | Promise<void>;
+/**
+ * Builder for commands.
+ */
+type Builder = (c: Command<any>) => Command<any> | void;
+/**
+ * A command.
+ */
+declare class Command<T extends Input = Input> {
+  /**
+   * The names (aliases) of this command.
+   */
+  $names: string[];
+  /**
+   * The description of this command.
+   */
+  $description: string | undefined;
+  /**
+   * The theme of this command
+   */
+  $theme: Theme | undefined;
+  /**
+   * The version of this command.
+   */
+  $version: string | undefined;
+  /**
+   * The children of this command.
+   */
+  $children: Map<string, CommandAlias>;
+  /**
+   * The parent of this command.
+   */
+  $parent: Command<any> | undefined;
+  /**
+   * If this command allows unknown options.
+   */
+  $allowUnknownOptions: boolean;
+  /**
+   * If you should be able to surpass the amount of positional arguments defined in the input.
+   */
+  $allowSurpassArgLimit: boolean;
+  /**
+   * The input this command takes.
+   */
+  $input: T;
+  /**
+   * The action function of this command.
+   */
+  $fn: ActionFn<T> | undefined;
+  /**
+   * The middlewares associated with this command.
+   */
+  $middlewares: MiddlewareFn<T>[];
+  /**
+   * The error handler of this command.
+   */
+  $errorFn: ErrorFn<T> | undefined;
+  /**
+   * Creates a new command.
+   * @param names The names (aliases).
+   * @param desc The description.
+   * @param version The version.
+   */
+  constructor(names: string | string[], desc?: string, version?: string);
+  /**
+   * Adds a set of aliases to this command.
+   * @param aliases The aliases to add.
+   * @returns this
+   */
+  alias(...aliases: string[]): this;
+  /**
+   * Adds a description to this command.
+   * @param desc The description.
+   * @returns this
+   */
+  description(desc: string): this;
+  /**
+   * Adds a version to this command.
+   * @param version The version.
+   * @returns this
+   */
+  version(version: string): this;
+  /**
+   * Sets the input for this command.
+   * @param version The input.
+   * @returns this
+   */
+  input<TInput extends Input>(input: TInput): Command<TInput>;
+  /**
+   * Adds a chain of middlewares.
+   * @param fns The middlewares to use.
+   * @returns this
+   */
+  use(...fns: MiddlewareFn<T>[]): this;
+  /**
+   * Sets the action function for this command.
+   * @param fn The action.
+   * @returns this
+   */
+  action(fn: ActionFn<T>): this;
+  /**
+   * Sets the error function for this command.
+   * @param fn The error handler.
+   * @returns this
+   */
+  error(fn: ErrorFn<T>): this;
+  /**
+   * Adds existing commands to this.
+   * @param commands The commands.
+   * @returns this
+   */
+  add(...commands: Command<any>[]): this;
+  /**
+   * Creates a new subcommand and adds it.
+   * @param names The aliases of the subcommand.
+   * @param builder A builder to create the command.
+   */
+  subCommand(names: string | string[], builder: Builder): this;
+  /**
+   * Creates a new subcommand and adds it.
+   * @param names The aliases of the subcommand.
+   * @param desc The description of the subcommand.
+   * @param version The version of the subcommand.
+   */
+  subCommand(names: string | string[], desc?: string, version?: string): Command<any>;
+  /**
+   * Allows unknown options.
+   * @returns this
+   */
+  allowUnknownOptions(): this;
+  /**
+   * Parses a set of command-line arguments.
+   * @param argv The arguments to parse.
+   * @returns A parse result.
+   */
+  parse(argv: string[]): Promise<ParseResult<T>>;
+  private buildInputMap;
+  /**
+   * Allows surpassing the amount of arguments specified.
+   * @returns this
+   */
+  allowSurpassArgLimit(): this;
+  /**
+   * Gets the full command path (name including parents).
+   * @returns The full command path.
+   */
+  fullCommandPath(): string;
+  /**
+   * The default error screen.
+   * @param errors The errors.
+   */
+  defaultErrorScreen(errors: Error[]): void;
+  /**
+   * Handles a set of errors.
+   * @param errors The errors to handle.
+   * @param input The parsed input, if possible.
+   * @returns this
+   */
+  handleErrors(errors: Error[], input?: Partial<InferInput<T>>): Promise<this>;
+  /**
+   * Runs a command.
+   * @param argv The arguments to run the command with. Defaults to your runtime's `argv` equivalent.
+   * @returns this
+   */
+  run(argv?: string[]): Promise<this>;
+}
+//#endregion
+export { ErrorFn as a, ConvokerError as c, MissingRequiredOptionError as d, TooManyArgumentsError as f, CommandAlias as i, HelpAskedError as l, Builder as n, MiddlewareFn as o, UnknownOptionError as p, Command as r, ParseResult as s, ActionFn as t, MissingRequiredArgumentError as u };
+//# sourceMappingURL=index-Cnx4H4D-.d.mts.map

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+import { J as DeepPartial, M as index_d_exports, n as Theme } from "./index-BtbthYjp.mjs";
+import "./standard-schema-DXS-QnwX.mjs";
+import { d as index_d_exports$1 } from "./index-ClhbwSD8.mjs";
+import { a as ErrorFn, c as ConvokerError, d as MissingRequiredOptionError, f as TooManyArgumentsError, i as CommandAlias, l as HelpAskedError, n as Builder, o as MiddlewareFn, p as UnknownOptionError, r as Command, s as ParseResult, t as ActionFn, u as MissingRequiredArgumentError } from "./index-Cnx4H4D-.mjs";
+import "./raw-cqTp2vds.mjs";
+import { d as index_d_exports$3 } from "./index-BYLskLxk.mjs";
+import Stream from "node:stream";
+
+//#region src/log/error.d.ts
+declare class WriteError extends Error {
+  constructor(streamName: string);
+}
+declare namespace index_d_exports$2 {
+  export { Config, DEFAULT_CONFIG, WriteError, error, fatal, info, setConfig, setTheme, trace, warn };
+}
+declare function setTheme(theme: Theme): void;
+interface Config {
+  format: "text" | "json";
+  stdout: Stream.Writable;
+  stderr: Stream.Writable;
+  jsonSpace: number;
+}
+declare const DEFAULT_CONFIG: Config;
+declare function setConfig({
+  theme,
+  ...cfg
+}: DeepPartial<Config> & {
+  theme?: Theme;
+}): void;
+declare function trace(...msgs: any[]): void;
+declare function info(...msgs: any[]): void;
+declare function warn(...msgs: any[]): void;
+declare function error(...msgs: any[]): void;
+declare function fatal(...msgs: any[]): void;
+//#endregion
+export { ActionFn, Builder, Command, CommandAlias, ConvokerError, ErrorFn, HelpAskedError, MiddlewareFn, MissingRequiredArgumentError, MissingRequiredOptionError, ParseResult, TooManyArgumentsError, UnknownOptionError, index_d_exports as color, index_d_exports$1 as i, index_d_exports$2 as log, index_d_exports$3 as prompt };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,92 @@
+import { t as __export } from "./chunk-z5eko27R.mjs";
+import { S as color_exports, q as merge, t as DEFAULT_THEME } from "./color-DiZvJ0Fc.mjs";
+import "./standard-schema-DTuaYJjO.mjs";
+import "./raw-DEtZFeMv.mjs";
+import { a as prompt_exports } from "./prompt-a5Ix_Hyc.mjs";
+import { a as MissingRequiredOptionError, i as MissingRequiredArgumentError, n as ConvokerError, o as TooManyArgumentsError, r as HelpAskedError, s as UnknownOptionError, t as Command } from "./command-8P8qXJ2o.mjs";
+import { a as input_exports } from "./input-XUsy1LCQ.mjs";
+import process from "node:process";
+
+//#region src/log/error.ts
+var WriteError = class extends Error {
+	constructor(streamName) {
+		super(`Could not write to \`${streamName}\`.`);
+	}
+};
+
+//#endregion
+//#region src/log/index.ts
+var log_exports = /* @__PURE__ */ __export({
+	DEFAULT_CONFIG: () => DEFAULT_CONFIG,
+	WriteError: () => WriteError,
+	error: () => error,
+	fatal: () => fatal,
+	info: () => info,
+	setConfig: () => setConfig,
+	setTheme: () => setTheme,
+	trace: () => trace,
+	warn: () => warn
+});
+let th = DEFAULT_THEME;
+function setTheme(theme) {
+	th = theme;
+}
+const DEFAULT_CONFIG = {
+	format: "text",
+	stderr: process.stderr,
+	stdout: process.stdout,
+	jsonSpace: 2
+};
+let config = DEFAULT_CONFIG;
+function setConfig({ theme,...cfg }) {
+	config = merge(DEFAULT_CONFIG, cfg);
+	th = theme ?? th;
+}
+function trace(...msgs) {
+	const str = format(msgs, "TRACE");
+	if (!config.stdout.write(str)) throw new WriteError("stdout");
+}
+function info(...msgs) {
+	const str = format(msgs, "INFO");
+	if (!config.stdout.write(str)) throw new WriteError("stdout");
+}
+function warn(...msgs) {
+	const str = format(msgs, "WARN");
+	if (!config.stderr.write(th.warning(str))) throw new WriteError("stderr");
+}
+function error(...msgs) {
+	const str = format(msgs, "ERROR");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
+}
+function fatal(...msgs) {
+	const str = format(msgs, "FATAL");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
+	process.exit(-1);
+}
+function format(msgs, level) {
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const msg = msgs.map((m) => typeof m === "string" ? m : JSON.stringify(m, null, config.jsonSpace)).join(" ");
+	switch (config.format) {
+		case "json": return colorize(JSON.stringify({
+			timestamp,
+			level,
+			message: msg
+		}) + "\n", level);
+		case "text":
+		default: return colorize(`[${timestamp}] [${th.symbols[level] ?? level}] ${msg}\n`, level);
+	}
+}
+function colorize(str, level) {
+	switch (level) {
+		case "TRACE": return th.secondary(str);
+		case "WARN": return th.warning(str);
+		case "ERROR": return th.error(str);
+		case "FATAL": return th.styles?.bold ? th.styles.bold(th.error(str)) : th.error(str);
+		case "INFO":
+		default: return th.info?.(str) ?? str;
+	}
+}
+
+//#endregion
+export { Command, ConvokerError, HelpAskedError, MissingRequiredArgumentError, MissingRequiredOptionError, TooManyArgumentsError, UnknownOptionError, color_exports as color, input_exports as i, log_exports as log, prompt_exports as prompt };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["th: Theme","DEFAULT_CONFIG: Config","config: Config"],"sources":["../src/log/error.ts","../src/log/index.ts"],"sourcesContent":["export class WriteError extends Error {\n  constructor(streamName: string) {\n    super(`Could not write to \\`${streamName}\\`.`);\n  }\n}\n","import Stream from \"node:stream\";\nimport process from \"node:process\";\nimport { DEFAULT_THEME, type Theme } from \"@/color\";\nimport { DeepPartial, merge } from \"@/utils\";\nimport { WriteError } from \"./error\";\n\nlet th: Theme = DEFAULT_THEME;\n\nexport function setTheme(theme: Theme) {\n  th = theme;\n}\n\nexport interface Config {\n  format: \"text\" | \"json\";\n  stdout: Stream.Writable;\n  stderr: Stream.Writable;\n  jsonSpace: number;\n}\n\nexport const DEFAULT_CONFIG: Config = {\n  format: \"text\",\n  stderr: process.stderr,\n  stdout: process.stdout,\n  jsonSpace: 2,\n};\n\nlet config: Config = DEFAULT_CONFIG;\n\nexport function setConfig({\n  theme,\n  ...cfg\n}: DeepPartial<Config> & { theme?: Theme }) {\n  config = merge(DEFAULT_CONFIG, cfg);\n  th = theme ?? th;\n}\n\nexport function trace(...msgs: any[]) {\n  const str = format(msgs, \"TRACE\");\n  if (!config.stdout.write(str)) {\n    throw new WriteError(\"stdout\");\n  }\n}\n\nexport function info(...msgs: any[]) {\n  const str = format(msgs, \"INFO\");\n  if (!config.stdout.write(str)) {\n    throw new WriteError(\"stdout\");\n  }\n}\n\nexport function warn(...msgs: any[]) {\n  const str = format(msgs, \"WARN\");\n  if (!config.stderr.write(th.warning(str))) {\n    throw new WriteError(\"stderr\");\n  }\n}\n\nexport function error(...msgs: any[]) {\n  const str = format(msgs, \"ERROR\");\n  if (!config.stderr.write(str)) {\n    throw new WriteError(\"stderr\");\n  }\n}\n\nexport function fatal(...msgs: any[]) {\n  const str = format(msgs, \"FATAL\");\n  if (!config.stderr.write(str)) {\n    throw new WriteError(\"stderr\");\n  }\n\n  process.exit(-1);\n}\n\nexport * from \"./error\";\n\nfunction format(msgs: any[], level: string): string {\n  const timestamp = new Date().toISOString();\n  const msg = msgs\n    .map((m) =>\n      typeof m === \"string\" ? m : JSON.stringify(m, null, config.jsonSpace),\n    )\n    .join(\" \");\n  switch (config.format) {\n    case \"json\":\n      return colorize(\n        JSON.stringify({ timestamp, level, message: msg }) + \"\\n\",\n        level,\n      );\n    case \"text\":\n    default:\n      return colorize(\n        `[${timestamp}] [${(th.symbols as any)[level] ?? level}] ${msg}\\n`,\n        level,\n      );\n  }\n}\n\nfunction colorize(str: string, level: string) {\n  switch (level) {\n    case \"TRACE\":\n      return th.secondary(str);\n    case \"WARN\":\n      return th.warning(str);\n    case \"ERROR\":\n      return th.error(str);\n    case \"FATAL\":\n      return th.styles?.bold ? th.styles.bold(th.error(str)) : th.error(str);\n    case \"INFO\":\n    default:\n      return th.info?.(str) ?? str;\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA,IAAa,aAAb,cAAgC,MAAM;CACpC,YAAY,YAAoB;AAC9B,QAAM,wBAAwB,WAAW,KAAK;;;;;;;;;;;;;;;;;ACIlD,IAAIA,KAAY;AAEhB,SAAgB,SAAS,OAAc;AACrC,MAAK;;AAUP,MAAaC,iBAAyB;CACpC,QAAQ;CACR,QAAQ,QAAQ;CAChB,QAAQ,QAAQ;CAChB,WAAW;CACZ;AAED,IAAIC,SAAiB;AAErB,SAAgB,UAAU,EACxB,MACA,GAAG,OACuC;AAC1C,UAAS,MAAM,gBAAgB,IAAI;AACnC,MAAK,SAAS;;AAGhB,SAAgB,MAAM,GAAG,MAAa;CACpC,MAAM,MAAM,OAAO,MAAM,QAAQ;AACjC,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAC3B,OAAM,IAAI,WAAW,SAAS;;AAIlC,SAAgB,KAAK,GAAG,MAAa;CACnC,MAAM,MAAM,OAAO,MAAM,OAAO;AAChC,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAC3B,OAAM,IAAI,WAAW,SAAS;;AAIlC,SAAgB,KAAK,GAAG,MAAa;CACnC,MAAM,MAAM,OAAO,MAAM,OAAO;AAChC,KAAI,CAAC,OAAO,OAAO,MAAM,GAAG,QAAQ,IAAI,CAAC,CACvC,OAAM,IAAI,WAAW,SAAS;;AAIlC,SAAgB,MAAM,GAAG,MAAa;CACpC,MAAM,MAAM,OAAO,MAAM,QAAQ;AACjC,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAC3B,OAAM,IAAI,WAAW,SAAS;;AAIlC,SAAgB,MAAM,GAAG,MAAa;CACpC,MAAM,MAAM,OAAO,MAAM,QAAQ;AACjC,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAC3B,OAAM,IAAI,WAAW,SAAS;AAGhC,SAAQ,KAAK,GAAG;;AAKlB,SAAS,OAAO,MAAa,OAAuB;CAClD,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa;CAC1C,MAAM,MAAM,KACT,KAAK,MACJ,OAAO,MAAM,WAAW,IAAI,KAAK,UAAU,GAAG,MAAM,OAAO,UAAU,CACtE,CACA,KAAK,IAAI;AACZ,SAAQ,OAAO,QAAf;EACE,KAAK,OACH,QAAO,SACL,KAAK,UAAU;GAAE;GAAW;GAAO,SAAS;GAAK,CAAC,GAAG,MACrD,MACD;EACH,KAAK;EACL,QACE,QAAO,SACL,IAAI,UAAU,KAAM,GAAG,QAAgB,UAAU,MAAM,IAAI,IAAI,KAC/D,MACD;;;AAIP,SAAS,SAAS,KAAa,OAAe;AAC5C,SAAQ,OAAR;EACE,KAAK,QACH,QAAO,GAAG,UAAU,IAAI;EAC1B,KAAK,OACH,QAAO,GAAG,QAAQ,IAAI;EACxB,KAAK,QACH,QAAO,GAAG,MAAM,IAAI;EACtB,KAAK,QACH,QAAO,GAAG,QAAQ,OAAO,GAAG,OAAO,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI;EACxE,KAAK;EACL,QACE,QAAO,GAAG,OAAO,IAAI,IAAI"}

package/dist/input/index.d.mts

@@ -0,0 +1,3 @@
+import "../standard-schema-DXS-QnwX.mjs";
+import { a as Kind, c as TypeOf, f as option, i as Input, l as argument, m as InputValidationError, n as InferEntry, o as Option, p as positional, r as InferInput, s as Positional, t as BasicKind, u as convert } from "../index-ClhbwSD8.mjs";
+export { BasicKind, InferEntry, InferInput, Input, InputValidationError, Kind, Option, Positional, TypeOf, argument, convert, option, positional };

package/dist/input/index.mjs

@@ -0,0 +1,4 @@
+import { n as InputValidationError } from "../standard-schema-DTuaYJjO.mjs";
+import { i as convert, n as Positional, o as option, r as argument, s as positional, t as Option } from "../input-XUsy1LCQ.mjs";
+
+export { InputValidationError, Option, Positional, argument, convert, option, positional };

package/dist/input-XUsy1LCQ.mjs

@@ -0,0 +1,176 @@
+import { t as __export } from "./chunk-z5eko27R.mjs";
+import { n as InputValidationError, t as validate } from "./standard-schema-DTuaYJjO.mjs";
+
+//#region src/input/index.ts
+var input_exports = /* @__PURE__ */ __export({
+	InputValidationError: () => InputValidationError,
+	Option: () => Option,
+	Positional: () => Positional,
+	argument: () => argument,
+	convert: () => convert,
+	option: () => option,
+	positional: () => positional
+});
+/**
+* Converts a value from a Kind to a TypeScript type.
+* @param kind The kind to convert to.
+* @param value The value to convert.
+* @returns The converted value.
+*/
+async function convert(kind, value) {
+	async function convertOne(val) {
+		if (typeof kind === "string") switch (kind) {
+			case "boolean": return val === "true";
+			case "bigint": return BigInt(val);
+			case "number": return parseFloat(val);
+			case "string": return val;
+		}
+		return validate(kind, val);
+	}
+	if (Array.isArray(value)) return await Promise.all(value.map((v) => convertOne(v)));
+	return convertOne(value);
+}
+/**
+* An option.
+*/
+var Option = class {
+	/**
+	* Creates a new option.
+	* @param kind The type of this option.
+	* @param names The names of this option.
+	*/
+	constructor(kind, names) {
+		this.$required = true;
+		this.$list = false;
+		this.$kind = kind;
+		this.$names = names.map((name) => name.replace(/^-+/, ""));
+	}
+	/**
+	* Makes this option a list.
+	* @returns this
+	*/
+	list(separator) {
+		this.$list = true;
+		this.$separator = separator ?? this.$separator;
+		return this;
+	}
+	/**
+	* Makes this option required.
+	* @returns this
+	*/
+	required() {
+		this.$required = true;
+		return this;
+	}
+	/**
+	* Makes this option optional.
+	* @returns this
+	*/
+	optional() {
+		this.$required = false;
+		return this;
+	}
+	/**
+	* Sets a default value.
+	* @param value The default value.
+	* @returns this
+	*/
+	default(value) {
+		this.$default = value;
+		return this;
+	}
+	/**
+	* Sets a description.
+	* @param desc The description.
+	* @returns this
+	*/
+	description(desc) {
+		this.$description = desc;
+		return this;
+	}
+};
+/**
+* A positional argument.
+*/
+var Positional = class {
+	/**
+	* Creates a new positional argument.
+	* @param kind The positional argument.
+	*/
+	constructor(kind) {
+		this.$required = true;
+		this.$list = false;
+		this.$kind = kind;
+	}
+	/**
+	* Makes this argument a list.
+	* @returns this
+	*/
+	list() {
+		this.$list = true;
+		return this;
+	}
+	/**
+	* Makes this argument required.
+	* @returns this
+	*/
+	required() {
+		this.$required = true;
+		return this;
+	}
+	/**
+	* Makes this argument optional.
+	* @returns this
+	*/
+	optional() {
+		this.$required = false;
+		return this;
+	}
+	/**
+	* Sets a default value.
+	* @param value The default value.
+	* @returns this
+	*/
+	default(value) {
+		this.$default = value;
+		return this;
+	}
+	/**
+	* Sets a description.
+	* @param desc The description.
+	* @returns this
+	*/
+	description(desc) {
+		this.$description = desc;
+		return this;
+	}
+};
+/**
+* Creates a new option.
+* @param kind The kind of option.
+* @param names The names of the option.
+* @returns A new option.
+*/
+function option(kind, ...names) {
+	return new Option(kind, names);
+}
+/**
+* Creates a new positional argument.
+* @param kind The kind of positional argument.
+* @returns A new positional argument.
+*/
+function positional(kind) {
+	return new Positional(kind);
+}
+/**
+* Creates a new positional argument.
+* @param kind The kind of positional argument.
+* @returns A new positional argument.
+*/
+function argument(kind) {
+	return new Positional(kind);
+}
+
+//#endregion
+export { input_exports as a, convert as i, Positional as n, option as o, argument as r, positional as s, Option as t };
+//# sourceMappingURL=input-XUsy1LCQ.mjs.map

package/dist/input-XUsy1LCQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-XUsy1LCQ.mjs","names":[],"sources":["../src/input/index.ts"],"sourcesContent":["import { validate, type StandardSchemaV1 } from \"./standard-schema\";\n\n/**\n * An input object.\n */\nexport interface Input {\n  [x: string]: Option<any, any, any> | Positional<any, any, any>;\n}\n\n/**\n * A basic input type.\n */\nexport type BasicKind = \"boolean\" | \"string\" | \"number\" | \"bigint\";\n/**\n * An input type.\n */\nexport type Kind = BasicKind | StandardSchemaV1<any, any>;\n\n/**\n * Converts a Kind to a TypeScript type.\n */\nexport type TypeOf<T extends Kind> =\n  T extends StandardSchemaV1<any, infer Out>\n    ? Out\n    : T extends \"boolean\"\n      ? boolean\n      : T extends \"string\"\n        ? string\n        : T extends \"number\"\n          ? number\n          : T extends \"bigint\"\n            ? bigint\n            : never;\n\n/**\n * Infers TypeScript types from an input object.\n */\nexport type InferInput<T extends Input> = {\n  [K in keyof T]: InferEntry<T[K]>;\n};\n\n/**\n * Infers a TypeScript type from an option or positional.\n */\nexport type InferEntry<T> = T extends {\n  $kind: infer TKind extends Kind;\n  $required: infer Required;\n  $list: infer List;\n}\n  ? List extends true\n    ? Required extends true\n      ? TypeOf<TKind>[]\n      : TypeOf<TKind>[] | undefined\n    : Required extends true\n      ? TypeOf<TKind>\n      : TypeOf<TKind> | undefined\n  : never;\n\n/**\n * Converts a value from a Kind to a TypeScript type.\n * @param kind The kind to convert to.\n * @param value The value to convert.\n * @returns The converted value.\n */\nexport async function convert<TKind extends Kind>(\n  kind: TKind,\n  value: string | string[],\n): Promise<TypeOf<TKind> | TypeOf<TKind>[]> {\n  // Helper for single value conversion\n  async function convertOne(val: string): Promise<TypeOf<TKind>> {\n    if (typeof kind === \"string\") {\n      switch (kind) {\n        case \"boolean\":\n          return (val === \"true\") as any;\n        case \"bigint\":\n          return BigInt(val) as any;\n        case \"number\":\n          return parseFloat(val) as any;\n        case \"string\":\n          return val as any;\n      }\n    }\n    // Otherwise, Standard Schema\n    return validate(kind, val);\n  }\n\n  // If list → map each item\n  if (Array.isArray(value)) {\n    const results = await Promise.all(value.map((v) => convertOne(v)));\n    return results as any;\n  }\n\n  // Single value case\n  return convertOne(value);\n}\n\n/**\n * An option.\n */\nexport class Option<\n  TKind extends Kind,\n  TRequired extends boolean = true,\n  TList extends boolean = false,\n> {\n  /**\n   * The kind of this option.\n   */\n  $kind: TKind;\n  /**\n   * The aliases of this option.\n   */\n  $names: string[];\n  /**\n   * The description of this option.\n   */\n  $description: string | undefined;\n  /**\n   * The default value of this option.\n   */\n  $default: TypeOf<TKind> | undefined;\n  /**\n   * If this option is required.\n   */\n  $required: TRequired = true as TRequired;\n  /**\n   * If this option is a list.\n   */\n  $list: TList = false as TList;\n  /**\n   * A separator if this option is a list.\n   */\n  $separator: string | undefined;\n\n  /**\n   * Creates a new option.\n   * @param kind The type of this option.\n   * @param names The names of this option.\n   */\n  constructor(kind: TKind, names: string[]) {\n    this.$kind = kind;\n    this.$names = names.map((name) => name.replace(/^-+/, \"\"));\n  }\n\n  /**\n   * Makes this option a list.\n   * @returns this\n   */\n  list(separator?: string): Option<TKind, TRequired, true> {\n    this.$list = true as TList;\n    this.$separator = separator ?? this.$separator;\n    return this as any;\n  }\n\n  /**\n   * Makes this option required.\n   * @returns this\n   */\n  required(): Option<TKind, true, TList> {\n    this.$required = true as TRequired;\n    return this as any;\n  }\n\n  /**\n   * Makes this option optional.\n   * @returns this\n   */\n  optional(): Option<TKind, false, TList> {\n    this.$required = false as TRequired;\n    return this as any;\n  }\n\n  /**\n   * Sets a default value.\n   * @param value The default value.\n   * @returns this\n   */\n  default(value: TypeOf<TKind>): this {\n    this.$default = value;\n    return this;\n  }\n\n  /**\n   * Sets a description.\n   * @param desc The description.\n   * @returns this\n   */\n  description(desc: string): this {\n    this.$description = desc;\n    return this;\n  }\n}\n\n/**\n * A positional argument.\n */\nexport class Positional<\n  TKind extends Kind,\n  TRequired extends boolean = true,\n  TList extends boolean = false,\n> {\n  /**\n   * The type of this argument.\n   */\n  $kind: TKind;\n  /**\n   * The default value of this argument.\n   */\n  $default: TypeOf<TKind> | undefined;\n  /**\n   * The description of this argument.\n   */\n  $description: string | undefined;\n  /**\n   * If this argument is required.\n   */\n  $required: TRequired = true as TRequired;\n  /**\n   * If this argument is a list.\n   */\n  $list: TList = false as TList;\n\n  /**\n   * Creates a new positional argument.\n   * @param kind The positional argument.\n   */\n  constructor(kind: TKind) {\n    this.$kind = kind;\n  }\n\n  /**\n   * Makes this argument a list.\n   * @returns this\n   */\n  list(): Positional<TKind, TRequired, true> {\n    this.$list = true as TList;\n    return this as any;\n  }\n\n  /**\n   * Makes this argument required.\n   * @returns this\n   */\n  required(): Positional<TKind, true, TList> {\n    this.$required = true as TRequired;\n    return this as any;\n  }\n\n  /**\n   * Makes this argument optional.\n   * @returns this\n   */\n  optional(): Positional<TKind, false, TList> {\n    this.$required = false as TRequired;\n    return this as any;\n  }\n\n  /**\n   * Sets a default value.\n   * @param value The default value.\n   * @returns this\n   */\n  default(value: TypeOf<TKind>): this {\n    this.$default = value;\n    return this;\n  }\n\n  /**\n   * Sets a description.\n   * @param desc The description.\n   * @returns this\n   */\n  description(desc: string): this {\n    this.$description = desc;\n    return this;\n  }\n}\n\n/**\n * Creates a new option.\n * @param kind The kind of option.\n * @param names The names of the option.\n * @returns A new option.\n */\nexport function option<T extends Kind>(kind: T, ...names: string[]): Option<T> {\n  return new Option(kind, names);\n}\n\n/**\n * Creates a new positional argument.\n * @param kind The kind of positional argument.\n * @returns A new positional argument.\n */\nexport function positional<T extends Kind>(kind: T): Positional<T> {\n  return new Positional(kind);\n}\n\n/**\n * Creates a new positional argument.\n * @param kind The kind of positional argument.\n * @returns A new positional argument.\n */\nexport function argument<T extends Kind>(kind: T): Positional<T> {\n  return new Positional(kind);\n}\n\nexport * from \"./error\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgEA,eAAsB,QACpB,MACA,OAC0C;CAE1C,eAAe,WAAW,KAAqC;AAC7D,MAAI,OAAO,SAAS,SAClB,SAAQ,MAAR;GACE,KAAK,UACH,QAAQ,QAAQ;GAClB,KAAK,SACH,QAAO,OAAO,IAAI;GACpB,KAAK,SACH,QAAO,WAAW,IAAI;GACxB,KAAK,SACH,QAAO;;AAIb,SAAO,SAAS,MAAM,IAAI;;AAI5B,KAAI,MAAM,QAAQ,MAAM,CAEtB,QADgB,MAAM,QAAQ,IAAI,MAAM,KAAK,MAAM,WAAW,EAAE,CAAC,CAAC;AAKpE,QAAO,WAAW,MAAM;;;;;AAM1B,IAAa,SAAb,MAIE;;;;;;CAmCA,YAAY,MAAa,OAAiB;mBAfnB;eAIR;AAYb,OAAK,QAAQ;AACb,OAAK,SAAS,MAAM,KAAK,SAAS,KAAK,QAAQ,OAAO,GAAG,CAAC;;;;;;CAO5D,KAAK,WAAoD;AACvD,OAAK,QAAQ;AACb,OAAK,aAAa,aAAa,KAAK;AACpC,SAAO;;;;;;CAOT,WAAuC;AACrC,OAAK,YAAY;AACjB,SAAO;;;;;;CAOT,WAAwC;AACtC,OAAK,YAAY;AACjB,SAAO;;;;;;;CAQT,QAAQ,OAA4B;AAClC,OAAK,WAAW;AAChB,SAAO;;;;;;;CAQT,YAAY,MAAoB;AAC9B,OAAK,eAAe;AACpB,SAAO;;;;;;AAOX,IAAa,aAAb,MAIE;;;;;CA0BA,YAAY,MAAa;mBAVF;eAIR;AAOb,OAAK,QAAQ;;;;;;CAOf,OAA2C;AACzC,OAAK,QAAQ;AACb,SAAO;;;;;;CAOT,WAA2C;AACzC,OAAK,YAAY;AACjB,SAAO;;;;;;CAOT,WAA4C;AAC1C,OAAK,YAAY;AACjB,SAAO;;;;;;;CAQT,QAAQ,OAA4B;AAClC,OAAK,WAAW;AAChB,SAAO;;;;;;;CAQT,YAAY,MAAoB;AAC9B,OAAK,eAAe;AACpB,SAAO;;;;;;;;;AAUX,SAAgB,OAAuB,MAAS,GAAG,OAA4B;AAC7E,QAAO,IAAI,OAAO,MAAM,MAAM;;;;;;;AAQhC,SAAgB,WAA2B,MAAwB;AACjE,QAAO,IAAI,WAAW,KAAK;;;;;;;AAQ7B,SAAgB,SAAyB,MAAwB;AAC/D,QAAO,IAAI,WAAW,KAAK"}

package/dist/prompt/index.d.mts

@@ -0,0 +1,5 @@
+import "../index-BtbthYjp.mjs";
+import "../standard-schema-DXS-QnwX.mjs";
+import { i as raw_d_exports } from "../raw-cqTp2vds.mjs";
+import { _ as text, a as SearchOpts, c as TextOpts, f as multiselect, g as setTheme, h as select, i as PasswordOpts, l as confirm, m as search, n as ConfirmOpts, o as SelectOption, p as password, r as EditorOpts, s as SelectOpts, t as BaseOpts, u as editor } from "../index-BYLskLxk.mjs";
+export { BaseOpts, ConfirmOpts, EditorOpts, PasswordOpts, SearchOpts, SelectOption, SelectOpts, TextOpts, confirm, editor, multiselect, password, raw_d_exports as raw, search, select, setTheme, text };

package/dist/prompt/index.mjs

@@ -0,0 +1,6 @@
+import "../color-DiZvJ0Fc.mjs";
+import "../standard-schema-DTuaYJjO.mjs";
+import { i as raw_exports } from "../raw-DEtZFeMv.mjs";
+import { c as setTheme, i as password, l as text, n as editor, o as search, r as multiselect, s as select, t as confirm } from "../prompt-a5Ix_Hyc.mjs";
+
+export { confirm, editor, multiselect, password, raw_exports as raw, search, select, setTheme, text };

package/dist/prompt/raw.d.mts

@@ -0,0 +1,2 @@
+import { a as readKey, n as cursorDown, o as readLine, r as cursorUp, t as clearLines } from "../raw-cqTp2vds.mjs";
+export { clearLines, cursorDown, cursorUp, readKey, readLine };

package/dist/prompt/raw.mjs

@@ -0,0 +1,3 @@
+import { a as readKey, n as cursorDown, o as readLine, r as cursorUp, t as clearLines } from "../raw-DEtZFeMv.mjs";
+
+export { clearLines, cursorDown, cursorUp, readKey, readLine };