@promptbook/utils 0.62.0 → 0.63.0-0

package/esm/index.es.js

@@ -1,5 +1,12 @@
 import spaceTrim$1, { spaceTrim } from 'spacetrim';
-export { spaceTrim } from 'spacetrim';
+
+/**
+ * The version of the Promptbook library
+ *
+ * @public exported from all packages
+ */
+var PROMPTBOOK_VERSION = '0.62.0';
+// TODO: !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -122,6 +129,8 @@ function __spreadArray(to, from, pack) {
 
 /**
  * This error type indicates that the error should not happen and its last check before crashing with some other error
+ *
+ * @public exported from `@promptbook/core`
  */
 var UnexpectedError = /** @class */ (function (_super) {
     __extends(UnexpectedError, _super);
@@ -134,6 +143,16 @@ var UnexpectedError = /** @class */ (function (_super) {
     return UnexpectedError;
 }(Error));
 
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @param _isFirstLetterCapital @@@
+ * @returns @@@
+ * @example 'helloWorld'
+ * @example 'iLovePromptbook'
+ * @public exported from `@promptbook/utils`
+ */
 function normalizeTo_camelCase(text, _isFirstLetterCapital) {
     var e_1, _a;
     if (_isFirstLetterCapital === void 0) { _isFirstLetterCapital = false; }
@@ -404,6 +423,8 @@ var defaultDiacriticsRemovalMap = [
  * > "ě" => "e"
  * > "Ă" => "A"
  * > ...
+ *
+ * @public exported from `@promptbook/utils`
  */
 var DIACRITIC_VARIANTS_LETTERS = {};
 // tslint:disable-next-line: prefer-for-of
@@ -431,7 +452,11 @@ for (var i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
 */
 
 /**
+ * @@@
  *
+ * @param input @@@
+ * @returns @@@
+ * @public exported from `@promptbook/utils`
  */
 function removeDiacritics(input) {
     /*eslint no-control-regex: "off"*/
@@ -439,7 +464,19 @@ function removeDiacritics(input) {
         return DIACRITIC_VARIANTS_LETTERS[a] || a;
     });
 }
+/**
+ * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
+ */
 
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @returns @@@
+ * @example 'hello-world'
+ * @example 'i-love-promptbook'
+ * @public exported from `@promptbook/utils`
+ */
 function normalizeToKebabCase(text) {
     var e_1, _a;
     text = removeDiacritics(text);
@@ -499,6 +536,7 @@ function normalizeToKebabCase(text) {
  *
  * @param text with emojis
  * @returns text without emojis
+ * @public exported from `@promptbook/utils`
  */
 function removeEmojis(text) {
     // Replace emojis (and also ZWJ sequence) with hyphens
@@ -510,7 +548,12 @@ function removeEmojis(text) {
 }
 
 /**
- * Function normalizes title to name which can be used as identifier
+ * @@@
+ *
+ * @param value @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
  */
 function titleToName(value) {
     if (value.startsWith('http://') || value.startsWith('https://')) {
@@ -531,6 +574,8 @@ function titleToName(value) {
  * Creates a Mermaid graph based on the promptbook
  *
  * Note: The result is not wrapped in a Markdown code block
+ *
+ * @public exported from `@promptbook/utils`
  */
 function renderPromptbookMermaid(pipelineJson, options) {
     var _a = (options || {}).linkPromptTemplate, linkPromptTemplate = _a === void 0 ? function () { return null; } : _a;
@@ -590,6 +635,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
  *
  * @param template the template with parameters in {curly} braces
  * @returns the list of parameter names
+ * @public exported from `@promptbook/utils`
  */
 function extractParameterNames(template) {
     var e_1, _a;
@@ -614,6 +660,8 @@ function extractParameterNames(template) {
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
  */
 var ParsingError = /** @class */ (function (_super) {
     __extends(ParsingError, _super);
@@ -632,6 +680,7 @@ var ParsingError = /** @class */ (function (_super) {
  * @param script from which to extract the variables
  * @returns the list of variable names
  * @throws {ParsingError} if the script is invalid
+ * @public exported from `@promptbook/utils`
  */
 function extractVariables(script) {
     var variables = new Set();
@@ -680,6 +729,7 @@ function extractVariables(script) {
  * @param promptTemplate the template with used parameters
  * @returns the set of parameter names
  * @throws {ParsingError} if the script is invalid
+ * @public exported from `@promptbook/utils`
  */
 function extractParameterNamesFromPromptTemplate(promptTemplate) {
     var e_1, _a, e_2, _b, e_3, _c;
@@ -736,6 +786,8 @@ function extractParameterNamesFromPromptTemplate(promptTemplate) {
 
 /**
  * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
  */
 var PipelineLogicError = /** @class */ (function (_super) {
     __extends(PipelineLogicError, _super);
@@ -753,6 +805,7 @@ var PipelineLogicError = /** @class */ (function (_super) {
  * In other words, it will find all parameters that are not used in the prompt template itseld and all its dependencies
  *
  * @throws {PipelineLogicError} If the new parameter name is already used in the pipeline
+ * @public exported from `@promptbook/utils`
  */
 function renameParameter(options) {
     var e_1, _a, e_2, _b;
@@ -810,6 +863,7 @@ function renameParameter(options) {
  * @param array - Array to iterate over
  * @param options - Options for the function
  * @param callbackfunction - Function to call for each item
+ * @public exported from `@promptbook/utils`
  */
 function forEachAsync(array, options, callbackfunction) {
     return __awaiter(this, void 0, void 0, function () {
@@ -880,6 +934,8 @@ function forEachAsync(array, options, callbackfunction) {
 
 /**
  * Function isValidJsonString will tell you if the string is valid JSON or not
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidJsonString(value /* <- [👨‍⚖️] */) {
     try {
@@ -900,6 +956,7 @@ function isValidJsonString(value /* <- [👨‍⚖️] */) {
 /**
  * Makes first letter of a string uppercase
  *
+ * @public exported from `@promptbook/utils`
  */
 function capitalize(word) {
     return word.substring(0, 1).toUpperCase() + word.substring(1);
@@ -915,7 +972,7 @@ function capitalize(word) {
  *
  * @param markdown any valid markdown
  * @returns code blocks with language and content
- *
+ * @public exported from `@promptbook/markdown-utils`
  */
 function extractAllBlocksFromMarkdown(markdown) {
     var e_1, _a;
@@ -992,6 +1049,7 @@ function extractAllBlocksFromMarkdown(markdown) {
  *
  * @param markdown any valid markdown
  * @returns code block with language and content
+ * @public exported from `@promptbook/markdown-utils`
  */
 function extractOneBlockFromMarkdown(markdown) {
     var codeBlocks = extractAllBlocksFromMarkdown(markdown);
@@ -1013,24 +1071,98 @@ function extractOneBlockFromMarkdown(markdown) {
  * - `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
+ *
+ * @public exported from `@promptbook/utils`
  */
 function extractBlock(markdown) {
     var content = extractOneBlockFromMarkdown(markdown).content;
     return content;
 }
-//
+/**
+ * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
+ */
 
 /**
  * Simple wrapper `new Date().toISOString()`
  *
  * @returns string_date branded type
+ * @public exported from `@promptbook/utils`
  */
 function $currentDate() {
     return new Date().toISOString();
 }
 
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function deepClone(objectValue) {
+    return JSON.parse(JSON.stringify(objectValue));
+    /*
+    TODO: [🧠] Is there a better implementation?
+    > const propertyNames = Object.getOwnPropertyNames(objectValue);
+    > for (const propertyName of propertyNames) {
+    >     const value = (objectValue as really_any)[propertyName];
+    >     if (value && typeof value === 'object') {
+    >         deepClone(value);
+    >     }
+    > }
+    > return Object.assign({}, objectValue);
+    */
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * @@@
+ *
+ * @returns The same object as the input, but deeply frozen
+ *
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ */
+function deepFreeze(objectValue) {
+    var e_1, _a;
+    var propertyNames = Object.getOwnPropertyNames(objectValue);
+    try {
+        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
+            var propertyName = propertyNames_1_1.value;
+            var value = objectValue[propertyName];
+            if (value && typeof value === 'object') {
+                deepFreeze(value);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return Object.freeze(objectValue);
+}
+/**
+ * @@@
+ * @@@
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @public exported from `@promptbook/utils`
+ *
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ */
+function deepFreezeWithSameType(objectValue) {
+    return deepFreeze(objectValue);
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
 /**
  * Counts number of characters in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countCharacters(text) {
     // Remove null characters
@@ -1044,6 +1176,8 @@ function countCharacters(text) {
 
 /**
  * Counts number of lines in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countLines(text) {
     if (text === '') {
@@ -1054,6 +1188,8 @@ function countLines(text) {
 
 /**
  * Counts number of pages in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countPages(text) {
     var sentencesPerPage = 5; // Assuming each page has 5 sentences
@@ -1064,6 +1200,8 @@ function countPages(text) {
 
 /**
  * Counts number of paragraphs in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countParagraphs(text) {
     return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
@@ -1071,12 +1209,16 @@ function countParagraphs(text) {
 
 /**
  * Split text into sentences
+ *
+ * @public exported from `@promptbook/utils`
  */
 function splitIntoSentences(text) {
     return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
 }
 /**
  * Counts number of sentences in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countSentences(text) {
     return splitIntoSentences(text).length;
@@ -1084,6 +1226,8 @@ function countSentences(text) {
 
 /**
  * Counts number of words in the text
+ *
+ * @public exported from `@promptbook/utils`
  */
 function countWords(text) {
     text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
@@ -1093,6 +1237,8 @@ function countWords(text) {
 
 /**
  * Index of all counter functions
+ *
+ * @public exported from `@promptbook/utils`
  */
 var CountUtils = {
     CHARACTERS: countCharacters,
@@ -1103,14 +1249,43 @@ var CountUtils = {
     PAGES: countPages,
 };
 
+/**
+ * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
+/**
+ * Detects if the code is running in a Node.js environment
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
+/**
+ * Detects if the code is running in a web worker
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
+
 /**
  * Makes first letter of a string uppercase
  *
+ * @public exported from `@promptbook/utils`
  */
 function decapitalize(word) {
     return word.substring(0, 1).toLowerCase() + word.substring(1);
 }
 
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @returns @@@
+ * @example 'HELLO_WORLD'
+ * @example 'I_LOVE_PROMPTBOOK'
+ * @public exported from `@promptbook/utils`
+ */
 function normalizeTo_SCREAMING_CASE(text) {
     var e_1, _a;
     var charType;
@@ -1177,6 +1352,7 @@ function normalizeTo_SCREAMING_CASE(text) {
  *
  * @param {string} input
  * @returns {Set} of keywords without diacritics in lowercase
+ * @public exported from `@promptbook/utils`
  */
 function parseKeywordsFromString(input) {
     var keywords = normalizeTo_SCREAMING_CASE(removeDiacritics(input))
@@ -1191,6 +1367,8 @@ function parseKeywordsFromString(input) {
  *
  * @param keyword to test
  * @returns if keyword is valid or not
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidKeyword(keyword) {
     var keywordParsed = parseKeywordsFromString(keyword);
@@ -1202,6 +1380,14 @@ function isValidKeyword(keyword) {
     return keywordParsedFirst === keyword;
 }
 
+/**
+ * @@@
+ *
+ * @param name @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
+ */
 function nameToUriPart(name) {
     var uriPart = name;
     uriPart = uriPart.toLowerCase();
@@ -1212,25 +1398,43 @@ function nameToUriPart(name) {
     return uriPart;
 }
 
+/**
+ * @@@
+ *
+ * @param name @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
+ */
 function nameToUriParts(name) {
     return nameToUriPart(name)
         .split('-')
         .filter(function (value) { return value !== ''; });
 }
 
+/**
+ *
+ * @param text @public exported from `@promptbook/utils`
+ * @returns
+ * @example 'HelloWorld'
+ * @example 'ILovePromptbook'
+ * @public exported from `@promptbook/utils`
+ */
 function normalizeTo_PascalCase(text) {
     return normalizeTo_camelCase(text, true);
 }
 
-function normalizeTo_snake_case(text) {
-    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
-}
-
 /**
- * Take every whitespace (space, new line, tab) and replace it with a single space.
+ * @@@
+ *
+ * @param text @@@
+ * @returns @@@
+ * @example 'hello_world'
+ * @example 'i_love_promptbook'
+ * @public exported from `@promptbook/utils`
  */
-function normalizeWhitespaces(sentence) {
-    return sentence.replace(/\s+/gs, ' ').trim();
+function normalizeTo_snake_case(text) {
+    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
 }
 
 /**
@@ -1240,6 +1444,7 @@ function normalizeWhitespaces(sentence) {
  *
  * @param input of any kind
  * @returns {Set} of keywords without diacritics in lowercase
+ * @public exported from `@promptbook/utils`
  */
 function parseKeywords(input) {
     if (typeof input === 'string') {
@@ -1266,7 +1471,12 @@ function parseKeywords(input) {
  */
 
 /**
+ * @@@
  *
+ * @param haystack
+ * @param needle
+ * @returns
+ * @public exported from `@promptbook/utils`
  */
 function searchKeywords(haystack, needle) {
     var e_1, _a;
@@ -1302,7 +1512,7 @@ function searchKeywords(haystack, needle) {
  * @returns parsed number
  * @throws {ParsingError} if the value is not a number
  *
- * @private within the parseCommand
+ * @public exported from `@promptbook/utils`
  */
 function parseNumber(value) {
     var originalValue = value;
@@ -1358,12 +1568,14 @@ function parseNumber(value) {
 }
 /**
  * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+ * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
  */
 
 /**
  * Generates random seed
  *
  * Warning: This function is not cryptographically secure (it uses Math.random internally)
+ * @public exported from `@promptbook/utils`
  */
 function $randomSeed() {
     return Math.random();
@@ -1380,6 +1592,7 @@ function $randomSeed() {
  *
  * @param text optionally quoted text
  * @returns text without quotes
+ * @public exported from `@promptbook/utils`
  */
 function removeQuotes(text) {
     if (text.startsWith('"') && text.endsWith('"')) {
@@ -1391,41 +1604,10 @@ function removeQuotes(text) {
     return text;
 }
 
-/**
- * @@@
- *
- * @returns The same object as the input, but deeply frozen
- *
- * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
- */
-function deepFreeze(objectValue) {
-    var e_1, _a;
-    var propertyNames = Object.getOwnPropertyNames(objectValue);
-    try {
-        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
-            var propertyName = propertyNames_1_1.value;
-            var value = objectValue[propertyName];
-            if (value && typeof value === 'object') {
-                deepFreeze(value);
-            }
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return Object.freeze(objectValue);
-}
-/**
- * TODO: [🔼] Export from `@promptbook/utils`
- * TODO: [🧠] Is there a way how to meaningfully test this utility
- */
-
 /**
  * The maximum number of iterations for a loops
+ *
+ * @private within the repository - too low-level in comparison to other `MAX_...`
  */
 var LOOP_LIMIT = 1000;
 /**
@@ -1434,6 +1616,8 @@ var LOOP_LIMIT = 1000;
 var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
 /**
  * The names of the parameters that are reserved for special purposes
+ *
+ * @public exported from `@promptbook/core`
  */
 deepFreeze([
     'content',
@@ -1447,10 +1631,14 @@ deepFreeze([
 ]);
 /**
  * @@@
+ *
+ * @private within the repository
  */
 var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
 /**
  * @@@
+ *
+ * @private within the repository
  */
 var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
 /*
@@ -1458,11 +1646,13 @@ TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
 */
 // [🟡][🟢][🔵][⚪]
 /**
- * TODO: [🔼] Export all to core
+ * TODO: !!!!!! Check that all @private contains some normalized explanation
  */
 
 /**
  * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
  */
 var LimitReachedError = /** @class */ (function (_super) {
     __extends(LimitReachedError, _super);
@@ -1477,6 +1667,8 @@ var LimitReachedError = /** @class */ (function (_super) {
 
 /**
  * This error indicates errors during the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
  */
 var PipelineExecutionError = /** @class */ (function (_super) {
     __extends(PipelineExecutionError, _super);
@@ -1496,6 +1688,7 @@ var PipelineExecutionError = /** @class */ (function (_super) {
  * @param parameters the object with parameters
  * @returns the template with replaced parameters
  * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+ * @public exported from `@promptbook/utils`
  */
 function replaceParameters(template, parameters) {
     var e_1, _a;
@@ -1571,6 +1764,7 @@ function replaceParameters(template, parameters) {
  * 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
+ * @public exported from `@promptbook/utils`
  */
 function difference(a, b, isEqual) {
     var e_1, _a;
@@ -1604,6 +1798,7 @@ 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
+ * @public exported from `@promptbook/utils`
  */
 function intersection() {
     var e_1, _a;
@@ -1643,6 +1838,7 @@ 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
+ * @public exported from `@promptbook/utils`
  */
 function union() {
     var e_1, _a, e_2, _b;
@@ -1685,6 +1881,7 @@ function union() {
  * Note: This is usefull for post-processing of the result of the chat LLM model
  *       when the model wraps the result in the (markdown) code block.
  *
+ * @public exported from `@promptbook/utils`
  */
 function trimCodeBlock(value) {
     value = spaceTrim(value);
@@ -1702,6 +1899,8 @@ function trimCodeBlock(value) {
  *
  * Note: This is usefull for post-processing of the result of the completion LLM model
  *       if you want to start code block in the prompt but you don't want to end it in the result.
+ *
+ * @public exported from `@promptbook/utils`
  */
 function trimEndOfCodeBlock(value) {
     value = spaceTrim(value);
@@ -1721,6 +1920,7 @@ function trimEndOfCodeBlock(value) {
  *
  * @param text optionally quoted text
  * @returns text without quotes
+ * @public exported from `@promptbook/utils`
  */
 function unwrapResult(text, options) {
     var _a = options || {}, _b = _a.isTrimmed, isTrimmed = _b === void 0 ? true : _b, _c = _a.isIntroduceSentenceRemoved, isIntroduceSentenceRemoved = _c === void 0 ? true : _c;
@@ -1785,6 +1985,7 @@ function unwrapResult(text, options) {
  * Tests if given string is valid URL.
  *
  * Note: This does not check if the file exists only if the path is valid
+ * @public exported from `@promptbook/utils`
  */
 function isValidFilePath(filePath) {
     if (typeof filePath !== 'string') {
@@ -1806,6 +2007,13 @@ function isValidFilePath(filePath) {
     return false;
 }
 
+/**
+ * @@@
+ *
+ * @param javascriptName @@@
+ * @returns @@@
+ * @public exported from `@promptbook/utils`
+ */
 function isValidJavascriptName(javascriptName) {
     if (typeof javascriptName !== 'string') {
         return false;
@@ -1819,6 +2027,8 @@ function isValidJavascriptName(javascriptName) {
  * Note: There are two simmilar functions:
  * - `isValidSemanticVersion` which tests any semantic version
  * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidSemanticVersion(version) {
     if (typeof version !== 'string') {
@@ -1839,6 +2049,8 @@ function isValidSemanticVersion(version) {
  * Note: There are two simmilar functions:
  * - `isValidSemanticVersion` which tests any semantic version
  * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidPromptbookVersion(version) {
     if (!isValidSemanticVersion(version)) {
@@ -1857,6 +2069,8 @@ function isValidPromptbookVersion(version) {
  * Note: There are two simmilar functions:
  * - `isUrlOnPrivateNetwork` which tests full URL
  * - `isHostnameOnPrivateNetwork` *(this one)* which tests just hostname
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isHostnameOnPrivateNetwork(hostname) {
     if (hostname === 'example.com' ||
@@ -1891,6 +2105,7 @@ function isHostnameOnPrivateNetwork(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.
+ * @public exported from `@promptbook/utils`
  */
 function isUrlOnPrivateNetwork(url) {
     if (typeof url === 'string') {
@@ -1906,6 +2121,8 @@ function isUrlOnPrivateNetwork(url) {
  * Note: There are two simmilar functions:
  * - `isValidUrl` which tests any URL
  * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidUrl(url) {
     if (typeof url !== 'string') {
@@ -1932,6 +2149,8 @@ function isValidUrl(url) {
  * Note: There are two simmilar functions:
  * - `isValidUrl` which tests any URL
  * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidPipelineUrl(url) {
     if (!isValidUrl(url)) {
@@ -1958,6 +2177,8 @@ function isValidPipelineUrl(url) {
 
 /**
  * Checks if value is valid uuid
+ *
+ * @public exported from `@promptbook/utils`
  */
 function isValidUuid(value) {
     if (typeof value !== 'string') {
@@ -1966,26 +2187,5 @@ function isValidUuid(value) {
     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.62.0-1';
-// TODO: !!!! List here all the versions and annotate + put into script
-
-// @promptbook/utils
-// And the normalization (originally n12 library) utilities:
-var normalizeTo = {
-    // [🕙] lowercase: normalizeTo_lowercase,
-    // [🕙] UPPERCASE: normalizeTo_UPPERCASE,
-    camelCase: normalizeTo_camelCase,
-    PascalCase: normalizeTo_PascalCase,
-    SCREAMING_CASE: normalizeTo_SCREAMING_CASE,
-    snake_case: normalizeTo_snake_case,
-    'kebab-case': normalizeToKebabCase,
-};
-/**
- * Note: [🕙] It does not make sence to have simple lower / UPPER case normalization
- */
-
-export { $currentDate, $randomSeed, CountUtils, DIACRITIC_VARIANTS_LETTERS, PROMPTBOOK_VERSION, capitalize, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, decapitalize, difference, extractBlock, extractParameterNames, extractParameterNamesFromPromptTemplate, 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 };
+export { $currentDate, $randomSeed, CountUtils, DIACRITIC_VARIANTS_LETTERS, PROMPTBOOK_VERSION, capitalize, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, decapitalize, deepClone, deepFreezeWithSameType, difference, extractBlock, extractParameterNames, extractParameterNamesFromPromptTemplate, extractVariables, forEachAsync, intersection, isHostnameOnPrivateNetwork, isRunningInBrowser, isRunningInNode, isRunningInWebWorker, isUrlOnPrivateNetwork, isValidFilePath, isValidJavascriptName, isValidJsonString, isValidKeyword, isValidPipelineUrl, isValidPromptbookVersion, isValidSemanticVersion, isValidUrl, isValidUuid, nameToUriPart, nameToUriParts, normalizeToKebabCase, normalizeTo_PascalCase, normalizeTo_SCREAMING_CASE, normalizeTo_camelCase, normalizeTo_snake_case, parseKeywords, parseKeywordsFromString, parseNumber, removeDiacritics, removeEmojis, removeQuotes, renameParameter, renderPromptbookMermaid, replaceParameters, searchKeywords, splitIntoSentences, titleToName, trimCodeBlock, trimEndOfCodeBlock, union, unwrapResult };
 //# sourceMappingURL=index.es.js.map