@videojs/html 10.2.0 → 10.4.0

package/docs/reference/api/player-store.md

@@ -31,8 +31,10 @@ Each feature links to the same entry on its reference page.
 | `ended` | `boolean` | [`playbackFeature`](./feature-playback.md#playback-state-ended) | Whether playback has reached the end. |
 | `started` | `boolean` | [`playbackFeature`](./feature-playback.md#playback-state-started) | Whether playback has started (played or seeked). |
 | `waiting` | `boolean` | [`playbackFeature`](./feature-playback.md#playback-state-waiting) | Whether playback is stalled waiting for data. |
+| `autoplay` | `boolean` | [`playbackFeature`](./feature-playback.md#playback-state-autoplay) | Whether the media starts playing on its own once it can. |
+| `autoplaying` | `boolean` | [`playbackFeature`](./feature-playback.md#playback-state-autoplaying) | Whether the media is trying to autoplay: `autoplay` is set, and playback hasn't started yet. Clears when playback starts, when `pause()` cancels it, and when the autoplay is refused. Browsers don't announce a refusal, so it shows as the media being able to play through but staying paused; embeds report one with a `pause` or `error` event. Controls treat it as playback that's about to begin. |
 | `play` | `() => Promise<void>` | [`playbackFeature`](./feature-playback.md#playback-action-play) | Start playback. Updates `paused` immediately when the media starts. |
-| `pause` | `() => void` | [`playbackFeature`](./feature-playback.md#playback-action-pause) | Pause playback. Updates `paused` immediately. |
+| `pause` | `() => void` | [`playbackFeature`](./feature-playback.md#playback-action-pause) | Pause playback. Updates `paused` immediately, and cancels a pending autoplay. |
 | `currentTime` | `number` | [`timeFeature`](./feature-time.md#time-state-currentTime) | Current playback position in seconds. |
 | `duration` | `number` | [`timeFeature`](./feature-time.md#time-state-duration) | Total duration in seconds (0 if unknown). |
 | `seeking` | `boolean` | [`timeFeature`](./feature-time.md#time-state-seeking) | Whether a seek operation is in progress. |
@@ -53,15 +55,18 @@ Each feature links to the same entry on its reference page.
 | `toggleControls` | `(forceShow?: boolean) => boolean` | [`controlsFeature`](./feature-controls.md#controls-action-toggleControls) | Toggle controls visibility, or force it with `forceShow`. Returns the new `controlsVisible` value. |
 | `buffered` | `[number, number][]` | [`bufferFeature`](./feature-buffer.md#buffer-state-buffered) | Buffered time ranges as \[start, end\] tuples. |
 | `seekable` | `[number, number][]` | [`bufferFeature`](./feature-buffer.md#buffer-state-seekable) | Seekable time ranges as \[start, end\] tuples. |
-| `textTrackList` | `MediaTextTrack[]` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-textTrackList) | All text tracks available on the media component. |
+| `textTrackList` | `MediaTextTrack[]` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-textTrackList) | Every text track: the media's, then those the app added through the player. `source` tells them apart. |
 | `subtitlesShowing` | `boolean` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-subtitlesShowing) | Whether a captions/subtitles track is showing. |
-| `chaptersCues` | `MediaTextCue[]` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-chaptersCues) | Cues from the first `kind="chapters"` track, with cue ends clamped to a finite media duration. |
+| `chaptersCues` | `MediaTextCue[]` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-chaptersCues) | Cues from the media's first `kind="chapters"` track, with cue ends clamped to a finite media duration. When the media has none, cues from the first chapters track the app added, where a chapter without an end runs to the next one and the last to the end of the media. |
 | `thumbnailsTrack` | `{ cues: MediaTextCue[]; src: string \| null; crossOrigin: 'anonymous' \| 'use-credentials' \| null } \| null` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-thumbnailsTrack) | The first thumbnails track, or `null` when there is none. |
+| `addTextTrack` | `{ <Cue extends MediaTextCue>(track: TextTrackDefinition<Cue>, content?: TextTrackContent<InferCueValue<Cue>>): TextTrackHandle<InferCueValue<Cue>>; <Value = unknown>(init: TextTrackInit<Value>): TextTrackHandle<Value> }` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-state-addTextTrack) | Add a text track from the app. It works on any media, sits next to the media's tracks in `textTrackList`, and its cues are read like theirs. Like a `<track>` element, it stays until it's removed, through source changes and media swaps. |
 | `toggleSubtitles` | `(forceShow?: boolean) => boolean` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-action-toggleSubtitles) | Toggle captions/subtitles visibility. Showing enables one caption/subtitle track. A track already showing stays selected. Otherwise, selection prefers the last track shown, then a track matching the browser language, then the first available track. Returns whether a track is showing. |
 | `selectSubtitlesTrack` | `(id: string \| null) => void` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-action-selectSubtitlesTrack) | Show the captions/subtitles track with `id`, or turn captions/subtitles off with `null`. |
-| `playbackRates` | `readonly number[]` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-state-playbackRates) | Available playback rates. |
+| `removeTextTrack` | `(id: string) => void` | [`textTrackFeature`](./feature-text-tracks.md#textTrack-action-removeTextTrack) | Remove a track the app added. Tracks from the media stay. |
 | `playbackRate` | `number` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-state-playbackRate) | Current playback rate. |
-| `setPlaybackRate` | `(rate: number) => void` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-action-setPlaybackRate) | Set the playback rate. |
+| `playbackRateAvailability` | `'available' \| 'unavailable' \| 'unsupported'` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-state-playbackRateAvailability) | Whether the media can change its playback rate. `unsupported` when the attached media has no `playbackRate` at all, such as an embed whose provider takes no speed command. |
+| `playbackRates` | `readonly number[]` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-state-playbackRates) | The default rates that fit the media's range. Set them through the player, not through the store. They are listed even when the media cannot change its rate, so check `playbackRateAvailability` before offering them. |
+| `setPlaybackRate` | `(rate: number) => void` | [`playbackRateFeature`](./feature-playback-rate.md#playbackRate-action-setPlaybackRate) | Set the playback rate, clamped to the rates the media accepts. |
 | `isPictureInPicture` | `boolean` | [`pipFeature`](./feature-pip.md#pip-state-isPictureInPicture) | Whether picture-in-picture mode is currently active. |
 | `pictureInPictureAvailability` | `'available' \| 'unavailable' \| 'unsupported'` | [`pipFeature`](./feature-pip.md#pip-state-pictureInPictureAvailability) | Whether picture-in-picture can be requested on this platform. |
 | `requestPictureInPicture` | `() => Promise<void>` | [`pipFeature`](./feature-pip.md#pip-action-requestPictureInPicture) | Enter picture-in-picture mode, exiting fullscreen first. Rejects before metadata is loaded. |
@@ -85,6 +90,8 @@ Each feature links to the same entry on its reference page.
 | `streamType` | `'on-demand' \| 'live' \| 'unknown'` | [`streamTypeFeature`](./feature-stream-type.md#streamType-state-streamType) | Current stream delivery type. Components use this to show live-specific UI (for example, a live indicator or a "jump to live edge" button) or hide the time display. |
 | `orientationLockType` | `'any' \| 'landscape' \| 'landscape-primary' \| 'landscape-secondary' \| 'natural' \| 'portrait' \| 'portrait-primary' \| 'portrait-secondary'` | [`orientationLockFeature`](./feature-orientation-lock.md#orientationLock-state-orientationLockType) | Screen orientation type locked while fullscreen is active. |
 | `setOrientationLockType` | `(value: 'any' \| 'landscape' \| 'landscape-primary' \| 'landscape-secondary' \| 'natural' \| 'portrait' \| 'portrait-primary' \| 'portrait-secondary' \| null \| undefined) => void` | [`orientationLockFeature`](./feature-orientation-lock.md#orientationLock-action-setOrientationLockType) | Sets the locked orientation type. A missing value, including an empty one, restores the default. |
+| `textCues` | `MediaTrackCues[]` | [`textCuesFeature`](./feature-text-cues.md#textCues-state-textCues) | Cues for the tracks being read: `metadata` and `chapters` tracks that aren't disabled, except the thumbnails track, plus any track a `watchTextCues()` filter matches. In `textTrackList` order. |
+| `watchTextCues` | `(filter: { kind?: TextTrackKind \| readonly TextTrackKind[]; label?: string; language?: string } \| ((track: MediaTextTrack) => boolean)) => (() => void)` | [`textCuesFeature`](./feature-text-cues.md#textCues-action-watchTextCues) | Read cues for more tracks, such as captions for an interactive transcript. Cues are tracked until the returned function is called. |
 
 ## Features by preset
 
@@ -98,7 +105,7 @@ Each column is a preset's feature bundle. A feature no bundle includes is opt-in
 | [`fullscreenFeature`](./feature-fullscreen.md) | ✓ | – | – | ✓ |
 | [`controlsFeature`](./feature-controls.md) | ✓ | – | – | ✓ |
 | [`bufferFeature`](./feature-buffer.md) | ✓ | ✓ | ✓ | ✓ |
-| [`textTrackFeature`](./feature-text-tracks.md) | ✓ | – | – | ✓ |
+| [`textTrackFeature`](./feature-text-tracks.md) | ✓ | ✓ | ✓ | ✓ |
 | [`playbackRateFeature`](./feature-playback-rate.md) | ✓ | ✓ | – | – |
 | [`pipFeature`](./feature-pip.md) | ✓ | – | – | ✓ |
 | [`errorFeature`](./feature-error.md) | ✓ | ✓ | ✓ | ✓ |
@@ -109,4 +116,5 @@ Each column is a preset's feature bundle. A feature no bundle includes is opt-in
 | [`remotePlaybackFeature`](./feature-remote-playback.md) | ✓ | – | – | ✓ |
 | [`liveFeature`](./feature-live.md) | – | – | ✓ | ✓ |
 | [`streamTypeFeature`](./feature-stream-type.md) | – | – | – | – |
-| [`orientationLockFeature`](./feature-orientation-lock.md) | – | – | – | – |
+| [`orientationLockFeature`](./feature-orientation-lock.md) | – | – | – | – |
+| [`textCuesFeature`](./feature-text-cues.md) | ✓ | ✓ | ✓ | ✓ |

package/docs/reference/api/preset-audio.md

@@ -2,7 +2,7 @@
 
 The audio-only preset — a player, feature bundle, skins, and media for on-demand audio
 
-`@videojs/html/audio` is the preset for on-demand audio. It bundles the `<audio-player>` element, the `audioFeatures` bundle it is configured with, and two skins, and plays through the browser’s native `<audio>`. See [Presets](../../guides/presets.md) for how presets fit together and how to customize one.
+`@videojs/html/audio` is the preset for on-demand audio. It bundles the `<audio-player>` element, the `audioFeatures` bundle it is configured with, and four skins, and plays through the browser’s native `<audio>`. See [Presets](../../guides/presets.md) for how presets fit together and how to customize one.
 
 ## Import
 
@@ -11,13 +11,13 @@ import '@videojs/html/audio/player';
 import '@videojs/html/audio/skin';
 ```
 
-Import `@videojs/html/audio/neutral-skin` instead for the neutral skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
+Import `@videojs/html/audio/neutral-skin`, `compat-skin`, or `scaffold-skin` instead for another skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/audio.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/audio.js"></script>
 ```
 
-`audio-neutral.js` registers the neutral skin instead, and `audio-player.js` registers `<audio-player>` alone.
+`audio-neutral.js`, `audio-compat.js`, and `audio-scaffold.js` register the other skins instead, and `audio-player.js` registers `<audio-player>` alone.
 
 ## Usage
 
@@ -44,7 +44,7 @@ Import `@videojs/html/audio/neutral-skin` instead for the neutral skin. Or load
 | --- | --- | --- |
 | `content-title` | `contentTitle` | The title to display. Takes precedence over the title the media reports. |
 | `poster` | `poster` | The poster to display. Takes precedence over the poster the media reports. |
-| `keep-alive` | — | Keeps the player and its store alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
+| `keep-alive` | — | Keeps the player, its store, and the UI elements inside it alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
 
 `content-title` and `poster` come from the [metadata feature](./feature-metadata.md#player-inputs). The element’s read-only `store` property returns its player store.
 
@@ -62,6 +62,8 @@ The preset root also exports a `PlayerController` bound to the audio player’s
 | [`timeFeature`](./feature-time.md) | Playback position and duration state for the player store |
 | [`sourceFeature`](./feature-source.md) | Media source state and actions for the player store |
 | [`bufferFeature`](./feature-buffer.md) | Buffered and seekable time range state for the player store |
+| [`textTrackFeature`](./feature-text-tracks.md) | Subtitles, captions, and chapter track state for the player store |
+| [`textCuesFeature`](./feature-text-cues.md) | Cues and active cues from metadata, chapters, and app text tracks |
 | [`errorFeature`](./feature-error.md) | Media error state and actions for the player store |
 | [`metadataFeature`](./feature-metadata.md) | Resolved title and poster values for the player store |
 
@@ -88,6 +90,10 @@ customElements.define('my-audio-player', PlayerElement);
 
 - [AudioSkin](../components/audio-skin.md) — the default skin, with the modern, frosted look.
 - [NeutralAudioSkin](../components/audio-neutral-skin.md) — the visually lighter variant, closer to a classic control bar.
+- [CompatAudioSkin](../components/audio-compat-skin.md) — the plain, unbranded variant that avoids newer visual effects, so it looks consistent across browsers.
+- [ScaffoldAudioSkin](../components/audio-scaffold-skin.md) — the minimally styled variant of Compat, a foundation for your own design.
+
+See [Choose a skin](../../guides/skins.md#choose-a-skin) to compare them.
 
 ## Media
 
@@ -104,6 +110,8 @@ The preset root, `@videojs/html/audio`, has no side effects. Importing it never
 | `audioFeatures` | The [feature bundle](#feature-bundle). |
 | `AudioSkinElement` | The default [skin](#skins) element class. |
 | `NeutralAudioSkinElement` | The neutral [skin](#skins) element class. |
+| `CompatAudioSkinElement` | The compat [skin](#skins) element class. |
+| `ScaffoldAudioSkinElement` | The scaffold [skin](#skins) element class. |
 
 Registration entry points are side-effect-only:
 
@@ -112,5 +120,7 @@ Registration entry points are side-effect-only:
 | `@videojs/html/audio/player` | `<audio-player>` |
 | `@videojs/html/audio/skin` | `<audio-skin>`, `<media-container>`, and the UI elements the skin composes |
 | `@videojs/html/audio/neutral-skin` | `<audio-neutral-skin>`, `<media-container>`, and the UI elements the neutral skin composes |
+| `@videojs/html/audio/compat-skin` | `<audio-compat-skin>`, `<media-container>`, and the UI elements the compat skin composes |
+| `@videojs/html/audio/scaffold-skin` | `<audio-scaffold-skin>`, `<media-container>`, and the UI elements the scaffold skin composes |
 | `@videojs/html/audio/ui` | `<media-container>` and the UI elements of the default skin, without the skin, for a layout you write yourself |
 | `@videojs/html/audio/neutral-ui` | `<media-container>` and the UI elements of the neutral skin, without the skin |

package/docs/reference/api/preset-background.md

@@ -15,7 +15,7 @@ import '@videojs/html/background/video';
 Or load the [CDN](../../guides/cdn.md) bundle that registers all three:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/background.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/background.js"></script>
 ```
 
 Unlike the other presets, the background preset has one bundle and no player-only bundle.
@@ -44,7 +44,7 @@ Unlike the other presets, the background preset has one bundle and no player-onl
 
 | Attribute | Property | Description |
 | --- | --- | --- |
-| `keep-alive` | — | Keeps the player and its store alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
+| `keep-alive` | — | Keeps the player, its store, and the UI elements inside it alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
 
 The bundle has no feature that takes player inputs, so the element has no player-input attributes such as `content-title` or `poster`; `keep-alive` is the only attribute it reads. Its read-only `store` property returns its player store.
 

package/docs/reference/api/preset-live-audio.md

@@ -2,7 +2,7 @@
 
 The live audio preset — a player, feature bundle, skins, and media for live audio streams
 
-`@videojs/html/live-audio` is the preset for live audio streams. It bundles the `<live-audio-player>` element, the `liveAudioFeatures` bundle it is configured with, and two skins that swap the time slider and time displays for a Live button, and plays through the browser’s native `<audio>`. See [Presets](../../guides/presets.md) for how presets fit together and [Live streams](../../guides/live-streams.md) for playing a live source.
+`@videojs/html/live-audio` is the preset for live audio streams. It bundles the `<live-audio-player>` element, the `liveAudioFeatures` bundle it is configured with, and four skins that swap the time slider and time displays for a Live button, and plays through the browser’s native `<audio>`. See [Presets](../../guides/presets.md) for how presets fit together and [Live streams](../../guides/live-streams.md) for playing a live source.
 
 ## Import
 
@@ -11,13 +11,13 @@ import '@videojs/html/live-audio/player';
 import '@videojs/html/live-audio/skin';
 ```
 
-Import `@videojs/html/live-audio/neutral-skin` instead for the neutral skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
+Import `@videojs/html/live-audio/neutral-skin`, `compat-skin`, or `scaffold-skin` instead for another skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/live-audio.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/live-audio.js"></script>
 ```
 
-`live-audio-neutral.js` registers the neutral skin instead, and `live-audio-player.js` registers `<live-audio-player>` alone.
+`live-audio-neutral.js`, `live-audio-compat.js`, and `live-audio-scaffold.js` register the other skins instead, and `live-audio-player.js` registers `<live-audio-player>` alone.
 
 ## Usage
 
@@ -47,7 +47,7 @@ Live streams are usually HLS, so this example plays through an HLS media compone
 | --- | --- | --- |
 | `content-title` | `contentTitle` | The title to display. Takes precedence over the title the media reports. |
 | `poster` | `poster` | The poster to display. Takes precedence over the poster the media reports. |
-| `keep-alive` | — | Keeps the player and its store alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
+| `keep-alive` | — | Keeps the player, its store, and the UI elements inside it alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
 
 `content-title` and `poster` come from the [metadata feature](./feature-metadata.md#player-inputs). The element’s read-only `store` property returns its player store.
 
@@ -64,6 +64,8 @@ The preset root also exports a `PlayerController` bound to the live audio player
 | [`timeFeature`](./feature-time.md) | Playback position and duration state for the player store |
 | [`sourceFeature`](./feature-source.md) | Media source state and actions for the player store |
 | [`bufferFeature`](./feature-buffer.md) | Buffered and seekable time range state for the player store |
+| [`textTrackFeature`](./feature-text-tracks.md) | Subtitles, captions, and chapter track state for the player store |
+| [`textCuesFeature`](./feature-text-cues.md) | Cues and active cues from metadata, chapters, and app text tracks |
 | [`errorFeature`](./feature-error.md) | Media error state and actions for the player store |
 | [`liveFeature`](./feature-live.md) | Live edge state for the player store |
 | [`metadataFeature`](./feature-metadata.md) | Resolved title and poster values for the player store |
@@ -91,6 +93,10 @@ customElements.define('my-live-audio-player', PlayerElement);
 
 - [LiveAudioSkin](../components/live-audio-skin.md) — the default skin, which swaps the time controls for a Live button.
 - [NeutralLiveAudioSkin](../components/live-audio-neutral-skin.md) — the visually lighter variant, closer to a classic control bar.
+- [CompatLiveAudioSkin](../components/live-audio-compat-skin.md) — the plain, unbranded variant that avoids newer visual effects, so it looks consistent across browsers.
+- [ScaffoldLiveAudioSkin](../components/live-audio-scaffold-skin.md) — the minimally styled variant of Compat, a foundation for your own design.
+
+See [Choose a skin](../../guides/skins.md#choose-a-skin) to compare them.
 
 ## Media
 
@@ -107,6 +113,8 @@ The preset root, `@videojs/html/live-audio`, has no side effects. Importing it n
 | `liveAudioFeatures` | The [feature bundle](#feature-bundle). |
 | `LiveAudioSkinElement` | The default [skin](#skins) element class. |
 | `NeutralLiveAudioSkinElement` | The neutral [skin](#skins) element class. |
+| `CompatLiveAudioSkinElement` | The compat [skin](#skins) element class. |
+| `ScaffoldLiveAudioSkinElement` | The scaffold [skin](#skins) element class. |
 
 Registration entry points are side-effect-only:
 
@@ -115,5 +123,7 @@ Registration entry points are side-effect-only:
 | `@videojs/html/live-audio/player` | `<live-audio-player>` |
 | `@videojs/html/live-audio/skin` | `<live-audio-skin>`, `<media-container>`, and the UI elements the skin composes |
 | `@videojs/html/live-audio/neutral-skin` | `<live-audio-neutral-skin>`, `<media-container>`, and the UI elements the neutral skin composes |
+| `@videojs/html/live-audio/compat-skin` | `<live-audio-compat-skin>`, `<media-container>`, and the UI elements the compat skin composes |
+| `@videojs/html/live-audio/scaffold-skin` | `<live-audio-scaffold-skin>`, `<media-container>`, and the UI elements the scaffold skin composes |
 | `@videojs/html/live-audio/ui` | `<media-container>` and the UI elements of the default skin, without the skin, for a layout you write yourself |
 | `@videojs/html/live-audio/neutral-ui` | `<media-container>` and the UI elements of the neutral skin, without the skin |

package/docs/reference/api/preset-live-video.md

@@ -2,7 +2,7 @@
 
 The live video preset — a player, feature bundle, skins, and media for live video streams
 
-`@videojs/html/live-video` is the preset for live video streams. It bundles the `<live-video-player>` element, the `liveVideoFeatures` bundle it is configured with, and two skins that swap the time slider and time displays for a Live button, and plays through the browser’s native `<video>`. See [Presets](../../guides/presets.md) for how presets fit together and [Live streams](../../guides/live-streams.md) for playing a live source.
+`@videojs/html/live-video` is the preset for live video streams. It bundles the `<live-video-player>` element, the `liveVideoFeatures` bundle it is configured with, and four skins that swap the time slider and time displays for a Live button, and plays through the browser’s native `<video>`. See [Presets](../../guides/presets.md) for how presets fit together and [Live streams](../../guides/live-streams.md) for playing a live source.
 
 ## Import
 
@@ -11,13 +11,13 @@ import '@videojs/html/live-video/player';
 import '@videojs/html/live-video/skin';
 ```
 
-Import `@videojs/html/live-video/neutral-skin` instead for the neutral skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
+Import `@videojs/html/live-video/neutral-skin`, `compat-skin`, or `scaffold-skin` instead for another skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/live-video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/live-video.js"></script>
 ```
 
-`live-video-neutral.js` registers the neutral skin instead, and `live-video-player.js` registers `<live-video-player>` alone.
+`live-video-neutral.js`, `live-video-compat.js`, and `live-video-scaffold.js` register the other skins instead, and `live-video-player.js` registers `<live-video-player>` alone.
 
 ## Usage
 
@@ -47,7 +47,7 @@ Live streams are usually HLS, so this example plays through an HLS media compone
 | --- | --- | --- |
 | `content-title` | `contentTitle` | The title to display. Takes precedence over the title the media reports. |
 | `poster` | `poster` | The poster to display. Takes precedence over the poster the media reports. |
-| `keep-alive` | — | Keeps the player and its store alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
+| `keep-alive` | — | Keeps the player, its store, and the UI elements inside it alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
 
 `content-title` and `poster` come from the [metadata feature](./feature-metadata.md#player-inputs). The element’s read-only `store` property returns its player store.
 
@@ -69,6 +69,7 @@ The preset root also exports a `PlayerController` bound to the live video player
 | [`remotePlaybackFeature`](./feature-remote-playback.md) | Remote playback state and actions for the player store |
 | [`controlsFeature`](./feature-controls.md) | User activity and controls visibility state for the player store |
 | [`textTrackFeature`](./feature-text-tracks.md) | Subtitles, captions, and chapter track state for the player store |
+| [`textCuesFeature`](./feature-text-cues.md) | Cues and active cues from metadata, chapters, and app text tracks |
 | [`errorFeature`](./feature-error.md) | Media error state and actions for the player store |
 | [`liveFeature`](./feature-live.md) | Live edge state for the player store |
 | [`metadataFeature`](./feature-metadata.md) | Resolved title and poster values for the player store |
@@ -96,6 +97,10 @@ customElements.define('my-live-video-player', PlayerElement);
 
 - [LiveVideoSkin](../components/live-video-skin.md) — the default skin, which swaps the time controls for a Live button.
 - [NeutralLiveVideoSkin](../components/live-video-neutral-skin.md) — the visually lighter variant, closer to a classic control bar.
+- [CompatLiveVideoSkin](../components/live-video-compat-skin.md) — the plain, unbranded variant that avoids newer visual effects, so it looks consistent across browsers.
+- [ScaffoldLiveVideoSkin](../components/live-video-scaffold-skin.md) — the minimally styled variant of Compat, a foundation for your own design.
+
+See [Choose a skin](../../guides/skins.md#choose-a-skin) to compare them.
 
 ## Media
 
@@ -112,6 +117,8 @@ The preset root, `@videojs/html/live-video`, has no side effects. Importing it n
 | `liveVideoFeatures` | The [feature bundle](#feature-bundle). |
 | `LiveVideoSkinElement` | The default [skin](#skins) element class. |
 | `NeutralLiveVideoSkinElement` | The neutral [skin](#skins) element class. |
+| `CompatLiveVideoSkinElement` | The compat [skin](#skins) element class. |
+| `ScaffoldLiveVideoSkinElement` | The scaffold [skin](#skins) element class. |
 
 Registration entry points are side-effect-only:
 
@@ -120,5 +127,7 @@ Registration entry points are side-effect-only:
 | `@videojs/html/live-video/player` | `<live-video-player>` |
 | `@videojs/html/live-video/skin` | `<live-video-skin>`, `<media-container>`, and the UI elements the skin composes |
 | `@videojs/html/live-video/neutral-skin` | `<live-video-neutral-skin>`, `<media-container>`, and the UI elements the neutral skin composes |
+| `@videojs/html/live-video/compat-skin` | `<live-video-compat-skin>`, `<media-container>`, and the UI elements the compat skin composes |
+| `@videojs/html/live-video/scaffold-skin` | `<live-video-scaffold-skin>`, `<media-container>`, and the UI elements the scaffold skin composes |
 | `@videojs/html/live-video/ui` | `<media-container>` and the UI elements of the default skin, without the skin, for a layout you write yourself |
 | `@videojs/html/live-video/neutral-ui` | `<media-container>` and the UI elements of the neutral skin, without the skin |

package/docs/reference/api/preset-video.md

@@ -2,7 +2,7 @@
 
 The general-purpose video preset — a player, feature bundle, skins, and media for on-demand video
 
-`@videojs/html/video` is the general-purpose preset for on-demand video. It bundles the `<video-player>` element, the `videoFeatures` bundle it is configured with, and two skins, and plays through the browser’s native `<video>`. See [Presets](../../guides/presets.md) for how presets fit together and how to customize one.
+`@videojs/html/video` is the general-purpose preset for on-demand video. It bundles the `<video-player>` element, the `videoFeatures` bundle it is configured with, and four skins, and plays through the browser’s native `<video>`. See [Presets](../../guides/presets.md) for how presets fit together and how to customize one.
 
 ## Import
 
@@ -11,13 +11,13 @@ import '@videojs/html/video/player';
 import '@videojs/html/video/skin';
 ```
 
-Import `@videojs/html/video/neutral-skin` instead for the neutral skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
+Import `@videojs/html/video/neutral-skin`, `compat-skin`, or `scaffold-skin` instead for another skin. Or load one [CDN](../../guides/cdn.md) bundle that registers the player and a skin together:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/video.js"></script>
 ```
 
-`video-neutral.js` registers the neutral skin instead, and `video-player.js` registers `<video-player>` alone.
+`video-neutral.js`, `video-compat.js`, and `video-scaffold.js` register the other skins instead, and `video-player.js` registers `<video-player>` alone.
 
 ## Usage
 
@@ -44,7 +44,7 @@ Import `@videojs/html/video/neutral-skin` instead for the neutral skin. Or load
 | --- | --- | --- |
 | `content-title` | `contentTitle` | The title to display. Takes precedence over the title the media reports. |
 | `poster` | `poster` | The poster to display. Takes precedence over the poster the media reports. |
-| `keep-alive` | — | Keeps the player and its store alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
+| `keep-alive` | — | Keeps the player, its store, and the UI elements inside it alive when the element leaves the DOM. Call `destroy()` when you’re done with it. |
 
 `content-title` and `poster` come from the [metadata feature](./feature-metadata.md#player-inputs). The element’s read-only `store` property returns its player store.
 
@@ -69,6 +69,7 @@ The preset root also exports a `PlayerController` bound to the video player’s
 | [`remotePlaybackFeature`](./feature-remote-playback.md) | Remote playback state and actions for the player store |
 | [`controlsFeature`](./feature-controls.md) | User activity and controls visibility state for the player store |
 | [`textTrackFeature`](./feature-text-tracks.md) | Subtitles, captions, and chapter track state for the player store |
+| [`textCuesFeature`](./feature-text-cues.md) | Cues and active cues from metadata, chapters, and app text tracks |
 | [`errorFeature`](./feature-error.md) | Media error state and actions for the player store |
 | [`metadataFeature`](./feature-metadata.md) | Resolved title and poster values for the player store |
 
@@ -95,6 +96,10 @@ customElements.define('my-video-player', PlayerElement);
 
 - [VideoSkin](../components/video-skin.md) — the default skin, with the modern, frosted look.
 - [NeutralVideoSkin](../components/video-neutral-skin.md) — the visually lighter variant, closer to a classic control bar.
+- [CompatVideoSkin](../components/video-compat-skin.md) — the plain, unbranded variant that avoids newer visual effects, so it looks consistent across browsers.
+- [ScaffoldVideoSkin](../components/video-scaffold-skin.md) — the minimally styled variant of Compat, a foundation for your own design.
+
+See [Choose a skin](../../guides/skins.md#choose-a-skin) to compare them.
 
 ## Media
 
@@ -111,6 +116,8 @@ The preset root, `@videojs/html/video`, has no side effects. Importing it never
 | `videoFeatures` | The [feature bundle](#feature-bundle). |
 | `VideoSkinElement` | The default [skin](#skins) element class. |
 | `NeutralVideoSkinElement` | The neutral [skin](#skins) element class. |
+| `CompatVideoSkinElement` | The compat [skin](#skins) element class. |
+| `ScaffoldVideoSkinElement` | The scaffold [skin](#skins) element class. |
 
 Registration entry points are side-effect-only:
 
@@ -119,5 +126,7 @@ Registration entry points are side-effect-only:
 | `@videojs/html/video/player` | `<video-player>` |
 | `@videojs/html/video/skin` | `<video-skin>`, `<media-container>`, and the UI elements the skin composes |
 | `@videojs/html/video/neutral-skin` | `<video-neutral-skin>`, `<media-container>`, and the UI elements the neutral skin composes |
+| `@videojs/html/video/compat-skin` | `<video-compat-skin>`, `<media-container>`, and the UI elements the compat skin composes |
+| `@videojs/html/video/scaffold-skin` | `<video-scaffold-skin>`, `<media-container>`, and the UI elements the scaffold skin composes |
 | `@videojs/html/video/ui` | `<media-container>` and the UI elements of the default skin, without the skin, for a layout you write yourself |
 | `@videojs/html/video/neutral-ui` | `<media-container>` and the UI elements of the neutral skin, without the skin |

package/docs/reference/api/resolve-adapter-type.md

@@ -47,8 +47,11 @@ Each media module you import adds its engine to your bundle, so import the rarel
 | `mux` | `stream.mux.com` stream URLs, with or without `.m3u8` | `<mux-video>` or `<mux-audio>` |
 | `cloudflare` | `cloudflarestream.com` and `videodelivery.net` URLs | `<cloudflare-video>` |
 | `spotify` | `open.spotify.com` URLs and `spotify:` URIs | `<spotify-audio>` |
+| `soundcloud` | `soundcloud.com` track and set URLs, `api.soundcloud.com` tracks and playlists, and `w.soundcloud.com/player/` embed URLs | `<soundcloud-audio>` |
+| `mixcloud` | `mixcloud.com` show URLs and Mixcloud widget embed URLs | `<mixcloud-audio>` |
 | `tiktok` | `tiktok.com` video URLs | `<tiktok-video>` |
 | `twitch` | `twitch.tv` video and channel URLs | `<twitch-video>` |
+| `dailymotion` | `dailymotion.com` video and embed URLs, `dai.ly` short links, and `geo.dailymotion.com` player embed URLs | `<dailymotion-video>` |
 | `hls` | `.m3u8` files and HLS MIME types | `<hls-video>`, `<hlsjs-video>`, or `<native-hls-video>` |
 | `dash` | `.mpd` files and `application/dash+xml` | `<dash-video>` or `<shaka-video>` |
 | `video` | `.mp4`, `.webm`, `.mov`, and `.ogv` files, and `video/*` MIME types | `<video>` |
@@ -95,4 +98,4 @@ A bare id returns `null`. An 11-character YouTube id and a 10-character Wistia i
 
 | Type |
 | --- |
-| `'youtube' \| 'vimeo' \| 'wistia' \| 'mux' \| 'cloudflare' \| 'spotify' \| 'tiktok' \| 'twitch' \| 'hls' \| 'dash' \| 'video' \| 'audio' \| null` |
+| `'youtube' \| 'vimeo' \| 'wistia' \| 'mux' \| 'cloudflare' \| 'spotify' \| 'soundcloud' \| 'mixcloud' \| 'tiktok' \| 'twitch' \| 'dailymotion' \| 'hls' \| 'dash' \| 'video' \| 'audio' \| null` |

package/docs/reference/api/ui-element.md

@@ -165,7 +165,7 @@ class ClockController implements ReactiveController {
 
 ## Destruction
 
-When the element disconnects, it waits two animation frames and then destroys itself if it is still disconnected. Moving the element within the document, or a framework reordering it, therefore keeps it alive. Destruction calls `hostDestroyed()` on every controller. A destroyed element stops updating and ignores later connections.
+When the element disconnects, it waits two animation frames and then destroys itself if it is still disconnected. Moving the element within the document, or a framework reordering it, therefore keeps it alive. Destruction first destroys the UI elements inside the element, including those in its shadow root, then calls `hostDestroyed()` on every controller. A destroyed element stops updating and ignores later connections.
 
 | Member | Description |
 | --- | --- |
@@ -173,7 +173,7 @@ When the element disconnects, it waits two animation frames and then destroys it
 | `destroyed` | `true` after destruction. |
 | `destroyCallback()` | Runs once on destruction. Override it, calling `super.destroyCallback()`, to release resources the element owns. |
 
-Add the `keep-alive` attribute to skip automatic destruction, for example when you detach an element and insert it again later. Call `destroy()` yourself when you are done with it.
+Add the `keep-alive` attribute to the element or one of its ancestors to skip automatic destruction, for example when you detach an element and insert it again later. Destroying an ancestor still destroys it. Call `destroy()` yourself when you are done with it.
 
 Release listeners and observers that the element starts on connection in `disconnectedCallback()`, calling `super.disconnectedCallback()`, because an element can connect and disconnect many times before it is destroyed.
 

package/docs/reference/components/alert-dialog.md

@@ -45,6 +45,7 @@ Use the open and transition data attributes to style visibility and animations:
 | `data-open` | Present while the dialog is open, including its closing transition |
 | `data-starting-style` | Present at the start of the opening transition |
 | `data-ending-style` | Present during the closing transition |
+| `data-scope` | `player` inside a player, `document` outside one |
 
 ```css
 media-dialog-backdrop:not([data-open]),
@@ -62,7 +63,7 @@ media-dialog-popup[data-ending-style] {
 
 ## Accessibility
 
-The dialog uses `role="alertdialog"` and `aria-modal="true"`. The title and description receive generated IDs that are connected with `aria-labelledby` and `aria-describedby`. Focus moves into the dialog when it opens, stays within it while open, and returns to the previously focused element when it closes. Content outside the dialog is inert while it is open. Pressing Escape closes the dialog.
+The dialog uses `role="alertdialog"`, plus `aria-modal="true"` outside a player. Like [Dialog](./dialog.md), it is confined to its player when rendered inside one and modal for the whole page otherwise. The title and description receive generated IDs that are connected with `aria-labelledby` and `aria-describedby`. Focus moves into the dialog when it opens, stays within it while open, and returns to the previously focused element when it closes. Content outside the dialog, within its player or the page, is inert while it is open. Pressing Escape closes the dialog.
 
 ## Examples
 
@@ -217,6 +218,7 @@ State is reflected as data attributes for CSS styling.
 | `status` | `'idle' \| 'starting' \| 'ending'` | Current phase of the transition lifecycle. |
 | `titleId` | `string \| undefined` | Element ID of the dialog title, used for `aria-labelledby`. |
 | `descriptionId` | `string \| undefined` | Element ID of the dialog description, used for `aria-describedby`. |
+| `scope` | `'player' \| 'document'` | `player` when the dialog is rendered inside a player and confined to it, otherwise `document`. |
 
 #### Events
 
@@ -231,11 +233,12 @@ Presentational backdrop that reflects its owning dialog's state.
 
 #### Data attributes
 
-| Attribute | Description |
-| --- | --- |
-| `data-open` | Present when the dialog is open. |
-| `data-starting-style` | Present during the open transition. |
-| `data-ending-style` | Present during the close transition. |
+| Attribute | Type | Description |
+| --- | --- | --- |
+| `data-open` | — | Present when the dialog is open. |
+| `data-starting-style` | — | Present during the open transition. |
+| `data-ending-style` | — | Present during the close transition. |
+| `data-scope` | `'player' \| 'document'` | `player` when the dialog is confined to its player, otherwise `document`. |
 
 ### media-dialog-close
 
@@ -243,11 +246,12 @@ Button that closes its owning dialog; the element itself takes `role="button"` a
 
 #### Data attributes
 
-| Attribute | Description |
-| --- | --- |
-| `data-open` | Present when the dialog is open. |
-| `data-starting-style` | Present during the open transition. |
-| `data-ending-style` | Present during the close transition. |
+| Attribute | Type | Description |
+| --- | --- | --- |
+| `data-open` | — | Present when the dialog is open. |
+| `data-starting-style` | — | Present during the open transition. |
+| `data-ending-style` | — | Present during the close transition. |
+| `data-scope` | `'player' \| 'document'` | `player` when the dialog is confined to its player, otherwise `document`. |
 
 ### media-dialog-description
 
@@ -259,11 +263,12 @@ Semantic popup that owns focus management and dialog transition completion.
 
 #### Data attributes
 
-| Attribute | Description |
-| --- | --- |
-| `data-open` | Present when the dialog is open. |
-| `data-starting-style` | Present during the open transition. |
-| `data-ending-style` | Present during the close transition. |
+| Attribute | Type | Description |
+| --- | --- | --- |
+| `data-open` | — | Present when the dialog is open. |
+| `data-starting-style` | — | Present during the open transition. |
+| `data-ending-style` | — | Present during the close transition. |
+| `data-scope` | `'player' \| 'document'` | `player` when the dialog is confined to its player, otherwise `document`. |
 
 ### media-dialog-title
 

package/docs/reference/components/audio-compat-skin.md

@@ -1,8 +1,8 @@
 # audio-compat-skin
 
-An audio skin designed for broader browser compatibility
+The audio preset's plain, unbranded skin, a polished step above native controls
 
-The Compat skin of the audio preset provides basic controls and plain surfaces, with broader browser compatibility as its design goal. Its time slider supports chapter segments and thumbnail previews. See [Customize skins](../../guides/customize-skins.md) to install and edit its source.
+The Compat skin of the audio preset: the same core controls with plain, unbranded surfaces that avoid newer visual effects such as backdrop blur. Its time slider supports chapter segments and thumbnail previews, and it adds captions and AirPlay buttons that the default audio skin leaves out. The preset also provides [AudioSkin](./audio-skin.md), [NeutralAudioSkin](./audio-neutral-skin.md), and [ScaffoldAudioSkin](./audio-scaffold-skin.md). See [Skins](../../guides/skins.md#choose-a-skin) to choose between them and [Customize skins](../../guides/customize-skins.md) to install and edit its source.
 
 ## Import
 
@@ -10,6 +10,12 @@ The Compat skin of the audio preset provides basic controls and plain surfaces,
 import '@videojs/html/audio/compat-skin';
 ```
 
+The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
+
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/audio-compat.js"></script>
+```
+
 ## Anatomy
 
 The skin goes between the player and the media component. It renders its controls around the media.

package/docs/reference/components/audio-neutral-skin.md

@@ -2,7 +2,7 @@
 
 The audio preset's visually lighter skin, closer to a classic control bar
 
-The neutral skin of the audio preset: the same player and the same controls in a visually lighter design, closer to a classic control bar. [AudioSkin](./audio-skin.md) is the same preset’s other variant. See [Skins](../../guides/skins.md) for how packaged skins work and [Presets](../../guides/presets.md) for what the audio preset ships.
+The neutral skin of the audio preset: the same player and the same controls in a visually lighter design, closer to a classic control bar. The preset also provides [AudioSkin](./audio-skin.md), [CompatAudioSkin](./audio-compat-skin.md), and [ScaffoldAudioSkin](./audio-scaffold-skin.md). See [Skins](../../guides/skins.md#choose-a-skin) to choose between them and [Presets](../../guides/presets.md) for what the audio preset ships.
 
 ## Import
 
@@ -13,7 +13,7 @@ import '@videojs/html/audio/neutral-skin';
 The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/audio-neutral.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/audio-neutral.js"></script>
 ```
 
 ## Anatomy

package/docs/reference/components/audio-scaffold-skin.md

@@ -2,7 +2,7 @@
 
 An audio skin with minimal styling for custom skins
 
-The Scaffold skin of the audio preset provides functional controls with minimal styling and no transitions. It is a starting point for a custom skin, intended to be restyled before use. Its time slider supports chapter segments and thumbnail previews. See [Customize skins](../../guides/customize-skins.md) to install and edit its source.
+The Scaffold skin of the audio preset provides functional controls with minimal styling and no transitions. It is a starting point for a custom skin, intended to be restyled before use. Its time slider supports chapter segments and thumbnail previews. The preset also provides [AudioSkin](./audio-skin.md), [NeutralAudioSkin](./audio-neutral-skin.md), and [CompatAudioSkin](./audio-compat-skin.md). See [Skins](../../guides/skins.md#choose-a-skin) to choose between them and [Customize skins](../../guides/customize-skins.md) to install and edit its source.
 
 ## Import
 
@@ -13,7 +13,7 @@ import '@videojs/html/audio/scaffold-skin';
 The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/audio-scaffold.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/audio-scaffold.js"></script>
 ```
 
 ## Usage

package/docs/reference/components/audio-skin.md

@@ -2,7 +2,7 @@
 
 The audio preset's default skin with the modern, frosted look
 
-The default skin of the audio preset: the control layout for on-demand audio with the modern, frosted look. [NeutralAudioSkin](./audio-neutral-skin.md) is the same preset’s other variant. See [Skins](../../guides/skins.md) for how packaged skins work and [Presets](../../guides/presets.md) for what the audio preset ships.
+The default skin of the audio preset: the control layout for on-demand audio with the modern, frosted look. The preset also provides [NeutralAudioSkin](./audio-neutral-skin.md), [CompatAudioSkin](./audio-compat-skin.md), and [ScaffoldAudioSkin](./audio-scaffold-skin.md). See [Skins](../../guides/skins.md#choose-a-skin) to choose between them and [Presets](../../guides/presets.md) for what the audio preset ships.
 
 ## Import
 
@@ -13,7 +13,7 @@ import '@videojs/html/audio/skin';
 The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.2.0/audio.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.4.0/audio.js"></script>
 ```
 
 ## Anatomy

package/docs/reference/components/audio-track-radio-group.md

@@ -204,7 +204,7 @@ State is reflected as data attributes for CSS styling.
 | `options` | `readonly Option[]` | Ordered options displayed by platform adapters. |
 | `disabled` | `boolean` | Whether the entire option group is disabled. |
 | `hidden` | `boolean` | Whether the option group is hidden because no meaningful selection is available. |
-| `availability` | `'available' \| 'unavailable'` | Whether the media exposes a meaningful selection. |
+| `availability` | `'available' \| 'unavailable' \| 'unsupported'` | Whether the media exposes a meaningful selection. `unsupported` when the media has no such capability at all. |
 
 #### Data attributes
 
@@ -213,7 +213,7 @@ State is reflected as data attributes for CSS styling.
 | `data-audio-track` | `string` | Current audio track value. |
 | `data-disabled` | — | Present when audio track selection is disabled. |
 | `data-hidden` | — | Present when audio track selection is unavailable. |
-| `data-availability` | `'available' \| 'unavailable'` | Indicates audio track availability (`available` or `unavailable`). |
+| `data-availability` | `'available' \| 'unavailable' \| 'unsupported'` | Indicates audio track availability (`available` or `unavailable`). |
 
 #### Events