vue-micro-router 1.0.19 → 1.0.22

package/dist/audio.d.ts

@@ -33,6 +33,8 @@ export declare interface AudioAdapter {
 export declare interface AudioManagerConfig {
     /** Volume ref (0-100). Defaults to 100. */
     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). */

package/dist/audio.mjs

@@ -1,100 +1,5 @@
-import { ref as v, computed as C, watch as P } from "vue";
-import { d as S } from "./timer-manager.mjs";
-class b {
-  constructor() {
-    this.sound = null, this.howlCtorPromise = null;
-  }
-  /** Lazy-load Howler.js — only imported when first sound is played */
-  async getHowlCtor() {
-    return this.howlCtorPromise || (this.howlCtorPromise = import("howler").then((s) => s.Howl)), this.howlCtorPromise;
-  }
-  async play(s, u = {}) {
-    this.stop();
-    const t = await this.getHowlCtor();
-    this.sound = new t({
-      src: [s],
-      autoplay: !0,
-      loop: u.loop ?? !1,
-      volume: 0
-    }), this.sound.fade(0, u.volume ?? 1, 200);
-  }
-  stop() {
-    try {
-      this.sound && (this.sound.stop(), this.sound.off(), this.sound.unload(), this.sound = null);
-    } catch {
-      this.sound = null;
-    }
-  }
-  pause() {
-    var s;
-    (s = this.sound) != null && s.playing() && this.sound.pause();
-  }
-  resume() {
-    this.sound && this.state() === "loaded" && this.sound.play();
-  }
-  fade(s, u, t) {
-    var a;
-    (a = this.sound) != null && a.playing() && this.sound.fade(s, u, t);
-  }
-  isPlaying() {
-    var s;
-    return ((s = this.sound) == null ? void 0 : s.playing()) ?? !1;
-  }
-  state() {
-    return this.sound ? this.sound.state() : "unloaded";
-  }
-  cleanup() {
-    this.stop();
-  }
-}
-function g(o) {
-  let s = !1, u = "default";
-  const t = (o == null ? void 0 : o.adapter) ?? new b(), a = v("default"), c = (o == null ? void 0 : o.urlResolver) ?? ((e) => e), d = C(() => {
-    var e;
-    return (((e = o == null ? void 0 : o.volumeRef) == null ? void 0 : e.value) ?? 100) / 100;
-  });
-  async function h(e, n = !1) {
-    try {
-      if (t.isPlaying() && a.value === e) return;
-      u = a.value, a.value = e, t.stop(), await S(50), await t.play(c(e), { loop: n, volume: d.value });
-    } catch (l) {
-      console.error("Sound playback failed:", l), t.stop();
-    }
-  }
-  function f() {
-    t.stop();
-  }
-  async function y(e, n) {
-    if (n)
-      try {
-        const l = e.split("/").pop() || "home", r = n.get(l), i = (r == null ? void 0 : r.bgm) || a.value, p = u;
-        p && i && p !== i && await h(i, !0);
-      } catch (l) {
-        console.error("Error updating background music:", l);
-      }
-  }
-  function m() {
-    if (!(typeof document > "u"))
-      try {
-        document.hidden ? t.isPlaying() && (t.pause(), s = !0) : s && t.state() === "loaded" && (t.resume(), s = !1);
-      } catch {
-        t.stop();
-      }
-  }
-  function w() {
-    t.cleanup();
-  }
-  return P(d, (e, n) => {
-    t.isPlaying() && t.fade(n ?? 0, e, 300);
-  }), {
-    playSound: h,
-    stopSound: f,
-    updateBackgroundMusic: y,
-    handleVisibilityChange: m,
-    cleanup: w
-  };
-}
+import { H as r, u as o } from "./use-audio-manager.mjs";
 export {
-  b as HowlerAdapter,
-  g as useAudioManager
+  r as HowlerAdapter,
+  o as useAudioManager
 };

package/dist/index.d.ts

@@ -413,8 +413,12 @@ export declare interface MicroRouterConfig {
     };
     /** Analytics hooks for page/dialog/control enter/leave events */
     tracker?: PageTrackerHooks;
-    /** Reactive volume ref (0-100) for audio manager. Only used with vue-micro-router/audio */
+    /** 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 */
+    defaultBgm?: string;
+    /** Resolve audio name to URL. Defaults to identity. Example: (name) => `/audios/${name}.mp3` */
+    audioUrlResolver?: (name: string) => string;
 }
 
 /**
@@ -559,6 +563,8 @@ export declare interface NavigationState {
     getRouteAttrs: (segment: string) => Record<string, unknown> | undefined;
     /** Manually preload an async route component */
     preloadRoute: (segment: string) => Promise<void>;
+    /** Registered route definitions — used internally by audio manager for BGM lookup */
+    routes: Map<string, MicroRoute>;
     /** Navigation history (only populated when config.history.enabled) */
     history?: NavigationHistory;
     cleanup: () => void;