react-native-audio-browser 0.2.0-next.8 → 0.2.0

package/lib/module/features/browser.js

@@ -3,8 +3,161 @@
 import { nativeBrowser } from '../native';
 import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
 import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
-import { SEARCH_ROUTE_PATH, toNativeConfig, validateBrowserConfiguration } from './browser-config';
-let currentConfiguration;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration Transformation
+// ─────────────────────────────────────────────────────────────────────────────
+
+function isCallback(source) {
+  return typeof source === 'function';
+}
+function isTransformableRequestConfig(source) {
+  if (typeof source !== 'object' || source === null) return false;
+  const obj = source;
+  // Has request config properties (not a ResolvedTrack which has 'title')
+  return 'baseUrl' in obj || 'path' in obj || 'headers' in obj || 'query' in obj || 'transform' in obj;
+}
+function isRouteConfig(source) {
+  if (typeof source !== 'object' || source === null) return false;
+  const obj = source;
+  // RouteConfig has browse/media/artwork properties at the top level
+  return 'browse' in obj || 'media' in obj && !('baseUrl' in obj);
+}
+function flattenBrowseSource(source) {
+  if (!source) return {};
+  if (isCallback(source)) return {
+    browseCallback: source
+  };
+  if (isTransformableRequestConfig(source)) return {
+    browseConfig: source
+  };
+  return {
+    browseStatic: source
+  };
+}
+
+/**
+ * Converts a SearchSource to a NativeRouteEntry for the __search__ path.
+ */
+function searchSourceToRouteEntry(source) {
+  if (isCallback(source)) {
+    return {
+      path: SEARCH_ROUTE_PATH,
+      searchCallback: source
+    };
+  }
+  return {
+    path: SEARCH_ROUTE_PATH,
+    searchConfig: source
+  };
+}
+
+/**
+ * Wraps a Track[] into a ResolvedTrack for tabs.
+ * Tabs are represented as a special route that returns children.
+ */
+function wrapTracksAsResolvedTrack(tracks) {
+  return {
+    url: TABS_ROUTE_PATH,
+    title: 'Tabs',
+    children: tracks
+  };
+}
+
+/**
+ * Converts a TabsSource to a NativeRouteEntry for the __tabs__ path.
+ * Track[] is wrapped in ResolvedTrack, callbacks are wrapped to return ResolvedTrack.
+ */
+function tabsSourceToRouteEntry(source) {
+  if (Array.isArray(source)) {
+    // Static Track[] - wrap as ResolvedTrack
+    return {
+      path: TABS_ROUTE_PATH,
+      browseStatic: wrapTracksAsResolvedTrack(source)
+    };
+  }
+  if (isCallback(source)) {
+    // Callback returning Track[] - wrap to return ResolvedTrack
+    const wrappedCallback = async () => {
+      const tracks = await source();
+      return wrapTracksAsResolvedTrack(tracks);
+    };
+    return {
+      path: TABS_ROUTE_PATH,
+      browseCallback: wrappedCallback
+    };
+  }
+
+  // TransformableRequestConfig - native will handle wrapping the response
+  return {
+    path: TABS_ROUTE_PATH,
+    browseConfig: source
+  };
+}
+function flattenRouteEntry(path, source) {
+  if (isRouteConfig(source)) {
+    return {
+      path,
+      ...flattenBrowseSource(source.browse),
+      media: source.media,
+      artwork: source.artwork
+    };
+  }
+  return {
+    path,
+    ...flattenBrowseSource(source)
+  };
+}
+
+/** Internal path used for the default/root browse source */
+const DEFAULT_ROUTE_PATH = '__default__';
+
+/** Internal path used for navigation tabs */
+const TABS_ROUTE_PATH = '__tabs__';
+
+/** Internal path used for search */
+const SEARCH_ROUTE_PATH = '__search__';
+function flattenRoutes(routes, rootBrowse, tabs, search) {
+  const entries = [];
+
+  // Add explicit routes
+  if (routes) {
+    for (const [path, source] of Object.entries(routes)) {
+      entries.push(flattenRouteEntry(path, source));
+    }
+  }
+
+  // Add root browse as default fallback
+  if (rootBrowse) {
+    entries.push(flattenRouteEntry(DEFAULT_ROUTE_PATH, rootBrowse));
+  }
+
+  // Add tabs as special route
+  if (tabs) {
+    entries.push(tabsSourceToRouteEntry(tabs));
+  }
+
+  // Add search as special route
+  if (search) {
+    entries.push(searchSourceToRouteEntry(search));
+  }
+  return entries.length > 0 ? entries : undefined;
+}
+function toNativeConfig(config) {
+  return {
+    path: config.path,
+    request: config.request,
+    media: config.media,
+    artwork: config.artwork,
+    routes: flattenRoutes(config.routes, config.browse, config.tabs, config.search),
+    singleTrack: config.singleTrack,
+    handleTrackLoad: config.handleTrackLoad,
+    androidControllerOfflineError: config.androidControllerOfflineError,
+    carPlayUpNextButton: config.carPlayUpNextButton,
+    carPlayNowPlayingButtons: config.carPlayNowPlayingButtons,
+    formatNavigationError: config.formatNavigationError
+  };
+}
 
 /**
  * Configures the browser with routes, tabs, and other settings.
@@ -13,30 +166,13 @@ let currentConfiguration;
  * - Android Auto / CarPlay browsing integration
  * - Playback of browsable tracks via navigate()
  *
- * Calling this again REPLACES the entire configuration (no merging) and
- * re-runs initial navigation — external browse UIs such as CarPlay reset to
- * the first tab. For values that change at runtime (base URL, locale, auth
- * token), don't reconfigure: read them inside a `request`/`browse` resolver
- * or a `transform`, and call {@link invalidateAllContent} so every surface
- * re-fetches in place.
- *
  * @param configuration - Browser configuration including routes, tabs, media config, etc.
  *
  * @example
  * ```ts
  * configureBrowser({
- *   request: { baseUrl: 'https://api.example.com' },
  *   routes: {
- *     // `{id}` is a route parameter — see the `routes` docs for matching rules.
- *     '/albums/{id}': async ({ routeParams }) => fetchAlbumPage(routeParams?.id),
- *     // Remapping a browse path to a different API path requires a transform;
- *     // a static `path` on a request config does NOT rewrite the path.
- *     '/artists/{id}': {
- *       transformSync: (request, routeParams) => ({
- *         ...request,
- *         path: `/api/v2/artists/${routeParams?.id}`
- *       })
- *     }
+ *     '/albums/:id': { path: '/api/albums/:id' }
  *   },
  *   tabs: [
  *     { title: 'Home', url: '/' },
@@ -46,25 +182,8 @@ let currentConfiguration;
  * ```
  */
 export function configureBrowser(configuration) {
-  // __DEV__ is a React Native global; absent under plain node (vitest).
-  if (typeof __DEV__ !== 'undefined' && __DEV__) {
-    validateBrowserConfiguration(configuration);
-  }
-  currentConfiguration = configuration;
   nativeBrowser.configuration = toNativeConfig(configuration);
 }
-
-/**
- * Returns the configuration last passed to {@link configureBrowser}, in its
- * original public shape (the native getter exposes only the lowered internal
- * form). `undefined` until the browser is configured.
- *
- * Treat the returned object as read-only: it is the live reference, and
- * mutating it does NOT reconfigure the browser — call configureBrowser again.
- */
-export function getBrowserConfiguration() {
-  return currentConfiguration;
-}
 export function navigate(pathOrTrack) {
   if (typeof pathOrTrack === 'string') {
     return nativeBrowser.navigatePath(pathOrTrack);
@@ -110,22 +229,6 @@ export const notifyContentChanged = path => {
   nativeBrowser.notifyContentChanged(path);
 };
 
-/**
- * Invalidates all cached browse content and refreshes every currently-displayed
- * browse surface. Use when something app-wide changed (locale switch, sign-out,
- * etc.) and every browse path should re-fetch from its route handler — unlike
- * {@link notifyContentChanged}, which targets a single path.
- *
- * @example
- * ```ts
- * // After the user changes the app language
- * invalidateAllContent()
- * ```
- */
-export const invalidateAllContent = () => {
-  nativeBrowser.invalidateAllContent();
-};
-
 /**
  * Returns whether search functionality is configured via `configureBrowser({ search: ... })`.
  */

package/lib/module/features/browser.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","SEARCH_ROUTE_PATH","toNativeConfig","validateBrowserConfiguration","currentConfiguration","configureBrowser","configuration","__DEV__","getBrowserConfiguration","navigate","pathOrTrack","navigatePath","navigateTrack","getPath","path","onPathChanged","emitterize","cb","usePath","getContent","onContentChanged","useContent","getTabs","tabs","onTabsChanged","useTabs","notifyContentChanged","invalidateAllContent","hasSearch","config","searchRoute","routes","find","r","searchCallback","searchConfig","search","query","onSearch"],"sourceRoot":"../../../src","sources":["features/browser.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","isCallback","source","isTransformableRequestConfig","obj","isRouteConfig","flattenBrowseSource","browseCallback","browseConfig","browseStatic","searchSourceToRouteEntry","path","SEARCH_ROUTE_PATH","searchCallback","searchConfig","wrapTracksAsResolvedTrack","tracks","url","TABS_ROUTE_PATH","title","children","tabsSourceToRouteEntry","Array","isArray","wrappedCallback","flattenRouteEntry","browse","media","artwork","DEFAULT_ROUTE_PATH","flattenRoutes","routes","rootBrowse","tabs","search","entries","Object","push","length","undefined","toNativeConfig","config","request","singleTrack","handleTrackLoad","androidControllerOfflineError","carPlayUpNextButton","carPlayNowPlayingButtons","formatNavigationError","configureBrowser","configuration","navigate","pathOrTrack","navigatePath","navigateTrack","getPath","onPathChanged","emitterize","cb","usePath","getContent","onContentChanged","useContent","getTabs","onTabsChanged","useTabs","notifyContentChanged","hasSearch","searchRoute","find","r","query","onSearch"],"sourceRoot":"../../../src","sources":["features/browser.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/features/equalizer.js

@@ -44,7 +44,7 @@ export function setEqualizerLevels(levels) {
 /**
  * Subscribes to equalizer settings changes (Android only).
  * @param callback - Called when equalizer settings change
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onEqualizerChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onEqualizerChanged = cb);
 

package/lib/module/features/errors.js

@@ -6,36 +6,8 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
 
 // Re-export for Nitro spec
 
-/**
- * Normalized, cross-platform classification of a playback failure.
- *
- * Both platforms map their native failure onto this set, so consumers can
- * branch on it without knowing whether the error came from AVFoundation or
- * ExoPlayer. Use this — not `code` — for anything user-visible.
- *
- * - `'offline'` - The device had no network connection at the moment of
- *   failure. The stream itself may be fine.
- * - `'unreachable'` - The stream host could not be reached: DNS failure,
- *   connection refused, timed out, or the connection dropped while loading.
- * - `'not-found'` - The server said this stream is gone (HTTP 404 / 410).
- *   Retrying will not help; the station is dead.
- * - `'rejected'` - The server refused the request (HTTP 401 / 403), e.g.
- *   geo-blocking or an expired token.
- * - `'server-error'` - The server responded with 5xx. Usually transient.
- * - `'unplayable'` - The stream was fetched but cannot be played: unknown
- *   container, unsupported codec, or a decoder failure.
- * - `'stalled'` - Playback had started and then stopped, and the player
- *   exhausted its recovery budget without recovering.
- * - `'unknown'` - The failure could not be classified. Inspect `code`.
- */
-
 /**
  * Emitted when a playback error occurs.
- *
- * Terminal errors only: this fires on both edges of the `error` state —
- * entering it (with the error) and leaving it (with `error` undefined).
- * Errors the player is still retrying (`retrying: true`) are surfaced through
- * `onPlaybackChanged` instead, attached to the `loading`/`buffering` state.
  */
 
 /**
@@ -49,10 +21,6 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
  * - `'callback-error'` - The browse callback returned an error (e.g., `{ error: 'message' }`).
  *   Use this for business logic errors like authentication failures or subscription requirements.
  * - `'unknown-error'` - An unexpected error occurred (e.g., invalid configuration).
- * - `'empty-content'` - The path resolved successfully but the container has no children (e.g. an
- *   empty Favorites tab, a search with no results).
- * - `'timeout'` - The resolve did not complete within the allotted time (a stalled request or
- *   unresponsive bridge). Surfaced on External surfaces that render their own browse list.
  */
 
 /**
@@ -74,7 +42,7 @@ export function getPlaybackError() {
 /**
  * Subscribes to playback error events.
  * @param callback - Called when a playback error occurs
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onPlaybackError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackError = cb);
 
@@ -102,7 +70,7 @@ export function getNavigationError() {
 /**
  * Subscribes to navigation error events.
  * @param callback - Called when a navigation error occurs
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onNavigationError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onNavigationError = cb);
 
@@ -130,7 +98,7 @@ export function getFormattedNavigationError() {
 /**
  * Subscribes to formatted navigation error changes.
  * @param callback - Called when the formatted navigation error changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onFormattedNavigationError = cb);
 
@@ -138,7 +106,7 @@ export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => na
  * Hook that returns the current navigation error formatted for display.
  *
  * Native formats the error using the `formatNavigationError` callback configured
- * in `BrowserConfiguration`, or falls back to default English messages.
+ * in {@link BrowserConfiguration}, or falls back to default English messages.
  *
  * The same formatted error is used by CarPlay and Android Auto error dialogs,
  * ensuring consistent error presentation across your app and external controllers.
@@ -179,7 +147,7 @@ export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => na
  * })
  * ```
  *
- * @see `BrowserConfiguration.formatNavigationError` - Configure custom error formatting
+ * @see {@link BrowserConfiguration.formatNavigationError} - Configure custom error formatting
  * @see {@link useNavigationError} - Access the raw error with code and status details
  */
 export function useFormattedNavigationError() {

package/lib/module/features/errors.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlaybackError","onPlaybackError","emitterize","cb","usePlaybackError","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BH,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOL,qBAAqB,CAACC,gBAAgB,EAAEC,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,aAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BV,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACW,iBAAiB,GAAGL,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA,OAAO,SAASM,kBAAkBA,CAAA,EAAgC;EAChE,OAAOV,qBAAqB,CAACM,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,aAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,0BAA0B,GAAGb,kBAAkB,CAACI,UAAU,CAEpEC,EAAE,IAAMN,aAAa,CAACc,0BAA0B,GAAGR,EAAG,CAAC;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAqB,CAC1BW,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlaybackError","onPlaybackError","emitterize","cb","usePlaybackError","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAQA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BH,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOL,qBAAqB,CAACC,gBAAgB,EAAEC,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,aAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BV,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACW,iBAAiB,GAAGL,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA,OAAO,SAASM,kBAAkBA,CAAA,EAAgC;EAChE,OAAOV,qBAAqB,CAACM,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,aAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,0BAA0B,GAAGb,kBAAkB,CAACI,UAAU,CAEpEC,EAAE,IAAMN,aAAa,CAACc,0BAA0B,GAAGR,EAAG,CAAC;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAqB,CAC1BW,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}

package/lib/module/features/favorites.js

@@ -77,7 +77,7 @@ export function setFavorites(favorites) {
  * The native side has already updated the track's favorite state and UI.
  *
  * @param callback - Called with the track and its new favorite state
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  *
  * @example
  * ```ts

package/lib/module/features/index.js

@@ -14,9 +14,7 @@ export * from './playback';
 export * from './player';
 export * from './queue';
 export * from './battery';
-export * from './gate';
 export * from './browser';
-export * from './carConnection';
 export * from './equalizer';
 export * from './errors';
 export * from './favorites';

package/lib/module/features/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["features/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,UAAU;AACxB,cAAc,YAAY;AAC1B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,QAAQ;AACtB,cAAc,WAAW;AACzB,cAAc,iBAAiB;AAC/B,cAAc,aAAa;AAC3B,cAAc,UAAU;AACxB,cAAc,aAAa;AAC3B,cAAc,YAAY;AAC1B,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,kBAAkB;AAChC,cAAc,cAAc","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["features/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,UAAU;AACxB,cAAc,YAAY;AAC1B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,aAAa;AAC3B,cAAc,UAAU;AACxB,cAAc,aAAa;AAC3B,cAAc,YAAY;AAC1B,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,kBAAkB;AAChC,cAAc,cAAc","ignoreList":[]}

package/lib/module/features/metadata.js

@@ -31,21 +31,21 @@ import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
 /**
  * Subscribes to chapter metadata events.
  * @param callback - Called when chapter metadata is received
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onChapterMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onChapterMetadata = cb);
 
 /**
  * Subscribes to track metadata events.
  * @param callback - Called when static track metadata is received
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onTrackMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTrackMetadata = cb);
 
 /**
  * Subscribes to timed metadata events (ICY/ID3 from live streams).
  * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onTimedMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTimedMetadata = cb);
 //# sourceMappingURL=metadata.js.map

package/lib/module/features/metadata.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","onChapterMetadata","emitterize","cb","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAyBA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAoBA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,kBAAkB,CAACE,UAAU,CAE3DC,EAAE,IAAMJ,aAAa,CAACE,iBAAiB,GAAGE,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGJ,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACK,eAAe,GAAGD,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,eAAe,GAAGL,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACM,eAAe,GAAGF,EAC3C,CAAC","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","onChapterMetadata","emitterize","cb","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAoCA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAoBA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,kBAAkB,CAACE,UAAU,CAE3DC,EAAE,IAAMJ,aAAa,CAACE,iBAAiB,GAAGE,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGJ,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACK,eAAe,GAAGD,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,eAAe,GAAGL,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACM,eAAe,GAAGF,EAC3C,CAAC","ignoreList":[]}

package/lib/module/features/network.js

@@ -19,7 +19,7 @@ export function getOnline() {
 /**
  * Subscribes to network connectivity changes.
  * @param callback - Called when network state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onOnlineChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOnlineChanged = cb);
 

package/lib/module/features/nowPlaying.js

@@ -33,46 +33,13 @@ export function getNowPlaying() {
   return nativeBrowser.getNowPlaying() ?? undefined;
 }
 
-/**
- * Temporarily replaces now-playing fields for `durationMs`, then reverts to
- * the live metadata. The flash outranks the now-playing formatter and the
- * `updateNowPlaying` override while active (live metadata can't stomp it),
- * and the revert runs on a native timer — JS timers pause in a backgrounded
- * host (the lock screen case) — so it fires reliably. A track change clears
- * the flash early; repeated calls restart the window.
- *
- * The feedback channel for refused remote commands: external surfaces have
- * no toast primitive, so a transient metadata swap is the only way to talk
- * to the user there.
- *
- * @example
- * ```ts
- * // A radio product with an hourly skip allowance:
- * handleRemoteNext(() => {
- *   if (skipsRemaining() > 0) skipToNext()
- *   else flashNowPlaying({ artist: 'Skip limit reached' }, 3000)
- * })
- * ```
- */
-export function flashNowPlaying(update, durationMs) {
-  nativeBrowser.flashNowPlaying(update, durationMs);
-}
-
-/**
- * Clears an active flash immediately, reverting to the live metadata.
- * No-op when no flash is active.
- */
-export function clearNowPlayingFlash() {
-  nativeBrowser.clearNowPlayingFlash();
-}
-
 // MARK: - Event Callbacks
 
 /**
  * Subscribes to now playing metadata change events.
  * Fires when updateNowPlaying is called or when the track changes.
  * @param callback - Called when now playing metadata changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onNowPlayingChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onNowPlayingChanged = cb);
 

package/lib/module/features/nowPlaying.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateNowPlaying","update","undefined","getNowPlaying","flashNowPlaying","durationMs","clearNowPlayingFlash","onNowPlayingChanged","emitterize","cb","useNowPlaying"],"sourceRoot":"../../../src","sources":["features/nowPlaying.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,MAA+B,EAAQ;EACtEJ,aAAa,CAACG,gBAAgB,CAACC,MAAM,IAAIC,SAAS,CAAC;AACrD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAON,aAAa,CAACM,aAAa,CAAC,CAAC,IAAID,SAAS;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,eAAeA,CAC7BH,MAAwB,EACxBI,UAAkB,EACZ;EACNR,aAAa,CAACO,eAAe,CAACH,MAAM,EAAEI,UAAU,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAS;EAC3CT,aAAa,CAACS,oBAAoB,CAAC,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BT,kBAAkB,CAACU,UAAU,CAC1BC,EAAE,IAAMZ,aAAa,CAACU,mBAAmB,GAAGE,EAC/C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAOX,qBAAqB,CAACI,aAAa,EAAEI,mBAAmB,CAAC;AAClE","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateNowPlaying","update","undefined","getNowPlaying","onNowPlayingChanged","emitterize","cb","useNowPlaying"],"sourceRoot":"../../../src","sources":["features/nowPlaying.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,MAA+B,EAAQ;EACtEJ,aAAa,CAACG,gBAAgB,CAACC,MAAM,IAAIC,SAAS,CAAC;AACrD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAON,aAAa,CAACM,aAAa,CAAC,CAAC,IAAID,SAAS;AACnD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,mBAAmB,GAC9BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACO,mBAAmB,GAAGE,EAC/C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAOR,qBAAqB,CAACI,aAAa,EAAEC,mBAAmB,CAAC;AAClE","ignoreList":[]}

package/lib/module/features/output.js

@@ -6,55 +6,42 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
 // MARK: - Actions
 
 /**
- * Presents the system audio output switcher so the listener can move playback to
- * another output. Cross-platform:
- * - **iOS** — the system route picker (Bluetooth, AirPlay / Sonos-via-AirPlay,
- *   speaker). Always available.
- * - **Android** — the system Output Switcher (Bluetooth / speaker / Cast list) on
- *   Android 11+. No-op on older Android — gate on {@link supportsOutputSwitcher}.
- * - **Web** — no-op.
+ * Opens the system output picker (iOS only).
+ * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
+ * No-op on Android.
  */
-export function openOutputPicker() {
-  nativeBrowser.openOutputPicker();
-}
-
-/**
- * Whether {@link openOutputPicker} can present a switcher on this device — use it
- * to decide whether to surface the output control in your UI.
- * `true` on iOS and Android 11+ (API 30); `false` on older Android and web.
- */
-export function supportsOutputSwitcher() {
-  return nativeBrowser.supportsOutputSwitcher();
+export function openIosOutputPicker() {
+  nativeBrowser.openIosOutputPicker();
 }
 
 // MARK: - Getters
 
 /**
- * The current audio output, or `undefined` when unknown. iOS reports one while a
- * session is active; Android reports the active output route via AudioManager
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
- * for `undefined`.
+ * Gets the current audio output info.
+ * Always returns a value on iOS, undefined on Android.
  */
-export function getOutput() {
-  return nativeBrowser.getOutput();
+export function getIosOutput() {
+  return nativeBrowser.getIosOutput();
 }
 
 // MARK: - Event Callbacks
 
 /**
- * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
- * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * Subscribes to output state changes (iOS only).
+ * Never fires on Android.
+ * @param callback - Called with output info when output changes
+ * @returns Cleanup function to unsubscribe
  */
-export const onOutputChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOutputChanged = cb);
+export const onIosOutputChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onIosOutputChanged = cb);
 
 // MARK: - Hooks
 
 /**
- * Reactive current audio output; re-renders when it changes (e.g. AirPods
- * connect, a Bluetooth speaker is selected). `undefined` when unknown.
+ * Hook that returns the current audio output info.
+ * Updates when the output changes (e.g., AirPods connected/disconnected).
+ * Always returns a value on iOS, undefined on Android.
  */
-export function useOutput() {
-  return useNativeUpdatedValue(getOutput, onOutputChanged);
+export function useIosOutput() {
+  return useNativeUpdatedValue(getIosOutput, onIosOutputChanged);
 }
 //# sourceMappingURL=output.js.map

package/lib/module/features/output.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","openOutputPicker","supportsOutputSwitcher","getOutput","onOutputChanged","emitterize","cb","useOutput"],"sourceRoot":"../../../src","sources":["features/output.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;AAItE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAS;EACvCH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOJ,aAAa,CAACI,sBAAsB,CAAC,CAAC;AAC/C;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOL,aAAa,CAACK,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGL,kBAAkB,CAACM,UAAU,CACzDC,EAAE,IAAMR,aAAa,CAACM,eAAe,GAAGE,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOP,qBAAqB,CAACG,SAAS,EAAEC,eAAe,CAAC;AAC1D","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","openIosOutputPicker","getIosOutput","onIosOutputChanged","emitterize","cb","useIosOutput"],"sourceRoot":"../../../src","sources":["features/output.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;AAItE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAS;EAC1CH,aAAa,CAACG,mBAAmB,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAA,EAA0B;EACpD,OAAOJ,aAAa,CAACI,YAAY,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAGJ,kBAAkB,CAACK,UAAU,CAC5DC,EAAE,IAAMP,aAAa,CAACK,kBAAkB,GAAGE,EAC9C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAA,EAA0B;EACpD,OAAON,qBAAqB,CAACE,YAAY,EAAEC,kBAAkB,CAAC;AAChE","ignoreList":[]}

package/lib/module/features/playback/controls.js

@@ -59,14 +59,6 @@ export function seekTo(position) {
   nativeBrowser.seekTo(position);
 }
 
-/**
- * Jump to the live edge of the current track. No-op for non-live tracks; for
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
- */
-export function seekToLiveEdge() {
-  nativeBrowser.seekToLiveEdge();
-}
-
 /**
  * Seeks by a relative time offset in the current track.
  * @param offset - The time offset to seek by in seconds.

package/lib/module/features/playback/controls.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeBrowser","reset","play","pause","togglePlayback","stop","retry","seekTo","position","seekToLiveEdge","seekBy","offset"],"sourceRoot":"../../../../src","sources":["features/playback/controls.ts"],"mappings":";;AAAA;;AAEA,SAASA,aAAa,QAAQ,cAAc;;AAE5C;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BD,aAAa,CAACC,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAA,EAAS;EAC3BF,aAAa,CAACE,IAAI,CAAC,CAAC;AACtB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BH,aAAa,CAACG,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAS;EACrCJ,aAAa,CAACI,cAAc,CAAC,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAA,EAAS;EAC3BL,aAAa,CAACK,IAAI,CAAC,CAAC;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BN,aAAa,CAACM,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAACC,QAAgB,EAAQ;EAC7CR,aAAa,CAACO,MAAM,CAACC,QAAQ,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAS;EACrCT,aAAa,CAACS,cAAc,CAAC,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAACC,MAAc,EAAQ;EAC3CX,aAAa,CAACU,MAAM,CAACC,MAAM,CAAC;AAC9B","ignoreList":[]}
+{"version":3,"names":["nativeBrowser","reset","play","pause","togglePlayback","stop","retry","seekTo","position","seekBy","offset"],"sourceRoot":"../../../../src","sources":["features/playback/controls.ts"],"mappings":";;AAAA;;AAEA,SAASA,aAAa,QAAQ,cAAc;;AAE5C;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BD,aAAa,CAACC,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAA,EAAS;EAC3BF,aAAa,CAACE,IAAI,CAAC,CAAC;AACtB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BH,aAAa,CAACG,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAS;EACrCJ,aAAa,CAACI,cAAc,CAAC,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAA,EAAS;EAC3BL,aAAa,CAACK,IAAI,CAAC,CAAC;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAAA,EAAS;EAC5BN,aAAa,CAACM,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAACC,QAAgB,EAAQ;EAC7CR,aAAa,CAACO,MAAM,CAACC,QAAQ,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAACC,MAAc,EAAQ;EAC3CV,aAAa,CAACS,MAAM,CAACC,MAAM,CAAC;AAC9B","ignoreList":[]}

package/lib/module/features/playback/index.js

@@ -5,7 +5,6 @@ export * from './state';
 export * from './playing';
 export * from './playWhenReady';
 export * from './progress';
-export * from './trackPlaybackTime';
 export * from './rate';
 export * from './volume';
 //# sourceMappingURL=index.js.map

package/lib/module/features/playback/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["features/playback/index.ts"],"mappings":";;AAAA,cAAc,YAAY;AAC1B,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,qBAAqB;AACnC,cAAc,QAAQ;AACtB,cAAc,UAAU","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["features/playback/index.ts"],"mappings":";;AAAA,cAAc,YAAY;AAC1B,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,UAAU","ignoreList":[]}