@promptbook/utils 0.60.1 → 0.61.0-0

package/esm/index.es.js

@@ -134,16 +134,15 @@ var UnexpectedError = /** @class */ (function (_super) {
     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';
@@ -162,7 +161,7 @@ function normalizeTo_camelCase(sentence, __firstLetterCapital) {
                 normalizedChar = '';
             }
             if (!lastCharType) {
-                if (__firstLetterCapital) {
+                if (_isFirstLetterCapital) {
                     normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
                 }
             }
@@ -179,7 +178,7 @@ function normalizeTo_camelCase(sentence, __firstLetterCapital) {
     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; }
     }
@@ -441,16 +440,15 @@ function removeDiacritics(input) {
     });
 }
 
-/* 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';
@@ -485,7 +483,7 @@ function normalizeToKebabCase(sentence) {
     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; }
     }
@@ -609,15 +607,15 @@ function extractParameters(template) {
 /**
  * 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));
 
 /**
@@ -625,7 +623,7 @@ var SyntaxError = /** @class */ (function (_super) {
  *
  * @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();
@@ -641,9 +639,8 @@ function extractVariables(script) {
                 }
                 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;
@@ -661,7 +658,7 @@ function extractVariables(script) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new SyntaxError(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(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
     }
     return variables;
 }
@@ -674,7 +671,7 @@ function extractVariables(script) {
  *
  * @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;
@@ -692,7 +689,7 @@ function extractParametersFromPromptTemplate(promptTemplate) {
         }
         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;
@@ -713,73 +710,6 @@ function extractParametersFromPromptTemplate(promptTemplate) {
  * 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)
  */
@@ -930,19 +860,17 @@ function forEachAsync(array, options, callbackfunction) {
 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));
 
 /**
@@ -951,7 +879,7 @@ var TemplateError = /** @class */ (function (_super) {
  * @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
  */
@@ -969,14 +897,14 @@ function replaceParameters(template, parameters) {
             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)) {
@@ -996,11 +924,11 @@ function replaceParameters(template, parameters) {
     }
     // [💫] 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;
 }
@@ -1106,152 +1034,6 @@ 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];
-}
-/***
- * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
- */
-
-/**
- * Removes HTML or Markdown comments from a string.
- *
- * @param {string} content - The string to remove comments from.
- * @returns {string} The input string with all comments removed.
- */
-function removeContentComments(content) {
-    return spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
-}
-
-/**
- * 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
  *
@@ -1260,22 +1042,14 @@ function decapitalize(word) {
     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';
@@ -1310,7 +1084,7 @@ function normalizeTo_SCREAMING_CASE(sentence) {
     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; }
     }
@@ -1321,6 +1095,11 @@ function normalizeTo_SCREAMING_CASE(sentence) {
     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
  */
 
@@ -1370,13 +1149,12 @@ function nameToUriParts(name) {
         .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();
 }
 
 /**
@@ -1446,6 +1224,154 @@ function searchKeywords(haystack, needle) {
     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.
  *
@@ -1486,6 +1412,8 @@ function removeQuotes(text) {
 
 /**
  * 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;
@@ -1514,6 +1442,8 @@ function difference(a, b, isEqual) {
 
 /**
  * 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;
@@ -1551,6 +1481,8 @@ function intersection() {
 
 /**
  * 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;
@@ -1689,10 +1621,196 @@ function unwrapResult(text, options) {
  * 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';
+// TODO: !!!! List here all the versions and annotate + put into script
 
 // @promptbook/utils
 // And the normalization (originally n12 library) utilities:
@@ -1706,9 +1824,9 @@ var normalizeTo = {
     '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
  */
 
-export { CountUtils, DIACRITIC_VARIANTS_LETTERS, PROMPTBOOK_VERSION, capitalize, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, decapitalize, difference, extractAllBlocksFromMarkdown, extractAllListItemsFromMarkdown, extractBlock, extractOneBlockFromMarkdown, extractParameters, extractParametersFromPromptTemplate, extractVariables, forEachAsync, intersection, isValidJsonString, isValidKeyword, nameToUriPart, nameToUriParts, normalizeTo, normalizeToKebabCase, normalizeTo_PascalCase, normalizeTo_SCREAMING_CASE, normalizeTo_camelCase, normalizeTo_snake_case, normalizeWhitespaces, parseKeywords, parseKeywordsFromString, parseNumber, removeContentComments, removeDiacritics, removeEmojis, removeMarkdownFormatting, removeQuotes, renameParameter, renderPromptbookMermaid, replaceParameters, searchKeywords, splitIntoSentences, titleToName, trimCodeBlock, trimEndOfCodeBlock, union, unwrapResult };
+export { CountUtils, DIACRITIC_VARIANTS_LETTERS, PROMPTBOOK_VERSION, capitalize, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, decapitalize, difference, extractBlock, extractParameters, extractParametersFromPromptTemplate, extractVariables, forEachAsync, intersection, isHostnameOnPrivateNetwork, isUrlOnPrivateNetwork, isValidFilePath, isValidJavascriptName, isValidJsonString, isValidKeyword, isValidPipelineUrl, isValidPromptbookVersion, isValidSemanticVersion, isValidUrl, isValidUuid, nameToUriPart, nameToUriParts, normalizeTo, normalizeToKebabCase, normalizeTo_PascalCase, normalizeTo_SCREAMING_CASE, normalizeTo_camelCase, normalizeTo_snake_case, normalizeWhitespaces, parseKeywords, parseKeywordsFromString, parseNumber, removeDiacritics, removeEmojis, removeQuotes, renameParameter, renderPromptbookMermaid, replaceParameters, searchKeywords, splitIntoSentences, titleToName, trimCodeBlock, trimEndOfCodeBlock, union, unwrapResult };
 //# sourceMappingURL=index.es.js.map