@webority/mobile-chat 0.128.0 → 0.134.0

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

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+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;
+export {};
+//# sourceMappingURL=ChartPart.d.ts.map

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

@@ -0,0 +1,23 @@
+import { type ChatFigureRun } from "@webority/chat-core";
+import { Text } from "@webority/mobile-ui";
+import { type ComponentProps } from "react";
+type MobileText = ComponentProps<typeof Text>;
+export interface FigureRunsProps {
+    runs: readonly ChatFigureRun[];
+    variant?: MobileText["variant"];
+    color?: MobileText["color"];
+    strong?: boolean;
+    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, 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/FiguresPart.d.ts

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type FiguresPartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Figures";
+}>>;
+export declare function FiguresPart({ part, turn }: Pick<FiguresPartProps, "part" | "turn">): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=FiguresPart.d.ts.map

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

@@ -0,0 +1,3 @@
+import type { ChatPartRendererProps } from "../types.js";
+export declare function FilePart(props: ChatPartRendererProps): import("react").JSX.Element;
+//# sourceMappingURL=FilePart.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+import type { ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type ImagePartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Image";
+}>>;
+export declare function ImagePart({ part, turn }: Pick<ImagePartProps, "part" | "turn">): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImagePart.d.ts.map

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

@@ -0,0 +1,3 @@
+import type { ChatPartRendererProps } from "../types.js";
+export declare function InputRequestPart(props: ChatPartRendererProps): import("react").JSX.Element;
+//# sourceMappingURL=InputRequestPart.d.ts.map

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

@@ -0,0 +1,8 @@
+import type { ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type NoticePartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Notice";
+}>>;
+export declare function NoticePart({ part }: NoticePartProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=NoticePart.d.ts.map

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

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type QuickRepliesPartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "QuickReplies";
+}>>;
+export declare function QuickRepliesPart({ part, turn }: QuickRepliesPartProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=QuickRepliesPart.d.ts.map

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

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type RecordCardPartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "RecordCard";
+}>>;
+export declare function RecordCardPart({ part, turn }: Pick<RecordCardPartProps, "part" | "turn">): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=RecordCardPart.d.ts.map

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

@@ -0,0 +1,8 @@
+import type { ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type SourcesPartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Sources";
+}>>;
+export declare function SourcesPart({ part, turn }: SourcesPartProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=SourcesPart.d.ts.map

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

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type TablePartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Table";
+}>>;
+export declare function TablePart({ part, turn }: Pick<TablePartProps, "part" | "turn">): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=TablePart.d.ts.map

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

@@ -0,0 +1,8 @@
+import { type ChatPart } from "@webority/chat-core";
+import type { ChatPartRendererProps } from "../types.js";
+type TextPartProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "Text";
+}>>;
+export declare function TextPart({ part, message, turn }: TextPartProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=TextPart.d.ts.map

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

@@ -0,0 +1,9 @@
+import type { ChatPart } from "@webority/chat-core";
+import type React from "react";
+import type { ChatPartRendererProps } from "../types.js";
+type TicketView = Extract<ChatPart, {
+    kind: "Ticket";
+}>;
+export declare function TicketPart({ part, turn }: ChatPartRendererProps<TicketView>): React.ReactElement;
+export {};
+//# sourceMappingURL=TicketPart.d.ts.map

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

@@ -0,0 +1,9 @@
+import { type ChatPart } from "@webority/chat-core";
+import type React from "react";
+import type { ChatPartRendererProps } from "../types.js";
+type VoiceClipProps = ChatPartRendererProps<Extract<ChatPart, {
+    kind: "VoiceClip";
+}>>;
+export declare function VoiceClipPart({ part, turn }: VoiceClipProps): React.ReactElement;
+export {};
+//# sourceMappingURL=VoiceClipPart.d.ts.map

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

@@ -0,0 +1,3 @@
+import type { ChatRenderers } from "../types.js";
+export declare const defaultRenderers: ChatRenderers;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,25 @@
+import { type ChatAbortSignal } from "@webority/chat-core";
+export interface SpeechEndpointToken {
+    token: string;
+    region: string;
+}
+export declare class SpeechRequestError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+export declare function transcribeClip(input: {
+    token: SpeechEndpointToken;
+    uri: string;
+    language: string;
+    signal?: ChatAbortSignal;
+    fetchImpl?: typeof fetch;
+}): Promise<string>;
+export declare function synthesizeSpeech(input: {
+    token: SpeechEndpointToken;
+    text: string;
+    language: string;
+    voice: string;
+    signal?: ChatAbortSignal;
+    fetchImpl?: typeof fetch;
+}): Promise<Uint8Array>;
+//# sourceMappingURL=azureSpeech.d.ts.map

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

@@ -0,0 +1,23 @@
+export interface RecordedClip {
+    uri: string;
+    durationMs: number;
+}
+export interface ClipRecording {
+    stop(): Promise<RecordedClip>;
+    cancel(): Promise<void>;
+}
+export interface ClipPlayback {
+    finished: Promise<void>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+}
+/** Starts a recording as m4a (AAC) on both platforms, mono at 16 kHz, which the transcription request reads. */
+export declare function startRecording(): Promise<ClipRecording>;
+/** Plays a local file. Starting one stops the playback before it, so a clip and a read-aloud never overlap. */
+export declare function playFile(uri: string, onStatus?: (status: {
+    positionMs: number;
+    durationMs: number | null;
+    playing: boolean;
+}) => void): ClipPlayback;
+//# sourceMappingURL=expoAudio.d.ts.map

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

@@ -0,0 +1,16 @@
+import { type ChatSpeechAdapter, ChatSpeechError, type ChatSpeechErrorCode, type ChatSpeechToken } from "@webority/chat-core";
+export type PhoneSpeechErrorCode = "MicDenied" | "MicBlocked" | "MicUnavailable" | "Failed" | "Unavailable";
+/** The chat-core code the UI reads, plus the finer phone code that says which step refused. */
+export declare class PhoneSpeechError extends ChatSpeechError {
+    readonly phoneCode: PhoneSpeechErrorCode;
+    constructor(code: ChatSpeechErrorCode, phoneCode: PhoneSpeechErrorCode, message?: string);
+}
+export interface PhoneSpeechOptions {
+    getToken: () => Promise<ChatSpeechToken>;
+    language?: string;
+    voice?: string;
+}
+/** Deletes a temporary audio file. A file that cannot be removed is left for the OS to clear. */
+export declare function discardFile(uri: string): void;
+export declare function createPhoneSpeech(options: PhoneSpeechOptions): ChatSpeechAdapter;
+//# sourceMappingURL=phoneSpeech.d.ts.map

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

@@ -0,0 +1,16 @@
+export declare const DEFAULT_SPEECH_LANGUAGE = "en-IN";
+export declare const DEFAULT_SPEECH_VOICE = "en-IN-NeerjaNeural";
+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 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;
+/** Appends what was heard to the draft, with one space between, and keeps the result within maxLength. */
+export declare function joinDictation(draft: string, heard: string, maxLength: number): string;
+//# sourceMappingURL=speechText.d.ts.map

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

@@ -0,0 +1,29 @@
+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 & ChatTurnHostApi;
+    pickAttachments?: () => Promise<ChatUploadFile[]>;
+};
+export type ChatRenderers = Partial<{
+    [K in ChatPartKind]: React.ComponentType<ChatPartRendererProps<Extract<ChatPart, {
+        kind: K;
+    }>>>;
+}>;
+export type ChatLayoutParts = (message: ChatLiveMessage) => Array<ChatPart | ChatPart[]>;
+export interface ChatTicketRef {
+    ticketId: string;
+    number: string;
+}
+export type ChatOpenTicketHandler = (ticket: ChatTicketRef) => void;
+//# sourceMappingURL=types.d.ts.map

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

@@ -1,19 +1,49 @@
-import type { ChatClient, ChatSession, ChatSessionState } from "@webority/markdown-core/chat";
-export type { ChatTurn, ChatTurnError } from "@webority/markdown-core/chat";
+import type { ChatBehaviour, ChatClient, ChatFeature, ChatSession, ChatSessionState } from "@webority/chat-core";
+import type { ChatLayout } from "./ChatFrame.js";
+export interface ChatPrefs {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
 export interface UseChatOptions {
-    /** From `createChatClient`. */
     client: ChatClient;
-    /** Sent with each question; read at the moment of sending. */
+    /** The screen key the profile resolves for; the phone has no URL. */
+    screen?: string;
+    /** The shell that hosts the session, named in its open and close events. */
+    layout?: ChatLayout;
+    /** Features switched off on this surface, on top of the server profile. */
+    narrow?: Partial<Record<ChatFeature, false>>;
+    /** Opens this conversation once after the profile loads. */
+    conversationId?: string | null;
+    /** Sent with each message; read at the moment of sending. */
     pageContext?: unknown;
+    /** The behaviour the host app measured; read at the moment of sending. */
+    behaviour?: () => ChatBehaviour | null;
+    /** Where the session keeps the mute choice (key wchat:muted). */
+    prefs: ChatPrefs;
+    getCaptchaToken?: (action: string) => Promise<string | null>;
+    onEvent?: (name: string, data: Record<string, unknown>) => void;
+    onError?: (error: unknown) => void;
+    /** Receives the path of a relative link in a reply; the host decides how to navigate to it. */
+    onNavigate?: (path: string) => void;
 }
-type ChatActions = Pick<ChatSession, "submit" | "stop" | "retry" | "regenerate" | "startEdit" | "cancelEdit" | "attach" | "removeAttachment" | "openConversation" | "newConversation" | "rate" | "refreshAllowance" | "reset">;
-export type UseChatResult = ChatSessionState & ChatActions & {
+type ChatActions = Pick<ChatSession, "load" | "submit" | "chooseQuickReply" | "answerInput" | "confirmAction" | "rejectAction" | "stop" | "retry" | "regenerate" | "startEdit" | "cancelEdit" | "attach" | "removeAttachment" | "openConversation" | "resumeLast" | "newConversation" | "rate" | "reset" | "requestHandoff" | "notifyTyping" | "resumeLive">;
+export interface UseChatResult extends ChatSessionState, ChatActions {
+    session: ChatSession;
     client: ChatClient;
-};
+    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;
+}
 /**
  * The chat's state and actions. The session lives in the component that calls it: one per client,
- * disposed when the client changes or the component unmounts. Call `reset()` when the signed-in
- * person or account changes so nothing of one person's chat shows to the next.
+ * screen and narrowing, created in a mount effect (StrictMode runs effects twice and a disposed session never
+ * loads again) and disposed when those change or the component unmounts. Until it exists the state is idle and
+ * the actions do nothing. Call `reset()` when the signed-in person changes so nothing of one person's chat shows to the next.
  */
-export declare const useChat: ({ client, pageContext }: UseChatOptions) => UseChatResult;
+export declare function useChat(options: UseChatOptions): UseChatResult;
+export {};
 //# sourceMappingURL=useChat.d.ts.map

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

@@ -0,0 +1,3 @@
+import type { UseChatResult } from "./useChat.js";
+export declare function useChatHaptics(chat: UseChatResult): void;
+//# sourceMappingURL=useChatHaptics.d.ts.map

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/lib/typescript/module/useChatSpeech.d.ts

@@ -0,0 +1,4 @@
+import type { ChatSpeechAdapter } from "@webority/chat-core";
+import type { UseChatResult } from "./useChat.js";
+export declare function useChatSpeech(chat: UseChatResult): ChatSpeechAdapter | null;
+//# sourceMappingURL=useChatSpeech.d.ts.map

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

@@ -0,0 +1,10 @@
+import { type ChatLabels, type ChatLiveMessage } from "@webority/chat-core";
+import type { UseChatResult } from "./useChat.js";
+export interface TranscriptActions {
+    canShare: boolean;
+    notice: string | null;
+    shareReply(message: ChatLiveMessage): Promise<void>;
+    shareConversation(): Promise<void>;
+}
+export default function useTranscriptActions(chat: UseChatResult, labels: ChatLabels): TranscriptActions;
+//# sourceMappingURL=useTranscriptActions.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webority/mobile-chat",
-  "version": "0.128.0",
-  "description": "AI assistant chat for Webority React Native apps: a streaming chat client, a store-agnostic chat hook, and the chat screen, thread, composer, past chats, reply rating and support action cards, built on @webority/mobile-ui.",
+  "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",
     "chat",
@@ -41,19 +41,26 @@
     "!**/*.spec.*",
     "!**/*.map"
   ],
-  "dependencies": {
-    "@webority/markdown-core": "0.128.0"
-  },
   "peerDependencies": {
-    "@webority/mobile-core": "0.128.0",
-    "@webority/mobile-ui": "0.128.0",
-    "expo-clipboard": ">=57.0.0",
+    "@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",
     "react-native": ">=0.81.0",
     "react-native-keyboard-controller": ">=1.21.9",
     "react-native-safe-area-context": ">=5.4.0"
   },
-  "peerDependenciesMeta": {},
+  "peerDependenciesMeta": {
+    "expo-audio": {
+      "optional": true
+    },
+    "expo-file-system": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -85,25 +92,46 @@
     ]
   },
   "devDependencies": {
+    "@react-native/babel-preset": "0.86.3",
+    "@react-native/jest-preset": "0.86.3",
     "@react-native/metro-config": "0.86.3",
     "@testing-library/react-native": "12.9.0",
     "@types/react": "19.2.18",
-    "@webority/mobile-core": "0.128.0",
-    "@webority/mobile-dev": "0.0.0",
-    "@webority/mobile-ui": "0.128.0",
+    "@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",
+    "expo-audio": "57.0.5",
+    "expo-clipboard": "57.0.2",
+    "expo-crypto": "57.0.4",
+    "expo-file-system": "57.0.7",
+    "expo-haptics": "57.0.3",
+    "expo-image": "57.0.5",
+    "expo-network": "57.0.3",
+    "expo-secure-store": "57.0.4",
+    "expo-sqlite": "57.0.4",
     "jest": "29.7.0",
     "react": "19.2.8",
+    "react-hook-form": "7.89.0",
     "react-native": "0.86.3",
     "react-native-builder-bob": "0.43.0",
+    "react-native-gesture-handler": "3.2.1",
     "react-native-keyboard-controller": "1.21.9",
+    "react-native-reanimated": "4.5.3",
     "react-native-safe-area-context": "5.9.1",
+    "react-native-svg": "15.15.5",
+    "react-native-worklets": "0.10.4",
     "react-test-renderer": "19.2.8",
-    "rimraf": "6.1.3",
+    "terser": "5.49.1",
     "typescript": "5.9.3"
   },
   "scripts": {
-    "build": "bob build && node ../mobile-dev/scripts/minify-lib.mjs",
-    "clean": "rimraf lib",
+    "build": "bob build && node ../../scripts/minify-lib.mjs",
+    "clean": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\"",
     "lint": "biome lint ./src",
     "lint:fix": "biome lint --write ./src",
     "test": "jest",