@promptbook/editable 0.112.0-32 → 0.112.0-35

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -32,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.spaceTrim;
 
     /**
-     * @private util of `@promptbook/color`
+     * Class implementing take chain.
+     *
      * @de
+     *
+     * @private util of `@promptbook/color`
      */
     class TakeChain {
         constructor(value) {
@@ -58,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) {
@@ -238,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.
@@ -270,7 +272,13 @@
         }
     }
 
+    /**
+     * 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.
@@ -303,6 +311,9 @@
         }
         return throwInvalidHex();
     }
+    /**
+     * Parses short hex channel.
+     */
     function parseShortHexChannel(char, onError) {
         if (!char) {
             return onError();
@@ -313,6 +324,9 @@
         }
         return parsed * 16;
     }
+    /**
+     * Parses long hex channel.
+     */
     function parseLongHexChannel(hex, start, onError) {
         const segment = hex.substr(start, 2);
         if (segment.length < 2) {
@@ -325,6 +339,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.
@@ -350,6 +367,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));
@@ -388,7 +408,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.
@@ -430,6 +456,9 @@
             alpha: parseAlphaValue(match[4]),
         };
     }
+    /**
+     * Parses channel value.
+     */
     function parseChannelValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -437,6 +466,9 @@
         }
         return Math.round(parseFloat(value));
     }
+    /**
+     * Parses alpha value.
+     */
     function parseAlphaValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -449,8 +481,17 @@
         return Math.round(parsed);
     }
 
+    /**
+     * Pattern matching hsl regex.
+     */
     const HSL_REGEX_PATTERN = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+    /**
+     * Pattern matching RGB regex.
+     */
     const RGB_REGEX_PATTERN = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba regex.
+     */
     const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
     /**
      * Color object represents an RGB color with alpha channel
@@ -816,9 +857,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
@@ -864,9 +903,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
@@ -884,9 +921,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
@@ -904,9 +939,7 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
-    /**
-     * TODO: Maybe implement by mix+hsl
-     */
+    // TODO: Maybe implement by mix+hsl
 
     /**
      * Returns the same value that is passed as argument.
@@ -919,6 +952,7 @@
      *
      * @param value any values
      * @returns the same values
+     *
      * @private within the repository
      */
     function just(value) {
@@ -1118,9 +1152,7 @@
             Object.setPrototypeOf(this, ParseError.prototype);
         }
     }
-    /**
-     * TODO: Maybe split `ParseError` and `ApplyError`
-     */
+    // TODO: Maybe split `ParseError` and `ApplyError`
 
     /**
      * Parses the boilerplate command
@@ -1128,6 +1160,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 = {
@@ -1261,12 +1294,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 +1318,7 @@
      * Parses the BOOK_VERSION command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const bookVersionCommandParser = {
@@ -1408,12 +1443,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 +1516,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 = {
@@ -1712,8 +1745,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',
@@ -1803,13 +1837,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 +1884,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 +1930,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 +1981,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 +1997,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 +2008,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 +2061,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 +2080,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 +2097,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,6 +2117,7 @@
      * - And much more...
      *
      * @throws UnexpectedError if the value is not serializable as JSON
+     *
      * @public exported from `@promptbook/utils`
      */
     function checkSerializableAsJson(options) {
@@ -2206,11 +2232,9 @@
                 `));
         }
     }
-    /**
-     * 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
-     */
+    // 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
 
     /**
      * Creates a deep clone of the given object
@@ -2220,6 +2244,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 +2261,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 +2274,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 +2294,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 +2322,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 +2334,7 @@
      * @returns The camelCase formatted string.
      * @example 'helloWorld'
      * @example 'iLovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -2354,10 +2375,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 +2631,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 +2640,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 +2649,7 @@
      *
      * @param text with emojis
      * @returns text without emojis
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeEmojis(text) {
@@ -2651,6 +2673,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeQuotes(text) {
@@ -2672,6 +2695,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) {
@@ -2742,6 +2766,7 @@
      * Parses the foreach command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const foreachCommandParser = {
@@ -2900,14 +2925,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 = {
@@ -3092,9 +3116,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
@@ -3246,9 +3268,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 +3276,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 = {
@@ -3351,6 +3372,7 @@
      * Parses the joker command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const jokerCommandParser = {
@@ -3421,6 +3443,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 +3492,7 @@
         }
         return false;
     }
-    /**
-     * TODO: [🍏] Implement for MacOs
-     */
+    // TODO: [🍏] Implement for MacOs
 
     /**
      * Tests if given string is valid URL.
@@ -3513,6 +3534,7 @@
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
      * @example 'i-love-promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeToKebabCase(text) {
@@ -3553,9 +3575,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 +3594,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 = {
@@ -3668,12 +3687,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 +3708,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 = {
@@ -3868,6 +3889,7 @@
      * Parses the parameter command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const parameterCommandParser = {
@@ -3978,6 +4000,7 @@
      * Parses the persona command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const personaCommandParser = {
@@ -4110,6 +4133,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 +4147,7 @@
      * Parses the postprocess command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const postprocessCommandParser = {
@@ -4238,6 +4263,7 @@
      * Parses the section command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const sectionCommandParser = {
@@ -4452,14 +4478,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 +4586,7 @@
      * Parses the action command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const actionCommandParser = {
@@ -4618,14 +4644,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 +4708,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 +4734,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
@@ -4743,6 +4764,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) {
@@ -4912,7 +4934,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 +4971,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 +4997,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,15 +5016,14 @@
         // <- 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) {
@@ -5081,9 +5101,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.
@@ -5139,10 +5157,8 @@
         }
         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
@@ -5201,6 +5217,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 +5251,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 +5270,6 @@
      * - `Symbol` objects are not serializable
      * - And much more...
      *
-     *
      * @public exported from `@promptbook/utils`
      */
     function isSerializableAsJson(value) {
@@ -5267,10 +5281,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
@@ -5298,12 +5310,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;