@videojs/html 10.0.0-beta.2 → 10.0.0-beta.21

package/dist/dev/define/video/minimal-skin.css

@@ -1,95 +1,44 @@
-/* ==========================================================================
-   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 --- */
+/* -------------------------------------------------------------------------- */
+/* Base                                                                       */
+/* -------------------------------------------------------------------------- */
 
-.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;
+video-player {
+  display: contents;
 }
 
-/* --- 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 {
+/*
+Required to override any default video and image styles (such as
+Tailwind's CSS reset) and ensure they fill the container as expected.
+*/
+video-player video,
+video-player [slot="poster"] {
   display: block;
-  opacity: 1;
+  width: 100%;
+  height: 100%;
 }
 
-/* ==========================================================================
-   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 --- */
+video-player video::-webkit-media-text-track-container {
+  transition: translate var(--media-caption-track-duration, 0) ease-out;
+  transition-delay: var(--media-caption-track-delay, 0);
+  translate: 0 var(--media-caption-track-y, 0);
+  scale: 0.98;
+  z-index: 1;
+  font-family: inherit;
+}
 
-.media-tooltip-label {
-  display: none;
+media-tooltip-group {
+  display: contents;
 }
 
-/* --- Active label per state --- */
+:host {
+  /* `display:grid` fixes a weird issue with Safari when setting aspect-ratio */
+  display: grid;
+  width: 100%;
+}
 
-/* 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;
+/* Hide volume popover when volume control is unsupported (e.g., iOS Safari). */
+.media-popover--volume:has(media-volume-slider[data-availability="unsupported"]) {
+  display: none;
 }
 
 /* ==========================================================================
@@ -100,7 +49,6 @@
 .media-minimal-skin *::before,
 .media-minimal-skin *::after {
   box-sizing: border-box;
-  margin: 0;
 }
 .media-minimal-skin img,
 .media-minimal-skin video,
@@ -122,22 +70,39 @@
    ========================================================================== */
 
 .media-minimal-skin {
+  container: media-root / inline-size;
   position: relative;
   isolation: isolate;
   display: block;
-  container: media-root / inline-size;
+  height: 100%;
+  width: 100%;
   border-radius: var(--media-border-radius, 0.75rem);
+  outline: 2px solid transparent;
+  outline-offset: 2px;
+
+  &:focus-visible {
+    outline-color: currentColor;
+  }
   font-family:
     Inter Variable,
     Inter,
     ui-sans-serif,
     system-ui,
     sans-serif;
-  font-size: 0.8125rem;
   line-height: 1.5;
   letter-spacing: normal;
   -webkit-font-smoothing: auto;
   -moz-osx-font-smoothing: auto;
+
+  & > * {
+    font-size: 0.75rem; /* 12px at 100% font size */
+  }
+
+  @container media-root (width > 48rem) {
+    & > * {
+      font-size: 0.875rem; /* 14px at 100% font size */
+    }
+  }
 }
 
 /* ==========================================================================
@@ -149,26 +114,19 @@
   display: block;
   width: 100%;
   height: 100%;
-  border-radius: var(--media-border-radius, 0.75rem);
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
 }
-
-/* ==========================================================================
-   Poster Image
-   ========================================================================== */
-
-.media-minimal-skin > img {
-  position: absolute;
-  inset: 0;
-  width: 100%;
-  height: 100%;
+.media-minimal-skin ::slotted(video) {
+  border-radius: var(--media-video-border-radius);
+}
+.media-minimal-skin video {
   border-radius: inherit;
-  object-fit: cover;
-  transition: opacity 0.25s;
-  pointer-events: none;
+}
 
-  &:not([data-visible]) {
-    opacity: 0;
-  }
+.media-minimal-skin:fullscreen ::slotted(video),
+.media-minimal-skin:fullscreen video {
+  object-fit: contain;
 }
 
 /* ==========================================================================
@@ -180,28 +138,26 @@
   inset: 0;
   border-radius: inherit;
   background-image: linear-gradient(to top, oklch(0 0 0 / 0.7), oklch(0 0 0 / 0.5) 7.5rem, oklch(0 0 0 / 0));
-  backdrop-filter: blur(0) saturate(1.2) brightness(0.9);
+  backdrop-filter: blur(0) saturate(1);
   opacity: 0;
+  pointer-events: none;
   transition-property: opacity, backdrop-filter;
-  transition-duration: 500ms;
-  transition-delay: 500ms;
+  transition-duration: var(--media-controls-transition-duration);
   transition-timing-function: ease-out;
-  pointer-events: none;
+}
 
-  @media (prefers-reduced-motion: reduce) {
-    transition-duration: 100ms;
-  }
+.media-minimal-skin .media-error ~ .media-overlay {
+  transition-duration: var(--media-error-dialog-transition-duration);
+  transition-delay: var(--media-error-dialog-transition-delay);
 }
 
 .media-minimal-skin .media-controls[data-visible] ~ .media-overlay,
 .media-minimal-skin .media-error[data-open] ~ .media-overlay {
   opacity: 1;
-  transition-duration: 150ms;
-  transition-delay: 0ms;
 }
 
 .media-minimal-skin .media-error[data-open] ~ .media-overlay {
-  backdrop-filter: blur(8px) saturate(1.2) brightness(0.9);
+  backdrop-filter: blur(16px) saturate(1.2);
 }
 
 /* ==========================================================================
@@ -226,59 +182,8 @@
    Error Dialog
    ========================================================================== */
 
-.media-minimal-skin .media-error {
-  position: absolute;
-  inset: 0;
-  z-index: 20;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  pointer-events: none;
-}
-
-.media-minimal-skin .media-error__dialog {
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-  max-width: 16rem;
-  padding: 1rem;
-  color: oklch(1 0 0);
-  font-size: 0.875rem;
-  text-shadow: 0 1px 0 oklch(0 0 0 / 0.5);
-  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
-  );
-
-  /* Simple, fast transition for reduced motion users */
-  @media (prefers-reduced-motion: reduce) {
-    transition-duration: 100ms;
-    transition-delay: 0ms;
-    transition-timing-function: ease-out;
-  }
-}
-
-.media-minimal-skin .media-error[data-starting-style] .media-error__dialog,
-.media-minimal-skin .media-error[data-ending-style] .media-error__dialog {
-  opacity: 0;
-  transform: scale(0.5);
-}
-
-.media-minimal-skin .media-error__content {
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-  padding: 0.375rem 0;
+.media-minimal-skin .media-error:not([data-open]) {
+  display: none;
 }
 
 .media-minimal-skin .media-error__title {
@@ -288,6 +193,7 @@
 
 .media-minimal-skin .media-error__description {
   opacity: 0.7;
+  overflow-wrap: anywhere;
 }
 
 .media-minimal-skin .media-error__actions {
@@ -299,6 +205,10 @@
   }
 }
 
+.media-minimal-skin .media-error[data-open] ~ .media-controls * {
+  visibility: hidden;
+}
+
 /* ==========================================================================
    Controls
    ========================================================================== */
@@ -307,12 +217,14 @@
   container: media-controls / inline-size;
   display: flex;
   align-items: center;
-  --media-controls-current-shadow-color: oklch(from currentColor 0 0 0 / clamp(0, calc((l - 0.5) * 0.5), 0.25));
+  --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 0 1px var(--media-controls-current-shadow-color);
+  background-color: var(--media-controls-background-color);
+  backdrop-filter: var(--media-controls-backdrop-filter);
+  text-shadow: 0 1px 0 var(--media-controls-current-shadow-color);
 }
 
 /* ==========================================================================
@@ -320,49 +232,42 @@
    ========================================================================== */
 
 .media-minimal-skin .media-time-controls {
+  container: media-time-controls / inline-size;
   display: flex;
   flex-direction: row-reverse;
   align-items: center;
   flex: 1;
   gap: 0.75rem;
 }
-.media-minimal-skin .media-time {
+
+.media-minimal-skin .media-time-group {
   display: flex;
   align-items: center;
   gap: 0.25rem;
 }
-.media-minimal-skin .media-time__value {
+
+.media-minimal-skin .media-time {
   font-variant-numeric: tabular-nums;
 }
-.media-minimal-skin .media-time__value--current,
-.media-minimal-skin .media-time__separator {
+
+.media-minimal-skin .media-time--current,
+.media-minimal-skin .media-time-separator {
   display: none;
 }
-@container media-controls (width > 28rem) {
+
+@container media-root (width > 42rem) {
   .media-minimal-skin .media-time-controls {
     flex-direction: row;
   }
-  .media-minimal-skin .media-time__value--duration,
-  .media-minimal-skin .media-time__separator {
+
+  .media-minimal-skin .media-time--duration,
+  .media-minimal-skin .media-time-separator {
     color: oklch(from currentColor l c h / 0.6);
   }
-  .media-minimal-skin .media-time__value--current,
-  .media-minimal-skin .media-time__separator {
-    display: inline;
-  }
-}
-
-/* ==========================================================================
-   Button Groups
-   ========================================================================== */
-
-.media-minimal-skin .media-button-group {
-  display: flex;
-  align-items: center;
-  gap: 0.075rem;
 
-  @container media-root (width > 40rem) {
-    gap: 0.125rem;
+  .media-minimal-skin .media-time--current,
+  .media-minimal-skin .media-time-separator {
+    display: inline;
   }
 }
 
@@ -377,26 +282,29 @@
   justify-content: center;
   flex-shrink: 0;
   padding: 0.5rem 1rem;
-  background: oklch(1 0 0);
   border: none;
   border-radius: 0.5rem;
   outline: 2px solid transparent;
   outline-offset: -2px;
-  color: oklch(0 0 0);
-  font-weight: 500;
-  text-align: center;
-  text-shadow: inherit;
-  transition-property: background-color, color, outline-offset, transform;
+  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;
     outline-offset: 2px;
   }
 
+  &:active {
+    scale: 0.98;
+  }
+
   &[disabled] {
     opacity: 0.5;
     filter: grayscale(1);
@@ -408,24 +316,45 @@
   }
 }
 
-/* Icon button variant */
-.media-minimal-skin .media-button--icon {
-  display: grid;
-  width: 2.375rem;
-  padding: 0;
-  aspect-ratio: 1;
+/* biome-ignore lint/correctness/noUnknownProperty: corner-shape is an emerging CSS spec */
+@supports (corner-shape: squircle) {
+  .media-minimal-skin .media-button {
+    border-radius: 1rem;
+    /* biome-ignore lint/correctness/noUnknownProperty: corner-shape is an emerging CSS spec */
+    corner-shape: squircle;
+  }
+}
+
+/* Primary button variant */
+.media-minimal-skin .media-button--primary {
+  background: oklch(1 0 0);
+  color: oklch(0 0 0);
+  font-weight: 500;
+  text-shadow: none;
+}
+
+/* Subtle button variant */
+.media-minimal-skin .media-button--subtle {
   background: transparent;
   color: inherit;
+  text-shadow: inherit;
 
   &:hover,
   &:focus-visible,
   &[aria-expanded="true"] {
-    color: oklch(from currentColor l c h / 0.8);
-    text-decoration: none;
+    background: oklch(from currentColor l c h / 0.1);
   }
+}
+
+/* Icon button variant */
+.media-minimal-skin .media-button--icon {
+  display: grid;
+  width: 2.375rem;
+  padding: 0;
+  aspect-ratio: 1;
 
   &:active {
-    transform: scale(0.9);
+    scale: 0.9;
   }
 
   & .media-icon {
@@ -439,7 +368,7 @@
     position: absolute;
     right: -1px;
     bottom: -3px;
-    font-size: 0.75em;
+    font-size: 10px; /* Hard coded due to size limitations. */
     font-weight: 480;
     font-variant-numeric: tabular-nums;
   }
@@ -448,10 +377,6 @@
     right: unset;
     left: -1px;
   }
-
-  @container media-controls (width < 28rem) {
-    display: none;
-  }
 }
 
 /* Playback rate button */
@@ -465,6 +390,20 @@
   }
 }
 
+/* ==========================================================================
+   Button Groups
+   ========================================================================== */
+
+.media-minimal-skin .media-button-group {
+  display: flex;
+  align-items: center;
+  gap: 0.075rem;
+
+  @container media-root (width > 42rem) {
+    gap: 0.125rem;
+  }
+}
+
 /* ==========================================================================
    Icons
    ========================================================================== */
@@ -487,6 +426,94 @@
   scale: -1 1;
 }
 
+/* ==========================================================================
+   Poster Image
+   ========================================================================== */
+
+.media-minimal-skin media-poster,
+.media-minimal-skin > img {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  transition: opacity 0.25s;
+  pointer-events: none;
+}
+.media-minimal-skin media-poster:not([data-visible]),
+.media-minimal-skin > img:not([data-visible]) {
+  opacity: 0;
+}
+.media-minimal-skin media-poster ::slotted(img),
+.media-minimal-skin media-poster img {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
+  border-radius: var(--media-video-border-radius);
+}
+.media-minimal-skin > img {
+  object-fit: var(--media-object-fit, contain);
+  object-position: var(--media-object-position, center);
+  border-radius: inherit;
+}
+
+.media-minimal-skin:fullscreen media-poster ::slotted(img),
+.media-minimal-skin:fullscreen media-poster img,
+.media-minimal-skin:fullscreen > img {
+  object-fit: contain;
+}
+
+/* ==========================================================================
+   Media preview
+   ========================================================================== */
+.media-minimal-skin .media-preview {
+  pointer-events: none;
+
+  & .media-preview__thumbnail-wrapper {
+    position: relative;
+    border-radius: 0.5rem;
+    background-color: oklch(0 0 0 / 0.9);
+  }
+  & .media-preview__thumbnail {
+    display: block;
+    border-radius: inherit;
+  }
+
+  & .media-preview__time {
+    display: block;
+    text-align: center;
+    margin-top: 0.5rem;
+  }
+
+  & .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
    ========================================================================== */
@@ -499,15 +526,16 @@
   flex: 1;
   border-radius: calc(infinity * 1px);
   outline: none;
+  cursor: pointer;
 
   &[data-orientation="horizontal"] {
     min-width: 5rem;
     width: 100%;
-    height: 1.25rem;
+    height: 2rem;
   }
 
   &[data-orientation="vertical"] {
-    width: 1.25rem;
+    width: 2rem;
     height: 4.5rem;
   }
 }
@@ -535,7 +563,7 @@
 /* Thumb */
 .media-minimal-skin .media-slider__thumb {
   position: absolute;
-  transform: translate(-50%, -50%);
+  translate: -50% -50%;
   z-index: 10;
   width: 0.75rem;
   height: 0.75rem;
@@ -628,9 +656,21 @@
   }
 }
 
-/* Time display within slider */
-.media-minimal-skin .media-slider__time-display {
-  font-variant-numeric: tabular-nums;
+/* Dragging — thumb and fill follow the pointer position */
+.media-minimal-skin .media-slider[data-dragging] .media-slider__thumb[data-orientation="horizontal"] {
+  left: var(--media-slider-pointer);
+}
+
+.media-minimal-skin .media-slider[data-dragging] .media-slider__thumb[data-orientation="vertical"] {
+  top: calc(100% - var(--media-slider-pointer));
+}
+
+.media-minimal-skin .media-slider[data-dragging] .media-slider__fill[data-orientation="horizontal"] {
+  width: var(--media-slider-pointer);
+}
+
+.media-minimal-skin .media-slider[data-dragging] .media-slider__fill[data-orientation="vertical"] {
+  height: var(--media-slider-pointer);
 }
 
 /* ==========================================================================
@@ -643,13 +683,14 @@
   border: 0;
   color: inherit;
   overflow: visible;
-  transition-property: transform, scale, opacity, filter;
-  transition-duration: 200ms;
+  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;
-    transform: scale(0);
+    scale: 0.5;
     filter: blur(8px);
   }
 
@@ -669,119 +710,160 @@
   &[data-side="right"] {
     transform-origin: left;
   }
-}
 
-.media-minimal-skin .media-tooltip {
-  padding: 0.25rem 0.5rem;
-  border-radius: 0.25rem;
-  background-color: oklch(1 0 0 / 0.1);
-  backdrop-filter: blur(64px) brightness(0.9) saturate(1.5);
-  box-shadow:
-    0 4px 6px -1px oklch(0 0 0 / 0.1),
-    0 2px 4px -2px oklch(0 0 0 / 0.1);
-  font-size: 0.75rem;
-  white-space: nowrap;
-  --media-tooltip-side-offset: 0.5rem;
-
-  @media (prefers-reduced-transparency: reduce) {
-    background-color: oklch(0 0 0 / 0.7);
+  /* Safe area between trigger and popup */
+  &::before {
+    content: "";
+    position: absolute;
+    pointer-events: inherit;
   }
 
-  @media (prefers-contrast: more) {
-    background-color: oklch(0 0 0 / 0.9);
+  &[data-side="top"]::before,
+  &[data-side="bottom"]::before {
+    width: 100%;
+    inset-inline: 0;
   }
-}
-
-/* ==========================================================================
-   Captions
-   ========================================================================== */
-
-.media-minimal-skin .media-captions {
-  position: absolute;
-  inset: auto 1rem 1.5rem 1rem;
-  z-index: 20;
-  font-size: 1rem;
-  text-wrap: balance;
-  pointer-events: none;
-
-  @container media-root (width > 20rem) {
-    font-size: 1.5rem;
+  &[data-side="top"]::before {
+    top: 100%;
   }
-
-  @container media-root (width > 48rem) {
-    font-size: 1.875rem;
+  &[data-side="bottom"]::before {
+    bottom: 100%;
   }
 
-  @container media-root (width > 80rem) {
-    font-size: 2.25rem;
+  &[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-minimal-skin .media-captions__container {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  max-width: 42ch;
-  margin: 0 auto;
-  text-align: center;
+.media-minimal-skin .media-popover {
+  &[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-minimal-skin .media-captions__text {
-  display: block;
-  padding: 0.125rem 0.5rem;
-  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;
+.media-minimal-skin .media-tooltip {
+  padding: 0.25rem 0.5rem;
+  border-radius: 0.5rem;
+  background-color: var(--media-tooltip-background-color);
+  backdrop-filter: var(--media-tooltip-backdrop-filter);
+  box-shadow:
+    0 0 0 1px var(--media-tooltip-border-color),
+    0 4px 6px -1px oklch(0 0 0 / 0.1),
+    0 2px 4px -2px oklch(0 0 0 / 0.1);
+  color: var(--media-tooltip-text-color);
+  font-size: 0.75rem; /* 12px at 100% font size */
+  white-space: nowrap;
 
-  @media (prefers-contrast: more) {
-    background: oklch(0 0 0 / 0.7);
-    text-shadow: none;
-    box-decoration-break: clone;
+  &[data-side="top"]::before,
+  &[data-side="bottom"]::before {
+    height: var(--media-tooltip-side-offset);
   }
-
-  & > * {
-    display: inline;
+  &[data-side="left"]::before,
+  &[data-side="right"]::before {
+    width: var(--media-tooltip-side-offset);
   }
 }
 
-/* Caption shifting styles (custom and native) */
+.media-minimal-skin .media-popover--volume:has(media-volume-slider[data-availability="unsupported"]) {
+  display: none;
+}
+
+/* ==========================================================================
+   Native Caption Track
+   ========================================================================== */
+
 .media-minimal-skin {
-  --media-caption-track-delay: 600ms;
+  --media-caption-track-duration: var(--media-controls-transition-duration);
+  --media-caption-track-delay: 25ms;
   --media-caption-track-y: -0.5rem;
 
   &:has(.media-controls[data-visible]) {
-    --media-caption-track-delay: 25ms;
-    --media-caption-track-y: -3rem;
+    --media-caption-track-y: -5rem;
   }
-}
 
-.media-minimal-skin .media-captions,
-.media-minimal-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);
+  @container media-root (width > 42rem) {
+    &:has(.media-controls[data-visible]) > * {
+      --media-caption-track-y: -3rem;
+    }
+  }
 }
 
 .media-minimal-skin video::-webkit-media-text-track-container {
-  transform: translateY(var(--media-caption-track-y)) scale(0.98);
+  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;
 }
 
-/* When controls are visible, shift captions up to avoid overlap */
-.media-minimal-skin .media-controls[data-visible] ~ .media-captions {
-  transform: translateY(calc(var(--media-caption-track-y) - 0.5rem));
+/* ==========================================================================
+   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;
 }
 
-@media (prefers-reduced-motion: reduce) {
-  .media-minimal-skin .media-captions,
-  .media-minimal-skin video::-webkit-media-text-track-container {
-    transition-duration: 50ms;
-  }
+/* --- 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;
 }
 
 
@@ -790,67 +872,208 @@
    ========================================================================== */
 
 .media-minimal-skin--video {
+  overflow: clip;
   background: oklch(0 0 0);
+  --media-border-color: oklch(0 0 0 / 0.15);
+  --media-video-border-radius: var(--media-border-radius, 0.75rem);
+  --media-controls-background-color: transparent;
+  --media-controls-transition-duration: 100ms;
+  --media-controls-transition-timing-function: ease-out;
+  --media-error-dialog-transition-duration: 150ms;
+  --media-error-dialog-transition-delay: 100ms;
+  --media-error-dialog-transition-timing-function: ease-out;
+  --media-popup-transition-duration: 100ms;
+  --media-popup-transition-timing-function: ease-out;
+  --media-tooltip-background-color: oklch(1 0 0 / 0.1);
+  --media-tooltip-border-color: transparent;
+  --media-tooltip-backdrop-filter: blur(16px) saturate(1.5);
+  --media-tooltip-text-color: currentColor;
+  --media-tooltip-side-offset: 0.5rem;
+  --media-popover-side-offset: 1.5rem;
+
+  @media (prefers-reduced-motion: reduce) {
+    --media-error-dialog-transition-duration: 50ms;
+    --media-error-dialog-transition-delay: 0ms;
+    --media-popup-transition-duration: 0ms;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    --media-border-color: oklch(1 0 0 / 0.15);
+  }
 
-  /* Border ring */
+  @media (prefers-reduced-transparency: reduce) or (prefers-contrast: more) {
+    --media-controls-background-color: oklch(0 0 0);
+    --media-tooltip-background-color: oklch(0 0 0);
+  }
+
+  @container media-root (width > 42rem) {
+    & > * {
+      --media-popover-side-offset: 0rem;
+    }
+  }
+
+  &:has(.media-controls:not([data-visible])) {
+    /* Slight delay to hide controls on non-touch devices after interaction */
+    @media (pointer: fine) {
+      --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 oklch(0 0 0 / 0.15);
+    box-shadow: inset 0 0 0 1px var(--media-border-color);
     pointer-events: none;
-
-    @media (prefers-color-scheme: dark) {
-      box-shadow: inset 0 0 0 1px oklch(1 0 0 / 0.15);
-    }
   }
 
   /* Fullscreen */
   &:fullscreen {
-    border-radius: 0;
+    --media-border-radius: 0;
   }
 }
 
+/* ==========================================================================
+   Error Dialog
+   ========================================================================== */
+
+.media-minimal-skin--video .media-error {
+  position: absolute;
+  inset: 0;
+  z-index: 20;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  pointer-events: none;
+  outline: none;
+}
+
+.media-minimal-skin--video .media-error__dialog {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  max-width: 16rem;
+  padding: 1rem;
+  color: oklch(1 0 0);
+  text-shadow: 0 1px 0 oklch(0 0 0 / 0.5);
+  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);
+  pointer-events: auto;
+}
+
+.media-minimal-skin--video .media-error[data-starting-style] .media-error__dialog,
+.media-minimal-skin--video .media-error[data-ending-style] .media-error__dialog {
+  opacity: 0;
+  scale: 0.5;
+}
+.media-minimal-skin--video .media-error[data-ending-style] .media-error__dialog {
+  transition-delay: 0ms;
+}
+
+.media-minimal-skin--video .media-error__content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 0.375rem 0;
+}
+
+.media-minimal-skin--video .media-error__title {
+  font-size: 1.125rem;
+}
+
+.media-minimal-skin--video .media-error[data-open] ~ .media-controls {
+  display: none;
+}
+
 /* ==========================================================================
   Controls (hide/show behavior)
   ========================================================================== */
 
 .media-minimal-skin--video .media-controls {
+  padding: 0.25rem;
+  column-gap: 0.5rem;
+  flex-wrap: wrap;
   position: absolute;
-  bottom: 0;
-  inset-inline: 0;
+  bottom: 0.25rem;
+  inset-inline: 0.25rem;
   z-index: 10;
-  gap: 0.5rem;
-  padding: 2rem 0.375rem 0.375rem 0.375rem;
-  will-change: transform, filter, opacity;
-  transition-property: transform, filter, opacity;
-  transition-duration: 75ms;
-  transition-delay: 0ms;
-  transition-timing-function: ease-out;
   color: oklch(1 0 0);
+  border-radius: 0.75rem;
+  transition-duration: var(--media-controls-transition-duration);
+  transition-timing-function: var(--media-controls-transition-timing-function);
+
+  @media (pointer: fine) {
+    will-change: translate, filter, opacity;
+    transition-property: translate, filter, opacity;
+  }
 
-  @container media-root (width > 40rem) {
-    gap: 0.875rem;
-    padding: 2.5rem 0.75rem 0.75rem 0.75rem;
+  @media (pointer: coarse) {
+    will-change: translate, opacity;
+    transition-property: translate, opacity;
   }
 
   &:not([data-visible]) {
     opacity: 0;
-    transform: translateY(100%);
-    filter: blur(8px);
-    transition-duration: 500ms;
-    transition-delay: 500ms;
     pointer-events: none;
+    translate: 0 100%;
+
+    @media (pointer: fine) {
+      filter: blur(8px);
+    }
 
     @media (prefers-reduced-motion: reduce) {
-      scale: 1;
-      transform: translateY(0);
+      translate: 0 0;
       filter: blur(0);
-      transition-duration: 100ms;
     }
   }
+
+  & .media-time-controls {
+    order: -1;
+    flex: 0 0 100%;
+    padding-inline: 0.625rem;
+  }
+
+  & .media-button-group:first-child {
+    flex: 1;
+    text-align: left;
+  }
+
+  & .media-button-group:last-child {
+    flex: 1;
+    justify-content: end;
+  }
+
+  @container media-root (width > 42rem) {
+    flex-wrap: nowrap;
+    bottom: 0.5rem;
+    inset-inline: 0.5rem;
+
+    & .media-time-controls {
+      order: unset;
+      flex: 1;
+    }
+
+    & .media-button-group:first-child,
+    & .media-button-group:last-child {
+      flex: 0 0 auto;
+    }
+  }
+}
+
+/* Hide cursor when controls are hidden */
+.media-minimal-skin--video:has(.media-controls:not([data-visible])) {
+  cursor: none;
 }
 
 /* ==========================================================================
@@ -866,8 +1089,75 @@
    ========================================================================== */
 
 .media-minimal-skin--video .media-popover--volume {
-  --media-popover-side-offset: 0.5rem;
   background: transparent;
-  padding: 0.25rem;
+  padding-block: 0.75rem;
+  border-radius: 0.75rem;
+
+  @media (prefers-reduced-transparency: reduce) or (prefers-contrast: more) {
+    background: var(--media-controls-background-color);
+  }
+}
+
+/* ==========================================================================
+   Slider preview
+   ========================================================================== */
+
+.media-minimal-skin--video .media-slider__preview {
+  --media-preview-max-width: 11rem;
+  --media-preview-padding: -0.5rem;
+  /**
+    Inset is the difference between the container width and the slider (100%) width.
+    We only add to the end as we render the time there.
+  */
+  --media-preview-inset: calc(100cqi - 100%);
+
+  position: absolute;
+  left: clamp(
+    calc(var(--media-preview-max-width) / 2 + var(--media-preview-padding)),
+    var(--media-slider-pointer),
+    calc(100% - var(--media-preview-max-width) / 2 - var(--media-preview-padding) + var(--media-preview-inset))
+  );
+  bottom: 100%;
+  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;
+
+  @container media-root (width > 42rem) {
+    bottom: calc(100% + 0.25rem);
+    left: var(--media-slider-pointer);
+  }
+
+  & .media-preview__thumbnail-wrapper {
+    position: relative;
+
+    &::after {
+      content: "";
+      position: absolute;
+      inset: 0;
+      border-radius: inherit;
+      box-shadow:
+        0 0 0 1px oklch(0 0 0 / 0.05),
+        0 1px 3px 0 oklch(0 0 0 / 0.2),
+        0 1px 2px -1px oklch(0 0 0 / 0.2);
+    }
+  }
+
+  & .media-preview__thumbnail {
+    max-width: var(--media-preview-max-width);
+  }
+
+  &:has(.media-preview__thumbnail[data-loading]) {
+    max-height: 6rem;
+  }
+}
+.media-minimal-skin--video .media-slider[data-pointing] .media-slider__preview:has([role="img"]:not([data-hidden])) {
+  opacity: 1;
+  scale: 1;
+  filter: blur(0);
 }