@livekit/components-js-docs 0.0.5 → 0.1.0

package/generated-docs/core/gettrackreferenceid.md

@@ -2,7 +2,7 @@
 
 # getTrackReferenceId
 
-Returns a id to identify the `TrackReference` based on participant and source.
+Returns a id to identify the `TrackReference` or `TrackReferencePlaceholder` based on participant, track source and trackSid.
 
 **Signature:**
 
@@ -12,4 +12,8 @@ export declare function getTrackReferenceId(
 ): string;
 ```
 
+## Remarks
+
+The id pattern is: `${participantIdentity}_${trackSource}_${trackSid}` for `TrackReference` and `${participantIdentity}_${trackSource}_placeholder` for `TrackReferencePlaceholder`<!-- -->.
+
 {% partial file="p_usage.md" variables={exampleCount: 0} /%}

package/generated-docs/core/index.md

@@ -4,113 +4,117 @@
 
 ## Others
 
-| Other                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                 |
-| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [activeSpeakerObserver(room)](./core/activespeakerobserver.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [allParticipantEvents](./core/allparticipantevents.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [allParticipantRoomEvents](./core/allparticipantroomevents.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [allRemoteParticipantEvents](./core/allremoteparticipantevents.md)                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [allRemoteParticipantRoomEvents](./core/allremoteparticipantroomevents.md)                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [attachIfSubscribed](./core/attachifsubscribed.md)                                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [AudioSource](./core/audiosource.md)                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [BaseDataMessage](./core/basedatamessage.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [CaptureOptionsBySource](./core/captureoptionsbysource.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ChatMessage](./core/chatmessage.md)                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [computeMenuPosition(button, menu)](./core/computemenuposition.md)                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [connectedParticipantObserver(room, identity, options)](./core/connectedparticipantobserver.md) |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ConnectedParticipantObserverOptions](./core/connectedparticipantobserveroptions.md)            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [connectedParticipantsObserver(room, options)](./core/connectedparticipantsobserver.md)         |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [connectionStateObserver(room)](./core/connectionstateobserver.md)                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createActiveDeviceObservable(room, kind)](./core/createactivedeviceobservable.md)              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createConnectionQualityObserver(participant)](./core/createconnectionqualityobserver.md)       |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createDataObserver(room)](./core/createdataobserver.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createDefaultGrammar](./core/createdefaultgrammar.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createIsSpeakingObserver(participant)](./core/createisspeakingobserver.md)                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createMediaDeviceObserver(kind, requestPermissions)](./core/createmediadeviceobserver.md)      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createTrackObserver(participant, options)](./core/createtrackobserver.md)                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [createUrlRegExp](./core/createurlregexp.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [cssPrefix](./core/cssprefix.md)                                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [DataSendOptions](./core/datasendoptions.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [DataTopic](./core/datatopic.md)                                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [encryptionStatusObservable(room, participant)](./core/encryptionstatusobservable.md)           |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [getTrackByIdentifier(options)](./core/gettrackbyidentifier.md)                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [getTrackReferenceId(trackReference)](./core/gettrackreferenceid.md)                            | Returns a id to identify the <code>TrackReference</code> based on participant and source.                                                                                                                                                                                                                                                                                                                   |
-| [getTrackReferenceSource(trackReference)](./core/gettrackreferencesource.md)                    | Returns the Source of the TrackReference.                                                                                                                                                                                                                                                                                                                                                                   |
-| [GRID_LAYOUTS](./core/grid_layouts.md)                                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [GridLayoutDefinition](./core/gridlayoutdefinition.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isEqualTrackRef(a, b)](./core/isequaltrackref.md)                                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isLocal(p)](./core/islocal.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isMobileBrowser()](./core/ismobilebrowser.md)                                                  | Mobile browser detection based on <code>navigator.userAgent</code> string. Defaults to returning <code>false</code> if not in a browser.                                                                                                                                                                                                                                                                    |
-| [isParticipantSourcePinned(participant, source, pinState)](./core/isparticipantsourcepinned.md) | Check if the participant track source is pinned.                                                                                                                                                                                                                                                                                                                                                            |
-| [isRemote(p)](./core/isremote.md)                                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isSourcesWithOptions(sources)](./core/issourceswithoptions.md)                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isSourceWitOptions(source)](./core/issourcewitoptions.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isTrackReference(trackReference)](./core/istrackreference.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [isTrackReferencePinned(trackReference, pinState)](./core/istrackreferencepinned.md)            | Check if the <code>TrackReference</code> is pinned.                                                                                                                                                                                                                                                                                                                                                         |
-| [isTrackReferencePlaceholder(trackReference)](./core/istrackreferenceplaceholder.md)            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [log](./core/log.md)                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [MediaToggleType](./core/mediatoggletype.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [mutedObserver(participant, source)](./core/mutedobserver.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [observeParticipantEvents(participant, events)](./core/observeparticipantevents.md)             |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [observeParticipantMedia(participant)](./core/observeparticipantmedia.md)                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [observeRoomEvents(room, events)](./core/observeroomevents.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [observeTrackEvents(track, events)](./core/observetrackevents.md)                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ParticipantClickEvent](./core/participantclickevent.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [participantEventSelector(participant, event)](./core/participanteventselector.md)              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ParticipantFilter](./core/participantfilter.md)                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [participantInfoObserver(participant)](./core/participantinfoobserver.md)                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ParticipantMedia](./core/participantmedia.md)                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [participantPermissionObserver(participant)](./core/participantpermissionobserver.md)           |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [PIN_DEFAULT_STATE](./core/pin_default_state.md)                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [PinState](./core/pinstate.md)                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ReceivedChatMessage](./core/receivedchatmessage.md)                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ReceivedDataMessage](./core/receiveddatamessage.md)                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [RequireOnlyOne](./core/requireonlyone.md)                                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [roomAudioPlaybackAllowedObservable(room)](./core/roomaudioplaybackallowedobservable.md)        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [roomEventSelector(room, event)](./core/roomeventselector.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [roomInfoObserver(room)](./core/roominfoobserver.md)                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [roomObserver(room)](./core/roomobserver.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [screenShareObserver(room)](./core/screenshareobserver.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [ScreenShareTrackMap](./core/screensharetrackmap.md)                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [selectGridLayout(layouts, participantCount, width, height)](./core/selectgridlayout.md)        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [sendMessage(localParticipant, payload, topic, options)](./core/sendmessage.md)                 | Publish data from the LocalParticipant.                                                                                                                                                                                                                                                                                                                                                                     |
-| [setDifference(setA, setB)](./core/setdifference.md)                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setLogLevel(level, options)](./core/setloglevel.md)                                            | Set the log level for both the <code>@livekit/components-react</code> package and the <code>@livekit-client</code> package. To set the <code>@livekit-client</code> log independently, use the <code>liveKitClientLogLevel</code> prop on the <code>options</code> object.                                                                                                                                  |
-| [SetMediaDeviceOptions](./core/setmediadeviceoptions.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupChat(room, options)](./core/setupchat.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupChatToggle()](./core/setupchattoggle.md)                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupClearPinButton()](./core/setupclearpinbutton.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupConnectionQualityIndicator(participant)](./core/setupconnectionqualityindicator.md)       |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupDataMessageHandler(room, topic, onMessage)](./core/setupdatamessagehandler.md)            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupDeviceSelector(kind, room, localTrack)](./core/setupdeviceselector.md)                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupDisconnectButton(room)](./core/setupdisconnectbutton.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupFocusToggle()](./core/setupfocustoggle.md)                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupLiveKitRoom()](./core/setuplivekitroom.md)                                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupManualToggle()](./core/setupmanualtoggle.md)                                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupMediaToggle(source, room, options)](./core/setupmediatoggle.md)                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupMediaTrack(trackIdentifier)](./core/setupmediatrack.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupParticipantName(participant)](./core/setupparticipantname.md)                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupParticipantTile()](./core/setupparticipanttile.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupStartAudio()](./core/setupstartaudio.md)                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [setupTrackMutedIndicator(participant, source)](./core/setuptrackmutedindicator.md)             |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [sortParticipants(participants)](./core/sortparticipants.md)                                    | Default sort for participants, it'll order participants by: 1. local participant 2. dominant speaker (speaker with the loudest audio level) 3. other speakers that are recently active 4. participants with video on 5. by joinedAt                                                                                                                                                                         |
-| [sortTrackReferences(tracks)](./core/sorttrackreferences.md)                                    | Default sort for <code>TrackReferenceOrPlaceholder</code>, it'll order participants by: 1. local camera track (publication.isLocal) 2. remote screen_share track 3. local screen_share track 4. remote dominant speaker camera track (sorted by speaker with the loudest audio level) 5. other remote speakers that are recently active 6. remote unmuted camera tracks 7. remote tracks sorted by joinedAt |
-| [SourcesArray](./core/sourcesarray.md)                                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [supportsScreenSharing()](./core/supportsscreensharing.md)                                      | Returns <code>true</code> if the browser supports screen sharing.                                                                                                                                                                                                                                                                                                                                           |
-| [ToggleSource](./core/togglesource.md)                                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [tokenize(input, grammar)](./core/tokenize.md)                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TokenizeGrammar](./core/tokenizegrammar.md)                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackIdentifier](./core/trackidentifier.md)                                                    | The TrackIdentifier type is used to select Tracks either based on - Track.Source and/or name of the track, e.g. <code>{source: Track.Source.Camera}</code> or <code>{name: &quot;my-track&quot;}</code> - TrackReference (participant and publication)                                                                                                                                                      |
-| [trackObservable(track)](./core/trackobservable.md)                                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackReference](./core/trackreference.md)                                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackReferenceFilter](./core/trackreferencefilter.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackReferenceOrPlaceholder](./core/trackreferenceorplaceholder.md)                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackReferencePlaceholder](./core/trackreferenceplaceholder.md)                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [trackReferencesObservable(room, sources, options)](./core/trackreferencesobservable.md)        |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackSource](./core/tracksource.md)                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [TrackSourceWithOptions](./core/tracksourcewithoptions.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [updatePages(currentList, nextList, maxItemsOnPage)](./core/updatepages.md)                     | Divide the list of elements into pages and and check if pages need updating.                                                                                                                                                                                                                                                                                                                                |
-| [VideoSource](./core/videosource.md)                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [wasClickOutside(insideElement, event)](./core/wasclickoutside.md)                              |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [WIDGET_DEFAULT_STATE](./core/widget_default_state.md)                                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [WidgetState](./core/widgetstate.md)                                                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| Other                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                 |
+| ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [activeSpeakerObserver(room)](./core/activespeakerobserver.md)                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [allParticipantEvents](./core/allparticipantevents.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [allParticipantRoomEvents](./core/allparticipantroomevents.md)                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [allRemoteParticipantEvents](./core/allremoteparticipantevents.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [allRemoteParticipantRoomEvents](./core/allremoteparticipantroomevents.md)                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [attachIfSubscribed](./core/attachifsubscribed.md)                                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [AudioSource](./core/audiosource.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [BaseDataMessage](./core/basedatamessage.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [CaptureOptionsBySource](./core/captureoptionsbysource.md)                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ChatMessage](./core/chatmessage.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [computeMenuPosition(button, menu)](./core/computemenuposition.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [connectedParticipantObserver(room, identity, options)](./core/connectedparticipantobserver.md)      |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ConnectedParticipantObserverOptions](./core/connectedparticipantobserveroptions.md)                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [connectedParticipantsObserver(room, options)](./core/connectedparticipantsobserver.md)              |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [connectionStateObserver(room)](./core/connectionstateobserver.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createActiveDeviceObservable(room, kind)](./core/createactivedeviceobservable.md)                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createConnectionQualityObserver(participant)](./core/createconnectionqualityobserver.md)            |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createDataObserver(room)](./core/createdataobserver.md)                                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createDefaultGrammar](./core/createdefaultgrammar.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createIsSpeakingObserver(participant)](./core/createisspeakingobserver.md)                          |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createMediaDeviceObserver(kind, requestPermissions)](./core/createmediadeviceobserver.md)           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createTrackObserver(participant, options)](./core/createtrackobserver.md)                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [createUrlRegExp](./core/createurlregexp.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [cssPrefix](./core/cssprefix.md)                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [DataSendOptions](./core/datasendoptions.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [DataTopic](./core/datatopic.md)                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [encryptionStatusObservable(room, participant)](./core/encryptionstatusobservable.md)                |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [getTrackByIdentifier(options)](./core/gettrackbyidentifier.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [getTrackReferenceId(trackReference)](./core/gettrackreferenceid.md)                                 | Returns a id to identify the <code>TrackReference</code> or <code>TrackReferencePlaceholder</code> based on participant, track source and trackSid.                                                                                                                                                                                                                                                         |
+| [getTrackReferenceSource(trackReference)](./core/gettrackreferencesource.md)                         | Returns the Source of the TrackReference.                                                                                                                                                                                                                                                                                                                                                                   |
+| [GRID_LAYOUTS](./core/grid_layouts.md)                                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [GridLayoutDefinition](./core/gridlayoutdefinition.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isEqualTrackRef(a, b)](./core/isequaltrackref.md)                                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isLocal(p)](./core/islocal.md)                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isMobileBrowser()](./core/ismobilebrowser.md)                                                       | Mobile browser detection based on <code>navigator.userAgent</code> string. Defaults to returning <code>false</code> if not in a browser.                                                                                                                                                                                                                                                                    |
+| [isParticipantSourcePinned(participant, source, pinState)](./core/isparticipantsourcepinned.md)      | Check if the participant track source is pinned.                                                                                                                                                                                                                                                                                                                                                            |
+| [isParticipantTrackReferencePinned(trackRef, pinState)](./core/isparticipanttrackreferencepinned.md) | Check if the participant track reference is pinned.                                                                                                                                                                                                                                                                                                                                                         |
+| [isRemote(p)](./core/isremote.md)                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isSourcesWithOptions(sources)](./core/issourceswithoptions.md)                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isSourceWitOptions(source)](./core/issourcewitoptions.md)                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isTrackReference(trackReference)](./core/istrackreference.md)                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [isTrackReferencePinned(trackReference, pinState)](./core/istrackreferencepinned.md)                 | Check if the <code>TrackReference</code> is pinned.                                                                                                                                                                                                                                                                                                                                                         |
+| [isTrackReferencePlaceholder(trackReference)](./core/istrackreferenceplaceholder.md)                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [log](./core/log.md)                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [MediaToggleType](./core/mediatoggletype.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [MessageDecoder](./core/messagedecoder.md)                                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [MessageEncoder](./core/messageencoder.md)                                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [mutedObserver(trackRef)](./core/mutedobserver.md)                                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [observeParticipantEvents(participant, events)](./core/observeparticipantevents.md)                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [observeParticipantMedia(participant)](./core/observeparticipantmedia.md)                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [observeRoomEvents(room, events)](./core/observeroomevents.md)                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [observeTrackEvents(track, events)](./core/observetrackevents.md)                                    |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ParticipantClickEvent](./core/participantclickevent.md)                                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [participantEventSelector(participant, event)](./core/participanteventselector.md)                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ParticipantFilter](./core/participantfilter.md)                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [participantInfoObserver(participant)](./core/participantinfoobserver.md)                            |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ParticipantMedia](./core/participantmedia.md)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [participantPermissionObserver(participant)](./core/participantpermissionobserver.md)                |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [PIN_DEFAULT_STATE](./core/pin_default_state.md)                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [PinState](./core/pinstate.md)                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ReceivedChatMessage](./core/receivedchatmessage.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ReceivedDataMessage](./core/receiveddatamessage.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [RequireOnlyOne](./core/requireonlyone.md)                                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [roomAudioPlaybackAllowedObservable(room)](./core/roomaudioplaybackallowedobservable.md)             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [roomEventSelector(room, event)](./core/roomeventselector.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [roomInfoObserver(room)](./core/roominfoobserver.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [roomObserver(room)](./core/roomobserver.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [screenShareObserver(room)](./core/screenshareobserver.md)                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [ScreenShareTrackMap](./core/screensharetrackmap.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [selectGridLayout(layouts, participantCount, width, height)](./core/selectgridlayout.md)             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [sendMessage(localParticipant, payload, topic, options)](./core/sendmessage.md)                      | Publish data from the LocalParticipant.                                                                                                                                                                                                                                                                                                                                                                     |
+| [setDifference(setA, setB)](./core/setdifference.md)                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setLogLevel(level, options)](./core/setloglevel.md)                                                 | Set the log level for both the <code>@livekit/components-react</code> package and the <code>@livekit-client</code> package. To set the <code>@livekit-client</code> log independently, use the <code>liveKitClientLogLevel</code> prop on the <code>options</code> object.                                                                                                                                  |
+| [SetMediaDeviceOptions](./core/setmediadeviceoptions.md)                                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupChat(room, options)](./core/setupchat.md)                                                      |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupChatToggle()](./core/setupchattoggle.md)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupClearPinButton()](./core/setupclearpinbutton.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupConnectionQualityIndicator(participant)](./core/setupconnectionqualityindicator.md)            |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupDataMessageHandler(room, topic, onMessage)](./core/setupdatamessagehandler.md)                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupDeviceSelector(kind, room, localTrack)](./core/setupdeviceselector.md)                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupDisconnectButton(room)](./core/setupdisconnectbutton.md)                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupFocusToggle()](./core/setupfocustoggle.md)                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupLiveKitRoom()](./core/setuplivekitroom.md)                                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupManualToggle()](./core/setupmanualtoggle.md)                                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupMediaToggle(source, room, options)](./core/setupmediatoggle.md)                                |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupMediaTrack(trackIdentifier)](./core/setupmediatrack.md)                                        |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupParticipantName(participant)](./core/setupparticipantname.md)                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupParticipantTile()](./core/setupparticipanttile.md)                                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupStartAudio()](./core/setupstartaudio.md)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [setupTrackMutedIndicator(trackRef)](./core/setuptrackmutedindicator.md)                             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [sortParticipants(participants)](./core/sortparticipants.md)                                         | Default sort for participants, it'll order participants by: 1. local participant 2. dominant speaker (speaker with the loudest audio level) 3. other speakers that are recently active 4. participants with video on 5. by joinedAt                                                                                                                                                                         |
+| [sortTrackReferences(tracks)](./core/sorttrackreferences.md)                                         | Default sort for <code>TrackReferenceOrPlaceholder</code>, it'll order participants by: 1. local camera track (publication.isLocal) 2. remote screen_share track 3. local screen_share track 4. remote dominant speaker camera track (sorted by speaker with the loudest audio level) 5. other remote speakers that are recently active 6. remote unmuted camera tracks 7. remote tracks sorted by joinedAt |
+| [SourcesArray](./core/sourcesarray.md)                                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [supportsScreenSharing()](./core/supportsscreensharing.md)                                           | Returns <code>true</code> if the browser supports screen sharing.                                                                                                                                                                                                                                                                                                                                           |
+| [ToggleSource](./core/togglesource.md)                                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [tokenize(input, grammar)](./core/tokenize.md)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TokenizeGrammar](./core/tokenizegrammar.md)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackIdentifier](./core/trackidentifier.md)                                                         | The TrackIdentifier type is used to select Tracks either based on - Track.Source and/or name of the track, e.g. <code>{source: Track.Source.Camera}</code> or <code>{name: &quot;my-track&quot;}</code> - TrackReference (participant and publication)                                                                                                                                                      |
+| [trackObservable(track)](./core/trackobservable.md)                                                  |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackReference](./core/trackreference.md)                                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackReferenceFilter](./core/trackreferencefilter.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackReferenceId](./core/trackreferenceid.md)                                                       |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackReferenceOrPlaceholder](./core/trackreferenceorplaceholder.md)                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackReferencePlaceholder](./core/trackreferenceplaceholder.md)                                     |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [trackReferencesObservable(room, sources, options)](./core/trackreferencesobservable.md)             |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackSource](./core/tracksource.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [TrackSourceWithOptions](./core/tracksourcewithoptions.md)                                           |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [updatePages(currentList, nextList, maxItemsOnPage)](./core/updatepages.md)                          | Divide the list of elements into pages and and check if pages need updating.                                                                                                                                                                                                                                                                                                                                |
+| [VideoSource](./core/videosource.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [wasClickOutside(insideElement, event)](./core/wasclickoutside.md)                                   |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [WIDGET_DEFAULT_STATE](./core/widget_default_state.md)                                               |                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [WidgetState](./core/widgetstate.md)                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                             |

package/generated-docs/core/isparticipantsourcepinned.md

@@ -2,6 +2,10 @@
 
 # isParticipantSourcePinned
 
+> Warning: This API is now obsolete.
+>
+> Use [isParticipantTrackReferencePinned()](./core/isparticipanttrackreferencepinned.md) instead.
+
 Check if the participant track source is pinned.
 
 **Signature:**

package/generated-docs/core/isparticipanttrackreferencepinned.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+# isParticipantTrackReferencePinned
+
+Check if the participant track reference is pinned.
+
+**Signature:**
+
+```typescript
+export declare function isParticipantTrackReferencePinned(
+  trackRef: TrackReference,
+  pinState: PinState | undefined,
+): boolean;
+```
+
+{% partial file="p_usage.md" variables={exampleCount: 0} /%}

package/generated-docs/core/mutedobserver.md

@@ -5,8 +5,5 @@
 **Signature:**
 
 ```typescript
-export declare function mutedObserver(
-  participant: Participant,
-  source: Track.Source,
-): Observable<boolean>;
+export declare function mutedObserver(trackRef: TrackReferenceOrPlaceholder): Observable<boolean>;
 ```

package/generated-docs/core/setupconnectionqualityindicator.md

@@ -6,65 +6,7 @@
 
 ```typescript
 export declare function setupConnectionQualityIndicator(participant: Participant): {
-  className:
-    | 'lk-rotate'
-    | 'lk-audio-conference'
-    | 'lk-audio-conference-stage'
-    | 'lk-audio-container'
-    | 'lk-button'
-    | 'lk-button-group'
-    | 'lk-button-group-container'
-    | 'lk-camera-off-note'
-    | 'lk-chat'
-    | 'lk-chat-entry'
-    | 'lk-chat-form'
-    | 'lk-chat-form-input'
-    | 'lk-chat-messages'
-    | 'lk-control-bar'
-    | 'lk-focus-layout-wrapper'
-    | 'lk-form-control'
-    | 'lk-grid-layout-wrapper'
-    | 'lk-join-button'
-    | 'lk-list'
-    | 'lk-message-body'
-    | 'lk-meta-data'
-    | 'lk-participant-name'
-    | 'lk-prejoin'
-    | 'lk-timestamp'
-    | 'lk-username-container'
-    | 'lk-video-conference'
-    | 'lk-video-conference-inner'
-    | 'lk-video-container'
-    | 'lk-audio-visualizer'
-    | 'lk-button-group-menu'
-    | 'lk-button-menu'
-    | 'lk-carousel'
-    | 'lk-chat-toggle'
-    | 'lk-connection-quality'
-    | 'lk-device-menu'
-    | 'lk-device-menu-heading'
-    | 'lk-disconnect-button'
-    | 'lk-focus-layout'
-    | 'lk-focus-toggle-button'
-    | 'lk-focused-participant'
-    | 'lk-grid-layout'
-    | 'lk-media-device-select'
-    | 'lk-pagination-control'
-    | 'lk-pagination-count'
-    | 'lk-pagination-indicator'
-    | 'lk-participant-media-audio'
-    | 'lk-participant-media-video'
-    | 'lk-participant-metadata'
-    | 'lk-participant-metadata-item'
-    | 'lk-participant-placeholder'
-    | 'lk-participant-tile'
-    | 'lk-pip-track'
-    | 'lk-room-container'
-    | 'lk-spinner'
-    | 'lk-start-audio-button'
-    | 'lk-toast'
-    | 'lk-track-muted-indicator-camera'
-    | 'lk-track-muted-indicator-microphone';
+  className: 'lk-connection-quality';
   connectionQualityObserver: import('rxjs').Observable<import('livekit-client').ConnectionQuality>;
 };
 ```

package/generated-docs/core/setuptrackmutedindicator.md

@@ -5,10 +5,7 @@
 **Signature:**
 
 ```typescript
-export declare function setupTrackMutedIndicator(
-  participant: Participant,
-  source: Track.Source,
-): {
+export declare function setupTrackMutedIndicator(trackRef: TrackReferenceOrPlaceholder): {
   className: string;
   mediaMutedObserver: import('rxjs').Observable<boolean>;
 };

package/generated-docs/core/trackreferenceid.md

@@ -0,0 +1,9 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+## TrackReferenceId type
+
+**Signature:**
+
+```typescript
+export type TrackReferenceId = ReturnType<typeof getTrackReferenceId>;
+```