@livekit/components-js-docs 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/LICENSE +201 -0
  2. package/generated-docs/core/chatmessage.md +2 -0
  3. package/generated-docs/core/chatoptions.md +24 -0
  4. package/generated-docs/core/createmediadeviceobserver.md +2 -1
  5. package/generated-docs/core/createurlregexp.md +4 -4
  6. package/generated-docs/core/index.md +8 -4
  7. package/generated-docs/core/loaduserchoices.md +27 -0
  8. package/generated-docs/core/localuserchoices.md +28 -0
  9. package/generated-docs/core/pinstate.md +2 -0
  10. package/generated-docs/core/receivedchatmessage.md +2 -0
  11. package/generated-docs/core/roomvideoplaybackallowedobservable.md +18 -0
  12. package/generated-docs/core/saveuserchoices.md +20 -0
  13. package/generated-docs/core/setupchat.md +1 -5
  14. package/generated-docs/core/setupstartvideo.md +20 -0
  15. package/generated-docs/core/trackreference.md +2 -0
  16. package/generated-docs/core/trackreferenceorplaceholder.md +2 -0
  17. package/generated-docs/core/trackreferenceplaceholder.md +2 -0
  18. package/generated-docs/core/widgetstate.md +2 -0
  19. package/generated-docs/react/audiotrackprops.md +12 -11
  20. package/generated-docs/react/audiotrackprops.muted.md +21 -0
  21. package/generated-docs/react/audiotrackprops.volume.md +1 -1
  22. package/generated-docs/react/audiovisualizerprops.md +4 -4
  23. package/generated-docs/react/carousellayoutprops.md +5 -5
  24. package/generated-docs/react/chatentryprops.md +6 -6
  25. package/generated-docs/react/chatmessage.md +25 -0
  26. package/generated-docs/{core/participantclickevent.track.md → react/chatmessage.message.md} +3 -3
  27. package/generated-docs/react/{chatprops.messageencoder.md → chatmessage.timestamp.md} +3 -3
  28. package/generated-docs/react/chatprops.md +2 -4
  29. package/generated-docs/react/component/audiotrack.md +6 -1
  30. package/generated-docs/react/component/chat.md +0 -10
  31. package/generated-docs/react/component/controlbar.md +5 -0
  32. package/generated-docs/react/component/layoutcontextprovider.md +35 -0
  33. package/generated-docs/react/component/livekitroom.md +5 -0
  34. package/generated-docs/react/component/mediadeviceselect.md +5 -0
  35. package/generated-docs/react/component/prejoin.md +12 -3
  36. package/generated-docs/react/component/roomaudiorenderer.md +12 -0
  37. package/generated-docs/react/controlbarprops.md +5 -4
  38. package/generated-docs/react/controlbarprops.saveuserchoices.md +17 -0
  39. package/generated-docs/react/focuslayoutcontainerprops.md +4 -4
  40. package/generated-docs/react/focuslayoutprops.md +5 -5
  41. package/generated-docs/react/focustoggleprops.md +5 -5
  42. package/generated-docs/react/gridlayoutprops.md +4 -4
  43. package/generated-docs/react/hook/useaudioplayback.md +34 -0
  44. package/generated-docs/react/hook/usechat.md +2 -5
  45. package/generated-docs/react/hook/usefacingmode.md +35 -0
  46. package/generated-docs/react/hook/useisencrypted.md +29 -0
  47. package/generated-docs/react/hook/uselivekitroom.md +3 -0
  48. package/generated-docs/react/hook/usemediadeviceselect.md +5 -0
  49. package/generated-docs/react/hook/usepagination.md +52 -0
  50. package/generated-docs/react/hook/usepersistentuserchoices.md +38 -0
  51. package/generated-docs/react/hook/usepreviewtracks.md +32 -0
  52. package/generated-docs/react/hook/usestartaudio.md +43 -0
  53. package/generated-docs/react/hook/usestartvideo.md +43 -0
  54. package/generated-docs/react/hook/useswipe.md +44 -0
  55. package/generated-docs/react/index.md +188 -163
  56. package/generated-docs/react/layoutcontextproviderprops.md +26 -0
  57. package/generated-docs/react/layoutcontextproviderprops.onpinchange.md +13 -0
  58. package/generated-docs/react/layoutcontextproviderprops.onwidgetchange.md +13 -0
  59. package/generated-docs/react/layoutcontextproviderprops.value.md +13 -0
  60. package/generated-docs/react/livekitroomprops.md +1 -0
  61. package/generated-docs/react/livekitroomprops.onencryptionerror.md +13 -0
  62. package/generated-docs/react/localuserchoices.md +4 -2
  63. package/generated-docs/react/mediadeviceselectprops.md +3 -2
  64. package/generated-docs/react/mediadeviceselectprops.onerror.md +13 -0
  65. package/generated-docs/react/messagedecoder.md +20 -0
  66. package/generated-docs/react/messageencoder.md +20 -0
  67. package/generated-docs/react/meta-data.json +1 -1
  68. package/generated-docs/react/participanttileprops.md +8 -8
  69. package/generated-docs/react/pinstate.md +20 -0
  70. package/generated-docs/react/prejoinprops.md +15 -12
  71. package/generated-docs/react/prejoinprops.persistuserchoices.md +17 -0
  72. package/generated-docs/react/prejoinprops.showe2eeoptions.md +10 -0
  73. package/generated-docs/react/{chatprops.messagedecoder.md → receivedchatmessage.from.md} +3 -3
  74. package/generated-docs/react/receivedchatmessage.md +26 -0
  75. package/generated-docs/react/roomaudiorendererprops.md +25 -0
  76. package/generated-docs/react/roomaudiorendererprops.muted.md +21 -0
  77. package/generated-docs/react/roomaudiorendererprops.volume.md +17 -0
  78. package/generated-docs/react/setloglevel.md +20 -0
  79. package/generated-docs/react/trackloopprops.md +4 -4
  80. package/generated-docs/react/trackmutedindicatorprops.md +6 -6
  81. package/generated-docs/react/trackreference.md +22 -0
  82. package/generated-docs/react/trackreferenceorplaceholder.md +20 -0
  83. package/generated-docs/react/tracktoggleprops.md +7 -7
  84. package/generated-docs/react/usefocustoggleprops.md +6 -6
  85. package/generated-docs/react/usemediadeviceselectprops.md +1 -0
  86. package/generated-docs/react/usemediadeviceselectprops.onerror.md +17 -0
  87. package/generated-docs/react/useparticipanttileprops.md +9 -9
  88. package/generated-docs/react/usepersistentuserchoicesoptions.defaults.md +17 -0
  89. package/generated-docs/react/usepersistentuserchoicesoptions.md +28 -0
  90. package/generated-docs/react/usepersistentuserchoicesoptions.preventload.md +17 -0
  91. package/generated-docs/react/usepersistentuserchoicesoptions.preventsave.md +17 -0
  92. package/generated-docs/react/usestartaudioprops.md +25 -0
  93. package/generated-docs/react/usestartaudioprops.props.md +13 -0
  94. package/generated-docs/react/usestartaudioprops.room.md +13 -0
  95. package/generated-docs/react/usestartvideoprops.md +25 -0
  96. package/generated-docs/react/usestartvideoprops.props.md +13 -0
  97. package/generated-docs/react/usestartvideoprops.room.md +13 -0
  98. package/generated-docs/react/useswipeoptions.md +22 -0
  99. package/generated-docs/react/usetrackshookreturntype.md +1 -1
  100. package/generated-docs/react/usevisualstableupdateoptions.md +3 -3
  101. package/generated-docs/react/videoconferenceprops.md +2 -2
  102. package/generated-docs/react/videotrackprops.md +12 -12
  103. package/generated-docs/react/widgetstate.md +21 -0
  104. package/package.json +5 -6
  105. package/generated-docs/core/istrackreference.md +0 -16
  106. package/generated-docs/core/participantclickevent.md +0 -23
  107. package/generated-docs/core/participantclickevent.participant.md +0 -13
@@ -0,0 +1,32 @@
1
+ ---
2
+ {
3
+ "title": "usePreviewTracks",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/prefabs/PreJoin.tsx"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # usePreviewTracks
11
+
12
+ ## Import
13
+
14
+ ```typescript
15
+ import { usePreviewTracks } from "@livekit/components-react";
16
+ ```
17
+
18
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
19
+
20
+ ## Properties
21
+
22
+ {% parameter name="options" type="CreateLocalTracksOptions" optional=false %}
23
+ {% /parameter %}
24
+
25
+ {% parameter name="onError" type="(err: Error) => void" optional=true %}
26
+ {% /parameter %}
27
+
28
+ ## Returns
29
+
30
+ ```typescript
31
+ LocalTrack[] | undefined
32
+ ```
@@ -0,0 +1,43 @@
1
+ ---
2
+ {
3
+ "title": "useStartAudio",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useStartAudio.ts"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # useStartAudio
11
+
12
+ In many browsers to start audio playback, the user must perform a user-initiated event such as clicking a button. The `useStatAudio` hook returns an object with a boolean `canPlayAudio` flag that indicates whether audio playback is allowed in the current context, as well as a `startAudio` function that can be called in a button `onClick` callback to start audio playback in the current context.
13
+
14
+ ## Import
15
+
16
+ ```typescript
17
+ import { useStartAudio } from "@livekit/components-react";
18
+ ```
19
+
20
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
21
+
22
+ ## Properties
23
+
24
+ {% parameter name="props" type="React.ButtonHTMLAttributes<HTMLButtonElement>" optional=false %}
25
+ {% /parameter %}
26
+
27
+ {% parameter name="room" type="Room" optional=true %}
28
+ {% /parameter %}
29
+
30
+ ## Returns
31
+
32
+ ```typescript
33
+ {
34
+ mergedProps: React.ButtonHTMLAttributes<HTMLButtonElement> & {
35
+ className: string;
36
+ onClick: () => void;
37
+ style: {
38
+ display: string;
39
+ };
40
+ };
41
+ canPlayAudio: boolean;
42
+ }
43
+ ```
@@ -0,0 +1,43 @@
1
+ ---
2
+ {
3
+ "title": "useStartVideo",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useStartVideo.ts"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # useStartVideo
11
+
12
+ In some browsers to start video playback in low power mode, the user must perform a user-initiated event such as clicking a button. The `useStartVideo` hook returns an object with a boolean `canPlayVideo` flag that indicates whether video playback is allowed in the current context, as well as a `startVideo` function that can be called in a button `onClick` callback to start video playback in the current context.
13
+
14
+ ## Import
15
+
16
+ ```typescript
17
+ import { useStartVideo } from "@livekit/components-react";
18
+ ```
19
+
20
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
21
+
22
+ ## Properties
23
+
24
+ {% parameter name="props" type="React.ButtonHTMLAttributes<HTMLButtonElement>" optional=false %}
25
+ {% /parameter %}
26
+
27
+ {% parameter name="room" type="Room" optional=true %}
28
+ {% /parameter %}
29
+
30
+ ## Returns
31
+
32
+ ```typescript
33
+ {
34
+ mergedProps: React.ButtonHTMLAttributes<HTMLButtonElement> & {
35
+ className: string;
36
+ onClick: () => void;
37
+ style: {
38
+ display: string;
39
+ };
40
+ };
41
+ canPlayVideo: boolean;
42
+ }
43
+ ```
@@ -0,0 +1,44 @@
1
+ ---
2
+ {
3
+ "title": "useSwipe",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useSwipe.ts"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # useSwipe
11
+
12
+ Simple implementation to detect horizontal swipe actions. Accepts callbacks for on right and left swipes.
13
+
14
+ ## Import
15
+
16
+ ```typescript
17
+ import { useSwipe } from "@livekit/components-react";
18
+ ```
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ <div
24
+ onTouchStart={onTouchStart}
25
+ onTouchMove={onTouchMove}
26
+ onTouchEnd={onTouchEnd}
27
+ >
28
+ ```
29
+
30
+ {% partial file="p_usage.md" variables={exampleCount: 1} /%}
31
+
32
+ ## Properties
33
+
34
+ {% parameter name="element" type="React.RefObject<HTMLElement>" optional=false %}
35
+ {% /parameter %}
36
+
37
+ {% parameter name="options" type="UseSwipeOptions" optional=true %}
38
+ {% /parameter %}
39
+
40
+ ## Returns
41
+
42
+ ```typescript
43
+ void
44
+ ```