react-native-queue-player 1.2.0 → 2.0.1

package/ios/Visualizer.swift

@@ -14,6 +14,7 @@ import NitroModules
 /// hops to main and builds a Nitro ArrayBuffer.
 final class Visualizer: HybridVisualizerSpec {
 
+  private static let currentLock = NSLock()
   /// The most recently constructed Visualizer instance. Held for
   /// JS-reload teardown parity with Android — a fresh construction
   /// tears the prior instance's subscriptions + consumer
@@ -23,7 +24,6 @@ final class Visualizer: HybridVisualizerSpec {
   /// Acquire `currentLock` when reading or writing [current] —
   /// `init()` runs on the JS bridge while a prior instance may be
   /// mid-dispatch on the render thread.
-  private static let currentLock = NSLock()
   private static var _current: Visualizer?
   static var current: Visualizer? {
     get {
@@ -52,8 +52,9 @@ final class Visualizer: HybridVisualizerSpec {
     let disposed: DisposedFlag
   }
 
-  /// Thread-safe one-way "disposed" latch shared by a subscription and the
-  /// emit blocks it has already enqueued onto the main queue.
+  /// Thread-safe "disposed" flag shared by a subscription and the emit blocks
+  /// it has already enqueued onto the main queue. `mark()` sets it; nothing
+  /// clears it.
   private final class DisposedFlag {
     private let lock = NSLock()
     private var value = false
@@ -65,12 +66,12 @@ final class Visualizer: HybridVisualizerSpec {
   private var subscriptions: [Subscription] = []
   private var nextId: Int = 1
 
+  private let assetLock = NSLock()
   /// Snapshot of the active asset — set from the audio-tap provider's
   /// `audioMix(for:)` path so `subscribe` can report `hls-source` for
   /// HLS streams without poking the TrackPlayer Hybrid. Held under its
   /// own lock so the render-thread-hot `subsLock` covers only the
   /// subscription array; main-thread asset writes never block render.
-  private let assetLock = NSLock()
   private var activeAsset: AVAsset?
 
   private let provider: AudioTapProvider
@@ -176,7 +177,7 @@ final class Visualizer: HybridVisualizerSpec {
       // throttle (default 16ms) caps the emit rate, which puts a
       // natural ceiling on main-queue accumulation.
       DispatchQueue.main.async {
-        // Drop frames queued before dispose — the disposer sets this latch
+        // Drop frames queued before dispose — the disposer sets this flag
         // before removing the subscription, so anything already on the main
         // queue short-circuits here rather than firing onFrame post-dispose.
         if disposed.isSet { return }

package/ios/tests-harness/Podfile

@@ -17,7 +17,7 @@
 
 require_relative '../../node_modules/react-native/scripts/react_native_pods'
 
-platform :ios, '15.1'
+platform :ios, '16.0'
 
 prepare_react_native_project!
 

package/ios/tests-harness/TestHost.xcodeproj/project.pbxproj

@@ -208,23 +208,29 @@
 			);
 			inputPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-TestHost/Pods-TestHost-resources.sh",
+				"${PODS_CONFIGURATION_BUILD_DIR}/GTMSessionFetcher/GTMSessionFetcher_Core_Privacy.bundle",
+				"${PODS_CONFIGURATION_BUILD_DIR}/GTMSessionFetcher/GTMSessionFetcher_Full_Privacy.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/QueuePlayer/QueuePlayer.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/React-Core/React-Core_privacy.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/React-cxxreact/React-cxxreact_privacy.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastCoreResources.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastUIResources.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastOptionalUIResources.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/MaterialDialogs.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansBold.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansMedium.bundle",
-				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.4_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansRegular.bundle",
+				"${PODS_CONFIGURATION_BUILD_DIR}/React-timing/React-timing_privacy.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastCoreResources.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastUIResources.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleCastOptionalUIResources.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/MaterialDialogs.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansBold.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansMedium.bundle",
+				"${PODS_ROOT}/google-cast-sdk/GoogleCastSDK-ios-4.8.6_static_xcframework/GoogleCast.xcframework/ios-arm64/GoogleCast.framework/GoogleSansRegular.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/google-cast-sdk/GoogleCast.bundle",
 			);
 			name = "[CP] Copy Pods Resources";
 			outputPaths = (
+				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/GTMSessionFetcher_Core_Privacy.bundle",
+				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/GTMSessionFetcher_Full_Privacy.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/QueuePlayer.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/React-Core_privacy.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/React-cxxreact_privacy.bundle",
+				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/React-timing_privacy.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/GoogleCastCoreResources.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/GoogleCastUIResources.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/GoogleCastOptionalUIResources.bundle",
@@ -264,7 +270,7 @@
 				CURRENT_PROJECT_VERSION = 1;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = TestHost/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = org.ghenry22.RNQueuePlayer.TestHost;
@@ -327,7 +333,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
@@ -339,6 +345,7 @@
 					"$(inherited)",
 					"-DRCT_REMOVE_LEGACY_ARCH=1",
 				);
+				PODFILE_DIR = "$(SRCROOT)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				REACT_NATIVE_PATH = "${PODS_ROOT}/../../../node_modules/react-native";
 				SDKROOT = iphoneos;
@@ -398,7 +405,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
@@ -410,6 +417,7 @@
 					"$(inherited)",
 					"-DRCT_REMOVE_LEGACY_ARCH=1",
 				);
+				PODFILE_DIR = "$(SRCROOT)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				REACT_NATIVE_PATH = "${PODS_ROOT}/../../../node_modules/react-native";
 				SDKROOT = iphoneos;
@@ -433,7 +441,7 @@
 				CURRENT_PROJECT_VERSION = 1;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = TestHost/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = org.ghenry22.RNQueuePlayer.TestHost;

package/ios/tests-harness/scripts/seed-xcodeproj.rb

@@ -41,7 +41,7 @@ end
 
 project = Xcodeproj::Project.new(PROJECT_PATH)
 
-target = project.new_target(:application, 'TestHost', :ios, '15.1', nil, :swift)
+target = project.new_target(:application, 'TestHost', :ios, '16.0', nil, :swift)
 
 host_group = project.new_group('TestHost', 'TestHost')
 app_ref = host_group.new_reference('App.swift')
@@ -64,7 +64,7 @@ project.build_configurations.each do |config|
     'GCC_C_LANGUAGE_STANDARD' => 'gnu17',
     'GCC_DYNAMIC_NO_PIC' => 'NO',
     'GCC_NO_COMMON_BLOCKS' => 'YES',
-    'IPHONEOS_DEPLOYMENT_TARGET' => '15.1',
+    'IPHONEOS_DEPLOYMENT_TARGET' => '16.0',
     'MTL_FAST_MATH' => 'YES',
     'ONLY_ACTIVE_ARCH' => 'YES',
     'SDKROOT' => 'iphoneos',

package/lib/module/hooks/useActiveTrack.js

@@ -11,39 +11,46 @@ const INITIAL = {
 /**
  * Subscribes to native `onTrackChange` updates.
  *
- * The first-render seed reads `getQueue()` and `getCurrentTrackIndex()`
- * separately — the pair is not atomic against a concurrent queue
- * mutation on either platform, so the seed can briefly observe the
- * new list with the old index (or vice versa). Self-healing: the
- * next `onTrackChange` event delivers a consistent
- * `(track, index, reason)` triple. Consumers needing an atomic
- * snapshot should wait for the first listener fire.
+ * Renders empty for the first frame, then fills in: the seed reads
+ * `getQueue()`, which resolves asynchronously, and pairs it with a separately
+ * read index — so it can briefly observe a new list against an old index. Any
+ * `onTrackChange` that arrives first wins and the seed is dropped, since the
+ * event delivers a consistent `(track, index, reason)` triple.
  */
 export function useActiveTrack() {
-  const [snapshot, setSnapshot] = useState(() => {
-    try {
-      const player = getTrackPlayer();
-      const queue = player.getQueue();
-      const index = player.getCurrentTrackIndex();
-      return {
-        track: index >= 0 && index < queue.length ? queue[index] : undefined,
-        index,
-        reason: 'queue-replaced'
-      };
-    } catch {
-      return INITIAL;
-    }
-  });
+  const [snapshot, setSnapshot] = useState(INITIAL);
   useEffect(() => {
     const player = getTrackPlayer();
+    let seeded = false;
+    // A seed still in flight when this effect is cleaned up (a StrictMode
+    // remount, an unmount) must not land on a later mount's state.
+    let disposed = false;
+    void (async () => {
+      try {
+        const queue = await player.getQueue();
+        const index = player.getCurrentTrackIndex();
+        if (disposed || seeded) return;
+        setSnapshot({
+          track: index >= 0 && index < queue.length ? queue[index] : undefined,
+          index,
+          reason: 'queue-replaced'
+        });
+      } catch {
+        // Player not configured yet; the first event seeds instead.
+      }
+    })();
     const dispose = player.onTrackChange((track, index, reason) => {
+      seeded = true;
       setSnapshot({
         track,
         index,
         reason
       });
     });
-    return dispose;
+    return () => {
+      disposed = true;
+      dispose();
+    };
   }, []);
   return snapshot;
 }

package/lib/module/hooks/useActiveTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","getTrackPlayer","INITIAL","track","undefined","index","reason","useActiveTrack","snapshot","setSnapshot","player","queue","getQueue","getCurrentTrackIndex","length","dispose","onTrackChange"],"sourceRoot":"../../../src","sources":["hooks/useActiveTrack.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,cAAc,QAAQ,eAAY;AAW3C,MAAMC,OAA4B,GAAG;EACnCC,KAAK,EAAEC,SAAS;EAChBC,KAAK,EAAE,CAAC,CAAC;EACTC,MAAM,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAwB;EACpD,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGT,QAAQ,CAAsB,MAAM;IAClE,IAAI;MACF,MAAMU,MAAM,GAAGT,cAAc,CAAC,CAAC;MAC/B,MAAMU,KAAK,GAAGD,MAAM,CAACE,QAAQ,CAAC,CAAC;MAC/B,MAAMP,KAAK,GAAGK,MAAM,CAACG,oBAAoB,CAAC,CAAC;MAC3C,OAAO;QACLV,KAAK,EAAEE,KAAK,IAAI,CAAC,IAAIA,KAAK,GAAGM,KAAK,CAACG,MAAM,GAAGH,KAAK,CAACN,KAAK,CAAC,GAAGD,SAAS;QACpEC,KAAK;QACLC,MAAM,EAAE;MACV,CAAC;IACH,CAAC,CAAC,MAAM;MACN,OAAOJ,OAAO;IAChB;EACF,CAAC,CAAC;EAEFH,SAAS,CAAC,MAAM;IACd,MAAMW,MAAM,GAAGT,cAAc,CAAC,CAAC;IAC/B,MAAMc,OAAO,GAAGL,MAAM,CAACM,aAAa,CAAC,CAACb,KAAK,EAAEE,KAAK,EAAEC,MAAM,KAAK;MAC7DG,WAAW,CAAC;QAAEN,KAAK;QAAEE,KAAK;QAAEC;MAAO,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,OAAOS,OAAO;EAChB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOP,QAAQ;AACjB","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","getTrackPlayer","INITIAL","track","undefined","index","reason","useActiveTrack","snapshot","setSnapshot","player","seeded","disposed","queue","getQueue","getCurrentTrackIndex","length","dispose","onTrackChange"],"sourceRoot":"../../../src","sources":["hooks/useActiveTrack.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,cAAc,QAAQ,eAAY;AAW3C,MAAMC,OAA4B,GAAG;EACnCC,KAAK,EAAEC,SAAS;EAChBC,KAAK,EAAE,CAAC,CAAC;EACTC,MAAM,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAwB;EACpD,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGT,QAAQ,CAAsBE,OAAO,CAAC;EAEtEH,SAAS,CAAC,MAAM;IACd,MAAMW,MAAM,GAAGT,cAAc,CAAC,CAAC;IAC/B,IAAIU,MAAM,GAAG,KAAK;IAClB;IACA;IACA,IAAIC,QAAQ,GAAG,KAAK;IACpB,KAAK,CAAC,YAAY;MAChB,IAAI;QACF,MAAMC,KAAK,GAAG,MAAMH,MAAM,CAACI,QAAQ,CAAC,CAAC;QACrC,MAAMT,KAAK,GAAGK,MAAM,CAACK,oBAAoB,CAAC,CAAC;QAC3C,IAAIH,QAAQ,IAAID,MAAM,EAAE;QACxBF,WAAW,CAAC;UACVN,KAAK,EAAEE,KAAK,IAAI,CAAC,IAAIA,KAAK,GAAGQ,KAAK,CAACG,MAAM,GAAGH,KAAK,CAACR,KAAK,CAAC,GAAGD,SAAS;UACpEC,KAAK;UACLC,MAAM,EAAE;QACV,CAAC,CAAC;MACJ,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC,EAAE,CAAC;IACJ,MAAMW,OAAO,GAAGP,MAAM,CAACQ,aAAa,CAAC,CAACf,KAAK,EAAEE,KAAK,EAAEC,MAAM,KAAK;MAC7DK,MAAM,GAAG,IAAI;MACbF,WAAW,CAAC;QAAEN,KAAK;QAAEE,KAAK;QAAEC;MAAO,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,OAAO,MAAM;MACXM,QAAQ,GAAG,IAAI;MACfK,OAAO,CAAC,CAAC;IACX,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOT,QAAQ;AACjB","ignoreList":[]}

package/lib/module/hooks/useCast.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import { useEffect, useState } from 'react';
-import { addDiscoveryStateListener, addLocalNetworkPermissionListener, addReceiversListener, addRouteListener, addSessionDiedListener, getCurrentRoute, getReceivers, getSupportedProtocols, isCastAvailable, isDiscovering, localRoute } from "../cast/index.js";
+import { addDiscoveryStateListener, addLocalNetworkPermissionListener, addReceiversListener, addRouteListener, addSessionDiedListener, getCurrentRoute, getLocalNetworkPermissionState, getReceivers, getSupportedProtocols, isCastAvailable, isDiscovering, localRoute } from "../cast/index.js";
 const INITIAL = {
   supportedProtocols: [],
   isAvailable: false,
@@ -33,7 +33,7 @@ export function useCast() {
         route: getCurrentRoute(),
         isDiscovering: isDiscovering(),
         lastSessionDied: null,
-        permission: 'undetermined'
+        permission: getLocalNetworkPermissionState()
       };
     } catch {
       return INITIAL;
@@ -42,39 +42,25 @@ export function useCast() {
   useEffect(() => {
     if (!isCastAvailable()) return;
 
-    // Each `addXxxListener` synchronously replays the current value on
-    // subscribe. The initial `useState` initializer already captured
-    // every initial value; skipping the first replay per stream avoids
-    // five back-to-back `setSnapshot` calls on mount.
-    let firstRoute = true;
-    let firstReceivers = true;
-    let firstDiscovery = true;
-    let firstPermission = true;
+    // Each `addXxxListener` replays the current value synchronously on
+    // subscribe, and every delivery is applied: a replay that equals the
+    // `useState` seed costs one batched render, while a replay that differs
+    // is a change that landed between the render and this effect — dropping
+    // it would leave the snapshot on the stale seed (on Android the
+    // permission replay is the only delivery there ever is).
     const routeSub = addRouteListener(route => {
-      if (firstRoute) {
-        firstRoute = false;
-        return;
-      }
       setSnapshot(prev => ({
         ...prev,
         route
       }));
     });
     const receiversSub = addReceiversListener(receivers => {
-      if (firstReceivers) {
-        firstReceivers = false;
-        return;
-      }
       setSnapshot(prev => ({
         ...prev,
         receivers
       }));
     });
     const discoverySub = addDiscoveryStateListener(state => {
-      if (firstDiscovery) {
-        firstDiscovery = false;
-        return;
-      }
       setSnapshot(prev => ({
         ...prev,
         isDiscovering: state.isDiscovering
@@ -85,10 +71,6 @@ export function useCast() {
       lastSessionDied: event
     })));
     const permissionSub = addLocalNetworkPermissionListener(event => {
-      if (firstPermission) {
-        firstPermission = false;
-        return;
-      }
       setSnapshot(prev => ({
         ...prev,
         permission: event.state

package/lib/module/hooks/useCast.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","addDiscoveryStateListener","addLocalNetworkPermissionListener","addReceiversListener","addRouteListener","addSessionDiedListener","getCurrentRoute","getReceivers","getSupportedProtocols","isCastAvailable","isDiscovering","localRoute","INITIAL","supportedProtocols","isAvailable","receivers","route","lastSessionDied","permission","useCast","snapshot","setSnapshot","protocols","length","firstRoute","firstReceivers","firstDiscovery","firstPermission","routeSub","prev","receiversSub","discoverySub","state","deathSub","event","permissionSub","remove"],"sourceRoot":"../../../src","sources":["hooks/useCast.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","addDiscoveryStateListener","addLocalNetworkPermissionListener","addReceiversListener","addRouteListener","addSessionDiedListener","getCurrentRoute","getLocalNetworkPermissionState","getReceivers","getSupportedProtocols","isCastAvailable","isDiscovering","localRoute","INITIAL","supportedProtocols","isAvailable","receivers","route","lastSessionDied","permission","useCast","snapshot","setSnapshot","protocols","length","routeSub","prev","receiversSub","discoverySub","state","deathSub","event","permissionSub","remove"],"sourceRoot":"../../../src","sources":["hooks/useCast.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SACEC,yBAAyB,EACzBC,iCAAiC,EACjCC,oBAAoB,EACpBC,gBAAgB,EAChBC,sBAAsB,EACtBC,eAAe,EACfC,8BAA8B,EAC9BC,YAAY,EACZC,qBAAqB,EACrBC,eAAe,EACfC,aAAa,EACbC,UAAU,QAML,kBAAS;AA2BhB,MAAMC,OAAqB,GAAG;EAC5BC,kBAAkB,EAAE,EAAE;EACtBC,WAAW,EAAE,KAAK;EAClBC,SAAS,EAAE,EAAE;EACbC,KAAK,EAAEL,UAAU,CAAC,CAAC;EACnBD,aAAa,EAAE,KAAK;EACpBO,eAAe,EAAE,IAAI;EACrBC,UAAU,EAAE;AACd,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CAAA,EAAiB;EACtC,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGtB,QAAQ,CAAe,MAAM;IAC3D,IAAI;MACF,MAAMuB,SAAS,GAAGd,qBAAqB,CAAC,CAAC;MACzC,OAAO;QACLK,kBAAkB,EAAES,SAAS;QAC7BR,WAAW,EAAEQ,SAAS,CAACC,MAAM,GAAG,CAAC;QACjCR,SAAS,EAAER,YAAY,CAAC,CAAC;QACzBS,KAAK,EAAEX,eAAe,CAAC,CAAC;QACxBK,aAAa,EAAEA,aAAa,CAAC,CAAC;QAC9BO,eAAe,EAAE,IAAI;QACrBC,UAAU,EAAEZ,8BAA8B,CAAC;MAC7C,CAAC;IACH,CAAC,CAAC,MAAM;MACN,OAAOM,OAAO;IAChB;EACF,CAAC,CAAC;EAEFd,SAAS,CAAC,MAAM;IACd,IAAI,CAACW,eAAe,CAAC,CAAC,EAAE;;IAExB;IACA;IACA;IACA;IACA;IACA;IACA,MAAMe,QAAQ,GAAGrB,gBAAgB,CAAEa,KAAK,IAAK;MAC3CK,WAAW,CAAEI,IAAI,KAAM;QAAE,GAAGA,IAAI;QAAET;MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,MAAMU,YAAY,GAAGxB,oBAAoB,CAAEa,SAAS,IAAK;MACvDM,WAAW,CAAEI,IAAI,KAAM;QAAE,GAAGA,IAAI;QAAEV;MAAU,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;IACF,MAAMY,YAAY,GAAG3B,yBAAyB,CAAE4B,KAAK,IAAK;MACxDP,WAAW,CAAEI,IAAI,KAAM;QAAE,GAAGA,IAAI;QAAEf,aAAa,EAAEkB,KAAK,CAAClB;MAAc,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;IACF,MAAMmB,QAAQ,GAAGzB,sBAAsB,CAAE0B,KAAK,IAC5CT,WAAW,CAAEI,IAAI,KAAM;MAAE,GAAGA,IAAI;MAAER,eAAe,EAAEa;IAAM,CAAC,CAAC,CAC7D,CAAC;IACD,MAAMC,aAAa,GAAG9B,iCAAiC,CAAE6B,KAAK,IAAK;MACjET,WAAW,CAAEI,IAAI,KAAM;QAAE,GAAGA,IAAI;QAAEP,UAAU,EAAEY,KAAK,CAACF;MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,OAAO,MAAM;MACXJ,QAAQ,CAACQ,MAAM,CAAC,CAAC;MACjBN,YAAY,CAACM,MAAM,CAAC,CAAC;MACrBL,YAAY,CAACK,MAAM,CAAC,CAAC;MACrBH,QAAQ,CAACG,MAAM,CAAC,CAAC;MACjBD,aAAa,CAACC,MAAM,CAAC,CAAC;IACxB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOZ,QAAQ;AACjB","ignoreList":[]}

package/lib/module/hooks/useEqualizer.js

@@ -3,7 +3,8 @@
 import { useCallback, useEffect, useState } from 'react';
 import { getEqualizer } from "../clients.js";
 /**
- * Subscribes to Equalizer band-change events and exposes imperative setters.
+ * Subscribes to Equalizer band-change and enabled-change events and
+ * exposes imperative setters.
  * Initial state is pulled synchronously on mount so consumers don't flash
  * empty bands.
  */
@@ -31,20 +32,27 @@ export function useEqualizer() {
   });
   useEffect(() => {
     const eq = getEqualizer();
-    const dispose = eq.onBandChange(updated => {
+    const disposeBands = eq.onBandChange(updated => {
       setBands(updated);
     });
-    return dispose;
+    const disposeEnabled = eq.onEnabledChange(next => {
+      setEnabledState(next);
+    });
+    return () => {
+      disposeBands();
+      disposeEnabled();
+    };
   }, []);
   const setEnabled = useCallback(async next => {
     const eq = getEqualizer();
     await eq.setEnabled(next);
-    // Read back rather than echoing the requested value: the native
-    // side may reject (or coerce) the change in a future build, and
-    // mirroring its actual state keeps JS aligned without a separate
-    // `onEnabledChange` event. Fall back to the requested value when
-    // the read-back throws (today's behaviour against the
-    // unimplemented native — matches the seed's try/catch on init).
+    // `isEnabled()` is the authority on what the native side committed,
+    // so read it back rather than echoing the request. `onEnabledChange`
+    // has already delivered the same value — both platforms emit it
+    // synchronously inside `setEnabled`'s promise body — which makes this
+    // a redundant write on the happy path and the only correction if a
+    // future native build stops emitting. Fall back to the requested
+    // value when the read-back throws, matching the seed's try/catch.
     try {
       setEnabledState(eq.isEnabled());
     } catch {
@@ -61,9 +69,8 @@ export function useEqualizer() {
     await getEqualizer().applyPreset(name);
   }, []);
 
-  // TODO: wire onPresetsChange when added to Equalizer.nitro.ts —
-  // until then, save/delete refresh the local presets list with a
-  // manual sync re-fetch.
+  // The spec carries no presets-changed event, so save and delete
+  // re-read `getPresets()` themselves to refresh the local list.
   const saveCustomPreset = useCallback(async name => {
     await getEqualizer().saveCustomPreset(name);
     setPresets(getEqualizer().getPresets());

package/lib/module/hooks/useEqualizer.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","useState","getEqualizer","useEqualizer","enabled","setEnabledState","isEnabled","bands","setBands","getBands","presets","setPresets","getPresets","eq","dispose","onBandChange","updated","setEnabled","next","setBandGain","index","gainDb","setAllBandGains","gains","applyPreset","name","saveCustomPreset","deleteCustomPreset","reset"],"sourceRoot":"../../../src","sources":["hooks/useEqualizer.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AACxD,SAASC,YAAY,QAAQ,eAAY;AAgBzC;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAuB;EACjD,MAAM,CAACC,OAAO,EAAEC,eAAe,CAAC,GAAGJ,QAAQ,CAAU,MAAM;IACzD,IAAI;MACF,OAAOC,YAAY,CAAC,CAAC,CAACI,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC,MAAM;MACN,OAAO,KAAK;IACd;EACF,CAAC,CAAC;EACF,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGP,QAAQ,CAAkB,MAAM;IACxD,IAAI;MACF,OAAOC,YAAY,CAAC,CAAC,CAACO,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,MAAM;MACN,OAAO,EAAE;IACX;EACF,CAAC,CAAC;EACF,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGV,QAAQ,CAAoB,MAAM;IAC9D,IAAI;MACF,OAAOC,YAAY,CAAC,CAAC,CAACU,UAAU,CAAC,CAAC;IACpC,CAAC,CAAC,MAAM;MACN,OAAO,EAAE;IACX;EACF,CAAC,CAAC;EAEFZ,SAAS,CAAC,MAAM;IACd,MAAMa,EAAE,GAAGX,YAAY,CAAC,CAAC;IACzB,MAAMY,OAAO,GAAGD,EAAE,CAACE,YAAY,CAAEC,OAAO,IAAK;MAC3CR,QAAQ,CAACQ,OAAO,CAAC;IACnB,CAAC,CAAC;IACF,OAAOF,OAAO;EAChB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,UAAU,GAAGlB,WAAW,CAAC,MAAOmB,IAAa,IAAK;IACtD,MAAML,EAAE,GAAGX,YAAY,CAAC,CAAC;IACzB,MAAMW,EAAE,CAACI,UAAU,CAACC,IAAI,CAAC;IACzB;IACA;IACA;IACA;IACA;IACA;IACA,IAAI;MACFb,eAAe,CAACQ,EAAE,CAACP,SAAS,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,MAAM;MACND,eAAe,CAACa,IAAI,CAAC;IACvB;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,WAAW,GAAGpB,WAAW,CAAC,OAAOqB,KAAa,EAAEC,MAAc,KAAK;IACvE,MAAMnB,YAAY,CAAC,CAAC,CAACiB,WAAW,CAACC,KAAK,EAAEC,MAAM,CAAC;EACjD,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,eAAe,GAAGvB,WAAW,CAAC,MAAOwB,KAAe,IAAK;IAC7D,MAAMrB,YAAY,CAAC,CAAC,CAACoB,eAAe,CAACC,KAAK,CAAC;EAC7C,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,WAAW,GAAGzB,WAAW,CAAC,MAAO0B,IAAY,IAAK;IACtD,MAAMvB,YAAY,CAAC,CAAC,CAACsB,WAAW,CAACC,IAAI,CAAC;EACxC,CAAC,EAAE,EAAE,CAAC;;EAEN;EACA;EACA;EACA,MAAMC,gBAAgB,GAAG3B,WAAW,CAAC,MAAO0B,IAAY,IAAK;IAC3D,MAAMvB,YAAY,CAAC,CAAC,CAACwB,gBAAgB,CAACD,IAAI,CAAC;IAC3Cd,UAAU,CAACT,YAAY,CAAC,CAAC,CAACU,UAAU,CAAC,CAAC,CAAC;EACzC,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMe,kBAAkB,GAAG5B,WAAW,CAAC,MAAO0B,IAAY,IAAK;IAC7D,MAAMvB,YAAY,CAAC,CAAC,CAACyB,kBAAkB,CAACF,IAAI,CAAC;IAC7Cd,UAAU,CAACT,YAAY,CAAC,CAAC,CAACU,UAAU,CAAC,CAAC,CAAC;EACzC,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMgB,KAAK,GAAG7B,WAAW,CAAC,YAAY;IACpC,MAAMG,YAAY,CAAC,CAAC,CAAC0B,KAAK,CAAC,CAAC;EAC9B,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLxB,OAAO;IACPG,KAAK;IACLG,OAAO;IACPO,UAAU;IACVE,WAAW;IACXG,eAAe;IACfE,WAAW;IACXE,gBAAgB;IAChBC,kBAAkB;IAClBC;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useState","getEqualizer","useEqualizer","enabled","setEnabledState","isEnabled","bands","setBands","getBands","presets","setPresets","getPresets","eq","disposeBands","onBandChange","updated","disposeEnabled","onEnabledChange","next","setEnabled","setBandGain","index","gainDb","setAllBandGains","gains","applyPreset","name","saveCustomPreset","deleteCustomPreset","reset"],"sourceRoot":"../../../src","sources":["hooks/useEqualizer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useLookaheadCache.js

@@ -20,13 +20,9 @@ const INITIAL = {
  * and drop the lookahead count).
  */
 export function useLookaheadCache() {
-  const [status, setStatus] = useState(() => {
-    try {
-      return getTrackPlayer().getLookaheadCacheStatus();
-    } catch {
-      return INITIAL;
-    }
-  });
+  // Seeded by the listener's own first fire, which delivers current status on
+  // registration — no getter call, so this survives the getter being async.
+  const [status, setStatus] = useState(INITIAL);
   useEffect(() => {
     const player = getTrackPlayer();
     const dispose = player.onCacheStatusChange(next => {

package/lib/module/hooks/useLookaheadCache.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","useState","getTrackPlayer","INITIAL","enabled","currentSizeMb","maxSizeMb","tracksFullyCached","currentlyCaching","useLookaheadCache","status","setStatus","getLookaheadCacheStatus","player","dispose","onCacheStatusChange","next","setConfig","config","setLookaheadCache","clear","clearLookaheadCache"],"sourceRoot":"../../../src","sources":["hooks/useLookaheadCache.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AACxD,SAASC,cAAc,QAAQ,eAAY;AAS3C;AACA;AACA;AACA;AACA,MAAMC,OAAoB,GAAG;EAC3BC,OAAO,EAAE,KAAK;EACdC,aAAa,EAAE,CAAC;EAChBC,SAAS,EAAE,GAAG;EACdC,iBAAiB,EAAE,CAAC;EACpBC,gBAAgB,EAAE;AACpB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAA4B;EAC3D,MAAM,CAACC,MAAM,EAAEC,SAAS,CAAC,GAAGV,QAAQ,CAAc,MAAM;IACtD,IAAI;MACF,OAAOC,cAAc,CAAC,CAAC,CAACU,uBAAuB,CAAC,CAAC;IACnD,CAAC,CAAC,MAAM;MACN,OAAOT,OAAO;IAChB;EACF,CAAC,CAAC;EAEFH,SAAS,CAAC,MAAM;IACd,MAAMa,MAAM,GAAGX,cAAc,CAAC,CAAC;IAC/B,MAAMY,OAAO,GAAGD,MAAM,CAACE,mBAAmB,CAAEC,IAAI,IAAK;MACnDL,SAAS,CAACK,IAAI,CAAC;IACjB,CAAC,CAAC;IACF,OAAOF,OAAO;EAChB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,SAAS,GAAGlB,WAAW,CAAC,MAAOmB,MAA4B,IAAK;IACpE,MAAMhB,cAAc,CAAC,CAAC,CAACiB,iBAAiB,CAACD,MAAM,CAAC;EAClD,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,KAAK,GAAGrB,WAAW,CAAC,YAAY;IACpC,MAAMG,cAAc,CAAC,CAAC,CAACmB,mBAAmB,CAAC,CAAC;EAC9C,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IAAEX,MAAM;IAAEO,SAAS;IAAEG;EAAM,CAAC;AACrC","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useState","getTrackPlayer","INITIAL","enabled","currentSizeMb","maxSizeMb","tracksFullyCached","currentlyCaching","useLookaheadCache","status","setStatus","player","dispose","onCacheStatusChange","next","setConfig","config","setLookaheadCache","clear","clearLookaheadCache"],"sourceRoot":"../../../src","sources":["hooks/useLookaheadCache.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AACxD,SAASC,cAAc,QAAQ,eAAY;AAS3C;AACA;AACA;AACA;AACA,MAAMC,OAAoB,GAAG;EAC3BC,OAAO,EAAE,KAAK;EACdC,aAAa,EAAE,CAAC;EAChBC,SAAS,EAAE,GAAG;EACdC,iBAAiB,EAAE,CAAC;EACpBC,gBAAgB,EAAE;AACpB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAA4B;EAC3D;EACA;EACA,MAAM,CAACC,MAAM,EAAEC,SAAS,CAAC,GAAGV,QAAQ,CAAcE,OAAO,CAAC;EAE1DH,SAAS,CAAC,MAAM;IACd,MAAMY,MAAM,GAAGV,cAAc,CAAC,CAAC;IAC/B,MAAMW,OAAO,GAAGD,MAAM,CAACE,mBAAmB,CAAEC,IAAI,IAAK;MACnDJ,SAAS,CAACI,IAAI,CAAC;IACjB,CAAC,CAAC;IACF,OAAOF,OAAO;EAChB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,SAAS,GAAGjB,WAAW,CAAC,MAAOkB,MAA4B,IAAK;IACpE,MAAMf,cAAc,CAAC,CAAC,CAACgB,iBAAiB,CAACD,MAAM,CAAC;EAClD,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,KAAK,GAAGpB,WAAW,CAAC,YAAY;IACpC,MAAMG,cAAc,CAAC,CAAC,CAACkB,mBAAmB,CAAC,CAAC;EAC9C,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IAAEV,MAAM;IAAEM,SAAS;IAAEG;EAAM,CAAC;AACrC","ignoreList":[]}

package/lib/module/hooks/useQueue.js

@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from 'react';
 import { getTrackPlayer } from "../clients.js";
+import { applyQueueDelta } from "../queueDelta.js";
 const INITIAL = {
   queue: [],
   currentIndex: -1
@@ -13,30 +14,75 @@ const INITIAL = {
  * `onTrackChange` so `currentIndex` stays live on auto-advance / skip,
  * which move the active position without changing the queue contents.
  *
- * The first-render seed reads `getQueue()` + `getCurrentTrackIndex()`
- * separately — the pair is not atomic against a concurrent mutation, so
- * it can briefly skew. Self-healing: the first `onQueueChange` /
- * `onTrackChange` fire delivers a consistent snapshot.
+ * Renders empty for the first frame, then fills in: the seed reads
+ * `getQueue()`, which resolves asynchronously. A mutation landing in that gap
+ * is not lost: a delta that arrives before the seed lands cannot be applied —
+ * there is nothing correct to apply it to — so the queue is re-read instead.
  */
 export function useQueue() {
-  const [snapshot, setSnapshot] = useState(() => {
-    try {
-      const player = getTrackPlayer();
-      return {
-        queue: player.getQueue(),
-        currentIndex: player.getCurrentTrackIndex()
-      };
-    } catch {
-      return INITIAL;
-    }
-  });
+  const [snapshot, setSnapshot] = useState(INITIAL);
   useEffect(() => {
     const player = getTrackPlayer();
-    const offQueue = player.onQueueChange((queue, currentIndex) => {
-      setSnapshot({
-        queue,
-        currentIndex
+    let disposed = false;
+    // `haveBase` is what makes a delta applicable: without a queue to apply it
+    // to, applying one silently produces a wrong mirror — and for `shuffle`, an
+    // array of holes. `seenEvent` separately stops a slow seed overwriting
+    // newer state.
+    let haveBase = false;
+    let seenEvent = false;
+    let revision = 0;
+    // Guards against two overlapping re-reads resolving out of order.
+    let readTicket = 0;
+    const reread = () => {
+      const ticket = ++readTicket;
+      // Until this read lands there is no base a delta can be applied to:
+      // an event arriving meanwhile re-reads too, and the ticket keeps the
+      // last read's answer.
+      haveBase = false;
+      void player.getQueue().then(queue => {
+        if (disposed || ticket !== readTicket) return;
+        haveBase = true;
+        // Re-read the index too: the queue just came from a fresh read, and
+        // the index captured when the event fired may already be stale.
+        setSnapshot({
+          queue,
+          currentIndex: player.getCurrentTrackIndex()
+        });
+      }).catch(() => {
+        // Player not configured yet; a later event re-reads.
       });
+    };
+    void (async () => {
+      try {
+        const ticket = ++readTicket;
+        const queue = await player.getQueue();
+        const currentIndex = player.getCurrentTrackIndex();
+        if (disposed || seenEvent || ticket !== readTicket) return;
+        haveBase = true;
+        setSnapshot({
+          queue,
+          currentIndex
+        });
+      } catch {
+        // Player not configured yet; the first event re-reads instead.
+      }
+    })();
+
+    // A delta only makes sense against the copy it was computed from, so a
+    // missed event — or one that beats the seed — is recovered by re-reading
+    // rather than patched over.
+    const offQueue = player.onQueueChange((delta, currentIndex, reason) => {
+      seenEvent = true;
+      const missed = revision !== 0 && delta.revision !== revision + 1;
+      revision = delta.revision;
+      if (!haveBase || missed) {
+        reread();
+        return;
+      }
+      setSnapshot(prev => ({
+        queue: applyQueueDelta(prev.queue, delta, reason),
+        currentIndex
+      }));
     });
     // Keep `currentIndex` live when the active track changes without a
     // queue-content change (auto-advance, skip). Preserves the queue from
@@ -48,6 +94,7 @@ export function useQueue() {
       }));
     });
     return () => {
+      disposed = true;
       offQueue();
       offTrack();
     };

package/lib/module/hooks/useQueue.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","getTrackPlayer","INITIAL","queue","currentIndex","useQueue","snapshot","setSnapshot","player","getQueue","getCurrentTrackIndex","offQueue","onQueueChange","offTrack","onTrackChange","_track","index","prev"],"sourceRoot":"../../../src","sources":["hooks/useQueue.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,cAAc,QAAQ,eAAY;AAU3C,MAAMC,OAAsB,GAAG;EAAEC,KAAK,EAAE,EAAE;EAAEC,YAAY,EAAE,CAAC;AAAE,CAAC;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAA,EAAkB;EACxC,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGP,QAAQ,CAAgB,MAAM;IAC5D,IAAI;MACF,MAAMQ,MAAM,GAAGP,cAAc,CAAC,CAAC;MAC/B,OAAO;QACLE,KAAK,EAAEK,MAAM,CAACC,QAAQ,CAAC,CAAC;QACxBL,YAAY,EAAEI,MAAM,CAACE,oBAAoB,CAAC;MAC5C,CAAC;IACH,CAAC,CAAC,MAAM;MACN,OAAOR,OAAO;IAChB;EACF,CAAC,CAAC;EAEFH,SAAS,CAAC,MAAM;IACd,MAAMS,MAAM,GAAGP,cAAc,CAAC,CAAC;IAC/B,MAAMU,QAAQ,GAAGH,MAAM,CAACI,aAAa,CAAC,CAACT,KAAK,EAAEC,YAAY,KAAK;MAC7DG,WAAW,CAAC;QAAEJ,KAAK;QAAEC;MAAa,CAAC,CAAC;IACtC,CAAC,CAAC;IACF;IACA;IACA;IACA,MAAMS,QAAQ,GAAGL,MAAM,CAACM,aAAa,CAAC,CAACC,MAAM,EAAEC,KAAK,KAAK;MACvDT,WAAW,CAAEU,IAAI,KAAM;QAAEd,KAAK,EAAEc,IAAI,CAACd,KAAK;QAAEC,YAAY,EAAEY;MAAM,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC;IACF,OAAO,MAAM;MACXL,QAAQ,CAAC,CAAC;MACVE,QAAQ,CAAC,CAAC;IACZ,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOP,QAAQ;AACjB","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","getTrackPlayer","applyQueueDelta","INITIAL","queue","currentIndex","useQueue","snapshot","setSnapshot","player","disposed","haveBase","seenEvent","revision","readTicket","reread","ticket","getQueue","then","getCurrentTrackIndex","catch","offQueue","onQueueChange","delta","reason","missed","prev","offTrack","onTrackChange","_track","index"],"sourceRoot":"../../../src","sources":["hooks/useQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -27,11 +27,14 @@ export { SectionIcon } from "./types.js";
 // `getEqualizer()` API for consumers building EQ UIs.
 export { EQ_BAND_COUNT, EQ_BAND_FREQUENCIES_HZ, EQ_FLAT_PRESET_NAME, EQ_GAIN_MAX_DB, EQ_GAIN_MIN_DB, clampGain, gainsFromBands, gainsFromMap, isBuiltinPreset, nearestBandIndex } from "./equalizer.js";
 
+// Pure helper for applying an onQueueChange delta to a queue copy.
+export { applyQueueDelta } from "./queueDelta.js";
+
 // React hooks — thin observers over the HybridObject event surface.
 export * from "./hooks/index.js";
 
-// Cast — Promise-based wrappers + listener subscriptions around the
-// `CastManager` HybridObject. Consumers can either reach in via
-// `getCastManager()` directly or import from `react-native-queue-player/cast`.
+// Cast — `Cast.*`: thin functions over the `CastManager` HybridObject
+// (optional-argument shapes, `CastSubscription` handles, `CastErrorCodes`,
+// `localRoute()`); `getCastManager()` returns the HybridObject itself.
 export * as Cast from "./cast/index.js";
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["getCastManager","getEqualizer","getTrackPlayer","getVisualizer","registerPlaybackService","unregisterPlaybackService","crossfadeDurationBounds","SectionIcon","EQ_BAND_COUNT","EQ_BAND_FREQUENCIES_HZ","EQ_FLAT_PRESET_NAME","EQ_GAIN_MAX_DB","EQ_GAIN_MIN_DB","clampGain","gainsFromBands","gainsFromMap","isBuiltinPreset","nearestBandIndex","Cast"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;;AAMA;;AAwEA;AACA;AACA;AACA,SAASA,cAAc,EAAEC,YAAY,EAAEC,cAAc,EAAEC,aAAa,QAAQ,cAAW;;AAEvF;AACA;AACA;AACA,SACEC,uBAAuB,EACvBC,yBAAyB,QACpB,sBAAmB;AAM1B;AACA;AACA,SAASC,uBAAuB,QAAQ,YAAS;;AAEjD;AACA;AACA;AACA,SAASC,WAAW,QAAQ,YAAS;;AAErC;AACA;AACA;AACA,SACEC,aAAa,EACbC,sBAAsB,EACtBC,mBAAmB,EACnBC,cAAc,EACdC,cAAc,EACdC,SAAS,EACTC,cAAc,EACdC,YAAY,EACZC,eAAe,EACfC,gBAAgB,QACX,gBAAa;;AAEpB;AACA,cAAc,kBAAS;;AAEvB;AACA;AACA;AACA,OAAO,KAAKC,IAAI,MAAM,iBAAQ","ignoreList":[]}
+{"version":3,"names":["getCastManager","getEqualizer","getTrackPlayer","getVisualizer","registerPlaybackService","unregisterPlaybackService","crossfadeDurationBounds","SectionIcon","EQ_BAND_COUNT","EQ_BAND_FREQUENCIES_HZ","EQ_FLAT_PRESET_NAME","EQ_GAIN_MAX_DB","EQ_GAIN_MIN_DB","clampGain","gainsFromBands","gainsFromMap","isBuiltinPreset","nearestBandIndex","applyQueueDelta","Cast"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;;AAMA;;AA+EA;AACA;AACA;AACA,SAASA,cAAc,EAAEC,YAAY,EAAEC,cAAc,EAAEC,aAAa,QAAQ,cAAW;;AAEvF;AACA;AACA;AACA,SACEC,uBAAuB,EACvBC,yBAAyB,QACpB,sBAAmB;AAM1B;AACA;AACA,SAASC,uBAAuB,QAAQ,YAAS;;AAEjD;AACA;AACA;AACA,SAASC,WAAW,QAAQ,YAAS;;AAErC;AACA;AACA;AACA,SACEC,aAAa,EACbC,sBAAsB,EACtBC,mBAAmB,EACnBC,cAAc,EACdC,cAAc,EACdC,SAAS,EACTC,cAAc,EACdC,YAAY,EACZC,eAAe,EACfC,gBAAgB,QACX,gBAAa;;AAEpB;AACA,SAASC,eAAe,QAAQ,iBAAc;;AAE9C;AACA,cAAc,kBAAS;;AAEvB;AACA;AACA;AACA,OAAO,KAAKC,IAAI,MAAM,iBAAQ","ignoreList":[]}