@botonic/webchat-react 2.25.0 → 2.27.0

package/lib/hooks/webchat-client-settings-behaviors.d.ts

@@ -0,0 +1,13 @@
+import { WebchatClientSettings } from '@botonic/shared';
+export interface WebchatInputBehavior {
+    isComposerVisible: boolean;
+    isTextInputEnabled: boolean;
+    areAttachmentsVisible: boolean;
+    isEmojiPickerVisible: boolean;
+    isAudioRecordingVisible: boolean;
+    blockInputs: WebchatClientSettings['block_inputs'];
+}
+export interface WebchatClientSettingsBehaviors {
+    input: WebchatInputBehavior;
+}
+export declare function createWebchatClientSettingsBehaviors(settings: WebchatClientSettings): WebchatClientSettingsBehaviors;

package/lib/types/webchat-props.d.ts

@@ -1,8 +1,15 @@
 import { WebchatController } from '@botonic/webchat-core';
-import { ComponentType, ReactNode } from 'react';
+import { ComponentType, CSSProperties, ReactNode } from 'react';
 import { CoverComponentRegistry } from '../components/webchat-overlay';
+export interface WebchatInputIcons {
+    emoji?: ReactNode;
+    attachment?: ReactNode;
+    microphone?: ReactNode;
+    send?: ReactNode;
+}
 export interface BaseWebchatProps {
     className?: string;
+    style?: CSSProperties;
     'aria-label'?: string;
 }
 /**
@@ -57,6 +64,14 @@ export interface WebchatContainerProps extends BaseWebchatProps {
 export interface WebchatMessagesProps extends BaseWebchatProps {
     variant?: 'default';
     enableScrollToBottom?: boolean;
+    /** When true, message list can drive expanded vs collapsed from scroll position. */
+    hasUserInteracted?: boolean;
+    /** Called when the messages scroll area is no longer at the top. */
+    onScrollDepthChange?: (hasDepth: boolean) => void;
+    /** `true` when the message list is at the scroll top (hero header), `false` when scrolled away. */
+    onMessagesScrollAtTopChange?: (isAtTop: boolean) => void;
+    /** Called when a quick-reply or message action is selected. */
+    onUserInteraction?: () => void;
 }
 export interface WebchatInputProps extends BaseWebchatProps {
     placeholder?: string;
@@ -64,13 +79,43 @@ export interface WebchatInputProps extends BaseWebchatProps {
     disabled?: boolean;
     /** When true, shows the "Powered by Hubtype" line below the input. Default: true. */
     showBranding?: boolean;
+    /** Called when the emoji control is activated (UI-only until wired by consumer). */
+    onEmojiClick?: () => void;
+    /** Called when the attachment control is activated (UI-only until wired by consumer). */
+    onAttachmentClick?: () => void;
+    /** Called when the microphone control is activated (UI-only until wired by consumer). */
+    onMicrophoneClick?: () => void;
+    /** Override default SVG icons for action bar buttons. */
+    icons?: WebchatInputIcons;
+    /** Called when the user submits a message from the input. */
+    onUserMessageSent?: () => void;
 }
 export interface WebchatHeaderProps extends BaseWebchatProps {
     title?: string;
+    /** URL for the avatar image shown in the header. If omitted, a placeholder background is shown. */
+    avatarSrc?: string;
+    /** Alt text for the avatar image. */
+    avatarAlt?: string;
     showStatus?: boolean;
     showClose?: boolean;
     onClose?: () => void;
-    variant?: 'default';
+    variant?: 'default' | 'expanded' | 'collapsed';
+    /**
+     * Collapse progress from 0 (expanded hero) to 1 (compact bar).
+     * When omitted, derived from `variant`: expanded → 0, default/collapsed → 1.
+     */
+    collapseProgress?: number;
+    hasShadow?: boolean;
+    /**
+     * When false, responsive hero header behavior is disabled (fixed compact bar).
+     * Defaults from `WebchatConfig.enableResponsiveHeroHeader` via context when omitted.
+     */
+    enableResponsiveHeroHeader?: boolean;
+    /**
+     * Composable slot for header actions (right side, before the close button).
+     * Use together with `PopoverTrigger` + `DropdownMenu` to build the menu.
+     */
+    children?: ReactNode;
 }
 export interface WebchatTriggerProps extends BaseWebchatProps {
     /** Hubtype App ID - required for webchat connection */
@@ -102,4 +147,14 @@ export interface WebchatTriggerProps extends BaseWebchatProps {
      * ```
      */
     loader?: WebchatLoader;
+    /**
+     * Message to show in a proactive pop-up bubble above the trigger.
+     * When undefined (default), no pop-up is shown.
+     */
+    proactiveMessage?: string;
+    /**
+     * Seconds of idle time before the proactive pop-up appears.
+     * @default 5
+     */
+    proactiveDelay?: number;
 }

package/lib/utils/audio-utils.d.ts

@@ -0,0 +1 @@
+export declare function formatTime(seconds: number): string;

package/lib/utils/uuid-utils.d.ts

@@ -0,0 +1 @@
+export declare function timestampFromUuidV7(id: string): Date | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botonic/webchat-react",
-  "version": "2.25.0",
+  "version": "2.27.0",
   "type": "module",
   "types": "./index.d.ts",
   "module": "./index.js",
@@ -26,8 +26,9 @@
   "peerDependencies": {
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
-    "@botonic/webchat-core": "2.25.0",
-    "@botonic/shared": "2.25.0"
+    "@botonic/webchat-core": "2.27.0",
+    "@botonic/shared": "2.27.0",
+    "@lilara/ui-web-react": ">=0.6.0"
   },
   "publishConfig": {
     "access": "public"