@scarlett-player/playlist 0.5.2 → 1.0.0

package/dist/index.cjs

@@ -30,7 +30,9 @@ var DEFAULT_CONFIG = {
   persist: false,
   persistKey: "scarlett-playlist",
   shuffle: false,
-  repeat: "none"
+  repeat: "none",
+  autoLoad: true,
+  advanceDelay: 0
 };
 function generateId() {
   return `track-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
@@ -174,6 +176,9 @@ function createPlaylistPlugin(config) {
     }
     api?.setState("mediaType", track.type || "audio");
     emitChange();
+    if (mergedConfig.autoLoad !== false && track.src) {
+      api?.emit("media:load-request", { src: track.src, autoplay: true });
+    }
   };
   const plugin = {
     id: "playlist",
@@ -188,12 +193,20 @@ function createPlaylistPlugin(config) {
       if (shuffle && tracks.length > 0) {
         generateShuffleOrder();
       }
+      let advanceTimeout = null;
       const unsubEnded = api.on("playback:ended", () => {
         if (!mergedConfig.autoAdvance) return;
         const nextIdx = getNextIndex();
         if (nextIdx >= 0) {
-          api?.logger.debug("Auto-advancing to next track", { nextIdx });
-          setCurrentTrack(nextIdx);
+          const advance = () => {
+            api?.logger.debug("Auto-advancing to next track", { nextIdx });
+            setCurrentTrack(nextIdx);
+          };
+          if (mergedConfig.advanceDelay) {
+            advanceTimeout = setTimeout(advance, mergedConfig.advanceDelay);
+          } else {
+            advance();
+          }
         } else {
           api?.logger.info("Playlist ended");
           api?.emit("playlist:ended", void 0);
@@ -201,6 +214,10 @@ function createPlaylistPlugin(config) {
       });
       api.onDestroy(() => {
         unsubEnded();
+        if (advanceTimeout) {
+          clearTimeout(advanceTimeout);
+          advanceTimeout = null;
+        }
         persistPlaylist();
       });
     },

package/dist/index.d.cts

@@ -28,6 +28,8 @@ interface PlaylistTrack {
     mimeType?: string;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
+    /** Allow additional properties for extensibility */
+    [key: string]: unknown;
 }
 /**
  * Repeat mode
@@ -72,6 +74,10 @@ interface PlaylistPluginConfig {
     shuffle?: boolean;
     /** Initial repeat mode */
     repeat?: RepeatMode;
+    /** Emit media:load-request on track change so core player loads automatically (default: true) */
+    autoLoad?: boolean;
+    /** Milliseconds to wait before auto-advancing to next track (default: 0) */
+    advanceDelay?: number;
     /** Index signature for PluginConfig compatibility */
     [key: string]: unknown;
 }

package/dist/index.d.ts

@@ -28,6 +28,8 @@ interface PlaylistTrack {
     mimeType?: string;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
+    /** Allow additional properties for extensibility */
+    [key: string]: unknown;
 }
 /**
  * Repeat mode
@@ -72,6 +74,10 @@ interface PlaylistPluginConfig {
     shuffle?: boolean;
     /** Initial repeat mode */
     repeat?: RepeatMode;
+    /** Emit media:load-request on track change so core player loads automatically (default: true) */
+    autoLoad?: boolean;
+    /** Milliseconds to wait before auto-advancing to next track (default: 0) */
+    advanceDelay?: number;
     /** Index signature for PluginConfig compatibility */
     [key: string]: unknown;
 }

package/dist/index.js

@@ -5,7 +5,9 @@ var DEFAULT_CONFIG = {
   persist: false,
   persistKey: "scarlett-playlist",
   shuffle: false,
-  repeat: "none"
+  repeat: "none",
+  autoLoad: true,
+  advanceDelay: 0
 };
 function generateId() {
   return `track-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
@@ -149,6 +151,9 @@ function createPlaylistPlugin(config) {
     }
     api?.setState("mediaType", track.type || "audio");
     emitChange();
+    if (mergedConfig.autoLoad !== false && track.src) {
+      api?.emit("media:load-request", { src: track.src, autoplay: true });
+    }
   };
   const plugin = {
     id: "playlist",
@@ -163,12 +168,20 @@ function createPlaylistPlugin(config) {
       if (shuffle && tracks.length > 0) {
         generateShuffleOrder();
       }
+      let advanceTimeout = null;
       const unsubEnded = api.on("playback:ended", () => {
         if (!mergedConfig.autoAdvance) return;
         const nextIdx = getNextIndex();
         if (nextIdx >= 0) {
-          api?.logger.debug("Auto-advancing to next track", { nextIdx });
-          setCurrentTrack(nextIdx);
+          const advance = () => {
+            api?.logger.debug("Auto-advancing to next track", { nextIdx });
+            setCurrentTrack(nextIdx);
+          };
+          if (mergedConfig.advanceDelay) {
+            advanceTimeout = setTimeout(advance, mergedConfig.advanceDelay);
+          } else {
+            advance();
+          }
         } else {
           api?.logger.info("Playlist ended");
           api?.emit("playlist:ended", void 0);
@@ -176,6 +189,10 @@ function createPlaylistPlugin(config) {
       });
       api.onDestroy(() => {
         unsubEnded();
+        if (advanceTimeout) {
+          clearTimeout(advanceTimeout);
+          advanceTimeout = null;
+        }
         persistPlaylist();
       });
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/playlist",
-  "version": "0.5.2",
+  "version": "1.0.0",
   "description": "Playlist Plugin for Scarlett Player - Queue management, shuffle, repeat, and gapless playback",
   "type": "module",
   "main": "dist/index.cjs",
@@ -22,14 +22,14 @@
     "dist"
   ],
   "peerDependencies": {
-    "@scarlett-player/core": "^0.5.2"
+    "@scarlett-player/core": "^1.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
     "vitest": "^1.6.0",
     "jsdom": "^24.0.0",
-    "@scarlett-player/core": "0.5.2"
+    "@scarlett-player/core": "1.0.0"
   },
   "keywords": [
     "video",