wevu 6.7.2 → 6.7.4

package/dist/router-5qgy8oOS.mjs

@@ -0,0 +1,329 @@
+import { n as isRef, r as markAsRef, v as isObject } from "./ref-BeA_Is-2.mjs";
+//#region src/reactivity/readonly.ts
+function readonly(target) {
+	if (isRef(target)) {
+		const source = target;
+		return markAsRef({
+			get value() {
+				return source.value;
+			},
+			set value(_v) {
+				throw new Error("无法给只读 ref 赋值");
+			}
+		});
+	}
+	if (!isObject(target)) return target;
+	return new Proxy(target, {
+		set() {
+			throw new Error("无法在只读对象上设置属性");
+		},
+		deleteProperty() {
+			throw new Error("无法在只读对象上删除属性");
+		},
+		defineProperty() {
+			throw new Error("无法在只读对象上定义属性");
+		},
+		get(target, key, receiver) {
+			return Reflect.get(target, key, receiver);
+		}
+	});
+}
+//#endregion
+//#region src/runtime/platform.ts
+function getGlobalRuntime() {
+	if (typeof globalThis === "undefined") return;
+	return globalThis;
+}
+function getMiniProgramGlobalObject() {
+	var _env;
+	const globalRuntime = getGlobalRuntime();
+	const compiledPlatform = (_env = import.meta.env) === null || _env === void 0 ? void 0 : _env.PLATFORM;
+	if (compiledPlatform === "tt") return globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.tt;
+	if (compiledPlatform === "alipay" || compiledPlatform === "my") return globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.my;
+	if (compiledPlatform === "weapp" || compiledPlatform === "wx") return globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.wx;
+	if (globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.wx) return globalRuntime.wx;
+	if (globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.my) return globalRuntime.my;
+	if (globalRuntime === null || globalRuntime === void 0 ? void 0 : globalRuntime.tt) return globalRuntime.tt;
+}
+function getScopedSlotHostGlobalObject() {
+	var _getMiniProgramGlobal;
+	return (_getMiniProgramGlobal = getMiniProgramGlobalObject()) !== null && _getMiniProgramGlobal !== void 0 ? _getMiniProgramGlobal : getGlobalRuntime();
+}
+//#endregion
+//#region src/runtime/hooks/base.ts
+let __currentInstance;
+let __currentSetupContext;
+function getCurrentInstance() {
+	return __currentInstance;
+}
+/**
+* 设置当前运行时实例（框架内部使用）。
+* @internal
+*/
+function setCurrentInstance(inst) {
+	__currentInstance = inst;
+}
+function getCurrentSetupContext() {
+	return __currentSetupContext;
+}
+/**
+* 设置当前 setup 上下文（框架内部使用）。
+* @internal
+*/
+function setCurrentSetupContext(ctx) {
+	__currentSetupContext = ctx;
+}
+function assertInSetup(name) {
+	if (!__currentInstance) throw new Error(`${name}() 必须在 setup() 的同步阶段调用`);
+	return __currentInstance;
+}
+function ensureHookBucket(target) {
+	if (!target.__wevuHooks) target.__wevuHooks = Object.create(null);
+	return target.__wevuHooks;
+}
+function pushHook(target, name, handler, { single = false } = {}) {
+	const bucket = ensureHookBucket(target);
+	if (single) bucket[name] = handler;
+	else {
+		var _bucket$name;
+		((_bucket$name = bucket[name]) !== null && _bucket$name !== void 0 ? _bucket$name : bucket[name] = []).push(handler);
+	}
+}
+function ensureSinglePageHookOnInstance(target, name) {
+	var _ref, _ref$__wevuShareHookB;
+	const bridges = (_ref$__wevuShareHookB = (_ref = target).__wevuShareHookBridges) !== null && _ref$__wevuShareHookB !== void 0 ? _ref$__wevuShareHookB : _ref.__wevuShareHookBridges = Object.create(null);
+	if (typeof bridges[name] === "function") return;
+	const original = target[name];
+	const bridge = function onWevuShareHookBridge(...args) {
+		var _runtime$proxy;
+		const hooks = this.__wevuHooks;
+		const entry = hooks === null || hooks === void 0 ? void 0 : hooks[name];
+		const runtime = this.__wevu;
+		const ctx = (_runtime$proxy = runtime === null || runtime === void 0 ? void 0 : runtime.proxy) !== null && _runtime$proxy !== void 0 ? _runtime$proxy : this;
+		let ret;
+		if (typeof entry === "function") try {
+			ret = entry.apply(ctx, args);
+		} catch (_unused) {
+			ret = void 0;
+		}
+		else if (Array.isArray(entry)) for (const fn of entry) try {
+			ret = fn.apply(ctx, args);
+		} catch (_unused2) {}
+		if (ret !== void 0) return ret;
+		if (typeof original === "function") return original.apply(this, args);
+	};
+	bridges[name] = bridge;
+	target[name] = bridge;
+}
+function ensurePageShareMenusOnSetup(target) {
+	var _target$__wevuHooks;
+	const wxGlobal = getMiniProgramGlobalObject();
+	if (!wxGlobal || typeof wxGlobal.showShareMenu !== "function") return;
+	const hooks = (_target$__wevuHooks = target.__wevuHooks) !== null && _target$__wevuHooks !== void 0 ? _target$__wevuHooks : {};
+	const hasShareAppMessage = typeof hooks.onShareAppMessage === "function";
+	const hasShareTimeline = typeof hooks.onShareTimeline === "function";
+	if (!hasShareAppMessage && !hasShareTimeline) return;
+	const menus = ["shareAppMessage"];
+	if (hasShareTimeline) menus.push("shareTimeline");
+	try {
+		wxGlobal.showShareMenu({
+			withShareTicket: true,
+			menus
+		});
+	} catch (_unused3) {}
+}
+/**
+* 调用批量 hook（框架内部调度入口）。
+* @internal
+*/
+function callHookList(target, name, args = []) {
+	var _runtime$proxy2;
+	const hooks = target.__wevuHooks;
+	if (!hooks) return;
+	const list = hooks[name];
+	if (!list) return;
+	const runtime = target.__wevu;
+	const ctx = (_runtime$proxy2 = runtime === null || runtime === void 0 ? void 0 : runtime.proxy) !== null && _runtime$proxy2 !== void 0 ? _runtime$proxy2 : target;
+	if (Array.isArray(list)) for (const fn of list) try {
+		fn.apply(ctx, args);
+	} catch (_unused4) {}
+	else if (typeof list === "function") try {
+		list.apply(ctx, args);
+	} catch (_unused5) {}
+}
+/**
+* 调用返回值型 hook（框架内部调度入口）。
+* @internal
+*/
+function callHookReturn(target, name, args = []) {
+	var _runtime$proxy3;
+	const hooks = target.__wevuHooks;
+	if (!hooks) return;
+	const entry = hooks[name];
+	if (!entry) return;
+	const runtime = target.__wevu;
+	const ctx = (_runtime$proxy3 = runtime === null || runtime === void 0 ? void 0 : runtime.proxy) !== null && _runtime$proxy3 !== void 0 ? _runtime$proxy3 : target;
+	if (typeof entry === "function") try {
+		return entry.apply(ctx, args);
+	} catch (_unused6) {
+		return;
+	}
+	if (Array.isArray(entry)) {
+		let out;
+		for (const fn of entry) try {
+			out = fn.apply(ctx, args);
+		} catch (_unused7) {}
+		return out;
+	}
+}
+//#endregion
+//#region src/runtime/hooks/register.ts
+function registerHook(name, handler, options) {
+	pushHook(assertInSetup(name), name, handler, options);
+}
+function onLaunch(handler) {
+	registerHook("onLaunch", handler);
+}
+function onPageNotFound(handler) {
+	registerHook("onPageNotFound", handler);
+}
+function onUnhandledRejection(handler) {
+	registerHook("onUnhandledRejection", handler);
+}
+function onThemeChange(handler) {
+	registerHook("onThemeChange", handler);
+}
+function onMemoryWarning(handler) {
+	registerHook("onMemoryWarning", handler);
+}
+function onShow(handler) {
+	registerHook("onShow", handler);
+}
+function onLoad(handler) {
+	registerHook("onLoad", handler);
+}
+function onHide(handler) {
+	registerHook("onHide", handler);
+}
+function onUnload(handler) {
+	registerHook("onUnload", handler);
+}
+function onReady(handler) {
+	registerHook("onReady", handler);
+}
+function onPullDownRefresh(handler) {
+	registerHook("onPullDownRefresh", handler);
+}
+function onReachBottom(handler) {
+	registerHook("onReachBottom", handler);
+}
+function onPageScroll(handler) {
+	registerHook("onPageScroll", handler);
+}
+function onRouteDone(handler) {
+	registerHook("onRouteDone", handler);
+}
+function onTabItemTap(handler) {
+	registerHook("onTabItemTap", handler);
+}
+function onResize(handler) {
+	registerHook("onResize", handler);
+}
+function onMoved(handler) {
+	registerHook("onMoved", handler);
+}
+function onAttached(handler) {
+	registerHook("onAttached", handler);
+}
+function onDetached(handler) {
+	registerHook("onDetached", handler);
+}
+function onError(handler) {
+	registerHook("onError", handler);
+}
+function onSaveExitState(handler) {
+	registerHook("onSaveExitState", handler, { single: true });
+}
+function onShareAppMessage(handler) {
+	const instance = assertInSetup("onShareAppMessage");
+	pushHook(instance, "onShareAppMessage", handler, { single: true });
+	ensureSinglePageHookOnInstance(instance, "onShareAppMessage");
+	ensurePageShareMenusOnSetup(instance);
+}
+function onShareTimeline(handler) {
+	const instance = assertInSetup("onShareTimeline");
+	pushHook(instance, "onShareTimeline", handler, { single: true });
+	ensureSinglePageHookOnInstance(instance, "onShareTimeline");
+	ensurePageShareMenusOnSetup(instance);
+}
+function onAddToFavorites(handler) {
+	const instance = assertInSetup("onAddToFavorites");
+	pushHook(instance, "onAddToFavorites", handler, { single: true });
+	ensureSinglePageHookOnInstance(instance, "onAddToFavorites");
+}
+//#endregion
+//#region src/runtime/vueCompat/router.ts
+const RUNTIME_ROUTER_METHODS = [
+	"switchTab",
+	"reLaunch",
+	"redirectTo",
+	"navigateTo",
+	"navigateBack"
+];
+function isRuntimeRouter(candidate) {
+	if (!candidate || typeof candidate !== "object") return false;
+	return RUNTIME_ROUTER_METHODS.every((methodName) => {
+		return typeof candidate[methodName] === "function";
+	});
+}
+function createGlobalRouterFallback() {
+	const miniProgramGlobal = getMiniProgramGlobalObject();
+	if (!miniProgramGlobal) return;
+	const fallbackRouter = Object.create(null);
+	for (const methodName of RUNTIME_ROUTER_METHODS) {
+		const handler = miniProgramGlobal[methodName];
+		if (typeof handler !== "function") return;
+		fallbackRouter[methodName] = (...args) => handler.apply(miniProgramGlobal, args);
+	}
+	return fallbackRouter;
+}
+function useRuntimeRouterByAccessor(primaryAccessor, fallbackAccessor, helperName) {
+	const ctx = getCurrentSetupContext();
+	if (!(ctx === null || ctx === void 0 ? void 0 : ctx.instance)) throw new Error(`${helperName}() 必须在 setup() 的同步阶段调用`);
+	const nativeInstance = ctx.instance;
+	const primaryRouter = nativeInstance[primaryAccessor];
+	if (isRuntimeRouter(primaryRouter)) return primaryRouter;
+	const fallbackRouter = nativeInstance[fallbackAccessor];
+	if (isRuntimeRouter(fallbackRouter)) return fallbackRouter;
+	const globalFallbackRouter = createGlobalRouterFallback();
+	if (globalFallbackRouter) return globalFallbackRouter;
+	throw new Error("当前运行环境不支持 Router，请升级微信基础库到 2.16.1+ 或检查平台路由能力");
+}
+/**
+* 在 setup 中获取与当前组件路径语义一致的原生 Router 对象。
+*
+* - 优先使用实例上的 `this.router`（组件路径语义）。
+* - 不可用时回退到 `this.pageRouter`。
+* - 低版本基础库再回退到全局 `wx.*` 路由方法。
+*
+* 如需更贴近 Vue Router 的高阶能力（导航守卫、失败类型、统一解析），
+* 推荐改用 `wevu/router` 子入口的 `useRouter()`。
+*/
+function useNativeRouter() {
+	return useRuntimeRouterByAccessor("router", "pageRouter", "useNativeRouter");
+}
+/**
+* 在 setup 中获取与当前页面路径语义一致的原生 Router 对象。
+*
+* - 优先使用实例上的 `this.pageRouter`（页面路径语义）。
+* - 不可用时回退到 `this.router`。
+* - 低版本基础库再回退到全局 `wx.*` 路由方法。
+*
+* 如需更贴近 Vue Router 的高阶能力（导航守卫、失败类型、统一解析），
+* 推荐改用 `wevu/router` 子入口的 `useRouter()`。
+*/
+function useNativePageRouter() {
+	return useRuntimeRouterByAccessor("pageRouter", "router", "useNativePageRouter");
+}
+//#endregion
+export { getCurrentInstance as A, onTabItemTap as C, assertInSetup as D, onUnload as E, getMiniProgramGlobalObject as F, getScopedSlotHostGlobalObject as I, readonly as L, pushHook as M, setCurrentInstance as N, callHookList as O, setCurrentSetupContext as P, onShow as S, onUnhandledRejection as T, onResize as _, onDetached as a, onShareAppMessage as b, onLaunch as c, onMoved as d, onPageNotFound as f, onReady as g, onReachBottom as h, onAttached as i, getCurrentSetupContext as j, callHookReturn as k, onLoad as l, onPullDownRefresh as m, useNativeRouter as n, onError as o, onPageScroll as p, onAddToFavorites as r, onHide as s, useNativePageRouter as t, onMemoryWarning as u, onRouteDone as v, onThemeChange as w, onShareTimeline as x, onSaveExitState as y };

package/dist/router-BxV0btOX.d.mts

@@ -0,0 +1,46 @@
+//#region src/runtime/types/props/router.d.ts
+/**
+ * Router 路由类型映射（供声明合并扩展）。
+ *
+ * 典型用法：在业务项目的类型声明中补充 `entries` 联合类型，
+ * 让 `useNativeRouter()/useNativePageRouter()` 的 `url` 参数获得字面量约束。
+ */
+interface WevuTypedRouterRouteMap {}
+type ResolveTypedRouterEntries = WevuTypedRouterRouteMap extends {
+  entries: infer Entries;
+} ? Extract<Entries, string> : string;
+type ResolveTypedRouterTabBarEntries = WevuTypedRouterRouteMap extends {
+  tabBarEntries: infer Entries;
+} ? Extract<Entries, string> : ResolveTypedRouterEntries;
+type RelativeRouterUrl = `./${string}` | `../${string}`;
+type AbsoluteRouterPath<Path extends string> = Path | `/${Path}`;
+type AbsoluteRouterUrl<Path extends string> = AbsoluteRouterPath<Path> | `${Path}?${string}` | `/${Path}?${string}`;
+type RouterUrl<Path extends string> = string extends Path ? string : AbsoluteRouterUrl<Path> | RelativeRouterUrl;
+type RouterPathUrl<Path extends string> = string extends Path ? string : AbsoluteRouterPath<Path>;
+type TypedRouterUrl = RouterUrl<ResolveTypedRouterEntries>;
+type TypedRouterTabBarUrl = RouterPathUrl<ResolveTypedRouterTabBarEntries>;
+type RouterSwitchTabOption = Omit<WechatMiniprogram.SwitchTabOption, 'url'> & {
+  url: TypedRouterTabBarUrl;
+};
+type RouterReLaunchOption = Omit<WechatMiniprogram.ReLaunchOption, 'url'> & {
+  url: TypedRouterUrl;
+};
+type RouterRedirectToOption = Omit<WechatMiniprogram.RedirectToOption, 'url'> & {
+  url: TypedRouterUrl;
+};
+type RouterNavigateToOption = Omit<WechatMiniprogram.NavigateToOption, 'url'> & {
+  url: TypedRouterUrl;
+};
+/**
+ * setup 场景下推荐使用的 Router 类型。
+ * 默认行为与原生 Router 一致；声明合并后可获得更精确的 `url` 类型提示。
+ */
+interface SetupContextRouter {
+  switchTab: (option: RouterSwitchTabOption) => ReturnType<WechatMiniprogram.Component.Router['switchTab']>;
+  reLaunch: (option: RouterReLaunchOption) => ReturnType<WechatMiniprogram.Component.Router['reLaunch']>;
+  redirectTo: (option: RouterRedirectToOption) => ReturnType<WechatMiniprogram.Component.Router['redirectTo']>;
+  navigateTo: (option: RouterNavigateToOption) => ReturnType<WechatMiniprogram.Component.Router['navigateTo']>;
+  navigateBack: WechatMiniprogram.Component.Router['navigateBack'];
+}
+//#endregion
+export { SetupContextRouter as a, WevuTypedRouterRouteMap as c, RouterSwitchTabOption as i, RouterReLaunchOption as n, TypedRouterTabBarUrl as o, RouterRedirectToOption as r, TypedRouterUrl as s, RouterNavigateToOption as t };

package/dist/router.d.mts

@@ -0,0 +1,192 @@
+import { a as SetupContextRouter, c as WevuTypedRouterRouteMap, i as RouterSwitchTabOption, n as RouterReLaunchOption, o as TypedRouterTabBarUrl, r as RouterRedirectToOption, s as TypedRouterUrl, t as RouterNavigateToOption } from "./router-BxV0btOX.mjs";
+
+//#region src/routerInternal/types.d.ts
+interface RouteResolveCodec {
+  parseQuery: RouteQueryParser;
+  stringifyQuery: RouteQueryStringifier;
+}
+//#endregion
+//#region src/routerInternal/query.d.ts
+declare function parseQuery(search: string): LocationQuery;
+declare function stringifyQuery(query?: LocationQueryRaw | LocationQuery): string;
+//#endregion
+//#region src/router/types.d.ts
+type LocationQueryValue = string | null;
+type LocationQueryValueRaw = LocationQueryValue | number | boolean | undefined;
+type LocationQuery = Record<string, LocationQueryValue | LocationQueryValue[]>;
+type LocationQueryRaw = Record<string, LocationQueryValueRaw | LocationQueryValueRaw[]>;
+type RouteParamValue = string;
+type RouteParamValueRaw = RouteParamValue | number | boolean | null | undefined;
+type RouteParams = Record<string, RouteParamValue | RouteParamValue[]>;
+type RouteParamsRaw = Record<string, RouteParamValueRaw | RouteParamValueRaw[]>;
+type RouteParamsMode = 'loose' | 'strict';
+type RouteQueryParser = (search: string) => LocationQueryRaw | LocationQuery;
+type RouteQueryStringifier = (query: LocationQueryRaw | LocationQuery) => string;
+type RouteMeta = Record<string, unknown>;
+interface NamedRouteRecord {
+  name: string;
+  path: string;
+}
+type NamedRoutes = Readonly<Record<string, string>> | readonly RouteRecordRaw[];
+type RouteLocationRaw = string | {
+  path?: string;
+  fullPath?: string;
+  query?: LocationQueryRaw;
+  hash?: string;
+  name?: string;
+  params?: RouteParamsRaw;
+};
+interface RouteLocationNormalizedLoaded {
+  path: string;
+  fullPath: string;
+  query: LocationQuery;
+  hash: string;
+  name?: string;
+  meta?: RouteMeta;
+  href?: string;
+  matched?: readonly RouteRecordMatched[];
+  redirectedFrom?: RouteLocationRedirectedFrom;
+  params: RouteParams;
+}
+declare const NavigationFailureType: {
+  readonly unknown: 1;
+  readonly aborted: 4;
+  readonly cancelled: 8;
+  readonly duplicated: 16;
+};
+type NavigationFailureTypeValue = (typeof NavigationFailureType)[keyof typeof NavigationFailureType];
+interface NavigationFailure extends Error {
+  readonly __wevuNavigationFailure: true;
+  readonly type: NavigationFailureTypeValue;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from?: RouteLocationNormalizedLoaded;
+  readonly cause?: unknown;
+}
+type NavigationMode = 'push' | 'replace' | 'back';
+interface NavigationRedirect {
+  to: RouteLocationRaw;
+  replace?: boolean;
+}
+type RouteRecordRedirect = RouteLocationRaw | NavigationRedirect | ((to: RouteLocationNormalizedLoaded, from: RouteLocationNormalizedLoaded) => RouteLocationRaw | NavigationRedirect | Promise<RouteLocationRaw | NavigationRedirect>);
+interface RouteRecordRaw extends NamedRouteRecord {
+  meta?: RouteMeta;
+  alias?: string | readonly string[];
+  children?: readonly RouteRecordRaw[];
+  beforeEnter?: NavigationGuard | readonly NavigationGuard[];
+  redirect?: RouteRecordRedirect;
+}
+interface RouteRecordMatched {
+  name: string;
+  path: string;
+  aliasPath?: string;
+  meta?: RouteMeta;
+}
+interface RouteLocationRedirectedFrom {
+  path: string;
+  fullPath: string;
+  query: LocationQuery;
+  hash: string;
+  name?: string;
+  meta?: RouteMeta;
+  href?: string;
+  matched?: readonly RouteRecordMatched[];
+  params: RouteParams;
+}
+type NavigationGuardResult = void | boolean | NavigationFailure | RouteLocationRaw | NavigationRedirect;
+type NavigationGuard = (to: RouteLocationNormalizedLoaded | undefined, from: RouteLocationNormalizedLoaded, context?: NavigationGuardContext) => NavigationGuardResult | Promise<NavigationGuardResult>;
+type NavigationAfterEach = (to: RouteLocationNormalizedLoaded | undefined, from: RouteLocationNormalizedLoaded, failure?: NavigationFailure, context?: NavigationAfterEachContext) => void | Promise<void>;
+interface NavigationGuardContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+}
+interface NavigationAfterEachContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+  readonly failure?: NavigationFailure;
+}
+interface NavigationErrorContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+  readonly failure: NavigationFailure;
+}
+type NavigationErrorHandler = (error: unknown, context: NavigationErrorContext) => void | Promise<void>;
+interface UseRouterOptions {
+  tabBarEntries?: readonly (TypedRouterTabBarUrl | string)[];
+  /**
+   * Vue Router 对齐入口：推荐使用 `routes`
+   */
+  routes?: readonly RouteRecordRaw[];
+  /**
+   * 兼容入口：支持对象 map 或路由记录数组
+   */
+  namedRoutes?: NamedRoutes;
+  paramsMode?: RouteParamsMode;
+  maxRedirects?: number;
+  parseQuery?: RouteQueryParser;
+  stringifyQuery?: RouteQueryStringifier;
+  /**
+   * 异常型导航失败时是否以 Promise reject 抛出失败对象。
+   *
+   * - `true`：更贴近 Vue Router 心智（默认）
+   * - `false`：始终以返回值形式携带失败对象
+   */
+  rejectOnError?: boolean;
+}
+interface RouterNavigation {
+  readonly nativeRouter: SetupContextRouter;
+  readonly options: Readonly<UseRouterOptions>;
+  readonly currentRoute: Readonly<RouteLocationNormalizedLoaded>;
+  install: (app?: unknown) => void;
+  resolve: (to: RouteLocationRaw) => RouteLocationNormalizedLoaded;
+  isReady: () => Promise<void>;
+  push: (to: RouteLocationRaw) => Promise<void | NavigationFailure>;
+  replace: (to: RouteLocationRaw) => Promise<void | NavigationFailure>;
+  back: (delta?: number) => Promise<void | NavigationFailure>;
+  go: (delta: number) => Promise<void | NavigationFailure>;
+  forward: () => Promise<void | NavigationFailure>;
+  hasRoute: (name: string) => boolean;
+  getRoutes: () => readonly RouteRecordRaw[];
+  addRoute: AddRoute;
+  removeRoute: (name: string) => void;
+  clearRoutes: () => void;
+  beforeEach: (guard: NavigationGuard) => () => void;
+  beforeResolve: (guard: NavigationGuard) => () => void;
+  afterEach: (hook: NavigationAfterEach) => () => void;
+  onError: (handler: NavigationErrorHandler) => () => void;
+}
+interface AddRoute {
+  (route: RouteRecordRaw): () => void;
+  (parentName: string, route: RouteRecordRaw): () => void;
+}
+//#endregion
+//#region src/router/navigationCore.d.ts
+declare function createNavigationFailure(type: NavigationFailureTypeValue, to?: RouteLocationNormalizedLoaded, from?: RouteLocationNormalizedLoaded, cause?: unknown): NavigationFailure;
+declare function isNavigationFailure(error: unknown, type?: NavigationFailureTypeValue): error is NavigationFailure;
+//#endregion
+//#region src/router/resolve.d.ts
+declare function resolveRouteLocation(to: RouteLocationRaw, currentPath?: string, codec?: RouteResolveCodec): RouteLocationNormalizedLoaded;
+//#endregion
+//#region src/router/useRoute.d.ts
+declare function useRoute(): Readonly<RouteLocationNormalizedLoaded>;
+/**
+ * @description 获取当前组件路径语义的原生 Router
+ */
+declare function useNativeRouter(): SetupContextRouter;
+/**
+ * @description 获取当前页面路径语义的原生 Page Router
+ */
+declare function useNativePageRouter(): SetupContextRouter;
+//#endregion
+//#region src/router/useRouter.d.ts
+/**
+ * @description 获取高阶路由导航器（对齐 Vue Router 心智）
+ */
+declare function useRouter(options?: UseRouterOptions): RouterNavigation;
+//#endregion
+export { type AddRoute, type LocationQuery, type LocationQueryRaw, type LocationQueryValue, type LocationQueryValueRaw, type NamedRouteRecord, type NamedRoutes, type NavigationAfterEach, type NavigationAfterEachContext, type NavigationErrorContext, type NavigationErrorHandler, type NavigationFailure, NavigationFailureType, type NavigationFailureTypeValue, type NavigationGuard, type NavigationGuardContext, type NavigationGuardResult, type NavigationMode, type NavigationRedirect, type RouteLocationNormalizedLoaded, type RouteLocationRaw, type RouteLocationRedirectedFrom, type RouteMeta, type RouteParamValue, type RouteParamValueRaw, type RouteParams, type RouteParamsMode, type RouteParamsRaw, type RouteQueryParser, type RouteQueryStringifier, type RouteRecordMatched, type RouteRecordRaw, type RouteRecordRedirect, type RouterNavigateToOption, type RouterNavigation, type RouterReLaunchOption, type RouterRedirectToOption, type RouterSwitchTabOption, type SetupContextRouter, type TypedRouterTabBarUrl, type TypedRouterUrl, type UseRouterOptions, type WevuTypedRouterRouteMap, createNavigationFailure, isNavigationFailure, parseQuery, resolveRouteLocation, stringifyQuery, useNativePageRouter, useNativeRouter, useRoute, useRouter };