@decaf-ts/utils 0.4.1 → 0.4.3

package/dist/utils.cjs

@@ -1,4224 +1 @@
-(function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('prompts'), require('util'), require('@decaf-ts/logging'), require('fs'), require('path'), require('child_process'), require('styled-string-builder'), require('https'), require('rollup'), require('@rollup/plugin-typescript'), require('@rollup/plugin-commonjs'), require('@rollup/plugin-node-resolve'), require('@rollup/plugin-json'), require('module'), require('typescript')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'prompts', 'util', '@decaf-ts/logging', 'fs', 'path', 'child_process', 'styled-string-builder', 'https', 'rollup', '@rollup/plugin-typescript', '@rollup/plugin-commonjs', '@rollup/plugin-node-resolve', '@rollup/plugin-json', 'module', 'typescript'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.utils = {}, global.prompts, global.util, global.decafTsLogging, global.fs, global.path, global.childProcess, global.styledStringBuilder, global.https, global.rollup, global.rollupPluginTypescript, global.rollupPluginCommonjs, global.rollupPluginNodeResolve, global.rollupPluginJson, global.module, global.typescript));
-})(this, (function (exports, prompts, util, logging, fs, path, child_process, styledStringBuilder, https, rollup, typescript, commonjs, pluginNodeResolve, json, module, ts) { 'use strict';
-
-    function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-    function _interopNamespace(e) {
-        if (e && e.__esModule) return e;
-        var n = Object.create(null);
-        if (e) {
-            Object.keys(e).forEach(function (k) {
-                if (k !== 'default') {
-                    var d = Object.getOwnPropertyDescriptor(e, k);
-                    Object.defineProperty(n, k, d.get ? d : {
-                        enumerable: true,
-                        get: function () { return e[k]; }
-                    });
-                }
-            });
-        }
-        n["default"] = e;
-        return Object.freeze(n);
-    }
-
-    var prompts__default = /*#__PURE__*/_interopDefaultLegacy(prompts);
-    var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
-    var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
-    var https__default = /*#__PURE__*/_interopDefaultLegacy(https);
-    var typescript__default = /*#__PURE__*/_interopDefaultLegacy(typescript);
-    var commonjs__default = /*#__PURE__*/_interopDefaultLegacy(commonjs);
-    var json__default = /*#__PURE__*/_interopDefaultLegacy(json);
-    var ts__namespace = /*#__PURE__*/_interopNamespace(ts);
-
-    /**
-     * @description Represents a user input prompt with various configuration options.
-     * @summary This class provides a flexible interface for creating and managing user input prompts.
-     * It implements the PromptObject interface from the 'prompts' library and offers methods to set
-     * various properties of the prompt. The class also includes static methods for common input scenarios
-     * and argument parsing.
-     *
-     * @template R - The type of the prompt name, extending string.
-     *
-     * @param name - The name of the prompt, used as the key in the returned answers object.
-     *
-     * @class
-     * @example
-     * ```typescript
-     * import { UserInput } from '@decaf-ts/utils';
-     *
-     * // Create a simple text input
-     * const nameInput = new UserInput('name')
-     *   .setMessage('What is your name?')
-     *   .setInitial('User');
-     *
-     * // Create a number input with validation
-     * const ageInput = new UserInput('age')
-     *   .setType('number')
-     *   .setMessage('How old are you?')
-     *   .setMin(0)
-     *   .setMax(120);
-     *
-     * // Ask for input and process the results
-     * async function getUserInfo() {
-     *   const answers = await UserInput.ask([nameInput, ageInput]);
-     *   console.log(`Hello ${answers.name}, you are ${answers.age} years old.`);
-     * }
-     *
-     * getUserInfo();
-     * ```
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Client
-     *   participant UserInput
-     *   participant PromptLibrary
-     *
-     *   Client->>UserInput: new UserInput(name)
-     *   Client->>UserInput: setMessage(message)
-     *   Client->>UserInput: setType(type)
-     *   Client->>UserInput: setInitial(initial)
-     *   Client->>UserInput: Other configuration methods
-     *
-     *   Client->>UserInput: ask()
-     *   UserInput->>PromptLibrary: prompts(question)
-     *   PromptLibrary->>Client: Display prompt
-     *   Client->>PromptLibrary: User provides input
-     *   PromptLibrary->>UserInput: Return answers
-     *   UserInput->>Client: Return processed answers
-     */
-    class UserInput {
-        static { this.logger = logging.Logging.for(UserInput); }
-        constructor(name) {
-            /**
-             * @description The type of the prompt.
-             * @summary Determines the input method (e.g., text, number, confirm).
-             */
-            this.type = "text";
-            this.name = name;
-        }
-        /**
-         * @description Sets the type of the prompt.
-         * @summary Configures the input method for the prompt.
-         *
-         * @param type - The type of the prompt.
-         * @returns This UserInput instance for method chaining.
-         */
-        setType(type) {
-            UserInput.logger.verbose(`Setting type to: ${type}`);
-            this.type = type;
-            return this;
-        }
-        /**
-         * @description Sets the message of the prompt.
-         * @summary Configures the question or instruction presented to the user.
-         *
-         * @param value - The message to be displayed.
-         * @returns This UserInput instance for method chaining.
-         */
-        setMessage(value) {
-            UserInput.logger.verbose(`Setting message to: ${value}`);
-            this.message = value;
-            return this;
-        }
-        /**
-         * @description Sets the initial value of the prompt.
-         * @summary Configures the default value presented to the user.
-         *
-         * @param value - The initial value.
-         * @returns This UserInput instance for method chaining.
-         */
-        setInitial(value) {
-            UserInput.logger.verbose(`Setting initial value to: ${value}`);
-            this.initial = value;
-            return this;
-        }
-        /**
-         * @description Sets the style of the prompt.
-         * @summary Configures the visual style of the prompt.
-         *
-         * @param value - The style to be applied.
-         * @returns This UserInput instance for method chaining.
-         */
-        setStyle(value) {
-            UserInput.logger.verbose(`Setting style to: ${value}`);
-            this.style = value;
-            return this;
-        }
-        /**
-         * @description Sets the format function of the prompt.
-         * @summary Configures a function to format the user's input before it's returned.
-         *
-         * @param value - The format function.
-         * @returns This UserInput instance for method chaining.
-         */
-        setFormat(value) {
-            UserInput.logger.verbose(`Setting format function`);
-            this.format = value;
-            return this;
-        }
-        /**
-         * @description Sets the validation function of the prompt.
-         * @summary Configures a function to validate the user's input.
-         *
-         * @param value - The validation function.
-         * @returns This UserInput instance for method chaining.
-         */
-        setValidate(value) {
-            UserInput.logger.verbose(`Setting validate function`);
-            this.validate = value;
-            return this;
-        }
-        /**
-         * @description Sets the onState callback of the prompt.
-         * @summary Configures a function to be called when the state of the prompt changes.
-         *
-         * @param value - The onState callback function.
-         * @returns This UserInput instance for method chaining.
-         */
-        setOnState(value) {
-            UserInput.logger.verbose(`Setting onState callback`);
-            this.onState = value;
-            return this;
-        }
-        /**
-         * @description Sets the minimum value for number inputs.
-         * @summary Configures the lowest number the user can input.
-         *
-         * @param value - The minimum value.
-         * @returns This UserInput instance for method chaining.
-         */
-        setMin(value) {
-            UserInput.logger.verbose(`Setting min value to: ${value}`);
-            this.min = value;
-            return this;
-        }
-        /**
-         * @description Sets the maximum value for number inputs.
-         * @summary Configures the highest number the user can input.
-         *
-         * @param value - The maximum value.
-         * @returns This UserInput instance for method chaining.
-         */
-        setMax(value) {
-            UserInput.logger.verbose(`Setting max value to: ${value}`);
-            this.max = value;
-            return this;
-        }
-        /**
-         * @description Sets whether to allow float values for number inputs.
-         * @summary Configures whether decimal numbers are allowed.
-         *
-         * @param value - Whether to allow float values.
-         * @returns This UserInput instance for method chaining.
-         */
-        setFloat(value) {
-            UserInput.logger.verbose(`Setting float to: ${value}`);
-            this.float = value;
-            return this;
-        }
-        /**
-         * @description Sets the number of decimal places to round to for float inputs.
-         * @summary Configures the precision of float inputs.
-         *
-         * @param value - The number of decimal places.
-         * @returns This UserInput instance for method chaining.
-         */
-        setRound(value) {
-            UserInput.logger.verbose(`Setting round to: ${value}`);
-            this.round = value;
-            return this;
-        }
-        /**
-         * @description Sets the instructions for the user.
-         * @summary Configures additional guidance provided to the user.
-         *
-         * @param value - The instructions.
-         * @returns This UserInput instance for method chaining.
-         */
-        setInstructions(value) {
-            UserInput.logger.verbose(`Setting instructions to: ${value}`);
-            this.instructions = value;
-            return this;
-        }
-        /**
-         * @description Sets the increment value for number inputs.
-         * @summary Configures the step size when increasing or decreasing the number.
-         *
-         * @param value - The increment value.
-         * @returns This UserInput instance for method chaining.
-         */
-        setIncrement(value) {
-            UserInput.logger.verbose(`Setting increment to: ${value}`);
-            this.increment = value;
-            return this;
-        }
-        /**
-         * @description Sets the separator for list inputs.
-         * @summary Configures the character used to separate list items.
-         *
-         * @param value - The separator character.
-         * @returns This UserInput instance for method chaining.
-         */
-        setSeparator(value) {
-            UserInput.logger.verbose(`Setting separator to: ${value}`);
-            this.separator = value;
-            return this;
-        }
-        /**
-         * @description Sets the active option style for select inputs.
-         * @summary Configures the style applied to the currently selected option.
-         *
-         * @param value - The active option style.
-         * @returns This UserInput instance for method chaining.
-         */
-        setActive(value) {
-            UserInput.logger.verbose(`Setting active style to: ${value}`);
-            this.active = value;
-            return this;
-        }
-        /**
-         * @description Sets the inactive option style for select inputs.
-         * @summary Configures the style applied to non-selected options.
-         *
-         * @param value - The inactive option style.
-         * @returns This UserInput instance for method chaining.
-         */
-        setInactive(value) {
-            UserInput.logger.verbose(`Setting inactive style to: ${value}`);
-            this.inactive = value;
-            return this;
-        }
-        /**
-         * @description Sets the choices for select, multiselect, or autocomplete inputs.
-         * @summary Configures the available options that the user can select from in choice-based prompts.
-         *
-         * @param value - The array of choices or a function to determine the choices.
-         * @returns This UserInput instance for method chaining.
-         */
-        setChoices(value) {
-            UserInput.logger.verbose(`Setting choices: ${JSON.stringify(value)}`);
-            this.choices = value;
-            return this;
-        }
-        /**
-         * @description Sets the hint text for the prompt.
-         * @summary Configures additional information displayed to the user.
-         *
-         * @param value - The hint text.
-         * @returns This UserInput instance for method chaining.
-         */
-        setHint(value) {
-            UserInput.logger.verbose(`Setting hint to: ${value}`);
-            this.hint = value;
-            return this;
-        }
-        /**
-         * @description Sets the warning text for the prompt.
-         * @summary Configures a warning message displayed to the user.
-         *
-         * @param value - The warning text.
-         * @returns This UserInput instance for method chaining.
-         */
-        setWarn(value) {
-            UserInput.logger.verbose(`Setting warn to: ${value}`);
-            this.warn = value;
-            return this;
-        }
-        /**
-         * @description Sets the suggestion function for autocomplete inputs.
-         * @summary Configures a function that provides suggestions based on the user's input and available choices.
-         *
-         * @param value - A function that takes the current input and available choices and returns a Promise resolving to suggestions.
-         * @returns This UserInput instance for method chaining.
-         */
-        setSuggest(value) {
-            UserInput.logger.verbose(`Setting suggest function`);
-            this.suggest = value;
-            return this;
-        }
-        /**
-         * @description Sets the limit for list inputs.
-         * @summary Configures the maximum number of items that can be selected in list-type prompts.
-         * @template R - The type of the prompt name, extending string.
-         * @param value - The maximum number of items that can be selected, or a function to determine this value.
-         * @return This UserInput instance for method chaining.
-         */
-        setLimit(value) {
-            UserInput.logger.verbose(`Setting limit to: ${value}`);
-            this.limit = value;
-            return this;
-        }
-        /**
-         * @description Sets the mask for password inputs.
-         * @summary Configures the character used to hide the user's input in password-type prompts.
-         * @template R - The type of the prompt name, extending string.
-         * @param value - The character used to mask the input, or a function to determine this value.
-         * @return This UserInput instance for method chaining.
-         */
-        setMask(value) {
-            UserInput.logger.verbose(`Setting mask to: ${value}`);
-            this.mask = value;
-            return this;
-        }
-        /**
-         * @description Sets the stdout stream for the prompt.
-         * @summary Configures the output stream used by the prompt for displaying messages and results.
-         * @param value - The Writable stream to be used as stdout.
-         * @return This UserInput instance for method chaining.
-         */
-        setStdout(value) {
-            UserInput.logger.verbose(`Setting stdout stream`);
-            this.stdout = value;
-            return this;
-        }
-        /**
-         * @description Sets the stdin stream for the prompt.
-         * @summary Configures the input stream used by the prompt for receiving user input.
-         * @param value - The Readable stream to be used as stdin.
-         * @return This UserInput instance for method chaining.
-         */
-        setStdin(value) {
-            this.stdin = value;
-            return this;
-        }
-        /**
-         * @description Asks the user for input based on the current UserInput configuration.
-         * @summary Prompts the user and returns their response as a single value.
-         * @template R - The type of the prompt name, extending string.
-         * @return A Promise that resolves to the user's answer.
-         */
-        async ask() {
-            return (await UserInput.ask(this))[this.name];
-        }
-        /**
-         * @description Asks the user one or more questions based on the provided UserInput configurations.
-         * @summary Prompts the user with one or more questions and returns their answers as an object.
-         * @template R - The type of the prompt name, extending string.
-         * @param question - A single UserInput instance or an array of UserInput instances.
-         * @return A Promise that resolves to an object containing the user's answers.
-         * @mermaid
-         * sequenceDiagram
-         *   participant U as User
-         *   participant A as ask method
-         *   participant P as prompts library
-         *   A->>P: Call prompts with question(s)
-         *   P->>U: Display prompt(s)
-         *   U->>P: Provide input
-         *   P->>A: Return answers
-         *   A->>A: Process answers
-         *   A-->>Caller: Return processed answers
-         */
-        static async ask(question) {
-            const log = UserInput.logger.for(this.ask);
-            if (!Array.isArray(question)) {
-                question = [question];
-            }
-            let answers;
-            try {
-                log.verbose(`Asking questions: ${question.map((q) => q.name).join(", ")}`);
-                answers = await prompts__default["default"](question);
-                log.verbose(`Received answers: ${JSON.stringify(answers, null, 2)}`);
-            }
-            catch (error) {
-                throw new Error(`Error while getting input: ${error}`);
-            }
-            return answers;
-        }
-        /**
-         * @description Asks the user for a number input.
-         * @summary Prompts the user to enter a number, with optional minimum, maximum, and initial values.
-         * @param name - The name of the prompt, used as the key in the returned answers object.
-         * @param question - The message displayed to the user.
-         * @param min - The minimum allowed value (optional).
-         * @param max - The maximum allowed value (optional).
-         * @param initial - The initial value presented to the user (optional).
-         * @return A Promise that resolves to the number entered by the user.
-         */
-        static async askNumber(name, question, min, max, initial) {
-            const log = UserInput.logger.for(this.askNumber);
-            log.verbose(`Asking number input: undefined, question: ${question}, min: ${min}, max: ${max}, initial: ${initial}`);
-            const userInput = new UserInput(name)
-                .setMessage(question)
-                .setType("number");
-            if (typeof min === "number")
-                userInput.setMin(min);
-            if (typeof max === "number")
-                userInput.setMax(max);
-            if (typeof initial === "number")
-                userInput.setInitial(initial);
-            return (await this.ask(userInput))[name];
-        }
-        /**
-         * @description Asks the user for a text input.
-         * @summary Prompts the user to enter text, with optional masking and initial value.
-         * @param name - The name of the prompt, used as the key in the returned answers object.
-         * @param question - The message displayed to the user.
-         * @param mask - The character used to mask the input (optional, for password-like inputs).
-         * @param initial - The initial value presented to the user (optional).
-         * @return A Promise that resolves to the text entered by the user.
-         */
-        static async askText(name, question, mask = undefined, initial) {
-            const log = UserInput.logger.for(this.askText);
-            log.verbose(`Asking text input: undefined, question: ${question}, mask: ${mask}, initial: ${initial}`);
-            const userInput = new UserInput(name).setMessage(question);
-            if (mask)
-                userInput.setMask(mask);
-            if (typeof initial === "string")
-                userInput.setInitial(initial);
-            return (await this.ask(userInput))[name];
-        }
-        /**
-         * @description Asks the user for a confirmation (yes/no).
-         * @summary Prompts the user with a yes/no question and returns a boolean result.
-         * @param name - The name of the prompt, used as the key in the returned answers object.
-         * @param question - The message displayed to the user.
-         * @param initial - The initial value presented to the user (optional).
-         * @return A Promise that resolves to a boolean representing the user's answer.
-         */
-        static async askConfirmation(name, question, initial) {
-            const log = UserInput.logger.for(this.askConfirmation);
-            log.verbose(`Asking confirmation input: undefined, question: ${question}, initial: ${initial}`);
-            const userInput = new UserInput(name)
-                .setMessage(question)
-                .setType("confirm");
-            if (typeof initial !== "undefined")
-                userInput.setInitial(initial);
-            return (await this.ask(userInput))[name];
-        }
-        /**
-         * @description Repeatedly asks for input until a valid response is given or the limit is reached.
-         * @summary This method insists on getting a valid input from the user, allowing for a specified number of attempts.
-         *
-         * @template R - The type of the expected result.
-         * @param input - The UserInput instance to use for prompting.
-         * @param {function(string):boolean} test - Validator function receiving the user input and returning whether it is valid.
-         * @param defaultConfirmation - The default value for the confirmation prompt (true for yes, false for no).
-         * @param limit - The maximum number of attempts allowed (default is 1).
-         * @return A Promise that resolves to the valid input or undefined if the limit is reached.
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant U as User
-         *   participant I as insist method
-         *   participant A as ask method
-         *   participant T as test function
-         *   participant C as askConfirmation method
-         *   loop Until valid input or limit reached
-         *     I->>A: Call ask with input
-         *     A->>U: Prompt user
-         *     U->>A: Provide input
-         *     A->>I: Return result
-         *     I->>T: Test result
-         *     alt Test passes
-         *       I->>C: Ask for confirmation
-         *       C->>U: Confirm input
-         *       U->>C: Provide confirmation
-         *       C->>I: Return confirmation
-         *       alt Confirmed
-         *         I-->>Caller: Return valid result
-         *       else Not confirmed
-         *         I->>I: Continue loop
-         *       end
-         *     else Test fails
-         *       I->>I: Continue loop
-         *     end
-         *   end
-         *   I-->>Caller: Return undefined if limit reached
-         */
-        static async insist(input, test, defaultConfirmation, limit = 1) {
-            const log = UserInput.logger.for(this.insist);
-            log.verbose(`Insisting on input: ${input.name}, test: ${test.toString()}, defaultConfirmation: ${defaultConfirmation}, limit: ${limit}`);
-            let result = undefined;
-            let count = 0;
-            let confirmation;
-            try {
-                do {
-                    result = (await UserInput.ask(input))[input.name];
-                    if (!test(result)) {
-                        result = undefined;
-                        continue;
-                    }
-                    confirmation = await UserInput.askConfirmation(`${input.name}-confirm`, `Is the ${input.type} correct?`, defaultConfirmation);
-                    if (!confirmation)
-                        result = undefined;
-                } while (typeof result === "undefined" && limit > 1 && count++ < limit);
-            }
-            catch (e) {
-                log.error(`Error while insisting: ${e}`);
-                throw e;
-            }
-            if (typeof result === "undefined")
-                log.info("no selection...");
-            return result;
-        }
-        /**
-         * @description Repeatedly asks for text input until a valid response is given or the limit is reached.
-         * @summary This method insists on getting a valid text input from the user, allowing for a specified number of attempts.
-         *
-         * @param name - The name of the prompt, used as the key in the returned answers object.
-         * @param question - The message displayed to the user.
-         * @param {function(number):boolean} test - Validator function receiving the user input and returning whether it is valid.
-         * @param mask - The character used to mask the input (optional, for password-like inputs).
-         * @param initial - The initial value presented to the user (optional).
-         * @param defaultConfirmation - The default value for the confirmation prompt (true for yes, false for no).
-         * @param limit - The maximum number of attempts allowed (default is -1, meaning unlimited).
-         * @return A Promise that resolves to the valid input or undefined if the limit is reached.
-         */
-        static async insistForText(name, question, test, mask = undefined, initial, defaultConfirmation = false, limit = -1) {
-            const log = UserInput.logger.for(this.insistForText);
-            log.verbose(`Insisting for text input: undefined, question: ${question}, test: ${test.toString()}, mask: ${mask}, initial: ${initial}, defaultConfirmation: ${defaultConfirmation}, limit: ${limit}`);
-            const userInput = new UserInput(name).setMessage(question);
-            if (mask)
-                userInput.setMask(mask);
-            if (typeof initial === "string")
-                userInput.setInitial(initial);
-            return (await this.insist(userInput, test, defaultConfirmation, limit));
-        }
-        /**
-         * @description Repeatedly asks for number input until a valid response is given or the limit is reached.
-         * @summary This method insists on getting a valid number input from the user, allowing for a specified number of attempts.
-         *
-         * @param name - The name of the prompt, used as the key in the returned answers object.
-         * @param question - The message displayed to the user.
-         * @param test - A function to validate the user's input.
-         * @param min - The minimum allowed value (optional).
-         * @param max - The maximum allowed value (optional).
-         * @param initial - The initial value presented to the user (optional).
-         * @param defaultConfirmation - The default value for the confirmation prompt (true for yes, false for no).
-         * @param limit - The maximum number of attempts allowed (default is -1, meaning unlimited).
-         * @return A Promise that resolves to the valid input or undefined if the limit is reached.
-         */
-        static async insistForNumber(name, question, test, min, max, initial, defaultConfirmation = false, limit = -1) {
-            const log = UserInput.logger.for(this.insistForNumber);
-            log.verbose(`Insisting for number input: undefined, question: ${question}, test: ${test.toString()}, min: ${min}, max: ${max}, initial: ${initial}, defaultConfirmation: ${defaultConfirmation}, limit: ${limit}`);
-            const userInput = new UserInput(name)
-                .setMessage(question)
-                .setType("number");
-            if (typeof min === "number")
-                userInput.setMin(min);
-            if (typeof max === "number")
-                userInput.setMax(max);
-            if (typeof initial === "number")
-                userInput.setInitial(initial);
-            return (await this.insist(userInput, test, defaultConfirmation, limit));
-        }
-        /**
-         * @description Parses command-line arguments based on the provided options.
-         * @summary Uses Node.js's util.parseArgs to parse command-line arguments and return the result.
-         * @param options - Configuration options for parsing arguments.
-         * @return An object containing the parsed arguments.
-         * @mermaid
-         * sequenceDiagram
-         *   participant C as Caller
-         *   participant P as parseArgs method
-         *   participant U as util.parseArgs
-         *   C->>P: Call with options
-         *   P->>P: Prepare args object
-         *   P->>U: Call parseArgs with prepared args
-         *   U->>P: Return parsed result
-         *   P-->>C: Return ParseArgsResult
-         */
-        static parseArgs(options) {
-            const log = UserInput.logger.for(this.parseArgs);
-            const args = {
-                args: process.argv.slice(2),
-                options: options,
-            };
-            log.debug(`Parsing arguments: ${JSON.stringify(args, null, 2)}`);
-            try {
-                return util.parseArgs(args);
-            }
-            catch (error) {
-                log.debug(`Error while parsing arguments:\n${JSON.stringify(args, null, 2)}\n | options\n${JSON.stringify(options, null, 2)}\n | ${error}`);
-                throw new Error(`Error while parsing arguments: ${error}`);
-            }
-        }
-    }
-
-    /**
-     * @description Default command options for CLI commands.
-     * @summary Defines the structure and default values for common command-line options used across various CLI commands.
-     * @const DefaultCommandOptions
-     * @typedef {Object} DefaultCommandOptions
-     * @property {Object} verbose - Verbosity level option.
-     * @property {string} verbose.type - The type of the verbose option (number).
-     * @property {string} verbose.short - The short flag for the verbose option (V).
-     * @property {number} verbose.default - The default value for verbosity (0).
-     * @property {Object} version - Version display option.
-     * @property {string} version.type - The type of the version option (boolean).
-     * @property {string} version.short - The short flag for the version option (v).
-     * @property {undefined} version.default - The default value for version display (undefined).
-     * @property {Object} help - Help display option.
-     * @property {string} help.type - The type of the help option (boolean).
-     * @property {string} help.short - The short flag for the help option (h).
-     * @property {boolean} help.default - The default value for help display (false).
-     * @property {Object} logLevel - Log level option.
-     * @property {string} logLevel.type - The type of the logLevel option (string).
-     * @property {string} logLevel.default - The default value for log level ("info").
-     * @property {Object} logStyle - Log styling option.
-     * @property {string} logStyle.type - The type of the logStyle option (boolean).
-     * @property {boolean} logStyle.default - The default value for log styling (true).
-     * @property {Object} timestamp - Timestamp display option.
-     * @property {string} timestamp.type - The type of the timestamp option (boolean).
-     * @property {boolean} timestamp.default - The default value for timestamp display (true).
-     * @property {Object} banner - Banner display option.
-     * @property {string} banner.type - The type of the banner option (boolean).
-     * @property {boolean} banner.default - The default value for banner display (false).
-     * @memberOf module:utils
-     */
-    const DefaultCommandOptions = {
-        verbose: {
-            type: "boolean",
-            short: "V",
-            default: undefined,
-        },
-        version: {
-            type: "boolean",
-            short: "v",
-            default: undefined,
-        },
-        help: {
-            type: "boolean",
-            short: "h",
-            default: false,
-        },
-        logLevel: {
-            type: "string",
-            default: "info",
-        },
-        logStyle: {
-            type: "boolean",
-            default: true,
-        },
-        timestamp: {
-            type: "boolean",
-            default: true,
-        },
-        banner: {
-            type: "boolean",
-            default: true,
-        },
-    };
-    /**
-     * @description Default command values derived from DefaultCommandOptions.
-     * @summary Creates an object with the default values of all options defined in DefaultCommandOptions.
-     * @const DefaultCommandValues
-     * @typedef {Object} DefaultCommandValues
-     * @property {unknown} [key: string] - The default value for each option in DefaultCommandOptions.
-     * @memberOf module:utils
-     */
-    const DefaultCommandValues = Object.keys(DefaultCommandOptions).reduce((acc, key) => {
-        acc[key] =
-            DefaultCommandOptions[key].default;
-        return acc;
-    }, {});
-
-    /**
-     * @description Default encoding for text operations.
-     * @summary The standard UTF-8 encoding used for text processing.
-     * @const {string} Encoding
-     * @memberOf module:utils
-     */
-    const Encoding = "utf-8";
-    /**
-     * @description Regular expression for semantic versioning.
-     * @summary A regex pattern to match and parse semantic version strings.
-     * @const {RegExp} SemVersionRegex
-     * @memberOf module:utils
-     */
-    const SemVersionRegex = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z])))/g;
-    /**
-     * @description Enum for semantic version components.
-     * @summary Defines the three levels of semantic versioning: PATCH, MINOR, and MAJOR.
-     * @enum {string}
-     * @memberOf module:utils
-     */
-    exports.SemVersion = void 0;
-    (function (SemVersion) {
-        /** Patch version for backwards-compatible bug fixes. */
-        SemVersion["PATCH"] = "patch";
-        /** Minor version for backwards-compatible new features. */
-        SemVersion["MINOR"] = "minor";
-        /** Major version for changes that break backwards compatibility. */
-        SemVersion["MAJOR"] = "major";
-    })(exports.SemVersion || (exports.SemVersion = {}));
-    /**
-     * @description Flag to indicate non-CI environment.
-     * @summary Used to specify that a command should run outside of a Continuous Integration environment.
-     * @const {string} NoCIFLag
-     * @memberOf module:utils
-     */
-    const NoCIFLag = "-no-ci";
-    /**
-     * @description Key for the setup script in package.json.
-     * @summary Identifies the script that runs after package installation.
-     * @const {string} SetupScriptKey
-     * @memberOf module:utils
-     */
-    const SetupScriptKey = "postinstall";
-    /**
-     * @description Enum for various authentication tokens.
-     * @summary Defines the file names for storing different types of authentication tokens.
-     * @enum {string}
-     * @memberOf module:utils
-     */
-    exports.Tokens = void 0;
-    (function (Tokens) {
-        /** Git authentication token file name. */
-        Tokens["GIT"] = ".token";
-        /** NPM authentication token file name. */
-        Tokens["NPM"] = ".npmtoken";
-        /** Docker authentication token file name. */
-        Tokens["DOCKER"] = ".dockertoken";
-        /** Confluence authentication token file name. */
-        Tokens["CONFLUENCE"] = ".confluence-token";
-    })(exports.Tokens || (exports.Tokens = {}));
-    /**
-     * @description Code used to indicate an operation was aborted.
-     * @summary Standard message used when a process is manually terminated.
-     * @const {string} AbortCode
-     * @memberOf module:utils
-     */
-    const AbortCode = "Aborted";
-
-    /**
-     * @description A standard output writer for handling command execution output.
-     * @summary This class implements the OutputWriter interface and provides methods for
-     * handling various types of output from command execution, including standard output,
-     * error output, and exit codes. It also includes utility methods for parsing commands
-     * and resolving or rejecting promises based on execution results.
-     *
-     * @template R - The type of the resolved value, defaulting to string.
-     *
-     * @param cmd - The command string to be executed.
-     * @param lock - A PromiseExecutor to control the asynchronous flow.
-     * @param args - Additional arguments (unused in the current implementation).
-     *
-     * @class
-     * @example
-     * ```typescript
-     * import { StandardOutputWriter } from '@decaf-ts/utils';
-     * import { PromiseExecutor } from '@decaf-ts/utils';
-     *
-     * // Create a promise executor
-     * const executor: PromiseExecutor<string> = {
-     *   resolve: (value) => console.log(`Resolved: ${value}`),
-     *   reject: (error) => console.error(`Rejected: ${error.message}`)
-     * };
-     *
-     * // Create a standard output writer
-     * const writer = new StandardOutputWriter('ls -la', executor);
-     *
-     * // Use the writer to handle command output
-     * writer.data('File list output...');
-     * writer.exit(0, ['Command executed successfully']);
-     * ```
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Client
-     *   participant StandardOutputWriter
-     *   participant Logger
-     *   participant PromiseExecutor
-     *
-     *   Client->>StandardOutputWriter: new StandardOutputWriter(cmd, lock)
-     *   StandardOutputWriter->>Logger: Logging.for(cmd)
-     *
-     *   Client->>StandardOutputWriter: data(chunk)
-     *   StandardOutputWriter->>StandardOutputWriter: log("stdout", chunk)
-     *   StandardOutputWriter->>Logger: logger.info(log)
-     *
-     *   Client->>StandardOutputWriter: error(chunk)
-     *   StandardOutputWriter->>StandardOutputWriter: log("stderr", chunk)
-     *   StandardOutputWriter->>Logger: logger.info(log)
-     *
-     *   Client->>StandardOutputWriter: exit(code, logs)
-     *   StandardOutputWriter->>StandardOutputWriter: log("stdout", exitMessage)
-     *   alt code === 0
-     *     StandardOutputWriter->>StandardOutputWriter: resolve(logs)
-     *     StandardOutputWriter->>PromiseExecutor: lock.resolve(reason)
-     *   else code !== 0
-     *     StandardOutputWriter->>StandardOutputWriter: reject(error)
-     *     StandardOutputWriter->>PromiseExecutor: lock.reject(reason)
-     *   end
-     */
-    class StandardOutputWriter {
-        constructor(cmd, lock, 
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        ...args) {
-            this.cmd = cmd;
-            this.lock = lock;
-            this.logger = logging.Logging.for(this.cmd);
-        }
-        /**
-         * @description Logs output to the console.
-         * @summary Formats and logs the given data with a timestamp and type indicator.
-         *
-         * @param type - The type of output (stdout or stderr).
-         * @param data - The data to be logged.
-         */
-        log(type, data) {
-            data = Buffer.isBuffer(data) ? data.toString(Encoding) : data;
-            const log = type === "stderr" ? styledStringBuilder.style(data).red.text : data;
-            this.logger.info(log);
-        }
-        /**
-         * @description Handles standard output data.
-         * @summary Logs the given chunk as standard output.
-         *
-         * @param chunk - The data chunk to be logged.
-         */
-        data(chunk) {
-            this.log("stdout", String(chunk));
-        }
-        /**
-         * @description Handles error output data.
-         * @summary Logs the given chunk as error output.
-         *
-         * @param chunk - The error data chunk to be logged.
-         */
-        error(chunk) {
-            this.log("stderr", String(chunk));
-        }
-        /**
-         * @description Handles error objects.
-         * @summary Logs the error message from the given Error object.
-         *
-         * @param err - The Error object to be logged.
-         */
-        errors(err) {
-            this.log("stderr", `Error executing command exited : ${err}`);
-        }
-        /**
-         * @description Handles the exit of a command.
-         * @summary Logs the exit code and resolves or rejects the promise based on the code.
-         *
-         * @param code - The exit code of the command.
-         * @param logs - Array of log messages to be processed before exiting.
-         */
-        exit(code, logs) {
-            this.log("stdout", `command exited code : ${code === 0 ? styledStringBuilder.style(code.toString()).green.text : styledStringBuilder.style(code === null ? "null" : code.toString()).red.text}`);
-            if (code === 0) {
-                this.resolve(logs.map((l) => l.trim()).join("\n"));
-            }
-            else {
-                this.reject(new Error(logs.length ? logs.join("\n") : code.toString()));
-            }
-        }
-        /**
-         * @description Parses a command string or array into components.
-         * @summary Converts the command into a consistent format and stores it, then returns it split into command and arguments.
-         *
-         * @param command - The command as a string or array of strings.
-         * @return A tuple containing the command and its arguments as separate elements.
-         */
-        parseCommand(command) {
-            command = typeof command === "string" ? command.split(" ") : command;
-            this.cmd = command.join(" ");
-            return [command[0], command.slice(1)];
-        }
-        /**
-         * @description Resolves the promise with a success message.
-         * @summary Logs a success message and resolves the promise with the given reason.
-         *
-         * @param reason - The reason for resolving the promise.
-         */
-        resolve(reason) {
-            this.log("stdout", `${this.cmd} executed successfully: ${styledStringBuilder.style(reason ? "ran to completion" : reason).green}`);
-            this.lock.resolve(reason);
-        }
-        /**
-         * @description Rejects the promise with an error message.
-         * @summary Logs an error message and rejects the promise with the given reason.
-         *
-         * @param reason - The reason for rejecting the promise, either a number (exit code) or a string.
-         */
-        reject(reason) {
-            if (!(reason instanceof Error)) {
-                reason = new Error(typeof reason === "number" ? `Exit code ${reason}` : reason);
-            }
-            this.log("stderr", `${this.cmd} failed to execute: ${styledStringBuilder.style(reason.message).red}`);
-            this.lock.reject(reason);
-        }
-    }
-
-    /**
-     * @description Creates a locked version of a function.
-     * @summary This higher-order function takes a function and returns a new function that ensures
-     * sequential execution of the original function, even when called multiple times concurrently.
-     * It uses a Promise-based locking mechanism to queue function calls.
-     *
-     * @template R - The return type of the input function.
-     *
-     * @param f - The function to be locked. It can take any number of parameters and return a value of type R.
-     * @return A new function with the same signature as the input function, but with sequential execution guaranteed.
-     *
-     * @function lockify
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Caller
-     *   participant LockedFunction
-     *   participant OriginalFunction
-     *   Caller->>LockedFunction: Call with params
-     *   LockedFunction->>LockedFunction: Check current lock
-     *   alt Lock is resolved
-     *     LockedFunction->>OriginalFunction: Execute with params
-     *     OriginalFunction-->>LockedFunction: Return result
-     *     LockedFunction-->>Caller: Return result
-     *   else Lock is pending
-     *     LockedFunction->>LockedFunction: Queue execution
-     *     LockedFunction-->>Caller: Return promise
-     *     Note over LockedFunction: Wait for previous execution
-     *     LockedFunction->>OriginalFunction: Execute with params
-     *     OriginalFunction-->>LockedFunction: Return result
-     *     LockedFunction-->>Caller: Resolve promise with result
-     *   end
-     *   LockedFunction->>LockedFunction: Update lock
-     *
-     * @memberOf module:utils
-     */
-    function lockify(f) {
-        let lock = Promise.resolve();
-        return (...params) => {
-            const result = lock.then(() => f(...params));
-            lock = result.catch(() => { });
-            return result;
-        };
-    }
-    function chainAbortController(argument0, ...remainder) {
-        let signals;
-        let controller;
-        // normalize args
-        if (argument0 instanceof AbortSignal) {
-            controller = new AbortController();
-            signals = [argument0, ...remainder];
-        }
-        else {
-            controller = argument0;
-            signals = remainder;
-        }
-        // if the controller is already aborted, exit early
-        if (controller.signal.aborted) {
-            return controller;
-        }
-        const handler = () => controller.abort();
-        for (const signal of signals) {
-            // check before adding! (and assume there is no possible way that the signal could
-            // abort between the `if` check and adding the event listener)
-            if (signal.aborted) {
-                controller.abort();
-                break;
-            }
-            signal.addEventListener("abort", handler, {
-                once: true,
-                signal: controller.signal,
-            });
-        }
-        return controller;
-    }
-    /**
-     * @description Spawns a command as a child process with output handling.
-     * @summary Creates a child process to execute a command with support for piping multiple commands,
-     * custom output handling, and abort control. This function handles the low-level details of
-     * spawning processes and connecting their inputs/outputs when piping is used.
-     *
-     * @template R - The type of the processed output, defaulting to string.
-     * @param {StandardOutputWriter<R>} output - The output writer to handle command output.
-     * @param {string} command - The command to execute, can include pipe operators.
-     * @param {SpawnOptionsWithoutStdio} opts - Options for the spawned process.
-     * @param {AbortController} abort - Controller to abort the command execution.
-     * @param {Logger} logger - Logger for recording command execution details.
-     * @return {ChildProcessWithoutNullStreams} The spawned child process.
-     *
-     * @function spawnCommand
-     *
-     * @memberOf module:utils
-     */
-    function spawnCommand(output, command, opts, abort, logger) {
-        function spawnInner(command, controller) {
-            const [cmd, argz] = output.parseCommand(command);
-            logger.info(`Running command: ${cmd}`);
-            logger.debug(`with args: ${argz.join(" ")}`);
-            const childProcess = child_process.spawn(cmd, argz, {
-                ...opts,
-                cwd: opts.cwd || process.cwd(),
-                env: Object.assign({}, process.env, opts.env, { PATH: process.env.PATH }),
-                shell: opts.shell || false,
-                signal: controller.signal,
-            });
-            logger.verbose(`pid : ${childProcess.pid}`);
-            return childProcess;
-        }
-        const m = command.match(/[<>$#]/g);
-        if (m)
-            throw new Error(`Invalid command: ${command}. contains invalid characters: ${m}`);
-        if (command.includes(" | ")) {
-            const cmds = command.split(" | ");
-            const spawns = [];
-            const controllers = new Array(cmds.length);
-            controllers[0] = abort;
-            for (let i = 0; i < cmds.length; i++) {
-                if (i !== 0)
-                    controllers[i] = chainAbortController(controllers[i - 1].signal);
-                spawns.push(spawnInner(cmds[i], controllers[i]));
-                if (i === 0)
-                    continue;
-                spawns[i - 1].stdout.pipe(spawns[i].stdin);
-            }
-            return spawns[cmds.length - 1];
-        }
-        return spawnInner(command, abort);
-    }
-    /**
-     * @description Executes a command asynchronously with customizable output handling.
-     * @summary This function runs a shell command as a child process, providing fine-grained
-     * control over its execution and output handling. It supports custom output writers,
-     * allows for command abortion, and captures both stdout and stderr.
-     *
-     * @template R - The type of the resolved value from the command execution.
-     *
-     * @param command - The command to run, either as a string or an array of strings.
-     * @param opts - Spawn options for the child process. Defaults to an empty object.
-     * @param outputConstructor - Constructor for the output writer. Defaults to StandardOutputWriter.
-     * @param args - Additional arguments to pass to the output constructor.
-     * @return {CommandResult} A promise that resolves to the command result of type R.
-     *
-     * @function runCommand
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Caller
-     *   participant runCommand
-     *   participant OutputWriter
-     *   participant ChildProcess
-     *   Caller->>runCommand: Call with command and options
-     *   runCommand->>OutputWriter: Create new instance
-     *   runCommand->>OutputWriter: Parse command
-     *   runCommand->>ChildProcess: Spawn process
-     *   ChildProcess-->>runCommand: Return process object
-     *   runCommand->>ChildProcess: Set up event listeners
-     *   loop For each stdout data
-     *     ChildProcess->>runCommand: Emit stdout data
-     *     runCommand->>OutputWriter: Handle stdout data
-     *   end
-     *   loop For each stderr data
-     *     ChildProcess->>runCommand: Emit stderr data
-     *     runCommand->>OutputWriter: Handle stderr data
-     *   end
-     *   ChildProcess->>runCommand: Emit error (if any)
-     *   runCommand->>OutputWriter: Handle error
-     *   ChildProcess->>runCommand: Emit exit
-     *   runCommand->>OutputWriter: Handle exit
-     *   OutputWriter-->>runCommand: Resolve or reject promise
-     *   runCommand-->>Caller: Return CommandResult
-     *
-     * @memberOf module:utils
-     */
-    function runCommand(command, opts = {}, outputConstructor = (StandardOutputWriter), ...args) {
-        const logger = logging.Logging.for(runCommand);
-        const abort = new AbortController();
-        const result = {
-            abort: abort,
-            command: command,
-            logs: [],
-            errs: [],
-        };
-        const lock = new Promise((resolve, reject) => {
-            let output;
-            try {
-                output = new outputConstructor(command, {
-                    resolve,
-                    reject,
-                }, ...args);
-                result.cmd = spawnCommand(output, command, opts, abort, logger);
-            }
-            catch (e) {
-                return reject(new Error(`Error running command ${command}: ${e}`));
-            }
-            result.cmd.stdout.setEncoding("utf8");
-            result.cmd.stdout.on("data", (chunk) => {
-                chunk = chunk.toString();
-                result.logs.push(chunk);
-                output.data(chunk);
-            });
-            result.cmd.stderr.on("data", (data) => {
-                data = data.toString();
-                result.errs.push(data);
-                output.error(data);
-            });
-            result.cmd.once("error", (err) => {
-                output.exit(err.message, result.errs);
-            });
-            result.cmd.once("exit", (code = 0) => {
-                if (abort.signal.aborted && code === null)
-                    code = AbortCode;
-                output.exit(code, code === 0 ? result.logs : result.errs);
-            });
-        });
-        Object.assign(result, {
-            promise: lock,
-            pipe: async (cb) => {
-                const l = logger.for("pipe");
-                try {
-                    l.verbose(`Executing pipe function ${command}...`);
-                    const result = await lock;
-                    l.verbose(`Piping output to ${cb.name}: ${result}`);
-                    return cb(result);
-                }
-                catch (e) {
-                    l.error(`Error piping command output: ${e}`);
-                    throw e;
-                }
-            },
-        });
-        return result;
-    }
-
-    const logger = logging.Logging.for("fs");
-    /**
-     * @description Patches a file with given values.
-     * @summary Reads a file, applies patches using TextUtils, and writes the result back to the file.
-     *
-     * @param {string} path - The path to the file to be patched.
-     * @param {Record<string, number | string>} values - The values to patch into the file.
-     * @return {void}
-     *
-     * @function patchFile
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Caller
-     *   participant patchFile
-     *   participant fs
-     *   participant readFile
-     *   participant TextUtils
-     *   participant writeFile
-     *   Caller->>patchFile: Call with path and values
-     *   patchFile->>fs: Check if file exists
-     *   patchFile->>readFile: Read file content
-     *   readFile->>fs: Read file
-     *   fs-->>readFile: Return file content
-     *   readFile-->>patchFile: Return file content
-     *   patchFile->>TextUtils: Patch string
-     *   TextUtils-->>patchFile: Return patched content
-     *   patchFile->>writeFile: Write patched content
-     *   writeFile->>fs: Write to file
-     *   fs-->>writeFile: File written
-     *   writeFile-->>patchFile: File written
-     *   patchFile-->>Caller: Patching complete
-     *
-     * @memberOf module:utils
-     */
-    function patchFile(path, values) {
-        const log = logger.for(patchFile);
-        if (!fs__default["default"].existsSync(path))
-            throw new Error(`File not found at path "${path}".`);
-        let content = readFile(path);
-        try {
-            log.verbose(`Patching file "${path}"...`);
-            log.debug(`with value: ${JSON.stringify(values)}`);
-            content = logging.patchString(content, values);
-        }
-        catch (error) {
-            throw new Error(`Error patching file: ${error}`);
-        }
-        writeFile(path, content);
-    }
-    /**
-     * @description Reads a file and returns its content.
-     * @summary Reads the content of a file at the specified path and returns it as a string.
-     *
-     * @param {string} path - The path to the file to be read.
-     * @return {string} The content of the file.
-     *
-     * @function readFile
-     *
-     * @memberOf module:utils
-     */
-    function readFile(path) {
-        const log = logger.for(readFile);
-        try {
-            log.verbose(`Reading file "${path}"...`);
-            return fs__default["default"].readFileSync(path, "utf8");
-        }
-        catch (error) {
-            log.verbose(`Error reading file "${path}": ${error}`);
-            throw new Error(`Error reading file "${path}": ${error}`);
-        }
-    }
-    /**
-     * @description Writes data to a file.
-     * @summary Writes the provided data to a file at the specified path.
-     *
-     * @param {string} path - The path to the file to be written.
-     * @param {string | Buffer} data - The data to be written to the file.
-     * @return {void}
-     *
-     * @function writeFile
-     *
-     * @memberOf module:utils
-     */
-    function writeFile(path, data) {
-        const log = logger.for(writeFile);
-        try {
-            log.verbose(`Writing file "${path} with ${data.length} bytes...`);
-            fs__default["default"].writeFileSync(path, data, "utf8");
-        }
-        catch (error) {
-            log.verbose(`Error writing file "${path}": ${error}`);
-            throw new Error(`Error writing file "${path}": ${error}`);
-        }
-    }
-    /**
-     * @description Retrieves all files recursively from a directory.
-     * @summary Traverses through directories and subdirectories to collect all file paths.
-     *
-     * @param {string} p - The path to start searching from.
-     * @param {function} [filter] - Optional function to filter files by name or index.
-     * @return {string[]} Array of file paths.
-     *
-     * @function getAllFiles
-     *
-     * @memberOf module:utils
-     */
-    function getAllFiles(p, filter) {
-        const log = logger.for(getAllFiles);
-        const files = [];
-        try {
-            log.verbose(`Retrieving all files from "${p}"...`);
-            const entries = fs__default["default"].readdirSync(p);
-            entries.forEach((entry) => {
-                const fullPath = path__default["default"].join(p, entry);
-                const stat = fs__default["default"].statSync(fullPath);
-                if (stat.isFile()) {
-                    files.push(fullPath);
-                }
-                else if (stat.isDirectory()) {
-                    files.push(...getAllFiles(fullPath));
-                }
-            });
-            if (!filter)
-                return files;
-            return files.filter(filter);
-        }
-        catch (error) {
-            log.verbose(`Error retrieving files from "${p}": ${error}`);
-            throw new Error(`Error retrieving files from "${p}": ${error}`);
-        }
-    }
-    /**
-     * @description Renames a file or directory.
-     * @summary Moves a file or directory from the source path to the destination path.
-     *
-     * @param {string} source - The source path of the file or directory.
-     * @param {string} dest - The destination path for the file or directory.
-     * @return {Promise<void>} A promise that resolves when the rename operation is complete.
-     *
-     * @function renameFile
-     *
-     * @memberOf module:utils
-     */
-    async function renameFile(source, dest) {
-        const log = logger.for(renameFile);
-        let descriptorSource, descriptorDest;
-        try {
-            descriptorSource = fs__default["default"].statSync(source);
-        }
-        catch (error) {
-            log.verbose(`Source path "${source}" does not exist: ${error}`);
-            throw new Error(`Source path "${source}" does not exist: ${error}`);
-        }
-        try {
-            descriptorDest = fs__default["default"].statSync(dest);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        }
-        catch (e) {
-            // do nothing. its ok
-        }
-        if (descriptorDest) {
-            log.verbose(`Destination path "${dest}" already exists`);
-            throw new Error(`Destination path "${dest}" already exists`);
-        }
-        try {
-            log.verbose(`Renaming ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}...`);
-            fs__default["default"].renameSync(source, dest);
-            log.verbose(`Successfully renamed to "${dest}"`);
-        }
-        catch (error) {
-            log.verbose(`Error renaming ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}": ${error}`);
-            throw new Error(`Error renaming ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}": ${error}`);
-        }
-    }
-    /**
-     * @description Copies a file or directory.
-     * @summary Creates a copy of a file or directory from the source path to the destination path.
-     *
-     * @param {string} source - The source path of the file or directory.
-     * @param {string} dest - The destination path for the file or directory.
-     * @return {void}
-     *
-     * @function copyFile
-     *
-     * @memberOf module:utils
-     */
-    function copyFile(source, dest) {
-        const log = logger.for(copyFile);
-        let descriptorSource, descriptorDest;
-        try {
-            descriptorSource = fs__default["default"].statSync(source);
-        }
-        catch (error) {
-            log.verbose(`Source path "${source}" does not exist: ${error}`);
-            throw new Error(`Source path "${source}" does not exist: ${error}`);
-        }
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            descriptorDest = fs__default["default"].statSync(dest);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        }
-        catch (error) {
-            if (descriptorSource.isDirectory()) {
-                log.verbose(`Dest path "${dest}" does not exist. creating`);
-                fs__default["default"].mkdirSync(dest, { recursive: true });
-            }
-        }
-        try {
-            log.verbose(`Copying ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}...`);
-            fs__default["default"].cpSync(source, dest, { recursive: true });
-        }
-        catch (error) {
-            log.verbose(`Error copying ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}: ${error}`);
-            throw new Error(`Error copying ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}: ${error}`);
-        }
-    }
-    /**
-     * @description Deletes a file or directory.
-     * @summary Removes a file or directory at the specified path, with recursive and force options enabled.
-     *
-     * @param {string} p - The path to the file or directory to delete.
-     * @return {void}
-     *
-     * @function deletePath
-     *
-     * @memberOf module:utils
-     */
-    function deletePath(p) {
-        const log = logger.for(deletePath);
-        try {
-            const descriptor = fs__default["default"].statSync(p);
-            if (descriptor.isFile()) {
-                log.verbose(`Deleting file "${p}...`);
-                fs__default["default"].rmSync(p, { recursive: true, force: true });
-            }
-            else if (descriptor.isDirectory())
-                fs__default["default"].rmSync(p, { recursive: true, force: true });
-        }
-        catch (error) {
-            log.verbose(`Error Deleting "${p}": ${error}`);
-            throw new Error(`Error Deleting "${p}": ${error}`);
-        }
-    }
-    /**
-     * @description Retrieves package information from package.json.
-     * @summary Loads and parses the package.json file from a specified directory or the current working directory. Can return the entire package object or a specific property.
-     * @param {string} [p=process.cwd()] - The directory path where the package.json file is located.
-     * @param {string} [property] - Optional. The specific property to retrieve from package.json.
-     * @return {object | string} The parsed contents of package.json or the value of the specified property.
-     * @function getPackage
-     * @mermaid
-     * sequenceDiagram
-     *   participant Caller
-     *   participant getPackage
-     *   participant readFile
-     *   participant JSON
-     *   Caller->>getPackage: Call with path and optional property
-     *   getPackage->>readFile: Read package.json
-     *   readFile-->>getPackage: Return file content
-     *   getPackage->>JSON: Parse file content
-     *   JSON-->>getPackage: Return parsed object
-     *   alt property specified
-     *     getPackage->>getPackage: Check if property exists
-     *     alt property exists
-     *       getPackage-->>Caller: Return property value
-     *     else property doesn't exist
-     *       getPackage-->>Caller: Throw Error
-     *     end
-     *   else no property specified
-     *     getPackage-->>Caller: Return entire package object
-     *   end
-     * @memberOf module:utils
-     */
-    function getPackage(p = process.cwd(), property) {
-        let pkg;
-        try {
-            pkg = JSON.parse(readFile(path__default["default"].join(p, `package.json`)));
-        }
-        catch (error) {
-            throw new Error(`Failed to retrieve package information" ${error}`);
-        }
-        if (property) {
-            if (!(property in pkg))
-                throw new Error(`Property "${property}" not found in package.json`);
-            return pkg[property];
-        }
-        return pkg;
-    }
-    /**
-     * @description Sets an attribute in the package.json file.
-     * @summary Updates a specific attribute in the package.json file with the provided value.
-     *
-     * @param {string} attr - The attribute name to set in package.json.
-     * @param {string | number | object} value - The value to set for the attribute.
-     * @param {string} [p=process.cwd()] - The directory path where the package.json file is located.
-     * @return {void}
-     *
-     * @function setPackageAttribute
-     *
-     * @memberOf module:utils
-     */
-    function setPackageAttribute(attr, value, p = process.cwd()) {
-        const pkg = getPackage(p);
-        pkg[attr] = value;
-        writeFile(path__default["default"].join(p, `package.json`), JSON.stringify(pkg, null, 2));
-    }
-    /**
-     * @description Retrieves the version from package.json.
-     * @summary A convenience function that calls getPackage to retrieve the "version" property from package.json.
-     * @param {string} [p=process.cwd()] - The directory path where the package.json file is located.
-     * @return {string} The version string from package.json.
-     * @function getPackageVersion
-     * @memberOf module:utils
-     */
-    function getPackageVersion(p = process.cwd()) {
-        return getPackage(p, "version");
-    }
-    /**
-     * @description Retrieves all dependencies from the project.
-     * @summary Executes 'npm ls --json' command to get a detailed list of all dependencies (production, development, and peer) and their versions.
-     * @param {string} [path=process.cwd()] - The directory path of the project.
-     * @return {Promise<{prod: Array<{name: string, version: string}>, dev: Array<{name: string, version: string}>, peer: Array<{name: string, version: string}>}>} An object containing arrays of production, development, and peer dependencies.
-     * @function getDependencies
-     * @mermaid
-     * sequenceDiagram
-     *   participant Caller
-     *   participant getDependencies
-     *   participant runCommand
-     *   participant JSON
-     *   Caller->>getDependencies: Call with optional path
-     *   getDependencies->>runCommand: Execute 'npm ls --json'
-     *   runCommand-->>getDependencies: Return command output
-     *   getDependencies->>JSON: Parse command output
-     *   JSON-->>getDependencies: Return parsed object
-     *   getDependencies->>getDependencies: Process dependencies
-     *   getDependencies-->>Caller: Return processed dependencies
-     * @memberOf module:utils
-     */
-    async function getDependencies(path = process.cwd()) {
-        let pkg;
-        try {
-            pkg = JSON.parse(await runCommand(`npm ls --json`, { cwd: path }).promise);
-        }
-        catch (e) {
-            throw new Error(`Failed to retrieve dependencies: ${e}`);
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const mapper = (entry, index) => ({
-            name: entry[0],
-            version: entry[1].version,
-        });
-        return {
-            prod: Object.entries(pkg.dependencies || {}).map(mapper),
-            dev: Object.entries(pkg.devDependencies || {}).map(mapper),
-            peer: Object.entries(pkg.peerDependencies || {}).map(mapper),
-        };
-    }
-    /**
-     * @description Updates project dependencies to their latest versions.
-     * @summary Runs npm-check-updates to update package.json and then installs the updated dependencies.
-     *
-     * @return {Promise<void>} A promise that resolves when dependencies are updated.
-     *
-     * @function updateDependencies
-     *
-     * @memberOf module:utils
-     */
-    async function updateDependencies() {
-        const log = logger.for(updateDependencies);
-        log.info("checking for updates...");
-        await runCommand("npx npm-check-updates -u").promise;
-        log.info("updating...");
-        await runCommand("npx npm run do-install").promise;
-    }
-    /**
-     * @description Installs dependencies if they are not already available.
-     * @summary Checks if specified dependencies are installed and installs any that are missing.
-     *
-     * @param {string[] | string} deps - The dependencies to check and potentially install.
-     * @param {SimpleDependencyMap} [dependencies] - Optional map of existing dependencies.
-     * @return {Promise<SimpleDependencyMap>} Updated map of dependencies.
-     *
-     * @function installIfNotAvailable
-     *
-     * @memberOf module:utils
-     */
-    async function installIfNotAvailable(deps, dependencies) {
-        if (!dependencies) {
-            const d = await getDependencies();
-            dependencies = {
-                prod: d.prod?.map((p) => p.name) || [],
-                dev: d.dev?.map((d) => d.name) || [],
-                peer: d.peer?.map((p) => p.name) || [],
-            };
-        }
-        const { prod, dev, peer } = dependencies;
-        const installed = Array.from(new Set([...(prod || []), ...(dev || []), ...(peer || [])]));
-        deps = typeof deps === "string" ? [deps] : deps;
-        const toInstall = deps.filter((d) => !installed.includes(d));
-        if (toInstall.length)
-            await installDependencies({ dev: toInstall });
-        dependencies.dev = dependencies.dev || [];
-        dependencies.dev.push(...toInstall);
-        return dependencies;
-    }
-    /**
-     * @description Pushes changes to Git repository.
-     * @summary Temporarily changes Git user configuration, commits all changes, pushes to remote, and restores original user configuration.
-     *
-     * @return {Promise<void>} A promise that resolves when changes are pushed.
-     *
-     * @function pushToGit
-     *
-     * @memberOf module:utils
-     */
-    async function pushToGit() {
-        const log = logger.for(pushToGit);
-        const gitUser = await runCommand("git config user.name").promise;
-        const gitEmail = await runCommand("git config user.email").promise;
-        log.verbose(`cached git id: ${gitUser}/${gitEmail}. changing to automation`);
-        await runCommand('git config user.email "automation@decaf.ts"').promise;
-        await runCommand('git config user.name "decaf"').promise;
-        log.info("Pushing changes to git...");
-        await runCommand("git add .").promise;
-        await runCommand(`git commit -m "refs #1 - after repo setup"`).promise;
-        await runCommand("git push").promise;
-        await runCommand(`git config user.email "${gitEmail}"`).promise;
-        await runCommand(`git config user.name "${gitUser}"`).promise;
-        log.verbose(`reverted to git id: ${gitUser}/${gitEmail}`);
-    }
-    /**
-     * @description Installs project dependencies.
-     * @summary Installs production, development, and peer dependencies as specified.
-     *
-     * @param {object} dependencies - Object containing arrays of dependencies to install.
-     * @param {string[]} [dependencies.prod] - Production dependencies to install.
-     * @param {string[]} [dependencies.dev] - Development dependencies to install.
-     * @param {string[]} [dependencies.peer] - Peer dependencies to install.
-     * @return {Promise<void>} A promise that resolves when all dependencies are installed.
-     *
-     * @function installDependencies
-     *
-     * @memberOf module:utils
-     */
-    async function installDependencies(dependencies) {
-        const log = logger.for(installDependencies);
-        const prod = dependencies.prod || [];
-        const dev = dependencies.dev || [];
-        const peer = dependencies.peer || [];
-        if (prod.length) {
-            log.info(`Installing dependencies ${prod.join(", ")}...`);
-            await runCommand(`npm install ${prod.join(" ")}`, { cwd: process.cwd() })
-                .promise;
-        }
-        if (dev.length) {
-            log.info(`Installing devDependencies ${dev.join(", ")}...`);
-            await runCommand(`npm install --save-dev ${dev.join(" ")}`, {
-                cwd: process.cwd(),
-            }).promise;
-        }
-        if (peer.length) {
-            log.info(`Installing peerDependencies ${peer.join(", ")}...`);
-            await runCommand(`npm install --save-peer ${peer.join(" ")}`, {
-                cwd: process.cwd(),
-            }).promise;
-        }
-    }
-    /**
-     * @description Normalizes imports to handle both CommonJS and ESModule formats.
-     * @summary Utility function to handle module import differences between formats.
-     *
-     * @template T - Type of the imported module.
-     * @param {Promise<T>} importPromise - Promise returned by dynamic import.
-     * @return {Promise<T>} Normalized module.
-     *
-     * @function normalizeImport
-     *
-     * @memberOf module:utils
-     */
-    async function normalizeImport(importPromise) {
-        // CommonJS's `module.exports` is wrapped as `default` in ESModule.
-        return importPromise.then((m) => (m.default || m));
-    }
-
-    /**
-     * @description Definition of a slogan item.
-     * @summary Represents a single slogan entry with text and tags.
-     * @typedef {Object} SloganItem
-     * @property {string} Slogan - The slogan text.
-     * @property {string} Tags - Comma-separated tags describing the slogan.
-     * @memberOf module:utils
-     */
-    /**
-     * @description List of available slogans for banners and messages.
-     * @summary Immutable array of slogan entries used by {@link getSlogan} and banner rendering.
-     * @type {SloganItem[]}
-     * @const slogans
-     * @memberOf module:utils
-     */
-    const slogans = [
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That's Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "No caffeine, no chaos. Just clean code.",
-            Tags: "Coffee-themed, Calm, Tech",
-        },
-        {
-            Slogan: "Full flavor, no jitters. That\u2019s Decaf-TS.",
-            Tags: "Coffee-themed, Cheerful",
-        },
-        {
-            Slogan: "Chill fullstack. Powered by Decaf.",
-            Tags: "Coffee-themed, Fun, Tech",
-        },
-        {
-            Slogan: "Decaf-TS: Brewed for calm code.",
-            Tags: "Coffee-themed, Branding",
-        },
-        {
-            Slogan: "Smooth as your morning Decaf.",
-            Tags: "Coffee-themed, Chill",
-        },
-        {
-            Slogan: "All the kick, none of the crash.",
-            Tags: "Coffee-themed, Energetic",
-        },
-        {
-            Slogan: "Sip back and ship faster.",
-            Tags: "Coffee-themed, Fun",
-        },
-        {
-            Slogan: "Keep calm and code Decaf.",
-            Tags: "Coffee-themed, Playful",
-        },
-        {
-            Slogan: "Code without the caffeine shakes.",
-            Tags: "Coffee-themed, Humorous",
-        },
-        {
-            Slogan: "Your fullstack, decaffeinated.",
-            Tags: "Coffee-themed, Technical",
-        },
-        {
-            Slogan: "Decaf-TS: Where smart contracts meet smart interfaces.",
-            Tags: "Blockchain, Smart Contracts, Tech",
-        },
-        {
-            Slogan: "Ship dApps without the stress.",
-            Tags: "Blockchain, Cheerful, Developer",
-        },
-        {
-            Slogan: "No CRUD, no problem \u2014 Decaf your data.",
-            Tags: "Data, No-CRUD, Chill",
-        },
-        {
-            Slogan: "From DID to UI, without breaking a sweat.",
-            Tags: "DID, SSI, UI, Calm",
-        },
-        {
-            Slogan: "Decaf-TS: Your frontend already understands your smart contract.",
-            Tags: "Smart Contracts, DX, Magic",
-        },
-        {
-            Slogan: "Self-sovereign by design. Productive by default.",
-            Tags: "SSI, Developer, Calm",
-        },
-        {
-            Slogan: "Build once. Deploy everywhere. Decentralized and delightful.",
-            Tags: "Blockchain, Multi-platform, Happy",
-        },
-        {
-            Slogan: "Data that defines its own destiny.",
-            Tags: "SSI, Data-driven, Empowerment",
-        },
-        {
-            Slogan: "Goodbye CRUD, hello intent-based interfaces.",
-            Tags: "No-CRUD, UI, Technical",
-        },
-        {
-            Slogan: "The smoothest path from DID to done.",
-            Tags: "DID, Workflow, Chill",
-        },
-        {
-            Slogan: "Because your dApp deserves more than boilerplate.",
-            Tags: "Blockchain, DevX, Efficiency",
-        },
-        {
-            Slogan: "Own your data. Own your flow.",
-            Tags: "SSI, Control, Ownership",
-        },
-        {
-            Slogan: "Write logic like it belongs with the data \u2014 because it does.",
-            Tags: "Data Logic, Developer, Smart",
-        },
-        {
-            Slogan: "From smart contracts to smarter frontends.",
-            Tags: "Smart Contracts, UI, DX",
-        },
-        {
-            Slogan: "No caffeine. No CRUD. Just the future.",
-            Tags: "No-CRUD, Coffee-themed, Futuristic",
-        },
-        {
-            Slogan: "The future of web3 UX is Decaf.",
-            Tags: "Blockchain, UX, Vision",
-        },
-        {
-            Slogan: "Code with confidence. Govern with clarity.",
-            Tags: "Blockchain, Governance, Calm",
-        },
-        {
-            Slogan: "Interfaces that obey the data, not the other way around.",
-            Tags: "UI, Data Logic, Self-aware",
-        },
-        {
-            Slogan: "Brew business logic right into your bytes.",
-            Tags: "Data Logic, Coffee-themed, Fun",
-        },
-        {
-            Slogan: "DIDs done differently \u2014 and delightfully.",
-            Tags: "DID, Self-Sovereign, Playful",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",
-            Tags: "Blockchain, Smart Contracts, Tech",
-        },
-        {
-            Slogan: "Ship dApps without the stress.",
-            Tags: "Blockchain, Cheerful, Developer",
-        },
-        {
-            Slogan: "No boilerplate, no problem \u2014 Decaf-TS your data.",
-            Tags: "Data, No-CRUD, Chill",
-        },
-        {
-            Slogan: "From DID to UI, without breaking a sweat.",
-            Tags: "DID, SSI, UI, Calm",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Your frontend already understands your blockchain contract.",
-            Tags: "Smart Contracts, DX, Magic",
-        },
-        {
-            Slogan: "Self-sovereign by design. Productive by default.",
-            Tags: "SSI, Developer, Calm",
-        },
-        {
-            Slogan: "Build once. Deploy everywhere. Decentralized and delightful.",
-            Tags: "Blockchain, Multi-platform, Happy",
-        },
-        {
-            Slogan: "Data that defines its own destiny.",
-            Tags: "SSI, Data-driven, Empowerment",
-        },
-        {
-            Slogan: "Goodbye boilerplate, hello intent-based interfaces.",
-            Tags: "No-CRUD, UI, Technical",
-        },
-        {
-            Slogan: "The smoothest path from DID to done.",
-            Tags: "DID, Workflow, Chill",
-        },
-        {
-            Slogan: "Because your dApp deserves more than boilerplate.",
-            Tags: "Blockchain, DevX, Efficiency",
-        },
-        {
-            Slogan: "Own your data. Own your flow.",
-            Tags: "SSI, Control, Ownership",
-        },
-        {
-            Slogan: "Write logic like it belongs with the data \u2014 because it does.",
-            Tags: "Data Logic, Developer, Smart",
-        },
-        {
-            Slogan: "From blockchain contracts to smarter frontends.",
-            Tags: "Smart Contracts, UI, DX",
-        },
-        {
-            Slogan: "No caffeine. No boilerplate. Just the future.",
-            Tags: "No-CRUD, Coffee-themed, Futuristic",
-        },
-        {
-            Slogan: "The future of web3 UX is Decaf-TS.",
-            Tags: "Blockchain, UX, Vision",
-        },
-        {
-            Slogan: "Code with confidence. Govern with clarity.",
-            Tags: "Blockchain, Governance, Calm",
-        },
-        {
-            Slogan: "Interfaces that obey the data, not the other way around.",
-            Tags: "UI, Data Logic, Self-aware",
-        },
-        {
-            Slogan: "Brew business logic right into your bytes.",
-            Tags: "Data Logic, Coffee-themed, Fun",
-        },
-        {
-            Slogan: "DIDs done differently \u2014 and delightfully.",
-            Tags: "DID, Self-Sovereign, Playful",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",
-            Tags: "Blockchain, Smart Contracts, Tech",
-        },
-        {
-            Slogan: "Ship dApps without the stress.",
-            Tags: "Blockchain, Cheerful, Developer",
-        },
-        {
-            Slogan: "No boilerplate, no problem \u2014 Decaf-TS your data.",
-            Tags: "Data, No-CRUD, Chill",
-        },
-        {
-            Slogan: "From DID to UI, without breaking a sweat.",
-            Tags: "DID, SSI, UI, Calm",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Your frontend already understands your blockchain contract.",
-            Tags: "Smart Contracts, DX, Magic",
-        },
-        {
-            Slogan: "Self-sovereign by design. Productive by default.",
-            Tags: "SSI, Developer, Calm",
-        },
-        {
-            Slogan: "Build once. Deploy everywhere. Decentralized and delightful.",
-            Tags: "Blockchain, Multi-platform, Happy",
-        },
-        {
-            Slogan: "Data that defines its own destiny.",
-            Tags: "SSI, Data-driven, Empowerment",
-        },
-        {
-            Slogan: "Goodbye boilerplate, hello intent-based interfaces.",
-            Tags: "No-CRUD, UI, Technical",
-        },
-        {
-            Slogan: "The smoothest path from DID to done.",
-            Tags: "DID, Workflow, Chill",
-        },
-        {
-            Slogan: "Because your dApp deserves more than boilerplate.",
-            Tags: "Blockchain, DevX, Efficiency",
-        },
-        {
-            Slogan: "Own your data. Own your flow.",
-            Tags: "SSI, Control, Ownership",
-        },
-        {
-            Slogan: "Write logic like it belongs with the data \u2014 because it does.",
-            Tags: "Data Logic, Developer, Smart",
-        },
-        {
-            Slogan: "From blockchain contracts to smarter frontends.",
-            Tags: "Smart Contracts, UI, DX",
-        },
-        {
-            Slogan: "No caffeine. No boilerplate. Just the future.",
-            Tags: "No-CRUD, Coffee-themed, Futuristic",
-        },
-        {
-            Slogan: "The future of web3 UX is Decaf-TS.",
-            Tags: "Blockchain, UX, Vision",
-        },
-        {
-            Slogan: "Code with confidence. Govern with clarity.",
-            Tags: "Blockchain, Governance, Calm",
-        },
-        {
-            Slogan: "Interfaces that obey the data, not the other way around.",
-            Tags: "UI, Data Logic, Self-aware",
-        },
-        {
-            Slogan: "Brew business logic right into your bytes.",
-            Tags: "Data Logic, Coffee-themed, Fun",
-        },
-        {
-            Slogan: "DIDs done differently \u2014 and delightfully.",
-            Tags: "DID, Self-Sovereign, Playful",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",
-            Tags: "Blockchain, Smart Contracts, Tech",
-        },
-        {
-            Slogan: "Ship dApps without the stress.",
-            Tags: "Blockchain, Cheerful, Developer",
-        },
-        {
-            Slogan: "No boilerplate, no problem \u2014 Decaf-TS your data.",
-            Tags: "Data, No-CRUD, Chill",
-        },
-        {
-            Slogan: "From DID to UI, without breaking a sweat.",
-            Tags: "DID, SSI, UI, Calm",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Your frontend already understands your blockchain contract.",
-            Tags: "Smart Contracts, DX, Magic",
-        },
-        {
-            Slogan: "Self-sovereign by design. Productive by default.",
-            Tags: "SSI, Developer, Calm",
-        },
-        {
-            Slogan: "Build once. Deploy everywhere. Decentralized and delightful.",
-            Tags: "Blockchain, Multi-platform, Happy",
-        },
-        {
-            Slogan: "Data that defines its own destiny.",
-            Tags: "SSI, Data-driven, Empowerment",
-        },
-        {
-            Slogan: "Goodbye boilerplate, hello intent-based interfaces.",
-            Tags: "No-CRUD, UI, Technical",
-        },
-        {
-            Slogan: "The smoothest path from DID to done.",
-            Tags: "DID, Workflow, Chill",
-        },
-        {
-            Slogan: "Because your dApp deserves more than boilerplate.",
-            Tags: "Blockchain, DevX, Efficiency",
-        },
-        {
-            Slogan: "Own your data. Own your flow.",
-            Tags: "SSI, Control, Ownership",
-        },
-        {
-            Slogan: "Write logic like it belongs with the data \u2014 because it does.",
-            Tags: "Data Logic, Developer, Smart",
-        },
-        {
-            Slogan: "From blockchain contracts to smarter frontends.",
-            Tags: "Smart Contracts, UI, DX",
-        },
-        {
-            Slogan: "No caffeine. No boilerplate. Just the future.",
-            Tags: "No-CRUD, Coffee-themed, Futuristic",
-        },
-        {
-            Slogan: "The future of web3 UX is Decaf-TS.",
-            Tags: "Blockchain, UX, Vision",
-        },
-        {
-            Slogan: "Code with confidence. Govern with clarity.",
-            Tags: "Blockchain, Governance, Calm",
-        },
-        {
-            Slogan: "Interfaces that obey the data, not the other way around.",
-            Tags: "UI, Data Logic, Self-aware",
-        },
-        {
-            Slogan: "Brew business logic right into your bytes.",
-            Tags: "Data Logic, Coffee-themed, Fun",
-        },
-        {
-            Slogan: "DIDs done differently \u2014 and delightfully.",
-            Tags: "DID, Self-Sovereign, Playful",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",
-            Tags: "Blockchain, Smart Contracts, Tech",
-        },
-        {
-            Slogan: "Ship dApps without the stress.",
-            Tags: "Blockchain, Cheerful, Developer",
-        },
-        {
-            Slogan: "No boilerplate, no problem \u2014 Decaf-TS your data.",
-            Tags: "Data, No-CRUD, Chill",
-        },
-        {
-            Slogan: "From DID to UI, without breaking a sweat.",
-            Tags: "DID, SSI, UI, Calm",
-        },
-        {
-            Slogan: "Decaf-TS-TS: Your frontend already understands your blockchain contract.",
-            Tags: "Smart Contracts, DX, Magic",
-        },
-        {
-            Slogan: "Self-sovereign by design. Productive by default.",
-            Tags: "SSI, Developer, Calm",
-        },
-        {
-            Slogan: "Build once. Deploy everywhere. Decentralized and delightful.",
-            Tags: "Blockchain, Multi-platform, Happy",
-        },
-        {
-            Slogan: "Data that defines its own destiny.",
-            Tags: "SSI, Data-driven, Empowerment",
-        },
-        {
-            Slogan: "Goodbye boilerplate, hello intent-based interfaces.",
-            Tags: "No-CRUD, UI, Technical",
-        },
-        {
-            Slogan: "The smoothest path from DID to done.",
-            Tags: "DID, Workflow, Chill",
-        },
-        {
-            Slogan: "Because your dApp deserves more than boilerplate.",
-            Tags: "Blockchain, DevX, Efficiency",
-        },
-        {
-            Slogan: "Own your data. Own your flow.",
-            Tags: "SSI, Control, Ownership",
-        },
-        {
-            Slogan: "Write logic like it belongs with the data \u2014 because it does.",
-            Tags: "Data Logic, Developer, Smart",
-        },
-        {
-            Slogan: "From blockchain contracts to smarter frontends.",
-            Tags: "Smart Contracts, UI, DX",
-        },
-        {
-            Slogan: "No caffeine. No boilerplate. Just the future.",
-            Tags: "No-CRUD, Coffee-themed, Futuristic",
-        },
-        {
-            Slogan: "The future of web3 UX is Decaf-TS.",
-            Tags: "Blockchain, UX, Vision",
-        },
-        {
-            Slogan: "Code with confidence. Govern with clarity.",
-            Tags: "Blockchain, Governance, Calm",
-        },
-        {
-            Slogan: "Interfaces that obey the data, not the other way around.",
-            Tags: "UI, Data Logic, Self-aware",
-        },
-        {
-            Slogan: "Brew business logic right into your bytes.",
-            Tags: "Data Logic, Coffee-themed, Fun",
-        },
-        {
-            Slogan: "DIDs done differently \u2014 and delightfully.",
-            Tags: "DID, Self-Sovereign, Playful",
-        },
-    ];
-
-    /**
-     * @description Array of ANSI color codes for banner styling.
-     * @summary Defines a set of ANSI color codes used to style the banner text.
-     * @memberOf module:utils
-     */
-    const colors = [
-        "\x1b[38;5;215m", // soft orange
-        "\x1b[38;5;209m", // coral
-        "\x1b[38;5;205m", // pink
-        "\x1b[38;5;210m", // peachy
-        "\x1b[38;5;217m", // salmon
-        "\x1b[38;5;216m", // light coral
-        "\x1b[38;5;224m", // light peach
-        "\x1b[38;5;230m", // soft cream
-        "\x1b[38;5;230m", // soft cream
-    ];
-    /**
-     * @description Prints a styled banner to the console.
-     * @summary Generates and prints a colorful ASCII art banner with a random slogan.
-     * @param {Logger} [logger] - Optional logger for verbose output.
-     * @memberOf module:utils
-     * @function printBanner
-     * @mermaid
-     * sequenceDiagram
-     *   participant printBanner
-     *   participant getSlogan
-     *   participant padEnd
-     *   participant console
-     *   printBanner->>getSlogan: Call getSlogan()
-     *   getSlogan-->>printBanner: Return random slogan
-     *   printBanner->>printBanner: Create banner ASCII art
-     *   printBanner->>printBanner: Split banner into lines
-     *   printBanner->>printBanner: Calculate max line length
-     *   printBanner->>padEnd: Call padEnd with slogan
-     *   padEnd-->>printBanner: Return padded slogan line
-     *   loop For each banner line
-     *     printBanner->>style: Call style(line)
-     *     style-->>printBanner: Return styled line
-     *     printBanner->>console: Log styled line
-     *   end
-     */
-    function printBanner(logger) {
-        const message = getSlogan();
-        const banner = `#                 ░▒▓███████▓▒░  ░▒▓████████▓▒░  ░▒▓██████▓▒░   ░▒▓██████▓▒░  ░▒▓████████▓▒░       ░▒▓████████▓▒░  ░▒▓███████▓▒░ 
-#      ( (        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓█▓▒░        
-#       ) )       ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓█▓▒░        
-#    [=======]    ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓██████▓▒░   ░▒▓█▓▒░        ░▒▓████████▓▒░ ░▒▓██████▓▒░            ░▒▓█▓▒░      ░▒▓██████▓▒░  
-#     \`-----´     ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░            ░▒▓█▓▒░ 
-#                 ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░            ░▒▓█▓▒░ 
-#                 ░▒▓███████▓▒░  ░▒▓████████▓▒░  ░▒▓██████▓▒░  ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓███████▓▒░  
-#`.split("\n");
-        const maxLength = banner.reduce((max, line) => Math.max(max, line.length), 0);
-        banner.push(`#  ${message.padStart(maxLength - 3)}`);
-        banner.forEach((line, index) => {
-            (logger ? logger.info.bind(logger) : console.log.bind(console))(styledStringBuilder.style(line || "").raw(colors[index]).text);
-        });
-    }
-    /**
-     * @description Retrieves a slogan from the predefined list.
-     * @summary Fetches a random slogan or a specific one by index from the slogans list.
-     * @param {number} [i] - Optional index to retrieve a specific slogan.
-     * @return {string} The selected slogan.
-     * @function getSlogan
-     * @memberOf module:utils
-     * @mermaid
-     * sequenceDiagram
-     *   participant getSlogan
-     *   participant Math.random
-     *   participant slogans
-     *   alt i is undefined
-     *     getSlogan->>Math.random: Generate random index
-     *     Math.random-->>getSlogan: Return random index
-     *   else i is defined
-     *     Note over getSlogan: Use provided index
-     *   end
-     *   getSlogan->>slogans: Access slogan at index
-     *   slogans-->>getSlogan: Return slogan
-     *   alt Error occurs
-     *     getSlogan->>getSlogan: Throw error
-     *   end
-     *   getSlogan-->>Caller: Return slogan
-     */
-    function getSlogan(i) {
-        try {
-            i =
-                typeof i === "undefined" ? Math.floor(Math.random() * slogans.length) : i;
-            return slogans[i].Slogan;
-        }
-        catch (error) {
-            throw new Error(`Failed to retrieve slogans: ${error}`);
-        }
-    }
-
-    /**
-     * @class Command
-     * @abstract
-     * @template I - The type of input options for the command.
-     * @template R - The return type of the command execution.
-     * @memberOf module:utils
-     * @description Abstract base class for command implementation.
-     * @summary Provides a structure for creating command-line interface commands with input handling, logging, and execution flow.
-     *
-     * @param {string} name - The name of the command.
-     * @param {CommandOptions<I>} [inputs] - The input options for the command.
-     * @param {string[]} [requirements] - The list of required dependencies for the command.
-     */
-    class Command extends logging.LoggedClass {
-        constructor(name, inputs = {}, requirements = []) {
-            super();
-            this.name = name;
-            this.inputs = inputs;
-            this.requirements = requirements;
-            if (!Command.log) {
-                Object.defineProperty(Command, "log", {
-                    writable: false,
-                    value: logging.Logging.for(Command.name),
-                });
-            }
-            this.inputs = Object.assign({}, DefaultCommandOptions, inputs);
-        }
-        /**
-         * @protected
-         * @async
-         * @description Checks if all required dependencies are present.
-         * @summary Retrieves the list of dependencies and compares it against the required dependencies for the command.
-         * @returns {Promise<void>} A promise that resolves when the check is complete.
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant Command
-         *   participant getDependencies
-         *   participant Set
-         *   Command->>getDependencies: Call
-         *   getDependencies-->>Command: Return {prod, dev, peer}
-         *   Command->>Set: Create Set from prod, dev, peer
-         *   Set-->>Command: Return unique dependencies
-         *   Command->>Command: Compare against requirements
-         *   alt Missing dependencies
-         *     Command->>Command: Add to missing list
-         *   end
-         *   Note over Command: If missing.length > 0, handle missing dependencies
-         */
-        async checkRequirements() {
-            const { prod, dev, peer } = await getDependencies();
-            const missing = [];
-            const fullList = Array.from(new Set([...prod, ...dev, ...peer]).values()).map((d) => d.name);
-            for (const dep of this.requirements)
-                if (!fullList.includes(dep))
-                    missing.push(dep);
-            if (!missing.length)
-                return;
-        }
-        /**
-         * @protected
-         * @description Provides help information for the command.
-         * @summary This method should be overridden in derived classes to provide specific help information.
-         * @param {ParseArgsResult} args - The parsed command-line arguments.
-         * @returns {void}
-         */
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        help(args) {
-            return this.log.info(`This is help. I'm no use because I should have been overridden.`);
-        }
-        /**
-         * @async
-         * @description Executes the command.
-         * @summary This method handles the overall execution flow of the command, including parsing arguments,
-         * setting up logging, checking for version or help requests, and running the command.
-         * @returns {Promise<R | string | void>} A promise that resolves with the command's result.
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant Command
-         *   participant UserInput
-         *   participant Logging
-         *   participant getPackageVersion
-         *   participant printBanner
-         *   Command->>UserInput: parseArgs(inputs)
-         *   UserInput-->>Command: Return ParseArgsResult
-         *   Command->>Command: Process options
-         *   Command->>Logging: setConfig(options)
-         *   alt version requested
-         *     Command->>getPackageVersion: Call
-         *     getPackageVersion-->>Command: Return version
-         *   else help requested
-         *     Command->>Command: help(args)
-         *   else banner requested
-         *     Command->>printBanner: Call
-         *   end
-         *   Command->>Command: run(args)
-         *   alt error occurs
-         *     Command->>Command: Log error
-         *   end
-         *   Command-->>Command: Return result
-         */
-        async execute() {
-            const args = UserInput.parseArgs(this.inputs);
-            const env = logging.LoggedEnvironment.accumulate(DefaultCommandValues).accumulate(args.values);
-            const { version, help, banner } = env;
-            if (version) {
-                return getPackageVersion();
-            }
-            if (help) {
-                return this.help(args);
-            }
-            if (banner)
-                printBanner(this.log.for(printBanner, {
-                    timestamp: false,
-                    style: false,
-                    context: false,
-                    logLevel: false,
-                }));
-            let result;
-            try {
-                result = await this.run(env);
-            }
-            catch (e) {
-                this.log.error(`Error while running provided cli function: ${e}`);
-                throw e;
-            }
-            return result;
-        }
-    }
-
-    /* istanbul ignore file */
-    /**
-     * @description A simple HTTP client for downloading files.
-     * @summary This class provides functionality to download files from HTTPS URLs.
-     * It uses Node.js built-in https module to make requests.
-     *
-     * @class HttpClient
-     */
-    class HttpClient {
-        static { this.log = logging.Logging.for(HttpClient); }
-        /**
-         * @description Downloads a file from a given URL.
-         * @summary This method sends a GET request to the specified URL and returns the response body as a string.
-         * It handles different scenarios such as non-200 status codes and network errors.
-         *
-         * @param url - The URL of the file to download.
-         * @return A promise that resolves with the file content as a string.
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant Client
-         *   participant HttpClient
-         *   participant HTTPS
-         *   participant Server
-         *   Client->>HttpClient: downloadFile(url)
-         *   HttpClient->>HTTPS: get(url)
-         *   HTTPS->>Server: GET request
-         *   Server-->>HTTPS: Response
-         *   HTTPS-->>HttpClient: Response object
-         *   alt Status code is 200
-         *     loop For each data chunk
-         *       HTTPS->>HttpClient: 'data' event
-         *       HttpClient->>HttpClient: Accumulate data
-         *     end
-         *     HTTPS->>HttpClient: 'end' event
-         *     HttpClient-->>Client: Resolve with data
-         *   else Status code is not 200
-         *     HttpClient-->>Client: Reject with error
-         *   end
-         */
-        static async downloadFile(url) {
-            return new Promise((resolve, reject) => {
-                function request(url) {
-                    url = encodeURI(url);
-                    https__default["default"].get(url, (res) => {
-                        if (res.statusCode === 301 || res.statusCode === 307)
-                            return request(res.headers.location);
-                        if (res.statusCode !== 200) {
-                            HttpClient.log.error(`Failed to fetch ${url} (status: ${res.statusCode})`);
-                            return reject(new Error(`Failed to fetch ${url}`));
-                        }
-                        let data = "";
-                        res.on("data", (chunk) => {
-                            data += chunk;
-                        });
-                        res.on("error", (error) => {
-                            reject(error);
-                        });
-                        res.on("end", () => {
-                            resolve(data);
-                        });
-                    });
-                }
-                request(url);
-            });
-        }
-    }
-
-    function parseList(input) {
-        if (!input)
-            return [];
-        if (Array.isArray(input))
-            return input.map((i) => `${i}`.trim()).filter(Boolean);
-        return `${input}`
-            .split(",")
-            .map((p) => p.trim())
-            .filter(Boolean);
-    }
-    function packageToGlobal(name) {
-        // Remove scope and split by non-alphanumeric chars, then camelCase
-        const withoutScope = name.replace(/^@/, "");
-        const parts = withoutScope.split(/[/\-_.]+/).filter(Boolean);
-        return parts
-            .map((p, i) => i === 0
-            ? p.replace(/[^a-zA-Z0-9]/g, "")
-            : `${p.charAt(0).toUpperCase()}${p.slice(1)}`)
-            .join("");
-    }
-    function getPackageDependencies() {
-        // Try the current working directory first
-        let pkg;
-        try {
-            pkg = getPackage(process.cwd());
-        }
-        catch {
-            pkg = undefined;
-        }
-        // If no dependencies found in cwd, try the package next to this source file (fallback for tests)
-        try {
-            const hasDeps = pkg &&
-                (Object.keys(pkg.dependencies || {}).length > 0 ||
-                    Object.keys(pkg.devDependencies || {}).length > 0 ||
-                    Object.keys(pkg.peerDependencies || {}).length > 0);
-            if (!hasDeps) {
-                const fallbackDir = path__default["default"].resolve(__dirname, "../../..");
-                try {
-                    pkg = getPackage(fallbackDir);
-                }
-                catch {
-                    // ignore and keep pkg as-is
-                }
-            }
-        }
-        catch {
-            // ignore
-        }
-        const deps = Object.keys((pkg && pkg.dependencies) || {});
-        const peer = Object.keys((pkg && pkg.peerDependencies) || {});
-        const dev = Object.keys((pkg && pkg.devDependencies) || {});
-        return Array.from(new Set([...deps, ...peer, ...dev]));
-    }
-    const VERSION_STRING = "0.4.1";
-    const PACKAGE_STRING = "@decaf-ts/utils";
-    var Modes;
-    (function (Modes) {
-        Modes["CJS"] = "commonjs";
-        Modes["ESM"] = "es2022";
-    })(Modes || (Modes = {}));
-    var BuildMode;
-    (function (BuildMode) {
-        BuildMode["BUILD"] = "build";
-        BuildMode["BUNDLE"] = "bundle";
-        BuildMode["ALL"] = "all";
-    })(BuildMode || (BuildMode = {}));
-    const options$2 = {
-        prod: {
-            type: "boolean",
-            default: false,
-        },
-        dev: {
-            type: "boolean",
-            default: false,
-        },
-        buildMode: {
-            type: "string",
-            default: BuildMode.ALL,
-        },
-        includes: {
-            type: "string",
-            default: "",
-        },
-        externals: {
-            type: "string",
-            default: "",
-        },
-        docs: {
-            type: "boolean",
-            default: false,
-        },
-        commands: {
-            type: "boolean",
-            default: false,
-        },
-        banner: {
-            type: "boolean",
-            default: false,
-        },
-    };
-    const cjs2Transformer = (ext = ".cjs") => {
-        const log = BuildScripts.log.for(cjs2Transformer);
-        const resolutionCache = new Map();
-        return (transformationContext) => {
-            return (sourceFile) => {
-                const sourceDir = path__default["default"].dirname(sourceFile.fileName);
-                function resolvePath(importPath) {
-                    const cacheKey = JSON.stringify([sourceDir, importPath]);
-                    const cachedValue = resolutionCache.get(cacheKey);
-                    if (cachedValue != null)
-                        return cachedValue;
-                    let resolvedPath = importPath;
-                    try {
-                        resolvedPath = path__default["default"].resolve(sourceDir, resolvedPath + ".ts");
-                    }
-                    catch (error) {
-                        throw new Error(`Failed to resolve path ${importPath}: ${error}`);
-                    }
-                    let stat;
-                    try {
-                        stat = fs__default["default"].statSync(resolvedPath);
-                    }
-                    catch (e) {
-                        try {
-                            log.verbose(`Testing existence of path ${resolvedPath} as a folder defaulting to index file`);
-                            stat = fs__default["default"].statSync(resolvedPath.replace(/\.ts$/gm, ""));
-                        }
-                        catch (e2) {
-                            throw new Error(`Failed to resolve path ${importPath}: ${e}, ${e2}`);
-                        }
-                    }
-                    if (stat.isDirectory())
-                        resolvedPath = resolvedPath.replace(/\.ts$/gm, "/index.ts");
-                    if (path__default["default"].isAbsolute(resolvedPath)) {
-                        const extension = (/\.tsx?$/.exec(path__default["default"].basename(resolvedPath)) || [])[0] || void 0;
-                        resolvedPath =
-                            "./" +
-                                path__default["default"].relative(sourceDir, path__default["default"].resolve(path__default["default"].dirname(resolvedPath), path__default["default"].basename(resolvedPath, extension) + ext));
-                    }
-                    resolutionCache.set(cacheKey, resolvedPath);
-                    return resolvedPath;
-                }
-                function visitNode(node) {
-                    if (shouldMutateModuleSpecifier(node)) {
-                        if (ts__namespace.isImportDeclaration(node)) {
-                            const resolvedPath = resolvePath(node.moduleSpecifier.text);
-                            const newModuleSpecifier = transformationContext.factory.createStringLiteral(resolvedPath);
-                            return transformationContext.factory.updateImportDeclaration(node, node.modifiers, node.importClause, newModuleSpecifier, undefined);
-                        }
-                        else if (ts__namespace.isExportDeclaration(node)) {
-                            const resolvedPath = resolvePath(node.moduleSpecifier.text);
-                            const newModuleSpecifier = transformationContext.factory.createStringLiteral(resolvedPath);
-                            return transformationContext.factory.updateExportDeclaration(node, node.modifiers, node.isTypeOnly, node.exportClause, newModuleSpecifier, undefined);
-                        }
-                    }
-                    return ts__namespace.visitEachChild(node, visitNode, transformationContext);
-                }
-                function shouldMutateModuleSpecifier(node) {
-                    if (!ts__namespace.isImportDeclaration(node) && !ts__namespace.isExportDeclaration(node))
-                        return false;
-                    if (node.moduleSpecifier === undefined)
-                        return false;
-                    // only when module specifier is valid
-                    if (!ts__namespace.isStringLiteral(node.moduleSpecifier))
-                        return false;
-                    // only when path is relative
-                    if (!node.moduleSpecifier.text.startsWith("./") &&
-                        !node.moduleSpecifier.text.startsWith("../"))
-                        return false;
-                    // only when module specifier has no extension
-                    if (path__default["default"].extname(node.moduleSpecifier.text) !== "")
-                        return false;
-                    return true;
-                }
-                return ts__namespace.visitNode(sourceFile, visitNode);
-            };
-        };
-    };
-    class BuildScripts extends Command {
-        constructor() {
-            super("BuildScripts", Object.assign({}, DefaultCommandOptions, options$2));
-            this.replacements = {};
-            const pkg = getPackage();
-            const { name, version } = pkg;
-            this.pkgName = name.includes("@") ? name.split("/")[1] : name;
-            this.pkgVersion = version;
-            this.replacements[VERSION_STRING] = this.pkgVersion;
-            this.replacements[PACKAGE_STRING] = name;
-        }
-        patchFiles(p) {
-            const log = this.log.for(this.patchFiles);
-            const { name, version } = getPackage();
-            log.info(`Patching ${name} ${version} module in ${p}...`);
-            const stat = fs__default["default"].statSync(p);
-            if (stat.isDirectory())
-                fs__default["default"].readdirSync(p, { withFileTypes: true, recursive: true })
-                    .filter((p) => p.isFile())
-                    .forEach((file) => patchFile(path__default["default"].join(file.parentPath, file.name), this.replacements));
-            log.verbose(`Module ${name} ${version} patched in ${p}...`);
-        }
-        reportDiagnostics(diagnostics, logLevel) {
-            const msg = this.formatDiagnostics(diagnostics);
-            if (!Object.values(logging.LogLevel).includes(logLevel))
-                throw new Error(`Invalid LogLevel ${logLevel}`);
-            try {
-                this.log[logLevel](msg);
-            }
-            catch (e) {
-                console.warn(`Failed to get logger for ${logLevel}`);
-                throw e;
-            }
-            return msg;
-        }
-        // Format diagnostics into a single string for throwing or logging
-        formatDiagnostics(diagnostics) {
-            return diagnostics
-                .map((diagnostic) => {
-                let message = "";
-                if (diagnostic.file && diagnostic.start) {
-                    const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
-                    message += `${diagnostic.file.fileName} (${line + 1},${character + 1})`;
-                }
-                message +=
-                    ": " + ts__namespace.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
-                return message;
-            })
-                .join("\n");
-        }
-        readConfigFile(configFileName) {
-            // Read config file
-            const configFileText = fs__default["default"].readFileSync(configFileName).toString();
-            // Parse JSON, after removing comments. Just fancier JSON.parse
-            const result = ts__namespace.parseConfigFileTextToJson(configFileName, configFileText);
-            const configObject = result.config;
-            if (!configObject) {
-                this.reportDiagnostics([result.error], logging.LogLevel.error);
-            }
-            // Extract config infromation
-            const configParseResult = ts__namespace.parseJsonConfigFileContent(configObject, ts__namespace.sys, path__default["default"].dirname(configFileName));
-            if (configParseResult.errors.length > 0)
-                this.reportDiagnostics(configParseResult.errors, logging.LogLevel.error);
-            return configParseResult;
-        }
-        evalDiagnostics(diagnostics) {
-            if (diagnostics && diagnostics.length > 0) {
-                const errors = diagnostics.filter((d) => d.category === ts__namespace.DiagnosticCategory.Error);
-                const warnings = diagnostics.filter((d) => d.category === ts__namespace.DiagnosticCategory.Warning);
-                const suggestions = diagnostics.filter((d) => d.category === ts__namespace.DiagnosticCategory.Suggestion);
-                const messages = diagnostics.filter((d) => d.category === ts__namespace.DiagnosticCategory.Message);
-                // Log diagnostics to console
-                if (warnings.length)
-                    this.reportDiagnostics(warnings, logging.LogLevel.info);
-                if (errors.length) {
-                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                    this.reportDiagnostics(diagnostics, logging.LogLevel.error);
-                    this.log.info(`TypeScript reported ${diagnostics.length} diagnostic(s) during check; aborting.`);
-                    // throw new Error(
-                    //   `TypeScript reported ${diagnostics.length} diagnostic(s) during check; aborting.`
-                    // );
-                }
-                if (suggestions.length)
-                    this.reportDiagnostics(suggestions, logging.LogLevel.info);
-                if (messages.length)
-                    this.reportDiagnostics(messages, logging.LogLevel.info);
-            }
-        }
-        preCheckDiagnostics(program) {
-            const diagnostics = ts__namespace.getPreEmitDiagnostics(program);
-            this.evalDiagnostics(diagnostics);
-        }
-        // Create a TypeScript program for the current tsconfig and fail if there are any error diagnostics.
-        async checkTsDiagnostics(isDev, mode, bundle = false) {
-            const log = this.log.for(this.checkTsDiagnostics);
-            let tsConfig;
-            try {
-                tsConfig = this.readConfigFile("./tsconfig.json");
-            }
-            catch (e) {
-                throw new Error(`Failed to parse tsconfig.json: ${e}`);
-            }
-            if (bundle) {
-                tsConfig.options.module = ts.ModuleKind.AMD;
-                tsConfig.options.outDir = "dist";
-                tsConfig.options.isolatedModules = false;
-                tsConfig.options.outFile = this.pkgName;
-            }
-            else {
-                tsConfig.options.outDir = `lib${mode === Modes.ESM ? "/esm" : ""}`;
-                tsConfig.options.module =
-                    mode === Modes.ESM ? ts.ModuleKind.ES2022 : ts.ModuleKind.CommonJS;
-            }
-            if (isDev) {
-                tsConfig.options.inlineSourceMap = true;
-                tsConfig.options.sourceMap = false;
-            }
-            else {
-                tsConfig.options.sourceMap = false;
-            }
-            const program = ts__namespace.createProgram(tsConfig.fileNames, tsConfig.options);
-            this.preCheckDiagnostics(program);
-            log.verbose(`TypeScript checks passed (${bundle ? "bundle" : "normal"} mode).`);
-        }
-        async buildTs(isDev, mode, bundle = false) {
-            const log = this.log.for(this.buildTs);
-            log.info(`Building ${this.pkgName} ${this.pkgVersion} module (${mode}) in ${isDev ? "dev" : "prod"} mode...`);
-            let tsConfig;
-            try {
-                tsConfig = this.readConfigFile("./tsconfig.json");
-            }
-            catch (e) {
-                throw new Error(`Failed to parse tsconfig.json: ${e}`);
-            }
-            if (bundle) {
-                tsConfig.options.module = ts.ModuleKind.AMD;
-                tsConfig.options.outDir = "dist";
-                tsConfig.options.isolatedModules = false;
-                tsConfig.options.outFile = this.pkgName;
-            }
-            else {
-                tsConfig.options.outDir = `lib${mode === Modes.ESM ? "/esm" : ""}`;
-                tsConfig.options.module =
-                    mode === Modes.ESM ? ts.ModuleKind.ES2022 : ts.ModuleKind.CommonJS;
-            }
-            if (isDev) {
-                tsConfig.options.inlineSourceMap = true;
-                tsConfig.options.sourceMap = false;
-            }
-            else {
-                tsConfig.options.sourceMap = false;
-            }
-            const program = ts__namespace.createProgram(tsConfig.fileNames, tsConfig.options);
-            const transformations = {};
-            if (mode === Modes.CJS) {
-                transformations.before = [cjs2Transformer(".cjs")];
-            }
-            else if (mode === Modes.ESM) {
-                transformations.before = [cjs2Transformer(".js")];
-            }
-            const emitResult = program.emit(undefined, undefined, undefined, undefined, transformations);
-            const allDiagnostics = ts__namespace
-                .getPreEmitDiagnostics(program)
-                .concat(emitResult.diagnostics);
-            this.evalDiagnostics(allDiagnostics);
-        }
-        async build(isDev, mode, bundle = false) {
-            const log = this.log.for(this.build);
-            await this.buildTs(isDev, mode, bundle);
-            log.verbose(`Module ${this.pkgName} ${this.pkgVersion} (${mode}) built in ${isDev ? "dev" : "prod"} mode...`);
-            if (mode === Modes.CJS && !bundle) {
-                const files = getAllFiles("lib", (file) => file.endsWith(".js") && !file.includes("/esm/"));
-                for (const file of files) {
-                    log.verbose(`Patching ${file}'s cjs imports...`);
-                    const f = file.replace(".js", ".cjs");
-                    await renameFile(file, f);
-                }
-            }
-        }
-        copyAssets(mode) {
-            const log = this.log.for(this.copyAssets);
-            let hasAssets = false;
-            try {
-                hasAssets = fs__default["default"].statSync("./src/assets").isDirectory();
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (e) {
-                return log.verbose(`No assets found in ./src/assets to copy`);
-            }
-            if (hasAssets)
-                copyFile("./src/assets", `./${mode === Modes.CJS ? "lib" : "dist"}/assets`);
-        }
-        async bundle(mode, isDev, isLib, entryFile = "src/index.ts", nameOverride = this.pkgName, externalsArg, includeArg = [
-            "prompts",
-            "styled-string-builder",
-            "typed-object-accumulator",
-            "@decaf-ts/logging",
-        ]) {
-            // Run a TypeScript-only diagnostic check for the bundling configuration and fail fast on any errors.
-            await this.checkTsDiagnostics(isDev, mode, true);
-            const isEsm = mode === Modes.ESM;
-            const pkgName = this.pkgName;
-            // normalize include and externals
-            const include = Array.from(new Set([...parseList(includeArg)]));
-            let externalsList = parseList(externalsArg);
-            if (externalsList.length === 0) {
-                // if no externals specified, include package.json dependencies to avoid rollup treating them as resolvable
-                externalsList = getPackageDependencies();
-            }
-            const ext = Array.from(new Set([
-                // builtins and always external runtime deps
-                ...(function builtinList() {
-                    try {
-                        return (Array.isArray(module.builtinModules) ? module.builtinModules : []);
-                    }
-                    catch {
-                        // fallback to a reasonable subset if `builtinModules` is unavailable
-                        return [
-                            "fs",
-                            "path",
-                            "process",
-                            "child_process",
-                            "util",
-                            "https",
-                            "http",
-                            "os",
-                            "stream",
-                            "crypto",
-                            "zlib",
-                            "net",
-                            "tls",
-                            "url",
-                            "querystring",
-                            "assert",
-                            "events",
-                            "tty",
-                            "dns",
-                            "querystring",
-                        ];
-                    }
-                })(),
-                ...externalsList,
-            ]));
-            const plugins = [
-                typescript__default["default"]({
-                    compilerOptions: {
-                        module: "esnext",
-                        declaration: false,
-                        outDir: isLib ? "bin" : "dist",
-                    },
-                    include: ["src/**/*.ts"],
-                    exclude: ["node_modules", "**/*.spec.ts"],
-                    tsconfig: "./tsconfig.json",
-                }),
-                json__default["default"](),
-            ];
-            // production minification
-            if (!isDev) {
-                // terser is optional at runtime; import lazily inside bundle to avoid test-time resolution errors
-                try {
-                    const terserMod = await import('@rollup/plugin-terser');
-                    const terserFn = (terserMod && terserMod.terser) || terserMod.default || terserMod;
-                    plugins.push(terserFn());
-                }
-                catch {
-                    // if terser isn't available, ignore
-                }
-            }
-            if (isLib) {
-                plugins.push(commonjs__default["default"]({
-                    include: [],
-                    exclude: externalsList,
-                }), pluginNodeResolve.nodeResolve({
-                    resolveOnly: include,
-                }));
-            }
-            const input = {
-                input: entryFile,
-                plugins: plugins,
-                external: ext,
-            };
-            // prepare output globals mapping for externals
-            const globals = {};
-            // include all externals and builtins (ext) so Rollup won't guess names for builtins
-            ext.forEach((e) => {
-                globals[e] = packageToGlobal(e);
-            });
-            const outputs = [
-                {
-                    file: `${isLib ? "bin/" : "dist/"}${nameOverride ? nameOverride : `.bundle.${!isDev ? "min" : ""}`}${isEsm ? ".esm" : ""}.cjs`,
-                    format: isLib ? "cjs" : isEsm ? "esm" : "umd",
-                    name: pkgName,
-                    esModule: isEsm,
-                    sourcemap: isDev ? "inline" : false,
-                    globals: globals,
-                    exports: "auto",
-                },
-            ];
-            try {
-                const bundle = await rollup.rollup(input);
-                console.log(bundle.watchFiles);
-                async function generateOutputs(bundle) {
-                    for (const outputOptions of outputs) {
-                        await bundle.write(outputOptions);
-                    }
-                }
-                await generateOutputs(bundle);
-            }
-            catch (e) {
-                throw new Error(`Failed to bundle: ${e}`);
-            }
-        }
-        async buildByEnv(isDev, mode = BuildMode.ALL, includesArg, externalsArg) {
-            // note: includes and externals will be passed through from run() into this method by callers
-            try {
-                deletePath("lib");
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (e) {
-                // do nothing
-            }
-            try {
-                deletePath("dist");
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (e) {
-                // do nothing
-            }
-            fs__default["default"].mkdirSync("lib");
-            fs__default["default"].mkdirSync("dist");
-            if ([BuildMode.ALL, BuildMode.BUILD].includes(mode)) {
-                await this.build(isDev, Modes.ESM);
-                await this.build(isDev, Modes.CJS);
-                this.patchFiles("lib");
-            }
-            if ([BuildMode.ALL, BuildMode.BUNDLE].includes(mode)) {
-                await this.bundle(Modes.ESM, isDev, false, "src/index.ts", this.pkgName, externalsArg, includesArg);
-                await this.bundle(Modes.CJS, isDev, false, "src/index.ts", this.pkgName, externalsArg, includesArg);
-                this.patchFiles("dist");
-            }
-            this.copyAssets(Modes.CJS);
-            this.copyAssets(Modes.ESM);
-        }
-        async buildDev(mode = BuildMode.ALL, includesArg, externalsArg) {
-            return this.buildByEnv(true, mode, includesArg, externalsArg);
-        }
-        async buildProd(mode = BuildMode.ALL, includesArg, externalsArg) {
-            return this.buildByEnv(false, mode, includesArg, externalsArg);
-        }
-        async buildDocs() {
-            await runCommand(`npm install better-docs taffydb`).promise;
-            await runCommand(`npx markdown-include ./workdocs/readme-md.json`).promise;
-            await runCommand(`npx jsdoc -c ./workdocs/jsdocs.json -t ./node_modules/better-docs`).promise;
-            await runCommand(`npm remove better-docs taffydb`).promise;
-            [
-                {
-                    src: "workdocs/assets",
-                    dest: "./docs/workdocs/assets",
-                },
-                {
-                    src: "workdocs/reports/coverage",
-                    dest: "./docs/workdocs/reports/coverage",
-                },
-                {
-                    src: "workdocs/reports/html",
-                    dest: "./docs/workdocs/reports/html",
-                },
-                {
-                    src: "workdocs/resources",
-                    dest: "./docs/workdocs/resources",
-                },
-                {
-                    src: "LICENSE.md",
-                    dest: "./docs/LICENSE.md",
-                },
-            ].forEach((f) => {
-                const { src, dest } = f;
-                copyFile(src, dest);
-            });
-        }
-        async run(answers) {
-            const { dev, prod, docs, buildMode, includes, externals } = answers;
-            if (dev) {
-                return await this.buildDev(buildMode, includes, externals);
-            }
-            if (prod) {
-                return await this.buildProd(buildMode, includes, externals);
-            }
-            if (docs) {
-                return await this.buildDocs();
-            }
-        }
-    }
-
-    /* istanbul ignore file */
-    const options$1 = {
-        ci: {
-            type: "boolean",
-            default: true,
-        },
-        message: {
-            type: "string",
-            short: "m",
-        },
-        tag: {
-            type: "string",
-            short: "t",
-            default: undefined,
-        },
-    };
-    /**
-     * @class ReleaseScript
-     * @extends {Command}
-     * @cavegory scripts
-     * @description A command-line script for managing releases and version updates.
-     * @summary This script automates the process of creating and pushing new releases. It handles version updates,
-     * commit messages, and optionally publishes to NPM. The script supports semantic versioning and can work in both CI and non-CI environments.
-     *
-     * @param {Object} options - Configuration options for the script
-     * @param {boolean} options.ci - Whether the script is running in a CI environment (default: true)
-     * @param {string} options.message - The release message (short: 'm')
-     * @param {string} options.tag - The version tag to use (short: 't', default: undefined)
-     */
-    class ReleaseScript extends Command {
-        constructor() {
-            super("ReleaseScript", options$1);
-        }
-        /**
-         * @description Prepares the version for the release.
-         * @summary This method validates the provided tag or prompts the user for a new one if not provided or invalid.
-         * It also displays the latest git tags for reference.
-         * @param {string} tag - The version tag to prepare
-         * @returns {Promise<string>} The prepared version tag
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant R as ReleaseScript
-         *   participant T as TestVersion
-         *   participant U as UserInput
-         *   participant G as Git
-         *   R->>T: testVersion(tag)
-         *   alt tag is valid
-         *     T-->>R: return tag
-         *   else tag is invalid or not provided
-         *     R->>G: List latest git tags
-         *     R->>U: Prompt for new tag
-         *     U-->>R: return new tag
-         *   end
-         */
-        async prepareVersion(tag) {
-            const log = this.log.for(this.prepareVersion);
-            tag = this.testVersion(tag || "");
-            if (!tag) {
-                log.verbose("No release message provided. Prompting for one:");
-                log.info(`Listing latest git tags:`);
-                await runCommand("git tag --sort=-taggerdate | head -n 5").promise;
-                return await UserInput.insistForText("tag", "Enter the new tag number (accepts v*.*.*[-...])", (val) => !!val.toString().match(/^v[0-9]+\.[0-9]+.[0-9]+(-[0-9a-zA-Z-]+)?$/));
-            }
-            return tag;
-        }
-        /**
-         * @description Tests if the provided version is valid.
-         * @summary This method checks if the version is a valid semantic version or a predefined update type (PATCH, MINOR, MAJOR).
-         * @param {string} version - The version to test
-         * @returns {string | undefined} The validated version or undefined if invalid
-         */
-        testVersion(version) {
-            const log = this.log.for(this.testVersion);
-            version = version.trim().toLowerCase();
-            switch (version) {
-                case exports.SemVersion.PATCH:
-                case exports.SemVersion.MINOR:
-                case exports.SemVersion.MAJOR:
-                    log.verbose(`Using provided SemVer update: ${version}`, 1);
-                    return version;
-                default:
-                    log.verbose(`Testing provided version for SemVer compatibility: ${version}`, 1);
-                    if (!new RegExp(SemVersionRegex).test(version)) {
-                        log.debug(`Invalid version number: ${version}`);
-                        return undefined;
-                    }
-                    log.verbose(`version approved: ${version}`, 1);
-                    return version;
-            }
-        }
-        /**
-         * @description Prepares the release message.
-         * @summary This method either returns the provided message or prompts the user for a new one if not provided.
-         * @param {string} [message] - The release message
-         * @returns {Promise<string>} The prepared release message
-         */
-        async prepareMessage(message) {
-            const log = this.log.for(this.prepareMessage);
-            if (!message) {
-                log.verbose("No release message provided. Prompting for one");
-                return await UserInput.insistForText("message", "What should be the release message/ticket?", (val) => !!val && val.toString().length > 5);
-            }
-            return message;
-        }
-        /**
-         * @description Runs the release script.
-         * @summary This method orchestrates the entire release process, including version preparation, message creation,
-         * git operations, and npm publishing (if not in CI environment).
-         * @param {ParseArgsResult} args - The parsed command-line arguments
-         * @returns {Promise<void>}
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant R as ReleaseScript
-         *   participant V as PrepareVersion
-         *   participant M as PrepareMessage
-         *   participant N as NPM
-         *   participant G as Git
-         *   participant U as UserInput
-         *   R->>V: prepareVersion(tag)
-         *   R->>M: prepareMessage(message)
-         *   R->>N: Run prepare-release script
-         *   R->>G: Check git status
-         *   alt changes exist
-         *     R->>U: Ask for confirmation
-         *     U-->>R: Confirm
-         *     R->>G: Add and commit changes
-         *   end
-         *   R->>N: Update npm version
-         *   R->>G: Push changes and tags
-         *   alt not CI environment
-         *     R->>N: Publish to npm
-         *   end
-         */
-        async run(args) {
-            let result;
-            const { ci } = args;
-            let { tag, message } = args;
-            tag = await this.prepareVersion(tag);
-            message = await this.prepareMessage(message);
-            result = await runCommand(`npm run prepare-release -- ${tag} ${message}`, {
-                cwd: process.cwd(),
-            }).promise;
-            result = await runCommand("git status --porcelain").promise;
-            await result;
-            if (result.logs.length &&
-                (await UserInput.askConfirmation("git-changes", "Do you want to push the changes to the remote repository?", true))) {
-                await runCommand("git add .").promise;
-                await runCommand(`git commit -m "${tag} - ${message} - after release preparation${ci ? "" : NoCIFLag}"`).promise;
-            }
-            await runCommand(`npm version "${tag}" -m "${message}${ci ? "" : NoCIFLag}"`).promise;
-            await runCommand("git push --follow-tags").promise;
-            if (!ci) {
-                await runCommand("NPM_TOKEN=$(cat .npmtoken) npm publish --access public")
-                    .promise;
-            }
-        }
-    }
-
-    /* istanbul ignore file */
-    const baseUrl = "https://raw.githubusercontent.com/decaf-ts/ts-workspace/master";
-    const options = {
-        templates: [
-            ".github/ISSUE_TEMPLATE/bug_report.md",
-            ".github/ISSUE_TEMPLATE/feature_request.md",
-            ".github/FUNDING.yml",
-        ],
-        workflows: [
-            ".github/workflows/codeql-analysis.yml",
-            ".github/workflows/jest-coverage.yaml",
-            ".github/workflows/nodejs-build-prod.yaml",
-            ".github/workflows/pages.yaml",
-            ".github/workflows/publish-on-release.yaml",
-            ".github/workflows/release-on-tag.yaml",
-            ".github/workflows/snyk-analysis.yaml",
-        ],
-        ide: [
-            ".idea/runConfigurations/All Tests.run.xml",
-            ".idea/runConfigurations/build.run.xml",
-            ".idea/runConfigurations/build_prod.run.xml",
-            ".idea/runConfigurations/coverage.run.xml",
-            ".idea/runConfigurations/docs.run.xml",
-            ".idea/runConfigurations/drawings.run.xml",
-            ".idea/runConfigurations/flash-forward.run.xml",
-            ".idea/runConfigurations/Integration_Tests.run.xml",
-            ".idea/runConfigurations/Bundling_Tests.run.xml",
-            ".idea/runConfigurations/lint-fix.run.xml",
-            ".idea/runConfigurations/release.run.xml",
-            ".idea/runConfigurations/test_circular.run.xml",
-            ".idea/runConfigurations/uml.run.xml",
-            ".idea/runConfigurations/Unit Tests.run.xml",
-            ".idea/runConfigurations/update-scripts.run.xml",
-        ],
-        docs: [
-            "workdocs/tutorials/Contributing.md",
-            "workdocs/tutorials/Documentation.md",
-            "workdocs/tutorials/For Developers.md",
-            "workdocs/2-Badges.md",
-            "workdocs/jsdocs.json",
-            "workdocs/readme-md.json",
-        ],
-        styles: [".prettierrc", "eslint.config.js"],
-        scripts: [
-            "bin/update-scripts.cjs",
-            "bin/tag-release.cjs",
-            "bin/build-scripts.cjs",
-        ],
-        tests: ["jest.config.ts", "workdocs/reports/jest.coverage.config.ts"],
-        typescript: ["tsconfig.json"],
-        docker: ["Dockerfile"],
-        automation: [
-            "workdocs/confluence/Continuous Integration-Deployment/GitHub.md",
-            "workdocs/confluence/Continuous Integration-Deployment/Jira.md",
-            "workdocs/confluence/Continuous Integration-Deployment/Teams.md",
-        ],
-    };
-    const argzz = {
-        // init attributes
-        boot: {
-            type: "boolean",
-        },
-        org: {
-            type: "string",
-            short: "o",
-        },
-        name: {
-            type: "string",
-            short: "n",
-            default: undefined,
-        },
-        author: {
-            type: "string",
-            short: "a",
-            default: undefined,
-        },
-        // update attributes
-        all: {
-            type: "boolean",
-        },
-        license: {
-            type: "string",
-            message: "Pick the license",
-        },
-        scripts: {
-            type: "boolean",
-        },
-        styles: {
-            type: "boolean",
-        },
-        docs: {
-            type: "boolean",
-        },
-        ide: {
-            type: "boolean",
-        },
-        workflows: {
-            type: "boolean",
-        },
-        templates: {
-            type: "boolean",
-        },
-        typescript: {
-            type: "boolean",
-        },
-        docker: {
-            type: "boolean",
-        },
-        pkg: {
-            type: "boolean",
-        },
-        dependencies: {
-            type: "boolean",
-        },
-        tests: {
-            type: "boolean",
-        },
-        automation: {
-            type: "boolean",
-        },
-    };
-    /**
-     * @class TemplateSync
-     * @extends {Command}
-     * @category scripts
-     * @description A command-line tool for synchronizing project templates and configurations.
-     * @summary This class provides functionality to download and update various project files and configurations from a remote repository.
-     * It supports updating licenses, IDE configurations, scripts, styles, documentation, workflows, and templates.
-     *
-     * @param {CommandOptions} args - The command options for TemplateSync
-     */
-    class TemplateSync extends Command {
-        constructor() {
-            super("TemplateSync", argzz);
-            this.replacements = {};
-            /**
-             * @description Downloads style configuration files.
-             * @returns {Promise<void>}
-             */
-            this.getStyles = () => this.downloadOption("styles");
-            /**
-             * @description Downloads template files.
-             * @returns {Promise<void>}
-             */
-            this.getTemplates = () => this.downloadOption("templates");
-            /**
-             * @description Downloads workflow configuration files.
-             * @returns {Promise<void>}
-             */
-            this.getWorkflows = () => this.downloadOption("workflows");
-            /**
-             * @description Downloads documentation files.
-             * @returns {Promise<void>}
-             */
-            this.getDocs = () => this.downloadOption("docs");
-            /**
-             * @description Downloads typescript config files.
-             * @returns {Promise<void>}
-             */
-            this.getTypescript = () => this.downloadOption("typescript");
-            /**
-             * @description Downloads automation documentation files.
-             * @returns {Promise<void>}
-             */
-            this.getAutomation = () => this.downloadOption("automation");
-            /**
-             * @description Downloads automation documentation files.
-             * @returns {Promise<void>}
-             */
-            this.getTests = () => this.downloadOption("tests");
-            /**
-             * @description Downloads docker image files.
-             * @returns {Promise<void>}
-             */
-            this.getDocker = () => this.downloadOption("docker");
-        }
-        loadValuesFromPackage() {
-            const p = process.cwd();
-            const author = getPackage(p, "author");
-            const scopedName = getPackage(p, "name");
-            let name = scopedName;
-            let org;
-            if (name.startsWith("@")) {
-                const split = name.split("/");
-                name = split[1];
-                org = split[0].replace("@", "");
-            }
-            ["Tiago Venceslau", "TiagoVenceslau", "${author}"].forEach((el) => (this.replacements[el] = author));
-            ["TS-Workspace", "ts-workspace", "${name}"].forEach((el) => (this.replacements[el] = name));
-            ["decaf-ts", "${org}"].forEach((el) => (this.replacements[el] = org || '""'));
-            this.replacements["${org_or_owner}"] = org || name;
-        }
-        /**
-         * @description Downloads files for a specific option category.
-         * @summary This method downloads all files associated with a given option key from the remote repository.
-         * @param {string} key - The key representing the option category to download
-         * @returns {Promise<void>}
-         * @throws {Error} If the specified option key is not found
-         */
-        async downloadOption(key) {
-            if (!(key in options)) {
-                throw new Error(`Option "${key}" not found in options`);
-            }
-            const files = options[key];
-            for (const file of files) {
-                this.log.info(`Downloading ${file}`);
-                let data = await HttpClient.downloadFile(`${baseUrl}/${file}`);
-                data = logging.patchString(data, this.replacements);
-                writeFile(path__default["default"].join(process.cwd(), file), data);
-            }
-        }
-        /**
-         * @description Downloads and sets up the specified license.
-         * @summary This method downloads the chosen license file, saves it to the project, and updates the package.json license field.
-         * @param {"MIT" | "GPL" | "Apache" | "LGPL" | "AGPL"} license - The license to download and set up
-         * @returns {Promise<void>}
-         */
-        async getLicense(license) {
-            this.log.info(`Downloading ${license} license`);
-            const url = `${baseUrl}/workdocs/licenses/${license}.md`;
-            let data = await HttpClient.downloadFile(url);
-            data = logging.patchString(data, this.replacements);
-            writeFile(path__default["default"].join(process.cwd(), "LICENSE.md"), data);
-            setPackageAttribute("license", license);
-        }
-        /**
-         * @description Downloads IDE configuration files.
-         * @returns {Promise<void>}
-         */
-        async getIde() {
-            fs__default["default"].mkdirSync(path__default["default"].join(process.cwd(), ".idea", "runConfigurations"), {
-                recursive: true,
-            });
-            await this.downloadOption("ide");
-        }
-        /**
-         * @description Update npm scripts
-         * @returns {Promise<void>}
-         */
-        async getScripts() {
-            await this.downloadOption("scripts");
-            this.log.info("please re-run the command");
-            process.exit(0);
-        }
-        async initPackage(pkgName, author, license) {
-            try {
-                const pkg = getPackage();
-                delete pkg[SetupScriptKey];
-                pkg.name = pkgName;
-                pkg.version = "0.0.1";
-                pkg.author = author;
-                pkg.license = license;
-                fs__default["default"].writeFileSync("package.json", JSON.stringify(pkg, null, 2));
-            }
-            catch (e) {
-                throw new Error(`Error fixing package.json: ${e}`);
-            }
-        }
-        async updatePackageScrips() {
-            try {
-                const originalPkg = JSON.parse(await HttpClient.downloadFile(`${baseUrl}/package.json`));
-                const { scripts } = originalPkg;
-                const pkg = getPackage();
-                Object.keys(pkg.scripts).forEach((key) => {
-                    if (key in scripts) {
-                        const replaced = logging.patchString(scripts[key], this.replacements);
-                        if (replaced !== scripts[key]) {
-                            pkg.scripts[key] = replaced;
-                        }
-                    }
-                });
-                pkg["exports"]["require"] = originalPkg["exports"]["require"];
-                pkg["exports"]["import"] = originalPkg["exports"]["import"];
-                pkg["types"] = originalPkg["types"];
-                fs__default["default"].writeFileSync("package.json", JSON.stringify(pkg, null, 2));
-            }
-            catch (e) {
-                throw new Error(`Error fixing package.json scripts: ${e}`);
-            }
-        }
-        async createTokenFiles() {
-            const log = this.log.for(this.createTokenFiles);
-            const gitToken = await UserInput.insistForText("token", "please input your github token", (res) => {
-                return !!res.match(/^ghp_[0-9a-zA-Z]{36}$/g);
-            });
-            Object.values(exports.Tokens).forEach((token) => {
-                try {
-                    let status;
-                    try {
-                        status = fs__default["default"].existsSync(token);
-                        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                    }
-                    catch (e) {
-                        log.info(`Token file ${token} not found. Creating a new one...`);
-                        fs__default["default"].writeFileSync(token, token === ".token" ? gitToken : "");
-                        return;
-                    }
-                    if (!status) {
-                        fs__default["default"].writeFileSync(token, token === ".token" ? gitToken : "");
-                    }
-                }
-                catch (e) {
-                    throw new Error(`Error creating token file ${token}: ${e}`);
-                }
-            });
-        }
-        async getOrg() {
-            const org = await UserInput.askText("Organization", "Enter the organization name (will be used to scope your npm project. leave blank to create a unscoped project):");
-            const confirmation = await UserInput.askConfirmation("Confirm organization", "Is this organization correct?", true);
-            if (!confirmation)
-                return this.getOrg();
-            return org;
-        }
-        async auditFix() {
-            return await runCommand("npm audit fix --force").promise;
-        }
-        patchFiles() {
-            const files = [
-                ...fs__default["default"]
-                    .readdirSync(path__default["default"].join(process.cwd(), "src"), {
-                    recursive: true,
-                    withFileTypes: true,
-                })
-                    .filter((entry) => entry.isFile())
-                    .map((entry) => path__default["default"].join(entry.parentPath, entry.name)),
-                ...fs__default["default"]
-                    .readdirSync(path__default["default"].join(process.cwd(), "workdocs"), {
-                    recursive: true,
-                    withFileTypes: true,
-                })
-                    .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
-                    .map((entry) => path__default["default"].join(entry.parentPath, entry.name)),
-                path__default["default"].join(process.cwd(), ".gitlab-ci.yml"),
-                path__default["default"].join(process.cwd(), "workdocs", "jsdocs.json"),
-            ];
-            for (const file of files) {
-                patchFile(file, this.replacements);
-            }
-        }
-        async updateDependencies() {
-            try {
-                const originalPkg = JSON.parse(await HttpClient.downloadFile(`${baseUrl}/package.json`));
-                const { devDependencies } = originalPkg;
-                const pkg = getPackage();
-                Object.keys(pkg.scripts).forEach((key) => {
-                    if (key in devDependencies) {
-                        const replaced = devDependencies[key];
-                        if (replaced !== devDependencies[key]) {
-                            pkg["devDependencies"] =
-                                pkg["devDependencies"] || {};
-                            pkg["devDependencies"][key] = replaced;
-                        }
-                    }
-                });
-                fs__default["default"].writeFileSync("package.json", JSON.stringify(pkg, null, 2));
-                await runCommand("npm install").promise;
-            }
-            catch (e) {
-                throw new Error(`Error fixing package.json dependencies: ${e}`);
-            }
-        }
-        /**
-         * @description Runs the template synchronization process.
-         * @summary This method orchestrates the downloading of various project components based on the provided arguments.
-         * @param {ParseArgsResult} args - The parsed command-line arguments
-         * @returns {Promise<void>}
-         *
-         * @mermaid
-         * sequenceDiagram
-         *   participant T as TemplateSync
-         *   participant L as getLicense
-         *   participant I as getIde
-         *   participant S as getScripts
-         *   participant St as getStyles
-         *   participant D as getDocs
-         *   participant W as getWorkflows
-         *   participant Te as getTemplates
-         *   T->>T: Parse arguments
-         *   alt all flag is true
-         *     T->>T: Set all component flags to true
-         *   end
-         *   alt license is specified
-         *     T->>L: getLicense(license)
-         *   end
-         *   alt ide flag is true
-         *     T->>I: getIde()
-         *   end
-         *   alt scripts flag is true
-         *     T->>S: getScripts()
-         *   end
-         *   alt styles flag is true
-         *     T->>St: getStyles()
-         *   end
-         *   alt docs flag is true
-         *     T->>D: getDocs()
-         *   end
-         *   alt workflows flag is true
-         *     T->>W: getWorkflows()
-         *   end
-         *   alt templates flag is true
-         *     T->>Te: getTemplates()
-         *   end
-         */
-        async run(args) {
-            let { license } = args;
-            const { boot } = args;
-            let { all, scripts, styles, docs, ide, workflows, templates, docker, typescript, dependencies, tests, automation, pkg, } = args;
-            if (scripts ||
-                styles ||
-                docs ||
-                ide ||
-                workflows ||
-                templates ||
-                docker ||
-                typescript ||
-                automation ||
-                dependencies ||
-                tests ||
-                pkg)
-                all = false;
-            if (boot) {
-                const org = await this.getOrg();
-                const name = await UserInput.insistForText("Project name", "Enter the project name:", (res) => res.length > 1);
-                const author = await UserInput.insistForText("Author", "Enter the author name:", (res) => res.length > 1);
-                const pkgName = org ? `@${org}/${name}` : name;
-                await this.initPackage(pkgName, author, license);
-                await this.createTokenFiles();
-                await this.auditFix();
-                this.patchFiles();
-            }
-            if (all) {
-                scripts = false;
-                styles = true;
-                docs = true;
-                ide = true;
-                workflows = true;
-                templates = true;
-                docker = true;
-                typescript = true;
-                pkg = true;
-                dependencies = true;
-                tests = true;
-                automation = false;
-            }
-            if (typeof scripts === "undefined")
-                scripts = await UserInput.askConfirmation("scripts", "Do you want to get scripts?", true);
-            if (scripts)
-                await this.getScripts();
-            this.loadValuesFromPackage();
-            if (!all && typeof license === "undefined") {
-                const confirmation = await UserInput.askConfirmation("license", "Do you want to set a license?", true);
-                if (confirmation)
-                    license = await UserInput.insistForText("license", "Enter the desired License (MIT|GPL|Apache|LGPL|AGPL):", (val) => !!val && !!val.match(/^(MIT|GPL|Apache|LGPL|AGPL)$/g));
-            }
-            if (typeof license !== "undefined")
-                await this.getLicense(license);
-            if (typeof ide === "undefined")
-                ide = await UserInput.askConfirmation("ide", "Do you want to get ide configs?", true);
-            if (ide)
-                await this.getIde();
-            if (typeof typescript === "undefined")
-                typescript = await UserInput.askConfirmation("typescript", "Do you want to get typescript configs?", true);
-            if (typescript)
-                await this.getTypescript();
-            if (typeof docker === "undefined")
-                docker = await UserInput.askConfirmation("docker", "Do you want to get docker configs?", true);
-            if (docker)
-                await this.getDocker();
-            if (typeof automation === "undefined")
-                automation = await UserInput.askConfirmation("automation", "Do you want to get automation configs?", true);
-            if (automation)
-                await this.getAutomation();
-            if (typeof styles === "undefined")
-                styles = await UserInput.askConfirmation("styles", "Do you want to get styles?", true);
-            if (styles)
-                await this.getStyles();
-            if (typeof docs === "undefined")
-                docs = await UserInput.askConfirmation("docs", "Do you want to get docs?", true);
-            if (docs)
-                await this.getDocs();
-            if (typeof workflows === "undefined")
-                workflows = await UserInput.askConfirmation("workflows", "Do you want to get workflows?", true);
-            if (workflows)
-                await this.getWorkflows();
-            if (typeof templates === "undefined")
-                templates = await UserInput.askConfirmation("templates", "Do you want to get templates?", true);
-            if (templates)
-                await this.getTemplates();
-            if (typeof pkg === "undefined")
-                pkg = await UserInput.askConfirmation("pkg", "Do you want to update your package.json scripts?", true);
-            if (pkg)
-                await this.updatePackageScrips();
-            if (typeof tests === "undefined")
-                tests = await UserInput.askConfirmation("pkg", "Do you want to update your test configs?", true);
-            if (tests)
-                await this.getTests();
-            if (typeof dependencies === "undefined")
-                dependencies = await UserInput.askConfirmation("pkg", "Do you want to update dev dependencies?", true);
-            if (dependencies)
-                await this.updateDependencies();
-        }
-    }
-
-    /**
-     * @description A specialized output writer that uses regular expressions to process output.
-     * @summary This class extends StandardOutputWriter to provide regex-based output processing.
-     * It allows for pattern matching in the output stream and can trigger specific actions
-     * based on matched patterns.
-     *
-     * @template T - The type of the resolved value, defaulting to string.
-     *
-     * @param cmd - The command string to be executed.
-     * @param lock - A PromiseExecutor to control the asynchronous flow.
-     * @param regexp - A string or RegExp to match against the output.
-     * @param flags - Optional flags for the RegExp constructor, defaults to "g".
-     *
-     * @class
-     * @example
-     * ```typescript
-     * import { RegexpOutputWriter } from '@decaf-ts/utils';
-     * import { PromiseExecutor } from '@decaf-ts/utils';
-     *
-     * // Create a promise executor
-     * const executor: PromiseExecutor<string, Error> = {
-     *   resolve: (value) => console.log(`Resolved: ${value}`),
-     *   reject: (error) => console.error(`Rejected: ${error.message}`)
-     * };
-     *
-     * // Create a regexp output writer that matches version numbers
-     * const writer = new RegexpOutputWriter('node --version', executor, /v(\d+\.\d+\.\d+)/);
-     *
-     * // Use the writer to handle command output
-     * writer.data('v14.17.0');  // This will automatically resolve with "v14.17.0"
-     * ```
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant Client
-     *   participant RegexpOutputWriter
-     *   participant StandardOutputWriter
-     *   participant Logger
-     *
-     *   Client->>RegexpOutputWriter: new RegexpOutputWriter(cmd, lock, regexp, flags)
-     *   RegexpOutputWriter->>StandardOutputWriter: super(cmd, lock)
-     *   StandardOutputWriter->>Logger: Logging.for(cmd)
-     *   RegexpOutputWriter->>RegexpOutputWriter: compile regexp
-     *
-     *   Client->>RegexpOutputWriter: data(chunk)
-     *   RegexpOutputWriter->>StandardOutputWriter: super.data(chunk)
-     *   StandardOutputWriter->>Logger: logger.info(log)
-     *   RegexpOutputWriter->>RegexpOutputWriter: testAndResolve(chunk)
-     *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
-     *   alt match found
-     *     RegexpOutputWriter->>RegexpOutputWriter: resolve(match[0])
-     *     RegexpOutputWriter->>StandardOutputWriter: resolve(match[0])
-     *   end
-     *
-     *   Client->>RegexpOutputWriter: error(chunk)
-     *   RegexpOutputWriter->>StandardOutputWriter: super.error(chunk)
-     *   StandardOutputWriter->>Logger: logger.info(log)
-     *   RegexpOutputWriter->>RegexpOutputWriter: testAndReject(chunk)
-     *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
-     *   alt match found
-     *     RegexpOutputWriter->>RegexpOutputWriter: reject(match[0])
-     *     RegexpOutputWriter->>StandardOutputWriter: reject(match[0])
-     *   end
-     */
-    class RegexpOutputWriter extends StandardOutputWriter {
-        constructor(cmd, lock, regexp, flags = "g") {
-            super(cmd, lock);
-            try {
-                this.regexp =
-                    typeof regexp === "string" ? new RegExp(regexp, flags) : regexp;
-            }
-            catch (e) {
-                throw new Error(`Invalid regular expression: ${e}`);
-            }
-        }
-        /**
-         * @description Tests the input data against the stored regular expression.
-         * @summary Executes the regular expression on the input data and returns the match result.
-         *
-         * @param data - The string to test against the regular expression.
-         * @return The result of the regular expression execution, or undefined if an error occurs.
-         */
-        test(data) {
-            this.regexp.lastIndex = 0;
-            let match;
-            try {
-                match = this.regexp.exec(data);
-            }
-            catch (e) {
-                return console.debug(`Failed to parse chunk: ${data}\nError: ${e} `);
-            }
-            return match;
-        }
-        /**
-         * @description Tests the data and resolves the promise if a match is found.
-         * @summary Executes the test method and resolves the promise with the first match group if successful.
-         *
-         * @param data - The string to test against the regular expression.
-         */
-        testAndResolve(data) {
-            const match = this.test(data);
-            if (match)
-                this.resolve(match[0]);
-        }
-        /**
-         * @description Tests the data and rejects the promise if a match is found.
-         * @summary Executes the test method and rejects the promise with the first match group if successful.
-         *
-         * @param data - The string to test against the regular expression.
-         */
-        testAndReject(data) {
-            const match = this.test(data);
-            if (match)
-                this.reject(match[0]);
-        }
-        /**
-         * @description Processes incoming data chunks.
-         * @summary Calls the parent class data method and then tests the data for a match to potentially resolve the promise.
-         *
-         * @param chunk - The data chunk to process.
-         */
-        data(chunk) {
-            super.data(chunk);
-            this.testAndResolve(String(chunk));
-        }
-        /**
-         * @description Processes incoming error chunks.
-         * @summary Calls the parent class error method and then tests the data for a match to potentially reject the promise.
-         *
-         * @param chunk - The error chunk to process.
-         */
-        error(chunk) {
-            super.error(chunk);
-            this.testAndReject(String(chunk));
-        }
-    }
-
-    /**
-     * @module utils
-     * @description Utilities and building blocks for Decaf-TS CLI and scripting.
-     * @summary Aggregates CLI command infrastructure, input helpers, output writers, filesystem/network utilities,
-     * and shared types. Consumers typically use {@link Command}, {@link UserInput}, {@link StandardOutputWriter},
-     * {@link printBanner}, and utilities from {@link module:utils|utils}.
-     *
-     * This entrypoint re-exports subpackages:
-     * - CLI framework under `./cli` (command base, options, built-in commands)
-     * - Input helpers under `./input` (prompting and arg parsing)
-     * - Output helpers under `./output` (banner and styling)
-     * - General utilities under `./utils` (fs, http, exec, types)
-     * - Writers under `./writers` (stdout/stderr processors)
-     *
-     * Note: Individual exports are documented in their source files.
-     */
-    /**
-     * @description Represents the current version of the module.
-     * @summary Stores the version for the @decaf-ts/utils package. The build replaces
-     * the placeholder with the actual version number at publish time.
-     * @const VERSION
-     * @memberOf module:utils
-     */
-    const VERSION = "0.4.1";
-    /**
-     * @description Represents the current version of the module.
-     * @summary Stores the version for the @decaf-ts/utils package. The build replaces
-     * the placeholder with the actual version number at publish time.
-     * @const VERSION
-     * @memberOf module:utils
-     */
-    const PACKAGE_NAME = "@decaf-ts/utils";
-
-    exports.AbortCode = AbortCode;
-    exports.BuildScripts = BuildScripts;
-    exports.Command = Command;
-    exports.DefaultCommandOptions = DefaultCommandOptions;
-    exports.DefaultCommandValues = DefaultCommandValues;
-    exports.Encoding = Encoding;
-    exports.HttpClient = HttpClient;
-    exports.NoCIFLag = NoCIFLag;
-    exports.PACKAGE_NAME = PACKAGE_NAME;
-    exports.RegexpOutputWriter = RegexpOutputWriter;
-    exports.ReleaseScript = ReleaseScript;
-    exports.SemVersionRegex = SemVersionRegex;
-    exports.SetupScriptKey = SetupScriptKey;
-    exports.StandardOutputWriter = StandardOutputWriter;
-    exports.TemplateSync = TemplateSync;
-    exports.UserInput = UserInput;
-    exports.VERSION = VERSION;
-    exports.chainAbortController = chainAbortController;
-    exports.copyFile = copyFile;
-    exports.deletePath = deletePath;
-    exports.getAllFiles = getAllFiles;
-    exports.getDependencies = getDependencies;
-    exports.getPackage = getPackage;
-    exports.getPackageDependencies = getPackageDependencies;
-    exports.getPackageVersion = getPackageVersion;
-    exports.getSlogan = getSlogan;
-    exports.installDependencies = installDependencies;
-    exports.installIfNotAvailable = installIfNotAvailable;
-    exports.lockify = lockify;
-    exports.normalizeImport = normalizeImport;
-    exports.packageToGlobal = packageToGlobal;
-    exports.parseList = parseList;
-    exports.patchFile = patchFile;
-    exports.printBanner = printBanner;
-    exports.pushToGit = pushToGit;
-    exports.readFile = readFile;
-    exports.renameFile = renameFile;
-    exports.runCommand = runCommand;
-    exports.setPackageAttribute = setPackageAttribute;
-    exports.spawnCommand = spawnCommand;
-    exports.updateDependencies = updateDependencies;
-    exports.writeFile = writeFile;
-
-}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("prompts"),require("util"),require("@decaf-ts/logging"),require("fs"),require("path"),require("child_process"),require("styled-string-builder"),require("https"),require("rollup"),require("@rollup/plugin-typescript"),require("@rollup/plugin-commonjs"),require("@rollup/plugin-node-resolve"),require("@rollup/plugin-json"),require("module"),require("typescript")):"function"==typeof define&&define.amd?define(["exports","prompts","util","@decaf-ts/logging","fs","path","child_process","styled-string-builder","https","rollup","@rollup/plugin-typescript","@rollup/plugin-commonjs","@rollup/plugin-node-resolve","@rollup/plugin-json","module","typescript"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).utils={},e.prompts,e.util,e.decafTsLogging,e.fs,e.path,e.childProcess,e.styledStringBuilder,e.https,e.rollup,e.rollupPluginTypescript,e.rollupPluginCommonjs,e.rollupPluginNodeResolve,e.rollupPluginJson,e.module,e.typescript)}(this,function(e,t,o,a,n,s,i,r,l,c,g,d,f,u,h,p){"use strict";function m(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function S(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach(function(o){if("default"!==o){var a=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(t,o,a.get?a:{enumerable:!0,get:function(){return e[o]}})}}),t.default=e,Object.freeze(t)}var y=m(t),w=m(n),T=m(s),b=m(l),C=m(g),v=m(d),D=m(u),k=S(p);class ${static{this.logger=a.Logging.for($)}constructor(e){this.type="text",this.name=e}setType(e){return $.logger.verbose(`Setting type to: ${e}`),this.type=e,this}setMessage(e){return $.logger.verbose(`Setting message to: ${e}`),this.message=e,this}setInitial(e){return $.logger.verbose(`Setting initial value to: ${e}`),this.initial=e,this}setStyle(e){return $.logger.verbose(`Setting style to: ${e}`),this.style=e,this}setFormat(e){return $.logger.verbose("Setting format function"),this.format=e,this}setValidate(e){return $.logger.verbose("Setting validate function"),this.validate=e,this}setOnState(e){return $.logger.verbose("Setting onState callback"),this.onState=e,this}setMin(e){return $.logger.verbose(`Setting min value to: ${e}`),this.min=e,this}setMax(e){return $.logger.verbose(`Setting max value to: ${e}`),this.max=e,this}setFloat(e){return $.logger.verbose(`Setting float to: ${e}`),this.float=e,this}setRound(e){return $.logger.verbose(`Setting round to: ${e}`),this.round=e,this}setInstructions(e){return $.logger.verbose(`Setting instructions to: ${e}`),this.instructions=e,this}setIncrement(e){return $.logger.verbose(`Setting increment to: ${e}`),this.increment=e,this}setSeparator(e){return $.logger.verbose(`Setting separator to: ${e}`),this.separator=e,this}setActive(e){return $.logger.verbose(`Setting active style to: ${e}`),this.active=e,this}setInactive(e){return $.logger.verbose(`Setting inactive style to: ${e}`),this.inactive=e,this}setChoices(e){return $.logger.verbose(`Setting choices: ${JSON.stringify(e)}`),this.choices=e,this}setHint(e){return $.logger.verbose(`Setting hint to: ${e}`),this.hint=e,this}setWarn(e){return $.logger.verbose(`Setting warn to: ${e}`),this.warn=e,this}setSuggest(e){return $.logger.verbose("Setting suggest function"),this.suggest=e,this}setLimit(e){return $.logger.verbose(`Setting limit to: ${e}`),this.limit=e,this}setMask(e){return $.logger.verbose(`Setting mask to: ${e}`),this.mask=e,this}setStdout(e){return $.logger.verbose("Setting stdout stream"),this.stdout=e,this}setStdin(e){return this.stdin=e,this}async ask(){return(await $.ask(this))[this.name]}static async ask(e){const t=$.logger.for(this.ask);let o;Array.isArray(e)||(e=[e]);try{t.verbose(`Asking questions: ${e.map(e=>e.name).join(", ")}`),o=await y.default(e),t.verbose(`Received answers: ${JSON.stringify(o,null,2)}`)}catch(e){throw new Error(`Error while getting input: ${e}`)}return o}static async askNumber(e,t,o,a,n){$.logger.for(this.askNumber).verbose(`Asking number input: undefined, question: ${t}, min: ${o}, max: ${a}, initial: ${n}`);const s=new $(e).setMessage(t).setType("number");return"number"==typeof o&&s.setMin(o),"number"==typeof a&&s.setMax(a),"number"==typeof n&&s.setInitial(n),(await this.ask(s))[e]}static async askText(e,t,o=void 0,a){$.logger.for(this.askText).verbose(`Asking text input: undefined, question: ${t}, mask: ${o}, initial: ${a}`);const n=new $(e).setMessage(t);return o&&n.setMask(o),"string"==typeof a&&n.setInitial(a),(await this.ask(n))[e]}static async askConfirmation(e,t,o){$.logger.for(this.askConfirmation).verbose(`Asking confirmation input: undefined, question: ${t}, initial: ${o}`);const a=new $(e).setMessage(t).setType("confirm");return void 0!==o&&a.setInitial(o),(await this.ask(a))[e]}static async insist(e,t,o,a=1){const n=$.logger.for(this.insist);let s;n.verbose(`Insisting on input: ${e.name}, test: ${t.toString()}, defaultConfirmation: ${o}, limit: ${a}`);let i,r=0;try{do{s=(await $.ask(e))[e.name],t(s)?(i=await $.askConfirmation(`${e.name}-confirm`,`Is the ${e.type} correct?`,o),i||(s=void 0)):s=void 0}while(void 0===s&&a>1&&r++<a)}catch(e){throw n.error(`Error while insisting: ${e}`),e}return void 0===s&&n.info("no selection..."),s}static async insistForText(e,t,o,a=void 0,n,s=!1,i=-1){$.logger.for(this.insistForText).verbose(`Insisting for text input: undefined, question: ${t}, test: ${o.toString()}, mask: ${a}, initial: ${n}, defaultConfirmation: ${s}, limit: ${i}`);const r=new $(e).setMessage(t);return a&&r.setMask(a),"string"==typeof n&&r.setInitial(n),await this.insist(r,o,s,i)}static async insistForNumber(e,t,o,a,n,s,i=!1,r=-1){$.logger.for(this.insistForNumber).verbose(`Insisting for number input: undefined, question: ${t}, test: ${o.toString()}, min: ${a}, max: ${n}, initial: ${s}, defaultConfirmation: ${i}, limit: ${r}`);const l=new $(e).setMessage(t).setType("number");return"number"==typeof a&&l.setMin(a),"number"==typeof n&&l.setMax(n),"number"==typeof s&&l.setInitial(s),await this.insist(l,o,i,r)}static parseArgs(e){const t=$.logger.for(this.parseArgs),a={args:process.argv.slice(2),options:e};t.debug(`Parsing arguments: ${JSON.stringify(a,null,2)}`);try{return o.parseArgs(a)}catch(o){throw t.debug(`Error while parsing arguments:\n${JSON.stringify(a,null,2)}\n | options\n${JSON.stringify(e,null,2)}\n | ${o}`),new Error(`Error while parsing arguments: ${o}`)}}}const E={verbose:{type:"boolean",short:"V",default:void 0},version:{type:"boolean",short:"v",default:void 0},help:{type:"boolean",short:"h",default:!1},logLevel:{type:"string",default:"info"},logStyle:{type:"boolean",default:!0},timestamp:{type:"boolean",default:!0},banner:{type:"boolean",default:!0}},I=Object.keys(E).reduce((e,t)=>(e[t]=E[t].default,e),{}),F="utf-8",j=/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z])))/g;var x;e.SemVersion=void 0,(x=e.SemVersion||(e.SemVersion={})).PATCH="patch",x.MINOR="minor",x.MAJOR="major";const A="-no-ci",N="postinstall";var P;e.Tokens=void 0,(P=e.Tokens||(e.Tokens={})).GIT=".token",P.NPM=".npmtoken",P.DOCKER=".dockertoken",P.CONFLUENCE=".confluence-token";const O="Aborted";class L{constructor(e,t,...o){this.cmd=e,this.lock=t,this.logger=a.Logging.for(this.cmd)}log(e,t){t=Buffer.isBuffer(t)?t.toString(F):t;const o="stderr"===e?r.style(t).red.text:t;this.logger.info(o)}data(e){this.log("stdout",String(e))}error(e){this.log("stderr",String(e))}errors(e){this.log("stderr",`Error executing command exited : ${e}`)}exit(e,t){this.log("stdout",`command exited code : ${0===e?r.style(e.toString()).green.text:r.style(null===e?"null":e.toString()).red.text}`),0===e?this.resolve(t.map(e=>e.trim()).join("\n")):this.reject(new Error(t.length?t.join("\n"):e.toString()))}parseCommand(e){return e="string"==typeof e?e.split(" "):e,this.cmd=e.join(" "),[e[0],e.slice(1)]}resolve(e){this.log("stdout",`${this.cmd} executed successfully: ${r.style(e?"ran to completion":e).green}`),this.lock.resolve(e)}reject(e){e instanceof Error||(e=new Error("number"==typeof e?`Exit code ${e}`:e)),this.log("stderr",`${this.cmd} failed to execute: ${r.style(e.message).red}`),this.lock.reject(e)}}function B(e,...t){let o,a;if(e instanceof AbortSignal?(a=new AbortController,o=[e,...t]):(a=e,o=t),a.signal.aborted)return a;const n=()=>a.abort();for(const e of o){if(e.aborted){a.abort();break}e.addEventListener("abort",n,{once:!0,signal:a.signal})}return a}function M(e,t,o,a,n){function s(t,a){const[s,r]=e.parseCommand(t);n.info(`Running command: ${s}`),n.debug(`with args: ${r.join(" ")}`);const l=i.spawn(s,r,{...o,cwd:o.cwd||process.cwd(),env:Object.assign({},process.env,o.env,{PATH:process.env.PATH}),shell:o.shell||!1,signal:a.signal});return n.verbose(`pid : ${l.pid}`),l}const r=t.match(/[<>$#]/g);if(r)throw new Error(`Invalid command: ${t}. contains invalid characters: ${r}`);if(t.includes(" | ")){const e=t.split(" | "),o=[],n=new Array(e.length);n[0]=a;for(let t=0;t<e.length;t++)0!==t&&(n[t]=B(n[t-1].signal)),o.push(s(e[t],n[t])),0!==t&&o[t-1].stdout.pipe(o[t].stdin);return o[e.length-1]}return s(t,a)}function U(e,t={},o=L,...n){const s=a.Logging.for(U),i=new AbortController,r={abort:i,command:e,logs:[],errs:[]},l=new Promise((a,l)=>{let c;try{c=new o(e,{resolve:a,reject:l},...n),r.cmd=M(c,e,t,i,s)}catch(t){return l(new Error(`Error running command ${e}: ${t}`))}r.cmd.stdout.setEncoding("utf8"),r.cmd.stdout.on("data",e=>{e=e.toString(),r.logs.push(e),c.data(e)}),r.cmd.stderr.on("data",e=>{e=e.toString(),r.errs.push(e),c.error(e)}),r.cmd.once("error",e=>{c.exit(e.message,r.errs)}),r.cmd.once("exit",(e=0)=>{i.signal.aborted&&null===e&&(e=O),c.exit(e,0===e?r.logs:r.errs)})});return Object.assign(r,{promise:l,pipe:async t=>{const o=s.for("pipe");try{o.verbose(`Executing pipe function ${e}...`);const a=await l;return o.verbose(`Piping output to ${t.name}: ${a}`),t(a)}catch(e){throw o.error(`Error piping command output: ${e}`),e}}}),r}const R=a.Logging.for("fs");function J(e,t){const o=R.for(J);if(!w.default.existsSync(e))throw new Error(`File not found at path "${e}".`);let n=V(e);try{o.verbose(`Patching file "${e}"...`),o.debug(`with value: ${JSON.stringify(t)}`),n=a.patchString(n,t)}catch(e){throw new Error(`Error patching file: ${e}`)}q(e,n)}function V(e){const t=R.for(V);try{return t.verbose(`Reading file "${e}"...`),w.default.readFileSync(e,"utf8")}catch(o){throw t.verbose(`Error reading file "${e}": ${o}`),new Error(`Error reading file "${e}": ${o}`)}}function q(e,t){const o=R.for(q);try{o.verbose(`Writing file "${e} with ${t.length} bytes...`),w.default.writeFileSync(e,t,"utf8")}catch(t){throw o.verbose(`Error writing file "${e}": ${t}`),new Error(`Error writing file "${e}": ${t}`)}}function G(e,t){const o=R.for(G),a=[];try{o.verbose(`Retrieving all files from "${e}"...`);return w.default.readdirSync(e).forEach(t=>{const o=T.default.join(e,t),n=w.default.statSync(o);n.isFile()?a.push(o):n.isDirectory()&&a.push(...G(o))}),t?a.filter(t):a}catch(t){throw o.verbose(`Error retrieving files from "${e}": ${t}`),new Error(`Error retrieving files from "${e}": ${t}`)}}async function W(e,t){const o=R.for(W);let a,n;try{a=w.default.statSync(e)}catch(t){throw o.verbose(`Source path "${e}" does not exist: ${t}`),new Error(`Source path "${e}" does not exist: ${t}`)}try{n=w.default.statSync(t)}catch(e){}if(n)throw o.verbose(`Destination path "${t}" already exists`),new Error(`Destination path "${t}" already exists`);try{o.verbose(`Renaming ${a.isFile()?"file":"directory"} "${e}" to "${t}...`),w.default.renameSync(e,t),o.verbose(`Successfully renamed to "${t}"`)}catch(n){throw o.verbose(`Error renaming ${a.isFile()?"file":"directory"} "${e}" to "${t}": ${n}`),new Error(`Error renaming ${a.isFile()?"file":"directory"} "${e}" to "${t}": ${n}`)}}function X(e,t){const o=R.for(X);let a,n;try{a=w.default.statSync(e)}catch(t){throw o.verbose(`Source path "${e}" does not exist: ${t}`),new Error(`Source path "${e}" does not exist: ${t}`)}try{n=w.default.statSync(t)}catch(e){a.isDirectory()&&(o.verbose(`Dest path "${t}" does not exist. creating`),w.default.mkdirSync(t,{recursive:!0}))}try{o.verbose(`Copying ${a.isFile()?"file":"directory"} "${e}" to "${t}...`),w.default.cpSync(e,t,{recursive:!0})}catch(n){throw o.verbose(`Error copying ${a.isFile()?"file":"directory"} "${e}" to "${t}: ${n}`),new Error(`Error copying ${a.isFile()?"file":"directory"} "${e}" to "${t}: ${n}`)}}function _(e){const t=R.for(_);try{const o=w.default.statSync(e);o.isFile()?(t.verbose(`Deleting file "${e}...`),w.default.rmSync(e,{recursive:!0,force:!0})):o.isDirectory()&&w.default.rmSync(e,{recursive:!0,force:!0})}catch(o){throw t.verbose(`Error Deleting "${e}": ${o}`),new Error(`Error Deleting "${e}": ${o}`)}}function H(e=process.cwd(),t){let o;try{o=JSON.parse(V(T.default.join(e,"package.json")))}catch(e){throw new Error(`Failed to retrieve package information" ${e}`)}if(t){if(!(t in o))throw new Error(`Property "${t}" not found in package.json`);return o[t]}return o}function K(e,t,o=process.cwd()){const a=H(o);a[e]=t,q(T.default.join(o,"package.json"),JSON.stringify(a,null,2))}function z(e=process.cwd()){return H(e,"version")}async function Y(e=process.cwd()){let t;try{t=JSON.parse(await U("npm ls --json",{cwd:e}).promise)}catch(e){throw new Error(`Failed to retrieve dependencies: ${e}`)}const o=(e,t)=>({name:e[0],version:e[1].version});return{prod:Object.entries(t.dependencies||{}).map(o),dev:Object.entries(t.devDependencies||{}).map(o),peer:Object.entries(t.peerDependencies||{}).map(o)}}async function Z(e){const t=R.for(Z),o=e.prod||[],a=e.dev||[],n=e.peer||[];o.length&&(t.info(`Installing dependencies ${o.join(", ")}...`),await U(`npm install ${o.join(" ")}`,{cwd:process.cwd()}).promise),a.length&&(t.info(`Installing devDependencies ${a.join(", ")}...`),await U(`npm install --save-dev ${a.join(" ")}`,{cwd:process.cwd()}).promise),n.length&&(t.info(`Installing peerDependencies ${n.join(", ")}...`),await U(`npm install --save-peer ${n.join(" ")}`,{cwd:process.cwd()}).promise)}const Q=[{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That's Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"No caffeine, no chaos. Just clean code.",Tags:"Coffee-themed, Calm, Tech"},{Slogan:"Full flavor, no jitters. That’s Decaf-TS.",Tags:"Coffee-themed, Cheerful"},{Slogan:"Chill fullstack. Powered by Decaf.",Tags:"Coffee-themed, Fun, Tech"},{Slogan:"Decaf-TS: Brewed for calm code.",Tags:"Coffee-themed, Branding"},{Slogan:"Smooth as your morning Decaf.",Tags:"Coffee-themed, Chill"},{Slogan:"All the kick, none of the crash.",Tags:"Coffee-themed, Energetic"},{Slogan:"Sip back and ship faster.",Tags:"Coffee-themed, Fun"},{Slogan:"Keep calm and code Decaf.",Tags:"Coffee-themed, Playful"},{Slogan:"Code without the caffeine shakes.",Tags:"Coffee-themed, Humorous"},{Slogan:"Your fullstack, decaffeinated.",Tags:"Coffee-themed, Technical"},{Slogan:"Decaf-TS: Where smart contracts meet smart interfaces.",Tags:"Blockchain, Smart Contracts, Tech"},{Slogan:"Ship dApps without the stress.",Tags:"Blockchain, Cheerful, Developer"},{Slogan:"No CRUD, no problem — Decaf your data.",Tags:"Data, No-CRUD, Chill"},{Slogan:"From DID to UI, without breaking a sweat.",Tags:"DID, SSI, UI, Calm"},{Slogan:"Decaf-TS: Your frontend already understands your smart contract.",Tags:"Smart Contracts, DX, Magic"},{Slogan:"Self-sovereign by design. Productive by default.",Tags:"SSI, Developer, Calm"},{Slogan:"Build once. Deploy everywhere. Decentralized and delightful.",Tags:"Blockchain, Multi-platform, Happy"},{Slogan:"Data that defines its own destiny.",Tags:"SSI, Data-driven, Empowerment"},{Slogan:"Goodbye CRUD, hello intent-based interfaces.",Tags:"No-CRUD, UI, Technical"},{Slogan:"The smoothest path from DID to done.",Tags:"DID, Workflow, Chill"},{Slogan:"Because your dApp deserves more than boilerplate.",Tags:"Blockchain, DevX, Efficiency"},{Slogan:"Own your data. Own your flow.",Tags:"SSI, Control, Ownership"},{Slogan:"Write logic like it belongs with the data — because it does.",Tags:"Data Logic, Developer, Smart"},{Slogan:"From smart contracts to smarter frontends.",Tags:"Smart Contracts, UI, DX"},{Slogan:"No caffeine. No CRUD. Just the future.",Tags:"No-CRUD, Coffee-themed, Futuristic"},{Slogan:"The future of web3 UX is Decaf.",Tags:"Blockchain, UX, Vision"},{Slogan:"Code with confidence. Govern with clarity.",Tags:"Blockchain, Governance, Calm"},{Slogan:"Interfaces that obey the data, not the other way around.",Tags:"UI, Data Logic, Self-aware"},{Slogan:"Brew business logic right into your bytes.",Tags:"Data Logic, Coffee-themed, Fun"},{Slogan:"DIDs done differently — and delightfully.",Tags:"DID, Self-Sovereign, Playful"},{Slogan:"Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",Tags:"Blockchain, Smart Contracts, Tech"},{Slogan:"Ship dApps without the stress.",Tags:"Blockchain, Cheerful, Developer"},{Slogan:"No boilerplate, no problem — Decaf-TS your data.",Tags:"Data, No-CRUD, Chill"},{Slogan:"From DID to UI, without breaking a sweat.",Tags:"DID, SSI, UI, Calm"},{Slogan:"Decaf-TS-TS: Your frontend already understands your blockchain contract.",Tags:"Smart Contracts, DX, Magic"},{Slogan:"Self-sovereign by design. Productive by default.",Tags:"SSI, Developer, Calm"},{Slogan:"Build once. Deploy everywhere. Decentralized and delightful.",Tags:"Blockchain, Multi-platform, Happy"},{Slogan:"Data that defines its own destiny.",Tags:"SSI, Data-driven, Empowerment"},{Slogan:"Goodbye boilerplate, hello intent-based interfaces.",Tags:"No-CRUD, UI, Technical"},{Slogan:"The smoothest path from DID to done.",Tags:"DID, Workflow, Chill"},{Slogan:"Because your dApp deserves more than boilerplate.",Tags:"Blockchain, DevX, Efficiency"},{Slogan:"Own your data. Own your flow.",Tags:"SSI, Control, Ownership"},{Slogan:"Write logic like it belongs with the data — because it does.",Tags:"Data Logic, Developer, Smart"},{Slogan:"From blockchain contracts to smarter frontends.",Tags:"Smart Contracts, UI, DX"},{Slogan:"No caffeine. No boilerplate. Just the future.",Tags:"No-CRUD, Coffee-themed, Futuristic"},{Slogan:"The future of web3 UX is Decaf-TS.",Tags:"Blockchain, UX, Vision"},{Slogan:"Code with confidence. Govern with clarity.",Tags:"Blockchain, Governance, Calm"},{Slogan:"Interfaces that obey the data, not the other way around.",Tags:"UI, Data Logic, Self-aware"},{Slogan:"Brew business logic right into your bytes.",Tags:"Data Logic, Coffee-themed, Fun"},{Slogan:"DIDs done differently — and delightfully.",Tags:"DID, Self-Sovereign, Playful"},{Slogan:"Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",Tags:"Blockchain, Smart Contracts, Tech"},{Slogan:"Ship dApps without the stress.",Tags:"Blockchain, Cheerful, Developer"},{Slogan:"No boilerplate, no problem — Decaf-TS your data.",Tags:"Data, No-CRUD, Chill"},{Slogan:"From DID to UI, without breaking a sweat.",Tags:"DID, SSI, UI, Calm"},{Slogan:"Decaf-TS-TS: Your frontend already understands your blockchain contract.",Tags:"Smart Contracts, DX, Magic"},{Slogan:"Self-sovereign by design. Productive by default.",Tags:"SSI, Developer, Calm"},{Slogan:"Build once. Deploy everywhere. Decentralized and delightful.",Tags:"Blockchain, Multi-platform, Happy"},{Slogan:"Data that defines its own destiny.",Tags:"SSI, Data-driven, Empowerment"},{Slogan:"Goodbye boilerplate, hello intent-based interfaces.",Tags:"No-CRUD, UI, Technical"},{Slogan:"The smoothest path from DID to done.",Tags:"DID, Workflow, Chill"},{Slogan:"Because your dApp deserves more than boilerplate.",Tags:"Blockchain, DevX, Efficiency"},{Slogan:"Own your data. Own your flow.",Tags:"SSI, Control, Ownership"},{Slogan:"Write logic like it belongs with the data — because it does.",Tags:"Data Logic, Developer, Smart"},{Slogan:"From blockchain contracts to smarter frontends.",Tags:"Smart Contracts, UI, DX"},{Slogan:"No caffeine. No boilerplate. Just the future.",Tags:"No-CRUD, Coffee-themed, Futuristic"},{Slogan:"The future of web3 UX is Decaf-TS.",Tags:"Blockchain, UX, Vision"},{Slogan:"Code with confidence. Govern with clarity.",Tags:"Blockchain, Governance, Calm"},{Slogan:"Interfaces that obey the data, not the other way around.",Tags:"UI, Data Logic, Self-aware"},{Slogan:"Brew business logic right into your bytes.",Tags:"Data Logic, Coffee-themed, Fun"},{Slogan:"DIDs done differently — and delightfully.",Tags:"DID, Self-Sovereign, Playful"},{Slogan:"Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",Tags:"Blockchain, Smart Contracts, Tech"},{Slogan:"Ship dApps without the stress.",Tags:"Blockchain, Cheerful, Developer"},{Slogan:"No boilerplate, no problem — Decaf-TS your data.",Tags:"Data, No-CRUD, Chill"},{Slogan:"From DID to UI, without breaking a sweat.",Tags:"DID, SSI, UI, Calm"},{Slogan:"Decaf-TS-TS: Your frontend already understands your blockchain contract.",Tags:"Smart Contracts, DX, Magic"},{Slogan:"Self-sovereign by design. Productive by default.",Tags:"SSI, Developer, Calm"},{Slogan:"Build once. Deploy everywhere. Decentralized and delightful.",Tags:"Blockchain, Multi-platform, Happy"},{Slogan:"Data that defines its own destiny.",Tags:"SSI, Data-driven, Empowerment"},{Slogan:"Goodbye boilerplate, hello intent-based interfaces.",Tags:"No-CRUD, UI, Technical"},{Slogan:"The smoothest path from DID to done.",Tags:"DID, Workflow, Chill"},{Slogan:"Because your dApp deserves more than boilerplate.",Tags:"Blockchain, DevX, Efficiency"},{Slogan:"Own your data. Own your flow.",Tags:"SSI, Control, Ownership"},{Slogan:"Write logic like it belongs with the data — because it does.",Tags:"Data Logic, Developer, Smart"},{Slogan:"From blockchain contracts to smarter frontends.",Tags:"Smart Contracts, UI, DX"},{Slogan:"No caffeine. No boilerplate. Just the future.",Tags:"No-CRUD, Coffee-themed, Futuristic"},{Slogan:"The future of web3 UX is Decaf-TS.",Tags:"Blockchain, UX, Vision"},{Slogan:"Code with confidence. Govern with clarity.",Tags:"Blockchain, Governance, Calm"},{Slogan:"Interfaces that obey the data, not the other way around.",Tags:"UI, Data Logic, Self-aware"},{Slogan:"Brew business logic right into your bytes.",Tags:"Data Logic, Coffee-themed, Fun"},{Slogan:"DIDs done differently — and delightfully.",Tags:"DID, Self-Sovereign, Playful"},{Slogan:"Decaf-TS-TS: Where blockchain contracts meet smart interfaces.",Tags:"Blockchain, Smart Contracts, Tech"},{Slogan:"Ship dApps without the stress.",Tags:"Blockchain, Cheerful, Developer"},{Slogan:"No boilerplate, no problem — Decaf-TS your data.",Tags:"Data, No-CRUD, Chill"},{Slogan:"From DID to UI, without breaking a sweat.",Tags:"DID, SSI, UI, Calm"},{Slogan:"Decaf-TS-TS: Your frontend already understands your blockchain contract.",Tags:"Smart Contracts, DX, Magic"},{Slogan:"Self-sovereign by design. Productive by default.",Tags:"SSI, Developer, Calm"},{Slogan:"Build once. Deploy everywhere. Decentralized and delightful.",Tags:"Blockchain, Multi-platform, Happy"},{Slogan:"Data that defines its own destiny.",Tags:"SSI, Data-driven, Empowerment"},{Slogan:"Goodbye boilerplate, hello intent-based interfaces.",Tags:"No-CRUD, UI, Technical"},{Slogan:"The smoothest path from DID to done.",Tags:"DID, Workflow, Chill"},{Slogan:"Because your dApp deserves more than boilerplate.",Tags:"Blockchain, DevX, Efficiency"},{Slogan:"Own your data. Own your flow.",Tags:"SSI, Control, Ownership"},{Slogan:"Write logic like it belongs with the data — because it does.",Tags:"Data Logic, Developer, Smart"},{Slogan:"From blockchain contracts to smarter frontends.",Tags:"Smart Contracts, UI, DX"},{Slogan:"No caffeine. No boilerplate. Just the future.",Tags:"No-CRUD, Coffee-themed, Futuristic"},{Slogan:"The future of web3 UX is Decaf-TS.",Tags:"Blockchain, UX, Vision"},{Slogan:"Code with confidence. Govern with clarity.",Tags:"Blockchain, Governance, Calm"},{Slogan:"Interfaces that obey the data, not the other way around.",Tags:"UI, Data Logic, Self-aware"},{Slogan:"Brew business logic right into your bytes.",Tags:"Data Logic, Coffee-themed, Fun"},{Slogan:"DIDs done differently — and delightfully.",Tags:"DID, Self-Sovereign, Playful"}],ee=["","","","","","","","",""];function te(e){const t=oe(),o="#                 ░▒▓███████▓▒░  ░▒▓████████▓▒░  ░▒▓██████▓▒░   ░▒▓██████▓▒░  ░▒▓████████▓▒░       ░▒▓████████▓▒░  ░▒▓███████▓▒░ \n#      ( (        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓█▓▒░        \n#       ) )       ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓█▓▒░        \n#    [=======]    ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓██████▓▒░   ░▒▓█▓▒░        ░▒▓████████▓▒░ ░▒▓██████▓▒░            ░▒▓█▓▒░      ░▒▓██████▓▒░  \n#     `-----´     ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░            ░▒▓█▓▒░ \n#                 ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░            ░▒▓█▓▒░ \n#                 ░▒▓███████▓▒░  ░▒▓████████▓▒░  ░▒▓██████▓▒░  ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░                 ░▒▓█▓▒░     ░▒▓███████▓▒░  \n#".split("\n"),a=o.reduce((e,t)=>Math.max(e,t.length),0);o.push(`#  ${t.padStart(a-3)}`),o.forEach((t,o)=>{(e?e.info.bind(e):console.log.bind(console))(r.style(t||"").raw(ee[o]).text)})}function oe(e){try{return e=void 0===e?Math.floor(Math.random()*Q.length):e,Q[e].Slogan}catch(e){throw new Error(`Failed to retrieve slogans: ${e}`)}}class ae extends a.LoggedClass{constructor(e,t={},o=[]){super(),this.name=e,this.inputs=t,this.requirements=o,ae.log||Object.defineProperty(ae,"log",{writable:!1,value:a.Logging.for(ae.name)}),this.inputs=Object.assign({},E,t)}async checkRequirements(){const{prod:e,dev:t,peer:o}=await Y(),a=[],n=Array.from(new Set([...e,...t,...o]).values()).map(e=>e.name);for(const e of this.requirements)n.includes(e)||a.push(e);a.length}help(e){return this.log.info("This is help. I'm no use because I should have been overridden.")}async execute(){const e=$.parseArgs(this.inputs),t=a.LoggedEnvironment.accumulate(I).accumulate(e.values),{version:o,help:n,banner:s}=t;if(o)return z();if(n)return this.help(e);let i;s&&te(this.log.for(te,{timestamp:!1,style:!1,context:!1,logLevel:!1}));try{i=await this.run(t)}catch(e){throw e}return i}}class ne{static{this.log=a.Logging.for(ne)}static async downloadFile(e){return new Promise((t,o)=>{!function e(a){a=encodeURI(a),b.default.get(a,n=>{if(301===n.statusCode||307===n.statusCode)return e(n.headers.location);if(200!==n.statusCode)return ne.log.error(`Failed to fetch ${a} (status: ${n.statusCode})`),o(new Error(`Failed to fetch ${a}`));let s="";n.on("data",e=>{s+=e}),n.on("error",e=>{o(e)}),n.on("end",()=>{t(s)})})}(e)})}}function se(e){return e?Array.isArray(e)?e.map(e=>`${e}`.trim()).filter(Boolean):`${e}`.split(",").map(e=>e.trim()).filter(Boolean):[]}function ie(e){return e.replace(/^@/,"").split(/[/\-_.]+/).filter(Boolean).map((e,t)=>0===t?e.replace(/[^a-zA-Z0-9]/g,""):`${e.charAt(0).toUpperCase()}${e.slice(1)}`).join("")}function re(){let e;try{e=H(process.cwd())}catch{e=void 0}try{if(!(e&&(Object.keys(e.dependencies||{}).length>0||Object.keys(e.devDependencies||{}).length>0||Object.keys(e.peerDependencies||{}).length>0))){const t=T.default.resolve(__dirname,"../../..");try{e=H(t)}catch{}}}catch{}const t=Object.keys(e&&e.dependencies||{}),o=Object.keys(e&&e.peerDependencies||{}),a=Object.keys(e&&e.devDependencies||{});return Array.from(new Set([...t,...o,...a]))}var le,ce;!function(e){e.CJS="commonjs",e.ESM="es2022"}(le||(le={})),function(e){e.BUILD="build",e.BUNDLE="bundle",e.ALL="all"}(ce||(ce={}));const ge={prod:{type:"boolean",default:!1},dev:{type:"boolean",default:!1},buildMode:{type:"string",default:ce.ALL},includes:{type:"string",default:""},externals:{type:"string",default:""},docs:{type:"boolean",default:!1},commands:{type:"boolean",default:!1},banner:{type:"boolean",default:!1}},de=(e=".cjs")=>{const t=fe.log.for(de),o=new Map;return a=>n=>{const s=T.default.dirname(n.fileName);function i(a){const n=JSON.stringify([s,a]),i=o.get(n);if(null!=i)return i;let r,l=a;try{l=T.default.resolve(s,l+".ts")}catch(e){throw new Error(`Failed to resolve path ${a}: ${e}`)}try{r=w.default.statSync(l)}catch(e){try{t.verbose(`Testing existence of path ${l} as a folder defaulting to index file`),r=w.default.statSync(l.replace(/\.ts$/gm,""))}catch(t){throw new Error(`Failed to resolve path ${a}: ${e}, ${t}`)}}if(r.isDirectory()&&(l=l.replace(/\.ts$/gm,"/index.ts")),T.default.isAbsolute(l)){const t=(/\.tsx?$/.exec(T.default.basename(l))||[])[0]||void 0;l="./"+T.default.relative(s,T.default.resolve(T.default.dirname(l),T.default.basename(l,t)+e))}return o.set(n,l),l}return k.visitNode(n,function e(t){if(function(e){return!(!k.isImportDeclaration(e)&&!k.isExportDeclaration(e))&&(void 0!==e.moduleSpecifier&&(!!k.isStringLiteral(e.moduleSpecifier)&&(!(!e.moduleSpecifier.text.startsWith("./")&&!e.moduleSpecifier.text.startsWith("../"))&&""===T.default.extname(e.moduleSpecifier.text))))}(t)){if(k.isImportDeclaration(t)){const e=i(t.moduleSpecifier.text),o=a.factory.createStringLiteral(e);return a.factory.updateImportDeclaration(t,t.modifiers,t.importClause,o,void 0)}if(k.isExportDeclaration(t)){const e=i(t.moduleSpecifier.text),o=a.factory.createStringLiteral(e);return a.factory.updateExportDeclaration(t,t.modifiers,t.isTypeOnly,t.exportClause,o,void 0)}}return k.visitEachChild(t,e,a)})}};class fe extends ae{constructor(){super("BuildScripts",Object.assign({},E,ge)),this.replacements={};const e=H(),{name:t,version:o}=e;this.pkgName=t.includes("@")?t.split("/")[1]:t,this.pkgVersion=o,this.replacements["0.4.2"]=this.pkgVersion,this.replacements["@decaf-ts/utils"]=t}patchFiles(e){const t=this.log.for(this.patchFiles),{name:o,version:a}=H();t.info(`Patching ${o} ${a} module in ${e}...`);w.default.statSync(e).isDirectory()&&w.default.readdirSync(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()).forEach(e=>J(T.default.join(e.parentPath,e.name),this.replacements)),t.verbose(`Module ${o} ${a} patched in ${e}...`)}reportDiagnostics(e,t){const o=this.formatDiagnostics(e);if(!Object.values(a.LogLevel).includes(t))throw new Error(`Invalid LogLevel ${t}`);try{this.log[t](o)}catch(e){throw console.warn(`Failed to get logger for ${t}`),e}return o}formatDiagnostics(e){return e.map(e=>{let t="";if(e.file&&e.start){const{line:o,character:a}=e.file.getLineAndCharacterOfPosition(e.start);t+=`${e.file.fileName} (${o+1},${a+1})`}return t+=": "+k.flattenDiagnosticMessageText(e.messageText,"\n"),t}).join("\n")}readConfigFile(e){const t=w.default.readFileSync(e).toString(),o=k.parseConfigFileTextToJson(e,t),n=o.config;n||this.reportDiagnostics([o.error],a.LogLevel.error);const s=k.parseJsonConfigFileContent(n,k.sys,T.default.dirname(e));return s.errors.length>0&&this.reportDiagnostics(s.errors,a.LogLevel.error),s}evalDiagnostics(e){if(e&&e.length>0){const t=e.filter(e=>e.category===k.DiagnosticCategory.Error),o=e.filter(e=>e.category===k.DiagnosticCategory.Warning),n=e.filter(e=>e.category===k.DiagnosticCategory.Suggestion),s=e.filter(e=>e.category===k.DiagnosticCategory.Message);o.length&&this.reportDiagnostics(o,a.LogLevel.info),t.length&&(this.reportDiagnostics(e,a.LogLevel.error),this.log.info(`TypeScript reported ${e.length} diagnostic(s) during check; aborting.`)),n.length&&this.reportDiagnostics(n,a.LogLevel.info),s.length&&this.reportDiagnostics(s,a.LogLevel.info)}}preCheckDiagnostics(e){const t=k.getPreEmitDiagnostics(e);this.evalDiagnostics(t)}async checkTsDiagnostics(e,t,o=!1){const a=this.log.for(this.checkTsDiagnostics);let n;try{n=this.readConfigFile("./tsconfig.json")}catch(e){throw new Error(`Failed to parse tsconfig.json: ${e}`)}o?(n.options.module=p.ModuleKind.AMD,n.options.outDir="dist",n.options.isolatedModules=!1,n.options.outFile=this.pkgName):(n.options.outDir="lib"+(t===le.ESM?"/esm":""),n.options.module=t===le.ESM?p.ModuleKind.ES2022:p.ModuleKind.CommonJS),e?(n.options.inlineSourceMap=!0,n.options.sourceMap=!1):n.options.sourceMap=!1;const s=k.createProgram(n.fileNames,n.options);this.preCheckDiagnostics(s),a.verbose(`TypeScript checks passed (${o?"bundle":"normal"} mode).`)}async buildTs(e,t,o=!1){let a;this.log.for(this.buildTs).info(`Building ${this.pkgName} ${this.pkgVersion} module (${t}) in ${e?"dev":"prod"} mode...`);try{a=this.readConfigFile("./tsconfig.json")}catch(e){throw new Error(`Failed to parse tsconfig.json: ${e}`)}o?(a.options.module=p.ModuleKind.AMD,a.options.outDir="dist",a.options.isolatedModules=!1,a.options.outFile=this.pkgName):(a.options.outDir="lib"+(t===le.ESM?"/esm":""),a.options.module=t===le.ESM?p.ModuleKind.ES2022:p.ModuleKind.CommonJS),e?(a.options.inlineSourceMap=!0,a.options.sourceMap=!1):a.options.sourceMap=!1;const n=k.createProgram(a.fileNames,a.options),s={};t===le.CJS?s.before=[de(".cjs")]:t===le.ESM&&(s.before=[de(".js")]);const i=n.emit(void 0,void 0,void 0,void 0,s),r=k.getPreEmitDiagnostics(n).concat(i.diagnostics);this.evalDiagnostics(r)}async build(e,t,o=!1){const a=this.log.for(this.build);if(await this.buildTs(e,t,o),a.verbose(`Module ${this.pkgName} ${this.pkgVersion} (${t}) built in ${e?"dev":"prod"} mode...`),t===le.CJS&&!o){const e=G("lib",e=>e.endsWith(".js")&&!e.includes("/esm/"));for(const t of e){a.verbose(`Patching ${t}'s cjs imports...`);const e=t.replace(".js",".cjs");await W(t,e)}}}copyAssets(e){const t=this.log.for(this.copyAssets);let o=!1;try{o=w.default.statSync("./src/assets").isDirectory()}catch(e){return t.verbose("No assets found in ./src/assets to copy")}o&&X("./src/assets",`./${e===le.CJS?"lib":"dist"}/assets`)}async bundle(e,t,o,a="src/index.ts",n=this.pkgName,s,i=["prompts","styled-string-builder","typed-object-accumulator","@decaf-ts/logging"]){await this.checkTsDiagnostics(t,e,!0);const r=e===le.ESM,l=this.pkgName,g=Array.from(new Set([...se(i)]));let d=se(s);0===d.length&&(d=re());const u=Array.from(new Set([...function(){try{return Array.isArray(h.builtinModules)?h.builtinModules:[]}catch{return["fs","path","process","child_process","util","https","http","os","stream","crypto","zlib","net","tls","url","querystring","assert","events","tty","dns","querystring"]}}(),...d])),p=[C.default({compilerOptions:{module:"esnext",declaration:!1,outDir:o?"bin":"dist"},include:["src/**/*.ts"],exclude:["node_modules","**/*.spec.ts"],tsconfig:"./tsconfig.json"}),D.default()];if(!t)try{const w=await import("@rollup/plugin-terser"),T=w&&w.terser||w.default||w;p.push(T())}catch{}o&&p.push(v.default({include:[],exclude:d}),f.nodeResolve({resolveOnly:g}));const m={input:a,plugins:p,external:u},S={};u.forEach(e=>{S[e]=ie(e)});const y=[{file:`${o?"bin/":"dist/"}${n||".bundle."+(t?"":"min")}${r?".esm":""}.cjs`,format:o?"cjs":r?"esm":"umd",name:l,esModule:r,sourcemap:!!t&&"inline",globals:S,exports:"auto"}];try{const b=await c.rollup(m);async function k(e){for(const t of y)await e.write(t)}console.log(b.watchFiles),await k(b)}catch($){throw new Error(`Failed to bundle: ${$}`)}}async buildByEnv(e,t=ce.ALL,o,a){try{_("lib")}catch(e){}try{_("dist")}catch(e){}w.default.mkdirSync("lib"),w.default.mkdirSync("dist"),[ce.ALL,ce.BUILD].includes(t)&&(await this.build(e,le.ESM),await this.build(e,le.CJS),this.patchFiles("lib")),[ce.ALL,ce.BUNDLE].includes(t)&&(await this.bundle(le.ESM,e,!1,"src/index.ts",this.pkgName,a,o),await this.bundle(le.CJS,e,!1,"src/index.ts",this.pkgName,a,o),this.patchFiles("dist")),this.copyAssets(le.CJS),this.copyAssets(le.ESM)}async buildDev(e=ce.ALL,t,o){return this.buildByEnv(!0,e,t,o)}async buildProd(e=ce.ALL,t,o){return this.buildByEnv(!1,e,t,o)}async buildDocs(){await U("npm install better-docs taffydb").promise,await U("npx markdown-include ./workdocs/readme-md.json").promise,await U("npx jsdoc -c ./workdocs/jsdocs.json -t ./node_modules/better-docs").promise,await U("npm remove better-docs taffydb").promise,[{src:"workdocs/assets",dest:"./docs/workdocs/assets"},{src:"workdocs/reports/coverage",dest:"./docs/workdocs/reports/coverage"},{src:"workdocs/reports/html",dest:"./docs/workdocs/reports/html"},{src:"workdocs/resources",dest:"./docs/workdocs/resources"},{src:"LICENSE.md",dest:"./docs/LICENSE.md"}].forEach(e=>{const{src:t,dest:o}=e;X(t,o)})}async run(e){const{dev:t,prod:o,docs:a,buildMode:n,includes:s,externals:i}=e;return t?await this.buildDev(n,s,i):o?await this.buildProd(n,s,i):a?await this.buildDocs():void 0}}const ue={ci:{type:"boolean",default:!0},message:{type:"string",short:"m"},tag:{type:"string",short:"t",default:void 0}};const he="https://raw.githubusercontent.com/decaf-ts/ts-workspace/master",pe={templates:[".github/ISSUE_TEMPLATE/bug_report.md",".github/ISSUE_TEMPLATE/feature_request.md",".github/FUNDING.yml"],workflows:[".github/workflows/codeql-analysis.yml",".github/workflows/jest-coverage.yaml",".github/workflows/nodejs-build-prod.yaml",".github/workflows/pages.yaml",".github/workflows/publish-on-release.yaml",".github/workflows/release-on-tag.yaml",".github/workflows/snyk-analysis.yaml"],ide:[".idea/runConfigurations/All Tests.run.xml",".idea/runConfigurations/build.run.xml",".idea/runConfigurations/build_prod.run.xml",".idea/runConfigurations/coverage.run.xml",".idea/runConfigurations/docs.run.xml",".idea/runConfigurations/drawings.run.xml",".idea/runConfigurations/flash-forward.run.xml",".idea/runConfigurations/Integration_Tests.run.xml",".idea/runConfigurations/Bundling_Tests.run.xml",".idea/runConfigurations/lint-fix.run.xml",".idea/runConfigurations/release.run.xml",".idea/runConfigurations/test_circular.run.xml",".idea/runConfigurations/uml.run.xml",".idea/runConfigurations/Unit Tests.run.xml",".idea/runConfigurations/update-scripts.run.xml"],docs:["workdocs/tutorials/Contributing.md","workdocs/tutorials/Documentation.md","workdocs/tutorials/For Developers.md","workdocs/2-Badges.md","workdocs/jsdocs.json","workdocs/readme-md.json"],styles:[".prettierrc","eslint.config.js"],scripts:["bin/update-scripts.cjs","bin/tag-release.cjs","bin/build-scripts.cjs"],tests:["jest.config.ts","workdocs/reports/jest.coverage.config.ts"],typescript:["tsconfig.json"],docker:["Dockerfile"],automation:["workdocs/confluence/Continuous Integration-Deployment/GitHub.md","workdocs/confluence/Continuous Integration-Deployment/Jira.md","workdocs/confluence/Continuous Integration-Deployment/Teams.md"]},me={boot:{type:"boolean"},org:{type:"string",short:"o"},name:{type:"string",short:"n",default:void 0},author:{type:"string",short:"a",default:void 0},all:{type:"boolean"},license:{type:"string",message:"Pick the license"},scripts:{type:"boolean"},styles:{type:"boolean"},docs:{type:"boolean"},ide:{type:"boolean"},workflows:{type:"boolean"},templates:{type:"boolean"},typescript:{type:"boolean"},docker:{type:"boolean"},pkg:{type:"boolean"},dependencies:{type:"boolean"},tests:{type:"boolean"},automation:{type:"boolean"}};e.AbortCode=O,e.BuildScripts=fe,e.Command=ae,e.DefaultCommandOptions=E,e.DefaultCommandValues=I,e.Encoding=F,e.HttpClient=ne,e.NoCIFLag=A,e.PACKAGE_NAME="@decaf-ts/utils",e.RegexpOutputWriter=class extends L{constructor(e,t,o,a="g"){super(e,t);try{this.regexp="string"==typeof o?new RegExp(o,a):o}catch(e){throw new Error(`Invalid regular expression: ${e}`)}}test(e){let t;this.regexp.lastIndex=0;try{t=this.regexp.exec(e)}catch(t){return console.debug(`Failed to parse chunk: ${e}\nError: ${t} `)}return t}testAndResolve(e){const t=this.test(e);t&&this.resolve(t[0])}testAndReject(e){const t=this.test(e);t&&this.reject(t[0])}data(e){super.data(e),this.testAndResolve(String(e))}error(e){super.error(e),this.testAndReject(String(e))}},e.ReleaseScript=class extends ae{constructor(){super("ReleaseScript",ue)}async prepareVersion(e){const t=this.log.for(this.prepareVersion);return(e=this.testVersion(e||""))||(t.verbose("No release message provided. Prompting for one:"),t.info("Listing latest git tags:"),await U("git tag --sort=-taggerdate | head -n 5").promise,await $.insistForText("tag","Enter the new tag number (accepts v*.*.*[-...])",e=>!!e.toString().match(/^v[0-9]+\.[0-9]+.[0-9]+(-[0-9a-zA-Z-]+)?$/)))}testVersion(t){const o=this.log.for(this.testVersion);switch(t=t.trim().toLowerCase()){case e.SemVersion.PATCH:case e.SemVersion.MINOR:case e.SemVersion.MAJOR:return o.verbose(`Using provided SemVer update: ${t}`,1),t;default:return o.verbose(`Testing provided version for SemVer compatibility: ${t}`,1),new RegExp(j).test(t)?(o.verbose(`version approved: ${t}`,1),t):void o.debug(`Invalid version number: ${t}`)}}async prepareMessage(e){const t=this.log.for(this.prepareMessage);return e||(t.verbose("No release message provided. Prompting for one"),await $.insistForText("message","What should be the release message/ticket?",e=>!!e&&e.toString().length>5))}async run(e){let t;const{ci:o}=e;let{tag:a,message:n}=e;a=await this.prepareVersion(a),n=await this.prepareMessage(n),t=await U(`npm run prepare-release -- ${a} ${n}`,{cwd:process.cwd()}).promise,t=await U("git status --porcelain").promise,await t,t.logs.length&&await $.askConfirmation("git-changes","Do you want to push the changes to the remote repository?",!0)&&(await U("git add .").promise,await U(`git commit -m "${a} - ${n} - after release preparation${o?"":A}"`).promise),await U(`npm version "${a}" -m "${n}${o?"":A}"`).promise,await U("git push --follow-tags").promise,o||await U("NPM_TOKEN=$(cat .npmtoken) npm publish --access public").promise}},e.SemVersionRegex=j,e.SetupScriptKey=N,e.StandardOutputWriter=L,e.TemplateSync=class extends ae{constructor(){super("TemplateSync",me),this.replacements={},this.getStyles=()=>this.downloadOption("styles"),this.getTemplates=()=>this.downloadOption("templates"),this.getWorkflows=()=>this.downloadOption("workflows"),this.getDocs=()=>this.downloadOption("docs"),this.getTypescript=()=>this.downloadOption("typescript"),this.getAutomation=()=>this.downloadOption("automation"),this.getTests=()=>this.downloadOption("tests"),this.getDocker=()=>this.downloadOption("docker")}loadValuesFromPackage(){const e=process.cwd(),t=H(e,"author");let o,a=H(e,"name");if(a.startsWith("@")){const e=a.split("/");a=e[1],o=e[0].replace("@","")}["Tiago Venceslau","TiagoVenceslau","${author}"].forEach(e=>this.replacements[e]=t),["TS-Workspace","ts-workspace","${name}"].forEach(e=>this.replacements[e]=a),["decaf-ts","${org}"].forEach(e=>this.replacements[e]=o||'""'),this.replacements["${org_or_owner}"]=o||a}async downloadOption(e){if(!(e in pe))throw new Error(`Option "${e}" not found in options`);const t=pe[e];for(const e of t){this.log.info(`Downloading ${e}`);let t=await ne.downloadFile(`${he}/${e}`);t=a.patchString(t,this.replacements),q(T.default.join(process.cwd(),e),t)}}async getLicense(e){this.log.info(`Downloading ${e} license`);const t=`${he}/workdocs/licenses/${e}.md`;let o=await ne.downloadFile(t);o=a.patchString(o,this.replacements),q(T.default.join(process.cwd(),"LICENSE.md"),o),K("license",e)}async getIde(){w.default.mkdirSync(T.default.join(process.cwd(),".idea","runConfigurations"),{recursive:!0}),await this.downloadOption("ide")}async getScripts(){await this.downloadOption("scripts"),this.log.info("please re-run the command"),process.exit(0)}async initPackage(e,t,o){try{const a=H();delete a[N],a.name=e,a.version="0.0.1",a.author=t,a.license=o,w.default.writeFileSync("package.json",JSON.stringify(a,null,2))}catch(e){throw new Error(`Error fixing package.json: ${e}`)}}async updatePackageScrips(){try{const e=JSON.parse(await ne.downloadFile(`${he}/package.json`)),{scripts:t}=e,o=H();Object.keys(o.scripts).forEach(e=>{if(e in t){const n=a.patchString(t[e],this.replacements);n!==t[e]&&(o.scripts[e]=n)}}),o.exports.require=e.exports.require,o.exports.import=e.exports.import,o.types=e.types,w.default.writeFileSync("package.json",JSON.stringify(o,null,2))}catch(e){throw new Error(`Error fixing package.json scripts: ${e}`)}}async createTokenFiles(){const t=this.log.for(this.createTokenFiles),o=await $.insistForText("token","please input your github token",e=>!!e.match(/^ghp_[0-9a-zA-Z]{36}$/g));Object.values(e.Tokens).forEach(e=>{try{let a;try{a=w.default.existsSync(e)}catch(a){return t.info(`Token file ${e} not found. Creating a new one...`),void w.default.writeFileSync(e,".token"===e?o:"")}a||w.default.writeFileSync(e,".token"===e?o:"")}catch(t){throw new Error(`Error creating token file ${e}: ${t}`)}})}async getOrg(){const e=await $.askText("Organization","Enter the organization name (will be used to scope your npm project. leave blank to create a unscoped project):");return await $.askConfirmation("Confirm organization","Is this organization correct?",!0)?e:this.getOrg()}async auditFix(){return await U("npm audit fix --force").promise}patchFiles(){const e=[...w.default.readdirSync(T.default.join(process.cwd(),"src"),{recursive:!0,withFileTypes:!0}).filter(e=>e.isFile()).map(e=>T.default.join(e.parentPath,e.name)),...w.default.readdirSync(T.default.join(process.cwd(),"workdocs"),{recursive:!0,withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(".md")).map(e=>T.default.join(e.parentPath,e.name)),T.default.join(process.cwd(),".gitlab-ci.yml"),T.default.join(process.cwd(),"workdocs","jsdocs.json")];for(const t of e)J(t,this.replacements)}async updateDependencies(){try{const e=JSON.parse(await ne.downloadFile(`${he}/package.json`)),{devDependencies:t}=e,o=H();Object.keys(o.scripts).forEach(e=>{if(e in t){const a=t[e];a!==t[e]&&(o.devDependencies=o.devDependencies||{},o.devDependencies[e]=a)}}),w.default.writeFileSync("package.json",JSON.stringify(o,null,2)),await U("npm install").promise}catch(e){throw new Error(`Error fixing package.json dependencies: ${e}`)}}async run(e){let{license:t}=e;const{boot:o}=e;let{all:a,scripts:n,styles:s,docs:i,ide:r,workflows:l,templates:c,docker:g,typescript:d,dependencies:f,tests:u,automation:h,pkg:p}=e;if((n||s||i||r||l||c||g||d||h||f||u||p)&&(a=!1),o){const e=await this.getOrg(),o=await $.insistForText("Project name","Enter the project name:",e=>e.length>1),a=await $.insistForText("Author","Enter the author name:",e=>e.length>1),n=e?`@${e}/${o}`:o;await this.initPackage(n,a,t),await this.createTokenFiles(),await this.auditFix(),this.patchFiles()}if(a&&(n=!1,s=!0,i=!0,r=!0,l=!0,c=!0,g=!0,d=!0,p=!0,f=!0,u=!0,h=!1),void 0===n&&(n=await $.askConfirmation("scripts","Do you want to get scripts?",!0)),n&&await this.getScripts(),this.loadValuesFromPackage(),!a&&void 0===t){await $.askConfirmation("license","Do you want to set a license?",!0)&&(t=await $.insistForText("license","Enter the desired License (MIT|GPL|Apache|LGPL|AGPL):",e=>!!e&&!!e.match(/^(MIT|GPL|Apache|LGPL|AGPL)$/g)))}void 0!==t&&await this.getLicense(t),void 0===r&&(r=await $.askConfirmation("ide","Do you want to get ide configs?",!0)),r&&await this.getIde(),void 0===d&&(d=await $.askConfirmation("typescript","Do you want to get typescript configs?",!0)),d&&await this.getTypescript(),void 0===g&&(g=await $.askConfirmation("docker","Do you want to get docker configs?",!0)),g&&await this.getDocker(),void 0===h&&(h=await $.askConfirmation("automation","Do you want to get automation configs?",!0)),h&&await this.getAutomation(),void 0===s&&(s=await $.askConfirmation("styles","Do you want to get styles?",!0)),s&&await this.getStyles(),void 0===i&&(i=await $.askConfirmation("docs","Do you want to get docs?",!0)),i&&await this.getDocs(),void 0===l&&(l=await $.askConfirmation("workflows","Do you want to get workflows?",!0)),l&&await this.getWorkflows(),void 0===c&&(c=await $.askConfirmation("templates","Do you want to get templates?",!0)),c&&await this.getTemplates(),void 0===p&&(p=await $.askConfirmation("pkg","Do you want to update your package.json scripts?",!0)),p&&await this.updatePackageScrips(),void 0===u&&(u=await $.askConfirmation("pkg","Do you want to update your test configs?",!0)),u&&await this.getTests(),void 0===f&&(f=await $.askConfirmation("pkg","Do you want to update dev dependencies?",!0)),f&&await this.updateDependencies()}},e.UserInput=$,e.VERSION="0.4.2",e.chainAbortController=B,e.copyFile=X,e.deletePath=_,e.getAllFiles=G,e.getDependencies=Y,e.getPackage=H,e.getPackageDependencies=re,e.getPackageVersion=z,e.getSlogan=oe,e.installDependencies=Z,e.installIfNotAvailable=async function(e,t){if(!t){const e=await Y();t={prod:e.prod?.map(e=>e.name)||[],dev:e.dev?.map(e=>e.name)||[],peer:e.peer?.map(e=>e.name)||[]}}const{prod:o,dev:a,peer:n}=t,s=Array.from(new Set([...o||[],...a||[],...n||[]])),i=(e="string"==typeof e?[e]:e).filter(e=>!s.includes(e));return i.length&&await Z({dev:i}),t.dev=t.dev||[],t.dev.push(...i),t},e.lockify=function(e){let t=Promise.resolve();return(...o)=>{const a=t.then(()=>e(...o));return t=a.catch(()=>{}),a}},e.normalizeImport=async function(e){return e.then(e=>e.default||e)},e.packageToGlobal=ie,e.parseList=se,e.patchFile=J,e.printBanner=te,e.pushToGit=async function e(){const t=R.for(e),o=await U("git config user.name").promise,a=await U("git config user.email").promise;t.verbose(`cached git id: ${o}/${a}. changing to automation`),await U('git config user.email "automation@decaf.ts"').promise,await U('git config user.name "decaf"').promise,t.info("Pushing changes to git..."),await U("git add .").promise,await U('git commit -m "refs #1 - after repo setup"').promise,await U("git push").promise,await U(`git config user.email "${a}"`).promise,await U(`git config user.name "${o}"`).promise,t.verbose(`reverted to git id: ${o}/${a}`)},e.readFile=V,e.renameFile=W,e.runCommand=U,e.setPackageAttribute=K,e.spawnCommand=M,e.updateDependencies=async function e(){const t=R.for(e);t.info("checking for updates..."),await U("npx npm-check-updates -u").promise,t.info("updating..."),await U("npx npm run do-install").promise},e.writeFile=q});