@kesha-antonov/react-native-chat 5.0.0 → 6.0.0

package/lib/MessagesContainer/viewability.js

@@ -0,0 +1,110 @@
+import { c as _c } from "react/compiler-runtime";
+import { useContext, useInsertionEffect, useState } from 'react';
+import { MediaPlaybackContext } from '../components/mediaPlayback';
+// Any pixel of a row on screen counts: the playing round note floats only once
+// its row has left the list entirely.
+const ROW_ON_SCREEN_CONFIG = {
+  itemVisiblePercentThreshold: 0
+};
+/**
+ * The list reads its viewability callbacks once, at mount, so they are permanent and forward to
+ * what the latest commit handed over (the list only reports after a commit). A plain object
+ * rather than refs: the callbacks are built while rendering, and React Compiler rejects a
+ * render-time closure over a ref even when nothing calls it until later.
+ */
+function createViewabilityRelay(initialMediaController, initialConsumer) {
+  let mediaController = initialMediaController;
+  let markRowsSeen = () => {};
+  let consumer = initialConsumer;
+  const onRowsViewable = ({
+    viewableItems
+  }) => {
+    const ids = [];
+    for (const token of viewableItems) {
+      const id = token.item?._id;
+      if (id != null) ids.push(id);
+    }
+    mediaController?.setViewableMessages(ids);
+    markRowsSeen(ids);
+  };
+  const onConsumerViewable = info => consumer?.(info);
+  const update = next => {
+    mediaController = next.mediaController;
+    markRowsSeen = next.markRowsSeen;
+    consumer = next.consumer;
+  };
+  return {
+    onRowsViewable,
+    onConsumerViewable,
+    update
+  };
+}
+
+/**
+ * The list's `viewabilityConfigCallbackPairs`: which rows are on screen, for the floating round
+ * note and the page-down counter, with a consumer's own handler folded in.
+ */
+export function useViewabilityPairs(listProps, markRowsSeen) {
+  const $ = _c(12);
+  const mediaController = useContext(MediaPlaybackContext);
+  let t0;
+  if ($[0] !== listProps?.onViewableItemsChanged || $[1] !== mediaController) {
+    t0 = () => createViewabilityRelay(mediaController, listProps?.onViewableItemsChanged);
+    $[0] = listProps?.onViewableItemsChanged;
+    $[1] = mediaController;
+    $[2] = t0;
+  } else {
+    t0 = $[2];
+  }
+  const [viewabilityRelay] = useState(t0);
+  let t1;
+  if ($[3] !== listProps || $[4] !== viewabilityRelay.onConsumerViewable || $[5] !== viewabilityRelay.onRowsViewable) {
+    t1 = () => {
+      const pairs = [{
+        viewabilityConfig: ROW_ON_SCREEN_CONFIG,
+        onViewableItemsChanged: viewabilityRelay.onRowsViewable
+      }];
+      if (listProps?.viewabilityConfigCallbackPairs) {
+        pairs.push(...listProps.viewabilityConfigCallbackPairs);
+      } else {
+        if (listProps?.onViewableItemsChanged) {
+          pairs.push({
+            viewabilityConfig: listProps.viewabilityConfig ?? {
+              viewAreaCoveragePercentThreshold: 0
+            },
+            onViewableItemsChanged: viewabilityRelay.onConsumerViewable
+          });
+        }
+      }
+      return pairs;
+    };
+    $[3] = listProps;
+    $[4] = viewabilityRelay.onConsumerViewable;
+    $[5] = viewabilityRelay.onRowsViewable;
+    $[6] = t1;
+  } else {
+    t1 = $[6];
+  }
+  const [viewabilityPairs] = useState(t1);
+  const consumerOnViewableItemsChanged = listProps?.onViewableItemsChanged;
+  let t2;
+  if ($[7] !== consumerOnViewableItemsChanged || $[8] !== markRowsSeen || $[9] !== mediaController || $[10] !== viewabilityRelay) {
+    t2 = () => {
+      viewabilityRelay.update({
+        mediaController,
+        markRowsSeen,
+        consumer: consumerOnViewableItemsChanged
+      });
+    };
+    $[7] = consumerOnViewableItemsChanged;
+    $[8] = markRowsSeen;
+    $[9] = mediaController;
+    $[10] = viewabilityRelay;
+    $[11] = t2;
+  } else {
+    t2 = $[11];
+  }
+  useInsertionEffect(t2);
+  return viewabilityPairs;
+}
+//# sourceMappingURL=viewability.js.map

package/lib/MessagesContainer/viewability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewability.js","names":["useContext","useInsertionEffect","useState","MediaPlaybackContext","ROW_ON_SCREEN_CONFIG","itemVisiblePercentThreshold","createViewabilityRelay","initialMediaController","initialConsumer","mediaController","markRowsSeen","consumer","onRowsViewable","viewableItems","ids","token","id","item","_id","push","setViewableMessages","onConsumerViewable","info","update","next","useViewabilityPairs","listProps","$","_c","t0","onViewableItemsChanged","viewabilityRelay","t1","pairs","viewabilityConfig","viewabilityConfigCallbackPairs","viewAreaCoveragePercentThreshold","viewabilityPairs","consumerOnViewableItemsChanged","t2"],"sources":["../../src/MessagesContainer/viewability.ts"],"sourcesContent":["import { useContext, useInsertionEffect, useState } from 'react'\nimport type { ViewabilityConfigCallbackPair } from '@legendapp/list/react-native'\n\nimport { MediaPlaybackContext, MediaPlaybackController } from '../components/mediaPlayback'\nimport { IMessage } from '../Models'\nimport { AnimatedListProps } from './types'\n\n// Any pixel of a row on screen counts: the playing round note floats only once\n// its row has left the list entirely.\nconst ROW_ON_SCREEN_CONFIG = { itemVisiblePercentThreshold: 0 }\n\ntype ViewableItemsChanged = NonNullable<ViewabilityConfigCallbackPair['onViewableItemsChanged']>\n\n/**\n * The list reads its viewability callbacks once, at mount, so they are permanent and forward to\n * what the latest commit handed over (the list only reports after a commit). A plain object\n * rather than refs: the callbacks are built while rendering, and React Compiler rejects a\n * render-time closure over a ref even when nothing calls it until later.\n */\nfunction createViewabilityRelay (\n  initialMediaController: MediaPlaybackController | null,\n  initialConsumer: ViewableItemsChanged | null | undefined\n) {\n  let mediaController = initialMediaController\n  let markRowsSeen: (ids: (string | number)[]) => void = () => {}\n  let consumer = initialConsumer\n  const onRowsViewable: ViewableItemsChanged = ({ viewableItems }) => {\n    const ids: (string | number)[] = []\n    for (const token of viewableItems) {\n      const id = (token.item as IMessage | undefined)?._id\n      if (id != null)\n        ids.push(id)\n    }\n    mediaController?.setViewableMessages(ids)\n    markRowsSeen(ids)\n  }\n  const onConsumerViewable: ViewableItemsChanged = info => consumer?.(info)\n  const update = (next: {\n    mediaController: MediaPlaybackController | null\n    markRowsSeen: (ids: (string | number)[]) => void\n    consumer: ViewableItemsChanged | null | undefined\n  }) => {\n    mediaController = next.mediaController\n    markRowsSeen = next.markRowsSeen\n    consumer = next.consumer\n  }\n  return { onRowsViewable, onConsumerViewable, update }\n}\n\n/**\n * The list's `viewabilityConfigCallbackPairs`: which rows are on screen, for the floating round\n * note and the page-down counter, with a consumer's own handler folded in.\n */\nexport function useViewabilityPairs<TMessage extends IMessage> (\n  listProps: AnimatedListProps<TMessage> | undefined,\n  markRowsSeen: (ids: (string | number)[]) => void\n) {\n  // Which rows are on screen, for the floating round note. The list reads viewability\n  // callbacks once, at mount, and FlatList refuses\n  // `onViewableItemsChanged` alongside `viewabilityConfigCallbackPairs`, so a\n  // consumer's own handler is folded into the pairs here, read through a relay.\n  const mediaController = useContext(MediaPlaybackContext)\n  const [viewabilityRelay] = useState(() => createViewabilityRelay(mediaController, listProps?.onViewableItemsChanged))\n  const [viewabilityPairs] = useState(() => {\n    const pairs: ViewabilityConfigCallbackPair[] = [{\n      viewabilityConfig: ROW_ON_SCREEN_CONFIG,\n      onViewableItemsChanged: viewabilityRelay.onRowsViewable,\n    }]\n    if (listProps?.viewabilityConfigCallbackPairs)\n      pairs.push(...listProps.viewabilityConfigCallbackPairs)\n    else if (listProps?.onViewableItemsChanged)\n      pairs.push({\n        // FlatList's own default when a handler comes without a config.\n        viewabilityConfig: listProps.viewabilityConfig ?? { viewAreaCoveragePercentThreshold: 0 },\n        onViewableItemsChanged: viewabilityRelay.onConsumerViewable,\n      })\n    return pairs\n  })\n\n  const consumerOnViewableItemsChanged = listProps?.onViewableItemsChanged\n  // An insertion effect runs before any layout effect, the list's own included, so a report\n  // made while the list commits already reaches this render's handlers.\n  useInsertionEffect(() => {\n    viewabilityRelay.update({ mediaController, markRowsSeen, consumer: consumerOnViewableItemsChanged })\n  })\n\n  return viewabilityPairs\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/Models.d.ts

@@ -1,8 +1,18 @@
 import { StyleProp, ViewStyle } from 'react-native';
 import { IconRenderer } from './Icons';
 export type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
-/** An action shown in the message long-press context menu (Telegram style). */
+/**
+ * The actions the chat can put in the long-press menu by itself, in this order:
+ * `reply`, `copy`, `forward`, `pin`, `edit`, `delete`.
+ */
+export type MessageActionKey = 'reply' | 'copy' | 'forward' | 'pin' | 'edit' | 'select' | 'delete';
+/** An action shown in the message long-press context menu. */
 export interface MessageMenuItem {
+    /**
+     * Identifies the action. The built-in ones carry their `MessageActionKey`, so a
+     * `messageActions` function can find, drop or reorder them.
+     */
+    key?: MessageActionKey | string;
     label: string;
     /** Optional leading icon, e.g. a lucide-react-native component. */
     icon?: IconRenderer;
@@ -38,16 +48,71 @@ export interface MessageReaction {
     /** IDs of the users who reacted with this emoji */
     userIds: (string | number)[];
 }
+/** A document attached to a message (`IMessage.file`), drawn as a file bubble. */
+export interface IMessageFile {
+    /** Where the file is: a local `file://` path or a remote URL. */
+    uri: string;
+    /** The file name shown in the bubble, with its extension. */
+    name: string;
+    /** Size in bytes, shown under the name. */
+    size?: number;
+    /** MIME type, used when the file is opened or shared. */
+    mimeType?: string;
+}
+/**
+ * A web page preview for the first link in a message: a block under the text
+ * (accent bar, site name, title, description, picture). Fetching it takes a request to the page,
+ * so the app supplies it, on the message or through `Chat`'s `fetchLinkPreview`.
+ */
+export interface LinkPreview {
+    /** The page the preview is for; a tap opens it. Defaults to the first link in the text. */
+    url?: string;
+    /** The site's name, drawn in the accent color on top (`og:site_name`). */
+    siteName?: string;
+    /** The page title, bold (`og:title`). */
+    title?: string;
+    /** A few lines of the page's description (`og:description`). */
+    description?: string;
+    /** The page's picture (`og:image`). */
+    image?: string;
+    /** The picture's size, so it keeps its aspect ratio before it has loaded. */
+    imageWidth?: number;
+    imageHeight?: number;
+    /**
+     * `'large'` draws the picture full width under the text, `'small'` as a 48dp thumbnail at the
+     * top right, as for articles. Default: large when the picture is wider than tall.
+     */
+    imageSize?: 'large' | 'small';
+}
 export interface IMessage {
     _id: string | number;
     text: string;
     createdAt: Date | number;
     user: User;
     image?: string;
+    /**
+     * A tiny stand-in shown under `image` until it has loaded, like a blurred thumbnail:
+     * a small image uri (drawn blurred), or a blurhash string when
+     * `expo-image` is installed.
+     */
+    imagePlaceholder?: string;
     video?: string;
-    /** Render `video` as a Telegram-style round video note (circular, autoplay/muted) instead of a rectangular player. */
+    /** Render `video` as a round video note (circular, autoplay/muted) instead of a rectangular player. */
     videoNote?: boolean;
     audio?: string;
+    /**
+     * The voice or round note has not been played by its recipient yet. Draws
+     * an unread dot: on an incoming note until you play it, on an
+     * outgoing one until the recipient does.
+     */
+    isMediaUnread?: boolean;
+    /**
+     * A view-once voice or round note: it plays a
+     * single time, then `mediaPlayback.onViewOnceEnd` lets the app remove it.
+     */
+    isViewOnce?: boolean;
+    /** Text of a transcribed voice or round note, shown under it. */
+    transcription?: string;
     /**
      * Length of `audio` / `video` in seconds. Set by the built-in recorders and
      * used to label a voice note before its file has been decoded, so a bubble can
@@ -55,9 +120,17 @@ export interface IMessage {
      */
     duration?: number;
     system?: boolean;
+    /** The message is pinned; the menu's pin action then reads "Unpin". */
+    isPinned?: boolean;
     sent?: boolean;
     received?: boolean;
     pending?: boolean;
+    /** Sending failed: the ticks give way to a red error badge. */
+    isFailed?: boolean;
+    /** The message was edited; its time reads "edited 14:05". Set by `useChatMessages`'s edit. */
+    isEdited?: boolean;
+    /** When the message was last edited; any value also shows the "edited" mark. */
+    editedAt?: Date | number;
     /** True while this message's text is still being streamed in (shows a typing cursor) */
     streaming?: boolean;
     quickReplies?: QuickReplies;
@@ -67,6 +140,43 @@ export interface IMessage {
         latitude: number;
         longitude: number;
     };
+    /** A document: a file bubble (icon, name, size); a tap opens it. */
+    file?: IMessageFile;
+    /** A preview of the first link in `text`, drawn under it. `null` hides the preview for this message. */
+    linkPreview?: LinkPreview | null;
+    /**
+     * The message's media (photo, video, file, voice or round note) is uploading or downloading.
+     * Draws a progress ring with a cancel ✕ over it; a tap calls `mediaTransfer.onCancel`.
+     */
+    transfer?: MediaTransfer;
+    /**
+     * The media is not on the device and is not fetched by itself: a download arrow,
+     * which calls `mediaTransfer.onDownload` when tapped. Without that handler a voice note
+     * downloads itself on the tap.
+     */
+    isDownloadRequired?: boolean;
+    /**
+     * A voice note's waveform, as the server sends it with the note: levels in 0..1, or 5-bit
+     * 0..31 values. Drawn at once, before the audio has downloaded, and resampled to the
+     * bubble's bar count; without it the waveform is decoded from the audio.
+     */
+    waveform?: number[];
+}
+/** An upload or download of a message's media, `IMessage.transfer`. */
+export interface MediaTransfer {
+    /** `upload` while sending, `download` while fetching. Both draw the same ring. */
+    type: 'upload' | 'download';
+    /** 0..1. Leave it out while unknown: the ring then shows a 4-degree dot, still turning. */
+    progress?: number;
+    /** The file's size in bytes: a photo or video then shows "1.2 MB / 4.5 MB" while it moves. */
+    totalBytes?: number;
+}
+/** Handlers for the media buttons of messages with `transfer` or `isDownloadRequired`. */
+export interface MediaTransferProps {
+    /** The download arrow was tapped: start fetching, and set `transfer` while it runs. */
+    onDownload?: (message: IMessage) => void;
+    /** The cancel ✕ was tapped during an upload or download. */
+    onCancel?: (message: IMessage) => void;
 }
 export type IChatMessage = IMessage;
 export interface MessageVideoProps<TMessage extends IMessage> {
@@ -83,6 +193,13 @@ export interface MessageAudioProps<TMessage extends IMessage> {
     audioStyle?: StyleProp<ViewStyle>;
     audioProps?: object;
 }
+export interface MessageFileProps<TMessage extends IMessage> {
+    currentMessage: TMessage;
+    position?: 'left' | 'right';
+    containerStyle?: StyleProp<ViewStyle>;
+    /** Override opening the file (the system share sheet with `expo-sharing`, else `Linking`). */
+    onPress?: (file: IMessageFile) => void;
+}
 export interface MessageLocationProps<TMessage extends IMessage> {
     currentMessage: TMessage;
     position?: 'left' | 'right';
@@ -95,10 +212,16 @@ export interface MessageLocationProps<TMessage extends IMessage> {
     }) => void;
 }
 /**
- * Telegram-style hold-to-record voice messages. Requires the optional
+ * Hold-to-record voice messages. Requires the optional
  * `expo-audio` peer dependency; when it is absent the mic button is hidden.
  */
 export interface AudioRecordingProps {
+    /**
+     * Show the "view once" toggle above the lock while a take is locked.
+     * A take sent with it on arrives in `onSend` with `isViewOnce: true`.
+     */
+    isViewOnceEnabled?: boolean;
+    /** On by default when `expo-audio` is installed; `false` hides the mic button. */
     isEnabled?: boolean;
     /** Minimum recording length (ms) below which the take is discarded. Default 800. */
     minDurationMs?: number;
@@ -123,6 +246,12 @@ export interface AudioRecordingProps {
  * `expo-image-picker` peer dependency; when it is absent the button is hidden.
  */
 export interface VideoRecordingProps {
+    /** As `audioRecording.isViewOnceEnabled`, for round video takes. */
+    isViewOnceEnabled?: boolean;
+    /**
+     * On by default when `react-native-vision-camera` is installed; `false` turns round video
+     * off, `true` also falls back to the system camera (`expo-image-picker`) without it.
+     */
     isEnabled?: boolean;
     /** Max video length in seconds. Default 60. */
     maxDuration?: number;
@@ -133,7 +262,63 @@ export interface VideoRecordingProps {
      * point the user at Settings instead of leaving a dead button.
      */
     onPermissionDenied?: () => void;
+    /** Called when a take is dropped for being shorter than `minDurationMs`. */
+    onTooShort?: () => void;
     onError?: (error: unknown) => void;
 }
+/**
+ * How voice notes and round video notes play back in the chat: one speed
+ * shared by every note, and a run of notes playing one after another.
+ */
+export interface MediaPlaybackProps {
+    /**
+     * When a voice or round video note plays to its end, start the next newer
+     * one in the chat. Default true.
+     */
+    isAutoPlayNextEnabled?: boolean;
+    /**
+     * Playback speed to start with (1, 1.5 or 2). The speed is shared by every
+     * note; pair this with `onPlaybackRateChange` to keep it across launches.
+     */
+    playbackRate?: number;
+    /** Called when the user changes the playback speed on any note. */
+    onPlaybackRateChange?: (rate: number) => void;
+    /**
+     * Round video notes loop silently in the list until tapped ("autoplay
+     * videos"). Default false: a note holds its first frame with a play
+     * button, and grows when tapped.
+     */
+    isRoundVideoAutoplayEnabled?: boolean;
+    /**
+     * A "now playing" bar at the top of the chat while a voice or round
+     * note plays or is paused: play/pause, sender, speed and close. Default true.
+     */
+    isNowPlayingBarEnabled?: boolean;
+    /**
+     * The floating round note: a round note still
+     * playing or paused when its row scrolls out of view keeps going in a small
+     * draggable circle over the list. Default true; when false, the note stops
+     * with its row instead, as a voice note does.
+     */
+    isFloatingRoundNoteEnabled?: boolean;
+    /**
+     * Called when an incoming voice or round note marked `isMediaUnread` starts
+     * playing, so the app can mark it listened.
+     */
+    onMediaRead?: (message: IMessage) => void;
+    /**
+     * The phone is held to the ear, from the app's proximity sensor. Raise to
+     * listen: playback moves to the earpiece, a note under a second in
+     * restarts, and lowering the phone pauses it.
+     */
+    isNearEar?: boolean;
+    /**
+     * Shows a transcribe button on voice and round notes. Called on tap; the app
+     * transcribes and sets `IMessage.transcription`, which is then shown.
+     */
+    onTranscribe?: (message: IMessage) => void;
+    /** A view-once note finished playing; the app should remove it. */
+    onViewOnceEnd?: (message: IMessage) => void;
+}
 export {};
 //# sourceMappingURL=Models.d.ts.map

package/lib/Models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Models.d.ts","sourceRoot":"","sources":["../src/Models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Models.d.ts","sourceRoot":"","sources":["../src/Models.ts"],"names":[],"mappings":"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"}

package/lib/Models.js.map

@@ -1 +1 @@
-{"version":3,"file":"Models.js","sourceRoot":"","sources":["../src/Models.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Models.js","names":[],"sources":["../src/Models.ts"],"sourcesContent":["import { StyleProp, ViewStyle } from 'react-native'\nimport { IconRenderer } from './Icons'\n\nexport type Omit<T, K> = Pick<T, Exclude<keyof T, K>>\n\n/**\n * The actions the chat can put in the long-press menu by itself, in this order:\n * `reply`, `copy`, `forward`, `pin`, `edit`, `delete`.\n */\nexport type MessageActionKey = 'reply' | 'copy' | 'forward' | 'pin' | 'edit' | 'select' | 'delete'\n\n/** An action shown in the message long-press context menu. */\nexport interface MessageMenuItem {\n  /**\n   * Identifies the action. The built-in ones carry their `MessageActionKey`, so a\n   * `messageActions` function can find, drop or reorder them.\n   */\n  key?: MessageActionKey | string\n  label: string\n  /** Optional leading icon, e.g. a lucide-react-native component. */\n  icon?: IconRenderer\n  onPress: () => void\n  /** Render the label in the destructive (error) color. */\n  destructive?: boolean\n}\n\nexport interface LeftRightStyle<T> {\n  left?: StyleProp<T>\n  right?: StyleProp<T>\n}\n\ntype renderFunction = (x: unknown) => React.ReactNode\n\nexport interface User {\n  _id: string | number\n  name?: string\n  avatar?: string | number | renderFunction\n}\n\nexport interface Reply {\n  title: string\n  value: string\n  messageId?: number | string\n}\n\nexport interface QuickReplies {\n  type: 'radio' | 'checkbox'\n  values: Reply[]\n  keepIt?: boolean\n}\n\nexport interface ReplyMessage extends Pick<IMessage, '_id' | 'text' | 'user' | 'audio' | 'image'> {}\n\nexport interface MessageReaction {\n  /** The emoji character (e.g. '👍') */\n  emoji: string\n  /** IDs of the users who reacted with this emoji */\n  userIds: (string | number)[]\n}\n\n/** A document attached to a message (`IMessage.file`), drawn as a file bubble. */\nexport interface IMessageFile {\n  /** Where the file is: a local `file://` path or a remote URL. */\n  uri: string\n  /** The file name shown in the bubble, with its extension. */\n  name: string\n  /** Size in bytes, shown under the name. */\n  size?: number\n  /** MIME type, used when the file is opened or shared. */\n  mimeType?: string\n}\n\n/**\n * A web page preview for the first link in a message: a block under the text\n * (accent bar, site name, title, description, picture). Fetching it takes a request to the page,\n * so the app supplies it, on the message or through `Chat`'s `fetchLinkPreview`.\n */\nexport interface LinkPreview {\n  /** The page the preview is for; a tap opens it. Defaults to the first link in the text. */\n  url?: string\n  /** The site's name, drawn in the accent color on top (`og:site_name`). */\n  siteName?: string\n  /** The page title, bold (`og:title`). */\n  title?: string\n  /** A few lines of the page's description (`og:description`). */\n  description?: string\n  /** The page's picture (`og:image`). */\n  image?: string\n  /** The picture's size, so it keeps its aspect ratio before it has loaded. */\n  imageWidth?: number\n  imageHeight?: number\n  /**\n   * `'large'` draws the picture full width under the text, `'small'` as a 48dp thumbnail at the\n   * top right, as for articles. Default: large when the picture is wider than tall.\n   */\n  imageSize?: 'large' | 'small'\n}\n\nexport interface IMessage {\n  _id: string | number\n  text: string\n  createdAt: Date | number\n  user: User\n  image?: string\n  /**\n   * A tiny stand-in shown under `image` until it has loaded, like a blurred thumbnail:\n   * a small image uri (drawn blurred), or a blurhash string when\n   * `expo-image` is installed.\n   */\n  imagePlaceholder?: string\n  video?: string\n  /** Render `video` as a round video note (circular, autoplay/muted) instead of a rectangular player. */\n  videoNote?: boolean\n  audio?: string\n  /**\n   * The voice or round note has not been played by its recipient yet. Draws\n   * an unread dot: on an incoming note until you play it, on an\n   * outgoing one until the recipient does.\n   */\n  isMediaUnread?: boolean\n  /**\n   * A view-once voice or round note: it plays a\n   * single time, then `mediaPlayback.onViewOnceEnd` lets the app remove it.\n   */\n  isViewOnce?: boolean\n  /** Text of a transcribed voice or round note, shown under it. */\n  transcription?: string\n  /**\n   * Length of `audio` / `video` in seconds. Set by the built-in recorders and\n   * used to label a voice note before its file has been decoded, so a bubble can\n   * render its duration without downloading the whole clip first.\n   */\n  duration?: number\n  system?: boolean\n  /** The message is pinned; the menu's pin action then reads \"Unpin\". */\n  isPinned?: boolean\n  sent?: boolean\n  received?: boolean\n  pending?: boolean\n  /** Sending failed: the ticks give way to a red error badge. */\n  isFailed?: boolean\n  /** The message was edited; its time reads \"edited 14:05\". Set by `useChatMessages`'s edit. */\n  isEdited?: boolean\n  /** When the message was last edited; any value also shows the \"edited\" mark. */\n  editedAt?: Date | number\n  /** True while this message's text is still being streamed in (shows a typing cursor) */\n  streaming?: boolean\n  quickReplies?: QuickReplies\n  replyMessage?: ReplyMessage\n  reactions?: MessageReaction[]\n  location?: {\n    latitude: number\n    longitude: number\n  }\n  /** A document: a file bubble (icon, name, size); a tap opens it. */\n  file?: IMessageFile\n  /** A preview of the first link in `text`, drawn under it. `null` hides the preview for this message. */\n  linkPreview?: LinkPreview | null\n  /**\n   * The message's media (photo, video, file, voice or round note) is uploading or downloading.\n   * Draws a progress ring with a cancel ✕ over it; a tap calls `mediaTransfer.onCancel`.\n   */\n  transfer?: MediaTransfer\n  /**\n   * The media is not on the device and is not fetched by itself: a download arrow,\n   * which calls `mediaTransfer.onDownload` when tapped. Without that handler a voice note\n   * downloads itself on the tap.\n   */\n  isDownloadRequired?: boolean\n  /**\n   * A voice note's waveform, as the server sends it with the note: levels in 0..1, or 5-bit\n   * 0..31 values. Drawn at once, before the audio has downloaded, and resampled to the\n   * bubble's bar count; without it the waveform is decoded from the audio.\n   */\n  waveform?: number[]\n}\n\n/** An upload or download of a message's media, `IMessage.transfer`. */\nexport interface MediaTransfer {\n  /** `upload` while sending, `download` while fetching. Both draw the same ring. */\n  type: 'upload' | 'download'\n  /** 0..1. Leave it out while unknown: the ring then shows a 4-degree dot, still turning. */\n  progress?: number\n  /** The file's size in bytes: a photo or video then shows \"1.2 MB / 4.5 MB\" while it moves. */\n  totalBytes?: number\n}\n\n/** Handlers for the media buttons of messages with `transfer` or `isDownloadRequired`. */\nexport interface MediaTransferProps {\n  /** The download arrow was tapped: start fetching, and set `transfer` while it runs. */\n  onDownload?: (message: IMessage) => void\n  /** The cancel ✕ was tapped during an upload or download. */\n  onCancel?: (message: IMessage) => void\n}\n\nexport type IChatMessage = IMessage\n\nexport interface MessageVideoProps<TMessage extends IMessage> {\n  currentMessage: TMessage\n  position?: 'left' | 'right'\n  containerStyle?: StyleProp<ViewStyle>\n  videoStyle?: StyleProp<ViewStyle>\n  videoProps?: object\n}\n\nexport interface MessageAudioProps<TMessage extends IMessage> {\n  currentMessage: TMessage\n  position?: 'left' | 'right'\n  containerStyle?: StyleProp<ViewStyle>\n  audioStyle?: StyleProp<ViewStyle>\n  audioProps?: object\n}\n\nexport interface MessageFileProps<TMessage extends IMessage> {\n  currentMessage: TMessage\n  position?: 'left' | 'right'\n  containerStyle?: StyleProp<ViewStyle>\n  /** Override opening the file (the system share sheet with `expo-sharing`, else `Linking`). */\n  onPress?: (file: IMessageFile) => void\n}\n\nexport interface MessageLocationProps<TMessage extends IMessage> {\n  currentMessage: TMessage\n  position?: 'left' | 'right'\n  containerStyle?: StyleProp<ViewStyle>\n  locationStyle?: StyleProp<ViewStyle>\n  /** Override the default behavior (opening the system maps app) when tapped. */\n  onPress?: (location: { latitude: number, longitude: number }) => void\n}\n\n/**\n * Hold-to-record voice messages. Requires the optional\n * `expo-audio` peer dependency; when it is absent the mic button is hidden.\n */\nexport interface AudioRecordingProps {\n  /**\n   * Show the \"view once\" toggle above the lock while a take is locked.\n   * A take sent with it on arrives in `onSend` with `isViewOnce: true`.\n   */\n  isViewOnceEnabled?: boolean\n  /** On by default when `expo-audio` is installed; `false` hides the mic button. */\n  isEnabled?: boolean\n  /** Minimum recording length (ms) below which the take is discarded. Default 800. */\n  minDurationMs?: number\n  /**\n   * Maximum recording length (ms); the take is sent automatically when reached.\n   * Matters most for a locked recording, which otherwise runs until the user\n   * sends it. Default 600000 (10 minutes).\n   */\n  maxDurationMs?: number\n  /**\n   * Called when the microphone permission is refused. iOS never re-prompts, so\n   * this is the hook for pointing the user at Settings - without it a denied\n   * permission leaves the mic button silently dead.\n   */\n  onPermissionDenied?: () => void\n  /** Called when a take is dropped for being shorter than `minDurationMs`. */\n  onTooShort?: () => void\n  onError?: (error: unknown) => void\n}\n\n/**\n * Record-and-send video messages from the camera. Requires the optional\n * `expo-image-picker` peer dependency; when it is absent the button is hidden.\n */\nexport interface VideoRecordingProps {\n  /** As `audioRecording.isViewOnceEnabled`, for round video takes. */\n  isViewOnceEnabled?: boolean\n  /**\n   * On by default when `react-native-vision-camera` is installed; `false` turns round video\n   * off, `true` also falls back to the system camera (`expo-image-picker`) without it.\n   */\n  isEnabled?: boolean\n  /** Max video length in seconds. Default 60. */\n  maxDuration?: number\n  /** Minimum video length (ms) below which the take is discarded. Default 800. */\n  minDurationMs?: number\n  /**\n   * Called when the camera (or microphone) permission is refused, so the app can\n   * point the user at Settings instead of leaving a dead button.\n   */\n  onPermissionDenied?: () => void\n  /** Called when a take is dropped for being shorter than `minDurationMs`. */\n  onTooShort?: () => void\n  onError?: (error: unknown) => void\n}\n\n/**\n * How voice notes and round video notes play back in the chat: one speed\n * shared by every note, and a run of notes playing one after another.\n */\nexport interface MediaPlaybackProps {\n  /**\n   * When a voice or round video note plays to its end, start the next newer\n   * one in the chat. Default true.\n   */\n  isAutoPlayNextEnabled?: boolean\n  /**\n   * Playback speed to start with (1, 1.5 or 2). The speed is shared by every\n   * note; pair this with `onPlaybackRateChange` to keep it across launches.\n   */\n  playbackRate?: number\n  /** Called when the user changes the playback speed on any note. */\n  onPlaybackRateChange?: (rate: number) => void\n  /**\n   * Round video notes loop silently in the list until tapped (\"autoplay\n   * videos\"). Default false: a note holds its first frame with a play\n   * button, and grows when tapped.\n   */\n  isRoundVideoAutoplayEnabled?: boolean\n  /**\n   * A \"now playing\" bar at the top of the chat while a voice or round\n   * note plays or is paused: play/pause, sender, speed and close. Default true.\n   */\n  isNowPlayingBarEnabled?: boolean\n  /**\n   * The floating round note: a round note still\n   * playing or paused when its row scrolls out of view keeps going in a small\n   * draggable circle over the list. Default true; when false, the note stops\n   * with its row instead, as a voice note does.\n   */\n  isFloatingRoundNoteEnabled?: boolean\n  /**\n   * Called when an incoming voice or round note marked `isMediaUnread` starts\n   * playing, so the app can mark it listened.\n   */\n  onMediaRead?: (message: IMessage) => void\n  /**\n   * The phone is held to the ear, from the app's proximity sensor. Raise to\n   * listen: playback moves to the earpiece, a note under a second in\n   * restarts, and lowering the phone pauses it.\n   */\n  isNearEar?: boolean\n  /**\n   * Shows a transcribe button on voice and round notes. Called on tap; the app\n   * transcribes and sets `IMessage.transcription`, which is then shown.\n   */\n  onTranscribe?: (message: IMessage) => void\n  /** A view-once note finished playing; the app should remove it. */\n  onViewOnceEnd?: (message: IMessage) => void\n}\n"],"mappings":"","ignoreList":[]}