@flowscripter/dynamic-cli-framework 1.7.3 → 1.7.5

package/dist/src/service/argumentPrompter/DefaultArgumentPrompterService.js

@@ -0,0 +1,197 @@
+import { PromptType, } from "../../api/service/core/PrompterService.js";
+import { InvalidArgumentReason } from "../../api/RunResult.js";
+import { ArgumentValueTypeName, ComplexValueTypeName, } from "../../api/argument/ArgumentValueTypes.js";
+import { isGlobalCommand, isSubCommand } from "../../runtime/command/CommandTypeGuards.js";
+export default class DefaultArgumentPrompterService {
+    #prompterService;
+    constructor(prompterService) {
+        this.#prompterService = prompterService;
+    }
+    async promptForMissingArguments(parseResult) {
+        if (!this.#prompterService.promptEnabled) {
+            return parseResult;
+        }
+        const allMissingValue = parseResult.invalidArguments.every((ia) => ia.reason === InvalidArgumentReason.MISSING_VALUE);
+        if (!allMissingValue) {
+            return parseResult;
+        }
+        if (parseResult.invalidArguments.length === 0) {
+            return parseResult;
+        }
+        try {
+            if (isGlobalCommand(parseResult.command)) {
+                return await this.#promptForGlobalCommand(parseResult);
+            }
+            if (isSubCommand(parseResult.command)) {
+                return await this.#promptForSubCommand(parseResult);
+            }
+        }
+        catch (error) {
+            if (error.message === "Interrupted") {
+                throw error;
+            }
+            return parseResult;
+        }
+        return parseResult;
+    }
+    async #promptForGlobalCommand(parseResult) {
+        const command = parseResult.command;
+        if (!command.argument) {
+            return parseResult;
+        }
+        const prompt = DefaultArgumentPrompterService.#argumentToPrompt(command.name, command.name, command.argument);
+        const result = await this.#prompterService.prompt(prompt);
+        const value = DefaultArgumentPrompterService.#coerceValue(result.value, command.argument.type);
+        return {
+            command: parseResult.command,
+            groupCommand: parseResult.groupCommand,
+            populatedArgumentValues: value,
+            invalidArguments: [],
+            unusedArgs: parseResult.unusedArgs,
+        };
+    }
+    async #promptForSubCommand(parseResult) {
+        const command = parseResult.command;
+        const existingValues = (parseResult.populatedArgumentValues ?? {});
+        const newValues = {
+            ...existingValues,
+        };
+        const remainingInvalid = [];
+        for (const invalid of parseResult.invalidArguments) {
+            if (invalid.reason !== InvalidArgumentReason.MISSING_VALUE || !invalid.name) {
+                remainingInvalid.push(invalid);
+                continue;
+            }
+            const arg = DefaultArgumentPrompterService.#findArgument(command, invalid.name);
+            if (!arg) {
+                remainingInvalid.push(invalid);
+                continue;
+            }
+            if ("type" in arg && arg.type === ComplexValueTypeName.COMPLEX) {
+                const complexValues = await this.#promptForComplexOption(invalid.name, arg);
+                newValues[invalid.name] = complexValues;
+            }
+            else if (DefaultArgumentPrompterService.#isArrayArgument(arg)) {
+                const arrayValues = await this.#promptForArrayArgument(invalid.name, arg);
+                newValues[invalid.name] = arrayValues;
+            }
+            else {
+                const prompt = DefaultArgumentPrompterService.#argumentToPrompt(invalid.name, arg.description ?? invalid.name, arg);
+                const result = await this.#prompterService.prompt(prompt);
+                newValues[invalid.name] = DefaultArgumentPrompterService.#coerceValue(result.value, arg.type);
+            }
+        }
+        return {
+            command: parseResult.command,
+            groupCommand: parseResult.groupCommand,
+            populatedArgumentValues: newValues,
+            invalidArguments: remainingInvalid,
+            unusedArgs: parseResult.unusedArgs,
+        };
+    }
+    async #promptForComplexOption(name, complexOption) {
+        const values = {};
+        for (const prop of complexOption.properties) {
+            if ("type" in prop && prop.type === ComplexValueTypeName.COMPLEX) {
+                values[prop.name] = await this.#promptForComplexOption(`${name}.${prop.name}`, prop);
+            }
+            else {
+                const option = prop;
+                if (option.isOptional && option.defaultValue !== undefined) {
+                    continue;
+                }
+                const prompt = DefaultArgumentPrompterService.#argumentToPrompt(`${name}.${option.name}`, option.description ?? `${name}.${option.name}`, option);
+                const result = await this.#prompterService.prompt(prompt);
+                values[option.name] = DefaultArgumentPrompterService.#coerceValue(result.value, option.type);
+            }
+        }
+        return values;
+    }
+    async #promptForArrayArgument(name, arg) {
+        const values = [];
+        while (true) {
+            const prompt = DefaultArgumentPrompterService.#argumentToPrompt(name, `${arg.description ?? name}${values.length > 0 ? ` [${values.length + 1}]` : ""}`, arg);
+            const result = await this.#prompterService.prompt(prompt);
+            values.push(DefaultArgumentPrompterService.#coerceValue(result.value, arg.type));
+            const addAnother = {
+                name: `${name}_more`,
+                promptText: `Add another value for ${name}?`,
+                type: PromptType.ACKNOWLEDGE,
+                options: [],
+            };
+            const moreResult = await this.#prompterService.prompt(addAnother);
+            if (moreResult.value !== true) {
+                break;
+            }
+        }
+        return values;
+    }
+    static #argumentToPrompt(name, description, arg) {
+        if (arg.type === ArgumentValueTypeName.BOOLEAN) {
+            return {
+                name,
+                promptText: description,
+                type: PromptType.TOGGLE,
+                options: [],
+            };
+        }
+        if (arg.allowableValues && arg.allowableValues.length > 0) {
+            const options = arg.allowableValues.map((v) => ({
+                displayValue: String(v),
+                returnedValue: v,
+            }));
+            return {
+                name,
+                promptText: description,
+                type: PromptType.SINGLE_SELECT,
+                options,
+            };
+        }
+        const validationOption = {
+            displayValue: arg.type === ArgumentValueTypeName.SECRET ? "__SECRET__" : name,
+            returnedValue: "",
+            min: arg.minValueInclusive,
+            max: arg.maxValueInclusive,
+            validate: arg.validate ? (v) => arg.validate(v) : undefined,
+        };
+        return {
+            name,
+            promptText: description,
+            type: PromptType.TEXT,
+            options: [validationOption],
+        };
+    }
+    static #coerceValue(value, type) {
+        if (typeof value === "string") {
+            switch (type) {
+                case ArgumentValueTypeName.INTEGER:
+                    return parseInt(value, 10);
+                case ArgumentValueTypeName.NUMBER:
+                    return parseFloat(value);
+                case ArgumentValueTypeName.BOOLEAN:
+                    return value.toLowerCase() === "true";
+            }
+        }
+        return value;
+    }
+    static #findArgument(command, name) {
+        for (const opt of command.options) {
+            if (opt.name === name)
+                return opt;
+        }
+        for (const pos of command.positionals) {
+            if (pos.name === name)
+                return pos;
+        }
+        return undefined;
+    }
+    static #isArrayArgument(arg) {
+        if ("isArray" in arg && arg.isArray) {
+            return true;
+        }
+        if ("isVarargMultiple" in arg && arg.isVarargMultiple) {
+            return true;
+        }
+        return false;
+    }
+}

package/dist/src/service/asciiBannerGenerator/AsciiBannerGeneratorServiceProvider.js

@@ -0,0 +1,28 @@
+import { ASCII_BANNER_GENERATOR_SERVICE_ID } from "../../api/service/core/AsciiBannerGeneratorService.js";
+import DefaultAsciiBannerGeneratorService from "./DefaultAsciiBannerGeneratorService.js";
+/**
+ * Provides an {@link AsciiBannerGeneratorService}.
+ */
+export default class AsciiBannerGeneratorServiceProvider {
+    serviceId = ASCII_BANNER_GENERATOR_SERVICE_ID;
+    servicePriority;
+    #asciiBannerGeneratorService;
+    /**
+     * Create an instance of the service provider with the specified details.
+     *
+     * @param servicePriority the priority of the service.
+     */
+    constructor(servicePriority) {
+        this.servicePriority = servicePriority;
+        this.#asciiBannerGeneratorService = new DefaultAsciiBannerGeneratorService();
+    }
+    getServiceInfo(_cliConfig) {
+        return Promise.resolve({
+            service: this.#asciiBannerGeneratorService,
+            commands: [],
+        });
+    }
+    initService(_context) {
+        return Promise.resolve(undefined);
+    }
+}

package/dist/src/service/asciiBannerGenerator/DefaultAsciiBannerGeneratorService.js

@@ -0,0 +1,233 @@
+import { BACKGROUND_COLOR_END, backgroundColorStart, FOREGROUND_COLOR_END, foregroundColorStart, } from "../../terminal/Ansi.js";
+import figlet from "figlet";
+import standardFont from "./standard.flf.json" with { type: "json" };
+function hslToRgb(h, s, l) {
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const x = c * (1 - Math.abs(((h * 6) % 2) - 1));
+    const m = l - c / 2;
+    let r = 0, g = 0, b = 0;
+    if (h < 1 / 6) {
+        r = c;
+        g = x;
+        b = 0;
+    }
+    else if (h < 2 / 6) {
+        r = x;
+        g = c;
+        b = 0;
+    }
+    else if (h < 3 / 6) {
+        r = 0;
+        g = c;
+        b = x;
+    }
+    else if (h < 4 / 6) {
+        r = 0;
+        g = x;
+        b = c;
+    }
+    else if (h < 5 / 6) {
+        r = x;
+        g = 0;
+        b = c;
+    }
+    else {
+        r = c;
+        g = 0;
+        b = x;
+    }
+    return [Math.round((r + m) * 255), Math.round((g + m) * 255), Math.round((b + m) * 255)];
+}
+function parseHex(hex) {
+    const v = parseInt(hex.slice(1), 16);
+    return [(v >> 16) & 0xff, (v >> 8) & 0xff, v & 0xff];
+}
+function interpolateColors(colorStops, position, total) {
+    const first = colorStops[0];
+    if (total <= 1 || first === undefined)
+        return first ?? [0, 0, 0];
+    const t = position / (total - 1);
+    const scaledT = t * (colorStops.length - 1);
+    const idx = Math.min(Math.floor(scaledT), colorStops.length - 2);
+    const localT = scaledT - idx;
+    const stop1 = colorStops[idx];
+    const stop2 = colorStops[idx + 1];
+    if (stop1 === undefined || stop2 === undefined)
+        return first;
+    const [r1, g1, b1] = stop1;
+    const [r2, g2, b2] = stop2;
+    return [
+        Math.round(r1 + (r2 - r1) * localT),
+        Math.round(g1 + (g2 - g1) * localT),
+        Math.round(b1 + (b2 - b1) * localT),
+    ];
+}
+function rainbowColor(freq, spread, seed, x, y) {
+    const h = (((freq * (x / spread) + seed + (y * freq) / spread) % 1.0) + 1.0) % 1.0;
+    return hslToRgb(h, 1.0, 0.5);
+}
+export default class DefaultAsciiBannerGeneratorService {
+    #registeredFontNames = [];
+    constructor() {
+        this.registerFont("standard", standardFont.font);
+    }
+    getRegisteredFonts() {
+        return this.#registeredFontNames;
+    }
+    registerFont(fontName, fontDefinition) {
+        const name = fontName.toLowerCase();
+        if (this.getRegisteredFonts().includes(name)) {
+            throw new Error(`Font name already registered: ${name}`);
+        }
+        this.#registeredFontNames.push(name);
+        figlet.parseFont(fontName, fontDefinition);
+    }
+    applyForegroundEffect(lines, effect) {
+        if (effect.type === "fixed") {
+            const [r, g, b] = parseHex(effect.color);
+            const code = foregroundColorStart(r, g, b);
+            return lines.map((line) => line
+                .split("")
+                .map((ch) => (ch === " " ? ch : code + ch + FOREGROUND_COLOR_END))
+                .join(""));
+        }
+        if (effect.type === "gradient") {
+            const colorStops = effect.colors.map(parseHex);
+            return lines.map((line, yi) => {
+                if (effect.direction === "vertical") {
+                    const [r, g, b] = interpolateColors(colorStops, yi, Math.max(lines.length, 1));
+                    const code = foregroundColorStart(r, g, b);
+                    return line
+                        .split("")
+                        .map((ch) => (ch === " " ? ch : code + ch + FOREGROUND_COLOR_END))
+                        .join("");
+                }
+                const nonSpaceCount = line.split("").filter((c) => c !== " ").length;
+                let charIdx = 0;
+                return line
+                    .split("")
+                    .map((ch) => {
+                    if (ch === " ")
+                        return ch;
+                    const [r, g, b] = interpolateColors(colorStops, charIdx, Math.max(nonSpaceCount, 1));
+                    charIdx++;
+                    return foregroundColorStart(r, g, b) + ch + FOREGROUND_COLOR_END;
+                })
+                    .join("");
+            });
+        }
+        const freq = effect.frequency ?? 0.3;
+        const spread = effect.spread ?? 8.0;
+        const seed = effect.seed ?? Math.random();
+        return lines.map((line, yi) => {
+            if (effect.direction === "vertical") {
+                const [r, g, b] = rainbowColor(freq, spread, seed, 0, yi);
+                const code = foregroundColorStart(r, g, b);
+                return line
+                    .split("")
+                    .map((ch) => (ch === " " ? ch : code + ch + FOREGROUND_COLOR_END))
+                    .join("");
+            }
+            let charIdx = 0;
+            return line
+                .split("")
+                .map((ch) => {
+                if (ch === " ")
+                    return ch;
+                const [r, g, b] = rainbowColor(freq, spread, seed, charIdx, yi);
+                charIdx++;
+                return foregroundColorStart(r, g, b) + ch + FOREGROUND_COLOR_END;
+            })
+                .join("");
+        });
+    }
+    applyBackgroundEffect(lines, effect) {
+        if (effect.type === "fixed") {
+            const [r, g, b] = parseHex(effect.color);
+            const code = backgroundColorStart(r, g, b);
+            return lines.map((line) => code + line + BACKGROUND_COLOR_END);
+        }
+        if (effect.type === "gradient") {
+            const colorStops = effect.colors.map(parseHex);
+            return lines.map((line, yi) => {
+                if (effect.direction === "vertical") {
+                    const [r, g, b] = interpolateColors(colorStops, yi, Math.max(lines.length, 1));
+                    return backgroundColorStart(r, g, b) + line + BACKGROUND_COLOR_END;
+                }
+                const totalChars = Math.max(line.length, 1);
+                return line
+                    .split("")
+                    .map((ch, xi) => {
+                    const [r, g, b] = interpolateColors(colorStops, xi, totalChars);
+                    return backgroundColorStart(r, g, b) + ch + BACKGROUND_COLOR_END;
+                })
+                    .join("");
+            });
+        }
+        const freq = effect.frequency ?? 0.3;
+        const spread = effect.spread ?? 8.0;
+        const seed = effect.seed ?? Math.random();
+        return lines.map((line, yi) => {
+            if (effect.direction === "vertical") {
+                const [r, g, b] = rainbowColor(freq, spread, seed, 0, yi);
+                return backgroundColorStart(r, g, b) + line + BACKGROUND_COLOR_END;
+            }
+            return line
+                .split("")
+                .map((ch, xi) => {
+                const [r, g, b] = rainbowColor(freq, spread, seed, xi, yi);
+                return backgroundColorStart(r, g, b) + ch + BACKGROUND_COLOR_END;
+            })
+                .join("");
+        });
+    }
+    async generate(message, options) {
+        const fontName = (options?.fontName ?? "standard").toLowerCase();
+        if (!this.getRegisteredFonts().includes(fontName)) {
+            throw new Error(`Font name is not registered: ${fontName}`);
+        }
+        const bannerText = await figlet.text(message, { font: fontName });
+        let titleLines = bannerText.split("\n");
+        while (titleLines.length > 0) {
+            const last = titleLines[titleLines.length - 1];
+            if (last === undefined || last.trim().length > 0)
+                break;
+            titleLines.pop();
+        }
+        let subMessageLine;
+        if (options?.subMessage) {
+            subMessageLine = options.subMessage
+                .toUpperCase()
+                .split("")
+                .map((c) => (c === " " ? "  " : c + " "))
+                .join("")
+                .trimEnd();
+            const bannerWidth = Math.max(...titleLines.map((l) => l.length));
+            const subWidth = subMessageLine.length;
+            if (bannerWidth >= subWidth) {
+                const pad = Math.floor((bannerWidth - subWidth) / 2);
+                subMessageLine = " ".repeat(pad) + subMessageLine;
+            }
+            else {
+                const pad = Math.floor((subWidth - bannerWidth) / 2);
+                titleLines = titleLines.map((l) => " ".repeat(pad) + l);
+            }
+        }
+        const colorEffects = options?.colorEffects;
+        if (colorEffects?.messageForeground) {
+            titleLines = this.applyForegroundEffect(titleLines, colorEffects.messageForeground);
+        }
+        let subLines;
+        if (subMessageLine !== undefined) {
+            subLines = [subMessageLine];
+            if (colorEffects?.subMessageForeground) {
+                subLines = this.applyForegroundEffect(subLines, colorEffects.subMessageForeground);
+            }
+        }
+        let allLines = subLines ? [...titleLines, ...subLines] : titleLines;
+        if (colorEffects?.background) {
+            allLines = this.applyBackgroundEffect(allLines, colorEffects.background);
+        }
+        return "\n" + allLines.join("\n") + "\n";
+    }
+}

package/dist/src/service/asciiBannerGenerator/standard.flf.json

@@ -0,0 +1,3 @@
+{
+    "font": "flf2a$ 6 5 16 15 11 0 24463\nStandard by Glenn Chappell & Ian Chai 3/93 -- based on Frank's .sig\nIncludes ISO Latin-1\nfiglet release 2.1 -- 12 Aug 1994\nModified for figlet 2.2 by John Cowan <cowan@ccil.org>\n  to add Latin-{2,3,4,5} support (Unicode U+0100-017F).\nPermission is hereby given to modify this font, as long as the\nmodifier's name is placed on a comment line.\n\nModified by Paul Burton <solution@earthlink.net> 12/96 to include new parameter\nsupported by FIGlet and FIGWin.  May also be slightly modified for better use\nof new full-width/kern/smush alternatives, but default output is NOT changed.\n $@\n $@\n $@\n $@\n $@\n $@@\n  _ @\n | |@\n | |@\n |_|@\n (_)@\n    @@\n  _ _ @\n ( | )@\n  V V @\n   $  @\n   $  @\n      @@\n    _  _   @\n  _| || |_ @\n |_  ..  _|@\n |_      _|@\n   |_||_|  @\n           @@\n   _  @\n  | | @\n / __)@\n \\__ \\@\n (   /@\n  |_| @@\n  _  __@\n (_)/ /@\n   / / @\n  / /_ @\n /_/(_)@\n       @@\n   ___   @\n  ( _ )  @\n  / _ \\/\\@\n | (_>  <@\n  \\___/\\/@\n         @@\n  _ @\n ( )@\n |/ @\n  $ @\n  $ @\n    @@\n   __@\n  / /@\n | | @\n | | @\n | | @\n  \\_\\@@\n __  @\n \\ \\ @\n  | |@\n  | |@\n  | |@\n /_/ @@\n       @\n __/\\__@\n \\    /@\n /_  _\\@\n   \\/  @\n       @@\n        @\n    _   @\n  _| |_ @\n |_   _|@\n   |_|  @\n        @@\n    @\n    @\n    @\n  _ @\n ( )@\n |/ @@\n        @\n        @\n  _____ @\n |_____|@\n    $   @\n        @@\n    @\n    @\n    @\n  _ @\n (_)@\n    @@\n     __@\n    / /@\n   / / @\n  / /  @\n /_/   @\n       @@\n   ___  @\n  / _ \\ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n  _ @\n / |@\n | |@\n | |@\n |_|@\n    @@\n  ____  @\n |___ \\ @\n   __) |@\n  / __/ @\n |_____|@\n        @@\n  _____ @\n |___ / @\n   |_ \\ @\n  ___) |@\n |____/ @\n        @@\n  _  _   @\n | || |  @\n | || |_ @\n |__   _|@\n    |_|  @\n         @@\n  ____  @\n | ___| @\n |___ \\ @\n  ___) |@\n |____/ @\n        @@\n   __   @\n  / /_  @\n | '_ \\ @\n | (_) |@\n  \\___/ @\n        @@\n  _____ @\n |___  |@\n    / / @\n   / /  @\n  /_/   @\n        @@\n   ___  @\n  ( _ ) @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n   ___  @\n  / _ \\ @\n | (_) |@\n  \\__, |@\n    /_/ @\n        @@\n    @\n  _ @\n (_)@\n  _ @\n (_)@\n    @@\n    @\n  _ @\n (_)@\n  _ @\n ( )@\n |/ @@\n   __@\n  / /@\n / / @\n \\ \\ @\n  \\_\\@\n     @@\n        @\n  _____ @\n |_____|@\n |_____|@\n    $   @\n        @@\n __  @\n \\ \\ @\n  \\ \\@\n  / /@\n /_/ @\n     @@\n  ___ @\n |__ \\@\n   / /@\n  |_| @\n  (_) @\n      @@\n    ____  @\n   / __ \\ @\n  / / _` |@\n | | (_| |@\n  \\ \\__,_|@\n   \\____/ @@\n     _    @\n    / \\   @\n   / _ \\  @\n  / ___ \\ @\n /_/   \\_\\@\n          @@\n  ____  @\n | __ ) @\n |  _ \\ @\n | |_) |@\n |____/ @\n        @@\n   ____ @\n  / ___|@\n | |    @\n | |___ @\n  \\____|@\n        @@\n  ____  @\n |  _ \\ @\n | | | |@\n | |_| |@\n |____/ @\n        @@\n  _____ @\n | ____|@\n |  _|  @\n | |___ @\n |_____|@\n        @@\n  _____ @\n |  ___|@\n | |_   @\n |  _|  @\n |_|    @\n        @@\n   ____ @\n  / ___|@\n | |  _ @\n | |_| |@\n  \\____|@\n        @@\n  _   _ @\n | | | |@\n | |_| |@\n |  _  |@\n |_| |_|@\n        @@\n  ___ @\n |_ _|@\n  | | @\n  | | @\n |___|@\n      @@\n      _ @\n     | |@\n  _  | |@\n | |_| |@\n  \\___/ @\n        @@\n  _  __@\n | |/ /@\n | ' / @\n | . \\ @\n |_|\\_\\@\n       @@\n  _     @\n | |    @\n | |    @\n | |___ @\n |_____|@\n        @@\n  __  __ @\n |  \\/  |@\n | |\\/| |@\n | |  | |@\n |_|  |_|@\n         @@\n  _   _ @\n | \\ | |@\n |  \\| |@\n | |\\  |@\n |_| \\_|@\n        @@\n   ___  @\n  / _ \\ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n  ____  @\n |  _ \\ @\n | |_) |@\n |  __/ @\n |_|    @\n        @@\n   ___  @\n  / _ \\ @\n | | | |@\n | |_| |@\n  \\__\\_\\@\n        @@\n  ____  @\n |  _ \\ @\n | |_) |@\n |  _ < @\n |_| \\_\\@\n        @@\n  ____  @\n / ___| @\n \\___ \\ @\n  ___) |@\n |____/ @\n        @@\n  _____ @\n |_   _|@\n   | |  @\n   | |  @\n   |_|  @\n        @@\n  _   _ @\n | | | |@\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n __     __@\n \\ \\   / /@\n  \\ \\ / / @\n   \\ V /  @\n    \\_/   @\n          @@\n __        __@\n \\ \\      / /@\n  \\ \\ /\\ / / @\n   \\ V  V /  @\n    \\_/\\_/   @\n             @@\n __  __@\n \\ \\/ /@\n  \\  / @\n  /  \\ @\n /_/\\_\\@\n       @@\n __   __@\n \\ \\ / /@\n  \\ V / @\n   | |  @\n   |_|  @\n        @@\n  _____@\n |__  /@\n   / / @\n  / /_ @\n /____|@\n       @@\n  __ @\n | _|@\n | | @\n | | @\n | | @\n |__|@@\n __    @\n \\ \\   @\n  \\ \\  @\n   \\ \\ @\n    \\_\\@\n       @@\n  __ @\n |_ |@\n  | |@\n  | |@\n  | |@\n |__|@@\n  /\\ @\n |/\\|@\n   $ @\n   $ @\n   $ @\n     @@\n        @\n        @\n        @\n        @\n  _____ @\n |_____|@@\n  _ @\n ( )@\n  \\|@\n  $ @\n  $ @\n    @@\n        @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n  _     @\n | |__  @\n | '_ \\ @\n | |_) |@\n |_.__/ @\n        @@\n       @\n   ___ @\n  / __|@\n | (__ @\n  \\___|@\n       @@\n      _ @\n   __| |@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n       @\n   ___ @\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n   __ @\n  / _|@\n | |_ @\n |  _|@\n |_|  @\n      @@\n        @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__, |@\n  |___/ @@\n  _     @\n | |__  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n  _ @\n (_)@\n | |@\n | |@\n |_|@\n    @@\n    _ @\n   (_)@\n   | |@\n   | |@\n  _/ |@\n |__/ @@\n  _    @\n | | __@\n | |/ /@\n |   < @\n |_|\\_\\@\n       @@\n  _ @\n | |@\n | |@\n | |@\n |_|@\n    @@\n            @\n  _ __ ___  @\n | '_ ` _ \\ @\n | | | | | |@\n |_| |_| |_|@\n            @@\n        @\n  _ __  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n        @\n   ___  @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n        @\n  _ __  @\n | '_ \\ @\n | |_) |@\n | .__/ @\n |_|    @@\n        @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__, |@\n     |_|@@\n       @\n  _ __ @\n | '__|@\n | |   @\n |_|   @\n       @@\n      @\n  ___ @\n / __|@\n \\__ \\@\n |___/@\n      @@\n  _   @\n | |_ @\n | __|@\n | |_ @\n  \\__|@\n      @@\n        @\n  _   _ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n        @\n __   __@\n \\ \\ / /@\n  \\ V / @\n   \\_/  @\n        @@\n           @\n __      __@\n \\ \\ /\\ / /@\n  \\ V  V / @\n   \\_/\\_/  @\n           @@\n       @\n __  __@\n \\ \\/ /@\n  >  < @\n /_/\\_\\@\n       @@\n        @\n  _   _ @\n | | | |@\n | |_| |@\n  \\__, |@\n  |___/ @@\n      @\n  ____@\n |_  /@\n  / / @\n /___|@\n      @@\n    __@\n   / /@\n  | | @\n < <  @\n  | | @\n   \\_\\@@\n  _ @\n | |@\n | |@\n | |@\n | |@\n |_|@@\n __   @\n \\ \\  @\n  | | @\n   > >@\n  | | @\n /_/  @@\n  /\\/|@\n |/\\/ @\n   $  @\n   $  @\n   $  @\n      @@\n  _   _ @\n (_)_(_)@\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n  _   _ @\n (_)_(_)@\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n  _   _ @\n (_) (_)@\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n  _   _ @\n (_)_(_)@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n  _   _ @\n (_)_(_)@\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n  _   _ @\n (_) (_)@\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n   ___ @\n  / _ \\@\n | |/ /@\n | |\\ \\@\n | ||_/@\n |_|   @@\n160  NO-BREAK SPACE\n $@\n $@\n $@\n $@\n $@\n $@@\n161  INVERTED EXCLAMATION MARK\n  _ @\n (_)@\n | |@\n | |@\n |_|@\n    @@\n162  CENT SIGN\n    _  @\n   | | @\n  / __)@\n | (__ @\n  \\   )@\n   |_| @@\n163  POUND SIGN\n    ___  @\n   / ,_\\ @\n _| |_   @\n  | |___ @\n (_,____|@\n         @@\n164  CURRENCY SIGN\n /\\___/\\@\n \\  _  /@\n | (_) |@\n / ___ \\@\n \\/   \\/@\n        @@\n165  YEN SIGN\n  __ __ @\n  \\ V / @\n |__ __|@\n |__ __|@\n   |_|  @\n        @@\n166  BROKEN BAR\n  _ @\n | |@\n |_|@\n  _ @\n | |@\n |_|@@\n167  SECTION SIGN\n    __ @\n  _/ _)@\n / \\ \\ @\n \\ \\\\ \\@\n  \\ \\_/@\n (__/  @@\n168  DIAERESIS\n  _   _ @\n (_) (_)@\n  $   $ @\n  $   $ @\n  $   $ @\n        @@\n169  COPYRIGHT SIGN\n    _____   @\n   / ___ \\  @\n  / / __| \\ @\n | | (__   |@\n  \\ \\___| / @\n   \\_____/  @@\n170  FEMININE ORDINAL INDICATOR\n  __ _ @\n / _` |@\n \\__,_|@\n |____|@\n    $  @\n       @@\n171  LEFT-POINTING DOUBLE ANGLE QUOTATION MARK\n   ____@\n  / / /@\n / / / @\n \\ \\ \\ @\n  \\_\\_\\@\n       @@\n172  NOT SIGN\n        @\n  _____ @\n |___  |@\n     |_|@\n    $   @\n        @@\n173  SOFT HYPHEN\n       @\n       @\n  ____ @\n |____|@\n    $  @\n       @@\n174  REGISTERED SIGN\n    _____   @\n   / ___ \\  @\n  / | _ \\ \\ @\n |  |   /  |@\n  \\ |_|_\\ / @\n   \\_____/  @@\n175  MACRON\n  _____ @\n |_____|@\n    $   @\n    $   @\n    $   @\n        @@\n176  DEGREE SIGN\n   __  @\n  /  \\ @\n | () |@\n  \\__/ @\n    $  @\n       @@\n177  PLUS-MINUS SIGN\n    _   @\n  _| |_ @\n |_   _|@\n  _|_|_ @\n |_____|@\n        @@\n178  SUPERSCRIPT TWO\n  ___ @\n |_  )@\n  / / @\n /___|@\n   $  @\n      @@\n179  SUPERSCRIPT THREE\n  ____@\n |__ /@\n  |_ \\@\n |___/@\n   $  @\n      @@\n180  ACUTE ACCENT\n  __@\n /_/@\n  $ @\n  $ @\n  $ @\n    @@\n181  MICRO SIGN\n        @\n  _   _ @\n | | | |@\n | |_| |@\n | ._,_|@\n |_|    @@\n182  PILCROW SIGN\n   _____ @\n  /     |@\n | (| | |@\n  \\__ | |@\n    |_|_|@\n         @@\n183  MIDDLE DOT\n    @\n  _ @\n (_)@\n  $ @\n  $ @\n    @@\n184  CEDILLA\n    @\n    @\n    @\n    @\n  _ @\n )_)@@\n185  SUPERSCRIPT ONE\n  _ @\n / |@\n | |@\n |_|@\n  $ @\n    @@\n186  MASCULINE ORDINAL INDICATOR\n  ___ @\n / _ \\@\n \\___/@\n |___|@\n   $  @\n      @@\n187  RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK\n ____  @\n \\ \\ \\ @\n  \\ \\ \\@\n  / / /@\n /_/_/ @\n       @@\n188  VULGAR FRACTION ONE QUARTER\n  _   __    @\n / | / / _  @\n | |/ / | | @\n |_/ /|_  _|@\n  /_/   |_| @\n            @@\n189  VULGAR FRACTION ONE HALF\n  _   __   @\n / | / /__ @\n | |/ /_  )@\n |_/ / / / @\n  /_/ /___|@\n           @@\n190  VULGAR FRACTION THREE QUARTERS\n  ____  __    @\n |__ / / / _  @\n  |_ \\/ / | | @\n |___/ /|_  _|@\n    /_/   |_| @\n              @@\n191  INVERTED QUESTION MARK\n   _  @\n  (_) @\n  | | @\n / /_ @\n \\___|@\n      @@\n192  LATIN CAPITAL LETTER A WITH GRAVE\n   __   @\n   \\_\\  @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n193  LATIN CAPITAL LETTER A WITH ACUTE\n    __  @\n   /_/  @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n194  LATIN CAPITAL LETTER A WITH CIRCUMFLEX\n   //\\  @\n  |/_\\| @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n195  LATIN CAPITAL LETTER A WITH TILDE\n   /\\/| @\n  |/\\/  @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n196  LATIN CAPITAL LETTER A WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n197  LATIN CAPITAL LETTER A WITH RING ABOVE\n    _   @\n   (o)  @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n198  LATIN CAPITAL LETTER AE\n     ______ @\n    /  ____|@\n   / _  _|  @\n  / __ |___ @\n /_/ |_____|@\n            @@\n199  LATIN CAPITAL LETTER C WITH CEDILLA\n   ____ @\n  / ___|@\n | |    @\n | |___ @\n  \\____|@\n    )_) @@\n200  LATIN CAPITAL LETTER E WITH GRAVE\n   __   @\n  _\\_\\_ @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n201  LATIN CAPITAL LETTER E WITH ACUTE\n    __  @\n  _/_/_ @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n202  LATIN CAPITAL LETTER E WITH CIRCUMFLEX\n   //\\  @\n  |/_\\| @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n203  LATIN CAPITAL LETTER E WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n204  LATIN CAPITAL LETTER I WITH GRAVE\n  __  @\n  \\_\\ @\n |_ _|@\n  | | @\n |___|@\n      @@\n205  LATIN CAPITAL LETTER I WITH ACUTE\n   __ @\n  /_/ @\n |_ _|@\n  | | @\n |___|@\n      @@\n206  LATIN CAPITAL LETTER I WITH CIRCUMFLEX\n  //\\ @\n |/_\\|@\n |_ _|@\n  | | @\n |___|@\n      @@\n207  LATIN CAPITAL LETTER I WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n  |_ _| @\n   | |  @\n  |___| @\n        @@\n208  LATIN CAPITAL LETTER ETH\n    ____  @\n   |  _ \\ @\n  _| |_| |@\n |__ __| |@\n   |____/ @\n          @@\n209  LATIN CAPITAL LETTER N WITH TILDE\n   /\\/|@\n  |/\\/ @\n | \\| |@\n | .` |@\n |_|\\_|@\n       @@\n210  LATIN CAPITAL LETTER O WITH GRAVE\n   __   @\n   \\_\\  @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n211  LATIN CAPITAL LETTER O WITH ACUTE\n    __  @\n   /_/  @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n212  LATIN CAPITAL LETTER O WITH CIRCUMFLEX\n   //\\  @\n  |/_\\| @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n213  LATIN CAPITAL LETTER O WITH TILDE\n   /\\/| @\n  |/\\/  @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n214  LATIN CAPITAL LETTER O WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n215  MULTIPLICATION SIGN\n     @\n     @\n /\\/\\@\n >  <@\n \\/\\/@\n     @@\n216  LATIN CAPITAL LETTER O WITH STROKE\n   ____ @\n  / _// @\n | |// |@\n | //| |@\n  //__/ @\n        @@\n217  LATIN CAPITAL LETTER U WITH GRAVE\n   __   @\n  _\\_\\_ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n218  LATIN CAPITAL LETTER U WITH ACUTE\n    __  @\n  _/_/_ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n219  LATIN CAPITAL LETTER U WITH CIRCUMFLEX\n   //\\  @\n  |/ \\| @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n220  LATIN CAPITAL LETTER U WITH DIAERESIS\n  _   _ @\n (_) (_)@\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n221  LATIN CAPITAL LETTER Y WITH ACUTE\n    __  @\n __/_/__@\n \\ \\ / /@\n  \\ V / @\n   |_|  @\n        @@\n222  LATIN CAPITAL LETTER THORN\n  _     @\n | |___ @\n |  __ \\@\n |  ___/@\n |_|    @\n        @@\n223  LATIN SMALL LETTER SHARP S\n   ___ @\n  / _ \\@\n | |/ /@\n | |\\ \\@\n | ||_/@\n |_|   @@\n224  LATIN SMALL LETTER A WITH GRAVE\n   __   @\n   \\_\\_ @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n225  LATIN SMALL LETTER A WITH ACUTE\n    __  @\n   /_/_ @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n226  LATIN SMALL LETTER A WITH CIRCUMFLEX\n   //\\  @\n  |/_\\| @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n227  LATIN SMALL LETTER A WITH TILDE\n   /\\/| @\n  |/\\/_ @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n228  LATIN SMALL LETTER A WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n229  LATIN SMALL LETTER A WITH RING ABOVE\n    __  @\n   (()) @\n  / _ '|@\n | (_| |@\n  \\__,_|@\n        @@\n230  LATIN SMALL LETTER AE\n           @\n   __ ____ @\n  / _`  _ \\@\n | (_|  __/@\n  \\__,____|@\n           @@\n231  LATIN SMALL LETTER C WITH CEDILLA\n       @\n   ___ @\n  / __|@\n | (__ @\n  \\___|@\n   )_) @@\n232  LATIN SMALL LETTER E WITH GRAVE\n   __  @\n   \\_\\ @\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n233  LATIN SMALL LETTER E WITH ACUTE\n    __ @\n   /_/ @\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n234  LATIN SMALL LETTER E WITH CIRCUMFLEX\n   //\\ @\n  |/_\\|@\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n235  LATIN SMALL LETTER E WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n  / _ \\ @\n |  __/ @\n  \\___| @\n        @@\n236  LATIN SMALL LETTER I WITH GRAVE\n __ @\n \\_\\@\n | |@\n | |@\n |_|@\n    @@\n237  LATIN SMALL LETTER I WITH ACUTE\n  __@\n /_/@\n | |@\n | |@\n |_|@\n    @@\n238  LATIN SMALL LETTER I WITH CIRCUMFLEX\n  //\\ @\n |/_\\|@\n  | | @\n  | | @\n  |_| @\n      @@\n239  LATIN SMALL LETTER I WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n   | |  @\n   | |  @\n   |_|  @\n        @@\n240  LATIN SMALL LETTER ETH\n   /\\/\\ @\n   >  < @\n  _\\/\\ |@\n / __` |@\n \\____/ @\n        @@\n241  LATIN SMALL LETTER N WITH TILDE\n   /\\/| @\n  |/\\/  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n242  LATIN SMALL LETTER O WITH GRAVE\n   __   @\n   \\_\\  @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n243  LATIN SMALL LETTER O WITH ACUTE\n    __  @\n   /_/  @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n244  LATIN SMALL LETTER O WITH CIRCUMFLEX\n   //\\  @\n  |/_\\| @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n245  LATIN SMALL LETTER O WITH TILDE\n   /\\/| @\n  |/\\/  @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n246  LATIN SMALL LETTER O WITH DIAERESIS\n  _   _ @\n (_)_(_)@\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n247  DIVISION SIGN\n        @\n    _   @\n  _(_)_ @\n |_____|@\n   (_)  @\n        @@\n248  LATIN SMALL LETTER O WITH STROKE\n         @\n   ____  @\n  / _//\\ @\n | (//) |@\n  \\//__/ @\n         @@\n249  LATIN SMALL LETTER U WITH GRAVE\n   __   @\n  _\\_\\_ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n250  LATIN SMALL LETTER U WITH ACUTE\n    __  @\n  _/_/_ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n251  LATIN SMALL LETTER U WITH CIRCUMFLEX\n   //\\  @\n  |/ \\| @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n252  LATIN SMALL LETTER U WITH DIAERESIS\n  _   _ @\n (_) (_)@\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n253  LATIN SMALL LETTER Y WITH ACUTE\n    __  @\n  _/_/_ @\n | | | |@\n | |_| |@\n  \\__, |@\n  |___/ @@\n254  LATIN SMALL LETTER THORN\n  _     @\n | |__  @\n | '_ \\ @\n | |_) |@\n | .__/ @\n |_|    @@\n255  LATIN SMALL LETTER Y WITH DIAERESIS\n  _   _ @\n (_) (_)@\n | | | |@\n | |_| |@\n  \\__, |@\n  |___/ @@\n0x0100  LATIN CAPITAL LETTER A WITH MACRON\n   ____ @\n  /___/ @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n0x0101  LATIN SMALL LETTER A WITH MACRON\n    ___ @\n   /_ _/@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n0x0102  LATIN CAPITAL LETTER A WITH BREVE\n  _   _ @\n  \\\\_// @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n        @@\n0x0103  LATIN SMALL LETTER A WITH BREVE\n   \\_/  @\n   ___  @\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n0x0104  LATIN CAPITAL LETTER A WITH OGONEK\n        @\n    _   @\n   /_\\  @\n  / _ \\ @\n /_/ \\_\\@\n     (_(@@\n0x0105  LATIN SMALL LETTER A WITH OGONEK\n        @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__,_|@\n     (_(@@\n0x0106  LATIN CAPITAL LETTER C WITH ACUTE\n     __ @\n   _/_/ @\n  / ___|@\n | |___ @\n  \\____|@\n        @@\n0x0107  LATIN SMALL LETTER C WITH ACUTE\n    __ @\n   /__/@\n  / __|@\n | (__ @\n  \\___|@\n       @@\n0x0108  LATIN CAPITAL LETTER C WITH CIRCUMFLEX\n     /\\ @\n   _//\\\\@\n  / ___|@\n | |___ @\n  \\____|@\n        @@\n0x0109  LATIN SMALL LETTER C WITH CIRCUMFLEX\n    /\\ @\n   /_\\ @\n  / __|@\n | (__ @\n  \\___|@\n       @@\n0x010A  LATIN CAPITAL LETTER C WITH DOT ABOVE\n    []  @\n   ____ @\n  / ___|@\n | |___ @\n  \\____|@\n        @@\n0x010B  LATIN SMALL LETTER C WITH DOT ABOVE\n   []  @\n   ___ @\n  / __|@\n | (__ @\n  \\___|@\n       @@\n0x010C  LATIN CAPITAL LETTER C WITH CARON\n   \\\\// @\n   _\\/_ @\n  / ___|@\n | |___ @\n  \\____|@\n        @@\n0x010D  LATIN SMALL LETTER C WITH CARON\n   \\\\//@\n   _\\/ @\n  / __|@\n | (__ @\n  \\___|@\n       @@\n0x010E  LATIN CAPITAL LETTER D WITH CARON\n   \\\\// @\n  __\\/  @\n |  _ \\ @\n | |_| |@\n |____/ @\n        @@\n0x010F  LATIN SMALL LETTER D WITH CARON\n  \\/  _ @\n   __| |@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n0x0110  LATIN CAPITAL LETTER D WITH STROKE\n   ____   @\n  |_ __ \\ @\n /| |/ | |@\n /|_|/_| |@\n  |_____/ @\n          @@\n0x0111  LATIN SMALL LETTER D WITH STROKE\n    ---|@\n   __| |@\n  / _` |@\n | (_| |@\n  \\__,_|@\n        @@\n0x0112  LATIN CAPITAL LETTER E WITH MACRON\n   ____ @\n  /___/ @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n0x0113  LATIN SMALL LETTER E WITH MACRON\n    ____@\n   /_ _/@\n  / _ \\ @\n |  __/ @\n  \\___| @\n        @@\n0x0114  LATIN CAPITAL LETTER E WITH BREVE\n  _   _ @\n  \\\\_// @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n0x0115  LATIN SMALL LETTER E WITH BREVE\n  \\\\  //@\n    --  @\n  / _ \\ @\n |  __/ @\n  \\___| @\n        @@\n0x0116  LATIN CAPITAL LETTER E WITH DOT ABOVE\n    []  @\n  _____ @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n0x0117  LATIN SMALL LETTER E WITH DOT ABOVE\n    [] @\n    __ @\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n0x0118  LATIN CAPITAL LETTER E WITH OGONEK\n        @\n  _____ @\n | ____|@\n |  _|_ @\n |_____|@\n    (__(@@\n0x0119  LATIN SMALL LETTER E WITH OGONEK\n       @\n   ___ @\n  / _ \\@\n |  __/@\n  \\___|@\n    (_(@@\n0x011A  LATIN CAPITAL LETTER E WITH CARON\n   \\\\// @\n  __\\/_ @\n | ____|@\n |  _|_ @\n |_____|@\n        @@\n0x011B  LATIN SMALL LETTER E WITH CARON\n   \\\\//@\n    \\/ @\n  / _ \\@\n |  __/@\n  \\___|@\n       @@\n0x011C  LATIN CAPITAL LETTER G WITH CIRCUMFLEX\n   _/\\_ @\n  / ___|@\n | |  _ @\n | |_| |@\n  \\____|@\n        @@\n0x011D  LATIN SMALL LETTER G WITH CIRCUMFLEX\n     /\\ @\n   _/_ \\@\n  / _` |@\n | (_| |@\n  \\__, |@\n  |___/ @@\n0x011E  LATIN CAPITAL LETTER G WITH BREVE\n   _\\/_ @\n  / ___|@\n | |  _ @\n | |_| |@\n  \\____|@\n        @@\n0x011F  LATIN SMALL LETTER G WITH BREVE\n  \\___/ @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__, |@\n  |___/ @@\n0x0120  LATIN CAPITAL LETTER G WITH DOT ABOVE\n   _[]_ @\n  / ___|@\n | |  _ @\n | |_| |@\n  \\____|@\n        @@\n0x0121  LATIN SMALL LETTER G WITH DOT ABOVE\n   []   @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__, |@\n  |___/ @@\n0x0122  LATIN CAPITAL LETTER G WITH CEDILLA\n   ____ @\n  / ___|@\n | |  _ @\n | |_| |@\n  \\____|@\n   )__) @@\n0x0123  LATIN SMALL LETTER G WITH CEDILLA\n        @\n   __ _ @\n  / _` |@\n | (_| |@\n  \\__, |@\n  |_))))@@\n0x0124  LATIN CAPITAL LETTER H WITH CIRCUMFLEX\n  _/ \\_ @\n | / \\ |@\n | |_| |@\n |  _  |@\n |_| |_|@\n        @@\n0x0125  LATIN SMALL LETTER H WITH CIRCUMFLEX\n  _  /\\ @\n | |//\\ @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n0x0126  LATIN CAPITAL LETTER H WITH STROKE\n  _   _ @\n | |=| |@\n | |_| |@\n |  _  |@\n |_| |_|@\n        @@\n0x0127  LATIN SMALL LETTER H WITH STROKE\n  _     @\n |=|__  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n0x0128  LATIN CAPITAL LETTER I WITH TILDE\n  /\\//@\n |_ _|@\n  | | @\n  | | @\n |___|@\n      @@\n0x0129  LATIN SMALL LETTER I WITH TILDE\n    @\n /\\/@\n | |@\n | |@\n |_|@\n    @@\n0x012A  LATIN CAPITAL LETTER I WITH MACRON\n /___/@\n |_ _|@\n  | | @\n  | | @\n |___|@\n      @@\n0x012B  LATIN SMALL LETTER I WITH MACRON\n  ____@\n /___/@\n  | | @\n  | | @\n  |_| @\n      @@\n0x012C  LATIN CAPITAL LETTER I WITH BREVE\n  \\__/@\n |_ _|@\n  | | @\n  | | @\n |___|@\n      @@\n0x012D  LATIN SMALL LETTER I WITH BREVE\n    @\n \\_/@\n | |@\n | |@\n |_|@\n    @@\n0x012E  LATIN CAPITAL LETTER I WITH OGONEK\n  ___ @\n |_ _|@\n  | | @\n  | | @\n |___|@\n  (__(@@\n0x012F  LATIN SMALL LETTER I WITH OGONEK\n  _  @\n (_) @\n | | @\n | | @\n |_|_@\n  (_(@@\n0x0130  LATIN CAPITAL LETTER I WITH DOT ABOVE\n  _[] @\n |_ _|@\n  | | @\n  | | @\n |___|@\n      @@\n0x0131  LATIN SMALL LETTER DOTLESS I\n    @\n  _ @\n | |@\n | |@\n |_|@\n    @@\n0x0132  LATIN CAPITAL LIGATURE IJ\n  ___  _ @\n |_ _|| |@\n  | | | |@\n  | |_| |@\n |__|__/ @\n         @@\n0x0133  LATIN SMALL LIGATURE IJ\n  _   _ @\n (_) (_)@\n | | | |@\n | | | |@\n |_|_/ |@\n   |__/ @@\n0x0134  LATIN CAPITAL LETTER J WITH CIRCUMFLEX\n      /\\ @\n     /_\\|@\n  _  | | @\n | |_| | @\n  \\___/  @\n         @@\n0x0135  LATIN SMALL LETTER J WITH CIRCUMFLEX\n    /\\@\n   /_\\@\n   | |@\n   | |@\n  _/ |@\n |__/ @@\n0x0136  LATIN CAPITAL LETTER K WITH CEDILLA\n  _  _  @\n | |/ / @\n | ' /  @\n | . \\  @\n |_|\\_\\ @\n    )__)@@\n0x0137  LATIN SMALL LETTER K WITH CEDILLA\n  _    @\n | | __@\n | |/ /@\n |   < @\n |_|\\_\\@\n    )_)@@\n0x0138  LATIN SMALL LETTER KRA\n       @\n  _ __ @\n | |/ \\@\n |   < @\n |_|\\_\\@\n       @@\n0x0139  LATIN CAPITAL LETTER L WITH ACUTE\n  _   //@\n | | // @\n | |    @\n | |___ @\n |_____|@\n        @@\n0x013A  LATIN SMALL LETTER L WITH ACUTE\n  //@\n | |@\n | |@\n | |@\n |_|@\n    @@\n0x013B  LATIN CAPITAL LETTER L WITH CEDILLA\n  _     @\n | |    @\n | |    @\n | |___ @\n |_____|@\n    )__)@@\n0x013C  LATIN SMALL LETTER L WITH CEDILLA\n  _   @\n | |  @\n | |  @\n | |  @\n |_|  @\n   )_)@@\n0x013D  LATIN CAPITAL LETTER L WITH CARON\n  _ \\\\//@\n | | \\/ @\n | |    @\n | |___ @\n |_____|@\n        @@\n0x013E  LATIN SMALL LETTER L WITH CARON\n  _ \\\\//@\n | | \\/ @\n | |    @\n | |    @\n |_|    @\n        @@\n0x013F  LATIN CAPITAL LETTER L WITH MIDDLE DOT\n  _     @\n | |    @\n | | [] @\n | |___ @\n |_____|@\n        @@\n0x0140  LATIN SMALL LETTER L WITH MIDDLE DOT\n  _    @\n | |   @\n | | []@\n | |   @\n |_|   @\n       @@\n0x0141  LATIN CAPITAL LETTER L WITH STROKE\n  __    @\n | //   @\n |//|   @\n // |__ @\n |_____|@\n        @@\n0x0142  LATIN SMALL LETTER L WITH STROKE\n  _ @\n | |@\n |//@\n //|@\n |_|@\n    @@\n0x0143  LATIN CAPITAL LETTER N WITH ACUTE\n  _/ /_ @\n | \\ | |@\n |  \\| |@\n | |\\  |@\n |_| \\_|@\n        @@\n0x0144  LATIN SMALL LETTER N WITH ACUTE\n     _  @\n  _ /_/ @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n0x0145  LATIN CAPITAL LETTER N WITH CEDILLA\n  _   _ @\n | \\ | |@\n |  \\| |@\n | |\\  |@\n |_| \\_|@\n )_)    @@\n0x0146  LATIN SMALL LETTER N WITH CEDILLA\n        @\n  _ __  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n )_)    @@\n0x0147  LATIN CAPITAL LETTER N WITH CARON\n  _\\/ _ @\n | \\ | |@\n |  \\| |@\n | |\\  |@\n |_| \\_|@\n        @@\n0x0148  LATIN SMALL LETTER N WITH CARON\n  \\\\//  @\n  _\\/_  @\n | '_ \\ @\n | | | |@\n |_| |_|@\n        @@\n0x0149  LATIN SMALL LETTER N PRECEDED BY APOSTROPHE\n          @\n  _  __   @\n ( )| '_\\ @\n |/| | | |@\n   |_| |_|@\n          @@\n0x014A  LATIN CAPITAL LETTER ENG\n  _   _ @\n | \\ | |@\n |  \\| |@\n | |\\  |@\n |_| \\ |@\n     )_)@@\n0x014B  LATIN SMALL LETTER ENG\n  _ __  @\n | '_ \\ @\n | | | |@\n |_| | |@\n     | |@\n    |__ @@\n0x014C  LATIN CAPITAL LETTER O WITH MACRON\n   ____ @\n  /_ _/ @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n0x014D  LATIN SMALL LETTER O WITH MACRON\n   ____ @\n  /_ _/ @\n  / _ \\ @\n | (_) |@\n  \\___/ @\n        @@\n0x014E  LATIN CAPITAL LETTER O WITH BREVE\n  \\   / @\n   _-_  @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n0x014F  LATIN SMALL LETTER O WITH BREVE\n  \\   / @\n   _-_  @\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n0x0150  LATIN CAPITAL LETTER O WITH DOUBLE ACUTE\n    ___ @\n   /_/_/@\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n0x0151  LATIN SMALL LETTER O WITH DOUBLE ACUTE\n    ___ @\n   /_/_/@\n  / _ \\ @\n | |_| |@\n  \\___/ @\n        @@\n0x0152  LATIN CAPITAL LIGATURE OE\n   ___  ___ @\n  / _ \\| __|@\n | | | |  | @\n | |_| | |__@\n  \\___/|____@\n            @@\n0x0153  LATIN SMALL LIGATURE OE\n             @\n   ___   ___ @\n  / _ \\ / _ \\@\n | (_) |  __/@\n  \\___/ \\___|@\n             @@\n0x0154  LATIN CAPITAL LETTER R WITH ACUTE\n  _/_/  @\n |  _ \\ @\n | |_) |@\n |  _ < @\n |_| \\_\\@\n        @@\n0x0155  LATIN SMALL LETTER R WITH ACUTE\n     __@\n  _ /_/@\n | '__|@\n | |   @\n |_|   @\n       @@\n0x0156  LATIN CAPITAL LETTER R WITH CEDILLA\n  ____  @\n |  _ \\ @\n | |_) |@\n |  _ < @\n |_| \\_\\@\n )_)    @@\n0x0157  LATIN SMALL LETTER R WITH CEDILLA\n       @\n  _ __ @\n | '__|@\n | |   @\n |_|   @\n   )_) @@\n0x0158  LATIN CAPITAL LETTER R WITH CARON\n  _\\_/  @\n |  _ \\ @\n | |_) |@\n |  _ < @\n |_| \\_\\@\n        @@\n0x0159  LATIN SMALL LETTER R WITH CARON\n  \\\\// @\n  _\\/_ @\n | '__|@\n | |   @\n |_|   @\n       @@\n0x015A  LATIN CAPITAL LETTER S WITH ACUTE\n  _/_/  @\n / ___| @\n \\___ \\ @\n  ___) |@\n |____/ @\n        @@\n0x015B  LATIN SMALL LETTER S WITH ACUTE\n    __@\n  _/_/@\n / __|@\n \\__ \\@\n |___/@\n      @@\n0x015C  LATIN CAPITAL LETTER S WITH CIRCUMFLEX\n  _/\\_  @\n / ___| @\n \\___ \\ @\n  ___) |@\n |____/ @\n        @@\n0x015D  LATIN SMALL LETTER S WITH CIRCUMFLEX\n      @\n  /_\\_@\n / __|@\n \\__ \\@\n |___/@\n      @@\n0x015E  LATIN CAPITAL LETTER S WITH CEDILLA\n  ____  @\n / ___| @\n \\___ \\ @\n  ___) |@\n |____/ @\n    )__)@@\n0x015F  LATIN SMALL LETTER S WITH CEDILLA\n      @\n  ___ @\n / __|@\n \\__ \\@\n |___/@\n   )_)@@\n0x0160  LATIN CAPITAL LETTER S WITH CARON\n  _\\_/  @\n / ___| @\n \\___ \\ @\n  ___) |@\n |____/ @\n        @@\n0x0161  LATIN SMALL LETTER S WITH CARON\n  \\\\//@\n  _\\/ @\n / __|@\n \\__ \\@\n |___/@\n      @@\n0x0162  LATIN CAPITAL LETTER T WITH CEDILLA\n  _____ @\n |_   _|@\n   | |  @\n   | |  @\n   |_|  @\n    )__)@@\n0x0163  LATIN SMALL LETTER T WITH CEDILLA\n  _   @\n | |_ @\n | __|@\n | |_ @\n  \\__|@\n   )_)@@\n0x0164  LATIN CAPITAL LETTER T WITH CARON\n  _____ @\n |_   _|@\n   | |  @\n   | |  @\n   |_|  @\n        @@\n0x0165  LATIN SMALL LETTER T WITH CARON\n  \\/  @\n | |_ @\n | __|@\n | |_ @\n  \\__|@\n      @@\n0x0166  LATIN CAPITAL LETTER T WITH STROKE\n  _____ @\n |_   _|@\n   | |  @\n  -|-|- @\n   |_|  @\n        @@\n0x0167  LATIN SMALL LETTER T WITH STROKE\n  _   @\n | |_ @\n | __|@\n |-|_ @\n  \\__|@\n      @@\n0x0168  LATIN CAPITAL LETTER U WITH TILDE\n        @\n  _/\\/_ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n0x0169  LATIN SMALL LETTER U WITH TILDE\n        @\n  _/\\/_ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n0x016A  LATIN CAPITAL LETTER U WITH MACRON\n   ____ @\n  /__ _/@\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n0x016B  LATIN SMALL LETTER U WITH MACRON\n   ____ @\n  / _  /@\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n0x016C  LATIN CAPITAL LETTER U WITH BREVE\n        @\n   \\_/_ @\n | | | |@\n | |_| |@\n  \\____|@\n        @@\n0x016D  LATIN SMALL LETTER U WITH BREVE\n        @\n   \\_/_ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n0x016E  LATIN CAPITAL LETTER U WITH RING ABOVE\n    O   @\n  __  _ @\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n0x016F  LATIN SMALL LETTER U WITH RING ABOVE\n    O   @\n  __ __ @\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n0x0170  LATIN CAPITAL LETTER U WITH DOUBLE ACUTE\n   -- --@\n  /_//_/@\n | | | |@\n | |_| |@\n  \\___/ @\n        @@\n0x0171  LATIN SMALL LETTER U WITH DOUBLE ACUTE\n    ____@\n  _/_/_/@\n | | | |@\n | |_| |@\n  \\__,_|@\n        @@\n0x0172  LATIN CAPITAL LETTER U WITH OGONEK\n  _   _ @\n | | | |@\n | | | |@\n | |_| |@\n  \\___/ @\n    (__(@@\n0x0173  LATIN SMALL LETTER U WITH OGONEK\n        @\n  _   _ @\n | | | |@\n | |_| |@\n  \\__,_|@\n     (_(@@\n0x0174  LATIN CAPITAL LETTER W WITH CIRCUMFLEX\n __    /\\  __@\n \\ \\  //\\\\/ /@\n  \\ \\ /\\ / / @\n   \\ V  V /  @\n    \\_/\\_/   @\n             @@\n0x0175  LATIN SMALL LETTER W WITH CIRCUMFLEX\n      /\\   @\n __  //\\\\__@\n \\ \\ /\\ / /@\n  \\ V  V / @\n   \\_/\\_/  @\n           @@\n0x0176  LATIN CAPITAL LETTER Y WITH CIRCUMFLEX\n    /\\  @\n __//\\\\ @\n \\ \\ / /@\n  \\ V / @\n   |_|  @\n        @@\n0x0177  LATIN SMALL LETTER Y WITH CIRCUMFLEX\n    /\\  @\n   //\\\\ @\n | | | |@\n | |_| |@\n  \\__, |@\n  |___/ @@\n0x0178  LATIN CAPITAL LETTER Y WITH DIAERESIS\n  []  []@\n __    _@\n \\ \\ / /@\n  \\ V / @\n   |_|  @\n        @@\n0x0179  LATIN CAPITAL LETTER Z WITH ACUTE\n  __/_/@\n |__  /@\n   / / @\n  / /_ @\n /____|@\n       @@\n0x017A  LATIN SMALL LETTER Z WITH ACUTE\n    _ @\n  _/_/@\n |_  /@\n  / / @\n /___|@\n      @@\n0x017B  LATIN CAPITAL LETTER Z WITH DOT ABOVE\n  __[]_@\n |__  /@\n   / / @\n  / /_ @\n /____|@\n       @@\n0x017C  LATIN SMALL LETTER Z WITH DOT ABOVE\n   [] @\n  ____@\n |_  /@\n  / / @\n /___|@\n      @@\n0x017D  LATIN CAPITAL LETTER Z WITH CARON\n  _\\_/_@\n |__  /@\n   / / @\n  / /_ @\n /____|@\n       @@\n0x017E  LATIN SMALL LETTER Z WITH CARON\n  \\\\//@\n  _\\/_@\n |_  /@\n  / / @\n /___|@\n      @@\n0x017F  LATIN SMALL LETTER LONG S\n     __ @\n    / _|@\n |-| |  @\n |-| |  @\n   |_|  @\n        @@\n0x02C7  CARON\n \\\\//@\n  \\/ @\n    $@\n    $@\n    $@\n    $@@\n0x02D8  BREVE\n \\\\_//@\n  \\_/ @\n     $@\n     $@\n     $@\n     $@@\n0x02D9  DOT ABOVE\n []@\n  $@\n  $@\n  $@\n  $@\n  $@@\n0x02DB  OGONEK\n    $@\n    $@\n    $@\n    $@\n    $@\n )_) @@\n0x02DD  DOUBLE ACUTE ACCENT\n  _ _ @\n /_/_/@\n     $@\n     $@\n     $@\n     $@@"
+}

package/dist/src/service/banner/BannerServiceProvider.js

@@ -0,0 +1,60 @@
+import NoBannerCommand from "./command/NoBannerCommand.js";
+import { PRINTER_SERVICE_ID } from "../../api/service/core/PrinterService.js";
+import { ASCII_BANNER_GENERATOR_SERVICE_ID } from "../../api/service/core/AsciiBannerGeneratorService.js";
+export const BANNER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/banner-service";
+/**
+ * Provides ascii banner functionality.
+ */
+export default class BannerServiceProvider {
+    fontName;
+    serviceId = BANNER_SERVICE_ID;
+    servicePriority;
+    #configurationServiceProvider;
+    /**
+     * Whether or not to print the banner, defaults to true.
+     */
+    printBanner = true;
+    /**
+     * Create an instance of the service provider with the specified details.
+     *
+     * @param servicePriority the priority of the service.
+     * @param configurationServiceProvider an optional {@link ConfigurationServiceProvider} to make use of.
+     * @param fontName an optional [FIGlet](http://www.figlet.org) font name to use for the banner, defaults to "standard".
+     */
+    constructor(servicePriority, configurationServiceProvider, fontName = "standard") {
+        this.fontName = fontName;
+        this.servicePriority = servicePriority;
+        this.#configurationServiceProvider = configurationServiceProvider;
+    }
+    getServiceInfo(_cliConfig) {
+        return Promise.resolve({
+            commands: [new NoBannerCommand(this, this.servicePriority)],
+        });
+    }
+    async initService(context) {
+        if (this.printBanner === false) {
+            return Promise.resolve();
+        }
+        const printerService = context.getServiceById(PRINTER_SERVICE_ID);
+        const asciiBannerGeneratorService = context.getServiceById(ASCII_BANNER_GENERATOR_SERVICE_ID);
+        const { cliConfig } = context;
+        const bannerText = await asciiBannerGeneratorService.generate(cliConfig.name.toUpperCase(), {
+            fontName: this.fontName,
+            subMessage: cliConfig.subMessage,
+        });
+        await printerService.info(printerService.blue(bannerText));
+        if (cliConfig.description !== undefined) {
+            await printerService.info(`  ${printerService.primary(cliConfig.description)}\n`);
+        }
+        if (cliConfig.version.length > 0) {
+            await printerService.info(`  ${printerService.secondary("version: " + cliConfig.version)}\n`);
+        }
+        if (this.#configurationServiceProvider) {
+            const configLocation = this.#configurationServiceProvider.configLocation;
+            if (configLocation && configLocation.length > 0) {
+                await printerService.info(`  ${printerService.secondary("config: " + configLocation)}\n`);
+            }
+        }
+        await printerService.info("\n");
+    }
+}

package/dist/src/service/banner/command/NoBannerCommand.js

@@ -0,0 +1,24 @@
+import { ArgumentValueTypeName, } from "../../../api/argument/ArgumentValueTypes.js";
+/**
+ * Command to disable banner output for the CLI application.
+ */
+export default class NoBannerCommand {
+    name = "no-banner";
+    description = "Disable output of banner";
+    enableConfiguration = true;
+    argument = {
+        type: ArgumentValueTypeName.BOOLEAN,
+        defaultValue: true,
+        configurationKey: "NO_BANNER",
+    };
+    executePriority;
+    #bannerServiceProvider;
+    constructor(bannerServiceProvider, executePriority) {
+        this.#bannerServiceProvider = bannerServiceProvider;
+        this.executePriority = executePriority;
+    }
+    execute(_context, argumentValue) {
+        this.#bannerServiceProvider.printBanner = !argumentValue;
+        return Promise.resolve();
+    }
+}