@poolse/react-native 2.12.1 → 2.13.0

package/dist/index.d.ts

@@ -1,51 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { CallParticipant, Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter, VoiceStatus, LiveKitModule, CallMedia } from '@poolse/sdk';
 import * as react from 'react';
-import { ReactNode, ReactElement } from 'react';
+import { ReactNode, ReactElement, ComponentType } from 'react';
+import { Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter, VoiceStatus, LiveKitModule, CallParticipant, CallMedia } from '@poolse/sdk';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { UseCalls } from '@poolse/react';
-
-/**
- * The slice of `@livekit/react-native` this needs.
- *
- * Passed in by the app rather than imported, for the same reason
- * `react-native-webrtc` is: tsup rewrites `require()` into
- * `__require()`, which Metro cannot follow, so anything this package
- * imports for itself never reaches a React Native bundle.
- *
- *     import * as livekitRN from '@livekit/react-native';
- */
-interface LiveKitReactNativeModule {
-    /**
-     * The module's `VideoTrack` component.
-     *
-     * Typed as `unknown` on purpose. Its real props are far more specific
-     * than what this renders with, and React component props are
-     * contravariant — declaring the narrow shape here means the real
-     * component is not assignable to it and no app can pass the module in.
-     * It is narrowed to {@link CheckedVideoTrack} at the point of use.
-     */
-    VideoTrack: unknown;
-}
-interface CallVideoGridProps {
-    participants: CallParticipant[];
-    /** `@livekit/react-native`, imported by your app. */
-    livekitReactNative?: LiveKitReactNativeModule | null | undefined;
-    /** Resolves a user id to a display label. */
-    labelFor?: ((userId: string) => string) | undefined;
-}
-/**
- * The video half of a call: one tile per participant.
- *
- * Someone with their camera off still gets a tile, showing their name
- * and whether they're muted. Dropping them would make a five-person
- * call with four cameras off look like a one-person call, and hide the
- * fact that they are there and can hear you.
- *
- * Tiles are laid out in a simple grid that stays square-ish as the call
- * grows. There is no active-speaker promotion yet — with the small
- * calls an SFU mesh replacement is sized for, everyone fits on screen.
- */
-declare function CallVideoGrid({ participants, livekitReactNative, labelFor }: CallVideoGridProps): react_jsx_runtime.JSX.Element | null;
+import { ViewStyle } from 'react-native';
 
 interface InboxUser {
     /** The user's external_id (the same id you mint JWTs with). */
@@ -685,10 +643,18 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M6 9.2a6 6 0 0 1 12 0c0 4.8 1.4 6.3 1.9 6.8H4.1C4.6 15.5 6 14 6 9.2Z\"/><path d=\"M9.6 19.8a2.5 2.5 0 0 0 4.8 0\"/>";
     };
+    readonly bluetooth: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M7.5 7.5 16.5 16.5 12 21V3l4.5 4.5L7.5 16.5\"/>";
+    };
     readonly camera: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M3 8.5a2 2 0 0 1 2-2h2.4l1.4-2h6.4l1.4 2H19a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-9Z\"/><circle cx=\"12\" cy=\"13\" r=\"3.5\"/>";
     };
+    readonly 'camera-flip': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M3 8.5a2 2 0 0 1 2-2h2.4l1.4-2h6.4l1.4 2H19a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-9Z\"/><path d=\"M14.6 13a2.6 2.6 0 0 1-4.5 1.8\"/><path d=\"M9.4 13a2.6 2.6 0 0 1 4.5-1.8\"/><path d=\"M13.9 9.6v1.7h-1.7\"/><path d=\"M10.1 16.4v-1.7h1.7\"/>";
+    };
     readonly 'check-double': {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M2.5 12.8 6.9 17 15.4 7.6\"/><path d=\"M11.4 16.4 12.3 17.2 21 7.6\"/>";
@@ -705,6 +671,10 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M9 5 16 12 9 19\"/>";
     };
+    readonly 'chevron-up': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M6 14.5 12 8.5 18 14.5\"/>";
+    };
     readonly close: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M6 6 18 18M18 6 6 18\"/>";
@@ -733,6 +703,10 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<circle cx=\"12\" cy=\"12\" r=\"8.6\"/><circle cx=\"9\" cy=\"10\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"15\" cy=\"10\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/><path d=\"M8.4 14.2a4.6 4.6 0 0 0 7.2 0\"/>";
     };
+    readonly headphones: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4 14v-2a8 8 0 0 1 16 0v2\"/><path d=\"M4 14h2.6a1.4 1.4 0 0 1 1.4 1.4v3.2A1.4 1.4 0 0 1 6.6 20H5.4A1.4 1.4 0 0 1 4 18.6Z\"/><path d=\"M20 14h-2.6a1.4 1.4 0 0 0-1.4 1.4v3.2A1.4 1.4 0 0 0 17.4 20h1.2A1.4 1.4 0 0 0 20 18.6Z\"/>";
+    };
     readonly heart: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M12 20.3 4.4 12.9a4.6 4.6 0 1 1 6.5-6.5l1.1 1.1 1.1-1.1a4.6 4.6 0 1 1 6.5 6.5L12 20.3Z\"/>";
@@ -769,6 +743,10 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<rect x=\"9\" y=\"2.6\" width=\"6\" height=\"11.2\" rx=\"3\"/><path d=\"M5.6 11.2a6.4 6.4 0 0 0 12.8 0\"/><path d=\"M12 17.6v3.4\"/><path d=\"M8.6 21h6.8\"/>";
     };
+    readonly 'mic-off': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"9\" y=\"2.6\" width=\"6\" height=\"11.2\" rx=\"3\"/><path d=\"M5.6 11.2a6.4 6.4 0 0 0 12.8 0\"/><path d=\"M12 17.6v3.4\"/><path d=\"M8.6 21h6.8\"/><path d=\"M3.6 3.2 20.4 20.8\"/>";
+    };
     readonly 'more-h': {
         readonly vb: "0 0 24 24";
         readonly d: "<circle cx=\"5.4\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"18.6\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/>";
@@ -777,6 +755,14 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<circle cx=\"12\" cy=\"5.4\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"18.6\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/>";
     };
+    readonly phone: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M6.6 3.5h3l1.5 3.7-1.9 1.4a12.5 12.5 0 0 0 6.2 6.2l1.4-1.9 3.7 1.5v3a2 2 0 0 1-2.2 2A16.8 16.8 0 0 1 4.6 5.7a2 2 0 0 1 2-2.2Z\"/>";
+    };
+    readonly 'phone-off': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<g transform=\"rotate(135 12 12)\"><path d=\"M6.6 3.5h3l1.5 3.7-1.9 1.4a12.5 12.5 0 0 0 6.2 6.2l1.4-1.9 3.7 1.5v3a2 2 0 0 1-2.2 2A16.8 16.8 0 0 1 4.6 5.7a2 2 0 0 1 2-2.2Z\"/></g>";
+    };
     readonly pin: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M9 3.4h6v1.8l-1 5.6 3 3.2H7l3-3.2-1-5.6V3.4Z\"/><path d=\"M12 17v3.6\"/>";
@@ -817,6 +803,14 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M4 7h9M17 7h3\"/><circle cx=\"15\" cy=\"7\" r=\"2.1\"/><path d=\"M4 17h3M11 17h9\"/><circle cx=\"9\" cy=\"17\" r=\"2.1\"/>";
     };
+    readonly speaker: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4 9.5h3.2L12 5.4v13.2L7.2 14.5H4a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1Z\"/><path d=\"M15.6 9.2a4 4 0 0 1 0 5.6\"/><path d=\"M18.2 6.6a7.7 7.7 0 0 1 0 10.8\"/>";
+    };
+    readonly 'speaker-off': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4 9.5h3.2L12 5.4v13.2L7.2 14.5H4a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1Z\"/><path d=\"M16.4 9.6 21.4 14.4\"/><path d=\"M21.4 9.6 16.4 14.4\"/>";
+    };
     readonly 'thumbs-up': {
         readonly vb: "0 0 24 24";
         readonly d: "<path d=\"M7 10.4V20H4.2V10.4Z\"/><path d=\"M7 10.4 11 3.2a2 2 0 0 1 1.9 2.2L12.4 9H18a2 2 0 0 1 2 2.4l-1.1 6A2 2 0 0 1 16.9 20H7\"/>";
@@ -841,6 +835,14 @@ declare const ICONS: {
         readonly vb: "0 0 24 24";
         readonly d: "<circle cx=\"9\" cy=\"8\" r=\"3.6\"/><path d=\"M2.6 20a6.4 6.4 0 0 1 12.8 0\"/><path d=\"M15.8 4.7a3.6 3.6 0 0 1 0 6.6\"/><path d=\"M17.6 20a6.4 6.4 0 0 0-3.1-5.5\"/>";
     };
+    readonly video: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"2.6\" y=\"6\" width=\"13\" height=\"12\" rx=\"2.4\"/><path d=\"M15.6 11.2 21.4 8v8l-5.8-3.2Z\"/>";
+    };
+    readonly 'video-off': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"2.6\" y=\"6\" width=\"13\" height=\"12\" rx=\"2.4\"/><path d=\"M15.6 11.2 21.4 8v8l-5.8-3.2Z\"/><path d=\"M3.6 3.2 20.4 20.8\"/>";
+    };
     readonly webhook: {
         readonly vb: "0 0 24 24";
         readonly d: "<circle cx=\"6\" cy=\"6\" r=\"2.6\"/><circle cx=\"18\" cy=\"9\" r=\"2.6\"/><circle cx=\"9.5\" cy=\"18\" r=\"2.6\"/><path d=\"M7.9 7.9 12 12l3.7-1.5\"/><path d=\"M11.6 12.7 9.8 16\"/>";
@@ -1115,6 +1117,107 @@ interface VoiceRoomBarProps {
  */
 declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, onStatusChange, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The slice of `@livekit/react-native` this package uses.
+ *
+ * Passed in by the app rather than imported, for the same reason
+ * `react-native-webrtc` is: tsup rewrites `require()` into
+ * `__require()`, which Metro cannot follow, so anything this package
+ * imports for itself never reaches a React Native bundle.
+ *
+ *     import * as livekitRN from '@livekit/react-native';
+ *     <CallScreen livekitReactNative={livekitRN} … />
+ *
+ * Everything past `VideoTrack` is optional so an older version of the
+ * module still type-checks — the features degrade rather than failing
+ * to compile.
+ */
+
+/**
+ * The slice of `VideoTrack` actually rendered.
+ *
+ * `LiveKitReactNativeModule.VideoTrack` is `unknown` because React props
+ * are contravariant — declaring the narrow shape there means the real
+ * component is not assignable to it and no app can pass the module in.
+ * Narrowing happens at the point of use, through this.
+ */
+type CheckedVideoTrack = ComponentType<{
+    trackRef: unknown;
+    style?: ViewStyle;
+    objectFit?: 'cover' | 'contain';
+    mirror?: boolean;
+    zOrder?: number;
+}>;
+/** What an audio route is, once its platform id has been read. */
+type AudioRouteKind = 'speaker' | 'earpiece' | 'headset' | 'bluetooth' | 'auto';
+interface AudioRoute {
+    /** Platform id, passed back to `selectAudioOutput`. */
+    id: string;
+    kind: AudioRouteKind;
+    /** Human label for a picker row. */
+    label: string;
+}
+/**
+ * LiveKit's audio session.
+ *
+ * The two platforms expose genuinely different things and the shape
+ * reflects that rather than papering over it:
+ *
+ *   * **Android** enumerates real devices — `speaker`, `earpiece`,
+ *     `headset`, `bluetooth` — and `selectAudioOutput` picks one.
+ *   * **iOS** offers only `default` and `force_speaker`, because AVAudio
+ *     does not let an app pick a route directly. Anything else (AirPods,
+ *     a wired headset, AirPlay) goes through the system's own picker,
+ *     which is what `showAudioRoutePicker` opens.
+ */
+interface LiveKitAudioSession {
+    configureAudio(config: {
+        android?: {
+            preferredOutputList?: ('speaker' | 'earpiece' | 'headset' | 'bluetooth')[];
+            audioTypeOptions?: unknown;
+        };
+        ios?: {
+            defaultOutput?: 'speaker' | 'earpiece';
+        };
+    }): Promise<void>;
+    startAudioSession(): Promise<void>;
+    stopAudioSession(): Promise<void>;
+    getAudioOutputs(): Promise<string[]>;
+    selectAudioOutput(deviceId: string): Promise<void>;
+    /** iOS 11+. Opens the system route picker (AirPods, AirPlay, …). */
+    showAudioRoutePicker?(): Promise<void>;
+}
+/** Fires when a headset or Bluetooth device appears or disappears. */
+interface AudioDeviceModuleEvents {
+    addDevicesUpdatedListener(listener: () => void): void;
+    removeDevicesUpdatedListener(listener: () => void): void;
+}
+interface LiveKitReactNativeModule {
+    /**
+     * The module's `VideoTrack` component.
+     *
+     * Typed as `unknown` on purpose. Its real props are far more specific
+     * than what this renders with, and React component props are
+     * contravariant — declaring the narrow shape here means the real
+     * component is not assignable to it and no app can pass the module in.
+     * It is narrowed at the point of use.
+     */
+    VideoTrack: unknown;
+    AudioSession?: LiveKitAudioSession | undefined;
+    /**
+     * Installs LiveKit's iOS audio policy and returns a disposer.
+     *
+     * Must not be re-run mid-call: it abandons the session activation the
+     * previous handlers were holding, which kills audio outright. The
+     * speaker preference is therefore captured once, when the call
+     * starts, and later changes go through `selectAudioOutput` instead.
+     */
+    setupIOSAudioManagement?: ((preferSpeakerOutput?: boolean) => () => void) | undefined;
+    audioDeviceModuleEvents?: AudioDeviceModuleEvents | undefined;
+}
+/** Turn a platform output id into something renderable. */
+declare function describeRoute(id: string): AudioRoute;
+
 interface CallScreenProps {
     /** The signed-in user's id — the topic calls are delivered on. */
     userId: string;
@@ -1142,15 +1245,16 @@ interface CallScreenProps {
      */
     livekit?: LiveKitModule | null;
     /**
-     * `@livekit/react-native`, imported by your app. Required to *render*
-     * video; without it a video call still connects and carries audio, and
-     * every tile shows a placeholder.
+     * `@livekit/react-native`, imported by your app.
+     *
+     * Required to *render* video, and also carries `AudioSession`, which
+     * is what routes a call to the speaker, the earpiece or a headset.
+     * Without it a call still connects and carries audio, every tile
+     * shows an avatar, and routing falls to whatever the OS picks.
      */
     livekitReactNative?: LiveKitReactNativeModule | null;
     /**
-     * Called whenever the call's media connection state changes. Drive
-     * speakerphone and the proximity sensor from here — see
-     * {@link VoiceRoomBarProps.onStatusChange}.
+     * Called whenever the call's media connection state changes.
      */
     onStatusChange?: (status: VoiceStatus) => void;
     /**
@@ -1165,17 +1269,11 @@ interface CallScreenProps {
      * only starts working after some unrelated engine change (turning the
      * camera on) makes LiveKit reapply its configuration.
      *
-     * So drive InCallManager from this, and only for `'mesh'`. The mesh
-     * has no session management of its own and still needs it.
+     * So drive InCallManager from this, and only for `'mesh'`. On the SFU
+     * path this component already owns the session, through LiveKit.
      */
     onTransportChange?: (transport: 'sfu' | 'mesh' | null) => void;
-    /**
-     * Called when the call's video state changes.
-     *
-     * A video call belongs on the speaker with the proximity sensor OFF —
-     * otherwise the screen blanks the moment the phone comes near your
-     * face, which is exactly when you are looking at it.
-     */
+    /** Called when the call's video state changes. */
     onVideoChange?: (video: boolean) => void;
     /**
      * Hide this screen while a call is merely ringing in.
@@ -1195,7 +1293,11 @@ interface CallScreenProps {
  * Mount it once, high in the tree, so a call can arrive on any screen:
  *
  *     <PoolseProvider config={config}>
- *       <CallScreen userId={me.id} livekit={livekit} livekitReactNative={livekitRN} />
+ *       <CallScreen
+ *         userId={me.id}
+ *         livekit={livekit}
+ *         livekitReactNative={livekitRN}
+ *       />
  *       <YourApp />
  *     </PoolseProvider>
  *
@@ -1212,6 +1314,310 @@ interface CallScreenProps {
  */
 declare function CallScreen({ userId, labelFor, calls: callsProp, webrtc, livekit, livekitReactNative, onStatusChange, onTransportChange, onVideoChange, nativeIncomingUi, }: CallScreenProps): react_jsx_runtime.JSX.Element;
 
+interface CallVideoGridProps {
+    participants: CallParticipant[];
+    /** `@livekit/react-native`, imported by your app. */
+    livekitReactNative?: LiveKitReactNativeModule | null | undefined;
+    /** Resolves a user id to a display label. */
+    labelFor?: ((userId: string) => string) | undefined;
+    /**
+     * Tapping the local preview. Wired to the camera flip by
+     * `CallScreen`, which is where every other call app puts it.
+     */
+    onLocalPress?: (() => void) | undefined;
+    /**
+     * How much chrome sits over the top and bottom of the stage, so the
+     * floating preview does not park itself under the control bar.
+     */
+    chromeInsets?: {
+        top: number;
+        bottom: number;
+    } | undefined;
+}
+/**
+ * The stage: everyone on the call, laid out for how many there are.
+ *
+ * Three layouts, because one grid cannot serve all of them:
+ *
+ *   * **Alone** — you, filling the screen, while the far side connects.
+ *   * **One other person** — them full-bleed, you in a draggable
+ *     corner tile. A 1:1 call split into two half-height boxes wastes
+ *     most of the screen on letterboxing, which is why no calling app
+ *     does it.
+ *   * **Three or more** — a real grid, two columns up to six people and
+ *     three beyond that, scrolling once the tiles would be too small to
+ *     make out a face.
+ *
+ * Audio calls land here too. Everyone simply has their camera off, so
+ * every tile draws an avatar, and the layout logic does not need to
+ * know whether video was ever on the table.
+ */
+declare function CallVideoGrid({ participants, livekitReactNative, labelFor, onLocalPress, chromeInsets, }: CallVideoGridProps): react_jsx_runtime.JSX.Element;
+
+interface CallControlButtonProps {
+    icon: IconName;
+    /** Shown under the button. Omit for the hang-up / answer buttons. */
+    label?: string | undefined;
+    /**
+     * The control is doing something — muted, speaker forced on, camera
+     * off. Inverts the button so engaged controls are readable at a
+     * glance.
+     */
+    active?: boolean;
+    /** Paints the button a solid colour: the hang-up and answer actions. */
+    tone?: 'neutral' | 'danger' | 'accept';
+    large?: boolean;
+    disabled?: boolean;
+    onPress: () => void;
+    /**
+     * Spoken description. Defaults to `label`, but a toggle needs to say
+     * what pressing it will DO, which is rarely what the label says —
+     * "Mute" under a button that unmutes is exactly backwards for anyone
+     * using a screen reader.
+     */
+    accessibilityLabel?: string | undefined;
+}
+/**
+ * One round call control.
+ *
+ * Fixed diameter and a caption underneath, so a row of them lines up on
+ * a grid regardless of label length — the thing that makes a control
+ * bar look built rather than assembled.
+ */
+declare function CallControlButton({ icon, label, active, tone, large, disabled, onPress, accessibilityLabel, }: CallControlButtonProps): react_jsx_runtime.JSX.Element;
+
+interface CallParticipantTileProps {
+    participant: CallParticipant;
+    /** Narrowed `@livekit/react-native` VideoTrack, when the app supplied it. */
+    VideoTrack?: CheckedVideoTrack | undefined;
+    label: (userId: string) => string;
+    style?: ViewStyle | ViewStyle[];
+    /** Avatar diameter when the camera is off. */
+    avatarSize?: number;
+    /** Full-bleed tiles drop their rounding and their name chip shrinks. */
+    bleed?: boolean;
+    /** Hide the name chip — the spotlight draws identity in the header. */
+    hideName?: boolean;
+}
+/**
+ * One person on the call: their video, or their avatar when the camera
+ * is off.
+ *
+ * A camera-off participant still gets a tile. Dropping them would make
+ * a five-person call with four cameras off look like a one-person call,
+ * and hide the fact that they are there and can hear you.
+ */
+declare function CallParticipantTile({ participant, VideoTrack, label, style, avatarSize, bleed, hideName, }: CallParticipantTileProps): react_jsx_runtime.JSX.Element;
+
+interface CallAvatarProps {
+    /** Display name; the first letters become the initials. */
+    name: string;
+    /** Stable colour seed — the poolse user id. */
+    seed: string;
+    size: number;
+    /** Draw the active-speaker ring. */
+    speaking?: boolean;
+}
+/**
+ * The stand-in for a face when a camera is off.
+ *
+ * Separate from `<Avatar>` rather than a size variant of it: this one
+ * scales to a third of the screen, carries the speaking ring, and lives
+ * on a dark surface, none of which the list avatar wants.
+ *
+ * The ring sits OUTSIDE the circle, drawn as a border on a larger box.
+ * Growing the avatar itself to show speaking would make everything jump
+ * every time somebody starts talking.
+ */
+declare function CallAvatar({ name, seed, size, speaking }: CallAvatarProps): react_jsx_runtime.JSX.Element;
+
+interface LocalVideoPipProps {
+    participant: CallParticipant;
+    VideoTrack?: CheckedVideoTrack | undefined;
+    label: (userId: string) => string;
+    /** Area the tile may be dragged within, in pixels. */
+    bounds: {
+        width: number;
+        height: number;
+    };
+    /** Inset from the edges — keeps the tile clear of the call chrome. */
+    insets?: {
+        top: number;
+        bottom: number;
+    };
+    /** Tap handler. Wired to the camera flip, matching every other call app. */
+    onPress?: (() => void) | undefined;
+}
+/**
+ * The local camera preview, floating over the remote video.
+ *
+ * Draggable, and it snaps to the nearest corner on release rather than
+ * staying wherever the finger stopped. Free positioning sounds more
+ * flexible but reads as broken: a tile left at a slight angle to the
+ * edge looks dropped rather than placed, and it is the corners people
+ * actually want — they move it to uncover a face.
+ *
+ * Built on `Animated` + `PanResponder` from React Native itself. A
+ * gesture library would be smoother, but it would be a new native
+ * dependency for every app that installs this SDK, and a call preview
+ * is not worth that.
+ */
+declare function LocalVideoPip({ participant, VideoTrack, label, bounds, insets, onPress, }: LocalVideoPipProps): react_jsx_runtime.JSX.Element;
+
+interface AudioRouteSheetProps {
+    visible: boolean;
+    routes: AudioRoute[];
+    /** Platform id of the chosen route, or null while routing is automatic. */
+    selectedRouteId: string | null;
+    onSelect: (id: string) => void;
+    onClose: () => void;
+}
+/**
+ * Pick where call audio comes out.
+ *
+ * Only worth showing when there is a real choice — on iOS there are
+ * exactly two entries and the system's own picker covers everything
+ * else, so `CallScreen` opens that instead. This is the Android
+ * surface, where LiveKit enumerates the actual devices.
+ */
+declare function AudioRouteSheet({ visible, routes, selectedRouteId, onSelect, onClose, }: AudioRouteSheetProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * The call surface's own palette.
+ *
+ * Deliberately NOT the app theme. Every serious calling app — phone,
+ * FaceTime, WhatsApp, Meet — renders calls dark regardless of the rest
+ * of the UI, for three reasons that all apply here:
+ *
+ *   * video is the content, and a light chrome around it washes the
+ *     picture out,
+ *   * a call screen is the one surface that routinely opens at 3am,
+ *   * it takes over the whole screen, so it reads as a mode change
+ *     rather than as a screen that has lost the app's styling.
+ *
+ * The brand still shows up — in the accept button and the speaking
+ * ring — it just doesn't set the background.
+ */
+declare const callColors: {
+    /** Behind everything. Near-black, warmed very slightly to match the brand. */
+    readonly bg: "#101012";
+    /** Behind a participant tile with no video. */
+    readonly tile: "#1c1c20";
+    /** Scrim under the top/bottom chrome so text stays legible over video. */
+    readonly scrim: "rgba(0,0,0,0.45)";
+    readonly text: "#ffffff";
+    readonly textDim: "rgba(255,255,255,0.72)";
+    readonly textFaint: "rgba(255,255,255,0.5)";
+    /** A control that is off / inactive — translucent over whatever is behind. */
+    readonly control: "rgba(255,255,255,0.16)";
+    /**
+     * A control that is ENGAGED (muted, speaker on, camera off).
+     *
+     * Inverted rather than tinted: at a glance the user needs to see
+     * *which* controls are doing something, and a solid white circle is
+     * unmistakable against five translucent ones in a dim room.
+     */
+    readonly controlActive: "#ffffff";
+    readonly controlActiveIcon: "#101012";
+    readonly danger: "#ef4444";
+    readonly accept: "#22c55e";
+    readonly onAction: "#ffffff";
+};
+
+/**
+ * How long the call has been connected, as `m:ss` (or `h:mm:ss`).
+ *
+ * Anchored to a timestamp rather than counting ticks: a phone that
+ * sleeps or throttles timers would otherwise drift, and a call timer
+ * that reads 4:12 after eleven minutes is worse than none. Returns null
+ * until the call is actually up, so a ringing call shows its status
+ * line instead of `0:00`.
+ */
+declare function useCallDuration(connected: boolean): string | null;
+
+interface UseCallAudioOptions {
+    /**
+     * True as soon as a call exists — ringing counts.
+     *
+     * Deliberately not "connected": the audio session has to be running
+     * before LiveKit's audio engine starts, not after. Start it late and
+     * the call connects, the roster is right, video flows, and no audio
+     * is published in either direction.
+     */
+    active: boolean;
+    /**
+     * Whether the call is carrying video.
+     *
+     * Decides where audio goes by default — nobody holds a phone to their
+     * ear while looking at the screen — and nothing else. Read once, when
+     * the call starts; see {@link LiveKitReactNativeModule.setupIOSAudioManagement}
+     * for why it cannot be re-applied mid-call.
+     */
+    video: boolean;
+    /** `@livekit/react-native`, imported by your app. */
+    livekitReactNative?: LiveKitReactNativeModule | null | undefined;
+}
+interface CallAudio {
+    /** Audio is coming out of the loudspeaker. */
+    speakerOn: boolean;
+    toggleSpeaker: () => void;
+    setSpeaker: (on: boolean) => void;
+    /** Every route that can be picked right now. */
+    routes: AudioRoute[];
+    /**
+     * The selected route's platform id, or `null` while routing is
+     * automatic — which is the normal state until the user picks
+     * something. Automatic means the OS follows the preference order the
+     * call was configured with, so plugging in a headset just works.
+     */
+    selectedRouteId: string | null;
+    selectRoute: (id: string) => void;
+    /**
+     * A headset, AirPods or car kit is connected.
+     *
+     * Worth surfacing because it changes what the speaker button means:
+     * with a headset attached, "off" routes to the headset rather than to
+     * the earpiece.
+     *
+     * Android only, and honestly so — iOS reports just `default` and
+     * `force_speaker` from `getAudioOutputs`, with no way to ask what
+     * `default` currently resolves to. On iOS this stays `false` and the
+     * system route picker is the way to see and change the real device.
+     */
+    externalDevice: boolean;
+    /**
+     * The system route picker can be opened. iOS only — Android
+     * enumerates its devices in {@link routes} instead.
+     */
+    canPickSystemRoute: boolean;
+    openSystemRoutePicker: () => void;
+}
+/**
+ * Owns the audio session for an SFU-backed call, and the routing on top
+ * of it.
+ *
+ * ## Why this is not `react-native-incall-manager`
+ *
+ * `registerGlobals()` from `@livekit/react-native` drives AVAudioSession
+ * natively off its own audio engine's state. Anything else driving the
+ * session at the same time fights it, and the symptom is brutal: the
+ * microphone captures nothing, and audio only starts working after some
+ * unrelated engine change — turning the camera on, say — makes LiveKit
+ * reapply its configuration. So InCallManager is reserved for the
+ * peer-to-peer mesh, which has no session management of its own.
+ *
+ * ## What "default" means on each platform
+ *
+ * Android is handed a `preferredOutputList` and picks the best
+ * available device itself, so a connected headset wins without the app
+ * detecting anything. iOS is given `defaultOutput`, which LiveKit
+ * documents as the output to use *when a wired headset or Bluetooth
+ * output is unavailable* — same effect, same reason: an app that forced
+ * the speaker on a video call would yank audio out of the user's
+ * AirPods every time.
+ */
+declare function useCallAudio({ active, video, livekitReactNative, }: UseCallAudioOptions): CallAudio;
+
 /**
  * Bridges iOS PushKit + CallKit to poolse calls, and owns the incoming
  * call UI end to end.
@@ -1350,4 +1756,4 @@ declare function isStalePush(sentAt: number | undefined, now: number, staleAfter
  */
 declare function useVoipCalls({ voipPush, callKeep, calls, onAnswer, onDecline, appName, apnsEnvironment, staleAfterMs, }: UseVoipCallsOptions): void;
 
-export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, type CallKeepModule, CallScreen, type CallScreenProps, CallVideoGrid, type CallVideoGridProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, type LiveKitReactNativeModule, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, type NativeWebRtcModule, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, type UseVoipCallsOptions, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, type VoipIncomingCall, type VoipPushModule, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, isStalePush, useAppStateLifecycle, useDisplayName, usePoolseTheme, useVoipCalls };
+export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, type AudioRoute, type AudioRouteKind, AudioRouteSheet, type AudioRouteSheetProps, Avatar, type AvatarProps, type CallAudio, CallAvatar, type CallAvatarProps, CallControlButton, type CallControlButtonProps, type CallKeepModule, CallParticipantTile, type CallParticipantTileProps, CallScreen, type CallScreenProps, CallVideoGrid, type CallVideoGridProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, type LiveKitAudioSession, type LiveKitReactNativeModule, LocalVideoPip, type LocalVideoPipProps, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, type NativeWebRtcModule, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, type UseCallAudioOptions, type UseVoipCallsOptions, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, type VoipIncomingCall, type VoipPushModule, callColors, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, describeRoute, isNativeWebRtcAvailable, isStalePush, useAppStateLifecycle, useCallAudio, useCallDuration, useDisplayName, usePoolseTheme, useVoipCalls };