bob-core 2.0.0-beta.2 → 2.0.0-beta.20

package/dist/esm/index.js

@@ -1,1066 +0,0 @@
-import I from "minimist";
-import a from "chalk";
-import w from "prompts";
-import * as F from "node:fs";
-import S from "path";
-import * as V from "string-similarity";
-class y extends Error {
-}
-class J extends y {
-  constructor(t) {
-    let e = `Argument "${t.param}" value is invalid.`;
-    t.reason ? e += ` Reason: ${t.reason}` : e += ` Value: "${t.value}"`, super(e), this.param = t;
-  }
-  pretty(t) {
-    t.log(a`  {white.bgRed  ERROR } Argument {bold.yellow ${this.param.param}} value is invalid. `), (this.param.value || this.param.reason) && t.log(""), this.param.value && t.log(a`  {blue Value}: ${this.param.value}`), this.param.reason && t.log(a`  {yellow Reason}: ${this.param.reason}`);
-  }
-}
-class $ extends y {
-  constructor(t) {
-    let e = `Option "${t.option}" value is invalid.`;
-    t.reason ? e += ` Reason: ${t.reason}` : e += ` Value: "${t.value}"`, super(e), this.param = t;
-  }
-  pretty(t) {
-    t.log(a`  {white.bgRed  ERROR } Option {bold.yellow ${this.param.option}} value is invalid. `), (this.param.value || this.param.reason) && t.log(""), this.param.value && t.log(a`  {blue Value}: ${this.param.value}`), this.param.reason && t.log(a`  {yellow Reason}: ${this.param.reason}`);
-  }
-}
-function E(r) {
-  if (r === "string" || r === "number") return null;
-  if (r === "boolean") return !1;
-  if (Array.isArray(r) && r.length === 1) {
-    if (r[0] === "string") return [];
-    if (r[0] === "number") return [];
-  }
-  throw new Error("Invalid option type: " + r);
-}
-function D(r) {
-  return typeof r == "string" ? E(r) : Array.isArray(r) ? [] : typeof r == "object" && r.type ? r.default !== void 0 ? r.default : E(r.type) : null;
-}
-function f(r) {
-  return typeof r == "string" || Array.isArray(r) ? {
-    type: r,
-    default: D(r),
-    description: "",
-    alias: [],
-    required: !1,
-    variadic: !1
-  } : {
-    type: r.type,
-    default: r.default ?? D(r.type),
-    description: r.description ?? "",
-    alias: r.alias ? Array.isArray(r.alias) ? r.alias : [r.alias] : [],
-    required: r.required ?? !1,
-    variadic: r.variadic ?? !1
-  };
-}
-class H extends y {
-  constructor(t, e = {}) {
-    super(`Invalid option ${t} in not recognized`), this.option = t, this.optionsSchema = e;
-  }
-  pretty(t) {
-    const e = Object.entries(this.optionsSchema);
-    if (e.length > 0) {
-      t.log(a`\n{yellow Available options}:`);
-      for (const [n, i] of e) {
-        const s = f(i), o = typeof s.alias == "string" ? [s.alias] : s.alias, l = Array.isArray(s.type) ? `[${s.type[0]}]` : s.type, u = `--${n}${o.length > 0 ? o.map((m) => `, -${m}`).join("") : ""}`, c = " ".repeat(30 - u.length);
-        t.log(a`  {green ${u}} ${c} ${s.description || "\b"} {white (${l})}`);
-      }
-      t.log("");
-    }
-    t.log(a`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is not recognized.`);
-  }
-}
-class j extends y {
-  constructor(t) {
-    super(`Command "${t}" not found.`), this.command = t;
-  }
-  pretty(t) {
-    t.log(a`{bgRed  ERROR } Command {yellow ${this.command}} not found.`);
-  }
-}
-class v extends y {
-  constructor(t, e) {
-    super(`Missing ${t} in the command signature`), this.argument = t, this.argumentsSchema = e;
-  }
-  pretty(t) {
-    const e = Object.entries(this.argumentsSchema);
-    if (e.length) {
-      t.log(a`\n{yellow Available arguments}:`);
-      for (const [n, i] of e) {
-        const s = f(i), o = Array.isArray(s.type) ? `[${s.type[0]}]` : s.type, l = o ? a`{white (${o})}` : "", u = " ".repeat(20 - n.length);
-        t.log(a`  {green ${n}} ${u} ${s.description ?? "\b"} ${l}`);
-      }
-      t.log("");
-    }
-    t.log(a`{white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is missing in the signature.`);
-  }
-}
-class b extends y {
-  constructor(t, e) {
-    super(`Missing ${t} in the command signature`), this.option = t, this.optionsSchema = e;
-  }
-  pretty(t) {
-    const e = Object.entries(this.optionsSchema);
-    if (e.length) {
-      t.log(a`{yellow Available options}:`);
-      for (const [n, i] of e) {
-        const s = f(i), o = Array.isArray(s.type) ? `[${s.type[0]}]` : s.type, l = o ? a`{white (${o})}` : "", u = " ".repeat(20 - n.length);
-        t.log(a`  {green ${n}} ${u} ${s.description ?? "\b"} ${l}`);
-      }
-      t.log("");
-    }
-    t.log(a`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is missing in the signature.`);
-  }
-}
-class C extends y {
-  constructor(t) {
-    super(`Argument "${t}" is required.`), this.argument = t;
-  }
-  pretty(t) {
-    t.log(a`{white.bgRed  ERROR } Argument {bold.yellow ${this.argument}} is required.`);
-  }
-}
-class T extends y {
-  constructor(t) {
-    super(`Argument "${t}" is required.`), this.option = t;
-  }
-  pretty(t) {
-    t.log(a`{white.bgRed  ERROR } Option {bold.yellow ${this.option}} is required.`);
-  }
-}
-function A(r, t, e, n) {
-  if (r == null)
-    return n ?? null;
-  if (t === "string")
-    return String(r);
-  if (t === "number") {
-    const i = Number(r);
-    if (isNaN(i))
-      throw new $({
-        option: e,
-        reason: `Expected a number, got "${r}"`
-      });
-    return i;
-  }
-  if (t === "boolean")
-    return typeof r == "boolean" ? r : r === "true" || r === "1" ? !0 : r === "false" || r === "0" ? !1 : !!r;
-  if (Array.isArray(t)) {
-    const i = t[0], s = Array.isArray(r) ? r : [r];
-    if (i === "string")
-      return s.map((o) => String(o));
-    if (i === "number")
-      return s.map((o) => {
-        const l = Number(o);
-        if (isNaN(l))
-          throw new $({
-            option: e,
-            reason: `Expected array of numbers, got "${o}" in array`
-          });
-        return l;
-      });
-  }
-  return r;
-}
-class k {
-  options;
-  parsedOptions = null;
-  arguments;
-  parsedArguments = null;
-  io;
-  constructor(t) {
-    this.options = t.options, this.arguments = t.arguments, this.io = t.io;
-  }
-  // === PUBLIC METHODS ===
-  /**
-   * Parses raw command-line arguments into structured options and arguments
-   * @param args - Raw command line arguments (typically from process.argv.slice(2))
-   * @returns Object containing parsed options and arguments
-   * @throws {InvalidOption} If an unknown option is provided
-   * @throws {BadCommandOption} If a value cannot be converted to the expected type
-   */
-  init(t) {
-    const { _: e, ...n } = I(t);
-    return this.validateUnknownOptions(n), this.parsedOptions = this.handleOptions(n), this.parsedArguments = this.handleArguments(e), {
-      options: this.parsedOptions,
-      arguments: this.parsedArguments
-    };
-  }
-  /**
-   * Validates the parsed options and arguments
-   * @throws {Error} If validation fails
-   */
-  async validate() {
-    for (const t in this.options)
-      if (f(this.options[t]).required && (this.parsedOptions?.[t] === void 0 || this.parsedOptions?.[t] === null))
-        throw new T(t);
-    for (const t in this.arguments)
-      if (f(this.arguments[t]).required && (this.parsedArguments?.[t] === void 0 || this.parsedArguments?.[t] === null))
-        throw new C(t);
-  }
-  /**
-   * Retrieves a parsed option value by name
-   * @param name - The option name
-   * @returns The typed option value
-   * @throws {Error} If init() has not been called yet
-   */
-  option(t) {
-    if (!this.parsedOptions)
-      throw new Error("Options have not been parsed yet. Call init() first.");
-    return this.parsedOptions[t];
-  }
-  /**
-   * Retrieves a parsed argument value by name
-   * @param name - The argument name
-   * @returns The typed argument value
-   * @throws {Error} If init() has not been called yet
-   */
-  argument(t) {
-    if (!this.parsedArguments)
-      throw new Error("Arguments have not been parsed yet. Call init() first.");
-    return this.parsedArguments[t];
-  }
-  // === PRIVATE HELPERS ===
-  /**
-   * Validates that all provided options are recognized
-   * @throws {InvalidOption} If an unknown option is found
-   */
-  validateUnknownOptions(t) {
-    const e = /* @__PURE__ */ new Set();
-    for (const n in this.options) {
-      e.add(n);
-      const i = f(this.options[n]);
-      for (const s of i.alias)
-        e.add(s);
-    }
-    for (const n in t)
-      if (!e.has(n))
-        throw new H(n, this.options);
-  }
-  /**
-   * Processes named options from minimist output
-   */
-  handleOptions(t) {
-    const e = {};
-    for (const n in this.options) {
-      const i = f(this.options[n]);
-      e[n] = this.resolveOptionValue(
-        n,
-        i,
-        t,
-        "option"
-      );
-    }
-    return e;
-  }
-  /**
-   * Processes positional arguments from minimist output
-   */
-  handleArguments(t) {
-    const e = {}, n = [...t];
-    for (const i in this.arguments) {
-      const s = f(this.arguments[i]);
-      if (s.variadic) {
-        e[i] = this.handleVariadicArgument(i, s, n);
-        continue;
-      }
-      e[i] = this.resolveArgumentValue(i, s, n.shift());
-    }
-    return e;
-  }
-  /**
-   * Handles variadic arguments that consume all remaining positional values
-   */
-  handleVariadicArgument(t, e, n) {
-    return n.length ? A(n, e.type, t, e.default) : e.default;
-  }
-  /**
-   * Resolves a single positional argument value with defaults and type conversion
-   * Note: Does not validate required arguments - validation happens in subclass validate() methods
-   */
-  resolveArgumentValue(t, e, n) {
-    return n === void 0 ? e.default : A(n, e.type, t, e.default);
-  }
-  /**
-   * Resolves an option value from the parsed option values object
-   * Handles alias resolution, defaults, and type conversion
-   */
-  resolveOptionValue(t, e, n, i) {
-    let s;
-    const o = [t, ...e.alias];
-    for (const l of o)
-      if (l in n) {
-        s = n[l];
-        break;
-      }
-    if (s === void 0) {
-      if (e.required)
-        throw new $({
-          option: t,
-          reason: `${i === "option" ? "Option" : "Argument"} is required but not provided`
-        });
-      return e.default;
-    }
-    return A(s, e.type, t, e.default);
-  }
-  optionDefinitions() {
-    const t = {};
-    for (const e in this.options)
-      t[e] = f(this.options[e]);
-    return t;
-  }
-  argumentDefinitions() {
-    const t = {};
-    for (const e in this.arguments)
-      t[e] = f(this.arguments[e]);
-    return t;
-  }
-  availableOptions() {
-    return Object.keys(this.options);
-  }
-  availableArguments() {
-    return Object.keys(this.arguments);
-  }
-}
-function O(r) {
-  return new Array(r + 5).join(" ");
-}
-class W {
-  type = "boolean";
-  option = "help";
-  alias = ["h"];
-  default = !1;
-  description = a`Display help for the given command. When no command is given display help for the {green list} command`;
-  async handler() {
-    const t = this.parser.argumentDefinitions(), e = this.parser.optionDefinitions(), n = Object.entries(t), i = Object.entries(e), s = i.map(([m, h]) => {
-      const d = Array.isArray(h.alias) ? h.alias : h.alias ? [h.alias] : [];
-      return {
-        name: m,
-        ...h,
-        optionWithAlias: `--${m}${d.map((p) => `, -${p}`).join("")}`
-      };
-    }), o = n.filter(([, m]) => m.required);
-    this.io.log(a`{yellow Description}:`), this.io.log(a`  ${this.description}\n`), this.io.log(a`{yellow Usage}:`), this.io.log(a`  ${this.command} ${o.length > 0 ? o.map(([m]) => `<${m}>`).join(" ") : "\b"} [options]`);
-    const l = Math.max(...s.map((m) => m.optionWithAlias.length), 0), u = Math.max(...n.map(([m]) => m.length), 0), c = u > l ? u : l;
-    if (n.length > 0) {
-      this.io.log(a`\n{yellow Arguments}:`);
-      for (const [m, h] of n) {
-        const d = O(c - m.length);
-        let p = a`  {green ${m}} ${d} ${h.description ?? "\b"}`;
-        if (h.default !== void 0 && !h.required) {
-          const N = (Array.isArray(h.type) ? `[${h.type[0]}]` : h.type) === "array" || Array.isArray(h.type) ? JSON.stringify(h.default) : h.default;
-          p += a` {yellow [default: ${N}]}`;
-        }
-        h.variadic && (p += a` {white (variadic)}`), this.io.log(p);
-      }
-    }
-    if (i.length > 0) {
-      this.io.log(a`\n{yellow Options}:`);
-      for (const m of s) {
-        const h = O(c - m.optionWithAlias.length);
-        let d = a`{green ${m.optionWithAlias}} ${h} ${m.description ?? "\b"}`;
-        if (m.type) {
-          const p = Array.isArray(m.type) ? `[${m.type[0]}]` : m.type;
-          d += a` {white (${p})}`;
-        }
-        if (m.default !== void 0 && !m.required) {
-          const x = (Array.isArray(m.type) ? `[${m.type[0]}]` : m.type) === "array" || Array.isArray(m.type) ? JSON.stringify(m.default) : m.default;
-          d += a` {yellow [default: ${x}]}`;
-        }
-        this.io.log(d);
-      }
-    }
-    if (this.commandsExamples.length > 0) {
-      this.io.log(a`\n{yellow Examples}:`);
-      let m = process.argv[0].split("/").pop();
-      m === "node" && (m += " " + process.argv[1].split("/").pop());
-      for (const [h, d] of this.commandsExamples.entries())
-        h > 0 && this.io.log(""), this.io.log(`  ${d.description}
-`), this.io.log(a`    {green ${m} ${d.command}}`);
-    }
-    return -1;
-  }
-}
-class q {
-  logger;
-  constructor(t) {
-    this.logger = t;
-  }
-  /**
-   * Logger methods
-   */
-  log(...t) {
-    this.logger.log(...t);
-  }
-  info(...t) {
-    this.logger.info(...t);
-  }
-  warn(...t) {
-    this.logger.warn(...t);
-  }
-  error(...t) {
-    this.logger.error(...t);
-  }
-  debug(...t) {
-    this.logger.debug(...t);
-  }
-  verbose(...t) {
-    this.logger.verbose(...t);
-  }
-  /**
-   * Prompt utils
-   */
-  async askForConfirmation(t = "Do you want to continue?", e) {
-    return (await w({
-      type: "confirm",
-      name: "value",
-      message: t,
-      initial: e ?? !1
-    })).value;
-  }
-  async askForInput(t, e, n) {
-    return (await w({
-      type: "text",
-      name: "value",
-      message: t,
-      initial: e,
-      ...n
-    }))?.value ?? null;
-  }
-  async askForToggle(t, e, n) {
-    return (await w({
-      type: "toggle",
-      name: "value",
-      message: t,
-      initial: e,
-      ...n
-    }))?.value ?? null;
-  }
-  async askForSelect(t, e, n) {
-    if (e.length === 0)
-      throw new Error("No options provided");
-    const i = [];
-    for (const o of e)
-      typeof o == "string" ? i.push({ title: o, value: o }) : i.push(o);
-    return (await w({
-      type: "select",
-      name: "value",
-      message: t,
-      choices: i,
-      ...n
-    }))?.value ?? null;
-  }
-  newLoader(t = "", e = ["⠙", "⠘", "⠰", "⠴", "⠤", "⠦", "⠆", "⠃", "⠋", "⠉"], n = 100) {
-    let i = t, s = null, o = 0;
-    const l = setInterval(function() {
-      s && (process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(s.length + 5) + "\r")), s = null), process.stdout.write(new TextEncoder().encode("\r" + e[o++] + " " + i)), o = o % e.length;
-    }, n), u = () => {
-      clearInterval(l), process.stdout.write(new TextEncoder().encode("\r" + " ".repeat(i.length + 5) + "\r"));
-    };
-    return {
-      [Symbol.dispose]: u,
-      [Symbol.asyncDispose]: u,
-      updateText: (c) => {
-        s = i, i = c;
-      },
-      stop: u
-    };
-  }
-}
-class R {
-  _command;
-  description = "";
-  commandsExamples = [];
-  get command() {
-    return this._command;
-  }
-  ctx;
-  io;
-  logger;
-  _handler;
-  parser;
-  tmp;
-  defaultOptions() {
-    return [new W()];
-  }
-  newCommandParser(t) {
-    return new k({
-      io: t.io,
-      options: t.options,
-      arguments: t.arguments
-    });
-  }
-  newCommandIO(t) {
-    return new q(t.logger);
-  }
-  constructor(t, e) {
-    this._command = t, this.description = e?.description ?? "";
-    const n = this.defaultOptions();
-    if (n.length > 0) {
-      this.tmp = {
-        options: {},
-        arguments: {}
-      };
-      for (const i of n)
-        this.tmp.options[i.option] = i;
-    }
-  }
-  handler(t) {
-    return this._handler = t, this;
-  }
-  options(t) {
-    return this.tmp = {
-      options: {
-        ...this.tmp?.options ?? {},
-        ...t
-      },
-      arguments: this.tmp?.arguments ?? {}
-    }, this;
-  }
-  arguments(t) {
-    return this.tmp = {
-      options: this.tmp?.options ?? {},
-      arguments: {
-        ...this.tmp?.arguments ?? {},
-        ...t
-      }
-    }, this;
-  }
-  async run(t) {
-    if (!this._handler && !this.handle)
-      throw new Error(`No handler defined for command ${this.command || "(unknown)"}`);
-    let e;
-    if (this.ctx = t.ctx, this.logger = t.logger, this.io = this.newCommandIO({
-      logger: t.logger
-    }), t && "args" in t) {
-      const s = this.tmp?.options ?? {};
-      for (const o of this.defaultOptions())
-        o.option in s || (s[o.option] = o);
-      this.parser = this.newCommandParser({
-        io: this.io,
-        options: s,
-        arguments: this.tmp?.arguments ?? {}
-      }), e = this.parser.init(t.args);
-      for (const o of this.defaultOptions())
-        if (e.options[o.option] === !0) {
-          const l = await o.handler.call(this);
-          if (l && l !== 0)
-            return l;
-        }
-      await this.parser.validate();
-    } else
-      e = {
-        options: t.options,
-        arguments: t.arguments
-      };
-    const n = this.preHandle ? await this.preHandle() : null;
-    if (n && n !== 0)
-      return n;
-    if (!this._handler && this.handle)
-      this._handler = this.handle.bind(this);
-    else if (!this._handler)
-      throw new Error(`No handler defined for command ${this.command || "(unknown)"}`);
-    return await this._handler(t.ctx, e) ?? 0;
-  }
-}
-class g extends k {
-  command;
-  argumentsSchema;
-  optionsSchema;
-  constructor(t) {
-    const e = g.parseSignature(
-      t.signature,
-      t.helperDefinitions,
-      t.defaultOptions
-    );
-    super({ io: t.io, options: e.options, arguments: e.arguments }), this.command = e.command, this.optionsSchema = e.options, this.argumentsSchema = e.arguments;
-  }
-  /**
-   * Parses command signature string into command name and parameter schemas
-   * Example: "migrate {name} {--force}" -> { command: "migrate", arguments: {name: ...}, options: {force: ...} }
-   */
-  static parseSignature(t, e, n) {
-    const [i, ...s] = t.split(/\{(.*?)\}/g).map((u) => u.trim()).filter(Boolean), o = {}, l = {};
-    for (const u of s) {
-      const { name: c, isOption: m, definition: h } = g.parseParamSignature(
-        u,
-        e
-      );
-      m ? o[c] = h : l[c] = h;
-    }
-    for (const u of n)
-      o[u.option] = {
-        type: u.type,
-        required: u.required,
-        alias: u.alias,
-        variadic: u.variadic ?? !1,
-        description: u.description,
-        default: u.default ?? null
-      };
-    return { command: i, options: o, arguments: l };
-  }
-  // === PUBLIC API ===
-  /**
-   * Retrieves an option value by name, with signature validation
-   */
-  option(t) {
-    if (!this.optionsSchema[t])
-      throw new b(t, this.optionsSchema);
-    return super.option(t);
-  }
-  /**
-   * Sets an option value programmatically
-   */
-  setOption(t, e) {
-    if (!this.optionsSchema[t])
-      throw new b(t, this.optionsSchema);
-    this.parsedOptions && (this.parsedOptions[t] = e);
-  }
-  /**
-   * Retrieves the description/help text for an option
-   */
-  optionHelp(t) {
-    if (!this.optionsSchema[t])
-      throw new b(t, this.optionsSchema);
-    return f(this.optionsSchema[t]).description;
-  }
-  /**
-   * Retrieves the description/help text for an argument
-   */
-  argumentHelp(t) {
-    if (!this.argumentsSchema[t])
-      throw new v(t, this.argumentsSchema);
-    return f(this.argumentsSchema[t]).description;
-  }
-  /**
-   * Retrieves an argument value by name, with signature validation
-   */
-  argument(t) {
-    if (!this.argumentsSchema[t])
-      throw new v(t, this.argumentsSchema);
-    return super.argument(t);
-  }
-  /**
-   * Sets an argument value programmatically
-   */
-  setArgument(t, e) {
-    if (!this.argumentsSchema[t])
-      throw new v(t, this.argumentsSchema);
-    this.parsedArguments && (this.parsedArguments[t] = e);
-  }
-  /**
-   * Returns all argument definitions from the signature
-   */
-  getArgumentSignatures() {
-    return this.argumentsSchema;
-  }
-  /**
-   * Returns all option definitions from the signature
-   */
-  getOptionSignatures() {
-    return this.optionsSchema;
-  }
-  /**
-   * Parses a single parameter signature like "{name}" or "{--force}" or "{files*}"
-   * Extracts name, type, default value, aliases, description, etc.
-   *
-   * Signature syntax:
-   * - {arg}          -> required string argument
-   * - {arg?}         -> optional argument
-   * - {arg=default}  -> argument with default value
-   * - {arg*}         -> variadic argument (array)
-   * - {arg:desc}     -> argument with description
-   * - {--opt}        -> boolean option
-   * - {--opt=}       -> string option
-   * - {--opt|o}      -> option with alias
-   */
-  static parseParamSignature(t, e) {
-    let n = t, i = !1;
-    const s = {
-      required: !0,
-      type: "string",
-      description: void 0,
-      default: null,
-      variadic: !1
-    };
-    if (n.includes(":")) {
-      const [o, l] = n.split(":");
-      n = o.trim(), s.description = l.trim();
-    }
-    if (n.includes("=")) {
-      const [o, l] = n.split("=");
-      n = o.trim(), s.default = l.trim(), s.required = !1, s.default.length ? s.default === "true" ? (s.default = !0, s.type = "boolean") : s.default === "false" && (s.default = !1, s.type = "boolean") : s.default = null;
-    } else n.startsWith("--") && (s.required = !1, s.default = !1, s.type = "boolean");
-    if (n.includes("|")) {
-      const [o, ...l] = n.split("|");
-      n = o.trim(), s.alias = l.map((u) => u.trim());
-    }
-    return n.startsWith("--") && (i = !0, n = n.slice(2)), s.default === "*" && (s.default = [], s.type = ["string"]), n.endsWith("?") && (s.required = !1, n = n.slice(0, -1)), n.endsWith("*") && (s.type = ["string"], s.variadic = !0, s.default = [], n = n.slice(0, -1)), s.description = s.description ?? e[n] ?? e[`--${n}`], { name: n, isOption: i, definition: s };
-  }
-  /**
-   * Validates that all required arguments are present
-   * If missing, prompts the user via CommandIO to provide them
-   * @throws {MissingRequiredArgumentValue} If a required argument cannot be obtained
-   */
-  async validate() {
-    for (const t in this.argumentsSchema) {
-      const e = f(this.argumentsSchema[t]), n = this.argument(t);
-      if (!n && e.required) {
-        const i = await this.promptForArgument(t, e);
-        if (i)
-          this.setArgument(t, i);
-        else
-          throw new C(t);
-      }
-      if (e.variadic && e.required && typeof n == "object" && !n?.length)
-        throw new C(t);
-    }
-  }
-  /**
-   * Prompts the user to provide a missing argument value via CommandIO
-   */
-  async promptForArgument(t, e) {
-    if (e.type !== "string")
-      return null;
-    let n = a`{yellow.bold ${t}} is required`;
-    return e.description && (n += a`: {gray (${e.description})}`), n += `
-`, await this.io.askForInput(
-      n,
-      e.default,
-      {
-        validate: (i) => i?.trim()?.length ? !0 : `${t} cannot be empty`
-      }
-    );
-  }
-  optionValues() {
-    if (!this.parsedOptions)
-      throw new Error("Options have not been parsed yet. Call init() first.");
-    return this.parsedOptions;
-  }
-  argumentValues() {
-    if (!this.parsedArguments)
-      throw new Error("Arguments have not been parsed yet. Call init() first.");
-    return this.parsedArguments;
-  }
-}
-class K extends R {
-  helperDefinitions = {};
-  get command() {
-    return this.parser ? this.parser.command : this.signature.split(" ")[0];
-  }
-  newCommandParser(t) {
-    return new g({
-      io: t.io,
-      signature: this.signature,
-      helperDefinitions: this.helperDefinitions,
-      defaultOptions: this.defaultOptions()
-    });
-  }
-  constructor() {
-    super("");
-  }
-  // Helper methods from LegacyCommand
-  setOption(t, e) {
-    this.parser.setOption(t, e);
-  }
-  setArgument(t, e) {
-    this.parser instanceof g && this.parser.setArgument(t, e);
-  }
-  option(t, e = null) {
-    return this.parser instanceof g ? this.parser.option(t) ?? e : e;
-  }
-  optionBoolean(t, e = !1) {
-    return this.parser instanceof g ? this.parser.option(t) ?? e : e;
-  }
-  optionArray(t, e = []) {
-    if (this.parser instanceof g) {
-      const n = this.parser.option(t);
-      if (!Array.isArray(n))
-        throw new Error(`Option ${t} is not an array`);
-      if (n.length)
-        return n;
-    }
-    return e;
-  }
-  optionNumber(t, e = null) {
-    if (this.parser instanceof g) {
-      const n = this.parser.option(t);
-      return n ? typeof n == "number" ? n : parseInt(n) : e;
-    }
-    return e;
-  }
-  argument(t, e = null) {
-    return this.parser instanceof g ? this.parser.argument(t) ?? e : e;
-  }
-  argumentArray(t, e = []) {
-    if (this.parser instanceof g) {
-      const n = this.parser.argument(t);
-      if (!Array.isArray(n))
-        throw new Error(`Argument ${t} is not an array`);
-      if (n?.length)
-        return n;
-    }
-    return e;
-  }
-  argumentBoolean(t, e = !1) {
-    return this.parser instanceof g ? this.parser.argument(t) ?? e : e;
-  }
-  argumentNumber(t, e = null) {
-    if (this.parser instanceof g) {
-      const n = this.parser.argument(t);
-      return n ? typeof n == "number" ? n : parseInt(n) : e;
-    }
-    return e;
-  }
-  // Prompt utils
-  async askForConfirmation(...t) {
-    return this.io.askForConfirmation(...t);
-  }
-  async askForInput(...t) {
-    return this.io.askForInput(...t);
-  }
-  async askForSelect(...t) {
-    return this.io.askForSelect(...t);
-  }
-  newLoader(...t) {
-    return this.io.newLoader(...t);
-  }
-}
-class L {
-  level;
-  constructor(t = {}) {
-    this.level = t.level ?? "info";
-  }
-  shouldLog(t) {
-    const e = ["debug", "verbose", "info", "warn", "error", "silent"], n = e.indexOf(this.level);
-    return e.indexOf(t) >= n;
-  }
-  setLevel(t) {
-    this.level = t;
-  }
-  getLevel() {
-    return this.level;
-  }
-  log(...t) {
-    console.log(...t);
-  }
-  info(...t) {
-    this.shouldLog("info") && console.log(...t);
-  }
-  warn(...t) {
-    this.shouldLog("warn") && console.warn(...t);
-  }
-  error(...t) {
-    this.shouldLog("error") && console.error(...t);
-  }
-  debug(...t) {
-    this.shouldLog("debug") && console.log(...t);
-  }
-  verbose(...t) {
-    this.shouldLog("verbose") && console.log(...t);
-  }
-}
-class M {
-  commands = {};
-  io;
-  logger;
-  get CommandIOClass() {
-    return q;
-  }
-  constructor(t) {
-    this.logger = t ?? new L(), this.io = new this.CommandIOClass(this.logger);
-  }
-  getAvailableCommands() {
-    return Object.keys(this.commands);
-  }
-  getCommands() {
-    return Object.values(this.commands);
-  }
-  commandResolver = async (t) => {
-    let e = (await import(t)).default;
-    if (!e)
-      throw new Error(`The command at path ${t} does not have a default export.`);
-    e?.default && (e = e.default);
-    let n;
-    if (typeof e == "function")
-      n = new e();
-    else if (e instanceof R)
-      n = e;
-    else
-      throw new Error(`The command at path ${t} is not a valid command class.`);
-    return n;
-  };
-  setCommandResolver(t) {
-    this.commandResolver = t;
-  }
-  registerCommand(t, e = !1) {
-    const n = t.command;
-    if (!n)
-      throw new Error("Command signature is invalid, it must have a command name.");
-    if (!e && this.commands[n])
-      throw new Error(`Command ${n} already registered.`);
-    this.commands[n] = t;
-  }
-  async loadCommandsPath(t) {
-    for await (const e of this.listCommandsFiles(t))
-      try {
-        const n = await this.commandResolver(e);
-        this.registerCommand(n);
-      } catch (n) {
-        throw new Error(`Command ${e} failed to load. ${n}`, {
-          cause: n
-        });
-      }
-  }
-  async runCommand(t, e, ...n) {
-    const i = typeof e == "string" ? this.commands[e] : e, s = typeof e == "string" ? e : i.command;
-    if (!i) {
-      const o = await this.suggestCommand(s);
-      return o ? await this.runCommand(t, o, ...n) : 1;
-    }
-    return await i.run({
-      ctx: t,
-      logger: this.logger,
-      args: n
-    }) ?? 0;
-  }
-  async suggestCommand(t) {
-    const e = this.getAvailableCommands(), { bestMatch: n, bestMatchIndex: i, ratings: s } = V.findBestMatch(t, e), o = s.filter((l) => l.rating > 0.3).map((l) => l.target);
-    if (n.rating > 0 && o.length <= 1 || n.rating > 0.7 && o.length > 1) {
-      const l = e[i];
-      return await this.askRunSimilarCommand(t, l) ? l : null;
-    }
-    if (o.length) {
-      this.io.error(a`{bgRed  ERROR } Command {yellow ${t}} not found.\n`);
-      const l = await this.io.askForSelect(
-        a`{green Did you mean to run one of these commands instead?}`,
-        o
-      );
-      if (l)
-        return l;
-    }
-    throw new j(t);
-  }
-  async askRunSimilarCommand(t, e) {
-    return this.io.error(a`{bgRed  ERROR } Command {yellow ${t}} not found.\n`), this.io.askForConfirmation(a`{green Do you want to run {yellow ${e}} instead?} `);
-  }
-  async *listCommandsFiles(t) {
-    const e = F.readdirSync(t, { withFileTypes: !0 });
-    for (const n of e) {
-      const i = S.resolve(t, n.name);
-      if (n.isDirectory())
-        yield* this.listCommandsFiles(S.resolve(t, n.name));
-      else {
-        if (!i.endsWith(".ts") && !i.endsWith(".js"))
-          continue;
-        yield i;
-      }
-    }
-  }
-}
-class B extends R {
-  constructor(t) {
-    super("help", {
-      description: a.bold("Show help information about the CLI and its commands")
-    }), this.opts = t;
-  }
-  async handle() {
-    const t = this.opts.commandRegistry.getCommands(), e = this.opts.cliName ?? "Bob CLI", n = this.opts.cliVersion ?? "0.0.0", i = (await import("./package-COKp1myj.js"))?.default?.version ?? "0.0.0";
-    this.io.log(a`${e} {green ${n}} (core: {yellow ${i}})
-
-{yellow Usage}:
-  command [options] [arguments]
-
-{yellow Available commands}:
-`);
-    const s = Math.max(...t.map((u) => u.command.length)) ?? 0, o = {};
-    for (const u of t) {
-      const c = u.command.split(":")[0];
-      o[c] || (o[c] = []), o[c].push(u);
-    }
-    const l = Object.entries(o).sort(([u], [c]) => u.toLowerCase().localeCompare(c.toLowerCase())).sort(([, u], [, c]) => u.length - c.length);
-    for (const [u, c] of l) {
-      const m = c.length > 1;
-      m && this.io.log(a`{yellow ${u}}:`);
-      const h = c.sort((d, p) => d.command.toLowerCase().localeCompare(p.command.toLowerCase()));
-      for (const d of h) {
-        let p = O(s - d.command.length);
-        m && (p = p.slice(2)), this.io.log(a`${m ? "  " : ""}{green ${d.command}} ${p} ${d.description}`);
-      }
-    }
-  }
-}
-class P {
-  logger;
-  constructor(t) {
-    this.logger = t;
-  }
-  handle(t) {
-    if (t instanceof y)
-      return t.pretty(this.logger), -1;
-    throw t;
-  }
-}
-class Q {
-  ctx;
-  logger;
-  commandRegistry;
-  exceptionHandler;
-  helpCommand;
-  newCommandRegistry(t) {
-    return new M(t.logger);
-  }
-  newHelpCommand(t) {
-    return new B(t);
-  }
-  newExceptionHandler(t) {
-    return new P(t.logger);
-  }
-  constructor(t = {}) {
-    this.ctx = t.ctx, this.logger = t.logger ?? new L(), this.commandRegistry = this.newCommandRegistry({
-      logger: this.logger
-    }), this.exceptionHandler = this.newExceptionHandler({
-      logger: this.logger
-    }), this.helpCommand = this.newHelpCommand({
-      cliName: t.name,
-      cliVersion: t.version,
-      commandRegistry: this.commandRegistry
-    });
-  }
-  setCommandResolver(t) {
-    this.commandRegistry.setCommandResolver(t);
-  }
-  async withCommands(...t) {
-    for (const e of t)
-      typeof e == "string" ? await this.commandRegistry.loadCommandsPath(e) : typeof e == "function" ? this.registerCommand(new e()) : this.registerCommand(e);
-  }
-  async runCommand(t, ...e) {
-    return t ? await this.commandRegistry.runCommand(this.ctx, t, ...e).catch(this.exceptionHandler.handle.bind(this.exceptionHandler)) : await this.runHelpCommand();
-  }
-  async runHelpCommand() {
-    return await this.runCommand(this.helpCommand);
-  }
-  registerCommand(t) {
-    this.commandRegistry.registerCommand(t);
-  }
-}
-export {
-  $ as BadCommandOption,
-  J as BadCommandParameter,
-  y as BobError,
-  Q as Cli,
-  R as Command,
-  q as CommandIO,
-  j as CommandNotFoundError,
-  k as CommandParser,
-  M as CommandRegistry,
-  g as CommandSignatureParser,
-  K as CommandWithSignature,
-  P as ExceptionHandler,
-  W as HelpOption,
-  H as InvalidOption,
-  L as Logger,
-  C as MissingRequiredArgumentValue,
-  T as MissingRequiredOptionValue,
-  v as MissingSignatureArgument,
-  b as MissingSignatureOption
-};