wevu 7.0.3 → 7.1.0

package/dist/dev/reactivity/watch/types.d.mts

@@ -0,0 +1,43 @@
+import { Ref } from "../ref.mjs";
+import { ComputedRef } from "../computed.mjs";
+//#region src/reactivity/watch/types.d.ts
+export type OnCleanup = (cleanupFn: () => void) => void;
+export type WatchEffect = (onCleanup: OnCleanup) => void;
+export type WatchSource<T = any> = Ref<T> | ComputedRef<T> | (() => T);
+export type WatchCallback<V = any, OV = any> = (value: V, oldValue: OV, onCleanup: OnCleanup) => void;
+export type WatchScheduler = (job: () => void, isFirstRun: boolean) => void;
+export type MaybeUndefined<T, Immediate> = Immediate extends true ? T | undefined : T;
+export type MultiWatchSources = (WatchSource<unknown> | object)[];
+export type MapSources<T, Immediate> = { [K in keyof T]: T[K] extends WatchSource<infer V> ? MaybeUndefined<V, Immediate> : T[K] extends object ? MaybeUndefined<T[K], Immediate> : never; };
+export type WatchSourceValue<S> = S extends WatchSource<infer V> ? V : S extends object ? S : never;
+export type WatchSources<T = any> = WatchSource<T> | ReadonlyArray<WatchSource<unknown> | object> | (T extends object ? T : never);
+type IsTuple<T extends ReadonlyArray<any>> = number extends T['length'] ? false : true;
+export type WatchMultiSources<T extends ReadonlyArray<WatchSource<unknown> | object>> = IsTuple<T> extends true ? { [K in keyof T]: WatchSourceValue<T[K]>; } : Array<WatchSourceValue<T[number]>>;
+export interface WatchEffectOptions {
+  flush?: 'pre' | 'post' | 'sync';
+}
+export interface WatchOptions<Immediate extends boolean = false> extends WatchEffectOptions {
+  immediate?: Immediate;
+  deep?: boolean | number;
+  once?: boolean;
+  scheduler?: WatchScheduler;
+}
+export interface WatchStopHandle {
+  (): void;
+  stop: () => void;
+  pause: () => void;
+  resume: () => void;
+}
+export type DeepWatchStrategy = 'version' | 'traverse';
+/**
+ * 设置深度 watch 内部策略（测试/框架内部使用）。
+ * @internal
+ */
+export declare function setDeepWatchStrategy(strategy: DeepWatchStrategy): void;
+/**
+ * 获取深度 watch 内部策略（测试/框架内部使用）。
+ * @internal
+ */
+export declare function getDeepWatchStrategy(): DeepWatchStrategy;
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/dev/reactivity/watch.d.mts

@@ -0,0 +1,22 @@
+import { DeepWatchStrategy, MapSources, MaybeUndefined, MultiWatchSources, OnCleanup, WatchCallback, WatchEffect, WatchEffectOptions, WatchMultiSources, WatchOptions, WatchScheduler, WatchSource, WatchSourceValue, WatchSources, WatchStopHandle, getDeepWatchStrategy, setDeepWatchStrategy } from "./watch/types.mjs";
+//#region src/reactivity/watch.d.ts
+export declare function watch<T, Immediate extends Readonly<boolean> = false>(source: WatchSource<T>, cb: WatchCallback<T, MaybeUndefined<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T extends object, Immediate extends Readonly<boolean> = false>(source: T extends ReadonlyArray<any> ? never : T, cb: WatchCallback<T, MaybeUndefined<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T extends Readonly<MultiWatchSources>, Immediate extends Readonly<boolean> = false>(source: readonly [...T] | T, cb: WatchCallback<MapSources<T, false>, MapSources<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T extends MultiWatchSources, Immediate extends Readonly<boolean> = false>(source: [...T], cb: WatchCallback<MapSources<T, false>, MapSources<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
+/**
+ * watchEffect 注册一个响应式副作用，可选清理函数。
+ * 副作用会立即执行，并在依赖变化时重新运行。
+ */
+export declare function watchEffect(effectFn: WatchEffect, options?: WatchEffectOptions): WatchStopHandle;
+/**
+ * 以后置刷新的方式运行副作用，与 Vue 的 `watchPostEffect()` 兼容。
+ */
+export declare function watchPostEffect(effectFn: WatchEffect, options?: Omit<WatchEffectOptions, 'flush'>): WatchStopHandle;
+/**
+ * 以同步刷新的方式运行副作用，与 Vue 的 `watchSyncEffect()` 兼容。
+ */
+export declare function watchSyncEffect(effectFn: WatchEffect, options?: Omit<WatchEffectOptions, 'flush'>): WatchStopHandle;
+//#endregion
+export { type MapSources, type MaybeUndefined, type MultiWatchSources, type OnCleanup, type WatchCallback, type WatchEffect, type WatchEffectOptions, type WatchMultiSources, type WatchOptions, type WatchScheduler, type WatchSource, type WatchSourceValue, type WatchSources, type WatchStopHandle, getDeepWatchStrategy, setDeepWatchStrategy };
+//# sourceMappingURL=watch.d.mts.map

package/dist/dev/router/createRouter.d.mts

@@ -0,0 +1,8 @@
+import { RouterNavigation, UseRouterOptions } from "./types.mjs";
+//#region src/router/createRouter.d.ts
+/**
+ * @description 创建高阶路由导航器（对齐 Vue Router 的 createRouter 心智）
+ */
+export declare function createRouter(options?: UseRouterOptions): RouterNavigation;
+//#endregion
+//# sourceMappingURL=createRouter.d.mts.map

package/dist/dev/router/navigationCore.d.mts

@@ -0,0 +1,6 @@
+import { NavigationFailure, NavigationFailureTypeValue, RouteLocationNormalizedLoaded } from "./types.mjs";
+//#region src/router/navigationCore.d.ts
+export declare function createNavigationFailure(type: NavigationFailureTypeValue, to?: RouteLocationNormalizedLoaded, from?: RouteLocationNormalizedLoaded, cause?: unknown): NavigationFailure;
+export declare function isNavigationFailure(error: unknown, type?: NavigationFailureTypeValue): error is NavigationFailure;
+//#endregion
+//# sourceMappingURL=navigationCore.d.mts.map

package/dist/dev/router/resolve.d.mts

@@ -0,0 +1,6 @@
+import { RouteResolveCodec } from "../routerInternal/types.mjs";
+import { RouteLocationNormalizedLoaded, RouteLocationRaw } from "./types.mjs";
+//#region src/router/resolve.d.ts
+export declare function resolveRouteLocation(to: RouteLocationRaw, currentPath?: string, codec?: RouteResolveCodec): RouteLocationNormalizedLoaded;
+//#endregion
+//# sourceMappingURL=resolve.d.mts.map

package/dist/dev/router/routeSync.d.mts

@@ -0,0 +1 @@
+import "./types.mjs";

package/dist/dev/router/routeSync.mjs

@@ -1,3 +1,5 @@
+import { getCurrentMiniProgramPages } from "../runtime/platform.mjs";
+
 //#region src/router/routeSync.ts
 const ROUTE_SYNC_NATIVE_METHODS = [
 	"switchTab",
@@ -19,7 +21,7 @@ function notifyRouteStateSync(payload) {
 		handler(payload);
 	} catch (_unused) {}
 }
-function createNativeRouteStateSyncPayload(methodName, option) {
+function createNativeRouteStateSyncPayload(methodName, option, sourcePage) {
 	if (methodName === "navigateBack") return {
 		method: methodName,
 		source: "native"
@@ -28,12 +30,14 @@ function createNativeRouteStateSyncPayload(methodName, option) {
 		const url = option.url;
 		if (typeof url === "string") return {
 			method: methodName,
+			page: sourcePage,
 			source: "native",
 			url
 		};
 	}
 	return {
 		method: methodName,
+		page: sourcePage,
 		source: "native"
 	};
 }
@@ -46,11 +50,13 @@ function installRouteStateSyncOnNativeRouter(nativeRouter) {
 		const original = router[methodName];
 		if (typeof original !== "function") continue;
 		router[methodName] = function routeStateSyncNativeRouterMethod(option, ...args) {
+			const pages = getCurrentMiniProgramPages();
+			const sourcePage = pages[pages.length - 1];
 			let synced = false;
 			const syncRouteState = () => {
 				if (synced) return;
 				synced = true;
-				notifyRouteStateSync(createNativeRouteStateSyncPayload(methodName, option));
+				notifyRouteStateSync(createNativeRouteStateSyncPayload(methodName, option, sourcePage));
 			};
 			const nextOption = option && typeof option === "object" ? {
 				...option,

package/dist/dev/router/routeSync.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routeSync.mjs","names":[],"sources":["../../../src/router/routeSync.ts"],"sourcesContent":["import type { MiniProgramPageLike } from '../routerInternal/shared'\nimport type { RouteLocationNormalizedLoaded } from './types'\n\nexport interface RouteStateSyncPayload {\n  page?: MiniProgramPageLike\n  route?: RouteLocationNormalizedLoaded\n  url?: string\n  source?: 'native' | 'page' | 'router'\n  method?: NativeRouterMethodName\n}\n\ntype RouteStateSyncHandler = (payload?: RouteStateSyncPayload) => void\ntype NativeRouterMethodName = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo' | 'navigateBack'\n\nconst ROUTE_SYNC_NATIVE_METHODS: readonly NativeRouterMethodName[] = ['switchTab', 'reLaunch', 'redirectTo', 'navigateTo', 'navigateBack']\nconst routeStateSyncHandlers = new Set<RouteStateSyncHandler>()\nconst patchedNativeRouters = new WeakSet<Record<string, any>>()\n\nexport function registerRouteStateSyncHandler(handler: RouteStateSyncHandler): () => void {\n  routeStateSyncHandlers.add(handler)\n  return () => {\n    routeStateSyncHandlers.delete(handler)\n  }\n}\n\nexport function notifyRouteStateSync(payload?: RouteStateSyncPayload) {\n  for (const handler of routeStateSyncHandlers) {\n    try {\n      handler(payload)\n    }\n    catch {\n      // 忽略单个 route 订阅者异常，避免阻塞原生导航成功回调。\n    }\n  }\n}\n\nfunction createNativeRouteStateSyncPayload(methodName: NativeRouterMethodName, option: unknown): RouteStateSyncPayload | undefined {\n  if (methodName === 'navigateBack') {\n    return {\n      method: methodName,\n      source: 'native',\n    }\n  }\n  if (option && typeof option === 'object') {\n    const url = (option as Record<string, unknown>).url\n    if (typeof url === 'string') {\n      return {\n        method: methodName,\n        source: 'native',\n        url,\n      }\n    }\n  }\n  return {\n    method: methodName,\n    source: 'native',\n  }\n}\n\nexport function installRouteStateSyncOnNativeRouter(nativeRouter: unknown) {\n  if (!nativeRouter || typeof nativeRouter !== 'object') {\n    return\n  }\n  const router = nativeRouter as Record<string, any>\n  if (patchedNativeRouters.has(router)) {\n    return\n  }\n  patchedNativeRouters.add(router)\n\n  for (const methodName of ROUTE_SYNC_NATIVE_METHODS) {\n    const original = router[methodName]\n    if (typeof original !== 'function') {\n      continue\n    }\n\n    router[methodName] = function routeStateSyncNativeRouterMethod(this: unknown, option?: unknown, ...args: any[]) {\n      let synced = false\n      const syncRouteState = () => {\n        if (synced) {\n          return\n        }\n        synced = true\n        notifyRouteStateSync(createNativeRouteStateSyncPayload(methodName, option))\n      }\n\n      const nextOption = option && typeof option === 'object'\n        ? {\n            ...(option as Record<string, any>),\n            success: (...successArgs: any[]) => {\n              syncRouteState()\n              const originalSuccess = (option as Record<string, any>).success\n              return typeof originalSuccess === 'function'\n                ? originalSuccess(...successArgs)\n                : undefined\n            },\n          }\n        : option\n\n      const result = original.call(this, nextOption, ...args)\n      if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n        ;(result as PromiseLike<unknown>).then(syncRouteState, () => {})\n      }\n      return result\n    }\n  }\n}\n"],"mappings":";AAcA,MAAM,4BAA+D;CAAC;CAAa;CAAY;CAAc;CAAc;AAAc;AACzI,MAAM,yCAAyB,IAAI,IAA2B;AAC9D,MAAM,uCAAuB,IAAI,QAA6B;AAE9D,SAAgB,8BAA8B,SAA4C;CACxF,uBAAuB,IAAI,OAAO;CAClC,aAAa;EACX,uBAAuB,OAAO,OAAO;CACvC;AACF;AAEA,SAAgB,qBAAqB,SAAiC;CACpE,KAAK,MAAM,WAAW,wBACpB,IAAI;EACF,QAAQ,OAAO;CACjB,kBACM,CAEN;AAEJ;AAEA,SAAS,kCAAkC,YAAoC,QAAoD;CACjI,IAAI,eAAe,gBACjB,OAAO;EACL,QAAQ;EACR,QAAQ;CACV;CAEF,IAAI,UAAU,OAAO,WAAW,UAAU;EACxC,MAAM,MAAO,OAAmC;EAChD,IAAI,OAAO,QAAQ,UACjB,OAAO;GACL,QAAQ;GACR,QAAQ;GACR;EACF;CAEJ;CACA,OAAO;EACL,QAAQ;EACR,QAAQ;CACV;AACF;AAEA,SAAgB,oCAAoC,cAAuB;CACzE,IAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAC3C;CAEF,MAAM,SAAS;CACf,IAAI,qBAAqB,IAAI,MAAM,GACjC;CAEF,qBAAqB,IAAI,MAAM;CAE/B,KAAK,MAAM,cAAc,2BAA2B;EAClD,MAAM,WAAW,OAAO;EACxB,IAAI,OAAO,aAAa,YACtB;EAGF,OAAO,cAAc,SAAS,iCAAgD,QAAkB,GAAG,MAAa;GAC9G,IAAI,SAAS;GACb,MAAM,uBAAuB;IAC3B,IAAI,QACF;IAEF,SAAS;IACT,qBAAqB,kCAAkC,YAAY,MAAM,CAAC;GAC5E;GAEA,MAAM,aAAa,UAAU,OAAO,WAAW,WAC3C;IACE,GAAI;IACJ,UAAU,GAAG,gBAAuB;KAClC,eAAe;KACf,MAAM,kBAAmB,OAA+B;KACxD,OAAO,OAAO,oBAAoB,aAC9B,gBAAgB,GAAG,WAAW,IAC9B;IACN;GACF,IACA;GAEJ,MAAM,SAAS,SAAS,KAAK,MAAM,YAAY,GAAG,IAAI;GACtD,IAAI,UAAU,OAAQ,OAAgC,SAAS,YAC5D,AAAC,OAAgC,KAAK,sBAAsB,CAAC,CAAC;GAEjE,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"routeSync.mjs","names":[],"sources":["../../../src/router/routeSync.ts"],"sourcesContent":["import type { MiniProgramPageLike } from '../routerInternal/shared'\nimport type { RouteLocationNormalizedLoaded } from './types'\nimport { getCurrentMiniProgramPages } from '../runtime/platform'\n\nexport interface RouteStateSyncPayload {\n  page?: MiniProgramPageLike\n  route?: RouteLocationNormalizedLoaded\n  url?: string\n  source?: 'native' | 'page' | 'router'\n  method?: NativeRouterMethodName\n}\n\ntype RouteStateSyncHandler = (payload?: RouteStateSyncPayload) => void\ntype NativeRouterMethodName = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo' | 'navigateBack'\n\nconst ROUTE_SYNC_NATIVE_METHODS: readonly NativeRouterMethodName[] = ['switchTab', 'reLaunch', 'redirectTo', 'navigateTo', 'navigateBack']\nconst routeStateSyncHandlers = new Set<RouteStateSyncHandler>()\nconst patchedNativeRouters = new WeakSet<Record<string, any>>()\n\nexport function registerRouteStateSyncHandler(handler: RouteStateSyncHandler): () => void {\n  routeStateSyncHandlers.add(handler)\n  return () => {\n    routeStateSyncHandlers.delete(handler)\n  }\n}\n\nexport function notifyRouteStateSync(payload?: RouteStateSyncPayload) {\n  for (const handler of routeStateSyncHandlers) {\n    try {\n      handler(payload)\n    }\n    catch {\n      // 忽略单个 route 订阅者异常，避免阻塞原生导航成功回调。\n    }\n  }\n}\n\nfunction createNativeRouteStateSyncPayload(\n  methodName: NativeRouterMethodName,\n  option: unknown,\n  sourcePage: MiniProgramPageLike | undefined,\n): RouteStateSyncPayload | undefined {\n  if (methodName === 'navigateBack') {\n    return {\n      method: methodName,\n      source: 'native',\n    }\n  }\n  if (option && typeof option === 'object') {\n    const url = (option as Record<string, unknown>).url\n    if (typeof url === 'string') {\n      return {\n        method: methodName,\n        page: sourcePage,\n        source: 'native',\n        url,\n      }\n    }\n  }\n  return {\n    method: methodName,\n    page: sourcePage,\n    source: 'native',\n  }\n}\n\nexport function installRouteStateSyncOnNativeRouter(nativeRouter: unknown) {\n  if (!nativeRouter || typeof nativeRouter !== 'object') {\n    return\n  }\n  const router = nativeRouter as Record<string, any>\n  if (patchedNativeRouters.has(router)) {\n    return\n  }\n  patchedNativeRouters.add(router)\n\n  for (const methodName of ROUTE_SYNC_NATIVE_METHODS) {\n    const original = router[methodName]\n    if (typeof original !== 'function') {\n      continue\n    }\n\n    router[methodName] = function routeStateSyncNativeRouterMethod(this: unknown, option?: unknown, ...args: any[]) {\n      const pages = getCurrentMiniProgramPages() as MiniProgramPageLike[]\n      const sourcePage = pages[pages.length - 1]\n      let synced = false\n      const syncRouteState = () => {\n        if (synced) {\n          return\n        }\n        synced = true\n        notifyRouteStateSync(createNativeRouteStateSyncPayload(methodName, option, sourcePage))\n      }\n\n      const nextOption = option && typeof option === 'object'\n        ? {\n            ...(option as Record<string, any>),\n            success: (...successArgs: any[]) => {\n              syncRouteState()\n              const originalSuccess = (option as Record<string, any>).success\n              return typeof originalSuccess === 'function'\n                ? originalSuccess(...successArgs)\n                : undefined\n            },\n          }\n        : option\n\n      const result = original.call(this, nextOption, ...args)\n      if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n        ;(result as PromiseLike<unknown>).then(syncRouteState, () => {})\n      }\n      return result\n    }\n  }\n}\n"],"mappings":";;;AAeA,MAAM,4BAA+D;CAAC;CAAa;CAAY;CAAc;CAAc;AAAc;AACzI,MAAM,yCAAyB,IAAI,IAA2B;AAC9D,MAAM,uCAAuB,IAAI,QAA6B;AAE9D,SAAgB,8BAA8B,SAA4C;CACxF,uBAAuB,IAAI,OAAO;CAClC,aAAa;EACX,uBAAuB,OAAO,OAAO;CACvC;AACF;AAEA,SAAgB,qBAAqB,SAAiC;CACpE,KAAK,MAAM,WAAW,wBACpB,IAAI;EACF,QAAQ,OAAO;CACjB,kBACM,CAEN;AAEJ;AAEA,SAAS,kCACP,YACA,QACA,YACmC;CACnC,IAAI,eAAe,gBACjB,OAAO;EACL,QAAQ;EACR,QAAQ;CACV;CAEF,IAAI,UAAU,OAAO,WAAW,UAAU;EACxC,MAAM,MAAO,OAAmC;EAChD,IAAI,OAAO,QAAQ,UACjB,OAAO;GACL,QAAQ;GACR,MAAM;GACN,QAAQ;GACR;EACF;CAEJ;CACA,OAAO;EACL,QAAQ;EACR,MAAM;EACN,QAAQ;CACV;AACF;AAEA,SAAgB,oCAAoC,cAAuB;CACzE,IAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAC3C;CAEF,MAAM,SAAS;CACf,IAAI,qBAAqB,IAAI,MAAM,GACjC;CAEF,qBAAqB,IAAI,MAAM;CAE/B,KAAK,MAAM,cAAc,2BAA2B;EAClD,MAAM,WAAW,OAAO;EACxB,IAAI,OAAO,aAAa,YACtB;EAGF,OAAO,cAAc,SAAS,iCAAgD,QAAkB,GAAG,MAAa;GAC9G,MAAM,QAAQ,2BAA2B;GACzC,MAAM,aAAa,MAAM,MAAM,SAAS;GACxC,IAAI,SAAS;GACb,MAAM,uBAAuB;IAC3B,IAAI,QACF;IAEF,SAAS;IACT,qBAAqB,kCAAkC,YAAY,QAAQ,UAAU,CAAC;GACxF;GAEA,MAAM,aAAa,UAAU,OAAO,WAAW,WAC3C;IACE,GAAI;IACJ,UAAU,GAAG,gBAAuB;KAClC,eAAe;KACf,MAAM,kBAAmB,OAA+B;KACxD,OAAO,OAAO,oBAAoB,aAC9B,gBAAgB,GAAG,WAAW,IAC9B;IACN;GACF,IACA;GAEJ,MAAM,SAAS,SAAS,KAAK,MAAM,YAAY,GAAG,IAAI;GACtD,IAAI,UAAU,OAAQ,OAAgC,SAAS,YAC5D,AAAC,OAAgC,KAAK,sBAAsB,CAAC,CAAC;GAEjE,OAAO;EACT;CACF;AACF"}

package/dist/dev/router/types.d.mts

@@ -0,0 +1,172 @@
+import { SetupContextRouter, TypedRouterTabBarUrl } from "../runtime/types/props/router.mjs";
+import "../runtime/types/props.mjs";
+//#region src/router/types.d.ts
+export type LocationQueryValue = string | null;
+export type LocationQueryValueRaw = LocationQueryValue | number | boolean | undefined;
+export type LocationQuery = Record<string, LocationQueryValue | LocationQueryValue[]>;
+export type LocationQueryRaw = Record<string, LocationQueryValueRaw | LocationQueryValueRaw[]>;
+export type RouteParamValue = string;
+export type RouteParamValueRaw = RouteParamValue | number | boolean | null | undefined;
+export type RouteParams = Record<string, RouteParamValue | RouteParamValue[]>;
+export type RouteParamsRaw = Record<string, RouteParamValueRaw | RouteParamValueRaw[]>;
+export type RouteParamsMode = 'loose' | 'strict';
+export type RouteQueryParser = (search: string) => LocationQueryRaw | LocationQuery;
+export type RouteQueryStringifier = (query: LocationQueryRaw | LocationQuery) => string;
+export type RouteMeta = Record<string, unknown>;
+export interface NamedRouteRecord {
+  name: string;
+  path: string;
+}
+export interface RouteRecordInput {
+  name?: string;
+  path: string;
+  meta?: RouteMeta;
+  alias?: string | readonly string[];
+  children?: readonly RouteRecordInput[];
+  beforeEnter?: NavigationGuard | readonly NavigationGuard[];
+  redirect?: RouteRecordRedirect;
+}
+export type NamedRoutes = Readonly<Record<string, string>> | readonly RouteRecordRaw[];
+export type RouteLocationRaw = string | {
+  path?: string;
+  fullPath?: string;
+  query?: LocationQueryRaw;
+  hash?: string;
+  name?: string;
+  params?: RouteParamsRaw;
+};
+export interface RouteLocationNormalizedLoaded {
+  path: string;
+  fullPath: string;
+  query: LocationQuery;
+  hash: string;
+  name?: string;
+  meta?: RouteMeta;
+  href?: string;
+  matched?: readonly RouteRecordMatched[];
+  redirectedFrom?: RouteLocationRedirectedFrom;
+  params: RouteParams;
+}
+export declare const NavigationFailureType: {
+  readonly unknown: 1;
+  readonly aborted: 4;
+  readonly cancelled: 8;
+  readonly duplicated: 16;
+};
+export type NavigationFailureTypeValue = (typeof NavigationFailureType)[keyof typeof NavigationFailureType];
+export interface NavigationFailure extends Error {
+  readonly __wevuNavigationFailure: true;
+  readonly type: NavigationFailureTypeValue;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from?: RouteLocationNormalizedLoaded;
+  readonly cause?: unknown;
+}
+export type NavigationMode = 'push' | 'replace' | 'back';
+export type InitialNavigationMode = 'eager' | 'blocking';
+export interface NavigationRedirect {
+  to: RouteLocationRaw;
+  replace?: boolean;
+}
+export type RouteRecordRedirect = RouteLocationRaw | NavigationRedirect | ((to: RouteLocationNormalizedLoaded, from: RouteLocationNormalizedLoaded) => RouteLocationRaw | NavigationRedirect | Promise<RouteLocationRaw | NavigationRedirect>);
+export interface RouteRecordRaw extends Omit<RouteRecordInput, 'name' | 'children'>, NamedRouteRecord {
+  children?: readonly RouteRecordRaw[];
+}
+export interface RouteRecordMatched {
+  name: string;
+  path: string;
+  aliasPath?: string;
+  meta?: RouteMeta;
+}
+export interface RouteLocationRedirectedFrom {
+  path: string;
+  fullPath: string;
+  query: LocationQuery;
+  hash: string;
+  name?: string;
+  meta?: RouteMeta;
+  href?: string;
+  matched?: readonly RouteRecordMatched[];
+  params: RouteParams;
+}
+export type NavigationGuardResult = void | boolean | NavigationFailure | RouteLocationRaw | NavigationRedirect;
+export type NavigationGuard = (to: RouteLocationNormalizedLoaded | undefined, from: RouteLocationNormalizedLoaded, context?: NavigationGuardContext) => NavigationGuardResult | Promise<NavigationGuardResult>;
+export type NavigationAfterEach = (to: RouteLocationNormalizedLoaded | undefined, from: RouteLocationNormalizedLoaded, failure?: NavigationFailure, context?: NavigationAfterEachContext) => void | Promise<void>;
+export interface NavigationGuardContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+}
+export interface NavigationAfterEachContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+  readonly failure?: NavigationFailure;
+}
+export interface NavigationErrorContext {
+  readonly mode: NavigationMode;
+  readonly to?: RouteLocationNormalizedLoaded;
+  readonly from: RouteLocationNormalizedLoaded;
+  readonly nativeRouter: SetupContextRouter;
+  readonly failure: NavigationFailure;
+}
+export type NavigationErrorHandler = (error: unknown, context: NavigationErrorContext) => void | Promise<void>;
+export interface UseRouterOptions {
+  tabBarEntries?: readonly (TypedRouterTabBarUrl | string)[];
+  /**
+   * Vue Router 对齐入口：推荐使用 `routes`
+   */
+  routes?: readonly RouteRecordInput[];
+  /**
+   * 兼容入口：支持对象 map 或路由记录数组
+   */
+  namedRoutes?: NamedRoutes;
+  paramsMode?: RouteParamsMode;
+  maxRedirects?: number;
+  /**
+   * 首屏导航守卫模式。默认立即挂载页面，只有明确配置 `blocking` 时才等待守卫完成。
+   */
+  initialNavigationMode?: InitialNavigationMode;
+  /**
+   * blocking 首屏导航守卫的最大等待时间（毫秒），超时后放行页面挂载。
+   */
+  initialNavigationTimeout?: number;
+  parseQuery?: RouteQueryParser;
+  stringifyQuery?: RouteQueryStringifier;
+  /**
+   * 异常型导航失败时是否以 Promise reject 抛出失败对象。
+   *
+   * - `true`：更贴近 Vue Router 心智（默认）
+   * - `false`：始终以返回值形式携带失败对象
+   */
+  rejectOnError?: boolean;
+}
+export 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;
+}
+export interface AddRoute {
+  (route: RouteRecordRaw): () => void;
+  (parentName: string, route: RouteRecordRaw): () => void;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/dev/router/useRoute.d.mts

@@ -0,0 +1,19 @@
+import { SetupContextRouter } from "../runtime/types/props/router.mjs";
+import "../runtime/types/props.mjs";
+import { RouteLocationNormalizedLoaded } from "./types.mjs";
+import "./routeSync.mjs";
+//#region src/router/useRoute.d.ts
+export interface UseRouteOptions {
+  resolveRoute?: (route: RouteLocationNormalizedLoaded) => RouteLocationNormalizedLoaded;
+}
+export declare function useRoute(options?: UseRouteOptions): Readonly<RouteLocationNormalizedLoaded>;
+/**
+ * @description 获取当前组件路径语义的原生 Router
+ */
+export declare function useNativeRouter(): SetupContextRouter;
+/**
+ * @description 获取当前页面路径语义的原生 Page Router
+ */
+export declare function useNativePageRouter(): SetupContextRouter;
+//#endregion
+//# sourceMappingURL=useRoute.d.mts.map

package/dist/dev/router/useRoute.mjs

@@ -9,17 +9,23 @@ import { resolveCurrentRoute, resolvePageRoute } from "../routerInternal/locatio
 import { cloneLocationQuery, cloneRouteLocationRedirectedFrom, cloneRouteMeta, cloneRouteParams, cloneRouteRecordMatchedList } from "../routerInternal/snapshots.mjs";
 import { useNativePageRouter as useNativePageRouter$1, useNativeRouter as useNativeRouter$1 } from "../runtime/vueCompat/router.mjs";
 import { resolveRouteLocation } from "./resolve.mjs";
+import { WEVU_NATIVE_INSTANCE_KEY } from "@weapp-core/constants";
 
 //#region src/router/useRoute.ts
 function isPageLikeInstance(instance) {
 	return typeof instance.route === "string" || typeof instance.__route__ === "string";
 }
+function resolveRouteControllerInstance(instance) {
+	const nativeInstance = instance[WEVU_NATIVE_INSTANCE_KEY];
+	return nativeInstance && typeof nativeInstance === "object" ? nativeInstance : instance;
+}
 function shouldSyncRouteStateForInstance(instance, isPageController, payload) {
 	if ((payload === null || payload === void 0 ? void 0 : payload.source) === "router") return true;
 	if (!isPageController) return true;
-	if (payload === null || payload === void 0 ? void 0 : payload.page) return payload.page === instance;
+	const routeControllerInstance = resolveRouteControllerInstance(instance);
+	if (payload === null || payload === void 0 ? void 0 : payload.page) return payload.page === routeControllerInstance;
 	const pages = getCurrentMiniProgramPages();
-	return pages[pages.length - 1] === instance;
+	return pages[pages.length - 1] === routeControllerInstance;
 }
 function applyRouteState(routeState, nextRoute) {
 	routeState.path = nextRoute.path;
@@ -43,12 +49,13 @@ function createRouteStateController(options = {}) {
 	const setupContext = getCurrentSetupContext();
 	if (!setupContext) throw new Error("useRoute() 必须在 setup() 的同步阶段调用");
 	const fallbackPage = setupContext.instance;
+	const initialRouteControllerInstance = resolveRouteControllerInstance(fallbackPage);
 	const resolveRoute = (_options$resolveRoute = options.resolveRoute) !== null && _options$resolveRoute !== void 0 ? _options$resolveRoute : ((route) => {
 		var _getActiveRouter$reso, _getActiveRouter;
 		return (_getActiveRouter$reso = (_getActiveRouter = getActiveRouter()) === null || _getActiveRouter === void 0 ? void 0 : _getActiveRouter.resolve(route)) !== null && _getActiveRouter$reso !== void 0 ? _getActiveRouter$reso : route;
 	});
 	const currentRoute = resolveRoute(resolveCurrentRoute(void 0, fallbackPage));
-	const isPageController = isPageLikeInstance(fallbackPage) || getCurrentMiniProgramPages().includes(fallbackPage);
+	const isPageController = isPageLikeInstance(initialRouteControllerInstance) || getCurrentMiniProgramPages().includes(initialRouteControllerInstance);
 	const routeState = reactive({
 		path: currentRoute.path,
 		fullPath: currentRoute.fullPath,
@@ -83,14 +90,14 @@ function createRouteStateController(options = {}) {
 			syncRoute(void 0, payload.route, payload);
 			return;
 		}
-		if (payload === null || payload === void 0 ? void 0 : payload.page) {
-			syncRoute(void 0, resolvePageRoute(payload.page), payload);
-			return;
-		}
 		if (payload === null || payload === void 0 ? void 0 : payload.url) {
 			syncRoute(void 0, resolveRouteLocation(payload.url, routeState.path), payload);
 			return;
 		}
+		if (payload === null || payload === void 0 ? void 0 : payload.page) {
+			syncRoute(void 0, resolvePageRoute(payload.page), payload);
+			return;
+		}
 		syncRoute(void 0, void 0, payload);
 	});
 	onUnload(() => {

package/dist/dev/router/useRoute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useRoute.mjs","names":["useNativeRouterInternal","useNativePageRouterInternal"],"sources":["../../../src/router/useRoute.ts"],"sourcesContent":["import type { MiniProgramPageLifetime } from '../runtime/types'\nimport type { SetupContextRouter } from '../runtime/types/props'\nimport type { RouteStateSyncPayload } from './routeSync'\nimport type { LocationQueryRaw, RouteLocationNormalizedLoaded } from './types'\nimport { reactive, readonly } from '../reactivity'\nimport { cloneLocationQuery, cloneRouteLocationRedirectedFrom, cloneRouteMeta, cloneRouteParams, cloneRouteRecordMatchedList, resolveCurrentRoute, resolvePageRoute } from '../routerInternal/shared'\nimport { getCurrentSetupContext, onLoad, onReady, onRouteDone, onShow, onUnload } from '../runtime/hooks'\nimport { getCurrentMiniProgramPages } from '../runtime/platform'\nimport {\n  useNativePageRouter as useNativePageRouterInternal,\n  useNativeRouter as useNativeRouterInternal,\n} from '../runtime/vueCompat'\nimport { getActiveRouter } from './instance'\nimport { resolveRouteLocation } from './resolve'\nimport { registerRouteStateSyncHandler } from './routeSync'\n\nexport interface UseRouteOptions {\n  resolveRoute?: (route: RouteLocationNormalizedLoaded) => RouteLocationNormalizedLoaded\n}\n\ninterface RouteStateControllerOptions extends UseRouteOptions {\n  beforeRouteStateSync?: (\n    nextRoute: RouteLocationNormalizedLoaded,\n    payload: RouteStateSyncPayload,\n  ) => void\n}\n\nexport interface RouteStateController {\n  route: Readonly<RouteLocationNormalizedLoaded>\n}\n\nfunction isPageLikeInstance(instance: Record<string, any>): boolean {\n  return typeof instance.route === 'string' || typeof instance.__route__ === 'string'\n}\n\nfunction shouldSyncRouteStateForInstance(\n  instance: Record<string, any>,\n  isPageController: boolean,\n  payload: RouteStateSyncPayload | undefined,\n): boolean {\n  if (payload?.source === 'router') {\n    return true\n  }\n\n  // 页面级 route controller 只处理当前页面的广播，避免 DevTools 在 onUnload/onShow\n  // 交错时让隐藏页面重复执行导航守卫。组件级 controller 仍接收全局同步。\n  if (!isPageController) {\n    return true\n  }\n\n  if (payload?.page) {\n    return payload.page === instance\n  }\n\n  const pages = getCurrentMiniProgramPages()\n  return pages[pages.length - 1] === instance\n}\n\nfunction applyRouteState(\n  routeState: RouteLocationNormalizedLoaded,\n  nextRoute: RouteLocationNormalizedLoaded,\n) {\n  routeState.path = nextRoute.path\n  routeState.fullPath = nextRoute.fullPath\n  routeState.query = cloneLocationQuery(nextRoute.query)\n  routeState.hash = nextRoute.hash\n  routeState.params = cloneRouteParams(nextRoute.params)\n  if (nextRoute.name === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).name\n  }\n  else {\n    routeState.name = nextRoute.name\n  }\n  if (nextRoute.meta === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).meta\n  }\n  else {\n    routeState.meta = cloneRouteMeta(nextRoute.meta)\n  }\n  if (nextRoute.href === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).href\n  }\n  else {\n    routeState.href = nextRoute.href\n  }\n  if (nextRoute.matched === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).matched\n  }\n  else {\n    routeState.matched = cloneRouteRecordMatchedList(nextRoute.matched)\n  }\n  if (nextRoute.redirectedFrom === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).redirectedFrom\n  }\n  else {\n    routeState.redirectedFrom = cloneRouteLocationRedirectedFrom(nextRoute.redirectedFrom)\n  }\n}\n\nexport function createRouteStateController(options: RouteStateControllerOptions = {}): RouteStateController {\n  const setupContext = getCurrentSetupContext()\n  if (!setupContext) {\n    throw new Error('useRoute() 必须在 setup() 的同步阶段调用')\n  }\n\n  const fallbackPage = setupContext.instance\n  const resolveRoute = options.resolveRoute\n    ?? ((route: RouteLocationNormalizedLoaded) => getActiveRouter()?.resolve(route) ?? route)\n  const currentRoute = resolveRoute(resolveCurrentRoute(undefined, fallbackPage))\n  const isPageController = isPageLikeInstance(fallbackPage)\n    || getCurrentMiniProgramPages().includes(fallbackPage)\n  const routeState = reactive<RouteLocationNormalizedLoaded>({\n    path: currentRoute.path,\n    fullPath: currentRoute.fullPath,\n    query: cloneLocationQuery(currentRoute.query),\n    hash: currentRoute.hash,\n    params: cloneRouteParams(currentRoute.params),\n  })\n  applyRouteState(routeState, currentRoute)\n\n  function syncRoute(\n    queryOverride?: LocationQueryRaw,\n    routeOverride?: RouteLocationNormalizedLoaded,\n    payload?: RouteStateSyncPayload,\n  ) {\n    const nextRoute = routeOverride\n      ? resolveRoute(routeOverride)\n      : resolveRoute(resolveCurrentRoute(queryOverride, fallbackPage))\n    if (payload) {\n      options.beforeRouteStateSync?.(nextRoute, payload)\n    }\n    applyRouteState(routeState, nextRoute)\n  }\n\n  onLoad((query: Parameters<NonNullable<MiniProgramPageLifetime['onLoad']>>[0]) => {\n    syncRoute(query as unknown as LocationQueryRaw)\n  })\n  onReady(() => {\n    syncRoute()\n  })\n  onShow(() => {\n    syncRoute()\n  })\n  onRouteDone(() => {\n    syncRoute()\n  })\n  const unregisterRouteStateSync = registerRouteStateSyncHandler((payload) => {\n    if (!shouldSyncRouteStateForInstance(fallbackPage, isPageController, payload)) {\n      return\n    }\n    if (payload?.route) {\n      syncRoute(undefined, payload.route, payload)\n      return\n    }\n    if (payload?.page) {\n      syncRoute(undefined, resolvePageRoute(payload.page), payload)\n      return\n    }\n    if (payload?.url) {\n      syncRoute(undefined, resolveRouteLocation(payload.url, routeState.path), payload)\n      return\n    }\n    syncRoute(undefined, undefined, payload)\n  })\n  onUnload(() => {\n    unregisterRouteStateSync()\n  })\n\n  return {\n    route: readonly(routeState) as Readonly<RouteLocationNormalizedLoaded>,\n  }\n}\n\nexport function useRoute(options: UseRouteOptions = {}): Readonly<RouteLocationNormalizedLoaded> {\n  return createRouteStateController(options).route\n}\n\n/**\n * @description 获取当前组件路径语义的原生 Router\n */\nexport function useNativeRouter(): SetupContextRouter {\n  return useNativeRouterInternal()\n}\n\n/**\n * @description 获取当前页面路径语义的原生 Page Router\n */\nexport function useNativePageRouter(): SetupContextRouter {\n  return useNativePageRouterInternal()\n}\n"],"mappings":"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"}
+{"version":3,"file":"useRoute.mjs","names":["useNativeRouterInternal","useNativePageRouterInternal"],"sources":["../../../src/router/useRoute.ts"],"sourcesContent":["import type { MiniProgramPageLifetime } from '../runtime/types'\nimport type { SetupContextRouter } from '../runtime/types/props'\nimport type { RouteStateSyncPayload } from './routeSync'\nimport type { LocationQueryRaw, RouteLocationNormalizedLoaded } from './types'\nimport { WEVU_NATIVE_INSTANCE_KEY } from '@weapp-core/constants'\nimport { reactive, readonly } from '../reactivity'\nimport { cloneLocationQuery, cloneRouteLocationRedirectedFrom, cloneRouteMeta, cloneRouteParams, cloneRouteRecordMatchedList, resolveCurrentRoute, resolvePageRoute } from '../routerInternal/shared'\nimport { getCurrentSetupContext, onLoad, onReady, onRouteDone, onShow, onUnload } from '../runtime/hooks'\nimport { getCurrentMiniProgramPages } from '../runtime/platform'\nimport {\n  useNativePageRouter as useNativePageRouterInternal,\n  useNativeRouter as useNativeRouterInternal,\n} from '../runtime/vueCompat'\nimport { getActiveRouter } from './instance'\nimport { resolveRouteLocation } from './resolve'\nimport { registerRouteStateSyncHandler } from './routeSync'\n\nexport interface UseRouteOptions {\n  resolveRoute?: (route: RouteLocationNormalizedLoaded) => RouteLocationNormalizedLoaded\n}\n\ninterface RouteStateControllerOptions extends UseRouteOptions {\n  beforeRouteStateSync?: (\n    nextRoute: RouteLocationNormalizedLoaded,\n    payload: RouteStateSyncPayload,\n  ) => void\n}\n\nexport interface RouteStateController {\n  route: Readonly<RouteLocationNormalizedLoaded>\n}\n\nfunction isPageLikeInstance(instance: Record<string, any>): boolean {\n  return typeof instance.route === 'string' || typeof instance.__route__ === 'string'\n}\n\nfunction resolveRouteControllerInstance(instance: Record<string, any>): Record<string, any> {\n  const nativeInstance = instance[WEVU_NATIVE_INSTANCE_KEY]\n  return nativeInstance && typeof nativeInstance === 'object'\n    ? nativeInstance\n    : instance\n}\n\nfunction shouldSyncRouteStateForInstance(\n  instance: Record<string, any>,\n  isPageController: boolean,\n  payload: RouteStateSyncPayload | undefined,\n): boolean {\n  if (payload?.source === 'router') {\n    return true\n  }\n\n  // 页面级 route controller 只处理当前页面的广播，避免 DevTools 在 onUnload/onShow\n  // 交错时让隐藏页面重复执行导航守卫。组件级 controller 仍接收全局同步。\n  if (!isPageController) {\n    return true\n  }\n\n  const routeControllerInstance = resolveRouteControllerInstance(instance)\n  if (payload?.page) {\n    return payload.page === routeControllerInstance\n  }\n\n  const pages = getCurrentMiniProgramPages()\n  return pages[pages.length - 1] === routeControllerInstance\n}\n\nfunction applyRouteState(\n  routeState: RouteLocationNormalizedLoaded,\n  nextRoute: RouteLocationNormalizedLoaded,\n) {\n  routeState.path = nextRoute.path\n  routeState.fullPath = nextRoute.fullPath\n  routeState.query = cloneLocationQuery(nextRoute.query)\n  routeState.hash = nextRoute.hash\n  routeState.params = cloneRouteParams(nextRoute.params)\n  if (nextRoute.name === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).name\n  }\n  else {\n    routeState.name = nextRoute.name\n  }\n  if (nextRoute.meta === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).meta\n  }\n  else {\n    routeState.meta = cloneRouteMeta(nextRoute.meta)\n  }\n  if (nextRoute.href === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).href\n  }\n  else {\n    routeState.href = nextRoute.href\n  }\n  if (nextRoute.matched === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).matched\n  }\n  else {\n    routeState.matched = cloneRouteRecordMatchedList(nextRoute.matched)\n  }\n  if (nextRoute.redirectedFrom === undefined) {\n    delete (routeState as Partial<RouteLocationNormalizedLoaded>).redirectedFrom\n  }\n  else {\n    routeState.redirectedFrom = cloneRouteLocationRedirectedFrom(nextRoute.redirectedFrom)\n  }\n}\n\nexport function createRouteStateController(options: RouteStateControllerOptions = {}): RouteStateController {\n  const setupContext = getCurrentSetupContext()\n  if (!setupContext) {\n    throw new Error('useRoute() 必须在 setup() 的同步阶段调用')\n  }\n\n  const fallbackPage = setupContext.instance\n  const initialRouteControllerInstance = resolveRouteControllerInstance(fallbackPage)\n  const resolveRoute = options.resolveRoute\n    ?? ((route: RouteLocationNormalizedLoaded) => getActiveRouter()?.resolve(route) ?? route)\n  const currentRoute = resolveRoute(resolveCurrentRoute(undefined, fallbackPage))\n  const isPageController = isPageLikeInstance(initialRouteControllerInstance)\n    || getCurrentMiniProgramPages().includes(initialRouteControllerInstance)\n  const routeState = reactive<RouteLocationNormalizedLoaded>({\n    path: currentRoute.path,\n    fullPath: currentRoute.fullPath,\n    query: cloneLocationQuery(currentRoute.query),\n    hash: currentRoute.hash,\n    params: cloneRouteParams(currentRoute.params),\n  })\n  applyRouteState(routeState, currentRoute)\n\n  function syncRoute(\n    queryOverride?: LocationQueryRaw,\n    routeOverride?: RouteLocationNormalizedLoaded,\n    payload?: RouteStateSyncPayload,\n  ) {\n    const nextRoute = routeOverride\n      ? resolveRoute(routeOverride)\n      : resolveRoute(resolveCurrentRoute(queryOverride, fallbackPage))\n    if (payload) {\n      options.beforeRouteStateSync?.(nextRoute, payload)\n    }\n    applyRouteState(routeState, nextRoute)\n  }\n\n  onLoad((query: Parameters<NonNullable<MiniProgramPageLifetime['onLoad']>>[0]) => {\n    syncRoute(query as unknown as LocationQueryRaw)\n  })\n  onReady(() => {\n    syncRoute()\n  })\n  onShow(() => {\n    syncRoute()\n  })\n  onRouteDone(() => {\n    syncRoute()\n  })\n  const unregisterRouteStateSync = registerRouteStateSyncHandler((payload) => {\n    if (!shouldSyncRouteStateForInstance(fallbackPage, isPageController, payload)) {\n      return\n    }\n    if (payload?.route) {\n      syncRoute(undefined, payload.route, payload)\n      return\n    }\n    if (payload?.url) {\n      syncRoute(undefined, resolveRouteLocation(payload.url, routeState.path), payload)\n      return\n    }\n    if (payload?.page) {\n      syncRoute(undefined, resolvePageRoute(payload.page), payload)\n      return\n    }\n    syncRoute(undefined, undefined, payload)\n  })\n  onUnload(() => {\n    unregisterRouteStateSync()\n  })\n\n  return {\n    route: readonly(routeState) as Readonly<RouteLocationNormalizedLoaded>,\n  }\n}\n\nexport function useRoute(options: UseRouteOptions = {}): Readonly<RouteLocationNormalizedLoaded> {\n  return createRouteStateController(options).route\n}\n\n/**\n * @description 获取当前组件路径语义的原生 Router\n */\nexport function useNativeRouter(): SetupContextRouter {\n  return useNativeRouterInternal()\n}\n\n/**\n * @description 获取当前页面路径语义的原生 Page Router\n */\nexport function useNativePageRouter(): SetupContextRouter {\n  return useNativePageRouterInternal()\n}\n"],"mappings":"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"}

package/dist/dev/router/useRouter.d.mts

@@ -0,0 +1,8 @@
+import { RouterNavigation } from "./types.mjs";
+//#region src/router/useRouter.d.ts
+/**
+ * @description 获取当前已创建的路由实例。
+ */
+export declare function useRouter(): RouterNavigation;
+//#endregion
+//# sourceMappingURL=useRouter.d.mts.map

package/dist/dev/router.d.mts

@@ -0,0 +1,10 @@
+import { RouterNavigateToOption, RouterReLaunchOption, RouterRedirectToOption, RouterSwitchTabOption, SetupContextRouter, TypedRouterTabBarUrl, TypedRouterUrl, WevuTypedRouterRouteMap } from "./runtime/types/props/router.mjs";
+import "./runtime/types/props.mjs";
+import { parseQuery, stringifyQuery } from "./routerInternal/query.mjs";
+import { AddRoute, InitialNavigationMode, LocationQuery, LocationQueryRaw, LocationQueryValue, LocationQueryValueRaw, NamedRouteRecord, NamedRoutes, NavigationAfterEach, NavigationAfterEachContext, NavigationErrorContext, NavigationErrorHandler, NavigationFailure, NavigationFailureType, NavigationFailureTypeValue, NavigationGuard, NavigationGuardContext, NavigationGuardResult, NavigationMode, NavigationRedirect, RouteLocationNormalizedLoaded, RouteLocationRaw, RouteLocationRedirectedFrom, RouteMeta, RouteParamValue, RouteParamValueRaw, RouteParams, RouteParamsMode, RouteParamsRaw, RouteQueryParser, RouteQueryStringifier, RouteRecordInput, RouteRecordMatched, RouteRecordRaw, RouteRecordRedirect, RouterNavigation, UseRouterOptions } from "./router/types.mjs";
+import { createRouter } from "./router/createRouter.mjs";
+import { createNavigationFailure, isNavigationFailure } from "./router/navigationCore.mjs";
+import { resolveRouteLocation } from "./router/resolve.mjs";
+import { useNativePageRouter, useNativeRouter, useRoute } from "./router/useRoute.mjs";
+import { useRouter } from "./router/useRouter.mjs";
+export { type AddRoute, type InitialNavigationMode, 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 RouteRecordInput, 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, createRouter, isNavigationFailure, parseQuery, resolveRouteLocation, stringifyQuery, useNativePageRouter, useNativeRouter, useRoute, useRouter };

package/dist/dev/routerInternal/query.d.mts

@@ -0,0 +1,7 @@
+import { LocationQuery, LocationQueryRaw } from "../router/types.mjs";
+import "../router.mjs";
+//#region src/routerInternal/query.d.ts
+export declare function parseQuery(search: string): LocationQuery;
+export declare function stringifyQuery(query?: LocationQueryRaw | LocationQuery): string;
+//#endregion
+//# sourceMappingURL=query.d.mts.map

package/dist/dev/routerInternal/types.d.mts

@@ -0,0 +1,9 @@
+import { RouteQueryParser, RouteQueryStringifier } from "../router/types.mjs";
+import "../router.mjs";
+//#region src/routerInternal/types.d.ts
+export interface RouteResolveCodec {
+  parseQuery: RouteQueryParser;
+  stringifyQuery: RouteQueryStringifier;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/dev/runtime/app/computed.mjs

@@ -1,4 +1,4 @@
-import { effect, track, trigger } from "../../reactivity/core.mjs";
+import { createComputedEffect, track, trigger } from "../../reactivity/core.mjs";
 import { markAsRef } from "../../reactivity/ref.mjs";
 
 //#region src/runtime/app/computed.ts
@@ -25,7 +25,7 @@ function createComputedAccessors(options) {
 			}
 		};
 		markAsRef(obj);
-		runner = effect(getter, {
+		runner = createComputedEffect(getter, {
 			lazy: true,
 			scheduler: () => {
 				if (!dirty) {

package/dist/dev/runtime/app/computed.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"computed.mjs","names":[],"sources":["../../../../src/runtime/app/computed.ts"],"sourcesContent":["import type { ComputedRef } from '../../reactivity'\nimport { effect } from '../../reactivity'\nimport { track, trigger } from '../../reactivity/core'\nimport { markAsRef } from '../../reactivity/ref'\n\ninterface ComputedOptions {\n  includeComputed: boolean\n  setDataStrategy: 'diff' | 'patch'\n}\n\nexport function createComputedAccessors(options: ComputedOptions) {\n  const computedRefs: Record<string, ComputedRef<any>> = Object.create(null)\n  const computedSetters: Record<string, (value: any) => void> = Object.create(null)\n  const dirtyComputedKeys = new Set<string>()\n\n  const createTrackedComputed = <T>(\n    key: string,\n    getter: () => T,\n    setter?: (value: T) => void,\n  ): ComputedRef<T> => {\n    let value: T\n    let dirty = true\n    let runner!: () => T\n    const obj: any = {\n      get value() {\n        if (dirty) {\n          value = runner()\n          dirty = false\n        }\n        track(obj, 'value')\n        return value\n      },\n      set value(nextValue: T) {\n        if (!setter) {\n          throw new Error('计算属性是只读的')\n        }\n        setter(nextValue)\n      },\n    }\n    markAsRef(obj)\n    runner = effect(getter, {\n      lazy: true,\n      scheduler: () => {\n        if (!dirty) {\n          dirty = true\n          if (options.setDataStrategy === 'patch' && options.includeComputed) {\n            dirtyComputedKeys.add(key)\n          }\n          trigger(obj, 'value')\n        }\n      },\n    })\n    return obj as ComputedRef<T>\n  }\n\n  const computedProxy = new Proxy(\n    {},\n    {\n      get(_target, key: string | symbol) {\n        if (typeof key === 'string' && computedRefs[key]) {\n          return computedRefs[key].value\n        }\n        return undefined\n      },\n      has(_target, key: string | symbol) {\n        return typeof key === 'string' && Boolean(computedRefs[key])\n      },\n      ownKeys() {\n        return Object.keys(computedRefs)\n      },\n      getOwnPropertyDescriptor(_target, key: string | symbol) {\n        if (typeof key === 'string' && computedRefs[key]) {\n          return {\n            configurable: true,\n            enumerable: true,\n            value: computedRefs[key].value,\n          }\n        }\n        return undefined\n      },\n    },\n  )\n\n  return {\n    computedRefs,\n    computedSetters,\n    dirtyComputedKeys,\n    createTrackedComputed,\n    computedProxy,\n  }\n}\n"],"mappings":";;;;AAUA,SAAgB,wBAAwB,SAA0B;CAChE,MAAM,eAAiD,OAAO,OAAO,IAAI;CACzE,MAAM,kBAAwD,OAAO,OAAO,IAAI;CAChF,MAAM,oCAAoB,IAAI,IAAY;CAE1C,MAAM,yBACJ,KACA,QACA,WACmB;EACnB,IAAI;EACJ,IAAI,QAAQ;EACZ,IAAI;EACJ,MAAM,MAAW;GACf,IAAI,QAAQ;IACV,IAAI,OAAO;KACT,QAAQ,OAAO;KACf,QAAQ;IACV;IACA,MAAM,KAAK,OAAO;IAClB,OAAO;GACT;GACA,IAAI,MAAM,WAAc;IACtB,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,UAAU;IAE5B,OAAO,SAAS;GAClB;EACF;EACA,UAAU,GAAG;EACb,SAAS,OAAO,QAAQ;GACtB,MAAM;GACN,iBAAiB;IACf,IAAI,CAAC,OAAO;KACV,QAAQ;KACR,IAAI,QAAQ,oBAAoB,WAAW,QAAQ,iBACjD,kBAAkB,IAAI,GAAG;KAE3B,QAAQ,KAAK,OAAO;IACtB;GACF;EACF,CAAC;EACD,OAAO;CACT;CA8BA,OAAO;EACL;EACA;EACA;EACA;EACA,mBAjCwB,MACxB,CAAC,GACD;GACE,IAAI,SAAS,KAAsB;IACjC,IAAI,OAAO,QAAQ,YAAY,aAAa,MAC1C,OAAO,aAAa,IAAI,CAAC;GAG7B;GACA,IAAI,SAAS,KAAsB;IACjC,OAAO,OAAO,QAAQ,YAAY,QAAQ,aAAa,IAAI;GAC7D;GACA,UAAU;IACR,OAAO,OAAO,KAAK,YAAY;GACjC;GACA,yBAAyB,SAAS,KAAsB;IACtD,IAAI,OAAO,QAAQ,YAAY,aAAa,MAC1C,OAAO;KACL,cAAc;KACd,YAAY;KACZ,OAAO,aAAa,IAAI,CAAC;IAC3B;GAGJ;EACF,CAQY;CACd;AACF"}
+{"version":3,"file":"computed.mjs","names":[],"sources":["../../../../src/runtime/app/computed.ts"],"sourcesContent":["import type { ComputedRef } from '../../reactivity'\nimport { createComputedEffect, track, trigger } from '../../reactivity/core'\nimport { markAsRef } from '../../reactivity/ref'\n\ninterface ComputedOptions {\n  includeComputed: boolean\n  setDataStrategy: 'diff' | 'patch'\n}\n\nexport function createComputedAccessors(options: ComputedOptions) {\n  const computedRefs: Record<string, ComputedRef<any>> = Object.create(null)\n  const computedSetters: Record<string, (value: any) => void> = Object.create(null)\n  const dirtyComputedKeys = new Set<string>()\n\n  const createTrackedComputed = <T>(\n    key: string,\n    getter: () => T,\n    setter?: (value: T) => void,\n  ): ComputedRef<T> => {\n    let value: T\n    let dirty = true\n    let runner!: () => T\n    const obj: any = {\n      get value() {\n        if (dirty) {\n          value = runner()\n          dirty = false\n        }\n        track(obj, 'value')\n        return value\n      },\n      set value(nextValue: T) {\n        if (!setter) {\n          throw new Error('计算属性是只读的')\n        }\n        setter(nextValue)\n      },\n    }\n    markAsRef(obj)\n    runner = createComputedEffect(getter, {\n      lazy: true,\n      scheduler: () => {\n        if (!dirty) {\n          dirty = true\n          if (options.setDataStrategy === 'patch' && options.includeComputed) {\n            dirtyComputedKeys.add(key)\n          }\n          trigger(obj, 'value')\n        }\n      },\n    })\n    return obj as ComputedRef<T>\n  }\n\n  const computedProxy = new Proxy(\n    {},\n    {\n      get(_target, key: string | symbol) {\n        if (typeof key === 'string' && computedRefs[key]) {\n          return computedRefs[key].value\n        }\n        return undefined\n      },\n      has(_target, key: string | symbol) {\n        return typeof key === 'string' && Boolean(computedRefs[key])\n      },\n      ownKeys() {\n        return Object.keys(computedRefs)\n      },\n      getOwnPropertyDescriptor(_target, key: string | symbol) {\n        if (typeof key === 'string' && computedRefs[key]) {\n          return {\n            configurable: true,\n            enumerable: true,\n            value: computedRefs[key].value,\n          }\n        }\n        return undefined\n      },\n    },\n  )\n\n  return {\n    computedRefs,\n    computedSetters,\n    dirtyComputedKeys,\n    createTrackedComputed,\n    computedProxy,\n  }\n}\n"],"mappings":";;;;AASA,SAAgB,wBAAwB,SAA0B;CAChE,MAAM,eAAiD,OAAO,OAAO,IAAI;CACzE,MAAM,kBAAwD,OAAO,OAAO,IAAI;CAChF,MAAM,oCAAoB,IAAI,IAAY;CAE1C,MAAM,yBACJ,KACA,QACA,WACmB;EACnB,IAAI;EACJ,IAAI,QAAQ;EACZ,IAAI;EACJ,MAAM,MAAW;GACf,IAAI,QAAQ;IACV,IAAI,OAAO;KACT,QAAQ,OAAO;KACf,QAAQ;IACV;IACA,MAAM,KAAK,OAAO;IAClB,OAAO;GACT;GACA,IAAI,MAAM,WAAc;IACtB,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,UAAU;IAE5B,OAAO,SAAS;GAClB;EACF;EACA,UAAU,GAAG;EACb,SAAS,qBAAqB,QAAQ;GACpC,MAAM;GACN,iBAAiB;IACf,IAAI,CAAC,OAAO;KACV,QAAQ;KACR,IAAI,QAAQ,oBAAoB,WAAW,QAAQ,iBACjD,kBAAkB,IAAI,GAAG;KAE3B,QAAQ,KAAK,OAAO;IACtB;GACF;EACF,CAAC;EACD,OAAO;CACT;CA8BA,OAAO;EACL;EACA;EACA;EACA;EACA,mBAjCwB,MACxB,CAAC,GACD;GACE,IAAI,SAAS,KAAsB;IACjC,IAAI,OAAO,QAAQ,YAAY,aAAa,MAC1C,OAAO,aAAa,IAAI,CAAC;GAG7B;GACA,IAAI,SAAS,KAAsB;IACjC,OAAO,OAAO,QAAQ,YAAY,QAAQ,aAAa,IAAI;GAC7D;GACA,UAAU;IACR,OAAO,OAAO,KAAK,YAAY;GACjC;GACA,yBAAyB,SAAS,KAAsB;IACtD,IAAI,OAAO,QAAQ,YAAY,aAAa,MAC1C,OAAO;KACL,cAAc;KACd,YAAY;KACZ,OAAO,aAAa,IAAI,CAAC;IAC3B;GAGJ;EACF,CAQY;CACd;AACF"}

package/dist/dev/runtime/app/context.mjs

@@ -6,7 +6,7 @@ import { setComputedValue } from "../internal.mjs";
 import { normalizeEmitEventName, normalizeEmitPayload } from "../emit.mjs";
 import { isNativeBridgeMethod, markNativeBridgeMethod } from "../nativeBridge.mjs";
 import { createComputedAccessors } from "./computed.mjs";
-import { WEVU_COMPONENT_NAME_KEY, WEVU_INLINE_MAP_KEY, WEVU_NATIVE_INSTANCE_KEY, WEVU_PARENT_INSTANCE_KEY, WEVU_PROPS_KEY, WEVU_RESOLVE_PUBLIC_INSTANCE_METHOD, WEVU_RUNTIME_APP_KEY, WEVU_RUNTIME_KEY } from "@weapp-core/constants";
+import { WEVU_COMPONENT_NAME_KEY, WEVU_HOST_COMMIT_PROMISE_KEY, WEVU_INLINE_MAP_KEY, WEVU_NATIVE_INSTANCE_KEY, WEVU_PARENT_INSTANCE_KEY, WEVU_PROPS_KEY, WEVU_RESOLVE_PUBLIC_INSTANCE_METHOD, WEVU_RUNTIME_APP_KEY, WEVU_RUNTIME_KEY } from "@weapp-core/constants";
 
 //#region src/runtime/app/context.ts
 function createRuntimeContext(options) {
@@ -118,7 +118,13 @@ function createRuntimeContext(options) {
 					const { detail, options } = normalizeEmitPayload(args);
 					return triggerEvent.call(nativeInstance, normalizeEmitEventName(eventName), detail, options);
 				};
-				if (key === "$nextTick") return (fn) => fn ? nextTick(() => fn.call(publicInstance)) : nextTick();
+				if (key === "$nextTick") return async (fn) => {
+					await nextTick();
+					const nativeInstance = resolveNativeInstance(target, receiver);
+					const hostCommit = nativeInstance && Reflect.get(nativeInstance, WEVU_HOST_COMMIT_PROMISE_KEY);
+					if (hostCommit && (typeof hostCommit === "object" || typeof hostCommit === "function") && "then" in hostCommit && typeof hostCommit.then === "function") await hostCommit;
+					if (fn) return fn.call(publicInstance);
+				};
 				if (key === "$set") return (object, property, value) => {
 					Reflect.set(object, property, value);
 					return value;