@promptbook/utils 0.103.0-9 → 0.104.0-0

package/esm/index.es.js

@@ -1,6 +1,8 @@
-import spaceTrim$1, { spaceTrim as spaceTrim$2 } from 'spacetrim';
+import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { basename } from 'path';
 import { randomBytes } from 'crypto';
+import { SHA256 } from 'crypto-js';
+import hexEncoder from 'crypto-js/enc-hex';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
 /**
@@ -9,19 +11,30 @@ import { randomBytes } from 'crypto';
  * @generated
  * @see https://github.com/webgptorg/book
  */
-const BOOK_LANGUAGE_VERSION = '1.0.0';
+const BOOK_LANGUAGE_VERSION = '2.0.0';
 /**
  * The version of the Promptbook engine
  *
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-9';
+const PROMPTBOOK_ENGINE_VERSION = '0.104.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Trims string from all 4 sides
+ *
+ * Note: This is a re-exported function from the `spacetrim` package which is
+ *       Developed by same author @hejny as this package
+ *
+ * @public exported from `@promptbook/utils`
+ * @see https://github.com/hejny/spacetrim#usage
+ */
+const spaceTrim = spaceTrim$1;
+
 /**
  * @private util of `@promptbook/color`
  * @de
@@ -70,6 +83,7 @@ function take(initialValue) {
  * @public exported from `@promptbook/color`
  */
 const CSS_COLORS = {
+    promptbook: '#79EAFD',
     transparent: 'rgba(0,0,0,0)',
     aliceblue: '#f0f8ff',
     antiquewhite: '#faebd7',
@@ -251,9 +265,6 @@ function checkChannelValue(channelName, value) {
         throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
     }
 }
-/**
- * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
- */
 
 /**
  * Color object represents an RGB color with alpha channel
@@ -273,21 +284,61 @@ class Color {
      * @param color
      * @returns Color object
      */
-    static from(color) {
-        if (color instanceof Color) {
+    static from(color, _isSingleValue = false) {
+        if (color === '') {
+            throw new Error(`Can not create color from empty string`);
+        }
+        else if (color instanceof Color) {
             return take(color);
         }
         else if (Color.isColor(color)) {
             return take(color);
         }
         else if (typeof color === 'string') {
-            return Color.fromString(color);
+            try {
+                return Color.fromString(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                if (_isSingleValue) {
+                    throw error;
+                }
+                const parts = color.split(/[\s+,;|]/);
+                if (parts.length > 0) {
+                    return Color.from(parts[0].trim(), true);
+                }
+                else {
+                    throw new Error(`Can not create color from given string "${color}"`);
+                }
+            }
         }
         else {
             console.error({ color });
             throw new Error(`Can not create color from given object`);
         }
     }
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+     *
+     * @param color
+     * @returns Color object
+     */
+    static fromSafe(color) {
+        try {
+            return Color.from(color);
+        }
+        catch (error) {
+            // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+            console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+            return Color.fromString('promptbook');
+        }
+    }
     /**
      * Creates a new Color instance from miscellaneous string formats
      *
@@ -355,6 +406,9 @@ class Color {
         if (hex.length === 3) {
             return Color.fromHex3(hex);
         }
+        if (hex.length === 4) {
+            return Color.fromHex4(hex);
+        }
         if (hex.length === 6) {
             return Color.fromHex6(hex);
         }
@@ -375,6 +429,19 @@ class Color {
         const b = parseInt(hex.substr(2, 1), 16) * 16;
         return take(new Color(r, g, b));
     }
+    /**
+     * Creates a new Color instance from color in hex format with 4 digits (with alpha channel)
+     *
+     * @param color in hex for example `09df`
+     * @returns Color object
+     */
+    static fromHex4(hex) {
+        const r = parseInt(hex.substr(0, 1), 16) * 16;
+        const g = parseInt(hex.substr(1, 1), 16) * 16;
+        const b = parseInt(hex.substr(2, 1), 16) * 16;
+        const a = parseInt(hex.substr(3, 1), 16) * 16;
+        return take(new Color(r, g, b, a));
+    }
     /**
      * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
      *
@@ -565,7 +632,8 @@ class Color {
      * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
      */
     static isHexColorString(value) {
-        return typeof value === 'string' && /^#(?:[0-9a-fA-F]{3}){1,2}$/.test(value);
+        return (typeof value === 'string' &&
+            /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
     }
     /**
      * Creates new Color object
@@ -680,6 +748,23 @@ class Color {
  * TODO: Maybe connect with textures
  */
 
+/**
+ * Makes color transformer which returns a grayscale version of the color
+ *
+ * @param amount from 0 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+function grayscale(amount) {
+    return ({ red, green, blue, alpha }) => {
+        const average = (red + green + blue) / 3;
+        red = Math.round(average * amount + red * (1 - amount));
+        green = Math.round(average * amount + green * (1 - amount));
+        blue = Math.round(average * amount + blue * (1 - amount));
+        return Color.fromValues(red, green, blue, alpha);
+    };
+}
+
 /**
  * Converts HSL values to RGB values
  *
@@ -795,102 +880,6 @@ function lighten(amount) {
  * TODO: Maybe implement by mix+hsl
  */
 
-/**
- * Calculates distance between two colors
- *
- * @param color1 first color
- * @param color2 second color
- *
- * Note: This function is inefficient. Use colorDistanceSquared instead if possible.
- *
- * @public exported from `@promptbook/color`
- */
-/**
- * Calculates distance between two colors without square root
- *
- * @param color1 first color
- * @param color2 second color
- *
- * @public exported from `@promptbook/color`
- */
-function colorDistanceSquared(color1, color2) {
-    const rmean = (color1.red + color2.red) / 2;
-    const r = color1.red - color2.red;
-    const g = color1.green - color2.green;
-    const b = color1.blue - color2.blue;
-    const weightR = 2 + rmean / 256;
-    const weightG = 4.0;
-    const weightB = 2 + (255 - rmean) / 256;
-    const distance = weightR * r * r + weightG * g * g + weightB * b * b;
-    return distance;
-}
-
-/**
- * Makes color transformer which finds the nearest color from the given list
- *
- * @param colors array of colors to choose from
- *
- * @public exported from `@promptbook/color`
- */
-function nearest(...colors) {
-    return (color) => {
-        const distances = colors.map((c) => colorDistanceSquared(c, color));
-        const minDistance = Math.min(...distances);
-        const minIndex = distances.indexOf(minDistance);
-        const nearestColor = colors[minIndex];
-        return nearestColor;
-    };
-}
-
-/**
- * Color transformer which returns the negative color
- *
- * @public exported from `@promptbook/color`
- */
-function negative(color) {
-    const r = 255 - color.red;
-    const g = 255 - color.green;
-    const b = 255 - color.blue;
-    return Color.fromValues(r, g, b, color.alpha);
-}
-
-/**
- * Makes color transformer which finds the furthest color from the given list
- *
- * @param colors array of colors to choose from
- *
- * @public exported from `@promptbook/color`
- */
-function furthest(...colors) {
-    return (color) => {
-        const furthestColor = negative(nearest(...colors.map(negative))(color));
-        return furthestColor;
-    };
-}
-/**
- * Makes color transformer which finds the best text color (black or white) for the given background color
- *
- * @public exported from `@promptbook/color`
- */
-furthest(Color.get('white'), Color.from('black'));
-
-/**
- * Makes color transformer which returns a grayscale version of the color
- *
- * @param amount from 0 to 1
- *
- * @public exported from `@promptbook/color`
- */
-function grayscale(amount) {
-    return ({ red, green, blue, alpha }) => {
-        const average = (red + green + blue) / 3;
-        red = Math.round(average * amount + red * (1 - amount));
-        green = Math.round(average * amount + green * (1 - amount));
-        blue = Math.round(average * amount + blue * (1 - amount));
-        return Color.fromValues(red, green, blue, alpha);
-    };
-}
-
 /**
  * Makes color transformer which saturate the given color
  *
@@ -939,16 +928,32 @@ const ADMIN_GITHUB_NAME = 'hejny';
  *
  * @public exported from `@promptbook/core`
  */
-const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
-// <- TODO: [🧠] Using `Color` here increases the package size approx 3kb, maybe remove it
+const PROMPTBOOK_COLOR = Color.fromString('promptbook');
+// <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
 /**
- * Dark color of the Promptbook
+ * Colors for syntax highlighting in the `<BookEditor/>`
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+({
+    TITLE: Color.fromHex('#244EA8'),
+    LINE: Color.fromHex('#eeeeee'),
+    SEPARATOR: Color.fromHex('#cccccc'),
+    COMMITMENT: Color.fromHex('#DA0F78'),
+    PARAMETER: Color.fromHex('#8e44ad'),
+});
+// <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
+/**
+ * Chat color of the Promptbook (in chat)
  *
  * TODO: [🗽] Unite branding and make single place for it
  *
  * @public exported from `@promptbook/core`
  */
 PROMPTBOOK_COLOR.then(lighten(0.1)).then(saturate(0.9)).then(grayscale(0.9));
+// <- TODO: [🧠][🈵] Using `Color` and `lighten`, `saturate`,... here increases the package size approx 3kb, maybe remove it
 /**
  * Color of the user (in chat)
  *
@@ -1059,7 +1064,7 @@ function $deepFreeze(objectValue) {
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$1((block) => `
+        body: spaceTrim$2((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1102,7 +1107,7 @@ function getErrorReportUrl(error) {
  */
 class UnexpectedError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1128,7 +1133,7 @@ class WrappedError extends Error {
     constructor(whatWasThrown) {
         const tag = `[🤮]`;
         console.error(tag, whatWasThrown);
-        super(spaceTrim$2(`
+        super(spaceTrim$1(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1217,7 +1222,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1236,7 +1241,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1259,7 +1264,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim$1((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1291,7 +1296,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -1321,7 +1326,7 @@ function deepClone(objectValue) {
     TODO: [🧠] Is there a better implementation?
     > const propertyNames = Object.getOwnPropertyNames(objectValue);
     > for (const propertyName of propertyNames) {
-    >     const value = (objectValue as really_any)[propertyName];
+    >     const value = (objectValue as chococake)[propertyName];
     >     if (value && typeof value === 'object') {
     >         deepClone(value);
     >     }
@@ -1412,6 +1417,8 @@ const RESERVED_PARAMETER_NAMES = exportJson({
 /**
  * Normalizes a given text to camelCase format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text to be normalized.
  * @param _isFirstLetterCapital Whether the first letter should be capitalized.
  * @returns The camelCase formatted string.
@@ -1813,6 +1820,8 @@ function removeDiacritics(input) {
 /**
  * Converts a given text to kebab-case format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text to be converted.
  * @returns The kebab-case formatted string.
  * @example 'hello-world'
@@ -1882,6 +1891,8 @@ function removeEmojis(text) {
 /**
  * Converts a title string into a normalized name.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param value The title string to be converted to a name.
  * @returns A normalized name derived from the input title.
  * @example 'Hello World!' -> 'hello-world'
@@ -1969,7 +1980,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
         .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
         .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
         .join('\n');
-    const promptbookMermaid = spaceTrim$2((block) => `
+    const promptbookMermaid = spaceTrim$1((block) => `
 
             %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
 
@@ -2067,6 +2078,22 @@ class CollectionError extends Error {
     }
 }
 
+/**
+ * This error indicates error from the database
+ *
+ * @public exported from `@promptbook/core`
+ */
+class DatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DatabaseError';
+        Object.setPrototypeOf(this, DatabaseError.prototype);
+    }
+}
+/**
+ * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
+ */
+
 /**
  * This error type indicates that you try to use a feature that is not available in the current environment
  *
@@ -2129,7 +2156,7 @@ class LimitReachedError extends Error {
  */
 class MissingToolsError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -2140,6 +2167,19 @@ class MissingToolsError extends Error {
     }
 }
 
+/**
+ * This error indicates that promptbook operation is not allowed
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotAllowed extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotAllowed';
+        Object.setPrototypeOf(this, NotAllowed.prototype);
+    }
+}
+
 /**
  * This error indicates that promptbook not found in the collection
  *
@@ -2160,7 +2200,7 @@ class NotFoundError extends Error {
  */
 class NotYetImplementedError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -2195,6 +2235,7 @@ class ParseError extends Error {
 /**
  * Generates random token
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
  * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
  *
  * @private internal helper function
@@ -2204,6 +2245,7 @@ function $randomToken(randomness) {
     return randomBytes(randomness).toString('hex');
 }
 /**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
  */
 
@@ -2289,6 +2331,8 @@ const PROMPTBOOK_ERRORS = {
     PromptbookFetchError,
     UnexpectedError,
     WrappedError,
+    NotAllowed,
+    DatabaseError,
     // TODO: [🪑]> VersionMismatchError,
 };
 /**
@@ -2341,7 +2385,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim$1((block) => `
+        message = spaceTrim$2((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -2362,7 +2406,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$1((block) => `
+        console.error(spaceTrim$2((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -2468,7 +2512,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim$1(`
+        throw new Error(spaceTrim$2(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -2482,7 +2526,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim$1((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -2682,7 +2726,7 @@ function templateParameters(template, parameters) {
  */
 function prompt(strings, ...values) {
     if (values.length === 0) {
-        return spaceTrim$1(strings.join(''));
+        return spaceTrim$2(strings.join(''));
     }
     const stringsWithHiddenParameters = strings.map((stringsItem) => 
     // TODO: [0] DRY
@@ -2693,7 +2737,7 @@ function prompt(strings, ...values) {
     let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
         ? `${result}${stringsItem}`
         : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
-    pipelineString = spaceTrim$1(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     try {
         pipelineString = templateParameters(pipelineString, parameters);
     }
@@ -2702,7 +2746,7 @@ function prompt(strings, ...values) {
             throw error;
         }
         console.error({ pipelineString, parameters, placeholderParameterNames, error });
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Internal error in prompt template literal
                   
                     ${block(JSON.stringify({ strings, values }, null, 4))}}
@@ -2810,6 +2854,25 @@ const $isRunningInWebWorker = new Function(`
  * TODO: [🎺]
  */
 
+/**
+ * Returns information about the current runtime environment
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environments
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function $detectRuntimeEnvironment() {
+    return {
+        isRunningInBrowser: $isRunningInBrowser(),
+        isRunningInJest: $isRunningInJest(),
+        isRunningInNode: $isRunningInNode(),
+        isRunningInWebWorker: $isRunningInWebWorker(),
+    };
+}
+/**
+ * TODO: [🎺] Also detect and report node version here
+ */
+
 /**
  * Number of characters per standard line with 11pt Arial font size.
  *
@@ -2854,10 +2917,13 @@ function countCharacters(text) {
  * @public exported from `@promptbook/utils`
  */
 function countLines(text) {
+    if (text === '') {
+        return 0;
+    }
     text = text.replace('\r\n', '\n');
     text = text.replace('\r', '\n');
     const lines = text.split('\n');
-    return lines.reduce((count, line) => count + Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 0);
+    return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
 }
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
@@ -2961,6 +3027,18 @@ function $getCurrentDate() {
     return new Date().toISOString();
 }
 
+/**
+ * Computes SHA-256 hash of the given object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function computeHash(value) {
+    return SHA256(hexEncoder.parse(spaceTrim$2(valueToString(value)))).toString( /* hex */);
+}
+/**
+ * TODO: [🥬][🥬] Use this ACRY
+ */
+
 /**
  * @public exported from `@promptbook/utils`
  */
@@ -3187,6 +3265,21 @@ function nameToUriParts(name) {
 }
 
 /**
+ * Normalizes message text for comparison
+ *
+ * @param text The message text to normalize
+ * @returns The normalized message text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeMessageText(text) {
+    return spaceTrim$1(text);
+}
+
+/**
+ * Normalizes a given text to PascalCase format.
+ *
+ * Note: [🔂] This function is idempotent.
  *
  * @param text @public exported from `@promptbook/utils`
  * @returns
@@ -3330,7 +3423,7 @@ function unwrapResult(text, options) {
     let trimmedText = text;
     // Remove leading and trailing spaces and newlines
     if (isTrimmed) {
-        trimmedText = spaceTrim$2(trimmedText);
+        trimmedText = spaceTrim$1(trimmedText);
     }
     let processedText = trimmedText;
     if (isIntroduceSentenceRemoved) {
@@ -3339,7 +3432,7 @@ function unwrapResult(text, options) {
             // Remove the introduce sentence and quotes by replacing it with an empty string
             processedText = processedText.replace(introduceSentenceRegex, '');
         }
-        processedText = spaceTrim$2(processedText);
+        processedText = spaceTrim$1(processedText);
     }
     if (processedText.length < 3) {
         return trimmedText;
@@ -3383,17 +3476,6 @@ function unwrapResult(text, options) {
  * TODO: [🧠] Should this also unwrap the (parenthesis)
  */
 
-/**
- * Trims string from all 4 sides
- *
- * Note: This is a re-exported function from the `spacetrim` package which is
- *       Developed by same author @hejny as this package
- *
- * @public exported from `@promptbook/utils`
- * @see https://github.com/hejny/spacetrim#usage
- */
-const spaceTrim = spaceTrim$2;
-
 /**
  * Parses the task and returns the list of all parameter names
  *
@@ -3531,7 +3613,7 @@ function serializeToPromptbookJavascript(value) {
         imports.push(`import { Color } from '@promptbook/color';`);
     }
     else if (typeof value === 'string') {
-        const trimmed = spaceTrim$1(value);
+        const trimmed = spaceTrim$2(value);
         if (trimmed.includes('\n')) {
             // Multiline string -> use `spaceTrim`
             serializedValue = `spaceTrim(\`\n${value.replace(/`/g, '\\`')}\n\`)`;
@@ -3816,5 +3898,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);
 }
 
-export { $deepFreeze, $getCurrentDate, $isRunningInBrowser, $isRunningInJest, $isRunningInNode, $isRunningInWebWorker, BOOK_LANGUAGE_VERSION, CHARACTERS_PER_STANDARD_LINE, CountUtils, DIACRITIC_VARIANTS_LETTERS, LINES_PER_STANDARD_PAGE, PROMPTBOOK_ENGINE_VERSION, SMALL_NUMBER, VALUE_STRINGS, capitalize, checkSerializableAsJson, clonePipeline, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, debounce, decapitalize, deepClone, deserializeError, difference, exportJson, extractParameterNames, forEachAsync, intersection, isHostnameOnPrivateNetwork, isRootPath, isSerializableAsJson, isUrlOnPrivateNetwork, isValidCsvString, isValidEmail, isValidFilePath, isValidJavascriptName, isValidJsonString, isValidKeyword, isValidPipelineUrl, isValidPromptbookVersion, isValidSemanticVersion, isValidUrl, isValidUuid, isValidXmlString, jsonParse, jsonStringsToJsons, nameToUriPart, nameToUriParts, normalizeToKebabCase, normalizeTo_PascalCase, normalizeTo_SCREAMING_CASE, normalizeTo_camelCase, normalizeTo_snake_case, normalizeWhitespaces, numberToString, orderJson, parseKeywords, parseKeywordsFromString, parseNumber, prompt, promptTemplate, removeDiacritics, removeEmojis, removeQuotes, renderPromptbookMermaid, searchKeywords, serializeError, serializeToPromptbookJavascript, spaceTrim, splitIntoSentences, suffixUrl, templateParameters, titleToName, union, unwrapResult, valueToString };
+export { $deepFreeze, $detectRuntimeEnvironment, $getCurrentDate, $isRunningInBrowser, $isRunningInJest, $isRunningInNode, $isRunningInWebWorker, BOOK_LANGUAGE_VERSION, CHARACTERS_PER_STANDARD_LINE, CountUtils, DIACRITIC_VARIANTS_LETTERS, LINES_PER_STANDARD_PAGE, PROMPTBOOK_ENGINE_VERSION, SMALL_NUMBER, VALUE_STRINGS, capitalize, checkSerializableAsJson, clonePipeline, computeHash, countCharacters, countLines, countPages, countParagraphs, countSentences, countWords, debounce, decapitalize, deepClone, deserializeError, difference, exportJson, extractParameterNames, forEachAsync, intersection, isHostnameOnPrivateNetwork, isRootPath, isSerializableAsJson, isUrlOnPrivateNetwork, isValidCsvString, isValidEmail, isValidFilePath, isValidJavascriptName, isValidJsonString, isValidKeyword, isValidPipelineUrl, isValidPromptbookVersion, isValidSemanticVersion, isValidUrl, isValidUuid, isValidXmlString, jsonParse, jsonStringsToJsons, nameToUriPart, nameToUriParts, normalizeMessageText, normalizeToKebabCase, normalizeTo_PascalCase, normalizeTo_SCREAMING_CASE, normalizeTo_camelCase, normalizeTo_snake_case, normalizeWhitespaces, numberToString, orderJson, parseKeywords, parseKeywordsFromString, parseNumber, prompt, promptTemplate, removeDiacritics, removeEmojis, removeQuotes, renderPromptbookMermaid, searchKeywords, serializeError, serializeToPromptbookJavascript, spaceTrim, splitIntoSentences, suffixUrl, templateParameters, titleToName, union, unwrapResult, valueToString };
 //# sourceMappingURL=index.es.js.map