@scarlett-player/native 0.1.2 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hackney Enterprises Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -25,15 +25,26 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_core = require("@scarlett-player/core");
-var SUPPORTED_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "ogg", "m4v"];
+var VIDEO_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "m4v"];
+var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "aac", "m4a", "opus", "weba"];
+var SUPPORTED_EXTENSIONS = [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS];
 var MIME_TYPES = {
+  // Video
   mp4: "video/mp4",
   m4v: "video/mp4",
   webm: "video/webm",
   mov: "video/quicktime",
   mkv: "video/x-matroska",
   ogv: "video/ogg",
-  ogg: "video/ogg"
+  // Audio
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  m4a: "audio/mp4",
+  opus: "audio/opus",
+  weba: "audio/webm"
 };
 function createNativePlugin(config) {
   const preload = config?.preload ?? "metadata";
@@ -54,9 +65,13 @@ function createNativePlugin(config) {
   const getMimeType = (ext) => {
     return MIME_TYPES[ext] || "video/mp4";
   };
+  const isAudioExtension = (ext) => {
+    return AUDIO_EXTENSIONS.includes(ext);
+  };
   const canBrowserPlay = (mimeType) => {
-    const testVideo = document.createElement("video");
-    const canPlay = testVideo.canPlayType(mimeType);
+    const isAudio = mimeType.startsWith("audio/");
+    const testElement = isAudio ? document.createElement("audio") : document.createElement("video");
+    const canPlay = testElement.canPlayType(mimeType);
     return canPlay === "probably" || canPlay === "maybe";
   };
   const getOrCreateVideo = () => {
@@ -67,10 +82,14 @@ function createNativePlugin(config) {
       return video;
     }
     video = document.createElement("video");
-    video.style.cssText = "width:100%;height:100%;display:block;object-fit:contain;background:#000";
+    video.style.cssText = "position:absolute;top:0;left:0;width:100%;height:100%;display:block;object-fit:contain;background:#000";
     video.preload = preload;
     video.controls = false;
     video.playsInline = true;
+    const poster = api?.getState("poster");
+    if (poster) {
+      video.poster = poster;
+    }
     api?.container.appendChild(video);
     return video;
   };
@@ -186,10 +205,10 @@ function createNativePlugin(config) {
   };
   const plugin = {
     id: "native-provider",
-    name: "Native Video Provider",
+    name: "Native Media Provider",
     version: "1.0.0",
     type: "provider",
-    description: "Native HTML5 video playback for MP4, WebM, MOV, MKV",
+    description: "Native HTML5 playback for video (MP4, WebM, MOV) and audio (MP3, WAV, FLAC, AAC)",
     canPlay(src) {
       const ext = getExtension(src);
       if (!SUPPORTED_EXTENSIONS.includes(ext)) {
@@ -251,18 +270,44 @@ function createNativePlugin(config) {
       if (!api) throw new Error("Plugin not initialized");
       const ext = getExtension(src);
       const mimeType = getMimeType(ext);
-      api.logger.info("Loading native video source", { src, mimeType });
+      const isAudio = isAudioExtension(ext);
+      api.logger.info("Loading native media source", { src, mimeType, isAudio });
       cleanup();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
+      api.setState("mediaType", isAudio ? "audio" : "video");
+      if (isAudio) {
+        try {
+          const url = new URL(src, window.location.href);
+          const filename = url.pathname.split("/").pop() || "Audio";
+          const title = decodeURIComponent(filename.replace(/\.[^.]+$/, "").replace(/[-_]/g, " "));
+          api.setState("title", title);
+        } catch {
+          api.setState("title", "Audio");
+        }
+      }
       api.setState("qualities", []);
       api.setState("currentQuality", null);
       const videoEl = getOrCreateVideo();
+      if (isAudio) {
+        videoEl.style.display = "none";
+        videoEl.poster = "";
+      } else {
+        videoEl.style.display = "block";
+        const poster = api.getState("poster");
+        if (poster) {
+          videoEl.poster = poster;
+        }
+      }
       cleanupEvents = setupEventListeners(videoEl);
       return new Promise((resolve, reject) => {
         const onLoaded = () => {
           videoEl.removeEventListener("loadedmetadata", onLoaded);
           videoEl.removeEventListener("error", onError);
+          const muted = api?.getState("muted");
+          const volume = api?.getState("volume");
+          if (muted !== void 0) videoEl.muted = muted;
+          if (volume !== void 0) videoEl.volume = volume;
           api?.setState("source", { src, type: mimeType });
           api?.setState("playbackState", "ready");
           api?.setState("buffering", false);

package/dist/index.d.cts

@@ -1,14 +1,24 @@
 import { PluginType, IPluginAPI } from '@scarlett-player/core';
 
 /**
- * Native Video Provider Plugin for Scarlett Player
+ * Native Media Provider Plugin for Scarlett Player
  *
  * Provides playback for native browser-supported formats:
+ *
+ * Video:
  * - MP4 (H.264/AAC)
  * - WebM (VP8/VP9/Opus)
  * - MOV (H.264/AAC)
  * - MKV (varies by browser)
  * - OGG/OGV (Theora/Vorbis)
+ *
+ * Audio:
+ * - MP3 (MPEG Audio Layer 3)
+ * - WAV (Waveform Audio)
+ * - OGG (Vorbis)
+ * - FLAC (Free Lossless Audio Codec)
+ * - AAC (Advanced Audio Coding)
+ * - M4A (MPEG-4 Audio)
  */
 
 interface NativePluginConfig {

package/dist/index.d.ts

@@ -1,14 +1,24 @@
 import { PluginType, IPluginAPI } from '@scarlett-player/core';
 
 /**
- * Native Video Provider Plugin for Scarlett Player
+ * Native Media Provider Plugin for Scarlett Player
  *
  * Provides playback for native browser-supported formats:
+ *
+ * Video:
  * - MP4 (H.264/AAC)
  * - WebM (VP8/VP9/Opus)
  * - MOV (H.264/AAC)
  * - MKV (varies by browser)
  * - OGG/OGV (Theora/Vorbis)
+ *
+ * Audio:
+ * - MP3 (MPEG Audio Layer 3)
+ * - WAV (Waveform Audio)
+ * - OGG (Vorbis)
+ * - FLAC (Free Lossless Audio Codec)
+ * - AAC (Advanced Audio Coding)
+ * - M4A (MPEG-4 Audio)
  */
 
 interface NativePluginConfig {

package/dist/index.js

@@ -1,14 +1,25 @@
 // src/index.ts
 import { ErrorCode } from "@scarlett-player/core";
-var SUPPORTED_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "ogg", "m4v"];
+var VIDEO_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "m4v"];
+var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "aac", "m4a", "opus", "weba"];
+var SUPPORTED_EXTENSIONS = [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS];
 var MIME_TYPES = {
+  // Video
   mp4: "video/mp4",
   m4v: "video/mp4",
   webm: "video/webm",
   mov: "video/quicktime",
   mkv: "video/x-matroska",
   ogv: "video/ogg",
-  ogg: "video/ogg"
+  // Audio
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  m4a: "audio/mp4",
+  opus: "audio/opus",
+  weba: "audio/webm"
 };
 function createNativePlugin(config) {
   const preload = config?.preload ?? "metadata";
@@ -29,9 +40,13 @@ function createNativePlugin(config) {
   const getMimeType = (ext) => {
     return MIME_TYPES[ext] || "video/mp4";
   };
+  const isAudioExtension = (ext) => {
+    return AUDIO_EXTENSIONS.includes(ext);
+  };
   const canBrowserPlay = (mimeType) => {
-    const testVideo = document.createElement("video");
-    const canPlay = testVideo.canPlayType(mimeType);
+    const isAudio = mimeType.startsWith("audio/");
+    const testElement = isAudio ? document.createElement("audio") : document.createElement("video");
+    const canPlay = testElement.canPlayType(mimeType);
     return canPlay === "probably" || canPlay === "maybe";
   };
   const getOrCreateVideo = () => {
@@ -42,10 +57,14 @@ function createNativePlugin(config) {
       return video;
     }
     video = document.createElement("video");
-    video.style.cssText = "width:100%;height:100%;display:block;object-fit:contain;background:#000";
+    video.style.cssText = "position:absolute;top:0;left:0;width:100%;height:100%;display:block;object-fit:contain;background:#000";
     video.preload = preload;
     video.controls = false;
     video.playsInline = true;
+    const poster = api?.getState("poster");
+    if (poster) {
+      video.poster = poster;
+    }
     api?.container.appendChild(video);
     return video;
   };
@@ -161,10 +180,10 @@ function createNativePlugin(config) {
   };
   const plugin = {
     id: "native-provider",
-    name: "Native Video Provider",
+    name: "Native Media Provider",
     version: "1.0.0",
     type: "provider",
-    description: "Native HTML5 video playback for MP4, WebM, MOV, MKV",
+    description: "Native HTML5 playback for video (MP4, WebM, MOV) and audio (MP3, WAV, FLAC, AAC)",
     canPlay(src) {
       const ext = getExtension(src);
       if (!SUPPORTED_EXTENSIONS.includes(ext)) {
@@ -226,18 +245,44 @@ function createNativePlugin(config) {
       if (!api) throw new Error("Plugin not initialized");
       const ext = getExtension(src);
       const mimeType = getMimeType(ext);
-      api.logger.info("Loading native video source", { src, mimeType });
+      const isAudio = isAudioExtension(ext);
+      api.logger.info("Loading native media source", { src, mimeType, isAudio });
       cleanup();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
+      api.setState("mediaType", isAudio ? "audio" : "video");
+      if (isAudio) {
+        try {
+          const url = new URL(src, window.location.href);
+          const filename = url.pathname.split("/").pop() || "Audio";
+          const title = decodeURIComponent(filename.replace(/\.[^.]+$/, "").replace(/[-_]/g, " "));
+          api.setState("title", title);
+        } catch {
+          api.setState("title", "Audio");
+        }
+      }
       api.setState("qualities", []);
       api.setState("currentQuality", null);
       const videoEl = getOrCreateVideo();
+      if (isAudio) {
+        videoEl.style.display = "none";
+        videoEl.poster = "";
+      } else {
+        videoEl.style.display = "block";
+        const poster = api.getState("poster");
+        if (poster) {
+          videoEl.poster = poster;
+        }
+      }
       cleanupEvents = setupEventListeners(videoEl);
       return new Promise((resolve, reject) => {
         const onLoaded = () => {
           videoEl.removeEventListener("loadedmetadata", onLoaded);
           videoEl.removeEventListener("error", onError);
+          const muted = api?.getState("muted");
+          const volume = api?.getState("volume");
+          if (muted !== void 0) videoEl.muted = muted;
+          if (volume !== void 0) videoEl.volume = volume;
           api?.setState("source", { src, type: mimeType });
           api?.setState("playbackState", "ready");
           api?.setState("buffering", false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/native",
-  "version": "0.1.2",
+  "version": "0.4.0",
   "description": "Native Video Provider Plugin for Scarlett Player (MP4, WebM, MOV, MKV)",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,20 +16,14 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "vitest --run",
-    "test:watch": "vitest"
-  },
   "peerDependencies": {
-    "@scarlett-player/core": "^0.1.0"
+    "@scarlett-player/core": "^0.4.0"
   },
   "devDependencies": {
-    "@scarlett-player/core": "workspace:*",
     "typescript": "^5.3.0",
     "tsup": "^8.0.0",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "@scarlett-player/core": "0.4.0"
   },
   "keywords": [
     "video",
@@ -49,5 +43,11 @@
   "bugs": {
     "url": "https://github.com/Hackney-Enterprises-Inc/scarlett-player/issues"
   },
-  "homepage": "https://scarlettplayer.com"
-}
+  "homepage": "https://scarlettplayer.com",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  }
+}