react-native-audio-browser 0.1.0 → 0.2.0-next.1

package/lib/module/web/TrackPlayer/QueueManager.js

@@ -0,0 +1,269 @@
+"use strict";
+
+import { assertedNotNullish } from '../../utils/validation';
+import { fisherYatesShuffle } from '../util/shuffle';
+import { RepeatMode } from './RepeatMode';
+
+/**
+ * What removing tracks means for the currently-playing item — the caller (the
+ * player) acts on it (reload / stop), keeping engine concerns out of the queue.
+ */
+
+// the current track was removed and the queue is now empty
+
+/**
+ * Owns the play queue: the track list, the current/last index, repeat mode and
+ * shuffle order, plus all the pure index math (next/previous, wrap-around,
+ * shuffle ordering, index adjustment on mutation). It has no knowledge of the
+ * playback engine — the web analog of iOS's `QueueManager` + `ShuffleOrder`.
+ * Orchestration (loading a track when the index changes) stays with the caller.
+ */
+export class QueueManager {
+  _tracks = [];
+  _repeatMode = RepeatMode.Off;
+  _shuffleEnabled = false;
+  shuffleOrder = [];
+
+  // MARK: tracks
+
+  get tracks() {
+    return this._tracks;
+  }
+  get length() {
+    return this._tracks.length;
+  }
+  getTrack(index) {
+    return this._tracks[index];
+  }
+
+  /** Replaces the whole queue and resets the current/last index. */
+  setTracks(tracks) {
+    this._tracks = tracks;
+    this._currentIndex = undefined;
+    this._lastIndex = undefined;
+    if (this._shuffleEnabled) this.regenerateShuffleOrder();
+  }
+
+  /** Replaces a single track in place (e.g. a favorite toggle). */
+  replaceTrack(index, track) {
+    this._tracks[index] = track;
+  }
+
+  // MARK: current index
+
+  get currentIndex() {
+    return this._currentIndex;
+  }
+  set currentIndex(index) {
+    this._lastIndex = this._currentIndex;
+    this._currentIndex = index;
+  }
+  get lastIndex() {
+    return this._lastIndex;
+  }
+
+  // MARK: repeat / shuffle
+
+  get repeatMode() {
+    return this._repeatMode;
+  }
+  set repeatMode(mode) {
+    this._repeatMode = mode;
+  }
+  get shuffleEnabled() {
+    return this._shuffleEnabled;
+  }
+  setShuffleEnabled(enabled) {
+    this._shuffleEnabled = enabled;
+    if (enabled) this.regenerateShuffleOrder();
+  }
+  regenerateShuffleOrder() {
+    this.shuffleOrder = Array.from({
+      length: this._tracks.length
+    }, (_, i) => i);
+    fisherYatesShuffle(this.shuffleOrder);
+
+    // Keep the current track at the front so navigation continues from it.
+    if (this._currentIndex === undefined) return;
+    const currentPos = this.shuffleOrder.indexOf(this._currentIndex);
+    if (currentPos > 0) {
+      const first = assertedNotNullish(this.shuffleOrder[0]);
+      this.shuffleOrder[0] = assertedNotNullish(this.shuffleOrder[currentPos]);
+      this.shuffleOrder[currentPos] = first;
+    }
+  }
+
+  // The shuffle order is maintained incrementally across mutations (matching
+  // iOS's ShuffleOrder and ExoPlayer's DefaultShuffleOrder) rather than
+  // regenerated: a regeneration re-randomizes the upcoming order and erases
+  // the played history, leaving previous() dead after any add/remove/move.
+
+  /** Shifts indices for an insertion and slots the new ones in at random positions. */
+  shuffleOrderInsert(at, count) {
+    if (!this._shuffleEnabled || count <= 0) return;
+    this.shuffleOrder = this.shuffleOrder.map(idx => idx >= at ? idx + count : idx);
+    for (let i = 0; i < count; i++) {
+      const pos = Math.floor(Math.random() * (this.shuffleOrder.length + 1));
+      this.shuffleOrder.splice(pos, 0, at + i);
+    }
+  }
+
+  /** Drops removed indices and shifts the survivors down past them. */
+  shuffleOrderRemove(removed) {
+    if (!this._shuffleEnabled || removed.size === 0) return;
+    const sorted = [...removed].sort((a, b) => a - b);
+    this.shuffleOrder = this.shuffleOrder.filter(idx => !removed.has(idx)).map(idx => idx - sorted.filter(r => r < idx).length);
+  }
+
+  /** Remaps indices for a move, keeping every track's shuffle position. */
+  shuffleOrderMove(fromIndex, toIndex) {
+    if (!this._shuffleEnabled) return;
+    this.shuffleOrder = this.shuffleOrder.map(idx => {
+      if (idx === fromIndex) return toIndex;
+      let adjusted = idx > fromIndex ? idx - 1 : idx;
+      if (adjusted >= toIndex) adjusted += 1;
+      return adjusted;
+    });
+  }
+
+  // MARK: navigation
+
+  nextIndex() {
+    if (this._currentIndex === undefined) return undefined;
+    if (!this._shuffleEnabled) {
+      const next = this._currentIndex + 1;
+      return next >= this._tracks.length ? undefined : next;
+    }
+    const pos = this.shuffleOrder.indexOf(this._currentIndex);
+    if (pos === -1) return undefined;
+    const nextPos = pos + 1;
+    return nextPos >= this.shuffleOrder.length ? undefined : this.shuffleOrder[nextPos];
+  }
+  previousIndex() {
+    if (this._currentIndex === undefined) return undefined;
+    if (!this._shuffleEnabled) {
+      const prev = this._currentIndex - 1;
+      return prev < 0 ? undefined : prev;
+    }
+    const pos = this.shuffleOrder.indexOf(this._currentIndex);
+    if (pos === -1) return undefined;
+    const prevPos = pos - 1;
+    return prevPos < 0 ? undefined : this.shuffleOrder[prevPos];
+  }
+  wrapAroundFirstIndex() {
+    if (this._repeatMode !== RepeatMode.Queue) return undefined;
+    return this._shuffleEnabled ? this.shuffleOrder[0] : 0;
+  }
+  wrapAroundLastIndex() {
+    if (this._repeatMode !== RepeatMode.Queue) return undefined;
+    return this._shuffleEnabled ? this.shuffleOrder[this.shuffleOrder.length - 1] : this._tracks.length - 1;
+  }
+
+  // MARK: mutations
+
+  /** Inserts tracks at `insertBeforeIndex`, or appends when omitted/-1. */
+  insert(tracks, insertBeforeIndex) {
+    if (insertBeforeIndex !== -1 && insertBeforeIndex !== undefined) {
+      // Match Android/iOS, which throw here: a negative index other than the
+      // -1 sentinel would splice from the end and mis-shift the current
+      // pointer; past-the-end would silently append under a lying index.
+      if (insertBeforeIndex < 0 || insertBeforeIndex > this._tracks.length) {
+        throw new Error(`insertBeforeIndex out of bounds: ${insertBeforeIndex} (use -1 to append)`);
+      }
+      this._tracks.splice(insertBeforeIndex, 0, ...tracks);
+      // Keep the pointer on the same track (remove()/move() already do).
+      if (this._currentIndex !== undefined && insertBeforeIndex <= this._currentIndex) {
+        this._currentIndex += tracks.length;
+      }
+      this.shuffleOrderInsert(insertBeforeIndex, tracks.length);
+    } else {
+      this._tracks.push(...tracks);
+      this.shuffleOrderInsert(this._tracks.length - tracks.length, tracks.length);
+    }
+  }
+
+  /**
+   * Removes the tracks at `indexes`, adjusting the current index. Returns what
+   * the caller must do for the current track (the queue itself never reloads).
+   */
+  remove(indexes) {
+    const idxSet = new Set(indexes);
+    const current = this._currentIndex;
+    let removedBeforeCurrent = 0;
+    let removedCurrent = false;
+    this._tracks = this._tracks.filter((_track, idx) => {
+      if (!idxSet.has(idx)) return true;
+      if (idx === current) removedCurrent = true;else if (current !== undefined && idx < current) removedBeforeCurrent++;
+      return false;
+    });
+    this.shuffleOrderRemove(idxSet);
+    if (current === undefined) return {
+      kind: 'no-current'
+    };
+    if (!removedCurrent) {
+      this._currentIndex = current - removedBeforeCurrent;
+      return {
+        kind: 'kept'
+      };
+    }
+    if (this._tracks.length === 0) {
+      this._currentIndex = undefined;
+      return {
+        kind: 'emptied'
+      };
+    }
+
+    // Reset so the caller's reload always loads the track at this position.
+    this._currentIndex = undefined;
+    const adjusted = current - removedBeforeCurrent;
+    // Wrap: removing the last-and-current track activates the first (the
+    // documented contract, matching iOS's modulo).
+    return {
+      kind: 'reload',
+      index: adjusted % this._tracks.length
+    };
+  }
+  move(fromIndex, toIndex) {
+    // Both ends are checked: an out-of-range destination would write a
+    // permanent out-of-range entry into the incrementally-maintained order.
+    const item = this._tracks[fromIndex];
+    if (item === undefined || toIndex < 0 || toIndex >= this._tracks.length) {
+      throw new Error('index out of bounds');
+    }
+    this._tracks.splice(fromIndex, 1);
+    this._tracks.splice(toIndex, 0, item);
+
+    // Track the current item's new position (matches Android's moveMediaItem).
+    const current = this._currentIndex;
+    if (current !== undefined) {
+      if (fromIndex === current) this._currentIndex = toIndex;else if (fromIndex < current && toIndex >= current) {
+        this._currentIndex = current - 1;
+      } else if (fromIndex > current && toIndex <= current) {
+        this._currentIndex = current + 1;
+      }
+    }
+    this.shuffleOrderMove(fromIndex, toIndex);
+  }
+
+  /** Drops every track after the current one. */
+  removeUpcoming() {
+    if (this._currentIndex === undefined) return;
+    const dropped = new Set();
+    for (let i = this._currentIndex + 1; i < this._tracks.length; i++) {
+      dropped.add(i);
+    }
+    this._tracks = this._tracks.slice(0, this._currentIndex + 1);
+    this.shuffleOrderRemove(dropped);
+  }
+
+  /** Empties the queue and resets the index. */
+  clear() {
+    this._tracks = [];
+    this._currentIndex = undefined;
+    this._lastIndex = undefined;
+    // Mutations maintain the order incrementally, so a stale order would
+    // survive the clear and corrupt the first post-clear insert.
+    this.shuffleOrder = [];
+  }
+}
+//# sourceMappingURL=QueueManager.js.map

package/lib/module/web/TrackPlayer/QueueManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertedNotNullish","fisherYatesShuffle","RepeatMode","QueueManager","_tracks","_repeatMode","Off","_shuffleEnabled","shuffleOrder","tracks","length","getTrack","index","setTracks","_currentIndex","undefined","_lastIndex","regenerateShuffleOrder","replaceTrack","track","currentIndex","lastIndex","repeatMode","mode","shuffleEnabled","setShuffleEnabled","enabled","Array","from","_","i","currentPos","indexOf","first","shuffleOrderInsert","at","count","map","idx","pos","Math","floor","random","splice","shuffleOrderRemove","removed","size","sorted","sort","a","b","filter","has","r","shuffleOrderMove","fromIndex","toIndex","adjusted","nextIndex","next","nextPos","previousIndex","prev","prevPos","wrapAroundFirstIndex","Queue","wrapAroundLastIndex","insert","insertBeforeIndex","Error","push","remove","indexes","idxSet","Set","current","removedBeforeCurrent","removedCurrent","_track","kind","move","item","removeUpcoming","dropped","add","slice","clear"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/QueueManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/web/TrackPlayer/QueuePlayer.js

@@ -0,0 +1,154 @@
+"use strict";
+
+import { Player } from './Player';
+import { QueueManager } from './QueueManager';
+import { RepeatMode } from './RepeatMode';
+import { State } from './State';
+
+/**
+ * A {@link Player} with a play queue. Owns the *orchestration* — advancing the
+ * queue on track end, loading the track when the index changes — while the
+ * queue data and index math live in {@link QueueManager}.
+ */
+export class QueuePlayer extends Player {
+  queue = new QueueManager();
+  applyState(state) {
+    // A natural queue end exhausts the play intent — nothing is left to play.
+    // Keeping it set inverted togglePlayback (the first press after completion
+    // was a silent pause) and armed load()'s auto-play with phantom intent.
+    // Cleared before the state lands so consumers observe the native order
+    // (intent → state → queueEnded), independent of onQueueEnded overrides.
+    // Per-track ends that advance the queue keep the intent.
+    if (state === State.Ended && this.endsQueue()) {
+      this.playWhenReady = false;
+    }
+    super.applyState(state);
+
+    // dispatch() already gates on _isStopped before reaching applyState, so a
+    // natural end while stopped never advances the queue.
+    if (state === State.Ended) {
+      this.onTrackEnded();
+    }
+  }
+
+  /** True when a natural end has nowhere to go: not repeating, no next track. */
+  endsQueue() {
+    return this.queue.repeatMode !== RepeatMode.Track && this.queue.repeatMode !== RepeatMode.Queue && this.queue.nextIndex() === undefined;
+  }
+  onTrackEnded() {
+    if (this.queue.repeatMode === RepeatMode.Track) {
+      if (this.queue.currentIndex !== undefined) {
+        this.goToIndex(this.queue.currentIndex);
+      }
+      return;
+    }
+    if (this.endsQueue()) {
+      this.onQueueEnded();
+      return;
+    }
+    this.skipToNext();
+  }
+
+  /**
+   * Notification hook for a natural queue end. The play intent is already
+   * cleared in {@link applyState} — this is purely for subclasses to react
+   * (e.g. emitting the queue-ended event).
+   */
+  onQueueEnded() {}
+  goToIndex(index, initialPosition) {
+    const track = this.queue.getTrack(index);
+    if (!track) return;
+
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const onLoaded = _track => {
+      if (initialPosition !== undefined) {
+        this.seekTo(initialPosition);
+      }
+    };
+    if (this.queue.currentIndex !== index) {
+      this.queue.currentIndex = index;
+      this.load(track, onLoaded);
+    } else if (this._isStopped) {
+      // The element is unloaded while stopped — a bare seek does nothing.
+      this.load(track, onLoaded);
+    } else {
+      // Replay the same track - seek to start (or initialPosition if specified)
+      this.seekTo(initialPosition ?? 0);
+      if (this.playWhenReady) {
+        this.play();
+      }
+    }
+  }
+  add(tracks, insertBeforeIndex) {
+    this.queue.insert(tracks, insertBeforeIndex);
+    if (this.queue.currentIndex === undefined) {
+      this.goToIndex(0);
+    }
+  }
+  skip(index, initialPosition) {
+    if (this.queue.getTrack(index) === undefined) {
+      throw new Error('index out of bounds');
+    }
+    this.goToIndex(index, initialPosition);
+  }
+  skipToNext(initialPosition) {
+    if (this.queue.currentIndex === undefined) return;
+    const nextIndex = this.queue.nextIndex() ?? this.queue.wrapAroundFirstIndex();
+    if (nextIndex === undefined) return;
+    this.goToIndex(nextIndex, initialPosition);
+  }
+  skipToPrevious(initialPosition) {
+    if (this.queue.currentIndex === undefined) return;
+    const previousIndex = this.queue.previousIndex() ?? this.queue.wrapAroundLastIndex();
+    if (previousIndex === undefined) return;
+    this.goToIndex(previousIndex, initialPosition);
+  }
+  setShuffleEnabled(enabled) {
+    this.queue.setShuffleEnabled(enabled);
+  }
+  getShuffleEnabled() {
+    return this.queue.shuffleEnabled;
+  }
+  getTrack(index) {
+    return this.queue.getTrack(index);
+  }
+  setRepeatMode(mode) {
+    this.queue.repeatMode = mode;
+  }
+  getRepeatMode() {
+    return this.queue.repeatMode;
+  }
+  remove(indexes) {
+    const outcome = this.queue.remove(indexes);
+    switch (outcome.kind) {
+      case 'no-current':
+      case 'kept':
+        break;
+      case 'reload':
+        this.goToIndex(outcome.index);
+        break;
+      case 'emptied':
+        this.current = undefined;
+        this.stop();
+        break;
+    }
+  }
+  stop(onComplete) {
+    super.stop(onComplete);
+  }
+  reset() {
+    // Clear queue state synchronously so subsequent add()/load() calls
+    // see a clean slate. The async player.unload() in stop() can finish
+    // in the background — it only releases the Shaka source.
+    this.queue.clear();
+    this.current = undefined;
+    this.stop();
+  }
+  removeUpcomingTracks() {
+    this.queue.removeUpcoming();
+  }
+  move(fromIndex, toIndex) {
+    this.queue.move(fromIndex, toIndex);
+  }
+}
+//# sourceMappingURL=QueuePlayer.js.map

package/lib/module/web/TrackPlayer/QueuePlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Player","QueueManager","RepeatMode","State","QueuePlayer","queue","applyState","state","Ended","endsQueue","playWhenReady","onTrackEnded","repeatMode","Track","Queue","nextIndex","undefined","currentIndex","goToIndex","onQueueEnded","skipToNext","index","initialPosition","track","getTrack","onLoaded","_track","seekTo","load","_isStopped","play","add","tracks","insertBeforeIndex","insert","skip","Error","wrapAroundFirstIndex","skipToPrevious","previousIndex","wrapAroundLastIndex","setShuffleEnabled","enabled","getShuffleEnabled","shuffleEnabled","setRepeatMode","mode","getRepeatMode","remove","indexes","outcome","kind","current","stop","onComplete","reset","clear","removeUpcomingTracks","removeUpcoming","move","fromIndex","toIndex"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/QueuePlayer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/web/TrackPlayer/RepeatMode.js

@@ -3,6 +3,6 @@
 export const RepeatMode = {
   Off: 'off',
   Track: 'track',
-  Playlist: 'queue'
+  Queue: 'queue'
 };
 //# sourceMappingURL=RepeatMode.js.map

package/lib/module/web/TrackPlayer/RepeatMode.js.map

@@ -1 +1 @@
-{"version":3,"names":["RepeatMode","Off","Track","Playlist"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/RepeatMode.ts"],"mappings":";;AAEA,OAAO,MAAMA,UAAU,GAAG;EACxBC,GAAG,EAAE,KAAc;EACnBC,KAAK,EAAE,OAAgB;EACvBC,QAAQ,EAAE;AACZ,CAA0C","ignoreList":[]}
+{"version":3,"names":["RepeatMode","Off","Track","Queue"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/RepeatMode.ts"],"mappings":";;AAEA,OAAO,MAAMA,UAAU,GAAG;EACxBC,GAAG,EAAE,KAAc;EACnBC,KAAK,EAAE,OAAgB;EACvBC,KAAK,EAAE;AACT,CAA0C","ignoreList":[]}

package/lib/module/web/TrackPlayer/SleepTimer.js

@@ -4,12 +4,14 @@
  * Manages a sleep timer that calls a completion callback after a specified duration.
  *
  * The timer stores the expiration time as a timestamp and uses setTimeout to schedule the completion
- * callback. Supports both time-based and end-of-track modes.
+ * callback. Supports both time-based and end-of-track modes, plus an optional fade-out that starts
+ * `fadeDuration` seconds before the deadline so silence lands exactly when the timer completes.
  */
 export class SleepTimerManager {
   time = null;
   sleepWhenPlayedToEnd = false;
   timeoutId = null;
+  fadeTimeoutId = null;
   get isRunning() {
     return this.time !== null || this.sleepWhenPlayedToEnd;
   }
@@ -18,14 +20,23 @@ export class SleepTimerManager {
    * Sets a timer to complete after the specified number of seconds.
    *
    * @param seconds Number of seconds until the timer completes
+   * @param fadeDuration Seconds over which to fade out before completion; clamped to `seconds`
    */
-  sleepAfter(seconds) {
+  sleepAfter(seconds, fadeDuration) {
     this.stopTimer();
+    this.onFadeCancel();
     this.sleepWhenPlayedToEnd = false;
     this.timeoutId = setTimeout(() => {
       this.complete();
     }, seconds * 1000);
     this.time = Date.now() + seconds * 1000;
+    if (fadeDuration !== undefined && fadeDuration > 0) {
+      const fade = Math.min(fadeDuration, seconds);
+      this.fadeTimeoutId = setTimeout(() => {
+        this.fadeTimeoutId = null;
+        this.onFadeStart(fade);
+      }, (seconds - fade) * 1000);
+    }
   }
 
   /**
@@ -34,6 +45,7 @@ export class SleepTimerManager {
    */
   setToEndOfTrack() {
     this.stopTimer();
+    this.onFadeCancel();
     this.time = null;
     this.sleepWhenPlayedToEnd = true;
   }
@@ -46,6 +58,7 @@ export class SleepTimerManager {
   clear() {
     const wasRunning = this.isRunning;
     this.stopTimer();
+    this.onFadeCancel();
     this.time = null;
     this.sleepWhenPlayedToEnd = false;
     return wasRunning;
@@ -55,9 +68,23 @@ export class SleepTimerManager {
   onComplete() {
     // Default implementation does nothing - override in subclass
   }
+
+  /** Override to begin fading the volume; the timer still completes at its deadline. */
+  onFadeStart(_durationSeconds) {
+    // Default implementation does nothing - override in subclass
+  }
+
+  /** Override to handle a fade cancelled before completion — restore the volume. */
+  onFadeCancel() {
+    // Default implementation does nothing - override in subclass
+  }
   complete() {
     if (!this.isRunning) return;
-    this.clear();
+    // Tear down without onFadeCancel: completion pauses first, then the
+    // completion handler restores the volume.
+    this.stopTimer();
+    this.time = null;
+    this.sleepWhenPlayedToEnd = false;
     this.onComplete();
   }
   stopTimer() {
@@ -65,6 +92,10 @@ export class SleepTimerManager {
       clearTimeout(this.timeoutId);
       this.timeoutId = null;
     }
+    if (this.fadeTimeoutId !== null) {
+      clearTimeout(this.fadeTimeoutId);
+      this.fadeTimeoutId = null;
+    }
   }
 }
 //# sourceMappingURL=SleepTimer.js.map

package/lib/module/web/TrackPlayer/SleepTimer.js.map

@@ -1 +1 @@
-{"version":3,"names":["SleepTimerManager","time","sleepWhenPlayedToEnd","timeoutId","isRunning","sleepAfter","seconds","stopTimer","setTimeout","complete","Date","now","setToEndOfTrack","clear","wasRunning","onComplete","clearTimeout"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/SleepTimer.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAC;EACtBC,IAAI,GAAkB,IAAI;EAC1BC,oBAAoB,GAAY,KAAK;EACpCC,SAAS,GAA0B,IAAI;EAE/C,IAAIC,SAASA,CAAA,EAAY;IACvB,OAAO,IAAI,CAACH,IAAI,KAAK,IAAI,IAAI,IAAI,CAACC,oBAAoB;EACxD;;EAEA;AACF;AACA;AACA;AACA;EACEG,UAAUA,CAACC,OAAe,EAAQ;IAChC,IAAI,CAACC,SAAS,CAAC,CAAC;IAChB,IAAI,CAACL,oBAAoB,GAAG,KAAK;IAEjC,IAAI,CAACC,SAAS,GAAGK,UAAU,CAAC,MAAM;MAChC,IAAI,CAACC,QAAQ,CAAC,CAAC;IACjB,CAAC,EAAEH,OAAO,GAAG,IAAI,CAAC;IAClB,IAAI,CAACL,IAAI,GAAGS,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGL,OAAO,GAAG,IAAI;EACzC;;EAEA;AACF;AACA;AACA;EACEM,eAAeA,CAAA,EAAS;IACtB,IAAI,CAACL,SAAS,CAAC,CAAC;IAChB,IAAI,CAACN,IAAI,GAAG,IAAI;IAChB,IAAI,CAACC,oBAAoB,GAAG,IAAI;EAClC;;EAEA;AACF;AACA;AACA;AACA;EACEW,KAAKA,CAAA,EAAY;IACf,MAAMC,UAAU,GAAG,IAAI,CAACV,SAAS;IACjC,IAAI,CAACG,SAAS,CAAC,CAAC;IAChB,IAAI,CAACN,IAAI,GAAG,IAAI;IAChB,IAAI,CAACC,oBAAoB,GAAG,KAAK;IACjC,OAAOY,UAAU;EACnB;;EAEA;EACUC,UAAUA,CAAA,EAAS;IAC3B;EAAA;EAGMN,QAAQA,CAAA,EAAS;IACvB,IAAI,CAAC,IAAI,CAACL,SAAS,EAAE;IACrB,IAAI,CAACS,KAAK,CAAC,CAAC;IACZ,IAAI,CAACE,UAAU,CAAC,CAAC;EACnB;EAEQR,SAASA,CAAA,EAAS;IACxB,IAAI,IAAI,CAACJ,SAAS,KAAK,IAAI,EAAE;MAC3Ba,YAAY,CAAC,IAAI,CAACb,SAAS,CAAC;MAC5B,IAAI,CAACA,SAAS,GAAG,IAAI;IACvB;EACF;AACF","ignoreList":[]}
+{"version":3,"names":["SleepTimerManager","time","sleepWhenPlayedToEnd","timeoutId","fadeTimeoutId","isRunning","sleepAfter","seconds","fadeDuration","stopTimer","onFadeCancel","setTimeout","complete","Date","now","undefined","fade","Math","min","onFadeStart","setToEndOfTrack","clear","wasRunning","onComplete","_durationSeconds","clearTimeout"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/SleepTimer.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAC;EACtBC,IAAI,GAAkB,IAAI;EAC1BC,oBAAoB,GAAY,KAAK;EACpCC,SAAS,GAA0B,IAAI;EACvCC,aAAa,GAA0B,IAAI;EAEnD,IAAIC,SAASA,CAAA,EAAY;IACvB,OAAO,IAAI,CAACJ,IAAI,KAAK,IAAI,IAAI,IAAI,CAACC,oBAAoB;EACxD;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEI,UAAUA,CAACC,OAAe,EAAEC,YAAqB,EAAQ;IACvD,IAAI,CAACC,SAAS,CAAC,CAAC;IAChB,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACR,oBAAoB,GAAG,KAAK;IAEjC,IAAI,CAACC,SAAS,GAAGQ,UAAU,CAAC,MAAM;MAChC,IAAI,CAACC,QAAQ,CAAC,CAAC;IACjB,CAAC,EAAEL,OAAO,GAAG,IAAI,CAAC;IAClB,IAAI,CAACN,IAAI,GAAGY,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGP,OAAO,GAAG,IAAI;IAEvC,IAAIC,YAAY,KAAKO,SAAS,IAAIP,YAAY,GAAG,CAAC,EAAE;MAClD,MAAMQ,IAAI,GAAGC,IAAI,CAACC,GAAG,CAACV,YAAY,EAAED,OAAO,CAAC;MAC5C,IAAI,CAACH,aAAa,GAAGO,UAAU,CAC7B,MAAM;QACJ,IAAI,CAACP,aAAa,GAAG,IAAI;QACzB,IAAI,CAACe,WAAW,CAACH,IAAI,CAAC;MACxB,CAAC,EACD,CAACT,OAAO,GAAGS,IAAI,IAAI,IACrB,CAAC;IACH;EACF;;EAEA;AACF;AACA;AACA;EACEI,eAAeA,CAAA,EAAS;IACtB,IAAI,CAACX,SAAS,CAAC,CAAC;IAChB,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACT,IAAI,GAAG,IAAI;IAChB,IAAI,CAACC,oBAAoB,GAAG,IAAI;EAClC;;EAEA;AACF;AACA;AACA;AACA;EACEmB,KAAKA,CAAA,EAAY;IACf,MAAMC,UAAU,GAAG,IAAI,CAACjB,SAAS;IACjC,IAAI,CAACI,SAAS,CAAC,CAAC;IAChB,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACT,IAAI,GAAG,IAAI;IAChB,IAAI,CAACC,oBAAoB,GAAG,KAAK;IACjC,OAAOoB,UAAU;EACnB;;EAEA;EACUC,UAAUA,CAAA,EAAS;IAC3B;EAAA;;EAGF;EACUJ,WAAWA,CAACK,gBAAwB,EAAQ;IACpD;EAAA;;EAGF;EACUd,YAAYA,CAAA,EAAS;IAC7B;EAAA;EAGME,QAAQA,CAAA,EAAS;IACvB,IAAI,CAAC,IAAI,CAACP,SAAS,EAAE;IACrB;IACA;IACA,IAAI,CAACI,SAAS,CAAC,CAAC;IAChB,IAAI,CAACR,IAAI,GAAG,IAAI;IAChB,IAAI,CAACC,oBAAoB,GAAG,KAAK;IACjC,IAAI,CAACqB,UAAU,CAAC,CAAC;EACnB;EAEQd,SAASA,CAAA,EAAS;IACxB,IAAI,IAAI,CAACN,SAAS,KAAK,IAAI,EAAE;MAC3BsB,YAAY,CAAC,IAAI,CAACtB,SAAS,CAAC;MAC5B,IAAI,CAACA,SAAS,GAAG,IAAI;IACvB;IACA,IAAI,IAAI,CAACC,aAAa,KAAK,IAAI,EAAE;MAC/BqB,YAAY,CAAC,IAAI,CAACrB,aAAa,CAAC;MAChC,IAAI,CAACA,aAAa,GAAG,IAAI;IAC3B;EACF;AACF","ignoreList":[]}

package/lib/module/web/TrackPlayer/VolumeFader.js

@@ -0,0 +1,70 @@
+"use strict";
+
+/**
+ * Ramps the player volume down over a duration (sleep-timer fade). The gain
+ * follows a squared curve: loudness perception is logarithmic, so a linear
+ * gain ramp sounds like a late cutoff rather than a fade.
+ */
+export class VolumeFader {
+  interval = null;
+
+  /**
+   * Volume captured when the fade started; restored after the fade resolves.
+   * Non-null from fade start until cancel/completion, even once the ramp has
+   * reached silence.
+   */
+  preFadeVolume = null;
+  constructor(getVolume, setVolume) {
+    this.getVolume = getVolume;
+    this.setVolume = setVolume;
+  }
+  get isActive() {
+    return this.preFadeVolume !== null;
+  }
+  start(durationSeconds) {
+    // If a fade is already running, keep its captured volume as the baseline —
+    // the current (partially faded) volume is not the value to restore.
+    const baseVolume = this.preFadeVolume ?? this.getVolume();
+    this.cancel(false);
+    this.preFadeVolume = baseVolume;
+    if (durationSeconds <= 0) return;
+    const startTime = Date.now();
+    this.interval = setInterval(() => {
+      const progress = Math.min(1, (Date.now() - startTime) / (durationSeconds * 1000));
+      this.setVolume(baseVolume * (1 - progress) ** 2);
+      if (progress >= 1 && this.interval !== null) {
+        clearInterval(this.interval);
+        this.interval = null;
+      }
+    }, 50);
+  }
+
+  /**
+   * Stops the ramp. With `restoreVolume` the pre-fade volume is put back
+   * immediately (cancellation); without it the caller restores after pausing
+   * (completion path — restoring first would let full-volume audio slip out).
+   */
+  cancel(restoreVolume) {
+    if (this.interval !== null) {
+      clearInterval(this.interval);
+      this.interval = null;
+    }
+    const preFadeVolume = this.preFadeVolume;
+    this.preFadeVolume = null;
+    if (restoreVolume && preFadeVolume !== null) this.setVolume(preFadeVolume);
+  }
+
+  /**
+   * Resolves the fade around a halting action: stops the ramp, runs `halt`,
+   * then restores the pre-fade volume — in that order, because restoring
+   * before halting would let full-volume audio slip out. The restore is
+   * skipped when no fade was running.
+   */
+  resolve(halt) {
+    const preFadeVolume = this.preFadeVolume;
+    this.cancel(false);
+    halt();
+    if (preFadeVolume !== null) this.setVolume(preFadeVolume);
+  }
+}
+//# sourceMappingURL=VolumeFader.js.map

package/lib/module/web/TrackPlayer/VolumeFader.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["VolumeFader","interval","preFadeVolume","constructor","getVolume","setVolume","isActive","start","durationSeconds","baseVolume","cancel","startTime","Date","now","setInterval","progress","Math","min","clearInterval","restoreVolume","resolve","halt"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/VolumeFader.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,WAAW,CAAC;EACfC,QAAQ,GAA0B,IAAI;;EAE9C;AACF;AACA;AACA;AACA;EACUC,aAAa,GAAkB,IAAI;EAE3CC,WAAWA,CACDC,SAAuB,EACvBC,SAAmC,EAC3C;IAAA,KAFQD,SAAuB,GAAvBA,SAAuB;IAAA,KACvBC,SAAmC,GAAnCA,SAAmC;EAC1C;EAEH,IAAIC,QAAQA,CAAA,EAAY;IACtB,OAAO,IAAI,CAACJ,aAAa,KAAK,IAAI;EACpC;EAEAK,KAAKA,CAACC,eAAuB,EAAQ;IACnC;IACA;IACA,MAAMC,UAAU,GAAG,IAAI,CAACP,aAAa,IAAI,IAAI,CAACE,SAAS,CAAC,CAAC;IACzD,IAAI,CAACM,MAAM,CAAC,KAAK,CAAC;IAClB,IAAI,CAACR,aAAa,GAAGO,UAAU;IAC/B,IAAID,eAAe,IAAI,CAAC,EAAE;IAE1B,MAAMG,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAACZ,QAAQ,GAAGa,WAAW,CAAC,MAAM;MAChC,MAAMC,QAAQ,GAAGC,IAAI,CAACC,GAAG,CACvB,CAAC,EACD,CAACL,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,SAAS,KAAKH,eAAe,GAAG,IAAI,CACpD,CAAC;MACD,IAAI,CAACH,SAAS,CAACI,UAAU,GAAG,CAAC,CAAC,GAAGM,QAAQ,KAAK,CAAC,CAAC;MAChD,IAAIA,QAAQ,IAAI,CAAC,IAAI,IAAI,CAACd,QAAQ,KAAK,IAAI,EAAE;QAC3CiB,aAAa,CAAC,IAAI,CAACjB,QAAQ,CAAC;QAC5B,IAAI,CAACA,QAAQ,GAAG,IAAI;MACtB;IACF,CAAC,EAAE,EAAE,CAAC;EACR;;EAEA;AACF;AACA;AACA;AACA;EACES,MAAMA,CAACS,aAAsB,EAAQ;IACnC,IAAI,IAAI,CAAClB,QAAQ,KAAK,IAAI,EAAE;MAC1BiB,aAAa,CAAC,IAAI,CAACjB,QAAQ,CAAC;MAC5B,IAAI,CAACA,QAAQ,GAAG,IAAI;IACtB;IACA,MAAMC,aAAa,GAAG,IAAI,CAACA,aAAa;IACxC,IAAI,CAACA,aAAa,GAAG,IAAI;IACzB,IAAIiB,aAAa,IAAIjB,aAAa,KAAK,IAAI,EAAE,IAAI,CAACG,SAAS,CAACH,aAAa,CAAC;EAC5E;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEkB,OAAOA,CAACC,IAAgB,EAAQ;IAC9B,MAAMnB,aAAa,GAAG,IAAI,CAACA,aAAa;IACxC,IAAI,CAACQ,MAAM,CAAC,KAAK,CAAC;IAClBW,IAAI,CAAC,CAAC;IACN,IAAInB,aAAa,KAAK,IAAI,EAAE,IAAI,CAACG,SAAS,CAACH,aAAa,CAAC;EAC3D;AACF","ignoreList":[]}

package/lib/module/web/TrackPlayer/index.js

@@ -1,7 +1,8 @@
 "use strict";
 
 export * from './Player';
-export * from './PlaylistPlayer';
+export * from './QueuePlayer';
 export * from './RepeatMode';
 export { SleepTimerManager } from './SleepTimer';
+export { VolumeFader } from './VolumeFader';
 //# sourceMappingURL=index.js.map

package/lib/module/web/TrackPlayer/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["SleepTimerManager"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/index.ts"],"mappings":";;AAAA,cAAc,UAAU;AACxB,cAAc,kBAAkB;AAChC,cAAc,cAAc;AAC5B,SAASA,iBAAiB,QAAQ,cAAc","ignoreList":[]}
+{"version":3,"names":["SleepTimerManager","VolumeFader"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/index.ts"],"mappings":";;AAAA,cAAc,UAAU;AACxB,cAAc,eAAe;AAC7B,cAAc,cAAc;AAC5B,SAASA,iBAAiB,QAAQ,cAAc;AAChD,SAASC,WAAW,QAAQ,eAAe","ignoreList":[]}