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

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

@@ -0,0 +1,273 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.QueueManager = void 0;
+var _validation = require("../../utils/validation");
+var _shuffle = require("../util/shuffle");
+var _RepeatMode = require("./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.
+ */
+class QueueManager {
+  _tracks = [];
+  _repeatMode = _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);
+    (0, _shuffle.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 = (0, _validation.assertedNotNullish)(this.shuffleOrder[0]);
+      this.shuffleOrder[0] = (0, _validation.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.RepeatMode.Queue) return undefined;
+    return this._shuffleEnabled ? this.shuffleOrder[0] : 0;
+  }
+  wrapAroundLastIndex() {
+    if (this._repeatMode !== _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 = [];
+  }
+}
+exports.QueueManager = QueueManager;
+//# sourceMappingURL=QueueManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_validation","require","_shuffle","_RepeatMode","QueueManager","_tracks","_repeatMode","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","fisherYatesShuffle","currentPos","indexOf","first","assertedNotNullish","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","exports"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/QueueManager.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.QueuePlayer = void 0;
+var _Player = require("./Player");
+var _QueueManager = require("./QueueManager");
+var _RepeatMode = require("./RepeatMode");
+var _State = require("./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}.
+ */
+class QueuePlayer extends _Player.Player {
+  queue = new _QueueManager.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.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.State.Ended) {
+      this.onTrackEnded();
+    }
+  }
+
+  /** True when a natural end has nowhere to go: not repeating, no next track. */
+  endsQueue() {
+    return this.queue.repeatMode !== _RepeatMode.RepeatMode.Track && this.queue.repeatMode !== _RepeatMode.RepeatMode.Queue && this.queue.nextIndex() === undefined;
+  }
+  onTrackEnded() {
+    if (this.queue.repeatMode === _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);
+  }
+}
+exports.QueuePlayer = QueuePlayer;
+//# sourceMappingURL=QueuePlayer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_Player","require","_QueueManager","_RepeatMode","_State","QueuePlayer","Player","queue","QueueManager","applyState","state","State","Ended","endsQueue","playWhenReady","onTrackEnded","repeatMode","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","exports"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/QueuePlayer.ts"],"mappings":"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","ignoreList":[]}

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

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

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

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

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

@@ -8,12 +8,14 @@ exports.SleepTimerManager = void 0;
  * 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.
  */
 class SleepTimerManager {
   time = null;
   sleepWhenPlayedToEnd = false;
   timeoutId = null;
+  fadeTimeoutId = null;
   get isRunning() {
     return this.time !== null || this.sleepWhenPlayedToEnd;
   }
@@ -22,14 +24,23 @@ 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);
+    }
   }
 
   /**
@@ -38,6 +49,7 @@ class SleepTimerManager {
    */
   setToEndOfTrack() {
     this.stopTimer();
+    this.onFadeCancel();
     this.time = null;
     this.sleepWhenPlayedToEnd = true;
   }
@@ -50,6 +62,7 @@ class SleepTimerManager {
   clear() {
     const wasRunning = this.isRunning;
     this.stopTimer();
+    this.onFadeCancel();
     this.time = null;
     this.sleepWhenPlayedToEnd = false;
     return wasRunning;
@@ -59,9 +72,23 @@ 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() {
@@ -69,6 +96,10 @@ class SleepTimerManager {
       clearTimeout(this.timeoutId);
       this.timeoutId = null;
     }
+    if (this.fadeTimeoutId !== null) {
+      clearTimeout(this.fadeTimeoutId);
+      this.fadeTimeoutId = null;
+    }
   }
 }
 exports.SleepTimerManager = SleepTimerManager;

package/lib/commonjs/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","exports"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/SleepTimer.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACO,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;AAACc,OAAA,CAAAjB,iBAAA,GAAAA,iBAAA","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","exports"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/SleepTimer.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,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;AAACsB,OAAA,CAAA1B,iBAAA,GAAAA,iBAAA","ignoreList":[]}

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

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VolumeFader = void 0;
+/**
+ * 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.
+ */
+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);
+  }
+}
+exports.VolumeFader = VolumeFader;
+//# sourceMappingURL=VolumeFader.js.map

package/lib/commonjs/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","exports"],"sourceRoot":"../../../../src","sources":["web/TrackPlayer/VolumeFader.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACO,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;AAACoB,OAAA,CAAAtB,WAAA,GAAAA,WAAA","ignoreList":[]}