@ethora/chat-component 26.7.5 → 26.7.6

package/dist/VisibilityModal-DkMhx_2k.js

@@ -0,0 +1,132 @@
+import { jsxs as r, jsx as e } from "react/jsx-runtime";
+import { useState as b, useEffect as x } from "react";
+import { x as o, a as L, n as P, u as z, aF as D, aG as I } from "./main-B-8IhwaP.js";
+import { S as N, D as C, a as w, b as O, e as S, f as p } from "./SideDrawer-Dr_lkaOW.js";
+o.div``;
+o.div`
+  font-size: 16px;
+  font-weight: bold;
+  color: var(--ethora-color-text, #141414);
+`;
+o.p`
+  font-size: 14px;
+  color: var(--ethora-color-text-muted, #6b7280);
+  margin-bottom: 32px;
+`;
+const $ = o.div`
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+`, h = o.label`
+  display: flex;
+  align-items: center;
+  font-size: 14px;
+  gap: 8px;
+`, f = o.input`
+  accent-color: ${({ $radioColor: t }) => t || "var(--ethora-color-primary, #0052CD)"};
+  margin: 0px;
+`, R = o.div`
+  padding: 10px 15px;
+  margin-top: 16px;
+  color: ${({ type: t }) => t === "success" ? "#10b981" : "#ef4444"};
+  background: ${({ type: t }) => t === "success" ? "#d1fae5" : "#fee2e2"};
+  border: 1px solid
+    ${({ type: t }) => t === "success" ? "#10b981" : "#ef4444"};
+  border-radius: 4px;
+`, M = ({
+  handleCloseModal: t
+}) => {
+  const k = L(), i = P(), { user: c, config: l } = z(
+    (s) => s.chatSettingStore
+  ), y = (s) => k(I(s)), [n, m] = b(c?.isProfileOpen), [a, g] = b(c?.isAssetsOpen), [u, v] = b(null), d = (s, A) => {
+    v({ message: s, type: A }), setTimeout(() => v(null), 3e3);
+  };
+  return x(() => {
+    n !== c.isProfileOpen && D({ isProfileOpen: n }).then(({ data: s }) => {
+      y(s.user), d(i("notification.saved"), "success");
+    }).catch(() => d(i("toast.error"), "error"));
+  }, [n]), x(() => {
+    a !== c?.isAssetsOpen && D({ isAssetsOpen: a }).then(({ data: s }) => {
+      y(s.user), d(i("notification.saved"), "success");
+    }).catch(() => d(i("toast.error"), "error"));
+  }, [a]), /* @__PURE__ */ r(
+    N,
+    {
+      title: i("settings.visibility.title"),
+      onClose: t,
+      backLabel: i("action.back"),
+      children: [
+        /* @__PURE__ */ r(C, { children: [
+          /* @__PURE__ */ e(w, { children: i("settings.visibility.profileLabel") }),
+          /* @__PURE__ */ e(O, { children: /* @__PURE__ */ e(S, { children: /* @__PURE__ */ r($, { children: [
+            /* @__PURE__ */ r(h, { children: [
+              /* @__PURE__ */ e(
+                f,
+                {
+                  $radioColor: l?.colors?.primary,
+                  type: "radio",
+                  name: "ethora-profile-visibility",
+                  checked: n === !0,
+                  onChange: () => m(!0)
+                }
+              ),
+              i("settings.visibility.open")
+            ] }),
+            /* @__PURE__ */ e(p, { children: i("settings.visibility.openDescription") }),
+            /* @__PURE__ */ r(h, { children: [
+              /* @__PURE__ */ e(
+                f,
+                {
+                  $radioColor: l?.colors?.primary,
+                  type: "radio",
+                  name: "ethora-profile-visibility",
+                  checked: n === !1,
+                  onChange: () => m(!1)
+                }
+              ),
+              i("settings.visibility.restricted")
+            ] }),
+            /* @__PURE__ */ e(p, { children: i("settings.visibility.restrictedDescription") })
+          ] }) }) })
+        ] }),
+        /* @__PURE__ */ r(C, { children: [
+          /* @__PURE__ */ e(w, { children: i("settings.visibility.documentsLabel") }),
+          /* @__PURE__ */ e(O, { children: /* @__PURE__ */ e(S, { children: /* @__PURE__ */ r($, { children: [
+            /* @__PURE__ */ r(h, { children: [
+              /* @__PURE__ */ e(
+                f,
+                {
+                  $radioColor: l?.colors?.primary,
+                  type: "radio",
+                  name: "ethora-documents-visibility",
+                  checked: a === !0,
+                  onChange: () => g(!0)
+                }
+              ),
+              i("settings.visibility.full")
+            ] }),
+            /* @__PURE__ */ e(p, { children: i("settings.visibility.fullDescription") }),
+            /* @__PURE__ */ r(h, { children: [
+              /* @__PURE__ */ e(
+                f,
+                {
+                  $radioColor: l?.colors?.primary,
+                  type: "radio",
+                  name: "ethora-documents-visibility",
+                  checked: a === !1,
+                  onChange: () => g(!1)
+                }
+              ),
+              i("settings.visibility.individual")
+            ] }),
+            /* @__PURE__ */ e(p, { children: i("settings.visibility.individualDescription") })
+          ] }) }) })
+        ] }),
+        u && /* @__PURE__ */ e(R, { type: u.type, children: u.message })
+      ]
+    }
+  );
+};
+export {
+  M as default
+};

package/dist/assets/icons.d.ts

@@ -7,9 +7,11 @@ export declare const AddNewIcon: ({ color, ...props }: {
     color?: string;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const AttachIcon: ({ color, bgcolor, ...props }: any) => import("react/jsx-runtime").JSX.Element;
+export declare const EmojiIcon: ({ color, bgcolor, ...props }: any) => import("react/jsx-runtime").JSX.Element;
 export declare const CloseIcon: ({ color, ...props }: any) => import("react/jsx-runtime").JSX.Element;
 export declare const DownloadIcon: ({ color, ...props }: any) => import("react/jsx-runtime").JSX.Element;
 export declare const RecordIcon: ({ color, bgcolor, ...props }: any) => import("react/jsx-runtime").JSX.Element;
+export declare const PdfIcon: ({ fill, color, ...props }: any) => import("react/jsx-runtime").JSX.Element;
 export declare const RemoveIcon: (props: any) => import("react/jsx-runtime").JSX.Element;
 export declare const SendIcon: ({ color, bgcolor, ...props }: {
     [x: string]: any;
@@ -47,6 +49,14 @@ export declare const ReportIcon: ({ color, ...props }: {
     [x: string]: any;
     color?: string;
 }) => import("react/jsx-runtime").JSX.Element;
+export declare const BellIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const BellOffIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
 export declare const DeleteIcon: ({ fill, color, width, height, ...props }: {
     [x: string]: any;
     fill?: string;
@@ -142,3 +152,23 @@ export declare const SingleTick: ({ color, ...props }: {
     [x: string]: any;
     color?: string;
 }) => import("react/jsx-runtime").JSX.Element;
+export declare const ChevronLeftIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ChevronRightIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ZoomInIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ZoomOutIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ZoomResetIcon: ({ color, ...props }: {
+    [x: string]: any;
+    color?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/ContextMenu/ContextMenuComponents.d.ts

@@ -1,11 +1,9 @@
-import { default as Picker } from '@emoji-mart/react';
 export declare const ContainerInteractions: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const ReactionContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const ReactionBadge: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;
 export declare const ArrowButton: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    isRotated: boolean;
+    $isRotated: boolean;
 }>> & string;
-export declare const StyledPicker: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<any, never>> & string & Omit<typeof Picker, keyof import('react').Component<any, {}, any>>;
 export declare const ContextMenu: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const MenuItem: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const Overlay: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;

package/dist/components/EmojiPicker/LazyEmojiPicker.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const LazyEmojiPicker: React.FC<any>;
+export default LazyEmojiPicker;

package/dist/components/ExampleComponents/CustomMessage.d.ts

@@ -1,14 +1,14 @@
 import { default as React } from 'react';
 import { MessageProps } from '../../types/types';
 export declare const MessageContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    isUser: boolean;
+    $isUser: boolean;
 }>> & string;
 export declare const MessageBubble: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    isUser: boolean;
+    $isUser: boolean;
 }>> & string;
 export declare const MessageText: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, never>> & string;
 export declare const UserName: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {
-    isUser: boolean;
+    $isUser: boolean;
     color?: string;
 }>> & string;
 export declare const MessageTimestamp: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;

package/dist/components/Files/FilesList.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { ApiFile } from '../../types/types';
+export interface FilesListProps {
+    items: ApiFile[];
+    fileToken?: string;
+    onPreview: (file: ApiFile) => void;
+    onDownload: (file: ApiFile) => void;
+    onDelete: (file: ApiFile) => void;
+    compact?: boolean;
+}
+declare const FilesList: React.FC<FilesListProps>;
+export default FilesList;

package/dist/components/Files/FilesPanel.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const FilesPanel: React.FC;
+export default FilesPanel;

package/dist/components/Files/fileCategory.d.ts

@@ -0,0 +1,13 @@
+import { ApiFile } from '../../types/types';
+export type FileCategory = 'media' | 'documents' | 'audio';
+/**
+ * Category derivation for the filter chips - purely mimetype-driven since
+ * that is the one field the backend always sends alongside originalname.
+ * image/* and video/* both live under "Media" (they share the grid layout
+ * with thumbnails); audio/* gets its own chip; everything else falls back
+ * to "Documents".
+ */
+export declare function getFileCategory(mimetype?: string | null): FileCategory;
+export declare function isPreviewable(file: Pick<ApiFile, 'mimetype'>): boolean;
+/** Human-readable byte size, e.g. formatBytes(1536) -> "1.5 KB". */
+export declare function formatBytes(bytes?: number | null): string;

package/dist/components/InputComponents/AttachmentPreview.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { IConfig } from '../../types/types';
+interface AttachmentPreviewProps {
+    file: File;
+    /** Blob URL for this file, owned by the composer. */
+    objectUrl?: string;
+    onRemove: (file: File) => void;
+    config?: IConfig;
+    removeLabel?: string;
+}
+/**
+ * One picked-but-not-yet-sent file. PDFs get the same first-page render the
+ * bubble does - the file is already local, so it costs one blob read and
+ * makes "did I attach the right document?" answerable before sending.
+ */
+declare const AttachmentPreview: React.FC<AttachmentPreviewProps>;
+export default AttachmentPreview;

package/dist/components/InputComponents/MentionDropdown.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { MentionCandidate } from '../../helpers/mentions';
+interface MentionDropdownProps {
+    candidates: MentionCandidate[];
+    totalCount: number;
+    hasOverflow: boolean;
+    highlightedIndex: number;
+    onSelect: (candidate: MentionCandidate) => void;
+    onShowAll: () => void;
+    onHoverIndex: (index: number) => void;
+}
+export declare const MentionDropdown: React.FC<MentionDropdownProps>;
+export default MentionDropdown;

package/dist/components/InputComponents/MentionPickerModal.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { RoomMember } from '../../types/types';
+import { MentionCandidate } from '../../helpers/mentions';
+interface MentionPickerModalProps {
+    members: RoomMember[];
+    selfId?: string;
+    onSelect: (candidate: MentionCandidate) => void;
+    onClose: () => void;
+}
+/**
+ * Overflow picker for @-mentions, shown from the inline dropdown's
+ * "Show all N..." row when a room has more members than the inline list can
+ * display. Deliberately reuses UsersList - the same windowed member list the
+ * New Chat / add-members flows already use - in its single-select mode
+ * (see UsersList's `singleSelect`/`onSingleSelect` props) instead of
+ * building a second member list with its own windowing/search/empty-state.
+ */
+export declare const MentionPickerModal: React.FC<MentionPickerModalProps>;
+export default MentionPickerModal;

package/dist/components/MainComponents/AttachmentList.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { IAttachment } from '../../types/types';
+interface AttachmentListProps {
+    attachments: IAttachment[];
+}
+declare const AttachmentList: React.FC<AttachmentListProps>;
+export default AttachmentList;

package/dist/components/MainComponents/ChatErrorBoundary.d.ts

@@ -0,0 +1,53 @@
+import { default as React } from 'react';
+import { ChatErrorScope, IConfig } from '../../types/models/config.model';
+interface ChatErrorBoundaryProps {
+    children: React.ReactNode;
+    /** Host config: supplies `fallbackScreens.error` and `eventHandlers.onError`. */
+    config?: IConfig;
+    /** Which part of the SDK crashed. Reported to the host and logged. */
+    scope?: ChatErrorScope;
+    /**
+     * Render nothing at all after a crash instead of the default screen. Used
+     * for the call overlay, where a full-size "something went wrong" panel
+     * would sit on top of the host application forever.
+     */
+    silent?: boolean;
+}
+interface ChatErrorBoundaryState {
+    error: Error | null;
+    componentStack?: string;
+    /** Bumped by "try again"; keying the subtree on it forces a re-mount. */
+    resetCount: number;
+}
+/**
+ * The SDK's crash barrier.
+ *
+ * `@ethora/chat-component` renders inside somebody else's application. Without
+ * a boundary, one uncaught render error anywhere in the chat tree unmounts the
+ * host's whole React root - the customer's app white-screens because of a bug
+ * in ours. That has already happened twice in the field (a router crash on an
+ * undefined `config.colors.primary`, and "Cannot destructure property
+ * 'composing'" when leaving a room), so the barrier is not hypothetical.
+ *
+ * Behaviour:
+ *  - the error is never swallowed: it is always logged through
+ *    `ethoraLogger.criticalError` together with the React component stack;
+ *  - the host can be notified via `config.eventHandlers.onError` (wrapped so a
+ *    throw inside the host's own handler cannot crash the boundary, the same
+ *    defence useEventHandlers applies to the message handlers);
+ *  - the host can replace the screen via `config.fallbackScreens.error`, which
+ *    follows the same shape as `noUser` / `noConnection` / `noRoom` (string =
+ *    centered text, React node = rendered as-is) and additionally accepts a
+ *    render function receiving `{ error, componentStack, scope, reset }`;
+ *  - "try again" clears the error and re-mounts the subtree, because most of
+ *    these crashes are transient state problems that a fresh mount fixes.
+ */
+declare class ChatErrorBoundary extends React.Component<ChatErrorBoundaryProps, ChatErrorBoundaryState> {
+    state: ChatErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): Partial<ChatErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    reset: () => void;
+    private renderFallback;
+    render(): React.ReactNode;
+}
+export default ChatErrorBoundary;

package/dist/components/MainComponents/ChatErrorScreen.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+/** Stable test ids for the default crash screen. */
+export declare const ChatErrorScreenTestIds: {
+    readonly screen: "chat_error_screen";
+    readonly retryButton: "chat_error_retry_button";
+};
+interface ChatErrorScreenProps {
+    /** Re-mounts the crashed subtree. */
+    onRetry: () => void;
+    style?: React.CSSProperties;
+}
+/**
+ * Default fallback rendered by <ChatErrorBoundary> when the chat tree throws.
+ *
+ * Deliberately calm and small: no stack traces, no red alarm state - an end
+ * user of the host application sees this, not a developer. Every caption goes
+ * through useT() so it follows the same locale as the rest of the chat, and
+ * the accent colour comes from the host's own `config.colors` (via
+ * resolveIconColor) plus the `--ethora-font-*` variables the typography
+ * config publishes, so it never looks like a foreign screen dropped into a
+ * themed app.
+ */
+declare const ChatErrorScreen: React.FC<ChatErrorScreenProps>;
+export default ChatErrorScreen;

package/dist/components/MainComponents/HeaderLogo.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+interface HeaderLogoProps {
+    /**
+     * A plain string is treated as an image URL and rendered as an `<img>`;
+     * any other node is rendered as-is. Same string-or-node duality as
+     * `config.fallbackScreens` (see FallbackScreen).
+     */
+    logo: string | React.ReactElement;
+    /** Rendered height in pixels. Default 32. */
+    size?: number;
+}
+export declare const HEADER_LOGO_TEST_ID = "ethora-header-logo";
+/**
+ * Host-provided logo shown at the left of the chat header, for white-label
+ * embedding. See IConfig.headerLogo.
+ */
+declare const HeaderLogo: React.FC<HeaderLogoProps>;
+export default HeaderLogo;

package/dist/components/MainComponents/MediaMessage.d.ts

@@ -1,6 +1,11 @@
 import { default as React } from 'react';
 import { IMessage } from '../../types/types';
 interface MediaMessageProps {
+    /**
+     * Legacy props. They describe attachment #0 only and are kept because
+     * hosts pass them when overriding the message renderer; `message` is the
+     * source of truth whenever it is present.
+     */
     mimeType?: string;
     message?: IMessage;
     location?: string;

package/dist/components/MainComponents/MessageContainer.d.ts

@@ -1,4 +1,4 @@
-import { default as React, FC } from 'react';
+import { default as React } from 'react';
 import { IConfig, IMessage } from '../../types/types';
 interface MessageContainerProps {
     CustomMessage?: React.ComponentType<{
@@ -15,5 +15,5 @@ interface MessageContainerProps {
     showDateLabel: boolean;
     className?: string;
 }
-export declare const MessageContainer: FC<MessageContainerProps>;
+export declare const MessageContainer: React.NamedExoticComponent<MessageContainerProps>;
 export {};

package/dist/components/MainComponents/ReduxWrapper.d.ts

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 import { ConfigUser, IConfig } from '../../types/types';
 import { CustomComponentsContextValue } from '../../types/models/customComponents.model';
-interface ChatWrapperProps extends Pick<CustomComponentsContextValue, 'CustomMessageComponent' | 'CustomInputComponent' | 'CustomScrollableArea' | 'CustomDaySeparator' | 'CustomNewMessageLabel'> {
+export interface ChatWrapperProps extends Pick<CustomComponentsContextValue, 'CustomMessageComponent' | 'CustomInputComponent' | 'CustomScrollableArea' | 'CustomDaySeparator' | 'CustomNewMessageLabel'> {
     token?: string;
     roomJID?: string;
     user?: ConfigUser;
@@ -13,4 +13,3 @@ interface ChatWrapperProps extends Pick<CustomComponentsContextValue, 'CustomMes
     config?: IConfig;
 }
 export declare const ReduxWrapper: React.FC<ChatWrapperProps>;
-export {};

package/dist/components/MainComponents/SystemMessage.d.ts

@@ -7,8 +7,7 @@ interface SystemMessageProps {
     };
 }
 export declare const CustomSystemMessageText: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    primary?: string;
-    secondary?: string;
+    $primary?: string;
 }>> & string;
 declare const SystemMessage: React.FC<SystemMessageProps>;
 export default SystemMessage;

package/dist/components/MenuRoom/MenuRoom.d.ts

@@ -1,5 +1,6 @@
 import { FC } from 'react';
 interface RoomMenuProps {
+    roomJid?: string;
     handleLeaveClick: () => void;
     handleReportClick: () => void;
 }

package/dist/components/MessageBubble/CustomDivider.d.ts

@@ -1,5 +1,5 @@
 export declare const CustomDivider: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    configColor: string;
-    configColorUser: string;
-    isUser: boolean;
+    $configColor: string;
+    $configColorUser: string;
+    $isUser: boolean;
 }>> & string;

package/dist/components/MessageBubble/Message.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 import { MessageProps } from '../../types/types';
-declare const Message: React.FC<MessageProps>;
-export { Message };
+declare const MemoizedMessage: React.NamedExoticComponent<MessageProps>;
+export { MemoizedMessage as Message };

package/dist/components/MessageBubble/MessageTranslate.d.ts

@@ -7,19 +7,37 @@ interface MessageTranslateProps {
 }
 /**
  * Manual-mode message translation (LinkedIn-style). Renders a "Translate"
- * link under an incoming message; on click it calls
- * `config.translates.onTranslate` (host-provided) - or, when the host
- * doesn't supply one, reads whatever translation already arrived attached
- * to the stanza (`message.translations`) - and shows the result inline
- * with a "Show original" toggle. No default translation service is called
- * here; a message with nothing attached and no host `onTranslate` simply
- * has nothing to reveal (see `translation.failed`).
+ * link under an incoming message; on click it resolves a translation in
+ * this order:
+ *
+ *  1. `config.translates.onTranslate` (host-provided) - wins whenever set;
+ *  2. whatever translation already arrived attached to the stanza
+ *     (`message.translations`), read through the SAME shared resolver
+ *     `resolveMessageTranslation` that auto mode uses - free, no request,
+ *     and guaranteed to show exactly what auto mode would have rendered
+ *     automatically for this message;
+ *  3. a fetch from the translate service, ONLY when the host has explicitly
+ *     set `config.translates.endpoint` - the built-in HTTP call is opt-in,
+ *     never a default. The result is cached onto the message in the store
+ *     (setMessageTranslation) so a second click - and 'auto' mode, if the
+ *     reader switches to it - see it for free, even after this bubble
+ *     unmounts and remounts (long rooms remount bubbles on scroll).
+ *
+ * A message with nothing attached, no host `onTranslate`, and no explicit
+ * `endpoint` simply has nothing to reveal - and in that case the link itself
+ * does not render at all (see `shouldShow` below), rather than offering a
+ * click that can only ever end in `translation.failed`. That retry link is
+ * reserved for a genuine attempt that came back empty or threw (host
+ * `onTranslate`, or an explicitly configured `endpoint`).
  *
  * Visibility: `config.translates.showTranslateForMessage(message)` if the host
  * supplies it (they keep the locale logic and just tell us yes/no); otherwise
- * we compare the message's source base-language with the reader's base-language
- * (region ignored, so en-US vs en-CA shows nothing). The reader's FULL locale
- * (fr-CA vs fr-FR) is still forwarded to `onTranslate` as `targetLocale`.
+ * the link shows only when the message actually needs translating for this
+ * reader (same gate as auto mode: known source language, base-language
+ * mismatch, actual translatable text) AND there is something that could
+ * reveal a translation - an attached one, a host `onTranslate`, or an
+ * explicit `endpoint`. The reader's FULL locale (fr-CA vs fr-FR) is still
+ * forwarded to `onTranslate` as `targetLocale`.
  */
 declare const MessageTranslate: FC<MessageTranslateProps>;
 export default MessageTranslate;

package/dist/components/MessageBubble/QuickReplies.d.ts

@@ -4,15 +4,16 @@ interface QuickRepliesProps {
     replies: QuickReply[];
     messageId: string;
     accentColor?: string;
-    /** Already answered (in this session) - chips render disabled. */
+    /** Already answered - the chips are gone for good. */
     answered?: boolean;
     onSelect: (reply: QuickReply, questionId: string) => void;
 }
 /**
- * Buttons offered by a bot message. Tapping one answers the message: the
- * chips lock immediately (so a double tap cannot post two answers) and stay
- * visible, which keeps the transcript readable - you can still see what the
- * options were next to the answer that was picked.
+ * Buttons offered by a bot message. Tapping one answers the message and the
+ * whole row disappears: the answer is already in the transcript as the
+ * user's own message, so leaving spent options on screen only invites a
+ * second tap on a question that is closed. Removing them is also what makes
+ * a double tap impossible rather than merely refused.
  */
 declare const QuickReplies: React.FC<QuickRepliesProps>;
 export default QuickReplies;

package/dist/components/Modals/ChatProfileModal/ChatProfileMemberRow.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { RoomMember } from '../../../types/types';
+interface ChatProfileMemberRowProps {
+    member: RoomMember;
+    isLast: boolean;
+    disableClick: boolean;
+    online: boolean;
+    showMenu: boolean;
+    menuOptions: {
+        label: string;
+        icon: any;
+        onClick: (e?: any) => void;
+    }[];
+    moreOptionsLabel: string;
+    onAvatarClick: (user: RoomMember) => void;
+}
+declare const _default: React.NamedExoticComponent<ChatProfileMemberRowProps>;
+export default _default;

package/dist/components/Modals/FilePreviewModal/FilePreviewModal.d.ts

@@ -2,5 +2,22 @@ import { default as React } from 'react';
 interface FilePreviewModalProps {
     handleCloseModal: any;
 }
+/**
+ * Full-screen media viewer.
+ *
+ * Images get a real lightbox: previous/next across every image loaded for
+ * the room (see helpers/roomImageGallery for exactly what that set is),
+ * wheel/pinch zoom with bounded panning, double-click/double-tap to toggle
+ * fit, arrow-key and swipe navigation. Video, PDF and unsupported files take
+ * the same paths they always did and get no navigation chrome, so opening a
+ * PDF is the experience it was before.
+ *
+ * Escape, initial focus and focus restore are NOT handled here: the modal
+ * layer (Modals/Modal/Modal.tsx) already runs `useModalDismiss` around every
+ * entry in MODAL_COMPONENTS, this one included. Adding a second Escape
+ * listener would double-handle the key and fight that hook's focus restore,
+ * so the only key listener below is for the arrows, and it explicitly leaves
+ * every other key (Escape included) alone.
+ */
 declare const FilePreviewModal: React.FC<FilePreviewModalProps>;
 export default FilePreviewModal;