@briklab/lib 1.2.1-test → 1.3.1

package/README.md

@@ -6,6 +6,23 @@
 - **@briklab/cli-john:** Generate a [CLI](https://en.wikipedia.org/wiki/Command-line_interface) with ease.
 - **@briklab/jstc:** Add Type Checking for JavaScript.
 
+## Exports
+
+The root package export currently exposes warning utilities:
+
+```ts
+import { warner, createWarner, Warner } from "@briklab/lib";
+```
+
+Other modules are exposed through subpath imports:
+
+```ts
+import JSTC from "@briklab/lib/jstc";
+import Color from "@briklab/lib/color";
+import InlineStyle, { StyleSheet } from "@briklab/lib/stylesheet";
+import { CLI } from "@briklab/lib/cli-john";
+```
+
 ## Installation
 Normally, the format is:
 ```bash
@@ -13,4 +30,4 @@ Normally, the format is:
 ```
 **Examples:**
 - **pnpm:**`pnpm add @briklab/lib`
-- **npm:**`npm i @briklab/lib`
+- **npm:**`npm i @briklab/lib`

package/dist/cli-john/index.d.ts

@@ -52,6 +52,7 @@
  *
  * @module cli-john
  */
+import { type ProtectionLevel } from "../jstc/index.js";
 import InlineStyle, { StyleSheet } from "../stylesheet/index.js";
 /**
  * # CLI
@@ -67,15 +68,21 @@ export declare class CLI {
     /**
      * ## CLI: Constructor
      * @param {NodeJS.Process} process - **The main process**
+     * @param {Object} options - Optional configuration
+     * @param {WarningLevel} options.warningLevel - Warning display level: 'silent', 'summary', or 'full'
+     * @param {ProtectionLevel} options.protectionLevel - Protection level for input validation
      * @constructor
      * @constructs CLI
      * @example
      * import * as process from "node:process"
      * import {CLI} from "@briklab/lib/cli-john"
-     * const cli = new CLI(process)
+     * const cli = new CLI(process, { warningLevel: "full", protectionLevel: "hardened" })
      * cli.run()
      */
-    constructor(process: NodeJS.Process);
+    constructor(process: NodeJS.Process, options?: {
+        warningLevel?: "silent" | "summary" | "full";
+        protectionLevel?: ProtectionLevel;
+    });
     /**
      * ### CLI.command
      * create a new command in a CLI.
@@ -83,7 +90,14 @@ export declare class CLI {
      * @param {string} name
      */
     command(name: string): CLI.Command;
-    on(event: CLI.ValidEvent, func: Function): void;
+    on(event: CLI.ValidEvent, func: ({ commandArgs, command, options, }: {
+        commandArgs: string[];
+        command: string;
+        options: {
+            arguments: string[];
+            optionName: string;
+        }[];
+    }) => any): void;
     run(): void;
 }
 export declare namespace CLI {
@@ -100,7 +114,17 @@ export declare namespace CLI {
          * @param name The name of the command
          * @constructor
          */
-        constructor(name: string);
+        constructor(name: string, commandcreatorfunction: Function);
+        /**
+         * What to do when an specific event happens
+         */
+        on(event: CLI.ValidEvent, func: ({ commandArgs, options, }: {
+            commandArgs: string[];
+            options: {
+                arguments: string[];
+                optionName: string;
+            }[];
+        }) => any): void;
         /**
          * The name of the Command
          * @returns {string}
@@ -110,8 +134,9 @@ export declare namespace CLI {
          * the metadata of the Command
          * @returns {object}
          */
-        get metadata(): Object;
+        metadata(): Object;
         option(name: string): Command.Option;
+        command(...args: any[]): void;
     }
 }
 export declare namespace CLI.Command {
@@ -121,11 +146,24 @@ export declare namespace CLI.Command {
      */
     class Option {
         #private;
+        constructor(name: string, optioncreatorfunc: Function, commandcreatorfunction: Function);
+        get name(): string;
         get metadata(): {
             name: string;
+            onCmdFunctions: Function[];
         };
-        constructor(name: string);
-        get name(): string;
+        /**
+         * What to do when an specific event happens for this option
+         */
+        on(event: CLI.ValidEvent, func: ({ commandArgs, options, }: {
+            commandArgs: string[];
+            options: {
+                arguments: string[];
+                optionName: string;
+            }[];
+        }) => any): void;
+        command(...args: any[]): void;
+        option(...args: any[]): void;
     }
 }
 declare class UtilitiesClass {

package/dist/cli-john/index.js

@@ -1,459 +1,19 @@
-/**
- * @packageDocumentation
- *
- * # CLI John
- *
- * **CLI John** is a **Node.js CLI framework** designed to create **fully functional CLIs** quickly.
- * It hooks into a given NodeJS process, automatically listens for commands, parses arguments,
- * and allows beautiful console messages. Its design is **modular**, using Commands and Options as sub-classes.
- *
- * ## Features
- * - Auto-listening to commands
- * - Command parsing
- * - Beautiful console messages
- * - One CLI per file
- * - Add your file to `bin` in package.json → CLI works seamlessly
- * - Event-driven command handling
- *
- * ## Usage
- * ```ts
- * import { CLI as CLI } from "@briklab/lib/cli-john"
- * import * as process from "node:process"
- *
- * const cli = new CLI(process);
- *
- * const cmd = cli.command("myCommand");
- * const opt = cmd.option("force");
- *
- * cmd.on("run", ({commandArgs}) => {
- *   CJ.notice("Hey, this is my CLI!");
- *   CJ.message("Do you like it?");
- *   CJ.error("Invalid args:", ...commandArgs.map(a => a.name));
- * });
- *
- * cli.run();
- * ```
- *
- * ## Limitations
- * - Only **one CLI per file** is allowed (CLI enforces this)
- * - CLI file must be manually added to `bin` in package.json
- *
- * ## Hierarchy
- * ```
- * CLI
- * ├─ Command
- * │   └─ Option
- * └─ CLIErrors
- * ```
- *
- * ## Error Handling
- * - All errors are instances of `CLIErrors`
- * - Dynamic names allow easy identification of which part of the CLI threw the error
- *
- * @module cli-john
- */
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var _CLI_instances, _CLI_commands, _CLI_onCmdFunctions, _CLI_figureOutCommand, _CLI_process, _CLI_ErrorClass, _CLI_createErr, _CLI_createWarn;
-// -------------------------------------------------------------------------------------------------------
-//#region Defination of custom JSTC handler
-import JSTC from "../jstc/index.js";
-import InlineStyle, { StyleSheet } from "../stylesheet/index.js";
-import Color from "../color/index.js";
-import { warner } from "../warner/index.js";
-JSTC.addCustomHandler("NodeJS Process", (p) => {
-    return (p &&
-        typeof p === "object" &&
-        typeof p.pid === "number" &&
-        typeof p.cwd === "function" &&
-        typeof p.exit === "function");
-});
-//#endregion
-// -------------------------------------------------------------------------------------------------------
-//#region The Main Class
-/**
- * # CLI
- * @classdesc The main class for **CLI**.
- * @example
- * import * as process from "node:process"
- * import {CLI} from "@briklab/lib/cli-john"
- * const cli = new CLI(process)
- * cli.run()
- */
-export class CLI {
-    /**
-     * ## CLI: Constructor
-     * @param {NodeJS.Process} process - **The main process**
-     * @constructor
-     * @constructs CLI
-     * @example
-     * import * as process from "node:process"
-     * import {CLI} from "@briklab/lib/cli-john"
-     * const cli = new CLI(process)
-     * cli.run()
-     */
-    constructor(process) {
-        _CLI_instances.add(this);
-        _CLI_commands.set(this, []);
-        _CLI_onCmdFunctions.set(this, []);
-        _CLI_process.set(this, void 0);
-        _CLI_ErrorClass.set(this, class extends CLIErrors {
-            constructor(message) {
-                super(message);
-                this.setName = "CLI";
-            }
-        });
-        if (!JSTC.for([process]).check(["NodeJS Process"])) {
-            throw __classPrivateFieldGet(this, _CLI_instances, "m", _CLI_createErr).call(this, "Invalid First Argument!", "You must pass a valid NodeJS process (imported from node:process) while constructing a CLI Class!");
-        }
-        __classPrivateFieldSet(this, _CLI_process, process, "f");
-    }
-    /**
-     * ### CLI.command
-     * create a new command in a CLI.
-     *
-     * @param {string} name
-     */
-    command(name) {
-        if (!JSTC.for([name]).check(["string"])) {
-            __classPrivateFieldGet(this, _CLI_instances, "m", _CLI_createWarn).call(this, "Invalid First Argument!", "CLI.option expects a string as the first argument.", "Using String(given argument) as fallback.");
-            name = String(name);
-        }
-        let c = new CLI.Command(name);
-        let f = __classPrivateFieldGet(this, _CLI_commands, "f").findIndex((a) => a.name === name);
-        if (f !== -1)
-            __classPrivateFieldGet(this, _CLI_commands, "f")[f] = c;
-        else
-            __classPrivateFieldGet(this, _CLI_commands, "f").push(c);
-        return c;
-    }
-    on(event, func) {
-        if (!JSTC.for([event, func]).check(["string", "function"]))
-            throw __classPrivateFieldGet(this, _CLI_instances, "m", _CLI_createErr).call(this, "Arguments in CLI.on are invalid!", "The first argument must be a string, and the second argument must be a function.");
-        switch (event.toLowerCase()) {
-            case "command":
-                __classPrivateFieldGet(this, _CLI_onCmdFunctions, "f").push(func);
-                break;
-            default:
-                __classPrivateFieldGet(this, _CLI_instances, "m", _CLI_createWarn).call(this, "Invalid event in CLI.on", "Please enter a valid event from CLI.ValidEvents (array)");
-        }
-    }
-    run() {
-        let { options, commandArgs, command, failed } = __classPrivateFieldGet(this, _CLI_instances, "m", _CLI_figureOutCommand).call(this);
-        if (failed)
-            return;
-        for (let i = 0; i < __classPrivateFieldGet(this, _CLI_onCmdFunctions, "f").length; i++) {
-            __classPrivateFieldGet(this, _CLI_onCmdFunctions, "f")[i]({ options, commandArgs, command });
-        }
-        warner.flush();
-    }
-}
-_CLI_commands = new WeakMap(), _CLI_onCmdFunctions = new WeakMap(), _CLI_process = new WeakMap(), _CLI_ErrorClass = new WeakMap(), _CLI_instances = new WeakSet(), _CLI_figureOutCommand = function _CLI_figureOutCommand() {
-    // for eg. we have nodepath filepath cli build
-    let [, , ...commands] = __classPrivateFieldGet(this, _CLI_process, "f").argv; // now its cli build. clear
-    if (commands.length === 0)
-        return { options: [], command: "", commandArgs: [], failed: true };
-    let command = __classPrivateFieldGet(this, _CLI_commands, "f").find((a) => a.name === commands[0]); // find the command
-    if (!command)
-        return { options: [], command: "", commandArgs: [], failed: true }; // command not found?
-    let commandArgs = [];
-    const args = commands.slice(1);
-    for (let i = 0; i < args.length; i++) {
-        let arg = args[i];
-        if (arg.startsWith("--"))
-            break;
-        commandArgs.push(arg);
-    }
-    let leftover = args.slice(commandArgs.length); // args = [1,2,3]; command args = [1,2] command args length is 2, therefore .slice(2) results in [3]
-    let options = [];
-    for (let i = 0; i < leftover.length; i++) {
-        const opt = leftover[i];
-        if (!opt.startsWith("--"))
-            continue;
-        const values = [];
-        for (let j = i + 1; j < leftover.length; j++) {
-            if (leftover[j].startsWith("--"))
-                break;
-            values.push(leftover[j]);
-        }
-        options.push({ option: opt, arguments: values });
-    }
-    return {
-        options,
-        commandArgs,
-        command,
-        failed: false,
-    };
-}, _CLI_createErr = function _CLI_createErr(message, hint) {
-    return new (__classPrivateFieldGet(this, _CLI_ErrorClass, "f"))(`${message}
-        Hint: ${hint}`);
-}, _CLI_createWarn = function _CLI_createWarn(message, hint, otherMessage) {
-    warner.warn({ message: `[Class CLI] ${message}
-        Hint: ${hint}
-        ${otherMessage}` });
-    return;
-};
-//#endregion
-// -------------------------------------------------------------------------------------------------------
-//#region Error Class
-class CLIErrors extends Error {
-    constructor(message) {
-        super(message);
-        this.name = `[] @briklab/lib/cli-john`;
-        Error.captureStackTrace(this, CLIErrors);
-    }
-    set setName(name) {
-        this.name = `[${name}] @briklab/lib/cli-john`;
-    }
-}
-(function (CLI) {
-    var _Command_instances, _Command_name, _Command_createWarn, _Command_options;
-    CLI.ValidEvents = ["command"];
-    /**
-     * ## CLI.Command
-     * A command in a CLI Command
-     */
-    class Command {
-        /**
-         * ### Command Constructor
-         * @param name The name of the command
-         * @constructor
-         */
-        constructor(name) {
-            _Command_instances.add(this);
-            _Command_name.set(this, void 0);
-            _Command_options.set(this, []);
-            __classPrivateFieldSet(this, _Command_name, name, "f");
-            return this;
-        }
-        /**
-         * The name of the Command
-         * @returns {string}
-         */
-        get name() {
-            return __classPrivateFieldGet(this, _Command_name, "f");
-        }
-        /**
-         * the metadata of the Command
-         * @returns {object}
-         */
-        get metadata() {
-            let metadata = {
-                options: __classPrivateFieldGet(this, _Command_options, "f").map((a) => a.metadata),
-                name: this.name,
-            };
-            return metadata;
-        }
-        option(name) {
-            if (!JSTC.for([name]).check(["string"])) {
-                __classPrivateFieldGet(this, _Command_instances, "m", _Command_createWarn).call(this, "First argument is invalid!", "The first argument must be a string", "Using String(argument) as fallback");
-                name = String(name);
-            }
-            let o = new CLI.Command.Option(name);
-            let f = __classPrivateFieldGet(this, _Command_options, "f").findIndex((a) => a.name === name);
-            if (f !== -1)
-                __classPrivateFieldGet(this, _Command_options, "f")[f] = o;
-            else
-                __classPrivateFieldGet(this, _Command_options, "f").push(o);
-            return o;
-        }
-    }
-    _Command_name = new WeakMap(), _Command_options = new WeakMap(), _Command_instances = new WeakSet(), _Command_createWarn = function _Command_createWarn(message, hint, otherMessage) {
-        warner.warn({ message: `[Class CLI.Command] ${message}
-        Hint: ${hint}
-        ${otherMessage}` });
-        return;
-    };
-    CLI.Command = Command;
-})(CLI || (CLI = {}));
-//#endregion
-// -------------------------------------------------------------------------------------------------------
-//#region CLI.Command.Option
-(function (CLI) {
-    var Command;
-    (function (Command) {
-        var _Option_name;
-        /**
-         * ## CLI.Command.Option
-         * A option for a CLI.Command
-         */
-        class Option {
-            get metadata() {
-                let metadata = {
-                    name: `${__classPrivateFieldGet(this, _Option_name, "f")}`, // <-- Templates TO NOT reference the actual variable
-                };
-                return metadata;
-            }
-            constructor(name) {
-                _Option_name.set(this, void 0);
-                __classPrivateFieldSet(this, _Option_name, name, "f");
-                return this;
-            }
-            get name() {
-                return __classPrivateFieldGet(this, _Option_name, "f");
-            }
-        }
-        _Option_name = new WeakMap();
-        Command.Option = Option;
-    })(Command = CLI.Command || (CLI.Command = {}));
-})(CLI || (CLI = {}));
-//#endregion
-// -------------------------------------------------------------------------------------------------------
-//#region CLI Utilities
-JSTC.addCustomHandler("Utilities Tag Config", (p) => {
-    return (p &&
-        typeof p === "object" &&
-        typeof p.tag === "string" &&
-        typeof p.showErrorInTag === "boolean" &&
-        typeof p.paddingLeft === "number" &&
-        typeof p.paddingRight === "number" &&
-        (typeof p.styleName === "string" || p.styleName === undefined));
-});
-class UtilitiesClass {
-    constructor() {
-        this.styleSheet = new StyleSheet();
-        this.tags = {};
-        this.addTag("error", {
-            tag: "ERROR",
-            showErrorInTag: false,
-            paddingLeft: 0,
-            paddingRight: 0,
-        });
-        this.addTag("warning", {
-            tag: "WARNING",
-            showErrorInTag: true,
-            paddingLeft: 0,
-            paddingRight: 0,
-        });
-        this.addTag("info", {
-            tag: "INFO",
-            showErrorInTag: true,
-            paddingLeft: 0,
-            paddingRight: 0,
-        });
-        this.setTagStyle("error", new InlineStyle({ color: "red", fontWeight: "bold" }));
-        this.setTagStyle("warning", new InlineStyle({ color: "orange", fontWeight: "bold" }));
-        this.setTagStyle("info", new InlineStyle({ color: "blue" }));
-    }
-    /** Add a new tag */
-    addTag(name, config = {}) {
-        if (!JSTC.for([name, config]).check(["string", "object"])) {
-            warner.warn({ message: `[UtilitiesClass.addTag] @briklab/lib/cli-john: Invalid Arguments!
-        Hint: The first argument must be a string, and the second argument must be a object.
-        Using String(argument1) and {} as fallback.` });
-            name = String(name);
-            config = {};
-        }
-        const fullConfig = {
-            tag: name.toUpperCase(),
-            showErrorInTag: false,
-            paddingLeft: 0,
-            paddingRight: 0,
-            styleName: "",
-            ...config,
-        };
-        if (!JSTC.for([fullConfig]).check(["Utilities Tag Config"])) {
-            warner.warn({ message: `[UtilitiesClass.addTag] @briklab/lib/cli-john: Invalid tag config passed for "${name}"
-        Hint: The config must be in format {tag?: string, showErrorInTag?:boolean, paddingLeft?:number, paddingRight?:number, styleName?:string}` });
-            warner.warn({ message: JSON.stringify(fullConfig, null, 2) });
-            return this;
-        }
-        this.tags[name] = fullConfig;
-        return this;
-    }
-    /** Set style for a tag */
-    setTagStyle(tagName, style) {
-        if (typeof tagName !== "string" || !(style instanceof InlineStyle)) {
-            warner.warn({ message: `[UtilitiesClass.setTagStyle] @briklab/lib/cli-john: Invalid arguments!
-        Hint: The first argument must be a string and the second argument must be a instance of InlineStyle
-        Using String(firstArgument) and new InlineStyle({}) as fallback` });
-            tagName = String(tagName);
-            style = new InlineStyle({});
-        }
-        if (!this.tags[tagName]) {
-            warner.warn({ message: `[UtilitiesClass.setTagStyle] @briklab/lib/cli-john: Tag "${tagName}" does not exist! 
-        Hint: Use a valid tag that you have defined or use "error"|"warn"|"info"` });
-            return this;
-        }
-        const styleName = `${tagName} Tag Color`;
-        this.styleSheet.set(styleName, style);
-        this.tags[tagName].styleName = styleName;
-        return this;
-    }
-    log(tagName, ...messages) {
-        if (!JSTC.for([tagName]).check(["string"])) {
-            warner.warn({ message: `[UtilitiesClass.log] @briklab/lib/cli-john: Invalid Arguments!
-        Hint: The first argument must be a string
-        Using String(argument1) as fallback` });
-            tagName = String(tagName);
-        }
-        if (!messages || messages.length === 0)
-            messages = [""];
-        const tag = this.tags[tagName];
-        if (!tag) {
-            warner.warn({ message: `[UtilitiesClass.log] @briklab/lib/cli-john: Tag "${tagName}" does not exist! 
-        Hint: Use a valid tag that you have defined or use "error"|"warn"|"info"` });
-            console.log(...messages);
-            return;
-        }
-        const inlineStyle = this.styleSheet.get(tag.styleName);
-        const style = inlineStyle?.text ?? "";
-        const leftPad = " ".repeat(tag.paddingLeft);
-        const rightPad = " ".repeat(tag.paddingRight);
-        const isNodeTTY = typeof process !== "undefined" &&
-            typeof process.stdout !== "undefined" &&
-            Boolean(process.stdout.isTTY);
-        if (isNodeTTY) {
-            const ansi = inlineStyle?.ansi ?? "";
-            const reset = Color.RESET;
-            if (tag.showErrorInTag) {
-                console.log("[" + ansi + leftPad + tag.tag + rightPad + reset + "]:", ...messages);
-            }
-            else {
-                console.log(ansi + "[" + leftPad + tag.tag + rightPad + "]" + reset + ":", ...messages);
-            }
-        }
-        else {
-            if (tag.showErrorInTag) {
-                console.log(`[%c${leftPad}${tag.tag}${rightPad}%c]:`, style, ...messages);
-            }
-            else {
-                console.log(`%c[${leftPad}${tag.tag}${rightPad}]%c:`, style, ...messages);
-            }
-        }
-    }
-    error(...msg) {
-        if (!msg || msg.length === 0)
-            msg = [""];
-        this.log("error", ...msg);
-        return this;
-    }
-    warning(...msg) {
-        if (!msg || msg.length === 0)
-            msg = [""];
-        this.log("warning", ...msg);
-        return this;
-    }
-    info(...msg) {
-        if (!msg || msg.length === 0)
-            msg = [""];
-        this.log("info", ...msg);
-        return this;
-    }
-}
-export const Utilities = new UtilitiesClass();
-//#endregion
-// -------------------------------------------------------------------------------------------------------
-//#region TODO
-// TODO: Wire Options to Commands
-// TODO: Create metadata getter-s in both commands and options
-//#endregion
+var i=function(a,t,e,n){if(e==="a"&&!n)throw new TypeError("Private accessor was defined without a getter");if(typeof t=="function"?a!==t||!n:!t.has(a))throw new TypeError("Cannot read private member from an object whose class did not declare it");return e==="m"?n:e==="a"?n.call(a):n?n.value:t.get(a)},w=function(a,t,e,n,o){if(n==="m")throw new TypeError("Private method is not writable");if(n==="a"&&!o)throw new TypeError("Private accessor was defined without a setter");if(typeof t=="function"?a!==t||!o:!t.has(a))throw new TypeError("Cannot write private member to an object whose class did not declare it");return n==="a"?o.call(a,e):o?o.value=e:t.set(a,e),e},b,S,_,I,O,L,E,W,$;import u from"../jstc/index.js";import y,{StyleSheet as j}from"../stylesheet/index.js";import M from"../color/index.js";import{createWarner as P}from"../warner/index.js";const g=P("@briklab/lib/cli-john");u.addCustomHandler("NodeJS Process",a=>a&&typeof a=="object"&&typeof a.pid=="number"&&typeof a.cwd=="function"&&typeof a.exit=="function");class v{constructor(t,e){if(b.add(this),S.set(this,"boundary"),_.set(this,[]),I.set(this,[]),L.set(this,void 0),E.set(this,class extends T{constructor(n){super(n),this.setName="CLI"}}),!u.for([t]).check(["NodeJS Process"]))throw i(this,b,"m",W).call(this,"Invalid First Argument!","You must pass a valid NodeJS process (imported from node:process) while constructing a CLI Class!");w(this,L,t,"f"),w(this,S,e?.protectionLevel??"boundary","f"),e?.warningLevel&&g.setLevel(e.warningLevel),e?.protectionLevel&&(u.setProtectionLevel(e.protectionLevel),g.setProtectionLevel(e.protectionLevel))}command(t){u.for([t]).check(["string"])||(i(this,b,"m",$).call(this,"Invalid First Argument!","CLI.option expects a string as the first argument.","Using String(given argument) as fallback."),t=String(t));let e=new v.Command(t,this.command.bind(this)),n=i(this,_,"f").findIndex(o=>o.name===t);return n!==-1?i(this,_,"f")[n]=e:i(this,_,"f").push(e),e}on(t,e){if(!u.for([t,e]).check(["string","function"]))throw i(this,b,"m",W).call(this,"Arguments in CLI.on are invalid!","The first argument must be a string, and the second argument must be a function.");t.toLowerCase()==="command"?i(this,I,"f").push(e):i(this,b,"m",$).call(this,"Invalid event in CLI.on","Please enter a valid event from CLI.ValidEvents (array)")}run(){let{options:t,commandArgs:e,command:n,failed:o}=i(this,b,"m",O).call(this);if(o)return;for(let r=0;r<i(this,I,"f").length;r++)i(this,I,"f")[r]({options:t,commandArgs:e,command:n});let c=i(this,_,"f").find(r=>r.name===n);if(!c)return;const s=c?.metadata()?.onCmdFunctions??[];for(let r=0;r<s.length;r++)s[r]({options:t,commandArgs:e});g.flush()}}S=new WeakMap,_=new WeakMap,I=new WeakMap,L=new WeakMap,E=new WeakMap,b=new WeakSet,O=function(){let[,,...t]=i(this,L,"f").argv;if(t.length===0)return{options:[],command:"",commandArgs:[],failed:!0};let e=i(this,_,"f").find(s=>s.name===t[0]);if(!e)return{options:[],command:"",commandArgs:[],failed:!0};let n=[];const o=t.slice(1);for(let s=0;s<o.length;s++){let r=o[s];if(r.startsWith("--"))break;n.push(r)}let c=o.slice(n.length),h=[];for(let s=0;s<c.length;s++){const r=c[s];if(!r.startsWith("--"))continue;const p=[];for(let f=s+1;f<c.length&&!c[f].startsWith("--");f++)p.push(c[f]);h.push({option:r,arguments:p})}return{options:h,commandArgs:n,command:e,failed:!1}},W=function(t,e){return new(i(this,E,"f"))(`${t}
+        Hint: ${e}`)},$=function(t,e,n){g.warn({message:`[Class CLI] ${t}
+        Hint: ${e}
+        ${n}`})};class T extends Error{constructor(t){super(t),this.name="[] @briklab/lib/cli-john",Error.captureStackTrace(this,T)}set setName(t){this.name=`[${t}] @briklab/lib/cli-john`}}(function(a){var t,e,n,o,c,h,s,r;a.ValidEvents=["command"];class p{constructor(d,m){return t.add(this),e.set(this,void 0),n.set(this,void 0),o.set(this,class extends T{constructor(l){super(l),this.setName="CLI.Command"}}),h.set(this,[]),r.set(this,[]),w(this,e,d,"f"),w(this,n,m,"f"),this}on(d,m){if(!u.for([d,m]).check(["string","function"]))throw i(this,t,"m",c).call(this,"Arguments in CLI.Command.on are invalid!","The first argument must be a string, and the second argument must be a function.");d.toLowerCase()==="command"?i(this,h,"f").push(m):i(this,t,"m",s).call(this,"Invalid event in CLI.Command.on","Please enter a valid event from CLI.ValidEvents (array)")}get name(){return`${i(this,e,"f")}`}metadata(){return{options:i(this,r,"f").map(m=>m.metadata),name:`${this.name}`,onCmdFunctions:[...i(this,h,"f")]}}option(d){u.for([d]).check(["string"])||(i(this,t,"m",s).call(this,"First argument is invalid!","The first argument must be a string","Using String(argument) as fallback"),d=String(d));let m=new a.Command.Option(d,this.option.bind(this),i(this,n,"f")),l=i(this,r,"f").findIndex(C=>C.name===d);return l!==-1?i(this,r,"f")[l]=m:i(this,r,"f").push(m),m}command(...d){i(this,n,"f").call(this,...d)}}e=new WeakMap,n=new WeakMap,o=new WeakMap,h=new WeakMap,r=new WeakMap,t=new WeakSet,c=function(d,m){return new(i(this,o,"f"))(`${d}
+        Hint: ${m}`)},s=function(d,m,l){g.warn({message:`[Class CLI.Command] ${d}
+        Hint: ${m}
+        ${l}`})},a.Command=p})(v||(v={})),(function(a){var t;(function(e){var n,o,c,h,s,r,p,f;class d{constructor(l,C,k){return n.add(this),o.set(this,void 0),c.set(this,void 0),h.set(this,void 0),s.set(this,[]),r.set(this,class extends T{constructor(U){super(U),this.setName="CLI.Command.Option"}}),w(this,o,l,"f"),w(this,c,C,"f"),w(this,h,k,"f"),this}get name(){return i(this,o,"f")}get metadata(){return{name:`${i(this,o,"f")}`,onCmdFunctions:[...i(this,s,"f")]}}on(l,C){if(!u.for([l,C]).check(["string","function"]))throw i(this,n,"m",p).call(this,"Arguments in CLI.Command.Option.on are invalid!","The first argument must be a string, and the second argument must be a function.");l.toLowerCase()==="command"?i(this,s,"f").push(C):i(this,n,"m",f).call(this,"Invalid event in CLI.Command.Option.on","Please enter a valid event from CLI.ValidEvents (array)")}command(...l){i(this,h,"f").call(this,...l)}option(...l){i(this,c,"f").call(this,...l)}}o=new WeakMap,c=new WeakMap,h=new WeakMap,s=new WeakMap,r=new WeakMap,n=new WeakSet,p=function(l,C){return new(i(this,r,"f"))(`${l}
+        Hint: ${C}`)},f=function(l,C,k){g.warn({message:`[Class CLI.Command.Option] ${l}
+        Hint: ${C}
+        ${k}`})},e.Option=d})(t=a.Command||(a.Command={}))})(v||(v={})),u.addCustomHandler("Utilities Tag Config",a=>a&&typeof a=="object"&&typeof a.tag=="string"&&typeof a.showErrorInTag=="boolean"&&typeof a.paddingLeft=="number"&&typeof a.paddingRight=="number"&&(typeof a.styleName=="string"||a.styleName===void 0));class F{constructor(){this.styleSheet=new j,this.tags={},this.addTag("error",{tag:"ERROR",showErrorInTag:!1,paddingLeft:0,paddingRight:0}),this.addTag("warning",{tag:"WARNING",showErrorInTag:!0,paddingLeft:0,paddingRight:0}),this.addTag("info",{tag:"INFO",showErrorInTag:!0,paddingLeft:0,paddingRight:0}),this.setTagStyle("error",new y({color:"red",fontWeight:"bold"})),this.setTagStyle("warning",new y({color:"orange",fontWeight:"bold"})),this.setTagStyle("info",new y({color:"blue"}))}addTag(t,e={}){u.for([t,e]).check(["string","object"])||(g.warn({message:`[UtilitiesClass.addTag] @briklab/lib/cli-john: Invalid Arguments!
+        Hint: The first argument must be a string, and the second argument must be a object.
+        Using String(argument1) and {} as fallback.`}),t=String(t),e={});const n={tag:t.toUpperCase(),showErrorInTag:!1,paddingLeft:0,paddingRight:0,styleName:"",...e};return u.for([n]).check(["Utilities Tag Config"])?(this.tags[t]=n,this):(g.warn({message:`[UtilitiesClass.addTag] @briklab/lib/cli-john: Invalid tag config passed for "${t}"
+        Hint: The config must be in format {tag?: string, showErrorInTag?:boolean, paddingLeft?:number, paddingRight?:number, styleName?:string}`}),g.warn({message:JSON.stringify(n,null,2)}),this)}setTagStyle(t,e){if((typeof t!="string"||!(e instanceof y))&&(g.warn({message:`[UtilitiesClass.setTagStyle] @briklab/lib/cli-john: Invalid arguments!
+        Hint: The first argument must be a string and the second argument must be a instance of InlineStyle
+        Using String(firstArgument) and new InlineStyle({}) as fallback`}),t=String(t),e=new y({})),!this.tags[t])return g.warn({message:`[UtilitiesClass.setTagStyle] @briklab/lib/cli-john: Tag "${t}" does not exist! 
+        Hint: Use a valid tag that you have defined or use "error"|"warn"|"info"`}),this;const n=`${t} Tag Color`;return this.styleSheet.set(n,e),this.tags[t].styleName=n,this}log(t,...e){u.for([t]).check(["string"])||(g.warn({message:`[UtilitiesClass.log] @briklab/lib/cli-john: Invalid Arguments!
+        Hint: The first argument must be a string
+        Using String(argument1) as fallback`}),t=String(t)),(!e||e.length===0)&&(e=[""]);const n=this.tags[t];if(!n){g.warn({message:`[UtilitiesClass.log] @briklab/lib/cli-john: Tag "${t}" does not exist! 
+        Hint: Use a valid tag that you have defined or use "error"|"warn"|"info"`}),console.log(...e);return}const o=this.styleSheet.get(n.styleName),c=o?.text??"",h=" ".repeat(n.paddingLeft),s=" ".repeat(n.paddingRight);if(typeof process<"u"&&typeof process.stdout<"u"&&!!process.stdout.isTTY){const p=o?.ansi??"",f=M.RESET;n.showErrorInTag?console.log("["+p+h+n.tag+s+f+"]:",...e):console.log(p+"["+h+n.tag+s+"]"+f+":",...e)}else n.showErrorInTag?console.log(`[%c${h}${n.tag}${s}%c]:`,c,...e):console.log(`%c[${h}${n.tag}${s}]%c:`,c,...e)}error(...t){return(!t||t.length===0)&&(t=[""]),this.log("error",...t),this}warning(...t){return(!t||t.length===0)&&(t=[""]),this.log("warning",...t),this}info(...t){return(!t||t.length===0)&&(t=[""]),this.log("info",...t),this}}const N=new F;export{v as CLI,N as Utilities};