@naviedu/room-platform-react 0.0.9 → 0.0.12

package/README.md

@@ -27,14 +27,12 @@ runtime dependencies are installed automatically with the package.
 
 ## Basic usage
 
-Import the package stylesheet once, then render `RoomPlatformRoom` with the
-launch ticket returned by your backend:
+Render `RoomPlatformRoom` with the launch ticket returned by your backend:
 
 ```tsx
 'use client'
 
 import { type RoomLaunchTicketRenewalReason, RoomPlatformRoom } from '@naviedu/room-platform-react'
-import '@naviedu/room-platform-react/styles.css'
 
 type RoomTicketResponse = { launchToken: string }
 
@@ -61,6 +59,10 @@ export function Room({ launchToken }: { launchToken: string }) {
 }
 ```
 
+`RoomPlatformRoom` renders its default room UI in an isolated Shadow Root and installs the package stylesheet itself. Do not import `@naviedu/room-platform-react/styles.css` for the default component.
+
+`RoomPlatformProvider` is advanced composition only; a consumer using it instead of `RoomPlatformRoom` owns its own DOM and stylesheet boundary.
+
 `apiBaseUrl` is the URL prefix before `/rooms`. The package calls these routes
 relative to it:
 
@@ -85,13 +87,18 @@ layout that allows the room to occupy the viewport.
 | `extensions`             | No       | Host-provided top-bar, workspace, sidebar, monitor, and participant extensions.      |
 | `integrations`           | No       | Chat and whiteboard configuration.                                                   |
 | `isPracticeMode`         | No       | Enables practice-room presentation behavior.                                         |
-| `showLocalPreview`       | No       | Shows the local preview in the sidebar. Defaults to `true`.                          |
-| `primaryCameraSelector`  | No       | Selects the primary camera track when the default selection is not suitable.         |
 | `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
+moderator camera becomes its overlay. If no moderator camera is available, the
+stage keeps its waiting state and never promotes a student camera. The local
+sidebar preview is hidden only when that selected moderator camera is local;
+its existing desktop breakpoint remains unchanged.
+
 ### Error and lifecycle callbacks
 
 ```tsx
@@ -153,6 +160,9 @@ whiteboard surface. Omit either integration when the host does not use it.
 Extensions keep host-specific UI outside the shared room implementation. Every
 extension receives `RoomPlatformExtensionProps`:
 
+Host extensions with independent framework CSS must own their own DOM and
+stylesheet boundary.
+
 ```tsx
 import type { RoomPlatformExtensionProps } from '@naviedu/room-platform-react'
 

package/index.d.ts

@@ -393,7 +393,6 @@ export declare type RoomPlatformExtensions = {
     topBarTrailing?: ComponentType<RoomPlatformExtensionProps>;
     monitor?: {
         roster: readonly RoomParticipantRosterEntry[];
-        roomEligible: boolean;
     };
     mainWorkspace?: {
         placement: 'overlay' | 'alongside-stage';
@@ -617,7 +616,7 @@ export declare type RoomPlatformProviderProps = PropsWithChildren<{
     }>;
 }>;
 
-export declare function RoomPlatformRoom({ children, extensions, integrations, isPracticeMode, onExit, primaryCameraSelector, showLocalPreview, sizing, ...providerProps }: RoomPlatformRoomProps): JSX.Element;
+export declare function RoomPlatformRoom(props: RoomPlatformRoomProps): JSX.Element;
 
 export declare type RoomPlatformRoomProps = {
     apiBaseUrl: string;
@@ -626,8 +625,6 @@ export declare type RoomPlatformRoomProps = {
     launchToken: string;
     isPracticeMode?: boolean;
     sizing?: RoomPlatformSizing;
-    primaryCameraSelector?: (cameraTracks: readonly TrackReference[], activeSpeakerParticipantIdentity?: string) => TrackReference | null;
-    showLocalPreview?: boolean;
     onError?: (event: RoomPlatformErrorEvent) => void;
     onLifecycleEvent?: (event: RoomPlatformLifecycleEvent) => void;
     onExit?: () => void;
@@ -663,14 +660,13 @@ export declare type RoomPlatformShellProps = {
 
 export declare type RoomPlatformSizing = 'viewport' | 'container';
 
-export declare function RoomPlatformSpeakQueue({ activeSpeakerParticipantIdentity, activeSpeakerSlot, canApproveSpeak, canClearActiveSpeaker, canRejectSpeak, isClearingActiveSpeaker, isPracticeMode, onApproveSpeakRequest, onClearActiveSpeaker, onRejectSpeakRequest, participants, raisedHandParticipantIdentities, }: {
+export declare function RoomPlatformSpeakQueue({ activeSpeakerParticipantIdentity, activeSpeakerSlot, canApproveSpeak, canClearActiveSpeaker, canRejectSpeak, isClearingActiveSpeaker, onApproveSpeakRequest, onClearActiveSpeaker, onRejectSpeakRequest, participants, raisedHandParticipantIdentities, }: {
     activeSpeakerParticipantIdentity?: string;
     activeSpeakerSlot?: ReactNode;
     canApproveSpeak?: boolean;
     canClearActiveSpeaker?: boolean;
     canRejectSpeak?: boolean;
     isClearingActiveSpeaker?: boolean;
-    isPracticeMode?: boolean;
     onApproveSpeakRequest?: (participantIdentity: string) => Promise<void> | void;
     onClearActiveSpeaker?: () => void;
     onRejectSpeakRequest?: (participantIdentity: string) => Promise<void> | void;