@naviedu/room-platform-react 0.0.45 → 0.0.47

package/README.md

@@ -79,16 +79,17 @@ layout that allows the room to occupy the viewport.
 
 ## `RoomPlatformRoom` props
 
-| Prop                     | Required | Description                                                                          |
-| ------------------------ | -------- | ------------------------------------------------------------------------------------ |
-| `apiBaseUrl`             | Yes      | Room Platform API prefix. Do not append `/rooms`.                                    |
-| `launchToken`            | Yes      | Initial server-issued launch ticket.                                                 |
-| `onLaunchTicketRequired` | Yes      | Returns `{ launchToken }` when the current ticket or access session must be renewed. |
-| `extensions`             | No       | Host-provided top-bar, workspace, sidebar, monitor, and participant extensions.      |
-| `onError`                | No       | Receives connection, media, and action errors.                                       |
-| `onLifecycleEvent`       | No       | Receives exchange, renewal, and reconnect lifecycle events.                          |
-| `onExit`                 | No       | Called when the user chooses to leave the room.                                      |
-| `children`               | No       | Replaces the default workspace while keeping the provider and room runtime.          |
+| Prop                     | Required | Description                                                                                                                                |
+| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `apiBaseUrl`             | Yes      | Room Platform API prefix. Do not append `/rooms`.                                                                                          |
+| `launchToken`            | Yes      | Initial server-issued launch ticket.                                                                                                       |
+| `onLaunchTicketRequired` | Yes      | Returns `{ launchToken }` when the current ticket or access session must be renewed.                                                       |
+| `extensions`             | No       | Host-provided top-bar, workspace, sidebar, monitor, and participant extensions.                                                            |
+| `primaryCameraPlacement` | No       | `overlay` (default) keeps the practice camera over the workspace; `sidebar` renders the local primary camera in the Room Platform sidebar. |
+| `onError`                | No       | Receives connection, media, and action errors.                                                                                             |
+| `onLifecycleEvent`       | No       | Receives exchange, renewal, and reconnect lifecycle events.                                                                                |
+| `onExit`                 | No       | Called when the user chooses to leave the room.                                                                                            |
+| `children`               | No       | Replaces the default workspace while keeping the provider and room runtime.                                                                |
 
 The default teaching stage selects the available participant camera carrying
 the canonical `room:moderate` capability. Screen share remains primary and the
@@ -99,6 +100,8 @@ its existing desktop breakpoint remains unchanged.
 
 The public room keeps one canonical local camera track. It may be preview-only
 before publication, and preview visibility never grants `media:publish_video`.
+Camera placement does not change camera permissions, publication, or LiveKit
+track lifecycle.
 
 ### Error and lifecycle callbacks
 

package/index.d.ts

@@ -232,7 +232,7 @@ declare type RoomPlatformChatIntegration = {
 
 declare interface RoomPlatformChatRoom {
     roomId: string;
-    roomType: 'group';
+    roomType: 'group' | 'direct';
     label?: string;
     permissions: string[];
 }
@@ -539,12 +539,13 @@ export declare type RoomPlatformPrivateRoomRuntimeState = {
     setIsAcceptingPrivateRoom: (value: boolean) => void;
 };
 
-export declare function RoomPlatformPrivateRoomStage({ callerExternalActorId, studentExternalActorId, activeScreenShareExternalActorId, controlBar, whiteboard, }: RoomPlatformPrivateRoomStageProps): JSX.Element;
+export declare function RoomPlatformPrivateRoomStage({ callerExternalActorId, studentExternalActorId, activeScreenShareExternalActorId, chat, controlBar, whiteboard, }: RoomPlatformPrivateRoomStageProps): JSX.Element;
 
 export declare type RoomPlatformPrivateRoomStageProps = {
     callerExternalActorId: string;
     studentExternalActorId: string;
     activeScreenShareExternalActorId?: string;
+    chat?: ReactNode;
     controlBar?: ReactNode;
     whiteboard?: ReactNode;
 };
@@ -580,6 +581,7 @@ export declare type RoomPlatformRoomProps = {
     extensions?: RoomPlatformExtensions;
     launchToken: string;
     modeConfig?: RoomPlatformModeConfig;
+    primaryCameraPlacement?: 'overlay' | 'sidebar';
     shadowDom?: boolean;
     sizing?: RoomPlatformSizing;
     onError?: (event: RoomPlatformErrorEvent) => void;
@@ -677,6 +679,7 @@ declare interface RoomPrivateRoomConnection {
     tokenExpiresAt: string;
     publishEnabled: boolean;
     permissions: RoomPrivateRoomPermission[];
+    chat?: RoomPlatformChatIntegration;
 }
 
 declare type RoomPrivateRoomPermission = 'media:publish' | 'media:subscribe' | 'media:share_screen';