@livekit/components-js-docs 0.1.1 → 0.1.2

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 (46) hide show
  1. package/LICENSE +201 -0
  2. package/generated-docs/core/createurlregexp.md +4 -4
  3. package/generated-docs/core/index.md +4 -1
  4. package/generated-docs/core/loaduserchoices.md +27 -0
  5. package/generated-docs/{react → core}/localuserchoices.md +4 -2
  6. package/generated-docs/core/saveuserchoices.md +20 -0
  7. package/generated-docs/react/audiotrackprops.md +12 -11
  8. package/generated-docs/react/audiotrackprops.muted.md +21 -0
  9. package/generated-docs/react/audiotrackprops.volume.md +1 -1
  10. package/generated-docs/react/component/audiotrack.md +6 -1
  11. package/generated-docs/react/component/controlbar.md +5 -0
  12. package/generated-docs/react/component/layoutcontextprovider.md +35 -0
  13. package/generated-docs/react/component/prejoin.md +12 -3
  14. package/generated-docs/react/component/roomaudiorenderer.md +12 -0
  15. package/generated-docs/react/controlbarprops.md +5 -4
  16. package/generated-docs/react/controlbarprops.saveuserchoices.md +17 -0
  17. package/generated-docs/react/hook/useaudioplayback.md +34 -0
  18. package/generated-docs/react/hook/usechat.md +1 -1
  19. package/generated-docs/react/hook/usefacingmode.md +35 -0
  20. package/generated-docs/react/hook/usepagination.md +52 -0
  21. package/generated-docs/react/hook/usepersistentuserchoices.md +38 -0
  22. package/generated-docs/react/hook/usepreviewtracks.md +32 -0
  23. package/generated-docs/react/hook/usestartaudio.md +43 -0
  24. package/generated-docs/react/hook/useswipe.md +44 -0
  25. package/generated-docs/react/index.md +81 -69
  26. package/generated-docs/react/layoutcontextproviderprops.md +26 -0
  27. package/generated-docs/react/layoutcontextproviderprops.onpinchange.md +13 -0
  28. package/generated-docs/react/layoutcontextproviderprops.onwidgetchange.md +13 -0
  29. package/generated-docs/react/layoutcontextproviderprops.value.md +13 -0
  30. package/generated-docs/react/meta-data.json +1 -1
  31. package/generated-docs/react/prejoinprops.md +15 -12
  32. package/generated-docs/react/prejoinprops.persistuserchoices.md +17 -0
  33. package/generated-docs/react/prejoinprops.showe2eeoptions.md +10 -0
  34. package/generated-docs/react/roomaudiorendererprops.md +25 -0
  35. package/generated-docs/react/roomaudiorendererprops.muted.md +21 -0
  36. package/generated-docs/react/roomaudiorendererprops.volume.md +17 -0
  37. package/generated-docs/react/usepersistentuserchoicesoptions.defaults.md +17 -0
  38. package/generated-docs/react/usepersistentuserchoicesoptions.md +28 -0
  39. package/generated-docs/react/usepersistentuserchoicesoptions.preventload.md +17 -0
  40. package/generated-docs/react/usepersistentuserchoicesoptions.preventsave.md +17 -0
  41. package/generated-docs/react/usestartaudioprops.md +25 -0
  42. package/generated-docs/react/usestartaudioprops.props.md +13 -0
  43. package/generated-docs/react/usestartaudioprops.room.md +13 -0
  44. package/generated-docs/react/useswipeoptions.md +22 -0
  45. package/generated-docs/react/videotrackprops.md +2 -2
  46. package/package.json +5 -6
@@ -0,0 +1,17 @@
1
+ ---
2
+ { "title": "PreJoinProps.persistUserChoices property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # PreJoinProps.persistUserChoices property
8
+
9
+ If true, user choices are persisted across sessions.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ persistUserChoices?: boolean;
15
+ ```
16
+
17
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -6,8 +6,18 @@
6
6
 
7
7
  # PreJoinProps.showE2EEOptions property
8
8
 
9
+ {% callout type="caution" variation="normal" %}
10
+
11
+ This API is deprecated:
12
+
13
+ E2EE options will be removed from PreJoin in a future version \*
14
+
15
+ {% /callout %}
16
+
9
17
  **Signature:**
10
18
 
11
19
  ```typescript
12
20
  showE2EEOptions?: boolean;
13
21
  ```
22
+
23
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,25 @@
1
+ ---
2
+ {
3
+ "title": "RoomAudioRendererProps interface",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/components/RoomAudioRenderer.tsx"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # RoomAudioRendererProps interface
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ export interface RoomAudioRendererProps
16
+ ```
17
+
18
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
19
+
20
+ ## Properties
21
+
22
+ | Property | Type | Description |
23
+ | --------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
24
+ | [muted?](./react/roomaudiorendererprops.muted.md) | boolean | _(Optional)_ If set to <code>true</code>, mutes all audio tracks rendered by the component. |
25
+ | [volume?](./react/roomaudiorendererprops.volume.md) | number | _(Optional)_ Sets the volume for all audio tracks rendered by this component. By default, the range is between <code>0.0</code> and <code>1.0</code>. |
@@ -0,0 +1,21 @@
1
+ ---
2
+ { "title": "RoomAudioRendererProps.muted property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # RoomAudioRendererProps.muted property
8
+
9
+ If set to `true`<!-- -->, mutes all audio tracks rendered by the component.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ muted?: boolean;
15
+ ```
16
+
17
+ ## Remarks
18
+
19
+ If set to `true`<!-- -->, the server will stop sending audio track data to the client.
20
+
21
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,17 @@
1
+ ---
2
+ { "title": "RoomAudioRendererProps.volume property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # RoomAudioRendererProps.volume property
8
+
9
+ Sets the volume for all audio tracks rendered by this component. By default, the range is between `0.0` and `1.0`<!-- -->.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ volume?: number;
15
+ ```
16
+
17
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,17 @@
1
+ ---
2
+ { "title": "UsePersistentUserChoicesOptions.defaults property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # UsePersistentUserChoicesOptions.defaults property
8
+
9
+ The default value to use if reading from local storage returns no results or fails.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ defaults?: Partial<LocalUserChoices>;
15
+ ```
16
+
17
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,28 @@
1
+ ---
2
+ {
3
+ "title": "UsePersistentUserChoicesOptions interface",
4
+ "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/usePersistentUserChoices.ts"
5
+ }
6
+ ---
7
+
8
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
+
10
+ # UsePersistentUserChoicesOptions interface
11
+
12
+ Options for the `usePersistentDeviceSettings` hook.
13
+
14
+ **Signature:**
15
+
16
+ ```typescript
17
+ export interface UsePersistentUserChoicesOptions
18
+ ```
19
+
20
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
21
+
22
+ ## Properties
23
+
24
+ | Property | Type | Description |
25
+ | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
26
+ | [defaults?](./react/usepersistentuserchoicesoptions.defaults.md) | Partial&lt;[LocalUserChoices](./core/localuserchoices.md)<!-- -->&gt; | _(Optional)_ The default value to use if reading from local storage returns no results or fails. |
27
+ | [preventLoad?](./react/usepersistentuserchoicesoptions.preventload.md) | boolean | _(Optional)_ Whether to prevent loading user choices from persistent storage and use <code>defaults</code> instead. |
28
+ | [preventSave?](./react/usepersistentuserchoicesoptions.preventsave.md) | boolean | _(Optional)_ Whether to prevent saving to persistent storage. |
@@ -0,0 +1,17 @@
1
+ ---
2
+ { "title": "UsePersistentUserChoicesOptions.preventLoad property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # UsePersistentUserChoicesOptions.preventLoad property
8
+
9
+ Whether to prevent loading user choices from persistent storage and use `defaults` instead.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ preventLoad?: boolean;
15
+ ```
16
+
17
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,17 @@
1
+ ---
2
+ { "title": "UsePersistentUserChoicesOptions.preventSave property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # UsePersistentUserChoicesOptions.preventSave property
8
+
9
+ Whether to prevent saving to persistent storage.
10
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ preventSave?: boolean;
15
+ ```
16
+
17
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -0,0 +1,25 @@
1
+ ---
2
+ {
3
+ "title": "UseStartAudioProps interface",
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
+ # UseStartAudioProps interface
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ export interface UseStartAudioProps
16
+ ```
17
+
18
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
19
+
20
+ ## Properties
21
+
22
+ | Property | Type | Description |
23
+ | -------------------------------------------- | --------------------------------------------------- | ------------ |
24
+ | [props](./react/usestartaudioprops.props.md) | React.ButtonHTMLAttributes&lt;HTMLButtonElement&gt; | |
25
+ | [room?](./react/usestartaudioprops.room.md) | Room | _(Optional)_ |
@@ -0,0 +1,13 @@
1
+ ---
2
+ { "title": "UseStartAudioProps.props property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # UseStartAudioProps.props property
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ props: React.ButtonHTMLAttributes<HTMLButtonElement>;
13
+ ```
@@ -0,0 +1,13 @@
1
+ ---
2
+ { "title": "UseStartAudioProps.room property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # UseStartAudioProps.room property
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ room?: Room;
13
+ ```
@@ -0,0 +1,22 @@
1
+ ---
2
+ {
3
+ "title": "UseSwipeOptions type",
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
+ # UseSwipeOptions type
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ export type UseSwipeOptions = {
16
+ minSwipeDistance?: number;
17
+ onLeftSwipe?: () => void;
18
+ onRightSwipe?: () => void;
19
+ };
20
+ ```
21
+
22
+ {% partial file="p_usage.md" variables={exampleCount: 0} /%}
@@ -12,10 +12,10 @@
12
12
  **Signature:**
13
13
 
14
14
  ```typescript
15
- export interface VideoTrackProps extends React.HTMLAttributes<HTMLVideoElement>
15
+ export interface VideoTrackProps extends React.VideoHTMLAttributes<HTMLVideoElement>
16
16
  ```
17
17
 
18
- **Extends:** React.HTMLAttributes&lt;HTMLVideoElement&gt;
18
+ **Extends:** React.VideoHTMLAttributes&lt;HTMLVideoElement&gt;
19
19
 
20
20
  {% partial file="p_usage.md" variables={exampleCount: 0} /%}
21
21
 
package/package.json CHANGED
@@ -1,16 +1,15 @@
1
1
  {
2
2
  "name": "@livekit/components-js-docs",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Automatically generated documentation pages for LiveKit Components JS. Intended to be consumed by the documentation page.",
5
- "scripts": {
6
- "yalc:publish": "yalc publish --private --push --replace",
7
- "yalc:publish:watch": "nodemon --delay 1 --watch \"generated-docs/**/*\" -e md -x \"yarn yalc:publish\""
8
- },
9
5
  "repository": {
10
6
  "type": "git",
11
7
  "url": "git+https://github.com/livekit/components-js.git",
12
8
  "directory": "/docs/beta-docs"
13
9
  },
10
+ "dependencies": {
11
+ "@livekit/components-react": "1.4.0"
12
+ },
14
13
  "author": "",
15
14
  "license": "Apache-2.0",
16
15
  "bugs": {
@@ -24,4 +23,4 @@
24
23
  "publishConfig": {
25
24
  "access": "restricted"
26
25
  }
27
- }
26
+ }