wevu 7.4.0 → 7.6.0

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

@@ -1,27 +0,0 @@
-import { Ref } from "./ref.mjs";
-//#region src/reactivity/readonly.d.ts
-/**
- * readonly 会为对象/数组创建一个“浅层”只读代理，并为 Ref 创建只读包装。
- * 选择浅层而非深层递归，是为了在小程序环境中保持实现和运行时开销最小，
- * 仅阻止直接属性写入/删除，嵌套对象仍按原样透传。
- */
-export declare function readonly<T extends object>(target: T): Readonly<T>;
-export declare function readonly<T>(target: Ref<T>): Readonly<Ref<T>>;
-/**
- * 与 Vue 3 的 `shallowReadonly()` 对齐。
- *
- * 当前 wevu 的只读语义本身就是浅层只读，因此这里直接复用同一套实现，
- * 让依赖 Vue 兼容 API 的代码可以无缝迁移。
- */
-export declare function shallowReadonly<T extends object>(target: T): Readonly<T>;
-export declare function shallowReadonly<T>(target: Ref<T>): Readonly<Ref<T>>;
-/**
- * 判断值是否为只读代理或只读 ref 包装。
- */
-export declare function isReadonly(value: unknown): boolean;
-/**
- * 判断值是否为响应式代理或只读代理。
- */
-export declare function isProxy(value: unknown): boolean;
-//#endregion
-//# sourceMappingURL=readonly.d.mts.map

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

@@ -1,27 +0,0 @@
-import { ComputedRef, WritableComputedRef } from "./computed.mjs";
-import { Ref as Ref$1, ShallowRef as ShallowRef$1 } from "../vue-types.mjs";
-//#region src/reactivity/ref.d.ts
-export type Ref<T = any, S = T> = Ref$1<T, S>;
-export type ShallowRef<T = any> = ShallowRef$1<T>;
-export type MaybeRef<T = any> = T | Ref<T> | ShallowRef<T> | WritableComputedRef<T>;
-export type MaybeRefOrGetter<T = any> = MaybeRef<T> | ComputedRef<T> | (() => T);
-export declare function isRef(value: unknown): value is Ref<any>;
-export declare function ref<T = any>(): Ref<T | undefined>;
-export declare function ref<T>(value: T): Ref<T>;
-export declare function unref<T>(value: MaybeRef<T> | ComputedRef<T>): T;
-export declare function toValue<T>(source: MaybeRefOrGetter<T>): T;
-/**
- * 自定义 ref 工厂：用于创建可显式控制 track/trigger 的自定义 ref
- */
-export type CustomRefFactory<T> = (track: () => void, trigger: () => void) => {
-  get: () => T;
-  set: (value: T) => void;
-};
-export interface CustomRefOptions<T> {
-  get: () => T;
-  set: (value: T) => void;
-}
-export type CustomRefSource<T> = CustomRefFactory<T> | CustomRefOptions<T>;
-export declare function customRef<T>(factory: CustomRefSource<T>, defaultValue?: T): Ref<T>;
-//#endregion
-//# sourceMappingURL=ref.d.mts.map

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

@@ -1,19 +0,0 @@
-import { Ref } from "./ref.mjs";
-//#region src/reactivity/shallowRef.d.ts
-export declare function shallowRef<T>(value: T): Ref<T>;
-export declare function shallowRef<T>(value: T, defaultValue: T): Ref<T>;
-/**
- * 判断传入值是否为浅层 ref。
- *
- * @param r 待判断的值
- * @returns 若为浅层 ref 则返回 true
- */
-export declare function isShallowRef(r: any): r is Ref<any>;
-/**
- * 主动触发一次浅层 ref 的更新（无需深度比较）。
- *
- * @param ref 需要触发的 ref
- */
-export declare function triggerRef<T>(ref: Ref<T>): void;
-//#endregion
-//# sourceMappingURL=shallowRef.d.mts.map

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

@@ -1,43 +0,0 @@
-import { Ref } from "./ref.mjs";
-//#region src/reactivity/toRefs.d.ts
-/**
- * 为源响应式对象的单个属性创建 ref，可读可写并与原属性保持同步。
- *
- * @param object 源响应式对象
- * @param key 属性名
- * @returns 指向该属性的 ref
- *
- * @example
- * ```ts
- * const state = reactive({ foo: 1 })
- * const fooRef = toRef(state, 'foo')
- *
- * fooRef.value++
- * console.log(state.foo) // 2
- * ```
- */
-export declare function toRef<T extends object, K extends keyof T>(object: T, key: K): ToRef<T[K]>;
-export declare function toRef<T extends object, K extends keyof T>(object: T, key: K, defaultValue: T[K]): ToRef<T[K]>;
-/**
- * 将一个响应式对象转换成“同结构的普通对象”，其中每个字段都是指向原对象对应属性的 ref。
- *
- * @param object 待转换的响应式对象
- * @returns 包含若干 ref 的普通对象
- *
- * @example
- * ```ts
- * const state = reactive({ foo: 1, bar: 2 })
- * const stateAsRefs = toRefs(state)
- *
- * stateAsRefs.foo.value++ // 2
- * state.foo // 2
- * ```
- */
-export declare function toRefs<T extends object>(object: T): ToRefs<T>;
-/**
- * toRefs 返回值的类型辅助
- */
-type ToRef<T> = T extends Ref<any> ? T : Ref<T>;
-export type ToRefs<T extends object> = { [K in keyof T]: ToRef<T[K]>; };
-//#endregion
-//# sourceMappingURL=toRefs.d.mts.map

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

@@ -1,8 +0,0 @@
-//#region src/reactivity/traverse.d.ts
-/**
- * 深度遍历工具（框架内部依赖收集使用）。
- * @internal
- */
-export declare function traverse(value: any, depth?: number, seen?: Map<object, number>): any;
-//#endregion
-//# sourceMappingURL=traverse.d.mts.map

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

@@ -1,43 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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/auto-routes.d.mts

@@ -1,8 +0,0 @@
-import { WevuAutoRoute } from "./types.mjs";
-import { WevuNamedRouteMap } from "../router.mjs";
-//#region src/router/auto-routes.d.ts
-export type WevuAutoRoutes<TRouteMap extends object = WevuNamedRouteMap> = readonly WevuAutoRoute<TRouteMap>[];
-export declare const routes: WevuAutoRoutes;
-//#endregion
-export type { WevuAutoRoute };
-//# sourceMappingURL=auto-routes.d.mts.map

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

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

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

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

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

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

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

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

package/dist/dev/router/scrollRestoration/adapters.d.mts

@@ -1,8 +0,0 @@
-import { ScrollRestorationHandle, ScrollRestorationRegistrationOptions, ScrollViewRestorationHandle } from "./types.mjs";
-//#region src/router/scrollRestoration/adapters.d.ts
-/** WebView 页面适配器；Skyline 没有隐式页面滚动容器。 */
-export declare function usePageScrollRestoration(options?: ScrollRestorationRegistrationOptions): ScrollRestorationHandle;
-/** 用属性控制 WebView/Skyline scroll-view，scroll 事件不产生 setData。 */
-export declare function useScrollViewRestoration(options?: ScrollRestorationRegistrationOptions): ScrollViewRestorationHandle;
-//#endregion
-//# sourceMappingURL=adapters.d.mts.map

package/dist/dev/router/scrollRestoration/controller.d.mts

@@ -1,8 +0,0 @@
-import "../types.mjs";
-import { ScrollRestorationController, ScrollRestorationOptions } from "./types.mjs";
-import "./host.mjs";
-//#region src/router/scrollRestoration/controller.d.ts
-/** 创建显式启用的路由会话；不会安装全局默认滚动行为。 */
-export declare function createScrollRestoration<TRouteMap extends object>(options: ScrollRestorationOptions<TRouteMap>): ScrollRestorationController;
-//#endregion
-//# sourceMappingURL=controller.d.mts.map

package/dist/dev/router/scrollRestoration/host.d.mts

@@ -1,3 +0,0 @@
-import "../../routerInternal/types.mjs";
-import "../types.mjs";
-import { WEVU_HOOKS_KEY, WEVU_NATIVE_INSTANCE_KEY, WEVU_READY_CALLED_KEY } from "@weapp-core/constants";

package/dist/dev/router/scrollRestoration/index.d.mts

@@ -1,9 +0,0 @@
-import { ScrollRestorationContext, ScrollRestorationController, ScrollRestorationHandle, ScrollRestorationOptions, ScrollRestorationRegistrationOptions, ScrollViewRestorationHandle, UseScrollRestorationOptions } from "./types.mjs";
-import "./host.mjs";
-import { createScrollRestoration } from "./controller.mjs";
-//#region src/router/scrollRestoration/index.d.ts
-/** 在同步 setup 中注册快照；只恢复新实例，不覆盖原生保留页的位置。 */
-export declare function useScrollRestoration<T extends object>(options: UseScrollRestorationOptions<T>): ScrollRestorationHandle;
-//#endregion
-export { type ScrollRestorationContext, type ScrollRestorationController, type ScrollRestorationHandle, type ScrollRestorationOptions, type ScrollRestorationRegistrationOptions, type ScrollViewRestorationHandle, type UseScrollRestorationOptions, createScrollRestoration };
-//# sourceMappingURL=index.d.mts.map

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

@@ -1,61 +0,0 @@
-import { Ref } from "../../reactivity/ref.mjs";
-import "../../reactivity/index.mjs";
-import { RouteLocationNormalizedLoaded, RouterNavigation } from "../types.mjs";
-//#region src/router/scrollRestoration/types.d.ts
-export interface ScrollRestorationController {
-  /** 当前宿主是否支持带 routeEventId 的自动路由关联。 */
-  readonly automatic: boolean;
-  /** 清除整个会话或指定路由 key 的快照，不注销组件。 */
-  clear: (key?: string) => void;
-  /** 注销宿主监听、组件注册和未完成的恢复，并清空会话。 */
-  dispose: () => void;
-}
-export interface ScrollRestorationOptions<TRouteMap extends object = object> {
-  router: RouterNavigation<TRouteMap>;
-  /** 自动捕获或恢复失败时调用；手动 scroll 的错误由调用者处理。 */
-  onError?: (error: unknown) => void;
-}
-export interface ScrollRestorationContext {
-  readonly route: Readonly<RouteLocationNormalizedLoaded>;
-  readonly routeEventId?: string;
-  /** 异步自定义恢复在每次 await 后、写入宿主前必须重新检查。 */
-  isActive: () => boolean;
-}
-export interface ScrollRestorationRegistrationOptions {
-  controller?: ScrollRestorationController;
-  /** 默认使用包含 query 的 route.fullPath。 */
-  key?: string | ((route: Readonly<RouteLocationNormalizedLoaded>) => string);
-  /** 同一页面和路由 key 内的独立容器名，默认为 default。 */
-  id?: string;
-  /** 只捕获，不在原生路由完成后自动恢复。 */
-  manual?: boolean;
-}
-export interface UseScrollRestorationOptions<T extends object> extends ScrollRestorationRegistrationOptions {
-  /** 同步返回独立快照；不能返回响应式活动对象或 Promise，null 表示清除。 */
-  capture: () => (T & {
-    then?: never;
-  }) | null;
-  restore: (snapshot: T | undefined, context: ScrollRestorationContext) => void | Promise<void>;
-}
-export interface ScrollRestorationHandle {
-  readonly automatic: boolean;
-  /** 等待组件就绪及宿主提交后恢复；已离开或失效时返回 false。 */
-  scroll: () => Promise<boolean>;
-  /** 只清除当前 key/id 的快照。 */
-  clear: () => void;
-  /** 停止当前注册；保留已捕获快照。 */
-  stop: () => void;
-}
-export interface ScrollViewRestorationHandle extends ScrollRestorationHandle {
-  scrollTop: Ref<number>;
-  scrollLeft: Ref<number>;
-  /** 绑定 scroll-view 的 scroll 事件，只更新非响应式缓存。 */
-  onScroll: (event: {
-    detail: {
-      scrollTop: number;
-      scrollLeft: number;
-    };
-  }) => void;
-}
-//#endregion
-//# sourceMappingURL=types.d.mts.map

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

@@ -1,267 +0,0 @@
-import { SetupContextRouter, TypedRouterTabBarUrl } from "../runtime/types/props/router.mjs";
-import "../runtime/types/props.mjs";
-import { WevuNamedRouteMap } from "../router.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 WevuNamedRouteDefinition {
-  readonly path: string;
-  readonly meta: RouteMeta;
-}
-/**
- * 显式选择不收窄名称和元信息的兼容路由模式。
- */
-export type WevuBroadRouteMap = Record<string, WevuNamedRouteDefinition>;
-type DeclaredRouteName<TRouteMap extends object> = Extract<keyof TRouteMap, string>;
-type IsBroadRouteMap<TRouteMap extends object> = [DeclaredRouteName<TRouteMap>] extends [never] ? true : string extends DeclaredRouteName<TRouteMap> ? true : false;
-export type WevuRouteName<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? string : DeclaredRouteName<TRouteMap>;
-export type WevuNamedRoutePath<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = IsBroadRouteMap<TRouteMap> extends true ? string : TName extends keyof TRouteMap ? TRouteMap[TName] extends {
-  readonly path: infer TPath extends string;
-} ? TPath : never : never;
-export type WevuNamedRouteMeta<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = IsBroadRouteMap<TRouteMap> extends true ? RouteMeta : TName extends keyof TRouteMap ? TRouteMap[TName] extends {
-  readonly meta: infer TMeta extends RouteMeta;
-} ? TMeta : never : never;
-type StrictRouteRecordMeta<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = keyof WevuNamedRouteMeta<TRouteMap, TName> extends never ? Record<string, never> : WevuNamedRouteMeta<TRouteMap, TName>;
-interface RouteLocationRawCommon {
-  query?: LocationQueryRaw;
-  hash?: string;
-  params?: RouteParamsRaw;
-}
-export type RouteLocationNamedRaw<TRouteMap extends object = WevuNamedRouteMap, TName extends WevuRouteName<TRouteMap> = WevuRouteName<TRouteMap>> = RouteLocationRawCommon & {
-  name: TName;
-  path?: never;
-  fullPath?: never;
-};
-type RouteLocationPathRaw = RouteLocationRawCommon & {
-  name?: never;
-  path?: string;
-  fullPath?: string;
-};
-type BroadRouteLocationRaw = string | RouteLocationRawCommon & {
-  path?: string;
-  fullPath?: string;
-  name?: string;
-};
-export type RouteLocationRaw<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? BroadRouteLocationRaw : string | RouteLocationPathRaw | { [TName in WevuRouteName<TRouteMap>]: RouteLocationNamedRaw<TRouteMap, TName>; }[WevuRouteName<TRouteMap>];
-interface RouteLocationNormalizedBase<TRouteMap extends object> {
-  path: string;
-  fullPath: string;
-  query: LocationQuery;
-  hash: string;
-  href?: string;
-  matched?: readonly RouteRecordMatched<TRouteMap>[];
-  redirectedFrom?: RouteLocationRedirectedFrom<TRouteMap>;
-  params: RouteParams;
-}
-type RouteLocationNormalizedUnnamed<TRouteMap extends object> = RouteLocationNormalizedBase<TRouteMap> & {
-  name?: undefined;
-  meta?: RouteMeta;
-};
-type BroadRouteLocationNormalizedLoaded<TRouteMap extends object> = RouteLocationNormalizedBase<TRouteMap> & {
-  name?: string;
-  meta?: RouteMeta;
-};
-export type RouteLocationNormalizedByName<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = TName extends WevuRouteName<TRouteMap> ? IsBroadRouteMap<TRouteMap> extends true ? (RouteLocationNormalizedBase<TRouteMap> & {
-  name: TName;
-  meta?: RouteMeta;
-}) : (RouteLocationNormalizedBase<TRouteMap> & {
-  name: TName;
-  meta: WevuNamedRouteMeta<TRouteMap, TName>;
-}) : never;
-export type RouteLocationNormalizedLoaded<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? BroadRouteLocationNormalizedLoaded<WevuBroadRouteMap> : RouteLocationNormalizedUnnamed<TRouteMap> | { [TName in WevuRouteName<TRouteMap>]: RouteLocationNormalizedByName<TRouteMap, TName>; }[WevuRouteName<TRouteMap>];
-interface RouteLocationRedirectedFromBase<TRouteMap extends object> {
-  path: string;
-  fullPath: string;
-  query: LocationQuery;
-  hash: string;
-  href?: string;
-  matched?: readonly RouteRecordMatched<TRouteMap>[];
-  params: RouteParams;
-}
-type RouteLocationRedirectedFromByName<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = IsBroadRouteMap<TRouteMap> extends true ? (RouteLocationRedirectedFromBase<TRouteMap> & {
-  name: TName;
-  meta?: RouteMeta;
-}) : (RouteLocationRedirectedFromBase<TRouteMap> & {
-  name: TName;
-  meta: WevuNamedRouteMeta<TRouteMap, TName>;
-});
-export type RouteLocationRedirectedFrom<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? (RouteLocationRedirectedFromBase<WevuBroadRouteMap> & {
-  name?: string;
-  meta?: RouteMeta;
-}) : (RouteLocationRedirectedFromBase<TRouteMap> & {
-  name?: undefined;
-  meta?: RouteMeta;
-} | { [TName in WevuRouteName<TRouteMap>]: RouteLocationRedirectedFromByName<TRouteMap, TName>; }[WevuRouteName<TRouteMap>]);
-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<TRouteMap extends object = WevuNamedRouteMap> extends Error {
-  readonly __wevuNavigationFailure: true;
-  readonly type: NavigationFailureTypeValue;
-  readonly to?: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly from?: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly cause?: unknown;
-}
-export type NavigationMode = 'push' | 'replace' | 'back';
-export type InitialNavigationMode = 'eager' | 'blocking';
-export interface NavigationRedirect<TRouteMap extends object = WevuNamedRouteMap> {
-  to: RouteLocationRaw<TRouteMap>;
-  replace?: boolean;
-}
-export type RouteRecordRedirect<TRouteMap extends object = WevuNamedRouteMap> = RouteLocationRaw<TRouteMap> | NavigationRedirect<TRouteMap> | ((to: RouteLocationNormalizedLoaded<TRouteMap>, from: RouteLocationNormalizedLoaded<TRouteMap>) => RouteLocationRaw<TRouteMap> | NavigationRedirect<TRouteMap> | Promise<RouteLocationRaw<TRouteMap> | NavigationRedirect<TRouteMap>>);
-interface RouteRecordCommon<TRouteMap extends object> {
-  alias?: string | readonly string[];
-  beforeEnter?: NavigationGuard<TRouteMap> | readonly NavigationGuard<TRouteMap>[];
-  redirect?: RouteRecordRedirect<TRouteMap>;
-}
-type BroadRouteRecordInput<TRouteMap extends object> = RouteRecordCommon<TRouteMap> & {
-  name?: string;
-  path: string;
-  meta?: RouteMeta;
-  children?: readonly RouteRecordInput<TRouteMap>[];
-};
-type StrictRouteRecordInputByName<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = RouteRecordCommon<TRouteMap> & {
-  name: TName;
-  path: WevuNamedRoutePath<TRouteMap, TName>;
-  meta: StrictRouteRecordMeta<TRouteMap, TName>;
-  children?: readonly RouteRecordInput<TRouteMap>[];
-};
-export type RouteRecordInput<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? BroadRouteRecordInput<TRouteMap> : { [TName in WevuRouteName<TRouteMap>]: StrictRouteRecordInputByName<TRouteMap, TName>; }[WevuRouteName<TRouteMap>];
-type BroadRouteRecordRaw<TRouteMap extends object> = RouteRecordCommon<TRouteMap> & {
-  name: string;
-  path: string;
-  meta?: RouteMeta;
-  children?: readonly RouteRecordRaw<TRouteMap>[];
-};
-type StrictRouteRecordRawByName<TRouteMap extends object, TName extends WevuRouteName<TRouteMap>> = RouteRecordCommon<TRouteMap> & {
-  name: TName;
-  path: WevuNamedRoutePath<TRouteMap, TName>;
-  meta: StrictRouteRecordMeta<TRouteMap, TName>;
-  children?: readonly RouteRecordRaw<TRouteMap>[];
-};
-export type RouteRecordRaw<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? BroadRouteRecordRaw<TRouteMap> : { [TName in WevuRouteName<TRouteMap>]: StrictRouteRecordRawByName<TRouteMap, TName>; }[WevuRouteName<TRouteMap>];
-export type NamedRouteRecord<TRouteMap extends object = WevuNamedRouteMap> = RouteRecordRaw<TRouteMap> extends (infer TRoute) ? TRoute extends {
-  name: string;
-  path: string;
-} ? Pick<TRoute, 'name' | 'path'> : never : never;
-export type NamedRoutes<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? Readonly<Record<string, string>> | readonly RouteRecordRaw<TRouteMap>[] : readonly RouteRecordRaw<TRouteMap>[];
-export type RouteRecordMatched<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? {
-  name: string;
-  path: string;
-  aliasPath?: string;
-  meta?: RouteMeta;
-} : { [TName in WevuRouteName<TRouteMap>]: {
-  name: TName;
-  path: string;
-  aliasPath?: string;
-  meta: WevuNamedRouteMeta<TRouteMap, TName>;
-}; }[WevuRouteName<TRouteMap>];
-export type NavigationGuardResult<TRouteMap extends object = WevuNamedRouteMap> = void | boolean | NavigationFailure<TRouteMap> | RouteLocationRaw<TRouteMap> | NavigationRedirect<TRouteMap>;
-export type NavigationGuard<TRouteMap extends object = WevuNamedRouteMap> = (to: RouteLocationNormalizedLoaded<TRouteMap> | undefined, from: RouteLocationNormalizedLoaded<TRouteMap>, context?: NavigationGuardContext<TRouteMap>) => NavigationGuardResult<TRouteMap> | Promise<NavigationGuardResult<TRouteMap>>;
-export type NavigationAfterEach<TRouteMap extends object = WevuNamedRouteMap> = (to: RouteLocationNormalizedLoaded<TRouteMap> | undefined, from: RouteLocationNormalizedLoaded<TRouteMap>, failure?: NavigationFailure<TRouteMap>, context?: NavigationAfterEachContext<TRouteMap>) => void | Promise<void>;
-export interface NavigationGuardContext<TRouteMap extends object = WevuNamedRouteMap> {
-  readonly mode: NavigationMode;
-  readonly to?: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly from: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly nativeRouter: SetupContextRouter;
-}
-export interface NavigationAfterEachContext<TRouteMap extends object = WevuNamedRouteMap> {
-  readonly mode: NavigationMode;
-  readonly to?: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly from: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly nativeRouter: SetupContextRouter;
-  readonly failure?: NavigationFailure<TRouteMap>;
-}
-export interface NavigationErrorContext<TRouteMap extends object = WevuNamedRouteMap> {
-  readonly mode: NavigationMode;
-  readonly to?: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly from: RouteLocationNormalizedLoaded<TRouteMap>;
-  readonly nativeRouter: SetupContextRouter;
-  readonly failure: NavigationFailure<TRouteMap>;
-}
-export type NavigationErrorHandler<TRouteMap extends object = WevuNamedRouteMap> = (error: unknown, context: NavigationErrorContext<TRouteMap>) => void | Promise<void>;
-export interface UseRouterOptions<TRouteMap extends object = WevuNamedRouteMap> {
-  tabBarEntries?: readonly (TypedRouterTabBarUrl | string)[];
-  /**
-   * Vue Router 对齐入口：推荐使用 `routes`
-   */
-  routes?: readonly RouteRecordInput<TRouteMap>[];
-  /**
-   * 兼容入口：支持对象 map 或路由记录数组
-   */
-  namedRoutes?: NamedRoutes<TRouteMap>;
-  paramsMode?: RouteParamsMode;
-  maxRedirects?: number;
-  /**
-   * 首屏导航守卫模式。默认立即挂载页面，只有明确配置 `blocking` 时才等待守卫完成。
-   */
-  initialNavigationMode?: InitialNavigationMode;
-  /**
-   * blocking 首屏导航守卫的最大等待时间（毫秒），超时后放行页面挂载。
-   */
-  initialNavigationTimeout?: number;
-  parseQuery?: RouteQueryParser;
-  stringifyQuery?: RouteQueryStringifier;
-  /**
-   * 异常型导航失败时是否以 Promise reject 抛出失败对象。
-   *
-   * - `true`：更贴近 Vue Router 心智（默认）
-   * - `false`：始终以返回值形式携带失败对象
-   */
-  rejectOnError?: boolean;
-}
-export type RouterResolve<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? (to: RouteLocationRaw<TRouteMap>) => RouteLocationNormalizedLoaded<TRouteMap> : {
-  <TName extends WevuRouteName<TRouteMap>>(to: RouteLocationNamedRaw<TRouteMap, TName>): RouteLocationNormalizedByName<TRouteMap, TName>;
-  (to: RouteLocationRaw<TRouteMap>): RouteLocationNormalizedLoaded<TRouteMap>;
-};
-export interface AddRoute<TRouteMap extends object = WevuNamedRouteMap> {
-  (route: RouteRecordRaw<TRouteMap>): () => void;
-  (parentName: WevuRouteName<TRouteMap>, route: RouteRecordRaw<TRouteMap>): () => void;
-}
-export interface RouterNavigation<TRouteMap extends object = WevuNamedRouteMap> {
-  readonly nativeRouter: SetupContextRouter;
-  readonly options: Readonly<UseRouterOptions<TRouteMap>>;
-  readonly currentRoute: Readonly<RouteLocationNormalizedLoaded<TRouteMap>>;
-  install: (app?: unknown) => void;
-  resolve: RouterResolve<TRouteMap>;
-  isReady: () => Promise<void>;
-  push: (to: RouteLocationRaw<TRouteMap>) => Promise<void | NavigationFailure<TRouteMap>>;
-  replace: (to: RouteLocationRaw<TRouteMap>) => Promise<void | NavigationFailure<TRouteMap>>;
-  back: (delta?: number) => Promise<void | NavigationFailure<TRouteMap>>;
-  go: (delta: number) => Promise<void | NavigationFailure<TRouteMap>>;
-  forward: () => Promise<void | NavigationFailure<TRouteMap>>;
-  hasRoute: (name: WevuRouteName<TRouteMap>) => boolean;
-  getRoutes: () => readonly RouteRecordRaw<TRouteMap>[];
-  addRoute: AddRoute<TRouteMap>;
-  removeRoute: (name: WevuRouteName<TRouteMap>) => void;
-  clearRoutes: () => void;
-  beforeEach: (guard: NavigationGuard<TRouteMap>) => () => void;
-  beforeResolve: (guard: NavigationGuard<TRouteMap>) => () => void;
-  afterEach: (hook: NavigationAfterEach<TRouteMap>) => () => void;
-  onError: (handler: NavigationErrorHandler<TRouteMap>) => () => void;
-}
-export type WevuAutoRoute<TRouteMap extends object = WevuNamedRouteMap> = IsBroadRouteMap<TRouteMap> extends true ? {
-  readonly name: string;
-  readonly path: string;
-  readonly meta: RouteMeta;
-} : { [TName in WevuRouteName<TRouteMap>]: {
-  readonly name: TName;
-  readonly path: WevuNamedRoutePath<TRouteMap, TName>;
-  readonly meta: StrictRouteRecordMeta<TRouteMap, TName>;
-}; }[WevuRouteName<TRouteMap>];
-//#endregion
-//# sourceMappingURL=types.d.mts.map

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

@@ -1,20 +0,0 @@
-import { SetupContextRouter } from "../runtime/types/props/router.mjs";
-import "../runtime/types/props.mjs";
-import { RouteLocationNormalizedLoaded } from "./types.mjs";
-import "./routeSync.mjs";
-import { WevuNamedRouteMap } from "../router.mjs";
-//#region src/router/useRoute.d.ts
-export interface UseRouteOptions<TRouteMap extends object = WevuNamedRouteMap> {
-  resolveRoute?: (route: RouteLocationNormalizedLoaded<TRouteMap>) => RouteLocationNormalizedLoaded<TRouteMap>;
-}
-export declare function useRoute<TRouteMap extends object = WevuNamedRouteMap>(options?: UseRouteOptions<NoInfer<TRouteMap>>): Readonly<RouteLocationNormalizedLoaded<TRouteMap>>;
-/**
- * @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/useRouter.d.mts

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