@videojs/html 10.0.0-alpha.9 → 10.0.0-beta.10

package/dist/default/define/video/skin.css

@@ -1,54 +1,3 @@
-/* ==========================================================================
-   Icon State Visibility
-
-   Data-attribute-driven visibility rules for multi-state icon buttons.
-   Uses :is() with both element selectors (for HTML custom element wrappers)
-   and class selectors (for React rendered SVG elements).
-   ========================================================================== */
-
-/* --- All icons hidden by default --- */
-
-.media-button--play .media-icon--restart,
-.media-button--play .media-icon--play,
-.media-button--play .media-icon--pause,
-.media-button--mute .media-icon--volume-off,
-.media-button--mute .media-icon--volume-low,
-.media-button--mute .media-icon--volume-high,
-.media-button--fullscreen .media-icon--fullscreen-enter,
-.media-button--fullscreen .media-icon--fullscreen-exit,
-.media-button--captions .media-icon--captions-off,
-.media-button--captions .media-icon--captions-on {
-  display: none;
-  opacity: 0;
-}
-
-/* --- Active icon per state --- */
-
-/* Play: ended → restart */
-.media-button--play[data-ended] .media-icon--restart,
-/* Play: paused (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,
-/* Mute: muted → volume off */
-.media-button--mute[data-muted] .media-icon--volume-off,
-/* Mute: volume low (not muted) → volume low */
-.media-button--mute:not([data-muted])[data-volume-level="low"] .media-icon--volume-low,
-/* Mute: volume high (not muted, not low) → volume high */
-.media-button--mute:not([data-muted]):not([data-volume-level="low"]) .media-icon--volume-high,
-/* Fullscreen: not fullscreen → enter */
-.media-button--fullscreen:not([data-fullscreen]) .media-icon--fullscreen-enter,
-/* Fullscreen: fullscreen → exit */
-.media-button--fullscreen[data-fullscreen] .media-icon--fullscreen-exit,
-/* Captions: not active → captions off */
-.media-button--captions:not([data-active]) .media-icon--captions-off,
-/* Captions: active → captions on */
-.media-button--captions[data-active] .media-icon--captions-on {
-  display: block;
-  opacity: 1;
-}
-
-
 /* ==========================================================================
    Reset
    ========================================================================== */
@@ -57,7 +6,6 @@
 .media-default-skin *::before,
 .media-default-skin *::after {
   box-sizing: border-box;
-  margin: 0;
 }
 .media-default-skin img,
 .media-default-skin video,
@@ -82,10 +30,10 @@
   position: relative;
   isolation: isolate;
   display: block;
+  height: 100%;
+  width: 100%;
   container: media-root / inline-size;
-  overflow: clip;
   border-radius: var(--media-border-radius, 2rem);
-  background: oklch(0 0 0);
   font-family:
     Inter Variable,
     Inter,
@@ -99,56 +47,60 @@
   -moz-osx-font-smoothing: auto;
 }
 
-/* Inner border rings */
-.media-default-skin::before,
-.media-default-skin::after {
-  content: "";
-  position: absolute;
-  z-index: 10;
-  border-radius: inherit;
-  pointer-events: none;
-}
-.media-default-skin::before {
-  inset: 1px;
-  box-shadow: inset 0 0 0 1px oklch(1 0 0 / 0.15);
-}
-.media-default-skin::after {
-  inset: 0;
-  box-shadow: inset 0 0 0 1px oklch(0 0 0 / 0.1);
-}
+/* ==========================================================================
+   Surface (shared glass effect for tooltips, popovers, controls)
+   ========================================================================== */
+
+.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);
+
+  /* Inner border ring */
+  &::after {
+    content: "";
+    position: absolute;
+    inset: 0;
+    z-index: 10;
+    border-radius: inherit;
+    box-shadow: inset 0 0 0 1px var(--media-surface-inner-border-color);
+    pointer-events: none;
+  }
+
+  @media (prefers-reduced-transparency: reduce) {
+    background-color: oklch(from var(--media-surface-background-color) l c h / 0.7);
+  }
 
-/* Fullscreen */
-.media-default-skin:fullscreen {
-  border-radius: 0;
+  @media (prefers-contrast: more) {
+    background-color: oklch(from var(--media-surface-background-color) l c h / 0.9);
+  }
 }
 
 /* ==========================================================================
    Media Element
    ========================================================================== */
 
-.media-default-skin > video {
+.media-default-skin ::slotted(video),
+.media-default-skin video {
   display: block;
   width: 100%;
   height: 100%;
-  border-radius: inherit;
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
 }
-
-/* ==========================================================================
-   Poster Image
-   ========================================================================== */
-
-.media-default-skin > img {
-  position: absolute;
-  inset: 0;
-  width: 100%;
-  height: 100%;
+.media-default-skin ::slotted(video) {
+  border-radius: var(--media-video-border-radius);
+}
+.media-default-skin video {
   border-radius: inherit;
-  object-fit: cover;
-  transition: opacity 0.25s;
-  pointer-events: none;
 }
-.media-default-skin > img:not([data-visible]) {
-  opacity: 0;
+
+.media-default-skin:fullscreen ::slotted(video),
+.media-default-skin:fullscreen video {
+  object-fit: contain;
 }
 
 /* ==========================================================================
@@ -158,30 +110,29 @@
 .media-default-skin .media-overlay {
   position: absolute;
   inset: 0;
-  z-index: 1;
   border-radius: inherit;
   background-image: linear-gradient(to top, oklch(0 0 0 / 0.5), oklch(0 0 0 / 0.3), oklch(0 0 0 / 0));
-  backdrop-filter: blur(0) saturate(1.2) brightness(0.9);
+  backdrop-filter: blur(0) saturate(1.5);
   opacity: 0;
+  pointer-events: none;
   transition-property: opacity, backdrop-filter;
-  transition-duration: 300ms;
-  transition-delay: 500ms;
+  transition-duration: var(--media-controls-transition-duration);
+  transition-delay: var(--media-controls-transition-delay);
   transition-timing-function: ease-out;
-  pointer-events: none;
 }
-@media (prefers-reduced-motion: reduce) {
-  .media-default-skin .media-overlay {
-    transition-duration: 100ms;
-  }
+
+.media-default-skin .media-error ~ .media-overlay {
+  transition-duration: var(--media-error-dialog-transition-duration);
+  transition-delay: var(--media-error-dialog-transition-delay);
 }
+
 .media-default-skin .media-controls[data-visible] ~ .media-overlay,
 .media-default-skin .media-error[data-open] ~ .media-overlay {
   opacity: 1;
-  transition-duration: 150ms;
-  transition-delay: 0ms;
 }
+
 .media-default-skin .media-error[data-open] ~ .media-overlay {
-  backdrop-filter: blur(8px) saturate(1.2) brightness(0.9);
+  backdrop-filter: blur(16px) saturate(1.5);
 }
 
 /* ==========================================================================
@@ -191,19 +142,20 @@
 .media-default-skin .media-buffering-indicator {
   position: absolute;
   inset: 0;
-  z-index: 10;
   display: none;
   align-items: center;
   justify-content: center;
   color: oklch(1 0 0);
   pointer-events: none;
-}
-.media-default-skin .media-buffering-indicator[data-visible] {
-  display: flex;
-}
-.media-default-skin .media-buffering-indicator .media-surface {
-  padding: 0.25rem;
-  border-radius: 100%;
+
+  &[data-visible] {
+    display: flex;
+  }
+
+  .media-surface {
+    padding: 0.25rem;
+    border-radius: 100%;
+  }
 }
 
 /* ==========================================================================
@@ -211,95 +163,30 @@
    ========================================================================== */
 
 .media-default-skin .media-error {
-  position: absolute;
-  inset: 0;
-  z-index: 20;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  pointer-events: none;
-}
-.media-default-skin .media-error__dialog {
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-  max-width: 18rem;
-  padding: 0.75rem;
-  border-radius: 1.75rem;
-  color: oklch(1 0 0);
-  font-size: 0.875rem;
-  pointer-events: auto;
-  opacity: 1;
-  transform: scale(1);
-  transition-property: opacity, transform;
-  transition-duration: 500ms;
-  transition-delay: 100ms;
-  transition-timing-function: linear(
-    0,
-    0.034 1.5%,
-    0.763 9.7%,
-    1.066 13.9%,
-    1.198 19.9%,
-    1.184 21.8%,
-    0.963 37.5%,
-    0.997 50.9%,
-    1
-  );
-}
-.media-default-skin .media-error[data-starting-style] .media-error__dialog,
-.media-default-skin .media-error[data-ending-style] .media-error__dialog {
-  opacity: 0;
-  transform: scale(0.5);
-}
-.media-default-skin .media-error__content {
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-  padding: 0.5rem 0.5rem 0.375rem;
+  outline: none;
 }
+
 .media-default-skin .media-error__title {
   font-weight: 600;
   line-height: 1.25;
 }
+
 .media-default-skin .media-error__description {
   opacity: 0.7;
+  overflow-wrap: anywhere;
 }
+
 .media-default-skin .media-error__actions {
   display: flex;
   gap: 0.5rem;
-}
-.media-default-skin .media-error__actions > * {
-  flex: 1;
-}
-
-/* ==========================================================================
-   Surface (shared glass effect for tooltips, popovers, controls)
-   ========================================================================== */
 
-.media-default-skin .media-surface {
-  background-color: oklch(1 0 0 / 0.1);
-  backdrop-filter: blur(64px) brightness(0.9) saturate(1.5);
-  box-shadow:
-    inset 0 0 0 1px oklch(1 0 0 / 0.05),
-    0 0 0 1px oklch(0 0 0 / 0.15),
-    oklch(0 0 0 / 0.15) 0px 1px 3px 0px,
-    oklch(0 0 0 / 0.15) 0px 1px 2px -1px;
-}
-@media (prefers-reduced-transparency: reduce) {
-  .media-default-skin .media-surface {
-    background-color: oklch(0 0 0 / 0.7);
-    box-shadow:
-      inset 0 0 0 1px oklch(0 0 0),
-      0 0 0 1px oklch(1 0 0 / 0.2);
+  & > * {
+    flex: 1;
   }
 }
-@media (prefers-contrast: more) {
-  .media-default-skin .media-surface {
-    background-color: oklch(0 0 0 / 0.9);
-    box-shadow:
-      inset 0 0 0 1px oklch(0 0 0),
-      0 0 0 1px oklch(1 0 0 / 0.2);
-  }
+
+.media-default-skin .media-error[data-open] ~ .media-controls * {
+  visibility: hidden;
 }
 
 /* ==========================================================================
@@ -307,41 +194,20 @@
    ========================================================================== */
 
 .media-default-skin .media-controls {
-  position: absolute;
-  bottom: 0.75rem;
-  inset-inline: 0.75rem;
-  z-index: 10;
   container: media-controls / inline-size;
   display: flex;
   align-items: center;
   gap: 0.075rem;
   padding: 0.175rem;
   border-radius: calc(infinity * 1px);
-  color: oklch(1 0 0);
-  will-change: scale, transform, filter, opacity;
-  transition-property: scale, transform, filter, opacity;
-  transition-duration: 100ms;
-  transition-delay: 0ms;
-  transition-timing-function: ease-out;
-  transform-origin: bottom;
-}
-.media-default-skin .media-controls:not([data-visible]) {
-  opacity: 0;
-  scale: 0.9;
-  filter: blur(8px);
-  transition-duration: 300ms;
-  transition-delay: 500ms;
-  pointer-events: none;
-}
-@media (prefers-reduced-motion: reduce) {
-  .media-default-skin .media-controls:not([data-visible]) {
-    scale: 1;
-    filter: blur(0);
-    transition-duration: 100ms;
-  }
-}
-@container media-root (width > 40rem) {
-  .media-default-skin .media-controls {
+  --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);
+
+  @container media-root (width > 40rem) {
     gap: 0.125rem;
     padding: 0.25rem;
   }
@@ -358,18 +224,18 @@
   flex: 1;
   gap: 0.75rem;
   padding-inline: 0.5rem;
+
+  & .media-time__value:first-child {
+    display: none;
+
+    @container media-time (width > 18rem) {
+      display: block;
+    }
+  }
 }
+
 .media-default-skin .media-time__value {
   font-variant-numeric: tabular-nums;
-  text-shadow: 0 1px 0 oklch(0 0 0 / 0.25);
-}
-.media-default-skin .media-time .media-time__value:first-child {
-  display: none;
-}
-@container media-time (width > 18rem) {
-  .media-default-skin .media-time .media-time__value:first-child {
-    display: block;
-  }
 }
 
 /* ==========================================================================
@@ -383,28 +249,58 @@
   justify-content: center;
   flex-shrink: 0;
   padding: 0.5rem 1rem;
-  background: oklch(1 0 0);
   border: none;
   border-radius: calc(infinity * 1px);
   outline: 2px solid transparent;
   outline-offset: -2px;
-  color: oklch(0 0 0);
-  font-weight: 500;
-  text-align: center;
-  transition-property: background-color, color, outline-offset;
+  transition-property: background-color, outline-offset, 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;
+    outline-offset: 2px;
+  }
+
+  &:active {
+    scale: 0.98;
+  }
+
+  &[disabled] {
+    opacity: 0.5;
+    filter: grayscale(1);
+    cursor: not-allowed;
+  }
+
+  &[data-availability="unavailable"] {
+    display: none;
+  }
 }
-.media-default-skin .media-button:focus-visible {
-  outline-color: oklch(62.3% 0.214 259.815);
-  outline-offset: 2px;
+
+/* Primary button variant */
+.media-default-skin .media-button--primary {
+  background: oklch(1 0 0);
+  color: oklch(0 0 0);
+  font-weight: 500;
+  text-shadow: none;
 }
-.media-default-skin .media-button[disabled] {
-  opacity: 0.5;
-  filter: grayscale(1);
-  cursor: not-allowed;
+
+/* Subtle button variant */
+.media-default-skin .media-button--subtle {
+  background: transparent;
+  color: inherit;
+  text-shadow: inherit;
+
+  &:hover,
+  &:focus-visible,
+  &[aria-expanded="true"] {
+    background-color: oklch(from currentColor l c h / 0.1);
+    text-decoration: none;
+  }
 }
 
 /* Icon button variant */
@@ -413,36 +309,33 @@
   width: 2.125rem;
   padding: 0;
   aspect-ratio: 1;
-  background: transparent;
-  color: oklch(1 0 0 / 0.9);
-  text-shadow: 0 1px 0 oklch(0 0 0 / 0.25);
-}
-.media-default-skin .media-button--icon:hover,
-.media-default-skin .media-button--icon:focus-visible,
-.media-default-skin .media-button--icon[aria-expanded="true"] {
-  background-color: oklch(1 0 0 / 0.1);
-  color: oklch(1 0 0);
-  text-decoration: none;
-}
-.media-default-skin .media-button--icon .media-icon {
-  filter: drop-shadow(0 1px 0 oklch(0 0 0 / 0.25));
+
+  &:active {
+    scale: 0.9;
+  }
+
+  & .media-icon {
+    filter: drop-shadow(0 1px 0 var(--media-controls-current-shadow-color, oklch(0 0 0 / 0.25)));
+  }
 }
 
 /* Seek button */
-.media-default-skin .media-button--seek .media-icon__label {
-  position: absolute;
-  right: -1px;
-  bottom: -3px;
-  font-size: 0.75em;
-  font-weight: 480;
-  font-variant-numeric: tabular-nums;
-}
-.media-default-skin .media-button--seek:has(.media-icon--flipped) .media-icon__label {
-  right: unset;
-  left: -1px;
-}
-@container media-controls (width < 28rem) {
-  .media-default-skin .media-button--seek {
+.media-default-skin .media-button--seek {
+  & .media-icon__label {
+    position: absolute;
+    right: -1px;
+    bottom: -3px;
+    font-size: 10px;
+    font-weight: 480;
+    font-variant-numeric: tabular-nums;
+  }
+
+  &:has(.media-icon--flipped) .media-icon__label {
+    right: unset;
+    left: -1px;
+  }
+
+  @container media-controls (width < 28rem) {
     display: none;
   }
 }
@@ -450,11 +343,12 @@
 /* Playback rate button */
 .media-default-skin .media-button--playback-rate {
   padding: 0;
-}
-.media-default-skin .media-button--playback-rate::after {
-  content: attr(data-rate) "\00D7";
-  width: 4ch;
-  font-variant-numeric: tabular-nums;
+
+  &::after {
+    content: attr(data-rate) "\00D7";
+    width: 4ch;
+    font-variant-numeric: tabular-nums;
+  }
 }
 
 /* ==========================================================================
@@ -480,62 +374,155 @@
 }
 
 /* ==========================================================================
-   Slider
+   Poster Image
    ========================================================================== */
 
-.media-default-skin .media-slider {
-  position: relative;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  flex: 1;
-  border-radius: calc(infinity * 1px);
-  outline: none;
+.media-default-skin media-poster,
+.media-default-skin > img {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  transition: opacity 0.25s;
+  pointer-events: none;
 }
-
-/* Horizontal orientation */
-.media-default-skin .media-slider[data-orientation="horizontal"] {
-  min-width: 5rem;
+.media-default-skin media-poster:not([data-visible]),
+.media-default-skin > img:not([data-visible]) {
+  opacity: 0;
+}
+.media-default-skin media-poster ::slotted(img) {
+  position: absolute;
+  inset: 0;
   width: 100%;
-  height: 1.25rem;
+  height: 100%;
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
+  border-radius: var(--media-video-border-radius);
+}
+.media-default-skin > img {
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
+  border-radius: inherit;
 }
 
-/* Vertical orientation */
-.media-default-skin .media-slider[data-orientation="vertical"] {
-  width: 1.25rem;
-  height: 5rem;
+.media-default-skin:fullscreen media-poster ::slotted(img),
+.media-default-skin:fullscreen > img {
+  object-fit: contain;
 }
 
-/* Track */
+/* ==========================================================================
+   Media preview
+   ========================================================================== */
+.media-default-skin .media-preview {
+  background-color: oklch(0 0 0 / 0.9);
+  border-radius: 0.75rem;
+
+  & .media-preview__thumbnail {
+    display: block;
+    position: relative;
+    border-radius: inherit;
+    overflow: clip;
+
+    &::after {
+      content: "";
+      position: absolute;
+      inset: 0;
+      border-radius: inherit;
+      background-image: linear-gradient(to top, oklch(0 0 0 / 0.8), oklch(0 0 0 / 0.3), oklch(0 0 0 / 0));
+    }
+  }
+
+  & .media-preview__timestamp {
+    position: absolute;
+    bottom: 0.5rem;
+    inset-inline: 0;
+    text-align: center;
+    font-variant-numeric: tabular-nums;
+  }
+
+  & .media-overlay {
+    opacity: 1;
+  }
+
+  & .media-preview__spinner {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    translate: -50% -50%;
+    opacity: 0;
+  }
+
+  & .media-preview__thumbnail,
+  & .media-preview__spinner {
+    transition: opacity 150ms ease-out;
+  }
+
+  &:has(.media-preview__thumbnail[data-loading]) {
+    & .media-preview__thumbnail {
+      opacity: 0;
+    }
+    & .media-preview__spinner {
+      opacity: 1;
+    }
+  }
+}
+
+/* ==========================================================================
+   Slider
+   ========================================================================== */
+
+.media-default-skin .media-slider {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex: 1;
+  border-radius: calc(infinity * 1px);
+  outline: none;
+  cursor: pointer;
+
+  &[data-orientation="horizontal"] {
+    min-width: 5rem;
+    width: 100%;
+    height: 1.25rem;
+  }
+
+  &[data-orientation="vertical"] {
+    width: 1.25rem;
+    height: 5rem;
+  }
+}
+
+/* Track */
 .media-default-skin .media-slider__track {
   position: relative;
   isolation: isolate;
   overflow: hidden;
-  background-color: oklch(1 0 0 / 0.2);
   border-radius: inherit;
-  box-shadow: 0 0 0 1px oklch(0 0 0 / 0.05);
   user-select: none;
-}
-.media-default-skin .media-slider__track[data-orientation="horizontal"] {
-  width: 100%;
-  height: 0.25rem;
-}
-.media-default-skin .media-slider__track[data-orientation="vertical"] {
-  width: 0.25rem;
-  height: 100%;
+
+  &[data-orientation="horizontal"] {
+    width: 100%;
+    height: 0.25rem;
+  }
+
+  &[data-orientation="vertical"] {
+    width: 0.25rem;
+    height: 100%;
+  }
 }
 
 /* Thumb */
 .media-default-skin .media-slider__thumb {
   z-index: 10;
   position: absolute;
-  transform: translate(-50%, -50%);
+  translate: -50% -50%;
   width: 0.625rem;
   height: 0.625rem;
-  background-color: oklch(1 0 0);
+  background-color: currentColor;
   border-radius: calc(infinity * 1px);
   box-shadow:
-    0 0 0 1px oklch(0 0 0 / 0.1),
+    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);
   opacity: 0;
@@ -543,26 +530,48 @@
   transition-duration: 150ms;
   transition-timing-function: ease-out;
   user-select: none;
-  outline: 2px solid transparent;
-  outline-offset: -2px;
-}
-.media-default-skin .media-slider__thumb[data-orientation="horizontal"] {
-  top: 50%;
-  left: var(--media-slider-fill);
-}
-.media-default-skin .media-slider__thumb[data-orientation="vertical"] {
-  left: 50%;
-  top: calc(100% - var(--media-slider-fill));
-}
-.media-default-skin .media-slider__thumb:focus-visible {
-  outline-color: oklch(62.3% 0.214 259.815);
-  outline-offset: 2px;
+  outline: 4px solid transparent;
+  outline-offset: -4px;
+
+  &[data-orientation="horizontal"] {
+    top: 50%;
+    left: var(--media-slider-fill);
+  }
+
+  &[data-orientation="vertical"] {
+    left: 50%;
+    top: calc(100% - var(--media-slider-fill));
+  }
+
+  &:hover,
+  &:focus {
+    outline-color: oklch(from currentColor l c h / 0.25);
+    outline-offset: 0;
+  }
+
+  &::after {
+    content: "";
+    position: absolute;
+    inset: -4px;
+    border-radius: inherit;
+    box-shadow: 0 0 0 2px oklch(1 0 0);
+    transition-property: opacity, scale;
+    transition-duration: 150ms;
+    transition-timing-function: ease-out;
+  }
+
+  &:not(:focus-visible)::after {
+    scale: 0.5;
+    opacity: 0;
+  }
 }
+
 .media-default-skin .media-slider:active .media-slider__thumb,
 .media-default-skin .media-slider__thumb--persistent {
   width: 0.75rem;
   height: 0.75rem;
 }
+
 .media-default-skin .media-slider:hover .media-slider__thumb,
 .media-default-skin .media-slider__thumb:focus-visible,
 .media-default-skin .media-slider__thumb--persistent {
@@ -576,11 +585,13 @@
   border-radius: inherit;
   pointer-events: none;
 }
+
 .media-default-skin .media-slider__buffer[data-orientation="horizontal"],
 .media-default-skin .media-slider__fill[data-orientation="horizontal"] {
   inset-block: 0;
   left: 0;
 }
+
 .media-default-skin .media-slider__buffer[data-orientation="vertical"],
 .media-default-skin .media-slider__fill[data-orientation="vertical"] {
   inset-inline: 0;
@@ -589,168 +600,474 @@
 
 /* Buffer */
 .media-default-skin .media-slider__buffer {
-  background-color: oklch(1 0 0 / 0.2);
+  background-color: oklch(from currentColor l c h / 0.2);
   transition-duration: 0.25s;
   transition-timing-function: ease-out;
-}
-.media-default-skin .media-slider__buffer[data-orientation="horizontal"] {
-  width: var(--media-slider-buffer);
-  transition-property: width;
-}
-.media-default-skin .media-slider__buffer[data-orientation="vertical"] {
-  height: var(--media-slider-buffer);
-  transition-property: height;
+
+  &[data-orientation="horizontal"] {
+    width: var(--media-slider-buffer);
+    transition-property: width;
+  }
+
+  &[data-orientation="vertical"] {
+    height: var(--media-slider-buffer);
+    transition-property: height;
+  }
 }
 
 /* Fill */
 .media-default-skin .media-slider__fill {
-  background-color: oklch(1 0 0);
+  background-color: currentColor;
+
+  &[data-orientation="horizontal"] {
+    width: var(--media-slider-fill);
+  }
+
+  &[data-orientation="vertical"] {
+    height: var(--media-slider-fill);
+  }
 }
-.media-default-skin .media-slider__fill[data-orientation="horizontal"] {
-  width: var(--media-slider-fill);
+
+/* ==========================================================================
+   Popups & Tooltips
+   ========================================================================== */
+
+.media-default-skin .media-popover,
+.media-default-skin .media-tooltip {
+  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);
+
+  &[data-starting-style],
+  &[data-ending-style] {
+    opacity: 0;
+    scale: 0.5;
+    filter: blur(8px);
+  }
+
+  &[data-instant] {
+    transition-duration: 0ms;
+  }
+
+  &[data-side="top"] {
+    transform-origin: bottom;
+  }
+  &[data-side="bottom"] {
+    transform-origin: top;
+  }
+  &[data-side="left"] {
+    transform-origin: right;
+  }
+  &[data-side="right"] {
+    transform-origin: left;
+  }
+
+  /* Safe area between trigger and popup */
+  &::before {
+    content: "";
+    position: absolute;
+    pointer-events: inherit;
+  }
+
+  &[data-side="top"]::before,
+  &[data-side="bottom"]::before {
+    width: 100%;
+    inset-inline: 0;
+  }
+  &[data-side="top"]::before {
+    top: 100%;
+  }
+  &[data-side="bottom"]::before {
+    bottom: 100%;
+  }
+
+  &[data-side="left"]::before,
+  &[data-side="right"]::before {
+    height: 100%;
+    inset-block: 0;
+  }
+  &[data-side="left"]::before {
+    left: 100%;
+  }
+  &[data-side="right"]::before {
+    right: 100%;
+  }
 }
-.media-default-skin .media-slider__fill[data-orientation="vertical"] {
-  height: var(--media-slider-fill);
+
+.media-default-skin .media-popover {
+  --media-popover-side-offset: 0.5rem;
+
+  &[data-side="top"]::before,
+  &[data-side="bottom"]::before {
+    height: var(--media-popover-side-offset);
+  }
+  &[data-side="left"]::before,
+  &[data-side="right"]::before {
+    width: var(--media-popover-side-offset);
+  }
 }
+.media-default-skin .media-popover--volume {
+  padding: 0.625rem 0.25rem;
+  border-radius: calc(infinity * 1px);
 
-/* Time display within slider */
-.media-default-skin .media-slider__time-display {
-  font-variant-numeric: tabular-nums;
+  &:has(media-volume-slider[data-availability="unsupported"]) {
+    display: none;
+  }
+}
+
+.media-default-skin .media-tooltip {
+  padding: 0.25rem 0.625rem;
+  border-radius: calc(infinity * 1px);
+  font-size: 0.75rem;
+  white-space: nowrap;
+  --media-tooltip-side-offset: 0.75rem;
+
+  &[data-side="top"]::before,
+  &[data-side="bottom"]::before {
+    height: var(--media-tooltip-side-offset);
+  }
+  &[data-side="left"]::before,
+  &[data-side="right"]::before {
+    width: var(--media-tooltip-side-offset);
+  }
 }
 
 /* ==========================================================================
-   Popups & Animations
+   Native Caption Track
    ========================================================================== */
 
-.media-default-skin .media-popup-animation {
-  opacity: 1;
-  transform: scale(1);
-  transform-origin: bottom;
-  filter: blur(0px);
-  transition-property: transform, scale, opacity, filter;
-  transition-duration: 200ms;
+.media-default-skin {
+  --media-caption-track-duration: var(--media-controls-transition-duration);
+  --media-caption-track-delay: calc(var(--media-controls-transition-delay) + 25ms);
+  --media-caption-track-y: -0.5rem;
+
+  &:has(.media-controls[data-visible]) {
+    --media-caption-track-y: -3.5rem;
+  }
+}
+
+.media-default-skin video::-webkit-media-text-track-container {
+  transition: translate var(--media-caption-track-duration) ease-out;
+  transition-delay: var(--media-caption-track-delay);
+  translate: 0 var(--media-caption-track-y);
+  scale: 0.98;
+  z-index: 1;
+  font-family: inherit;
 }
-.media-default-skin .media-popup-animation[data-starting-style],
-.media-default-skin .media-popup-animation[data-ending-style] {
+
+/* ==========================================================================
+   Icon State Visibility for Video Skins
+
+   Data-attribute-driven visibility rules for multi-state icon buttons.
+   Uses :is() with both element selectors (for HTML custom element wrappers)
+   and class selectors (for React rendered SVG elements).
+   ========================================================================== */
+
+/* --- All icons hidden by default --- */
+
+.media-button--play .media-icon--restart,
+.media-button--play .media-icon--play,
+.media-button--play .media-icon--pause,
+.media-button--mute .media-icon--volume-off,
+.media-button--mute .media-icon--volume-low,
+.media-button--mute .media-icon--volume-high,
+.media-button--fullscreen .media-icon--fullscreen-enter,
+.media-button--fullscreen .media-icon--fullscreen-exit,
+.media-button--pip .media-icon--pip-enter,
+.media-button--pip .media-icon--pip-exit,
+.media-button--captions .media-icon--captions-off,
+.media-button--captions .media-icon--captions-on {
+  display: none;
   opacity: 0;
-  transform: scale(0);
-  filter: blur(8px);
 }
-.media-default-skin .media-popup-animation[data-instant] {
-  transition-duration: 0ms;
+
+/* --- Active icon per state --- */
+
+/* Play: ended → restart */
+.media-button--play[data-ended] .media-icon--restart,
+/* Play: paused (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,
+/* Mute: muted → volume off */
+.media-button--mute[data-muted] .media-icon--volume-off,
+/* Mute: volume low (not muted) → volume low */
+.media-button--mute:not([data-muted])[data-volume-level="low"] .media-icon--volume-low,
+/* Mute: volume high (not muted, not low) → volume high */
+.media-button--mute:not([data-muted]):not([data-volume-level="low"]) .media-icon--volume-high,
+/* Fullscreen: not fullscreen → enter */
+.media-button--fullscreen:not([data-fullscreen]) .media-icon--fullscreen-enter,
+/* Fullscreen: fullscreen → exit */
+.media-button--fullscreen[data-fullscreen] .media-icon--fullscreen-exit,
+/* Picture-in-Picture: not active → enter */
+.media-button--pip:not([data-pip]) .media-icon--pip-enter,
+/* Picture-in-Picture: active → exit */
+.media-button--pip[data-pip] .media-icon--pip-exit,
+/* Captions: not active → captions off */
+.media-button--captions:not([data-active]) .media-icon--captions-off,
+/* Captions: active → captions on */
+.media-button--captions[data-active] .media-icon--captions-on {
+  display: block;
+  opacity: 1;
 }
 
-.media-default-skin .media-popup {
-  margin: 0;
-  border: 0;
-  --media-popover-side-offset: 0.5rem;
+/* ==========================================================================
+   Tooltip Label State Visibility for Video Skins
+
+   Data-attribute-driven visibility rules for multi-state tooltip labels.
+   Uses adjacent sibling selectors to match button state → tooltip content.
+   ========================================================================== */
+
+/* --- All multi-state labels hidden by default --- */
+
+.media-tooltip-label {
+  display: none;
 }
-.media-default-skin .media-popup--volume {
-  padding: 0.625rem 0.25rem;
-  border-radius: calc(infinity * 1px);
+
+/* --- Active label per state --- */
+
+/* Play: ended → replay */
+.media-button--play[data-ended] + .media-tooltip .media-tooltip-label--replay,
+/* Play: paused (not ended) → play */
+  .media-button--play:not([data-ended])[data-paused] + .media-tooltip
+  .media-tooltip-label--play,
+/* Play: playing (not paused, not ended) → pause */
+  .media-button--play:not([data-paused]):not([data-ended]) + .media-tooltip
+  .media-tooltip-label--pause,
+/* Fullscreen: not fullscreen → enter */
+  .media-button--fullscreen:not([data-fullscreen]) + .media-tooltip
+  .media-tooltip-label--enter-fullscreen,
+/* Fullscreen: fullscreen → exit */
+  .media-button--fullscreen[data-fullscreen] + .media-tooltip
+  .media-tooltip-label--exit-fullscreen,
+/* Captions: not active → enable */
+  .media-button--captions:not([data-active]) + .media-tooltip
+  .media-tooltip-label--enable-captions,
+/* Captions: active → disable */
+  .media-button--captions[data-active] + .media-tooltip
+  .media-tooltip-label--disable-captions,
+/* PiP: not in pip → enter */
+  .media-button--pip:not([data-pip]) + .media-tooltip
+  .media-tooltip-label--enter-pip,
+/* PiP: in pip → exit */
+  .media-button--pip[data-pip] + .media-tooltip
+  .media-tooltip-label--exit-pip {
+  display: block;
 }
 
+
 /* ==========================================================================
-   Tooltips
+   Root
    ========================================================================== */
 
-.media-default-skin .media-tooltip {
-  white-space: nowrap;
-}
-.media-default-skin .media-tooltip-popup {
-  padding: 0.25rem 0.625rem;
-  border-radius: calc(infinity * 1px);
-  color: oklch(1 0 0);
-  font-size: 0.75rem;
+.media-default-skin--video {
+  background: oklch(0 0 0);
+  --media-spring-transition: linear(
+    0,
+    0.034 1.5%,
+    0.763 9.7%,
+    1.066 13.9%,
+    1.198 19.9%,
+    1.184 21.8%,
+    0.963 37.5%,
+    0.997 50.9%,
+    1
+  );
+  --media-border-color: oklch(0 0 0 / 0.1);
+  --media-surface-background-color: oklch(1 0 0 / 0.1);
+  --media-surface-inner-border-color: oklch(1 0 0 / 0.05);
+  --media-surface-outer-border-color: oklch(0 0 0 / 0.1);
+  --media-surface-shadow-color: oklch(0 0 0 / 0.15);
+  --media-surface-backdrop-filter: blur(16px) saturate(1.5);
+  --media-video-border-radius: var(--media-border-radius, 2rem);
+  --media-controls-transition-duration: 100ms;
+  --media-controls-transition-delay: 0ms;
+  --media-controls-transition-timing-function: ease-out;
+  --media-error-dialog-transition-duration: 350ms;
+  --media-error-dialog-transition-delay: 100ms;
+  --media-error-dialog-transition-timing-function: var(--media-spring-transition);
+  --media-popup-transition-duration: 100ms;
+  --media-popup-transition-timing-function: ease-out;
+
+  @media (prefers-reduced-motion: reduce) {
+    --media-error-dialog-transition-duration: 50ms;
+    --media-error-dialog-transition-delay: 0ms;
+    --media-error-dialog-transition-timing-function: ease-out;
+    --media-popup-transition-duration: 0ms;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    --media-border-color: oklch(1 0 0 / 0.15);
+  }
+
+  &:has(.media-controls:not([data-visible])) {
+    /* Slight delay to hide controls on non-touch devices after interaction */
+    @media (pointer: fine) {
+      --media-controls-transition-delay: 500ms;
+      --media-controls-transition-duration: 300ms;
+    }
+    @media (pointer: coarse) {
+      --media-controls-transition-duration: 150ms;
+    }
+    @media (prefers-reduced-motion: reduce) {
+      --media-controls-transition-duration: 50ms;
+    }
+  }
+
+  /* Inner border ring */
+  &::after {
+    content: "";
+    position: absolute;
+    inset: 0;
+    z-index: 10;
+    border-radius: inherit;
+    box-shadow: inset 0 0 0 1px var(--media-border-color);
+    pointer-events: none;
+  }
+
+  &:fullscreen {
+    --media-border-radius: 0;
+  }
 }
 
 /* ==========================================================================
-   Captions
+   Error Dialog
    ========================================================================== */
 
-.media-default-skin .media-captions {
+.media-default-skin--video .media-error {
   position: absolute;
-  inset: auto 1rem 1.5rem 1rem;
+  inset: 0;
   z-index: 20;
-  font-size: 1rem;
-  text-wrap: balance;
-  pointer-events: none;
-}
-.media-default-skin .media-captions__container {
   display: flex;
-  flex-direction: column;
   align-items: center;
-  max-width: 42ch;
-  margin: 0 auto;
-  text-align: center;
+  justify-content: center;
 }
-.media-default-skin .media-captions__text {
-  display: block;
-  padding: 0.125rem 0.5rem;
+
+.media-default-skin--video .media-error__dialog {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  max-width: 18rem;
+  padding: 0.75rem;
+  border-radius: 1.75rem;
   color: oklch(1 0 0);
-  text-shadow:
-    0 0 1px oklch(0 0 0 / 0.7),
-    0 0 8px oklch(0 0 0 / 0.7);
-  text-align: center;
-  white-space: pre-wrap;
-  line-height: 1.2;
+  text-shadow: 0 1px 0 oklch(0 0 0 / 0.25);
+  transition-property: opacity, scale;
+  transition-duration: var(--media-error-dialog-transition-duration);
+  transition-delay: var(--media-error-dialog-transition-delay);
+  transition-timing-function: var(--media-error-dialog-transition-timing-function);
 }
-@media (prefers-contrast: more) {
-  .media-default-skin .media-captions__text {
-    background: oklch(0 0 0 / 0.7);
-    text-shadow: none;
-    box-decoration-break: clone;
-  }
+
+.media-default-skin--video .media-error[data-starting-style] .media-error__dialog,
+.media-default-skin--video .media-error[data-ending-style] .media-error__dialog {
+  opacity: 0;
+  scale: 0.5;
 }
-.media-default-skin .media-captions__text > * {
-  display: inline;
+.media-default-skin--video .media-error[data-ending-style] .media-error__dialog {
+  transition-delay: 0ms;
 }
 
-/* Responsive caption sizing */
-@container media-root (width > 20rem) {
-  .media-default-skin .media-captions {
-    font-size: 1.5rem;
-  }
+.media-default-skin--video .media-error__content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 0.5rem 0.5rem 0.375rem;
+  text-shadow: inherit;
 }
-@container media-root (width > 48rem) {
-  .media-default-skin .media-captions {
-    font-size: 1.875rem;
-  }
+
+.media-default-skin--video .media-error__title {
+  font-size: 1rem;
 }
-@container media-root (width > 80rem) {
-  .media-default-skin .media-captions {
-    font-size: 2.25rem;
+
+/* ==========================================================================
+   Controls (hide/show behavior)
+   ========================================================================== */
+
+.media-default-skin--video .media-controls {
+  position: absolute;
+  bottom: 0.75rem;
+  inset-inline: 0.75rem;
+  z-index: 10;
+  color: var(--media-color-primary, oklch(1 0 0));
+  transition-duration: var(--media-controls-transition-duration);
+  transition-delay: var(--media-controls-transition-delay);
+  transition-timing-function: var(--media-controls-transition-timing-function);
+  transform-origin: bottom;
+
+  @media (pointer: fine) {
+    will-change: scale, filter, opacity;
+    transition-property: scale, filter, opacity;
   }
-}
 
-/* Caption shifting styles (custom and native) */
-.media-default-skin {
-  --media-caption-track-delay: 600ms;
-  --media-caption-track-y: -0.5rem;
-}
-.media-default-skin:has(.media-controls[data-visible]) {
-  --media-caption-track-delay: 25ms;
-  --media-caption-track-y: -3.5rem;
+  @media (pointer: coarse) {
+    will-change: scale, opacity;
+    transition-property: scale, opacity;
+  }
+
+  &:not([data-visible]) {
+    opacity: 0;
+    pointer-events: none;
+    scale: 0.9;
+
+    @media (pointer: fine) and (prefers-reduced-motion: no-preference) {
+      filter: blur(8px);
+    }
+
+    @media (prefers-reduced-motion: reduce) {
+      scale: 1;
+    }
+  }
 }
-.media-default-skin .media-captions,
-.media-default-skin video::-webkit-media-text-track-container {
-  /* NOTE: The delay must account for the controls delay/duration */
-  transition: transform 150ms ease-out;
-  transition-delay: var(--media-caption-track-delay);
+
+.media-default-skin--video .media-error[data-open] ~ .media-controls {
+  display: none;
 }
-.media-default-skin video::-webkit-media-text-track-container {
-  transform: translateY(var(--media-caption-track-y)) scale(0.98);
-  z-index: 1;
-  font-family: inherit;
+
+/* Hide cursor when controls are hidden in fullscreen */
+@media (pointer: fine) {
+  .media-default-skin--video:fullscreen:has(.media-controls:not([data-visible])) {
+    cursor: none;
+  }
 }
-/* When controls are visible, shift captions up to avoid overlap */
-.media-default-skin .media-controls[data-visible] ~ .media-captions {
-  transform: translateY(calc(var(--media-caption-track-y) - 0.5rem));
+
+/* ==========================================================================
+   Sliders
+   ========================================================================== */
+
+.media-default-skin--video .media-slider__track {
+  background-color: oklch(1 0 0 / 0.2);
+  box-shadow: 0 0 0 1px oklch(0 0 0 / 0.05);
 }
-@media (prefers-reduced-motion: reduce) {
-  .media-default-skin .media-captions,
-  .media-default-skin video::-webkit-media-text-track-container {
-    transition-duration: 50ms;
+
+.media-default-skin--video .media-slider__preview {
+  position: absolute;
+  left: var(--media-slider-pointer);
+  bottom: calc(100% + 1.2rem);
+  translate: -50%;
+  opacity: 0;
+  scale: 0.8;
+  filter: blur(8px);
+  transition-property: scale, opacity, filter;
+  transition-duration: 150ms;
+  transition-timing-function: ease-out;
+  transform-origin: bottom;
+  pointer-events: none;
+
+  & .media-preview__thumbnail {
+    max-width: 11rem;
   }
+
+  &:has(.media-preview__thumbnail[data-loading]) {
+    max-height: 6rem;
+  }
+}
+.media-default-skin--video .media-slider[data-pointing] .media-slider__preview:has([role="img"]:not([data-hidden])) {
+  opacity: 1;
+  scale: 1;
+  filter: blur(0);
 }