@promptbook/utils 0.60.1 → 0.61.0-1

package/umd/index.umd.js

@@ -137,16 +137,15 @@
         return UnexpectedError;
     }(Error));
 
-    /* tslint:disable */
-    function normalizeTo_camelCase(sentence, __firstLetterCapital) {
+    function normalizeTo_camelCase(text, _isFirstLetterCapital) {
         var e_1, _a;
-        if (__firstLetterCapital === void 0) { __firstLetterCapital = false; }
+        if (_isFirstLetterCapital === void 0) { _isFirstLetterCapital = false; }
         var charType;
         var lastCharType = null;
         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()) {
-                var char = sentence_1_1.value;
+            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+                var char = text_1_1.value;
                 var normalizedChar = void 0;
                 if (/^[a-z]$/.test(char)) {
                     charType = 'LOWERCASE';
@@ -165,7 +164,7 @@
                     normalizedChar = '';
                 }
                 if (!lastCharType) {
-                    if (__firstLetterCapital) {
+                    if (_isFirstLetterCapital) {
                         normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
                     }
                 }
@@ -182,7 +181,7 @@
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_1);
+                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
@@ -444,16 +443,15 @@
         });
     }
 
-    /* tslint:disable */
-    function normalizeToKebabCase(sentence) {
+    function normalizeToKebabCase(text) {
         var e_1, _a;
-        sentence = removeDiacritics(sentence);
+        text = removeDiacritics(text);
         var charType;
         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()) {
-                var char = sentence_1_1.value;
+            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+                var char = text_1_1.value;
                 var normalizedChar = void 0;
                 if (/^[a-z]$/.test(char)) {
                     charType = 'LOWERCASE';
@@ -488,7 +486,7 @@
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_1);
+                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
@@ -612,15 +610,15 @@
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
      */
-    var SyntaxError = /** @class */ (function (_super) {
-        __extends(SyntaxError, _super);
-        function SyntaxError(message) {
+    var ParsingError = /** @class */ (function (_super) {
+        __extends(ParsingError, _super);
+        function ParsingError(message) {
             var _this = _super.call(this, message) || this;
-            _this.name = 'SyntaxError';
-            Object.setPrototypeOf(_this, SyntaxError.prototype);
+            _this.name = 'ParsingError';
+            Object.setPrototypeOf(_this, ParsingError.prototype);
             return _this;
         }
-        return SyntaxError;
+        return ParsingError;
     }(Error));
 
     /**
@@ -628,7 +626,7 @@
      *
      * @param script from which to extract the variables
      * @returns the list of variable names
-     * @throws {SyntaxError} if the script is invalid
+     * @throws {ParsingError} if the script is invalid
      */
     function extractVariables(script) {
         var variables = new Set();
@@ -644,9 +642,8 @@
                     }
                     var undefinedName = error.message.split(' ')[0];
                     /*
-                    Note: Remapping error
-                          From: [ReferenceError: thing is not defined],
-                          To:   [Error: Parameter {thing} is not defined],
+                    Note: Parsing the error
+                          [ReferenceError: thing is not defined]
                     */
                     if (!undefinedName) {
                         throw error;
@@ -664,7 +661,7 @@
             if (!(error instanceof Error)) {
                 throw error;
             }
-            throw new SyntaxError(spacetrim.spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+            throw new ParsingError(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;
     }
@@ -677,7 +674,7 @@
      *
      * @param promptTemplate the template with used parameters
      * @returns the set of parameter names
-     * @throws {SyntaxError} if the script is invalid
+     * @throws {ParsingError} if the script is invalid
      */
     function extractParametersFromPromptTemplate(promptTemplate) {
         var e_1, _a, e_2, _b;
@@ -695,7 +692,7 @@
             }
             finally { if (e_1) throw e_1.error; }
         }
-        if (promptTemplate.executionType === 'SCRIPT') {
+        if (promptTemplate.blockType === 'SCRIPT') {
             try {
                 for (var _e = __values(extractVariables(promptTemplate.content)), _f = _e.next(); !_f.done; _f = _e.next()) {
                     var parameterName = _f.value;
@@ -716,73 +713,6 @@
      * TODO: [🔣] If script require contentLanguage
      */
 
-    /**
-     * 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
-     *
-     * @returns parsed number
-     * @throws {SyntaxError} if the value is not a number
-     *
-     * @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 SyntaxError("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 SyntaxError("Unable to parse number from \"".concat(originalValue, "\""));
-        }
-        var num = parseFloat(value);
-        if (isNaN(num)) {
-            throw new SyntaxError("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
-     */
-
     /**
      * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
      */
@@ -933,19 +863,17 @@
     var LOOP_LIMIT = 1000;
 
     /**
-     * This error occurs during the parameter replacement in the template
-     *
-     * Note: This is a kindof subtype of ExecutionError because it occurs during the execution of the pipeline
+     * This error indicates errors during the execution of the pipeline
      */
-    var TemplateError = /** @class */ (function (_super) {
-        __extends(TemplateError, _super);
-        function TemplateError(message) {
+    var PipelineExecutionError = /** @class */ (function (_super) {
+        __extends(PipelineExecutionError, _super);
+        function PipelineExecutionError(message) {
             var _this = _super.call(this, message) || this;
-            _this.name = 'TemplateError';
-            Object.setPrototypeOf(_this, TemplateError.prototype);
+            _this.name = 'PipelineExecutionError';
+            Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
             return _this;
         }
-        return TemplateError;
+        return PipelineExecutionError;
     }(Error));
 
     /**
@@ -954,7 +882,7 @@
      * @param template the template with parameters in {curly} braces
      * @param parameters the object with parameters
      * @returns the template with replaced parameters
-     * @throws {TemplateError} if parameter is not defined, not closed, or not opened
+     * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
      *
      * @private within the createPipelineExecutor
      */
@@ -972,14 +900,14 @@
                 return "continue";
             }
             if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-                throw new TemplateError('Parameter is already opened or not closed');
+                throw new PipelineExecutionError('Parameter is already opened or not closed');
             }
             if (parameters[parameterName] === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
             }
             var parameterValue = parameters[parameterName];
             if (parameterValue === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
             }
             parameterValue = parameterValue.toString();
             if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
@@ -999,11 +927,11 @@
         }
         // [💫] Check if there are parameters that are not closed properly
         if (/{\w+$/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not closed');
+            throw new PipelineExecutionError('Parameter is not closed');
         }
         // [💫] Check if there are parameters that are not opened properly
         if (/^\w+}/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not opened');
+            throw new PipelineExecutionError('Parameter is not opened');
         }
         return replacedTemplate;
     }
@@ -1109,152 +1037,6 @@
         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];
-    }
-    /***
-     * 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, ''));
-    }
-
-    /**
-     * 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;
-    }
-
     /**
      * Makes first letter of a string uppercase
      *
@@ -1263,22 +1045,14 @@
         return word.substring(0, 1).toLowerCase() + word.substring(1);
     }
 
-    /* tslint:disable */
-    /*
-    TODO: Tests
-    expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
-    expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
-    expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
-    expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
-    */
-    function normalizeTo_SCREAMING_CASE(sentence) {
+    function normalizeTo_SCREAMING_CASE(text) {
         var e_1, _a;
         var charType;
         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()) {
-                var char = sentence_1_1.value;
+            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+                var char = text_1_1.value;
                 var normalizedChar = void 0;
                 if (/^[a-z]$/.test(char)) {
                     charType = 'LOWERCASE';
@@ -1313,7 +1087,7 @@
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_1);
+                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
@@ -1324,6 +1098,11 @@
         return normalizedName;
     }
     /**
+     * TODO: Tests
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
      * TODO: [🌺] Use some intermediate util splitWords
      */
 
@@ -1373,13 +1152,12 @@
             .filter(function (value) { return value !== ''; });
     }
 
-    function normalizeTo_PascalCase(sentence) {
-        return normalizeTo_camelCase(sentence, true);
+    function normalizeTo_PascalCase(text) {
+        return normalizeTo_camelCase(text, true);
     }
 
-    /* tslint:disable */
-    function normalizeTo_snake_case(sentence) {
-        return normalizeTo_SCREAMING_CASE(sentence).toLowerCase();
+    function normalizeTo_snake_case(text) {
+        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
     }
 
     /**
@@ -1449,6 +1227,154 @@
         return true;
     }
 
+    /**
+     * 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
+     *
+     * @returns parsed number
+     * @throws {ParsingError} if the value is not a number
+     *
+     * @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 ParsingError("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 ParsingError("Unable to parse number from \"".concat(originalValue, "\""));
+        }
+        var num = parseFloat(value);
+        if (isNaN(num)) {
+            throw new ParsingError("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
+     */
+
+    /**
+     * 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
+     */
+
     /**
      * Extracts code block from markdown.
      *
@@ -1489,6 +1415,8 @@
 
     /**
      * Create difference set of two sets.
+     *
+     * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
      */
     function difference(a, b, isEqual) {
         var e_1, _a;
@@ -1517,6 +1445,8 @@
 
     /**
      * Creates a new set with all elements that are present in all sets
+     *
+     * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
      */
     function intersection() {
         var e_1, _a;
@@ -1554,6 +1484,8 @@
 
     /**
      * Creates a new set with all elements that are present in either set
+     *
+     * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
      */
     function union() {
         var e_1, _a, e_2, _b;
@@ -1692,10 +1624,196 @@
      * TODO: [🧠] Should this also unwrap the (parenthesis)
      */
 
+    /**
+     * Tests if given string is valid URL.
+     *
+     * Note: This does not check if the file exists only if the path is valid
+     */
+    function isValidFilePath(filePath) {
+        if (typeof filePath !== 'string') {
+            return false;
+        }
+        var filePathSlashes = filePath.split('\\').join('/');
+        // Absolute Unix path: /hello.txt
+        if (/^(\/)/i.test(filePathSlashes)) {
+            return true;
+        }
+        // Absolute Windows path: /hello.txt
+        if (/^([A-Z]{1,2}:\/?)\//i.test(filePathSlashes)) {
+            return true;
+        }
+        // Relative path: ./hello.txt
+        if (/^(\.\.?\/)+/i.test(filePathSlashes)) {
+            return true;
+        }
+        return false;
+    }
+
+    function isValidJavascriptName(javascriptName) {
+        if (typeof javascriptName !== 'string') {
+            return false;
+        }
+        return /^[a-zA-Z_$][0-9a-zA-Z_$]*$/i.test(javascriptName);
+    }
+
+    /**
+     * Tests if given string is valid semantic version
+     *
+     * Note: There are two simmilar functions:
+     * - `isValidSemanticVersion` which tests any semantic version
+     * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+     */
+    function isValidSemanticVersion(version) {
+        if (typeof version !== 'string') {
+            return false;
+        }
+        if (version.startsWith('0.0.0')) {
+            return false;
+        }
+        return /^\d+\.\d+\.\d+(-\d+)?$/i.test(version);
+    }
+
+    /**
+     * Tests if given string is valid promptbook version
+     * It looks into list of known promptbook versions.
+     *
+     * @see https://www.npmjs.com/package/promptbook?activeTab=versions
+     * Note: When you are using for example promptbook 2.0.0 and there already is promptbook 3.0.0 it don`t know about it.
+     * Note: There are two simmilar functions:
+     * - `isValidSemanticVersion` which tests any semantic version
+     * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+     */
+    function isValidPromptbookVersion(version) {
+        if (!isValidSemanticVersion(version)) {
+            return false;
+        }
+        if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
+            return false;
+        }
+        // <- TODO: !!!! Check isValidPromptbookVersion against PROMPTBOOK_VERSIONS
+        return true;
+    }
+
+    /**
+     * Checks if an URL is reserved for private networks or localhost.
+     *
+     * Note: There are two simmilar functions:
+     * - `isUrlOnPrivateNetwork` which tests full URL
+     * - `isHostnameOnPrivateNetwork` *(this one)* which tests just hostname
+     */
+    function isHostnameOnPrivateNetwork(hostname) {
+        if (hostname === 'example.com' ||
+            hostname === 'localhost' ||
+            hostname.endsWith('.localhost') ||
+            hostname.endsWith('.local') ||
+            hostname.endsWith('.test') ||
+            hostname === '127.0.0.1' ||
+            hostname === '::1') {
+            return true;
+        }
+        if (hostname.includes(':')) {
+            // IPv6
+            var ipParts = hostname.split(':');
+            return ipParts[0] === 'fc00' || ipParts[0] === 'fd00' || ipParts[0] === 'fe80';
+        }
+        else {
+            // IPv4
+            var ipParts = hostname.split('.').map(function (part) { return Number.parseInt(part, 10); });
+            return (ipParts[0] === 10 ||
+                (ipParts[0] === 172 && ipParts[1] >= 16 && ipParts[1] <= 31) ||
+                (ipParts[0] === 192 && ipParts[1] === 168));
+        }
+    }
+
+    /**
+     * Checks if an IP address or hostname is reserved for private networks or localhost.
+     *
+     * Note: There are two simmilar functions:
+     * - `isUrlOnPrivateNetwork` *(this one)* which tests full URL
+     * - `isHostnameOnPrivateNetwork` which tests just hostname
+     *
+     * @param {string} ipAddress - The IP address to check.
+     * @returns {boolean} Returns true if the IP address is reserved for private networks or localhost, otherwise false.
+     */
+    function isUrlOnPrivateNetwork(url) {
+        if (typeof url === 'string') {
+            url = new URL(url);
+        }
+        return isHostnameOnPrivateNetwork(url.hostname);
+    }
+
+    /**
+     * Tests if given string is valid URL.
+     *
+     * Note: Dataurl are considered perfectly valid.
+     * Note: There are two simmilar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     */
+    function isValidUrl(url) {
+        if (typeof url !== 'string') {
+            return false;
+        }
+        try {
+            if (url.startsWith('blob:')) {
+                url = url.replace(/^blob:/, '');
+            }
+            var urlObject = new URL(url /* because fail is handled */);
+            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+
+    /**
+     * Tests if given string is valid pipeline URL URL.
+     *
+     * Note: There are two simmilar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
+     */
+    function isValidPipelineUrl(url) {
+        if (!isValidUrl(url)) {
+            return false;
+        }
+        if (!url.startsWith('https://')) {
+            return false;
+        }
+        if (!url.endsWith('.ptbk.md')) {
+            return false;
+        }
+        if (url.includes('#')) {
+            // TODO: [🐠]
+            return false;
+        }
+        if (isUrlOnPrivateNetwork(url)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * TODO: [🐠] Maybe more info why the URL is invalid
+     */
+
+    /**
+     * Checks if value is valid uuid
+     */
+    function isValidUuid(value) {
+        if (typeof value !== 'string') {
+            return false;
+        }
+        return /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/i.test(value);
+    }
+
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.60.0';
+    var PROMPTBOOK_VERSION = '0.61.0-0';
+    // TODO: !!!! List here all the versions and annotate + put into script
 
     // @promptbook/utils
     // And the normalization (originally n12 library) utilities:
@@ -1709,7 +1827,7 @@
         'kebab-case': normalizeToKebabCase,
     };
     /**
-     * TODO: [🧠] Maybe create some indipendent package like `markdown-tools` from both here exported and @private utilities
+     * TODO: [🧠] Maybe create some indipendent package like `@promptbook/markdown-utils`
      * Note: [🕙] It does not make sence to have simple lower / UPPER case normalization
      */
 
@@ -1729,17 +1847,23 @@
     exports.countWords = countWords;
     exports.decapitalize = decapitalize;
     exports.difference = difference;
-    exports.extractAllBlocksFromMarkdown = extractAllBlocksFromMarkdown;
-    exports.extractAllListItemsFromMarkdown = extractAllListItemsFromMarkdown;
     exports.extractBlock = extractBlock;
-    exports.extractOneBlockFromMarkdown = extractOneBlockFromMarkdown;
     exports.extractParameters = extractParameters;
     exports.extractParametersFromPromptTemplate = extractParametersFromPromptTemplate;
     exports.extractVariables = extractVariables;
     exports.forEachAsync = forEachAsync;
     exports.intersection = intersection;
+    exports.isHostnameOnPrivateNetwork = isHostnameOnPrivateNetwork;
+    exports.isUrlOnPrivateNetwork = isUrlOnPrivateNetwork;
+    exports.isValidFilePath = isValidFilePath;
+    exports.isValidJavascriptName = isValidJavascriptName;
     exports.isValidJsonString = isValidJsonString;
     exports.isValidKeyword = isValidKeyword;
+    exports.isValidPipelineUrl = isValidPipelineUrl;
+    exports.isValidPromptbookVersion = isValidPromptbookVersion;
+    exports.isValidSemanticVersion = isValidSemanticVersion;
+    exports.isValidUrl = isValidUrl;
+    exports.isValidUuid = isValidUuid;
     exports.nameToUriPart = nameToUriPart;
     exports.nameToUriParts = nameToUriParts;
     exports.normalizeTo = normalizeTo;
@@ -1752,10 +1876,8 @@
     exports.parseKeywords = parseKeywords;
     exports.parseKeywordsFromString = parseKeywordsFromString;
     exports.parseNumber = parseNumber;
-    exports.removeContentComments = removeContentComments;
     exports.removeDiacritics = removeDiacritics;
     exports.removeEmojis = removeEmojis;
-    exports.removeMarkdownFormatting = removeMarkdownFormatting;
     exports.removeQuotes = removeQuotes;
     exports.renameParameter = renameParameter;
     exports.renderPromptbookMermaid = renderPromptbookMermaid;