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

package/dist/default/presets/live-audio/skin.css

@@ -16,6 +16,10 @@
 .media-default-skin button {
   font: inherit;
 }
+.media-default-skin [hidden][hidden] {
+  /* Keep authored templates hidden even when component classes set display. */
+  display: none;
+}
 @media (prefers-reduced-motion: no-preference) {
   .media-default-skin {
     interpolate-size: allow-keywords;
@@ -27,38 +31,49 @@
    ========================================================================== */
 
 .media-default-skin {
-  container: media-root / inline-size;
+  --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;
-  isolation: isolate;
   display: block;
-  height: 100%;
   width: 100%;
-  border-radius: var(--media-border-radius, 2rem);
-  outline: 2px solid transparent;
-  outline-offset: 2px;
-
-  &:focus-visible {
-    outline-color: currentColor;
-  }
+  height: 100%;
+  container: media-root / inline-size;
   font-family:
     Inter Variable,
     Inter,
     ui-sans-serif,
     system-ui,
     sans-serif;
-  line-height: 1.5;
-  letter-spacing: normal;
+  font-size: 0.8125rem; /* 13px at 100% font size */
   -webkit-font-smoothing: auto;
   -moz-osx-font-smoothing: auto;
+  line-height: 1.5;
+  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;
+  transition-duration: 100ms;
+  transition-property: outline-offset, outline-color;
 
-  & > * {
-    font-size: 0.75rem; /* 12px at 100% font size */
+  &:focus-visible {
+    outline-color: currentColor;
+    outline-offset: 2px;
   }
 
-  @container media-root (width > 48rem) {
-    & > * {
-      font-size: 0.875rem; /* 14px at 100% font size */
-    }
+  &::-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;
   }
 }
 
@@ -68,21 +83,21 @@
 
 .media-default-skin .media-surface {
   background-color: var(--media-surface-background-color);
-  backdrop-filter: var(--media-surface-backdrop-filter);
   box-shadow:
     0 0 0 1px var(--media-surface-outer-border-color),
     0 1px 3px 0 var(--media-surface-shadow-color),
     0 1px 2px -1px var(--media-surface-shadow-color);
+  backdrop-filter: var(--media-surface-backdrop-filter);
 
   /* Inner border ring */
   &::after {
-    content: "";
     position: absolute;
     inset: 0;
     z-index: 10;
+    pointer-events: none;
+    content: "";
     border-radius: inherit;
     box-shadow: inset 0 0 0 1px var(--media-surface-inner-border-color);
-    pointer-events: none;
   }
 }
 
@@ -93,19 +108,18 @@
 .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;
 
-  &[data-visible] {
-    display: flex;
+  &:not([data-visible]) {
+    --media-spinner-animation: none;
   }
 
-  .media-surface {
-    padding: 0.25rem;
-    border-radius: 100%;
+  &[data-visible] {
+    display: grid;
   }
 }
 
@@ -127,8 +141,8 @@
 }
 
 .media-default-skin .media-error__description {
-  opacity: 0.7;
   overflow-wrap: anywhere;
+  opacity: 0.7;
 }
 
 .media-default-skin .media-error__actions {
@@ -149,18 +163,13 @@
    ========================================================================== */
 
 .media-default-skin .media-controls {
-  container: media-controls / inline-size;
   display: flex;
-  align-items: center;
   column-gap: 0.075rem;
+  align-items: center;
   padding: 0.375rem;
+  container: media-controls / inline-size;
+  text-shadow: 0 1px 0 var(--media-current-shadow-color);
   border-radius: 1.5rem;
-  --media-controls-current-shadow-color: oklch(from currentColor 0 0 0 / clamp(0, calc((l - 0.5) * 0.5), 0.15));
-  --media-controls-current-shadow-color-subtle: oklch(
-    from var(--media-controls-current-shadow-color) l c h /
-    calc(alpha * 0.4)
-  );
-  text-shadow: 0 1px 0 var(--media-controls-current-shadow-color);
 }
 
 /* ==========================================================================
@@ -168,18 +177,33 @@
    ========================================================================== */
 
 .media-default-skin .media-time-controls {
-  container: media-time-controls / inline-size;
   display: flex;
-  align-items: center;
   flex: 1;
   gap: 0.75rem;
+  align-items: center;
   padding-inline: 0.5rem;
+  container: media-time-controls / inline-size;
 }
 
 .media-default-skin .media-time {
   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
    ========================================================================== */
@@ -187,23 +211,24 @@
 /* Base button */
 .media-default-skin .media-button {
   display: flex;
+  flex-shrink: 0;
   align-items: center;
   justify-content: center;
-  flex-shrink: 0;
+  min-height: 0;
   padding: 0.5rem 1rem;
-  border: none;
-  border-radius: calc(infinity * 1px);
+  text-align: center;
+  touch-action: manipulation;
+  cursor: pointer;
+  user-select: none;
   outline: 2px solid transparent;
   outline-offset: -2px;
+  border: none;
+  border-radius: calc(infinity * 1px);
+  transition-timing-function: ease-out;
+  transition-duration: 150ms;
   transition-property: background-color, outline-offset, scale;
   /* Fix weird jumping when clicking on the buttons in Safari. */
   will-change: scale;
-  transition-duration: 150ms;
-  transition-timing-function: ease-out;
-  cursor: pointer;
-  user-select: none;
-  text-align: center;
-  touch-action: manipulation;
 
   &:focus-visible {
     outline-color: currentColor;
@@ -215,9 +240,9 @@
   }
 
   &[disabled] {
+    cursor: not-allowed;
     opacity: 0.5;
     filter: grayscale(1);
-    cursor: not-allowed;
   }
 
   &[data-availability="unavailable"],
@@ -228,23 +253,23 @@
 
 /* Primary button variant */
 .media-default-skin .media-button--primary {
-  background: oklch(1 0 0);
-  color: oklch(0 0 0);
   font-weight: 500;
+  color: oklch(0 0 0);
   text-shadow: none;
+  background: oklch(1 0 0);
 }
 
 /* Subtle button variant */
 .media-default-skin .media-button--subtle {
-  background: transparent;
   color: inherit;
   text-shadow: inherit;
+  background: transparent;
 
   &:hover,
   &:focus-visible,
   &[aria-expanded="true"] {
-    background-color: oklch(from currentColor l c h / 0.1);
     text-decoration: none;
+    background-color: oklch(from currentColor l c h / 0.1);
   }
 }
 
@@ -252,15 +277,24 @@
 .media-default-skin .media-button--icon {
   display: grid;
   width: 2.25rem;
-  padding: 0;
   aspect-ratio: 1;
+  padding: 0;
 
   &:active {
     scale: 0.9;
   }
 
+  & .media-icon__container {
+    display: grid;
+  }
+
   & .media-icon {
-    filter: drop-shadow(0 1px 0 var(--media-controls-current-shadow-color, oklch(0 0 0 / 0.25)));
+    grid-area: 1 / 1;
+    transition-behavior: allow-discrete;
+    transition-property: display, opacity;
+    transition-duration: 150ms;
+    transition-timing-function: ease-out;
+    filter: drop-shadow(0 1px 0 var(--media-current-shadow-color));
   }
 }
 
@@ -271,8 +305,9 @@
     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 {
@@ -284,11 +319,68 @@
 /* Playback rate button */
 .media-default-skin .media-button--playback-rate {
   padding: 0;
+  font-variant-numeric: tabular-nums;
 
   &::after {
-    content: attr(data-rate) "\00D7";
     width: 4ch;
-    font-variant-numeric: tabular-nums;
+    content: attr(data-rate) "\00D7";
+  }
+
+  &[data-inline-rate-label]::after {
+    content: none;
+  }
+}
+
+/* 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. */
+.media-default-skin .media-button--live {
+  display: inline-flex;
+  gap: 0.4rem;
+  align-items: center;
+  width: auto;
+  aspect-ratio: auto;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  line-height: 1;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+
+  &::before {
+    display: inline-block;
+    flex-shrink: 0;
+    width: 0.5rem;
+    height: 0.5rem;
+    content: "";
+    background-color: oklch(from currentColor l c h / 0.4);
+    border-radius: 50%;
+    transition: background-color 150ms ease-out;
+  }
+
+  &[data-live-edge]::before {
+    background-color: oklch(0.65 0.22 27);
   }
 }
 
@@ -298,14 +390,29 @@
 
 .media-default-skin .media-button-group {
   display: flex;
-  align-items: center;
   gap: 0.075rem;
+  align-items: center;
 
   @container media-root (width > 42rem) {
     gap: 0.125rem;
   }
 }
 
+/* ==========================================================================
+   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
    ========================================================================== */
@@ -313,16 +420,11 @@
 .media-default-skin .media-icon__container {
   position: relative;
 }
+
 .media-default-skin .media-icon {
-  display: block;
   flex-shrink: 0;
-  grid-area: 1 / 1;
-  width: 18px;
-  height: 18px;
-  transition-behavior: allow-discrete;
-  transition-property: display, opacity;
-  transition-duration: 150ms;
-  transition-timing-function: ease-out;
+  width: var(--media-icon-size);
+  height: var(--media-icon-size);
 }
 .media-default-skin .media-icon--flipped {
   scale: -1 1;
@@ -335,16 +437,16 @@
 .media-default-skin .media-slider {
   position: relative;
   display: flex;
+  flex: 1;
   align-items: center;
   justify-content: center;
-  flex: 1;
-  border-radius: calc(infinity * 1px);
-  outline: none;
   cursor: pointer;
+  outline: none;
+  border-radius: calc(infinity * 1px);
 
   &[data-orientation="horizontal"] {
-    min-width: 5rem;
     width: 100%;
+    min-width: 5rem;
     height: 2rem;
   }
 
@@ -357,10 +459,10 @@
 /* Track */
 .media-default-skin .media-slider__track {
   position: relative;
-  isolation: isolate;
   overflow: hidden;
-  border-radius: inherit;
   user-select: none;
+  border-radius: inherit;
+  isolation: isolate;
 
   &[data-orientation="horizontal"] {
     width: 100%;
@@ -375,24 +477,24 @@
 
 /* Thumb */
 .media-default-skin .media-slider__thumb {
-  z-index: 10;
   position: absolute;
-  translate: -50% -50%;
+  z-index: 10;
   width: 0.625rem;
   height: 0.625rem;
+  user-select: none;
+  outline: 4px solid transparent;
+  outline-offset: -4px;
   background-color: currentColor;
   border-radius: calc(infinity * 1px);
   box-shadow:
-    0 0 0 1px var(--media-controls-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;
-  transition-property: opacity, height, width, outline-offset;
-  transition-duration: 150ms;
+  translate: -50% -50%;
   transition-timing-function: ease-out;
-  user-select: none;
-  outline: 4px solid transparent;
-  outline-offset: -4px;
+  transition-duration: 150ms;
+  transition-property: opacity, height, width, outline-offset;
 
   &[data-orientation="horizontal"] {
     top: 50%;
@@ -400,30 +502,30 @@
   }
 
   &[data-orientation="vertical"] {
-    left: 50%;
     top: calc(100% - var(--media-slider-fill));
+    left: 50%;
   }
 
   &: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;
   }
 
   &::after {
-    content: "";
     position: absolute;
     inset: -4px;
+    content: "";
     border-radius: inherit;
-    box-shadow: 0 0 0 2px oklch(1 0 0);
-    transition-property: opacity, scale;
-    transition-duration: 150ms;
+    box-shadow: 0 0 0 2px currentColor;
     transition-timing-function: ease-out;
+    transition-duration: 150ms;
+    transition-property: opacity, scale;
   }
 
   &:not(:focus-visible)::after {
-    scale: 0.5;
     opacity: 0;
+    scale: 0.5;
   }
 }
 
@@ -439,12 +541,55 @@
   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 {
   position: absolute;
-  border-radius: inherit;
   pointer-events: none;
+  border-radius: inherit;
 }
 
 .media-default-skin .media-slider__buffer[data-orientation="horizontal"],
@@ -462,8 +607,8 @@
 /* Buffer */
 .media-default-skin .media-slider__buffer {
   background-color: oklch(from currentColor l c h / 0.2);
-  transition-duration: 0.25s;
   transition-timing-function: ease-out;
+  transition-duration: 0.25s;
 
   &[data-orientation="horizontal"] {
     width: var(--media-slider-buffer);
@@ -510,51 +655,66 @@
    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;
-  border: 0;
-  color: inherit;
   overflow: visible;
-  transition-property: scale, opacity, filter;
-  transition-duration: var(--media-popup-transition-duration);
-  transition-timing-function: var(--media-popup-transition-timing-function);
+  color: inherit;
+  border: 0;
+  transition: var(--media-popup-transition);
 
   &[data-starting-style],
   &[data-ending-style] {
     opacity: 0;
-    scale: 0.5;
-    filter: blur(8px);
+    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;
   }
 
   /* Safe area between trigger and popup */
   &::before {
-    content: "";
     position: absolute;
     pointer-events: inherit;
+    content: "";
   }
 
   &[data-side="top"]::before,
   &[data-side="bottom"]::before {
-    width: 100%;
     inset-inline: 0;
+    width: 100%;
   }
   &[data-side="top"]::before {
     top: 100%;
@@ -565,8 +725,8 @@
 
   &[data-side="left"]::before,
   &[data-side="right"]::before {
-    height: 100%;
     inset-block: 0;
+    height: 100%;
   }
   &[data-side="left"]::before {
     left: 100%;
@@ -597,9 +757,16 @@
 
 .media-default-skin .media-tooltip {
   padding: 0.25rem 0.625rem;
-  border-radius: calc(infinity * 1px);
   font-size: 0.75rem;
   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 {
@@ -609,6 +776,250 @@
   &[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);
+    }
+  }
 }
 
 /* ==========================================================================
@@ -635,10 +1046,11 @@
 
 /* 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 */
@@ -666,7 +1078,9 @@
   --media-popup-transition-duration: 100ms;
   --media-popup-transition-timing-function: ease-out;
   --media-tooltip-side-offset: 0.75rem;
+  --media-tooltip-boundary-offset: 0.75rem;
   --media-popover-side-offset: 0.75rem;
+  --media-popover-boundary-offset: 0.75rem;
 
   @media (prefers-reduced-motion: reduce) {
     --media-error-dialog-transition-duration: 50ms;
@@ -700,17 +1114,17 @@
   inset: 0;
   z-index: 20;
   display: flex;
-  align-items: center;
   gap: 0.75rem;
+  align-items: center;
   padding-inline: 1.25rem 0.125rem;
-  transition-property: opacity, filter;
-  transition-duration: var(--media-error-dialog-transition-duration);
-  transition-delay: var(--media-error-dialog-transition-delay);
-  transition-timing-function: ease-out;
-  border-radius: calc(infinity * 1px);
+  color: var(--media-text-color);
   background-color: var(--media-surface-background-color);
+  border-radius: calc(infinity * 1px);
   backdrop-filter: var(--media-surface-backdrop-filter);
-  color: var(--media-text-color);
+  transition-delay: var(--media-error-dialog-transition-delay);
+  transition-timing-function: ease-out;
+  transition-duration: var(--media-error-dialog-transition-duration);
+  transition-property: opacity, filter;
 }
 
 .media-default-skin .media-error[data-starting-style] .media-error__dialog,
@@ -723,8 +1137,8 @@
 }
 
 .media-default-skin--audio .media-error__content {
-  flex: 1;
   display: flex;
+  flex: 1;
   gap: 0.5rem;
   align-items: center;
 }
@@ -737,6 +1151,26 @@
   color: var(--media-text-color);
 }
 
+/* ==========================================================================
+   Buffering (spinner over play button — overlay only, no layout change)
+   ========================================================================== */
+
+.media-default-skin--audio .media-button--play__wrapper {
+  position: relative;
+  display: inline-flex;
+}
+
+.media-default-skin--audio .media-button--play__wrapper .media-buffering-indicator {
+  color: inherit;
+}
+
+.media-default-skin--audio
+  .media-button--play__wrapper:has(.media-buffering-indicator[data-visible])
+  .media-button--play
+  .media-icon {
+  opacity: 0;
+}
+
 /* ==========================================================================
    Sliders
    ========================================================================== */