@livekit/components-js-docs 0.1.0 → 0.1.2

package/generated-docs/react/hook/usetrackrefcontext.md

@@ -1,3 +1,10 @@
+---
+{
+  "title": "useTrackRefContext",
+  "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/context/track-reference-context.ts"
+}
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
 # useTrackRefContext
@@ -7,7 +14,7 @@ Ensures that a track reference is provided via context. If not inside a `TrackRe
 ## Import
 
 ```typescript
-import { useTrackRefContext } from '@livekit/components-react';
+import { useTrackRefContext } from "@livekit/components-react";
 ```
 
 {% partial file="p_usage.md" variables={exampleCount: 0} /%}

package/generated-docs/react/hook/usetracks.md

@@ -1,3 +1,10 @@
+---
+{
+  "title": "useTracks",
+  "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useTracks.ts"
+}
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
 # useTracks
@@ -7,7 +14,7 @@ The `useTracks` hook returns an array of `TrackReference` or `TrackReferenceOrPl
 ## Import
 
 ```typescript
-import { useTracks } from '@livekit/components-react';
+import { useTracks } from "@livekit/components-react";
 ```
 
 ## Usage Example 1
@@ -23,13 +30,13 @@ const trackReferences: TrackReference[] = useTracks([Track.Source.Camera]);
 // Return all subscribed camera tracks as well as placeholders for
 // participants without a camera subscription.
 const trackReferencesWithPlaceholders: TrackReferenceOrPlaceholder[] = useTracks([
-  { source: Track.Source.Camera, withPlaceholder: true },
+  { source: Track.Source.Camera, withPlaceholder: true }
 ]);
 ```
 
 {% partial file="p_usage.md" variables={exampleCount: 2} /%}
 
-## Parameters
+## Properties
 
 {% parameter name="options" type="UseTracksOptions" optional=true %}
 {% /parameter %}

package/generated-docs/react/hook/usetracktoggle.md

@@ -1,3 +1,10 @@
+---
+{
+  "title": "useTrackToggle",
+  "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useTrackToggle.ts"
+}
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
 # useTrackToggle
@@ -7,23 +14,18 @@ The `useTrackToggle` hook is used to implement the `TrackToggle` component and r
 ## Import
 
 ```typescript
-import { useTrackToggle } from '@livekit/components-react';
+import { useTrackToggle } from "@livekit/components-react";
 ```
 
 ## Usage
 
 ```tsx
 const { buttonProps, enabled } = useTrackToggle(trackRef);
-return <button {...buttonProps}>{enabled ? 'disable' : 'enable'}</button>;
+return <button {...buttonProps}>{enabled ? "disable" : "enable"}</button>;
 ```
 
 {% partial file="p_usage.md" variables={exampleCount: 1} /%}
 
-## Parameters
-
-{% parameter name="{ source, onChange, initialState, captureOptions, ...rest }" type="UseTrackToggleProps<T>" optional=false %}
-{% /parameter %}
-
 ## Returns
 
 ```typescript

package/generated-docs/react/hook/usevisualstableupdate.md

@@ -1,18 +1,25 @@
+---
+{
+  "title": "useVisualStableUpdate",
+  "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useVisualStableUpdate.ts"
+}
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
 # useVisualStableUpdate
 
-The `useVisualStableUpdate` hook is used to prevent visually jarring jumps and shifts of elements in an array. The algorithm only starts to update when there are more items than visually fit on a page. If this is the case, it will make sure that speaking participants move to the first page and are always visible. Updating the array can occur because attendees leave or join a room, or because they mute/unmute or start speaking.
+The `useVisualStableUpdate` hook is used to prevent visually jarring jumps and shifts of elements in an array. The algorithm only starts to update when there are more items than visually fit on a page. If this is the case, it will make sure that speaking participants move to the first page and are always visible.
 
 ## Import
 
 ```typescript
-import { useVisualStableUpdate } from '@livekit/components-react';
+import { useVisualStableUpdate } from "@livekit/components-react";
 ```
 
 ## Remarks
 
-The hook is used for the `GridLayout` and `CarouselLayout` components.
+Updating the array can occur because attendees leave or join a room, or because they mute/unmute or start speaking. The hook is used for the `GridLayout` and `CarouselLayout` components.
 
 ## Usage
 
@@ -23,7 +30,7 @@ const updatedTrackRefs = useVisualStableUpdate(trackRefs, itemPerPage);
 
 {% partial file="p_usage.md" variables={exampleCount: 1} /%}
 
-## Parameters
+## Properties
 
 {% parameter name="maxItemsOnPage" type="number" optional=false %}
 {% /parameter %}

package/generated-docs/react/index.md

@@ -1,6 +1,10 @@
+---
+{ "title": "components-react package" }
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
-## components-react package
+# components-react package
 
 ## Components
 
@@ -20,6 +24,7 @@
 | [FocusLayoutContainer(props)](./react/component/focuslayoutcontainer.md)                                                                                                                                | The <code>FocusLayoutContainer</code> is a layout component that expects two children: A small side component: In a video conference, this is usually a carousel of participants who are not in focus. And a larger main component to display the focused participant. For example, with the <code>FocusLayout</code> component. |
 | [FocusToggle({ trackRef, trackSource, participant, ...props })](./react/component/focustoggle.md)                                                                                                       | The <code>FocusToggle</code> puts the <code>ParticipantTile</code> in focus or removes it from focus.                                                                                                                                                                                                                            |
 | [GridLayout({ tracks, ...props })](./react/component/gridlayout.md)                                                                                                                                     | The <code>GridLayout</code> component displays the nested participants in a grid where every participants has the same size. It also supports pagination if there are more participants than the grid can display.                                                                                                               |
+| [LayoutContextProvider({ value, onPinChange, onWidgetChange, children, })](./react/component/layoutcontextprovider.md)                                                                                  |                                                                                                                                                                                                                                                                                                                                  |
 | [LiveKitRoom(props)](./react/component/livekitroom.md)                                                                                                                                                  | The <code>LiveKitRoom</code> component provides the room context to all its child components. It is generally the starting point of your LiveKit app and the root of the LiveKit component tree. It provides the room state as a React context to all child components, so you don't have to pass it yourself.                   |
 | [MediaDeviceSelect({ kind, initialSelection, onActiveDeviceChange, onDeviceListChange, onDeviceSelectError, exactMatch, track, requestPermissions, ...props })](./react/component/mediadeviceselect.md) | The <code>MediaDeviceSelect</code> list all media devices of one kind. Clicking on one of the listed devices make it the active media device.                                                                                                                                                                                    |
 | [ParticipantAudioTile({ participant, children, source, publication, disableSpeakingIndicator, onParticipantClick, ...htmlProps })](./react/component/participantaudiotile.md)                           | The <code>ParticipantAudioTile</code> component is the base utility wrapper for displaying a visual representation of a participant. This component can be used as a child of the <code>TileLoop</code> or independently if a participant is passed as a property.                                                               |
@@ -27,7 +32,7 @@
 | [ParticipantLoop({ participants, ...props })](./react/component/participantloop.md)                                                                                                                     | The <code>ParticipantLoop</code> component loops over an array of participants to create a context for every participant. This component takes exactly one child component as a template. By providing your own template as a child you have full control over the look and feel of your participant representations.            |
 | [ParticipantName({ participant, ...props })](./react/component/participantname.md)                                                                                                                      | The <code>ParticipantName</code> component displays the name of the participant as a string within an HTML span element. If no participant name is undefined the participant identity string is displayed.                                                                                                                       |
 | [ParticipantTile({ trackRef, participant, children, source, onParticipantClick, publication, disableSpeakingIndicator, ...htmlProps })](./react/component/participanttile.md)                           | The <code>ParticipantTile</code> component is the base utility wrapper for displaying a visual representation of a participant. This component can be used as a child of the <code>TrackLoop</code> component or by passing a track reference as property.                                                                       |
-| [RoomAudioRenderer()](./react/component/roomaudiorenderer.md)                                                                                                                                           | The <code>RoomAudioRenderer</code> component is a drop-in solution for adding audio to your LiveKit app. It takes care of handling remote participants’ audio tracks and makes sure that microphones and screen share are audible.                                                                                               |
+| [RoomAudioRenderer({ volume, muted })](./react/component/roomaudiorenderer.md)                                                                                                                          | The <code>RoomAudioRenderer</code> component is a drop-in solution for adding audio to your LiveKit app. It takes care of handling remote participants’ audio tracks and makes sure that microphones and screen share are audible.                                                                                               |
 | [RoomName({ childrenPosition, children, ...htmlAttributes })](./react/component/roomname.md)                                                                                                            | The <code>RoomName</code> component renders the name of the connected LiveKit room inside a span tag.                                                                                                                                                                                                                            |
 | [StartAudio({ label, ...props })](./react/component/startaudio.md)                                                                                                                                      | The <code>StartAudio</code> component is only visible when the browser blocks audio playback. This is due to some browser implemented autoplay policies. To start audio playback, the user must perform a user-initiated event such as clicking this button. As soon as audio playback starts, the button hides itself again.    |
 | [Toast(props)](./react/component/toast.md)                                                                                                                                                              | The <code>Toast</code> component is a rudimentary way to display a message to the user. This message should be short lived and not require user interaction. For example, displaying the current connection state like <code>ConnectionStateToast</code> does.                                                                   |
@@ -38,75 +43,82 @@
 
 ## Prefabs
 
-| Prefab                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                         |
-| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [AudioConference({ ...props })](./react/component/audioconference.md)                                                                                                | This component is the default setup of a classic LiveKit audio conferencing app. It provides functionality like switching between participant grid view and focus view.                                                                                                                                                                                                             |
-| [Chat({ messageFormatter, messageDecoder, messageEncoder, ...props })](./react/component/chat.md)                                                                    | The Chat component adds a basis chat functionality to the LiveKit room. The messages are distributed to all participants in the room. Only users who are in the room at the time of dispatch will receive the message.                                                                                                                                                              |
-| [ControlBar({ variation, controls, ...props })](./react/component/controlbar.md)                                                                                     | The <code>ControlBar</code> prefab gives the user the basic user interface to control their media devices (camera, microphone and screen share), open the <code>Chat</code> and leave the room.                                                                                                                                                                                     |
-| [MediaDeviceMenu({ kind, initialSelection, onActiveDeviceChange, tracks, requestPermissions, ...props })](./react/component/mediadevicemenu.md)                      | The <code>MediaDeviceMenu</code> component is a button that opens a menu that lists all media devices and allows the user to select them.                                                                                                                                                                                                                                           |
-| [PreJoin({ defaults, onValidate, onSubmit, onError, debug, joinLabel, micLabel, camLabel, userLabel, showE2EEOptions, ...htmlProps })](./react/component/prejoin.md) | The <code>PreJoin</code> 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 <code>LiveKitRoom</code> so that the user enters the room with the correct media devices. |
-| [VideoConference({ chatMessageFormatter, chatMessageDecoder, chatMessageEncoder, ...props })](./react/component/videoconference.md)                                  | The <code>VideoConference</code> 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.                                                                 |
+| Prefab                                                                                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                         |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [AudioConference({ ...props })](./react/component/audioconference.md)                                                                                                                    | This component is the default setup of a classic LiveKit audio conferencing app. It provides functionality like switching between participant grid view and focus view.                                                                                                                                                                                                             |
+| [Chat({ messageFormatter, messageDecoder, messageEncoder, ...props })](./react/component/chat.md)                                                                                        | The Chat component adds a basis chat functionality to the LiveKit room. The messages are distributed to all participants in the room. Only users who are in the room at the time of dispatch will receive the message.                                                                                                                                                              |
+| [ControlBar({ variation, controls, saveUserChoices, ...props })](./react/component/controlbar.md)                                                                                        | The <code>ControlBar</code> prefab gives the user the basic user interface to control their media devices (camera, microphone and screen share), open the <code>Chat</code> and leave the room.                                                                                                                                                                                     |
+| [MediaDeviceMenu({ kind, initialSelection, onActiveDeviceChange, tracks, requestPermissions, ...props })](./react/component/mediadevicemenu.md)                                          | The <code>MediaDeviceMenu</code> component is a button that opens a menu that lists all media devices and allows the user to select them.                                                                                                                                                                                                                                           |
+| [PreJoin({ defaults, onValidate, onSubmit, onError, debug, joinLabel, micLabel, camLabel, userLabel, showE2EEOptions, persistUserChoices, ...htmlProps })](./react/component/prejoin.md) | The <code>PreJoin</code> 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 <code>LiveKitRoom</code> so that the user enters the room with the correct media devices. |
+| [VideoConference({ chatMessageFormatter, chatMessageDecoder, chatMessageEncoder, ...props })](./react/component/videoconference.md)                                                      | The <code>VideoConference</code> 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.                                                                 |
 
 ## Hooks
 
-| Hook                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [useChat(options)](./react/hook/usechat.md)                                                                                                                        | The <code>useChat</code> hook provides chat functionality for a LiveKit room. It returns a simple <code>send</code> function to send chat messages and an array of <code>chatMessages</code> to hold received messages.                                                                                                                                                                                                                                   |
-| [useChatToggle({ props })](./react/hook/usechattoggle.md)                                                                                                          | The <code>useChatToggle</code> hook provides state and functions for toggling the chat window.                                                                                                                                                                                                                                                                                                                                                            |
-| [useClearPinButton(props)](./react/hook/useclearpinbutton.md)                                                                                                      | The <code>useClearPinButton</code> hook provides props for the [ClearPinButton()](./react/component/clearpinbutton.md) or your custom implementation of it component. It adds the <code>onClick</code> handler to signal the <code>LayoutContext</code> that the tile in focus should be cleared.                                                                                                                                                         |
-| [useConnectionQualityIndicator(options)](./react/hook/useconnectionqualityindicator.md)                                                                            | The <code>useConnectionQualityIndicator</code> hook provides props for the <code>ConnectionQualityIndicator</code> or your custom implementation of it component.                                                                                                                                                                                                                                                                                         |
-| [useConnectionState(room)](./react/hook/useconnectionstate.md)                                                                                                     | The <code>useConnectionState</code> hook allows you to simply implement your own <code>ConnectionState</code> component.                                                                                                                                                                                                                                                                                                                                  |
-| [useCreateLayoutContext()](./react/hook/usecreatelayoutcontext.md)                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useDataChannel(topic, onMessage)](./react/hook/usedatachannel.md)                                                                                                 | The <code>useDataChannel</code> hook returns the ability to send and receive messages. By optionally passing a <code>topic</code>, you can narrow down which messages are returned in the messages array.                                                                                                                                                                                                                                                 |
-| [useDataChannel(onMessage)](./react/hook/usedatachannel_1.md)                                                                                                      | The <code>useDataChannel</code> hook returns the ability to send and receive messages.                                                                                                                                                                                                                                                                                                                                                                    |
-| [useDisconnectButton(props)](./react/hook/usedisconnectbutton.md)                                                                                                  | The <code>useDisconnectButton</code> hook is used to implement the <code>DisconnectButton</code> or your custom implementation of it. It adds onClick handler to the button to disconnect from the room.                                                                                                                                                                                                                                                  |
-| [useEnsureCreateLayoutContext(layoutContext)](./react/hook/useensurecreatelayoutcontext.md)                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useEnsureLayoutContext(layoutContext)](./react/hook/useensurelayoutcontext.md)                                                                                    | Ensures that a layout context is provided, either via context or explicitly as a parameter. If not inside a <code>LayoutContext</code> and no layout context is provided, an error is thrown.                                                                                                                                                                                                                                                             |
-| [useEnsureParticipant(participant)](./react/hook/useensureparticipant.md)                                                                                          | Ensures that a participant is provided, either via context or explicitly as a parameter. If not inside a <code>ParticipantContext</code> and no participant is provided, an error is thrown.                                                                                                                                                                                                                                                              |
-| [useEnsureRoom(room)](./react/hook/useensureroom.md)                                                                                                               | Ensures that a room is provided, either via context or explicitly as a parameter. If no room is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                             |
-| [useEnsureTrackRef(trackRef)](./react/hook/useensuretrackref.md)                                                                                                   | Ensures that a track reference is provided, either via context or explicitly as a parameter. If not inside a <code>TrackRefContext</code> and no track reference is provided, an error is thrown.                                                                                                                                                                                                                                                         |
-| [useEnsureTrackReference(track)](./react/hook/useensuretrackreference.md)                                                                                          | Ensures that a track reference is provided, either via context or explicitly as a parameter. If not inside a <code>TrackContext</code> and no track reference is provided, an error is thrown.                                                                                                                                                                                                                                                            |
-| [useFocusToggle({ trackRef, trackSource, participant, props })](./react/hook/usefocustoggle.md)                                                                    | The <code>useFocusToggle</code> hook is used to implement the <code>FocusToggle</code> or your custom implementation of it. The <code>TrackReferenceOrPlaceholder</code> is used to register a onClick handler and to identify the track to focus on.                                                                                                                                                                                                     |
-| [useGridLayout(gridElement, trackCount)](./react/hook/usegridlayout.md)                                                                                            | The <code>useGridLayout</code> hook tries to select the best layout to fit all tiles. If the available screen space is not enough, it will reduce the number of maximum visible tiles and select a layout that still works visually within the given limitations. As the order of tiles changes over time, the hook tries to keep visual updates to a minimum while trying to display important tiles such as speaking participants or screen shares.     |
-| [useIsMuted(trackRef)](./react/hook/useismuted.md)                                                                                                                 | The <code>useIsMuted</code> hook is used to implement the <code>TrackMutedIndicator</code> or your custom implementation of it. It returns a <code>boolean</code> that indicates if the track is muted or not.                                                                                                                                                                                                                                            |
-| [useIsMuted(source, options)](./react/hook/useismuted_1.md)                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useIsSpeaking(participant)](./react/hook/useisspeaking.md)                                                                                                        | The <code>useIsSpeaking</code> hook returns a <code>boolean</code> that indicates if the participant is speaking or not.                                                                                                                                                                                                                                                                                                                                  |
-| [useLayoutContext()](./react/hook/uselayoutcontext.md)                                                                                                             | Ensures that a layout context is provided via context. If no layout context is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                                              |
-| [useLiveKitRoom(props)](./react/hook/uselivekitroom.md)                                                                                                            | The <code>useLiveKitRoom</code> hook is used to implement the <code>LiveKitRoom</code> or your custom implementation of it. It returns a <code>Room</code> instance and HTML props that should be applied to the root element of the component.                                                                                                                                                                                                           |
-| [useLocalParticipant(options)](./react/hook/uselocalparticipant.md)                                                                                                | The <code>useLocalParticipant</code> hook returns the local participant and the associated state around the participant.                                                                                                                                                                                                                                                                                                                                  |
-| [useLocalParticipantPermissions()](./react/hook/uselocalparticipantpermissions.md)                                                                                 | The <code>useLocalParticipantPermissions</code> hook returns the local participant's permissions.                                                                                                                                                                                                                                                                                                                                                         |
-| [useMaybeLayoutContext()](./react/hook/usemaybelayoutcontext.md)                                                                                                   | Returns a layout context from the <code>LayoutContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                              |
-| [useMaybeParticipantContext()](./react/hook/usemaybeparticipantcontext.md)                                                                                         | Returns a participant from the <code>ParticipantContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                            |
-| [useMaybeRoomContext()](./react/hook/usemayberoomcontext.md)                                                                                                       | Returns the room context if it exists, otherwise undefined.                                                                                                                                                                                                                                                                                                                                                                                               |
-| [useMaybeTrackContext()](./react/hook/usemaybetrackcontext.md)                                                                                                     | Returns a track reference from the <code>TrackContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                              |
-| [useMaybeTrackRefContext()](./react/hook/usemaybetrackrefcontext.md)                                                                                               | Returns a track reference from the <code>TrackRefContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                           |
-| [useMediaDevices({ kind })](./react/hook/usemediadevices.md)                                                                                                       | The <code>useMediaDevices</code> hook returns the list of media devices of a given kind.                                                                                                                                                                                                                                                                                                                                                                  |
-| [useMediaDeviceSelect({ kind, room, track, requestPermissions, })](./react/hook/usemediadeviceselect.md)                                                           | The <code>useMediaDeviceSelect</code> hook is used to implement the <code>MediaDeviceSelect</code> component and returns o.a. the list of devices of a given kind (audioinput or videoinput), the currently active device and a function to set the the active device.                                                                                                                                                                                    |
-| [useMediaTrack(source, participant, options)](./react/hook/usemediatrack.md)                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useMediaTrackByName(name, participant, options)](./react/hook/usemediatrackbyname.md)                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useParticipantContext()](./react/hook/useparticipantcontext.md)                                                                                                   | Ensures that a participant is provided via context. If not inside a <code>ParticipantContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                  |
-| [useParticipantInfo(props)](./react/hook/useparticipantinfo.md)                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useParticipantPermissions(options)](./react/hook/useparticipantpermissions.md)                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useParticipants(options)](./react/hook/useparticipants.md)                                                                                                        | The <code>useParticipants</code> hook returns all participants (local and remote) of the current room.                                                                                                                                                                                                                                                                                                                                                    |
-| [useParticipantTile({ trackRef, participant, source, publication, onParticipantClick, disableSpeakingIndicator, htmlProps, })](./react/hook/useparticipanttile.md) | The <code>useParticipantTile</code> hook is used to implement the <code>ParticipantTile</code> and returns the props needed to render the tile.                                                                                                                                                                                                                                                                                                           |
-| [usePinnedTracks(layoutContext)](./react/hook/usepinnedtracks.md)                                                                                                  | The <code>usePinnedTracks</code> hook returns a array of the pinned tracks of the current room.                                                                                                                                                                                                                                                                                                                                                           |
-| [usePreviewDevice(enabled, deviceId, kind)](./react/hook/usepreviewdevice.md)                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useRemoteParticipant(identity, options)](./react/hook/useremoteparticipant.md)                                                                                    | The <code>useRemoteParticipant</code> hook returns the RemoteParticipant with the given <code>identity</code>.                                                                                                                                                                                                                                                                                                                                            |
-| [useRemoteParticipants(options)](./react/hook/useremoteparticipants.md)                                                                                            | The <code>useRemoteParticipants</code> hook returns all remote participants (without the local) of the current room.                                                                                                                                                                                                                                                                                                                                      |
-| [useRoomContext()](./react/hook/useroomcontext.md)                                                                                                                 | Ensures that a room is provided via context. If no room is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                                                                  |
-| [useRoomInfo(options)](./react/hook/useroominfo.md)                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useSortedParticipants(participants)](./react/hook/usesortedparticipants.md)                                                                                       | The <code>useSortedParticipants</code> hook returns the participants sorted by importance.                                                                                                                                                                                                                                                                                                                                                                |
-| [useSpeakingParticipants()](./react/hook/usespeakingparticipants.md)                                                                                               | The <code>useSpeakingParticipants</code> hook returns the only the active speakers of all participants.                                                                                                                                                                                                                                                                                                                                                   |
-| [useToken(tokenEndpoint, roomName, options)](./react/hook/usetoken.md)                                                                                             | The <code>useToken</code> hook fetches a token from the given token endpoint with the given user info.                                                                                                                                                                                                                                                                                                                                                    |
-| [useTrack(trackRef, options)](./react/hook/usetrack.md)                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useTrackByName(trackRef, options)](./react/hook/usetrackbyname.md)                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useTrackContext()](./react/hook/usetrackcontext.md)                                                                                                               | Ensures that a track reference is provided via context. If not inside a <code>TrackRefContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                 |
-| [useTrackMutedIndicator(trackRef)](./react/hook/usetrackmutedindicator.md)                                                                                         | The <code>useTrackMutedIndicator</code> hook is used to implement the <code>TrackMutedIndicator</code> component and returns the muted state of the given track.                                                                                                                                                                                                                                                                                          |
-| [useTrackMutedIndicator(source, options)](./react/hook/usetrackmutedindicator_1.md)                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [useTrackRefContext()](./react/hook/usetrackrefcontext.md)                                                                                                         | Ensures that a track reference is provided via context. If not inside a <code>TrackRefContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                 |
-| [useTracks(sources, options)](./react/hook/usetracks.md)                                                                                                           | The <code>useTracks</code> hook returns an array of <code>TrackReference</code> or <code>TrackReferenceOrPlaceholder</code> depending on the provided <code>sources</code> property. If only subscribed tracks are desired, set the <code>onlySubscribed</code> property to <code>true</code>.                                                                                                                                                            |
-| [useTrackToggle({ source, onChange, initialState, captureOptions, ...rest })](./react/hook/usetracktoggle.md)                                                      | The <code>useTrackToggle</code> hook is used to implement the <code>TrackToggle</code> component and returns state and functionality of the given track.                                                                                                                                                                                                                                                                                                  |
-| [useVisualStableUpdate(trackReferences, maxItemsOnPage, options)](./react/hook/usevisualstableupdate.md)                                                           | The <code>useVisualStableUpdate</code> hook is used to prevent visually jarring jumps and shifts of elements in an array. The algorithm only starts to update when there are more items than visually fit on a page. If this is the case, it will make sure that speaking participants move to the first page and are always visible. Updating the array can occur because attendees leave or join a room, or because they mute/unmute or start speaking. |
+| Hook                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [useAudioPlayback(room)](./react/hook/useaudioplayback.md)                                                                                                         | In many browsers to start audio playback, the user must perform a user-initiated event such as clicking a button. The <code>useAudioPlayback</code> hook returns an object with a boolean <code>canPlayAudio</code> flag that indicates whether audio playback is allowed in the current context, as well as a <code>startAudio</code> function that can be called in a button <code>onClick</code> callback to start audio playback in the current context. |
+| [useChat(options)](./react/hook/usechat.md)                                                                                                                        | The <code>useChat</code> hook provides chat functionality for a LiveKit room. It returns a simple <code>send</code> function to send chat messages and an array of <code>chatMessages</code> to hold received messages.                                                                                                                                                                                                                                      |
+| [useChatToggle({ props })](./react/hook/usechattoggle.md)                                                                                                          | The <code>useChatToggle</code> hook provides state and functions for toggling the chat window.                                                                                                                                                                                                                                                                                                                                                               |
+| [useClearPinButton(props)](./react/hook/useclearpinbutton.md)                                                                                                      | The <code>useClearPinButton</code> hook provides props for the [ClearPinButton()](./react/component/clearpinbutton.md) or your custom implementation of it component. It adds the <code>onClick</code> handler to signal the <code>LayoutContext</code> that the tile in focus should be cleared.                                                                                                                                                            |
+| [useConnectionQualityIndicator(options)](./react/hook/useconnectionqualityindicator.md)                                                                            | The <code>useConnectionQualityIndicator</code> hook provides props for the <code>ConnectionQualityIndicator</code> or your custom implementation of it component.                                                                                                                                                                                                                                                                                            |
+| [useConnectionState(room)](./react/hook/useconnectionstate.md)                                                                                                     | The <code>useConnectionState</code> hook allows you to simply implement your own <code>ConnectionState</code> component.                                                                                                                                                                                                                                                                                                                                     |
+| [useCreateLayoutContext()](./react/hook/usecreatelayoutcontext.md)                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useDataChannel(topic, onMessage)](./react/hook/usedatachannel.md)                                                                                                 | The <code>useDataChannel</code> hook returns the ability to send and receive messages. By optionally passing a <code>topic</code>, you can narrow down which messages are returned in the messages array.                                                                                                                                                                                                                                                    |
+| [useDataChannel(onMessage)](./react/hook/usedatachannel_1.md)                                                                                                      | The <code>useDataChannel</code> hook returns the ability to send and receive messages.                                                                                                                                                                                                                                                                                                                                                                       |
+| [useDisconnectButton(props)](./react/hook/usedisconnectbutton.md)                                                                                                  | The <code>useDisconnectButton</code> hook is used to implement the <code>DisconnectButton</code> or your custom implementation of it. It adds onClick handler to the button to disconnect from the room.                                                                                                                                                                                                                                                     |
+| [useEnsureCreateLayoutContext(layoutContext)](./react/hook/useensurecreatelayoutcontext.md)                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useEnsureLayoutContext(layoutContext)](./react/hook/useensurelayoutcontext.md)                                                                                    | Ensures that a layout context is provided, either via context or explicitly as a parameter. If not inside a <code>LayoutContext</code> and no layout context is provided, an error is thrown.                                                                                                                                                                                                                                                                |
+| [useEnsureParticipant(participant)](./react/hook/useensureparticipant.md)                                                                                          | Ensures that a participant is provided, either via context or explicitly as a parameter. If not inside a <code>ParticipantContext</code> and no participant is provided, an error is thrown.                                                                                                                                                                                                                                                                 |
+| [useEnsureRoom(room)](./react/hook/useensureroom.md)                                                                                                               | Ensures that a room is provided, either via context or explicitly as a parameter. If no room is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                                |
+| [useEnsureTrackRef(trackRef)](./react/hook/useensuretrackref.md)                                                                                                   | Ensures that a track reference is provided, either via context or explicitly as a parameter. If not inside a <code>TrackRefContext</code> and no track reference is provided, an error is thrown.                                                                                                                                                                                                                                                            |
+| [useEnsureTrackReference(track)](./react/hook/useensuretrackreference.md)                                                                                          | Ensures that a track reference is provided, either via context or explicitly as a parameter. If not inside a <code>TrackContext</code> and no track reference is provided, an error is thrown.                                                                                                                                                                                                                                                               |
+| [useFacingMode(trackReference)](./react/hook/usefacingmode.md)                                                                                                     | Try to determine the <code>facingMode</code> of a local participant video track.                                                                                                                                                                                                                                                                                                                                                                             |
+| [useFocusToggle({ trackRef, trackSource, participant, props })](./react/hook/usefocustoggle.md)                                                                    | The <code>useFocusToggle</code> hook is used to implement the <code>FocusToggle</code> or your custom implementation of it. The <code>TrackReferenceOrPlaceholder</code> is used to register a onClick handler and to identify the track to focus on.                                                                                                                                                                                                        |
+| [useGridLayout(gridElement, trackCount)](./react/hook/usegridlayout.md)                                                                                            | The <code>useGridLayout</code> hook tries to select the best layout to fit all tiles. If the available screen space is not enough, it will reduce the number of maximum visible tiles and select a layout that still works visually within the given limitations. As the order of tiles changes over time, the hook tries to keep visual updates to a minimum while trying to display important tiles such as speaking participants or screen shares.        |
+| [useIsMuted(trackRef)](./react/hook/useismuted.md)                                                                                                                 | The <code>useIsMuted</code> hook is used to implement the <code>TrackMutedIndicator</code> or your custom implementation of it. It returns a <code>boolean</code> that indicates if the track is muted or not.                                                                                                                                                                                                                                               |
+| [useIsMuted(source, options)](./react/hook/useismuted_1.md)                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useIsSpeaking(participant)](./react/hook/useisspeaking.md)                                                                                                        | The <code>useIsSpeaking</code> hook returns a <code>boolean</code> that indicates if the participant is speaking or not.                                                                                                                                                                                                                                                                                                                                     |
+| [useLayoutContext()](./react/hook/uselayoutcontext.md)                                                                                                             | Ensures that a layout context is provided via context. If no layout context is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                                                 |
+| [useLiveKitRoom(props)](./react/hook/uselivekitroom.md)                                                                                                            | The <code>useLiveKitRoom</code> hook is used to implement the <code>LiveKitRoom</code> or your custom implementation of it. It returns a <code>Room</code> instance and HTML props that should be applied to the root element of the component.                                                                                                                                                                                                              |
+| [useLocalParticipant(options)](./react/hook/uselocalparticipant.md)                                                                                                | The <code>useLocalParticipant</code> hook returns the local participant and the associated state around the participant.                                                                                                                                                                                                                                                                                                                                     |
+| [useLocalParticipantPermissions()](./react/hook/uselocalparticipantpermissions.md)                                                                                 | The <code>useLocalParticipantPermissions</code> hook returns the local participant's permissions.                                                                                                                                                                                                                                                                                                                                                            |
+| [useMaybeLayoutContext()](./react/hook/usemaybelayoutcontext.md)                                                                                                   | Returns a layout context from the <code>LayoutContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                                 |
+| [useMaybeParticipantContext()](./react/hook/usemaybeparticipantcontext.md)                                                                                         | Returns a participant from the <code>ParticipantContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                               |
+| [useMaybeRoomContext()](./react/hook/usemayberoomcontext.md)                                                                                                       | Returns the room context if it exists, otherwise undefined.                                                                                                                                                                                                                                                                                                                                                                                                  |
+| [useMaybeTrackContext()](./react/hook/usemaybetrackcontext.md)                                                                                                     | Returns a track reference from the <code>TrackContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                                 |
+| [useMaybeTrackRefContext()](./react/hook/usemaybetrackrefcontext.md)                                                                                               | Returns a track reference from the <code>TrackRefContext</code> if it exists, otherwise <code>undefined</code>.                                                                                                                                                                                                                                                                                                                                              |
+| [useMediaDevices({ kind })](./react/hook/usemediadevices.md)                                                                                                       | The <code>useMediaDevices</code> hook returns the list of media devices of a given kind.                                                                                                                                                                                                                                                                                                                                                                     |
+| [useMediaDeviceSelect({ kind, room, track, requestPermissions, })](./react/hook/usemediadeviceselect.md)                                                           | The <code>useMediaDeviceSelect</code> hook is used to implement the <code>MediaDeviceSelect</code> component and returns o.a. the list of devices of a given kind (audioinput or videoinput), the currently active device and a function to set the the active device.                                                                                                                                                                                       |
+| [useMediaTrack(source, participant, options)](./react/hook/usemediatrack.md)                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useMediaTrackByName(name, participant, options)](./react/hook/usemediatrackbyname.md)                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [usePagination(itemPerPage, trackReferences)](./react/hook/usepagination.md)                                                                                       | The <code>usePagination</code> hook implements simple pagination logic for use with arrays.                                                                                                                                                                                                                                                                                                                                                                  |
+| [useParticipantContext()](./react/hook/useparticipantcontext.md)                                                                                                   | Ensures that a participant is provided via context. If not inside a <code>ParticipantContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                     |
+| [useParticipantInfo(props)](./react/hook/useparticipantinfo.md)                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useParticipantPermissions(options)](./react/hook/useparticipantpermissions.md)                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useParticipants(options)](./react/hook/useparticipants.md)                                                                                                        | The <code>useParticipants</code> hook returns all participants (local and remote) of the current room.                                                                                                                                                                                                                                                                                                                                                       |
+| [useParticipantTile({ trackRef, participant, source, publication, onParticipantClick, disableSpeakingIndicator, htmlProps, })](./react/hook/useparticipanttile.md) | The <code>useParticipantTile</code> hook is used to implement the <code>ParticipantTile</code> and returns the props needed to render the tile.                                                                                                                                                                                                                                                                                                              |
+| [usePersistentUserChoices(options)](./react/hook/usepersistentuserchoices.md)                                                                                      | A hook that provides access to user choices stored in local storage, such as selected media devices and their current state (on or off), as well as the user name.                                                                                                                                                                                                                                                                                           |
+| [usePinnedTracks(layoutContext)](./react/hook/usepinnedtracks.md)                                                                                                  | The <code>usePinnedTracks</code> hook returns a array of the pinned tracks of the current room.                                                                                                                                                                                                                                                                                                                                                              |
+| [usePreviewDevice(enabled, deviceId, kind)](./react/hook/usepreviewdevice.md)                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [usePreviewTracks(options, onError)](./react/hook/usepreviewtracks.md)                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useRemoteParticipant(identity, options)](./react/hook/useremoteparticipant.md)                                                                                    | The <code>useRemoteParticipant</code> hook returns the RemoteParticipant with the given <code>identity</code>.                                                                                                                                                                                                                                                                                                                                               |
+| [useRemoteParticipants(options)](./react/hook/useremoteparticipants.md)                                                                                            | The <code>useRemoteParticipants</code> hook returns all remote participants (without the local) of the current room.                                                                                                                                                                                                                                                                                                                                         |
+| [useRoomContext()](./react/hook/useroomcontext.md)                                                                                                                 | Ensures that a room is provided via context. If no room is provided, an error is thrown.                                                                                                                                                                                                                                                                                                                                                                     |
+| [useRoomInfo(options)](./react/hook/useroominfo.md)                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useSortedParticipants(participants)](./react/hook/usesortedparticipants.md)                                                                                       | The <code>useSortedParticipants</code> hook returns the participants sorted by importance.                                                                                                                                                                                                                                                                                                                                                                   |
+| [useSpeakingParticipants()](./react/hook/usespeakingparticipants.md)                                                                                               | The <code>useSpeakingParticipants</code> hook returns the only the active speakers of all participants.                                                                                                                                                                                                                                                                                                                                                      |
+| [useStartAudio({ room, props })](./react/hook/usestartaudio.md)                                                                                                    | In many browsers to start audio playback, the user must perform a user-initiated event such as clicking a button. The <code>useStatAudio</code> hook returns an object with a boolean <code>canPlayAudio</code> flag that indicates whether audio playback is allowed in the current context, as well as a <code>startAudio</code> function that can be called in a button <code>onClick</code> callback to start audio playback in the current context.     |
+| [useSwipe(element, options)](./react/hook/useswipe.md)                                                                                                             | Simple implementation to detect horizontal swipe actions. Accepts callbacks for on right and left swipes.                                                                                                                                                                                                                                                                                                                                                    |
+| [useToken(tokenEndpoint, roomName, options)](./react/hook/usetoken.md)                                                                                             | The <code>useToken</code> hook fetches a token from the given token endpoint with the given user info.                                                                                                                                                                                                                                                                                                                                                       |
+| [useTrack(trackRef, options)](./react/hook/usetrack.md)                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useTrackByName(trackRef, options)](./react/hook/usetrackbyname.md)                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useTrackContext()](./react/hook/usetrackcontext.md)                                                                                                               | Ensures that a track reference is provided via context. If not inside a <code>TrackRefContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                    |
+| [useTrackMutedIndicator(trackRef)](./react/hook/usetrackmutedindicator.md)                                                                                         | The <code>useTrackMutedIndicator</code> hook is used to implement the <code>TrackMutedIndicator</code> component and returns the muted state of the given track.                                                                                                                                                                                                                                                                                             |
+| [useTrackMutedIndicator(source, options)](./react/hook/usetrackmutedindicator_1.md)                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [useTrackRefContext()](./react/hook/usetrackrefcontext.md)                                                                                                         | Ensures that a track reference is provided via context. If not inside a <code>TrackRefContext</code>, an error is thrown.                                                                                                                                                                                                                                                                                                                                    |
+| [useTracks(sources, options)](./react/hook/usetracks.md)                                                                                                           | The <code>useTracks</code> hook returns an array of <code>TrackReference</code> or <code>TrackReferenceOrPlaceholder</code> depending on the provided <code>sources</code> property. If only subscribed tracks are desired, set the <code>onlySubscribed</code> property to <code>true</code>.                                                                                                                                                               |
+| [useTrackToggle({ source, onChange, initialState, captureOptions, ...rest })](./react/hook/usetracktoggle.md)                                                      | The <code>useTrackToggle</code> hook is used to implement the <code>TrackToggle</code> component and returns state and functionality of the given track.                                                                                                                                                                                                                                                                                                     |
+| [useVisualStableUpdate(trackReferences, maxItemsOnPage, options)](./react/hook/usevisualstableupdate.md)                                                           | The <code>useVisualStableUpdate</code> hook is used to prevent visually jarring jumps and shifts of elements in an array. The algorithm only starts to update when there are more items than visually fit on a page. If this is the case, it will make sure that speaking participants move to the first page and are always visible.                                                                                                                        |
 
 ## Others
 
@@ -135,9 +147,9 @@
 | [formatChatMessageLinks(message)](./react/formatchatmessagelinks.md)              |                                                                                                                                                                                                                        |
 | [GridLayoutProps](./react/gridlayoutprops.md)                                     |                                                                                                                                                                                                                        |
 | [LayoutContext](./react/layoutcontext.md)                                         |                                                                                                                                                                                                                        |
+| [LayoutContextProviderProps](./react/layoutcontextproviderprops.md)               |                                                                                                                                                                                                                        |
 | [LayoutContextType](./react/layoutcontexttype.md)                                 |                                                                                                                                                                                                                        |
 | [LiveKitRoomProps](./react/livekitroomprops.md)                                   |                                                                                                                                                                                                                        |
-| [LocalUserChoices](./react/localuserchoices.md)                                   |                                                                                                                                                                                                                        |
 | [MediaDeviceMenuProps](./react/mediadevicemenuprops.md)                           |                                                                                                                                                                                                                        |
 | [MediaDeviceSelectProps](./react/mediadeviceselectprops.md)                       |                                                                                                                                                                                                                        |
 | [MessageFormatter](./react/messageformatter.md)                                   |                                                                                                                                                                                                                        |
@@ -145,7 +157,8 @@
 | [ParticipantLoopProps](./react/participantloopprops.md)                           |                                                                                                                                                                                                                        |
 | [ParticipantNameProps](./react/participantnameprops.md)                           |                                                                                                                                                                                                                        |
 | [ParticipantTileProps](./react/participanttileprops.md)                           |                                                                                                                                                                                                                        |
-| [PreJoinProps](./react/prejoinprops.md)                                           |                                                                                                                                                                                                                        |
+| [PreJoinProps](./react/prejoinprops.md)                                           | Props for the PreJoin component.                                                                                                                                                                                       |
+| [RoomAudioRendererProps](./react/roomaudiorendererprops.md)                       |                                                                                                                                                                                                                        |
 | [RoomContext](./react/roomcontext.md)                                             |                                                                                                                                                                                                                        |
 | [RoomNameProps](./react/roomnameprops.md)                                         |                                                                                                                                                                                                                        |
 | [TrackContext](./react/trackcontext.md)                                           |                                                                                                                                                                                                                        |
@@ -163,10 +176,13 @@
 | [UseParticipantPermissionsOptions](./react/useparticipantpermissionsoptions.md)   | The <code>useParticipantPermissions</code> hook returns the permissions of a given participant.                                                                                                                        |
 | [UseParticipantsOptions](./react/useparticipantsoptions.md)                       |                                                                                                                                                                                                                        |
 | [UseParticipantTileProps](./react/useparticipanttileprops.md)                     |                                                                                                                                                                                                                        |
+| [UsePersistentUserChoicesOptions](./react/usepersistentuserchoicesoptions.md)     | Options for the <code>usePersistentDeviceSettings</code> hook.                                                                                                                                                         |
 | [UseRemoteParticipantOptions](./react/useremoteparticipantoptions.md)             |                                                                                                                                                                                                                        |
 | [UseRemoteParticipantsOptions](./react/useremoteparticipantsoptions.md)           |                                                                                                                                                                                                                        |
 | [UserInfo](./react/userinfo.md)                                                   |                                                                                                                                                                                                                        |
 | [UseRoomInfoOptions](./react/useroominfooptions.md)                               | The <code>useRoomInfo</code> hook returns the name and metadata of the given <code>Room</code>.                                                                                                                        |
+| [UseStartAudioProps](./react/usestartaudioprops.md)                               |                                                                                                                                                                                                                        |
+| [UseSwipeOptions](./react/useswipeoptions.md)                                     |                                                                                                                                                                                                                        |
 | [UseTokenOptions](./react/usetokenoptions.md)                                     |                                                                                                                                                                                                                        |
 | [UseTrackMutedIndicatorOptions](./react/usetrackmutedindicatoroptions.md)         |                                                                                                                                                                                                                        |
 | [UseTrackOptions](./react/usetrackoptions.md)                                     |                                                                                                                                                                                                                        |

package/generated-docs/react/layoutcontext.md

@@ -1,6 +1,13 @@
+---
+{
+  "title": "LayoutContext variable",
+  "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/context/layout-context.ts"
+}
+---
+
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
-## LayoutContext variable
+# LayoutContext variable
 
 **Signature:**