@scarlett-player/embed 0.4.0 → 0.5.0

package/dist/embed.js

@@ -144,6 +144,9 @@ function setupVideoEventHandlers(video, api) {
     video.addEventListener(event, handler);
     handlers.push({ event, handler });
   };
+  addHandler("play", () => {
+    api.setState("paused", false);
+  });
   addHandler("playing", () => {
     api.setState("playing", true);
     api.setState("paused", false);
@@ -394,7 +397,9 @@ function createHLSPlugin(config) {
   const getRetryDelay = (retryCount) => {
     const baseDelay = mergedConfig.retryDelayMs ?? 1e3;
     const backoffFactor = mergedConfig.retryBackoffFactor ?? 2;
-    return baseDelay * Math.pow(backoffFactor, retryCount);
+    const delay = baseDelay * Math.pow(backoffFactor, retryCount);
+    const jitter = delay * (0.7 + Math.random() * 0.3);
+    return jitter;
   };
   const emitFatalError = (error, retriesExhausted) => {
     const message = retriesExhausted ? `HLS error: ${error.details} (max retries exceeded)` : `HLS error: ${error.details}`;
@@ -608,6 +613,20 @@ function createHLSPlugin(config) {
           if (!isNaN(levelIndex) && levelIndex >= 0 && levelIndex < hls.levels.length) {
             hls.nextLevel = levelIndex;
             api?.logger.debug(`Quality: queued switch to level ${levelIndex}`);
+            const targetLevel = hls.levels[levelIndex];
+            if (targetLevel) {
+              const label = formatLevel(targetLevel);
+              api?.setState("currentQuality", {
+                id: `level-${levelIndex}`,
+                label: `${label}...`,
+                // Ellipsis indicates switching in progress
+                width: targetLevel.width,
+                height: targetLevel.height,
+                bitrate: targetLevel.bitrate,
+                active: false
+                // Not yet active
+              });
+            }
           }
         }
       });
@@ -869,7 +888,12 @@ var styles = `
   transition: height 0.15s ease;
 }
 
-.sp-progress-wrapper:hover .sp-progress,
+@media (hover: hover) {
+  .sp-progress-wrapper:hover .sp-progress {
+    height: 5px;
+  }
+}
+
 .sp-progress--dragging {
   height: 5px;
 }
@@ -915,11 +939,34 @@ var styles = `
   box-shadow: 0 2px 4px rgba(0, 0, 0, 0.3);
 }
 
-.sp-progress-wrapper:hover .sp-progress__handle,
+@media (hover: hover) {
+  .sp-progress-wrapper:hover .sp-progress__handle {
+    transform: translate(-50%, -50%) scale(1);
+  }
+}
+
 .sp-progress--dragging .sp-progress__handle {
   transform: translate(-50%, -50%) scale(1);
 }
 
+/* Thumbnail Preview */
+.sp-thumbnail-preview {
+  position: absolute;
+  bottom: calc(100% + 8px);
+  transform: translateX(-50%);
+  pointer-events: none;
+  display: none;
+  z-index: 21;
+  border-radius: 4px;
+  overflow: hidden;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.4);
+  border: 2px solid rgba(255, 255, 255, 0.2);
+}
+
+.sp-thumbnail-preview__img {
+  background-repeat: no-repeat;
+}
+
 /* Progress Tooltip */
 .sp-progress__tooltip {
   position: absolute;
@@ -939,8 +986,10 @@ var styles = `
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
 }
 
-.sp-progress-wrapper:hover .sp-progress__tooltip {
-  opacity: 1;
+@media (hover: hover) {
+  .sp-progress-wrapper:hover .sp-progress__tooltip {
+    opacity: 1;
+  }
 }
 
 /* ============================================
@@ -960,9 +1009,11 @@ var styles = `
   flex-shrink: 0;
 }
 
-.sp-control:hover {
-  color: #fff;
-  background: rgba(255, 255, 255, 0.1);
+@media (hover: hover) {
+  .sp-control:hover {
+    color: #fff;
+    background: rgba(255, 255, 255, 0.1);
+  }
 }
 
 .sp-control:active {
@@ -1031,7 +1082,12 @@ var styles = `
   transition: width 0.2s ease;
 }
 
-.sp-volume:hover .sp-volume__slider-wrap,
+@media (hover: hover) {
+  .sp-volume:hover .sp-volume__slider-wrap {
+    width: 64px;
+  }
+}
+
 .sp-volume:focus-within .sp-volume__slider-wrap {
   width: 64px;
 }
@@ -1074,8 +1130,10 @@ var styles = `
   transition: background 0.15s ease, opacity 0.15s ease;
 }
 
-.sp-live:hover {
-  background: rgba(255, 255, 255, 0.1);
+@media (hover: hover) {
+  .sp-live:hover {
+    background: rgba(255, 255, 255, 0.1);
+  }
 }
 
 .sp-live__dot {
@@ -1094,6 +1152,16 @@ var styles = `
   animation: none;
 }
 
+.sp-live--behind span {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+/* Progress bar live mode: accent color for filled bar */
+.sp-progress--live .sp-progress__filled {
+  background: var(--sp-accent, #e50914);
+}
+
 @keyframes sp-pulse {
   0%, 100% { opacity: 1; }
   50% { opacity: 0.4; }
@@ -1174,6 +1242,169 @@ var styles = `
   opacity: 1;
 }
 
+/* ============================================
+   Settings Menu (Gear Icon)
+   ============================================ */
+.sp-settings {
+  position: relative;
+}
+
+.sp-settings__btn {
+  display: flex;
+  align-items: center;
+}
+
+.sp-settings-panel {
+  position: absolute;
+  bottom: calc(100% + 8px);
+  right: 0;
+  background: rgba(20, 20, 20, 0.95);
+  backdrop-filter: blur(8px);
+  -webkit-backdrop-filter: blur(8px);
+  border-radius: 8px;
+  min-width: 200px;
+  box-shadow: 0 4px 24px rgba(0, 0, 0, 0.4);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(8px);
+  transition: opacity 0.15s ease, transform 0.15s ease, visibility 0.15s;
+  z-index: 20;
+  overflow: hidden;
+}
+
+.sp-settings-panel--open {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+/* Main menu rows */
+.sp-settings-panel--main {
+  padding: 4px 0;
+}
+
+.sp-settings-panel__row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 16px;
+  font-size: 13px;
+  color: rgba(255, 255, 255, 0.9);
+  cursor: pointer;
+  transition: background 0.1s ease;
+}
+
+.sp-settings-panel__row:hover {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.sp-settings-panel__label {
+  font-weight: 500;
+}
+
+.sp-settings-panel__value {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  color: rgba(255, 255, 255, 0.6);
+  font-size: 12px;
+}
+
+.sp-settings-panel__arrow {
+  display: flex;
+  align-items: center;
+  transform: rotate(-90deg);
+}
+
+.sp-settings-panel__arrow svg {
+  width: 16px;
+  height: 16px;
+  fill: currentColor;
+}
+
+/* Sub-menu panels */
+.sp-settings-panel--sub {
+  padding: 0;
+}
+
+.sp-settings-panel__header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 16px;
+  font-size: 13px;
+  font-weight: 600;
+  color: rgba(255, 255, 255, 0.9);
+  cursor: pointer;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+  transition: background 0.1s ease;
+}
+
+.sp-settings-panel__header:hover {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.sp-settings-panel__back {
+  display: flex;
+  align-items: center;
+  transform: rotate(-90deg);
+}
+
+.sp-settings-panel__back svg {
+  width: 16px;
+  height: 16px;
+  fill: currentColor;
+}
+
+.sp-settings-panel__header-label {
+  flex: 1;
+}
+
+.sp-settings-panel__item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 16px;
+  font-size: 13px;
+  color: rgba(255, 255, 255, 0.8);
+  cursor: pointer;
+  transition: background 0.1s ease, color 0.1s ease;
+}
+
+.sp-settings-panel__item:hover {
+  background: rgba(255, 255, 255, 0.1);
+  color: #fff;
+}
+
+.sp-settings-panel__item--active {
+  color: var(--sp-accent, #e50914);
+}
+
+.sp-settings-panel__check {
+  width: 16px;
+  height: 16px;
+  fill: currentColor;
+  margin-left: 8px;
+  opacity: 0;
+}
+
+.sp-settings-panel__check svg {
+  width: 16px;
+  height: 16px;
+  fill: currentColor;
+}
+
+.sp-settings-panel__item--active .sp-settings-panel__check {
+  opacity: 1;
+}
+
+/* ============================================
+   Captions Button
+   ============================================ */
+.sp-captions--active {
+  color: var(--sp-accent, #e50914);
+}
+
 /* ============================================
    Cast Button States
    ============================================ */
@@ -1185,6 +1416,122 @@ var styles = `
   opacity: 0.4;
 }
 
+/* ============================================
+   Error Overlay
+   ============================================ */
+.sp-error-overlay {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.85);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 25;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.25s ease, visibility 0.25s;
+}
+
+.sp-error-overlay--visible {
+  opacity: 1;
+  visibility: visible;
+}
+
+.sp-error-overlay__content {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  text-align: center;
+  padding: 24px;
+  max-width: 360px;
+}
+
+.sp-error-overlay__icon {
+  color: rgba(255, 255, 255, 0.7);
+  margin-bottom: 16px;
+}
+
+.sp-error-overlay__icon svg {
+  width: 48px;
+  height: 48px;
+  fill: currentColor;
+}
+
+.sp-error-overlay__message {
+  color: rgba(255, 255, 255, 0.9);
+  font-size: 15px;
+  line-height: 1.5;
+  margin: 0 0 24px;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+.sp-error-overlay__actions {
+  display: flex;
+  gap: 12px;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+.sp-error-overlay__retry {
+  background: var(--sp-accent, #e50914);
+  color: #fff;
+  border: none;
+  padding: 12px 24px;
+  font-size: 14px;
+  font-weight: 600;
+  border-radius: 6px;
+  cursor: pointer;
+  min-width: 120px;
+  min-height: 44px;
+  transition: background 0.15s ease, transform 0.15s ease;
+  font-family: inherit;
+}
+
+.sp-error-overlay__retry:hover {
+  filter: brightness(1.1);
+}
+
+.sp-error-overlay__retry:active {
+  transform: scale(0.96);
+}
+
+.sp-error-overlay__retry:focus-visible {
+  outline: 2px solid #fff;
+  outline-offset: 2px;
+}
+
+.sp-error-overlay__dismiss {
+  background: none;
+  color: rgba(255, 255, 255, 0.7);
+  border: 1px solid rgba(255, 255, 255, 0.3);
+  padding: 12px 24px;
+  font-size: 14px;
+  font-weight: 500;
+  border-radius: 6px;
+  cursor: pointer;
+  min-width: 100px;
+  min-height: 44px;
+  transition: color 0.15s ease, border-color 0.15s ease, transform 0.15s ease;
+  font-family: inherit;
+}
+
+.sp-error-overlay__dismiss:hover {
+  color: #fff;
+  border-color: rgba(255, 255, 255, 0.5);
+}
+
+.sp-error-overlay__dismiss:active {
+  transform: scale(0.96);
+}
+
+.sp-error-overlay__dismiss:focus-visible {
+  outline: 2px solid #fff;
+  outline-offset: 2px;
+}
+
 /* ============================================
    Buffering Indicator
    ============================================ */
@@ -1232,7 +1579,14 @@ var styles = `
   .sp-control,
   .sp-volume__slider-wrap,
   .sp-quality-menu,
-  .sp-buffering {
+  .sp-settings-panel,
+  .sp-settings-panel__row,
+  .sp-settings-panel__item,
+  .sp-settings-panel__header,
+  .sp-buffering,
+  .sp-error-overlay,
+  .sp-error-overlay__retry,
+  .sp-error-overlay__dismiss {
     transition: none;
   }
 
@@ -1267,7 +1621,15 @@ var icons = {
   chromecast: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M1 18v3h3c0-1.66-1.34-3-3-3zm0-4v2c2.76 0 5 2.24 5 5h2c0-3.87-3.13-7-7-7zm0-4v2c4.97 0 9 4.03 9 9h2c0-6.08-4.93-11-11-11zm20-7H3c-1.1 0-2 .9-2 2v3h2V5h18v14h-7v2h7c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2z"/></svg>`,
   chromecastConnected: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M1 18v3h3c0-1.66-1.34-3-3-3zm0-4v2c2.76 0 5 2.24 5 5h2c0-3.87-3.13-7-7-7zm18-7H5v1.63c3.96 1.28 7.09 4.41 8.37 8.37H19V7zM1 10v2c4.97 0 9 4.03 9 9h2c0-6.08-4.93-11-11-11zm20-7H3c-1.1 0-2 .9-2 2v3h2V5h18v14h-7v2h7c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2z"/></svg>`,
   airplay: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M6 22h12l-6-6-6 6zM21 3H3c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h4v-2H3V5h18v12h-4v2h4c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2z"/></svg>`,
-  spinner: `<svg viewBox="0 0 24 24" fill="currentColor" class="sp-spin"><path d="M12 4V2A10 10 0 0 0 2 12h2a8 8 0 0 1 8-8z"/></svg>`
+  captions: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M19 4H5c-1.11 0-2 .9-2 2v12c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2zm-8 7H9.5v-.5h-2v3h2V13H11v1c0 .55-.45 1-1 1H7c-.55 0-1-.45-1-1v-4c0-.55.45-1 1-1h3c.55 0 1 .45 1 1v1zm7 0h-1.5v-.5h-2v3h2V13H18v1c0 .55-.45 1-1 1h-3c-.55 0-1-.45-1-1v-4c0-.55.45-1 1-1h3c.55 0 1 .45 1 1v1z"/></svg>`,
+  captionsOff: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M19.5 5.5v13h-15v-13h15zM19 4H5c-1.11 0-2 .9-2 2v12c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2z"/></svg>`,
+  checkmark: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/></svg>`,
+  chevronUp: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14z"/></svg>`,
+  chevronDown: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M16.59 8.59L12 13.17 7.41 8.59 6 10l6 6 6-6z"/></svg>`,
+  spinner: `<svg viewBox="0 0 24 24" fill="currentColor" class="sp-spin"><path d="M12 4V2A10 10 0 0 0 2 12h2a8 8 0 0 1 8-8z"/></svg>`,
+  forward10: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M18 13c0 3.31-2.69 6-6 6s-6-2.69-6-6 2.69-6 6-6v4l5-5-5-5v4c-4.42 0-8 3.58-8 8s3.58 8 8 8 8-3.58 8-8h-2z"/><path d="M10.9 16V11.73l-.72.36-.48-.86 1.48-.73h.85V16h-1.13zm2.77-2.14c0-.66.13-1.2.38-1.6.26-.41.66-.62 1.2-.62.55 0 .95.21 1.21.62.25.4.38.94.38 1.6 0 .67-.13 1.2-.38 1.61-.26.41-.66.61-1.21.61-.54 0-.94-.2-1.2-.61-.25-.41-.38-.94-.38-1.61zm1.12 0c0 .45.05.79.15 1.03.1.23.26.35.48.35s.38-.12.49-.35c.1-.24.15-.58.15-1.03s-.05-.78-.15-1.02c-.11-.23-.27-.35-.49-.35s-.38.12-.48.35c-.1.24-.15.57-.15 1.02z"/></svg>`,
+  replay10: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M12 5V1L7 6l5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6H4c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z"/><path d="M10.9 16V11.73l-.72.36-.48-.86 1.48-.73h.85V16h-1.13zm2.77-2.14c0-.66.13-1.2.38-1.6.26-.41.66-.62 1.2-.62.55 0 .95.21 1.21.62.25.4.38.94.38 1.6 0 .67-.13 1.2-.38 1.61-.26.41-.66.61-1.21.61-.54 0-.94-.2-1.2-.61-.25-.41-.38-.94-.38-1.61zm1.12 0c0 .45.05.79.15 1.03.1.23.26.35.48.35s.38-.12.49-.35c.1-.24.15-.58.15-1.03s-.05-.78-.15-1.02c-.11-.23-.27-.35-.49-.35s-.38.12-.48.35c-.1.24-.15.57-.15 1.02z"/></svg>`,
+  error: `<svg viewBox="0 0 24 24" fill="currentColor"><path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z"/></svg>`
 };
 function createElement(tag, attrs, children) {
   const el = document.createElement(tag);
@@ -1351,12 +1713,11 @@ var PlayButton = class {
     const video = getVideo(this.api.container);
     if (!video) return;
     const ended = this.api.getState("ended");
-    const playing = this.api.getState("playing");
     if (ended) {
       video.currentTime = 0;
       video.play().catch(() => {
       });
-    } else if (playing) {
+    } else if (!video.paused) {
       video.pause();
     } else {
       video.play().catch(() => {
@@ -1368,6 +1729,68 @@ var PlayButton = class {
     this.el.remove();
   }
 };
+var ThumbnailPreview = class {
+  constructor() {
+    this.config = null;
+    this.loaded = false;
+    this.el = createElement("div", { className: "sp-thumbnail-preview" });
+    this.img = createElement("div", { className: "sp-thumbnail-preview__img" });
+    this.el.appendChild(this.img);
+  }
+  getElement() {
+    return this.el;
+  }
+  setConfig(config) {
+    this.config = config;
+    this.loaded = false;
+    if (config) {
+      this.img.style.width = `${config.width}px`;
+      this.img.style.height = `${config.height}px`;
+      this.el.style.width = `${config.width}px`;
+      this.el.style.height = `${config.height}px`;
+      const preload = new Image();
+      preload.onload = () => {
+        this.loaded = true;
+      };
+      preload.onerror = () => {
+        this.config = null;
+        this.loaded = false;
+      };
+      preload.src = config.src;
+    }
+  }
+  /**
+   * Update the thumbnail to show the frame at the given time.
+   * @param time Time in seconds
+   * @param percent Position as 0-1 fraction (for horizontal positioning)
+   */
+  show(time, percent) {
+    if (!this.config || !this.loaded) {
+      this.el.style.display = "none";
+      return;
+    }
+    const { src, width, height, columns, interval } = this.config;
+    const index = Math.floor(time / interval);
+    const col = index % columns;
+    const row = Math.floor(index / columns);
+    this.img.style.backgroundImage = `url(${src})`;
+    this.img.style.backgroundPosition = `-${col * width}px -${row * height}px`;
+    this.img.style.backgroundSize = `${columns * width}px auto`;
+    this.img.style.width = `${width}px`;
+    this.img.style.height = `${height}px`;
+    this.el.style.left = `${percent * 100}%`;
+    this.el.style.display = "";
+  }
+  hide() {
+    this.el.style.display = "none";
+  }
+  isConfigured() {
+    return this.config !== null;
+  }
+  destroy() {
+    this.el.remove();
+  }
+};
 var ProgressBar = class {
   constructor(api) {
     this.isDragging = false;
@@ -1407,36 +1830,99 @@ var ProgressBar = class {
         }
       }
     };
-    this.onMouseMove = (e) => {
-      this.updateTooltip(e.clientX);
+    this.onTouchStart = (e) => {
+      e.preventDefault();
+      const video = getVideo(this.api.container);
+      this.wasPlayingBeforeDrag = video ? !video.paused : false;
+      this.isDragging = true;
+      this.el.classList.add("sp-progress--dragging");
+      this.lastSeekTime = 0;
+      this.seek(e.touches[0].clientX, true);
     };
-    this.onMouseLeave = () => {
+    this.onDocTouchMove = (e) => {
+      if (this.isDragging) {
+        e.preventDefault();
+        this.seek(e.touches[0].clientX);
+        this.updateVisualPosition(e.touches[0].clientX);
+      }
+    };
+    this.onTouchEnd = (e) => {
+      if (this.isDragging) {
+        const clientX = e.changedTouches?.[0]?.clientX;
+        if (clientX !== void 0) {
+          this.seek(clientX, true);
+        }
+        this.isDragging = false;
+        this.el.classList.remove("sp-progress--dragging");
+        if (this.wasPlayingBeforeDrag) {
+          const video = getVideo(this.api.container);
+          if (video && video.paused) {
+            const resumePlayback = () => {
+              video.removeEventListener("seeked", resumePlayback);
+              video.play().catch(() => {
+              });
+            };
+            video.addEventListener("seeked", resumePlayback);
+          }
+        }
+        this.tooltip.style.opacity = "0";
+        this.thumbnailPreview.hide();
+      }
+    };
+    this.onMouseMove = (e) => {
+      this.updateTooltip(e.clientX);
+    };
+    this.onMouseLeave = () => {
       if (!this.isDragging) {
         this.tooltip.style.opacity = "0";
+        this.thumbnailPreview.hide();
       }
     };
     this.onKeyDown = (e) => {
       const video = getVideo(this.api.container);
       if (!video) return;
       const step = 5;
-      const duration = this.api.getState("duration") || 0;
-      switch (e.key) {
-        case "ArrowLeft":
-          e.preventDefault();
-          video.currentTime = Math.max(0, video.currentTime - step);
-          break;
-        case "ArrowRight":
-          e.preventDefault();
-          video.currentTime = Math.min(duration, video.currentTime + step);
-          break;
-        case "Home":
-          e.preventDefault();
-          video.currentTime = 0;
-          break;
-        case "End":
-          e.preventDefault();
-          video.currentTime = duration;
-          break;
+      const live = this.api.getState("live");
+      const seekableRange = this.api.getState("seekableRange");
+      if (live && seekableRange) {
+        switch (e.key) {
+          case "ArrowLeft":
+            e.preventDefault();
+            video.currentTime = Math.max(seekableRange.start, video.currentTime - step);
+            break;
+          case "ArrowRight":
+            e.preventDefault();
+            video.currentTime = Math.min(seekableRange.end, video.currentTime + step);
+            break;
+          case "Home":
+            e.preventDefault();
+            video.currentTime = seekableRange.start;
+            break;
+          case "End":
+            e.preventDefault();
+            video.currentTime = seekableRange.end;
+            break;
+        }
+      } else {
+        const duration = this.api.getState("duration") || 0;
+        switch (e.key) {
+          case "ArrowLeft":
+            e.preventDefault();
+            video.currentTime = Math.max(0, video.currentTime - step);
+            break;
+          case "ArrowRight":
+            e.preventDefault();
+            video.currentTime = Math.min(duration, video.currentTime + step);
+            break;
+          case "Home":
+            e.preventDefault();
+            video.currentTime = 0;
+            break;
+          case "End":
+            e.preventDefault();
+            video.currentTime = duration;
+            break;
+        }
       }
     };
     this.api = api;
@@ -1448,10 +1934,12 @@ var ProgressBar = class {
     this.handle = createElement("div", { className: "sp-progress__handle" });
     this.tooltip = createElement("div", { className: "sp-progress__tooltip" });
     this.tooltip.textContent = "0:00";
+    this.thumbnailPreview = new ThumbnailPreview();
     track.appendChild(this.buffered);
     track.appendChild(this.filled);
     track.appendChild(this.handle);
     this.el.appendChild(track);
+    this.el.appendChild(this.thumbnailPreview.getElement());
     this.el.appendChild(this.tooltip);
     this.wrapper.appendChild(this.el);
     this.el.setAttribute("role", "slider");
@@ -1461,9 +1949,13 @@ var ProgressBar = class {
     this.wrapper.addEventListener("mousedown", this.onMouseDown);
     this.wrapper.addEventListener("mousemove", this.onMouseMove);
     this.wrapper.addEventListener("mouseleave", this.onMouseLeave);
+    this.wrapper.addEventListener("touchstart", this.onTouchStart, { passive: false });
     this.el.addEventListener("keydown", this.onKeyDown);
     document.addEventListener("mousemove", this.onDocMouseMove);
     document.addEventListener("mouseup", this.onMouseUp);
+    document.addEventListener("touchmove", this.onDocTouchMove, { passive: false });
+    document.addEventListener("touchend", this.onTouchEnd);
+    document.addEventListener("touchcancel", this.onTouchEnd);
   }
   render() {
     return this.wrapper;
@@ -1476,11 +1968,40 @@ var ProgressBar = class {
   hide() {
     this.wrapper.classList.remove("sp-progress-wrapper--visible");
   }
+  /** Set thumbnail sprite configuration */
+  setThumbnails(config) {
+    this.thumbnailPreview.setConfig(config);
+  }
   update() {
     const currentTime = this.api.getState("currentTime") || 0;
     const duration = this.api.getState("duration") || 0;
     const bufferedRanges = this.api.getState("buffered");
-    if (duration > 0) {
+    const live = this.api.getState("live");
+    const seekableRange = this.api.getState("seekableRange");
+    const thumbnails = this.api.getState("thumbnails");
+    if (thumbnails && !this.thumbnailPreview.isConfigured()) {
+      this.thumbnailPreview.setConfig(thumbnails);
+    }
+    this.el.classList.toggle("sp-progress--live", !!live);
+    if (live && seekableRange) {
+      const rangeLength = seekableRange.end - seekableRange.start;
+      if (rangeLength > 0) {
+        const progress = (currentTime - seekableRange.start) / rangeLength * 100;
+        this.filled.style.width = `${Math.max(0, Math.min(100, progress))}%`;
+        this.handle.style.left = `${Math.max(0, Math.min(100, progress))}%`;
+      }
+      if (bufferedRanges && bufferedRanges.length > 0) {
+        const rangeLength2 = seekableRange.end - seekableRange.start;
+        if (rangeLength2 > 0) {
+          const bufferedEnd = bufferedRanges.end(bufferedRanges.length - 1);
+          const bufferedPercent = (bufferedEnd - seekableRange.start) / rangeLength2 * 100;
+          this.buffered.style.width = `${Math.max(0, Math.min(100, bufferedPercent))}%`;
+        }
+      }
+      this.el.setAttribute("aria-valuemax", String(Math.floor(seekableRange.end)));
+      this.el.setAttribute("aria-valuenow", String(Math.floor(currentTime)));
+      this.el.setAttribute("aria-valuetext", `${Math.floor(seekableRange.end - currentTime)} seconds behind live`);
+    } else if (duration > 0) {
       const progress = currentTime / duration * 100;
       this.filled.style.width = `${progress}%`;
       this.handle.style.left = `${progress}%`;
@@ -1497,6 +2018,12 @@ var ProgressBar = class {
   getTimeFromPosition(clientX) {
     const rect = this.el.getBoundingClientRect();
     const percent = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));
+    const live = this.api.getState("live");
+    const seekableRange = this.api.getState("seekableRange");
+    if (live && seekableRange) {
+      const rangeLength = seekableRange.end - seekableRange.start;
+      return seekableRange.start + percent * rangeLength;
+    }
     const duration = this.api.getState("duration") || 0;
     return percent * duration;
   }
@@ -1504,8 +2031,18 @@ var ProgressBar = class {
     const rect = this.el.getBoundingClientRect();
     const percent = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));
     const time = this.getTimeFromPosition(clientX);
-    this.tooltip.textContent = formatTime$1(time);
+    const live = this.api.getState("live");
+    const seekableRange = this.api.getState("seekableRange");
+    if (live && seekableRange) {
+      const behindLive = seekableRange.end - time;
+      this.tooltip.textContent = formatLiveTime(behindLive);
+    } else {
+      this.tooltip.textContent = formatTime$1(time);
+    }
     this.tooltip.style.left = `${percent * 100}%`;
+    if (this.thumbnailPreview.isConfigured()) {
+      this.thumbnailPreview.show(time, percent);
+    }
   }
   updateVisualPosition(clientX) {
     const rect = this.el.getBoundingClientRect();
@@ -1528,8 +2065,13 @@ var ProgressBar = class {
     this.wrapper.removeEventListener("mousedown", this.onMouseDown);
     this.wrapper.removeEventListener("mousemove", this.onMouseMove);
     this.wrapper.removeEventListener("mouseleave", this.onMouseLeave);
+    this.wrapper.removeEventListener("touchstart", this.onTouchStart);
     document.removeEventListener("mousemove", this.onDocMouseMove);
     document.removeEventListener("mouseup", this.onMouseUp);
+    document.removeEventListener("touchmove", this.onDocTouchMove);
+    document.removeEventListener("touchend", this.onTouchEnd);
+    document.removeEventListener("touchcancel", this.onTouchEnd);
+    this.thumbnailPreview.destroy();
     this.wrapper.remove();
   }
 };
@@ -1578,6 +2120,20 @@ var VolumeControl = class {
     this.onMouseUp = () => {
       this.isDragging = false;
     };
+    this.onTouchStart = (e) => {
+      e.preventDefault();
+      this.isDragging = true;
+      this.setVolume(this.getVolumeFromPosition(e.touches[0].clientX));
+    };
+    this.onDocTouchMove = (e) => {
+      if (this.isDragging) {
+        e.preventDefault();
+        this.setVolume(this.getVolumeFromPosition(e.touches[0].clientX));
+      }
+    };
+    this.onTouchEnd = () => {
+      this.isDragging = false;
+    };
     this.onKeyDown = (e) => {
       const video = getVideo(this.api.container);
       if (!video) return;
@@ -1617,9 +2173,13 @@ var VolumeControl = class {
     this.el.appendChild(this.btn);
     this.el.appendChild(sliderWrap);
     this.slider.addEventListener("mousedown", this.onMouseDown);
+    this.slider.addEventListener("touchstart", this.onTouchStart, { passive: false });
     this.slider.addEventListener("keydown", this.onKeyDown);
     document.addEventListener("mousemove", this.onDocMouseMove);
     document.addEventListener("mouseup", this.onMouseUp);
+    document.addEventListener("touchmove", this.onDocTouchMove, { passive: false });
+    document.addEventListener("touchend", this.onTouchEnd);
+    document.addEventListener("touchcancel", this.onTouchEnd);
   }
   render() {
     return this.el;
@@ -1664,26 +2224,40 @@ var VolumeControl = class {
     return Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));
   }
   destroy() {
+    this.slider.removeEventListener("mousedown", this.onMouseDown);
+    this.slider.removeEventListener("touchstart", this.onTouchStart);
+    this.slider.removeEventListener("keydown", this.onKeyDown);
     document.removeEventListener("mousemove", this.onDocMouseMove);
     document.removeEventListener("mouseup", this.onMouseUp);
+    document.removeEventListener("touchmove", this.onDocTouchMove);
+    document.removeEventListener("touchend", this.onTouchEnd);
+    document.removeEventListener("touchcancel", this.onTouchEnd);
     this.el.remove();
   }
 };
 var LiveIndicator = class {
   constructor(api) {
-    this.api = api;
-    this.el = createElement("div", { className: "sp-live" });
-    this.el.innerHTML = '<div class="sp-live__dot"></div><span>LIVE</span>';
-    this.el.setAttribute("role", "button");
-    this.el.setAttribute("aria-label", "Seek to live");
-    this.el.setAttribute("tabindex", "0");
-    this.el.onclick = () => this.seekToLive();
-    this.el.onkeydown = (e) => {
+    this.handleClick = () => {
+      this.seekToLive();
+    };
+    this.handleKeyDown = (e) => {
       if (e.key === "Enter" || e.key === " ") {
         e.preventDefault();
         this.seekToLive();
       }
     };
+    this.api = api;
+    this.el = createElement("div", { className: "sp-live" });
+    this.dot = createElement("div", { className: "sp-live__dot" });
+    this.label = document.createElement("span");
+    this.label.textContent = "LIVE";
+    this.el.appendChild(this.dot);
+    this.el.appendChild(this.label);
+    this.el.setAttribute("role", "button");
+    this.el.setAttribute("aria-label", "Seek to live");
+    this.el.setAttribute("tabindex", "0");
+    this.el.addEventListener("click", this.handleClick);
+    this.el.addEventListener("keydown", this.handleKeyDown);
   }
   render() {
     return this.el;
@@ -1694,8 +2268,12 @@ var LiveIndicator = class {
     this.el.style.display = live ? "" : "none";
     if (liveEdge) {
       this.el.classList.remove("sp-live--behind");
+      this.label.textContent = "LIVE";
+      this.el.setAttribute("aria-label", "At live edge");
     } else {
       this.el.classList.add("sp-live--behind");
+      this.label.textContent = "GO LIVE";
+      this.el.setAttribute("aria-label", "Seek to live");
     }
   }
   seekToLive() {
@@ -1707,6 +2285,8 @@ var LiveIndicator = class {
     }
   }
   destroy() {
+    this.el.removeEventListener("click", this.handleClick);
+    this.el.removeEventListener("keydown", this.handleKeyDown);
     this.el.remove();
   }
 };
@@ -2006,13 +2586,579 @@ var Spacer = class {
     this.el.remove();
   }
 };
+function getUserMessage(error) {
+  if (!error) return "Something went wrong.";
+  const msg = error.message?.toLowerCase() || "";
+  if (msg.includes("network") || msg.includes("timeout") || msg.includes("fetch") || msg.includes("connection")) {
+    return "Having trouble connecting. Check your internet and try again.";
+  }
+  if (msg.includes("manifest")) {
+    return "Unable to load video. Please try again.";
+  }
+  if (msg.includes("decode") || msg.includes("media") || msg.includes("format") || msg.includes("codec")) {
+    return "This video can't be played right now.";
+  }
+  if (msg.includes("not found") || msg.includes("404") || msg.includes("source") || msg.includes("not supported")) {
+    return "Video not found.";
+  }
+  return "Something went wrong.";
+}
+var ErrorOverlay = class {
+  constructor(api) {
+    this.visible = false;
+    this.lastSource = null;
+    this.handleRetry = () => {
+      if (this.retryBtn.disabled) return;
+      this.retryBtn.disabled = true;
+      this.hide();
+      const source = this.api.getState("source");
+      const src = source?.src || this.lastSource;
+      if (src) {
+        this.api.emit("error:retry", { src });
+        const video = this.api.container.querySelector("video");
+        if (video) {
+          video.src = src;
+          video.load();
+          video.play().catch(() => {
+          });
+        }
+      }
+      setTimeout(() => {
+        this.retryBtn.disabled = false;
+      }, 1e3);
+    };
+    this.handleDismiss = () => {
+      this.hide();
+      this.api.emit("error:dismiss", void 0);
+    };
+    this.api = api;
+    const overlay = document.createElement("div");
+    overlay.className = "sp-error-overlay";
+    overlay.setAttribute("role", "alert");
+    overlay.setAttribute("aria-live", "assertive");
+    const content = document.createElement("div");
+    content.className = "sp-error-overlay__content";
+    const iconEl = document.createElement("div");
+    iconEl.className = "sp-error-overlay__icon";
+    iconEl.innerHTML = icons.error;
+    const messageEl = document.createElement("p");
+    messageEl.className = "sp-error-overlay__message";
+    messageEl.textContent = "Something went wrong.";
+    const actions = document.createElement("div");
+    actions.className = "sp-error-overlay__actions";
+    this.retryBtn = document.createElement("button");
+    this.retryBtn.className = "sp-error-overlay__retry";
+    this.retryBtn.setAttribute("type", "button");
+    this.retryBtn.setAttribute("aria-label", "Try again");
+    this.retryBtn.textContent = "Try Again";
+    this.retryBtn.addEventListener("click", this.handleRetry);
+    this.dismissBtn = document.createElement("button");
+    this.dismissBtn.className = "sp-error-overlay__dismiss";
+    this.dismissBtn.setAttribute("type", "button");
+    this.dismissBtn.setAttribute("aria-label", "Go back");
+    this.dismissBtn.textContent = "Go Back";
+    this.dismissBtn.addEventListener("click", this.handleDismiss);
+    actions.appendChild(this.retryBtn);
+    actions.appendChild(this.dismissBtn);
+    content.appendChild(iconEl);
+    content.appendChild(messageEl);
+    content.appendChild(actions);
+    overlay.appendChild(content);
+    this.el = overlay;
+  }
+  render() {
+    return this.el;
+  }
+  /** Show the error overlay with the given error */
+  show(error) {
+    const message = getUserMessage(error);
+    const messageEl = this.el.querySelector(".sp-error-overlay__message");
+    if (messageEl) {
+      messageEl.textContent = message;
+    }
+    const source = this.api.getState("source");
+    if (source?.src) {
+      this.lastSource = source.src;
+    }
+    this.visible = true;
+    this.retryBtn.disabled = false;
+    this.el.classList.add("sp-error-overlay--visible");
+  }
+  /** Hide the error overlay */
+  hide() {
+    this.visible = false;
+    this.el.classList.remove("sp-error-overlay--visible");
+  }
+  isVisible() {
+    return this.visible;
+  }
+  update() {
+    const playbackState = this.api.getState("playbackState");
+    if (this.visible && playbackState !== "error" && playbackState !== "loading") {
+      const playing = this.api.getState("playing");
+      if (playing) {
+        this.hide();
+      }
+    }
+  }
+  destroy() {
+    this.retryBtn.removeEventListener("click", this.handleRetry);
+    this.dismissBtn.removeEventListener("click", this.handleDismiss);
+    this.el.remove();
+  }
+};
+var SPEED_OPTIONS = [
+  { label: "0.5x", value: 0.5 },
+  { label: "0.75x", value: 0.75 },
+  { label: "Normal", value: 1 },
+  { label: "1.25x", value: 1.25 },
+  { label: "1.5x", value: 1.5 },
+  { label: "2x", value: 2 }
+];
+var SettingsMenu = class {
+  constructor(api) {
+    this.isOpen = false;
+    this.currentPanel = "main";
+    this.lastQualitiesJson = "";
+    this.api = api;
+    this.el = createElement("div", { className: "sp-settings" });
+    this.btn = createButton("sp-settings__btn", "Settings", icons.settings);
+    this.btn.setAttribute("aria-haspopup", "true");
+    this.btn.setAttribute("aria-expanded", "false");
+    this.btn.addEventListener("click", (e) => {
+      e.stopPropagation();
+      this.toggle();
+    });
+    this.panel = createElement("div", { className: "sp-settings-panel" });
+    this.panel.setAttribute("role", "menu");
+    this.panel.addEventListener("click", (e) => e.stopPropagation());
+    this.el.appendChild(this.btn);
+    this.el.appendChild(this.panel);
+    this.closeHandler = (e) => {
+      if (!this.el.contains(e.target)) {
+        this.close();
+      }
+    };
+    document.addEventListener("click", this.closeHandler);
+    this.keyHandler = (e) => {
+      if (!this.isOpen) return;
+      if (e.key === "Escape") {
+        e.preventDefault();
+        e.stopPropagation();
+        if (this.currentPanel !== "main") {
+          this.showPanel("main");
+        } else {
+          this.close();
+          this.btn.focus();
+        }
+      }
+    };
+    document.addEventListener("keydown", this.keyHandler);
+  }
+  render() {
+    return this.el;
+  }
+  update() {
+    const qualities = this.api.getState("qualities") || [];
+    const qualitiesJson = JSON.stringify(qualities.map((q) => q.id));
+    if (qualitiesJson !== this.lastQualitiesJson) {
+      this.lastQualitiesJson = qualitiesJson;
+      if (this.isOpen && this.currentPanel === "quality") {
+        this.renderQualityPanel();
+      }
+    }
+    if (this.isOpen) {
+      if (this.currentPanel === "quality") {
+        this.updateQualityActiveStates();
+      } else if (this.currentPanel === "speed") {
+        this.updateSpeedActiveStates();
+      } else if (this.currentPanel === "captions") {
+        this.updateCaptionsActiveStates();
+      }
+    }
+  }
+  toggle() {
+    this.isOpen ? this.close() : this.open();
+  }
+  open() {
+    this.isOpen = true;
+    this.currentPanel = "main";
+    this.renderMainPanel();
+    this.panel.classList.add("sp-settings-panel--open");
+    this.btn.setAttribute("aria-expanded", "true");
+  }
+  close() {
+    this.isOpen = false;
+    this.currentPanel = "main";
+    this.panel.classList.remove("sp-settings-panel--open");
+    this.btn.setAttribute("aria-expanded", "false");
+  }
+  showPanel(panel) {
+    this.currentPanel = panel;
+    switch (panel) {
+      case "main":
+        this.renderMainPanel();
+        break;
+      case "quality":
+        this.renderQualityPanel();
+        break;
+      case "speed":
+        this.renderSpeedPanel();
+        break;
+      case "captions":
+        this.renderCaptionsPanel();
+        break;
+    }
+  }
+  renderMainPanel() {
+    this.panel.innerHTML = "";
+    this.panel.className = "sp-settings-panel sp-settings-panel--open sp-settings-panel--main";
+    const qualities = this.api.getState("qualities") || [];
+    const currentQuality = this.api.getState("currentQuality");
+    const playbackRate = this.api.getState("playbackRate") ?? 1;
+    if (qualities.length > 0) {
+      const qualityRow = this.createMainRow(
+        "Quality",
+        currentQuality?.label || "Auto",
+        () => this.showPanel("quality")
+      );
+      this.panel.appendChild(qualityRow);
+    }
+    const textTracks = this.api.getState("textTracks") || [];
+    if (textTracks.length > 0) {
+      const currentTextTrack = this.api.getState("currentTextTrack");
+      const captionsLabel = currentTextTrack ? currentTextTrack.label : "Off";
+      const captionsRow = this.createMainRow(
+        "Captions",
+        captionsLabel,
+        () => this.showPanel("captions")
+      );
+      this.panel.appendChild(captionsRow);
+    }
+    const speedLabel = playbackRate === 1 ? "Normal" : `${playbackRate}x`;
+    const speedRow = this.createMainRow(
+      "Speed",
+      speedLabel,
+      () => this.showPanel("speed")
+    );
+    this.panel.appendChild(speedRow);
+  }
+  createMainRow(label, value, onClick2) {
+    const row = createElement("div", { className: "sp-settings-panel__row" });
+    row.setAttribute("role", "menuitem");
+    row.setAttribute("tabindex", "0");
+    row.setAttribute("aria-haspopup", "true");
+    const labelEl = createElement("span", { className: "sp-settings-panel__label" });
+    labelEl.textContent = label;
+    const rightSide = createElement("span", { className: "sp-settings-panel__value" });
+    rightSide.textContent = value;
+    const arrow = createElement("span", { className: "sp-settings-panel__arrow" });
+    arrow.innerHTML = icons.chevronDown;
+    rightSide.appendChild(arrow);
+    row.appendChild(labelEl);
+    row.appendChild(rightSide);
+    row.addEventListener("click", (e) => {
+      e.preventDefault();
+      onClick2();
+    });
+    row.addEventListener("keydown", (e) => {
+      if (e.key === "Enter" || e.key === " ") {
+        e.preventDefault();
+        onClick2();
+      }
+    });
+    return row;
+  }
+  renderQualityPanel() {
+    this.panel.innerHTML = "";
+    this.panel.className = "sp-settings-panel sp-settings-panel--open sp-settings-panel--sub";
+    const header = this.createSubHeader("Quality");
+    this.panel.appendChild(header);
+    const qualities = this.api.getState("qualities") || [];
+    const currentQuality = this.api.getState("currentQuality");
+    const activeId = currentQuality?.id || "auto";
+    const autoItem = this.createMenuItem("Auto", "auto", activeId === "auto");
+    autoItem.addEventListener("click", (e) => {
+      e.preventDefault();
+      this.selectQuality("auto");
+    });
+    this.panel.appendChild(autoItem);
+    const sorted = [...qualities].sort(
+      (a, b) => b.height - a.height
+    );
+    for (const q of sorted) {
+      if (q.id === "auto") continue;
+      const item = this.createMenuItem(q.label, q.id, q.id === activeId);
+      item.addEventListener("click", (e) => {
+        e.preventDefault();
+        this.selectQuality(q.id);
+      });
+      this.panel.appendChild(item);
+    }
+  }
+  renderSpeedPanel() {
+    this.panel.innerHTML = "";
+    this.panel.className = "sp-settings-panel sp-settings-panel--open sp-settings-panel--sub";
+    const header = this.createSubHeader("Speed");
+    this.panel.appendChild(header);
+    const currentRate = this.api.getState("playbackRate") ?? 1;
+    for (const opt of SPEED_OPTIONS) {
+      const isActive = Math.abs(currentRate - opt.value) < 0.01;
+      const item = this.createMenuItem(opt.label, String(opt.value), isActive);
+      item.addEventListener("click", (e) => {
+        e.preventDefault();
+        this.selectSpeed(opt.value);
+      });
+      this.panel.appendChild(item);
+    }
+  }
+  renderCaptionsPanel() {
+    this.panel.innerHTML = "";
+    this.panel.className = "sp-settings-panel sp-settings-panel--open sp-settings-panel--sub";
+    const header = this.createSubHeader("Captions");
+    this.panel.appendChild(header);
+    const textTracks = this.api.getState("textTracks") || [];
+    const currentTextTrack = this.api.getState("currentTextTrack");
+    const activeId = currentTextTrack?.id || "off";
+    const offItem = this.createMenuItem("Off", "off", activeId === "off");
+    offItem.addEventListener("click", (e) => {
+      e.preventDefault();
+      this.selectCaption(null);
+    });
+    this.panel.appendChild(offItem);
+    for (const track of textTracks) {
+      const item = this.createMenuItem(track.label, track.id, track.id === activeId);
+      item.addEventListener("click", (e) => {
+        e.preventDefault();
+        this.selectCaption(track.id);
+      });
+      this.panel.appendChild(item);
+    }
+  }
+  selectCaption(trackId) {
+    this.api.emit("track:text", { trackId });
+    this.close();
+  }
+  updateCaptionsActiveStates() {
+    const currentTextTrack = this.api.getState("currentTextTrack");
+    const activeId = currentTextTrack?.id || "off";
+    const items = this.panel.querySelectorAll(".sp-settings-panel__item");
+    items.forEach((item) => {
+      const id = item.getAttribute("data-id");
+      item.classList.toggle("sp-settings-panel__item--active", id === activeId);
+    });
+  }
+  createSubHeader(title) {
+    const header = createElement("div", { className: "sp-settings-panel__header" });
+    header.setAttribute("role", "menuitem");
+    header.setAttribute("tabindex", "0");
+    const backArrow = createElement("span", { className: "sp-settings-panel__back" });
+    backArrow.innerHTML = icons.chevronUp;
+    const label = createElement("span", { className: "sp-settings-panel__header-label" });
+    label.textContent = title;
+    header.appendChild(backArrow);
+    header.appendChild(label);
+    header.addEventListener("click", (e) => {
+      e.preventDefault();
+      this.showPanel("main");
+    });
+    header.addEventListener("keydown", (e) => {
+      if (e.key === "Enter" || e.key === " ") {
+        e.preventDefault();
+        this.showPanel("main");
+      }
+    });
+    return header;
+  }
+  createMenuItem(label, dataId, isActive) {
+    const item = createElement("div", {
+      className: `sp-settings-panel__item${isActive ? " sp-settings-panel__item--active" : ""}`
+    });
+    item.setAttribute("role", "menuitem");
+    item.setAttribute("tabindex", "0");
+    item.setAttribute("data-id", dataId);
+    const labelEl = createElement("span");
+    labelEl.textContent = label;
+    const check = createElement("span", { className: "sp-settings-panel__check" });
+    check.innerHTML = icons.checkmark;
+    item.appendChild(labelEl);
+    item.appendChild(check);
+    item.addEventListener("keydown", (e) => {
+      if (e.key === "Enter" || e.key === " ") {
+        e.preventDefault();
+        item.click();
+      }
+    });
+    return item;
+  }
+  selectQuality(qualityId) {
+    this.api.emit("quality:select", {
+      quality: qualityId,
+      auto: qualityId === "auto"
+    });
+    this.close();
+  }
+  selectSpeed(rate) {
+    this.api.emit("playback:ratechange", { rate });
+    const video = this.api.container.querySelector("video");
+    if (video) {
+      video.playbackRate = rate;
+    }
+    this.close();
+  }
+  updateQualityActiveStates() {
+    const currentQuality = this.api.getState("currentQuality");
+    const activeId = currentQuality?.id || "auto";
+    const items = this.panel.querySelectorAll(".sp-settings-panel__item");
+    items.forEach((item) => {
+      const id = item.getAttribute("data-id");
+      item.classList.toggle("sp-settings-panel__item--active", id === activeId);
+    });
+  }
+  updateSpeedActiveStates() {
+    const currentRate = this.api.getState("playbackRate") ?? 1;
+    const items = this.panel.querySelectorAll(".sp-settings-panel__item");
+    items.forEach((item) => {
+      const id = item.getAttribute("data-id");
+      const value = parseFloat(id || "1");
+      item.classList.toggle(
+        "sp-settings-panel__item--active",
+        Math.abs(currentRate - value) < 0.01
+      );
+    });
+  }
+  getPanel() {
+    return this.currentPanel;
+  }
+  isMenuOpen() {
+    return this.isOpen;
+  }
+  destroy() {
+    document.removeEventListener("click", this.closeHandler);
+    document.removeEventListener("keydown", this.keyHandler);
+    this.el.remove();
+  }
+};
+var DEFAULT_SKIP_SECONDS = 10;
+var SkipButton = class {
+  constructor(api, direction, seconds = DEFAULT_SKIP_SECONDS) {
+    this.clickHandler = () => {
+      this.skip();
+    };
+    this.api = api;
+    this.direction = direction;
+    this.seconds = seconds;
+    const icon = direction === "backward" ? icons.replay10 : icons.forward10;
+    const label = direction === "backward" ? `Rewind ${seconds} seconds` : `Forward ${seconds} seconds`;
+    this.el = createButton(
+      `sp-skip sp-skip--${direction}`,
+      label,
+      icon
+    );
+    this.el.addEventListener("click", this.clickHandler);
+  }
+  render() {
+    return this.el;
+  }
+  update() {
+    const live = this.api.getState("live");
+    const duration = this.api.getState("duration") ?? 0;
+    const seekableRange = this.api.getState("seekableRange");
+    if (live && !seekableRange) {
+      this.el.style.display = "none";
+      return;
+    }
+    if (live && seekableRange) {
+      this.el.style.display = "";
+      return;
+    }
+    if (duration === 0) {
+      this.el.style.display = "none";
+      return;
+    }
+    this.el.style.display = "";
+  }
+  skip() {
+    const video = getVideo(this.api.container);
+    if (!video) return;
+    const live = this.api.getState("live");
+    const seekableRange = this.api.getState("seekableRange");
+    if (live && seekableRange) {
+      if (this.direction === "backward") {
+        video.currentTime = Math.max(seekableRange.start, video.currentTime - this.seconds);
+      } else {
+        video.currentTime = Math.min(seekableRange.end, video.currentTime + this.seconds);
+      }
+      return;
+    }
+    const duration = video.duration || 0;
+    if (!duration || !isFinite(duration)) return;
+    if (this.direction === "backward") {
+      video.currentTime = Math.max(0, video.currentTime - this.seconds);
+    } else {
+      video.currentTime = Math.min(duration, video.currentTime + this.seconds);
+    }
+  }
+  destroy() {
+    this.el.removeEventListener("click", this.clickHandler);
+    this.el.remove();
+  }
+};
+var CaptionsButton = class {
+  constructor(api) {
+    this.clickHandler = () => {
+      this.toggle();
+    };
+    this.api = api;
+    this.el = createButton("sp-captions", "Captions", icons.captionsOff);
+    this.el.addEventListener("click", this.clickHandler);
+  }
+  render() {
+    return this.el;
+  }
+  update() {
+    const textTracks = this.api.getState("textTracks") || [];
+    const currentTrack = this.api.getState("currentTextTrack");
+    if (textTracks.length === 0) {
+      this.el.style.display = "none";
+      return;
+    }
+    this.el.style.display = "";
+    if (currentTrack) {
+      this.el.innerHTML = icons.captions;
+      this.el.setAttribute("aria-label", `Captions: ${currentTrack.label}`);
+      this.el.classList.add("sp-captions--active");
+    } else {
+      this.el.innerHTML = icons.captionsOff;
+      this.el.setAttribute("aria-label", "Captions");
+      this.el.classList.remove("sp-captions--active");
+    }
+  }
+  toggle() {
+    const textTracks = this.api.getState("textTracks") || [];
+    const currentTrack = this.api.getState("currentTextTrack");
+    if (textTracks.length === 0) return;
+    if (currentTrack) {
+      this.api.emit("track:text", { trackId: null });
+    } else {
+      this.api.emit("track:text", { trackId: textTracks[0].id });
+    }
+  }
+  destroy() {
+    this.el.removeEventListener("click", this.clickHandler);
+    this.el.remove();
+  }
+};
 var DEFAULT_LAYOUT = [
   "play",
+  "skip-backward",
+  "skip-forward",
   "volume",
   "time",
   "live-indicator",
   "spacer",
-  "quality",
+  "settings",
+  "captions",
   "chromecast",
   "airplay",
   "pip",
@@ -2025,10 +3171,12 @@ function uiPlugin(config = {}) {
   let gradient = null;
   let progressBar = null;
   let bufferingIndicator = null;
+  let errorOverlay = null;
   let styleEl = null;
   let controls = [];
   let hideTimeout = null;
   let stateUnsubscribe = null;
+  let errorUnsubscribe = null;
   let controlsVisible = true;
   const layout = config.controls || DEFAULT_LAYOUT;
   const hideDelay = config.hideDelay ?? DEFAULT_HIDE_DELAY;
@@ -2036,6 +3184,10 @@ function uiPlugin(config = {}) {
     switch (slot) {
       case "play":
         return new PlayButton(api);
+      case "skip-backward":
+        return new SkipButton(api, "backward");
+      case "skip-forward":
+        return new SkipButton(api, "forward");
       case "volume":
         return new VolumeControl(api);
       case "progress":
@@ -2046,6 +3198,10 @@ function uiPlugin(config = {}) {
         return new LiveIndicator(api);
       case "quality":
         return new QualityMenu(api);
+      case "settings":
+        return new SettingsMenu(api);
+      case "captions":
+        return new CaptionsButton(api);
       case "chromecast":
         return new CastButton(api, "chromecast");
       case "airplay":
@@ -2069,6 +3225,7 @@ function uiPlugin(config = {}) {
     const isLoading = playbackState === "loading";
     const showSpinner = waiting || seeking && !api?.getState("paused") || isLoading;
     bufferingIndicator?.classList.toggle("sp-buffering--visible", !!showSpinner);
+    errorOverlay?.update();
   };
   const showControls = () => {
     if (controlsVisible) {
@@ -2107,8 +3264,14 @@ function uiPlugin(config = {}) {
   };
   const handleKeyDown = (e) => {
     if (!api.container.contains(document.activeElement)) return;
+    const activeEl = document.activeElement;
+    if (activeEl instanceof HTMLInputElement || activeEl instanceof HTMLTextAreaElement || activeEl instanceof HTMLSelectElement || activeEl?.isContentEditable) {
+      return;
+    }
     const video = api.container.querySelector("video");
     if (!video) return;
+    const live = api.getState("live");
+    const seekableRange = api.getState("seekableRange");
     switch (e.key) {
       case " ":
       case "k":
@@ -2129,12 +3292,20 @@ function uiPlugin(config = {}) {
         break;
       case "ArrowLeft":
         e.preventDefault();
-        video.currentTime = Math.max(0, video.currentTime - 5);
+        if (live && seekableRange) {
+          video.currentTime = Math.max(seekableRange.start, video.currentTime - 5);
+        } else {
+          video.currentTime = Math.max(0, video.currentTime - 5);
+        }
         showControls();
         break;
       case "ArrowRight":
         e.preventDefault();
-        video.currentTime = Math.min(video.duration || 0, video.currentTime + 5);
+        if (live && seekableRange) {
+          video.currentTime = Math.min(seekableRange.end, video.currentTime + 5);
+        } else {
+          video.currentTime = Math.min(video.duration || 0, video.currentTime + 5);
+        }
         showControls();
         break;
       case "ArrowUp":
@@ -2171,19 +3342,30 @@ function uiPlugin(config = {}) {
       if (containerStyle.position === "static") {
         container.style.position = "relative";
       }
+      const isPlaying = api.getState("playing");
       gradient = document.createElement("div");
-      gradient.className = "sp-gradient sp-gradient--visible";
+      gradient.className = isPlaying ? "sp-gradient" : "sp-gradient sp-gradient--visible";
       container.appendChild(gradient);
       bufferingIndicator = document.createElement("div");
       bufferingIndicator.className = "sp-buffering";
       bufferingIndicator.innerHTML = icons.spinner;
       bufferingIndicator.setAttribute("aria-hidden", "true");
       container.appendChild(bufferingIndicator);
+      errorOverlay = new ErrorOverlay(api);
+      container.appendChild(errorOverlay.render());
+      errorUnsubscribe = api.on("error", (payload) => {
+        if (payload?.fatal) {
+          const error = api.getState("error") || new Error(payload.message || "Playback error");
+          errorOverlay?.show(error);
+        }
+      });
       progressBar = new ProgressBar(api);
       container.appendChild(progressBar.render());
-      progressBar.show();
+      if (!isPlaying) {
+        progressBar.show();
+      }
       controlBar = document.createElement("div");
-      controlBar.className = "sp-controls sp-controls--visible";
+      controlBar.className = isPlaying ? "sp-controls sp-controls--hidden" : "sp-controls sp-controls--visible";
       controlBar.setAttribute("role", "toolbar");
       controlBar.setAttribute("aria-label", "Video controls");
       for (const slot of layout) {
@@ -2206,6 +3388,11 @@ function uiPlugin(config = {}) {
       if (!container.hasAttribute("tabindex")) {
         container.setAttribute("tabindex", "0");
       }
+      controlsVisible = !isPlaying;
+      api.setState("controlsVisible", controlsVisible);
+      if (isPlaying) {
+        resetHideTimer();
+      }
       api.logger.debug("UI controls plugin initialized");
     },
     async destroy() {
@@ -2215,6 +3402,8 @@ function uiPlugin(config = {}) {
       }
       stateUnsubscribe?.();
       stateUnsubscribe = null;
+      errorUnsubscribe?.();
+      errorUnsubscribe = null;
       if (api?.container) {
         api.container.removeEventListener("mousemove", handleInteraction);
         api.container.removeEventListener("mouseenter", handleInteraction);
@@ -2228,6 +3417,8 @@ function uiPlugin(config = {}) {
       controls = [];
       progressBar?.destroy();
       progressBar = null;
+      errorOverlay?.destroy();
+      errorOverlay = null;
       controlBar?.remove();
       controlBar = null;
       gradient?.remove();
@@ -4311,6 +5502,8 @@ const DEFAULT_STATE = {
   airplayActive: false,
   chromecastAvailable: false,
   chromecastActive: false,
+  // Thumbnail Preview
+  thumbnails: null,
   // UI State
   interacting: false,
   hovering: false,