@promptbook/editable 0.111.0-7 → 0.112.0-100

package/umd/index.umd.js

@@ -1,12 +1,11 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('papaparse'), require('crypto-js'), require('crypto-js/enc-hex')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'papaparse', 'crypto-js', 'crypto-js/enc-hex'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-editable"] = {}, global.spaceTrim$1, global.papaparse, global.cryptoJs, global.hexEncoder));
-})(this, (function (exports, spaceTrim$1, papaparse, cryptoJs, hexEncoder) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-editable"] = {}, global.spacetrim, global.papaparse, global.cryptoJs, global.hexEncoder));
+})(this, (function (exports, spacetrim, papaparse, cryptoJs, hexEncoder) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -23,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-7';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-100';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -33,16 +32,20 @@
      * 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
+     * Developed by same author @hejny as this package
      *
-     * @public exported from `@promptbook/utils`
      * @see https://github.com/hejny/spacetrim#usage
+     *
+     * @public exported from `@promptbook/utils`
      */
-    const spaceTrim = spaceTrim$1.spaceTrim;
+    const spaceTrim = spacetrim.spaceTrim;
 
     /**
-     * @private util of `@promptbook/color`
+     * Class implementing take chain.
+     *
      * @de
+     *
+     * @private util of `@promptbook/color`
      */
     class TakeChain {
         constructor(value) {
@@ -59,9 +62,9 @@
      *
      * @param {*} initialValue - The initial value.
      * @returns {Proxy<WithTake<TValue>>} - A proxy object with a `take` method.
+     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      *
      * @private util of `@promptbook/color`
-     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      */
     function take(initialValue) {
         if (initialValue instanceof TakeChain) {
@@ -239,9 +242,7 @@
         yellow: '#ffff00',
         yellowgreen: '#9acd32',
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Validates that a channel value is a valid number within the range of 0 to 255.
@@ -271,7 +272,118 @@
         }
     }
 
+    /**
+     * Shared immutable channel storage and serialization helpers for `Color`.
+     *
+     * @private base class of Color
+     */
+    class ColorValue {
+        constructor(red, green, blue, alpha = 255) {
+            this.red = red;
+            this.green = green;
+            this.blue = blue;
+            this.alpha = alpha;
+            checkChannelValue('Red', red);
+            checkChannelValue('Green', green);
+            checkChannelValue('Blue', blue);
+            checkChannelValue('Alpha', alpha);
+        }
+        /**
+         * Shortcut for `red` property
+         * Number from 0 to 255
+         * @alias red
+         */
+        get r() {
+            return this.red;
+        }
+        /**
+         * Shortcut for `green` property
+         * Number from 0 to 255
+         * @alias green
+         */
+        get g() {
+            return this.green;
+        }
+        /**
+         * Shortcut for `blue` property
+         * Number from 0 to 255
+         * @alias blue
+         */
+        get b() {
+            return this.blue;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get a() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get opacity() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for 1-`alpha` property
+         */
+        get transparency() {
+            return 255 - this.alpha;
+        }
+        clone() {
+            return take(this.createColor(this.red, this.green, this.blue, this.alpha));
+        }
+        toString() {
+            return this.toHex();
+        }
+        toHex() {
+            if (this.alpha === 255) {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}`;
+            }
+            else {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}${this.alpha.toString(16).padStart(2, '0')}`;
+            }
+        }
+        toRgb() {
+            if (this.alpha === 255) {
+                return `rgb(${this.red}, ${this.green}, ${this.blue})`;
+            }
+            else {
+                return `rgba(${this.red}, ${this.green}, ${this.blue}, ${Math.round((this.alpha / 255) * 100)}%)`;
+            }
+        }
+        toHsl() {
+            throw new Error(`Getting HSL is not implemented`);
+        }
+    }
+
+    /**
+     * Checks if the given value is a valid hex color string
+     *
+     * @param value - value to check
+     * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
+     *
+     * @private function of Color
+     */
+    function isHexColorString(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));
+    }
+
+    /**
+     * Constant for short hex lengths.
+     */
     const SHORT_HEX_LENGTHS = new Set([3, 4]);
+    /**
+     * Constant for long hex lengths.
+     */
     const LONG_HEX_LENGTHS = new Set([6, 8]);
     /**
      * Parses a hex string into RGBA channel values.
@@ -304,6 +416,9 @@
         }
         return throwInvalidHex();
     }
+    /**
+     * Parses short hex channel.
+     */
     function parseShortHexChannel(char, onError) {
         if (!char) {
             return onError();
@@ -314,6 +429,9 @@
         }
         return parsed * 16;
     }
+    /**
+     * Parses long hex channel.
+     */
     function parseLongHexChannel(hex, start, onError) {
         const segment = hex.substr(start, 2);
         if (segment.length < 2) {
@@ -326,6 +444,9 @@
         return parsed;
     }
 
+    /**
+     * Pattern matching hsl.
+     */
     const HSL_REGEX = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
     /**
      * Parses an HSL string into RGBA channel values.
@@ -351,6 +472,9 @@
             alpha: 255,
         };
     }
+    /**
+     * Handles convert hsl to Rgb.
+     */
     function convertHslToRgb(h, s, l) {
         const c = (1 - Math.abs(2 * l - 1)) * s;
         const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
@@ -389,7 +513,13 @@
         };
     }
 
+    /**
+     * Pattern matching RGB.
+     */
     const RGB_REGEX = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba.
+     */
     const RGBA_REGEX = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
     /**
      * Parses an RGB string into RGBA channel values.
@@ -431,6 +561,9 @@
             alpha: parseAlphaValue(match[4]),
         };
     }
+    /**
+     * Parses channel value.
+     */
     function parseChannelValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -438,6 +571,9 @@
         }
         return Math.round(parseFloat(value));
     }
+    /**
+     * Parses alpha value.
+     */
     function parseAlphaValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -450,9 +586,55 @@
         return Math.round(parsed);
     }
 
+    /**
+     * Pattern matching hsl regex.
+     *
+     * @private function of Color
+     */
     const HSL_REGEX_PATTERN = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+    /**
+     * Pattern matching RGB regex.
+     *
+     * @private function of Color
+     */
     const RGB_REGEX_PATTERN = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba regex.
+     *
+     * @private function of Color
+     */
     const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Parses a supported color string into RGBA channels.
+     *
+     * @param color as a string for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`, `red`, `darkgrey`,...
+     * @returns RGBA channel values.
+     *
+     * @private function of Color
+     */
+    function parseColorString(color) {
+        const trimmed = color.trim();
+        const cssColor = CSS_COLORS[trimmed];
+        if (cssColor) {
+            return parseColorString(cssColor);
+        }
+        else if (isHexColorString(trimmed)) {
+            return parseHexColor(trimmed);
+        }
+        if (HSL_REGEX_PATTERN.test(trimmed)) {
+            return parseHslColor(trimmed);
+        }
+        else if (RGB_REGEX_PATTERN.test(trimmed)) {
+            return parseRgbColor(trimmed);
+        }
+        else if (RGBA_REGEX_PATTERN.test(trimmed)) {
+            return parseRgbaColor(trimmed);
+        }
+        else {
+            throw new Error(`Can not create a new Color instance from string "${trimmed}".`);
+        }
+    }
+
     /**
      * Color object represents an RGB color with alpha channel
      *
@@ -460,7 +642,7 @@
      *
      * @public exported from `@promptbook/color`
      */
-    class Color {
+    class Color extends ColorValue {
         /**
          * Creates a new Color instance from miscellaneous formats
          * - It can receive Color instance and just return the same instance
@@ -533,25 +715,7 @@
          * @returns Color object
          */
         static fromString(color) {
-            const trimmed = color.trim();
-            if (CSS_COLORS[trimmed]) {
-                return Color.fromString(CSS_COLORS[trimmed]);
-            }
-            else if (Color.isHexColorString(trimmed)) {
-                return Color.fromHex(trimmed);
-            }
-            if (HSL_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromHsl(trimmed);
-            }
-            else if (RGB_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromRgbString(trimmed);
-            }
-            else if (RGBA_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromRgbaString(trimmed);
-            }
-            else {
-                throw new Error(`Can not create a new Color instance from string "${trimmed}".`);
-            }
+            return Color.fromColorChannels(parseColorString(color));
         }
         /**
          * Gets common color
@@ -581,8 +745,7 @@
          * @returns Color object
          */
         static fromHex(hex) {
-            const { red, green, blue, alpha } = parseHexColor(hex);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseHexColor(hex));
         }
         /**
          * Creates a new Color instance from color in hsl format
@@ -591,8 +754,7 @@
          * @returns Color object
          */
         static fromHsl(hsl) {
-            const { red, green, blue, alpha } = parseHslColor(hsl);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseHslColor(hsl));
         }
         /**
          * Creates a new Color instance from color in rgb format
@@ -601,8 +763,7 @@
          * @returns Color object
          */
         static fromRgbString(rgb) {
-            const { red, green, blue, alpha } = parseRgbColor(rgb);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseRgbColor(rgb));
         }
         /**
          * Creates a new Color instance from color in rbga format
@@ -611,8 +772,7 @@
          * @returns Color object
          */
         static fromRgbaString(rgba) {
-            const { red, green, blue, alpha } = parseRgbaColor(rgba);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseRgbaColor(rgba));
         }
         /**
          * Creates a new Color for color channels values
@@ -624,7 +784,7 @@
          * @returns Color object
          */
         static fromValues(red, green, blue, alpha = 255) {
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels({ red, green, blue, alpha });
         }
         /**
          * Checks if the given value is a valid Color object.
@@ -657,8 +817,7 @@
          * @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}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
+            return isHexColorString(value);
         }
         /**
          * Creates new Color object
@@ -671,91 +830,13 @@
          * @param alpha number from 0 (transparent) to 255 (opaque)
          */
         constructor(red, green, blue, alpha = 255) {
-            this.red = red;
-            this.green = green;
-            this.blue = blue;
-            this.alpha = alpha;
-            checkChannelValue('Red', red);
-            checkChannelValue('Green', green);
-            checkChannelValue('Blue', blue);
-            checkChannelValue('Alpha', alpha);
+            super(red, green, blue, alpha);
         }
-        /**
-         * Shortcut for `red` property
-         * Number from 0 to 255
-         * @alias red
-         */
-        get r() {
-            return this.red;
-        }
-        /**
-         * Shortcut for `green` property
-         * Number from 0 to 255
-         * @alias green
-         */
-        get g() {
-            return this.green;
-        }
-        /**
-         * Shortcut for `blue` property
-         * Number from 0 to 255
-         * @alias blue
-         */
-        get b() {
-            return this.blue;
-        }
-        /**
-         * Shortcut for `alpha` property
-         * Number from 0 (transparent) to 255 (opaque)
-         * @alias alpha
-         */
-        get a() {
-            return this.alpha;
-        }
-        /**
-         * Shortcut for `alpha` property
-         * Number from 0 (transparent) to 255 (opaque)
-         * @alias alpha
-         */
-        get opacity() {
-            return this.alpha;
+        createColor(red, green, blue, alpha) {
+            return new Color(red, green, blue, alpha);
         }
-        /**
-         * Shortcut for 1-`alpha` property
-         */
-        get transparency() {
-            return 255 - this.alpha;
-        }
-        clone() {
-            return take(new Color(this.red, this.green, this.blue, this.alpha));
-        }
-        toString() {
-            return this.toHex();
-        }
-        toHex() {
-            if (this.alpha === 255) {
-                return `#${this.red.toString(16).padStart(2, '0')}${this.green
-                .toString(16)
-                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}`;
-            }
-            else {
-                return `#${this.red.toString(16).padStart(2, '0')}${this.green
-                .toString(16)
-                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}${this.alpha
-                .toString(16)
-                .padStart(2, '0')}`;
-            }
-        }
-        toRgb() {
-            if (this.alpha === 255) {
-                return `rgb(${this.red}, ${this.green}, ${this.blue})`;
-            }
-            else {
-                return `rgba(${this.red}, ${this.green}, ${this.blue}, ${Math.round((this.alpha / 255) * 100)}%)`;
-            }
-        }
-        toHsl() {
-            throw new Error(`Getting HSL is not implemented`);
+        static fromColorChannels({ red, green, blue, alpha }) {
+            return take(new Color(red, green, blue, alpha));
         }
     }
 
@@ -819,9 +900,7 @@
         }
         return [Math.round(red * 255), Math.round(green * 255), Math.round(blue * 255)];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Converts RGB values to HSL values
@@ -867,9 +946,7 @@
         }
         return [hue, saturation, lightness];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Makes color transformer which lighten the given color
@@ -887,9 +964,7 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
-    /**
-     * TODO: Maybe implement by mix+hsl
-     */
+    // TODO: Maybe implement by mix+hsl
 
     /**
      * Makes color transformer which saturate the given color
@@ -907,9 +982,36 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
+    // TODO: Maybe implement by mix+hsl
+
+    /**
+     * Stable root directory used for Promptbook-owned temporary files and caches.
+     *
+     * @private internal utility for Promptbook temporary folders
+     */
+    const PROMPTBOOK_TEMPORARY_DIRECTORY = '.promptbook';
+    /**
+     * Builds one normalized project-relative path inside Promptbook's dedicated temporary root.
+     *
+     * The returned path intentionally uses `/` separators so the same helper can be reused from
+     * Node.js and edge-safe code without depending on the Node `path` module.
+     *
+     * @private internal utility for Promptbook temporary folders
+     */
+    function getPromptbookTemporaryPath(...pathSegments) {
+        const normalizedPathSegments = pathSegments.flatMap(splitPathSegments).filter(Boolean);
+        return [PROMPTBOOK_TEMPORARY_DIRECTORY, ...normalizedPathSegments].join('/');
+    }
     /**
-     * TODO: Maybe implement by mix+hsl
+     * Normalizes one raw path segment into slash-delimited pieces without empty items.
      */
+    function splitPathSegments(pathSegment) {
+        return pathSegment
+            .split(/[\\/]+/u)
+            .map((segment) => segment.trim())
+            .filter(Boolean);
+    }
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Returns the same value that is passed as argument.
@@ -922,6 +1024,7 @@
      *
      * @param value any values
      * @returns the same values
+     *
      * @private within the repository
      */
     function just(value) {
@@ -973,6 +1076,9 @@
         LINE: Color.fromHex('#eeeeee'),
         SEPARATOR: Color.fromHex('#cccccc'),
         COMMITMENT: Color.fromHex('#DA0F78'),
+        NOTE_COMMITMENT: Color.fromHex('#8080807e'),
+        TODO_COMMITMENT_TEXT: Color.fromHex('#000000'),
+        TODO_COMMITMENT_BACKGROUND: Color.fromHex('#FFEB3B'),
         PARAMETER: Color.fromHex('#8e44ad'),
         CODE_BLOCK: Color.fromHex('#7700ffff'),
     });
@@ -1000,7 +1106,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
+    const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
     /**
      * When the pipeline is flat and no name of return parameter is provided, this name is used
      *
@@ -1014,6 +1120,31 @@
      * @private within the repository - too low-level in comparison with other `MAX_...`
      */
     const LOOP_LIMIT = 1000;
+    // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
+    /**
+     * Where to store the temporary downloads
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('download-cache')}`;
+    /**
+     * Where to store the cache of executions for promptbook CLI
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('execution-cache')}`;
+    /**
+     * Where to store the scrape cache
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('scrape-cache')}`;
     // <- TODO: [🧜‍♂️]
     /**
      * Default settings for parsing and generating CSV files in Promptbook.
@@ -1046,7 +1177,7 @@
     function getErrorReportUrl(error) {
         const report = {
             title: `🐜 Error report from ${NAME}`,
-            body: spaceTrim__default["default"]((block) => `
+            body: spacetrim.spaceTrim((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1089,7 +1220,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim$1.spaceTrim((block) => `
+            super(spacetrim.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1118,9 +1249,7 @@
             Object.setPrototypeOf(this, ParseError.prototype);
         }
     }
-    /**
-     * TODO: Maybe split `ParseError` and `ApplyError`
-     */
+    // TODO: Maybe split `ParseError` and `ApplyError`
 
     /**
      * Parses the boilerplate command
@@ -1128,6 +1257,7 @@
      * Note: @@ This command is used as boilerplate for new commands - it should NOT be used in any `.book` file
      *
      * @see `documentationUrl` for more details
+     *
      * @private within the commands folder
      */
     const boilerplateCommandParser = {
@@ -1222,7 +1352,7 @@
      */
     class NotYetImplementedError extends Error {
         constructor(message) {
-            super(spaceTrim$1.spaceTrim((block) => `
+            super(spacetrim.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -1261,12 +1391,13 @@
      * 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 similar functions:
      * - `isValidSemanticVersion` which tests any semantic version
      * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
      *
+     * @see https://www.npmjs.com/package/promptbook?activeTab=versions
+     *
      * @public exported from `@promptbook/utils`
      */
     function isValidPromptbookVersion(version) {
@@ -1284,6 +1415,7 @@
      * Parses the BOOK_VERSION command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const bookVersionCommandParser = {
@@ -1365,7 +1497,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim$1.spaceTrim(`
+            super(spacetrim.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1408,12 +1540,11 @@
      * Units of text measurement
      *
      * @see https://github.com/webgptorg/promptbook/discussions/30
+     *
      * @public exported from `@promptbook/core`
      */
     const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
-    /**
-     * TODO: [💝] Unite object for expecting amount and format - remove format
-     */
+    // TODO: [💝] Unite object for expecting amount and format - remove format
 
     /**
      * Function parseNumber will parse number from string
@@ -1482,17 +1613,16 @@
         }
         return num;
     }
-    /**
-     * 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`
-     */
+    // 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`
 
     /**
-    import { WrappedError } from '../../errors/WrappedError';
-    import { assertsError } from '../../errors/assertsError';
+     * import { WrappedError } from '../../errors/WrappedError';
+     * import { assertsError } from '../../errors/assertsError';
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const expectCommandParser = {
@@ -1508,7 +1638,7 @@
         /**
          * Description of the FORMAT command
          */
-        description: spaceTrim__default["default"](`
+        description: spacetrim.spaceTrim(`
         Expect command describes the desired output of the task *(after post-processing)*
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -1582,7 +1712,7 @@
             }
             catch (error) {
                 assertsError(error);
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
                         `));
@@ -1712,8 +1842,9 @@
     /**
      * Definition for CSV spreadsheet
      *
+     * TODO: [🏢] Export from package `@promptbook/csv`
+     *
      * @public exported from `@promptbook/core`
-     *                          <- TODO: [🏢] Export from package `@promptbook/csv`
      */
     const CsvFormatParser = {
         formatName: 'CSV',
@@ -1734,7 +1865,7 @@
                     const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                     const csv = csvParse(value, settings);
                     if (csv.errors.length !== 0) {
-                        throw new CsvFormatError(spaceTrim__default["default"]((block) => `
+                        throw new CsvFormatError(spacetrim.spaceTrim((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -1779,7 +1910,7 @@
                     const { value, settings, mapCallback, onProgress } = options;
                     const csv = csvParse(value, settings);
                     if (csv.errors.length !== 0) {
-                        throw new CsvFormatError(spaceTrim__default["default"]((block) => `
+                        throw new CsvFormatError(spacetrim.spaceTrim((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -1803,13 +1934,11 @@
             },
         ],
     };
-    /**
-     * TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
-     * TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
-     * TODO: [🍓] In `CsvFormatParser` implement `heal
-     * TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
-     * TODO: [🏢] Allow to expect something inside CSV objects and other formats
-     */
+    // TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
+    // TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
+    // TODO: [🍓] In `CsvFormatParser` implement `heal
+    // TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
+    // TODO: [🏢] Allow to expect something inside CSV objects and other formats
 
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
@@ -1852,17 +1981,15 @@
         },
         subvalueParsers: [],
     };
-    /**
-     * TODO: [🧠] Maybe proper instance of object
-     * TODO: [0] Make string_serialized_json
-     * TODO: [1] Make type for JSON Settings and Schema
-     * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
-     * TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
-     * TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
-     * TODO: [🍓] In `JsonFormatParser` implement `heal
-     * TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
-     * TODO: [🏢] Allow to expect something inside JSON objects and other formats
-     */
+    // TODO: [🧠] Maybe proper instance of object
+    // TODO: [0] Make string_serialized_json
+    // TODO: [1] Make type for JSON Settings and Schema
+    // TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
+    // TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
+    // TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
+    // TODO: [🍓] In `JsonFormatParser` implement `heal
+    // TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
+    // TODO: [🏢] Allow to expect something inside JSON objects and other formats
 
     /**
      * Definition for any text - this will be always valid
@@ -1900,15 +2027,13 @@
             // <- TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
         ],
     };
-    /**
-     * TODO: [1] Make type for XML Text and Schema
-     * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
-     * TODO: [🍓] In `TextFormatParser` implement simple `isValid`
-     * TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
-     * TODO: [🍓] In `TextFormatParser` implement `heal
-     * TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
-     * TODO: [🏢] Allow to expect something inside each item of list and other formats
-     */
+    // TODO: [1] Make type for XML Text and Schema
+    // TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
+    // TODO: [🍓] In `TextFormatParser` implement simple `isValid`
+    // TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
+    // TODO: [🍓] In `TextFormatParser` implement `heal
+    // TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
+    // TODO: [🏢] Allow to expect something inside each item of list and other formats
 
     /**
      * Function to check if a string is valid XML
@@ -1953,17 +2078,15 @@
         },
         subvalueParsers: [],
     };
-    /**
-     * TODO: [🧠] Maybe proper instance of object
-     * TODO: [0] Make string_serialized_xml
-     * TODO: [1] Make type for XML Settings and Schema
-     * TODO: [🧠] What to use for validating XMLs - XSD,...
-     * TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
-     * TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
-     * TODO: [🍓] In `XmlFormatParser` implement `heal
-     * TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
-     * TODO: [🏢] Allow to expect something inside XML and other formats
-     */
+    // TODO: [🧠] Maybe proper instance of object
+    // TODO: [0] Make string_serialized_xml
+    // TODO: [1] Make type for XML Settings and Schema
+    // TODO: [🧠] What to use for validating XMLs - XSD,...
+    // TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
+    // TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
+    // TODO: [🍓] In `XmlFormatParser` implement `heal
+    // TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
+    // TODO: [🏢] Allow to expect something inside XML and other formats
 
     /**
      * Definitions for all formats supported by Promptbook
@@ -1971,9 +2094,7 @@
      * @private internal index of `...` <- TODO [🏢]
      */
     const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser, CsvFormatParser];
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
@@ -1984,6 +2105,7 @@
      * @returns The normalized text in SCREAMING_CASE format.
      * @example 'HELLO_WORLD'
      * @example 'I_LOVE_PROMPTBOOK'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_SCREAMING_CASE(text) {
@@ -2036,6 +2158,7 @@
      * Orders JSON object by keys
      *
      * @returns The same type of object as the input re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function orderJson(options) {
@@ -2054,6 +2177,7 @@
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
      *
      * @returns The same object as the input, but deeply frozen
+     *
      * @public exported from `@promptbook/utils`
      */
     function $deepFreeze(objectValue) {
@@ -2070,9 +2194,7 @@
         Object.freeze(objectValue);
         return objectValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Checks if the value is [🚉] serializable as JSON
@@ -2092,125 +2214,187 @@
      * - And much more...
      *
      * @throws UnexpectedError if the value is not serializable as JSON
+     *
      * @public exported from `@promptbook/utils`
      */
     function checkSerializableAsJson(options) {
-        const { value, name, message } = options;
+        checkSerializableValue(options);
+    }
+    // TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
+    // TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+    // Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+    /**
+     * Checks one value and dispatches to the appropriate specialized validator.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableValue(options) {
+        const { value } = options;
+        if (isSerializablePrimitive(value)) {
+            return;
+        }
         if (value === undefined) {
-            throw new UnexpectedError(`${name} is undefined`);
+            throw new UnexpectedError(`${options.name} is undefined`);
         }
-        else if (value === null) {
-            return;
+        if (typeof value === 'symbol') {
+            throw new UnexpectedError(`${options.name} is symbol`);
         }
-        else if (typeof value === 'boolean') {
-            return;
+        if (typeof value === 'function') {
+            throw new UnexpectedError(`${options.name} is function`);
         }
-        else if (typeof value === 'number' && !isNaN(value)) {
+        if (Array.isArray(value)) {
+            checkSerializableArray(options, value);
             return;
         }
-        else if (typeof value === 'string') {
+        if (value !== null && typeof value === 'object') {
+            checkSerializableObject(options, value);
             return;
         }
-        else if (typeof value === 'symbol') {
-            throw new UnexpectedError(`${name} is symbol`);
-        }
-        else if (typeof value === 'function') {
-            throw new UnexpectedError(`${name} is function`);
-        }
-        else if (typeof value === 'object' && Array.isArray(value)) {
-            for (let i = 0; i < value.length; i++) {
-                checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
-            }
+        throwUnknownTypeError(options);
+    }
+    /**
+     * Checks the primitive values that are directly JSON serializable.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function isSerializablePrimitive(value) {
+        return (value === null ||
+            typeof value === 'boolean' ||
+            (typeof value === 'number' && !isNaN(value)) ||
+            typeof value === 'string');
+    }
+    /**
+     * Recursively checks JSON array items.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableArray(context, arrayValue) {
+        for (let index = 0; index < arrayValue.length; index++) {
+            checkSerializableAsJson({
+                ...context,
+                name: `${context.name}[${index}]`,
+                value: arrayValue[index],
+            });
         }
-        else if (typeof value === 'object') {
-            if (value instanceof Date) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is Date
+    }
+    /**
+     * Checks object-like values and dispatches special unsupported built-ins.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableObject(context, objectValue) {
+        checkUnsupportedObjectType(context, objectValue);
+        checkSerializableObjectEntries(context, objectValue);
+        assertJsonStringificationSucceeds(context, objectValue);
+    }
+    /**
+     * Rejects built-in objects that must be converted before JSON serialization.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkUnsupportedObjectType(context, objectValue) {
+        if (objectValue instanceof Date) {
+            throw new UnexpectedError(spacetrim.spaceTrim((block) => `
+                    \`${context.name}\` is Date
 
-                        Use \`string_date_iso8601\` instead
+                    Use \`string_date_iso8601\` instead
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
-                    `));
-            }
-            else if (value instanceof Map) {
-                throw new UnexpectedError(`${name} is Map`);
-            }
-            else if (value instanceof Set) {
-                throw new UnexpectedError(`${name} is Set`);
-            }
-            else if (value instanceof RegExp) {
-                throw new UnexpectedError(`${name} is RegExp`);
-            }
-            else if (value instanceof Error) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is unserialized Error
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
+                `));
+        }
+        if (objectValue instanceof Map) {
+            throw new UnexpectedError(`${context.name} is Map`);
+        }
+        if (objectValue instanceof Set) {
+            throw new UnexpectedError(`${context.name} is Set`);
+        }
+        if (objectValue instanceof RegExp) {
+            throw new UnexpectedError(`${context.name} is RegExp`);
+        }
+        if (objectValue instanceof Error) {
+            throw new UnexpectedError(spacetrim.spaceTrim((block) => `
+                    \`${context.name}\` is unserialized Error
 
-                        Use function \`serializeError\`
+                    Use function \`serializeError\`
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
 
-                    `));
+                `));
+        }
+    }
+    /**
+     * Recursively checks object properties while preserving omitted `undefined` keys.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableObjectEntries(context, objectValue) {
+        for (const [subName, subValue] of Object.entries(objectValue)) {
+            if (subValue === undefined) {
+                // Note: undefined in object is serializable - it is just omitted
+                continue;
             }
-            else {
-                for (const [subName, subValue] of Object.entries(value)) {
-                    if (subValue === undefined) {
-                        // Note: undefined in object is serializable - it is just omitted
-                        continue;
-                    }
-                    checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });
-                }
-                try {
-                    JSON.stringify(value); // <- TODO: [0]
-                }
-                catch (error) {
-                    assertsError(error);
-                    throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                            \`${name}\` is not serializable
+            checkSerializableAsJson({
+                ...context,
+                name: `${context.name}.${subName}`,
+                value: subValue,
+            });
+        }
+    }
+    /**
+     * Uses `JSON.stringify` as the final guard for cases like circular references.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function assertJsonStringificationSucceeds(context, objectValue) {
+        try {
+            JSON.stringify(objectValue); // <- TODO: [0]
+        }
+        catch (error) {
+            assertsError(error);
+            throw new UnexpectedError(spacetrim.spaceTrim((block) => `
+                    \`${context.name}\` is not serializable
 
-                            ${block(error.stack || error.message)}
+                    ${block(error.stack || error.message)}
 
-                            Additional message for \`${name}\`:
-                            ${block(message || '(nothing)')}
-                        `));
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
+                `));
+        }
+        /*
+        TODO: [0] Is there some more elegant way to check circular references?
+        const seen = new Set();
+        const stack = [{ value }];
+        while (stack.length > 0) {
+            const { value } = stack.pop()!;
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value)) {
+                    throw new UnexpectedError(`${name} has circular reference`);
                 }
-                /*
-                TODO: [0] Is there some more elegant way to check circular references?
-                const seen = new Set();
-                const stack = [{ value }];
-                while (stack.length > 0) {
-                    const { value } = stack.pop()!;
-                    if (typeof value === 'object' && value !== null) {
-                        if (seen.has(value)) {
-                            throw new UnexpectedError(`${name} has circular reference`);
-                        }
-                        seen.add(value);
-                        if (Array.isArray(value)) {
-                            stack.push(...value.map((value) => ({ value })));
-                        } else {
-                            stack.push(...Object.values(value).map((value) => ({ value })));
-                        }
-                    }
+                seen.add(value);
+                if (Array.isArray(value)) {
+                    stack.push(...value.map((value) => ({ value })));
+                } else {
+                    stack.push(...Object.values(value).map((value) => ({ value })));
                 }
-                */
-                return;
             }
         }
-        else {
-            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                    \`${name}\` is unknown type
-
-                    Additional message for \`${name}\`:
-                    ${block(message || '(nothing)')}
-                `));
-        }
+        */
     }
     /**
-     * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
-     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
-     * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+     * Throws the fallback error for unsupported value types like `bigint` and `NaN`.
+     *
+     * @private function of `checkSerializableAsJson`
      */
+    function throwUnknownTypeError(context) {
+        throw new UnexpectedError(spacetrim.spaceTrim((block) => `
+                \`${context.name}\` is unknown type
+
+                Additional message for \`${context.name}\`:
+                ${block(context.message || '(nothing)')}
+            `));
+    }
 
     /**
      * Creates a deep clone of the given object
@@ -2220,6 +2404,7 @@
      *
      * @param objectValue The object to clone.
      * @returns A deep, writable clone of the input object.
+     *
      * @public exported from `@promptbook/utils`
      */
     function deepClone(objectValue) {
@@ -2236,9 +2421,7 @@
         > return Object.assign({}, objectValue);
         */
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Utility to export a JSON object from a function
@@ -2251,6 +2434,7 @@
      * Note: This function does not mutates the given object
      *
      * @returns The same type of object as the input but read-only and re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function exportJson(options) {
@@ -2270,9 +2454,7 @@
         $deepFreeze(orderedValue);
         return orderedValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Nonce which is used for replacing things in strings
@@ -2300,9 +2482,7 @@
             // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
         ],
     });
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Normalizes a given text to camelCase format.
@@ -2314,6 +2494,7 @@
      * @returns The camelCase formatted string.
      * @example 'helloWorld'
      * @example 'iLovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -2354,10 +2535,11 @@
         }
         return normalizedName;
     }
+    // TODO: [🌺] Use some intermediate util splitWords
+
     /**
-     * TODO: [🌺] Use some intermediate util splitWords
+     * Collection of default diacritics removal map.
      */
-
     const defaultDiacriticsRemovalMap = [
         {
             base: 'A',
@@ -2609,6 +2791,7 @@
      *
      * @param input The string containing diacritics to be normalized.
      * @returns The string with diacritics removed or normalized.
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeDiacritics(input) {
@@ -2617,9 +2800,7 @@
             return DIACRITIC_VARIANTS_LETTERS[character] || character;
         });
     }
-    /**
-     * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
-     */
+    // TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
 
     /**
      * Removes emojis from a string and fix whitespaces
@@ -2628,6 +2809,7 @@
      *
      * @param text with emojis
      * @returns text without emojis
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeEmojis(text) {
@@ -2651,6 +2833,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeQuotes(text) {
@@ -2672,6 +2855,7 @@
      * @param parameterName The parameter name to validate and normalize.
      * @returns The validated and normalized parameter name.
      * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.
+     *
      * @private within the repository
      */
     function validateParameterName(parameterName) {
@@ -2728,7 +2912,7 @@
             if (!(error instanceof ParseError)) {
                 throw error;
             }
-            throw new ParseError(spaceTrim__default["default"]((block) => `
+            throw new ParseError(spacetrim.spaceTrim((block) => `
                     ${block(error.message)}
 
                     Tried to validate parameter name:
@@ -2742,6 +2926,7 @@
      * Parses the foreach command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const foreachCommandParser = {
@@ -2787,7 +2972,7 @@
             const assignSign = args[3];
             const formatDefinition = FORMAT_DEFINITIONS.find((formatDefinition) => [formatDefinition.formatName, ...(formatDefinition.aliases || [])].includes(formatName));
             if (formatDefinition === undefined) {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                         Unsupported format "${formatName}"
 
                         Available formats:
@@ -2799,7 +2984,7 @@
             }
             const subvalueParser = formatDefinition.subvalueParsers.find((subvalueParser) => [subvalueParser.subvalueName, ...(subvalueParser.aliases || [])].includes(subformatName));
             if (subvalueParser === undefined) {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                         Unsupported subformat name "${subformatName}" for format "${formatName}"
 
                         Available subformat names for format "${formatDefinition.formatName}":
@@ -2847,7 +3032,7 @@
                     outputSubparameterName = 'newLine';
                 }
                 else {
-                    throw new ParseError(spaceTrim__default["default"](`
+                    throw new ParseError(spacetrim.spaceTrim(`
                         FOREACH ${formatName} ${subformatName} must specify output subparameter
 
                         Correct example:
@@ -2900,14 +3085,13 @@
             throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
         },
     };
-    /**
-     * TODO: [🍭] Make .book.md file with examples of the FOREACH with wrong parsing and logic
-     */
+    // TODO: [🍭] Make .book.md file with examples of the FOREACH with wrong parsing and logic
 
     /**
      * Parses the format command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const formatCommandParser = {
@@ -2923,7 +3107,7 @@
         /**
          * Description of the FORMAT command
          */
-        description: spaceTrim__default["default"](`
+        description: spacetrim.spaceTrim(`
         Format command describes the desired output of the task (after post-processing)
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -3092,9 +3276,7 @@
         inputParameters: [],
         outputParameters: [],
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * A generic pipeline
@@ -3146,8 +3328,10 @@
      */
     const MatcherFormfactorDefinition = {
         name: 'EXPERIMENTAL_MATCHER',
-        description: `An evaluation system that determines whether content meets specific criteria or patterns.
-    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.`,
+        description: spacetrim.spaceTrim(`
+        An evaluation system that determines whether content meets specific criteria or patterns.
+        Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.
+    `),
         documentationUrl: `https://github.com/webgptorg/promptbook/discussions/177`,
         pipelineInterface: {
             inputParameters: [
@@ -3204,9 +3388,11 @@
      */
     const TranslatorFormfactorDefinition = {
         name: 'TRANSLATOR',
-        description: `A text transformation system that converts input content into different forms,
-    including language translations, paraphrasing, style conversions, and tone adjustments.
-    This form factor takes one input and produces one transformed output.`,
+        description: spacetrim.spaceTrim(`
+        A text transformation system that converts input content into different forms,
+        including language translations, paraphrasing, style conversions, and tone adjustments.
+        This form factor takes one input and produces one transformed output.
+    `),
         documentationUrl: `https://github.com/webgptorg/promptbook/discussions/175`,
         pipelineInterface: {
             inputParameters: [
@@ -3246,9 +3432,7 @@
         CompletionFormfactorDefinition,
         // <- [🛬] When making new formfactor, copy the _boilerplate and link it here
     ];
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Parses the formfactor command
@@ -3256,6 +3440,7 @@
      * Note: This command is used as a formfactor for new commands and defines the app type format - it should NOT be used in any `.book` file
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const formfactorCommandParser = {
@@ -3295,7 +3480,7 @@
             const formfactorNameCandidate = args[0].toUpperCase();
             const formfactor = FORMFACTOR_DEFINITIONS.find((definition) => [definition.name, ...{ aliasNames: [], ...definition }.aliasNames].includes(formfactorNameCandidate));
             if (formfactor === undefined) {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                         Unknown formfactor name "${formfactorNameCandidate}"
 
                         Available formfactors:
@@ -3314,7 +3499,7 @@
          */
         $applyToPipelineJson(command, $pipelineJson) {
             if ($pipelineJson.formfactorName !== undefined && $pipelineJson.formfactorName !== command.formfactorName) {
-                throw new ParseError(spaceTrim__default["default"](`
+                throw new ParseError(spacetrim.spaceTrim(`
                     Redefinition of \`FORMFACTOR\` in the pipeline head
 
                     You have used:
@@ -3351,6 +3536,7 @@
      * Parses the joker command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const jokerCommandParser = {
@@ -3421,6 +3607,7 @@
      * Tests if given string is valid file path.
      *
      * Note: This does not check if the file exists only if the path is valid
+     *
      * @public exported from `@promptbook/utils`
      */
     function isValidFilePath(filename) {
@@ -3469,9 +3656,7 @@
         }
         return false;
     }
-    /**
-     * TODO: [🍏] Implement for MacOs
-     */
+    // TODO: [🍏] Implement for MacOs
 
     /**
      * Tests if given string is valid URL.
@@ -3513,6 +3698,7 @@
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
      * @example 'i-love-promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeToKebabCase(text) {
@@ -3553,9 +3739,7 @@
         normalizedName = normalizedName.replace(/-$/, '');
         return normalizedName;
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Creates unique name for the source
@@ -3574,14 +3758,13 @@
         // <- TODO: Use MAX_FILENAME_LENGTH
         return name;
     }
-    /**
-     * TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
-     */
+    // TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
 
     /**
      * Parses the knowledge command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const knowledgeCommandParser = {
@@ -3618,7 +3801,7 @@
          */
         parse(input) {
             const { args } = input;
-            const knowledgeSourceContent = spaceTrim__default["default"](args[0] || '');
+            const knowledgeSourceContent = spacetrim.spaceTrim(args[0] || '');
             if (knowledgeSourceContent === '') {
                 throw new ParseError(`Source is not defined`);
             }
@@ -3668,12 +3851,13 @@
             throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
         },
     };
-    /**
-     * Note: [⛱] There are two types of KNOWLEDGE commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of KNOWLEDGE commands *...(read more in [⛱])*
 
     /**
+     * Constant for model variants.
+     *
      * @see {@link ModelVariant}
+     *
      * @public exported from `@promptbook/core`
      */
     const MODEL_VARIANTS = [
@@ -3688,6 +3872,7 @@
      *
      * @see `documentationUrl` for more details
      * @deprecated Option to manually set the model requirements is not recommended to use, use `PERSONA` instead
+     *
      * @public exported from `@promptbook/editable`
      */
     const modelCommandParser = {
@@ -3717,7 +3902,7 @@
          */
         parse(input) {
             const { args, normalized } = input;
-            const availableVariantsMessage = spaceTrim__default["default"]((block) => `
+            const availableVariantsMessage = spacetrim.spaceTrim((block) => `
               Available variants are:
               ${block(MODEL_VARIANTS.map((variantName) => `- ${variantName}${variantName !== 'EMBEDDING' ? '' : ' (Not available in pipeline)'}`).join('\n'))}
           `);
@@ -3739,14 +3924,14 @@
                     // <- Note: [🤖]
                 }
                 else if (normalized.startsWith('MODEL_VARIANT_EMBED')) {
-                    spaceTrim__default["default"]((block) => `
+                    spacetrim.spaceTrim((block) => `
                         Embedding model can not be used in pipeline
 
                         ${block(availableVariantsMessage)}
                     `);
                 }
                 else {
-                    throw new ParseError(spaceTrim__default["default"]((block) => `
+                    throw new ParseError(spacetrim.spaceTrim((block) => `
                             Unknown model variant in command:
 
                             ${block(availableVariantsMessage)}
@@ -3761,7 +3946,7 @@
                 };
             }
             else {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                     Unknown model key in command.
 
                     Supported model keys are:
@@ -3788,7 +3973,7 @@
                     // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                 }
                 else {
-                    throw new ParseError(spaceTrim__default["default"](`
+                    throw new ParseError(spacetrim.spaceTrim(`
                         Redefinition of \`MODEL ${command.key}\` in the pipeline head
 
                         You have used:
@@ -3816,7 +4001,7 @@
                     // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                 }
                 else {
-                    throw new ParseError(spaceTrim__default["default"](`
+                    throw new ParseError(spacetrim.spaceTrim(`
                               Redefinition of MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}"
 
                               You have used:
@@ -3826,7 +4011,7 @@
                 }
             }
             if (command.value === ($pipelineJson.defaultModelRequirements || {})[command.key]) {
-                console.log(spaceTrim__default["default"](`
+                console.log(spacetrim.spaceTrim(`
                     Setting MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}" to the same value as in the pipeline head
 
                     In pipeline head:
@@ -3868,6 +4053,7 @@
      * Parses the parameter command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const parameterCommandParser = {
@@ -3909,7 +4095,7 @@
             // <- TODO: When [🥶] fixed, change to:
             //        >   const parameterDescriptionRaw = rawArgs.split(parameterNameRaw).join('').trim();
             if (parameterDescriptionRaw && parameterDescriptionRaw.match(/\{(?<embeddedParameterName>[a-z0-9_]+)\}/im)) {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                         Parameter \`{${parameterNameRaw}}\` can not contain another parameter in description
 
                         The description:
@@ -3978,6 +4164,7 @@
      * Parses the persona command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const personaCommandParser = {
@@ -4091,7 +4278,7 @@
             persona.description = personaDescription;
             return;
         }
-        console.warn(spaceTrim__default["default"](`
+        console.warn(spacetrim.spaceTrim(`
 
             Persona "${personaName}" is defined multiple times with different description:
 
@@ -4102,7 +4289,7 @@
             ${personaDescription}
 
         `));
-        persona.description += spaceTrim__default["default"]('\n\n' + personaDescription);
+        persona.description += spacetrim.spaceTrim('\n\n' + personaDescription);
     }
 
     /**
@@ -4110,6 +4297,7 @@
      *
      * @param javascriptName The value to check for JavaScript identifier validity.
      * @returns `true` if the value is a valid JavaScript name, false otherwise.
+     *
      * @public exported from `@promptbook/utils`
      */
     function isValidJavascriptName(javascriptName) {
@@ -4123,6 +4311,7 @@
      * Parses the postprocess command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const postprocessCommandParser = {
@@ -4238,6 +4427,7 @@
      * Parses the section command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const sectionCommandParser = {
@@ -4324,7 +4514,7 @@
             normalized = normalized.split('DIALOGUE').join('DIALOG');
             const taskTypes = SectionTypes.filter((sectionType) => normalized.includes(sectionType.split('_TASK').join('')));
             if (taskTypes.length !== 1) {
-                throw new ParseError(spaceTrim__default["default"]((block) => `
+                throw new ParseError(spacetrim.spaceTrim((block) => `
                         Unknown section type "${normalized}"
 
                         Supported section types are:
@@ -4344,7 +4534,7 @@
          */
         $applyToTaskJson(command, $taskJson, $pipelineJson) {
             if ($taskJson.isSectionTypeSet === true) {
-                throw new ParseError(spaceTrim__default["default"](`
+                throw new ParseError(spacetrim.spaceTrim(`
                     Section type is already defined in the section.
                     It can be defined only once.
                 `));
@@ -4452,14 +4642,13 @@
         */
         return true;
     }
-    /**
-     * TODO: [🐠] Maybe more info why the URL is invalid
-     */
+    // TODO: [🐠] Maybe more info why the URL is invalid
 
     /**
      * Parses the url command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const urlCommandParser = {
@@ -4561,6 +4750,7 @@
      * Parses the action command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const actionCommandParser = {
@@ -4618,14 +4808,13 @@
             throw new NotYetImplementedError('[🛠] Actions are not implemented yet');
         },
     };
-    /**
-     * Note: [⛱] There are two types of ACTION commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of ACTION commands *...(read more in [⛱])*
 
     /**
      * Parses the instrument command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const instrumentCommandParser = {
@@ -4683,9 +4872,7 @@
             throw new NotYetImplementedError('[🛠] Instruments are not implemented yet');
         },
     };
-    /**
-     * Note: [⛱] There are two types of INSTRUMENT commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of INSTRUMENT commands *...(read more in [⛱])*
 
     /**
      * All available command parsers
@@ -4711,9 +4898,7 @@
         boilerplateCommandParser, // <- TODO: Only in development, remove in production
         // <- Note: [♓️][💩] This is the order of the commands in the pipeline, BUT its not used in parsing and before usage maybe it should be done better
     ];
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Gets the parser for the command
@@ -4726,7 +4911,7 @@
     function getParserForCommand(command) {
         const commandParser = COMMANDS.find((commandParser) => commandParser.name === command.type);
         if (commandParser === undefined) {
-            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
+            throw new UnexpectedError(spacetrim.spaceTrim((block) => `
                     Command ${command.type} parser is not found
 
                     ${block(JSON.stringify(command, null, 4)
@@ -4743,6 +4928,7 @@
      *
      * @param {string} str - The string to remove Markdown tags from.
      * @returns {string} The input string with all Markdown tags removed.
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownFormatting(str) {
@@ -4802,7 +4988,7 @@
             .map(removeMarkdownFormatting)
             .map((item) => item.trim());
         if (items.length === 0 || items[0] === '') {
-            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
+            throw new ParseError(spacetrim.spaceTrim((block) => `
                         Malformed command:
                         - ${raw}
 
@@ -4838,7 +5024,7 @@
                 return command;
             }
         }
-        throw new ParseError(spaceTrim$1.spaceTrim((block) => `
+        throw new ParseError(spacetrim.spaceTrim((block) => `
                   Malformed or unknown command:
                   - ${raw}
 
@@ -4889,7 +5075,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
+                    throw new ParseError(spacetrim.spaceTrim((block) => `
                               Invalid ${commandName} command:
 
                               Your command:
@@ -4912,7 +5098,7 @@
     }
 
     /**
-     *  Number of padding lines to add at the end of the book content
+     * Number of padding lines to add at the end of the book content
      *
      * @public exported from `@promptbook/core`
      */
@@ -4949,9 +5135,7 @@
         const linesToAdd = PADDING_LINES - trailingEmptyLines;
         return (content + '\n'.repeat(linesToAdd));
     }
-    /**
-     * TODO: [🧠] Maybe export
-     */
+    // TODO: [🧠] Maybe export
 
     /**
      * Checks if value is valid email
@@ -4977,6 +5161,7 @@
      * @param {string} pipelineString the candidate for a pipeline string
      * @returns {PipelineString} the same string as input, but validated as valid
      * @throws {ParseError} if the string is not a valid pipeline string
+     *
      * @public exported from `@promptbook/core`
      */
     function validatePipelineString(pipelineString) {
@@ -4995,19 +5180,18 @@
         // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
         return pipelineString;
     }
-    /**
-     * TODO: [🧠][🈴] Where is the best location for this file
-     */
+    // TODO: [🧠][🈴] Where is the best location for this file
 
     /**
      * Removes Markdown (or HTML) comments
      *
      * @param {string} content - The string to remove comments from.
      * @returns {string} The input string with all comments removed.
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownComments(content) {
-        return spaceTrim$1.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+        return spacetrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
@@ -5018,7 +5202,7 @@
      */
     function isFlatPipeline(pipelineString) {
         pipelineString = removeMarkdownComments(pipelineString);
-        pipelineString = spaceTrim__default["default"](pipelineString);
+        pipelineString = spacetrim.spaceTrim(pipelineString);
         const isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
         //const isLastLineReturnStatement = pipelineString.split(/\r?\n/).pop()!.split('`').join('').startsWith('->');
         const isBacktickBlockUsed = pipelineString.includes('```');
@@ -5044,7 +5228,7 @@
         if (!isFlatPipeline(pipelineString)) {
             return pipelineString;
         }
-        pipelineString = spaceTrim__default["default"](pipelineString);
+        pipelineString = spacetrim.spaceTrim(pipelineString);
         const pipelineStringLines = pipelineString.split(/\r?\n/);
         const potentialReturnStatement = pipelineStringLines.pop();
         let returnStatement;
@@ -5057,19 +5241,19 @@
             returnStatement = `-> {${DEFAULT_BOOK_OUTPUT_PARAMETER_NAME}}`;
             pipelineStringLines.push(potentialReturnStatement);
         }
-        const prompt = spaceTrim__default["default"](pipelineStringLines.join('\n'));
+        const prompt = spacetrim.spaceTrim(pipelineStringLines.join('\n'));
         let quotedPrompt;
         if (prompt.split(/\r?\n/).length <= 1) {
             quotedPrompt = `> ${prompt}`;
         }
         else {
-            quotedPrompt = spaceTrim__default["default"]((block) => `
+            quotedPrompt = spacetrim.spaceTrim((block) => `
                 \`\`\`
                 ${block(prompt.split('`').join('\\`'))}
                 \`\`\`
             `);
         }
-        pipelineString = validatePipelineString(spaceTrim__default["default"]((block) => `
+        pipelineString = validatePipelineString(spacetrim.spaceTrim((block) => `
                 # ${DEFAULT_BOOK_TITLE}
 
                 ## Prompt
@@ -5081,9 +5265,7 @@
         // <- TODO: Maybe use book` notation
         return padBook(pipelineString);
     }
-    /**
-     * TODO: Unit test
-     */
+    // TODO: Unit test
 
     /**
      * Adds a new command to a pipeline string in the correct format.
@@ -5137,12 +5319,10 @@
             );
             */
         }
-        return spaceTrim__default["default"](newLines.join('\n'));
+        return spacetrim.spaceTrim(newLines.join('\n'));
     }
-    /**
-     * TODO: [🧠] What is the better solution - `- xxx`, - `-   xxx` or preserve (see also next TODO)
-     * TODO: When existing commands 1) as 2) number 3) list, add 4) new command as next number
-     */
+    // TODO: [🧠] What is the better solution - `- xxx`, - `-   xxx` or preserve (see also next TODO)
+    // TODO: When existing commands 1) as 2) number 3) list, add 4) new command as next number
 
     /**
      * Function `removePipelineCommand` will remove one command from pipeline string
@@ -5179,7 +5359,7 @@
             }
             newLines.push(line);
         }
-        const newPipeline = spaceTrim__default["default"](newLines.join('\n'));
+        const newPipeline = spacetrim.spaceTrim(newLines.join('\n'));
         return newPipeline;
     }
 
@@ -5201,6 +5381,7 @@
      * In other words, it will find all parameters that are not used in the task itseld and all its dependencies
      *
      * @throws {PipelineLogicError} If the new parameter name is already used in the pipeline
+     *
      * @public exported from `@promptbook/editable`
      */
     function renamePipelineParameter(options) {
@@ -5234,9 +5415,7 @@
         }
         return renamedPipeline;
     }
-    /**
-     * TODO: Also variant for `edit-pipeline-string`
-     */
+    // TODO: Also variant for `edit-pipeline-string`
 
     // <- TODO: Auto convert to type `import { ... } from 'type-fest';`
     /**
@@ -5255,7 +5434,6 @@
      * - `Symbol` objects are not serializable
      * - And much more...
      *
-     *
      * @public exported from `@promptbook/utils`
      */
     function isSerializableAsJson(value) {
@@ -5267,10 +5445,8 @@
             return false;
         }
     }
-    /**
-     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
-     * TODO: [🧠][💺] Can be done this on type-level?
-     */
+    // TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+    // TODO: [🧠][💺] Can be done this on type-level?
 
     /**
      * Stringify the PipelineJson with proper formatting
@@ -5282,7 +5458,7 @@
      */
     function stringifyPipelineJson(pipeline) {
         if (!isSerializableAsJson(pipeline)) {
-            throw new UnexpectedError(spaceTrim__default["default"](`
+            throw new UnexpectedError(spacetrim.spaceTrim(`
                 Cannot stringify the pipeline, because it is not serializable as JSON
 
                 There can be multiple reasons:
@@ -5298,12 +5474,10 @@
         pipelineJsonStringified += '\n';
         return pipelineJsonStringified;
     }
-    /**
-     * TODO: [🐝] Not Working properly @see https://promptbook.studio/examples/mixed-knowledge.book
-     * TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
-     * TODO: [🧠] Maybe more elegant solution than replacing via regex
-     * TODO: [🍙] Make some standard order of json properties
-     */
+    // TODO: [🐝] Not Working properly @see https://promptbook.studio/examples/mixed-knowledge.book
+    // TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
+    // TODO: [🧠] Maybe more elegant solution than replacing via regex
+    // TODO: [🍙] Make some standard order of json properties
 
     exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
     exports.COMMANDS = COMMANDS;