@naviedu/room-platform-react 0.0.1

package/styles.css

@@ -0,0 +1,598 @@
+.room-platform-room {
+    --room-platform-navy: #242f62;
+    --room-platform-orange: #eb6619;
+    --room-platform-border: #dbe3ef;
+    --room-platform-surface: #ffffff;
+    --room-platform-muted: #f8fafc;
+    background: var(--room-platform-muted);
+    color: #172033;
+    display: flex;
+    flex-direction: column;
+    height: 100dvh;
+    min-height: 100dvh;
+    min-width: 0;
+    overflow: hidden;
+    width: 100%;
+}
+
+.room-platform-surface {
+    box-sizing: border-box;
+}
+
+.room-platform-panel {
+    background: var(--room-platform-surface);
+    border: 1px solid var(--room-platform-border);
+    border-radius: 8px;
+}
+
+.room-platform-button {
+    align-items: center;
+    border: 1px solid transparent;
+    border-radius: 8px;
+    cursor: pointer;
+    display: inline-flex;
+    font: inherit;
+    gap: 0.375rem;
+    justify-content: center;
+    min-height: 2rem;
+    padding: 0.375rem 0.75rem;
+}
+
+.room-platform-button:focus-visible,
+.room-platform-tab:focus-visible {
+    outline: 3px solid color-mix(in srgb, var(--room-platform-orange), transparent 65%);
+    outline-offset: 2px;
+}
+
+.room-platform-button:disabled {
+    cursor: not-allowed;
+    opacity: 0.55;
+}
+
+.room-platform-button--default {
+    background: var(--room-platform-navy);
+    color: #fff;
+}
+
+.room-platform-button--quiet {
+    background: #edf2f7;
+    color: var(--room-platform-navy);
+}
+
+.room-platform-button--danger {
+    background: #fff1f2;
+    color: #b42318;
+}
+
+.room-platform-shell {
+    background: #020617;
+    color: #fff;
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    min-height: 0;
+    min-width: 0;
+    overflow: hidden;
+}
+
+.room-platform-shell-top-bar--hidden {
+    display: none;
+}
+
+.room-platform-shell-body {
+    display: grid;
+    flex: 1;
+    grid-template-columns: minmax(0, 1fr);
+    min-height: 0;
+    position: relative;
+}
+
+.room-platform-shell-body--sidebar {
+    grid-template-columns: minmax(0, 1fr) minmax(16.25rem, 18.75rem);
+}
+
+.room-platform-shell-main {
+    display: flex;
+    min-height: 0;
+    min-width: 0;
+    overflow: hidden;
+    position: relative;
+}
+
+.room-platform-shell-sidebar {
+    display: flex;
+    min-height: 0;
+    position: relative;
+    width: 100%;
+}
+
+.room-platform-shell-sidebar-content {
+    flex: 1;
+    min-height: 0;
+    overflow: hidden;
+}
+
+.room-platform-shell-sidebar-open,
+.room-platform-shell-sidebar-close {
+    position: absolute;
+    z-index: 40;
+}
+
+.room-platform-shell-sidebar-open {
+    right: 1rem;
+    top: 1rem;
+}
+
+.room-platform-shell-sidebar-close {
+    left: 0;
+    top: 0.75rem;
+    transform: translateX(-100%);
+}
+
+.room-platform-top-bar {
+    align-items: center;
+    background: #0f172a;
+    border-bottom: 1px solid rgb(255 255 255 / 10%);
+    color: #fff;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.75rem;
+    justify-content: space-between;
+    min-height: 4.5rem;
+    padding: 0.75rem 1rem;
+}
+
+.room-platform-top-bar h1,
+.room-platform-top-bar p {
+    margin: 0;
+}
+
+.room-platform-top-bar h1 {
+    color: #fff;
+    font-size: 1.125rem;
+}
+
+.room-platform-eyebrow {
+    color: #cbd5e1;
+    font-size: 0.75rem;
+    font-weight: 600;
+    text-transform: uppercase;
+}
+
+.room-platform-top-bar-heading,
+.room-platform-top-bar-trailing {
+    align-items: center;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.5rem;
+}
+
+.room-platform-top-bar-trailing {
+    justify-content: flex-end;
+}
+
+.room-platform-media-controls {
+    align-items: center;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.375rem;
+}
+
+.room-platform-media-controls .room-platform-button {
+    font-size: 0.8125rem;
+}
+
+.room-platform-status {
+    border-radius: 999px;
+    font-size: 0.8rem;
+    font-weight: 600;
+    padding: 0.25rem 0.625rem;
+}
+
+.room-platform-status[data-status='connected'] {
+    background: #dcfae6;
+    color: #166534;
+}
+
+.room-platform-status[data-status='error'] {
+    background: #fee2e2;
+    color: #b42318;
+}
+
+.room-platform-status[data-status='connecting'],
+.room-platform-status[data-status='reconnecting'] {
+    background: #fff3d6;
+    color: #9a4f00;
+}
+
+.room-platform-main {
+    display: flex;
+    flex: 1;
+    gap: 1rem;
+    min-height: 0;
+    min-width: 0;
+    padding: 1rem;
+    position: relative;
+}
+
+.room-platform-stage-area {
+    flex: 1;
+    min-height: 26rem;
+    min-width: 0;
+    position: relative;
+}
+
+.room-platform-stage {
+    align-items: center;
+    background: linear-gradient(135deg, #1e2a5b, #3c4b89);
+    color: #fff;
+    display: flex;
+    height: 100%;
+    justify-content: center;
+    overflow: hidden;
+    padding: 1rem;
+    position: relative;
+}
+
+.room-platform-stage-title {
+    font-size: 1.125rem;
+    font-weight: 700;
+}
+
+.room-platform-workspace-overlay {
+    align-items: center;
+    display: flex;
+    height: 100%;
+    justify-content: center;
+    overflow: auto;
+    width: 100%;
+}
+
+.room-platform-workspace-alongside {
+    min-width: 18rem;
+    width: 35%;
+}
+
+.room-platform-sidebar {
+    background: var(--room-platform-surface);
+    border: 1px solid var(--room-platform-border);
+    border-radius: 8px;
+    min-width: 0;
+    overflow: hidden;
+    width: 100%;
+}
+
+.room-platform-control-anchor {
+    align-items: stretch;
+    display: flex;
+    flex: 1;
+    justify-content: center;
+    min-height: 0;
+    min-width: 0;
+    overflow: hidden;
+    position: relative;
+}
+
+.room-platform-control-bar {
+    bottom: 0;
+    display: flex;
+    justify-content: center;
+    left: 0;
+    margin: auto;
+    padding: 0 0.75rem 0.75rem;
+    position: absolute;
+    right: 0;
+    transition: transform 200ms ease;
+    width: fit-content;
+    z-index: 40;
+}
+
+.room-platform-control-bar--hidden {
+    transform: translateY(calc(100% - 0.75rem));
+}
+
+.room-platform-control-reveal {
+    bottom: 0.25rem;
+    left: 50%;
+    position: absolute;
+    transform: translateX(-50%);
+    z-index: 30;
+}
+
+.room-platform-side-media {
+    display: grid;
+    gap: 0.75rem;
+    padding: 0.75rem;
+}
+
+.room-platform-video-tile {
+    background: #0f172a;
+    border-radius: 8px;
+    color: #fff;
+    min-height: 0;
+    overflow: hidden;
+    position: relative;
+    width: 100%;
+}
+
+.room-platform-video-tile--preview,
+.room-platform-video-tile--active-speaker {
+    aspect-ratio: 16 / 9;
+}
+
+.room-platform-video-tile--stage,
+.room-platform-video-tile--overlay {
+    height: 100%;
+}
+
+.room-platform-video-tile-media {
+    display: block;
+    height: 100%;
+    object-fit: cover;
+    width: 100%;
+}
+
+.room-platform-video-tile--stage .room-platform-video-tile-media {
+    object-fit: contain;
+}
+
+.room-platform-video-tile-media--mirrored {
+    transform: scaleX(-1);
+}
+
+.room-platform-video-tile-label {
+    background: rgb(15 23 42 / 75%);
+    border-radius: 999px;
+    bottom: 0.5rem;
+    font-size: 0.75rem;
+    font-weight: 700;
+    left: 0.5rem;
+    max-width: calc(100% - 1rem);
+    overflow: hidden;
+    padding: 0.25rem 0.5rem;
+    position: absolute;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    z-index: 15;
+}
+
+.room-platform-video-tile-empty {
+    align-items: center;
+    display: flex;
+    font-size: 0.8125rem;
+    height: 100%;
+    justify-content: center;
+    margin: 0;
+    min-height: 8rem;
+    padding: 1rem;
+    text-align: center;
+}
+
+.room-platform-tabs {
+    border-bottom: 1px solid var(--room-platform-border);
+    display: flex;
+    gap: 0.25rem;
+    overflow-x: auto;
+    padding: 0.5rem;
+}
+
+.room-platform-tab {
+    background: transparent;
+    border: 0;
+    border-radius: 6px;
+    color: #475569;
+    cursor: pointer;
+    font: inherit;
+    font-size: 0.875rem;
+    padding: 0.4rem 0.6rem;
+    white-space: nowrap;
+}
+
+.room-platform-tab[aria-selected='true'] {
+    background: #e9edf9;
+    color: var(--room-platform-navy);
+    font-weight: 700;
+}
+
+.room-platform-tab-panel {
+    padding: 0.75rem;
+}
+
+.room-platform-participant-list {
+    display: grid;
+    gap: 0.5rem;
+}
+
+.room-platform-participant-row {
+    align-items: center;
+    display: flex;
+    gap: 0.5rem;
+    justify-content: space-between;
+    padding: 0.625rem;
+}
+
+.room-platform-participant-name,
+.room-platform-participant-subtitle {
+    margin: 0;
+}
+
+.room-platform-participant-name {
+    font-size: 0.875rem;
+    font-weight: 700;
+}
+
+.room-platform-participant-subtitle {
+    color: #64748b;
+    font-size: 0.75rem;
+}
+
+.room-platform-participant-row-trailing,
+.room-platform-participant-actions {
+    align-items: center;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.375rem;
+    justify-content: flex-end;
+}
+
+.room-platform-participant-actions .room-platform-button {
+    font-size: 0.75rem;
+    min-height: 1.75rem;
+    padding: 0.25rem 0.5rem;
+}
+
+.room-platform-action-error {
+    color: #b42318;
+    font-size: 0.8125rem;
+    margin: 0.5rem 0 0;
+}
+
+.room-platform-error {
+    color: #fca5a5;
+    font-size: 0.8125rem;
+    margin: 0.5rem 0 0;
+}
+
+.room-platform-empty {
+    color: #64748b;
+    font-size: 0.875rem;
+    margin: 0;
+    padding: 1rem 0;
+    text-align: center;
+}
+
+.room-platform-whiteboard {
+    height: 100%;
+    width: 100%;
+}
+
+.room-platform-surface-error {
+    align-items: center;
+    background: rgb(15 23 42 / 88%);
+    color: #fff;
+    display: flex;
+    height: 100%;
+    justify-content: center;
+    margin: 0;
+    padding: 1rem;
+    text-align: center;
+    width: 100%;
+}
+
+.room-platform-start-audio {
+    background: #242f62;
+    border: 0;
+    border-radius: 8px;
+    color: #fff;
+    cursor: pointer;
+    left: 50%;
+    padding: 0.625rem 1rem;
+    position: fixed;
+    top: 1rem;
+    transform: translateX(-50%);
+    z-index: 50;
+}
+
+.room-platform-start-audio:focus-visible {
+    outline: 3px solid #eb6619;
+    outline-offset: 2px;
+}
+
+.room-platform-stage-frame {
+    align-items: center;
+    background: #0f172a;
+    border-radius: 8px;
+    display: flex;
+    justify-content: center;
+    max-height: 100%;
+    max-width: 100%;
+    overflow: hidden;
+    position: relative;
+    width: 100%;
+}
+
+.room-platform-stage-frame > video {
+    display: block;
+    height: 100%;
+    object-fit: contain;
+    width: 100%;
+}
+
+.room-platform-stage-content {
+    inset: 0;
+    position: absolute;
+    z-index: 10;
+}
+
+.room-platform-stage-camera-overlay {
+    aspect-ratio: 16 / 9;
+    left: 1rem;
+    max-width: 40%;
+    overflow: hidden;
+    position: absolute;
+    top: 1rem;
+    width: 12rem;
+    z-index: 20;
+}
+
+.room-platform-stage-camera-overlay video {
+    height: 100%;
+    object-fit: cover;
+    width: 100%;
+}
+
+.room-platform-stage-status {
+    background: rgb(15 23 42 / 80%);
+    border-radius: 999px;
+    color: #dbeafe;
+    left: 50%;
+    margin: 0;
+    padding: 0.375rem 0.75rem;
+    position: absolute;
+    top: 1.5rem;
+    transform: translateX(-50%);
+    z-index: 30;
+}
+
+@media (max-width: 900px) {
+    .room-platform-stage-area {
+        min-height: 20rem;
+    }
+}
+
+@media (max-width: 767px) {
+    .room-platform-shell-body {
+        grid-template-columns: 1fr;
+        grid-template-rows: minmax(15rem, 45dvh) minmax(0, 1fr);
+    }
+
+    .room-platform-shell-body > .room-platform-shell-main:only-child {
+        grid-row: 1 / -1;
+    }
+
+    .room-platform-shell-sidebar {
+        max-width: none;
+    }
+
+    .room-platform-top-bar {
+        align-items: flex-start;
+        flex-direction: column;
+        gap: 0.75rem;
+    }
+
+    .room-platform-top-bar-heading,
+    .room-platform-top-bar-trailing {
+        justify-content: flex-start;
+        width: 100%;
+    }
+
+    .room-platform-main {
+        flex-direction: column;
+        padding: 0.5rem;
+    }
+
+    .room-platform-workspace-alongside {
+        min-width: 0;
+        width: 100%;
+    }
+}

package/use-room-platform-camera-background.d.ts

@@ -0,0 +1,34 @@
+import type { LocalVideoTrack } from 'livekit-client';
+export type RoomPlatformCameraBackgroundUploadPreview = {
+    id: string;
+    name: string;
+    createdAt: string;
+    previewUrl: string;
+};
+export type RoomPlatformCameraBackgroundState = {
+    mode: 'none' | 'blur' | 'preset' | 'upload';
+    blurLevel: 'light' | 'strong';
+    presetId?: string;
+    uploadAssetId?: string;
+    isSupported: boolean;
+    isApplying: boolean;
+    error: string | null;
+};
+export type UseRoomPlatformCameraBackgroundInput = {
+    localVideoTrack: LocalVideoTrack | null;
+};
+export declare function useRoomPlatformCameraBackground({ localVideoTrack }: UseRoomPlatformCameraBackgroundInput): {
+    state: RoomPlatformCameraBackgroundState;
+    uploadItems: RoomPlatformCameraBackgroundUploadPreview[];
+    uploadPreviewUrl: string;
+    setBackgroundOff: () => Promise<void>;
+    setBlurLevel: (blurLevel: "light" | "strong") => Promise<void>;
+    setBlur: () => Promise<void>;
+    setPreset: (presetId: string) => Promise<void>;
+    selectUploaded: (uploadAssetId: string) => Promise<void>;
+    setUploaded: () => Promise<void>;
+    setUpload: (file: File) => Promise<void>;
+    removeUploaded: (uploadAssetId: string) => Promise<void>;
+    clearError: () => void;
+};
+export type RoomPlatformCameraBackgroundRuntime = ReturnType<typeof useRoomPlatformCameraBackground>;

package/use-room-platform-private-room-control-actions.d.ts

@@ -0,0 +1,21 @@
+export type UseRoomPlatformPrivateRoomControlActionsInput = {
+    canShareScreen: boolean;
+    isScreenSharing: boolean;
+    onStartScreenShare: () => Promise<void>;
+    onStopScreenShare: () => Promise<void>;
+    onEnd: () => Promise<void> | void;
+    onScreenSharingChange?: (isScreenSharing: boolean) => void;
+    setLocalScreenShareEnabled?: (enabled: boolean) => Promise<void>;
+    onEndingChange?: (isEnding: boolean) => void;
+    onEnded?: () => void;
+};
+export type UseRoomPlatformPrivateRoomControlActionsResult = {
+    isScreenSharing: boolean;
+    isScreenSharePending: boolean;
+    isEnding: boolean;
+    canToggleScreenShare: boolean;
+    startScreenShare: () => Promise<void>;
+    stopScreenShare: () => Promise<void>;
+    endPrivateRoom: () => Promise<void>;
+};
+export declare function useRoomPlatformPrivateRoomControlActions({ canShareScreen, isScreenSharing, onStartScreenShare, onStopScreenShare, onEnd, onScreenSharingChange, setLocalScreenShareEnabled, onEndingChange, onEnded, }: UseRoomPlatformPrivateRoomControlActionsInput): UseRoomPlatformPrivateRoomControlActionsResult;

package/use-room-platform-private-room.d.ts

@@ -0,0 +1,43 @@
+import { type RoomPrivateRoomConnection, type RoomPrivateRoomState } from '@navi/feature-room-platform';
+import type { RoomPlatformPrivateRoomStatusBannerProps, RoomPlatformPrivateRoomStatusBannerTone } from './room-platform-private-room-status-banner';
+export type RoomPlatformPrivateRoomBannerState = Omit<RoomPlatformPrivateRoomStatusBannerProps, 'message'> & {
+    message: string;
+    tone?: RoomPlatformPrivateRoomStatusBannerTone;
+};
+export declare function getRoomPlatformPrivateRoomStatusBanner({ privateRoom, isCaller, canMountPrivateRoom, isAcceptingPrivateRoom, isEndingPrivateRoom, privateRoomReturnedNoticeId, }: {
+    privateRoom?: RoomPrivateRoomState;
+    isCaller: boolean;
+    canMountPrivateRoom: boolean;
+    isAcceptingPrivateRoom: boolean;
+    isEndingPrivateRoom: boolean;
+    privateRoomReturnedNoticeId?: string;
+}): RoomPlatformPrivateRoomBannerState | undefined;
+export type RoomPlatformPrivateRoomRuntimeState = {
+    actorExternalId?: string;
+    canMountPrivateRoom: boolean;
+    currentPrivateRoomOperation?: {
+        status: 'ringing' | 'active';
+        studentExternalActorId: string;
+    };
+    hasIncomingPrivateRoom: boolean;
+    isAcceptingPrivateRoom: boolean;
+    isCaller: boolean;
+    privateRoom?: RoomPrivateRoomState;
+    privateRoomConnection?: RoomPrivateRoomConnection;
+    privateRoomReturnedNoticeId?: string;
+    privateRoomStatusBanner?: RoomPlatformPrivateRoomBannerState;
+    acceptPrivateRoom: () => Promise<void>;
+    declinePrivateRoom: () => Promise<void>;
+    cancelPrivateRoom: () => Promise<void>;
+    endPrivateRoom: () => Promise<void>;
+    startPrivateScreenShare: () => Promise<void>;
+    stopPrivateScreenShare: () => Promise<void>;
+    markPrivateRoomEnded: () => void;
+    setIsAcceptingPrivateRoom: (value: boolean) => void;
+};
+export declare function useRoomPlatformPrivateRoom(): RoomPlatformPrivateRoomRuntimeState;
+export declare function useRoomPlatformPrivateRoomPendingState(): {
+    acceptPending: boolean;
+    declinePending: boolean;
+    endPending: boolean;
+};

package/use-room-platform-stage.d.ts

@@ -0,0 +1,2 @@
+import type { RoomPlatformPrimaryCameraSelector } from './room-platform-stage-selection';
+export declare function useRoomPlatformStage(primaryCameraSelector?: RoomPlatformPrimaryCameraSelector): import("./room-platform-stage-selection").RoomPlatformStageModel;

package/use-room-presence.d.ts

@@ -0,0 +1,2 @@
+import type { RoomParticipantPresence } from './room-platform-types';
+export declare function useRoomPresence(): RoomParticipantPresence[];