@lightbird/core 0.4.0 → 0.6.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);
@@ -1412,6 +1558,61 @@ async function captureVideoThumbnail(videoEl, atSeconds = 5) {
     }
   });
 }
+async function captureFrameAt(videoEl, timeSeconds, width = 160, height = 90) {
+  return new Promise((resolve) => {
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+      resolve(null);
+      return;
+    }
+    let settled = false;
+    const cleanup = () => {
+      videoEl.removeEventListener("seeked", onSeeked);
+      videoEl.removeEventListener("error", onError);
+      videoEl.removeEventListener("loadedmetadata", onLoadedMetadata);
+    };
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      resolve(value);
+    };
+    const draw = () => {
+      try {
+        ctx.drawImage(videoEl, 0, 0, width, height);
+        finish(canvas.toDataURL("image/jpeg", 0.6));
+      } catch {
+        finish(null);
+      }
+    };
+    const seekTo = () => {
+      const duration = videoEl.duration || 0;
+      const target = duration > 0 ? Math.max(0, Math.min(timeSeconds, duration)) : Math.max(0, timeSeconds);
+      if (Math.abs(videoEl.currentTime - target) < 0.05) {
+        draw();
+        return;
+      }
+      try {
+        videoEl.currentTime = target;
+      } catch {
+        finish(null);
+      }
+    };
+    const onSeeked = () => draw();
+    const onError = () => finish(null);
+    const onLoadedMetadata = () => seekTo();
+    videoEl.addEventListener("seeked", onSeeked);
+    videoEl.addEventListener("error", onError);
+    if (videoEl.readyState >= 1) {
+      seekTo();
+    } else {
+      videoEl.addEventListener("loadedmetadata", onLoadedMetadata, { once: true });
+    }
+  });
+}
 
 // src/utils/keyboard-shortcuts.ts
 var DEFAULT_SHORTCUTS = [
@@ -1555,6 +1756,7 @@ exports.UniversalSubtitleManager = UniversalSubtitleManager;
 exports.VIDEO_EXTENSIONS = VIDEO_EXTENSIONS;
 exports.acceptDisclaimer = acceptDisclaimer;
 exports.applyOffsetToVtt = applyOffsetToVtt;
+exports.captureFrameAt = captureFrameAt;
 exports.captureVideoThumbnail = captureVideoThumbnail;
 exports.configureLightBird = configureLightBird;
 exports.createOffsetVttUrl = createOffsetVttUrl;
@@ -1564,6 +1766,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

@@ -372,6 +372,21 @@ declare function validateFile(file: File): {
 declare function extractNativeMetadata(videoEl: HTMLVideoElement, file?: File): Partial<VideoMetadata>;
 
 declare function captureVideoThumbnail(videoEl: HTMLVideoElement, atSeconds?: number): Promise<string | null>;
+/**
+ * Capture a single video frame at a specific timestamp.
+ *
+ * Unlike {@link captureVideoThumbnail}, this does not save/restore
+ * `currentTime` — it is built for a dedicated, offscreen preview video so the
+ * main playback element is never disturbed. Powers seek-bar hover previews.
+ *
+ * @param videoEl - A video element (typically offscreen) to seek and capture.
+ * @param timeSeconds - Timestamp to capture, clamped to the video duration.
+ * @param width - Output thumbnail width in pixels.
+ * @param height - Output thumbnail height in pixels.
+ * @returns A JPEG data URL, or `null` if capture failed (no 2d context, a
+ *          tainted canvas, or a media error).
+ */
+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';
 interface ShortcutBinding {
@@ -426,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, 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

@@ -372,6 +372,21 @@ declare function validateFile(file: File): {
 declare function extractNativeMetadata(videoEl: HTMLVideoElement, file?: File): Partial<VideoMetadata>;
 
 declare function captureVideoThumbnail(videoEl: HTMLVideoElement, atSeconds?: number): Promise<string | null>;
+/**
+ * Capture a single video frame at a specific timestamp.
+ *
+ * Unlike {@link captureVideoThumbnail}, this does not save/restore
+ * `currentTime` — it is built for a dedicated, offscreen preview video so the
+ * main playback element is never disturbed. Powers seek-bar hover previews.
+ *
+ * @param videoEl - A video element (typically offscreen) to seek and capture.
+ * @param timeSeconds - Timestamp to capture, clamped to the video duration.
+ * @param width - Output thumbnail width in pixels.
+ * @param height - Output thumbnail height in pixels.
+ * @returns A JPEG data URL, or `null` if capture failed (no 2d context, a
+ *          tainted canvas, or a media error).
+ */
+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';
 interface ShortcutBinding {
@@ -426,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, 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 };