bob-core 3.0.0-beta.4 → 3.0.0-beta.6

package/dist/cjs/flags/boolean.d.ts

@@ -0,0 +1,20 @@
+import { FlagOpts } from '../lib/types.js';
+/** Boolean flag (`--debug` / `--no-debug`). Defaults to `false` when omitted. */
+export declare const booleanFlag: <const O extends Partial<import('../lib/types.js').FlagDefinition<boolean, import('../lib/types.js').CustomOptions>>>(overrides?: O | undefined) => {
+    [x: string]: unknown;
+} & {
+    parse: (input: any, opts: FlagOpts<any, import('../lib/types.js').CustomOptions>) => boolean;
+    type?: import('../lib/types.js').FlagKind;
+    ask?: (opts: FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: boolean | boolean[] | (() => boolean | boolean[] | null) | (() => Promise<boolean | boolean[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: boolean, opts: FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../lib/types.js').FlagDefinition<boolean, import('../lib/types.js').CustomOptions>, "parse"> & {
+    parse?: ((input: any, opts: FlagOpts<any, import('../lib/types.js').CustomOptions>) => boolean) | undefined;
+} & O;

package/dist/cjs/flags/custom.d.ts

@@ -0,0 +1,12 @@
+import { CustomOptions, FlagDefinition, InitFlagDefinition } from '../lib/types.js';
+/**
+ * Escape hatch for declaring arbitrary parameter types. Returns a builder
+ * function — call it with overrides to produce a `FlagDefinition`.
+ *
+ * `parse` is required when there's no built-in for the target type. `multiple`
+ * defaults the value to `[]`; non-multiple flags default to `null`.
+ *
+ * The `type` literal supplied in `defaults` is preserved in the returned shape
+ * so downstream consumers can rely on it (e.g. for help rendering).
+ */
+export declare function custom<T, C extends CustomOptions = CustomOptions, const D extends InitFlagDefinition<T, C> = InitFlagDefinition<T, C>>(defaults?: D): <const O extends Partial<FlagDefinition<T, C>>>(overrides?: O) => FlagDefinition<T, C> & D & O;

package/dist/cjs/flags/directory.d.ts

@@ -0,0 +1,27 @@
+/** Filesystem directory flag. Pass `exists: true` to require the directory to exist at parse time. */
+export declare const directoryFlag: <const O extends Partial<import('../index.js').FlagDefinition<string, {
+    exists?: boolean;
+}>>>(overrides?: O | undefined) => {
+    exists?: boolean | undefined;
+} & {
+    parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+        exists?: boolean;
+    }>) => string;
+    type?: import('../index.js').FlagKind;
+    ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../index.js').FlagDefinition<string, {
+    exists?: boolean;
+}>, "parse"> & {
+    parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+        exists?: boolean;
+    }>) => string) | undefined;
+} & O;

package/dist/cjs/flags/file.d.ts

@@ -0,0 +1,27 @@
+/** Filesystem file flag. Pass `exists: true` to require the path to exist at parse time. */
+export declare const fileFlag: <const O extends Partial<import('../index.js').FlagDefinition<string, {
+    exists?: boolean;
+}>>>(overrides?: O | undefined) => {
+    exists?: boolean | undefined;
+} & {
+    parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+        exists?: boolean;
+    }>) => string;
+    type?: import('../index.js').FlagKind;
+    ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../index.js').FlagDefinition<string, {
+    exists?: boolean;
+}>, "parse"> & {
+    parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+        exists?: boolean;
+    }>) => string) | undefined;
+} & O;

package/dist/cjs/flags/helpers.d.ts

@@ -0,0 +1,9 @@
+import { FlagDefinition } from '../lib/types.js';
+export declare function formatPromptMessage(name: string, definition: FlagDefinition): string;
+export declare function normalizeAliases(alias: string | readonly string[] | undefined): readonly string[];
+/**
+ * Formats an alias with the correct dash prefix for help/error output:
+ * single-character aliases get one dash (`-v`), multi-character aliases get
+ * two (`--verbose`). This matches POSIX/minimist parsing conventions.
+ */
+export declare function formatAlias(alias: string): string;

package/dist/cjs/flags/index.d.ts

@@ -0,0 +1,160 @@
+import { custom } from './custom.js';
+import { optionFlag } from './option.js';
+/**
+ * Flag builders used in `static flags = { ... }` schemas.
+ *
+ *   - `Flags.string({ secret? })` — text input; `secret` masks the prompt.
+ *   - `Flags.number({ min?, max? })` — numeric input with range validation.
+ *   - `Flags.boolean()` — toggle flag (`--debug` / `--no-debug`).
+ *   - `Flags.option({ options: [...] as const })` — fixed enum.
+ *   - `Flags.file({ exists? })` / `Flags.directory({ exists? })` — filesystem
+ *     paths; `exists` validates presence at parse time.
+ *   - `Flags.url()` — `URL`-typed input.
+ *   - `Flags.custom<T>({ parse, ... })` — escape hatch for arbitrary types;
+ *     `parse` is required.
+ *
+ * Every builder accepts the common `FlagProps` (description, alias, required,
+ * default, multiple, ask, handler, help) plus its builder-specific extras.
+ */
+export declare const Flags: {
+    string: <const O extends Partial<import('../index.js').FlagDefinition<string, import('../index.js').CustomOptions>>>(overrides?: O | undefined) => {
+        [x: string]: unknown;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => string;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<string, import('../index.js').CustomOptions>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => string) | undefined;
+    } & O;
+    number: <const O extends Partial<import('../index.js').FlagDefinition<number, {
+        min?: number;
+        max?: number;
+    }>>>(overrides?: O | undefined) => {
+        min?: number | undefined;
+        max?: number | undefined;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+            min?: number;
+            max?: number;
+        }>) => number;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: number | number[] | (() => number | number[] | null) | (() => Promise<number | number[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: number, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<number, {
+        min?: number;
+        max?: number;
+    }>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+            min?: number;
+            max?: number;
+        }>) => number) | undefined;
+    } & O;
+    boolean: <const O extends Partial<import('../index.js').FlagDefinition<boolean, import('../index.js').CustomOptions>>>(overrides?: O | undefined) => {
+        [x: string]: unknown;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => boolean;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: boolean | boolean[] | (() => boolean | boolean[] | null) | (() => Promise<boolean | boolean[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: boolean, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<boolean, import('../index.js').CustomOptions>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => boolean) | undefined;
+    } & O;
+    option: typeof optionFlag;
+    file: <const O extends Partial<import('../index.js').FlagDefinition<string, {
+        exists?: boolean;
+    }>>>(overrides?: O | undefined) => {
+        exists?: boolean | undefined;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+            exists?: boolean;
+        }>) => string;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<string, {
+        exists?: boolean;
+    }>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+            exists?: boolean;
+        }>) => string) | undefined;
+    } & O;
+    directory: <const O extends Partial<import('../index.js').FlagDefinition<string, {
+        exists?: boolean;
+    }>>>(overrides?: O | undefined) => {
+        exists?: boolean | undefined;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+            exists?: boolean;
+        }>) => string;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<string, {
+        exists?: boolean;
+    }>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+            exists?: boolean;
+        }>) => string) | undefined;
+    } & O;
+    url: <const O extends Partial<import('../index.js').FlagDefinition<URL, import('../index.js').CustomOptions>>>(overrides?: O | undefined) => {
+        [x: string]: unknown;
+    } & {
+        parse: (input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => URL;
+        type?: import('../index.js').FlagKind;
+        ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+        description?: string;
+        required?: boolean;
+        default?: URL | URL[] | (() => URL | URL[] | null) | (() => Promise<URL | URL[] | null>) | null | undefined;
+        multiple?: boolean;
+        help?: string;
+        alias?: string | readonly string[];
+        handler?: ((value: URL, opts: import('../index.js').FlagOpts) => {
+            shouldStop: boolean;
+        } | void) | undefined;
+    } & Omit<import('../index.js').FlagDefinition<URL, import('../index.js').CustomOptions>, "parse"> & {
+        parse?: ((input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => URL) | undefined;
+    } & O;
+    custom: typeof custom;
+};
+export { Args } from '../args/index.js';

package/dist/cjs/flags/number.d.ts

@@ -0,0 +1,32 @@
+/** Numeric flag. Optional `min`/`max` clamp the accepted range and surface as `BadCommandFlag`. */
+export declare const numberFlag: <const O extends Partial<import('../index.js').FlagDefinition<number, {
+    min?: number;
+    max?: number;
+}>>>(overrides?: O | undefined) => {
+    min?: number | undefined;
+    max?: number | undefined;
+} & {
+    parse: (input: any, opts: import('../index.js').FlagOpts<any, {
+        min?: number;
+        max?: number;
+    }>) => number;
+    type?: import('../index.js').FlagKind;
+    ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: number | number[] | (() => number | number[] | null) | (() => Promise<number | number[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: number, opts: import('../index.js').FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../index.js').FlagDefinition<number, {
+    min?: number;
+    max?: number;
+}>, "parse"> & {
+    parse?: ((input: any, opts: import('../index.js').FlagOpts<any, {
+        min?: number;
+        max?: number;
+    }>) => number) | undefined;
+} & O;

package/dist/cjs/flags/option.d.ts

@@ -0,0 +1,8 @@
+import { FlagDefinition, InitFlagDefinition } from '../lib/types.js';
+export declare function optionFlag<const T extends readonly string[], const O extends Partial<InitFlagDefinition<T[number], {
+    options: T;
+}>>>(opts: {
+    options: T;
+} & O): FlagDefinition<T[number], {
+    options: T;
+}> & O;

package/dist/cjs/flags/string.d.ts

@@ -0,0 +1,19 @@
+/** Text input flag. Pass `secret: true` to mask the prompt as a password. */
+export declare const stringFlag: <const O extends Partial<import('../index.js').FlagDefinition<string, import('../index.js').CustomOptions>>>(overrides?: O | undefined) => {
+    [x: string]: unknown;
+} & {
+    parse: (input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => string;
+    type?: import('../index.js').FlagKind;
+    ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: string | string[] | (() => string | string[] | null) | (() => Promise<string | string[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: string, opts: import('../index.js').FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../index.js').FlagDefinition<string, import('../index.js').CustomOptions>, "parse"> & {
+    parse?: ((input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => string) | undefined;
+} & O;

package/dist/cjs/flags/url.d.ts

@@ -0,0 +1,19 @@
+/** URL flag — parses the input with `new URL()` and returns the resulting `URL` object. */
+export declare const urlFlag: <const O extends Partial<import('../index.js').FlagDefinition<URL, import('../index.js').CustomOptions>>>(overrides?: O | undefined) => {
+    [x: string]: unknown;
+} & {
+    parse: (input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => URL;
+    type?: import('../index.js').FlagKind;
+    ask?: (opts: import('../index.js').FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: URL | URL[] | (() => URL | URL[] | null) | (() => Promise<URL | URL[] | null>) | null | undefined;
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: ((value: URL, opts: import('../index.js').FlagOpts) => {
+        shouldStop: boolean;
+    } | void) | undefined;
+} & Omit<import('../index.js').FlagDefinition<URL, import('../index.js').CustomOptions>, "parse"> & {
+    parse?: ((input: any, opts: import('../index.js').FlagOpts<any, import('../index.js').CustomOptions>) => URL) | undefined;
+} & O;

package/dist/cjs/index.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,a)=>(a=n==null?{}:e(i(n)),s(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let l=require(`chalk`);l=c(l,1);let u=require(`node:fs`);u=c(u,1);let d=require(`node:path`);d=c(d,1);let f=require(`minimist`);f=c(f,1);let p=require(`@inquirer/prompts`),ee=require(`inquirer-file-selector`);var m=class{level;constructor(e={}){this.level=e.level??`info`}shouldLog(e){let t=[`debug`,`info`,`warn`,`error`],n=t.indexOf(this.level);return t.indexOf(e)>=n}setLevel(e){this.level=e}getLevel(){return this.level}log(...e){console.log(...e)}info(...e){this.shouldLog(`info`)&&console.log(...e)}warn(...e){this.shouldLog(`warn`)&&console.warn(...e)}error(...e){this.shouldLog(`error`)&&console.error(...e)}debug(...e){this.shouldLog(`debug`)&&console.log(...e)}},te=.1,ne=4,h=.5,g=class{calculateSimilarity(e,t){if(e===t)return 1;let n=e.toLowerCase(),r=t.toLowerCase();if(n===r)return 1;if(n.length===0||r.length===0)return 0;let i=this.jaro(n,r);if(i===0)return 0;let a=0,o=Math.min(ne,n.length,r.length);for(;a<o&&n[a]===r[a];)a++;let s=i+a*te*(1-i),c=Math.min(n.length,r.length)/Math.max(n.length,r.length);return s*(c<h?c/h:1)}jaro(e,t){let n=Math.max(0,Math.floor(Math.max(e.length,t.length)/2)-1),r=Array(e.length).fill(!1),i=Array(t.length).fill(!1),a=0;for(let o=0;o<e.length;o++){let s=Math.max(0,o-n),c=Math.min(o+n+1,t.length);for(let n=s;n<c;n++)if(!i[n]&&e[o]===t[n]){r[o]=!0,i[n]=!0,a++;break}}if(a===0)return 0;let o=0,s=0;for(let n=0;n<e.length;n++)if(r[n]){for(;!i[s];)s++;e[n]!==t[s]&&o++,s++}return o/=2,(a/e.length+a/t.length+(a-o)/a)/3}findBestMatch(e,t){let n=t.map(t=>({target:t,rating:this.calculateSimilarity(e,t)})),r=0,i=n[0]?.rating??0;for(let e=1;e<n.length;e++)n[e].rating>i&&(i=n[e].rating,r=e);return{ratings:n,bestMatch:n[r],bestMatchIndex:r}}},_=class extends Error{};function v(e){return l.default.bold.yellow(`'${e}'`)}var re=/\x1b\[[0-9;]*m/g;function ie(e){return e.replace(re,``).length}function y(e,t){let{title:n,details:r,hint:i}=t,a=r&&r.length>0||i!=null,o=l.default.dim(`│`),s=l.default.dim(`└─`);if(e.log(``),e.log(`  ${l.default.red(`error:`)} ${n}`),a){if(e.log(`   ${o}`),r&&r.length>0){let t=r.map(([e])=>ie(e)),n=Math.max(...t);for(let i=0;i<r.length;i++){let[a,s]=r[i],c=` `.repeat(n-t[i]);e.log(`   ${o}  ${a}${c}  ${s}`)}}i==null?e.log(`   ${o}`):(e.log(`   ${o}`),e.log(`   ${s} try: ${i}`))}e.log(``)}var ae=class extends _{$type=`CommandNotFoundError`;constructor(e){super(`Command "${e}" not found.`),this.command=e}pretty(e){y(e,{title:`command ${v(this.command)} not found`})}};function b(e,t){let n=t.multiple===!0,r=t.required?`${l.default.yellow.bold(e)} is required`:`Enter ${l.default.yellow.bold(e)}`;return t.description&&(r+=`: ${l.default.gray(`(${t.description})`)}`),r+=` ${l.default.green(`(${t.type}${n?`[]`:``})`)}\n`,r}function x(e){return e==null?[]:typeof e==`string`?[e]:e}function S(e){return e.length===1?`-${e}`:`--${e}`}function C(e){return e.type===`option`&&`options`in e}var w=class extends _{$type=`InvalidFlag`;constructor(e,t={}){super(`Flag ${e} is not recognized`),this.flag=e,this.flagsSchema=t}pretty(e){let t=Object.entries(this.flagsSchema).map(([e,t])=>{let n=x(t.alias),r=`--${e}${n.length>0?n.map(e=>`, ${S(e)}`).join(``):``}`,i=C(t)?t.options.join(` | `):t.type,a=t.description??``,o=a?`${a} ${l.default.dim(`(${i})`)}`:l.default.dim(`(${i})`);return[l.default.cyan(r),o]});y(e,{title:`flag ${v(this.flag)} is not recognized`,details:t})}},T=class extends _{$type=`MissingRequiredArgumentValue`;constructor(e){super(`Argument "${e}" is required.`),this.argument=e}pretty(e){y(e,{title:`argument ${v(this.argument)} is required`})}},E=class extends _{$type=`MissingRequiredFlagValue`;constructor(e){super(`Flag "${e}" is required.`),this.flag=e}pretty(e){y(e,{title:`flag ${v(this.flag)} is required`})}},D=class extends Error{constructor(e){super(e)}},O=class extends _{$type=`BadCommandArgument`;constructor(e,t){let n=`Argument "${e.arg}" value is invalid.`;e.reason?n+=` Reason: ${e.reason}`:n+=` Value: "${e.value}"`,super(n),this.detail=e,this.argDefinition=t}pretty(e){let t=[];this.detail.value!=null&&t.push([l.default.dim(`value`),l.default.yellow(`"${this.detail.value}"`)]),this.detail.reason!=null&&t.push([l.default.dim(`reason`),this.detail.reason]),this.argDefinition?.help!=null&&t.push([l.default.dim(`help`),l.default.green(this.argDefinition.help)]),y(e,{title:`argument ${v(this.detail.arg)} is invalid`,details:t})}},k=class extends _{$type=`BadCommandFlag`;constructor(e,t){let n=`Flag "${e.flag}" value is invalid.`;e.reason?n+=` Reason: ${e.reason}`:n+=` Value: "${e.value}"`,super(n),this.param=e,this.flagDefinition=t}pretty(e){let t=[];this.param.value!=null&&t.push([l.default.dim(`value`),l.default.yellow(`"${this.param.value}"`)]),this.param.reason!=null&&t.push([l.default.dim(`reason`),this.param.reason]),this.flagDefinition?.help!=null&&t.push([l.default.dim(`help`),l.default.green(this.flagDefinition.help)]),y(e,{title:`flag ${v(this.param.flag)} is invalid`,details:t})}},oe=class extends _{$type=`TooManyArguments`;constructor(e,t){super(`Too many arguments provided. Expected ${e}, got ${t}.`),this.expected=e,this.received=t}pretty(e){y(e,{title:`too many arguments`,details:[[l.default.dim(`expected`),l.default.green(String(this.expected))],[l.default.dim(`received`),l.default.bold.yellow(String(this.received))]]})}},se=class{flags;parsedFlags=null;args;parsedArgs=null;ux;shouldPromptForMissingFlags=!0;shouldValidateUnknownFlags=!0;shouldRejectExtraArguments=!1;constructor(e){this.opts=e,this.ux=e.ux,this.flags=e.flags,this.args=e.args}async init(e){let{_:t,...n}=(0,f.default)(e);return this.shouldValidateUnknownFlags&&this.validateUnknownFlags(n),this.parsedFlags=await this.handleOptions(n),this.parsedArgs=await this.handleArguments(t),{flags:this.parsedFlags,args:this.parsedArgs}}async validate(){await this.validateSchema(this.flags,this.parsedFlags,`flag`),await this.validateSchema(this.args,this.parsedArgs,`arg`)}flag(e,t){if(!this.parsedFlags)throw Error(`Flags have not been parsed yet. Call init() first.`);return this.isEmptyValue(this.parsedFlags[e])&&t!==void 0?t:this.parsedFlags[e]}async setFlag(e,t){if(!this.parsedFlags)throw Error(`Flags have not been parsed yet. Call init() first.`);if(!(e in this.flags))throw new w(e,this.flags);this.parsedFlags[e]=t}argument(e,t){if(!this.parsedArgs)throw Error(`Arguments have not been parsed yet. Call init() first.`);return this.isEmptyValue(this.parsedArgs[e])&&t!==void 0?t:this.parsedArgs[e]}async setArgument(e,t){if(!this.parsedArgs)throw Error(`Arguments have not been parsed yet. Call init() first.`);if(!(e in this.args))throw new O({arg:e,reason:`Argument "${e}" is not recognized`});this.parsedArgs[e]=t}isEmptyValue(e){return e==null||typeof e==`string`&&e.trim()===``||Array.isArray(e)&&e.length===0}isMissing(e){return e==null||Array.isArray(e)&&e.length===0}validateUnknownFlags(e){let t=new Set;for(let e in this.flags){t.add(e);let n=this.flags[e],r=Array.isArray(n.alias)?n.alias:n.alias?[n.alias]:[];for(let e of r)t.add(e)}for(let n in e)if(!t.has(n))throw new w(n,this.flags)}async handleOptions(e){let t={};for(let n in this.flags)t[n]=await this.resolveFlagValue(n,this.flags[n],e);return t}async handleArguments(e){let t={},n=[...e],r=Object.keys(this.args).length;for(let e in this.args){let r=this.args[e];if(r.multiple){t[e]=await this.parseValue(n,r,`arg`,{name:e}),n.length=0;continue}t[e]=await this.parseValue(n.shift(),r,`arg`,{name:e})}if(this.shouldRejectExtraArguments&&n.length>0)throw new oe(r,r+n.length);return t}async resolveFlagValue(e,t,n){let r,i=[e];t.alias&&i.push(...Array.isArray(t.alias)?t.alias:[t.alias]);for(let e of i)if(e in n){r=n[e];break}return this.parseValue(r,t,`flag`,{name:e})}async parseValue(e,t,n,r){if(this.isMissing(e))return typeof t.default==`function`?await t.default():t.default;if(t.multiple){Array.isArray(e)||(e=[e]);let i=[];for(let a of e)i.push(await this.safeParse(a,t,n,r));return i}return this.safeParse(e,t,n,r)}buildOpts(e,t){return{name:e,ux:this.ux,ctx:this.opts.ctx,definition:t,cmd:this.opts.cmd??Q}}async safeParse(e,t,n,r){try{return t.parse(e,this.buildOpts(r?.name??``,t))}catch(t){if(t instanceof k||t instanceof O||!(t instanceof D)||!r)throw t;let i=t.message;throw n===`flag`?new k({flag:r.name,value:e,reason:i}):new O({arg:r.name,value:e,reason:i})}}async validateSchema(e,t,n){for(let r in e){let i=e[r],a=t?.[r],o=this.isEmptyValue(a);if(i.required&&o){if(!this.shouldPromptForMissingFlags)throw n===`flag`?new E(r):new T(r);let e=await this.promptFor(r,i);if(e!=null&&t)a=await this.parseValue(e,i,n,{name:r}),t[r]=a;else throw n===`flag`?new E(r):new T(r)}}}disablePrompting(){return this.shouldPromptForMissingFlags=!1,this}allowUnknownFlags(){return this.shouldValidateUnknownFlags=!1,this}strictMode(){return this.shouldRejectExtraArguments=!0,this}async promptFor(e,t){return t.ask?t.ask(this.buildOpts(e,t)):null}};function A(e={}){return function(t){return{type:`custom`,default:e.multiple||t?.multiple?[]:null,parse:e=>e,...e,...t}}}function ce(e){if(typeof e==`boolean`)throw new D(`Expected a string, got boolean "${e}"`);return String(e)}function le(e,t){let n=typeof e==`number`?e:Number(e);if(isNaN(n))throw new D(`must be a valid number`);if(t?.min!==void 0&&n<t.min)throw new D(`is below minimum ${t.min}`);if(t?.max!==void 0&&n>t.max)throw new D(`exceeds maximum ${t.max}`);return n}function ue(e){if(typeof e==`boolean`)return e;let t=String(e).toLowerCase();if(t===`true`||t===`1`)return!0;if(t===`false`||t===`0`)return!1;throw new D(`Invalid boolean value: "${e}". Expected true, false, 1, or 0.`)}function de(e,t){let n=String(e);if(!t.includes(n))throw new D(`must be one of: ${t.map(e=>`"${e}"`).join(`, `)}`);return n}function fe(e,t){let n=String(e);if(t?.exists)try{u.default.accessSync(n,u.default.constants.F_OK)}catch(e){let t=e.code;throw t===`ENOENT`?new D(`file does not exist`):t===`EACCES`?new D(`file is not accessible (permission denied)`):new D(`file is not accessible (${t??e.message})`)}return n}function pe(e,t){let n=String(e);if(t?.exists){let e;try{e=u.default.lstatSync(n)}catch(e){let t=e.code;throw t===`ENOENT`?new D(`directory does not exist`):t===`EACCES`?new D(`directory is not accessible (permission denied)`):t===`ELOOP`?new D(`symlink loop detected`):new D(`directory is not accessible (${t??e.message})`)}if(!e.isDirectory())throw new D(`path is not a directory`)}return n}function me(e){try{return new URL(String(e))}catch(t){throw new D(`Invalid URL "${e}": ${t instanceof Error?t.message:String(t)}`)}}var he=A({default:!1,parse:e=>ue(e),ask:async e=>{let t=b(e.name,e.definition);return await e.ux.askForToggle(t)},type:`boolean`});function j(e,t){return n=>{if((n==null||typeof n==`string`&&n.trim()===``)&&e.required)return`This value is required`;try{e.parse(n,t)}catch(e){if(e instanceof D)return e.message;throw e}return!0}}function M(e,t){return n=>{if((n==null||n.trim()===``)&&e.required)return`Please enter at least one value`;for(let r of n.split(`,`)){let n=r.trim();if(n!==``)try{e.parse(n,t)}catch(e){if(e instanceof D)return`"${n}": ${e.message}`;throw e}}return!0}}async function ge(e){let t=e.definition,n=t.multiple===!0,r=b(e.name,t);return n?await e.ux.askForList(r+`Please provide one or more values, separated by commas:
+`,{separator:`,`,validate:M(t,e)}):t.secret?e.ux.askForPassword(r,{validate:j(t,e)}):await e.ux.askForInput(r,{validate:j(t,e)})}async function _e(e){let t=e.definition,n=t.multiple===!0,r=b(e.name,t);return n?await e.ux.askForList(r+`Please provide one or more values, separated by commas:
+`,{separator:`,`,validate:M(t,e)}):await e.ux.askForNumber(r,{validate:n=>{if(n===void 0&&t.required)return`This value is required`;if(n!==void 0)try{t.parse(String(n),e)}catch(e){if(e instanceof D)return e.message;throw e}return!0}})}async function ve(e){let t=e.definition,n=t.multiple===!0,r=b(e.name,t);if(!C(t))return null;let i=t.options.map(e=>({name:e,value:e}));return n?await e.ux.askForCheckbox(r,i):await e.ux.askForSelect(r,i)}async function ye(e){let t=b(e.name,e.definition);return e.ux.askForFile(t,{basePath:process.cwd()})}async function be(e){let t=b(e.name,e.definition);return e.ux.askForDirectory(t,{basePath:process.cwd()})}async function xe(e){let t=b(e.name,e.definition);return await e.ux.askForInput(t,{validate:j(e.definition,e)})}var N=A({parse:(e,t)=>pe(e,{exists:t.definition.exists}),ask:be,type:`directory`}),P=A({parse:(e,t)=>fe(e,{exists:t.definition.exists}),ask:ye,type:`file`}),F=A({parse:(e,t)=>le(e,{min:t.definition.min,max:t.definition.max}),ask:_e,type:`number`});function I(e){let{options:t,...n}=e;return A({type:`option`,ask:ve,parse:e=>de(e,t??[]),...e})(n)}var L=A({parse:e=>ce(e),ask:ge,type:`string`}),R=A({parse:e=>me(e),ask:xe,type:`url`}),z={string:L,number:F,option:I,file:P,directory:N,url:R,custom:A},B={string:L,number:F,boolean:he,option:I,file:P,directory:N,url:R,custom:A};function V(e){return Array(e+5).join(` `)}function Se(e){let t=e.type;return C(e)?`enum: ${e.options.join(`|`)}`:t??`custom`}var Ce=B.boolean({alias:[`h`],description:`Displays help information about the command`,handler:(e,t)=>{if(!e)return{shouldStop:!1};let n=t.cmd,r=n.args,i={...n.baseFlags,...n.flags},a=Object.entries(r),o=Object.entries(i),s=o.map(([e,t])=>{let n=x(t.alias);return{name:e,...t,flagWithAlias:`--${e}${n.map(e=>`, ${S(e)}`).join(``)}`}}),c=a.filter(([,e])=>e.required);console.log(l.default.yellow(`Description:`)),console.log(`  ${n.description}\n`),n.aliases.length>0&&(console.log(l.default.yellow(`Aliases:`)),console.log(`  ${n.aliases.join(`, `)}\n`)),console.log(l.default.yellow(`Usage:`)),console.log(`  ${n.command} ${c.length>0?c.map(([e])=>`<${e}>`).join(` `):`\b`} [options]`);let u=Math.max(...s.map(e=>e.flagWithAlias.length),0),d=Math.max(...a.map(([e])=>e.length),0),f=d>u?d:u;if(a.length>0){console.log(`\n${l.default.yellow(`Arguments`)}:`);for(let[e,t]of a){let n=V(f-e.length),r=`  ${l.default.green(e)} ${n} ${t.description??`\b`}`;if(t.default!==void 0&&!t.required){let e=typeof t.default==`function`?`[function]`:t.multiple?JSON.stringify(t.default):t.default;r+=` ${l.default.yellow(`[default: ${e}]`)}`}t.multiple&&(r+=` ${l.default.white(`(multiple)`)}`),console.log(r)}}if(o.length>0){console.log(`\n${l.default.yellow(`Options`)}:`);for(let e of s){let t=V(f-e.flagWithAlias.length),n=`  ${l.default.green(e.flagWithAlias)} ${t} ${e.description??`\b`}`;if(e.type&&(n+=` ${l.default.white(`(${Se(e)})`)}`),e.default!==void 0&&!e.required){let t=typeof e.default==`function`?`(function)`:e.default;n+=` ${l.default.yellow(`[default: ${t}]`)}`}console.log(n)}}let p=n.examples??[];if(p.length>0){console.log(`\n${l.default.yellow(`Examples`)}:`);let e=process.argv[0].split(`/`).pop();e===`node`&&(e+=` `+process.argv[1].split(`/`).pop());for(let[t,n]of p.entries())t>0&&console.log(``),console.log(`  ${n.description}\n`),console.log(`    ${l.default.green(`${e} ${n.command}`)}`)}return{shouldStop:!0}}}),we=class extends Error{name=`ExitPromptError`},Te=o(((e,t)=>{t.exports={}}));async function H(e,t){try{return await e()}catch(e){if(e instanceof we||e instanceof Error&&e.name===`ExitPromptError`)return t;throw e}}async function U(e,t,n){if(t.length===0)throw Error(`No options provided`);let r=t.map(e=>typeof e==`string`?{name:e,value:e}:{name:e.name,value:e.value,disabled:e.disabled,checked:e.checked,description:e.description});return H(()=>(0,p.checkbox)({message:e,choices:r,required:n?.required,pageSize:n?.pageSize,loop:n?.loop,validate:n?.validate,shortcuts:n?.shortcuts}),null)}async function W(e=`Do you want to continue?`,t){return H(()=>(0,p.confirm)({message:e,default:t?.default??!1,transformer:t?.transformer}),null)}async function G(e,t){return H(()=>(0,p.editor)({message:e,default:t?.default,postfix:t?.postfix,waitForUserInput:t?.waitForUserInput,validate:t?.validate}),null)}async function K(e,t,n){return H(()=>(0,p.expand)({message:e,choices:t,default:n?.default}),null)}async function q(e,t){return H(async()=>{let n=await(0,ee.fileSelector)({message:e,basePath:t?.basePath,type:t?.type===`file+directory`?void 0:t?.type,filter:t?.filter,allowCancel:!0,pageSize:t?.pageSize,loop:t?.loop});return n===null?null:n.path},null)}async function J(e,t){return H(()=>(0,p.input)({message:e,default:t?.default,required:t?.required,validate:t?.validate,transformer:t?.transformer}),null)}async function Y(e,t){let n=t?.separator??`,`;return H(async()=>(await(0,p.input)({message:e,default:t?.default,validate:t?.validate})).split(n).map(e=>e.trim()).filter(e=>e.length>0),null)}async function X(e,t){return H(async()=>await(0,p.number)({message:e,default:t?.default,required:t?.required,min:t?.min,max:t?.max,step:t?.step,validate:t?.validate})??null,null)}async function Ee(e,t){return H(()=>(0,p.password)({message:e,mask:t?.mask,validate:t?.validate}),null)}async function De(e,t,n){return H(()=>(0,p.rawlist)({message:e,choices:t,loop:n?.loop}),null)}async function Oe(e,t,n){return H(()=>(0,p.search)({message:e,source:t,pageSize:n?.pageSize,validate:n?.validate}),null)}async function ke(e,t,n){if(t.length===0)throw Error(`No options provided`);let r=t.map(e=>typeof e==`string`?{name:e,value:e}:e);return H(()=>(0,p.select)({message:e,choices:r,default:n?.default,pageSize:n?.pageSize,loop:n?.loop}),null)}async function Ae(e,t){let n=t?.active??`Yes`,r=t?.inactive??`No`;return H(()=>(0,p.confirm)({message:e,default:t?.default??!1,transformer:e=>e?n:r}),null)}function je(e,t){let n=t?.separator??`: `,r=t?.keyStyle??l.default.bold,i=Array.isArray(e)?e:Object.entries(e);if(i.length===0)return;let a=Math.max(...i.map(([e])=>e.length));for(let[e,t]of i)console.log(r(e.padEnd(a))+n+String(t??``))}function Me(e=``,t=[`⠙`,`⠘`,`⠰`,`⠴`,`⠤`,`⠦`,`⠆`,`⠃`,`⠋`,`⠉`],n=100){let r=e,i=null,a=e.length,o=0,s=e=>{let t=process.stdout.columns||80,n=e+2,r=Math.max(1,Math.ceil(n/t));if(process.stdout.isTTY&&process.stdout.clearLine&&process.stdout.moveCursor&&process.stdout.cursorTo){r>1&&process.stdout.moveCursor(0,-(r-1));for(let e=0;e<r;e++)process.stdout.cursorTo(0),process.stdout.clearLine(1),e<r-1&&process.stdout.moveCursor(0,1);r>1&&process.stdout.moveCursor(0,-(r-1)),process.stdout.cursorTo(0)}else process.stdout.write(`\r`+` `.repeat(e+5)+`\r`)},c=setInterval(function(){i!==null&&(s(Math.max(i.length,r.length)),i=null),process.stdout.write(`\r`+t[o++]+` `+r),o%=t.length},n),l=()=>{clearInterval(c),s(a)};return{[Symbol.dispose]:l,[Symbol.asyncDispose]:l,updateText:e=>{i=r,r=e,a=Math.max(a,e.length)},stop:l}}function Ne(e,t){let n=t?.width??30,r=t?.completeChar??`█`,i=t?.incompleteChar??`░`,a=0,o=!1,s=()=>{if(o)return;let t=e<=0?1:Math.min(a/e,1),s=Math.round(t*n),l=`${r.repeat(s)+i.repeat(n-s)}  ${Math.round(t*100)}%  ${a}/${e}`;process.stdout.write(`\r`+l),(e<=0||a>=e)&&c()},c=()=>{o||(o=!0,process.stdout.write(`
+`))};return s(),{increment:(t=1)=>{o||(a=Math.min(a+t,e),s())},update:t=>{o||(a=Math.max(0,Math.min(t,e)),s())},stop:c,[Symbol.dispose]:c,[Symbol.asyncDispose]:c}}function Pe(e,t){if(e.length===0)return;let n=t??Object.keys(e[0]).map(e=>({key:e})),r=n.map(e=>e.header??e.key.toUpperCase()),i=n.map((t,n)=>{let i=Math.max(r[n].length,...e.map(e=>(t.format?t.format(e[t.key]):String(e[t.key]??``)).length));return t.width?Math.min(i,t.width):i}),a=(e,t,n=`left`)=>{if(e.length>t)return e.slice(0,t-1)+`…`;switch(n){case`right`:return e.padStart(t);case`center`:{let n=Math.floor((t-e.length)/2);return` `.repeat(n)+e+` `.repeat(t-e.length-n)}default:return e.padEnd(t)}},o=n.map((e,t)=>a(r[t],i[t],e.alignment)).join(`  `);console.log(l.default.bold(o));let s=i.map(e=>`-`.repeat(e)).join(`  `);console.log(l.default.dim(s));for(let t of e){let e=n.map((e,n)=>a(e.format?e.format(t[e.key]):String(t[e.key]??``),i[n],e.alignment)).join(`  `);console.log(e)}}var Z=class{askForConfirmation(e,t){return W(e,t)}askForInput(e,t){return J(e,t)}askForPassword(e,t){return Ee(e,t)}askForNumber(e,t){return X(e,t)}askForSelect(e,t,n){return ke(e,t,n)}askForCheckbox(e,t,n){return U(e,t,n)}askForSearch(e,t,n){return Oe(e,t,n)}askForList(e,t){return Y(e,t)}askForToggle(e,t){return Ae(e,t)}askForEditor(e,t){return G(e,t)}askForRawList(e,t,n){return De(e,t,n)}askForExpand(e,t,n){return K(e,t,n)}askForFile(e,t){return q(e,{...t,type:`file`})}askForDirectory(e,t){return q(e,{...t,type:`directory`})}askForFileSelector(e,t){return q(e,t)}keyValue(e,t){return je(e,t)}table(e,t){return Pe(e,t)}newProgressBar(e,t){return Ne(e,t)}newLoader(e,t,n){return Me(e,t,n)}},Q=class{static $type=`BobCommand`;static command=``;static description=``;static group;static args={};static flags={};static examples=[];static hidden=!1;static aliases=[];static disableDefaultOptions=!1;static disablePrompting=!1;static allowUnknownFlags=!1;static strictMode=!1;ctx;logger;ux;parser;static baseFlags={help:Ce};newCommandParser(e){return new se({ux:e.ux,ctx:e.ctx,flags:e.flags,args:e.args,cmd:e.cmd})}newUX(){return new Z}async run(e){let t=this.constructor;this.ctx=e.ctx,this.logger=e.logger,this.ux=this.newUX();let n;if(`flags`in e)n={flags:e.flags,args:e.args};else{this.parser=this.newCommandParser({ctx:this.ctx,ux:this.ux,flags:t.disableDefaultOptions?t.flags:{...t.baseFlags,...t.flags},args:t.args,cmd:t}),t.allowUnknownFlags&&this.parser.allowUnknownFlags(),t.strictMode&&this.parser.strictMode(),t.disablePrompting&&this.parser.disablePrompting();let r=await this.parser.init(e.args);for(let n in r.flags){let i=r.flags[n],a=t.flags[n]||t.baseFlags[n];if(a&&a.handler){let r={name:n,ux:this.ux,ctx:e.ctx,definition:a,cmd:t},o=a.handler(i,r);if(o&&o.shouldStop)return 0}}await this.parser.validate(),n={flags:r.flags,args:r.args}}if(this.preHandle){let e=await this.preHandle();if(e&&e!==0)return e}return await this.handle(this.ctx,n)??0}};function Fe(e){return e instanceof _}function $(e){return typeof e==`function`?e.prototype instanceof Q||e.$type===`BobCommand`:!1}var Ie=.75,Le=.55,Re=.05,ze=class{commands={};aliases={};ux;logger;stringSimilarity;constructor(e){this.logger=e?.logger??new m,this.ux=e?.ux??new Z,this.stringSimilarity=e?.stringSimilarity??new g}getAvailableCommands(){return[...Object.keys(this.commands),...Object.keys(this.aliases)]}getCommands(){return Object.values(this.commands)}importFile=async e=>(await import(e)).default;commandResolver=async e=>{let t=await this.importFile(e);return t?(t&&typeof t==`object`&&`default`in t&&(t=t.default),typeof t==`function`&&$(t)?t:null):null};withCommandResolver(e){return this.commandResolver=e,this}withFileImporter(e){return this.importFile=e,this}registerCommand(e,t=!1){if(!$(e))throw Error(`Invalid command, it must extend the Command class.`);let n=e.command;if(!n)throw Error(`Cannot register a command with no name. ${e.name} `);if(!t&&this.commands[n])throw Error(`Command ${n} already registered.`);if(!t&&this.aliases[n])throw Error(`Command name ${n} conflicts with an existing alias.`);this.commands[n]=e;for(let r of e.aliases){if(!t&&this.commands[r])throw Error(`Alias ${r} conflicts with an existing command name.`);if(!t&&this.aliases[r])throw Error(`Alias ${r} already registered.`);this.aliases[r]=n}}async loadCommandsPath(e){for await(let t of this.listCommandsFiles(e))try{let e=await this.commandResolver(t);$(e)&&this.registerCommand(e)}catch(e){throw Error(`Command ${t} failed to load. ${e}`,{cause:e})}}async runCommand(e,t,...n){let r;if(typeof t==`string`){let i=this.commands[t]??this.commands[this.aliases[t]];if(!i){let r=await this.suggestCommand(t);if(r)return await this.runCommand(e,r,...n);throw new ae(t)}r=new i}else r=$(t)?new t:t;return await r.run({ctx:e,logger:this.logger,args:n})??0}async suggestCommand(e){let t=this.getAvailableCommands();if(t.length===0)return null;let{bestMatch:n,bestMatchIndex:r,ratings:i}=this.stringSimilarity.findBestMatch(e,t),a=[...i].sort((e,t)=>t.rating-e.rating),o=a[1]?.rating??0,s=a.filter(e=>e.rating>=Le).map(e=>e.target);if(n&&n.rating>=Ie&&n.rating-o>Re){let n=t[r],i=await this.askRunSimilarCommand(e,n);return i===!0?n:(i===null&&this.logger.debug(`suggestion prompt cancelled for "${e}"`),null)}if(s.length===1){let t=s[0],n=await this.askRunSimilarCommand(e,t);return n===!0?t:(n===null&&this.logger.debug(`suggestion prompt cancelled for "${e}"`),null)}if(s.length>1){let t=await this.ux.askForSelect(`${l.default.red(`unknown command`)} ${l.default.bold.yellow(`'${e}'`)} ${l.default.dim(`—`)} did you mean one of these?`,s);return t||(t===null&&this.logger.debug(`suggestion selection cancelled for "${e}"`),null)}return null}async askRunSimilarCommand(e,t){return this.ux.askForConfirmation(`${l.default.red(`unknown command`)} ${l.default.bold.yellow(`'${e}'`)} ${l.default.dim(`—`)} did you mean ${l.default.bold.green(`'${t}'`)}?`)}async*listCommandsFiles(e){let t;try{t=await u.default.promises.readdir(e,{withFileTypes:!0})}catch(t){throw Error(`Failed to read commands directory "${e}": ${t.message}`,{cause:t})}for(let n of t){let t=d.default.resolve(e,n.name);if(n.isDirectory())yield*this.listCommandsFiles(d.default.resolve(e,n.name));else{if(!t.endsWith(`.ts`)&&!t.endsWith(`.js`)&&!t.endsWith(`.mjs`)&&!t.endsWith(`.cjs`))continue;yield t}}}},Be=class{logger;constructor(e){this.logger=e}handle(e){if(Fe(e))return e.pretty(this.logger),-1;throw e}},Ve=c(Te(),1);function He(){try{let e=(0,u.readFileSync)((0,Ve.fileURLToPath)(new URL(`data:application/json;base64,ewogICJuYW1lIjogImJvYi1jb3JlIiwKICAidmVyc2lvbiI6ICIzLjAuMC1iZXRhLjYiLAogICJkZXNjcmlwdGlvbiI6ICJCT0IgQ29yZSIsCiAgInR5cGUiOiAibW9kdWxlIiwKICAibWFpbiI6ICIuL2Rpc3QvY2pzL3NyYy9pbmRleC5qcyIsCiAgIm1vZHVsZSI6ICIuL2Rpc3QvZXNtL3NyYy9pbmRleC5qcyIsCiAgInR5cGVzIjogIi4vZGlzdC9lc20vc3JjL2luZGV4LmQudHMiLAogICJmaWxlcyI6IFsKICAgICJkaXN0IgogIF0sCiAgImV4cG9ydHMiOiB7CiAgICAiLiI6IHsKICAgICAgImltcG9ydCI6IHsKICAgICAgICAidHlwZXMiOiAiLi9kaXN0L2VzbS9zcmMvaW5kZXguZC50cyIsCiAgICAgICAgImRlZmF1bHQiOiAiLi9kaXN0L2VzbS9zcmMvaW5kZXguanMiCiAgICAgIH0sCiAgICAgICJyZXF1aXJlIjogewogICAgICAgICJ0eXBlcyI6ICIuL2Rpc3QvY2pzL3NyYy9pbmRleC5kLnRzIiwKICAgICAgICAiZGVmYXVsdCI6ICIuL2Rpc3QvY2pzL3NyYy9pbmRleC5qcyIKICAgICAgfQogICAgfQogIH0sCiAgInNjcmlwdHMiOiB7CiAgICAic3RhcnQiOiAibm9kZSAtciBAc3djLW5vZGUvcmVnaXN0ZXIgZGVidWcvbWFpbi50cyIsCiAgICAiYnVpbGQiOiAicm0gLXJmIC4vZGlzdCAmJiB2aXRlIGJ1aWxkIiwKICAgICJ0eXBlY2hlY2siOiAidHNjIC0tbm9FbWl0IiwKICAgICJwcmVwYWNrIjogIm5wbSBydW4gYnVpbGQiLAogICAgInRlc3QiOiAidml0ZXN0IHJ1biIsCiAgICAibGludCI6ICJlc2xpbnQgLiIsCiAgICAibGludDpmaXgiOiAiZXNsaW50IC4gLS1maXgiCiAgfSwKICAiYXV0aG9yIjogIkzDqW8gSHViZXJ0IiwKICAibGljZW5zZSI6ICJJU0MiLAogICJkZXZEZXBlbmRlbmNpZXMiOiB7CiAgICAiQGVzbGludC9qcyI6ICJeOS4zOS40IiwKICAgICJAZmFrZXItanMvZmFrZXIiOiAiXjEwLjMuMCIsCiAgICAiQHN3Yy1ub2RlL3JlZ2lzdGVyIjogIl4xLjExLjEiLAogICAgIkB0cml2YWdvL3ByZXR0aWVyLXBsdWdpbi1zb3J0LWltcG9ydHMiOiAiXjUuMi4yIiwKICAgICJAdHlwZXMvbWluaW1pc3QiOiAiXjEuMi41IiwKICAgICJAdHlwZXMvbm9kZSI6ICJeMjAuMTQuNSIsCiAgICAiQHR5cGVzL3N0cmluZy1zaW1pbGFyaXR5IjogIl40LjAuMiIsCiAgICAiQHZpdGVzdC9jb3ZlcmFnZS12OCI6ICJeNC4xLjAiLAogICAgImVzbGludCI6ICJeOS4zOS40IiwKICAgICJlc2xpbnQtY29uZmlnLXByZXR0aWVyIjogIl4xMC4xLjgiLAogICAgImVzbGludC1wbHVnaW4tcHJldHRpZXIiOiAiXjUuNS41IiwKICAgICJwcmV0dGllciI6ICJeMy42LjIiLAogICAgInRzeCI6ICJeNC4yMS4wIiwKICAgICJ0eXBlc2NyaXB0IjogIl41LjkuMyIsCiAgICAidHlwZXNjcmlwdC1lc2xpbnQiOiAiXjguNTcuMCIsCiAgICAidml0ZSI6ICJeOC4wLjAiLAogICAgInZpdGUtcGx1Z2luLWR0cyI6ICJeNC41LjQiLAogICAgInZpdGVzdCI6ICJeNC4xLjAiCiAgfSwKICAiZGVwZW5kZW5jaWVzIjogewogICAgIkBpbnF1aXJlci9jb3JlIjogIl4xMS4xLjgiLAogICAgIkBpbnF1aXJlci9wcm9tcHRzIjogIl44LjQuMSIsCiAgICAiY2hhbGsiOiAiXjUuNi4yIiwKICAgICJpbnF1aXJlci1maWxlLXNlbGVjdG9yIjogIl4xLjAuMSIsCiAgICAibWluaW1pc3QiOiAiXjEuMi44IgogIH0KfQo=`,``+{}.url)),`utf8`);return JSON.parse(e).version??`0.0.0`}catch{return`0.0.0`}}var Ue=class extends Q{static command=`help`;static description=l.default.bold(`Show help information about the CLI and its commands`);constructor(e){super(),this.opts=e}async handle(){let e=this.opts.commandRegistry.getCommands().filter(e=>!e.hidden),t=this.opts.cliName??`Bob CLI`,n=this.opts.cliVersion??`0.0.0`,r=He();this.logger.log(`${t} ${l.default.green(n)} (core: ${l.default.yellow(r)})
+
+${l.default.yellow(`Usage`)}:
+  command [options] [arguments]
+
+${l.default.yellow(`Available commands`)}:
+`);let i=Math.max(...e.map(e=>{let t=e.aliases.length>0?` (${e.aliases.join(`, `)})`:``;return e.command.length+t.length}))??0,a={};for(let t of e){let e=t.group??t.command.split(`:`)[0];a[e]||(a[e]=[]),a[e].push(t)}let o=Object.entries(a).sort(([e],[t])=>e.toLowerCase().localeCompare(t.toLowerCase())).sort(([,e],[,t])=>e.length-t.length);for(let[e,t]of o){let n=t.length>1;n&&this.logger.log(l.default.yellow(`${e}:`));let r=t.sort((e,t)=>e.command.toLowerCase().localeCompare(t.command.toLowerCase()));for(let e of r){let t=e.aliases.length>0?l.default.gray(` (${e.aliases.join(`, `)})`):``,r=V(i-(e.command.length+(e.aliases.length>0?` (${e.aliases.join(`, `)})`.length:0)));n&&(r=r.slice(2)),this.logger.log(`${n?`  `:``}${l.default.green(e.command)}${t} ${r} ${e.description}`)}}}},We=class{ctx;logger;commandRegistry;exceptionHandler;helpCommand;newCommandRegistry(e){return new ze(e)}newHelpCommand(e){return new Ue(e)}newExceptionHandler(e){return new Be(e.logger)}constructor(e={}){this.ctx=e.ctx,this.logger=e.logger??new m,this.commandRegistry=this.newCommandRegistry({logger:this.logger}),this.exceptionHandler=this.newExceptionHandler({logger:this.logger}),this.helpCommand=this.newHelpCommand({cliName:e.name,cliVersion:e.version,commandRegistry:this.commandRegistry})}withCommandResolver(e){return this.commandRegistry.withCommandResolver(e),this}withFileImporter(e){return this.commandRegistry.withFileImporter(e),this}async withCommands(...e){for(let t of e)typeof t==`string`?await this.commandRegistry.loadCommandsPath(t):typeof t==`function`?this.registerCommand(t):this.registerCommand(t.constructor)}async runCommand(e,...t){return e?await this.commandRegistry.runCommand(this.ctx??{},e,...t).catch(this.exceptionHandler.handle.bind(this.exceptionHandler)):await this.runHelpCommand()}async runHelpCommand(){return await this.runCommand(this.helpCommand)}registerCommand(e){this.commandRegistry.registerCommand(e)}},Ge=class e{static parse(t,n={}){let[r,...i]=t.split(/\{(.*?)\}/g).map(e=>e.trim()).filter(Boolean),a={},o={};for(let t of i){let r=e.parseParamSignature(t,n);r.isFlag?a[r.name]=r.definition:o[r.name]=r.definition}return{command:r,flags:a,args:o}}static parseParamSignature(e,t){let n=e,r=!1,i,a,o,s=!1,c=!1,l=!0;if(n.includes(`:`)){let[e,t]=n.split(`:`);n=e.trim(),i=t.trim()}if(n.includes(`=`)){let[e,t]=n.split(`=`);n=e.trim();let r=t.trim();l=!1,r.length?r===`*`?(c=!0,a=[]):r===`true`?(s=!0,a=!0):r===`false`?(s=!0,a=!1):a=r:a=null}else n.startsWith(`--`)&&(s=!0,l=!1,a=!1);if(n.includes(`|`)){let[e,...t]=n.split(`|`);n=e.trim(),o=t.map(e=>e.trim())}n.startsWith(`--`)&&(r=!0,n=n.slice(2)),n.endsWith(`?`)&&(l=!1,n=n.slice(0,-1)),n.endsWith(`*`)&&(c=!0,a=[],n=n.slice(0,-1)),i=i??t[n]??t[`--${n}`];let u;return u=r?s?B.boolean({description:i,alias:o,...a===void 0?{}:{default:a}}):c?B.string({description:i,alias:o,multiple:!0,...l?{required:!0}:{},default:a??[]}):B.string({description:i,alias:o,...l?{required:!0}:{},...a===void 0?{}:{default:a}}):c?z.string({description:i,multiple:!0,...l?{required:!0}:{},default:a??[]}):z.string({description:i,...l?{required:!0}:{},...a===void 0?{}:{default:a}}),{name:n,isFlag:r,definition:u}}},Ke=class extends Q{static signature=``;static helperDefinitions={};static get command(){return this.signature.split(/\s/)[0]||``}async run(e){let t=this.constructor;if(t.signature&&!Object.prototype.hasOwnProperty.call(t,`_signatureParsed`)){let e=Ge.parse(t.signature,t.helperDefinitions),n=Object.prototype.hasOwnProperty.call(t,`flags`)?t.flags:{},r=Object.prototype.hasOwnProperty.call(t,`args`)?t.args:{};t.flags={...e.flags,...n},t.args={...e.args,...r},Object.defineProperty(t,`_signatureParsed`,{value:!0})}return super.run(e)}option(e,t=null){return this.parser.flag(e,t)}argument(e,t=null){return this.parser.argument(e,t)}};exports.Args=z,exports.BadCommandArgument=O,exports.BadCommandFlag=k,exports.BobError=_,exports.Cli=We,exports.Command=Q,exports.CommandNotFoundError=ae,exports.CommandParser=se,exports.CommandRegistry=ze,exports.CommandSignatureParser=Ge,exports.CommandWithSignature=Ke,exports.ExceptionHandler=Be,exports.Flags=B,exports.InvalidFlag=w,exports.Logger=m,exports.MissingRequiredArgumentValue=T,exports.MissingRequiredFlagValue=E,exports.StringSimilarity=g,exports.TooManyArguments=oe,exports.UX=Z,exports.ValidationError=D,exports.askForCheckbox=U,exports.askForConfirmation=W,exports.askForEditor=G,exports.askForExpand=K,exports.askForFileSelector=q,exports.askForInput=J,exports.askForList=Y,exports.askForNumber=X,exports.askForPassword=Ee,exports.askForRawList=De,exports.askForSearch=Oe,exports.askForSelect=ke,exports.askForToggle=Ae,exports.keyValue=je,exports.newLoader=Me,exports.newProgressBar=Ne,exports.table=Pe,exports.withCancelHandling=H;

package/dist/cjs/{src/lib → lib}/helpers.d.ts

@@ -1,4 +1,4 @@
 import { Command } from '../Command.js';
 import { BobError } from '../errors/index.js';
-export declare function isBobError(err: Error): err is BobError;
+export declare function isBobError(err: unknown): err is BobError;
 export declare function isBobCommandClass(cls: unknown): cls is typeof Command;

package/dist/cjs/lib/types.d.ts

@@ -0,0 +1,99 @@
+import { Command } from '../Command.js';
+import { UX } from '../ux/index.js';
+export type ContextDefinition = any;
+export type CustomOptions = Record<string, unknown>;
+export type FlagKind = 'string' | 'number' | 'boolean' | 'option' | 'file' | 'directory' | 'url' | 'custom';
+/**
+ * Options handed to a flag's `parse`, `ask`, and `handler` callbacks.
+ *
+ * `definition` is typed as the canonical {@link FlagDefinition}. Builder-specific
+ * extras (`options`, `min`, `max`, `exists`, `secret`) live directly on
+ * {@link FlagDefinition}, so handlers can read them without `any` casts while still
+ * being honest that they are optional at the type level.
+ */
+export type FlagOpts<C extends ContextDefinition = ContextDefinition, P extends CustomOptions = CustomOptions> = {
+    name: string;
+    ux: UX;
+    ctx: C;
+    definition: FlagDefinition<C, P>;
+    cmd: typeof Command;
+};
+export type FlagDefinition<T = any, C extends CustomOptions = CustomOptions> = {
+    [key in keyof C]: C[keyof C];
+} & {
+    parse: (input: any, opts: FlagOpts<any, C>) => T;
+    type?: FlagKind;
+    ask?: (opts: FlagOpts) => Promise<any>;
+    description?: string;
+    required?: boolean;
+    default?: T | T[] | null | (() => T | T[] | null) | (() => Promise<T | T[] | null>);
+    multiple?: boolean;
+    help?: string;
+    alias?: string | readonly string[];
+    handler?: (value: T, opts: FlagOpts) => {
+        shouldStop: boolean;
+    } | void;
+};
+export type InitFlagDefinition<T = any, C extends CustomOptions = CustomOptions> = Omit<FlagDefinition<T, C>, 'parse'> & {
+    parse?: (input: any, opts: FlagOpts<any, C>) => T;
+};
+/** Infers the runtime return type of a flag definition, accounting for `multiple`. */
+export type InferFlagReturn<O> = O extends {
+    parse: (...args: any[]) => infer R;
+} ? O extends {
+    multiple: true;
+} ? [R] extends [Array<unknown>] ? R : R[] : R : never;
+/**
+ * `true` when the parsed value cannot be `null`:
+ *  - `required: true`
+ *  - `multiple: true` (always an array)
+ *  - `default` resolves to a value where neither `null` nor `undefined` is in the union
+ *    (covers `T`, `T[]`, `() => T`, `() => Promise<T>`)
+ */
+type IsGuaranteed<O> = O extends {
+    required: true;
+} ? true : O extends {
+    multiple: true;
+} ? true : O extends {
+    default: infer D;
+} ? null extends D ? false : undefined extends D ? false : true : false;
+/**
+ * Final value type seen by the handler — `T` if guaranteed (required, multiple,
+ * or non-null default), otherwise `T | null`.
+ */
+export type FlagReturnType<O> = IsGuaranteed<O> extends true ? InferFlagReturn<O> : InferFlagReturn<O> | null;
+/** Historic alias — kept so `FlagType<O>` keeps working as a value-inference helper. */
+export type FlagType<O> = InferFlagReturn<O>;
+/** Schema mapping flag names to their {@link FlagDefinition}. */
+export type FlagsSchema = {
+    [key: string]: FlagDefinition<any, any>;
+};
+/** Inferred runtime shape of all flags in a schema. */
+export type FlagsObject<Options extends FlagsSchema> = {
+    [Key in keyof Options]: FlagReturnType<Options[Key]>;
+};
+/**
+ * Schema for positional arguments.
+ *
+ * Note on booleans: positional booleans don't really make sense, so the
+ * canonical {@link Args} builder set deliberately omits `Args.boolean`. The
+ * type itself is a structural alias of {@link FlagsSchema} (rather than a
+ * branded subtype) to keep literal-type inference flowing through the builder
+ * generics without surprising errors. If you put `Flags.boolean()` in
+ * `static args`, the runtime parser will accept it but you're outside the
+ * supported design.
+ */
+export type ArgDefinition = FlagDefinition;
+export type ArgsSchema = FlagsSchema;
+export type InferFlags<T> = T extends {
+    flags: infer O extends FlagsSchema;
+} ? O : FlagsSchema;
+export type InferArgs<T> = T extends {
+    args: infer A extends ArgsSchema;
+} ? A : ArgsSchema;
+/** `{ flags, args }` pair for a given Command class — the second handler argument. */
+export type Parsed<T> = {
+    flags: FlagsObject<InferFlags<T>>;
+    args: FlagsObject<InferArgs<T>>;
+};
+export {};

package/dist/cjs/shared/ask-helpers.d.ts

@@ -0,0 +1,7 @@
+import { FlagOpts } from '../lib/types.js';
+export declare function buildStringAsk(builderOpts: FlagOpts): Promise<any>;
+export declare function buildNumberAsk(builderOpts: FlagOpts): Promise<any>;
+export declare function buildOptionAsk(builderOpts: FlagOpts): Promise<any>;
+export declare function buildFileAsk(builderOpts: FlagOpts): Promise<any>;
+export declare function buildDirectoryAsk(builderOpts: FlagOpts): Promise<any>;
+export declare function buildUrlAsk(builderOpts: FlagOpts): Promise<any>;

package/dist/cjs/shared/flagsUtils.d.ts

@@ -0,0 +1,5 @@
+import { numberFlag } from '../flags/number.js';
+import { optionFlag } from '../flags/option.js';
+import { FlagDefinition } from '../lib/types.js';
+export declare function isNumberFlag(flag: FlagDefinition): flag is ReturnType<typeof numberFlag>;
+export declare function isOptionFlag(flag: FlagDefinition<any, any>): flag is ReturnType<typeof optionFlag>;

package/dist/cjs/ux/askForConfirmation.d.ts

@@ -0,0 +1,10 @@
+export type AskForConfirmationOptions = {
+    default?: boolean;
+    transformer?: (value: boolean) => string;
+};
+/**
+ * Yes/no confirmation prompt. Returns the user's choice, or `null` if they
+ * cancelled (Ctrl+C / SIGINT) — matching the cancellation contract used by
+ * every other prompt in the {@link UX} module.
+ */
+export declare function askForConfirmation(message?: string, opts?: AskForConfirmationOptions): Promise<boolean | null>;

package/dist/cjs/{src/ux → ux}/askForToggle.d.ts

@@ -3,4 +3,8 @@ export type AskForToggleOptions = {
     active?: string;
     inactive?: string;
 };
-export declare function askForToggle(message: string, opts?: AskForToggleOptions): Promise<boolean>;
+/**
+ * Two-state toggle prompt with custom labels. Returns the chosen state, or
+ * `null` if cancelled (Ctrl+C / SIGINT).
+ */
+export declare function askForToggle(message: string, opts?: AskForToggleOptions): Promise<boolean | null>;

package/dist/cjs/ux/helpers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wraps an inquirer prompt so that cancellation (Ctrl+C / SIGINT, surfaced as
+ * `ExitPromptError`) resolves to `fallback` instead of throwing. Every other
+ * exception propagates so genuine failures stay visible.
+ */
+export declare function withCancelHandling<T>(fn: () => Promise<T>, fallback: T): Promise<T>;