@voryx/cli 0.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,22 @@
+
+
+> @voryx/cli@0.0.0 build /Users/cal/Documents/dev/voryx/packages/cli
+> rslib build
+
+Rslib v0.19.6
+
+(node:97408) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///Users/cal/Documents/dev/voryx/packages/cli/rslib.config.ts?t=1788725586056 is not specified and it doesn't parse as CommonJS.
+Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
+To eliminate this warning, add "type": "module" to /Users/cal/Documents/dev/voryx/packages/cli/package.json.
+(Use `node --trace-warnings ...` to show where the warning was created)
+info    build started...
+ready   built in 0.13 s
+start   generating declaration files... (esm)
+ready   declaration files generated in 0.26 s (esm)
+
+File (esm)           Size      
+dist/manifest.json   0.17 kB
+dist/index.mjs       11.0 kB
+
+            Total:   11.1 kB
+

package/dist/BooleanFlag.d.ts

@@ -0,0 +1,10 @@
+import { FlagSchema } from './FlagSchema';
+import type { FlagDefinition } from './types';
+export declare class BooleanFlag<D extends boolean | undefined = boolean | undefined> extends FlagSchema<'boolean', D> {
+    constructor(options: Omit<FlagDefinition<'boolean', D>, 'kind'>);
+    resolveValue(raw: string | undefined): {
+        value: boolean;
+        usedValue: boolean;
+    };
+}
+//# sourceMappingURL=BooleanFlag.d.ts.map

package/dist/BooleanFlag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BooleanFlag.d.ts","sourceRoot":"","sources":["../src/BooleanFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,qBAAa,WAAW,CACtB,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CACnD,SAAQ,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAIhE,YAAY,CAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;QACtC,KAAK,EAAE,OAAO,CAAA;QACd,SAAS,EAAE,OAAO,CAAA;KACnB;CAMF"}

package/dist/Cli.d.ts

@@ -0,0 +1,37 @@
+import { Schema } from './Schema';
+import type { CommandCtx, SchemaOptions } from './types';
+export interface Command<S extends SchemaOptions = SchemaOptions> {
+    name: string;
+    description: string;
+    usage: string;
+    schema: Schema<S>;
+    run: (ctx: CommandCtx<S>) => void | Promise<void>;
+}
+declare function createCommandClass(cli: Cli): {
+    new <S extends SchemaOptions = SchemaOptions>(options: {
+        name: string;
+        description: string;
+        usage: string;
+        schema: S;
+        run: (ctx: CommandCtx<S>) => void | Promise<void>;
+    }): {
+        name: string;
+        description: string;
+        usage: string;
+        schema: Schema<S>;
+        run: (ctx: CommandCtx<S>) => void | Promise<void>;
+    };
+};
+export declare class Cli {
+    name: string;
+    commands: Map<string, Command>;
+    Command: ReturnType<typeof createCommandClass>;
+    constructor(name: string);
+    run(): Promise<void>;
+    warn(msg: string): void;
+    error(msg: string): void;
+    log(msg: string): void;
+    exit(code: number): void;
+}
+export {};
+//# sourceMappingURL=Cli.d.ts.map

package/dist/Cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.d.ts","sourceRoot":"","sources":["../src/Cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAgExD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACjB,GAAG,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED,iBAAS,kBAAkB,CAAE,GAAG,EAAE,GAAG;SAEjC,CAAC,SAAS,aAAa,2BAOD;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,CAAC,CAAA;QACT,GAAG,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAClD;cAXG,MAAM;qBACC,MAAM;eACZ,MAAM;gBACL,MAAM,CAAC,CAAC,CAAC;aACZ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;;EAgBlD;AAED,qBAAa,GAAG;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;gBAEjC,IAAI,EAAE,MAAM;IAMnB,GAAG;IAqDT,IAAI,CAAE,GAAG,EAAE,MAAM;IAIjB,KAAK,CAAE,GAAG,EAAE,MAAM;IAKlB,GAAG,CAAE,GAAG,EAAE,MAAM;IAIhB,IAAI,CAAE,IAAI,EAAE,MAAM;CAGnB"}

package/dist/FlagSchema.d.ts

@@ -0,0 +1,14 @@
+import type { FlagDefinition, FlagKind, TypeFlag } from './types';
+export declare abstract class FlagSchema<T extends FlagKind = FlagKind, D extends TypeFlag<T> | undefined = TypeFlag<T> | undefined> {
+    kind: T;
+    long: string;
+    short?: string;
+    description: string;
+    default: D;
+    constructor(options: FlagDefinition<T, D>);
+    abstract resolveValue(raw: string | undefined): {
+        value: TypeFlag<T> | D;
+        usedValue: boolean;
+    };
+}
+//# sourceMappingURL=FlagSchema.d.ts.map

package/dist/FlagSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagSchema.d.ts","sourceRoot":"","sources":["../src/FlagSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEjE,8BAAsB,UAAU,CAC9B,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7B,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAE3D,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,EAAE,MAAM,CAAK;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,CAAA;gBAEG,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAO1C,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;QAC9C,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACtB,SAAS,EAAE,OAAO,CAAA;KACnB;CACF"}

package/dist/NumberFlag.d.ts

@@ -0,0 +1,10 @@
+import { FlagSchema } from "./FlagSchema";
+import type { FlagDefinition } from "./types";
+export declare class NumberFlag<D extends number | undefined = number | undefined> extends FlagSchema<'number', D> {
+    constructor(options: Omit<FlagDefinition<'number', D>, 'kind'>);
+    resolveValue(raw: string | undefined): {
+        value: number;
+        usedValue: boolean;
+    };
+}
+//# sourceMappingURL=NumberFlag.d.ts.map

package/dist/NumberFlag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFlag.d.ts","sourceRoot":"","sources":["../src/NumberFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,qBAAa,UAAU,CACrB,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CACjD,SAAQ,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAI/D,YAAY,CAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAY9E"}

package/dist/Schema.d.ts

@@ -0,0 +1,14 @@
+import type { Flags, SchemaOptions } from "./types";
+export declare class Schema<S extends SchemaOptions = SchemaOptions> {
+    private byLong;
+    private byShort;
+    private names;
+    constructor(schema: S);
+    map<T>(fn: (flag: S[keyof S]) => T): T[];
+    forEach(fn: (flag: S[keyof S], index: number) => void): void;
+    parse(argv: string[]): {
+        flags: Flags<S>;
+        unknown: string[];
+    };
+}
+//# sourceMappingURL=Schema.d.ts.map

package/dist/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../src/Schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEnD,qBAAa,MAAM,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACzD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAa;gBAEb,MAAM,EAAE,CAAC;IAatB,GAAG,CAAC,CAAC,EAAG,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IAQzC,OAAO,CAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAQ7D,KAAK,CAAE,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;CAwE/D"}

package/dist/StringFlag.d.ts

@@ -0,0 +1,10 @@
+import { FlagSchema } from "./FlagSchema";
+import type { FlagDefinition } from "./types";
+export declare class StringFlag<D extends string | undefined = string | undefined> extends FlagSchema<'string', D> {
+    constructor(options: Omit<FlagDefinition<'string', D>, 'kind'>);
+    resolveValue(raw: string | undefined): {
+        value: string;
+        usedValue: boolean;
+    };
+}
+//# sourceMappingURL=StringFlag.d.ts.map

package/dist/StringFlag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringFlag.d.ts","sourceRoot":"","sources":["../src/StringFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,qBAAa,UAAU,CACrB,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CACjD,SAAQ,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAI/D,YAAY,CAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAS9E"}

package/dist/TerminalColor.d.ts

@@ -0,0 +1,20 @@
+export declare class TerminalColor {
+    static red(text: string): string;
+    static green(text: string): string;
+    static yellow(text: string): string;
+    static blue(text: string): string;
+    static magenta(text: string): string;
+    static cyan(text: string): string;
+    static purple(text: string): string;
+    static gray(text: string): string;
+    static bold(text: string): string;
+    static backgroundRed(text: string): string;
+    static backgroundGreen(text: string): string;
+    static backgroundYellow(text: string): string;
+    static backgroundBlue(text: string): string;
+    static backgroundMagenta(text: string): string;
+    static backgroundCyan(text: string): string;
+    static backgroundPurple(text: string): string;
+    static backgroundGray(text: string): string;
+}
+//# sourceMappingURL=TerminalColor.d.ts.map

package/dist/TerminalColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalColor.d.ts","sourceRoot":"","sources":["../src/TerminalColor.ts"],"names":[],"mappings":"AACA,qBAAa,aAAa;IACxB,MAAM,CAAC,GAAG,CAAE,IAAI,EAAE,MAAM;IAIxB,MAAM,CAAC,KAAK,CAAE,IAAI,EAAE,MAAM;IAI1B,MAAM,CAAC,MAAM,CAAE,IAAI,EAAE,MAAM;IAI3B,MAAM,CAAC,IAAI,CAAE,IAAI,EAAE,MAAM;IAIzB,MAAM,CAAC,OAAO,CAAE,IAAI,EAAE,MAAM;IAI5B,MAAM,CAAC,IAAI,CAAE,IAAI,EAAE,MAAM;IAIzB,MAAM,CAAC,MAAM,CAAE,IAAI,EAAE,MAAM;IAI3B,MAAM,CAAC,IAAI,CAAE,IAAI,EAAE,MAAM;IAIzB,MAAM,CAAC,IAAI,CAAE,IAAI,EAAE,MAAM;IAIzB,MAAM,CAAC,aAAa,CAAE,IAAI,EAAE,MAAM;IAIlC,MAAM,CAAC,eAAe,CAAE,IAAI,EAAE,MAAM;IAIpC,MAAM,CAAC,gBAAgB,CAAE,IAAI,EAAE,MAAM;IAIrC,MAAM,CAAC,cAAc,CAAE,IAAI,EAAE,MAAM;IAInC,MAAM,CAAC,iBAAiB,CAAE,IAAI,EAAE,MAAM;IAItC,MAAM,CAAC,cAAc,CAAE,IAAI,EAAE,MAAM;IAInC,MAAM,CAAC,gBAAgB,CAAE,IAAI,EAAE,MAAM;IAIrC,MAAM,CAAC,cAAc,CAAE,IAAI,EAAE,MAAM;CAGpC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './Cli';
+export * from './Schema';
+export * from './types';
+export * from './TerminalColor';
+export * from './BooleanFlag';
+export * from './StringFlag';
+export * from './NumberFlag';
+export * from './FlagSchema';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/index.mjs

@@ -0,0 +1,345 @@
+class Schema {
+    byLong;
+    byShort;
+    names;
+    constructor(schema){
+        this.byLong = new Map();
+        this.byShort = new Map();
+        this.names = new Set();
+        for (const [key, s] of Object.entries(schema)){
+            s.long = key;
+            this.byLong.set(s.long, s);
+            if (s.short) this.byShort.set(s.short, s);
+            this.names.add(s.long);
+        }
+    }
+    map(fn) {
+        const result = [];
+        for (const flag of this.byLong.values())result.push(fn(flag));
+        return result;
+    }
+    forEach(fn) {
+        let index = 0;
+        for (const flag of this.byLong.values()){
+            fn(flag, index);
+            index++;
+        }
+    }
+    parse(argv) {
+        const flags = {};
+        const notFound = new Set(this.names);
+        const unknown = [];
+        for(let i = 0; i < argv.length; i++){
+            const a = argv[i];
+            if ('--' === a) break;
+            if (a.startsWith('--')) {
+                const eq = a.indexOf('=');
+                const name = -1 === eq ? a.slice(2) : a.slice(2, eq);
+                const flag = this.byLong.get(name);
+                if (!flag) {
+                    unknown.push(a);
+                    continue;
+                }
+                notFound.delete(name);
+                const value = -1 === eq ? void 0 : a.slice(eq + 1);
+                const raw = value ?? argv[i + 1];
+                if (void 0 === value) {
+                    const { value: resolved, usedValue } = flag.resolveValue(raw);
+                    flags[flag.long] = resolved;
+                    if (usedValue) i++;
+                } else {
+                    const resolved = flag.resolveValue(value);
+                    flags[flag.long] = resolved.value;
+                }
+            } else if (a.startsWith('-') && '-' !== a) {
+                const eq = a.indexOf('=');
+                const name = -1 === eq ? a.slice(1) : a.slice(1, eq);
+                const flag = this.byShort.get(name);
+                if (!flag) {
+                    unknown.push(a);
+                    continue;
+                }
+                notFound.delete(name);
+                const value = -1 === eq ? void 0 : a.slice(eq + 1);
+                const raw = value ?? argv[i + 1];
+                if (void 0 === value) {
+                    const { value: resolved, usedValue } = flag.resolveValue(raw);
+                    flags[flag.long] = resolved;
+                    if (usedValue) i++;
+                } else {
+                    const resolved = flag.resolveValue(value);
+                    flags[flag.long] = resolved.value;
+                }
+            }
+        }
+        for (const name of notFound){
+            const flag = this.byLong.get(name);
+            if (void 0 !== flag.default) flags[flag.long] = flag.default;
+            else if ('boolean' === flag.kind) flags[flag.long] = false;
+            else throw new Error(`Missing required flag --${flag.long}`);
+        }
+        return {
+            flags,
+            unknown
+        };
+    }
+}
+class TerminalColor {
+    static red(text) {
+        return `\x1b[38;5;196m${text}\x1b[0m`;
+    }
+    static green(text) {
+        return `\x1b[38;5;47m${text}\x1b[0m`;
+    }
+    static yellow(text) {
+        return `\x1b[38;5;226m${text}\x1b[0m`;
+    }
+    static blue(text) {
+        return `\x1b[38;5;27m${text}\x1b[0m`;
+    }
+    static magenta(text) {
+        return `\x1b[38;5;200m${text}\x1b[0m`;
+    }
+    static cyan(text) {
+        return `\x1b[38;5;51m${text}\x1b[0m`;
+    }
+    static purple(text) {
+        return `\x1b[38;5;141m${text}\x1b[0m`;
+    }
+    static gray(text) {
+        return `\x1b[38;5;245m${text}\x1b[0m`;
+    }
+    static bold(text) {
+        return `\x1b[1m${text}\x1b[0m`;
+    }
+    static backgroundRed(text) {
+        return `\x1b[48;5;196m${text}\x1b[0m`;
+    }
+    static backgroundGreen(text) {
+        return `\x1b[48;5;47m${text}\x1b[0m`;
+    }
+    static backgroundYellow(text) {
+        return `\x1b[48;5;226m${text}\x1b[0m`;
+    }
+    static backgroundBlue(text) {
+        return `\x1b[48;5;27m${text}\x1b[0m`;
+    }
+    static backgroundMagenta(text) {
+        return `\x1b[48;5;200m${text}\x1b[0m`;
+    }
+    static backgroundCyan(text) {
+        return `\x1b[48;5;51m${text}\x1b[0m`;
+    }
+    static backgroundPurple(text) {
+        return `\x1b[48;5;141m${text}\x1b[0m`;
+    }
+    static backgroundGray(text) {
+        return `\x1b[48;5;245m${text}\x1b[0m`;
+    }
+}
+function exit(code) {
+    process.exitCode = code;
+    throw code;
+}
+function formatError(msg) {
+    return `Error: ${msg}`;
+}
+function padRight(s, n) {
+    return s.length >= n ? s : s + ' '.repeat(n - s.length);
+}
+function printHelp(appName, commands) {
+    const lines = [];
+    lines.push(`${TerminalColor.backgroundPurple(appName)} — CLI`);
+    lines.push('');
+    lines.push('Usage:');
+    lines.push(`  ${appName} ${TerminalColor.cyan('<command>')} [options]`);
+    lines.push('');
+    lines.push('Commands:');
+    const w = Math.max(...commands.map((c)=>c.name.length), 7);
+    for (const c of commands)lines.push(`  ${padRight(c.name, w)}  ${c.description}`);
+    lines.push('');
+    lines.push(`Run "${appName} <command> --help" for command options.`);
+    process.stdout.write(lines.join('\n') + '\n');
+}
+function printCommandHelp(appName, cmd) {
+    const lines = [];
+    lines.push(`${TerminalColor.backgroundPurple(appName)} ${TerminalColor.cyan(cmd.name)}`);
+    lines.push('');
+    lines.push(cmd.description);
+    lines.push('');
+    lines.push('Usage:');
+    lines.push(`  ${appName} ${cmd.usage}`);
+    if (cmd.schema) {
+        lines.push('');
+        lines.push('Options:');
+        const left = cmd.schema.map((f)=>{
+            const short = 'short' in f && f.short ? `-${f.short}, ` : '    ';
+            const long = `--${f.long}`;
+            const value = 'boolean' === f.kind ? '' : `=<${'placeholder' in f && f.placeholder ? f.placeholder : f.kind}>`;
+            return `${short}${long}${value}`;
+        });
+        const w = Math.max(...left.map((s)=>s.length), 10);
+        cmd.schema.forEach((f, i)=>{
+            lines.push(`  ${padRight(left[i], w)}  ${f.description}`);
+        });
+    }
+    lines.push('');
+    process.stdout.write(lines.join('\n') + '\n');
+}
+function createCommandClass(cli) {
+    return class {
+        name;
+        description;
+        usage;
+        schema;
+        run;
+        constructor(options){
+            this.name = options.name;
+            this.description = options.description;
+            this.usage = options.usage;
+            this.schema = new Schema(options.schema);
+            this.run = options.run;
+            cli.commands.set(this.name, this);
+        }
+    };
+}
+class Cli {
+    name;
+    commands;
+    Command;
+    constructor(name){
+        this.name = name;
+        this.commands = new Map();
+        this.Command = createCommandClass(this);
+    }
+    async run() {
+        const argv = process.argv.slice(2);
+        const [maybeCommand, ...rest] = argv;
+        if (!maybeCommand || '-h' === maybeCommand || '--help' === maybeCommand) return void printHelp(this.name, [
+            ...this.commands.values()
+        ]);
+        const cmd = this.commands.get(maybeCommand);
+        if (!cmd) {
+            process.stderr.write(formatError(`Unknown command "${maybeCommand}".`) + '\n\n');
+            printHelp(this.name, [
+                ...this.commands.values()
+            ]);
+            exit(1);
+        }
+        if (rest.includes('--help') || rest.includes('-h')) return void printCommandHelp(this.name, cmd);
+        const parsed = cmd.schema.parse(rest);
+        if (parsed.unknown.length) {
+            process.stderr.write(formatError(`Unknown option(s): ${parsed.unknown.join(', ')}`) + '\n');
+            process.stderr.write(`Run "${this.name} ${cmd.name} --help" for options.\n`);
+            exit(1);
+        }
+        process.stdout.write(`${TerminalColor.backgroundPurple(this.name)} - <${TerminalColor.cyan(cmd.name)}>...\n\n`);
+        const timeNow = performance.now();
+        await cmd.run({
+            argv: rest,
+            flags: parsed.flags,
+            stdout: process.stdout,
+            stderr: process.stderr,
+            exit: exit
+        });
+        const timeEnd = performance.now();
+        process.stdout.write(`\n${TerminalColor.backgroundPurple(this.name)} - <${TerminalColor.cyan(cmd.name)}>\n    completed in ${TerminalColor.green((timeEnd - timeNow).toFixed(2))}ms\n\n`);
+    }
+    warn(msg) {
+        process.stdout.write(`    ${TerminalColor.yellow('Warning:')} ${msg.split('\n').join('\n    ')}\n`);
+    }
+    error(msg) {
+        process.stderr.write(`${TerminalColor.red('Error:')} ${msg}\n`);
+        exit(1);
+    }
+    log(msg) {
+        process.stdout.write(`    ${msg.split('\n').join('\n    ')}\n`);
+    }
+    exit(code) {
+        exit(code);
+    }
+}
+class FlagSchema {
+    kind;
+    long = '';
+    short;
+    description;
+    default;
+    constructor(options){
+        this.kind = options.kind;
+        this.short = options.short;
+        this.description = options.description;
+        this.default = options.default;
+    }
+}
+class BooleanFlag extends FlagSchema {
+    constructor(options){
+        super({
+            ...options,
+            kind: 'boolean'
+        });
+    }
+    resolveValue(raw) {
+        if (void 0 === raw) return {
+            value: true,
+            usedValue: false
+        };
+        if ('true' === raw.toLowerCase()) return {
+            value: true,
+            usedValue: true
+        };
+        if ('false' === raw.toLowerCase()) return {
+            value: false,
+            usedValue: true
+        };
+        return {
+            value: true,
+            usedValue: false
+        };
+    }
+}
+class StringFlag extends FlagSchema {
+    constructor(options){
+        super({
+            ...options,
+            kind: 'string'
+        });
+    }
+    resolveValue(raw) {
+        if (void 0 === raw) {
+            if (void 0 !== this.default) return {
+                value: this.default,
+                usedValue: false
+            };
+            throw new Error(`Missing value for --${this.long}`);
+        }
+        return {
+            value: raw,
+            usedValue: true
+        };
+    }
+}
+class NumberFlag extends FlagSchema {
+    constructor(options){
+        super({
+            ...options,
+            kind: 'number'
+        });
+    }
+    resolveValue(raw) {
+        if (void 0 === raw) {
+            if (void 0 !== this.default) return {
+                value: this.default,
+                usedValue: false
+            };
+            throw new Error(`Missing value for --${this.long}`);
+        }
+        const n = Number(raw);
+        if (!Number.isFinite(n)) throw new Error(`Invalid number for --${this.long}: ${raw}`);
+        return {
+            value: n,
+            usedValue: true
+        };
+    }
+}
+export { BooleanFlag, Cli, FlagSchema, NumberFlag, Schema, StringFlag, TerminalColor };

package/dist/manifest.json

@@ -0,0 +1,15 @@
+{
+  "allFiles": [
+    "index.mjs"
+  ],
+  "entries": {
+    "index": {
+      "initial": {
+        "js": [
+          "index.mjs"
+        ]
+      }
+    }
+  },
+  "integrity": {}
+}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+import type { FlagSchema } from "./FlagSchema";
+export type TypeFlag<T extends 'boolean' | 'string' | 'number'> = T extends 'boolean' ? boolean : T extends 'string' ? string : T extends 'number' ? number : never;
+export type FlagKind = 'boolean' | 'string' | 'number';
+export type FlagDefinition<T extends FlagKind, D extends TypeFlag<T> | undefined = TypeFlag<T> | undefined> = {
+    kind: T;
+    short?: string;
+    description: string;
+    default: D;
+};
+export type ShouldRequire<T extends FlagDefinition<FlagKind>> = T['default'] extends undefined ? T['kind'] extends 'boolean' ? true : false : true;
+export type Flags<S extends SchemaOptions> = {
+    [K in keyof S as ShouldRequire<S[K]> extends true ? K : never]: TypeFlag<S[K]['kind']>;
+} & {
+    [K in keyof S as ShouldRequire<S[K]> extends false ? K : never]?: TypeFlag<S[K]['kind']>;
+};
+export interface SchemaOptions {
+    [key: string]: FlagSchema;
+}
+export type CommandCtx<S extends SchemaOptions = SchemaOptions> = {
+    argv: string[];
+    flags: Flags<S>;
+    stdout: NodeJS.WriteStream;
+    stderr: NodeJS.WriteStream;
+    exit: (code: number) => never;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG,QAAQ,GAAG,QAAQ,IAAI,CAAC,SAAS,SAAS,GACjF,OAAO,GACP,CAAC,SAAS,QAAQ,GAClB,MAAM,GACN,CAAC,SAAS,QAAQ,GAClB,MAAM,GACN,KAAK,CAAA;AAET,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEtD,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,IACzD;IACF,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,CAAA;CACX,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,CAAC,QAAQ,CAAC,IAC1D,CAAC,CAAC,SAAS,CAAC,SAAS,SAAS,GAC1B,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACzB,IAAI,GACJ,KAAK,GACP,IAAI,CAAA;AAEV,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,aAAa,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,QAAQ,CACtE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CACb;CACF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CACxE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CACb;CACF,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC1B;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI;IAChE,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,WAAW,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAA;IAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAA;CAC9B,CAAA"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@voryx/cli",
+  "version": "0.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@rslib/core": "^0.19.6",
+    "@types/node": "^22.15.3",
+    "ts-standard": "^12.0.2",
+    "typescript": "5.9.2",
+    "@voryx/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "lint": "ts-standard",
+    "build": "rslib build",
+    "check-types": "tsc --noEmit"
+  }
+}

package/rslib.config.ts

@@ -0,0 +1,22 @@
+
+import { defineConfig } from '@rslib/core'
+
+export default defineConfig({
+  lib: [
+    {
+      format: 'esm',
+      syntax: 'es2023',
+      bundle: true,
+      dts: true
+    }
+  ],
+  output: {
+    target: 'node',
+    manifest: true
+  },
+  source: {
+    entry: {
+      index: 'src/index.ts'
+    }
+  }
+})

package/src/BooleanFlag.ts

@@ -0,0 +1,20 @@
+import { FlagSchema } from './FlagSchema'
+import type { FlagDefinition } from './types'
+
+export class BooleanFlag<
+  D extends boolean | undefined = boolean | undefined
+> extends FlagSchema<'boolean', D> {
+  constructor (options: Omit<FlagDefinition<'boolean', D>, 'kind'>) {
+    super({ ...options, kind: 'boolean' })
+  }
+
+  resolveValue (raw: string | undefined): {
+    value: boolean
+    usedValue: boolean
+  } {
+    if (raw === undefined) return { value: true, usedValue: false }
+    if (raw.toLowerCase() === 'true') return { value: true, usedValue: true }
+    if (raw.toLowerCase() === 'false') return { value: false, usedValue: true }
+    return { value: true, usedValue: false }
+  }
+}

package/src/Cli.ts

@@ -0,0 +1,180 @@
+import { Schema } from './Schema'
+import type { CommandCtx, SchemaOptions } from './types'
+import { TerminalColor } from './TerminalColor'
+
+function exit (code: number): never {
+  process.exitCode = code
+  // eslint-disable-next-line no-throw-literal
+  throw code // allows early exits inside async without extra plumbing
+}
+
+function formatError (msg: string) {
+  return `Error: ${msg}`
+}
+
+function padRight (s: string, n: number) {
+  return s.length >= n ? s : s + ' '.repeat(n - s.length)
+}
+
+function printHelp (appName: string, commands: Command[]) {
+  const lines: string[] = []
+  lines.push(`${TerminalColor.backgroundPurple(appName)} — CLI`)
+  lines.push('')
+  lines.push('Usage:')
+  lines.push(`  ${appName} ${TerminalColor.cyan('<command>')} [options]`)
+  lines.push('')
+  lines.push('Commands:')
+  const w = Math.max(...commands.map(c => c.name.length), 7)
+  for (const c of commands) {
+    lines.push(`  ${padRight(c.name, w)}  ${c.description}`)
+  }
+  lines.push('')
+  lines.push(`Run "${appName} <command> --help" for command options.`)
+  process.stdout.write(lines.join('\n') + '\n')
+}
+
+function printCommandHelp (appName: string, cmd: Command) {
+  const lines: string[] = []
+  lines.push(`${TerminalColor.backgroundPurple(appName)} ${TerminalColor.cyan(cmd.name)}`)
+  lines.push('')
+  lines.push(cmd.description)
+  lines.push('')
+  lines.push('Usage:')
+  lines.push(`  ${appName} ${cmd.usage}`)
+  if (cmd.schema) {
+    lines.push('')
+    lines.push('Options:')
+    const left = cmd.schema.map(f => {
+      const short = 'short' in f && f.short ? `-${f.short}, ` : '    '
+      const long = `--${f.long}`
+      const value =
+        f.kind === 'boolean'
+          ? ''
+          : `=<${'placeholder' in f && f.placeholder ? f.placeholder : f.kind}>`
+      return `${short}${long}${value}`
+    })
+    const w = Math.max(...left.map(s => s.length), 10)
+
+    cmd.schema.forEach((f, i) => {
+      lines.push(`  ${padRight(left[i]!, w)}  ${f.description}`)
+    })
+  }
+  lines.push('')
+  process.stdout.write(lines.join('\n') + '\n')
+}
+
+export interface Command<S extends SchemaOptions = SchemaOptions> {
+  name: string
+  description: string
+  usage: string
+  schema: Schema<S>
+  run: (ctx: CommandCtx<S>) => void | Promise<void>
+}
+
+function createCommandClass (cli: Cli) {
+  return class CliCommand<
+    S extends SchemaOptions = SchemaOptions
+  > implements Command<S> {
+  name: string
+  description: string
+  usage: string
+  schema: Schema<S>
+  run: (ctx: CommandCtx<S>) => void | Promise<void>
+    constructor (options: {
+      name: string
+      description: string
+      usage: string
+      schema: S
+      run: (ctx: CommandCtx<S>) => void | Promise<void>
+    }) {
+    this.name = options.name
+    this.description = options.description
+    this.usage = options.usage
+    this.schema = new Schema(options.schema)
+    this.run = options.run
+      cli.commands.set(this.name, this as Command<any>)
+    }
+  }
+}
+
+export class Cli {
+  name: string
+  commands: Map<string, Command>
+  Command: ReturnType<typeof createCommandClass>
+
+  constructor (name: string) {
+    this.name = name
+    this.commands = new Map()
+    this.Command = createCommandClass(this)
+  }
+
+  async run () {
+    // remove node + script path
+    const argv = process.argv.slice(2)
+
+    const [maybeCommand, ...rest] = argv
+
+    if (!maybeCommand || maybeCommand === '-h' || maybeCommand === '--help') {
+      printHelp(this.name, [...this.commands.values()])
+      return
+    }
+
+    const cmd = this.commands.get(maybeCommand)
+    if (!cmd) {
+      process.stderr.write(
+        formatError(`Unknown command "${maybeCommand}".`) + '\n\n'
+      )
+      printHelp(this.name, [...this.commands.values()])
+      exit(1)
+    }
+
+    // command-level help
+    if (rest.includes('--help') || rest.includes('-h')) {
+      printCommandHelp(this.name, cmd)
+      return
+    }
+
+    const parsed = cmd.schema.parse(rest)
+
+    if (parsed.unknown.length) {
+      process.stderr.write(
+        formatError(`Unknown option(s): ${parsed.unknown.join(', ')}`) + '\n'
+      )
+      process.stderr.write(
+        `Run "${this.name} ${cmd.name} --help" for options.\n`
+      )
+      exit(1)
+    }
+
+    process.stdout.write(`${TerminalColor.backgroundPurple(this.name)} - <${TerminalColor.cyan(cmd.name)}>...\n\n`)
+    const timeNow = performance.now()
+
+    await cmd.run({
+      argv: rest,
+      flags: parsed.flags,
+      stdout: process.stdout,
+      stderr: process.stderr,
+      exit
+    })
+
+    const timeEnd = performance.now()
+    process.stdout.write(`\n${TerminalColor.backgroundPurple(this.name)} - <${TerminalColor.cyan(cmd.name)}>\n    completed in ${TerminalColor.green((timeEnd - timeNow).toFixed(2))}ms\n\n`)
+  }
+
+  warn (msg: string) {
+    process.stdout.write(`    ${TerminalColor.yellow('Warning:')} ${msg.split('\n').join('\n    ')}\n`)
+  }
+
+  error (msg: string) {
+    process.stderr.write(`${TerminalColor.red('Error:')} ${msg}\n`)
+    exit(1)
+  }
+
+  log (msg: string) {
+    process.stdout.write(`    ${msg.split('\n').join('\n    ')}\n`)
+  }
+
+  exit (code: number) {
+    exit(code)
+  }
+}

package/src/FlagSchema.ts

@@ -0,0 +1,24 @@
+import type { FlagDefinition, FlagKind, TypeFlag } from './types'
+
+export abstract class FlagSchema<
+  T extends FlagKind = FlagKind,
+  D extends TypeFlag<T> | undefined = TypeFlag<T> | undefined
+> {
+  kind: T
+  long: string = ''
+  short?: string
+  description: string
+  default: D
+
+  constructor (options: FlagDefinition<T, D>) {
+    this.kind = options.kind
+    this.short = options.short
+    this.description = options.description
+    this.default = options.default
+  }
+
+  abstract resolveValue(raw: string | undefined): {
+    value: TypeFlag<T> | D
+    usedValue: boolean
+  }
+}

package/src/NumberFlag.ts

@@ -0,0 +1,23 @@
+import { FlagSchema } from "./FlagSchema"
+import type { FlagDefinition } from "./types"
+
+export class NumberFlag<
+  D extends number | undefined = number | undefined
+> extends FlagSchema<'number', D> {
+  constructor (options: Omit<FlagDefinition<'number', D>, 'kind'>) {
+    super({ ...options, kind: 'number' })
+  }
+
+  resolveValue (raw: string | undefined): { value: number; usedValue: boolean } {
+    if (raw === undefined) {
+      if (this.default !== undefined)
+        return { value: this.default, usedValue: false }
+      throw new Error(`Missing value for --${this.long}`)
+    }
+    const n = Number(raw)
+    if (!Number.isFinite(n)) {
+      throw new Error(`Invalid number for --${this.long}: ${raw}`)
+    }
+    return { value: n, usedValue: true }
+  }
+}

package/src/Schema.ts

@@ -0,0 +1,109 @@
+import type { Flags, SchemaOptions } from "./types"
+
+export class Schema<S extends SchemaOptions = SchemaOptions> {
+  private byLong: Map<string, S[keyof S]>
+  private byShort: Map<string, S[keyof S]>
+  private names: Set<string>
+
+  constructor (schema: S) {
+    this.byLong = new Map()
+    this.byShort = new Map()
+    this.names = new Set()
+
+    for (const [key, s] of Object.entries(schema)) {
+      s.long = key
+      this.byLong.set(s.long, s as S[keyof S])
+      if (s.short) this.byShort.set(s.short, s as S[keyof S])
+      this.names.add(s.long)
+    }
+  }
+
+  map<T> (fn: (flag: S[keyof S]) => T): T[] {
+    const result: T[] = []
+    for (const flag of this.byLong.values()) {
+      result.push(fn(flag))
+    }
+    return result
+  }
+
+  forEach (fn: (flag: S[keyof S], index: number) => void): void {
+    let index = 0
+    for (const flag of this.byLong.values()) {
+      fn(flag, index)
+      index++
+    }
+  }
+
+  parse (argv: string[]): { flags: Flags<S>; unknown: string[] } {
+    const flags = {} as Flags<S>
+    const notFound: Set<string> = new Set(this.names)
+    const unknown: string[] = []
+
+    for (let i = 0; i < argv.length; i++) {
+      const a = argv[i]!
+
+      if (a === '--') {
+        break
+      }
+
+      if (a.startsWith('--')) {
+        const eq = a.indexOf('=')
+        const name = eq === -1 ? a.slice(2) : a.slice(2, eq)
+        const flag = this.byLong.get(name)
+
+        if (!flag) {
+          unknown.push(a)
+          continue
+        }
+
+        notFound.delete(name)
+        const value = eq === -1 ? undefined : a.slice(eq + 1)
+        const raw = value ?? argv[i + 1]
+
+        if (value === undefined) {
+          const { value: resolved, usedValue } = flag.resolveValue(raw)
+          flags[flag.long as keyof Flags<S>] = resolved as any
+          if (usedValue) i++
+        } else {
+          const resolved = flag.resolveValue(value)
+          flags[flag.long as keyof Flags<S>] = resolved.value as any
+        }
+      } else if (a.startsWith('-') && a !== '-') {
+        const eq = a.indexOf('=')
+        const name = eq === -1 ? a.slice(1) : a.slice(1, eq)
+        const flag = this.byShort.get(name)
+
+        if (!flag) {
+          unknown.push(a)
+          continue
+        }
+
+        notFound.delete(name)
+        const value = eq === -1 ? undefined : a.slice(eq + 1)
+        const raw = value ?? argv[i + 1]
+
+        if (value === undefined) {
+          const { value: resolved, usedValue } = flag.resolveValue(raw)
+          flags[flag.long as keyof Flags<S>] = resolved as any
+          if (usedValue) i++
+        } else {
+          const resolved = flag.resolveValue(value)
+          flags[flag.long as keyof Flags<S>] = resolved.value as any
+        }
+      }
+    }
+
+    for (const name of notFound) {
+      const flag = this.byLong.get(name)!
+      if (flag.default !== undefined) {
+        flags[flag.long as keyof Flags<S>] = flag.default as any
+      } else if (flag.kind === 'boolean') {
+        flags[flag.long as keyof Flags<S>] = false as any
+      } else {
+        throw new Error(`Missing required flag --${flag.long}`)
+      }
+    }
+
+    return { flags, unknown }
+  }
+}

package/src/StringFlag.ts

@@ -0,0 +1,20 @@
+import { FlagSchema } from "./FlagSchema"
+import type { FlagDefinition } from "./types"
+
+export class StringFlag<
+  D extends string | undefined = string | undefined
+> extends FlagSchema<'string', D> {
+  constructor (options: Omit<FlagDefinition<'string', D>, 'kind'>) {
+    super({ ...options, kind: 'string' })
+  }
+
+  resolveValue (raw: string | undefined): { value: string; usedValue: boolean } {
+    if (raw === undefined) {
+      if (this.default !== undefined)
+        return { value: this.default, usedValue: false }
+      throw new Error(`Missing value for --${this.long}`)
+    }
+
+    return { value: raw, usedValue: true }
+  }
+}

package/src/TerminalColor.ts

@@ -0,0 +1,70 @@
+
+export class TerminalColor {
+  static red (text: string) {
+    return `\x1b[38;5;196m${text}\x1b[0m`
+  }
+
+  static green (text: string) {
+    return `\x1b[38;5;47m${text}\x1b[0m`
+  }
+
+  static yellow (text: string) {
+    return `\x1b[38;5;226m${text}\x1b[0m`
+  }
+
+  static blue (text: string) {
+    return `\x1b[38;5;27m${text}\x1b[0m`
+  }
+
+  static magenta (text: string) {
+    return `\x1b[38;5;200m${text}\x1b[0m`
+  }
+
+  static cyan (text: string) {
+    return `\x1b[38;5;51m${text}\x1b[0m`
+  }
+
+  static purple (text: string) {
+    return `\x1b[38;5;141m${text}\x1b[0m`
+  }
+
+  static gray (text: string) {
+    return `\x1b[38;5;245m${text}\x1b[0m`
+  }
+
+  static bold (text: string) {
+    return `\x1b[1m${text}\x1b[0m`
+  }
+
+  static backgroundRed (text: string) {
+    return `\x1b[48;5;196m${text}\x1b[0m`
+  }
+
+  static backgroundGreen (text: string) {
+    return `\x1b[48;5;47m${text}\x1b[0m`
+  }
+  
+  static backgroundYellow (text: string) {
+    return `\x1b[48;5;226m${text}\x1b[0m`
+  }
+
+  static backgroundBlue (text: string) {
+    return `\x1b[48;5;27m${text}\x1b[0m`
+  }
+  
+  static backgroundMagenta (text: string) {
+    return `\x1b[48;5;200m${text}\x1b[0m`
+  }
+
+  static backgroundCyan (text: string) {
+    return `\x1b[48;5;51m${text}\x1b[0m`
+  }
+
+  static backgroundPurple (text: string) {
+    return `\x1b[48;5;141m${text}\x1b[0m`
+  }
+
+  static backgroundGray (text: string) {
+    return `\x1b[48;5;245m${text}\x1b[0m`
+  }
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+
+export * from './Cli'
+export * from './Schema'
+export * from './types'
+export * from './TerminalColor'
+export * from './BooleanFlag'
+export * from './StringFlag'
+export * from './NumberFlag'
+export * from './FlagSchema'

package/src/types.ts

@@ -0,0 +1,50 @@
+import type { FlagSchema } from "./FlagSchema"
+
+export type TypeFlag<T extends 'boolean' | 'string' | 'number'> = T extends 'boolean'
+  ? boolean
+  : T extends 'string'
+  ? string
+  : T extends 'number'
+  ? number
+  : never
+
+export type FlagKind = 'boolean' | 'string' | 'number'
+
+export type FlagDefinition<
+  T extends FlagKind,
+  D extends TypeFlag<T> | undefined = TypeFlag<T> | undefined
+> = {
+  kind: T
+  short?: string
+  description: string
+  default: D
+}
+
+export type ShouldRequire<T extends FlagDefinition<FlagKind>> =
+  T['default'] extends undefined
+    ? T['kind'] extends 'boolean'
+      ? true
+      : false
+    : true
+
+export type Flags<S extends SchemaOptions> = {
+  [K in keyof S as ShouldRequire<S[K]> extends true ? K : never]: TypeFlag<
+    S[K]['kind']
+  >
+} & {
+  [K in keyof S as ShouldRequire<S[K]> extends false ? K : never]?: TypeFlag<
+    S[K]['kind']
+  >
+}
+
+export interface SchemaOptions {
+  [key: string]: FlagSchema
+}
+
+export type CommandCtx<S extends SchemaOptions = SchemaOptions> = {
+  argv: string[]
+  flags: Flags<S>
+  stdout: NodeJS.WriteStream
+  stderr: NodeJS.WriteStream
+  exit: (code: number) => never
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@voryx/tsconfig/nodelib.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}