convoker 0.1.0 → 0.3.0

package/README.md

@@ -1,9 +1,9 @@
-# LunarCLI
+# Convoker
 
 A simple, type safe CLI library for TypeScript.
 
 ```ts
-import { i, Command } from "lunarcli";
+import { i, Command } from "convoker";
 
 const program = new Command("calc").description("A basic calculator.");
 

package/dist/chunks/{error-Cj2qDfOl.js → error-CyKscMUD.js}

@@ -9,7 +9,7 @@ class n extends Error {
 }
 class o extends Error {
   /**
-   * Creates a new LunarCLI error.
+   * Creates a new Convoker error.
    * @param message The message.
    * @param command The command.
    */
@@ -75,21 +75,21 @@ class d extends o {
 }
 const l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
+  ConvokerError: o,
   HelpAskedError: i,
   InputValidationError: n,
-  LunarCLIError: o,
   MissingRequiredArgumentError: d,
   MissingRequiredOptionError: c,
   TooManyArgumentsError: a,
   UnknownOptionError: u
 }, Symbol.toStringTag, { value: "Module" }));
 export {
+  o as C,
   i as H,
   n as I,
-  o as L,
-  c as M,
+  d as M,
   a as T,
   u as U,
-  d as a,
+  c as a,
   l as e
 };

package/dist/chunks/{index-G2nVXKup.js → index-BluQjWvw.js}

@@ -1,6 +1,6 @@
 import { D as y } from "./color-CiruG_zQ.js";
-import { v as p } from "./standard-schema-Dn3nwAxU.js";
-import { I as f } from "./error-Cj2qDfOl.js";
+import { v as p } from "./standard-schema-BHKzvwIS.js";
+import { I as f } from "./error-CyKscMUD.js";
 import { i as $, a as v, b } from "./utils-DdmSEjLc.js";
 import { r as m, a as g, c as d, b as x, d as D } from "./__vite-browser-external-DQYBmsno.js";
 let l = y;

package/dist/chunks/{input-COjWPD53.js → input-WNu16aNE.js}

@@ -1,33 +1,36 @@
-import { v as u } from "./standard-schema-Dn3nwAxU.js";
-async function o(r, t) {
-  if (typeof r == "string")
-    switch (r) {
-      case "boolean":
-        return t === "true";
-      case "bigint":
-        return BigInt(t);
-      case "number":
-        return parseFloat(t);
-      case "string":
-        return t;
-    }
-  return u(r, t);
+import { v as o } from "./standard-schema-BHKzvwIS.js";
+async function a(r, t) {
+  async function i(e) {
+    if (typeof r == "string")
+      switch (r) {
+        case "boolean":
+          return e === "true";
+        case "bigint":
+          return BigInt(e);
+        case "number":
+          return parseFloat(e);
+        case "string":
+          return e;
+      }
+    return o(r, e);
+  }
+  return Array.isArray(t) ? await Promise.all(t.map((u) => i(u))) : i(t);
 }
-class i {
+class n {
   /**
    * Creates a new option.
    * @param kind The type of this option.
    * @param names The names of this option.
    */
-  constructor(t, s) {
-    this.$required = !0, this.$list = !1, this.$kind = t, this.$names = s.map((n) => n.replace(/^-+/, ""));
+  constructor(t, i) {
+    this.$required = !0, this.$list = !1, this.$kind = t, this.$names = i.map((e) => e.replace(/^-+/, ""));
   }
   /**
    * Makes this option a list.
    * @returns this
    */
-  list() {
-    return this.$list = !0, this;
+  list(t) {
+    return this.$list = !0, this.$separator = t ?? this.$separator, this;
   }
   /**
    * Makes this option required.
@@ -60,7 +63,7 @@ class i {
     return this.$description = t, this;
   }
 }
-class e {
+class s {
   /**
    * Creates a new positional argument.
    * @param kind The positional argument.
@@ -106,30 +109,30 @@ class e {
     return this.$description = t, this;
   }
 }
-function a(r, ...t) {
-  return new i(r, t);
+function c(r, ...t) {
+  return new n(r, t);
 }
 function h(r) {
-  return new e(r);
+  return new s(r);
 }
-function c(r) {
-  return new e(r);
+function l(r) {
+  return new s(r);
 }
 const d = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  Option: i,
-  Positional: e,
-  argument: c,
-  convert: o,
-  option: a,
+  Option: n,
+  Positional: s,
+  argument: l,
+  convert: a,
+  option: c,
   positional: h
 }, Symbol.toStringTag, { value: "Module" }));
 export {
-  i as O,
-  e as P,
-  c as a,
-  o as c,
+  n as O,
+  s as P,
+  l as a,
+  a as c,
   d as i,
-  a as o,
+  c as o,
   h as p
 };

package/dist/chunks/{standard-schema-Dn3nwAxU.js → standard-schema-BHKzvwIS.js}

@@ -1,4 +1,4 @@
-import { I as i } from "./error-Cj2qDfOl.js";
+import { I as i } from "./error-CyKscMUD.js";
 async function o(a, t) {
   const s = await a["~standard"].validate(t);
   if (s.issues) {

package/dist/command.d.ts

@@ -1,7 +1,7 @@
 /**
  * Command action function.
  */
-export declare type ActionFn<T extends Input> = (input: InferInput<T>) => void | Promise<void>;
+export declare type ActionFn<T extends Input> = (input: InferInput<T>) => any | Promise<any>;
 
 /**
  * A basic input type.
@@ -45,6 +45,10 @@ export declare class Command<T extends Input = Input> {
      * 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.
      */
@@ -53,6 +57,10 @@ export declare class Command<T extends Input = Input> {
      * 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.
      */
@@ -88,6 +96,12 @@ export declare class Command<T extends Input = 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.
@@ -131,6 +145,11 @@ export declare class Command<T extends Input = Input> {
      */
     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.
@@ -170,6 +189,26 @@ export declare interface CommandAlias<T extends Input = Input> {
     alias?: string;
 }
 
+/**
+ * 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;
+}
+
 /**
  * Command error handler.
  */
@@ -204,24 +243,9 @@ declare interface Input {
 declare type Kind = BasicKind | StandardSchemaV1<any, any>;
 
 /**
- * A LunarCLI-related error. These are usually handled by default.
+ * Command middleware function.
  */
-declare class LunarCLIError extends Error {
-    /**
-     * The command this error happened on.
-     */
-    command: Command<any>;
-    /**
-     * Creates a new LunarCLI error.
-     * @param message The message.
-     * @param command The command.
-     */
-    constructor(message: string, command: Command<any>);
-    /**
-     * Prints the error's message.
-     */
-    print(): void;
-}
+export declare type MiddlewareFn<T extends Input = Input> = (input: InferInput<T>, next: () => Promise<any>) => any | Promise<any>;
 
 /**
  * An option.
@@ -251,6 +275,10 @@ declare class Option_2<TKind extends Kind, TRequired extends boolean = true, TLi
      * If this option is a list.
      */
     $list: TList;
+    /**
+     * A separator if this option is a list.
+     */
+    $separator: string | undefined;
     /**
      * Creates a new option.
      * @param kind The type of this option.
@@ -261,7 +289,7 @@ declare class Option_2<TKind extends Kind, TRequired extends boolean = true, TLi
      * Makes this option a list.
      * @returns this
      */
-    list(): Option_2<TKind, TRequired, true>;
+    list(separator?: string): Option_2<TKind, TRequired, true>;
     /**
      * Makes this option required.
      * @returns this
@@ -301,7 +329,7 @@ export declare interface ParseResult<T extends Input> {
     /**
      * Errors collected during parsing.
      */
-    errors: LunarCLIError[];
+    errors: ConvokerError[];
     /**
      * If this should result in displaying the version of the command.
      */