convoker 0.3.4 → 0.4.0

package/dist/standard-schema-DTuaYJjO.mjs

@@ -0,0 +1,32 @@
+//#region src/input/error.ts
+/**
+* Thrown when the command fails to validate an input.
+*/
+var InputValidationError = class extends Error {
+	/**
+	* Creates a new input validation error.
+	* @param messages The messages.
+	*/
+	constructor(messages) {
+		super(`Validation failed: ${messages.join(", ")}`);
+		this.messages = messages;
+	}
+};
+
+//#endregion
+//#region src/input/standard-schema.ts
+/**
+* Validates a value.
+* @param entry The Standard Schema validator.
+* @param value The value to validate.
+* @returns The validated value.
+*/
+async function validate(entry, value) {
+	const result = await entry["~standard"].validate(value);
+	if (result.issues) throw new InputValidationError(result.issues.map((i) => i.message));
+	return result.value;
+}
+
+//#endregion
+export { InputValidationError as n, validate as t };
+//# sourceMappingURL=standard-schema-DTuaYJjO.mjs.map

package/dist/standard-schema-DTuaYJjO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema-DTuaYJjO.mjs","names":[],"sources":["../src/input/error.ts","../src/input/standard-schema.ts"],"sourcesContent":["/**\n * Thrown when the command fails to validate an input.\n */\nexport class InputValidationError extends Error {\n  /**\n   * A list of messages.\n   */\n  messages: string[];\n\n  /**\n   * Creates a new input validation error.\n   * @param messages The messages.\n   */\n  constructor(messages: string[]) {\n    super(`Validation failed: ${messages.join(\", \")}`);\n    this.messages = messages;\n  }\n}\n","// * https://standardschema.dev * //\n\nimport { InputValidationError } from \"./error\";\n\n/** The Standard Schema interface. */\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  /** The Standard Schema properties. */\n  readonly \"~standard\": StandardSchemaV1.Props<Input, Output>;\n}\n\n// eslint-disable-next-line -- this is Standard Schema\nexport declare namespace StandardSchemaV1 {\n  /** The Standard Schema properties interface. */\n  export interface Props<Input = unknown, Output = Input> {\n    /** The version number of the standard. */\n    readonly version: 1;\n    /** The vendor name of the schema library. */\n    readonly vendor: string;\n    /** Validates unknown input values. */\n    readonly validate: (\n      value: unknown,\n    ) => Result<Output> | Promise<Result<Output>>;\n    /** Inferred types associated with the schema. */\n    readonly types?: Types<Input, Output> | undefined;\n  }\n\n  /** The result interface of the validate function. */\n  export type Result<Output> = SuccessResult<Output> | FailureResult;\n\n  /** The result interface if validation succeeds. */\n  export interface SuccessResult<Output> {\n    /** The typed output value. */\n    readonly value: Output;\n    /** The non-existent issues. */\n    readonly issues?: undefined;\n  }\n\n  /** The result interface if validation fails. */\n  export interface FailureResult {\n    /** The issues of failed validation. */\n    readonly issues: ReadonlyArray<Issue>;\n  }\n\n  /** The issue interface of the failure output. */\n  export interface Issue {\n    /** The error message of the issue. */\n    readonly message: string;\n    /** The path of the issue, if any. */\n    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;\n  }\n\n  /** The path segment interface of the issue. */\n  export interface PathSegment {\n    /** The key representing a path segment. */\n    readonly key: PropertyKey;\n  }\n\n  /** The Standard Schema types interface. */\n  export interface Types<Input = unknown, Output = Input> {\n    /** The input type of the schema. */\n    readonly input: Input;\n    /** The output type of the schema. */\n    readonly output: Output;\n  }\n\n  /** Infers the input type of a Standard Schema. */\n  export type InferInput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema[\"~standard\"][\"types\"]\n  >[\"input\"];\n\n  /** Infers the output type of a Standard Schema. */\n  export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema[\"~standard\"][\"types\"]\n  >[\"output\"];\n}\n\n/**\n * Validates a value.\n * @param entry The Standard Schema validator.\n * @param value The value to validate.\n * @returns The validated value.\n */\nexport async function validate<T extends StandardSchemaV1<any, any>>(\n  entry: T,\n  value: any,\n): Promise<T extends StandardSchemaV1<any, infer Out> ? Out : never> {\n  const result = await entry[\"~standard\"].validate(value);\n  if (result.issues) {\n    const msgs = result.issues.map((i) => i.message);\n    throw new InputValidationError(msgs);\n  }\n\n  return result.value;\n}\n"],"mappings":";;;;AAGA,IAAa,uBAAb,cAA0C,MAAM;;;;;CAU9C,YAAY,UAAoB;AAC9B,QAAM,sBAAsB,SAAS,KAAK,KAAK,GAAG;AAClD,OAAK,WAAW;;;;;;;;;;;;ACmEpB,eAAsB,SACpB,OACA,OACmE;CACnE,MAAM,SAAS,MAAM,MAAM,aAAa,SAAS,MAAM;AACvD,KAAI,OAAO,OAET,OAAM,IAAI,qBADG,OAAO,OAAO,KAAK,MAAM,EAAE,QAAQ,CACZ;AAGtC,QAAO,OAAO"}

package/dist/{standard-schema-DLeKaehR.d.mts → standard-schema-DXS-QnwX.d.mts}

@@ -1,4 +1,4 @@
-//#region src/standard-schema.d.ts
+//#region src/input/standard-schema.d.ts
 /** The Standard Schema interface. */
 interface StandardSchemaV1<Input = unknown, Output = Input> {
   /** The Standard Schema properties. */
@@ -55,4 +55,5 @@ declare namespace StandardSchemaV1 {
   type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 }
 //#endregion
-export { StandardSchemaV1 as t };
+export { StandardSchemaV1 as t };
+//# sourceMappingURL=standard-schema-DXS-QnwX.d.mts.map

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "convoker",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "A simple, type safe CLI framework for TypeScript.",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/trailfrost/convoker"
+    "url": "git+https://github.com/sprucepad/convoker"
   },
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -14,16 +14,16 @@
       "import": "./dist/index.mjs"
     },
     "./command": {
-      "types": "./dist/command.d.mts",
-      "import": "./dist/command.mjs"
+      "types": "./dist/command/index.d.mts",
+      "import": "./dist/command/index.mjs"
     },
     "./input": {
-      "types": "./dist/types.d.mts",
-      "import": "./dist/input.mjs"
+      "types": "./dist/input/index.d.mts",
+      "import": "./dist/input/index.mjs"
     },
     "./color": {
-      "types": "./dist/color.d.mts",
-      "import": "./dist/color.mjs"
+      "types": "./dist/color/index.d.mts",
+      "import": "./dist/color/index.mjs"
     },
     "./prompt": {
       "types": "./dist/prompt/index.d.mts",
@@ -32,10 +32,6 @@
     "./prompt/raw": {
       "types": "./dist/prompt/raw.d.mts",
       "import": "./dist/prompt/raw.mjs"
-    },
-    "./error": {
-      "types": "./dist/error.d.mts",
-      "import": "./dist/error.mjs"
     }
   },
   "type": "module",
@@ -49,10 +45,11 @@
     "argv",
     "option"
   ],
-  "author": "trailfrost",
+  "author": "sprucepad",
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "^9.36.0",
+    "@types/node": "~20.19.30",
     "eslint": "^9.36.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
@@ -63,12 +60,12 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "test": "vitest tests",
+    "test": "vitest",
     "build": "tsdown",
-    "check": "tsc -b tsconfig.app.json",
+    "check": "tsc",
     "format": "prettier --check .",
-    "format!": "prettier --write .",
+    "format:fix": "prettier --write .",
     "lint": "eslint .",
-    "lint!": "eslint --fix ."
+    "lint:fix": "eslint --fix ."
   }
 }

package/dist/color.d.mts

@@ -1,2 +0,0 @@
-import { A as green, B as reset, D as defineTheme, E as cyanBright, F as magenta, G as whiteBright, H as supportsColor, I as magentaBright, K as yellow, L as overline, M as hidden, N as inverse, O as dim, P as italic, R as red, S as bold, T as cyan, U as underline, V as strikethrough, W as white, _ as bgYellow, a as bgBlueBright, b as blue, c as bgGray, d as bgMagenta, f as bgMagentaBright, g as bgWhiteBright, h as bgWhite, i as bgBlue, j as greenBright, k as gray, l as bgGreen, m as bgRedBright, n as Theme, o as bgCyan, p as bgRed, q as yellowBright, r as bgBlack, s as bgCyanBright, t as DEFAULT_THEME, u as bgGreenBright, v as bgYellowBright, w as createAnsiColor, x as blueBright, y as black, z as redBright } from "./color-BuHvMolk.mjs";
-export { DEFAULT_THEME, Theme, bgBlack, bgBlue, bgBlueBright, bgCyan, bgCyanBright, bgGray, bgGreen, bgGreenBright, bgMagenta, bgMagentaBright, bgRed, bgRedBright, bgWhite, bgWhiteBright, bgYellow, bgYellowBright, black, blue, blueBright, bold, createAnsiColor, cyan, cyanBright, defineTheme, dim, gray, green, greenBright, hidden, inverse, italic, magenta, magentaBright, overline, red, redBright, reset, strikethrough, supportsColor, underline, white, whiteBright, yellow, yellowBright };

package/dist/command.d.mts

@@ -1,5 +0,0 @@
-import "./color-BuHvMolk.mjs";
-import "./standard-schema-DLeKaehR.mjs";
-import "./input-B12iaqb8.mjs";
-import { a as ErrorFn, i as CommandAlias, n as Builder, o as MiddlewareFn, r as Command, s as ParseResult, t as ActionFn } from "./command-BXmfoT-l.mjs";
-export { ActionFn, Builder, Command, CommandAlias, ErrorFn, MiddlewareFn, ParseResult };

package/dist/command.mjs

@@ -1,10 +0,0 @@
-import "./utils-ChmY93uA.mjs";
-import "./color-OlJQTTxb.mjs";
-import "./error-C1S1gs8L.mjs";
-import "./standard-schema-DBXbMy6L.mjs";
-import "./raw--889icsd.mjs";
-import "./prompt-Cvufljin.mjs";
-import { t as Command } from "./command-D2UiQBNA.mjs";
-import "./input-DRy_sVxZ.mjs";
-
-export { Command };

package/dist/error-C1S1gs8L.mjs

@@ -1,115 +0,0 @@
-import { t as __export } from "./chunk-z5eko27R.mjs";
-
-//#region src/error.ts
-var error_exports = /* @__PURE__ */ __export({
-	ConvokerError: () => ConvokerError,
-	HelpAskedError: () => HelpAskedError,
-	InputValidationError: () => InputValidationError,
-	MissingRequiredArgumentError: () => MissingRequiredArgumentError,
-	MissingRequiredOptionError: () => MissingRequiredOptionError,
-	TooManyArgumentsError: () => TooManyArgumentsError,
-	UnknownOptionError: () => UnknownOptionError
-});
-/**
-* Thrown when the command fails to validate an input.
-*/
-var InputValidationError = class extends Error {
-	/**
-	* Creates a new input validation error.
-	* @param messages The messages.
-	*/
-	constructor(messages) {
-		super(`Validation failed: ${messages.join(", ")}`);
-		this.messages = messages;
-	}
-};
-/**
-* A Convoker-related error. These are usually handled by default.
-*/
-var ConvokerError = class extends Error {
-	/**
-	* Creates a new Convoker error.
-	* @param message The message.
-	* @param command The command.
-	*/
-	constructor(message, command) {
-		super(message);
-		this.command = command;
-	}
-	/**
-	* Prints the error's message.
-	*/
-	print() {
-		console.error(this.message);
-	}
-};
-/**
-* When the user asks for help.
-*/
-var HelpAskedError = class extends ConvokerError {
-	/**
-	* Creates a new help asked error.
-	* @param command The command.
-	*/
-	constructor(command) {
-		super("user asked for help!", command);
-	}
-};
-/**
-* When you pass too many arguments.
-*/
-var TooManyArgumentsError = class extends ConvokerError {
-	/**
-	* Creates a new too many arguments error.
-	* @param command The command.
-	*/
-	constructor(command) {
-		super("too many arguments!", command);
-	}
-};
-/**
-* When you pass an unknown option, when unknown options aren't allowed.
-*/
-var UnknownOptionError = class extends ConvokerError {
-	/**
-	* Creates a new unknown option error.
-	* @param command The command.
-	* @param key The key.
-	*/
-	constructor(command, key) {
-		super(`unknown option: ${key}!`, command);
-		this.key = key;
-	}
-};
-/**
-* When a required option is missing.
-*/
-var MissingRequiredOptionError = class extends ConvokerError {
-	/**
-	* Creates a new missing required option error.
-	* @param command The command.
-	* @param key The key.
-	* @param entry The entry.
-	*/
-	constructor(command, key, entry) {
-		super(`missing required option: ${key}!`, command);
-		this.key = key;
-		this.entry = entry;
-	}
-};
-var MissingRequiredArgumentError = class extends ConvokerError {
-	/**
-	* Creates a new missing required argument error.
-	* @param command The command.
-	* @param key The key.
-	* @param entry The entry.
-	*/
-	constructor(command, key, entry) {
-		super(`missing required positional argument: ${key}!`, command);
-		this.key = key;
-		this.entry = entry;
-	}
-};
-
-//#endregion
-export { MissingRequiredOptionError as a, error_exports as c, MissingRequiredArgumentError as i, HelpAskedError as n, TooManyArgumentsError as o, InputValidationError as r, UnknownOptionError as s, ConvokerError as t };

package/dist/error.d.mts

@@ -1,5 +0,0 @@
-import "./color-BuHvMolk.mjs";
-import "./standard-schema-DLeKaehR.mjs";
-import "./input-B12iaqb8.mjs";
-import { c as ConvokerError, d as MissingRequiredArgumentError, f as MissingRequiredOptionError, l as HelpAskedError, m as UnknownOptionError, p as TooManyArgumentsError, u as InputValidationError } from "./command-BXmfoT-l.mjs";
-export { ConvokerError, HelpAskedError, InputValidationError, MissingRequiredArgumentError, MissingRequiredOptionError, TooManyArgumentsError, UnknownOptionError };

package/dist/error.mjs

@@ -1,3 +0,0 @@
-import { a as MissingRequiredOptionError, i as MissingRequiredArgumentError, n as HelpAskedError, o as TooManyArgumentsError, r as InputValidationError, s as UnknownOptionError, t as ConvokerError } from "./error-C1S1gs8L.mjs";
-
-export { ConvokerError, HelpAskedError, InputValidationError, MissingRequiredArgumentError, MissingRequiredOptionError, TooManyArgumentsError, UnknownOptionError };

package/dist/input.d.mts

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

package/dist/input.mjs

@@ -1,5 +0,0 @@
-import "./error-C1S1gs8L.mjs";
-import "./standard-schema-DBXbMy6L.mjs";
-import { i as convert, n as Positional, o as option, r as argument, s as positional, t as Option } from "./input-DRy_sVxZ.mjs";
-
-export { Option, Positional, argument, convert, option, positional };

package/dist/standard-schema-DBXbMy6L.mjs

@@ -1,17 +0,0 @@
-import { r as InputValidationError } from "./error-C1S1gs8L.mjs";
-
-//#region src/standard-schema.ts
-/**
-* Validates a value.
-* @param entry The Standard Schema validator.
-* @param value The value to validate.
-* @returns The validated value.
-*/
-async function validate(entry, value) {
-	const result = await entry["~standard"].validate(value);
-	if (result.issues) throw new InputValidationError(result.issues.map((i) => i.message));
-	return result.value;
-}
-
-//#endregion
-export { validate as t };

package/dist/utils-ChmY93uA.mjs

@@ -1,45 +0,0 @@
-//#region src/utils.ts
-/**
-* If the runtime is Node.js.
-*/
-const isNode = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
-/**
-* If the runtime is Deno.
-*/
-const isDeno = typeof Deno !== "undefined" && typeof Deno.version?.deno === "string";
-/**
-* If the runtime is Bun.
-*/
-const isBun = typeof Bun !== "undefined" && typeof Bun.version === "string";
-/**
-* Checks if a value is a plain object.
-* @param value The value to check.
-* @returns If the value is a plain object.
-*/
-function isPlainObject(value) {
-	return value !== null && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype;
-}
-/**
-* Merges two objects deeply.
-* @param source The source object.
-* @param target The target object.
-* @returns The merged objects.
-*/
-function merge(source, target) {
-	if (Array.isArray(source) && Array.isArray(target)) return target;
-	if (isPlainObject(source) && isPlainObject(target)) {
-		const result = {};
-		new Set([...Object.keys(source), ...Object.keys(target)]).forEach((key) => {
-			const sourceVal = source[key];
-			const targetVal = target[key];
-			if (sourceVal !== void 0 && targetVal !== void 0) result[key] = merge(sourceVal, targetVal);
-			else if (targetVal !== void 0) result[key] = targetVal;
-			else result[key] = sourceVal;
-		});
-		return result;
-	}
-	return target;
-}
-
-//#endregion
-export { merge as i, isDeno as n, isNode as r, isBun as t };