@promptbook/node 0.101.0-0 → 0.101.0-2

package/esm/typings/src/_packages/components.index.d.ts

@@ -16,6 +16,12 @@ import { LlmChat } from '../book-components/Chat/LlmChat/LlmChat';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
+import { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
+import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
+import { ArrowIcon } from '../book-components/icons/ArrowIcon';
+import { ResetIcon } from '../book-components/icons/ResetIcon';
+import { SendIcon } from '../book-components/icons/SendIcon';
+import { TemplateIcon } from '../book-components/icons/TemplateIcon';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export type { AvatarChipProps };
 export { AvatarChip };
@@ -34,3 +40,9 @@ export { LlmChat };
 export type { LlmChatProps };
 export type { ChatMessage };
 export type { ChatParticipant };
+export { renderMarkdown };
+export { isMarkdownContent };
+export { ArrowIcon };
+export { ResetIcon };
+export { SendIcon };
+export { TemplateIcon };

package/esm/typings/src/book-components/Chat/Chat/Chat.d.ts

@@ -1,9 +1,4 @@
 import type { ChatProps } from './ChatProps';
-/**
- * @deprecated use `isComplete` instead
- * @private util of `<Chat />`
- */
-export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
 /**
  * Renders a chat with messages and input for new messages
  *

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -23,10 +23,16 @@ export type ChatProps = {
      * Called when user sends a message
      *
      * Note: You must handle the message yourself and add it to the `messages` array
+     *
+     * - When set, the send textarea and button will be shown
+     * - When undefined, the chat has no input and is read-only showing only the messages
      */
-    onMessage(messageContent: string): Promisable<void>;
+    onMessage?(messageContent: string): Promisable<void>;
     /**
-     * Optional callback, when set, button for resetting chat will be shown
+     * Optional callback
+     *
+     * - When set, button for resetting chat will be shown
+     * - When undefined, no reset button will be shown
      */
     onReset?(): Promisable<void>;
     /**

package/esm/typings/src/book-components/Chat/Chat/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @deprecated use `isComplete` instead
+ * @private util of `<Chat />`
+ */
+export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-components/Chat/examples/ChatMarkdownDemo.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Demo component showing Chat with markdown rendering capabilities
+ *
+ * This example demonstrates various markdown features supported by the Chat component:
+ * - Headers
+ * - Bold and italic text
+ * - Code blocks and inline code
+ * - Lists (ordered and unordered)
+ * - Links
+ * - Blockquotes
+ * - Tables
+ * - Strikethrough text
+ *
+ * @private temporary for testing purposes
+ */
+export declare function ChatMarkdownDemo(): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/Chat/utils/renderMarkdown.d.ts

@@ -0,0 +1,21 @@
+import type { string_html, string_markdown } from '../../../types/typeAliases';
+/**
+ * Convert markdown content to HTML for display in chat messages
+ *
+ * @param markdown - The markdown content to convert
+ * @returns HTML string ready for rendering
+ *
+ * @public exported from `@promptbook/components`
+ *         <- TODO: [🧠] Maybe export from `@promptbook/markdown-utils`
+ */
+export declare function renderMarkdown(markdown: string_markdown): string_html;
+/**
+ * Check if content appears to be markdown (contains markdown syntax)
+ *
+ * @param content - Content to check
+ * @returns true if content appears to contain markdown syntax
+ *
+ * @public exported from `@promptbook/components`
+ *         <- TODO: [🧠] Maybe export from `@promptbook/markdown-utils`
+ */
+export declare function isMarkdownContent(content: string): boolean;

package/esm/typings/src/book-components/Chat/utils/renderMarkdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/book-components/icons/ArrowIcon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shows simple arrow icon pointing up or down
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ArrowIcon: ({ direction, size }: {
+    direction: string;
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/ResetIcon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shows simple reset icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ResetIcon: () => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/SendIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple send icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const SendIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/TemplateIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple template icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const TemplateIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/utils/markdown/escapeMarkdownBlock.d.ts

@@ -3,6 +3,8 @@ import type { string_markdown_text } from '../../types/typeAliases';
  * Function escapeMarkdownBlock will escape markdown block if needed
  * It is useful when you want have block in block
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function escapeMarkdownBlock(value: string_markdown_text): string_markdown_text;

package/esm/typings/src/utils/markdown/humanizeAiText.d.ts

@@ -2,6 +2,7 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Function `humanizeAiText` will remove traces of AI text generation artifacts
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: If you want more control, look for other functions for example `humanizeAiTextEmdashed` exported `@promptbook/markdown-utils`
  *
  * @public exported from `@promptbook/markdown-utils`

package/esm/typings/src/utils/markdown/humanizeAiTextEllipsis.d.ts

@@ -2,6 +2,7 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Change ellipsis character to three dots `…` -> `...`
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
  *
  * @public exported from `@promptbook/markdown-utils`

package/esm/typings/src/utils/markdown/humanizeAiTextEmdashed.d.ts

@@ -2,6 +2,7 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Change em-dashes to regular dashes `—` -> `-`
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
  *
  * @public exported from `@promptbook/markdown-utils`

package/esm/typings/src/utils/markdown/humanizeAiTextQuotes.d.ts

@@ -2,6 +2,7 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Change smart quotes to regular quotes
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
  *
  * @public exported from `@promptbook/markdown-utils`

package/esm/typings/src/utils/markdown/humanizeAiTextWhitespace.d.ts

@@ -2,6 +2,7 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Change unprintable hard spaces to regular spaces
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
  *
  * @public exported from `@promptbook/markdown-utils`

package/esm/typings/src/utils/markdown/prettifyMarkdown.d.ts

@@ -7,3 +7,11 @@ import type { string_html } from '../../types/typeAliases';
  * @private withing the package because of HUGE size of prettier dependency
  */
 export declare function prettifyMarkdown<TContent extends string_html>(content: TContent): TContent;
+/**
+ * Async version of prettifyMarkdown using dynamic imports
+ *
+ * @param content raw html code
+ * @returns formatted html code
+ * @private withing the package because of HUGE size of prettier dependency
+ */
+export declare function prettifyMarkdownAsync<TContent extends string_html>(content: TContent): Promise<TContent>;

package/esm/typings/src/utils/markdown/promptbookifyAiText.d.ts

@@ -6,6 +6,7 @@ import { string_markdown } from '../../types/typeAliases';
  */
 export declare function promptbookifyAiText(text: string_markdown): string_markdown;
 /**
+ * TODO: !!!!! Make the function idempotent and add "Note: [🔂] This function is idempotent."
  * TODO: [🅾️]!!! Use this across the project where AI text is involved
  * TODO: [🧠][✌️] Make some Promptbook-native token system
  */

package/esm/typings/src/utils/normalization/capitalize.d.ts

@@ -1,6 +1,8 @@
 /**
  * Makes first letter of a string uppercase
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function capitalize(word: string): string;

package/esm/typings/src/utils/normalization/decapitalize.d.ts

@@ -1,5 +1,7 @@
 /**
- * Makes first letter of a string uppercase
+ * Makes first letter of a string lowercase
+ *
+ * Note: [🔂] This function is idempotent.
  *
  * @public exported from `@promptbook/utils`
  */

package/esm/typings/src/utils/normalization/normalizeTo_SCREAMING_CASE.d.ts

@@ -9,6 +9,8 @@ export type string_SCREAMING_CASE = string;
 /**
  * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text string to be converted to SCREAMING_CASE format.
  * @returns The normalized text in SCREAMING_CASE format.
  * @example 'HELLO_WORLD'

package/esm/typings/src/utils/normalization/normalizeTo_snake_case.d.ts

@@ -8,6 +8,8 @@ export type string_snake_case = string;
 /**
  * Normalizes a text string to snake_case format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text string to be converted to snake_case format.
  * @returns The normalized text in snake_case format.
  * @example 'hello_world'

package/esm/typings/src/utils/normalization/normalizeWhitespaces.d.ts

@@ -1,6 +1,8 @@
 /**
  * Take every whitespace (space, new line, tab) and replace it with a single space
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function normalizeWhitespaces(sentence: string): string;

package/esm/typings/src/utils/normalization/removeDiacritics.d.ts

@@ -1,6 +1,8 @@
 /**
  * Removes diacritic marks (accents) from characters in a string.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param input The string containing diacritics to be normalized.
  * @returns The string with diacritics removed or normalized.
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/parseNumber.d.ts

@@ -1,6 +1,7 @@
 /**
  * Function parseNumber will parse number from string
  *
+ * Note: [🔂] This function is idempotent.
  * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
  * Note: it also works only with decimal numbers
  *

package/esm/typings/src/utils/removeEmojis.d.ts

@@ -1,6 +1,8 @@
 /**
  * Removes emojis from a string and fix whitespaces
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text with emojis
  * @returns text without emojis
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/removeQuotes.d.ts

@@ -1,6 +1,7 @@
 /**
  * Removes quotes from a string
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: This is very useful for post-processing of the result of the LLM model
  * Note: This function removes only the same quotes from the beginning and the end of the string
  * Note: There are two similar functions:

package/esm/typings/src/utils/serialization/deepClone.d.ts

@@ -2,6 +2,7 @@ import type { WritableDeep } from 'type-fest';
 /**
  * Creates a deep clone of the given object
  *
+ * Note: [🔂] This function is idempotent.
  * Note: This method only works for objects that are fully serializable to JSON and do not contain functions, Dates, or special types.
  *
  * @param objectValue The object to clone.

package/esm/typings/src/utils/trimCodeBlock.d.ts

@@ -1,6 +1,7 @@
 /**
  * Function trimCodeBlock will trim starting and ending code block from the string if it is present.
  *
+ * Note: [🔂] This function is idempotent.
  * Note: This is useful for post-processing of the result of the chat LLM model
  *       when the model wraps the result in the (markdown) code block.
  *

package/esm/typings/src/utils/validators/url/isValidUrl.d.ts

@@ -3,6 +3,7 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Tests if given string is valid URL.
  *
+ * Note: [🔂] This function is idempotent.
  * Note: Dataurl are considered perfectly valid.
  * Note: There are two similar functions:
  * - `isValidUrl` which tests any URL

package/esm/typings/src/utils/validators/uuid/isValidUuid.d.ts

@@ -3,6 +3,8 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Checks if value is valid uuid
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function isValidUuid(value: really_unknown): value is string_uuid;

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.100.4-0`).
+ * It follows semantic versioning (e.g., `0.101.0-1`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.101.0-0",
+    "version": "0.101.0-2",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-0"
+        "@promptbook/core": "0.101.0-2"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('fs/promises'), require('path'), require('spacetrim'), require('jszip'), require('prettier/parser-html'), require('prettier/parser-markdown'), require('prettier/standalone'), require('crypto'), require('rxjs'), require('waitasecond'), require('papaparse'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('child_process'), require('dotenv')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'fs/promises', 'path', 'spacetrim', 'jszip', 'prettier/parser-html', 'prettier/parser-markdown', 'prettier/standalone', 'crypto', 'rxjs', 'waitasecond', 'papaparse', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'child_process', 'dotenv'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-node"] = {}, global.colors, global.promises, global.path, global.spaceTrim, global.JSZip, global.parserHtml, global.parserMarkdown, global.standalone, global.crypto, global.rxjs, global.waitasecond, global.papaparse, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.child_process, global.dotenv));
-})(this, (function (exports, colors, promises, path, spaceTrim, JSZip, parserHtml, parserMarkdown, standalone, crypto, rxjs, waitasecond, papaparse, hexEncoder, sha256, cryptoJs, mimeTypes, child_process, dotenv) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('fs/promises'), require('path'), require('spacetrim'), require('jszip'), require('crypto'), require('rxjs'), require('waitasecond'), require('papaparse'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('child_process'), require('dotenv')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'fs/promises', 'path', 'spacetrim', 'jszip', 'crypto', 'rxjs', 'waitasecond', 'papaparse', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'child_process', 'dotenv'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-node"] = {}, global.colors, global.promises, global.path, global.spaceTrim, global.JSZip, global.crypto, global.rxjs, global.waitasecond, global.papaparse, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.child_process, global.dotenv));
+})(this, (function (exports, colors, promises, path, spaceTrim, JSZip, crypto, rxjs, waitasecond, papaparse, hexEncoder, sha256, cryptoJs, mimeTypes, child_process, dotenv) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -27,8 +27,6 @@
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var JSZip__default = /*#__PURE__*/_interopDefaultLegacy(JSZip);
-    var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
-    var parserMarkdown__default = /*#__PURE__*/_interopDefaultLegacy(parserMarkdown);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
@@ -47,7 +45,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-2';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -611,6 +609,7 @@
     /**
      * Creates a deep clone of the given object
      *
+     * Note: [🔂] This function is idempotent.
      * Note: This method only works for objects that are fully serializable to JSON and do not contain functions, Dates, or special types.
      *
      * @param objectValue The object to clone.
@@ -805,6 +804,7 @@
     /**
      * Tests if given string is valid URL.
      *
+     * Note: [🔂] This function is idempotent.
      * Note: Dataurl are considered perfectly valid.
      * Note: There are two similar functions:
      * - `isValidUrl` which tests any URL
@@ -1315,10 +1315,20 @@
      * @private withing the package because of HUGE size of prettier dependency
      */
     function prettifyMarkdown(content) {
+        // In browser/Next.js environments, just return the original content
+        // since prettier parsers are not available and would cause bundling issues
+        if (typeof window !== 'undefined') {
+            return content;
+        }
         try {
-            return standalone.format(content, {
+            // Use dynamic require to avoid static imports that cause bundling issues
+            // This will only work in Node.js environments
+            const prettierStandalone = eval('require')('prettier/standalone');
+            const parserMarkdown = eval('require')('prettier/parser-markdown');
+            const parserHtml = eval('require')('prettier/parser-html');
+            return prettierStandalone.format(content, {
                 parser: 'markdown',
-                plugins: [parserMarkdown__default["default"], parserHtml__default["default"]],
+                plugins: [parserMarkdown, parserHtml],
                 // TODO: DRY - make some import or auto-copy of .prettierrc
                 endOfLine: 'lf',
                 tabWidth: 4,
@@ -1344,6 +1354,8 @@
     /**
      * Makes first letter of a string uppercase
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/utils`
      */
     function capitalize(word) {
@@ -3847,6 +3859,8 @@
     /**
      * Removes diacritic marks (accents) from characters in a string.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param input The string containing diacritics to be normalized.
      * @returns The string with diacritics removed or normalized.
      * @public exported from `@promptbook/utils`
@@ -5376,6 +5390,8 @@
     /**
      * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text string to be converted to SCREAMING_CASE format.
      * @returns The normalized text in SCREAMING_CASE format.
      * @example 'HELLO_WORLD'
@@ -5431,6 +5447,8 @@
     /**
      * Normalizes a text string to snake_case format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text string to be converted to snake_case format.
      * @returns The normalized text in snake_case format.
      * @example 'hello_world'
@@ -5741,6 +5759,8 @@
     /**
      * Removes emojis from a string and fix whitespaces
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text with emojis
      * @returns text without emojis
      * @public exported from `@promptbook/utils`
@@ -6830,6 +6850,7 @@
     /**
      * Function parseNumber will parse number from string
      *
+     * Note: [🔂] This function is idempotent.
      * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
      * Note: it also works only with decimal numbers
      *
@@ -7092,6 +7113,7 @@
     /**
      * Removes quotes from a string
      *
+     * Note: [🔂] This function is idempotent.
      * Tip: This is very useful for post-processing of the result of the LLM model
      * Note: This function removes only the same quotes from the beginning and the end of the string
      * Note: There are two similar functions:
@@ -10714,7 +10736,9 @@
      */
 
     /**
-     * Makes first letter of a string uppercase
+     * Makes first letter of a string lowercase
+     *
+     * Note: [🔂] This function is idempotent.
      *
      * @public exported from `@promptbook/utils`
      */
@@ -10784,6 +10808,8 @@
     /**
      * Take every whitespace (space, new line, tab) and replace it with a single space
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeWhitespaces(sentence) {
@@ -10827,6 +10853,7 @@
     /**
      * Function trimCodeBlock will trim starting and ending code block from the string if it is present.
      *
+     * Note: [🔂] This function is idempotent.
      * Note: This is useful for post-processing of the result of the chat LLM model
      *       when the model wraps the result in the (markdown) code block.
      *