vue-micro-router 1.0.26 → 1.0.29

package/dist/audio.d.ts

@@ -14,6 +14,11 @@ export declare interface AudioAdapter {
         loop?: boolean;
         volume?: number;
     }): Promise<void>;
+    /** Synchronous play — must work without await for user gesture context. Optional — falls back to play(). */
+    playSync?(src: string, options: {
+        loop?: boolean;
+        volume?: number;
+    }): void;
     /** Stop and unload the current sound */
     stop(): void;
     /** Pause playback (preserves position) */
@@ -35,29 +40,35 @@ export declare interface AudioManagerConfig {
     volumeRef?: Ref<number>;
     /** Default BGM track name — played on mount and used as fallback. Defaults to 'default'. */
     defaultBgm?: string;
-    /** Resolve a sound name to a full URL. Defaults to identity (name returned as-is). */
-    urlResolver?: (name: string) => string;
     /** Custom audio adapter. Defaults to HowlerAdapter (requires howler peer dep). */
     adapter?: AudioAdapter;
 }
 
 export declare interface AudioManagerState {
     playSound: (soundSrc: string, loop?: boolean) => Promise<void>;
+    /** Synchronous play — no async gaps, safe in user gesture context for autoplay policy */
+    playSoundSync: (soundSrc: string, loop?: boolean) => void;
     stopSound: () => void;
     updateBackgroundMusic: (route: string, routes?: Map<string, MicroRoute>) => Promise<void>;
     handleVisibilityChange: () => void;
+    /** Whether audio has successfully started playing at least once */
+    isStarted: () => boolean;
     cleanup: () => void;
 }
 
 export declare class HowlerAdapter implements AudioAdapter {
     private sound;
-    private howlCtorPromise;
-    /** Lazy-load Howler.js — only imported when first sound is played */
-    private getHowlCtor;
+    private HowlCtor;
+    constructor();
     play(src: string, options?: {
         loop?: boolean;
         volume?: number;
     }): Promise<void>;
+    /** Fully synchronous play — uses preloaded HowlCtor. No-op if not preloaded yet. */
+    playSync(src: string, options?: {
+        loop?: boolean;
+        volume?: number;
+    }): void;
     stop(): void;
     pause(): void;
     resume(): void;

package/dist/index.d.ts

@@ -415,10 +415,10 @@ export declare interface MicroRouterConfig {
     tracker?: PageTrackerHooks;
     /** Reactive volume ref (0-100) for audio manager. Enables built-in BGM when provided. */
     volumeRef?: Ref<number>;
-    /** Default BGM track name — used as initial track and fallback when route has no bgm field */
+    /** Default BGM audio path — used as initial track and fallback when route has no bgm field. Example: '/audios/default.mp3' */
     defaultBgm?: string;
-    /** Resolve audio name to URL. Defaults to identity. Example: (name) => `/audios/${name}.mp3` */
-    audioUrlResolver?: (name: string) => string;
+    /** Set to true (in a user gesture handler) to start default BGM. Watched with flush:'sync' to preserve gesture context for autoplay policy. */
+    bgmStartRef?: Ref<boolean>;
 }
 
 /**