@videojs/react 10.0.0-beta.24 → 10.0.0-beta.25

package/docs/concepts/skins.md

@@ -19,7 +19,7 @@ tsx
 
 ## Packaged vs. ejected
 
-When you choose a skin you have two options for how you use it: **packaged** or **ejected** . It’s usually easiest to start with a packaged skin and later eject its internal components into your project when you need more customization.
+When you choose a skin you have two options for how you use it: **packaged** or **ejected**. It’s usually easiest to start with a packaged skin and later eject its internal components into your project when you need more customization.
 
 Packaged
 
@@ -63,8 +63,8 @@ skin.css
 'use client';
 
 import { type CSSProperties, type ComponentProps, forwardRef, type ReactNode, isValidElement } from 'react';
-import { CaptionsOffIcon, CaptionsOnIcon, CastEnterIcon, CastExitIcon, CheckIcon, ChevronIcon, FullscreenEnterIcon, FullscreenExitIcon, PauseIcon, PipEnterIcon, PipExitIcon, PlayIcon, RestartIcon, SeekIcon, SpinnerIcon, VolumeHighIcon, VolumeLowIcon, VolumeOffIcon } from '@videojs/react/icons';
-import { createPlayer, Poster, Container, usePlayer, BufferingIndicator, CaptionsButton, CastButton, Controls, ErrorDialog, FullscreenButton, Gesture, Hotkey, Menu, MuteButton, PiPButton, PlayButton, PlaybackRateMenu, usePlaybackRateMenu, Popover, SeekButton, SeekIndicator, Slider, StatusAnnouncer, StatusIndicator, Time, TimeSlider, Tooltip, VolumeIndicator, VolumeSlider, type RenderProp } from '@videojs/react';
+import { AirPlayEnterIcon, AirPlayExitIcon, CaptionsOffIcon, CaptionsOnIcon, CastEnterIcon, CastExitIcon, CheckIcon, ChevronIcon, FullscreenEnterIcon, FullscreenExitIcon, GearIcon, PauseIcon, PipEnterIcon, PipExitIcon, PlayIcon, QualityIcon, RestartIcon, SeekIcon, SpeechIcon, SpeedIcon, SpinnerIcon, VolumeHighIcon, VolumeLowIcon, VolumeOffIcon } from '@videojs/react/icons';
+import { createPlayer, Poster, Container, usePlayer, AirPlayButton, useAudioTrackOptions, BufferingIndicator, useCaptionsOptions, CastButton, Controls, ErrorDialog, FullscreenButton, Gesture, Hotkey, Menu, MuteButton, PiPButton, PlayButton, usePlaybackRateOptions, Popover, useQualityOptions, SeekButton, SeekIndicator, Slider, StatusAnnouncer, StatusIndicator, Time, TimeSlider, Tooltip, VolumeIndicator, VolumeSlider, type RenderProp } from '@videojs/react';
 import { Video, videoFeatures } from '@videojs/react/video';
 import './player.css';
 
@@ -72,20 +72,237 @@ const TOP_STATUS_ACTIONS = ['toggleSubtitles', 'toggleFullscreen', 'togglePictur
 
 const CENTER_STATUS_ACTIONS = ['togglePaused'] as const;
 
-function PlaybackRateMenuItems(): ReactNode {
-  const { options, setValue, value } = usePlaybackRateMenu();
+function MenuChevron({ flipped = false }: { flipped?: boolean }): ReactNode {
+  return <ChevronIcon className={`media-icon media-menu__chevron ${flipped ? 'media-icon--flipped' : undefined}`} />;
+}
+
+function SettingsMenu(): ReactNode {
+  const playbackRate = usePlaybackRateOptions();
+  const quality = useQualityOptions();
+  const audioTrack = useAudioTrackOptions();
+  const captions = useCaptionsOptions();
+  const hasPlaybackRate = playbackRate?.state.availability === 'available';
+  const hasQuality = quality?.state.availability === 'available';
+  const hasAudioTrack = audioTrack?.state.availability === 'available';
+  const hasCaptions = captions?.state.availability === 'available';
+
+  if (!hasPlaybackRate && !hasQuality && !hasAudioTrack && !hasCaptions) return null;
 
   return (
-    <Menu.RadioGroup className="media-menu__group" value={value} onValueChange={setValue} label="Playback rate">
-      {options.map((option) => (
-        <Menu.RadioItem key={option.value} className="media-menu__item" value={option.value} disabled={option.disabled}>
-          <span>{option.label}</span>
-          <Menu.ItemIndicator checked={option.value === value} forceMount className="media-menu__indicator">
-            <CheckIcon className="media-icon" />
-          </Menu.ItemIndicator>
-        </Menu.RadioItem>
-      ))}
-    </Menu.RadioGroup>
+    <Menu.Root side="top" align="center">
+      <Menu.Trigger aria-label="Settings" className="media-button--settings" render={<Button />}>
+        <GearIcon className="media-icon media-icon--settings" />
+      </Menu.Trigger>
+      <Menu.Content className="media-surface media-popover media-menu media-menu--settings">
+        <Menu.View className="media-menu__panel">
+          <div className="media-menu__group">
+            {hasQuality ? (
+              <Menu.Root>
+                <Menu.Trigger
+                  type="quality"
+                  className="media-menu__item media-menu__item--submenu"
+                  render={(props) => (
+                    <div {...props}>
+                      <QualityIcon className="media-icon" />
+                      <span>Quality</span>
+                      <span className="media-menu__hint">
+                        <Menu.ItemValue className="media-menu__hint-label" />
+                        <MenuChevron />
+                      </span>
+                    </div>
+                  )}
+                />
+                <Menu.Content className="media-menu__panel">
+                  <Menu.Back className="media-menu__back">
+                    <MenuChevron flipped />
+                    Quality
+                  </Menu.Back>
+                  <Menu.Separator className="media-menu__separator" />
+                  <Menu.RadioGroup
+                    className="media-menu__group"
+                    value={quality.value}
+                    onValueChange={quality.setValue}
+                    aria-label="Quality"
+                  >
+                    {quality.options.map((option) => (
+                      <Menu.RadioItem
+                        key={option.value}
+                        className="media-menu__item"
+                        value={option.value}
+                        disabled={option.disabled}
+                      >
+                        <span>
+                          {option.label}
+                          {option.tier ? <sup className="media-menu__tier">{option.tier}</sup> : null}
+                        </span>
+                        {option.badge ? <span className="media-badge">{option.badge}</span> : null}
+                        <Menu.ItemIndicator
+                          checked={option.value === quality.value}
+                          forceMount
+                          className="media-menu__indicator"
+                        >
+                          <CheckIcon className="media-icon" />
+                        </Menu.ItemIndicator>
+                      </Menu.RadioItem>
+                    ))}
+                  </Menu.RadioGroup>
+                </Menu.Content>
+              </Menu.Root>
+            ) : null}
+
+            {hasAudioTrack ? (
+              <Menu.Root>
+                <Menu.Trigger
+                  type="audio-track"
+                  className="media-menu__item media-menu__item--submenu"
+                  render={(props) => (
+                    <div {...props}>
+                      <SpeechIcon className="media-icon" />
+                      <span>Audio</span>
+                      <span className="media-menu__hint">
+                        <Menu.ItemValue className="media-menu__hint-label" />
+                        <MenuChevron />
+                      </span>
+                    </div>
+                  )}
+                />
+                <Menu.Content className="media-menu__panel">
+                  <Menu.Back className="media-menu__back">
+                    <MenuChevron flipped />
+                    Audio
+                  </Menu.Back>
+                  <Menu.Separator className="media-menu__separator" />
+                  <Menu.RadioGroup
+                    className="media-menu__group"
+                    value={audioTrack.value}
+                    onValueChange={audioTrack.setValue}
+                    aria-label="Audio tracks"
+                  >
+                    {audioTrack.options.map((option) => (
+                      <Menu.RadioItem
+                        key={option.value}
+                        className="media-menu__item"
+                        value={option.value}
+                        disabled={option.disabled}
+                      >
+                        <span>{option.label}</span>
+                        <Menu.ItemIndicator
+                          checked={option.value === audioTrack.value}
+                          forceMount
+                          className="media-menu__indicator"
+                        >
+                          <CheckIcon className="media-icon" />
+                        </Menu.ItemIndicator>
+                      </Menu.RadioItem>
+                    ))}
+                  </Menu.RadioGroup>
+                </Menu.Content>
+              </Menu.Root>
+            ) : null}
+
+            {hasPlaybackRate ? (
+              <Menu.Root>
+                <Menu.Trigger
+                  type="playback-rate"
+                  className="media-menu__item media-menu__item--submenu"
+                  render={(props) => (
+                    <div {...props}>
+                      <SpeedIcon className="media-icon" />
+                      <span>Speed</span>
+                      <span className="media-menu__hint">
+                        <Menu.ItemValue className="media-menu__hint-label" />
+                        <MenuChevron />
+                      </span>
+                    </div>
+                  )}
+                />
+                <Menu.Content className="media-menu__panel">
+                  <Menu.Back className="media-menu__back">
+                    <MenuChevron flipped />
+                    Speed
+                  </Menu.Back>
+                  <Menu.Separator className="media-menu__separator" />
+                  <Menu.RadioGroup
+                    className="media-menu__group"
+                    value={playbackRate.value}
+                    onValueChange={playbackRate.setValue}
+                    aria-label="Playback rate"
+                  >
+                    {playbackRate.options.map((option) => (
+                      <Menu.RadioItem
+                        key={option.value}
+                        className="media-menu__item"
+                        value={option.value}
+                        disabled={option.disabled}
+                      >
+                        <span>{option.label}</span>
+                        <Menu.ItemIndicator
+                          checked={option.value === playbackRate.value}
+                          forceMount
+                          className="media-menu__indicator"
+                        >
+                          <CheckIcon className="media-icon" />
+                        </Menu.ItemIndicator>
+                      </Menu.RadioItem>
+                    ))}
+                  </Menu.RadioGroup>
+                </Menu.Content>
+              </Menu.Root>
+            ) : null}
+
+            {hasCaptions ? (
+              <Menu.Root>
+                <Menu.Trigger
+                  type="captions"
+                  className="media-menu__item media-menu__item--submenu"
+                  render={(props) => (
+                    <div {...props}>
+                      <CaptionsOffIcon className="media-icon" />
+                      <span>Captions</span>
+                      <span className="media-menu__hint">
+                        <Menu.ItemValue className="media-menu__hint-label" />
+                        <MenuChevron />
+                      </span>
+                    </div>
+                  )}
+                />
+                <Menu.Content className="media-menu__panel">
+                  <Menu.Back className="media-menu__back">
+                    <MenuChevron flipped />
+                    Captions
+                  </Menu.Back>
+                  <Menu.Separator className="media-menu__separator" />
+                  <Menu.RadioGroup
+                    className="media-menu__group"
+                    value={captions.value}
+                    onValueChange={captions.setValue}
+                    aria-label="Captions"
+                  >
+                    {captions.options.map((option) => (
+                      <Menu.RadioItem
+                        key={option.value}
+                        className="media-menu__item"
+                        value={option.value}
+                        disabled={option.disabled}
+                      >
+                        <span>{option.label}</span>
+                        <Menu.ItemIndicator
+                          checked={option.value === captions.value}
+                          forceMount
+                          className="media-menu__indicator"
+                        >
+                          <CheckIcon className="media-icon" />
+                        </Menu.ItemIndicator>
+                      </Menu.RadioItem>
+                    ))}
+                  </Menu.RadioGroup>
+                </Menu.Content>
+              </Menu.Root>
+            ) : null}
+          </div>
+        </Menu.View>
+      </Menu.Content>
+    </Menu.Root>
   );
 }
 
@@ -113,10 +330,18 @@ export interface VideoPlayerProps {
  * />
  * ```
  */
-export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProps): ReactNode {
+export function VideoPlayer({ src, className, poster, placeholder, style, ...rest }: VideoPlayerProps): ReactNode {
+  const containerStyle = placeholder
+    ? ({ '--media-poster-placeholder': `url(${placeholder})`, ...style } as CSSProperties)
+    : style;
+
   return (
     <Player.Provider>
-      <Container className={`media-default-skin media-default-skin--video ${className ?? ''}`} {...rest}>
+      <Container
+        className={`media-default-skin media-default-skin--video ${className ?? ''}`}
+        style={containerStyle}
+        {...rest}
+      >
         <Video src={src} playsInline />
 
         {poster && (
@@ -126,9 +351,7 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
         <BufferingIndicator
           render={(props) => (
             <div {...props} className="media-buffering-indicator">
-              <div className="media-surface">
-                <SpinnerIcon className="media-icon" />
-              </div>
+              <SpinnerIcon className="media-icon" />
             </div>
           )}
         />
@@ -160,7 +383,10 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                     </PlayButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
 
               <Tooltip.Root side="top">
@@ -174,7 +400,10 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                     </SeekButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
 
               <Tooltip.Root side="top">
@@ -188,7 +417,10 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                     </SeekButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
             </div>
 
@@ -201,47 +433,51 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                 </TimeSlider.Track>
                 <TimeSlider.Thumb className="media-slider__thumb" />
 
-                <div className="media-surface media-preview media-slider__preview">
-                  <Slider.Thumbnail className="media-preview__thumbnail" />
-                  <TimeSlider.Value type="pointer" className="media-time media-preview__time" />
-                  <SpinnerIcon className="media-preview__spinner media-icon" />
+                <div className="media-surface media-thumbnail media-slider__thumbnail">
+                  <Slider.Thumbnail className="media-thumbnail__image" />
+                  <TimeSlider.Value type="pointer" className="media-time media-thumbnail__time" />
+                  <SpinnerIcon className="media-thumbnail__spinner media-icon" />
                 </div>
+                <TimeSlider.Preview className="media-slider__preview">
+                  <TimeSlider.Value type="pointer" className="media-time media-slider__value" />
+                </TimeSlider.Preview>
               </TimeSlider.Root>
-              <Time.Value type="duration" className="media-time" />
+              <Time.Value toggle type="remaining" className="media-time" />
             </div>
 
             <div className="media-button-group">
-              <PlaybackRateMenu.Root side="top" align="center">
-                <PlaybackRateMenu.Trigger className="media-button--playback-rate" render={<Button />} />
-                <PlaybackRateMenu.Content className="media-surface media-popover media-menu media-menu--playback-rate">
-                  <PlaybackRateMenuItems />
-                </PlaybackRateMenu.Content>
-              </PlaybackRateMenu.Root>
-
               <VolumePopover />
 
+              <SettingsMenu />
+
               <Tooltip.Root side="top">
                 <Tooltip.Trigger
                   render={
-                    <CaptionsButton className="media-button--captions" render={<Button />}>
-                      <CaptionsOffIcon className="media-icon media-icon--captions-off" />
-                      <CaptionsOnIcon className="media-icon media-icon--captions-on" />
-                    </CaptionsButton>
+                    <CastButton className="media-button--cast" render={<Button />}>
+                      <CastEnterIcon className="media-icon media-icon--cast-enter" />
+                      <CastExitIcon className="media-icon media-icon--cast-exit" />
+                    </CastButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
 
               <Tooltip.Root side="top">
                 <Tooltip.Trigger
                   render={
-                    <CastButton className="media-button--cast" render={<Button />}>
-                      <CastEnterIcon className="media-icon media-icon--cast-enter" />
-                      <CastExitIcon className="media-icon media-icon--cast-exit" />
-                    </CastButton>
+                    <AirPlayButton className="media-button--airplay" render={<Button />}>
+                      <AirPlayEnterIcon className="media-icon media-icon--airplay-enter" />
+                      <AirPlayExitIcon className="media-icon media-icon--airplay-exit" />
+                    </AirPlayButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
 
               <Tooltip.Root side="top">
@@ -253,7 +489,10 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                     </PiPButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
 
               <Tooltip.Root side="top">
@@ -265,7 +504,10 @@ export function VideoPlayer({ src, className, poster, ...rest }: VideoPlayerProp
                     </FullscreenButton>
                   }
                 />
-                <Tooltip.Popup className="media-surface media-tooltip" />
+                <Tooltip.Popup className="media-surface media-tooltip">
+                  <Tooltip.Label />
+                  <Tooltip.Shortcut className="media-tooltip__kbd" />
+                </Tooltip.Popup>
               </Tooltip.Root>
             </div>
           </Tooltip.Provider>
@@ -434,6 +676,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   --media-current-shadow-color: oklch(from currentColor 0 0 0 / clamp(0, calc((l - 0.5) * 0.5), 0.15));
   --media-current-shadow-color-subtle: oklch(from var(--media-current-shadow-color) l c h / calc(alpha * 0.4));
   --media-icon-size: 18px;
+  --media-color-scrollbar-thumb: oklch(from currentColor l c h / 0.3);
   position: relative;
   display: block;
   width: 100%;
@@ -452,6 +695,8 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   letter-spacing: normal;
   outline: 2px solid transparent;
   outline-offset: -4px;
+  scrollbar-color: var(--media-color-scrollbar-thumb) transparent;
+  scrollbar-width: thin;
   border-radius: var(--media-border-radius, 2rem);
   isolation: isolate;
   transition-timing-function: ease-out;
@@ -462,6 +707,16 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     outline-color: currentColor;
     outline-offset: 2px;
   }
+
+  &::-webkit-scrollbar-thumb {
+    background: var(--media-color-scrollbar-thumb);
+    border-radius: 9999px;
+  }
+
+  @media (prefers-reduced-transparency: reduce) or (prefers-contrast: more) {
+    --media-color-scrollbar-thumb: oklch(from currentColor l c h / 0.8);
+    scrollbar-width: auto;
+  }
 }
 
 /* ==========================================================================
@@ -520,7 +775,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   position: absolute;
   inset: 0;
   pointer-events: none;
-  background-image: linear-gradient(to top, oklch(0 0 0 / 0.5), oklch(0 0 0 / 0.3), oklch(0 0 0 / 0));
+  background-image: linear-gradient(to top, oklch(0 0 0 / 0.5), oklch(0 0 0 / 0.3) 25%, oklch(0 0 0 / 0));
   border-radius: inherit;
   opacity: 0;
   backdrop-filter: blur(0) saturate(1);
@@ -539,6 +794,12 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   opacity: 1;
 }
 
+.media-default-skin .media-buffering-indicator[data-visible] ~ .media-overlay {
+  background: oklch(0 0 0 / 0.35);
+  opacity: 1;
+  backdrop-filter: blur(8px);
+}
+
 .media-default-skin .media-error[data-open] ~ .media-overlay {
   backdrop-filter: blur(16px) saturate(1.5);
 }
@@ -550,9 +811,9 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 .media-default-skin .media-buffering-indicator {
   position: absolute;
   inset: 0;
+  z-index: 10;
   display: none;
-  align-items: center;
-  justify-content: center;
+  place-content: center;
   color: oklch(1 0 0);
   pointer-events: none;
 
@@ -561,12 +822,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   }
 
   &[data-visible] {
-    display: flex;
-  }
-
-  .media-surface {
-    padding: 0.25rem;
-    border-radius: 100%;
+    display: grid;
   }
 }
 
@@ -636,6 +892,21 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   font-variant-numeric: tabular-nums;
 }
 
+.media-default-skin .media-time[role="button"] {
+  cursor: pointer;
+  outline: 2px solid transparent;
+  outline-offset: -2px;
+  border-radius: 0.25rem;
+  transition-timing-function: ease-out;
+  transition-duration: 100ms;
+  transition-property: outline-color, outline-offset;
+
+  &:focus-visible {
+    outline-color: currentColor;
+    outline-offset: 2px;
+  }
+}
+
 /* ==========================================================================
    Buttons
    ========================================================================== */
@@ -716,6 +987,10 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     scale: 0.9;
   }
 
+  & .media-icon__container {
+    display: grid;
+  }
+
   & .media-icon {
     grid-area: 1 / 1;
     transition-behavior: allow-discrete;
@@ -733,8 +1008,9 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     right: -1px;
     bottom: -3px;
     font-size: 10px;
-    font-weight: 480;
+    font-weight: 500;
     font-variant-numeric: tabular-nums;
+    letter-spacing: -0.05em;
   }
 
   &:has(.media-icon--flipped) .media-icon__label {
@@ -758,6 +1034,27 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   }
 }
 
+/* Settings button */
+.media-default-skin .media-button--settings {
+  display: none;
+
+  & .media-icon--settings {
+    transition: transform 150ms ease-in-out;
+
+    @media (prefers-reduced-motion: reduce) {
+      transition-duration: 0ms;
+    }
+  }
+
+  &[aria-expanded="true"] .media-icon--settings {
+    transform: rotate(90deg);
+  }
+}
+
+.media-default-skin .media-button-group:has([data-availability="available"]) .media-button--settings {
+  display: grid;
+}
+
 /* Live button — wide pill button with a status dot (gray → red at the live
    edge) rendered via ::before, and "LIVE" text rendered as the button's own
    text content. */
@@ -804,6 +1101,21 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   }
 }
 
+/* ==========================================================================
+   Badge
+   ========================================================================== */
+
+.media-default-skin .media-badge {
+  padding: 0.125rem 0.375rem;
+  font-size: 0.6875rem;
+  font-weight: 500;
+  line-height: 1;
+  color: oklch(from currentColor l c h / 0.85);
+  white-space: nowrap;
+  background-color: oklch(from currentColor l c h / 0.1);
+  border-radius: calc(infinity * 1px);
+}
+
 /* ==========================================================================
    Icons
    ========================================================================== */
@@ -811,6 +1123,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 .media-default-skin .media-icon__container {
   position: relative;
 }
+
 .media-default-skin .media-icon {
   flex-shrink: 0;
   width: var(--media-icon-size);
@@ -820,102 +1133,6 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   scale: -1 1;
 }
 
-/* ==========================================================================
-   Menus
-   Note: Menus use `.media-popover` styles for positioning and transitions.
-   ========================================================================== */
-
-.media-default-skin .media-popover.media-menu {
-  box-sizing: border-box;
-  min-width: min(6rem, var(--media-popover-available-width, 6rem));
-  max-width: var(--media-popover-available-width, none);
-  max-height: var(--media-popover-available-height, none);
-  padding: 0.375rem;
-  overflow: auto;
-  overscroll-behavior: none;
-  border-radius: 1.25rem;
-
-  &::before {
-    display: none;
-  }
-}
-
-.media-default-skin .media-popover.media-menu .media-menu__group {
-  position: relative;
-  display: flex;
-  flex-direction: column;
-  gap: 0.125rem;
-
-  &::before {
-    position: absolute;
-    position-anchor: --media-menu-item-highlight-anchor;
-    inset: anchor(inside);
-    pointer-events: none;
-    content: "";
-    background-color: oklch(from currentColor l c h / 0.1);
-    border-radius: calc(infinity * 1px);
-    transition: inset ease-in-out 100ms;
-  }
-
-  @supports not (top: anchor(top)) {
-    &::before {
-      display: none;
-    }
-  }
-}
-
-.media-default-skin .media-popover.media-menu .media-menu__item {
-  display: flex;
-  gap: 0.5rem;
-  align-items: center;
-  justify-content: space-between;
-  min-height: 2rem;
-  padding: 0 0.75rem;
-  font-variant-numeric: tabular-nums;
-  color: inherit;
-  cursor: pointer;
-  outline: 2px solid transparent;
-  outline-offset: -2px;
-  border-radius: calc(infinity * 1px);
-
-  &:hover,
-  &[data-highlighted] {
-    anchor-name: --media-menu-item-highlight-anchor;
-  }
-
-  @supports not (top: anchor(top)) {
-    &:hover,
-    &[data-highlighted] {
-      background-color: oklch(from currentColor l c h / 0.1);
-    }
-  }
-
-  &:focus-visible {
-    outline-color: currentColor;
-    outline-offset: 2px;
-  }
-
-  &[aria-checked="true"] .media-menu__indicator {
-    opacity: 1;
-  }
-
-  &[aria-disabled="true"] {
-    pointer-events: none;
-    cursor: not-allowed;
-    opacity: 0.5;
-  }
-}
-
-.media-default-skin .media-popover.media-menu .media-menu__indicator {
-  flex-shrink: 0;
-  margin-right: -0.25rem;
-  opacity: 0;
-}
-
-.media-default-skin .media-popover.media-menu .media-menu__indicator .media-icon {
-  filter: drop-shadow(0 1px 0 var(--media-current-shadow-color));
-}
-
 /* ==========================================================================
    Poster Image
    ========================================================================== */
@@ -930,7 +1147,8 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   transition: opacity 0.25s;
 }
 .media-default-skin media-poster:not([data-visible]),
-.media-default-skin > img:not([data-visible]) {
+.media-default-skin > img:not([data-visible]),
+.media-default-skin > img[data-visible]:not([data-loaded]) {
   opacity: 0;
 }
 .media-default-skin media-poster ::slotted(img),
@@ -949,6 +1167,30 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   border-radius: inherit;
 }
 
+/* Blurred placeholder: HTML path targets media-poster::before, React path targets the skin container::before */
+.media-default-skin media-poster::before,
+.media-default-skin::before {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  content: "";
+  background-image: var(--media-poster-placeholder, none);
+  background-repeat: no-repeat;
+  background-position: var(--media-object-position, center);
+  background-size: var(--media-object-fit, contain);
+  filter: blur(var(--media-poster-placeholder-blur, 20px));
+}
+
+/* React path: hidden by default, transitions in while poster loads */
+.media-default-skin::before {
+  opacity: 0;
+  transition: opacity 0.25s;
+}
+/* Show placeholder while the poster is visible but not yet loaded */
+.media-default-skin:has(img[data-visible]:not([data-loaded]))::before {
+  opacity: 1;
+}
+
 .media-default-skin:fullscreen media-poster ::slotted(img),
 .media-default-skin:fullscreen media-poster img,
 .media-default-skin:fullscreen > img {
@@ -956,14 +1198,15 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 }
 
 /* ==========================================================================
-   Media preview
+   Media thumbnail
    ========================================================================== */
-.media-default-skin .media-preview {
+
+.media-default-skin .media-thumbnail {
   pointer-events: none;
   background-color: oklch(0 0 0 / 0.9);
   border-radius: 0.75rem;
 
-  & .media-preview__thumbnail {
+  & .media-thumbnail__image {
     position: relative;
     display: block;
     overflow: clip;
@@ -978,18 +1221,14 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     }
   }
 
-  & .media-preview__time {
+  & .media-thumbnail__time {
     position: absolute;
     inset-inline: 0;
     bottom: 0.5rem;
     text-align: center;
   }
 
-  & .media-overlay {
-    opacity: 1;
-  }
-
-  & .media-preview__spinner {
+  & .media-thumbnail__spinner {
     position: absolute;
     top: 50%;
     left: 50%;
@@ -997,22 +1236,22 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     translate: -50% -50%;
   }
 
-  & .media-preview__thumbnail,
-  & .media-preview__spinner {
+  & .media-thumbnail__image,
+  & .media-thumbnail__spinner {
     transition: opacity 150ms ease-out;
   }
 
-  &:not(:has(.media-preview__thumbnail[data-loading])) {
-    & .media-preview__spinner {
+  &:not(:has(.media-thumbnail__image[data-loading])) {
+    & .media-thumbnail__spinner {
       --media-spinner-animation: none;
     }
   }
 
-  &:has(.media-preview__thumbnail[data-loading]) {
-    & .media-preview__thumbnail {
+  &:has(.media-thumbnail__image[data-loading]) {
+    & .media-thumbnail__image {
       opacity: 0;
     }
-    & .media-preview__spinner {
+    & .media-thumbnail__spinner {
       opacity: 1;
     }
   }
@@ -1075,9 +1314,9 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   background-color: currentColor;
   border-radius: calc(infinity * 1px);
   box-shadow:
-    0 0 0 1px var(--media-current-shadow-color-subtle, oklch(0 0 0 / 0.1)),
-    0 1px 3px 0 oklch(0 0 0 / 0.15),
-    0 1px 2px -1px oklch(0 0 0 / 0.15);
+    0 0 0 1px var(--media-current-shadow-color, oklch(0 0 0 / 0.1)),
+    0 1px 3px 0 oklch(0 0 0 / 0.35),
+    0 1px 2px -1px oklch(0 0 0 / 0.35);
   opacity: 0;
   translate: -50% -50%;
   transition-timing-function: ease-out;
@@ -1096,7 +1335,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 
   &:hover,
   &:focus {
-    outline-color: oklch(from currentColor l c h / 0.25);
+    outline-color: oklch(from currentColor l c h / 0.15);
     outline-offset: 0;
   }
 
@@ -1105,7 +1344,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     inset: -4px;
     content: "";
     border-radius: inherit;
-    box-shadow: 0 0 0 2px oklch(1 0 0);
+    box-shadow: 0 0 0 2px currentColor;
     transition-timing-function: ease-out;
     transition-duration: 150ms;
     transition-property: opacity, scale;
@@ -1129,6 +1368,49 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   opacity: 1;
 }
 
+/* Preview */
+.media-default-skin .media-slider__preview {
+  & .media-slider__value,
+  &::before {
+    opacity: 0;
+    scale: 0.5;
+    transition-timing-function: ease-out;
+    transition-duration: 200ms;
+    transition-property: opacity, scale;
+  }
+
+  & .media-slider__value {
+    position: absolute;
+    bottom: 2.25rem;
+    text-shadow: 0 1px 0 var(--media-current-shadow-color);
+    filter: blur(8px);
+    translate: -50% 0.5rem;
+    transition-property: filter, opacity, scale, translate;
+  }
+
+  &::before {
+    display: block;
+    min-width: 0.25rem;
+    height: 0.25rem;
+    content: "";
+    background-color: currentColor;
+    border-radius: 100%;
+    box-shadow:
+      0 0 0 1px var(--media-current-shadow-color, oklch(0 0 0 / 0.15)),
+      0 1px 2px 0 oklch(0 0 0 / 0.35);
+  }
+
+  &[data-pointing] .media-slider__value,
+  &[data-pointing]:not([data-dragging])::before {
+    opacity: 1;
+    scale: 1;
+  }
+  &[data-pointing] .media-slider__value {
+    filter: blur(0);
+    translate: -50% 0;
+  }
+}
+
 /* Shared track fills */
 .media-default-skin .media-slider__buffer,
 .media-default-skin .media-slider__fill {
@@ -1200,38 +1482,52 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
    Popups & Tooltips
    ========================================================================== */
 
+.media-default-skin {
+  --media-popup-transition:
+    opacity var(--media-popup-transition-timing-function) var(--media-popup-transition-duration),
+    filter var(--media-popup-transition-timing-function) var(--media-popup-transition-duration),
+    transform var(--media-popup-transition-timing-function) var(--media-popup-transition-duration),
+    scale var(--media-popup-transition-timing-function) var(--media-popup-transition-duration);
+}
+
 .media-default-skin .media-popover,
 .media-default-skin .media-tooltip {
+  --popup-translate-distance: 0.5rem;
   margin: 0;
   overflow: visible;
   color: inherit;
   border: 0;
-  filter: blur(0px);
-  transition-timing-function: var(--media-popup-transition-timing-function);
-  transition-duration: var(--media-popup-transition-duration);
-  transition-property: scale, opacity, filter;
+  transition: var(--media-popup-transition);
 
   &[data-starting-style],
   &[data-ending-style] {
     opacity: 0;
-    filter: blur(8px);
-    scale: 0.85;
+    filter: blur(4px);
+    /* We have to use transform here for translate as the translate property is used for positioning by core. */
+    transform: translate(var(--popup-translate-x-distance, 0), var(--popup-translate-y-distance, 0));
+    scale: 0.95;
   }
 
-  &[data-instant] {
-    transition-duration: 0ms;
+  &[data-ending-style] {
+    transform: none;
+    /* Speed up the exit transition. */
+    transition-duration: max(0ms, calc(var(--media-popup-transition-duration) - 50ms));
   }
 
   &[data-side="top"] {
+    --popup-translate-y-distance: var(--popup-translate-distance);
     transform-origin: bottom;
   }
   &[data-side="bottom"] {
+    --popup-translate-y-distance: calc(var(--popup-translate-distance) * -1);
     transform-origin: top;
   }
   &[data-side="left"] {
+    --popup-translate-x-distance: var(--popup-translate-distance);
     transform-origin: right;
   }
   &[data-side="right"] {
+    --popup-translate-x-distance: calc(var(--popup-translate-distance) * -1);
     transform-origin: left;
   }
 
@@ -1292,6 +1588,13 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   white-space: nowrap;
   border-radius: calc(infinity * 1px);
 
+  /* `display: flex` must not apply while closed — it overrides UA `[popover]` hiding. */
+  &[data-open] {
+    display: flex;
+    column-gap: 0.25rem;
+    align-items: center;
+  }
+
   &[data-side="top"]::before,
   &[data-side="bottom"]::before {
     height: var(--media-tooltip-side-offset);
@@ -1300,6 +1603,250 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   &[data-side="right"]::before {
     width: var(--media-tooltip-side-offset);
   }
+
+  & .media-tooltip__kbd {
+    min-width: 1.5em;
+    padding: 0.1em;
+    font-family: inherit;
+    font-size: 90%;
+    font-weight: 600;
+    line-height: 1.25;
+    text-align: center;
+    background-color: oklch(from currentColor l c h / 0.3);
+    border-radius: 0.25rem;
+  }
+}
+
+/* ==========================================================================
+   Menus
+   Note: Menus use `.media-popover` styles for positioning and transitions.
+   ========================================================================== */
+
+.media-default-skin .media-menu {
+  --menu-transition-duration: 250ms;
+  --menu-max-height: 14rem;
+  --menu-padding: 0.25rem;
+  --menu-border-radius: 0.75rem;
+  --menu-item-border-radius: calc(var(--menu-border-radius) - var(--menu-padding));
+  box-sizing: border-box;
+  max-width: var(--media-popover-available-width, none);
+  max-height: min(var(--media-popover-available-height, var(--menu-max-height)), var(--menu-max-height));
+  padding: var(--menu-padding);
+  overflow: auto;
+  overscroll-behavior: none;
+  border-radius: var(--menu-border-radius);
+
+  @media (prefers-reduced-motion: reduce) {
+    --menu-transition-duration: 0ms;
+  }
+
+  & .media-menu__panel {
+    position: absolute;
+    inset: 0;
+    padding: var(--menu-padding);
+    overflow: auto;
+    overscroll-behavior: none;
+    outline: none;
+    translate: 0 0;
+    transition-timing-function: ease-in-out;
+    transition-duration: var(--menu-transition-duration);
+    transition-property: translate, filter;
+    will-change: translate, filter;
+
+    &[data-starting-style],
+    &[data-ending-style] {
+      overflow: hidden;
+    }
+
+    /* Root settings view — slides out when a submenu is active */
+    &[data-menu-root-view][data-menu-view-state="inactive"] {
+      filter: blur(8px);
+      translate: -100% 0;
+
+      /* Hide the indicator while transitioning */
+      & .media-menu__group::before {
+        display: none;
+      }
+    }
+
+    /* Submenu panels — slide in/out alongside the root view */
+    &[data-submenu] {
+      z-index: 10;
+
+      &:not([data-open], [data-ending-style]) {
+        translate: -100% 0;
+        transition-property: none;
+      }
+
+      &[data-starting-style],
+      &[data-ending-style] {
+        pointer-events: none;
+        filter: blur(8px);
+      }
+
+      &[data-starting-style][data-direction="forward"],
+      &[data-ending-style][data-direction="back"] {
+        translate: 100% 0;
+      }
+
+      &[data-ending-style][data-direction="forward"],
+      &[data-starting-style][data-direction="back"] {
+        translate: -100% 0;
+      }
+    }
+  }
+
+  & .media-menu__separator {
+    margin-block: 0.25rem;
+    border-bottom: 1px solid oklch(0 0 0 / 0.1);
+    box-shadow: 0 1px 0 0 oklch(1 0 0 / 0.075);
+  }
+
+  & .media-menu__group {
+    display: flex;
+    flex-direction: column;
+    gap: 0.125rem;
+
+    @supports (top: anchor(top)) {
+      &::before {
+        position: absolute;
+        position-anchor: --media-menu-item-highlight-anchor;
+        inset: anchor(inside);
+        pointer-events: none;
+        content: "";
+        background-color: oklch(from currentColor l c h / 0.1);
+        border-radius: var(--menu-item-border-radius);
+        transition: inset ease-in-out 100ms;
+      }
+    }
+  }
+
+  & .media-menu__item,
+  & .media-menu__back {
+    display: flex;
+    gap: 0.375rem;
+    align-items: center;
+    padding: 0.375rem 0.5rem;
+    text-align: left;
+    text-shadow: 0 1px 0 var(--media-current-shadow-color);
+    cursor: pointer;
+    user-select: none;
+    outline: 2px solid transparent;
+    outline-offset: -2px;
+    border-radius: var(--menu-item-border-radius);
+    transition: background-color, color;
+    transition-timing-function: ease-out;
+    transition-duration: 100ms;
+
+    &:focus-visible {
+      outline-color: currentColor;
+      outline-offset: 2px;
+    }
+
+    &:hover,
+    &[data-highlighted] {
+      background-color: oklch(from currentColor l c h / 0.1);
+
+      @supports (top: anchor(top)) {
+        anchor-name: --media-menu-item-highlight-anchor;
+        background-color: transparent;
+      }
+    }
+
+    & .media-icon {
+      flex-shrink: 0;
+      color: oklch(from currentColor l c h / 0.65);
+      filter: drop-shadow(0 1px 0 var(--media-current-shadow-color));
+    }
+  }
+
+  & .media-menu__indicator {
+    flex-shrink: 0;
+    margin-right: -0.25rem;
+    margin-left: auto;
+    opacity: 0;
+
+    & .media-icon {
+      filter: drop-shadow(0 1px 0 var(--media-current-shadow-color));
+    }
+  }
+
+  & .media-menu__item {
+    justify-content: space-between;
+    font-variant-numeric: tabular-nums;
+    color: inherit;
+
+    &[aria-disabled="true"] {
+      pointer-events: none;
+      cursor: not-allowed;
+      opacity: 0.5;
+    }
+
+    &[aria-checked="true"] .media-menu__indicator {
+      opacity: 1;
+    }
+
+    &[data-availability="unavailable"],
+    &[data-availability="unsupported"] {
+      display: none;
+    }
+  }
+
+  & .media-menu__tier {
+    padding-top: 1px;
+    padding-left: 0.125rem;
+    font-size: 0.5625rem;
+    font-weight: 600;
+    line-height: 1;
+    color: oklch(from currentColor l c h / 0.7);
+  }
+
+  & .media-menu__back {
+    width: 100%;
+    margin-bottom: 0.125rem;
+  }
+
+  & .media-menu__hint {
+    display: inline-flex;
+    gap: 0.25rem;
+    align-items: center;
+    min-width: 0;
+    padding-left: 0.5rem;
+    margin-left: auto;
+    font-size: 0.75rem;
+    color: oklch(from currentColor l c h / 0.65);
+  }
+
+  & .media-menu__hint-label {
+    max-width: 6rem;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  & .media-menu__chevron {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+
+  /* Settings menu */
+  &.media-menu--settings {
+    width: var(--media-menu-width);
+    min-width: 12rem;
+    height: var(--media-menu-height);
+    overflow: hidden;
+    /* Add height and width transitions. */
+    transition:
+      var(--media-popup-transition),
+      height var(--media-popup-transition-timing-function) var(--menu-transition-duration),
+      width var(--media-popup-transition-timing-function) var(--menu-transition-duration);
+
+    /* Don't transition width and height on open/close. */
+    &[data-starting-style],
+    &[data-ending-style] {
+      transition: var(--media-popup-transition);
+    }
+  }
 }
 
 /* ==========================================================================
@@ -1438,126 +1985,127 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
     border-radius: inherit;
     transition: --media-progress-fill 200ms linear;
   }
-}
 
-.media-default-skin .media-input-feedback-island--volume[data-level="high"] .media-icon--volume-high,
-.media-default-skin .media-input-feedback-island--volume[data-level="low"] .media-icon--volume-low,
-.media-default-skin .media-input-feedback-island--volume[data-level="off"] .media-icon--volume-off {
-  display: block;
-}
+  &[data-level="high"] .media-icon--volume-high,
+  &[data-level="low"] .media-icon--volume-low,
+  &[data-level="off"] .media-icon--volume-off {
+    display: block;
+  }
 
-.media-default-skin .media-input-feedback-island--status[data-status="captions-on"] .media-icon--captions-on,
-.media-default-skin .media-input-feedback-island--status[data-status="captions-off"] .media-icon--captions-off,
-.media-default-skin .media-input-feedback-island--status[data-status="fullscreen"] .media-icon--fullscreen-enter,
-.media-default-skin .media-input-feedback-island--status[data-status="exit-fullscreen"] .media-icon--fullscreen-exit,
-.media-default-skin .media-input-feedback-island--status[data-status="pip"] .media-icon--pip-enter,
-.media-default-skin .media-input-feedback-island--status[data-status="exit-pip"] .media-icon--pip-exit {
-  display: block;
+  @media (prefers-reduced-motion: no-preference) {
+    &[data-min],
+    &[data-max] {
+      animation: media-shake 300ms ease-in-out;
+    }
+  }
 }
 
-/* --- Boundary shake ------------------------------------------------------- */
-
-@media (prefers-reduced-motion: no-preference) {
-  .media-default-skin .media-input-feedback-island--volume[data-min],
-  .media-default-skin .media-input-feedback-island--volume[data-max] {
-    animation: media-shake 300ms ease-in-out;
+.media-default-skin .media-input-feedback-island--status {
+  &[data-status="captions-on"] .media-icon--captions-on,
+  &[data-status="captions-off"] .media-icon--captions-off,
+  &[data-status="fullscreen"] .media-icon--fullscreen-enter,
+  &[data-status="exit-fullscreen"] .media-icon--fullscreen-exit,
+  &[data-status="pip"] .media-icon--pip-enter,
+  &[data-status="exit-pip"] .media-icon--pip-exit {
+    display: block;
   }
 }
 
 /* --- Bubble ---------------------------------------------------------------- */
 
 .media-default-skin .media-input-feedback-bubble {
-  display: flex;
-  flex-direction: column;
+  display: grid;
   grid-row: 1;
-  grid-column: 2; /* default to center for status bubbles and undirected seeks */
-  align-items: center;
-  justify-content: center;
+  grid-column: 2;
+  place-content: center;
   padding: 1rem;
-  transition: opacity 250ms ease-out;
-
-  @container media-root (width > 24rem) {
-    padding: 2rem;
-  }
+  text-align: center;
 
-  &[data-starting-style],
-  &[data-ending-style] {
-    opacity: 0;
-    transition-timing-function: ease-in;
+  /* Central bubble (play, pause) */
+  &:not([data-direction]) {
+    background: oklch(0 0 0 / 0.35);
+    border-radius: 100%;
+    backdrop-filter: blur(8px);
+    transition-timing-function: ease-out;
     transition-duration: 200ms;
-  }
-}
+    transition-property: opacity, scale;
 
-/* Direction placement — seek bubbles move to the side implied by their direction. */
-.media-default-skin .media-input-feedback-bubble[data-direction="backward"] {
-  grid-column: 1;
-  justify-self: left;
-}
+    &[data-starting-style],
+    &[data-ending-style] {
+      opacity: 0;
+      scale: 0.85;
+    }
 
-.media-default-skin .media-input-feedback-bubble:not([data-direction]) {
-  grid-column: 2;
-  transition-timing-function:
-    ease-out, linear(0, 0.12 1.5%, 1.35 9.7%, 2.2 13.9%, 3 19.9%, 2.7 21.8%, 0.62 37.5%, 0.96 50.9%, 1);
-  transition-duration: 600ms;
-  transition-property: opacity, scale;
+    &[data-ending-style] {
+      transition-timing-function: ease-in;
+      transition-duration: 100ms;
+    }
 
-  @media (prefers-reduced-motion: reduce) {
-    transition: opacity 100ms ease-out;
+    @media (prefers-reduced-motion: reduce) {
+      transition-duration: 50ms;
+      transition-property: opacity;
+    }
   }
 
-  &[data-starting-style],
-  &[data-ending-style] {
-    opacity: 0;
-    scale: 0.8;
-    transition-timing-function: ease-in;
-    transition-duration: 200ms;
+  /* Directional bubbles (seek) */
+  &[data-direction] {
+    gap: 0.25rem;
+
+    @container media-root (width > 24rem) {
+      padding: 1.5rem;
+    }
   }
-}
 
-.media-default-skin .media-input-feedback-bubble[data-direction="forward"] {
-  grid-column: 3;
-  justify-self: right;
-}
+  &[data-direction="backward"] {
+    grid-column: 1;
+    justify-self: left;
+  }
 
-/* --- Bubble icons ---------------------------------------------------------- */
+  &[data-direction="forward"] {
+    grid-column: 3;
+    justify-self: right;
+  }
 
-.media-default-skin .media-input-feedback-bubble .media-icon {
-  display: none;
-  width: 36px;
-  height: 36px;
-}
+  /* Icons */
+  .media-icon {
+    display: none;
+    width: calc(var(--media-icon-size) * 1.5);
+    height: calc(var(--media-icon-size) * 1.5);
 
-/* seek: seek icon, flipped for backward */
-.media-default-skin .media-input-feedback-bubble[data-direction] .media-icon--seek {
-  display: block;
-}
+    &.media-icon--play {
+      translate: 1px 0;
+    }
+  }
 
-.media-default-skin .media-input-feedback-bubble[data-direction="backward"] .media-icon--seek {
-  transform: scaleX(-1);
-}
+  &[data-direction] .media-icon--seek,
+  &[data-status="pause"] .media-icon--pause,
+  &[data-status="play"] .media-icon--play {
+    display: block;
+  }
 
-@media (prefers-reduced-motion: no-preference) {
-  .media-default-skin
-    .media-input-feedback-bubble[data-direction="forward"]:not([data-starting-style])
-    .media-icon--seek {
-    animation: media-slide-in-forward 300ms ease-in-out;
+  &[data-direction="backward"] .media-icon--seek {
+    scale: -1 1;
   }
 
-  .media-default-skin
-    .media-input-feedback-bubble[data-direction="backward"]:not([data-starting-style])
+  @media (prefers-reduced-motion: no-preference) {
     .media-icon--seek {
-    animation: media-slide-in-backward 300ms ease-in-out;
-  }
+      transition-timing-function: ease-in-out;
+      transition-duration: 200ms;
+      transition-property: translate, opacity;
+    }
 
-  .media-default-skin .media-input-feedback-island--status[data-status]:not([data-starting-style]) .media-icon,
-  .media-default-skin .media-input-feedback-bubble[data-status]:not([data-starting-style]) .media-icon {
-    animation: media-pop-in 250ms ease-out;
-  }
-}
+    &[data-starting-style] .media-icon--seek,
+    &[data-ending-style] .media-icon--seek {
+      opacity: 0;
+    }
 
-.media-default-skin .media-input-feedback-bubble[data-status="pause"] .media-icon--pause,
-.media-default-skin .media-input-feedback-bubble[data-status="play"] .media-icon--play {
-  display: block;
+    &[data-direction="forward"][data-starting-style] .media-icon--seek {
+      translate: -60% 0;
+    }
+    &[data-direction="backward"][data-starting-style] .media-icon--seek {
+      translate: 60% 0;
+    }
+  }
 }
 
 /* ==========================================================================
@@ -1582,6 +2130,8 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 .media-button--pip .media-icon--pip-exit,
 .media-button--cast .media-icon--cast-enter,
 .media-button--cast .media-icon--cast-exit,
+.media-button--airplay .media-icon--airplay-enter,
+.media-button--airplay .media-icon--airplay-exit,
 .media-button--captions .media-icon--captions-off,
 .media-button--captions .media-icon--captions-on {
   display: none;
@@ -1592,10 +2142,11 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 
 /* Play: ended → restart */
 .media-button--play[data-ended] .media-icon--restart,
-/* Play: paused (not ended) → play */
+/* Play: paused or not yet started (not ended) → play */
 .media-button--play:not([data-ended])[data-paused] .media-icon--play,
-/* Play: playing (not paused, not ended) → pause */
-.media-button--play:not([data-paused]):not([data-ended]) .media-icon--pause,
+.media-button--play:not([data-ended]):not([data-started]) .media-icon--play,
+/* Play: started and not paused/ended → pause */
+.media-button--play[data-started]:not([data-paused]):not([data-ended]) .media-icon--pause,
 /* Mute: muted → volume off */
 .media-button--mute[data-muted] .media-icon--volume-off,
 /* Mute: volume low (not muted) → volume low */
@@ -1614,6 +2165,10 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 .media-button--cast:not([data-cast-state="connected"]) .media-icon--cast-enter,
 /* Cast: connected → exit */
 .media-button--cast[data-cast-state="connected"] .media-icon--cast-exit,
+/* AirPlay: not connected → enter */
+.media-button--airplay:not([data-airplay-state="connected"]) .media-icon--airplay-enter,
+/* AirPlay: connected → exit */
+.media-button--airplay[data-airplay-state="connected"] .media-icon--airplay-exit,
 /* Captions: not active → captions off */
 .media-button--captions:not([data-active]) .media-icon--captions-off,
 /* Captions: active → captions on */
@@ -1622,6 +2177,17 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   opacity: 1;
 }
 
+/* --- Pause keyframe animations on inactive icons --- */
+
+/* The airplay-exit SVG defines its keyframes against CSS variables (mirroring
+   the spinner pattern). When the AirPlay session isn't active the SVG is
+   still in the DOM — just `display: none` — so its animations would keep
+   running. Set the variables to `none` to short-circuit the keyframes. */
+.media-button--airplay:not([data-airplay-state="connected"]) {
+  --media-icon--airplay__fill-animation: none;
+  --media-icon--airplay__triangle-animation: none;
+}
+
 /* -------------------------------------------------------------------------- */
 /* Global @keyframes for all video skins (CSS & Tailwind)                     */
 /* -------------------------------------------------------------------------- */
@@ -1645,27 +2211,6 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   }
 }
 
-@keyframes media-slide-in-forward {
-  from {
-    translate: -60% 0;
-    opacity: 0;
-  }
-}
-
-@keyframes media-slide-in-backward {
-  from {
-    translate: 60% 0;
-    opacity: 0;
-  }
-}
-
-@keyframes media-pop-in {
-  from {
-    scale: 0.8;
-    opacity: 0;
-  }
-}
-
 /* -------------------------------------------------------------------------- */
 /* Global @properties for all video skins (CSS & Tailwind)                    */
 /* -------------------------------------------------------------------------- */
@@ -1711,6 +2256,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   --media-tooltip-boundary-offset: 0.5rem;
   --media-popover-side-offset: 0.5rem;
   --media-popover-boundary-offset: 0.5rem;
+  overflow: clip;
   background: oklch(0 0 0);
 
   @media (prefers-reduced-motion: reduce) {
@@ -1818,8 +2364,6 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   bottom: 0.5rem;
   z-index: 10;
   flex-wrap: wrap;
-  max-width: 56rem;
-  margin-inline: auto;
   color: var(--media-color-primary, oklch(1 0 0));
   transform-origin: bottom;
   transition-timing-function: var(--media-controls-transition-timing-function);
@@ -1902,21 +2446,33 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   box-shadow: 0 0 0 1px oklch(0 0 0 / 0.05);
 }
 
-.media-default-skin--video .media-slider__preview {
-  --media-preview-max-width: 11rem;
-  --media-preview-padding: -1.125rem;
+.media-default-skin--video .media-slider__thumbnail {
+  --media-slider-thumbnail-max-width: 11rem;
+  --media-slider-thumbnail-max-height: 8rem;
+  --media-slider-thumbnail-padding: -1.125rem;
   /**
     Inset is the difference between the container width and the slider (100%) width.
     Divided by 2 as we render the time on both sides.
   */
-  --media-preview-inset: calc((100cqi - 100%) / 2);
+  --media-slider-thumbnail-inset: calc((100cqi - 100%) / 2);
 
   position: absolute;
   bottom: calc(100% + 1.2rem);
   left: clamp(
-    calc(var(--media-preview-max-width) / 2 + var(--media-preview-padding) - var(--media-preview-inset)),
+    calc(
+      var(--media-slider-thumbnail-max-width) /
+      2 +
+      var(--media-slider-thumbnail-padding) -
+      var(--media-slider-thumbnail-inset)
+    ),
     var(--media-slider-pointer),
-    calc(100% - var(--media-preview-max-width) / 2 - var(--media-preview-padding) + var(--media-preview-inset))
+    calc(
+      100% -
+      var(--media-slider-thumbnail-max-width) /
+      2 -
+      var(--media-slider-thumbnail-padding) +
+      var(--media-slider-thumbnail-inset)
+    )
   );
   pointer-events: none;
   opacity: 0;
@@ -1928,19 +2484,22 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
   transition-duration: 150ms;
   transition-property: scale, opacity, filter;
 
-  & .media-preview__thumbnail {
-    max-width: var(--media-preview-max-width);
-  }
-
-  &:has(.media-preview__thumbnail[data-loading]) {
-    max-height: 6rem;
+  & .media-thumbnail__image {
+    max-width: var(--media-slider-thumbnail-max-width);
+    max-height: var(--media-slider-thumbnail-max-height);
   }
 }
-.media-default-skin--video .media-slider[data-pointing] .media-slider__preview:has([role="img"]:not([data-hidden])) {
+.media-default-skin--video .media-slider[data-pointing] .media-slider__thumbnail:has([role="img"]:not([data-hidden])) {
   opacity: 1;
   filter: blur(0);
   scale: 1;
 }
+.media-default-skin--video
+  .media-slider__thumbnail:has([role="img"]:not([data-hidden]))
+  + .media-slider__preview
+  .media-slider__value {
+  display: none;
+}
 
 ```
 
@@ -1948,7 +2507,7 @@ function isRenderProp(value: unknown): value is RenderProp<unknown> {
 
 Each skin is built with specific [features](./features.md) in mind. For example, a video skin renders fullscreen and picture-in-picture controls. An audio skin doesn’t.
 
-You’ll find both a skin and the feature bundle it expects exported from the same path. We call these paths **presets** .
+You’ll find both a skin and the feature bundle it expects exported from the same path. We call these paths **presets**.
 
 Import
 
@@ -1968,11 +2527,17 @@ Feature bundle
 
 Features
 
-[playback](../reference/feature-playback.md), [playbackRate](../reference/feature-playback-rate.md), [volume](../reference/feature-volume.md), [time](../reference/feature-time.md), [source](../reference/feature-source.md), [buffer](../reference/feature-buffer.md), [fullscreen](../reference/feature-fullscreen.md), [pip](../reference/feature-pip.md), [remotePlayback](../reference/feature-remote-playback.md), [controls](../reference/feature-controls.md), [textTrack](../reference/feature-text-tracks.md), [error](../reference/feature-error.md)
+[playback](../reference/feature-playback.md), [playbackRate](../reference/feature-playback-rate.md), [quality](../reference/feature-quality.md), [audioTrack](../reference/feature-audio-track.md), [volume](../reference/feature-volume.md), [time](../reference/feature-time.md), [source](../reference/feature-source.md), [buffer](../reference/feature-buffer.md), [fullscreen](../reference/feature-fullscreen.md), [pip](../reference/feature-pip.md), [remotePlayback](../reference/feature-remote-playback.md), [controls](../reference/feature-controls.md), [textTrack](../reference/feature-text-tracks.md), [error](../reference/feature-error.md)
 
 Skins
 
-`<MinimalVideoSkin>`, `<VideoSkin>`
+`<MinimalVideoSkin>`
+
+`import '@videojs/react/video/minimal-skin.css';`
+
+`<VideoSkin>`
+
+`import '@videojs/react/video/skin.css';`
 
 Default media element
 
@@ -1994,7 +2559,13 @@ Features
 
 Skins
 
-`<MinimalAudioSkin>`, `<AudioSkin>`
+`<MinimalAudioSkin>`
+
+`import '@videojs/react/audio/minimal-skin.css';`
+
+`<AudioSkin>`
+
+`import '@videojs/react/audio/skin.css';`
 
 Default media element
 
@@ -2018,6 +2589,8 @@ Skins
 
 `<BackgroundVideoSkin>`
 
+`import '@videojs/react/background/skin.css';`
+
 Default media element
 
 `<BackgroundVideo>`
@@ -2038,7 +2611,13 @@ Features
 
 Skins
 
-`<MinimalLiveAudioSkin>`, `<LiveAudioSkin>`
+`<MinimalLiveAudioSkin>`
+
+`import '@videojs/react/live-audio/minimal-skin.css';`
+
+`<LiveAudioSkin>`
+
+`import '@videojs/react/live-audio/skin.css';`
 
 Default media element
 
@@ -2060,7 +2639,13 @@ Features
 
 Skins
 
-`<MinimalLiveVideoSkin>`, `<LiveVideoSkin>`
+`<MinimalLiveVideoSkin>`
+
+`import '@videojs/react/live-video/minimal-skin.css';`
+
+`<LiveVideoSkin>`
+
+`import '@videojs/react/live-video/skin.css';`
 
 Default media element
 
@@ -2074,7 +2659,7 @@ Presets are a topic quite a bit bigger than just this guide. To learn more, chec
 
 There are currently two options for styling:
 
-*   Vanilla CSS where you import the stylesheet in your app. This is the default.
+*   Vanilla CSS — import the stylesheet listed for each skin in the [preset table](#skins-features-and-presets). This is the default.
 *   Tailwind where you [eject](../how-to/customize-skins#ejecting) the skin and use Tailwind classnames in your app.
 
 ### Current limitations