@promptbook/cli 0.41.109

package/esm/index.es.js

@@ -0,0 +1,1356 @@
+import colors from 'colors';
+import commander from 'commander';
+import { writeFile, readFile } from 'fs/promises';
+import glob from 'glob-promise';
+import spaceTrim from 'spacetrim';
+import { forTime } from 'waitasecond';
+import { capitalize, normalizeTo_SCREAMING_CASE, normalizeTo_PascalCase } from 'n12';
+import { format } from 'prettier';
+import parserHtml from 'prettier/parser-html';
+
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise */
+
+var extendStatics = function(d, b) {
+    extendStatics = Object.setPrototypeOf ||
+        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+    return extendStatics(d, b);
+};
+
+function __extends(d, b) {
+    if (typeof b !== "function" && b !== null)
+        throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+    extendStatics(d, b);
+    function __() { this.constructor = d; }
+    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+}
+
+var __assign = function() {
+    __assign = Object.assign || function __assign(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+        }
+        return t;
+    };
+    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);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+}
+
+function __read(o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+}
+
+function __spreadArray(to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+}
+
+/**
+ * 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");
+
+/**
+ * The version of the Promptbook library
+ */
+var PROMPTBOOK_VERSION = '0.41.108';
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ */
+var PromptbookSyntaxError = /** @class */ (function (_super) {
+    __extends(PromptbookSyntaxError, _super);
+    function PromptbookSyntaxError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PromptbookSyntaxError';
+        Object.setPrototypeOf(_this, PromptbookSyntaxError.prototype);
+        return _this;
+    }
+    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(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("\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(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(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(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(content.replace(/<!--(.*?)-->/gs, ''));
+}
+
+/**
+ * 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(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',
+    // <- [🥻] Insert here when making new command
+];
+
+/**
+ * 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
+ *
+ * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
+ * Note: it also works only with decimal numbers
+ *
+ * @private within the parseCommand
+ */
+function parseNumber(value) {
+    var originalValue = value;
+    if (typeof value === 'number') {
+        value = value.toString(); // <- TODO: Maybe more efficient way to do this
+    }
+    if (typeof value !== 'string') {
+        return 0;
+    }
+    value = value.trim();
+    if (value.startsWith('+')) {
+        return parseNumber(value.substring(1));
+    }
+    if (value.startsWith('-')) {
+        var number = parseNumber(value.substring(1));
+        if (number === 0) {
+            return 0; // <- Note: To prevent -0
+        }
+        return -number;
+    }
+    value = value.replace(/,/g, '.');
+    value = value.toUpperCase();
+    if (value === '') {
+        return 0;
+    }
+    if (value === '♾' || value.startsWith('INF')) {
+        return Infinity;
+    }
+    if (value.includes('/')) {
+        var _a = __read(value.split('/'), 2), numerator_ = _a[0], denominator_ = _a[1];
+        var numerator = parseNumber(numerator_);
+        var denominator = parseNumber(denominator_);
+        if (denominator === 0) {
+            throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\" because denominator is zero"));
+        }
+        return numerator / denominator;
+    }
+    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 = 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("\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("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+        }
+        if (promptbookUrl.hash !== '') {
+            throw new PromptbookSyntaxError(spaceTrim("\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("\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(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(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(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("\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("\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("\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("\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("\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("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+        }
+        /*
+    } else if (type.startsWith('__________________')) {
+        // <- [🥻] Insert here when making new command
+    */
+    }
+    else {
+        throw new PromptbookSyntaxError(spaceTrim("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - PROMPTBOOK_URL <url>\n                    - PROMPTBOOK_VERSION <version>\n                    - EXECUTE PROMPT TEMPLATE\n                    - EXECUTE SIMPLE TEMPLATE\n                    -         SIMPLE TEMPLATE\n                    - EXECUTE SCRIPT\n                    - EXECUTE PROMPT_DIALOG'\n                    -         PROMPT_DIALOG'\n                    - MODEL NAME <name>\n                    - MODEL VARIANT <\"Chat\"|\"Completion\">\n                    - INPUT  PARAM {<name>} <description>\n                    - OUTPUT PARAM {<name>} <description>\n                    - POSTPROCESS `{functionName}`\n                    - JOKER {<name>}\n                    - EXPECT JSON\n                    - EXPECT <\"Exactly\"|\"Min\"|\"Max\"> <number> <\"Chars\"|\"Words\"|\"Sentences\"|\"Paragraphs\"|\"Pages\">\n\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(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("\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(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(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(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(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: 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(function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
+    }
+    var placeForSection = removeContentComments(content).match(/^##.*$/im);
+    if (!placeForSection) {
+        throw new Error("No place where to put the section <!--".concat(sectionName, "-->"));
+    }
+    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 format(html, {
+            parser: 'markdown',
+            plugins: [parserHtml],
+            // 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;
+    }
+}
+
+/**
+ * !!!
+ */
+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' + normalizeTo_PascalCase(template.title);
+        };
+        var promptbookMermaid_1 = spaceTrim(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(function (block) { return "\n            ```mermaid\n            ".concat(block(promptbookMermaid_1), "\n            ```\n        "); });
+        promptbookString = addAutoGeneratedSection(promptbookString, {
+            sectionName: 'Graph',
+            sectionContent: promptbookMermaidBlock,
+        });
+    }
+    if (isPrettifyed) {
+        promptbookString = prettifyMarkdown(promptbookString);
+    }
+    return promptbookString;
+}
+/**
+ * TODO: Maybe use some Mermaid library instead of string templating
+ * TODO: [🕌] When more than 2 functionalities, split into separate functions
+ */
+
+/**
+ * !!! Initialize
+ */
+function prettifyPromptbookStringCli() {
+    return __awaiter(this, void 0, void 0, function () {
+        var program, prettifyCommand, helloCommand;
+        var _this = this;
+        return __generator(this, function (_a) {
+            if (!isRunningInNode()) {
+                throw new Error(spaceTrim("\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.Command();
+            program.name('promptbook');
+            program.version(PROMPTBOOK_VERSION);
+            program.description(spaceTrim("\n            Promptbook utilities\n        "));
+            prettifyCommand = program.command('prettify');
+            prettifyCommand.description(spaceTrim("\n            Iterates over promptbooks and does multiple enhancing operations on them:\n            1) Adds Mermaid graph\n            2) Prettifies the markdown\n        "));
+            prettifyCommand.argument('<filesGlob>', 'Promptbooks to prettify as glob pattern');
+            prettifyCommand.option('-i, --ignore <glob>', "Ignore as glob pattern");
+            prettifyCommand.action(function (filesGlob, _a) {
+                var ignore = _a.ignore;
+                return __awaiter(_this, void 0, void 0, function () {
+                    var filePaths, filePaths_1, filePaths_1_1, filePath, promptbookMarkdown, error_1, e_1_1;
+                    var e_1, _b;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0: return [4 /*yield*/, glob(filesGlob, { ignore: ignore })];
+                            case 1:
+                                filePaths = _c.sent();
+                                _c.label = 2;
+                            case 2:
+                                _c.trys.push([2, 10, 11, 12]);
+                                filePaths_1 = __values(filePaths), filePaths_1_1 = filePaths_1.next();
+                                _c.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.yellow("Skipping prettify of non-promptbook ".concat(filePath)));
+                                    return [3 /*break*/, 8];
+                                }
+                                return [4 /*yield*/, readFile(filePath, 'utf-8')];
+                            case 4:
+                                promptbookMarkdown = (_c.sent());
+                                _c.label = 5;
+                            case 5:
+                                _c.trys.push([5, 7, , 8]);
+                                promptbookMarkdown = prettifyPromptbookString(promptbookMarkdown, {
+                                    isGraphAdded: true,
+                                    isPrettifyed: true,
+                                    // <- [🕌]
+                                });
+                                return [4 /*yield*/, writeFile(filePath, promptbookMarkdown)];
+                            case 6:
+                                _c.sent();
+                                console.info(colors.green("Prettify ".concat(filePath)));
+                                return [3 /*break*/, 8];
+                            case 7:
+                                error_1 = _c.sent();
+                                if (!(error_1 instanceof Error)) {
+                                    throw error_1;
+                                }
+                                console.info(colors.red("Prettify ".concat(error_1.name, " ").concat(filePath)));
+                                console.error(colors.bgRed(error_1.name));
+                                console.error(error_1);
+                                process.exit(1);
+                                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 = _c.sent();
+                                e_1 = { error: e_1_1 };
+                                return [3 /*break*/, 12];
+                            case 11:
+                                try {
+                                    if (filePaths_1_1 && !filePaths_1_1.done && (_b = filePaths_1.return)) _b.call(filePaths_1);
+                                }
+                                finally { if (e_1) throw e_1.error; }
+                                return [7 /*endfinally*/];
+                            case 12:
+                                process.exit(0);
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            });
+            helloCommand = program.command('hello');
+            helloCommand.description(spaceTrim("\n            Just command for testing\n        "));
+            helloCommand.argument('<name>', 'Your name');
+            helloCommand.option('-g, --greeting <greeting>', "Greeting", 'Hello');
+            helloCommand.action(function (name, _a) {
+                var greeting = _a.greeting;
+                return __awaiter(_this, void 0, void 0, function () {
+                    return __generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0:
+                                console.info(colors.cyan("".concat(greeting, " ").concat(name)));
+                                return [4 /*yield*/, forTime(1000)];
+                            case 1:
+                                _b.sent();
+                                console.info(colors.rainbow("Nice to meet you!"));
+                                process.exit(0);
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            });
+            //------
+            program.parse(process.argv);
+            return [2 /*return*/];
+        });
+    });
+}
+/**
+ * TODO: [🥠] Do not export to utils directly, its just for CLI script
+ * TODO: [🕌] When more functionalities, rename
+ * Note: 11:11
+ */
+
+/**
+ * Hidden utilities which should not be used by external consumers.
+ */
+var __ = {
+    // Note: [🥠]
+    prettifyPromptbookStringCli: prettifyPromptbookStringCli,
+};
+
+export { __ };
+//# sourceMappingURL=index.es.js.map