@promptbook/utils 0.41.2 → 0.41.4

package/umd/index.umd.js

@@ -1,14 +1,17 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('moment'), require('n12'), require('prettier'), require('prettier/parser-html')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'moment', 'n12', 'prettier', 'prettier/parser-html'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.spaceTrim, global.moment, global.n12, global.prettier, global.parserHtml));
-})(this, (function (exports, spaceTrim, moment, n12, prettier, parserHtml) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('n12'), require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('colors'), require('commander'), require('fs/promises'), require('glob-promise'), require('moment')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'n12', 'spacetrim', 'prettier', 'prettier/parser-html', 'colors', 'commander', 'fs/promises', 'glob-promise', 'moment'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.n12, global.spaceTrim, global.prettier, global.parserHtml, global.colors, global.commander, global.promises, global.glob, global.moment));
+})(this, (function (exports, n12, spaceTrim, prettier, parserHtml, colors, commander, promises, glob, moment) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
-    var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
+    var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
+    var commander__default = /*#__PURE__*/_interopDefaultLegacy(commander);
+    var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
+    var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -52,6 +55,44 @@
         return __assign.apply(this, arguments);
     };
 
+    function __awaiter(thisArg, _arguments, P, generator) {
+        function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+        return new (P || (P = Promise))(function (resolve, reject) {
+            function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+            function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+            function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+            step((generator = generator.apply(thisArg, _arguments || [])).next());
+        });
+    }
+
+    function __generator(thisArg, body) {
+        var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+        return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+        function verb(n) { return function (v) { return step([n, v]); }; }
+        function step(op) {
+            if (f) throw new TypeError("Generator is already executing.");
+            while (_) try {
+                if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+                if (y = 0, t) op = [op[0] & 2, t.value];
+                switch (op[0]) {
+                    case 0: case 1: t = op; break;
+                    case 4: _.label++; return { value: op[1], done: false };
+                    case 5: _.label++; y = op[1]; op = [0]; continue;
+                    case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                    default:
+                        if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                        if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                        if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                        if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                        if (t[2]) _.ops.pop();
+                        _.trys.pop(); continue;
+                }
+                op = body.call(thisArg, _);
+            } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+            if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+        }
+    }
+
     function __values(o) {
         var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
         if (m) return m.call(o);
@@ -105,6 +146,382 @@
         return PromptbookSyntaxError;
     }(Error));
 
+    /**
+     * Supported script languages
+     */
+    var SUPPORTED_SCRIPT_LANGUAGES = ['javascript', 'typescript', 'python'];
+
+    /**
+     * Parses the template and returns the list of all parameter names
+     *
+     * @param template the template with parameters in {curly} braces
+     * @returns the list of parameter names
+     *
+     * @private within the library
+     */
+    function extractParameters(template) {
+        var e_1, _a;
+        var matches = template.matchAll(/{\w+}/g);
+        var parameterNames = [];
+        try {
+            for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
+                var match = matches_1_1.value;
+                var parameterName = match[0].slice(1, -1);
+                if (!parameterNames.includes(parameterName)) {
+                    parameterNames.push(parameterName);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return parameterNames;
+    }
+
+    /**
+     * Computes the deepness of the markdown structure.
+     *
+     * @private within the library
+     */
+    function countMarkdownStructureDeepness(markdownStructure) {
+        var e_1, _a;
+        var maxDeepness = 0;
+        try {
+            for (var _b = __values(markdownStructure.sections), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var section = _c.value;
+                maxDeepness = Math.max(maxDeepness, countMarkdownStructureDeepness(section));
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return maxDeepness + 1;
+    }
+
+    /**
+     * The maximum number of iterations for a loops
+     */
+    var LOOP_LIMIT = 1000;
+
+    /**
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
+     */
+    var UnexpectedError = /** @class */ (function (_super) {
+        __extends(UnexpectedError, _super);
+        function UnexpectedError(message) {
+            var _this = _super.call(this, spaceTrim__default["default"](function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+            _this.name = 'UnexpectedError';
+            Object.setPrototypeOf(_this, UnexpectedError.prototype);
+            return _this;
+        }
+        return UnexpectedError;
+    }(Error));
+
+    /**
+     * Parse a markdown string into a MarkdownStructure object.
+     *
+     * Note: This function does work with code blocks
+     * Note: This function does not work with markdown comments
+     *
+     * @param markdown The markdown string to parse.
+     * @returns The MarkdownStructure object.
+     *
+     * @private within the library
+     */
+    function markdownToMarkdownStructure(markdown) {
+        var e_1, _a;
+        var lines = markdown.split('\n');
+        var root = { level: 0, title: '', contentLines: [], sections: [], parent: null };
+        var current = root;
+        var isInsideCodeBlock = false;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                var headingMatch = line.match(/^(?<mark>#{1,6})\s(?<title>.*)/);
+                if (isInsideCodeBlock || !headingMatch) {
+                    if (line.startsWith('```')) {
+                        isInsideCodeBlock = !isInsideCodeBlock;
+                    }
+                    current.contentLines.push(line);
+                }
+                else {
+                    var level = headingMatch.groups.mark.length;
+                    var title = headingMatch.groups.title.trim();
+                    var parent_1 = void 0;
+                    if (level > current.level) {
+                        // Note: Going deeper (next section is child of current)
+                        parent_1 = current;
+                    }
+                    else {
+                        // Note: Going up or staying at the same level (next section is sibling or parent or grandparent,... of current)
+                        parent_1 = current;
+                        var loopLimit = LOOP_LIMIT;
+                        while (parent_1.level !== level - 1) {
+                            if (loopLimit-- < 0) {
+                                throw new UnexpectedError('Loop limit reached during parsing of markdown structure in `markdownToMarkdownStructure`');
+                            }
+                            if (parent_1.parent === null /* <- Note: We are in root */) {
+                                // [🌻]
+                                throw new Error(spaceTrim__default["default"]("\n                                The file has an invalid structure.\n                                The markdown file must have exactly one top-level section.\n                            "));
+                            }
+                            parent_1 = parent_1.parent;
+                        }
+                    }
+                    var section = { level: level, title: title, contentLines: [], sections: [], parent: parent_1 };
+                    parent_1.sections.push(section);
+                    current = section;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (root.sections.length === 1) {
+            var markdownStructure = parsingMarkdownStructureToMarkdownStructure(root.sections[0]);
+            return markdownStructure;
+        }
+        // [🌻]
+        throw new Error('The markdown file must have exactly one top-level section.');
+        // return root;
+    }
+    /**
+     * @private
+     */
+    function parsingMarkdownStructureToMarkdownStructure(parsingMarkdownStructure) {
+        var level = parsingMarkdownStructure.level, title = parsingMarkdownStructure.title, contentLines = parsingMarkdownStructure.contentLines, sections = parsingMarkdownStructure.sections;
+        return {
+            level: level,
+            title: title,
+            content: spaceTrim__default["default"](contentLines.join('\n')),
+            sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
+        };
+    }
+
+    /**
+     * Utility function to extract all list items from markdown
+     *
+     * Note: It works with both ul and ol
+     * Note: It omits list items in code blocks
+     * Note: It flattens nested lists
+     * Note: It can not work with html syntax and comments
+     *
+     * @param markdown any valid markdown
+     * @returns
+     */
+    function extractAllListItemsFromMarkdown(markdown) {
+        var e_1, _a;
+        var lines = markdown.split('\n');
+        var listItems = [];
+        var isInCodeBlock = false;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                var trimmedLine = line.trim();
+                if (trimmedLine.startsWith('```')) {
+                    isInCodeBlock = !isInCodeBlock;
+                }
+                if (!isInCodeBlock && (trimmedLine.startsWith('-') || trimmedLine.match(/^\d+\./))) {
+                    var listItem = trimmedLine.replace(/^-|\d+\./, '').trim();
+                    listItems.push(listItem);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return listItems;
+    }
+
+    /**
+     * Extracts all code blocks from markdown.
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code blocks with language and content
+     *
+     */
+    function extractAllBlocksFromMarkdown(markdown) {
+        var e_1, _a;
+        var codeBlocks = [];
+        var lines = markdown.split('\n');
+        var currentCodeBlock = null;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                if (line.startsWith('```')) {
+                    var language = line.slice(3).trim() || null;
+                    if (currentCodeBlock === null) {
+                        currentCodeBlock = { language: language, content: '' };
+                    }
+                    else {
+                        if (language !== null) {
+                            // [🌻]
+                            throw new Error("".concat(n12.capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+                        }
+                        codeBlocks.push(currentCodeBlock);
+                        currentCodeBlock = null;
+                    }
+                }
+                else if (currentCodeBlock !== null) {
+                    if (currentCodeBlock.content !== '') {
+                        currentCodeBlock.content += '\n';
+                    }
+                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (currentCodeBlock !== null) {
+            // [🌻]
+            throw new Error("".concat(n12.capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
+        }
+        return codeBlocks;
+    }
+
+    /**
+     * Extracts exactly ONE code block from markdown.
+     *
+     * Note: If there are multiple or no code blocks the function throws an error
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code block with language and content
+     */
+    function extractOneBlockFromMarkdown(markdown) {
+        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
+        if (codeBlocks.length !== 1) {
+            // TODO: Report more specific place where the error happened
+            throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
+        }
+        return codeBlocks[0];
+    }
+    /***
+     * TODO: [🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+     */
+
+    /**
+     * Removes HTML or Markdown comments from a string.
+     *
+     * @param {string} content - The string to remove comments from.
+     * @returns {string} The input string with all comments removed.
+     */
+    function removeContentComments(content) {
+        return spaceTrim__default["default"](content.replace(/<!--(.*?)-->/gs, ''));
+    }
+
+    /**
+     * The version of the Promptbook library
+     */
+    var PROMPTBOOK_VERSION = '0.41.0';
+
+    /**
+     * Parses the given script and returns the list of all used variables that are not defined in the script
+     *
+     * @param script from which to extract the variables
+     * @returns the list of variable names
+     *
+     * @private within the promptbookStringToJson
+     */
+    function extractVariables(script) {
+        var variables = [];
+        script = "(()=>{".concat(script, "})()");
+        try {
+            for (var i = 0; i < 100 /* <- TODO: This limit to configuration */; i++)
+                try {
+                    eval(script);
+                }
+                catch (error) {
+                    if (!(error instanceof ReferenceError)) {
+                        throw error;
+                    }
+                    var undefinedName = error.message.split(' ')[0];
+                    /*
+                    Note: Remapping error
+                          From: [ReferenceError: thing is not defined],
+                          To:   [Error: Parameter {thing} is not defined],
+                    */
+                    if (!undefinedName) {
+                        throw error;
+                    }
+                    if (script.includes(undefinedName + '(')) {
+                        script = "const ".concat(undefinedName, " = ()=>'';") + script;
+                    }
+                    else {
+                        variables.push(undefinedName);
+                        script = "const ".concat(undefinedName, " = '';") + script;
+                    }
+                }
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+        }
+        return variables;
+    }
+
+    /**
+     * Execution type describes the way how the block is executed
+     *
+     * @see https://github.com/webgptorg/promptbook#execution-type
+     */
+    var ExecutionTypes = ['PROMPT_TEMPLATE', 'SIMPLE_TEMPLATE', 'SCRIPT', 'PROMPT_DIALOG'];
+
+    /**
+     * Units of text measurement
+     */
+    var EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'PARAGRAPHS', 'LINES', 'PAGES'];
+    /**
+     * TODO: use one helper type> (string_prompt | string_javascript | string_markdown) & string_template
+     */
+
+    /**
+     * Removes Markdown formatting tags from a string.
+     *
+     * @param {string} str - The string to remove Markdown tags from.
+     * @returns {string} The input string with all Markdown tags removed.
+     */
+    function removeMarkdownFormatting(str) {
+        // Remove bold formatting
+        str = str.replace(/\*\*(.*?)\*\*/g, '$1');
+        // Remove italic formatting
+        str = str.replace(/\*(.*?)\*/g, '$1');
+        // Remove code formatting
+        str = str.replace(/`(.*?)`/g, '$1');
+        return str;
+    }
+
     /**
      * Function parseNumber will parse number from string
      *
@@ -149,24 +566,741 @@
             }
             return numerator / denominator;
         }
-        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
-            return 0;
+        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
+            return 0;
+        }
+        if (value.includes('E')) {
+            var _b = __read(value.split('E'), 2), significand = _b[0], exponent = _b[1];
+            return parseNumber(significand) * Math.pow(10, parseNumber(exponent));
+        }
+        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
+            throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\""));
+        }
+        var num = parseFloat(value);
+        if (isNaN(num)) {
+            throw new PromptbookSyntaxError("Unexpected NaN when parsing number from \"".concat(originalValue, "\""));
+        }
+        return num;
+    }
+    /**
+     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+     */
+
+    /**
+     * Parses one line of ul/ol to command
+     *
+     * @private within the promptbookStringToJson
+     */
+    function parseCommand(listItem) {
+        var e_1, _a;
+        if (listItem.includes('\n') || listItem.includes('\r')) {
+            throw new PromptbookSyntaxError('Command can not contain new line characters:');
+        }
+        var type = listItem.trim();
+        type = type.split('`').join('');
+        type = type.split('"').join('');
+        type = type.split("'").join('');
+        type = type.split('~').join('');
+        type = type.split('[').join('');
+        type = type.split(']').join('');
+        type = type.split('(').join('');
+        type = type.split(')').join('');
+        type = n12.normalizeTo_SCREAMING_CASE(type);
+        type = type.split('DIALOGUE').join('DIALOG');
+        var listItemParts = listItem
+            .split(' ')
+            .map(function (part) { return part.trim(); })
+            .filter(function (item) { return item !== ''; })
+            .filter(function (item) { return !/^PTBK$/i.test(item); })
+            .filter(function (item) { return !/^PROMPTBOOK$/i.test(item); })
+            .map(removeMarkdownFormatting);
+        if (type.startsWith('URL') ||
+            type.startsWith('PTBK_URL') ||
+            type.startsWith('PTBKURL') ||
+            type.startsWith('PROMPTBOOK_URL') ||
+            type.startsWith('PROMPTBOOKURL') ||
+            type.startsWith('HTTPS')) {
+            if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
+            }
+            var promptbookUrlString = listItemParts.pop();
+            var promptbookUrl = new URL(promptbookUrlString);
+            if (promptbookUrl.protocol !== 'https:') {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+            }
+            if (promptbookUrl.hash !== '') {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        URL must not contain hash\n                        Hash is used for identification of the prompt template in the pipeline\n                    ")));
+            }
+            return {
+                type: 'PROMPTBOOK_URL',
+                promptbookUrl: promptbookUrl,
+            };
+        }
+        else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
+            if (listItemParts.length !== 2) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
+            }
+            var promptbookVersion = listItemParts.pop();
+            // TODO: Validate version
+            return {
+                type: 'PROMPTBOOK_VERSION',
+                promptbookVersion: promptbookVersion,
+            };
+        }
+        else if (type.startsWith('EXECUTE') ||
+            type.startsWith('EXEC') ||
+            type.startsWith('PROMPT_DIALOG') ||
+            type.startsWith('SIMPLE_TEMPLATE')) {
+            var executionTypes = ExecutionTypes.filter(function (executionType) { return type.includes(executionType); });
+            if (executionTypes.length !== 1) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Unknown execution type in command:\n\n                        - ".concat(listItem, "\n\n                        Supported execution types are:\n                        ").concat(block(ExecutionTypes.join(', ')), "\n                    "); }));
+            }
+            return {
+                type: 'EXECUTE',
+                executionType: executionTypes[0],
+            };
+        }
+        else if (type.startsWith('MODEL')) {
+            // TODO: Make this more elegant and dynamically
+            if (type.startsWith('MODEL_VARIANT')) {
+                if (type === 'MODEL_VARIANT_CHAT') {
+                    return {
+                        type: 'MODEL',
+                        key: 'modelVariant',
+                        value: 'CHAT',
+                    };
+                }
+                else if (type === 'MODEL_VARIANT_COMPLETION') {
+                    return {
+                        type: 'MODEL',
+                        key: 'modelVariant',
+                        value: 'COMPLETION',
+                    };
+                }
+                else {
+                    throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                            Unknown model variant in command:\n\n                            - ".concat(listItem, "\n\n                            Supported variants are:\n                            ").concat(block(['CHAT', 'COMPLETION'].join(', ')), "\n                        "); }));
+                }
+            }
+            if (type.startsWith('MODEL_NAME')) {
+                return {
+                    type: 'MODEL',
+                    key: 'modelName',
+                    value: listItemParts.pop(),
+                };
+            }
+            else {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                          Unknown model key in command:\n\n                          - ".concat(listItem, "\n\n                          Supported model keys are:\n                          ").concat(block(['variant', 'name'].join(', ')), "\n\n                          Example:\n\n                          - MODEL VARIANT Chat\n                          - MODEL NAME gpt-4\n                    "); }));
+            }
+        }
+        else if (type.startsWith('PARAM') ||
+            type.startsWith('INPUT_PARAM') ||
+            type.startsWith('OUTPUT_PARAM') ||
+            listItem.startsWith('{') ||
+            listItem.startsWith('> {') /* <- Note: This is a bit hack to parse return parameters defined at the end of each section */) {
+            var parametersMatch = listItem.match(/\{(?<parameterName>[a-z0-9_]+)\}[^\S\r\n]*(?<parameterDescription>.*)$/im);
+            if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid parameter in command:\n\n                        - ".concat(listItem, "\n                    ")));
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            var _b = parametersMatch.groups, parameterName = _b.parameterName, parameterDescription = _b.parameterDescription;
+            if (parameterDescription && parameterDescription.match(/\{(?<parameterName>[a-z0-9_]+)\}/im)) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Parameter {".concat(parameterName, "} can not contain another parameter in description:\n\n                        - ").concat(listItem, "\n                    ")));
+            }
+            var isInput = type.startsWith('INPUT');
+            var isOutput = type.startsWith('OUTPUT');
+            return {
+                type: 'PARAMETER',
+                parameterName: parameterName,
+                parameterDescription: parameterDescription.trim() || null,
+                isInput: isInput,
+                isOutput: isOutput,
+            };
+        }
+        else if (type.startsWith('JOKER')) {
+            if (listItemParts.length !== 2) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid JOKER command:\n\n                - ".concat(listItem, "\n            ")));
+            }
+            var parametersMatch = (listItemParts.pop() || '').match(/^\{(?<parameterName>[a-z0-9_]+)\}$/im);
+            if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                      Invalid parameter in command:\n\n                      - ".concat(listItem, "\n                  ")));
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            var parameterName = parametersMatch.groups.parameterName;
+            return {
+                type: 'JOKER',
+                parameterName: parameterName,
+            };
+        }
+        else if (type.startsWith('POSTPROCESS') || type.startsWith('POST_PROCESS')) {
+            if (listItemParts.length !== 2) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
+            }
+            var functionName = listItemParts.pop();
+            return {
+                type: 'POSTPROCESS',
+                functionName: functionName,
+            };
+        }
+        else if (type.startsWith('EXPECT_JSON')) {
+            return {
+                type: 'EXPECT_FORMAT',
+                format: 'JSON',
+            };
+            // [🥤]
+        }
+        else if (type.startsWith('EXPECT')) {
+            try {
+                listItemParts.shift();
+                var sign = void 0;
+                var signRaw = listItemParts.shift();
+                if (/^exact/i.test(signRaw)) {
+                    sign = 'EXACTLY';
+                }
+                else if (/^min/i.test(signRaw)) {
+                    sign = 'MINIMUM';
+                }
+                else if (/^max/i.test(signRaw)) {
+                    sign = 'MAXIMUM';
+                }
+                else {
+                    throw new PromptbookSyntaxError("Invalid sign \"".concat(signRaw, "\""));
+                }
+                var amountRaw = listItemParts.shift();
+                var amount = parseNumber(amountRaw);
+                if (amount < 0) {
+                    throw new PromptbookSyntaxError('Amount must be positive number or zero');
+                }
+                if (amount !== Math.floor(amount)) {
+                    throw new PromptbookSyntaxError('Amount must be whole number');
+                }
+                var unitRaw = listItemParts.shift();
+                var unit = undefined;
+                try {
+                    for (var EXPECTATION_UNITS_1 = __values(EXPECTATION_UNITS), EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next(); !EXPECTATION_UNITS_1_1.done; EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next()) {
+                        var existingUnit = EXPECTATION_UNITS_1_1.value;
+                        var existingUnitText = existingUnit;
+                        existingUnitText = existingUnitText.substring(0, existingUnitText.length - 1);
+                        if (existingUnitText === 'CHARACTER') {
+                            existingUnitText = 'CHAR';
+                        }
+                        if (new RegExp("^".concat(existingUnitText.toLowerCase())).test(unitRaw.toLowerCase()) ||
+                            new RegExp("^".concat(unitRaw.toLowerCase())).test(existingUnitText.toLowerCase())) {
+                            if (unit !== undefined) {
+                                throw new PromptbookSyntaxError("Ambiguous unit \"".concat(unitRaw, "\""));
+                            }
+                            unit = existingUnit;
+                        }
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (EXPECTATION_UNITS_1_1 && !EXPECTATION_UNITS_1_1.done && (_a = EXPECTATION_UNITS_1.return)) _a.call(EXPECTATION_UNITS_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+                if (unit === undefined) {
+                    throw new PromptbookSyntaxError("Invalid unit \"".concat(unitRaw, "\""));
+                }
+                return {
+                    type: 'EXPECT_AMOUNT',
+                    sign: sign,
+                    unit: unit,
+                    amount: amount,
+                };
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+            }
+        }
+        else {
+            throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - Execute\n                    - Model\n                    - Parameter\n                    - INPUT  PARAMETER\n                    - OUTPUT PARAMETER\n                    - PROMPTBOOK VERSION\n                ")));
+        }
+    }
+
+    /**
+     * Parse promptbook from string format to JSON format
+     *
+     * Note: This function does not validate logic of the pipeline only the syntax
+     */
+    function promptbookStringToJson(promptbookString) {
+        var e_1, _a, e_2, _b;
+        var promptbookJson = {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
+            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
+            promptbookVersion: PROMPTBOOK_VERSION,
+            description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
+            parameters: [],
+            promptTemplates: [],
+        };
+        // =============================================================
+        // Note: 1️⃣ Normalization of the PROMPTBOOK string
+        promptbookString = removeContentComments(promptbookString);
+        promptbookString = promptbookString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
+        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
+        // =============================================================
+        ///Note: 2️⃣ Function for adding parameters
+        var addParam = function (parameterCommand) {
+            var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInput = parameterCommand.isInput, isOutput = parameterCommand.isOutput;
+            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+            if (existingParameter &&
+                existingParameter.description &&
+                existingParameter.description !== parameterDescription &&
+                parameterDescription) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+            }
+            if (existingParameter) {
+                if (parameterDescription) {
+                    existingParameter.description = parameterDescription;
+                }
+            }
+            else {
+                promptbookJson.parameters.push({
+                    name: parameterName,
+                    description: parameterDescription || undefined,
+                    isInput: isInput,
+                    isOutput: isOutput,
+                });
+            }
+        };
+        // =============================================================
+        // Note: 3️⃣ Parse the dynamic part - the template pipeline
+        var markdownStructure = markdownToMarkdownStructure(promptbookString);
+        var markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
+        if (markdownStructureDeepness !== 2) {
+            throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
+        }
+        promptbookJson.title = markdownStructure.title;
+        // TODO: [1] DRY description
+        var description = markdownStructure.content;
+        // Note: Remove codeblocks
+        description = description.split(/^```.*^```/gms).join('');
+        //Note: Remove lists and return statement
+        description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+        description = spaceTrim__default["default"](description);
+        if (description === '') {
+            description = undefined;
+        }
+        promptbookJson.description = description;
+        var defaultModelRequirements = {};
+        var listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
+        try {
+            for (var listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
+                var listItem = listItems_1_1.value;
+                var command = parseCommand(listItem);
+                switch (command.type) {
+                    case 'PROMPTBOOK_URL':
+                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
+                        break;
+                    case 'PROMPTBOOK_VERSION':
+                        promptbookJson.promptbookVersion = command.promptbookVersion;
+                        break;
+                    case 'MODEL':
+                        defaultModelRequirements[command.key] = command.value;
+                        break;
+                    case 'PARAMETER':
+                        addParam(command);
+                        break;
+                    default:
+                        throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (listItems_1_1 && !listItems_1_1.done && (_a = listItems_1.return)) _a.call(listItems_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var _loop_1 = function (section) {
+            var e_3, _e, e_4, _f, e_5, _g;
+            // TODO: Parse prompt template description (the content out of the codeblock and lists)
+            var templateModelRequirements = __assign({}, defaultModelRequirements);
+            var listItems_3 = extractAllListItemsFromMarkdown(section.content);
+            var dependentParameterNames = [];
+            var executionType = 'PROMPT_TEMPLATE';
+            var jokers = [];
+            var postprocessing = [];
+            var expectAmount = {};
+            var expectFormat = undefined;
+            var isExecutionTypeChanged = false;
+            try {
+                for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
+                    var listItem = listItems_2_1.value;
+                    var command = parseCommand(listItem);
+                    switch (command.type) {
+                        case 'JOKER':
+                            jokers.push(command.parameterName);
+                            dependentParameterNames.push(command.parameterName);
+                            break;
+                        case 'EXECUTE':
+                            if (isExecutionTypeChanged) {
+                                throw new PromptbookSyntaxError('Execution type is already defined in the prompt template. It can be defined only once.');
+                            }
+                            executionType = command.executionType;
+                            isExecutionTypeChanged = true;
+                            break;
+                        case 'MODEL':
+                            templateModelRequirements[command.key] = command.value;
+                            break;
+                        case 'PARAMETER':
+                            // Note: This is just for detecting resulitng parameter name
+                            addParam(command);
+                            break;
+                        case 'POSTPROCESS':
+                            postprocessing.push(command.functionName);
+                            break;
+                        case 'EXPECT_AMOUNT':
+                            // eslint-disable-next-line no-case-declarations
+                            var unit = command.unit.toLowerCase();
+                            expectAmount[unit] = expectAmount[unit] || {};
+                            if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
+                                if (expectAmount[unit].min !== undefined) {
+                                    throw new PromptbookSyntaxError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                }
+                                expectAmount[unit].min = command.amount;
+                            } /* not else */
+                            if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
+                                if (expectAmount[unit].max !== undefined) {
+                                    throw new PromptbookSyntaxError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                }
+                                expectAmount[unit].max = command.amount;
+                            }
+                            break;
+                        case 'EXPECT_FORMAT':
+                            if (expectFormat !== undefined && command.format !== expectFormat) {
+                                throw new PromptbookSyntaxError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
+                            }
+                            expectFormat = command.format;
+                            break;
+                        default:
+                            throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
+                    }
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (listItems_2_1 && !listItems_2_1.done && (_e = listItems_2.return)) _e.call(listItems_2);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            var _h = extractOneBlockFromMarkdown(section.content), language = _h.language, content = _h.content;
+            if (executionType === 'SCRIPT') {
+                if (!language) {
+                    throw new PromptbookSyntaxError('You must specify the language of the script in the prompt template');
+                }
+                else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
+                    throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
+                }
+            }
+            var lastLine = section.content.split('\n').pop();
+            var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
+            if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
+                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
+                // TODO: Show code of invalid sections each time + DRY
+                section.content
+                    .split('\n')
+                    .map(function (line) { return "> ".concat(line); })
+                    .join('\n')), "\n                        "); }));
+            }
+            var resultingParameterName = match.groups.resultingParamName;
+            // TODO: [1] DRY description
+            var description_1 = section.content;
+            // Note: Remove codeblocks
+            description_1 = description_1.split(/^```.*^```/gms).join('');
+            //Note: Remove lists and return statement
+            description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+            description_1 = spaceTrim__default["default"](description_1);
+            if (description_1 === '') {
+                description_1 = undefined;
+            }
+            if (Object.keys(jokers).length === 0) {
+                jokers = undefined;
+            }
+            if (Object.keys(expectAmount).length === 0) {
+                expectAmount = undefined;
+            }
+            if (Object.keys(postprocessing).length === 0) {
+                postprocessing = undefined;
+            }
+            try {
+                for (var _j = (e_4 = void 0, __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(section.title)), false), __read(extractParameters(description_1 || '')), false), __read(extractParameters(content)), false))), _k = _j.next(); !_k.done; _k = _j.next()) {
+                    var parameterName = _k.value;
+                    dependentParameterNames.push(parameterName);
+                }
+            }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            finally {
+                try {
+                    if (_k && !_k.done && (_f = _j.return)) _f.call(_j);
+                }
+                finally { if (e_4) throw e_4.error; }
+            }
+            if (executionType === 'SCRIPT') {
+                try {
+                    for (var _l = (e_5 = void 0, __values(extractVariables(content))), _m = _l.next(); !_m.done; _m = _l.next()) {
+                        var parameterName = _m.value;
+                        dependentParameterNames.push(parameterName);
+                    }
+                }
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                finally {
+                    try {
+                        if (_m && !_m.done && (_g = _l.return)) _g.call(_l);
+                    }
+                    finally { if (e_5) throw e_5.error; }
+                }
+            }
+            dependentParameterNames = __spreadArray([], __read(new Set(dependentParameterNames)), false);
+            promptbookJson.promptTemplates.push({
+                name: n12.normalizeTo_PascalCase(section.title),
+                title: section.title,
+                description: description_1,
+                dependentParameterNames: dependentParameterNames,
+                executionType: executionType,
+                jokers: jokers,
+                postprocessing: postprocessing,
+                expectAmount: expectAmount,
+                expectFormat: expectFormat,
+                modelRequirements: templateModelRequirements,
+                contentLanguage: executionType === 'SCRIPT' ? language : undefined,
+                content: content,
+                resultingParameterName: resultingParameterName,
+            });
+        };
+        try {
+            for (var _c = __values(markdownStructure.sections), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var section = _d.value;
+                _loop_1(section);
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        // =============================================================
+        return promptbookJson;
+    }
+    /**
+     * TODO: Report here line/column of error
+     * TODO: Use spaceTrim more effectively
+     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+     */
+
+    /**
+     * Add or modify an auto-generated section in a markdown file
+     *
+     * @private within the library
+     */
+    function addAutoGeneratedSection(content, options) {
+        var sectionName = options.sectionName, sectionContent = options.sectionContent;
+        var warningLine = "<!-- \u26A0\uFE0F WARNING: This section was auto-generated -->";
+        var sectionRegex = new RegExp("<!--".concat(sectionName, "-->([\\s\\S]*?)<!--/").concat(sectionName, "-->"), 'g');
+        var sectionMatch = content.match(sectionRegex);
+        if (sectionMatch) {
+            return content.replace(sectionRegex, spaceTrim__default["default"](function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
+        }
+        var placeForSection = content.match(/^##.*$/im);
+        if (!placeForSection) {
+            throw new Error("No place where to put the section <!--".concat(sectionName, "-->"));
         }
-        if (value.includes('E')) {
-            var _b = __read(value.split('E'), 2), significand = _b[0], exponent = _b[1];
-            return parseNumber(significand) * Math.pow(10, parseNumber(exponent));
+        var _a = __read(placeForSection, 1), heading = _a[0];
+        return content.replace(heading, "<!--".concat(sectionName, "-->\n").concat(warningLine, "\n").concat(sectionContent, "\n<!--/").concat(sectionName, "-->\n\n").concat(heading));
+    }
+
+    /**
+     * Prettify the html code
+     *
+     * @param html raw html code
+     * @returns formatted html code
+     */
+    function prettifyMarkdown(html) {
+        try {
+            return prettier.format(html, {
+                parser: 'markdown',
+                plugins: [parserHtml__default["default"]],
+                // TODO: DRY - make some import or auto-copy of .prettierrc
+                endOfLine: 'lf',
+                tabWidth: 4,
+                singleQuote: true,
+                trailingComma: 'all',
+                arrowParens: 'always',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                jsxBracketSameLine: false,
+                bracketSpacing: true,
+            });
         }
-        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
-            throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\""));
+        catch (error) {
+            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
+                error: error,
+                html: html,
+            });
+            return html;
         }
-        var num = parseFloat(value);
-        if (isNaN(num)) {
-            throw new PromptbookSyntaxError("Unexpected NaN when parsing number from \"".concat(originalValue, "\""));
+    }
+
+    /**
+     * !!!
+     */
+    function prettifyPromptbookString(promptbookString, options) {
+        var isGraphAdded = options.isGraphAdded, isPrettifyed = options.isPrettifyed;
+        if (isGraphAdded) {
+            var promptbookJson_1 = promptbookStringToJson(promptbookString);
+            var parameterNameToTemplateName_1 = function (parameterName) {
+                var parameter = promptbookJson_1.parameters.find(function (parameter) { return parameter.name === parameterName; });
+                if (!parameter) {
+                    throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
+                }
+                if (parameter.isInput) {
+                    return 'input';
+                }
+                var template = promptbookJson_1.promptTemplates.find(function (template) { return template.resultingParameterName === parameterName; });
+                if (!template) {
+                    throw new Error("Could not find template for {".concat(parameterName, "}"));
+                }
+                return 'template' + n12.normalizeTo_PascalCase(template.title);
+            };
+            var promptbookMermaid_1 = spaceTrim__default["default"](function (block) { return "\n\n                %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n                flowchart LR\n                  subgraph \"".concat(promptbookJson_1.title, "\"\n\n                      direction TB\n\n                      input((Input)):::input\n                      ").concat(block(promptbookJson_1.promptTemplates
+                .flatMap(function (_a) {
+                var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
+                return __spreadArray([
+                    "".concat(parameterNameToTemplateName_1(resultingParameterName), "(").concat(title, ")")
+                ], __read(dependentParameterNames.map(function (dependentParameterName) {
+                    return "".concat(parameterNameToTemplateName_1(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTemplateName_1(resultingParameterName));
+                })), false);
+            })
+                .join('\n')), "\n\n                      ").concat(block(promptbookJson_1.parameters
+                .filter(function (_a) {
+                var isOutput = _a.isOutput;
+                return isOutput;
+            })
+                .map(function (_a) {
+                var name = _a.name;
+                return "".concat(parameterNameToTemplateName_1(name), "--\"{").concat(name, "}\"-->output");
+            })
+                .join('\n')), "\n                      output((Output)):::output\n\n                      classDef input color: grey;\n                      classDef output color: grey;\n\n                  end;\n\n\n\n        "); });
+            var promptbookMermaidBlock = spaceTrim__default["default"](function (block) { return "\n            ```mermaid\n            ".concat(block(promptbookMermaid_1), "\n            ```\n        "); });
+            promptbookString = addAutoGeneratedSection(promptbookString, {
+                sectionName: 'Graph',
+                sectionContent: promptbookMermaidBlock,
+            });
         }
-        return num;
+        if (isPrettifyed) {
+            promptbookString = prettifyMarkdown(promptbookString);
+        }
+        return promptbookString;
     }
     /**
-     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+     * TODO: [🧠] Should this be here OR in other folder
+     * TODO: [🕌] When more than 2 functionalities, split into separate functions
+     */
+
+    /**
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+     */
+    new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
+    /**
+     * Detects if the code is running in a Node.js environment
+     */
+    var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
+    /**
+     * Detects if the code is running in a web worker
+     */
+    new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
+
+    /**
+     * !!! Initialize
+     */
+    function prettifyPromptbookStringCli() {
+        return __awaiter(this, void 0, void 0, function () {
+            var program, filesGlob, filePaths, filePaths_1, filePaths_1_1, filePath, promptbookMarkdown, error_1, e_1_1;
+            var e_1, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!isRunningInNode()) {
+                            throw new Error(spaceTrim__default["default"]("\n                Function prettifyPromptbookStringCli is initiator of CLI script and should be run in Node.js environment.\n\n                - In browser use prettifyPromptbookString.\n\n            "));
+                        }
+                        program = new commander__default["default"].Command();
+                        program.version(PROMPTBOOK_VERSION);
+                        program.argument('<filesGlob>', 'Promptbooks to prettify');
+                        program.parse(process.argv);
+                        filesGlob = program.options.filesGlob;
+                        return [4 /*yield*/, glob__default["default"](filesGlob)];
+                    case 1:
+                        filePaths = _b.sent();
+                        _b.label = 2;
+                    case 2:
+                        _b.trys.push([2, 10, 11, 12]);
+                        filePaths_1 = __values(filePaths), filePaths_1_1 = filePaths_1.next();
+                        _b.label = 3;
+                    case 3:
+                        if (!!filePaths_1_1.done) return [3 /*break*/, 9];
+                        filePath = filePaths_1_1.value;
+                        if (!filePath.endsWith('.ptbk.md')) {
+                            console.warn(colors__default["default"].yellow("Skipping prettify of non-promptbook ".concat(filePath)));
+                            return [3 /*break*/, 8];
+                        }
+                        return [4 /*yield*/, promises.readFile(filePath, 'utf-8')];
+                    case 4:
+                        promptbookMarkdown = (_b.sent());
+                        _b.label = 5;
+                    case 5:
+                        _b.trys.push([5, 7, , 8]);
+                        promptbookMarkdown = prettifyPromptbookString(promptbookMarkdown, {
+                            isGraphAdded: true,
+                            isPrettifyed: true,
+                            // <- [🕌]
+                        });
+                        return [4 /*yield*/, promises.writeFile(filePath, promptbookMarkdown)];
+                    case 6:
+                        _b.sent();
+                        console.info(colors__default["default"].america("Prettify ".concat(filePath)));
+                        return [3 /*break*/, 8];
+                    case 7:
+                        error_1 = _b.sent();
+                        if (!(error_1 instanceof Error)) {
+                            throw error_1;
+                        }
+                        console.info(colors__default["default"].bgWhite('========================='));
+                        console.info(colors__default["default"].red("Prettify error ".concat(filePath)));
+                        console.error(colors__default["default"].bgRed(error_1.name));
+                        console.error(error_1);
+                        console.info(colors__default["default"].bgWhite('========================='));
+                        return [3 /*break*/, 8];
+                    case 8:
+                        filePaths_1_1 = filePaths_1.next();
+                        return [3 /*break*/, 3];
+                    case 9: return [3 /*break*/, 12];
+                    case 10:
+                        e_1_1 = _b.sent();
+                        e_1 = { error: e_1_1 };
+                        return [3 /*break*/, 12];
+                    case 11:
+                        try {
+                            if (filePaths_1_1 && !filePaths_1_1.done && (_a = filePaths_1.return)) _a.call(filePaths_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                        return [7 /*endfinally*/];
+                    case 12: return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🥠] Do not export to utils directly, its just for CLI script
+     * TODO: [🌰] Use just prettifyPromptbookStringCli
+     * Note: 11:11
      */
 
     /**
@@ -340,38 +1474,6 @@
         return value.replace(/```/g, '\\`\\`\\`');
     }
 
-    /**
-     * Prettify the html code
-     *
-     * @param html raw html code
-     * @returns formatted html code
-     */
-    function prettifyMarkdown(html) {
-        try {
-            return prettier.format(html, {
-                parser: 'markdown',
-                plugins: [parserHtml__default["default"]],
-                // TODO: DRY - make some import or auto-copy of .prettierrc
-                endOfLine: 'lf',
-                tabWidth: 4,
-                singleQuote: true,
-                trailingComma: 'all',
-                arrowParens: 'always',
-                printWidth: 120,
-                htmlWhitespaceSensitivity: 'ignore',
-                jsxBracketSameLine: false,
-                bracketSpacing: true,
-            });
-        }
-        catch (error) {
-            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
-                error: error,
-                html: html,
-            });
-            return html;
-        }
-    }
-
     /**
      * The thresholds for the relative time in the `moment` library.
      *
@@ -659,152 +1761,6 @@
         }
     }
 
-    /**
-     * Extracts all code blocks from markdown.
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
-     *
-     * @param markdown any valid markdown
-     * @returns code blocks with language and content
-     *
-     */
-    function extractAllBlocksFromMarkdown(markdown) {
-        var e_1, _a;
-        var codeBlocks = [];
-        var lines = markdown.split('\n');
-        var currentCodeBlock = null;
-        try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                if (line.startsWith('```')) {
-                    var language = line.slice(3).trim() || null;
-                    if (currentCodeBlock === null) {
-                        currentCodeBlock = { language: language, content: '' };
-                    }
-                    else {
-                        if (language !== null) {
-                            // [🌻]
-                            throw new Error("".concat(n12.capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
-                        }
-                        codeBlocks.push(currentCodeBlock);
-                        currentCodeBlock = null;
-                    }
-                }
-                else if (currentCodeBlock !== null) {
-                    if (currentCodeBlock.content !== '') {
-                        currentCodeBlock.content += '\n';
-                    }
-                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
-                }
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        if (currentCodeBlock !== null) {
-            // [🌻]
-            throw new Error("".concat(n12.capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
-        }
-        return codeBlocks;
-    }
-
-    /**
-     * Utility function to extract all list items from markdown
-     *
-     * Note: It works with both ul and ol
-     * Note: It omits list items in code blocks
-     * Note: It flattens nested lists
-     * Note: It can not work with html syntax and comments
-     *
-     * @param markdown any valid markdown
-     * @returns
-     */
-    function extractAllListItemsFromMarkdown(markdown) {
-        var e_1, _a;
-        var lines = markdown.split('\n');
-        var listItems = [];
-        var isInCodeBlock = false;
-        try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                var trimmedLine = line.trim();
-                if (trimmedLine.startsWith('```')) {
-                    isInCodeBlock = !isInCodeBlock;
-                }
-                if (!isInCodeBlock && (trimmedLine.startsWith('-') || trimmedLine.match(/^\d+\./))) {
-                    var listItem = trimmedLine.replace(/^-|\d+\./, '').trim();
-                    listItems.push(listItem);
-                }
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        return listItems;
-    }
-
-    /**
-     * Extracts exactly ONE code block from markdown.
-     *
-     * Note: If there are multiple or no code blocks the function throws an error
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
-     *
-     * @param markdown any valid markdown
-     * @returns code block with language and content
-     */
-    function extractOneBlockFromMarkdown(markdown) {
-        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
-        if (codeBlocks.length !== 1) {
-            // TODO: Report more specific place where the error happened
-            throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
-        }
-        return codeBlocks[0];
-    }
-    /***
-     * TODO: [🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
-     */
-
-    /**
-     * Removes HTML or Markdown comments from a string.
-     *
-     * @param {string} content - The string to remove comments from.
-     * @returns {string} The input string with all comments removed.
-     */
-    function removeContentComments(content) {
-        return spaceTrim__default["default"](content.replace(/<!--(.*?)-->/gs, ''));
-    }
-
-    /**
-     * Removes Markdown formatting tags from a string.
-     *
-     * @param {string} str - The string to remove Markdown tags from.
-     * @returns {string} The input string with all Markdown tags removed.
-     */
-    function removeMarkdownFormatting(str) {
-        // Remove bold formatting
-        str = str.replace(/\*\*(.*?)\*\*/g, '$1');
-        // Remove italic formatting
-        str = str.replace(/\*(.*?)\*/g, '$1');
-        // Remove code formatting
-        str = str.replace(/`(.*?)`/g, '$1');
-        return str;
-    }
-
     /**
      * Extracts code block from markdown.
      *
@@ -945,8 +1901,20 @@
      * TODO: [🧠] Should this also unwrap the (parenthesis)
      */
 
+    /**
+     * Hidden utilities which should not be used by external consumers.
+     */
+    var __ = {
+        // Note: [🥠]
+        prettifyPromptbookStringCli: prettifyPromptbookStringCli,
+    };
+    /**
+     * TODO: [🧠] Maybe create some indipendent package like `markdown-tools` from both here exported and @private utilities
+     */
+
     exports.CountUtils = CountUtils;
     exports.ExecutionReportStringOptionsDefaults = ExecutionReportStringOptionsDefaults;
+    exports.__ = __;
     exports.assertsExecutionSuccessful = assertsExecutionSuccessful;
     exports.countCharacters = countCharacters;
     exports.countLines = countLines;
@@ -961,6 +1929,7 @@
     exports.extractOneBlockFromMarkdown = extractOneBlockFromMarkdown;
     exports.isValidJsonString = isValidJsonString;
     exports.parseNumber = parseNumber;
+    exports.prettifyPromptbookString = prettifyPromptbookString;
     exports.removeContentComments = removeContentComments;
     exports.removeEmojis = removeEmojis;
     exports.removeMarkdownFormatting = removeMarkdownFormatting;