convoker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 trailfrost
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# LunarCLI
+
+A simple, type safe CLI library for TypeScript.
+
+```ts
+import { i, Command } from "lunarcli";
+
+const program = new Command("calc").description("A basic calculator.");
+
+program
+  .subCommand("add", (c) =>
+    c
+      .description("Adds two numbers.")
+      .input({
+        x: i.option("number", "-x", "--x"),
+        y: i.option("number", "-y", "--y"),
+      })
+      .action(({ x, y }) => {
+        console.log(`${x} + ${y} = ${x + y}`);
+      }),
+  )
+  .subCommand("sub", (c) =>
+    c
+      .description("Subtracts any amount of numbers.")
+      .input({
+        numbers: i.option("number", "--numbers", "-n").list(),
+      })
+      .action(({ numbers }) => {
+        const sub = numbers.reduce((a, b) => a - b, 0);
+        console.log(`${numbers.join(" + ")} = ${sub}`);
+      }),
+  )
+  .run();
+```

package/dist/chunks/__vite-browser-external-DQYBmsno.js

@@ -0,0 +1,80 @@
+import { i as c } from "./utils-DdmSEjLc.js";
+async function d(e = "", t, u) {
+  if (c) {
+    await Deno.stdout.write(new TextEncoder().encode(e));
+    const a = new TextDecoder(), i = new Uint8Array(1024);
+    let n = "";
+    for (; ; ) {
+      const o = await Deno.stdin.read(i);
+      if (!o) break;
+      const s = a.decode(i.subarray(0, o));
+      if (s.includes(`
+`)) {
+        n += s.split(`
+`)[0];
+        break;
+      }
+      n += s;
+    }
+    return n.trim() || t || "";
+  }
+  const r = await Promise.resolve().then(() => x);
+  return new Promise((a) => {
+    const i = r.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: !0
+    });
+    if (u?.masked) {
+      const n = i._writeToOutput.bind(i);
+      i._writeToOutput = (o) => {
+        if (o.match(/^\x1b/) || o.endsWith(`
+`) || o.endsWith("\r")) return n(o);
+        const s = u.maskChar ?? "*";
+        n(s.repeat(o.length));
+      };
+    }
+    i.question(e, (n) => {
+      i.close(), a(n || t || "");
+    });
+  });
+}
+async function f() {
+  return new Promise((e) => {
+    const t = process.stdin;
+    t.setRawMode(!0), t.resume(), t.once("data", (u) => {
+      const r = u.toString();
+      return t.setRawMode(!1), t.pause(), e(r === "\r" || r === `
+` ? "enter" : r === " " ? "space" : r === "\x1B[A" ? "up" : r === "\x1B[B" ? "down" : r === "\x1B[C" ? "right" : r === "\x1B[D" ? "left" : r);
+    });
+  });
+}
+function p(e = 1) {
+  for (let t = 0; t < e; t++) process.stdout.write("\x1B[2K\x1B[1A");
+  process.stdout.write("\x1B[2K\r");
+}
+function w(e = 1) {
+  process.stdout.write(`\x1B[${e}A`);
+}
+function l(e = 1) {
+  process.stdout.write(`\x1B[${e}B`);
+}
+const m = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  clearLines: p,
+  cursorDown: l,
+  cursorUp: w,
+  readKey: f,
+  readLine: d
+}, Symbol.toStringTag, { value: "Module" })), x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  x as _,
+  f as a,
+  w as b,
+  p as c,
+  m as d,
+  l as e,
+  d as r
+};

package/dist/chunks/color-CiruG_zQ.js

@@ -0,0 +1,153 @@
+import { m as p } from "./utils-DdmSEjLc.js";
+function m() {
+  if (typeof window < "u" && typeof window.document < "u")
+    return !1;
+  const e = typeof process < "u" ? process.env ?? {} : {};
+  if ("NO_COLOR" in e) return !1;
+  if ("FORCE_COLOR" in e) return !0;
+  if ("CI" in e)
+    return !!([
+      "TRAVIS",
+      "CIRCLECI",
+      "APPVEYOR",
+      "GITLAB_CI",
+      "GITHUB_ACTIONS",
+      "BUILDKITE",
+      "DRONE"
+    ].some((t) => t in e) || e.CI_NAME === "codeship");
+  if (typeof Deno < "u" && Deno.noColor !== void 0)
+    return !Deno.noColor;
+  if (typeof process < "u" && process.stdout) {
+    const t = e.TERM || "";
+    return (e.COLORTERM || "").length > 0 ? !0 : t === "dumb" ? !1 : /(color|ansi|cygwin|xterm|vt100)/i.test(t);
+  }
+  return !1;
+}
+const c = m();
+function s(e, t) {
+  const n = `\x1B[${e}m`, r = `\x1B[${t}m`;
+  return c ? (o) => {
+    if (!o) return n + r;
+    const B = (o + "").replace(
+      new RegExp(`\x1B\\[${t}m`, "g"),
+      r + n
+    );
+    return n + B + r;
+  } : (o) => o + "";
+}
+const y = s(0, 0), a = s(1, 22), C = s(2, 22), i = s(3, 23), g = s(4, 24), w = s(53, 55), O = s(7, 27), R = s(8, 28), E = s(9, 29), I = s(30, 39), l = s(31, 39), u = s(32, 39), d = s(33, 39), T = s(34, 39), _ = s(35, 39), f = s(36, 39), v = s(37, 39), b = s(90, 39), A = s(40, 49), L = s(41, 49), M = s(42, 49), x = s(43, 49), D = s(44, 49), G = s(45, 49), S = s(46, 49), N = s(47, 49), k = s(100, 49), P = s(91, 39), j = s(92, 39), F = s(93, 39), H = s(94, 39), U = s(95, 39), Y = s(96, 39), $ = s(97, 39), z = s(101, 49), K = s(102, 49), V = s(103, 49), W = s(104, 49), q = s(105, 49), J = s(106, 49), Q = s(107, 49), h = {
+  primary: f,
+  secondary: b,
+  success: u,
+  warning: d,
+  error: l,
+  symbols: {
+    success: "✔",
+    error: "✖",
+    warning: "⚠"
+  },
+  styles: {
+    bold: a,
+    italic: i,
+    underline: g
+  }
+};
+function X(e) {
+  return p(h, e);
+}
+const es = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  DEFAULT_THEME: h,
+  bgBlack: A,
+  bgBlue: D,
+  bgBlueBright: W,
+  bgCyan: S,
+  bgCyanBright: J,
+  bgGray: k,
+  bgGreen: M,
+  bgGreenBright: K,
+  bgMagenta: G,
+  bgMagentaBright: q,
+  bgRed: L,
+  bgRedBright: z,
+  bgWhite: N,
+  bgWhiteBright: Q,
+  bgYellow: x,
+  bgYellowBright: V,
+  black: I,
+  blue: T,
+  blueBright: H,
+  bold: a,
+  createAnsiColor: s,
+  cyan: f,
+  cyanBright: Y,
+  defineTheme: X,
+  dim: C,
+  gray: b,
+  green: u,
+  greenBright: j,
+  hidden: R,
+  inverse: O,
+  italic: i,
+  magenta: _,
+  magentaBright: U,
+  overline: w,
+  red: l,
+  redBright: P,
+  reset: y,
+  strikethrough: E,
+  supportsColor: c,
+  underline: g,
+  white: v,
+  whiteBright: $,
+  yellow: d,
+  yellowBright: F
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  G as A,
+  S as B,
+  N as C,
+  h as D,
+  k as E,
+  P as F,
+  j as G,
+  F as H,
+  H as I,
+  U as J,
+  Y as K,
+  $ as L,
+  z as M,
+  K as N,
+  V as O,
+  W as P,
+  q as Q,
+  J as R,
+  Q as S,
+  X as T,
+  es as a,
+  a as b,
+  f as c,
+  s as d,
+  C as e,
+  O as f,
+  b as g,
+  R as h,
+  i,
+  E as j,
+  I as k,
+  l,
+  u as m,
+  T as n,
+  w as o,
+  _ as p,
+  A as q,
+  y as r,
+  c as s,
+  L as t,
+  g as u,
+  M as v,
+  v as w,
+  x,
+  d as y,
+  D as z
+};

package/dist/chunks/error-Cj2qDfOl.js

@@ -0,0 +1,95 @@
+class n extends Error {
+  /**
+   * Creates a new input validation error.
+   * @param messages The messages.
+   */
+  constructor(r) {
+    super(`Validation failed: ${r.join(", ")}`), this.messages = r;
+  }
+}
+class o extends Error {
+  /**
+   * Creates a new LunarCLI error.
+   * @param message The message.
+   * @param command The command.
+   */
+  constructor(r, s) {
+    super(r), this.command = s;
+  }
+  /**
+   * Prints the error's message.
+   */
+  print() {
+    console.error(this.message);
+  }
+}
+class i extends o {
+  /**
+   * Creates a new help asked error.
+   * @param command The command.
+   */
+  constructor(r) {
+    super("user asked for help!", r);
+  }
+}
+class a extends o {
+  /**
+   * Creates a new too many arguments error.
+   * @param command The command.
+   */
+  constructor(r) {
+    super("too many arguments!", r);
+  }
+}
+class u extends o {
+  /**
+   * Creates a new unknown option error.
+   * @param command The command.
+   * @param key The key.
+   */
+  constructor(r, s) {
+    super(`unknown option: ${s}!`, r), this.key = s;
+  }
+}
+class c extends o {
+  /**
+   * Creates a new missing required option error.
+   * @param command The command.
+   * @param key The key.
+   * @param entry The entry.
+   */
+  constructor(r, s, t) {
+    super(`missing required option: ${s}!`, r), this.key = s, this.entry = t;
+  }
+}
+class d extends o {
+  /**
+   * Creates a new missing required argument error.
+   * @param command The command.
+   * @param key The key.
+   * @param entry The entry.
+   */
+  constructor(r, s, t) {
+    super(`missing required positional argument: ${s}!`, r), this.key = s, this.entry = t;
+  }
+}
+const l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  HelpAskedError: i,
+  InputValidationError: n,
+  LunarCLIError: o,
+  MissingRequiredArgumentError: d,
+  MissingRequiredOptionError: c,
+  TooManyArgumentsError: a,
+  UnknownOptionError: u
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  i as H,
+  n as I,
+  o as L,
+  c as M,
+  a as T,
+  u as U,
+  d as a,
+  l as e
+};

package/dist/chunks/index-G2nVXKup.js

@@ -0,0 +1,198 @@
+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 { 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;
+function E(e) {
+  l = e;
+}
+async function L(e) {
+  const n = (e.theme ?? l).primary(e.message) + " ", t = await m(n, e.default);
+  if (e.minLength && t.length < e.minLength)
+    throw new f([
+      `Must be at least ${e.minLength} characters`
+    ]);
+  if (e.maxLength && t.length > e.maxLength)
+    throw new f([
+      `Must be at most ${e.maxLength} characters`
+    ]);
+  if (typeof e.validate == "function") {
+    if (!e.validate(t))
+      throw new f([
+        "Validation function returned a falsy value"
+      ]);
+  } else e.validate && p(e.validate, t);
+  return t;
+}
+async function I(e) {
+  const a = e.theme ?? l, n = await m(a.primary(e.message) + " ", void 0, {
+    masked: !0,
+    maskChar: e.mask ?? "*"
+  });
+  if (e.confirm) {
+    const t = await m(
+      a.secondary("Confirm password: "),
+      void 0,
+      {
+        masked: !0,
+        maskChar: e.mask ?? "*"
+      }
+    );
+    if (n !== t) throw new Error(a.error("Passwords do not match"));
+  }
+  return n;
+}
+async function k(e) {
+  const a = e.theme ?? l, n = e.options;
+  let t = e.initialIndex ?? 0;
+  const i = () => {
+    d(n.length + 1), console.log(a.primary(e.message));
+    for (let s = 0; s < n.length; s++) {
+      const r = n[s], c = s === t ? a.accent?.("> ") ?? "> " : "  ", o = r.disabled ? a.secondary(r.label) : a.foreground?.(r.label) ?? r.label;
+      console.log(c + o);
+    }
+  };
+  for (console.log(a.primary(e.message)), n.forEach(
+    (s, r) => console.log(`${r === t ? "> " : "  "}${s.label}`)
+  ); ; ) {
+    const s = await g();
+    if (s === "up" && t > 0) t--;
+    else if (s === "down" && t < n.length - 1) t++;
+    else if (s === "enter") {
+      const r = n[t];
+      if (r.disabled) continue;
+      return d(n.length + 1), console.log(a.success(`${a.symbols?.success ?? "✔"} ${r.label}`)), r.value;
+    }
+    i();
+  }
+}
+async function T(e) {
+  const a = e.theme ?? l, n = e.options;
+  let t = e.initialIndex ?? 0;
+  const i = /* @__PURE__ */ new Set(), s = () => {
+    d(), console.log(a.primary(e.message)), n.forEach((r, c) => {
+      const o = c === t ? a.accent?.("> ") ?? "> " : "  ", u = i.has(c) ? a.success("[x]") : "[ ]";
+      console.log(o + u + " " + r.label);
+    });
+  };
+  for (s(); ; ) {
+    const r = await g();
+    if (r === "up" && t > 0) t--;
+    else if (r === "down" && t < n.length - 1) t++;
+    else if (r === "space")
+      i.has(t) ? i.delete(t) : i.add(t);
+    else if (r === "return") {
+      const c = Array.from(i).map((o) => n[o].value);
+      return d(n.length + 1), console.log(a.success(`${e.message} ${c.length} selected`)), c;
+    }
+    x(n.length), s();
+  }
+}
+async function _(e) {
+  const a = e.theme ?? l;
+  let n = "";
+  const t = e.filter ?? ((i, s) => s.label.toLowerCase().includes(i.toLowerCase()));
+  for (; ; ) {
+    d(), console.log(a.primary(e.message));
+    const i = e.options.filter((r) => t(n, r));
+    i.forEach(
+      (r) => console.log("  " + (a.foreground?.(r.label) ?? r.label))
+    );
+    const s = await m(a.secondary(`Search: ${n}`));
+    if (s !== "" && (n = s, i.length === 1))
+      return i[0].value;
+  }
+}
+async function C(e) {
+  const a = e.theme ?? l, n = e.yesLabel ?? "y", t = e.noLabel ?? "n", i = e.default ? n : t, s = await m(
+    `${a.primary(e.message)} ${a.secondary(`[${n}/${t}] (default: ${i})`)} `
+  );
+  return s ? /^y/i.test(s.trim()) : !!e.default;
+}
+async function F(e) {
+  const a = e.theme ?? {
+    primary: (n) => n,
+    secondary: (n) => n
+  };
+  console.log(a.primary(e.message ?? "Please enter text:")), console.log(a.secondary("Press Ctrl+D (or save & close editor) when done."));
+  try {
+    const n = await P(e.initial ?? "");
+    if (e.required && !n.trim()) throw new Error("Input required.");
+    return n;
+  } catch {
+    const n = await m("", e.initial, {});
+    if (e.required && !n.trim()) throw new Error("Input required.");
+    return n;
+  }
+}
+async function P(e) {
+  const a = `edit-${Date.now()}.txt`;
+  if ($) {
+    const t = `${Deno.env.get("TMPDIR") ?? "/tmp"}/${a}`;
+    await Deno.writeTextFile(t, e ?? "");
+    const i = Deno.env.get("EDITOR") ?? "vi", r = await new Deno.Command(i, {
+      args: [t],
+      stdin: "inherit",
+      stdout: "inherit",
+      stderr: "inherit"
+    }).spawn().status;
+    if (!r.success)
+      throw new Error(`${i} exited with ${r.code}`);
+    const c = await Deno.readTextFile(t);
+    return await Deno.remove(t).catch(() => {
+    }), c;
+  }
+  if (v) {
+    const { $: n } = await import("bun"), t = `/tmp/${a}`;
+    await Bun.write(t, e ?? "");
+    const i = process.env.EDITOR ?? "vi";
+    await n`${i} ${t}`;
+    const s = await Bun.file(t).text();
+    return await Bun.write(t, ""), s;
+  }
+  if (b) {
+    const { tmpdir: n } = await import("./__vite-browser-external-DQYBmsno.js").then((o) => o._), { join: t } = await import("./__vite-browser-external-DQYBmsno.js").then((o) => o._), { promises: i } = await import("./__vite-browser-external-DQYBmsno.js").then((o) => o._), { spawn: s } = await import("./__vite-browser-external-DQYBmsno.js").then((o) => o._), r = t(n(), a);
+    await i.writeFile(r, e ?? "", "utf8");
+    const c = process.env.EDITOR || process.env.VISUAL || (process.platform === "win32" ? "notepad" : "vi");
+    return new Promise((o, u) => {
+      s(c, [r], { stdio: "inherit" }).on("exit", async (w) => {
+        if (w !== 0) {
+          u(new Error(`${c} exited with code ${w}`));
+          return;
+        }
+        try {
+          const h = await i.readFile(r, "utf8");
+          await i.unlink(r).catch(() => {
+          }), o(h);
+        } catch (h) {
+          u(h);
+        }
+      });
+    });
+  }
+  throw new Error("Unsupported runtime for system editor.");
+}
+const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  confirm: C,
+  editor: F,
+  multiselect: T,
+  password: I,
+  raw: D,
+  search: _,
+  select: k,
+  setTheme: E,
+  text: L
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  k as a,
+  _ as b,
+  C as c,
+  F as e,
+  U as i,
+  T as m,
+  I as p,
+  E as s,
+  L as t
+};

package/dist/chunks/input-COjWPD53.js

@@ -0,0 +1,135 @@
+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);
+}
+class i {
+  /**
+   * 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(/^-+/, ""));
+  }
+  /**
+   * Makes this option a list.
+   * @returns this
+   */
+  list() {
+    return this.$list = !0, this;
+  }
+  /**
+   * Makes this option required.
+   * @returns this
+   */
+  required() {
+    return this.$required = !0, this;
+  }
+  /**
+   * Makes this option optional.
+   * @returns this
+   */
+  optional() {
+    return this.$required = !1, this;
+  }
+  /**
+   * Sets a default value.
+   * @param value The default value.
+   * @returns this
+   */
+  default(t) {
+    return this.$default = t, this;
+  }
+  /**
+   * Sets a description.
+   * @param desc The description.
+   * @returns this
+   */
+  description(t) {
+    return this.$description = t, this;
+  }
+}
+class e {
+  /**
+   * Creates a new positional argument.
+   * @param kind The positional argument.
+   */
+  constructor(t) {
+    this.$required = !0, this.$list = !1, this.$kind = t;
+  }
+  /**
+   * Makes this argument a list.
+   * @returns this
+   */
+  list() {
+    return this.$list = !0, this;
+  }
+  /**
+   * Makes this argument required.
+   * @returns this
+   */
+  required() {
+    return this.$required = !0, this;
+  }
+  /**
+   * Makes this argument optional.
+   * @returns this
+   */
+  optional() {
+    return this.$required = !1, this;
+  }
+  /**
+   * Sets a default value.
+   * @param value The default value.
+   * @returns this
+   */
+  default(t) {
+    return this.$default = t, this;
+  }
+  /**
+   * Sets a description.
+   * @param desc The description.
+   * @returns this
+   */
+  description(t) {
+    return this.$description = t, this;
+  }
+}
+function a(r, ...t) {
+  return new i(r, t);
+}
+function h(r) {
+  return new e(r);
+}
+function c(r) {
+  return new e(r);
+}
+const d = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  Option: i,
+  Positional: e,
+  argument: c,
+  convert: o,
+  option: a,
+  positional: h
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  i as O,
+  e as P,
+  c as a,
+  o as c,
+  d as i,
+  a as o,
+  h as p
+};