convoker 0.1.0 → 0.2.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-CBR2veuf.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,18 +75,18 @@ 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,
   a as T,
   u as U,

package/dist/chunks/{index-G2nVXKup.js → index-D7JQKzRX.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-CFxVDMhv.js";
+import { I as f } from "./error-CBR2veuf.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-BfYvlWdG.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-CFxVDMhv.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-CFxVDMhv.js}

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

package/dist/command.d.ts

@@ -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.
      */
@@ -170,6 +174,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.
  */
@@ -203,26 +227,6 @@ declare interface Input {
  */
 declare type Kind = BasicKind | StandardSchemaV1<any, any>;
 
-/**
- * A LunarCLI-related error. These are usually handled by default.
- */
-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;
-}
-
 /**
  * An option.
  */
@@ -251,6 +255,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 +269,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 +309,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.
      */

package/dist/command.js

@@ -1,140 +1,140 @@
-import { D as L, b, c as v, g as M } from "./chunks/color-CiruG_zQ.js";
-import { s as V } from "./chunks/index-G2nVXKup.js";
-import { m as q, i as O, b as W, a as j } from "./chunks/utils-DdmSEjLc.js";
-import { M as R, a as z, L as N, H as A, U as J } from "./chunks/error-Cj2qDfOl.js";
-import { P as B, c as K, O as H } from "./chunks/input-COjWPD53.js";
-async function G() {
+import { D as V, b, c as v, g as O } from "./chunks/color-CiruG_zQ.js";
+import { s as q } from "./chunks/index-D7JQKzRX.js";
+import { m as R, i as A, b as W, a as j } from "./chunks/utils-DdmSEjLc.js";
+import { T as H, M as z, a as N, C as J, H as P, U as K } from "./chunks/error-CBR2veuf.js";
+import { P as B, c as G, O as _ } from "./chunks/input-BfYvlWdG.js";
+async function Q() {
   if (W && process.stdout?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
     return n.toWeb(process.stdout);
   }
-  return O && Deno.stdout?.writable ? Deno.stdout.writable : j && Bun.stdout ? Bun.stdout : new WritableStream({
+  return A && Deno.stdout?.writable ? Deno.stdout.writable : j && Bun.stdout ? Bun.stdout : new WritableStream({
     write(n) {
       console.log(String(n));
     }
   });
 }
-async function Q() {
+async function X() {
   if (W && process.stderr?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
     return n.toWeb(process.stderr);
   }
-  return O && Deno.stderr?.writable ? Deno.stderr.writable : j && Bun.stderr ? Bun.stderr : new WritableStream({
+  return A && Deno.stderr?.writable ? Deno.stderr.writable : j && Bun.stderr ? Bun.stderr : new WritableStream({
     write(n) {
       console.error(String(n));
     }
   });
 }
-async function X() {
+async function Y() {
   if (W && process.stdin?.readable) {
-    const { Readable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    const { Readable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
     return n.toWeb(process.stdin);
   }
-  return O && Deno.stdin?.readable ? Deno.stdin.readable : j ? Bun.stdin.stream() : new ReadableStream({
+  return A && Deno.stdin?.readable ? Deno.stdin.readable : j ? Bun.stdin.stream() : new ReadableStream({
     start(n) {
       n.close();
     }
   });
 }
-let m = L, g;
+let m = V, g;
 function I(n) {
   m = n;
 }
-async function T(n) {
-  g = q(
+async function L(n) {
+  g = R(
     {
       format: "text",
-      stdout: await G(),
-      stderr: await Q(),
-      stdin: await X()
+      stdout: await Q(),
+      stderr: await X(),
+      stdin: await Y()
     },
     n
   );
 }
-async function Y() {
-  await T({});
+async function Z() {
+  await L({});
 }
-function S(n, ...t) {
-  const e = (/* @__PURE__ */ new Date()).toISOString(), r = t.map((o) => typeof o == "string" ? o : JSON.stringify(o, null, 2)).join(" ");
+function S(n, ...e) {
+  const t = (/* @__PURE__ */ new Date()).toISOString(), r = e.map((i) => typeof i == "string" ? i : JSON.stringify(i, null, 2)).join(" ");
   switch (g.format) {
     case "json":
-      return JSON.stringify({ timestamp: e, level: n, message: r }) + `
+      return JSON.stringify({ timestamp: t, level: n, message: r }) + `
 `;
     case "xml":
       return `<log>
-  <timestamp>${e}</timestamp>
+  <timestamp>${t}</timestamp>
   <level>${n}</level>
   <message>${r}</message>
 </log>
 `;
     case "yaml":
-      return `- timestamp: ${e}
+      return `- timestamp: ${t}
   level: ${n}
   message: "${r.replace(/"/g, '\\"')}"
 `;
     case "csv":
-      return `"${e}","${n}","${r.replace(/"/g, '""')}"
+      return `"${t}","${n}","${r.replace(/"/g, '""')}"
 `;
     case "text":
     default:
-      return `[${e}] [${n.toUpperCase()}] ${r}
+      return `[${t}] [${n.toUpperCase()}] ${r}
 `;
   }
 }
-function E(n, t) {
+function E(n, e) {
   switch (n) {
     case "trace":
-      return m.secondary ? m.secondary(t) : t;
+      return m.secondary ? m.secondary(e) : e;
     case "info":
-      return m.info ? m.info(t) : t;
+      return m.info ? m.info(e) : e;
     case "warn":
-      return m.warning ? m.warning(t) : t;
+      return m.warning ? m.warning(e) : e;
     case "error":
-      return m.error ? m.error(t) : t;
+      return m.error ? m.error(e) : e;
     case "fatal":
-      return m.error ? m.error(m.styles?.bold?.(t) ?? t) : t;
+      return m.error ? m.error(m.styles?.bold?.(e) ?? e) : e;
     default:
-      return t;
+      return e;
   }
 }
-async function k(n, t) {
-  const e = n.getWriter();
+async function k(n, e) {
+  const t = n.getWriter();
   try {
-    await e.write(t);
+    await t.write(e);
   } finally {
-    e.releaseLock();
+    t.releaseLock();
   }
 }
-async function Z(...n) {
-  const t = S("trace", ...n), e = E("trace", t);
-  await k(g.stdout, e);
-}
 async function x(...n) {
-  const t = S("info", ...n), e = E("info", t);
-  await k(g.stdout, e);
+  const e = S("trace", ...n), t = E("trace", e);
+  await k(g.stdout, t);
 }
 async function tt(...n) {
-  const t = S("warn", ...n), e = E("warn", t);
-  await k(g.stdout, e);
+  const e = S("info", ...n), t = E("info", e);
+  await k(g.stdout, t);
 }
 async function et(...n) {
-  const t = S("error", ...n), e = E("error", t);
-  await k(g.stderr, e);
+  const e = S("warn", ...n), t = E("warn", e);
+  await k(g.stdout, t);
 }
 async function nt(...n) {
-  const t = S("fatal", ...n), e = E("fatal", t);
-  await k(g.stderr, e), O ? Deno.exit(-1) : (W || j) && process.exit(-1);
+  const e = S("error", ...n), t = E("error", e);
+  await k(g.stderr, t);
+}
+async function rt(...n) {
+  const e = S("fatal", ...n), t = E("fatal", e);
+  await k(g.stderr, t), A ? Deno.exit(-1) : (W || j) && process.exit(-1);
 }
 const ct = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  error: et,
-  fatal: nt,
-  info: x,
-  setConfig: T,
+  error: nt,
+  fatal: rt,
+  info: tt,
+  setConfig: L,
   setTheme: I,
-  setup: Y,
-  trace: Z,
-  warn: tt
+  setup: Z,
+  trace: x,
+  warn: et
 }, Symbol.toStringTag, { value: "Module" }));
 class F {
   /**
@@ -143,76 +143,76 @@ class F {
    * @param desc The description.
    * @param version The version.
    */
-  constructor(t, e, r) {
-    this.$children = /* @__PURE__ */ new Map(), this.$allowUnknownOptions = !1, this.$input = {}, this.$fn = void 0, this.$errorFn = void 0, this.$names = Array.isArray(t) ? t : [t], this.$description = e, this.$version = r;
+  constructor(e, t, r) {
+    this.$children = /* @__PURE__ */ new Map(), this.$allowUnknownOptions = !1, this.$allowSurpassArgLimit = !1, this.$input = {}, this.$fn = void 0, this.$errorFn = void 0, this.$names = Array.isArray(e) ? e : [e], this.$description = t, this.$version = r;
   }
   /**
    * Adds a set of aliases to this command.
    * @param aliases The aliases to add.
    * @returns this
    */
-  alias(...t) {
-    return this.$names.concat(t), this.$parent?.add(this), this;
+  alias(...e) {
+    return this.$names.concat(e), this.$parent?.add(this), this;
   }
   /**
    * Adds a description to this command.
    * @param desc The description.
    * @returns this
    */
-  description(t) {
-    return this.$description = t, this;
+  description(e) {
+    return this.$description = e, this;
   }
   /**
    * Adds a version to this command.
    * @param version The version.
    * @returns this
    */
-  version(t) {
-    return this.$version = t, this;
+  version(e) {
+    return this.$version = e, this;
   }
   /**
    * Sets the input for this command.
    * @param version The input.
    * @returns this
    */
-  input(t) {
-    return this.$input = t, this;
+  input(e) {
+    return this.$input = e, this;
   }
   /**
    * Sets the action function for this command.
    * @param fn The action.
    * @returns this
    */
-  action(t) {
-    return this.$fn = t, this;
+  action(e) {
+    return this.$fn = e, this;
   }
   /**
    * Sets the error function for this command.
    * @param fn The error handler.
    * @returns this
    */
-  error(t) {
-    return this.$errorFn = t, this;
+  error(e) {
+    return this.$errorFn = e, this;
   }
   /**
    * Adds an existing command to this.
    * @param command The command.
    * @returns this
    */
-  add(t) {
-    t.$parent = this;
-    const e = { command: t, alias: t.$names[0] };
-    for (let r = 0; r < t.$names.length; r++)
-      r === 0 && this.$children.set(t.$names[r], { command: t }), this.$children.set(t.$names[r], e);
+  add(e) {
+    e.$parent = this;
+    const t = { command: e, alias: e.$names[0] };
+    for (let r = 0; r < e.$names.length; r++)
+      r === 0 && this.$children.set(e.$names[r], { command: e }), this.$children.set(e.$names[r], t);
     return this;
   }
-  subCommand(t, e, r) {
-    if (typeof e == "function") {
-      const c = new F(t);
-      return e(c), this.add(c), this;
+  subCommand(e, t, r) {
+    if (typeof t == "function") {
+      const a = new F(e);
+      return t(a), this.add(a), this;
     }
-    const o = new F(t, e, r);
-    return this.add(o), o;
+    const i = new F(e, t, r);
+    return this.add(i), i;
   }
   /**
    * Allows unknown options.
@@ -226,129 +226,133 @@ class F {
    * @param argv The arguments to parse.
    * @returns A parse result.
    */
-  async parse(t) {
-    let e = this, r = !1;
-    const o = {}, c = [], d = {}, s = [], a = e.buildInputMap();
-    function u(f, i) {
-      const l = a.get(f);
-      return l ? l.value : (!e.$allowUnknownOptions && !i && s.push(new J(e, f)), null);
+  async parse(e) {
+    let t = this, r = !1;
+    const i = {}, a = [], d = {}, s = [], c = t.buildInputMap();
+    function u(f, o) {
+      const l = c.get(f);
+      return l ? l.value : (!t.$allowUnknownOptions && !o && s.push(new K(t, f)), null);
     }
-    function p(f, i, l) {
-      i.$kind === "boolean" ? d[f] = "true" : l !== void 0 && (d[f] = l);
+    function h(f, o, l) {
+      o.$kind === "boolean" ? d[f] = "true" : l !== void 0 && (d[f] = l);
     }
-    let h = !1, C = !1;
-    for (let f = 0; f < t.length; f++) {
-      const i = t[f];
-      if (i.startsWith("--")) {
-        const [l, w] = i.slice(2).split("=");
+    let p = !1, C = !1;
+    for (let f = 0; f < e.length; f++) {
+      const o = e[f];
+      if (o.startsWith("--")) {
+        const [l, w] = o.slice(2).split("=");
         let y = !1;
-        l === "help" ? (C = !0, y = !0) : l === "version" && (h = !0, y = !0);
+        l === "help" ? (C = !0, y = !0) : l === "version" && (p = !0, y = !0);
         const $ = u(l, y);
-        $ && (w === void 0 ? p(
+        $ && (w === void 0 ? h(
           l,
           $,
-          $.$kind === "boolean" ? void 0 : t[++f]
-        ) : p(l, $, w));
-      } else if (i.startsWith("-")) {
-        const [l, w] = i.slice(1).split("="), y = l.split("");
+          $.$kind === "boolean" ? void 0 : e[++f]
+        ) : h(l, $, w));
+      } else if (o.startsWith("-")) {
+        const [l, w] = o.slice(1).split("="), y = l.split("");
         let $ = w;
         for (const D of y) {
-          let U = !1;
-          D === "h" ? (C = !0, U = !0) : D === "V" && (h = !0, U = !0);
-          const P = u(D, U);
-          P && (P.$kind !== "boolean" && $ === void 0 && ($ = t[++f]), p(D, P, $), $ = void 0);
+          let T = !1;
+          D === "h" ? (C = !0, T = !0) : D === "V" && (p = !0, T = !0);
+          const U = u(D, T);
+          U && (U.$kind !== "boolean" && $ === void 0 && ($ = e[++f]), h(D, U, $), $ = void 0);
         }
       } else
-        e.$children.has(i) && !r ? (e = e.$children.get(i).command, e.$theme && (V(e.$theme), I(e.$theme))) : (r = !0, c.push(i));
+        t.$children.has(o) && !r ? (t = t.$children.get(o).command, t.$theme && (q(t.$theme), I(t.$theme))) : (r = !0, a.push(o));
     }
-    let _ = 0;
-    for (const f in e.$input) {
-      const i = e.$input[f];
+    let M = 0;
+    for (const f in t.$input) {
+      const o = t.$input[f];
       let l;
-      if (i instanceof B)
-        l = c[_++];
-      else
-        for (const w of i.$names)
+      if (o instanceof B) {
+        if (o.$list) {
+          if (l = a.slice(M), M = a.length, !t.$allowSurpassArgLimit && l.length === 0)
+            throw new H(t);
+        } else if (l = a[M++], M > a.length && !t.$allowSurpassArgLimit)
+          throw new H(t);
+      } else
+        for (const w of o.$names)
           if (d[w] !== void 0) {
-            l = d[w];
+            l = o.$list ? d[w] : d[w].split(o.$separator ?? ",");
             break;
           }
-      l !== void 0 ? o[f] = await K(i.$kind, l) : i.$default !== void 0 ? o[f] = i.$default : i.$required && (i instanceof H ? s.push(new R(e, f, i)) : s.push(new z(e, f, i)));
+      l !== void 0 ? i[f] = await G(o.$kind, l) : o.$default !== void 0 ? i[f] = o.$default : o.$required && (o instanceof _ ? s.push(new z(t, f, o)) : s.push(new N(t, f, o)));
     }
     return {
-      input: o,
-      command: e,
+      input: i,
+      command: t,
       errors: s,
-      isVersion: h,
+      isVersion: p,
       isHelp: C
     };
   }
-  buildInputMap(t) {
-    const e = /* @__PURE__ */ new Map();
+  buildInputMap(e) {
+    const t = /* @__PURE__ */ new Map();
     let r = 0;
-    for (const o in this.$input) {
-      const c = this.$input[o];
-      if (c instanceof B)
-        e.set(r++, { value: c, key: o });
+    for (const i in this.$input) {
+      const a = this.$input[i];
+      if (a instanceof B)
+        t.set(r++, { value: a, key: i });
       else
-        for (const d of c.$names)
-          e.set(d, { value: c, key: o });
+        for (const d of a.$names)
+          t.set(d, { value: a, key: i });
     }
-    if (!t)
-      for (const [o, c] of this.$parent?.buildInputMap() ?? [])
-        e.set(o, c);
-    for (const [, { command: o }] of this.$children)
-      for (const [c, d] of o.buildInputMap(!0))
-        e.set(c, d);
-    return e;
+    if (!e)
+      for (const [i, a] of this.$parent?.buildInputMap() ?? [])
+        t.set(i, a);
+    for (const [, { command: i }] of this.$children)
+      for (const [a, d] of i.buildInputMap(!0))
+        t.set(a, d);
+    return t;
   }
   /**
    * Gets the full command path (name including parents).
    * @returns The full command path.
    */
   fullCommandPath() {
-    const t = [];
-    let e = this;
-    for (; e; )
-      t.unshift(e.$names[0]), e = e.$parent;
-    return t.join(" ");
+    const e = [];
+    let t = this;
+    for (; t; )
+      e.unshift(t.$names[0]), t = t.$parent;
+    return e.join(" ");
   }
   /**
    * The default error screen.
    * @param errors The errors.
    */
-  defaultErrorScreen(t) {
-    let e = !1;
+  defaultErrorScreen(e) {
+    let t = !1;
     const r = [];
-    for (const s of t)
-      s instanceof N ? (s instanceof A || s.print(), e = !0) : r.push(s);
+    for (const s of e)
+      s instanceof J ? (s instanceof P || s.print(), t = !0) : r.push(s);
     if (r.length) throw r[0];
-    if (!e) return;
-    const o = (s, a) => s.padEnd(a, " ");
+    if (!t) return;
+    const i = (s, c) => s.padEnd(c, " ");
     console.log(
-      `${b("usage:")} ${v(this.fullCommandPath())} ${M("[options] [arguments]")}`
+      `${b("usage:")} ${v(this.fullCommandPath())} ${O("[options] [arguments]")}`
     ), this.$description && console.log(`${this.$description}`), this.$version && console.log(`${b("version")} ${this.$version}`);
-    const c = Object.entries(this.$input).filter(([, s]) => s instanceof H).map(([s, a]) => ({ key: s, entry: a }));
-    if (c.length > 0) {
+    const a = Object.entries(this.$input).filter(([, s]) => s instanceof _).map(([s, c]) => ({ key: s, entry: c }));
+    if (a.length > 0) {
       console.log(b("options:"));
       const s = Math.max(
-        ...c.map(({ entry: a }) => a.$names.join(", ").length)
+        ...a.map(({ entry: c }) => c.$names.join(", ").length)
       );
-      for (const { entry: a } of c) {
-        const u = a.$names.map((h) => h.length === 1 ? `-${h}` : `--${h}`).join(", "), p = `  ${v(o(u, s + 4))}${M(a.$description ?? "")}`;
-        console.log(p);
+      for (const { entry: c } of a) {
+        const u = c.$names.map((p) => p.length === 1 ? `-${p}` : `--${p}`).join(", "), h = `  ${v(i(u, s + 4))}${O(c.$description ?? "")}`;
+        console.log(h);
       }
     }
-    const d = Object.entries(this.$input).filter(([, s]) => s instanceof B).map(([s, a]) => ({
+    const d = Object.entries(this.$input).filter(([, s]) => s instanceof B).map(([s, c]) => ({
       key: s,
-      entry: a
+      entry: c
     }));
     if (d.length > 0) {
       console.log(b("arguments:"));
-      const s = Math.max(...d.map(({ key: a }) => a.length));
-      for (const { key: a, entry: u } of d) {
-        const p = u.$required ? `<${a}>` : `[${a}]`, h = `  ${v(o(p, s + 4))}${M(u.$description ?? "")}`;
-        console.log(h);
+      const s = Math.max(...d.map(({ key: c }) => c.length));
+      for (const { key: c, entry: u } of d) {
+        const h = u.$required ? `<${c}>` : `[${c}]`, p = `  ${v(i(h, s + 4))}${O(u.$description ?? "")}`;
+        console.log(p);
       }
     }
     if (this.$children.size > 0) {
@@ -360,10 +364,10 @@ class F {
             u.command
           ])
         ).values()
-      ), a = Math.max(...s.map((u) => u.$names[0].length));
+      ), c = Math.max(...s.map((u) => u.$names[0].length));
       for (const u of s) {
-        const p = `  ${v(o(u.$names[0], a + 4))}${M(u.$description) ?? ""}`;
-        console.log(p);
+        const h = `  ${v(i(u.$names[0], c + 4))}${O(u.$description) ?? ""}`;
+        console.log(h);
       }
       console.log(), console.log(
         `run '${v(`${this.fullCommandPath()} <command> --help`)}' for more info on a command.`
@@ -376,35 +380,35 @@ class F {
    * @param input The parsed input, if possible.
    * @returns this
    */
-  async handleErrors(t, e) {
+  async handleErrors(e, t) {
     let r = this;
     for (; !r.$errorFn && r.$parent; )
       r = r.$parent;
-    return r.$errorFn ? await r.$errorFn(r, t, e ?? {}) : this.defaultErrorScreen(t), this;
+    return r.$errorFn ? await r.$errorFn(r, e, t ?? {}) : this.defaultErrorScreen(e), this;
   }
   /**
    * Runs a command.
    * @param argv The arguments to run the command with. Defaults to your runtime's `argv` equivalent.
    * @returns this
    */
-  async run(t) {
-    t || (t = typeof Bun < "u" ? Bun.argv.slice(2) : typeof Deno < "u" ? Deno.args : process.argv.slice(2));
-    const e = await this.parse(t);
-    if (e.isHelp)
-      return e.command.handleErrors([new A(e.command)]), this;
-    if (e.isVersion)
+  async run(e) {
+    e || (e = typeof Bun < "u" ? Bun.argv.slice(2) : typeof Deno < "u" ? Deno.args : process.argv.slice(2));
+    const t = await this.parse(e);
+    if (t.isHelp)
+      return t.command.handleErrors([new P(t.command)]), this;
+    if (t.isVersion)
       return console.log(
-        `${e.command.fullCommandPath()} version ${e.command.$version}`
+        `${t.command.fullCommandPath()} version ${t.command.$version}`
       ), this;
     try {
-      e.errors.length > 0 ? await e.command.handleErrors(e.errors, e.input) : e.command.$fn ? await e.command.$fn(e.input) : await e.command.handleErrors(
-        [new A(e.command), ...e.errors],
-        e.input
+      t.errors.length > 0 ? await t.command.handleErrors(t.errors, t.input) : t.command.$fn ? await t.command.$fn(t.input) : await t.command.handleErrors(
+        [new P(t.command), ...t.errors],
+        t.input
       );
     } catch (r) {
       r instanceof Error || console.warn(
-        "[lunarcli] an error that is not instance of `Error` was thrown. this may cause undefined behavior."
-      ), await e.command.handleErrors([r]);
+        "[convoker] an error that is not instance of `Error` was thrown. this may cause undefined behavior."
+      ), await t.command.handleErrors([r]);
     }
     return this;
   }

package/dist/error.d.ts

@@ -50,6 +50,10 @@ 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.
      */
@@ -175,6 +179,46 @@ declare interface CommandAlias<T extends Input = Input> {
     alias?: string;
 }
 
+/**
+ * A Convoker-related error. These are usually handled by default.
+ */
+export 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;
+}
+
+/**
+ * A Convoker-related error. These are usually handled by default.
+ */
+declare class ConvokerError_2 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.
  */
@@ -183,7 +227,7 @@ declare type ErrorFn<T extends Input> = (command: Command<T>, errors: Error[], i
 /**
  * When the user asks for help.
  */
-export declare class HelpAskedError extends LunarCLIError {
+export declare class HelpAskedError extends ConvokerError {
     /**
      * Creates a new help asked error.
      * @param command The command.
@@ -239,47 +283,7 @@ declare type Kind = BasicKind | StandardSchemaV1<any, any>;
  */
 declare type Kind_2 = BasicKind_2 | StandardSchemaV1_2<any, any>;
 
-/**
- * A LunarCLI-related error. These are usually handled by default.
- */
-export 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;
-}
-
-/**
- * A LunarCLI-related error. These are usually handled by default.
- */
-declare class LunarCLIError_2 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 class MissingRequiredArgumentError extends LunarCLIError {
+export declare class MissingRequiredArgumentError extends ConvokerError {
     /**
      * The argument key.
      */
@@ -300,7 +304,7 @@ export declare class MissingRequiredArgumentError extends LunarCLIError {
 /**
  * When a required option is missing.
  */
-export declare class MissingRequiredOptionError extends LunarCLIError {
+export declare class MissingRequiredOptionError extends ConvokerError {
     /**
      * The option key.
      */
@@ -346,6 +350,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.
@@ -356,7 +364,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
@@ -409,6 +417,10 @@ declare class Option_2_2<TKind extends Kind_2, TRequired extends boolean = true,
      * 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.
@@ -419,7 +431,7 @@ declare class Option_2_2<TKind extends Kind_2, TRequired extends boolean = true,
      * Makes this option a list.
      * @returns this
      */
-    list(): Option_2_2<TKind, TRequired, true>;
+    list(separator?: string): Option_2_2<TKind, TRequired, true>;
     /**
      * Makes this option required.
      * @returns this
@@ -459,7 +471,7 @@ declare interface ParseResult<T extends Input> {
     /**
      * Errors collected during parsing.
      */
-    errors: LunarCLIError_2[];
+    errors: ConvokerError_2[];
     /**
      * If this should result in displaying the version of the command.
      */
@@ -795,7 +807,7 @@ declare interface Theme {
 /**
  * When you pass too many arguments.
  */
-export declare class TooManyArgumentsError extends LunarCLIError {
+export declare class TooManyArgumentsError extends ConvokerError {
     /**
      * Creates a new too many arguments error.
      * @param command The command.
@@ -816,7 +828,7 @@ declare type TypeOf_2<T extends Kind_2> = T extends StandardSchemaV1_2<any, infe
 /**
  * When you pass an unknown option, when unknown options aren't allowed.
  */
-export declare class UnknownOptionError extends LunarCLIError {
+export declare class UnknownOptionError extends ConvokerError {
     /**
      * The option key.
      */

package/dist/error.js

@@ -1,10 +1,10 @@
-import { H as n, I as s, L as a, a as i, M as e, T as t, U as E } from "./chunks/error-Cj2qDfOl.js";
+import { C as n, H as s, I as a, a as e, M as i, T as t, U as E } from "./chunks/error-CBR2veuf.js";
 export {
-  n as HelpAskedError,
-  s as InputValidationError,
-  a as LunarCLIError,
-  i as MissingRequiredArgumentError,
-  e as MissingRequiredOptionError,
+  n as ConvokerError,
+  s as HelpAskedError,
+  a as InputValidationError,
+  e as MissingRequiredArgumentError,
+  i as MissingRequiredOptionError,
   t as TooManyArgumentsError,
   E as UnknownOptionError
 };

package/dist/index.d.ts

@@ -178,6 +178,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.
      */
@@ -330,7 +334,27 @@ declare interface ConfirmOpts extends BaseOpts<boolean> {
  * @param value The value to convert.
  * @returns The converted value.
  */
-declare function convert<TKind extends Kind>(kind: TKind, value: string): Promise<TypeOf<TKind>>;
+declare function convert<TKind extends Kind>(kind: TKind, value: string | string[]): Promise<TypeOf<TKind> | TypeOf<TKind>[]>;
+
+/**
+ * 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;
+}
 
 /**
  * Creates a function that wraps a string in ANSI codes.
@@ -398,7 +422,7 @@ declare interface EditorOpts extends BaseOpts<string> {
 export declare namespace error {
     export {
         InputValidationError,
-        LunarCLIError,
+        ConvokerError,
         HelpAskedError,
         TooManyArgumentsError,
         UnknownOptionError,
@@ -433,7 +457,7 @@ declare const greenBright: (input: any) => string;
 /**
  * When the user asks for help.
  */
-declare class HelpAskedError extends LunarCLIError {
+declare class HelpAskedError extends ConvokerError {
     /**
      * Creates a new help asked error.
      * @param command The command.
@@ -549,31 +573,11 @@ declare interface LogConfig {
     stdin: ReadableStream<string>;
 }
 
-/**
- * A LunarCLI-related error. These are usually handled by default.
- */
-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;
-}
-
 declare const magenta: (input: any) => string;
 
 declare const magentaBright: (input: any) => string;
 
-declare class MissingRequiredArgumentError extends LunarCLIError {
+declare class MissingRequiredArgumentError extends ConvokerError {
     /**
      * The argument key.
      */
@@ -594,7 +598,7 @@ declare class MissingRequiredArgumentError extends LunarCLIError {
 /**
  * When a required option is missing.
  */
-declare class MissingRequiredOptionError extends LunarCLIError {
+declare class MissingRequiredOptionError extends ConvokerError {
     /**
      * The option key.
      */
@@ -655,6 +659,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.
@@ -665,7 +673,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
@@ -707,7 +715,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.
      */
@@ -1142,7 +1150,7 @@ declare interface Theme {
 /**
  * When you pass too many arguments.
  */
-declare class TooManyArgumentsError extends LunarCLIError {
+declare class TooManyArgumentsError extends ConvokerError {
     /**
      * Creates a new too many arguments error.
      * @param command The command.
@@ -1166,7 +1174,7 @@ declare const underline: (input: any) => string;
 /**
  * When you pass an unknown option, when unknown options aren't allowed.
  */
-declare class UnknownOptionError extends LunarCLIError {
+declare class UnknownOptionError extends ConvokerError {
     /**
      * The option key.
      */

package/dist/index.js

@@ -1,8 +1,8 @@
 import { Command as m, l as e } from "./command.js";
-import { e as a } from "./chunks/error-Cj2qDfOl.js";
-import { i as f } from "./chunks/input-COjWPD53.js";
+import { e as a } from "./chunks/error-CBR2veuf.js";
+import { i as f } from "./chunks/input-BfYvlWdG.js";
 import { a as s } from "./chunks/color-CiruG_zQ.js";
-import { i } from "./chunks/index-G2nVXKup.js";
+import { i } from "./chunks/index-D7JQKzRX.js";
 export {
   m as Command,
   s as color,

package/dist/input.d.ts

@@ -16,7 +16,7 @@ export declare type BasicKind = "boolean" | "string" | "number" | "bigint";
  * @param value The value to convert.
  * @returns The converted value.
  */
-export declare function convert<TKind extends Kind>(kind: TKind, value: string): Promise<TypeOf<TKind>>;
+export declare function convert<TKind extends Kind>(kind: TKind, value: string | string[]): Promise<TypeOf<TKind> | TypeOf<TKind>[]>;
 
 /**
  * Infers a TypeScript type from an option or positional.
@@ -82,6 +82,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.
@@ -92,7 +96,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

package/dist/input.js

@@ -1,5 +1,5 @@
-import "./chunks/standard-schema-Dn3nwAxU.js";
-import { O as t, P as i, a as n, c as p, o as r, p as e } from "./chunks/input-COjWPD53.js";
+import "./chunks/standard-schema-CFxVDMhv.js";
+import { O as t, P as i, a as n, c as p, o as r, p as e } from "./chunks/input-BfYvlWdG.js";
 export {
   t as Option,
   i as Positional,

package/dist/prompt.js

@@ -1,9 +1,9 @@
 import "./chunks/color-CiruG_zQ.js";
-import "./chunks/standard-schema-Dn3nwAxU.js";
-import "./chunks/error-Cj2qDfOl.js";
+import "./chunks/standard-schema-CFxVDMhv.js";
+import "./chunks/error-CBR2veuf.js";
 import "./chunks/utils-DdmSEjLc.js";
 import { d as m } from "./chunks/__vite-browser-external-DQYBmsno.js";
-import { c as i, e as c, m as d, p as f, b as l, a as x, s as h, t as w } from "./chunks/index-G2nVXKup.js";
+import { c as i, e as c, m as d, p as f, b as l, a as x, s as h, t as w } from "./chunks/index-D7JQKzRX.js";
 export {
   i as confirm,
   c as editor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoker",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A simple, type safe CLI framework for TypeScript.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",