@naviedu/room-platform-react 0.0.44 → 0.0.46

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

@@ -580,6 +580,7 @@ export declare type RoomPlatformRoomProps = {
     extensions?: RoomPlatformExtensions;
     launchToken: string;
     modeConfig?: RoomPlatformModeConfig;
+    primaryCameraPlacement?: 'overlay' | 'sidebar';
     shadowDom?: boolean;
     sizing?: RoomPlatformSizing;
     onError?: (event: RoomPlatformErrorEvent) => void;

package/index.esm.js

@@ -29067,9 +29067,9 @@ function getTrackAspectRatio(trackRef) {
 }
 function RoomPlatformStage(param) {
     var controlBar = param.controlBar, _param_layout = param.layout, layout = _param_layout === void 0 ? 'stage' : _param_layout, model = param.model, overlayTrack = param.overlayTrack, status = param.status, whiteboard = param.whiteboard;
-    var _ref, _ref1;
+    var _ref;
     var _model_primary, _model_primary1;
-    var cameraOverlayTrack = (_ref = overlayTrack !== null && overlayTrack !== void 0 ? overlayTrack : model.localPreview) !== null && _ref !== void 0 ? _ref : model.primary;
+    var cameraOverlayTrack = overlayTrack !== null && overlayTrack !== void 0 ? overlayTrack : model.primary;
     var displayedTrack = layout === 'camera-overlay' ? cameraOverlayTrack : model.primary;
     var dimensions = displayedTrack === null || displayedTrack === void 0 ? void 0 : displayedTrack.publication.dimensions;
     var screenShareTrack = layout === 'stage' && ((_model_primary = model.primary) === null || _model_primary === void 0 ? void 0 : _model_primary.source) === Track.Source.ScreenShare ? model.primary : null;
@@ -29114,7 +29114,7 @@ function RoomPlatformStage(param) {
                 style: frameStyle,
                 children: /*#__PURE__*/ jsx("section", {
                     className: frameClassName,
-                    "data-source": (_ref1 = (_model_primary1 = model.primary) === null || _model_primary1 === void 0 ? void 0 : _model_primary1.source) !== null && _ref1 !== void 0 ? _ref1 : 'empty',
+                    "data-source": (_ref = (_model_primary1 = model.primary) === null || _model_primary1 === void 0 ? void 0 : _model_primary1.source) !== null && _ref !== void 0 ? _ref : 'empty',
                     "data-testid": "room-platform-stage-frame",
                     style: frameStyle,
                     children: isScreenShare && model.primary ? /*#__PURE__*/ jsx("div", {
@@ -29576,7 +29576,7 @@ function RoomPlatformWhiteboardShareLifecycle(param) {
     return null;
 }
 var RoomPlatformWorkspaceContent = function(param) {
-    var cameraBackground = param.cameraBackground, completionAction = param.completionAction, extensions = param.extensions, modeConfig = param.modeConfig, onExit = param.onExit, sizing = param.sizing, stageModel = param.stageModel;
+    var cameraBackground = param.cameraBackground, completionAction = param.completionAction, extensions = param.extensions, modeConfig = param.modeConfig, onExit = param.onExit, _param_primaryCameraPlacement = param.primaryCameraPlacement, primaryCameraPlacement = _param_primaryCameraPlacement === void 0 ? 'overlay' : _param_primaryCameraPlacement, sizing = param.sizing, stageModel = param.stageModel;
     var _resolvedStageModel_cameraOverlay, _ref, _ref1, _ref2, _ref3, _ref4;
     var _resolvedStageModel_primary, _resolvedStageModel_primary1, _extensions_sidebarTabs;
     var _useRoomPlatform = useRoomPlatform(), access = _useRoomPlatform.access, controlState = _useRoomPlatform.controlState, error = _useRoomPlatform.error, hasCapability = _useRoomPlatform.hasCapability, isActionPending = _useRoomPlatform.isActionPending, localCameraTrack = _useRoomPlatform.localCameraTrack, performAction = _useRoomPlatform.performAction, status = _useRoomPlatform.status;
@@ -29820,10 +29820,10 @@ var RoomPlatformWorkspaceContent = function(param) {
     var activeSpeakerSlot = resolvedStageModel.activeSpeaker && !isSelfActiveSpeaker ? /*#__PURE__*/ jsx(RoomPlatformActiveSpeaker, {
         trackRef: resolvedStageModel.activeSpeaker
     }) : undefined;
-    var localMediaSlot = (selectedHostCamera === null || selectedHostCamera === void 0 ? void 0 : selectedHostCamera.participant.isLocal) ? undefined : /*#__PURE__*/ jsx(RoomPlatformLocalPreview, {
+    var localMediaSlot = primaryCameraPlacement === 'sidebar' || !(selectedHostCamera === null || selectedHostCamera === void 0 ? void 0 : selectedHostCamera.participant.isLocal) ? /*#__PURE__*/ jsx(RoomPlatformLocalPreview, {
         localTrack: localCameraTrack,
         trackRef: resolvedStageModel.localPreview
-    });
+    }) : undefined;
     var activeSpeakerMediaSlot = hasActiveSpeaker && !canModerate ? activeSpeakerSlot : undefined;
     var isClearingActiveSpeaker = isActionPending(RoomPlatformAction.SPEAKER_CLEAR);
     var clearActiveSpeaker = function() {
@@ -29950,12 +29950,12 @@ var RoomPlatformWorkspaceContent = function(param) {
                                     className: "min-h-0 bg-slate-950",
                                     controlBar: controlBar,
                                     children: [
-                                        /*#__PURE__*/ jsx(RoomPlatformStage, {
+                                        primaryCameraPlacement === 'overlay' ? /*#__PURE__*/ jsx(RoomPlatformStage, {
                                             layout: "camera-overlay",
                                             model: resolvedStageModel,
                                             overlayTrack: workspaceOverlayTrack,
                                             status: status
-                                        }),
+                                        }) : null,
                                         /*#__PURE__*/ jsx(RoomPlatformExtensionZone, {
                                             component: MainWorkspace,
                                             extensionProps: extensionProps
@@ -30205,12 +30205,13 @@ function RoomPlatformPrivateRoomRuntime(param) {
     });
 }
 function RoomPlatformRuntime(_0) {
-    var children = _0.children, completionAction = _0.completionAction, extensions = _0.extensions, modeConfig = _0.modeConfig, onExit = _0.onExit, _0_sizing = _0.sizing, sizing = _0_sizing === void 0 ? 'viewport' : _0_sizing, providerProps = _object_without_properties(_0, [
+    var children = _0.children, completionAction = _0.completionAction, extensions = _0.extensions, modeConfig = _0.modeConfig, onExit = _0.onExit, primaryCameraPlacement = _0.primaryCameraPlacement, _0_sizing = _0.sizing, sizing = _0_sizing === void 0 ? 'viewport' : _0_sizing, providerProps = _object_without_properties(_0, [
         "children",
         "completionAction",
         "extensions",
         "modeConfig",
         "onExit",
+        "primaryCameraPlacement",
         "sizing"
     ]);
     return /*#__PURE__*/ jsx(RoomPlatformProvider, _object_spread_props(_object_spread({}, providerProps), {
@@ -30221,6 +30222,7 @@ function RoomPlatformRuntime(_0) {
                     extensions: extensions,
                     modeConfig: modeConfig,
                     onExit: onExit,
+                    primaryCameraPlacement: primaryCameraPlacement,
                     sizing: sizing
                 })
             })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naviedu/room-platform-react",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "type": "module",
   "main": "./index.esm.js",
   "module": "./index.esm.js",