wevu 7.4.0 → 7.5.0

package/dist/dev/reactivity/reactive/mutation.d.mts

@@ -1,21 +0,0 @@
-//#region src/reactivity/reactive/mutation.d.ts
-export type MutationOp = 'set' | 'delete';
-export type MutationKind = 'property' | 'array';
-export interface MutationRecord {
-  root: object;
-  kind: MutationKind;
-  op: MutationOp;
-  /**
-   * 点路径（例如 `a.b.c`）；当路径不可靠时为 undefined。
-   */
-  path?: string;
-  /**
-   * 当路径不唯一时回退使用的顶层键列表。
-   */
-  fallbackTopKeys?: string[];
-}
-type MutationRecorder = (record: MutationRecord) => void;
-export declare function addMutationRecorder(recorder: MutationRecorder): void;
-export declare function removeMutationRecorder(recorder: MutationRecorder): void;
-//#endregion
-//# sourceMappingURL=mutation.d.mts.map

package/dist/dev/reactivity/reactive/patch.d.mts

@@ -1,18 +0,0 @@
-//#region src/reactivity/reactive/patch.d.ts
-export interface PrelinkReactiveTreeOptions {
-  shouldIncludeTopKey?: (key: string) => boolean;
-  maxDepth?: number;
-  maxKeys?: number;
-}
-/**
- * 预链接响应式树结构，供运行时差量路径追踪使用。
- * @internal
- */
-export declare function prelinkReactiveTree(root: object, options?: PrelinkReactiveTreeOptions): void;
-/**
- * 让 effect 订阅整个对象的“版本号”，无需深度遍历即可对任何字段变化做出响应。
- * @internal
- */
-export declare function touchReactive(target: object): void;
-//#endregion
-//# sourceMappingURL=patch.d.mts.map

package/dist/dev/reactivity/reactive/shallow.d.mts

@@ -1,22 +0,0 @@
-//#region src/reactivity/reactive/shallow.d.ts
-/**
- * 创建一个浅层响应式代理：仅跟踪第一层属性变更，不深度递归嵌套对象。
- *
- * @param target 待转换的对象
- * @returns 浅层响应式代理
- *
- * @example
- * ```ts
- * const state = shallowReactive({ nested: { count: 0 } })
- *
- * state.nested.count++ // 不会触发 effect（嵌套对象未深度代理）
- * state.nested = { count: 1 } // 会触发 effect（顶层属性变更）
- * ```
- */
-export declare function shallowReactive<T extends object>(target: T): T;
-/**
- * 判断一个值是否为 shallowReactive 创建的浅层响应式对象
- */
-export declare function isShallowReactive(value: unknown): boolean;
-//#endregion
-//# sourceMappingURL=shallow.d.mts.map

package/dist/dev/reactivity/reactive/shared.d.mts

@@ -1,4 +0,0 @@
-//#region src/reactivity/reactive/shared.d.ts
-export declare function toRaw<T>(observed: T): T;
-//#endregion
-//# sourceMappingURL=shared.d.mts.map

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

@@ -1,42 +0,0 @@
-import { MutationKind, MutationOp, MutationRecord, addMutationRecorder, removeMutationRecorder } from "./reactive/mutation.mjs";
-import { PrelinkReactiveTreeOptions, prelinkReactiveTree, touchReactive } from "./reactive/patch.mjs";
-import { isShallowReactive, shallowReactive } from "./reactive/shallow.mjs";
-import { toRaw } from "./reactive/shared.mjs";
-//#region src/reactivity/reactive.d.ts
-/**
- * 读取响应式版本号（框架内部调试能力）。
- * @internal
- */
-export declare function getReactiveVersion(target: object): number;
-export declare function reactive<T extends object>(target: T): T;
-export declare function isReactive(value: unknown): boolean;
-/**
- * 标记对象为“原始”状态，后续不会被转换为响应式，返回原对象本身。
- *
- * @param value 需要标记的对象
- * @returns 带有跳过标记的原对象
- *
- * @example
- * ```ts
- * const foo = markRaw({
- *   nested: {}
- * })
- *
- * const state = reactive({
- *   foo
- * })
- *
- * state.foo // 不是响应式对象
- * ```
- */
-export declare function markRaw<T extends object>(value: T): T;
-/**
- * 判断某个值是否被标记为原始（即不应转换为响应式）。
- *
- * @param value 待检测的值
- * @returns 若含有跳过标记则返回 true
- */
-export declare function isRaw(value: unknown): boolean;
-//#endregion
-export { type MutationKind, type MutationOp, type MutationRecord, type PrelinkReactiveTreeOptions, addMutationRecorder, isShallowReactive, prelinkReactiveTree, removeMutationRecorder, shallowReactive, toRaw, touchReactive };
-//# sourceMappingURL=reactive.d.mts.map

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