@decaf-ts/utils 0.4.1 → 0.4.3

package/dist/utils.esm.cjs

@@ -1,4163 +1 @@
-import prompts from 'prompts';
-import { parseArgs } from 'util';
-import { Logging, patchString, LoggedClass, LoggedEnvironment, LogLevel } from '@decaf-ts/logging';
-import fs from 'fs';
-import path from 'path';
-import { spawn } from 'child_process';
-import { style } from 'styled-string-builder';
-import https from 'https';
-import { rollup } from 'rollup';
-import typescript from '@rollup/plugin-typescript';
-import commonjs from '@rollup/plugin-commonjs';
-import { nodeResolve } from '@rollup/plugin-node-resolve';
-import json from '@rollup/plugin-json';
-import { builtinModules } from 'module';
-import * as ts from 'typescript';
-import { ModuleKind } from 'typescript';
-
-/**
- * @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.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(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 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
- */
-var SemVersion;
-(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";
-})(SemVersion || (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
- */
-var Tokens;
-(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";
-})(Tokens || (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.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" ? 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 ? style(code.toString()).green.text : 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: ${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: ${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 = 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.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.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.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 = 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.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.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.readdirSync(p);
-        entries.forEach((entry) => {
-            const fullPath = path.join(p, entry);
-            const stat = fs.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.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.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.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.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.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.mkdirSync(dest, { recursive: true });
-        }
-    }
-    try {
-        log.verbose(`Copying ${descriptorSource.isFile() ? "file" : "directory"} "${source}" to "${dest}...`);
-        fs.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.statSync(p);
-        if (descriptor.isFile()) {
-            log.verbose(`Deleting file "${p}...`);
-            fs.rmSync(p, { recursive: true, force: true });
-        }
-        else if (descriptor.isDirectory())
-            fs.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.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.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))(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 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.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 = 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.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.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.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.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.resolve(sourceDir, resolvedPath + ".ts");
-                }
-                catch (error) {
-                    throw new Error(`Failed to resolve path ${importPath}: ${error}`);
-                }
-                let stat;
-                try {
-                    stat = fs.statSync(resolvedPath);
-                }
-                catch (e) {
-                    try {
-                        log.verbose(`Testing existence of path ${resolvedPath} as a folder defaulting to index file`);
-                        stat = fs.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.isAbsolute(resolvedPath)) {
-                    const extension = (/\.tsx?$/.exec(path.basename(resolvedPath)) || [])[0] || void 0;
-                    resolvedPath =
-                        "./" +
-                            path.relative(sourceDir, path.resolve(path.dirname(resolvedPath), path.basename(resolvedPath, extension) + ext));
-                }
-                resolutionCache.set(cacheKey, resolvedPath);
-                return resolvedPath;
-            }
-            function visitNode(node) {
-                if (shouldMutateModuleSpecifier(node)) {
-                    if (ts.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.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.visitEachChild(node, visitNode, transformationContext);
-            }
-            function shouldMutateModuleSpecifier(node) {
-                if (!ts.isImportDeclaration(node) && !ts.isExportDeclaration(node))
-                    return false;
-                if (node.moduleSpecifier === undefined)
-                    return false;
-                // only when module specifier is valid
-                if (!ts.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.extname(node.moduleSpecifier.text) !== "")
-                    return false;
-                return true;
-            }
-            return ts.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.statSync(p);
-        if (stat.isDirectory())
-            fs.readdirSync(p, { withFileTypes: true, recursive: true })
-                .filter((p) => p.isFile())
-                .forEach((file) => patchFile(path.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(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.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
-            return message;
-        })
-            .join("\n");
-    }
-    readConfigFile(configFileName) {
-        // Read config file
-        const configFileText = fs.readFileSync(configFileName).toString();
-        // Parse JSON, after removing comments. Just fancier JSON.parse
-        const result = ts.parseConfigFileTextToJson(configFileName, configFileText);
-        const configObject = result.config;
-        if (!configObject) {
-            this.reportDiagnostics([result.error], LogLevel.error);
-        }
-        // Extract config infromation
-        const configParseResult = ts.parseJsonConfigFileContent(configObject, ts.sys, path.dirname(configFileName));
-        if (configParseResult.errors.length > 0)
-            this.reportDiagnostics(configParseResult.errors, LogLevel.error);
-        return configParseResult;
-    }
-    evalDiagnostics(diagnostics) {
-        if (diagnostics && diagnostics.length > 0) {
-            const errors = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Error);
-            const warnings = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Warning);
-            const suggestions = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Suggestion);
-            const messages = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Message);
-            // Log diagnostics to console
-            if (warnings.length)
-                this.reportDiagnostics(warnings, LogLevel.info);
-            if (errors.length) {
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                this.reportDiagnostics(diagnostics, 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, LogLevel.info);
-            if (messages.length)
-                this.reportDiagnostics(messages, LogLevel.info);
-        }
-    }
-    preCheckDiagnostics(program) {
-        const diagnostics = ts.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 = 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 ? ModuleKind.ES2022 : ModuleKind.CommonJS;
-        }
-        if (isDev) {
-            tsConfig.options.inlineSourceMap = true;
-            tsConfig.options.sourceMap = false;
-        }
-        else {
-            tsConfig.options.sourceMap = false;
-        }
-        const program = ts.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 = 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 ? ModuleKind.ES2022 : ModuleKind.CommonJS;
-        }
-        if (isDev) {
-            tsConfig.options.inlineSourceMap = true;
-            tsConfig.options.sourceMap = false;
-        }
-        else {
-            tsConfig.options.sourceMap = false;
-        }
-        const program = ts.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
-            .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.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(builtinModules) ? 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({
-                compilerOptions: {
-                    module: "esnext",
-                    declaration: false,
-                    outDir: isLib ? "bin" : "dist",
-                },
-                include: ["src/**/*.ts"],
-                exclude: ["node_modules", "**/*.spec.ts"],
-                tsconfig: "./tsconfig.json",
-            }),
-            json(),
-        ];
-        // 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({
-                include: [],
-                exclude: externalsList,
-            }), 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(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.mkdirSync("lib");
-        fs.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 SemVersion.PATCH:
-            case SemVersion.MINOR:
-            case 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 = patchString(data, this.replacements);
-            writeFile(path.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 = patchString(data, this.replacements);
-        writeFile(path.join(process.cwd(), "LICENSE.md"), data);
-        setPackageAttribute("license", license);
-    }
-    /**
-     * @description Downloads IDE configuration files.
-     * @returns {Promise<void>}
-     */
-    async getIde() {
-        fs.mkdirSync(path.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.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 = 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.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(Tokens).forEach((token) => {
-            try {
-                let status;
-                try {
-                    status = fs.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.writeFileSync(token, token === ".token" ? gitToken : "");
-                    return;
-                }
-                if (!status) {
-                    fs.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
-                .readdirSync(path.join(process.cwd(), "src"), {
-                recursive: true,
-                withFileTypes: true,
-            })
-                .filter((entry) => entry.isFile())
-                .map((entry) => path.join(entry.parentPath, entry.name)),
-            ...fs
-                .readdirSync(path.join(process.cwd(), "workdocs"), {
-                recursive: true,
-                withFileTypes: true,
-            })
-                .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
-                .map((entry) => path.join(entry.parentPath, entry.name)),
-            path.join(process.cwd(), ".gitlab-ci.yml"),
-            path.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.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";
-
-export { AbortCode, BuildScripts, Command, DefaultCommandOptions, DefaultCommandValues, Encoding, HttpClient, NoCIFLag, PACKAGE_NAME, RegexpOutputWriter, ReleaseScript, SemVersion, SemVersionRegex, SetupScriptKey, StandardOutputWriter, TemplateSync, Tokens, UserInput, VERSION, chainAbortController, copyFile, deletePath, getAllFiles, getDependencies, getPackage, getPackageDependencies, getPackageVersion, getSlogan, installDependencies, installIfNotAvailable, lockify, normalizeImport, packageToGlobal, parseList, patchFile, printBanner, pushToGit, readFile, renameFile, runCommand, setPackageAttribute, spawnCommand, updateDependencies, writeFile };
+import e from"prompts";import{parseArgs as t}from"util";import{Logging as o,patchString as a,LoggedClass as s,LoggedEnvironment as n,LogLevel as r}from"@decaf-ts/logging";import i from"fs";import c from"path";import{spawn as l}from"child_process";import{style as g}from"styled-string-builder";import d from"https";import{rollup as f}from"rollup";import h from"@rollup/plugin-typescript";import u from"@rollup/plugin-commonjs";import{nodeResolve as p}from"@rollup/plugin-node-resolve";import m from"@rollup/plugin-json";import{builtinModules as S}from"module";import*as y from"typescript";import{ModuleKind as w}from"typescript";class T{static{this.logger=o.for(T)}constructor(e){this.type="text",this.name=e}setType(e){return T.logger.verbose(`Setting type to: ${e}`),this.type=e,this}setMessage(e){return T.logger.verbose(`Setting message to: ${e}`),this.message=e,this}setInitial(e){return T.logger.verbose(`Setting initial value to: ${e}`),this.initial=e,this}setStyle(e){return T.logger.verbose(`Setting style to: ${e}`),this.style=e,this}setFormat(e){return T.logger.verbose("Setting format function"),this.format=e,this}setValidate(e){return T.logger.verbose("Setting validate function"),this.validate=e,this}setOnState(e){return T.logger.verbose("Setting onState callback"),this.onState=e,this}setMin(e){return T.logger.verbose(`Setting min value to: ${e}`),this.min=e,this}setMax(e){return T.logger.verbose(`Setting max value to: ${e}`),this.max=e,this}setFloat(e){return T.logger.verbose(`Setting float to: ${e}`),this.float=e,this}setRound(e){return T.logger.verbose(`Setting round to: ${e}`),this.round=e,this}setInstructions(e){return T.logger.verbose(`Setting instructions to: ${e}`),this.instructions=e,this}setIncrement(e){return T.logger.verbose(`Setting increment to: ${e}`),this.increment=e,this}setSeparator(e){return T.logger.verbose(`Setting separator to: ${e}`),this.separator=e,this}setActive(e){return T.logger.verbose(`Setting active style to: ${e}`),this.active=e,this}setInactive(e){return T.logger.verbose(`Setting inactive style to: ${e}`),this.inactive=e,this}setChoices(e){return T.logger.verbose(`Setting choices: ${JSON.stringify(e)}`),this.choices=e,this}setHint(e){return T.logger.verbose(`Setting hint to: ${e}`),this.hint=e,this}setWarn(e){return T.logger.verbose(`Setting warn to: ${e}`),this.warn=e,this}setSuggest(e){return T.logger.verbose("Setting suggest function"),this.suggest=e,this}setLimit(e){return T.logger.verbose(`Setting limit to: ${e}`),this.limit=e,this}setMask(e){return T.logger.verbose(`Setting mask to: ${e}`),this.mask=e,this}setStdout(e){return T.logger.verbose("Setting stdout stream"),this.stdout=e,this}setStdin(e){return this.stdin=e,this}async ask(){return(await T.ask(this))[this.name]}static async ask(t){const o=T.logger.for(this.ask);let a;Array.isArray(t)||(t=[t]);try{o.verbose(`Asking questions: ${t.map(e=>e.name).join(", ")}`),a=await e(t),o.verbose(`Received answers: ${JSON.stringify(a,null,2)}`)}catch(e){throw new Error(`Error while getting input: ${e}`)}return a}static async askNumber(e,t,o,a,s){T.logger.for(this.askNumber).verbose(`Asking number input: undefined, question: ${t}, min: ${o}, max: ${a}, initial: ${s}`);const n=new T(e).setMessage(t).setType("number");return"number"==typeof o&&n.setMin(o),"number"==typeof a&&n.setMax(a),"number"==typeof s&&n.setInitial(s),(await this.ask(n))[e]}static async askText(e,t,o=void 0,a){T.logger.for(this.askText).verbose(`Asking text input: undefined, question: ${t}, mask: ${o}, initial: ${a}`);const s=new T(e).setMessage(t);return o&&s.setMask(o),"string"==typeof a&&s.setInitial(a),(await this.ask(s))[e]}static async askConfirmation(e,t,o){T.logger.for(this.askConfirmation).verbose(`Asking confirmation input: undefined, question: ${t}, initial: ${o}`);const a=new T(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 s=T.logger.for(this.insist);let n;s.verbose(`Insisting on input: ${e.name}, test: ${t.toString()}, defaultConfirmation: ${o}, limit: ${a}`);let r,i=0;try{do{n=(await T.ask(e))[e.name],t(n)?(r=await T.askConfirmation(`${e.name}-confirm`,`Is the ${e.type} correct?`,o),r||(n=void 0)):n=void 0}while(void 0===n&&a>1&&i++<a)}catch(e){throw s.error(`Error while insisting: ${e}`),e}return void 0===n&&s.info("no selection..."),n}static async insistForText(e,t,o,a=void 0,s,n=!1,r=-1){T.logger.for(this.insistForText).verbose(`Insisting for text input: undefined, question: ${t}, test: ${o.toString()}, mask: ${a}, initial: ${s}, defaultConfirmation: ${n}, limit: ${r}`);const i=new T(e).setMessage(t);return a&&i.setMask(a),"string"==typeof s&&i.setInitial(s),await this.insist(i,o,n,r)}static async insistForNumber(e,t,o,a,s,n,r=!1,i=-1){T.logger.for(this.insistForNumber).verbose(`Insisting for number input: undefined, question: ${t}, test: ${o.toString()}, min: ${a}, max: ${s}, initial: ${n}, defaultConfirmation: ${r}, limit: ${i}`);const c=new T(e).setMessage(t).setType("number");return"number"==typeof a&&c.setMin(a),"number"==typeof s&&c.setMax(s),"number"==typeof n&&c.setInitial(n),await this.insist(c,o,r,i)}static parseArgs(e){const o=T.logger.for(this.parseArgs),a={args:process.argv.slice(2),options:e};o.debug(`Parsing arguments: ${JSON.stringify(a,null,2)}`);try{return t(a)}catch(t){throw o.debug(`Error while parsing arguments:\n${JSON.stringify(a,null,2)}\n | options\n${JSON.stringify(e,null,2)}\n | ${t}`),new Error(`Error while parsing arguments: ${t}`)}}}const b={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}},C=Object.keys(b).reduce((e,t)=>(e[t]=b[t].default,e),{}),D="utf-8",v=/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z])))/g;var k;!function(e){e.PATCH="patch",e.MINOR="minor",e.MAJOR="major"}(k||(k={}));const $="-no-ci",E="postinstall";var I;!function(e){e.GIT=".token",e.NPM=".npmtoken",e.DOCKER=".dockertoken",e.CONFLUENCE=".confluence-token"}(I||(I={}));const F="Aborted";class x{constructor(e,t,...a){this.cmd=e,this.lock=t,this.logger=o.for(this.cmd)}log(e,t){t=Buffer.isBuffer(t)?t.toString(D):t;const o="stderr"===e?g(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?g(e.toString()).green.text:g(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: ${g(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: ${g(e.message).red}`),this.lock.reject(e)}}function j(e){let t=Promise.resolve();return(...o)=>{const a=t.then(()=>e(...o));return t=a.catch(()=>{}),a}}function N(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 s=()=>a.abort();for(const e of o){if(e.aborted){a.abort();break}e.addEventListener("abort",s,{once:!0,signal:a.signal})}return a}function A(e,t,o,a,s){function n(t,a){const[n,r]=e.parseCommand(t);s.info(`Running command: ${n}`),s.debug(`with args: ${r.join(" ")}`);const i=l(n,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 s.verbose(`pid : ${i.pid}`),i}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=[],s=new Array(e.length);s[0]=a;for(let t=0;t<e.length;t++)0!==t&&(s[t]=N(s[t-1].signal)),o.push(n(e[t],s[t])),0!==t&&o[t-1].stdout.pipe(o[t].stdin);return o[e.length-1]}return n(t,a)}function B(e,t={},a=x,...s){const n=o.for(B),r=new AbortController,i={abort:r,command:e,logs:[],errs:[]},c=new Promise((o,c)=>{let l;try{l=new a(e,{resolve:o,reject:c},...s),i.cmd=A(l,e,t,r,n)}catch(t){return c(new Error(`Error running command ${e}: ${t}`))}i.cmd.stdout.setEncoding("utf8"),i.cmd.stdout.on("data",e=>{e=e.toString(),i.logs.push(e),l.data(e)}),i.cmd.stderr.on("data",e=>{e=e.toString(),i.errs.push(e),l.error(e)}),i.cmd.once("error",e=>{l.exit(e.message,i.errs)}),i.cmd.once("exit",(e=0)=>{r.signal.aborted&&null===e&&(e=F),l.exit(e,0===e?i.logs:i.errs)})});return Object.assign(i,{promise:c,pipe:async t=>{const o=n.for("pipe");try{o.verbose(`Executing pipe function ${e}...`);const a=await c;return o.verbose(`Piping output to ${t.name}: ${a}`),t(a)}catch(e){throw o.error(`Error piping command output: ${e}`),e}}}),i}const O=o.for("fs");function P(e,t){const o=O.for(P);if(!i.existsSync(e))throw new Error(`File not found at path "${e}".`);let s=M(e);try{o.verbose(`Patching file "${e}"...`),o.debug(`with value: ${JSON.stringify(t)}`),s=a(s,t)}catch(e){throw new Error(`Error patching file: ${e}`)}U(e,s)}function M(e){const t=O.for(M);try{return t.verbose(`Reading file "${e}"...`),i.readFileSync(e,"utf8")}catch(o){throw t.verbose(`Error reading file "${e}": ${o}`),new Error(`Error reading file "${e}": ${o}`)}}function U(e,t){const o=O.for(U);try{o.verbose(`Writing file "${e} with ${t.length} bytes...`),i.writeFileSync(e,t,"utf8")}catch(t){throw o.verbose(`Error writing file "${e}": ${t}`),new Error(`Error writing file "${e}": ${t}`)}}function L(e,t){const o=O.for(L),a=[];try{o.verbose(`Retrieving all files from "${e}"...`);return i.readdirSync(e).forEach(t=>{const o=c.join(e,t),s=i.statSync(o);s.isFile()?a.push(o):s.isDirectory()&&a.push(...L(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 J(e,t){const o=O.for(J);let a,s;try{a=i.statSync(e)}catch(t){throw o.verbose(`Source path "${e}" does not exist: ${t}`),new Error(`Source path "${e}" does not exist: ${t}`)}try{s=i.statSync(t)}catch(e){}if(s)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}...`),i.renameSync(e,t),o.verbose(`Successfully renamed to "${t}"`)}catch(s){throw o.verbose(`Error renaming ${a.isFile()?"file":"directory"} "${e}" to "${t}": ${s}`),new Error(`Error renaming ${a.isFile()?"file":"directory"} "${e}" to "${t}": ${s}`)}}function R(e,t){const o=O.for(R);let a,s;try{a=i.statSync(e)}catch(t){throw o.verbose(`Source path "${e}" does not exist: ${t}`),new Error(`Source path "${e}" does not exist: ${t}`)}try{s=i.statSync(t)}catch(e){a.isDirectory()&&(o.verbose(`Dest path "${t}" does not exist. creating`),i.mkdirSync(t,{recursive:!0}))}try{o.verbose(`Copying ${a.isFile()?"file":"directory"} "${e}" to "${t}...`),i.cpSync(e,t,{recursive:!0})}catch(s){throw o.verbose(`Error copying ${a.isFile()?"file":"directory"} "${e}" to "${t}: ${s}`),new Error(`Error copying ${a.isFile()?"file":"directory"} "${e}" to "${t}: ${s}`)}}function W(e){const t=O.for(W);try{const o=i.statSync(e);o.isFile()?(t.verbose(`Deleting file "${e}...`),i.rmSync(e,{recursive:!0,force:!0})):o.isDirectory()&&i.rmSync(e,{recursive:!0,force:!0})}catch(o){throw t.verbose(`Error Deleting "${e}": ${o}`),new Error(`Error Deleting "${e}": ${o}`)}}function G(e=process.cwd(),t){let o;try{o=JSON.parse(M(c.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 V(e,t,o=process.cwd()){const a=G(o);a[e]=t,U(c.join(o,"package.json"),JSON.stringify(a,null,2))}function X(e=process.cwd()){return G(e,"version")}async function H(e=process.cwd()){let t;try{t=JSON.parse(await B("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 _(){const e=O.for(_);e.info("checking for updates..."),await B("npx npm-check-updates -u").promise,e.info("updating..."),await B("npx npm run do-install").promise}async function q(e,t){if(!t){const e=await H();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:s}=t,n=Array.from(new Set([...o||[],...a||[],...s||[]])),r=(e="string"==typeof e?[e]:e).filter(e=>!n.includes(e));return r.length&&await Y({dev:r}),t.dev=t.dev||[],t.dev.push(...r),t}async function z(){const e=O.for(z),t=await B("git config user.name").promise,o=await B("git config user.email").promise;e.verbose(`cached git id: ${t}/${o}. changing to automation`),await B('git config user.email "automation@decaf.ts"').promise,await B('git config user.name "decaf"').promise,e.info("Pushing changes to git..."),await B("git add .").promise,await B('git commit -m "refs #1 - after repo setup"').promise,await B("git push").promise,await B(`git config user.email "${o}"`).promise,await B(`git config user.name "${t}"`).promise,e.verbose(`reverted to git id: ${t}/${o}`)}async function Y(e){const t=O.for(Y),o=e.prod||[],a=e.dev||[],s=e.peer||[];o.length&&(t.info(`Installing dependencies ${o.join(", ")}...`),await B(`npm install ${o.join(" ")}`,{cwd:process.cwd()}).promise),a.length&&(t.info(`Installing devDependencies ${a.join(", ")}...`),await B(`npm install --save-dev ${a.join(" ")}`,{cwd:process.cwd()}).promise),s.length&&(t.info(`Installing peerDependencies ${s.join(", ")}...`),await B(`npm install --save-peer ${s.join(" ")}`,{cwd:process.cwd()}).promise)}async function K(e){return e.then(e=>e.default||e)}const Z=[{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"}],Q=["","","","","","","","",""];function ee(e){const t=te(),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))(g(t||"").raw(Q[o]).text)})}function te(e){try{return e=void 0===e?Math.floor(Math.random()*Z.length):e,Z[e].Slogan}catch(e){throw new Error(`Failed to retrieve slogans: ${e}`)}}class oe extends s{constructor(e,t={},a=[]){super(),this.name=e,this.inputs=t,this.requirements=a,oe.log||Object.defineProperty(oe,"log",{writable:!1,value:o.for(oe.name)}),this.inputs=Object.assign({},b,t)}async checkRequirements(){const{prod:e,dev:t,peer:o}=await H(),a=[],s=Array.from(new Set([...e,...t,...o]).values()).map(e=>e.name);for(const e of this.requirements)s.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=T.parseArgs(this.inputs),t=n.accumulate(C).accumulate(e.values),{version:o,help:a,banner:s}=t;if(o)return X();if(a)return this.help(e);let r;s&&ee(this.log.for(ee,{timestamp:!1,style:!1,context:!1,logLevel:!1}));try{r=await this.run(t)}catch(e){throw e}return r}}class ae{static{this.log=o.for(ae)}static async downloadFile(e){return new Promise((t,o)=>{!function e(a){a=encodeURI(a),d.get(a,s=>{if(301===s.statusCode||307===s.statusCode)return e(s.headers.location);if(200!==s.statusCode)return ae.log.error(`Failed to fetch ${a} (status: ${s.statusCode})`),o(new Error(`Failed to fetch ${a}`));let n="";s.on("data",e=>{n+=e}),s.on("error",e=>{o(e)}),s.on("end",()=>{t(n)})})}(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 ne(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=G(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=c.resolve(__dirname,"../../..");try{e=G(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 ie,ce;!function(e){e.CJS="commonjs",e.ESM="es2022"}(ie||(ie={})),function(e){e.BUILD="build",e.BUNDLE="bundle",e.ALL="all"}(ce||(ce={}));const le={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}},ge=(e=".cjs")=>{const t=de.log.for(ge),o=new Map;return a=>s=>{const n=c.dirname(s.fileName);function r(a){const s=JSON.stringify([n,a]),r=o.get(s);if(null!=r)return r;let l,g=a;try{g=c.resolve(n,g+".ts")}catch(e){throw new Error(`Failed to resolve path ${a}: ${e}`)}try{l=i.statSync(g)}catch(e){try{t.verbose(`Testing existence of path ${g} as a folder defaulting to index file`),l=i.statSync(g.replace(/\.ts$/gm,""))}catch(t){throw new Error(`Failed to resolve path ${a}: ${e}, ${t}`)}}if(l.isDirectory()&&(g=g.replace(/\.ts$/gm,"/index.ts")),c.isAbsolute(g)){const t=(/\.tsx?$/.exec(c.basename(g))||[])[0]||void 0;g="./"+c.relative(n,c.resolve(c.dirname(g),c.basename(g,t)+e))}return o.set(s,g),g}return y.visitNode(s,function e(t){if(function(e){return!(!y.isImportDeclaration(e)&&!y.isExportDeclaration(e))&&(void 0!==e.moduleSpecifier&&(!!y.isStringLiteral(e.moduleSpecifier)&&(!(!e.moduleSpecifier.text.startsWith("./")&&!e.moduleSpecifier.text.startsWith("../"))&&""===c.extname(e.moduleSpecifier.text))))}(t)){if(y.isImportDeclaration(t)){const e=r(t.moduleSpecifier.text),o=a.factory.createStringLiteral(e);return a.factory.updateImportDeclaration(t,t.modifiers,t.importClause,o,void 0)}if(y.isExportDeclaration(t)){const e=r(t.moduleSpecifier.text),o=a.factory.createStringLiteral(e);return a.factory.updateExportDeclaration(t,t.modifiers,t.isTypeOnly,t.exportClause,o,void 0)}}return y.visitEachChild(t,e,a)})}};class de extends oe{constructor(){super("BuildScripts",Object.assign({},b,le)),this.replacements={};const e=G(),{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}=G();t.info(`Patching ${o} ${a} module in ${e}...`);i.statSync(e).isDirectory()&&i.readdirSync(e,{withFileTypes:!0,recursive:!0}).filter(e=>e.isFile()).forEach(e=>P(c.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(r).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+=": "+y.flattenDiagnosticMessageText(e.messageText,"\n"),t}).join("\n")}readConfigFile(e){const t=i.readFileSync(e).toString(),o=y.parseConfigFileTextToJson(e,t),a=o.config;a||this.reportDiagnostics([o.error],r.error);const s=y.parseJsonConfigFileContent(a,y.sys,c.dirname(e));return s.errors.length>0&&this.reportDiagnostics(s.errors,r.error),s}evalDiagnostics(e){if(e&&e.length>0){const t=e.filter(e=>e.category===y.DiagnosticCategory.Error),o=e.filter(e=>e.category===y.DiagnosticCategory.Warning),a=e.filter(e=>e.category===y.DiagnosticCategory.Suggestion),s=e.filter(e=>e.category===y.DiagnosticCategory.Message);o.length&&this.reportDiagnostics(o,r.info),t.length&&(this.reportDiagnostics(e,r.error),this.log.info(`TypeScript reported ${e.length} diagnostic(s) during check; aborting.`)),a.length&&this.reportDiagnostics(a,r.info),s.length&&this.reportDiagnostics(s,r.info)}}preCheckDiagnostics(e){const t=y.getPreEmitDiagnostics(e);this.evalDiagnostics(t)}async checkTsDiagnostics(e,t,o=!1){const a=this.log.for(this.checkTsDiagnostics);let s;try{s=this.readConfigFile("./tsconfig.json")}catch(e){throw new Error(`Failed to parse tsconfig.json: ${e}`)}o?(s.options.module=w.AMD,s.options.outDir="dist",s.options.isolatedModules=!1,s.options.outFile=this.pkgName):(s.options.outDir="lib"+(t===ie.ESM?"/esm":""),s.options.module=t===ie.ESM?w.ES2022:w.CommonJS),e?(s.options.inlineSourceMap=!0,s.options.sourceMap=!1):s.options.sourceMap=!1;const n=y.createProgram(s.fileNames,s.options);this.preCheckDiagnostics(n),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=w.AMD,a.options.outDir="dist",a.options.isolatedModules=!1,a.options.outFile=this.pkgName):(a.options.outDir="lib"+(t===ie.ESM?"/esm":""),a.options.module=t===ie.ESM?w.ES2022:w.CommonJS),e?(a.options.inlineSourceMap=!0,a.options.sourceMap=!1):a.options.sourceMap=!1;const s=y.createProgram(a.fileNames,a.options),n={};t===ie.CJS?n.before=[ge(".cjs")]:t===ie.ESM&&(n.before=[ge(".js")]);const r=s.emit(void 0,void 0,void 0,void 0,n),i=y.getPreEmitDiagnostics(s).concat(r.diagnostics);this.evalDiagnostics(i)}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===ie.CJS&&!o){const e=L("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 J(t,e)}}}copyAssets(e){const t=this.log.for(this.copyAssets);let o=!1;try{o=i.statSync("./src/assets").isDirectory()}catch(e){return t.verbose("No assets found in ./src/assets to copy")}o&&R("./src/assets",`./${e===ie.CJS?"lib":"dist"}/assets`)}async bundle(e,t,o,a="src/index.ts",s=this.pkgName,n,r=["prompts","styled-string-builder","typed-object-accumulator","@decaf-ts/logging"]){await this.checkTsDiagnostics(t,e,!0);const i=e===ie.ESM,c=this.pkgName,l=Array.from(new Set([...se(r)]));let g=se(n);0===g.length&&(g=re());const d=Array.from(new Set([...function(){try{return Array.isArray(S)?S:[]}catch{return["fs","path","process","child_process","util","https","http","os","stream","crypto","zlib","net","tls","url","querystring","assert","events","tty","dns","querystring"]}}(),...g])),y=[h({compilerOptions:{module:"esnext",declaration:!1,outDir:o?"bin":"dist"},include:["src/**/*.ts"],exclude:["node_modules","**/*.spec.ts"],tsconfig:"./tsconfig.json"}),m()];if(!t)try{const C=await import("@rollup/plugin-terser"),D=C&&C.terser||C.default||C;y.push(D())}catch{}o&&y.push(u({include:[],exclude:g}),p({resolveOnly:l}));const w={input:a,plugins:y,external:d},T={};d.forEach(e=>{T[e]=ne(e)});const b=[{file:`${o?"bin/":"dist/"}${s||".bundle."+(t?"":"min")}${i?".esm":""}.cjs`,format:o?"cjs":i?"esm":"umd",name:c,esModule:i,sourcemap:!!t&&"inline",globals:T,exports:"auto"}];try{const v=await f(w);async function k(e){for(const t of b)await e.write(t)}console.log(v.watchFiles),await k(v)}catch($){throw new Error(`Failed to bundle: ${$}`)}}async buildByEnv(e,t=ce.ALL,o,a){try{W("lib")}catch(e){}try{W("dist")}catch(e){}i.mkdirSync("lib"),i.mkdirSync("dist"),[ce.ALL,ce.BUILD].includes(t)&&(await this.build(e,ie.ESM),await this.build(e,ie.CJS),this.patchFiles("lib")),[ce.ALL,ce.BUNDLE].includes(t)&&(await this.bundle(ie.ESM,e,!1,"src/index.ts",this.pkgName,a,o),await this.bundle(ie.CJS,e,!1,"src/index.ts",this.pkgName,a,o),this.patchFiles("dist")),this.copyAssets(ie.CJS),this.copyAssets(ie.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 B("npm install better-docs taffydb").promise,await B("npx markdown-include ./workdocs/readme-md.json").promise,await B("npx jsdoc -c ./workdocs/jsdocs.json -t ./node_modules/better-docs").promise,await B("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;R(t,o)})}async run(e){const{dev:t,prod:o,docs:a,buildMode:s,includes:n,externals:r}=e;return t?await this.buildDev(s,n,r):o?await this.buildProd(s,n,r):a?await this.buildDocs():void 0}}const fe={ci:{type:"boolean",default:!0},message:{type:"string",short:"m"},tag:{type:"string",short:"t",default:void 0}};class he extends oe{constructor(){super("ReleaseScript",fe)}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 B("git tag --sort=-taggerdate | head -n 5").promise,await T.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(e){const t=this.log.for(this.testVersion);switch(e=e.trim().toLowerCase()){case k.PATCH:case k.MINOR:case k.MAJOR:return t.verbose(`Using provided SemVer update: ${e}`,1),e;default:return t.verbose(`Testing provided version for SemVer compatibility: ${e}`,1),new RegExp(v).test(e)?(t.verbose(`version approved: ${e}`,1),e):void t.debug(`Invalid version number: ${e}`)}}async prepareMessage(e){const t=this.log.for(this.prepareMessage);return e||(t.verbose("No release message provided. Prompting for one"),await T.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:s}=e;a=await this.prepareVersion(a),s=await this.prepareMessage(s),t=await B(`npm run prepare-release -- ${a} ${s}`,{cwd:process.cwd()}).promise,t=await B("git status --porcelain").promise,await t,t.logs.length&&await T.askConfirmation("git-changes","Do you want to push the changes to the remote repository?",!0)&&(await B("git add .").promise,await B(`git commit -m "${a} - ${s} - after release preparation${o?"":$}"`).promise),await B(`npm version "${a}" -m "${s}${o?"":$}"`).promise,await B("git push --follow-tags").promise,o||await B("NPM_TOKEN=$(cat .npmtoken) npm publish --access public").promise}}const ue="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"}};class Se extends oe{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=G(e,"author");let o,a=G(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 ae.downloadFile(`${ue}/${e}`);t=a(t,this.replacements),U(c.join(process.cwd(),e),t)}}async getLicense(e){this.log.info(`Downloading ${e} license`);const t=`${ue}/workdocs/licenses/${e}.md`;let o=await ae.downloadFile(t);o=a(o,this.replacements),U(c.join(process.cwd(),"LICENSE.md"),o),V("license",e)}async getIde(){i.mkdirSync(c.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=G();delete a[E],a.name=e,a.version="0.0.1",a.author=t,a.license=o,i.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 ae.downloadFile(`${ue}/package.json`)),{scripts:t}=e,o=G();Object.keys(o.scripts).forEach(e=>{if(e in t){const s=a(t[e],this.replacements);s!==t[e]&&(o.scripts[e]=s)}}),o.exports.require=e.exports.require,o.exports.import=e.exports.import,o.types=e.types,i.writeFileSync("package.json",JSON.stringify(o,null,2))}catch(e){throw new Error(`Error fixing package.json scripts: ${e}`)}}async createTokenFiles(){const e=this.log.for(this.createTokenFiles),t=await T.insistForText("token","please input your github token",e=>!!e.match(/^ghp_[0-9a-zA-Z]{36}$/g));Object.values(I).forEach(o=>{try{let a;try{a=i.existsSync(o)}catch(a){return e.info(`Token file ${o} not found. Creating a new one...`),void i.writeFileSync(o,".token"===o?t:"")}a||i.writeFileSync(o,".token"===o?t:"")}catch(e){throw new Error(`Error creating token file ${o}: ${e}`)}})}async getOrg(){const e=await T.askText("Organization","Enter the organization name (will be used to scope your npm project. leave blank to create a unscoped project):");return await T.askConfirmation("Confirm organization","Is this organization correct?",!0)?e:this.getOrg()}async auditFix(){return await B("npm audit fix --force").promise}patchFiles(){const e=[...i.readdirSync(c.join(process.cwd(),"src"),{recursive:!0,withFileTypes:!0}).filter(e=>e.isFile()).map(e=>c.join(e.parentPath,e.name)),...i.readdirSync(c.join(process.cwd(),"workdocs"),{recursive:!0,withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(".md")).map(e=>c.join(e.parentPath,e.name)),c.join(process.cwd(),".gitlab-ci.yml"),c.join(process.cwd(),"workdocs","jsdocs.json")];for(const t of e)P(t,this.replacements)}async updateDependencies(){try{const e=JSON.parse(await ae.downloadFile(`${ue}/package.json`)),{devDependencies:t}=e,o=G();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)}}),i.writeFileSync("package.json",JSON.stringify(o,null,2)),await B("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:s,styles:n,docs:r,ide:i,workflows:c,templates:l,docker:g,typescript:d,dependencies:f,tests:h,automation:u,pkg:p}=e;if((s||n||r||i||c||l||g||d||u||f||h||p)&&(a=!1),o){const e=await this.getOrg(),o=await T.insistForText("Project name","Enter the project name:",e=>e.length>1),a=await T.insistForText("Author","Enter the author name:",e=>e.length>1),s=e?`@${e}/${o}`:o;await this.initPackage(s,a,t),await this.createTokenFiles(),await this.auditFix(),this.patchFiles()}if(a&&(s=!1,n=!0,r=!0,i=!0,c=!0,l=!0,g=!0,d=!0,p=!0,f=!0,h=!0,u=!1),void 0===s&&(s=await T.askConfirmation("scripts","Do you want to get scripts?",!0)),s&&await this.getScripts(),this.loadValuesFromPackage(),!a&&void 0===t){await T.askConfirmation("license","Do you want to set a license?",!0)&&(t=await T.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===i&&(i=await T.askConfirmation("ide","Do you want to get ide configs?",!0)),i&&await this.getIde(),void 0===d&&(d=await T.askConfirmation("typescript","Do you want to get typescript configs?",!0)),d&&await this.getTypescript(),void 0===g&&(g=await T.askConfirmation("docker","Do you want to get docker configs?",!0)),g&&await this.getDocker(),void 0===u&&(u=await T.askConfirmation("automation","Do you want to get automation configs?",!0)),u&&await this.getAutomation(),void 0===n&&(n=await T.askConfirmation("styles","Do you want to get styles?",!0)),n&&await this.getStyles(),void 0===r&&(r=await T.askConfirmation("docs","Do you want to get docs?",!0)),r&&await this.getDocs(),void 0===c&&(c=await T.askConfirmation("workflows","Do you want to get workflows?",!0)),c&&await this.getWorkflows(),void 0===l&&(l=await T.askConfirmation("templates","Do you want to get templates?",!0)),l&&await this.getTemplates(),void 0===p&&(p=await T.askConfirmation("pkg","Do you want to update your package.json scripts?",!0)),p&&await this.updatePackageScrips(),void 0===h&&(h=await T.askConfirmation("pkg","Do you want to update your test configs?",!0)),h&&await this.getTests(),void 0===f&&(f=await T.askConfirmation("pkg","Do you want to update dev dependencies?",!0)),f&&await this.updateDependencies()}}class ye extends x{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))}}const we="0.4.2",Te="@decaf-ts/utils";export{F as AbortCode,de as BuildScripts,oe as Command,b as DefaultCommandOptions,C as DefaultCommandValues,D as Encoding,ae as HttpClient,$ as NoCIFLag,Te as PACKAGE_NAME,ye as RegexpOutputWriter,he as ReleaseScript,k as SemVersion,v as SemVersionRegex,E as SetupScriptKey,x as StandardOutputWriter,Se as TemplateSync,I as Tokens,T as UserInput,we as VERSION,N as chainAbortController,R as copyFile,W as deletePath,L as getAllFiles,H as getDependencies,G as getPackage,re as getPackageDependencies,X as getPackageVersion,te as getSlogan,Y as installDependencies,q as installIfNotAvailable,j as lockify,K as normalizeImport,ne as packageToGlobal,se as parseList,P as patchFile,ee as printBanner,z as pushToGit,M as readFile,J as renameFile,B as runCommand,V as setPackageAttribute,A as spawnCommand,_ as updateDependencies,U as writeFile};