@webority/mobile-chat 0.133.0 → 0.134.0

package/lib/typescript/module/ChatComposer.d.ts

@@ -9,6 +9,7 @@ export interface ChatComposerProps {
     keyboardAware?: boolean;
     safeArea?: boolean;
     testID?: string;
+    focusRef?: React.MutableRefObject<(() => void) | null>;
 }
-export declare function ChatComposer({ chat, labels, pickAttachments, keyboardOffset, keyboardAware, safeArea, testID, }: ChatComposerProps): React.ReactElement;
+export declare function ChatComposer({ chat, labels, pickAttachments, keyboardOffset, keyboardAware, safeArea, testID, focusRef, }: ChatComposerProps): React.ReactElement;
 //# sourceMappingURL=ChatComposer.d.ts.map

package/lib/typescript/module/ChatConversationActions.d.ts

@@ -1,4 +1,4 @@
-import type { ChatLabels } from "@webority/chat-core";
+import { type ChatLabels } from "@webority/chat-core";
 import type React from "react";
 import type { UseChatResult } from "./useChat.js";
 export interface ChatConversationActionsProps {

package/lib/typescript/module/ChatDictationButton.d.ts

@@ -4,6 +4,7 @@ import type { UseChatResult } from "./useChat.js";
 export interface DictationNotice {
     message: string;
     openSettings: boolean;
+    tone: "danger" | "info";
 }
 export interface ChatDictationButtonProps {
     chat: UseChatResult;
@@ -12,6 +13,7 @@ export interface ChatDictationButtonProps {
     onText: (text: string) => void;
     onNotice: (notice: DictationNotice | null) => void;
     testID?: string;
+    stopRef?: React.MutableRefObject<(() => void) | null>;
 }
-export declare function ChatDictationButton({ chat, labels, disabled, onText, onNotice, testID, }: ChatDictationButtonProps): React.ReactElement | null;
+export declare function ChatDictationButton({ chat, labels, disabled, onText, onNotice, testID, stopRef, }: ChatDictationButtonProps): React.ReactElement | null;
 //# sourceMappingURL=ChatDictationButton.d.ts.map

package/lib/typescript/module/ChatEmbed.d.ts

@@ -7,5 +7,5 @@ export interface ChatEmbedProps extends ChatShellProps {
     height?: number;
 }
 /** The chat drawn inside a bounded area of a screen, with a border and rounded corners. */
-export declare function ChatEmbed({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, keyboardOffset, title, headerActions, height, testID, }: ChatEmbedProps): React.ReactElement | null;
+export declare function ChatEmbed({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, resolveLink, keyboardOffset, title, headerActions, onClose, height, testID, }: ChatEmbedProps): React.ReactElement | null;
 //# sourceMappingURL=ChatEmbed.d.ts.map

package/lib/typescript/module/ChatFrame.d.ts

@@ -21,6 +21,8 @@ export interface ChatCommonProps {
     openTicket?: ChatOpenTicketHandler;
     /** Hosts an absolute https link or Navigate chip may open; any other absolute target is not linked. */
     handoffHosts?: readonly string[];
+    /** Resolves a link in a reply to a host route or address; null leaves the link as text. */
+    resolveLink?: (href: string) => string | null;
     keyboardOffset?: number;
     testID?: string;
 }
@@ -28,12 +30,16 @@ export interface ChatFrameProps extends ChatCommonProps {
     layout: ChatLayout;
     title?: string;
     headerActions?: React.ReactNode;
+    /** The host sheet closes through this callback. */
+    onClose?: () => void;
 }
 /** The props of the three shells: the frame's, with labels as a partial merged over the defaults. */
 export interface ChatShellProps extends Omit<ChatCommonProps, "labels"> {
     labels?: Partial<ChatLabels>;
     title?: string;
     headerActions?: React.ReactNode;
+    /** The host sheet closes through this callback. */
+    onClose?: () => void;
 }
-export declare function ChatFrame({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, keyboardOffset, layout, title, headerActions, testID, }: ChatFrameProps): React.ReactElement | null;
+export declare function ChatFrame({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, resolveLink, keyboardOffset, layout, title, headerActions, onClose, testID, }: ChatFrameProps): React.ReactElement | null;
 //# sourceMappingURL=ChatFrame.d.ts.map

package/lib/typescript/module/ChatPastChats.d.ts

@@ -0,0 +1,21 @@
+import type { ChatConversationSummary, ChatLabels } from "@webority/chat-core";
+import { type ConversationList } from "@webority/chat-core";
+import type React from "react";
+import type { UseChatResult } from "./useChat.js";
+export interface ChatPastChatsProps {
+    chat: UseChatResult;
+    labels: ChatLabels;
+    testID?: string;
+}
+export interface ConversationRowProps {
+    conversation: ChatConversationSummary;
+    list: ConversationList | null;
+    chat: UseChatResult;
+    labels: ChatLabels;
+    testID: string;
+    onOpen: (conversation: ChatConversationSummary) => void;
+    untitledTitle?: string;
+}
+export declare function ChatPastChats({ chat, labels, testID }: ChatPastChatsProps): React.ReactElement | null;
+export declare function ConversationRow({ conversation, list, chat, labels, testID, onOpen, untitledTitle, }: ConversationRowProps): React.ReactElement;
+//# sourceMappingURL=ChatPastChats.d.ts.map

package/lib/typescript/module/ChatScreen.d.ts

@@ -1,5 +1,5 @@
 import type React from "react";
 import { type ChatShellProps } from "./ChatFrame.js";
 /** The whole chat for one screen of the app's navigator. Keep `useChat` above the navigator so the conversation survives leaving the screen. */
-export declare function ChatScreen({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, keyboardOffset, title, headerActions, testID, }: ChatShellProps): React.ReactElement | null;
+export declare function ChatScreen({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, resolveLink, keyboardOffset, title, headerActions, onClose, testID, }: ChatShellProps): React.ReactElement | null;
 //# sourceMappingURL=ChatScreen.d.ts.map

package/lib/typescript/module/ChatSheet.d.ts

@@ -17,5 +17,5 @@ export interface ChatSheetProps extends ChatShellProps {
     conversationId?: string | null;
 }
 /** The chat in a bottom sheet over the screen, opened from a floating launcher. */
-export declare function ChatSheet({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, keyboardOffset, open, defaultOpen, onOpenChange, position, bottomOffset, snapPoints, compact, openTicket, handoffHosts, conversationId, testID, }: ChatSheetProps): React.ReactElement | null;
+export declare function ChatSheet({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, keyboardOffset, open, defaultOpen, onOpenChange, position, bottomOffset, snapPoints, compact, openTicket, handoffHosts, resolveLink, conversationId, onClose, testID, }: ChatSheetProps): React.ReactElement | null;
 //# sourceMappingURL=ChatSheet.d.ts.map

package/lib/typescript/module/ChatThread.d.ts

@@ -18,6 +18,8 @@ export interface ChatThreadProps {
     onNavigate?: (path: string) => void;
     openTicket?: ChatOpenTicketHandler;
     handoffHosts?: readonly string[];
+    resolveLink?: (href: string) => string | null;
+    focusComposer?: () => void;
     keyboardAware?: boolean;
     keyboardOffset?: number;
     /** Drawn before the first message. */
@@ -30,5 +32,5 @@ export interface ChatThreadProps {
  * pill while a paced reply is held, the loader while a reply is awaited and the error row after a
  * failed or stopped turn.
  */
-export declare function ChatThread({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, keyboardAware, keyboardOffset, empty, style, testID, }: ChatThreadProps): React.ReactElement;
+export declare function ChatThread({ chat, labels, renderers, layoutParts, loader, motion, pickAttachments, onOpenAttachment, onOpenTarget, onNavigate, openTicket, handoffHosts, resolveLink, focusComposer, keyboardAware, keyboardOffset, empty, style, testID, }: ChatThreadProps): React.ReactElement;
 //# sourceMappingURL=ChatThread.d.ts.map

package/lib/typescript/module/index.d.ts

@@ -10,6 +10,7 @@ export { ChatLiveBar } from "./ChatLiveBar.js";
 export { ChatMessageActions } from "./ChatMessageActions.js";
 export { ChatNudge } from "./ChatNudge.js";
 export { ChatOpenTickets } from "./ChatOpenTickets.js";
+export { ChatPastChats } from "./ChatPastChats.js";
 export { ChatScreen } from "./ChatScreen.js";
 export type { ChatSheetProps } from "./ChatSheet.js";
 export { ChatSheet } from "./ChatSheet.js";

package/lib/typescript/module/renderers/ChartPart.d.ts

@@ -3,6 +3,6 @@ import type { ChatPartRendererProps } from "../types.js";
 type ChartPartProps = ChatPartRendererProps<Extract<ChatPart, {
     kind: "Chart";
 }>>;
-export declare function ChartPart({ part, turn }: Pick<ChartPartProps, "part" | "turn">): import("react").JSX.Element | null;
+export declare function ChartPart({ part, turn }: Pick<ChartPartProps, "part" | "turn">): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=ChartPart.d.ts.map

package/lib/typescript/module/renderers/FigureText.d.ts

@@ -10,12 +10,14 @@ export interface FigureRunsProps {
     numberOfLines?: number;
     accessibilityLabel?: string;
     testID?: string;
+    heading?: boolean;
 }
 export interface FigureTextProps extends Omit<FigureRunsProps, "runs"> {
     text: string;
+    enabled?: boolean;
 }
 export declare function runsToText(runs: readonly ChatFigureRun[]): string;
-export declare function FigureRuns({ runs, variant, color, strong, numberOfLines, accessibilityLabel, testID, }: FigureRunsProps): import("react").JSX.Element;
-export declare function FigureText({ text, variant, ...rest }: FigureTextProps): import("react").JSX.Element;
+export declare function FigureRuns({ runs, variant, color, strong, numberOfLines, accessibilityLabel, testID, heading, }: FigureRunsProps): import("react").JSX.Element;
+export declare function FigureText({ text, variant, enabled, ...rest }: FigureTextProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=FigureText.d.ts.map

package/lib/typescript/module/renderers/HandoffPart.d.ts

@@ -4,6 +4,6 @@ import type { ChatPartRendererProps } from "../types.js";
 type HandoffView = Extract<ChatPart, {
     kind: "Handoff";
 }>;
-export declare function HandoffPart({ part, turn }: ChatPartRendererProps<HandoffView>): React.ReactElement;
+export declare function HandoffPart({ part, turn }: ChatPartRendererProps<HandoffView>): React.ReactElement | null;
 export {};
 //# sourceMappingURL=HandoffPart.d.ts.map

package/lib/typescript/module/renderers/VoiceClipPart.d.ts

@@ -1,4 +1,4 @@
-import type { ChatPart } from "@webority/chat-core";
+import { type ChatPart } from "@webority/chat-core";
 import type React from "react";
 import type { ChatPartRendererProps } from "../types.js";
 type VoiceClipProps = ChatPartRendererProps<Extract<ChatPart, {

package/lib/typescript/module/speech/speechText.d.ts

@@ -1,13 +1,13 @@
 export declare const DEFAULT_SPEECH_LANGUAGE = "en-IN";
 export declare const DEFAULT_SPEECH_VOICE = "en-IN-NeerjaNeural";
-export declare const MAX_SPEAK_CHARS = 4000;
-export declare const MAX_DICTATION_MS = 60000;
+export declare const MAX_SPEAK_CHARS = 6000;
+export declare const MAX_DICTATION_MS = 300000;
 export declare const MIN_DICTATION_MS = 600;
 /** The file extension a recording's bytes stand for. m4a is the fallback, the format the phone records. */
 export declare function audioExtension(bytes: Uint8Array): string;
 export declare function escapeSsml(text: string): string;
 export declare function buildSsml(text: string, language: string, voice: string): string;
-/** Cuts at the last sentence end past the floor, so a long reply is read whole sentences at a time. */
+/** Cuts at the last sentence end within the limit, so a long reply is read whole sentences at a time. */
 export declare function clampSpeakText(text: string): string;
 /** Whole seconds as m:ss. A negative or non-finite value reads as 0:00. */
 export declare function formatClipTime(ms: number): string;

package/lib/typescript/module/types.d.ts

@@ -1,10 +1,18 @@
 import type { ChatLiveMessage, ChatPart, ChatPartKind, ChatTurnApi, ChatUploadFile } from "@webority/chat-core";
 import type React from "react";
+import type { View } from "react-native";
 export type { ChatMotion } from "@webority/chat-core";
+/** Host values the thread adds to each part's turn: the host's link resolver and the source rows a citation focuses. */
+export interface ChatTurnHostApi {
+    resolveLink?: (href: string) => string | null;
+    registerSourceRow?: (marker: string, row: View | null) => void;
+    /** Moves focus to the composer input after a quick reply is chosen. */
+    focusComposer?: () => void;
+}
 export type ChatPartRendererProps<P extends ChatPart = ChatPart> = {
     part: P;
     message: ChatLiveMessage;
-    turn: ChatTurnApi;
+    turn: ChatTurnApi & ChatTurnHostApi;
     pickAttachments?: () => Promise<ChatUploadFile[]>;
 };
 export type ChatRenderers = Partial<{

package/lib/typescript/module/useChat.d.ts

@@ -33,6 +33,8 @@ export interface UseChatResult extends ChatSessionState, ChatActions {
     emit: (name: string, data: Record<string, unknown>) => void;
     /** The host reports whether the chat is on screen; the live stream runs only while it is and the app is active. */
     setChatVisible: (visible: boolean) => void;
+    /** The message of the last hand-off request that failed, cleared by the next request. */
+    handoffError: string | null;
     /** Present only when the host passed `onNavigate`; the turn API of each message hands relative links to it. */
     onNavigate?: (path: string) => void;
 }

package/lib/typescript/module/useChatSound.d.ts

@@ -0,0 +1,35 @@
+import type { UseChatResult } from "./useChat.js";
+/**
+ * Plays the open cue when the panel opens, and the sent and reply cues for each new message, as the web chat does
+ * (chat-elements/src/WuiChat.js _playSounds). A send, an edit and a retry each add a new visitor message; an assistant,
+ * script or agent message plays the reply cue. Restored messages, notices and a history load stay silent, and the
+ * visitor message the server's copy replaces after a turn is stored, so it does not play the sent cue again.
+ * The phone has no WebAudio, so each cue is a short 16-bit WAV written once to the cache and played from there.
+ */
+export declare const CUES: {
+    readonly open: {
+        readonly from: 420;
+        readonly to: 920;
+        readonly seconds: 0.16;
+        readonly peak: 0.16;
+    };
+    readonly reply: {
+        readonly from: 680;
+        readonly to: 540;
+        readonly seconds: 0.11;
+        readonly peak: 0.06;
+    };
+    readonly sent: {
+        readonly from: 540;
+        readonly to: 760;
+        readonly seconds: 0.09;
+        readonly peak: 0.05;
+    };
+};
+/**
+ * Plays one cue at the given volume (0 to 1). The file is written on the first play and reused after that.
+ * A failure is logged, never thrown, so a missing sound never breaks the chat.
+ */
+export declare function playCue(name: keyof typeof CUES, volume?: number): void;
+export declare function useChatSound(chat: UseChatResult): void;
+//# sourceMappingURL=useChatSound.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-chat",
-  "version": "0.133.0",
+  "version": "0.134.0",
   "description": "Webority Chat for React Native apps: the chat screen, sheet and embedded shells, thread, composer, one renderer per message part kind and the useChat hook, built on @webority/chat-core and @webority/mobile-ui.",
   "keywords": [
     "react-native",
@@ -42,9 +42,10 @@
     "!**/*.map"
   ],
   "peerDependencies": {
-    "@webority/chat-core": "0.133.0",
-    "@webority/mobile-core": "^0.130.0",
-    "@webority/mobile-ui": "^0.130.1",
+    "@webority/chat-core": "0.134.0",
+    "@webority/markdown-core": "^0.130.3",
+    "@webority/mobile-core": "^0.130.3",
+    "@webority/mobile-ui": "^0.130.3",
     "expo-audio": ">=57.0.0",
     "expo-file-system": ">=57.0.0",
     "react": "^19.1.0",
@@ -96,11 +97,11 @@
     "@react-native/metro-config": "0.86.3",
     "@testing-library/react-native": "12.9.0",
     "@types/react": "19.2.18",
-    "@webority/canvas-kit": "0.130.2",
-    "@webority/chat-core": "0.133.0",
-    "@webority/markdown-core": "0.130.2",
-    "@webority/mobile-core": "0.130.2",
-    "@webority/mobile-ui": "0.130.2",
+    "@webority/canvas-kit": "0.130.3",
+    "@webority/chat-core": "0.134.0",
+    "@webority/markdown-core": "0.130.3",
+    "@webority/mobile-core": "0.130.3",
+    "@webority/mobile-ui": "0.130.3",
     "babel-jest": "29.7.0",
     "expo": "57.0.31",
     "expo-application": "57.0.3",