@promptbook/core 0.47.0 → 0.48.0-1

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import { spaceTrim } from 'spacetrim';
+import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import 'prettier';
 import 'prettier/parser-html';
 import 'moment';
@@ -122,6 +122,311 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
+/**
+ * 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;
+}
+
+/**
+ * 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.
  *
@@ -133,32 +438,82 @@ function removeContentComments(content) {
 }
 
 /**
- * This error type indicates that the error should not happen and its last check before crashing with some other error
+ * The version of the Promptbook library
  */
-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));
+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
+ * 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
  */
-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;
+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;
+                }
+            }
     }
-    return PromptbookSyntaxError;
-}(Error));
+    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;
+}
+
+/**
+ * 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;
+}
 
 /**
  * Function parseNumber will parse number from string
@@ -534,11 +889,10 @@ for (var i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
     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");
@@ -621,11 +975,6 @@ function checkExpectations(expectations, value) {
  * TODO: [💝] Unite object for expecting amount and format
  */
 
-/**
- * The maximum number of iterations for a loops
- */
-var LOOP_LIMIT = 1000;
-
 /**
  * This error occurs during the parameter replacement in the template
  *
@@ -699,155 +1048,27 @@ function replaceParameters(template, parameters) {
     if (/^\w+}/.test(replacedTemplate)) {
         throw new TemplateError('Parameter is not opened');
     }
-    return replacedTemplate;
-}
-
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- */
-function isValidJsonString(value) {
-    try {
-        JSON.parse(value);
-        return true;
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
-    }
-}
-
-/**
- * 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');
-    }
-    return codeBlocks[0];
+    return replacedTemplate;
 }
-/***
- * TODO: [🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+
+/**
+ * Function isValidJsonString will tell you if the string is valid JSON or not
  */
+function isValidJsonString(value) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        return false;
+    }
+}
 
 /**
  * Removes Markdown formatting tags from a string.
@@ -930,11 +1151,11 @@ function normalizeTo_SCREAMING_CASE(sentence) {
  */
 
 /* 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()) {
@@ -952,20 +1173,19 @@ function normalizeTo_camelCase(sentence, __firstLetterCapital) {
                 charType = 'NUMBER';
                 normalizedChar = char;
             }
+            else if (/^\/$/.test(char)) {
+                charType = 'SLASH';
+                normalizedChar = char;
+            }
             else {
                 charType = 'OTHER';
-                normalizedChar = '';
-            }
-            if (!lastCharType) {
-                if (__firstLetterCapital) {
-                    normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
-                }
+                normalizedChar = '-';
             }
-            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;
@@ -978,212 +1198,12 @@ function normalizeTo_camelCase(sentence, __firstLetterCapital) {
         }
         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) {
-    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;
-}
-
-/**
- * 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),
-    };
-}
-
-/**
- * The version of the Promptbook library
- */
-var PROMPTBOOK_VERSION = '0.47.0-0';
-
-/**
- * Parses the given script and returns the list of all used variables that are not defined in the script
- *
- * @param script from which to extract the variables
- * @returns the list of variable names
- * @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(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
@@ -1693,7 +1713,7 @@ function promptbookStringToJson(promptbookString) {
         }
         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,
@@ -1730,6 +1750,15 @@ function promptbookStringToJson(promptbookString) {
  * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
  */
 
+function promptbookJsonToString(promptbookJson) {
+    return spaceTrim$1(function (block) { return "\n\n            # ".concat(block(promptbookJson.title), "\n\n        "); });
+}
+/**
+ * TODO: !!!!! Implement
+ * TODO: !!!!! Annotate and warn
+ * TODO: !!!!! Test + test together with promptbookStringToJson
+ */
+
 /**
  * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
  */
@@ -2555,7 +2584,8 @@ var PromptbookReferenceError = /** @class */ (function (_super) {
  * @see https://github.com/webgptorg/promptbook#promptbook-library
  */
 var SimplePromptbookLibrary = /** @class */ (function () {
-    /**!!!
+    /**
+     * Constructs a promptbook library from promptbooks
      *
      * @param promptbooks !!!
      *
@@ -2617,6 +2647,15 @@ var SimplePromptbookLibrary = /** @class */ (function () {
     return SimplePromptbookLibrary;
 }());
 
+/**
+ * Creates PromptbookLibrary from array of PromptbookJson or PromptbookString
+ *
+ * Note: You can combine `PromptbookString` (`.ptbk.md`) with `PromptbookJson` BUT it is not recommended
+ * Note: During the construction syntax and logic of all sources are validated
+ *
+ * @param promptbookSources
+ * @returns PromptbookLibrary
+ */
 function createPromptbookLibraryFromSources() {
     var e_1, _a;
     var promptbookSources = [];
@@ -2648,20 +2687,29 @@ function createPromptbookLibraryFromSources() {
     }
     return new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))();
 }
+/***
+ * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
+ */
+
 /**
- * Constructs Promptbook from any sources
+ * Constructs Promptbook from async sources
+ * It can be one of the following:
+ * - Promise of array of PromptbookJson or PromptbookString
+ * - Factory function that returns Promise of array of PromptbookJson or PromptbookString
  *
- * Note: During the construction syntax and logic of all sources are validated
- * Note: You can combine .ptbk.md and .ptbk.json files BUT it is not recommended
+ * Note: This is useful as internal tool for other constructor functions like
+ *       `createPromptbookLibraryFromUrl` or `createPromptbookLibraryFromDirectory`
+ *       Consider using those functions instead of this one
+ *
+ * Note: The function does NOT return promise it returns the library directly which waits for the sources to be resolved
+ *       when error occurs in given promise or factory function, it is thrown during `listPromptbooks` or `getPromptbookByUrl` call
  *
- * @param promptbookSources contents of .ptbk.md or .ptbk.json files
- * @param settings settings for creating executor functions
+ *
+ * @param promptbookSourcesPromiseOrFactory
  * @returns PromptbookLibrary
+ *
+ * @deprecated Consider using `createPromptbookLibraryFromUrl` or `createPromptbookLibraryFromDirectory`
  */
-/***
- * TODO: !!! Annotate all + all to README and samples
- */
-
 function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
     var library;
     function forSources() {
@@ -2726,9 +2774,18 @@ function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
     };
 }
 /***
- * TODO: !!! Annotate all + all to README and samples
+ * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
  */
 
+/**
+ * Creates PromptbookLibrary as a subset of another PromptbookLibrary
+ *
+ * Note: You can use any type of library as a parent library - local, remote, etc.
+ * Note: This is just a thin wrapper / proxy around the parent library
+ *
+ * @param promptbookSources
+ * @returns PromptbookLibrary
+ */
 function createPromptbookSublibrary(library, predicate) {
     function listPromptbooks() {
         return __awaiter(this, void 0, void 0, function () {
@@ -2799,8 +2856,8 @@ function createPromptbookSublibrary(library, predicate) {
     };
 }
 /***
- * TODO: !!! Annotate all + all to README and samples
+ * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
  */
 
-export { CallbackInterfaceTools, ExecutionTypes, PROMPTBOOK_VERSION, SimplePromptInterfaceTools, SimplePromptbookLibrary, createPromptbookExecutor, createPromptbookLibraryFromPromise, createPromptbookLibraryFromSources, createPromptbookSublibrary, promptbookStringToJson, validatePromptbookJson };
+export { CallbackInterfaceTools, ExecutionTypes, PROMPTBOOK_VERSION, SimplePromptInterfaceTools, SimplePromptbookLibrary, createPromptbookExecutor, createPromptbookLibraryFromPromise, createPromptbookLibraryFromSources, createPromptbookSublibrary, promptbookJsonToString, promptbookStringToJson, validatePromptbookJson };
 //# sourceMappingURL=index.es.js.map