@lightbird/core 0.5.0 → 0.7.0

package/dist/index.cjs

@@ -239,6 +239,121 @@ function parseVttTimestamp(ts) {
   return NaN;
 }
 
+// src/utils/language-names.ts
+var LANGUAGE_NAMES = {
+  // English
+  en: "English",
+  eng: "English",
+  // Japanese
+  ja: "Japanese",
+  jpn: "Japanese",
+  // Chinese
+  zh: "Chinese",
+  chi: "Chinese",
+  zho: "Chinese",
+  // Korean
+  ko: "Korean",
+  kor: "Korean",
+  // French
+  fr: "French",
+  fre: "French",
+  fra: "French",
+  // German
+  de: "German",
+  ger: "German",
+  deu: "German",
+  // Spanish
+  es: "Spanish",
+  spa: "Spanish",
+  // Italian
+  it: "Italian",
+  ita: "Italian",
+  // Portuguese
+  pt: "Portuguese",
+  por: "Portuguese",
+  // Russian
+  ru: "Russian",
+  rus: "Russian",
+  // Dutch
+  nl: "Dutch",
+  dut: "Dutch",
+  nld: "Dutch",
+  // Polish
+  pl: "Polish",
+  pol: "Polish",
+  // Arabic
+  ar: "Arabic",
+  ara: "Arabic",
+  // Hindi
+  hi: "Hindi",
+  hin: "Hindi",
+  // Bengali
+  bn: "Bengali",
+  ben: "Bengali",
+  // Turkish
+  tr: "Turkish",
+  tur: "Turkish",
+  // Swedish
+  sv: "Swedish",
+  swe: "Swedish",
+  // Norwegian
+  no: "Norwegian",
+  nor: "Norwegian",
+  // Danish
+  da: "Danish",
+  dan: "Danish",
+  // Finnish
+  fi: "Finnish",
+  fin: "Finnish",
+  // Greek
+  el: "Greek",
+  gre: "Greek",
+  ell: "Greek",
+  // Hebrew
+  he: "Hebrew",
+  heb: "Hebrew",
+  // Thai
+  th: "Thai",
+  tha: "Thai",
+  // Vietnamese
+  vi: "Vietnamese",
+  vie: "Vietnamese",
+  // Indonesian
+  id: "Indonesian",
+  ind: "Indonesian",
+  // Malay
+  ms: "Malay",
+  may: "Malay",
+  msa: "Malay",
+  // Czech
+  cs: "Czech",
+  cze: "Czech",
+  ces: "Czech",
+  // Hungarian
+  hu: "Hungarian",
+  hun: "Hungarian",
+  // Romanian
+  ro: "Romanian",
+  rum: "Romanian",
+  ron: "Romanian",
+  // Ukrainian
+  uk: "Ukrainian",
+  ukr: "Ukrainian",
+  // Tamil
+  ta: "Tamil",
+  tam: "Tamil",
+  // Telugu
+  te: "Telugu",
+  tel: "Telugu"
+};
+var UNDETERMINED = /* @__PURE__ */ new Set(["", "und", "unknown", "mis", "zxx", "mul"]);
+function getLanguageName(code) {
+  if (!code) return void 0;
+  const normalized = code.trim().toLowerCase();
+  if (UNDETERMINED.has(normalized)) return void 0;
+  return LANGUAGE_NAMES[normalized] ?? code.trim();
+}
+
 // src/players/mkv-player.ts
 async function canPlayNatively(objectUrl, timeoutMs = 3e3) {
   return new Promise((resolve) => {
@@ -267,23 +382,76 @@ function parseStreamInfo(logs) {
   const videoTracks = [];
   const audioTracks = [];
   const subtitleTracks = [];
+  let current = null;
   const lines = logs.split("\n");
   for (const line of lines) {
-    const streamMatch = line.match(/Stream #\d+:\d+(?:\((\w+)\))?: (Video|Audio|Subtitle): (\S+)/i);
-    if (!streamMatch) continue;
-    const [, lang, type, codec] = streamMatch;
-    const titleMatch = line.match(/\btitle\s*:\s*([^,\n]+)/i);
-    const title = titleMatch ? titleMatch[1].trim() : void 0;
-    if (type.toLowerCase() === "video") {
-      videoTracks.push({ index: videoTracks.length, type: "video", codec, lang, title });
-    } else if (type.toLowerCase() === "audio") {
-      audioTracks.push({ index: audioTracks.length, type: "audio", codec, lang, title });
-    } else if (type.toLowerCase() === "subtitle") {
-      subtitleTracks.push({ index: subtitleTracks.length, type: "subtitle", codec, lang, title });
+    if (/^\s*Stream #\d+:\d+/.test(line)) {
+      current = null;
+    }
+    const streamMatch = line.match(
+      /Stream #\d+:\d+(?:\((\w+)\))?: (Video|Audio|Subtitle): (.+)$/i
+    );
+    if (streamMatch) {
+      const [, lang, type, rest] = streamMatch;
+      const codec = rest.trim().split(/[\s,]/)[0];
+      const forced = /\(forced\)/i.test(rest);
+      const isDefault = /\(default\)/i.test(rest);
+      const t = type.toLowerCase();
+      const bucket = t === "video" ? videoTracks : t === "audio" ? audioTracks : subtitleTracks;
+      current = {
+        index: bucket.length,
+        type: t,
+        codec,
+        lang,
+        forced,
+        default: isDefault
+      };
+      bucket.push(current);
+      continue;
+    }
+    if (/^\s*(Chapter #|Program )/i.test(line)) {
+      current = null;
+      continue;
+    }
+    if (current && current.title === void 0) {
+      const titleMatch = line.match(/^\s*title\s*:\s*(.+)$/i);
+      if (titleMatch) {
+        current.title = titleMatch[1].trim();
+      }
     }
   }
   return { videoTracks, audioTracks, subtitleTracks };
 }
+function formatTrackName(index, t) {
+  let label = t.title?.trim() || `Track ${index + 1}`;
+  const langName = getLanguageName(t.lang);
+  if (langName) label += ` - [${langName}]`;
+  if (t.forced) label += " [Forced]";
+  return label;
+}
+function buildAudioTracks(tracks) {
+  if (tracks.length === 0) {
+    return [{ id: "0", name: "Default Audio", lang: "unknown" }];
+  }
+  return tracks.map((t, i) => ({
+    id: String(i),
+    name: formatTrackName(i, t),
+    lang: t.lang ?? "unknown"
+  }));
+}
+function buildSubtitleTracks(tracks, trackMap) {
+  trackMap.clear();
+  return tracks.map((t, i) => {
+    const id = String(i);
+    trackMap.set(id, i);
+    return {
+      id,
+      name: formatTrackName(i, t),
+      lang: t.lang ?? "unknown",
+      type: "embedded"
+    };
+  });
+}
 var _MKVPlayer = class _MKVPlayer {
   constructor(file, onProgress) {
     this.videoElement = null;
@@ -402,22 +570,11 @@ var _MKVPlayer = class _MKVPlayer {
       });
       const { audioTracks, subtitleTracks } = parseStreamInfo(result.logs);
       this.chapters = parseChaptersFromFFmpegLog(result.logs, videoElement.duration || 0);
-      this.playerFile.audioTracks = audioTracks.length > 0 ? audioTracks.map((t, i) => ({
-        id: String(i),
-        name: t.title ?? (t.lang ? `Audio ${i + 1} (${t.lang})` : `Audio ${i + 1}`),
-        lang: t.lang ?? "unknown"
-      })) : [{ id: "0", name: "Default Audio", lang: "unknown" }];
-      this.subtitleTrackMap.clear();
-      this.playerFile.subtitleTracks = subtitleTracks.map((t, i) => {
-        const id = String(i);
-        this.subtitleTrackMap.set(id, i);
-        return {
-          id,
-          name: t.title ?? (t.lang ? `Subtitle ${i + 1} (${t.lang})` : `Subtitle ${i + 1}`),
-          lang: t.lang ?? "unknown",
-          type: "embedded"
-        };
-      });
+      this.playerFile.audioTracks = buildAudioTracks(audioTracks);
+      this.playerFile.subtitleTracks = buildSubtitleTracks(
+        subtitleTracks,
+        this.subtitleTrackMap
+      );
       const blob = new Blob([result.data], { type: "video/mp4" });
       const url = URL.createObjectURL(blob);
       this.remuxCache.set(0, url);
@@ -448,22 +605,11 @@ var _MKVPlayer = class _MKVPlayer {
     });
     if (this._cancelled) return;
     const { audioTracks, subtitleTracks } = parseStreamInfo(probeResult.logs);
-    this.playerFile.audioTracks = audioTracks.length > 0 ? audioTracks.map((t, i) => ({
-      id: String(i),
-      name: t.title ?? (t.lang ? `Audio ${i + 1} (${t.lang})` : `Audio ${i + 1}`),
-      lang: t.lang ?? "unknown"
-    })) : [{ id: "0", name: "Default Audio", lang: "unknown" }];
-    this.subtitleTrackMap.clear();
-    this.playerFile.subtitleTracks = subtitleTracks.map((t, i) => {
-      const id = String(i);
-      this.subtitleTrackMap.set(id, i);
-      return {
-        id,
-        name: t.title ?? (t.lang ? `Subtitle ${i + 1} (${t.lang})` : `Subtitle ${i + 1}`),
-        lang: t.lang ?? "unknown",
-        type: "embedded"
-      };
-    });
+    this.playerFile.audioTracks = buildAudioTracks(audioTracks);
+    this.playerFile.subtitleTracks = buildSubtitleTracks(
+      subtitleTracks,
+      this.subtitleTrackMap
+    );
   }
   async _remux(audioTrackIndex) {
     const cached = this.remuxCache.get(audioTrackIndex);
@@ -1484,7 +1630,11 @@ var DEFAULT_SHORTCUTS = [
   { action: "screenshot", label: "Screenshot", defaultKey: "s", key: "s", modifiers: { ctrl: true } },
   { action: "show-shortcuts", label: "Show Shortcuts Help", defaultKey: "?", key: "?" },
   { action: "next-chapter", label: "Next Chapter", defaultKey: "]", key: "]" },
-  { action: "prev-chapter", label: "Previous Chapter", defaultKey: "[", key: "[" }
+  { action: "prev-chapter", label: "Previous Chapter", defaultKey: "[", key: "[" },
+  { action: "frame-step-forward", label: "Step Forward One Frame", defaultKey: ".", key: "." },
+  { action: "frame-step-backward", label: "Step Backward One Frame", defaultKey: ",", key: "," },
+  { action: "loop-toggle", label: "Toggle Loop", defaultKey: "l", key: "l" },
+  { action: "ab-loop-cycle", label: "A-B Loop (Set/Cycle)", defaultKey: "r", key: "r" }
 ];
 var STORAGE_KEY = "lightbird-shortcuts";
 function loadShortcuts() {
@@ -1518,7 +1668,14 @@ function matchesShortcut(e, binding) {
 function isInteractiveElement(el) {
   if (!el || !(el instanceof HTMLElement)) return false;
   const tag = el.tagName.toLowerCase();
-  return ["input", "textarea", "select", "button", "a"].includes(tag) || el.contentEditable === "true" || el.getAttribute("contenteditable") !== null;
+  if (["input", "textarea", "select"].includes(tag)) return true;
+  if (el.contentEditable === "true" || el.getAttribute("contenteditable") !== null) return true;
+  if (typeof el.closest === "function" && el.closest(
+    '[role="dialog"], [role="alertdialog"], [role="menu"], [data-radix-popper-content-wrapper]'
+  )) {
+    return true;
+  }
+  return false;
 }
 function formatShortcutKey(binding) {
   const mods = [];
@@ -1620,6 +1777,7 @@ exports.exportPlaylist = exportPlaylist;
 exports.extractNativeMetadata = extractNativeMetadata;
 exports.formatShortcutKey = formatShortcutKey;
 exports.getFFmpeg = getFFmpeg;
+exports.getLanguageName = getLanguageName;
 exports.getVideoFiles = getVideoFiles;
 exports.getWebTorrentClient = getWebTorrentClient;
 exports.hasAcceptedDisclaimer = hasAcceptedDisclaimer;

package/dist/index.d.cts

@@ -388,7 +388,7 @@ declare function captureVideoThumbnail(videoEl: HTMLVideoElement, atSeconds?: nu
  */
 declare function captureFrameAt(videoEl: HTMLVideoElement, timeSeconds: number, width?: number, height?: number): Promise<string | null>;
 
-type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter';
+type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter' | 'frame-step-forward' | 'frame-step-backward' | 'loop-toggle' | 'ab-loop-cycle';
 interface ShortcutBinding {
     action: ShortcutAction;
     label: string;
@@ -441,4 +441,13 @@ declare class ProgressEstimator {
 declare function getFFmpeg(): Promise<FFmpeg>;
 declare function resetFFmpeg(): void;
 
-export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, type HLSPlayerFile, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type QualityLevel, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+/**
+ * Resolve an ISO 639 language code to its English language name, mirroring how
+ * VLC labels tracks.
+ *
+ * @returns The full language name, or the original code if it's unrecognised
+ *          (VLC behaviour), or `undefined` if the code is absent/undetermined.
+ */
+declare function getLanguageName(code?: string | null): string | undefined;
+
+export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, type HLSPlayerFile, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type QualityLevel, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getLanguageName, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/index.d.ts

@@ -388,7 +388,7 @@ declare function captureVideoThumbnail(videoEl: HTMLVideoElement, atSeconds?: nu
  */
 declare function captureFrameAt(videoEl: HTMLVideoElement, timeSeconds: number, width?: number, height?: number): Promise<string | null>;
 
-type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter';
+type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter' | 'frame-step-forward' | 'frame-step-backward' | 'loop-toggle' | 'ab-loop-cycle';
 interface ShortcutBinding {
     action: ShortcutAction;
     label: string;
@@ -441,4 +441,13 @@ declare class ProgressEstimator {
 declare function getFFmpeg(): Promise<FFmpeg>;
 declare function resetFFmpeg(): void;
 
-export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, type HLSPlayerFile, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type QualityLevel, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+/**
+ * Resolve an ISO 639 language code to its English language name, mirroring how
+ * VLC labels tracks.
+ *
+ * @returns The full language name, or the original code if it's unrecognised
+ *          (VLC behaviour), or `undefined` if the code is absent/undetermined.
+ */
+declare function getLanguageName(code?: string | null): string | undefined;
+
+export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, type HLSPlayerFile, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type QualityLevel, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getLanguageName, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/index.js

@@ -236,6 +236,121 @@ function parseVttTimestamp(ts) {
   return NaN;
 }
 
+// src/utils/language-names.ts
+var LANGUAGE_NAMES = {
+  // English
+  en: "English",
+  eng: "English",
+  // Japanese
+  ja: "Japanese",
+  jpn: "Japanese",
+  // Chinese
+  zh: "Chinese",
+  chi: "Chinese",
+  zho: "Chinese",
+  // Korean
+  ko: "Korean",
+  kor: "Korean",
+  // French
+  fr: "French",
+  fre: "French",
+  fra: "French",
+  // German
+  de: "German",
+  ger: "German",
+  deu: "German",
+  // Spanish
+  es: "Spanish",
+  spa: "Spanish",
+  // Italian
+  it: "Italian",
+  ita: "Italian",
+  // Portuguese
+  pt: "Portuguese",
+  por: "Portuguese",
+  // Russian
+  ru: "Russian",
+  rus: "Russian",
+  // Dutch
+  nl: "Dutch",
+  dut: "Dutch",
+  nld: "Dutch",
+  // Polish
+  pl: "Polish",
+  pol: "Polish",
+  // Arabic
+  ar: "Arabic",
+  ara: "Arabic",
+  // Hindi
+  hi: "Hindi",
+  hin: "Hindi",
+  // Bengali
+  bn: "Bengali",
+  ben: "Bengali",
+  // Turkish
+  tr: "Turkish",
+  tur: "Turkish",
+  // Swedish
+  sv: "Swedish",
+  swe: "Swedish",
+  // Norwegian
+  no: "Norwegian",
+  nor: "Norwegian",
+  // Danish
+  da: "Danish",
+  dan: "Danish",
+  // Finnish
+  fi: "Finnish",
+  fin: "Finnish",
+  // Greek
+  el: "Greek",
+  gre: "Greek",
+  ell: "Greek",
+  // Hebrew
+  he: "Hebrew",
+  heb: "Hebrew",
+  // Thai
+  th: "Thai",
+  tha: "Thai",
+  // Vietnamese
+  vi: "Vietnamese",
+  vie: "Vietnamese",
+  // Indonesian
+  id: "Indonesian",
+  ind: "Indonesian",
+  // Malay
+  ms: "Malay",
+  may: "Malay",
+  msa: "Malay",
+  // Czech
+  cs: "Czech",
+  cze: "Czech",
+  ces: "Czech",
+  // Hungarian
+  hu: "Hungarian",
+  hun: "Hungarian",
+  // Romanian
+  ro: "Romanian",
+  rum: "Romanian",
+  ron: "Romanian",
+  // Ukrainian
+  uk: "Ukrainian",
+  ukr: "Ukrainian",
+  // Tamil
+  ta: "Tamil",
+  tam: "Tamil",
+  // Telugu
+  te: "Telugu",
+  tel: "Telugu"
+};
+var UNDETERMINED = /* @__PURE__ */ new Set(["", "und", "unknown", "mis", "zxx", "mul"]);
+function getLanguageName(code) {
+  if (!code) return void 0;
+  const normalized = code.trim().toLowerCase();
+  if (UNDETERMINED.has(normalized)) return void 0;
+  return LANGUAGE_NAMES[normalized] ?? code.trim();
+}
+
 // src/players/mkv-player.ts
 async function canPlayNatively(objectUrl, timeoutMs = 3e3) {
   return new Promise((resolve) => {
@@ -264,23 +379,76 @@ function parseStreamInfo(logs) {
   const videoTracks = [];
   const audioTracks = [];
   const subtitleTracks = [];
+  let current = null;
   const lines = logs.split("\n");
   for (const line of lines) {
-    const streamMatch = line.match(/Stream #\d+:\d+(?:\((\w+)\))?: (Video|Audio|Subtitle): (\S+)/i);
-    if (!streamMatch) continue;
-    const [, lang, type, codec] = streamMatch;
-    const titleMatch = line.match(/\btitle\s*:\s*([^,\n]+)/i);
-    const title = titleMatch ? titleMatch[1].trim() : void 0;
-    if (type.toLowerCase() === "video") {
-      videoTracks.push({ index: videoTracks.length, type: "video", codec, lang, title });
-    } else if (type.toLowerCase() === "audio") {
-      audioTracks.push({ index: audioTracks.length, type: "audio", codec, lang, title });
-    } else if (type.toLowerCase() === "subtitle") {
-      subtitleTracks.push({ index: subtitleTracks.length, type: "subtitle", codec, lang, title });
+    if (/^\s*Stream #\d+:\d+/.test(line)) {
+      current = null;
+    }
+    const streamMatch = line.match(
+      /Stream #\d+:\d+(?:\((\w+)\))?: (Video|Audio|Subtitle): (.+)$/i
+    );
+    if (streamMatch) {
+      const [, lang, type, rest] = streamMatch;
+      const codec = rest.trim().split(/[\s,]/)[0];
+      const forced = /\(forced\)/i.test(rest);
+      const isDefault = /\(default\)/i.test(rest);
+      const t = type.toLowerCase();
+      const bucket = t === "video" ? videoTracks : t === "audio" ? audioTracks : subtitleTracks;
+      current = {
+        index: bucket.length,
+        type: t,
+        codec,
+        lang,
+        forced,
+        default: isDefault
+      };
+      bucket.push(current);
+      continue;
+    }
+    if (/^\s*(Chapter #|Program )/i.test(line)) {
+      current = null;
+      continue;
+    }
+    if (current && current.title === void 0) {
+      const titleMatch = line.match(/^\s*title\s*:\s*(.+)$/i);
+      if (titleMatch) {
+        current.title = titleMatch[1].trim();
+      }
     }
   }
   return { videoTracks, audioTracks, subtitleTracks };
 }
+function formatTrackName(index, t) {
+  let label = t.title?.trim() || `Track ${index + 1}`;
+  const langName = getLanguageName(t.lang);
+  if (langName) label += ` - [${langName}]`;
+  if (t.forced) label += " [Forced]";
+  return label;
+}
+function buildAudioTracks(tracks) {
+  if (tracks.length === 0) {
+    return [{ id: "0", name: "Default Audio", lang: "unknown" }];
+  }
+  return tracks.map((t, i) => ({
+    id: String(i),
+    name: formatTrackName(i, t),
+    lang: t.lang ?? "unknown"
+  }));
+}
+function buildSubtitleTracks(tracks, trackMap) {
+  trackMap.clear();
+  return tracks.map((t, i) => {
+    const id = String(i);
+    trackMap.set(id, i);
+    return {
+      id,
+      name: formatTrackName(i, t),
+      lang: t.lang ?? "unknown",
+      type: "embedded"
+    };
+  });
+}
 var _MKVPlayer = class _MKVPlayer {
   constructor(file, onProgress) {
     this.videoElement = null;
@@ -399,22 +567,11 @@ var _MKVPlayer = class _MKVPlayer {
       });
       const { audioTracks, subtitleTracks } = parseStreamInfo(result.logs);
       this.chapters = parseChaptersFromFFmpegLog(result.logs, videoElement.duration || 0);
-      this.playerFile.audioTracks = audioTracks.length > 0 ? audioTracks.map((t, i) => ({
-        id: String(i),
-        name: t.title ?? (t.lang ? `Audio ${i + 1} (${t.lang})` : `Audio ${i + 1}`),
-        lang: t.lang ?? "unknown"
-      })) : [{ id: "0", name: "Default Audio", lang: "unknown" }];
-      this.subtitleTrackMap.clear();
-      this.playerFile.subtitleTracks = subtitleTracks.map((t, i) => {
-        const id = String(i);
-        this.subtitleTrackMap.set(id, i);
-        return {
-          id,
-          name: t.title ?? (t.lang ? `Subtitle ${i + 1} (${t.lang})` : `Subtitle ${i + 1}`),
-          lang: t.lang ?? "unknown",
-          type: "embedded"
-        };
-      });
+      this.playerFile.audioTracks = buildAudioTracks(audioTracks);
+      this.playerFile.subtitleTracks = buildSubtitleTracks(
+        subtitleTracks,
+        this.subtitleTrackMap
+      );
       const blob = new Blob([result.data], { type: "video/mp4" });
       const url = URL.createObjectURL(blob);
       this.remuxCache.set(0, url);
@@ -445,22 +602,11 @@ var _MKVPlayer = class _MKVPlayer {
     });
     if (this._cancelled) return;
     const { audioTracks, subtitleTracks } = parseStreamInfo(probeResult.logs);
-    this.playerFile.audioTracks = audioTracks.length > 0 ? audioTracks.map((t, i) => ({
-      id: String(i),
-      name: t.title ?? (t.lang ? `Audio ${i + 1} (${t.lang})` : `Audio ${i + 1}`),
-      lang: t.lang ?? "unknown"
-    })) : [{ id: "0", name: "Default Audio", lang: "unknown" }];
-    this.subtitleTrackMap.clear();
-    this.playerFile.subtitleTracks = subtitleTracks.map((t, i) => {
-      const id = String(i);
-      this.subtitleTrackMap.set(id, i);
-      return {
-        id,
-        name: t.title ?? (t.lang ? `Subtitle ${i + 1} (${t.lang})` : `Subtitle ${i + 1}`),
-        lang: t.lang ?? "unknown",
-        type: "embedded"
-      };
-    });
+    this.playerFile.audioTracks = buildAudioTracks(audioTracks);
+    this.playerFile.subtitleTracks = buildSubtitleTracks(
+      subtitleTracks,
+      this.subtitleTrackMap
+    );
   }
   async _remux(audioTrackIndex) {
     const cached = this.remuxCache.get(audioTrackIndex);
@@ -1481,7 +1627,11 @@ var DEFAULT_SHORTCUTS = [
   { action: "screenshot", label: "Screenshot", defaultKey: "s", key: "s", modifiers: { ctrl: true } },
   { action: "show-shortcuts", label: "Show Shortcuts Help", defaultKey: "?", key: "?" },
   { action: "next-chapter", label: "Next Chapter", defaultKey: "]", key: "]" },
-  { action: "prev-chapter", label: "Previous Chapter", defaultKey: "[", key: "[" }
+  { action: "prev-chapter", label: "Previous Chapter", defaultKey: "[", key: "[" },
+  { action: "frame-step-forward", label: "Step Forward One Frame", defaultKey: ".", key: "." },
+  { action: "frame-step-backward", label: "Step Backward One Frame", defaultKey: ",", key: "," },
+  { action: "loop-toggle", label: "Toggle Loop", defaultKey: "l", key: "l" },
+  { action: "ab-loop-cycle", label: "A-B Loop (Set/Cycle)", defaultKey: "r", key: "r" }
 ];
 var STORAGE_KEY = "lightbird-shortcuts";
 function loadShortcuts() {
@@ -1515,7 +1665,14 @@ function matchesShortcut(e, binding) {
 function isInteractiveElement(el) {
   if (!el || !(el instanceof HTMLElement)) return false;
   const tag = el.tagName.toLowerCase();
-  return ["input", "textarea", "select", "button", "a"].includes(tag) || el.contentEditable === "true" || el.getAttribute("contenteditable") !== null;
+  if (["input", "textarea", "select"].includes(tag)) return true;
+  if (el.contentEditable === "true" || el.getAttribute("contenteditable") !== null) return true;
+  if (typeof el.closest === "function" && el.closest(
+    '[role="dialog"], [role="alertdialog"], [role="menu"], [data-radix-popper-content-wrapper]'
+  )) {
+    return true;
+  }
+  return false;
 }
 function formatShortcutKey(binding) {
   const mods = [];
@@ -1592,4 +1749,4 @@ function resetFFmpeg() {
   loading = null;
 }
 
-export { ASSRenderer, CancellationError, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, MKVPlayer, ProgressEstimator, SimplePlayer, SubtitleConverter, UniversalSubtitleManager, VIDEO_EXTENSIONS, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+export { ASSRenderer, CancellationError, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, HLSPlayer, MKVPlayer, ProgressEstimator, SimplePlayer, SubtitleConverter, UniversalSubtitleManager, VIDEO_EXTENSIONS, acceptDisclaimer, applyOffsetToVtt, captureFrameAt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getLanguageName, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isHlsUrl, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/react/index.cjs

@@ -673,7 +673,14 @@ function matchesShortcut(e, binding) {
 function isInteractiveElement(el) {
   if (!el || !(el instanceof HTMLElement)) return false;
   const tag = el.tagName.toLowerCase();
-  return ["input", "textarea", "select", "button", "a"].includes(tag) || el.contentEditable === "true" || el.getAttribute("contenteditable") !== null;
+  if (["input", "textarea", "select"].includes(tag)) return true;
+  if (el.contentEditable === "true" || el.getAttribute("contenteditable") !== null) return true;
+  if (typeof el.closest === "function" && el.closest(
+    '[role="dialog"], [role="alertdialog"], [role="menu"], [data-radix-popper-content-wrapper]'
+  )) {
+    return true;
+  }
+  return false;
 }
 
 // src/react/use-keyboard-shortcuts.ts
@@ -1332,6 +1339,66 @@ function useABLoop(videoRef) {
     clear
   };
 }
+function useSmoothProgress(videoRef, { isPlaying, fallback = 0 }) {
+  const [progress, setProgress] = react.useState(() => {
+    const el = videoRef.current;
+    return el ? el.currentTime : fallback;
+  });
+  const rafRef = react.useRef(null);
+  react.useEffect(() => {
+    const el = videoRef.current;
+    if (!el) {
+      setProgress(fallback);
+      return;
+    }
+    if (!isPlaying) {
+      setProgress(el.currentTime);
+      return;
+    }
+    const isHidden = () => typeof document !== "undefined" && document.visibilityState === "hidden";
+    let cancelled = false;
+    const tick = () => {
+      if (cancelled) return;
+      const current = videoRef.current;
+      if (!current) {
+        setProgress(fallback);
+        stop();
+        return;
+      }
+      setProgress(current.currentTime);
+      rafRef.current = requestAnimationFrame(tick);
+    };
+    const start = () => {
+      if (rafRef.current != null || isHidden()) return;
+      rafRef.current = requestAnimationFrame(tick);
+    };
+    const stop = () => {
+      if (rafRef.current != null) {
+        cancelAnimationFrame(rafRef.current);
+        rafRef.current = null;
+      }
+    };
+    const onVisibility = () => {
+      if (isHidden()) {
+        stop();
+      } else {
+        start();
+      }
+    };
+    start();
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", onVisibility);
+    }
+    return () => {
+      cancelled = true;
+      stop();
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", onVisibility);
+      }
+    };
+  }, [isPlaying, videoRef, fallback]);
+  return progress;
+}
 var SWIPE_THRESHOLD = 10;
 var DOUBLE_TAP_DISTANCE = 40;
 function useTouchGestures(targetRef, handlers, options = {}) {
@@ -1463,6 +1530,7 @@ exports.usePictureInPicture = usePictureInPicture;
 exports.usePlaylist = usePlaylist;
 exports.useProgressPersistence = useProgressPersistence;
 exports.useSeekPreview = useSeekPreview;
+exports.useSmoothProgress = useSmoothProgress;
 exports.useSubtitles = useSubtitles;
 exports.useTouchGestures = useTouchGestures;
 exports.useVideoFilters = useVideoFilters;

package/dist/react/index.d.cts

@@ -183,7 +183,7 @@ declare function usePlaylist(): {
     setCurrentIndex: react.Dispatch<react.SetStateAction<number | null>>;
 };
 
-type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter';
+type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter' | 'frame-step-forward' | 'frame-step-backward' | 'loop-toggle' | 'ab-loop-cycle';
 interface ShortcutBinding {
     action: ShortcutAction;
     label: string;
@@ -335,6 +335,20 @@ interface ABLoopState {
  */
 declare function useABLoop(videoRef: RefObject<HTMLVideoElement | null>): ABLoopState;
 
+interface UseSmoothProgressOptions {
+    isPlaying: boolean;
+    fallback?: number;
+}
+/**
+ * Drives a `progress` value at requestAnimationFrame rate by reading
+ * `videoRef.current.currentTime` each frame while playing. Decouples the
+ * visual seek-bar position from the video element's coarse `timeupdate`
+ * events (~4Hz) so the thumb glides instead of stepping.
+ *
+ * Pauses the rAF loop when not playing or when the tab is hidden.
+ */
+declare function useSmoothProgress(videoRef: RefObject<HTMLVideoElement | null>, { isPlaying, fallback }: UseSmoothProgressOptions): number;
+
 interface TouchGestureHandlers {
     /** Seek relative to the current time by a signed number of seconds. */
     seekBy?: (seconds: number) => void;
@@ -384,4 +398,4 @@ interface TouchGesturesState {
  */
 declare function useTouchGestures(targetRef: RefObject<HTMLElement | null>, handlers: TouchGestureHandlers, options?: UseTouchGesturesOptions): TouchGesturesState;
 
-export { type ABLoopState, type SeekPreviewState, type ShortcutHandlers, type TouchGestureFeedback, type TouchGestureHandlers, type TouchGesturesState, type UseMagnetReturn, type UseMediaSessionOptions, type UseSeekPreviewOptions, type UseSubtitlesOptions, type UseTouchGesturesOptions, useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };
+export { type ABLoopState, type SeekPreviewState, type ShortcutHandlers, type TouchGestureFeedback, type TouchGestureHandlers, type TouchGesturesState, type UseMagnetReturn, type UseMediaSessionOptions, type UseSeekPreviewOptions, type UseSubtitlesOptions, type UseTouchGesturesOptions, useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSmoothProgress, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };

package/dist/react/index.d.ts

@@ -183,7 +183,7 @@ declare function usePlaylist(): {
     setCurrentIndex: react.Dispatch<react.SetStateAction<number | null>>;
 };
 
-type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter';
+type ShortcutAction = 'play-pause' | 'seek-forward-5' | 'seek-backward-5' | 'seek-forward-30' | 'seek-backward-30' | 'volume-up' | 'volume-down' | 'mute' | 'fullscreen' | 'next-item' | 'prev-item' | 'screenshot' | 'show-shortcuts' | 'next-chapter' | 'prev-chapter' | 'frame-step-forward' | 'frame-step-backward' | 'loop-toggle' | 'ab-loop-cycle';
 interface ShortcutBinding {
     action: ShortcutAction;
     label: string;
@@ -335,6 +335,20 @@ interface ABLoopState {
  */
 declare function useABLoop(videoRef: RefObject<HTMLVideoElement | null>): ABLoopState;
 
+interface UseSmoothProgressOptions {
+    isPlaying: boolean;
+    fallback?: number;
+}
+/**
+ * Drives a `progress` value at requestAnimationFrame rate by reading
+ * `videoRef.current.currentTime` each frame while playing. Decouples the
+ * visual seek-bar position from the video element's coarse `timeupdate`
+ * events (~4Hz) so the thumb glides instead of stepping.
+ *
+ * Pauses the rAF loop when not playing or when the tab is hidden.
+ */
+declare function useSmoothProgress(videoRef: RefObject<HTMLVideoElement | null>, { isPlaying, fallback }: UseSmoothProgressOptions): number;
+
 interface TouchGestureHandlers {
     /** Seek relative to the current time by a signed number of seconds. */
     seekBy?: (seconds: number) => void;
@@ -384,4 +398,4 @@ interface TouchGesturesState {
  */
 declare function useTouchGestures(targetRef: RefObject<HTMLElement | null>, handlers: TouchGestureHandlers, options?: UseTouchGesturesOptions): TouchGesturesState;
 
-export { type ABLoopState, type SeekPreviewState, type ShortcutHandlers, type TouchGestureFeedback, type TouchGestureHandlers, type TouchGesturesState, type UseMagnetReturn, type UseMediaSessionOptions, type UseSeekPreviewOptions, type UseSubtitlesOptions, type UseTouchGesturesOptions, useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };
+export { type ABLoopState, type SeekPreviewState, type ShortcutHandlers, type TouchGestureFeedback, type TouchGestureHandlers, type TouchGesturesState, type UseMagnetReturn, type UseMediaSessionOptions, type UseSeekPreviewOptions, type UseSubtitlesOptions, type UseTouchGesturesOptions, useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSmoothProgress, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };

package/dist/react/index.js

@@ -671,7 +671,14 @@ function matchesShortcut(e, binding) {
 function isInteractiveElement(el) {
   if (!el || !(el instanceof HTMLElement)) return false;
   const tag = el.tagName.toLowerCase();
-  return ["input", "textarea", "select", "button", "a"].includes(tag) || el.contentEditable === "true" || el.getAttribute("contenteditable") !== null;
+  if (["input", "textarea", "select"].includes(tag)) return true;
+  if (el.contentEditable === "true" || el.getAttribute("contenteditable") !== null) return true;
+  if (typeof el.closest === "function" && el.closest(
+    '[role="dialog"], [role="alertdialog"], [role="menu"], [data-radix-popper-content-wrapper]'
+  )) {
+    return true;
+  }
+  return false;
 }
 
 // src/react/use-keyboard-shortcuts.ts
@@ -1330,6 +1337,66 @@ function useABLoop(videoRef) {
     clear
   };
 }
+function useSmoothProgress(videoRef, { isPlaying, fallback = 0 }) {
+  const [progress, setProgress] = useState(() => {
+    const el = videoRef.current;
+    return el ? el.currentTime : fallback;
+  });
+  const rafRef = useRef(null);
+  useEffect(() => {
+    const el = videoRef.current;
+    if (!el) {
+      setProgress(fallback);
+      return;
+    }
+    if (!isPlaying) {
+      setProgress(el.currentTime);
+      return;
+    }
+    const isHidden = () => typeof document !== "undefined" && document.visibilityState === "hidden";
+    let cancelled = false;
+    const tick = () => {
+      if (cancelled) return;
+      const current = videoRef.current;
+      if (!current) {
+        setProgress(fallback);
+        stop();
+        return;
+      }
+      setProgress(current.currentTime);
+      rafRef.current = requestAnimationFrame(tick);
+    };
+    const start = () => {
+      if (rafRef.current != null || isHidden()) return;
+      rafRef.current = requestAnimationFrame(tick);
+    };
+    const stop = () => {
+      if (rafRef.current != null) {
+        cancelAnimationFrame(rafRef.current);
+        rafRef.current = null;
+      }
+    };
+    const onVisibility = () => {
+      if (isHidden()) {
+        stop();
+      } else {
+        start();
+      }
+    };
+    start();
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", onVisibility);
+    }
+    return () => {
+      cancelled = true;
+      stop();
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", onVisibility);
+      }
+    };
+  }, [isPlaying, videoRef, fallback]);
+  return progress;
+}
 var SWIPE_THRESHOLD = 10;
 var DOUBLE_TAP_DISTANCE = 40;
 function useTouchGestures(targetRef, handlers, options = {}) {
@@ -1451,4 +1518,4 @@ function useTouchGestures(targetRef, handlers, options = {}) {
   return { feedback };
 }
 
-export { useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };
+export { useABLoop, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSeekPreview, useSmoothProgress, useSubtitles, useTouchGestures, useVideoFilters, useVideoInfo, useVideoPlayback };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightbird/core",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Client-side video player engine. Plays MKV, MP4, WebM with full subtitle, audio track, and chapter support. No server required.",
   "license": "MIT",
   "author": "Punyam Singh",