@promptbook/utils 0.103.0-55 → 0.103.0-66

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import spaceTrim$1, { spaceTrim as spaceTrim$2 } from 'spacetrim';
+import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { basename } from 'path';
 import { randomBytes } from 'crypto';
 import { SHA256 } from 'crypto-js';
@@ -18,12 +18,23 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-55';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-66';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Trims string from all 4 sides
+ *
+ * Note: This is a re-exported function from the `spacetrim` package which is
+ *       Developed by same author @hejny as this package
+ *
+ * @public exported from `@promptbook/utils`
+ * @see https://github.com/hejny/spacetrim#usage
+ */
+const spaceTrim = spaceTrim$1;
+
 /**
  * @private util of `@promptbook/color`
  * @de
@@ -72,6 +83,7 @@ function take(initialValue) {
  * @public exported from `@promptbook/color`
  */
 const CSS_COLORS = {
+    promptbook: '#79EAFD',
     transparent: 'rgba(0,0,0,0)',
     aliceblue: '#f0f8ff',
     antiquewhite: '#faebd7',
@@ -272,21 +284,61 @@ class Color {
      * @param color
      * @returns Color object
      */
-    static from(color) {
-        if (color instanceof Color) {
+    static from(color, _isSingleValue = false) {
+        if (color === '') {
+            throw new Error(`Can not create color from empty string`);
+        }
+        else if (color instanceof Color) {
             return take(color);
         }
         else if (Color.isColor(color)) {
             return take(color);
         }
         else if (typeof color === 'string') {
-            return Color.fromString(color);
+            try {
+                return Color.fromString(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                if (_isSingleValue) {
+                    throw error;
+                }
+                const parts = color.split(/[\s+,;|]/);
+                if (parts.length > 0) {
+                    return Color.from(parts[0].trim(), true);
+                }
+                else {
+                    throw new Error(`Can not create color from given string "${color}"`);
+                }
+            }
         }
         else {
             console.error({ color });
             throw new Error(`Can not create color from given object`);
         }
     }
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+     *
+     * @param color
+     * @returns Color object
+     */
+    static fromSafe(color) {
+        try {
+            return Color.from(color);
+        }
+        catch (error) {
+            // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+            console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+            return Color.fromString('promptbook');
+        }
+    }
     /**
      * Creates a new Color instance from miscellaneous string formats
      *
@@ -876,7 +928,7 @@ const ADMIN_GITHUB_NAME = 'hejny';
  *
  * @public exported from `@promptbook/core`
  */
-const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
+const PROMPTBOOK_COLOR = Color.fromString('promptbook');
 // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
 /**
  * Colors for syntax highlighting in the `<BookEditor/>`
@@ -1012,7 +1064,7 @@ function $deepFreeze(objectValue) {
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$1((block) => `
+        body: spaceTrim$2((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1055,7 +1107,7 @@ function getErrorReportUrl(error) {
  */
 class UnexpectedError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1081,7 +1133,7 @@ class WrappedError extends Error {
     constructor(whatWasThrown) {
         const tag = `[🤮]`;
         console.error(tag, whatWasThrown);
-        super(spaceTrim$2(`
+        super(spaceTrim$1(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1170,7 +1222,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1189,7 +1241,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1212,7 +1264,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim$1((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1244,7 +1296,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -1928,7 +1980,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
         .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
         .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
         .join('\n');
-    const promptbookMermaid = spaceTrim$2((block) => `
+    const promptbookMermaid = spaceTrim$1((block) => `
 
             %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
 
@@ -2104,7 +2156,7 @@ class LimitReachedError extends Error {
  */
 class MissingToolsError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -2148,7 +2200,7 @@ class NotFoundError extends Error {
  */
 class NotYetImplementedError extends Error {
     constructor(message) {
-        super(spaceTrim$2((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -2333,7 +2385,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim$1((block) => `
+        message = spaceTrim$2((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -2354,7 +2406,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$1((block) => `
+        console.error(spaceTrim$2((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -2460,7 +2512,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim$1(`
+        throw new Error(spaceTrim$2(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -2474,7 +2526,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim$1((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -2674,7 +2726,7 @@ function templateParameters(template, parameters) {
  */
 function prompt(strings, ...values) {
     if (values.length === 0) {
-        return spaceTrim$1(strings.join(''));
+        return spaceTrim$2(strings.join(''));
     }
     const stringsWithHiddenParameters = strings.map((stringsItem) => 
     // TODO: [0] DRY
@@ -2685,7 +2737,7 @@ function prompt(strings, ...values) {
     let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
         ? `${result}${stringsItem}`
         : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
-    pipelineString = spaceTrim$1(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     try {
         pipelineString = templateParameters(pipelineString, parameters);
     }
@@ -2694,7 +2746,7 @@ function prompt(strings, ...values) {
             throw error;
         }
         console.error({ pipelineString, parameters, placeholderParameterNames, error });
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Internal error in prompt template literal
                   
                     ${block(JSON.stringify({ strings, values }, null, 4))}}
@@ -2981,7 +3033,7 @@ function $getCurrentDate() {
  * @public exported from `@promptbook/utils`
  */
 function computeHash(value) {
-    return SHA256(hexEncoder.parse(spaceTrim$1(valueToString(value)))).toString( /* hex */);
+    return SHA256(hexEncoder.parse(spaceTrim$2(valueToString(value)))).toString( /* hex */);
 }
 /**
  * TODO: [🥬][🥬] Use this ACRY
@@ -3221,7 +3273,7 @@ function nameToUriParts(name) {
  * @public exported from `@promptbook/utils`
  */
 function normalizeMessageText(text) {
-    return spaceTrim$2(text);
+    return spaceTrim$1(text);
 }
 
 /**
@@ -3371,7 +3423,7 @@ function unwrapResult(text, options) {
     let trimmedText = text;
     // Remove leading and trailing spaces and newlines
     if (isTrimmed) {
-        trimmedText = spaceTrim$2(trimmedText);
+        trimmedText = spaceTrim$1(trimmedText);
     }
     let processedText = trimmedText;
     if (isIntroduceSentenceRemoved) {
@@ -3380,7 +3432,7 @@ function unwrapResult(text, options) {
             // Remove the introduce sentence and quotes by replacing it with an empty string
             processedText = processedText.replace(introduceSentenceRegex, '');
         }
-        processedText = spaceTrim$2(processedText);
+        processedText = spaceTrim$1(processedText);
     }
     if (processedText.length < 3) {
         return trimmedText;
@@ -3424,17 +3476,6 @@ function unwrapResult(text, options) {
  * TODO: [🧠] Should this also unwrap the (parenthesis)
  */
 
-/**
- * Trims string from all 4 sides
- *
- * Note: This is a re-exported function from the `spacetrim` package which is
- *       Developed by same author @hejny as this package
- *
- * @public exported from `@promptbook/utils`
- * @see https://github.com/hejny/spacetrim#usage
- */
-const spaceTrim = spaceTrim$2;
-
 /**
  * Parses the task and returns the list of all parameter names
  *
@@ -3572,7 +3613,7 @@ function serializeToPromptbookJavascript(value) {
         imports.push(`import { Color } from '@promptbook/color';`);
     }
     else if (typeof value === 'string') {
-        const trimmed = spaceTrim$1(value);
+        const trimmed = spaceTrim$2(value);
         if (trimmed.includes('\n')) {
             // Multiline string -> use `spaceTrim`
             serializedValue = `spaceTrim(\`\n${value.replace(/`/g, '\\`')}\n\`)`;