@promptbook/editable 0.111.0-7 → 0.112.0-100

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { parse, unparse } from 'papaparse';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
@@ -17,7 +17,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -27,16 +27,20 @@ const PROMPTBOOK_ENGINE_VERSION = '0.111.0-7';
  * 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;
 
 /**
- * @private util of `@promptbook/color`
+ * Class implementing take chain.
+ *
  * @de
+ *
+ * @private util of `@promptbook/color`
  */
 class TakeChain {
     constructor(value) {
@@ -53,9 +57,9 @@ class TakeChain {
  *
  * @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) {
@@ -233,9 +237,7 @@ const CSS_COLORS = {
     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.
@@ -265,7 +267,118 @@ function checkChannelValue(channelName, value) {
     }
 }
 
+/**
+ * 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.
@@ -298,6 +411,9 @@ function parseHexColor(hex) {
     }
     return throwInvalidHex();
 }
+/**
+ * Parses short hex channel.
+ */
 function parseShortHexChannel(char, onError) {
     if (!char) {
         return onError();
@@ -308,6 +424,9 @@ function parseShortHexChannel(char, onError) {
     }
     return parsed * 16;
 }
+/**
+ * Parses long hex channel.
+ */
 function parseLongHexChannel(hex, start, onError) {
     const segment = hex.substr(start, 2);
     if (segment.length < 2) {
@@ -320,6 +439,9 @@ function parseLongHexChannel(hex, start, onError) {
     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.
@@ -345,6 +467,9 @@ function parseHslColor(hsl) {
         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));
@@ -383,7 +508,13 @@ function convertHslToRgb(h, s, l) {
     };
 }
 
+/**
+ * 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.
@@ -425,6 +556,9 @@ function parseRgbaColor(rgba) {
         alpha: parseAlphaValue(match[4]),
     };
 }
+/**
+ * Parses channel value.
+ */
 function parseChannelValue(value) {
     if (value.endsWith('%')) {
         const percent = parseFloat(value);
@@ -432,6 +566,9 @@ function parseChannelValue(value) {
     }
     return Math.round(parseFloat(value));
 }
+/**
+ * Parses alpha value.
+ */
 function parseAlphaValue(value) {
     if (value.endsWith('%')) {
         const percent = parseFloat(value);
@@ -444,9 +581,55 @@ function parseAlphaValue(value) {
     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
  *
@@ -454,7 +637,7 @@ const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.
  *
  * @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
@@ -527,25 +710,7 @@ class Color {
      * @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
@@ -575,8 +740,7 @@ class Color {
      * @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
@@ -585,8 +749,7 @@ class Color {
      * @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
@@ -595,8 +758,7 @@ class Color {
      * @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
@@ -605,8 +767,7 @@ class Color {
      * @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
@@ -618,7 +779,7 @@ class Color {
      * @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.
@@ -651,8 +812,7 @@ 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}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
+        return isHexColorString(value);
     }
     /**
      * Creates new Color object
@@ -665,91 +825,13 @@ class Color {
      * @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);
-    }
-    /**
-     * 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;
+        super(red, green, blue, alpha);
     }
-    /**
-     * 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(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)}%)`;
-        }
+    createColor(red, green, blue, alpha) {
+        return new Color(red, green, blue, alpha);
     }
-    toHsl() {
-        throw new Error(`Getting HSL is not implemented`);
+    static fromColorChannels({ red, green, blue, alpha }) {
+        return take(new Color(red, green, blue, alpha));
     }
 }
 
@@ -813,9 +895,7 @@ function hslToRgb(hue, saturation, lightness) {
     }
     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
@@ -861,9 +941,7 @@ function rgbToHsl(red, green, blue) {
     }
     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
@@ -881,9 +959,7 @@ function lighten(amount) {
         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
@@ -901,9 +977,36 @@ function saturate(amount) {
         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.
@@ -916,6 +1019,7 @@ function saturate(amount) {
  *
  * @param value any values
  * @returns the same values
+ *
  * @private within the repository
  */
 function just(value) {
@@ -967,6 +1071,9 @@ const PROMPTBOOK_COLOR = Color.fromString('promptbook');
     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'),
 });
@@ -994,7 +1101,7 @@ Color.fromHex('#1D4ED8');
  *
  * @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
  *
@@ -1008,6 +1115,31 @@ const DEFAULT_BOOK_OUTPUT_PARAMETER_NAME = 'result';
  * @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.
@@ -1040,7 +1172,7 @@ parseInt(process.env.API_REQUEST_TIMEOUT || '90000');
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$2((block) => `
+        body: spaceTrim$1((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1112,9 +1244,7 @@ class ParseError extends Error {
         Object.setPrototypeOf(this, ParseError.prototype);
     }
 }
-/**
- * TODO: Maybe split `ParseError` and `ApplyError`
- */
+// TODO: Maybe split `ParseError` and `ApplyError`
 
 /**
  * Parses the boilerplate command
@@ -1122,6 +1252,7 @@ class ParseError extends Error {
  * 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 = {
@@ -1255,12 +1386,13 @@ function isValidSemanticVersion(version) {
  * Tests if given string is valid promptbook version
  * It looks into list of known promptbook versions.
  *
- * @see https://www.npmjs.com/package/promptbook?activeTab=versions
  * Note: When you are using for example promptbook 2.0.0 and there already is promptbook 3.0.0 it don`t know about it.
  * Note: There are two 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) {
@@ -1278,6 +1410,7 @@ function isValidPromptbookVersion(version) {
  * Parses the BOOK_VERSION command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const bookVersionCommandParser = {
@@ -1402,12 +1535,11 @@ function assertsError(whatWasThrown) {
  * 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
@@ -1476,17 +1608,16 @@ function parseNumber(value) {
     }
     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 = {
@@ -1502,7 +1633,7 @@ const expectCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim$2(`
+    description: spaceTrim$1(`
         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.
     `),
@@ -1576,7 +1707,7 @@ const expectCommandParser = {
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
                         `));
@@ -1706,8 +1837,9 @@ function isValidCsvString(value) {
 /**
  * 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',
@@ -1728,7 +1860,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$2((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -1773,7 +1905,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$2((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -1797,13 +1929,11 @@ const CsvFormatParser = {
         },
     ],
 };
-/**
- * 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
@@ -1846,17 +1976,15 @@ const JsonFormatParser = {
     },
     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
@@ -1894,15 +2022,13 @@ const TextFormatParser = {
         // <- 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
@@ -1947,17 +2073,15 @@ const XmlFormatParser = {
     },
     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
@@ -1965,9 +2089,7 @@ const XmlFormatParser = {
  * @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).
@@ -1978,6 +2100,7 @@ const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser,
  * @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) {
@@ -2030,6 +2153,7 @@ function normalizeTo_SCREAMING_CASE(text) {
  * Orders JSON object by keys
  *
  * @returns The same type of object as the input re-ordered
+ *
  * @public exported from `@promptbook/utils`
  */
 function orderJson(options) {
@@ -2048,6 +2172,7 @@ function orderJson(options) {
  * 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) {
@@ -2064,9 +2189,7 @@ function $deepFreeze(objectValue) {
     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
@@ -2086,125 +2209,187 @@ function $deepFreeze(objectValue) {
  * - 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$2((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$1((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$2((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$1((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$2((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$1((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$2((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$1((block) => `
+                \`${context.name}\` is unknown type
+
+                Additional message for \`${context.name}\`:
+                ${block(context.message || '(nothing)')}
+            `));
+}
 
 /**
  * Creates a deep clone of the given object
@@ -2214,6 +2399,7 @@ function checkSerializableAsJson(options) {
  *
  * @param objectValue The object to clone.
  * @returns A deep, writable clone of the input object.
+ *
  * @public exported from `@promptbook/utils`
  */
 function deepClone(objectValue) {
@@ -2230,9 +2416,7 @@ function deepClone(objectValue) {
     > 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
@@ -2245,6 +2429,7 @@ function deepClone(objectValue) {
  * 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) {
@@ -2264,9 +2449,7 @@ function exportJson(options) {
     $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
@@ -2294,9 +2477,7 @@ const RESERVED_PARAMETER_NAMES = exportJson({
         // <- 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.
@@ -2308,6 +2489,7 @@ const RESERVED_PARAMETER_NAMES = exportJson({
  * @returns The camelCase formatted string.
  * @example 'helloWorld'
  * @example 'iLovePromptbook'
+ *
  * @public exported from `@promptbook/utils`
  */
 function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -2348,10 +2530,11 @@ function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
     }
     return normalizedName;
 }
+// TODO: [🌺] Use some intermediate util splitWords
+
 /**
- * TODO: [🌺] Use some intermediate util splitWords
+ * Collection of default diacritics removal map.
  */
-
 const defaultDiacriticsRemovalMap = [
     {
         base: 'A',
@@ -2603,6 +2786,7 @@ for (let i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
  *
  * @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) {
@@ -2611,9 +2795,7 @@ function removeDiacritics(input) {
         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
@@ -2622,6 +2804,7 @@ function removeDiacritics(input) {
  *
  * @param text with emojis
  * @returns text without emojis
+ *
  * @public exported from `@promptbook/utils`
  */
 function removeEmojis(text) {
@@ -2645,6 +2828,7 @@ function removeEmojis(text) {
  *
  * @param text optionally quoted text
  * @returns text without quotes
+ *
  * @public exported from `@promptbook/utils`
  */
 function removeQuotes(text) {
@@ -2666,6 +2850,7 @@ function removeQuotes(text) {
  * @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) {
@@ -2722,7 +2907,7 @@ function validateParameterName(parameterName) {
         if (!(error instanceof ParseError)) {
             throw error;
         }
-        throw new ParseError(spaceTrim$2((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     ${block(error.message)}
 
                     Tried to validate parameter name:
@@ -2736,6 +2921,7 @@ function validateParameterName(parameterName) {
  * Parses the foreach command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const foreachCommandParser = {
@@ -2781,7 +2967,7 @@ const foreachCommandParser = {
         const assignSign = args[3];
         const formatDefinition = FORMAT_DEFINITIONS.find((formatDefinition) => [formatDefinition.formatName, ...(formatDefinition.aliases || [])].includes(formatName));
         if (formatDefinition === undefined) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported format "${formatName}"
 
                         Available formats:
@@ -2793,7 +2979,7 @@ const foreachCommandParser = {
         }
         const subvalueParser = formatDefinition.subvalueParsers.find((subvalueParser) => [subvalueParser.subvalueName, ...(subvalueParser.aliases || [])].includes(subformatName));
         if (subvalueParser === undefined) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported subformat name "${subformatName}" for format "${formatName}"
 
                         Available subformat names for format "${formatDefinition.formatName}":
@@ -2841,7 +3027,7 @@ const foreachCommandParser = {
                 outputSubparameterName = 'newLine';
             }
             else {
-                throw new ParseError(spaceTrim$2(`
+                throw new ParseError(spaceTrim$1(`
                         FOREACH ${formatName} ${subformatName} must specify output subparameter
 
                         Correct example:
@@ -2894,14 +3080,13 @@ const foreachCommandParser = {
         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 = {
@@ -2917,7 +3102,7 @@ const formatCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim$2(`
+    description: spaceTrim$1(`
         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.
     `),
@@ -3086,9 +3271,7 @@ const GENERIC_PIPELINE_INTERFACE = {
     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
@@ -3140,8 +3323,10 @@ const ImageGeneratorFormfactorDefinition = {
  */
 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$1(`
+        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: [
@@ -3198,9 +3383,11 @@ const SheetsFormfactorDefinition = {
  */
 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$1(`
+        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: [
@@ -3240,9 +3427,7 @@ const FORMFACTOR_DEFINITIONS = [
     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
@@ -3250,6 +3435,7 @@ const FORMFACTOR_DEFINITIONS = [
  * 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 = {
@@ -3289,7 +3475,7 @@ const formfactorCommandParser = {
         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$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown formfactor name "${formfactorNameCandidate}"
 
                         Available formfactors:
@@ -3308,7 +3494,7 @@ const formfactorCommandParser = {
      */
     $applyToPipelineJson(command, $pipelineJson) {
         if ($pipelineJson.formfactorName !== undefined && $pipelineJson.formfactorName !== command.formfactorName) {
-            throw new ParseError(spaceTrim$2(`
+            throw new ParseError(spaceTrim$1(`
                     Redefinition of \`FORMFACTOR\` in the pipeline head
 
                     You have used:
@@ -3345,6 +3531,7 @@ const formfactorCommandParser = {
  * Parses the joker command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const jokerCommandParser = {
@@ -3415,6 +3602,7 @@ const jokerCommandParser = {
  * 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) {
@@ -3463,9 +3651,7 @@ function isValidFilePath(filename) {
     }
     return false;
 }
-/**
- * TODO: [🍏] Implement for MacOs
- */
+// TODO: [🍏] Implement for MacOs
 
 /**
  * Tests if given string is valid URL.
@@ -3507,6 +3693,7 @@ function isValidUrl(url) {
  * @returns The kebab-case formatted string.
  * @example 'hello-world'
  * @example 'i-love-promptbook'
+ *
  * @public exported from `@promptbook/utils`
  */
 function normalizeToKebabCase(text) {
@@ -3547,9 +3734,7 @@ function normalizeToKebabCase(text) {
     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
@@ -3568,14 +3753,13 @@ function knowledgeSourceContentToName(knowledgeSourceContent) {
     // <- 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 = {
@@ -3612,7 +3796,7 @@ const knowledgeCommandParser = {
      */
     parse(input) {
         const { args } = input;
-        const knowledgeSourceContent = spaceTrim$2(args[0] || '');
+        const knowledgeSourceContent = spaceTrim$1(args[0] || '');
         if (knowledgeSourceContent === '') {
             throw new ParseError(`Source is not defined`);
         }
@@ -3662,12 +3846,13 @@ const knowledgeCommandParser = {
         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 = [
@@ -3682,6 +3867,7 @@ const MODEL_VARIANTS = [
  *
  * @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 = {
@@ -3711,7 +3897,7 @@ const modelCommandParser = {
      */
     parse(input) {
         const { args, normalized } = input;
-        const availableVariantsMessage = spaceTrim$2((block) => `
+        const availableVariantsMessage = spaceTrim$1((block) => `
               Available variants are:
               ${block(MODEL_VARIANTS.map((variantName) => `- ${variantName}${variantName !== 'EMBEDDING' ? '' : ' (Not available in pipeline)'}`).join('\n'))}
           `);
@@ -3733,14 +3919,14 @@ const modelCommandParser = {
                 // <- Note: [🤖]
             }
             else if (normalized.startsWith('MODEL_VARIANT_EMBED')) {
-                spaceTrim$2((block) => `
+                spaceTrim$1((block) => `
                         Embedding model can not be used in pipeline
 
                         ${block(availableVariantsMessage)}
                     `);
             }
             else {
-                throw new ParseError(spaceTrim$2((block) => `
+                throw new ParseError(spaceTrim$1((block) => `
                             Unknown model variant in command:
 
                             ${block(availableVariantsMessage)}
@@ -3755,7 +3941,7 @@ const modelCommandParser = {
             };
         }
         else {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                     Unknown model key in command.
 
                     Supported model keys are:
@@ -3782,7 +3968,7 @@ const modelCommandParser = {
                 // <- 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$2(`
+                throw new ParseError(spaceTrim$1(`
                         Redefinition of \`MODEL ${command.key}\` in the pipeline head
 
                         You have used:
@@ -3810,7 +3996,7 @@ const modelCommandParser = {
                 // <- 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$2(`
+                throw new ParseError(spaceTrim$1(`
                               Redefinition of MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}"
 
                               You have used:
@@ -3820,7 +4006,7 @@ const modelCommandParser = {
             }
         }
         if (command.value === ($pipelineJson.defaultModelRequirements || {})[command.key]) {
-            console.log(spaceTrim$2(`
+            console.log(spaceTrim$1(`
                     Setting MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}" to the same value as in the pipeline head
 
                     In pipeline head:
@@ -3862,6 +4048,7 @@ const modelCommandParser = {
  * Parses the parameter command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const parameterCommandParser = {
@@ -3903,7 +4090,7 @@ const parameterCommandParser = {
         // <- 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$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Parameter \`{${parameterNameRaw}}\` can not contain another parameter in description
 
                         The description:
@@ -3972,6 +4159,7 @@ const parameterCommandParser = {
  * Parses the persona command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const personaCommandParser = {
@@ -4085,7 +4273,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
         persona.description = personaDescription;
         return;
     }
-    console.warn(spaceTrim$2(`
+    console.warn(spaceTrim$1(`
 
             Persona "${personaName}" is defined multiple times with different description:
 
@@ -4096,7 +4284,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
             ${personaDescription}
 
         `));
-    persona.description += spaceTrim$2('\n\n' + personaDescription);
+    persona.description += spaceTrim$1('\n\n' + personaDescription);
 }
 
 /**
@@ -4104,6 +4292,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
  *
  * @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) {
@@ -4117,6 +4306,7 @@ function isValidJavascriptName(javascriptName) {
  * Parses the postprocess command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const postprocessCommandParser = {
@@ -4232,6 +4422,7 @@ const SectionTypes = [
  * Parses the section command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const sectionCommandParser = {
@@ -4318,7 +4509,7 @@ const sectionCommandParser = {
         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$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown section type "${normalized}"
 
                         Supported section types are:
@@ -4338,7 +4529,7 @@ const sectionCommandParser = {
      */
     $applyToTaskJson(command, $taskJson, $pipelineJson) {
         if ($taskJson.isSectionTypeSet === true) {
-            throw new ParseError(spaceTrim$2(`
+            throw new ParseError(spaceTrim$1(`
                     Section type is already defined in the section.
                     It can be defined only once.
                 `));
@@ -4446,14 +4637,13 @@ function isValidPipelineUrl(url) {
     */
     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 = {
@@ -4555,6 +4745,7 @@ const urlCommandParser = {
  * Parses the action command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 const actionCommandParser = {
@@ -4612,14 +4803,13 @@ const actionCommandParser = {
         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 = {
@@ -4677,9 +4867,7 @@ const instrumentCommandParser = {
         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
@@ -4705,9 +4893,7 @@ const COMMANDS = [
     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
@@ -4737,6 +4923,7 @@ function getParserForCommand(command) {
  *
  * @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) {
@@ -4906,7 +5093,7 @@ function parseCommandVariant(input) {
 }
 
 /**
- *  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`
  */
@@ -4943,9 +5130,7 @@ function padBook(content) {
     const linesToAdd = PADDING_LINES - trailingEmptyLines;
     return (content + '\n'.repeat(linesToAdd));
 }
-/**
- * TODO: [🧠] Maybe export
- */
+// TODO: [🧠] Maybe export
 
 /**
  * Checks if value is valid email
@@ -4971,6 +5156,7 @@ function isValidEmail(email) {
  * @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) {
@@ -4989,15 +5175,14 @@ function validatePipelineString(pipelineString) {
     // <- 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) {
@@ -5012,7 +5197,7 @@ function removeMarkdownComments(content) {
  */
 function isFlatPipeline(pipelineString) {
     pipelineString = removeMarkdownComments(pipelineString);
-    pipelineString = spaceTrim$2(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
     //const isLastLineReturnStatement = pipelineString.split(/\r?\n/).pop()!.split('`').join('').startsWith('->');
     const isBacktickBlockUsed = pipelineString.includes('```');
@@ -5038,7 +5223,7 @@ function deflatePipeline(pipelineString) {
     if (!isFlatPipeline(pipelineString)) {
         return pipelineString;
     }
-    pipelineString = spaceTrim$2(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const pipelineStringLines = pipelineString.split(/\r?\n/);
     const potentialReturnStatement = pipelineStringLines.pop();
     let returnStatement;
@@ -5051,19 +5236,19 @@ function deflatePipeline(pipelineString) {
         returnStatement = `-> {${DEFAULT_BOOK_OUTPUT_PARAMETER_NAME}}`;
         pipelineStringLines.push(potentialReturnStatement);
     }
-    const prompt = spaceTrim$2(pipelineStringLines.join('\n'));
+    const prompt = spaceTrim$1(pipelineStringLines.join('\n'));
     let quotedPrompt;
     if (prompt.split(/\r?\n/).length <= 1) {
         quotedPrompt = `> ${prompt}`;
     }
     else {
-        quotedPrompt = spaceTrim$2((block) => `
+        quotedPrompt = spaceTrim$1((block) => `
                 \`\`\`
                 ${block(prompt.split('`').join('\\`'))}
                 \`\`\`
             `);
     }
-    pipelineString = validatePipelineString(spaceTrim$2((block) => `
+    pipelineString = validatePipelineString(spaceTrim$1((block) => `
                 # ${DEFAULT_BOOK_TITLE}
 
                 ## Prompt
@@ -5075,9 +5260,7 @@ function deflatePipeline(pipelineString) {
     // <- 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.
@@ -5131,12 +5314,10 @@ function addPipelineCommand(options) {
         );
         */
     }
-    return spaceTrim$2(newLines.join('\n'));
+    return spaceTrim$1(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
@@ -5173,7 +5354,7 @@ function removePipelineCommand(options) {
         }
         newLines.push(line);
     }
-    const newPipeline = spaceTrim$2(newLines.join('\n'));
+    const newPipeline = spaceTrim$1(newLines.join('\n'));
     return newPipeline;
 }
 
@@ -5195,6 +5376,7 @@ class PipelineLogicError extends Error {
  * 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) {
@@ -5228,9 +5410,7 @@ function renamePipelineParameter(options) {
     }
     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';`
 /**
@@ -5249,7 +5429,6 @@ function renamePipelineParameter(options) {
  * - `Symbol` objects are not serializable
  * - And much more...
  *
- *
  * @public exported from `@promptbook/utils`
  */
 function isSerializableAsJson(value) {
@@ -5261,10 +5440,8 @@ function isSerializableAsJson(value) {
         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
@@ -5276,7 +5453,7 @@ function isSerializableAsJson(value) {
  */
 function stringifyPipelineJson(pipeline) {
     if (!isSerializableAsJson(pipeline)) {
-        throw new UnexpectedError(spaceTrim$2(`
+        throw new UnexpectedError(spaceTrim$1(`
                 Cannot stringify the pipeline, because it is not serializable as JSON
 
                 There can be multiple reasons:
@@ -5292,12 +5469,10 @@ function stringifyPipelineJson(pipeline) {
     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
 
 export { BOOK_LANGUAGE_VERSION, COMMANDS, PROMPTBOOK_ENGINE_VERSION, actionCommandParser, addPipelineCommand, bookVersionCommandParser, deflatePipeline, expectCommandParser, foreachCommandParser, formatCommandParser, formfactorCommandParser, getParserForCommand, instrumentCommandParser, isFlatPipeline, jokerCommandParser, knowledgeCommandParser, knowledgeSourceContentToName, modelCommandParser, parameterCommandParser, parseCommand, personaCommandParser, postprocessCommandParser, removePipelineCommand, renamePipelineParameter, sectionCommandParser, stringifyPipelineJson, urlCommandParser };
 //# sourceMappingURL=index.es.js.map