@promptbook/templates 0.102.0-12 → 0.102.0-16

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

@@ -34,6 +34,7 @@ import { CHAT_SAVE_FORMATS } from '../book-components/Chat/save/index';
 import { jsonSaveFormatDefinition } from '../book-components/Chat/save/json/jsonSaveFormatDefinition';
 import { mdSaveFormatDefinition } from '../book-components/Chat/save/markdown/mdSaveFormatDefinition';
 import { pdfSaveFormatDefinition } from '../book-components/Chat/save/pdf/pdfSaveFormatDefinition';
+import { reactSaveFormatDefinition } from '../book-components/Chat/save/react/reactSaveFormatDefinition';
 import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
@@ -87,6 +88,7 @@ export { CHAT_SAVE_FORMATS };
 export { jsonSaveFormatDefinition };
 export { mdSaveFormatDefinition };
 export { pdfSaveFormatDefinition };
+export { reactSaveFormatDefinition };
 export { txtSaveFormatDefinition };
 export type { ChatMessage };
 export type { ChatParticipant };

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

@@ -68,6 +68,7 @@ import { deepClone } from '../utils/serialization/deepClone';
 import { exportJson } from '../utils/serialization/exportJson';
 import { isSerializableAsJson } from '../utils/serialization/isSerializableAsJson';
 import { jsonStringsToJsons } from '../utils/serialization/jsonStringsToJsons';
+import { serializeToPromptbookJavascript } from '../utils/serialization/serializeToPromptbookJavascript';
 import { difference } from '../utils/sets/difference';
 import { intersection } from '../utils/sets/intersection';
 import { union } from '../utils/sets/union';
@@ -152,6 +153,7 @@ export { deepClone };
 export { exportJson };
 export { isSerializableAsJson };
 export { jsonStringsToJsons };
+export { serializeToPromptbookJavascript };
 export { difference };
 export { intersection };
 export { union };

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

@@ -25,11 +25,15 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Enables the feedback (rating) UI for this message bubble.
      */
     isFeedbackEnabled?: boolean;
+    /**
+     * Called when the copy button is pressed.
+     */
+    onCopy?: () => void;
 };
 /**
  * Renders a single chat message item with avatar, content, buttons, and rating.
  *
  * @private internal subcomponent of `<Chat>` component
  */
-export declare const ChatMessageItem: import("react").MemoExoticComponent<({ message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, }: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const ChatMessageItem: import("react").MemoExoticComponent<({ message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, }: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

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

@@ -12,6 +12,10 @@ export type ChatProps = {
      * If provided, renders the [Use this template] button.
      */
     onUseTemplate?(): void;
+    /**
+     * The title of the chat
+     */
+    readonly title: string;
     /**
      * Messages to render - they are rendered as they are
      */

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

@@ -1,13 +1,51 @@
+import type { Promisable } from 'type-fest';
 import type { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
 import type { ChatMessage } from '../../types/ChatMessage';
+import { ChatParticipant } from '../../types/ChatParticipant';
 /**
  * Plugin contract for chat export formatNames
+ *
  * @public exported from `@promptbook/components`
  */
 export type ChatSaveFormatDefinition = {
-    formatName: string_file_extension | string_mime_type | string;
-    label: string;
-    getContent: (messages: ChatMessage[]) => string;
-    mimeType: string;
-    fileExtension: string;
+    /**
+     * A unique name for the format (e.g. 'json', 'txt', 'md', 'html', 'pdf', etc.)
+     */
+    readonly formatName: string_file_extension | string_mime_type | string;
+    /**
+     * A human-readable label for the format (e.g. 'JSON', 'Plain Text', 'Markdown', 'HTML', 'PDF', etc.) shown in UI
+     */
+    readonly label: string;
+    /**
+     * MIME type (e.g. 'application/json', 'text/plain', 'text/markdown', 'text/html', 'application/pdf', etc.)
+     */
+    readonly mimeType: string;
+    /**
+     * File extension without leading dot (e.g. 'json', 'txt', 'md', 'html', 'pdf', etc.)
+     */
+    readonly fileExtension: string;
+    /**
+     * The function that generates the content of the file to be saved
+     */
+    getContent(chatExportData: ChatExportData): Promisable<string>;
 };
+/**
+ * Plugin contract for the data passed to `ChatSaveFormatDefinition.getContent()`
+ *
+ * @public exported from `@promptbook/components`
+ */
+type ChatExportData = {
+    /**
+     * The title of the chat (used for file naming, etc.)
+     */
+    readonly title: string;
+    /**
+     * The chat messages to be exported
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * The participants in the chat
+     */
+    readonly participants: ReadonlyArray<ChatParticipant>;
+};
+export {};

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

@@ -5,8 +5,12 @@
  */
 export declare const htmlSaveFormatDefinition: {
     readonly formatName: "html";
-    readonly label: "HTML";
-    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Html";
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/html";
     readonly fileExtension: "html";
 };

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

@@ -5,32 +5,62 @@
  */
 export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly formatName: "json";
-    readonly label: "JSON (full)";
-    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Json";
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "application/json";
     readonly fileExtension: "json";
 }, {
     readonly formatName: "txt";
     readonly label: "Plain Text";
-    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/plain";
     readonly fileExtension: "txt";
 }, {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/markdown";
     readonly fileExtension: "md";
 }, {
     readonly formatName: "html";
-    readonly label: "HTML";
-    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Html";
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/html";
     readonly fileExtension: "html";
+}, {
+    readonly formatName: "jsx";
+    readonly label: "React";
+    readonly getContent: (chatExportData: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => string;
+    readonly mimeType: "application/javascript";
+    readonly fileExtension: "jsx";
 }, {
     readonly formatName: "pdf";
-    readonly label: "PDF";
-    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Pdf";
+    readonly getContent: (chatExportData: {
+        readonly title: string;
+        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
+    }) => Promise<string>;
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 }];

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

@@ -5,8 +5,12 @@
  */
 export declare const jsonSaveFormatDefinition: {
     readonly formatName: "json";
-    readonly label: "JSON (full)";
-    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Json";
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "application/json";
     readonly fileExtension: "json";
 };

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

@@ -6,7 +6,11 @@
 export declare const mdSaveFormatDefinition: {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/markdown";
     readonly fileExtension: "md";
 };

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

@@ -5,8 +5,12 @@
  */
 export declare const pdfSaveFormatDefinition: {
     readonly formatName: "pdf";
-    readonly label: "PDF";
-    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly label: "Pdf";
+    readonly getContent: (chatExportData: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => Promise<string>;
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 };

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

@@ -0,0 +1,16 @@
+/**
+ * React <jsx/> export plugin (full metadata)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const reactSaveFormatDefinition: {
+    readonly formatName: "jsx";
+    readonly label: "React";
+    readonly getContent: (chatExportData: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => string;
+    readonly mimeType: "application/javascript";
+    readonly fileExtension: "jsx";
+};

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

@@ -6,7 +6,11 @@
 export declare const txtSaveFormatDefinition: {
     readonly formatName: "txt";
     readonly label: "Plain Text";
-    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly getContent: ({ messages }: {
+        readonly title: string;
+        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
+        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+    }) => string;
     readonly mimeType: "text/plain";
     readonly fileExtension: "txt";
 };

package/esm/typings/src/utils/color/Color.d.ts

@@ -111,6 +111,13 @@ export declare class Color {
      * @return {value is WithTake<Color>} Returns true if the value is a valid Color object, false otherwise.
      */
     static isColor(value: unknown): value is WithTake<Color>;
+    /**
+     * 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.)
+     */
+    static isHexColorString(value: unknown): value is string_color;
     /**
      * Creates new Color object
      *

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

@@ -0,0 +1,22 @@
+import { string_javascript } from '../../types/typeAliases';
+import { TODO_any } from '../organization/TODO_any';
+type SerializeToPromptbookJavascriptReturn = {
+    /**
+     * Array of import statements required for the `value` to work
+     */
+    readonly imports: ReadonlyArray<string_javascript>;
+    /**
+     * The serialized value as a string of JavaScript code
+     */
+    readonly value: string_javascript;
+};
+/**
+ * Function `serializeToPromptbookJavascript` will serialize a value to a javascript representation using `@promptbook/*` entities where possible.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function serializeToPromptbookJavascript(value: TODO_any): SerializeToPromptbookJavascriptReturn;
+export {};
+/**
+ * TODO: Dynamic indentation passable through options in a second argument
+ */

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.102.0-11`).
+ * It follows semantic versioning (e.g., `0.102.0-15`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/templates",
-    "version": "0.102.0-12",
+    "version": "0.102.0-16",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/templates.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.102.0-12"
+        "@promptbook/core": "0.102.0-16"
     },
     "dependencies": {
         "spacetrim": "0.11.59"