@factorialco/f0-react 4.67.0 → 4.68.0

package/dist/experimental.d.ts

@@ -3762,7 +3762,9 @@ declare const defaultTranslations: {
         readonly cancelRecording: "Cancel recording";
         readonly dropFilesHere: "Drop your files here";
         readonly removeFile: "Remove";
+        readonly removeNamedFile: "Remove {{name}}";
         readonly tooManyFilesError: "You can attach up to {{maxFiles}} files at once";
+        readonly fileTooLargeError: "Each file must be {{maxFileSize}} or smaller";
         readonly fileUploadError: "Upload failed";
         readonly micPermissionDenied: "Microphone access is blocked. Allow it in your browser settings to dictate.";
         readonly micError: "Couldn't access the microphone.";
@@ -3798,6 +3800,7 @@ declare const defaultTranslations: {
         readonly reply: "Reply";
         readonly react: "Add reaction";
         readonly download: "Download";
+        readonly downloadNamedFile: "Download {{name}}";
         readonly removeQuote: "Remove quote";
         readonly edit: "Edit";
         readonly editing: "Editing";
@@ -3811,7 +3814,10 @@ declare const defaultTranslations: {
         readonly previousImage: "Previous image";
         readonly nextImage: "Next image";
         readonly openDocument: "Open document";
+        readonly openNamedDocument: "Open {{name}}";
         readonly documentPreview: "Document preview";
+        readonly videoPlayerLabel: "Video player: {{name}}";
+        readonly loadingVideo: "Loading video: {{name}}";
         readonly photo: "Photo";
         readonly photoCount: {
             readonly one: "{{count}} photo";
@@ -5187,7 +5193,11 @@ export declare type F0ChatChannel = {
      * factorial sources these from its own data (e.g. HR vacation status).
      */
     statuses?: F0ChatChannelStatus[];
-    /** Group only. */
+    /**
+     * Group only. Total channel members, including the current user. F0 compares
+     * `memberCount - 1` with the unique other members in `readBy` (or its count
+     * fallback) before showing the all-read footer state.
+     */
     memberCount?: number;
     /** DM only — the counterpart, used for the header identity hover card. */
     user?: F0ChatUser;
@@ -5222,6 +5232,17 @@ export declare type F0ChatFileAttachment = {
     name: string;
     size?: number;
     mimeType?: string;
+    /** Poster used when a video file renders through the inline F0VideoPlayer. */
+    thumbnailUrl?: string;
+    /**
+     * Optional captions/audio-description sources for video files. Passed
+     * directly to F0VideoPlayer; ignored for non-video files.
+     */
+    videoContent?: VideoPlayerContent;
+    /** Initial locale for localized video audio and accessibility content. */
+    videoDefaultLanguage?: string;
+    /** Declare that a video file has no audio, so captions are not required. */
+    videoSilent?: boolean;
     /** 0–100 while uploading; undefined once done. */
     progress?: number;
 };
@@ -5354,9 +5375,14 @@ export declare type F0ChatMessage = {
      */
     mentionedEveryone?: boolean;
     /**
-     * Group read receipts — how many other members have read this message.
-     * Approximated by counting members whose last-read pointer is at/after this
-     * message (Stream exposes no per-message reader list).
+     * Group read receipts — the other members who have read this message.
+     * Hosts derive this from their transport's per-member read pointers.
+     */
+    readBy?: F0ChatUser[];
+    /**
+     * Group read-receipt count for hosts that cannot provide reader identities.
+     * Prefer `readBy` when identities are available; F0 derives its count from
+     * `readBy.length`.
      */
     readByCount?: number;
     /**
@@ -5389,7 +5415,10 @@ export declare type F0ChatMessageReply = {
  * shows a tappable critical alert whose menu is reduced to Retry / Delete.
  * `delivered` (reached the counterpart's device, not read yet) is for backends
  * that distinguish it — Stream doesn't, so the factorial adapter never emits it
- * and those messages go straight from `sent` to `read`.
+ * and those messages go straight from `sent` to `read`. In groups, `read`
+ * should only be emitted when all other channel members have read the message;
+ * F0 also guards that transition with `channel.memberCount` and the available
+ * `readBy` / `readByCount`.
  */
 export declare type F0ChatMessageStatus = "sending" | "sent" | "delivered" | "read" | "failed";
 
@@ -5423,6 +5452,10 @@ export declare type F0ChatReaction = {
     emoji: string;
     count: number;
     reactedByMe: boolean;
+    /**
+     * People who reacted with this emoji. Hosts may omit this initial list and
+     * provide {@link F0ChatRuntime.loadReactionUsers} to resolve it lazily.
+     */
     users?: F0ChatUser[];
 };
 
@@ -5483,6 +5516,13 @@ export declare type F0ChatRuntime = {
     retryMessage: (id: string) => void | Promise<void>;
     loadOlder: () => void;
     toggleReaction: (messageId: string, emoji: string) => void | Promise<void>;
+    /**
+     * Resolve the complete user list for one reaction on demand. F0 calls this
+     * when the reaction receives pointer hover or keyboard focus and caches the
+     * result while its count is unchanged. Omit when every reaction already
+     * carries its complete {@link F0ChatReaction.users} list.
+     */
+    loadReactionUsers?: (messageId: string, emoji: string) => Promise<F0ChatUser[]>;
     /**
      * Delete a message that exists server-side (soft delete → tombstone, or hard
      * delete → removed from `messages`).
@@ -5530,6 +5570,13 @@ export declare type F0ChatRuntime = {
      * textarea (mirrors the AI chat). Omit for no limit.
      */
     maxFiles?: number;
+    /**
+     * Maximum size in bytes for each file selected, dropped, or pasted into the
+     * composer. When any file exceeds the limit, the composer rejects the whole
+     * batch before calling `uploadFiles` and keeps the validation error visible
+     * until the next attachment attempt. Omit for no size limit.
+     */
+    maxFileSizeBytes?: number;
     /**
      * Optional voice dictation — same signature as the AI chat (streams partials).
      * Not part of the Stream transport; a host wires it to its own speech service
@@ -7673,6 +7720,26 @@ declare interface LoadingStateProps {
     label: string;
 }
 
+/** A single value, or the same value provided in multiple languages. */
+declare type Localized<T> = T | LocalizedOption<T>[];
+
+/**
+ * Shared helpers for content that can be provided in one language (a plain
+ * value) or several (a list of per-locale entries) — used by the media players
+ * for captions, descriptions, transcriptions and summaries.
+ */
+declare interface LocalizedOption<T> {
+    /** BCP-47 language tag, e.g. `"en"`, `"es"`, `"en-US"`. */
+    locale: string;
+    /**
+     * Display label for the language picker. Defaults to the language name for
+     * `locale` (via `Intl.DisplayNames`), so this is only needed to override it.
+     */
+    label?: string;
+    /** The value for this locale. */
+    value: T;
+}
+
 export declare const MAX_EXPANDED_ACTIONS = 2;
 
 export declare type MentionedUser = {
@@ -9010,7 +9077,7 @@ declare const privateProps_5: readonly [];
 
 declare const privateProps_6: readonly ["compact"];
 
-declare const privateProps_7: readonly ["delay"];
+declare const privateProps_7: readonly ["delay", "onOpen"];
 
 declare type ProductUpdate = {
     title: string;
@@ -9222,6 +9289,8 @@ declare interface ReactionProps {
     initialCount: number;
     hasReacted?: boolean;
     users?: User_2[];
+    /** Resolve the complete user list on first hover or keyboard focus. */
+    loadUsers?: () => Promise<User_2[]>;
     onInteraction?: (emoji: string) => void;
     size?: "sm" | "md" | "lg";
 }
@@ -10659,6 +10728,7 @@ declare type TooltipInternalProps = {
     shortcut?: ComponentProps<typeof Shortcut>["keys"];
     delay?: number;
     instant?: boolean;
+    onOpen?: () => void;
 } & ({
     label: string;
     description?: string;
@@ -11166,6 +11236,56 @@ declare const VerticalOverflowList: {
     displayName: string;
 };
 
+/**
+ * Structured content for the video player.
+ *
+ * Every field accepts either a single value or a localized list
+ * (`[{ locale, label?, value }]`) — pass several languages and a language
+ * selector appears in the controls. A single shared selection drives captions,
+ * descriptions and the described source together (each falls back to its first
+ * entry for languages it doesn't provide). See `F0VideoPlayerProps.defaultLanguage`.
+ *
+ * `captions` are timed text shown over the video during playback (WCAG 2.1
+ * SC 1.2.2, Captions). Pass either a WebVTT resource URL or a raw WebVTT string
+ * (the player turns raw VTT into a blob track, so no CORS setup is needed); a
+ * remote URL requires the video host to allow cross-origin reads. When omitted,
+ * the player uses any caption/subtitle track embedded in the video file. A
+ * captions toggle in the controls shows/hides them (a filled glyph when on, a
+ * line glyph when off).
+ *
+ * Audio description (WCAG 2.1 SC 1.2.5) conveys on-screen visual information as
+ * audio, complementary to captions — both are independent and can be on at
+ * once. Provide it in one of two ways, toggled with the audio-description
+ * control (a filled "AD" badge when on, a line badge when off):
+ * - `describedSrc`: a pre-produced media rendition with description mixed into
+ *   the audio. Toggling swaps the source, preserving position and play state.
+ *   Highest quality; assumed the same length as `src`.
+ * - `descriptions`: a WebVTT `kind="descriptions"` script (URL or raw VTT),
+ *   delivered at runtime — the video pauses on each cue so the description can
+ *   be spoken (extended audio description), then resumes. Used only when
+ *   `describedSrc` is absent.
+ */
+declare interface VideoPlayerContent {
+    /**
+     * WebVTT URL, or raw WebVTT content, for captions shown during playback.
+     * Localizable — pass a per-locale list to offer captions in several languages.
+     */
+    captions?: Localized<string>;
+    /**
+     * A pre-produced described media source (description mixed into the audio),
+     * swapped in when audio description is enabled. Takes precedence over
+     * `descriptions`. Should match `src`'s duration so the position carries
+     * across the swap. Localizable.
+     */
+    describedSrc?: Localized<string>;
+    /**
+     * WebVTT URL, or raw WebVTT content, of a `kind="descriptions"` script.
+     * Delivered at runtime with extended (pausing) audio description when no
+     * `describedSrc` is provided. Localizable.
+     */
+    descriptions?: Localized<string>;
+}
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */