@promptbook/cli 0.47.0 → 0.48.0-1

package/umd/index.umd.js

@@ -146,7 +146,86 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.47.0-0';
+    var PROMPTBOOK_VERSION = '0.48.0-0';
+
+    /**
+     * 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
@@ -162,6 +241,301 @@
         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.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.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;
+    }
+
+    /**
+     * Makes first letter of a string uppercase
+     *
+     */
+    function capitalize(word) {
+        return word.substring(0, 1).toUpperCase() + word.substring(1);
+    }
+
+    /**
+     * 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.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
+     * @throws {PromptbookSyntaxError} if the script is invalid
+     *
+     * @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.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;
+    }
+
+    /**
+     * Removes emojis from a string and fix whitespaces
+     *
+     * @param text with emojis
+     * @returns text without emojis
+     */
+    function removeEmojis(text) {
+        // Replace emojis (and also ZWJ sequence) with hyphens
+        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
+        text = text.replace(/\p{Extended_Pictographic}/gu, '');
+        return text;
+    }
+
+    /**
+     * Function normalizes title to name which can be used as identifier
+     */
+    function titleToName(value) {
+        value = removeEmojis(value);
+        value = normalizeToKebabCase(value);
+        // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
+        return value;
+    }
+
     /**
      * Creates a Mermaid graph based on the promptbook
      *
@@ -180,7 +554,7 @@
             if (!template) {
                 throw new Error("Could not find template for {".concat(parameterName, "}"));
             }
-            return 'template' + normalizeTo_PascalCase(template.title);
+            return normalizeTo_camelCase('template-' + titleToName(template.title));
         };
         var promptbookMermaid = spacetrim.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.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(promptbookJson.promptTemplates
             .flatMap(function (_a) {
@@ -201,6 +575,7 @@
             return "".concat(parameterNameToTemplateName(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        "); });
+        // TODO: !!!!! Allow to put link callback into `renderPromptbookMermaid`
         return promptbookMermaid;
     }
     /**
@@ -208,20 +583,6 @@
      * TODO: [🕌] When more than 2 functionalities, split into separate functions
      */
 
-    /**
-     * 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));
-
     /**
      * Function parseNumber will parse number from string
      *
@@ -543,11 +904,10 @@
         var letters = defaultDiacriticsRemovalMap[i].letters;
         // tslint:disable-next-line: prefer-for-of
         for (var j = 0; j < letters.length; j++) {
-            DIACRITIC_VARIANTS_LETTERS[letters[j]] =
-                defaultDiacriticsRemovalMap[i].base;
+            DIACRITIC_VARIANTS_LETTERS[letters[j]] = defaultDiacriticsRemovalMap[i].base;
         }
     }
-    // <- TODO: !!!! Put to maker function
+    // <- TODO: [🍓] Put to maker function to save execution time if not needed
     /*
       @see https://stackoverflow.com/questions/990904/remove-accents-diacritics-in-a-string-in-javascript
        Licensed under the Apache License, Version 2.0 (the "License");
@@ -564,9 +924,14 @@
     */
 
     /**
-     * The maximum number of iterations for a loops
+     *
      */
-    var LOOP_LIMIT = 1000;
+    function removeDiacritics(input) {
+        /*eslint no-control-regex: "off"*/
+        return input.replace(/[^\u0000-\u007E]/g, function (a) {
+            return DIACRITIC_VARIANTS_LETTERS[a] || a;
+        });
+    }
 
     /**
      * This error occurs during the parameter replacement in the template
@@ -603,155 +968,17 @@
                 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;
-        }
-    }
-
-    /**
-     * Makes first letter of a string uppercase
-     *
-     */
-    function capitalize(word) {
-        return word.substring(0, 1).toUpperCase() + word.substring(1);
-    }
-
-    /**
-     * 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;
-    }
-
-    /**
-     * 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');
+                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;
         }
-        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.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
@@ -835,11 +1062,11 @@
      */
 
     /* tslint:disable */
-    function normalizeTo_camelCase(sentence, __firstLetterCapital) {
+    function normalizeToKebabCase(sentence) {
         var e_1, _a;
-        if (__firstLetterCapital === void 0) { __firstLetterCapital = false; }
+        sentence = removeDiacritics(sentence);
         var charType;
-        var lastCharType = null;
+        var lastCharType = 'OTHER';
         var normalizedName = '';
         try {
             for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
@@ -857,20 +1084,19 @@
                     charType = 'NUMBER';
                     normalizedChar = char;
                 }
+                else if (/^\/$/.test(char)) {
+                    charType = 'SLASH';
+                    normalizedChar = char;
+                }
                 else {
                     charType = 'OTHER';
-                    normalizedChar = '';
+                    normalizedChar = '-';
                 }
-                if (!lastCharType) {
-                    if (__firstLetterCapital) {
-                        normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
-                    }
-                }
-                else if (charType !== lastCharType &&
-                    !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
+                if (charType !== lastCharType &&
+                    !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
                     !(lastCharType === 'NUMBER') &&
                     !(charType === 'NUMBER')) {
-                    normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
+                    normalizedName += '-';
                 }
                 normalizedName += normalizedChar;
                 lastCharType = charType;
@@ -883,207 +1109,67 @@
             }
             finally { if (e_1) throw e_1.error; }
         }
+        normalizedName = normalizedName.split(/-+/g).join('-');
+        normalizedName = normalizedName.split(/-?\/-?/g).join('/');
+        normalizedName = normalizedName.replace(/^-/, '');
+        normalizedName = normalizedName.replace(/-$/, '');
         return normalizedName;
     }
-    /**
-     * TODO: [🌺] Use some intermediate util splitWords
-     */
-
-    function normalizeTo_PascalCase(sentence) {
-        return normalizeTo_camelCase(sentence, true);
-    }
-
-    /**
-     * 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) {
+    /* tslint:disable */
+    function normalizeTo_camelCase(sentence, __firstLetterCapital) {
         var e_1, _a;
-        var matches = template.matchAll(/{\w+}/g);
-        var parameterNames = [];
+        if (__firstLetterCapital === void 0) { __firstLetterCapital = false; }
+        var charType;
+        var lastCharType = null;
+        var normalizedName = '';
         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);
+            for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
+                var char = sentence_1_1.value;
+                var normalizedChar = void 0;
+                if (/^[a-z]$/.test(char)) {
+                    charType = 'LOWERCASE';
+                    normalizedChar = char;
                 }
-            }
-        }
-        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;
-    }
-
-    /**
-     * 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 if (/^[A-Z]$/.test(char)) {
+                    charType = 'UPPERCASE';
+                    normalizedChar = char.toLowerCase();
+                }
+                else if (/^[0-9]$/.test(char)) {
+                    charType = 'NUMBER';
+                    normalizedChar = char;
                 }
                 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.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;
-                        }
+                    charType = 'OTHER';
+                    normalizedChar = '';
+                }
+                if (!lastCharType) {
+                    if (__firstLetterCapital) {
+                        normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
                     }
-                    var section = { level: level, title: title, contentLines: [], sections: [], parent: parent_1 };
-                    parent_1.sections.push(section);
-                    current = section;
                 }
+                else if (charType !== lastCharType &&
+                    !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
+                    !(lastCharType === 'NUMBER') &&
+                    !(charType === 'NUMBER')) {
+                    normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
+                }
+                normalizedName += normalizedChar;
+                lastCharType = charType;
             }
         }
         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);
+                if (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_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.spaceTrim(contentLines.join('\n')),
-            sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
-        };
+        return normalizedName;
     }
-
     /**
-     * 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
-     * @throws {PromptbookSyntaxError} if the script is invalid
-     *
-     * @private within the promptbookStringToJson
+     * TODO: [🌺] Use some intermediate util splitWords
      */
-    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.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
@@ -1593,7 +1679,7 @@
             }
             dependentParameterNames = __spreadArray([], __read(new Set(dependentParameterNames)), false);
             promptbookJson.promptTemplates.push({
-                name: normalizeTo_PascalCase(section.title),
+                name: titleToName(section.title),
                 title: section.title,
                 description: description_1,
                 dependentParameterNames: dependentParameterNames,
@@ -1676,7 +1762,7 @@
      */
 
     /**
-     * !!! Initialize
+     * Runs CLI script for prettifying promptbooks
      */
     function prettifyPromptbookStringCli() {
         return __awaiter(this, void 0, void 0, function () {