@selfcommunity/react-ui 0.10.2-alpha.8 → 0.10.2-courses.100

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/PreJoin.d.ts

@@ -0,0 +1,58 @@
+import type { CreateLocalTracksOptions, LocalAudioTrack, LocalTrack, LocalVideoTrack } from 'livekit-client';
+import { Track } from 'livekit-client';
+import * as React from 'react';
+import type { LocalUserChoices } from '@livekit/components-core';
+/**
+ * Props for the PreJoin component.
+ * @public
+ */
+export interface PreJoinProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSubmit' | 'onError'> {
+    /** This function is called with the `LocalUserChoices` if validation is passed. */
+    onSubmit?: (values: LocalUserChoices) => void;
+    /**
+     * Provide your custom validation function. Only if validation is successful the user choices are past to the onSubmit callback.
+     */
+    onValidate?: (values: LocalUserChoices) => boolean;
+    onError?: (error: Error) => void;
+    /** Prefill the input form with initial values. */
+    defaults?: Partial<LocalUserChoices>;
+    /** Display a debug window for your convenience. */
+    debug?: boolean;
+    joinLabel?: string;
+    micLabel?: string;
+    camLabel?: string;
+    userLabel?: string;
+    /**
+     * If true, user choices are persisted across sessions.
+     * @defaultValue true
+     * @alpha
+     */
+    persistUserChoices?: boolean;
+}
+/** @alpha */
+export declare function usePreviewTracks(options: CreateLocalTracksOptions, onError?: (err: Error) => void): {
+    tracks: LocalTrack<Track.Kind>[];
+    error: boolean;
+};
+/** @public */
+export declare function usePreviewDevice<T extends LocalVideoTrack | LocalAudioTrack>(enabled: boolean, deviceId: string, kind: 'videoinput' | 'audioinput'): {
+    selectedDevice: MediaDeviceInfo;
+    localTrack: T;
+    deviceError: Error;
+};
+/**
+ * The `PreJoin` prefab component is normally presented to the user before he enters a room.
+ * This component allows the user to check and select the preferred media device (camera und microphone).
+ * On submit the user decisions are returned, which can then be passed on to the `LiveKitRoom` so that the user enters the room with the correct media devices.
+ *
+ * @remarks
+ * This component is independent of the `LiveKitRoom` component and should not be nested within it.
+ * Because it only accesses the local media tracks this component is self-contained and works without connection to the LiveKit server.
+ *
+ * @example
+ * ```tsx
+ * <PreJoin />
+ * ```
+ * @public
+ */
+export declare function PreJoin({ defaults, onValidate, onSubmit, onError, debug, joinLabel, micLabel, camLabel, userLabel, persistUserChoices, ...htmlProps }: PreJoinProps): JSX.Element;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/PreJoin.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreJoin = exports.usePreviewDevice = exports.usePreviewTracks = void 0;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const livekit_client_1 = require("livekit-client");
+const React = tslib_1.__importStar(require("react"));
+const components_core_1 = require("@livekit/components-core");
+const components_core_2 = require("@livekit/components-core");
+const components_react_1 = require("@livekit/components-react");
+const react_core_1 = require("@selfcommunity/react-core");
+const ParticipantTileAvatar_1 = tslib_1.__importDefault(require("./ParticipantTileAvatar"));
+const react_1 = require("react");
+const TrackToggle_1 = require("./TrackToggle");
+const LiveStreamProvider_1 = require("./LiveStreamProvider");
+/** @alpha */
+function usePreviewTracks(options, onError) {
+    const [tracks, setTracks] = React.useState();
+    const [error, setError] = React.useState(false);
+    const trackLock = React.useMemo(() => new livekit_client_1.Mutex(), []);
+    React.useEffect(() => {
+        let needsCleanup = false;
+        let localTracks = [];
+        trackLock.lock().then((unlock) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if (options.audio || options.video) {
+                    localTracks = yield (0, livekit_client_1.createLocalTracks)(options);
+                    if (needsCleanup) {
+                        localTracks.forEach((tr) => tr.stop());
+                    }
+                    else {
+                        setTracks(localTracks);
+                    }
+                    setError(false);
+                }
+            }
+            catch (e) {
+                if (onError && e instanceof Error) {
+                    onError(e);
+                }
+                else {
+                    components_core_1.log.error(e);
+                }
+                setError(true);
+            }
+            finally {
+                unlock();
+            }
+        }));
+        return () => {
+            needsCleanup = true;
+            localTracks.forEach((track) => {
+                track.stop();
+            });
+            setError(false);
+        };
+    }, [JSON.stringify(options), onError, trackLock]);
+    return { tracks, error };
+}
+exports.usePreviewTracks = usePreviewTracks;
+/** @public */
+function usePreviewDevice(enabled, deviceId, kind) {
+    const [deviceError, setDeviceError] = React.useState(null);
+    const [isCreatingTrack, setIsCreatingTrack] = React.useState(false);
+    const devices = (0, components_react_1.useMediaDevices)({ kind });
+    const [selectedDevice, setSelectedDevice] = React.useState(undefined);
+    const [localTrack, setLocalTrack] = React.useState();
+    const [localDeviceId, setLocalDeviceId] = React.useState(deviceId);
+    React.useEffect(() => {
+        setLocalDeviceId(deviceId);
+    }, [deviceId]);
+    const createTrack = (deviceId, kind) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        try {
+            const track = kind === 'videoinput'
+                ? yield (0, livekit_client_1.createLocalVideoTrack)({
+                    deviceId: deviceId,
+                    resolution: livekit_client_1.VideoPresets.h720.resolution
+                })
+                : yield (0, livekit_client_1.createLocalAudioTrack)({ deviceId });
+            const newDeviceId = yield track.getDeviceId();
+            if (newDeviceId && deviceId !== newDeviceId) {
+                prevDeviceId.current = newDeviceId;
+                setLocalDeviceId(newDeviceId);
+            }
+            setLocalTrack(track);
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                setDeviceError(e);
+            }
+        }
+    });
+    const switchDevice = (track, id) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        yield track.setDeviceId(id);
+        prevDeviceId.current = id;
+    });
+    const prevDeviceId = React.useRef(localDeviceId);
+    React.useEffect(() => {
+        if (enabled && !localTrack && !deviceError && !isCreatingTrack) {
+            components_core_1.log.debug('creating track', kind);
+            setIsCreatingTrack(true);
+            createTrack(localDeviceId, kind).finally(() => {
+                setIsCreatingTrack(false);
+            });
+        }
+    }, [enabled, localTrack, deviceError, isCreatingTrack]);
+    // switch camera device
+    React.useEffect(() => {
+        if (!localTrack) {
+            return;
+        }
+        if (!enabled) {
+            components_core_1.log.debug(`muting ${kind} track`);
+            localTrack.mute().then(() => components_core_1.log.debug(localTrack.mediaStreamTrack));
+        }
+        else if ((selectedDevice === null || selectedDevice === void 0 ? void 0 : selectedDevice.deviceId) && prevDeviceId.current !== (selectedDevice === null || selectedDevice === void 0 ? void 0 : selectedDevice.deviceId)) {
+            components_core_1.log.debug(`switching ${kind} device from`, prevDeviceId.current, selectedDevice.deviceId);
+            switchDevice(localTrack, selectedDevice.deviceId);
+        }
+        else {
+            components_core_1.log.debug(`unmuting local ${kind} track`);
+            localTrack.unmute();
+        }
+    }, [localTrack, selectedDevice, enabled, kind]);
+    React.useEffect(() => {
+        return () => {
+            if (localTrack) {
+                components_core_1.log.debug(`stopping local ${kind} track`);
+                localTrack.stop();
+                localTrack.mute();
+            }
+        };
+    }, []);
+    React.useEffect(() => {
+        setSelectedDevice(devices === null || devices === void 0 ? void 0 : devices.find((dev) => dev.deviceId === localDeviceId));
+    }, [localDeviceId, devices]);
+    return {
+        selectedDevice,
+        localTrack,
+        deviceError
+    };
+}
+exports.usePreviewDevice = usePreviewDevice;
+/**
+ * The `PreJoin` prefab component is normally presented to the user before he enters a room.
+ * This component allows the user to check and select the preferred media device (camera und microphone).
+ * On submit the user decisions are returned, which can then be passed on to the `LiveKitRoom` so that the user enters the room with the correct media devices.
+ *
+ * @remarks
+ * This component is independent of the `LiveKitRoom` component and should not be nested within it.
+ * Because it only accesses the local media tracks this component is self-contained and works without connection to the LiveKit server.
+ *
+ * @example
+ * ```tsx
+ * <PreJoin />
+ * ```
+ * @public
+ */
+function PreJoin(_a) {
+    var { defaults = {}, onValidate, onSubmit, onError, debug, joinLabel = 'Join Room', micLabel = 'Microphone', camLabel = 'Camera', userLabel = 'Username', persistUserChoices = true } = _a, htmlProps = tslib_1.__rest(_a, ["defaults", "onValidate", "onSubmit", "onError", "debug", "joinLabel", "micLabel", "camLabel", "userLabel", "persistUserChoices"]);
+    const { liveStream } = (0, LiveStreamProvider_1.useLiveStream)();
+    const scUserContext = (0, react_core_1.useSCUser)();
+    const [userChoices, setUserChoices] = React.useState(components_core_2.defaultUserChoices);
+    const canUseAudio = (0, react_1.useMemo)(() => { var _a; return scUserContext.user && liveStream && (liveStream.host.id === scUserContext.user.id || (liveStream && !((_a = liveStream === null || liveStream === void 0 ? void 0 : liveStream.settings) === null || _a === void 0 ? void 0 : _a.muteParticipants))); }, [scUserContext, liveStream]);
+    const canUseVideo = (0, react_1.useMemo)(() => { var _a; return scUserContext.user && liveStream && (liveStream.host.id === scUserContext.user.id || (liveStream && !((_a = liveStream === null || liveStream === void 0 ? void 0 : liveStream.settings) === null || _a === void 0 ? void 0 : _a.disableVideo))); }, [scUserContext, liveStream]);
+    // TODO: Remove and pipe `defaults` object directly into `usePersistentUserChoices` once we fully switch from type `LocalUserChoices` to `UserChoices`.
+    const partialDefaults = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (defaults.audioDeviceId !== undefined && { audioDeviceId: defaults.audioDeviceId })), (defaults.videoDeviceId !== undefined && { videoDeviceId: defaults.videoDeviceId })), (defaults.audioEnabled !== undefined && { audioEnabled: defaults.audioEnabled })), (defaults.videoEnabled !== undefined && { videoEnabled: defaults.videoEnabled })), (defaults.username !== undefined && { username: defaults.username }));
+    const { userChoices: initialUserChoices, saveAudioInputDeviceId, saveAudioInputEnabled, saveVideoInputDeviceId, saveVideoInputEnabled, saveUsername } = (0, components_react_1.usePersistentUserChoices)({
+        defaults: partialDefaults,
+        preventSave: !persistUserChoices,
+        preventLoad: !persistUserChoices
+    });
+    // Initialize device settings
+    const [audioEnabled, setAudioEnabled] = React.useState(initialUserChoices.audioEnabled && canUseAudio);
+    const [videoEnabled, setVideoEnabled] = React.useState(initialUserChoices.videoEnabled && canUseVideo);
+    const [audioDeviceId, setAudioDeviceId] = React.useState(initialUserChoices.audioDeviceId);
+    const [videoDeviceId, setVideoDeviceId] = React.useState(initialUserChoices.videoDeviceId);
+    const [username, setUsername] = React.useState(initialUserChoices.username);
+    // Save user choices to persistent storage.
+    React.useEffect(() => {
+        saveAudioInputEnabled(audioEnabled && canUseAudio);
+    }, [audioEnabled, saveAudioInputEnabled, canUseAudio]);
+    React.useEffect(() => {
+        saveVideoInputEnabled(videoEnabled && canUseVideo);
+    }, [videoEnabled, saveVideoInputEnabled, canUseVideo]);
+    React.useEffect(() => {
+        saveAudioInputDeviceId(audioDeviceId);
+    }, [audioDeviceId, saveAudioInputDeviceId]);
+    React.useEffect(() => {
+        saveVideoInputDeviceId(videoDeviceId);
+    }, [videoDeviceId, saveVideoInputDeviceId]);
+    React.useEffect(() => {
+        if (scUserContext.user) {
+            saveUsername(scUserContext.user.username);
+        }
+    }, [username, saveUsername, scUserContext.user]);
+    const { tracks, error } = usePreviewTracks({
+        audio: audioEnabled ? { deviceId: initialUserChoices.audioDeviceId } : false,
+        video: videoEnabled ? { deviceId: initialUserChoices.videoDeviceId } : false
+    }, onError);
+    const videoEl = React.useRef(null);
+    const videoTrack = React.useMemo(() => tracks === null || tracks === void 0 ? void 0 : tracks.filter((track) => track.kind === livekit_client_1.Track.Kind.Video)[0], [tracks]);
+    const facingMode = React.useMemo(() => {
+        if (videoTrack) {
+            const { facingMode } = (0, livekit_client_1.facingModeFromLocalTrack)(videoTrack);
+            return facingMode;
+        }
+        else {
+            return 'undefined';
+        }
+    }, [videoTrack]);
+    const audioTrack = React.useMemo(() => tracks === null || tracks === void 0 ? void 0 : tracks.filter((track) => track.kind === livekit_client_1.Track.Kind.Audio)[0], [tracks]);
+    React.useEffect(() => {
+        if (videoEl.current && videoTrack) {
+            videoTrack.unmute();
+            videoTrack.attach(videoEl.current);
+        }
+        return () => {
+            videoTrack === null || videoTrack === void 0 ? void 0 : videoTrack.detach();
+        };
+    }, [videoTrack]);
+    const [isValid, setIsValid] = React.useState();
+    const handleValidation = React.useCallback((values) => {
+        if (typeof onValidate === 'function') {
+            return onValidate(values);
+        }
+        else {
+            return Boolean(values.username !== '' &&
+                ((values.audioEnabled && values.audioDeviceId) || !values.audioEnabled) &&
+                ((values.videoEnabled && values.videoDeviceId) || !values.videoEnabled));
+        }
+    }, [onValidate]);
+    (0, react_1.useEffect)(() => {
+        const newUserChoices = {
+            username,
+            videoEnabled,
+            videoDeviceId,
+            audioEnabled,
+            audioDeviceId
+        };
+        setUserChoices(newUserChoices);
+        setIsValid(handleValidation(newUserChoices));
+    }, [username, scUserContext.user, videoEnabled, handleValidation, audioEnabled, audioDeviceId, videoDeviceId]);
+    function handleSubmit(event) {
+        event.preventDefault();
+        if (handleValidation(userChoices)) {
+            if (typeof onSubmit === 'function') {
+                onSubmit(userChoices);
+            }
+        }
+        else {
+            components_core_1.log.warn('Validation failed with: ', userChoices);
+        }
+    }
+    return ((0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-prejoin" }, htmlProps, { children: [(0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-video-container" }, { children: [videoTrack && (0, jsx_runtime_1.jsx)("video", { ref: videoEl, width: "1280", height: "720", "data-lk-facing-mode": facingMode }), (!videoTrack || !videoEnabled) && ((0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-camera-off-note" }, { children: (0, jsx_runtime_1.jsx)(ParticipantTileAvatar_1.default, { user: scUserContext.user }) })))] })), (0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-button-group-container" }, { children: [(0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-button-group audio" }, { children: [(0, jsx_runtime_1.jsx)(TrackToggle_1.TrackToggle, Object.assign({ disabled: !canUseAudio, initialState: audioEnabled, source: livekit_client_1.Track.Source.Microphone, onChange: (enabled) => setAudioEnabled(enabled) }, { children: micLabel })), (0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-button-group-menu" }, { children: (0, jsx_runtime_1.jsx)(components_react_1.MediaDeviceMenu, { initialSelection: audioDeviceId, kind: "audioinput", disabled: !audioTrack || !canUseAudio || !audioEnabled, tracks: { audioinput: audioTrack }, onActiveDeviceChange: (_, id) => setAudioDeviceId(id) }) }))] })), (0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-button-group video" }, { children: [(0, jsx_runtime_1.jsx)(TrackToggle_1.TrackToggle, Object.assign({ disabled: !canUseVideo, initialState: videoEnabled, source: livekit_client_1.Track.Source.Camera, onChange: (enabled) => setVideoEnabled(enabled) }, { children: camLabel })), (0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-button-group-menu" }, { children: (0, jsx_runtime_1.jsx)(components_react_1.MediaDeviceMenu, { initialSelection: videoDeviceId, kind: "videoinput", disabled: !videoTrack || !canUseVideo || !videoEnabled, tracks: { videoinput: videoTrack }, onActiveDeviceChange: (_, id) => setVideoDeviceId(id) }) }))] }))] })), (0, jsx_runtime_1.jsx)("form", Object.assign({ className: "lk-username-container" }, { children: (0, jsx_runtime_1.jsx)("button", Object.assign({ className: "lk-button lk-join-button", type: "submit", onClick: handleSubmit, disabled: !isValid || error }, { children: joinLabel })) })), debug && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("strong", { children: "User Choices:" }), (0, jsx_runtime_1.jsxs)("ul", Object.assign({ className: "lk-list", style: { overflow: 'hidden', maxWidth: '15rem' } }, { children: [(0, jsx_runtime_1.jsxs)("li", { children: ["Username: ", `${userChoices.username}`] }), (0, jsx_runtime_1.jsxs)("li", { children: ["Video Enabled: ", `${userChoices.videoEnabled}`] }), (0, jsx_runtime_1.jsxs)("li", { children: ["Audio Enabled: ", `${userChoices.audioEnabled}`] }), (0, jsx_runtime_1.jsxs)("li", { children: ["Video Device: ", `${userChoices.videoDeviceId}`] }), (0, jsx_runtime_1.jsxs)("li", { children: ["Audio Device: ", `${userChoices.audioDeviceId}`] })] }))] }))] })));
+}
+exports.PreJoin = PreJoin;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/RecordingIndicator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * RecordingIndicator
+ * @alpha
+ */
+export default function RecordingIndicator(): JSX.Element;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/RecordingIndicator.js

@@ -0,0 +1,32 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const components_react_1 = require("@livekit/components-react");
+const react_1 = require("react");
+/**
+ * RecordingIndicator
+ * @alpha
+ */
+function RecordingIndicator() {
+    const isRecording = (0, components_react_1.useIsRecording)();
+    const [wasRecording, setWasRecording] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        if (isRecording !== wasRecording) {
+            setWasRecording(isRecording);
+            if (isRecording) {
+                window.alert('This meeting is being recorded');
+            }
+        }
+    }, [isRecording]);
+    return ((0, jsx_runtime_1.jsx)("div", { style: {
+            position: 'absolute',
+            top: '0',
+            left: '0',
+            width: '100%',
+            height: '100%',
+            boxShadow: isRecording ? 'red 0px 0px 0px 3px inset' : 'none',
+            pointerEvents: 'none'
+        } }));
+}
+exports.default = RecordingIndicator;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/SettingsMenuToggle.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+export interface UseSettingsToggleProps {
+    props: React.ButtonHTMLAttributes<HTMLButtonElement>;
+}
+/**
+ * The `useSettingsToggle` hook provides state and functions for toggling the settings menu.
+ */
+export declare function useSettingsToggle({ props }: UseSettingsToggleProps): {
+    mergedProps: React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        className: string;
+        onClick: () => void;
+        'aria-pressed': string;
+    };
+};
+export declare type SettingsMenuToggleProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+/**
+ * The `SettingsMenuToggle` component is a button that toggles the visibility of the `SettingsMenu` component.
+ */
+export declare const SettingsMenuToggle: (props: SettingsMenuToggleProps & React.RefAttributes<HTMLButtonElement>) => React.ReactNode;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/SettingsMenuToggle.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsMenuToggle = exports.useSettingsToggle = void 0;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = tslib_1.__importStar(require("react"));
+const utils_1 = require("./utils");
+const components_react_1 = require("@livekit/components-react");
+/**
+ * The `useSettingsToggle` hook provides state and functions for toggling the settings menu.
+ */
+function useSettingsToggle({ props }) {
+    const { dispatch, state } = (0, components_react_1.useLayoutContext)().widget;
+    const className = 'lk-button lk-settings-toggle';
+    const mergedProps = React.useMemo(() => {
+        return (0, utils_1.mergePropsReactAria)(props, {
+            className,
+            onClick: () => {
+                if (dispatch)
+                    dispatch({ msg: 'toggle_settings' });
+            },
+            'aria-pressed': (state === null || state === void 0 ? void 0 : state.showSettings) ? 'true' : 'false'
+        });
+    }, [props, className, dispatch, state]);
+    return { mergedProps };
+}
+exports.useSettingsToggle = useSettingsToggle;
+/**
+ * The `SettingsMenuToggle` component is a button that toggles the visibility of the `SettingsMenu` component.
+ */
+exports.SettingsMenuToggle = 
+/* @__PURE__ */ React.forwardRef(function SettingsMenuToggle(props, ref) {
+    const { mergedProps } = useSettingsToggle({ props });
+    return ((0, jsx_runtime_1.jsx)("button", Object.assign({ ref: ref }, mergedProps, { children: props.children })));
+});

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/TrackToggle.d.ts

@@ -0,0 +1,23 @@
+import type { CaptureOptionsBySource, ToggleSource } from '@livekit/components-core';
+import * as React from 'react';
+import { Track, TrackPublishOptions } from 'livekit-client';
+export declare function getSourceIcon(source: Track.Source, enabled: boolean): JSX.Element;
+export interface TrackToggleProps<T extends ToggleSource> extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    source: T;
+    showIcon?: boolean;
+    initialState?: boolean;
+    disabled?: boolean;
+    /**
+     * Function that is called when the enabled state of the toggle changes.
+     * The second function argument `isUserInitiated` is `true` if the change was initiated by a user interaction, such as a click.
+     */
+    onChange?: (enabled: boolean, isUserInitiated: boolean) => void;
+    captureOptions?: CaptureOptionsBySource<T>;
+    publishOptions?: TrackPublishOptions;
+    onDeviceError?: (error: Error) => void;
+}
+/**
+ * With the `TrackToggle` component it is possible to mute and unmute your camera and microphone.
+ * The component uses an html button element under the hood so you can treat it like a button.
+ */
+export declare const TrackToggle: <T extends ToggleSource>(props: TrackToggleProps<T> & React.RefAttributes<HTMLButtonElement>) => React.ReactNode;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/TrackToggle.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackToggle = exports.getSourceIcon = void 0;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = tslib_1.__importStar(require("react"));
+const livekit_client_1 = require("livekit-client");
+const components_react_1 = require("@livekit/components-react");
+function getSourceIcon(source, enabled) {
+    switch (source) {
+        case livekit_client_1.Track.Source.Microphone:
+            return enabled ? (0, jsx_runtime_1.jsx)(components_react_1.MicIcon, {}) : (0, jsx_runtime_1.jsx)(components_react_1.MicDisabledIcon, {});
+        case livekit_client_1.Track.Source.Camera:
+            return enabled ? (0, jsx_runtime_1.jsx)(components_react_1.CameraIcon, {}) : (0, jsx_runtime_1.jsx)(components_react_1.CameraDisabledIcon, {});
+        case livekit_client_1.Track.Source.ScreenShare:
+            return enabled ? (0, jsx_runtime_1.jsx)(components_react_1.ScreenShareStopIcon, {}) : (0, jsx_runtime_1.jsx)(components_react_1.ScreenShareIcon, {});
+        default:
+            return undefined;
+    }
+}
+exports.getSourceIcon = getSourceIcon;
+/**
+ * With the `TrackToggle` component it is possible to mute and unmute your camera and microphone.
+ * The component uses an html button element under the hood so you can treat it like a button.
+ */
+exports.TrackToggle = 
+/* @__PURE__ */ React.forwardRef(function TrackToggle(_a, ref) {
+    var { showIcon, disabled } = _a, props = tslib_1.__rest(_a, ["showIcon", "disabled"]);
+    const { buttonProps, enabled } = (0, components_react_1.useTrackToggle)(props);
+    return ((0, jsx_runtime_1.jsxs)("button", Object.assign({ ref: ref }, buttonProps, { disabled: disabled }, { children: [(showIcon !== null && showIcon !== void 0 ? showIcon : true) && getSourceIcon(props.source, enabled && !disabled), props.children] })));
+});

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/VideoConference.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { MessageDecoder, MessageEncoder } from '@livekit/components-core';
+import { MessageFormatter } from '@livekit/components-react';
+import { SCUserType } from '@selfcommunity/types';
+export interface VideoConferenceProps {
+    className?: string;
+    chatMessageFormatter?: MessageFormatter;
+    chatMessageEncoder?: MessageEncoder;
+    chatMessageDecoder?: MessageDecoder;
+    /** @alpha */
+    SettingsComponent?: React.ComponentType;
+    speakerFocused?: SCUserType;
+    disableChat?: boolean;
+    disableMicrophone?: boolean;
+    disableCamera?: boolean;
+    disableShareScreen?: boolean;
+    hideParticipantsList?: boolean;
+    showSettings?: boolean;
+}
+/**
+ * The `VideoConference` ready-made component is your drop-in solution for a classic video conferencing application.
+ * It provides functionality such as focusing on one participant, grid view with pagination to handle large numbers
+ * of participants, basic non-persistent chat, screen sharing, and more.
+ *
+ */
+export declare function VideoConference(inProps: VideoConferenceProps): JSX.Element;

package/lib/cjs/components/LiveStreamRoom/LiveStreamVideoConference/VideoConference.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VideoConference = void 0;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = tslib_1.__importStar(require("react"));
+const components_core_1 = require("@livekit/components-core");
+const livekit_client_1 = require("livekit-client");
+const components_react_1 = require("@livekit/components-react");
+const ParticipantTile_1 = require("./ParticipantTile");
+const ControlBar_1 = require("./ControlBar");
+const react_1 = require("react");
+const useLiveStreamCheck_1 = require("./useLiveStreamCheck");
+const FocusLayout_1 = require("./FocusLayout");
+const react_core_1 = require("@selfcommunity/react-core");
+const classnames_1 = tslib_1.__importDefault(require("classnames"));
+const styles_1 = require("@mui/material/styles");
+const material_1 = require("@mui/material");
+const system_1 = require("@mui/system");
+const NoParticipants_1 = tslib_1.__importDefault(require("./NoParticipants"));
+const PREFIX = 'SCVideoConference';
+const classes = {
+    root: `${PREFIX}-root`
+};
+const Root = (0, styles_1.styled)(material_1.Box, {
+    name: PREFIX,
+    slot: 'Root',
+    overridesResolver: (props, styles) => styles.root
+})(({ theme }) => ({
+    '& .lk-chat': {
+        height: '100%'
+    }
+}));
+/**
+ * The `VideoConference` ready-made component is your drop-in solution for a classic video conferencing application.
+ * It provides functionality such as focusing on one participant, grid view with pagination to handle large numbers
+ * of participants, basic non-persistent chat, screen sharing, and more.
+ *
+ */
+function VideoConference(inProps) {
+    var _a, _b;
+    // PROPS
+    const props = (0, system_1.useThemeProps)({
+        props: inProps,
+        name: PREFIX
+    });
+    const { className, chatMessageFormatter, chatMessageDecoder, chatMessageEncoder, SettingsComponent, speakerFocused, disableChat = false, disableMicrophone = false, disableCamera = false, disableShareScreen = false, hideParticipantsList = false, showSettings } = props, rest = tslib_1.__rest(props, ["className", "chatMessageFormatter", "chatMessageDecoder", "chatMessageEncoder", "SettingsComponent", "speakerFocused", "disableChat", "disableMicrophone", "disableCamera", "disableShareScreen", "hideParticipantsList", "showSettings"]);
+    // STATE
+    const [widgetState, setWidgetState] = React.useState({
+        showChat: false,
+        unreadMessages: 0,
+        showSettings: showSettings || false
+    });
+    const [focusInitialized, setFocusInitialized] = React.useState(false);
+    const lastAutoFocusedScreenShareTrack = React.useRef(null);
+    // HOOKS
+    const scUserContext = (0, react_core_1.useSCUser)();
+    const tracks = (0, components_react_1.useTracks)([
+        { source: livekit_client_1.Track.Source.Camera, withPlaceholder: true },
+        { source: livekit_client_1.Track.Source.ScreenShare, withPlaceholder: false }
+    ], { updateOnlyOn: [livekit_client_1.RoomEvent.ActiveSpeakersChanged], onlySubscribed: false });
+    const tracksNoParticipants = (0, react_1.useMemo)(() => tracks.filter((t) => t.participant.name === scUserContext.user.username || t.source === 'screen_share'), [tracks, scUserContext.user]);
+    const participants = (0, components_react_1.useParticipants)();
+    const layoutContext = (0, components_react_1.useCreateLayoutContext)();
+    const screenShareTracks = tracks.filter(components_core_1.isTrackReference).filter((track) => track.publication.source === livekit_client_1.Track.Source.ScreenShare);
+    const focusTrack = (_a = (0, components_react_1.usePinnedTracks)(layoutContext)) === null || _a === void 0 ? void 0 : _a[0];
+    const carouselTracks = tracks.filter((track) => !(0, components_core_1.isEqualTrackRef)(track, focusTrack));
+    (0, useLiveStreamCheck_1.useLivestreamCheck)();
+    /**
+     * widgetUpdate
+     * @param state
+     */
+    const widgetUpdate = (state) => {
+        components_core_1.log.debug('updating widget state', state);
+        setWidgetState(state);
+    };
+    /**
+     * handleFocusStateChange
+     * @param state
+     */
+    const handleFocusStateChange = (state) => {
+        var _a, _b;
+        components_core_1.log.debug('updating widget state', state);
+        if (state && state.participant) {
+            const updatedFocusTrack = tracks.find((tr) => tr.participant.identity === state.participant.identity);
+            if (updatedFocusTrack) {
+                (_b = (_a = layoutContext.pin).dispatch) === null || _b === void 0 ? void 0 : _b.call(_a, { msg: 'set_pin', trackReference: updatedFocusTrack });
+            }
+        }
+    };
+    (0, react_1.useEffect)(() => {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        // If screen share tracks are published, and no pin is set explicitly, auto set the screen share.
+        if (screenShareTracks.some((track) => track.publication.isSubscribed) && lastAutoFocusedScreenShareTrack.current === null) {
+            components_core_1.log.debug('Auto set screen share focus:', { newScreenShareTrack: screenShareTracks[0] });
+            (_b = (_a = layoutContext.pin).dispatch) === null || _b === void 0 ? void 0 : _b.call(_a, { msg: 'set_pin', trackReference: screenShareTracks[0] });
+            lastAutoFocusedScreenShareTrack.current = screenShareTracks[0];
+        }
+        else if (lastAutoFocusedScreenShareTrack.current &&
+            !screenShareTracks.some((track) => { var _a, _b; return track.publication.trackSid === ((_b = (_a = lastAutoFocusedScreenShareTrack.current) === null || _a === void 0 ? void 0 : _a.publication) === null || _b === void 0 ? void 0 : _b.trackSid); })) {
+            components_core_1.log.debug('Auto clearing screen share focus.');
+            (_d = (_c = layoutContext.pin).dispatch) === null || _d === void 0 ? void 0 : _d.call(_c, { msg: 'clear_pin' });
+            lastAutoFocusedScreenShareTrack.current = null;
+        }
+        if (focusTrack) {
+            let updatedFocusTrack;
+            const isFocusTrackParticipantExist = participants.find((pt) => pt.identity === focusTrack.participant.identity);
+            if (!isFocusTrackParticipantExist) {
+                // Focus track is relative to a participant that has left the room
+                updatedFocusTrack = tracks.find((tr) => tr.participant.identity === scUserContext.user.id.toString());
+                (_f = (_e = layoutContext.pin).dispatch) === null || _f === void 0 ? void 0 : _f.call(_e, { msg: 'set_pin', trackReference: updatedFocusTrack });
+            }
+            else if (!(0, components_core_1.isTrackReference)(focusTrack)) {
+                // You are not subscribet to the track
+                updatedFocusTrack = tracks.find((tr) => tr.participant.identity === focusTrack.participant.identity && tr.source === focusTrack.source);
+                if (updatedFocusTrack !== focusTrack && (0, components_core_1.isTrackReference)(updatedFocusTrack)) {
+                    (_h = (_g = layoutContext.pin).dispatch) === null || _h === void 0 ? void 0 : _h.call(_g, { msg: 'set_pin', trackReference: updatedFocusTrack });
+                }
+            }
+        }
+    }, [
+        screenShareTracks.map((ref) => `${ref.publication.trackSid}_${ref.publication.isSubscribed}`).join(),
+        (_b = focusTrack === null || focusTrack === void 0 ? void 0 : focusTrack.publication) === null || _b === void 0 ? void 0 : _b.trackSid,
+        tracks,
+        participants,
+        speakerFocused
+    ]);
+    (0, react_1.useEffect)(() => {
+        var _a, _b;
+        if (speakerFocused && !focusInitialized) {
+            const speaker = participants.find((pt) => {
+                return pt.name === speakerFocused.username;
+            });
+            if (speaker) {
+                const updatedFocusTrack = tracks.find((tr) => {
+                    if (tr) {
+                        return tr.participant.identity === speaker.identity;
+                    }
+                    return false;
+                });
+                (_b = (_a = layoutContext.pin).dispatch) === null || _b === void 0 ? void 0 : _b.call(_a, { msg: 'set_pin', trackReference: updatedFocusTrack });
+                setFocusInitialized(true);
+            }
+        }
+    }, [tracks, participants, speakerFocused]);
+    return ((0, jsx_runtime_1.jsxs)(Root, Object.assign({ className: (0, classnames_1.default)(className, classes.root, 'lk-video-conference') }, rest, { children: [(0, components_core_1.isWeb)() && ((0, jsx_runtime_1.jsxs)(components_react_1.LayoutContextProvider, Object.assign({ value: layoutContext, onPinChange: handleFocusStateChange, onWidgetChange: widgetUpdate }, { children: [(0, jsx_runtime_1.jsxs)("div", Object.assign({ className: "lk-video-conference-inner" }, { children: [!focusTrack ? ((0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-grid-layout-wrapper" }, { children: (0, jsx_runtime_1.jsx)(components_react_1.GridLayout, Object.assign({ tracks: hideParticipantsList ? tracksNoParticipants : tracks }, { children: (0, jsx_runtime_1.jsx)(ParticipantTile_1.ParticipantTile, {}) })) }))) : ((0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-focus-layout-wrapper" }, { children: hideParticipantsList ? ((0, jsx_runtime_1.jsx)(FocusLayout_1.FocusLayoutContainerNoParticipants, { children: focusTrack && (0, jsx_runtime_1.jsx)(FocusLayout_1.FocusLayout, { trackRef: focusTrack, disableTileFocusToggle: Boolean(tracksNoParticipants.length <= 1) }) })) : ((0, jsx_runtime_1.jsxs)(FocusLayout_1.FocusLayoutContainer, { children: [carouselTracks.length > 1 ? ((0, jsx_runtime_1.jsx)(components_react_1.CarouselLayout, Object.assign({ tracks: carouselTracks }, { children: (0, jsx_runtime_1.jsx)(ParticipantTile_1.ParticipantTile, {}) }))) : ((0, jsx_runtime_1.jsx)(NoParticipants_1.default, {})), focusTrack && (0, jsx_runtime_1.jsx)(FocusLayout_1.FocusLayout, { trackRef: focusTrack })] })) }))), (0, jsx_runtime_1.jsx)(ControlBar_1.ControlBar, { controls: Object.assign({
+                                    chat: !disableChat,
+                                    microphone: !disableMicrophone,
+                                    camera: !disableCamera,
+                                    screenShare: !disableShareScreen
+                                }, { settings: !!SettingsComponent }) })] })), !disableChat && ((0, jsx_runtime_1.jsx)(components_react_1.Chat, { style: { display: widgetState.showChat ? 'grid' : 'none' }, messageFormatter: chatMessageFormatter, messageEncoder: chatMessageEncoder, messageDecoder: chatMessageDecoder })), SettingsComponent && ((0, jsx_runtime_1.jsx)("div", Object.assign({ className: "lk-settings-menu-modal", style: { display: widgetState.showSettings ? 'block' : 'none' } }, { children: (0, jsx_runtime_1.jsx)(SettingsComponent, {}) })))] }))), (0, jsx_runtime_1.jsx)(components_react_1.RoomAudioRenderer, {}), (0, jsx_runtime_1.jsx)(components_react_1.ConnectionStateToast, {})] })));
+}
+exports.VideoConference = VideoConference;