@promptbook/wizard 0.111.0-4 → 0.112.0-100

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

@@ -1,9 +0,0 @@
-/**
- * Default user-facing error text shown in chats when the generator fails.
- *
- * @private internal fallback for `LlmChat` so the same string can be reused across the stack without repetition.
- */
-export declare const DEFAULT_CHAT_FAIL_MESSAGE = "Sorry, I encountered an error processing your message. Please, try again later.";
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -1,16 +0,0 @@
-import type { string_markdown } from '../../../types/typeAliases';
-type MarkdownContentProps = {
-    content: string_markdown;
-    className?: string;
-    onCreateAgent?: (bookContent: string) => void;
-};
-/**
- * Renders markdown content with support for code highlighting, math, and tables.
- *
- * @public exported from `@promptbook/components`
- */
-export declare function MarkdownContent(props: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
-export {};
-/**
- * TODO: !!! Split into multiple files
- */

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

@@ -1,85 +0,0 @@
-import type { ChatProps } from '../Chat/ChatProps';
-/**
- * Delay configuration for the MockedChat component
- *
- * @public exported from `@promptbook/components`
- */
-export type MockedChatDelayConfig = {
-    /**
-     * Delay before showing the first message (ms)
-     * @default 1000
-     */
-    beforeFirstMessage?: number | [number, number];
-    /**
-     * Emulated thinking time between messages (ms)
-     * Can be a fixed number or [min, max] for random range.
-     * @default 2000
-     */
-    thinkingBetweenMessages?: number | [number, number];
-    /**
-     * Wait time after each written word (ms)
-     * Can be a fixed number or [min, max] for random range.
-     * @default 100
-     */
-    waitAfterWord?: number | [number, number];
-    /**
-     * Extra delay on top of the word waiting (ms)
-     * Can be a fixed number or [min, max] for random range.
-     * @default 50
-     */
-    extraWordDelay?: number | [number, number];
-    /**
-     * Chance (0-1) that a longer pause occurs before a message (e.g. agent switch)
-     * @default 0.2
-     */
-    longPauseChance?: number;
-    /**
-     * Range for long pause duration (ms), [min, max]
-     * @default [1200, 3500]
-     */
-    longPauseDuration?: [number, number];
-    /**
-     * If true, disables typing effect and shows full message at once (BLOCKY_FLOW)
-     */
-    blocky?: boolean;
-    /**
-     * This prop will allow to show N first messages immediately, while the rest will be typed out with delays
-     * @default 0
-     */
-    showIntermediateMessages?: number;
-};
-/**
- * Props for MockedChat component
- *
- * @public exported from `@promptbook/components`
- */
-export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
-    /**
-     * Whether the chat can be reset via the "New chat" button.
-     *
-     * When true (default), the reset button is shown and clicking it restarts the simulated flow.
-     * When false, the reset button is hidden (read-only simulation without manual restart).
-     *
-     * @default true
-     */
-    isResettable?: boolean;
-    /**
-     * Optional delays configuration for emulating typing behavior
-     */
-    delayConfig?: MockedChatDelayConfig;
-    /**
-     * When true, shows Pause/Resume control and allows pausing the simulated flow.
-     * Pausing finishes the currently typing message first (transitions via PAUSING state),
-     * then prevents new messages from starting until resumed.
-     *
-     * @default true
-     */
-    isPausable?: boolean;
-};
-/**
- * MockedChat component that shows the same chat as Chat but emulates ongoing discussion
- * with realistic typing delays and thinking pauses.
- *
- * @public exported from `@promptbook/components`
- */
-export declare function MockedChat(props: MockedChatProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,42 +0,0 @@
-import type { MockedChatDelayConfig } from './MockedChat';
-/**
- * Normal flow of messages in the `MockedChat` component
- *
- * @public exported from `@promptbook/components`
- */
-export declare const NORMAL_FLOW: MockedChatDelayConfig;
-/**
- * Fast flow of messages in the `MockedChat` component
- *
- * @public exported from `@promptbook/components`
- */
-export declare const FAST_FLOW: MockedChatDelayConfig;
-/**
- * Slow flow of messages in the `MockedChat` component
- *
- * @public exported from `@promptbook/components`
- */
-export declare const SLOW_FLOW: MockedChatDelayConfig;
-/**
- * Blocky flow of messages in the `MockedChat` component
- *
- * Messages appear in blocks rather than word-by-word
- *
- * @public exported from `@promptbook/components`
- */
-export declare const BLOCKY_FLOW: MockedChatDelayConfig;
-/**
- * Random flow of messages in the `MockedChat` component
- *
- * @public exported from `@promptbook/components`
- */
-export declare const RANDOM_FLOW: MockedChatDelayConfig;
-/**
- * All predefined delay configurations for the `MockedChat` component
- *
- * @public exported from `@promptbook/components`
- */
-export declare const MOCKED_CHAT_DELAY_CONFIGS: Record<string, MockedChatDelayConfig>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -1,39 +0,0 @@
-import type { ParsedCitation } from '../utils/parseCitationsFromContent';
-/**
- * Props for SourceChip component
- */
-export type SourceChipProps = {
-    /**
-     * Citation data to display
-     */
-    citation: ParsedCitation;
-    /**
-     * Click handler
-     */
-    onClick?: (citation: ParsedCitation) => void;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-    /**
-     * Optional suffix text to display after the citation label.
-     */
-    suffix?: string;
-};
-/**
- * SourceChip component - displays a chip with source document information
- *
- * This component is used to display RAG source citations in chat messages.
- * It displays the source document name and citation ID.
- *
- * @example
- * ```tsx
- * <SourceChip
- *   citation={{ id: '5:13', source: 'document.pdf' }}
- *   onClick={(citation) => console.log('clicked', citation)}
- * />
- * ```
- *
- * @private utility of `ChatMessageItem` component
- */
-export declare function SourceChip({ citation, onClick, className, suffix }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,18 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * 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/utils/detectEffects.d.ts

@@ -1,12 +0,0 @@
-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/book-components/Chat/hooks/useChatAutoScroll.d.ts

@@ -1,41 +0,0 @@
-/**
- * Configuration for the auto-scroll behavior
- */
-export type ChatAutoScrollConfig = {
-    /**
-     * Threshold in pixels from bottom to consider as "at bottom"
-     * @default 100
-     */
-    bottomThreshold?: number;
-    /**
-     * Whether to use smooth scrolling
-     * @default true
-     */
-    smoothScroll?: boolean;
-    /**
-     * Delay before checking scroll position after new messages (in milliseconds)
-     * @default 100
-     */
-    scrollCheckDelay?: number;
-};
-/**
- * Hook for managing auto-scroll behavior in chat components
- *
- * This hook provides:
- * - Automatic scrolling to bottom when new messages arrive (if user is already at bottom)
- * - Detection of when user scrolls away from bottom
- * - Scroll-to-bottom functionality with smooth animation
- * - Mobile-optimized scrolling behavior
- *
- * @public exported from `@promptbook/components`
- */
-export declare function useChatAutoScroll(config?: ChatAutoScrollConfig): {
-    isAutoScrolling: boolean;
-    chatMessagesRef: (element: HTMLDivElement | null) => void;
-    handleScroll: (event: React.UIEvent<HTMLDivElement>) => void;
-    handleMessagesChange: () => void;
-    scrollToBottom: () => void;
-    enableAutoScroll: () => void;
-    disableAutoScroll: () => void;
-    isMobile: boolean;
-};

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

@@ -1,89 +0,0 @@
-import type { Promisable } from 'type-fest';
-import type { id } from '../../../types/typeAliases';
-import type { ChatMessage } from '../types/ChatMessage';
-import type { ChatFeedbackResponse } from '../Chat/ChatProps';
-/**
- * Input parameters for the chat rating hook.
- *
- * @private component of `<Chat/>`
- */
-export type UseChatRatingsOptions = {
-    /**
-     * Messages in the chat thread.
-     */
-    messages: ReadonlyArray<ChatMessage>;
-    /**
-     * Optional feedback handler passed to Chat.
-     */
-    onFeedback?: (feedback: {
-        message: ChatMessage;
-        rating: number;
-        textRating: string;
-        chatThread: string;
-        expectedAnswer: string | null;
-        url: string;
-    }) => Promisable<ChatFeedbackResponse | void>;
-    /**
-     * Whether the UI should apply mobile-specific behavior.
-     */
-    isMobile: boolean;
-};
-/**
- * Indicates how the feedback status message should be rendered.
- *
- * @private component of `<Chat/>`
- */
-export type FeedbackStatusVariant = 'success' | 'error';
-/**
- * Data used to show the transient feedback status toast.
- *
- * @private component of `<Chat/>`
- */
-export type FeedbackStatus = {
-    /**
-     * Message displayed to the user.
-     */
-    readonly message: string;
-    /**
-     * Whether the message indicates success or failure.
-     */
-    readonly variant: FeedbackStatusVariant;
-};
-/**
- * Rating state tracked for the chat UI.
- *
- * @private component of `<Chat/>`
- */
-export type ChatRatingsState = {
-    ratingModalOpen: boolean;
-    selectedMessage: ChatMessage | null;
-    messageRatings: Map<id, number>;
-    textRating: string;
-    hoveredRating: number;
-    expandedMessageId: id | null;
-    feedbackStatus: FeedbackStatus | null;
-};
-/**
- * Rating actions for the chat UI.
- *
- * @private component of `<Chat/>`
- */
-export type ChatRatingsActions = {
-    setRatingModalOpen: (value: boolean) => void;
-    setSelectedMessage: (value: ChatMessage | null) => void;
-    setMessageRatings: (value: Map<id, number> | ((previous: Map<id, number>) => Map<id, number>)) => void;
-    setTextRating: (value: string) => void;
-    setHoveredRating: (value: number) => void;
-    setExpandedMessageId: (value: id | null) => void;
-    handleRating: (message: ChatMessage, newRating: number) => void;
-    submitRating: () => Promise<void>;
-};
-/**
- * Hook that centralizes rating state and handlers for Chat.
- *
- * @private component of `<Chat/>`
- */
-export declare function useChatRatings(options: UseChatRatingsOptions): {
-    state: ChatRatingsState;
-    actions: ChatRatingsActions;
-};

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

@@ -1,44 +0,0 @@
-/**
- * Function type for sending a message to LlmChat.
- *
- * Implementation detail: The returned function is "attachable".
- * LlmChat will call the internal `_attach` method (if present) to bind
- * its real message handler. Messages sent before attachment are queued
- * and flushed after attachment.
- *
- * @public exported from `@promptbook/components`
- */
-export type SendMessageToLlmChatFunction = {
-    /**
-     * Send a message to the bound LlmChat instance (or queue it until attached).
-     */
-    (message: string): void;
-    /**
-     * Internal method used by the <LlmChat/> component to attach its handler.
-     * Not intended for consumer usage.
-     *
-     * @internal
-     */
-    _attach?: (handler: (message: string) => Promise<void> | void) => void;
-};
-/**
- * Hook to create a sendMessage function for an <LlmChat/> component WITHOUT needing any React Context.
- *
- * Usage pattern:
- * ```tsx
- * const sendMessage = useSendMessageToLlmChat();
- * return (
- *   <>
- *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
- *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
- *   </>
- * );
- * ```
- *
- * - No provider wrapping needed.
- * - Safe to call before the <LlmChat/> mounts (messages will be queued).
- * - Keeps DRY by letting <LlmChat/> reuse its internal `handleMessage` logic.
- *
- * @public exported from `@promptbook/components`
- */
-export declare function useSendMessageToLlmChat(): SendMessageToLlmChatFunction;

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

@@ -1,57 +0,0 @@
-import type { Promisable } from 'type-fest';
-import type { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
-import type { ChatMessage } from '../../types/ChatMessage';
-import type { ChatParticipant } from '../../types/ChatParticipant';
-/**
- * Plugin contract for chat export formatNames
- *
- * @public exported from `@promptbook/components`
- */
-export type ChatSaveFormatDefinition = {
-    /**
-     * 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<ChatSaveFormatContent>;
-};
-/**
- * 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>;
-};
-/**
- * Content data that can be wrapped into a browser blob.
- *
- * @private Internal helper type for chat save plugins.
- */
-type ChatSaveFormatContent = string | Blob | ArrayBuffer | ArrayBufferView;
-export {};

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

@@ -1,6 +0,0 @@
-import { CHAT_SAVE_FORMATS } from '../index';
-/**
- * Supported chat export formatNames
- * @public exported from `@promptbook/components`
- */
-export type string_chat_format_name = (typeof CHAT_SAVE_FORMATS)[number]['formatName'];

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

@@ -1,21 +0,0 @@
-import type { ChatMessage } from '../../types/ChatMessage';
-import type { ChatParticipant } from '../../types/ChatParticipant';
-/**
- * HTML export plugin
- *
- * @public exported from `@promptbook/components`
- */
-export declare const htmlSaveFormatDefinition: {
-    readonly formatName: "html";
-    readonly label: "Html";
-    readonly getContent: ({ title, messages, participants }: {
-        readonly title: string;
-        readonly messages: readonly ChatMessage[];
-        readonly participants: readonly ChatParticipant[];
-    }) => string;
-    readonly mimeType: "text/html";
-    readonly fileExtension: "html";
-};
-/**
- * TODO: Enhance branding
- */

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

@@ -1,69 +0,0 @@
-/**
- * Registry of all built-in chat save plugins
- *
- * @public exported from `@promptbook/components`
- */
-export declare const CHAT_SAVE_FORMATS: readonly [{
-    readonly formatName: "json";
-    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 }: {
-        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 }: {
-        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: ({ title, messages, participants }: {
-        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, participants }: {
-        readonly title: string;
-        readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
-        readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
-    }) => Uint8Array;
-    readonly mimeType: "application/pdf";
-    readonly fileExtension: "pdf";
-}];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -1,16 +0,0 @@
-/**
- * Markdown export plugin
- *
- * @public exported from `@promptbook/components`
- */
-export declare const mdSaveFormatDefinition: {
-    readonly formatName: "md";
-    readonly label: "Markdown";
-    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/buildChatPdf.d.ts

@@ -1,11 +0,0 @@
-import type { ChatMessage } from '../../types/ChatMessage';
-import type { ChatParticipant } from '../../types/ChatParticipant';
-/**
- * Creates a minimal PDF representation of the provided chat.
- *
- * @param messages - Messages that should be included in the PDF export.
- * @param participants - Optional participant metadata to resolve sender names.
- * @returns Binary data for the generated PDF file.
- * @private Internal helper used by `pdfSaveFormatDefinition`.
- */
-export declare function buildChatPdf(messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;

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

@@ -1,20 +0,0 @@
-/**
- * PDF export plugin
- *
- * @public exported from `@promptbook/components`
- */
-export declare const pdfSaveFormatDefinition: {
-    readonly formatName: "pdf";
-    readonly label: "Pdf";
-    readonly getContent: ({ messages, participants }: {
-        readonly title: string;
-        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
-        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
-    }) => Uint8Array;
-    readonly mimeType: "application/pdf";
-    readonly fileExtension: "pdf";
-};
-/**
- * TODO: !!! Add QR code with branding to the footer
- * TODO: !!! Add print option
- */