@promptbook/fake-llm 0.105.0-20 → 0.105.0-21

package/esm/index.es.js

@@ -21,7 +21,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.105.0-20';
+const PROMPTBOOK_ENGINE_VERSION = '0.105.0-21';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -13,7 +13,17 @@ import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
+import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
+import { ChatSoundToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
+import { ChatEffectsSystem } from '../book-components/Chat/effects/ChatEffectsSystem';
+import { ConfettiEffect } from '../book-components/Chat/effects/components/ConfettiEffect';
+import { HeartsEffect } from '../book-components/Chat/effects/components/HeartsEffect';
+import { defaultEffectConfigs } from '../book-components/Chat/effects/configs/defaultEffectConfigs';
+import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
+import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
+import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
+import type { ChatEffectType } from '../book-components/Chat/effects/types/ChatEffectType';
 import { useChatAutoScroll } from '../book-components/Chat/hooks/useChatAutoScroll';
 import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
 import { useSendMessageToLlmChat } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
@@ -71,7 +81,17 @@ export { BookEditor };
 export { AgentChat };
 export type { AgentChatProps };
 export { Chat };
+export type { ChatSoundSystem };
 export type { ChatProps };
+export { ChatSoundToggle };
+export { ChatEffectsSystem };
+export { ConfettiEffect };
+export { HeartsEffect };
+export { defaultEffectConfigs };
+export type { ChatEffect };
+export type { ChatEffectConfig };
+export type { ChatEffectsSystemProps };
+export type { ChatEffectType };
 export { useChatAutoScroll };
 export type { SendMessageToLlmChatFunction };
 export { useSendMessageToLlmChat };

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

@@ -9,7 +9,13 @@ import type { AvatarProfileProps } from '../book-components/AvatarProfile/Avatar
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
+import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatSoundToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
+import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
+import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
+import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
+import type { ChatEffectType } from '../book-components/Chat/effects/types/ChatEffectType';
 import type { ChatAutoScrollConfig } from '../book-components/Chat/hooks/useChatAutoScroll';
 import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
@@ -392,7 +398,13 @@ export type { AvatarProfileProps };
 export type { AvatarProfileFromSourceProps };
 export type { BookEditorProps };
 export type { AgentChatProps };
+export type { ChatSoundSystem };
 export type { ChatProps };
+export type { ChatSoundToggleProps };
+export type { ChatEffect };
+export type { ChatEffectConfig };
+export type { ChatEffectsSystemProps };
+export type { ChatEffectType };
 export type { ChatAutoScrollConfig };
 export type { SendMessageToLlmChatFunction };
 export type { LlmChatProps };

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

@@ -6,6 +6,21 @@ import { string_color } from '../../../types/typeAliases';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Interface for sound system that can be passed to Chat component
+ * This allows the chat to trigger sounds without tight coupling
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatSoundSystem = {
+    /**
+     * @@@
+     */
+    play(event: string): Promise<void>;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    toggle(): boolean;
+};
 /**
  * @public exported from `@promptbook/components`
  */
@@ -202,6 +217,49 @@ export type ChatProps = {
      * Visual style of the chat component
      */
     readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    /**
+     * Optional array of effect configurations for chat animations
+     * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages
+     *
+     * Example:
+     * ```typescript
+     * [
+     *   { trigger: '🎉', effectType: 'CONFETTI' },
+     *   { trigger: /❤️|💙|💚/, effectType: 'HEARTS' }
+     * ]
+     * ```
+     */
+    readonly effectConfigs?: ReadonlyArray<{
+        trigger: string | RegExp;
+        effectType: string;
+    }>;
+    /**
+     * Optional sound system for playing chat sounds
+     * When provided, enables sound effects for message events, button clicks, and visual effects
+     *
+     * The sound system should implement the ChatSoundSystem interface:
+     * - play(event: string): Plays a sound for the given event
+     * - isEnabled(): Returns whether sounds are enabled
+     * - setEnabled(enabled: boolean): Enables or disables sounds
+     * - toggle(): Toggles sound on/off and returns the new state
+     *
+     * Supported events:
+     * - 'message_send': When user sends a message
+     * - 'message_receive': When agent sends a message
+     * - 'message_typing': When agent is typing/thinking
+     * - 'button_click': When any button is clicked
+     * - 'effect_confetti': When confetti effect is triggered
+     * - 'effect_hearts': When hearts effect is triggered
+     *
+     * @example
+     * ```typescript
+     * import { createDefaultSoundSystem } from '@/utils/sound/createDefaultSoundSystem';
+     *
+     * const soundSystem = createDefaultSoundSystem();
+     * <Chat soundSystem={soundSystem} ... />
+     * ```
+     */
+    readonly soundSystem?: ChatSoundSystem;
 };
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)

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

@@ -0,0 +1,23 @@
+import type { ChatSoundSystem } from './ChatProps';
+/**
+ * Props for the ChatSoundToggle component
+ */
+export type ChatSoundToggleProps = {
+    /**
+     * The sound system instance
+     */
+    soundSystem: ChatSoundSystem;
+    /**
+     * Optional CSS class name
+     */
+    className?: string;
+};
+/**
+ * ChatSoundToggle component
+ *
+ * Renders a toggle button/checkbox to enable/disable chat sounds.
+ * The state is persisted in localStorage via the SoundSystem.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatSoundToggle(props: ChatSoundToggleProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { ChatEffectsSystemProps } from './types/ChatEffectsSystemProps';
+/**
+ * ChatEffectsSystem component
+ * Monitors chat messages and triggers visual effects based on emoji content
+ *
+ * This component:
+ * - Tracks which messages have already been processed
+ * - Detects emojis in new agent messages
+ * - Triggers appropriate effects (confetti, hearts, etc.)
+ * - Handles effect lifecycle (creation, completion, cleanup)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatEffectsSystem(props: ChatEffectsSystemProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,18 @@
+type ConfettiEffectProps = {
+    /**
+     * Unique identifier for this effect instance
+     */
+    effectId: string;
+    /**
+     * Callback when the effect completes
+     */
+    onComplete?: () => void;
+};
+/**
+ * Confetti effect component
+ * Renders falling confetti particles from the top of the screen
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ConfettiEffect(props: ConfettiEffectProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,18 @@
+type HeartsEffectProps = {
+    /**
+     * Unique identifier for this effect instance
+     */
+    effectId: string;
+    /**
+     * Callback when the effect completes
+     */
+    onComplete?: () => void;
+};
+/**
+ * Hearts effect component
+ * Renders floating hearts that rise from the bottom of the screen
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function HeartsEffect(props: HeartsEffectProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,7 @@
+import type { ChatEffectConfig } from '../types/ChatEffectConfig';
+/**
+ * Default effect configurations for common chat emojis
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const defaultEffectConfigs: ReadonlyArray<ChatEffectConfig>;

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

@@ -0,0 +1,18 @@
+/**
+ * Chat effects system exports
+ *
+ * @packageDocumentation
+ */
+export { ChatEffectsSystem } from './ChatEffectsSystem';
+export { ConfettiEffect } from './components/ConfettiEffect';
+export { HeartsEffect } from './components/HeartsEffect';
+export { defaultEffectConfigs } from './configs/defaultEffectConfigs';
+export type { ChatEffect } from './types/ChatEffect';
+export type { ChatEffectConfig } from './types/ChatEffectConfig';
+export type { ChatEffectsSystemProps } from './types/ChatEffectsSystemProps';
+export type { ChatEffectType } from './types/ChatEffectType';
+export { detectEffects } from './utils/detectEffects';
+/**
+ * TODO: !!!!! To rules: Do not create index files that re-ex-port from multiple files, import directly instead or use full register
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,20 @@
+import type { ChatEffectType } from './ChatEffectType';
+/**
+ * Represents a chat effect instance
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatEffect = {
+    /**
+     * Unique identifier for this effect instance
+     */
+    id: string;
+    /**
+     * Type of effect
+     */
+    type: ChatEffectType;
+    /**
+     * Timestamp when the effect was triggered
+     */
+    timestamp: number;
+};

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

@@ -0,0 +1,21 @@
+import type { ChatEffectType } from './ChatEffectType';
+/**
+ * Configuration for a chat effect trigger
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatEffectConfig = {
+    /**
+     * Emoji or pattern that triggers this effect
+     */
+    trigger: string | RegExp;
+    /**
+     * Type of effect to trigger
+     */
+    effectType: ChatEffectType;
+    /**
+     * Whether to match all heart emojis (❤️, 💙, 💚, etc.)
+     * Only relevant for heart effects
+     */
+    matchAllHeartEmojis?: boolean;
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Types of chat effects that can be triggered
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatEffectType = 'CONFETTI' | 'HEARTS';

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

@@ -0,0 +1,32 @@
+import type { ChatSoundSystem } from '../../Chat/ChatProps';
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatEffectConfig } from './ChatEffectConfig';
+/**
+ * Props for the ChatEffectsSystem component
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatEffectsSystemProps = {
+    /**
+     * Array of chat messages to monitor for effect triggers
+     */
+    messages: ReadonlyArray<ChatMessage>;
+    /**
+     * Array of effect configurations
+     * Defines which emojis/patterns trigger which effects
+     */
+    effectConfigs: ReadonlyArray<ChatEffectConfig>;
+    /**
+     * Optional filter function to determine if a message should trigger effects
+     * By default, only agent messages trigger effects
+     */
+    shouldTriggerEffect?: (message: ChatMessage) => boolean;
+    /**
+     * CSS class name for the effects container
+     */
+    className?: string;
+    /**
+     * Optional sound system to play sounds when effects are triggered
+     */
+    soundSystem?: ChatSoundSystem;
+};

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

@@ -0,0 +1,12 @@
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatEffectConfig } from '../types/ChatEffectConfig';
+import type { ChatEffectType } from '../types/ChatEffectType';
+/**
+ * Detects which effects should be triggered based on message content
+ *
+ * @param message - The chat message to analyze
+ * @param effectConfigs - Array of effect configurations
+ * @returns Array of unique effect types to trigger
+ * @private utility function of Effects system
+ */
+export declare function detectEffects(message: ChatMessage, effectConfigs: ReadonlyArray<ChatEffectConfig>): ChatEffectType[];

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.105.0-19`).
+ * It follows semantic versioning (e.g., `0.105.0-20`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/fake-llm",
-    "version": "0.105.0-20",
+    "version": "0.105.0-21",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -96,7 +96,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/fake-llm.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.105.0-20"
+        "@promptbook/core": "0.105.0-21"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -24,7 +24,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-20';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-21';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name