wevu 6.18.7 → 6.19.0

package/dist/runtime/types/props/propTypes.d.mts

@@ -0,0 +1,79 @@
+import { HostMiniProgramComponentAllProperty, HostMiniProgramComponentShortProperty } from "../miniprogramHost.mjs";
+//#region src/runtime/types/props/propTypes.d.ts
+type PropMethod<T, TConstructor = any> = [T] extends [((...args: any) => any) | undefined] ? {
+  new (): TConstructor;
+  (): T;
+  readonly prototype: TConstructor;
+} : never;
+type PropConstructor<T = any> = {
+  new (...args: any[]): T & {};
+} | {
+  (): T;
+} | PropMethod<T>;
+type PropType<T> = PropConstructor<T> | (PropConstructor<T> | null)[];
+type Prop<T, D = T> = PropOptions<T, D> | PropType<T>;
+type ComponentPropsOptions = Record<string, PropOptions<any> | PropType<any> | null>;
+interface NativeTypeHint<T = any> {
+  readonly __wevuNativeType?: T;
+}
+type NativePropsOptions = Record<string, HostMiniProgramComponentAllProperty | NativeTypeHint<any>>;
+type NativePropType<T = any, C extends HostMiniProgramComponentShortProperty = StringConstructor> = C & NativeTypeHint<T>;
+type NativeTypedProperty<T = any, P extends HostMiniProgramComponentAllProperty = HostMiniProgramComponentAllProperty> = P & NativeTypeHint<T>;
+interface PropOptions<T = any, D = T> {
+  type?: PropType<T> | true | null;
+  optionalTypes?: Array<HostMiniProgramComponentShortProperty | PropConstructor<any>>;
+  /**
+   * 默认值（对齐 Vue 的 `default`；会被赋给小程序 property 的 `value`）
+   */
+  default?: D | (() => D);
+  /**
+   * 小程序 `value` 的别名
+   */
+  value?: D | (() => D);
+  observer?: string | ((newVal: T, oldVal: T, changedPath: Array<string | number>) => void);
+  required?: boolean;
+}
+type HasDefault<T> = T extends {
+  default: infer D;
+} ? D extends (() => undefined) | undefined ? false : true : T extends {
+  value: infer V;
+} ? V extends (() => undefined) | undefined ? false : true : false;
+type IsBooleanProp<T> = T extends {
+  type?: infer U;
+} ? IsBooleanProp<U> : T extends readonly any[] ? true extends IsBooleanProp<T[number]> ? true : false : T extends BooleanConstructor ? true : false;
+type RequiredKeys<T> = { [K in keyof T]: T[K] extends {
+  required: true;
+} ? K : HasDefault<T[K]> extends true ? K : IsBooleanProp<T[K]> extends true ? K : never; }[keyof T];
+type OptionalKeys<T> = Exclude<keyof T, RequiredKeys<T>>;
+type DefaultKeys<T> = { [K in keyof T]: HasDefault<T[K]> extends true ? K : IsBooleanProp<T[K]> extends true ? K : never; }[keyof T];
+type IfAny<T, Y, N> = 0 extends (1 & T) ? Y : N;
+type InferPropType<O, NullAsAny = true> = [O] extends [null] ? NullAsAny extends true ? any : null : [O] extends [{
+  type: null | true;
+}] ? any : [O] extends [ObjectConstructor | {
+  type: ObjectConstructor;
+}] ? Record<string, any> : [O] extends [BooleanConstructor | {
+  type: BooleanConstructor;
+}] ? boolean : [O] extends [DateConstructor | {
+  type: DateConstructor;
+}] ? Date : [O] extends [(infer U)[] | {
+  type: (infer U)[];
+}] ? U extends DateConstructor ? Date | InferPropType<U, false> : InferPropType<U, false> : [O] extends [Prop<infer V, infer D>] ? unknown extends V ? keyof V extends never ? IfAny<V, V, D> : V : V : O;
+type IsUnion<T, U = T> = T extends any ? ([U] extends [T] ? false : true) : never;
+type WidenLiteral<T> = T extends string ? string extends T ? string : IsUnion<T> extends true ? T : string : T extends number ? number extends T ? number : IsUnion<T> extends true ? T : number : T extends boolean ? boolean extends T ? boolean : IsUnion<T> extends true ? T : boolean : T;
+type NativeInferByCtor<C> = C extends readonly any[] ? NativeInferByCtor<C[number]> : C extends StringConstructor ? string : C extends NumberConstructor ? number : C extends BooleanConstructor ? boolean : C extends DateConstructor ? Date : C extends ArrayConstructor ? any[] : C extends ObjectConstructor ? Record<string, any> : C extends null ? any : C extends PropConstructor<infer V> ? V : any;
+type MergeNativeType<Base, V> = Base extends string ? Exclude<Extract<WidenLiteral<V>, string>, never> | (Extract<WidenLiteral<V>, string> extends never ? string : never) : Base extends number ? Exclude<Extract<WidenLiteral<V>, number>, never> | (Extract<WidenLiteral<V>, number> extends never ? number : never) : Base extends boolean ? Exclude<Extract<WidenLiteral<V>, boolean>, never> | (Extract<WidenLiteral<V>, boolean> extends never ? boolean : never) : Base;
+type InferNativeByOption<O extends {
+  type?: any;
+}> = O['type'] extends NativeTypeHint<infer THint> ? THint : O extends {
+  value: infer V;
+} ? MergeNativeType<NativeInferByCtor<O['type']>, V> : NativeInferByCtor<O['type']>;
+type InferNativePropType<O> = O extends NativeTypeHint<infer T> ? T : O extends {
+  type?: any;
+} ? InferNativeByOption<O> : NativeInferByCtor<O>;
+type InferNativeProps<P extends NativePropsOptions = NativePropsOptions> = { readonly [K in keyof P]?: InferNativePropType<P[K]>; };
+type InferProps<P extends ComponentPropsOptions = ComponentPropsOptions> = { [K in keyof Pick<P, RequiredKeys<P>>]: HasDefault<P[K]> extends true ? Exclude<InferPropType<P[K]>, undefined> : InferPropType<P[K]>; } & { [K in keyof Pick<P, OptionalKeys<P>>]?: InferPropType<P[K]>; };
+type ExtractPropTypes<P extends ComponentPropsOptions = ComponentPropsOptions> = InferProps<P>;
+type ExtractPublicPropTypes<P extends ComponentPropsOptions = ComponentPropsOptions> = InferProps<P>;
+type ExtractDefaultPropTypes<P extends ComponentPropsOptions = ComponentPropsOptions> = { [K in keyof Pick<P, DefaultKeys<P>>]: InferPropType<P[K]>; };
+//#endregion
+export { ComponentPropsOptions, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InferNativePropType, InferNativeProps, InferPropType, InferProps, NativePropType, NativePropsOptions, NativeTypeHint, NativeTypedProperty, PropConstructor, PropOptions, PropType };

package/dist/runtime/types/props/router.d.mts

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

package/dist/runtime/types/props/setup.d.mts

@@ -0,0 +1,96 @@
+import { HostMiniProgramIntersectionObserver, HostMiniProgramIntersectionObserverOptions, HostMiniProgramSelectorQuery, HostMiniProgramTriggerEventOptions } from "../miniprogramHost.mjs";
+import { ComponentPropsOptions, InferProps } from "./propTypes.mjs";
+import { SetupContextRouter } from "./router.mjs";
+import { ComputedDefinitions, MethodDefinitions } from "../core.mjs";
+import { InternalRuntimeState, RuntimeInstance } from "../runtime.mjs";
+//#region src/runtime/types/props/setup.d.ts
+type SetupContextSelectorQuery = HostMiniProgramSelectorQuery;
+type SetupContextIntersectionObserverOptions = HostMiniProgramIntersectionObserverOptions;
+type SetupContextIntersectionObserver = HostMiniProgramIntersectionObserver;
+type SetupFunction<P extends ComponentPropsOptions, D extends object, C extends ComputedDefinitions, M extends MethodDefinitions, R extends Record<string, any> | void = Record<string, any> | void> = (props: InferProps<P>, ctx: SetupContext<D, C, M, P>) => R;
+type SetupContextNativeInstance = InternalRuntimeState & {
+  /**
+   * 派发组件事件（页面/应用场景下不可用时会安全降级为 no-op）
+   */
+  triggerEvent: (eventName: string, detail?: any, options?: HostMiniProgramTriggerEventOptions) => void;
+  /**
+   * 创建选择器查询对象（不可用时返回 undefined）
+   */
+  createSelectorQuery: () => SetupContextSelectorQuery | undefined;
+  /**
+   * 创建交叉观察器（不可用时返回 undefined）
+   */
+  createIntersectionObserver: (options?: SetupContextIntersectionObserverOptions) => SetupContextIntersectionObserver | undefined;
+  /**
+   * 提交视图层更新
+   */
+  setData: (payload: Record<string, any>, callback?: () => void) => void | Promise<void> | undefined;
+  /**
+   * 监听组件更新性能统计（不可用时返回 undefined）
+   */
+  setUpdatePerformanceListener: (listener?: ((result: Record<string, any>) => void)) => void | undefined;
+  /**
+   * 相对于当前组件路径的 Router（基础库 2.16.1+）。
+   * 低版本基础库可能不存在，建议优先使用 `useNativeRouter()` 获取带降级能力的路由对象。
+   */
+  router?: SetupContextRouter;
+  /**
+   * 相对于当前页面路径的 Router（基础库 2.16.1+）。
+   * 低版本基础库可能不存在，建议优先使用 `useNativePageRouter()` 获取带降级能力的路由对象。
+   */
+  pageRouter?: SetupContextRouter;
+};
+interface SetupContext<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions, P extends ComponentPropsOptions = ComponentPropsOptions> {
+  /**
+   * 组件 props（来自小程序 properties）
+   */
+  props: InferProps<P>;
+  /**
+   * 运行时实例
+   */
+  runtime: RuntimeInstance<D, C, M>;
+  /**
+   * 响应式状态
+   */
+  state: D;
+  /**
+   * 公开实例代理
+   */
+  proxy: RuntimeInstance<D, C, M>['proxy'];
+  /**
+   * 双向绑定辅助方法
+   */
+  bindModel: RuntimeInstance<D, C, M>['bindModel'];
+  /**
+   * watch 辅助方法
+   */
+  watch: RuntimeInstance<D, C, M>['watch'];
+  /**
+   * 小程序内部实例
+   */
+  instance: SetupContextNativeInstance;
+  /**
+   * 通过小程序 `triggerEvent(eventName, detail?, options?)` 派发事件。
+   *
+   * 为兼容 Vue 3 的 `emit(event, ...args)`：
+   * - `emit(name)` -> `detail = undefined`
+   * - `emit(name, payload)` -> `detail = payload`
+   * - `emit(name, payload, options)`（当最后一个参数是事件选项）-> `detail = payload`
+   * - `emit(name, a, b, c)` -> `detail = [a, b, c]`
+   */
+  emit: (event: string, ...args: any[]) => void;
+  /**
+   * Vue 3 对齐：expose 公共属性
+   */
+  expose: (exposed: Record<string, any>) => void;
+  /**
+   * Vue 3 对齐：attrs（小程序场景为非 props 属性集合）
+   */
+  attrs: Record<string, any>;
+  /**
+   * Vue 3 对齐：slots（由编译期传入的 slot 名元数据驱动）
+   */
+  slots: Record<string, any>;
+}
+//#endregion
+export { SetupContext, SetupContextIntersectionObserver, SetupContextIntersectionObserverOptions, SetupContextNativeInstance, SetupContextSelectorQuery, SetupFunction };

package/dist/runtime/types/props.d.mts

@@ -0,0 +1,4 @@
+import { ComponentPropsOptions, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InferNativePropType, InferNativeProps, InferPropType, InferProps, NativePropType, NativePropsOptions, NativeTypeHint, NativeTypedProperty, PropConstructor, PropOptions, PropType } from "./props/propTypes.mjs";
+import { MiniProgramRouterNavigateToOption, MiniProgramRouterReLaunchOption, MiniProgramRouterRedirectToOption, MiniProgramRouterSwitchTabOption, RouterNavigateToOption, RouterReLaunchOption, RouterRedirectToOption, RouterSwitchTabOption, SetupContextRouter, TypedRouterTabBarUrl, TypedRouterUrl, WevuTypedRouterRouteMap } from "./props/router.mjs";
+import { SetupContext, SetupContextIntersectionObserver, SetupContextIntersectionObserverOptions, SetupContextNativeInstance, SetupContextSelectorQuery, SetupFunction } from "./props/setup.mjs";
+export type { ComponentPropsOptions, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InferNativePropType, InferNativeProps, InferPropType, InferProps, MiniProgramRouterNavigateToOption, MiniProgramRouterReLaunchOption, MiniProgramRouterRedirectToOption, MiniProgramRouterSwitchTabOption, NativePropType, NativePropsOptions, NativeTypeHint, NativeTypedProperty, PropConstructor, PropOptions, PropType, RouterNavigateToOption, RouterReLaunchOption, RouterRedirectToOption, RouterSwitchTabOption, SetupContext, SetupContextNativeInstance, SetupContextRouter, SetupFunction, TypedRouterTabBarUrl, TypedRouterUrl, WevuTypedRouterRouteMap };

package/dist/runtime/types/runtime.d.mts

@@ -0,0 +1,59 @@
+import { MiniProgramAdapter, MiniProgramInstance } from "./miniprogram.mjs";
+import { Ref } from "../../reactivity/ref.mjs";
+import { EffectScope } from "../../reactivity/core.mjs";
+import { WatchOptions, WatchStopHandle } from "../../reactivity/watch/types.mjs";
+import "../../reactivity/index.mjs";
+import { ComponentPublicInstance, ComputedDefinitions, ExtractComputed, ExtractMethods, MethodDefinitions, ModelBinding, ModelBindingOptions } from "./core.mjs";
+//#region src/runtime/types/runtime.d.ts
+interface AppConfig {
+  globalProperties: Record<string, any>;
+}
+type WevuPlugin = ((app: RuntimeApp<any, any, any>, ...options: any[]) => any) | {
+  install: (app: RuntimeApp<any, any, any>, ...options: any[]) => any;
+};
+interface RuntimeApp<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> {
+  mount: (adapter?: MiniProgramAdapter) => RuntimeInstance<D, C, M>;
+  use: (plugin: WevuPlugin, ...options: any[]) => RuntimeApp<D, C, M>;
+  provide: <T>(key: any, value: T) => RuntimeApp<D, C, M>;
+  onUnmount: (cleanup: () => void) => RuntimeApp<D, C, M>;
+  unmount: () => void;
+  config: AppConfig;
+  version: string;
+  __wevuAppProvides?: Record<PropertyKey, any>;
+}
+interface RuntimeInstance<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> {
+  readonly state: D;
+  readonly setupState?: Record<string, any>;
+  readonly proxy: ComponentPublicInstance<D, C, M>;
+  readonly methods: ExtractMethods<M>;
+  readonly computed: Readonly<ExtractComputed<C>>;
+  readonly adapter?: MiniProgramAdapter;
+  bindModel: <T = any>(path: string, options?: ModelBindingOptions<T>) => ModelBinding<T>;
+  watch: <T>(source: (() => T) | Record<string, any>, cb: (value: T, oldValue: T) => void, options?: WatchOptions) => WatchStopHandle;
+  snapshot: () => Record<string, any>;
+  unmount: () => void;
+}
+interface InternalRuntimeStateFields {
+  __wevu?: RuntimeInstance<any, any, any>;
+  __wevuIsAppInstance?: boolean;
+  __wevuRuntimeApp?: RuntimeApp<any, any, any>;
+  __wevuAppProvides?: Record<PropertyKey, any>;
+  __wevuProvides?: Record<PropertyKey, any>;
+  __wevuParentInstance?: InternalRuntimeState;
+  __wevuSetPageLayout?: (layout: string | false, props?: Record<string, any>) => void;
+  __wevuWatchStops?: WatchStopHandle[];
+  __wevuLayoutHostBridge?: Record<string, any>;
+  $wevu?: RuntimeInstance<any, any, any>;
+  __wevuHooks?: Record<string, any>;
+  __wevuExposed?: Record<string, any>;
+  __wevuAttrs?: Record<string, any>;
+  __wevuEffectScope?: EffectScope;
+  __wevuPropKeys?: string[];
+  __wevuTemplateRefs?: unknown[];
+  __wevuTemplateRefMap?: Map<string, Ref<any>>;
+  __wevuTemplateRefsPending?: boolean;
+  __wevuReadyCalled?: boolean;
+}
+type InternalRuntimeState = InternalRuntimeStateFields & Partial<MiniProgramInstance>;
+//#endregion
+export { AppConfig, InternalRuntimeState, InternalRuntimeStateFields, RuntimeApp, RuntimeInstance, WevuPlugin };

package/dist/runtime/types/setData.d.mts

@@ -0,0 +1,220 @@
+//#region src/runtime/types/setData.d.ts
+interface SetDataSnapshotOptions {
+  /**
+   * 开发态高频 setData 告警。
+   *
+   * - `undefined`：默认关闭（可通过 `weapp.wevu.preset: 'performance'` 自动开启）
+   * - `false`：关闭告警
+   * - `true`：启用默认阈值（默认仅开发态生效）
+   * - `object`：自定义阈值与开关
+   */
+  highFrequencyWarning?: boolean | {
+    /**
+     * 是否启用告警。
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 是否仅在开发态生效。
+     * @default true
+     */
+    devOnly?: boolean;
+    /**
+     * 统计窗口（毫秒）。
+     * @default 1000
+     */
+    sampleWindowMs?: number;
+    /**
+     * 窗口内超过该次数触发告警。
+     * @default 30
+     */
+    maxCalls?: number;
+    /**
+     * 告警冷却时间（毫秒），避免刷屏。
+     * @default 5000
+     */
+    coolDownMs?: number;
+    /**
+     * 是否在检测到 `onPageScroll` 回调内调用 setData 时输出专项告警。
+     * @default true
+     */
+    warnOnPageScroll?: boolean;
+    /**
+     * `onPageScroll` 专项告警冷却时间（毫秒）。
+     * @default 2000
+     */
+    pageScrollCoolDownMs?: number;
+  };
+  /**
+   * setData 策略：
+   * - diff：全量快照 + diff（默认，兼容性最好）
+   * - patch：按变更路径增量产出 payload（性能更好；在共享引用等场景会自动回退 diff）
+   */
+  strategy?: 'diff' | 'patch';
+  /**
+   * 仅下发指定的顶层字段（包含 data/setup 返回值与 computed）。
+   * 若为空则默认下发所有字段。
+   */
+  pick?: string[];
+  /**
+   * 排除指定的顶层字段（包含 data/setup 返回值与 computed）。
+   */
+  omit?: string[];
+  /**
+   * 是否将 computed 的结果参与 setData（默认 true）。
+   */
+  includeComputed?: boolean;
+  /**
+   * 页面/组件处于后台态（onHide 之后）时，是否挂起 setData 下发。
+   *
+   * - true：后台态仅合并最新 payload，待 onShow 后一次性 flush
+   * - false：保持默认行为，后台态也继续 setData
+   *
+   * @default false
+   */
+  suspendWhenHidden?: boolean;
+  /**
+   * patch 模式阈值：当本轮变更路径数量超过该值时，自动回退到 diff。
+   * 说明：大量路径变更时，全量快照 diff 往往更快/更小。
+   */
+  maxPatchKeys?: number;
+  /**
+   * patch 模式阈值：当本轮 payload 估算字节数超过该值时，自动回退到 diff。
+   * 说明：该估算基于 `JSON.stringify(payload).length`，仅用于启发式降级。
+   */
+  maxPayloadBytes?: number;
+  /**
+   * patch 模式优化：当同一父路径下存在多个子路径变更时，合并为父路径整体下发。
+   *
+   * 例如：`a.b` 与 `a.c` 同时变更，且 `mergeSiblingThreshold = 2` 时，会下发 `a`。
+   *
+   * 注意：当子路径包含删除（null）时，为避免删除语义不一致，将不会触发合并。
+   */
+  mergeSiblingThreshold?: number;
+  /**
+   * 同级合并的“负优化”防护：若合并后的父路径估算体积大于子路径体积之和 * ratio，则不合并。
+   */
+  mergeSiblingMaxInflationRatio?: number;
+  /**
+   * 同级合并的“负优化”防护：若父路径估算体积超过该值，则不合并。
+   */
+  mergeSiblingMaxParentBytes?: number;
+  /**
+   * 是否在父值为数组时跳过同级合并（默认 true）。
+   */
+  mergeSiblingSkipArray?: boolean;
+  /**
+   * patch 模式优化：computed 变更对比策略。
+   *
+   * - reference：仅 `Object.is` 比较（最快，可能会多下发）
+   * - shallow：仅比较数组/对象第一层（折中）
+   * - deep：深比较（可能较慢，适合小对象）；会受 `computedCompareMaxDepth/maxKeys` 限制
+   */
+  computedCompare?: 'reference' | 'shallow' | 'deep';
+  /**
+   * computed 深比较最大深度（仅在 `computedCompare = "deep"` 时生效）。
+   */
+  computedCompareMaxDepth?: number;
+  /**
+   * computed 深比较最多比较 key 数（仅在 `computedCompare = "deep"` 时生效）。
+   */
+  computedCompareMaxKeys?: number;
+  /**
+   * 限制 patch 模式的预链接（prelinkReactiveTree）开销：最多向下遍历的深度（root 为 0）。
+   */
+  prelinkMaxDepth?: number;
+  /**
+   * 限制 patch 模式的预链接（prelinkReactiveTree）开销：最多索引的节点数。
+   */
+  prelinkMaxKeys?: number;
+  /**
+   * setData 调试信息回调（用于观测 patch 命中率/回退原因/payload 大小）。
+   */
+  debug?: (info: SetDataDebugInfo) => void;
+  /**
+   * 内建诊断日志开关（默认 off）。
+   *
+   * - off：关闭内建日志
+   * - fallback：仅在回退 diff / 超阈值时输出
+   * - always：每次 flush 都输出
+   */
+  diagnostics?: 'off' | 'fallback' | 'always';
+  /**
+   * 疑似运行时更新循环诊断。
+   *
+   * 在短时间内连续触发 setData flush 时输出告警，帮助定位页面/组件、
+   * 调度模式、patch 信号和 computed dirty 状态。
+   */
+  loopWarning?: boolean | {
+    /**
+     * 是否启用告警。
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 统计窗口（毫秒）。
+     * @default 1000
+     */
+    sampleWindowMs?: number;
+    /**
+     * 窗口内超过该次数触发告警。
+     * @default 50
+     */
+    maxFlushes?: number;
+    /**
+     * 告警冷却时间（毫秒），避免刷屏。
+     * @default 5000
+     */
+    coolDownMs?: number;
+  };
+  /**
+   * debug 触发时机：
+   * - fallback：仅在回退 diff / 超阈值时触发（默认）
+   * - always：每次 flush 都触发
+   */
+  debugWhen?: 'fallback' | 'always';
+  /**
+   * debug 采样率（0-1），用于降低 debug 频率与开销（默认 1）。
+   */
+  debugSampleRate?: number;
+  /**
+   * patch 模式优化：当某个顶层字段下的变更路径数量过多时，直接提升为顶层字段整体替换。
+   */
+  elevateTopKeyThreshold?: number;
+  /**
+   * setData 序列化上限：最大递归深度（root 为 0）。超过时将停止深拷贝，保留更浅层结构。
+   */
+  toPlainMaxDepth?: number;
+  /**
+   * setData 序列化上限：最多处理的对象 key 数（累计）。超过时将停止深拷贝，保留更浅层结构。
+   */
+  toPlainMaxKeys?: number;
+  /**
+   * 是否允许函数进入 setData 快照。
+   *
+   * @internal
+   */
+  includeFunctions?: boolean;
+  /**
+   * 允许函数进入 setData 快照的状态路径。
+   *
+   * @internal
+   */
+  functionPaths?: string[];
+}
+interface SetDataDebugInfo {
+  mode: 'patch' | 'diff';
+  reason: 'patch' | 'diff' | 'needsFullSnapshot' | 'maxPatchKeys' | 'maxPayloadBytes' | 'loopWarning';
+  pendingPatchKeys: number;
+  payloadKeys: number;
+  estimatedBytes?: number;
+  bytes?: number;
+  mergedSiblingParents?: number;
+  computedDirtyKeys?: number;
+  flushCount?: number;
+  windowMs?: number;
+  targetLabel?: string;
+  message?: string;
+}
+//#endregion
+export { SetDataDebugInfo, SetDataSnapshotOptions };

package/dist/runtime/types.d.mts

@@ -0,0 +1,28 @@
+import { AlipayMiniProgramHostNamespace, AlipayMiniProgramHostSourceContract, DefaultMiniProgramHostNamespace, DefaultMiniProgramHostSourceContract, DouyinMiniProgramHostNamespace, DouyinMiniProgramHostSourceContract, MiniProgramHostNamespace, MiniProgramHostNamespaceBySource, MiniProgramHostSourceName, MiniProgramHostSourceRegistry, MiniProgramPlatformHostNamespaceBySource, MiniProgramPlatformHostSourceName, MiniProgramPlatformHostSourceRegistry, MiniProgramRuntimeHostNamespaceBySource, MiniProgramRuntimeHostSourceName, MiniProgramRuntimeHostSourceRegistry, TtMiniProgramHostNamespace, TtMiniProgramHostSourceContract, WechatMiniProgramHostNamespace, WechatMiniProgramHostSourceContract } from "./types/miniprogramHostSources.mjs";
+import { HostMiniProgramAddToFavoritesOption, HostMiniProgramAppOptions, HostMiniProgramAppTrivialInstance, HostMiniProgramBehaviorIdentifier, HostMiniProgramBoundingClientRectResult, HostMiniProgramComponentAllFullProperty, HostMiniProgramComponentAllProperty, HostMiniProgramComponentBehaviorOptions, HostMiniProgramComponentEmptyArray, HostMiniProgramComponentInstance, HostMiniProgramComponentMethodOption, HostMiniProgramComponentPropertyOption, HostMiniProgramComponentPropertyValue, HostMiniProgramComponentShortProperty, HostMiniProgramComponentTrivialInstance, HostMiniProgramComponentTrivialOption, HostMiniProgramIntersectionObserver, HostMiniProgramIntersectionObserverOptions, HostMiniProgramLaunchOptions, HostMiniProgramMemoryWarningResult, HostMiniProgramNavigateToOption, HostMiniProgramNodesRef, HostMiniProgramNodesRefFields, HostMiniProgramPageLifetime, HostMiniProgramPageNotFoundOptions, HostMiniProgramPageResizeOption, HostMiniProgramPageScrollOption, HostMiniProgramPageTrivialInstance, HostMiniProgramReLaunchOption, HostMiniProgramRedirectToOption, HostMiniProgramRouter, HostMiniProgramSaveExitState, HostMiniProgramScrollOffsetResult, HostMiniProgramSelectorQuery, HostMiniProgramShareAppMessageOption, HostMiniProgramSwitchTabOption, HostMiniProgramTabItemTapOption, HostMiniProgramThemeChangeResult, HostMiniProgramTriggerEventOptions, HostMiniProgramUnhandledRejectionResult } from "./types/miniprogramHost.mjs";
+import { MiniProgramAdapter, MiniProgramAppOptions, MiniProgramBehaviorIdentifier, MiniProgramComponentInstance, MiniProgramComponentOptions, MiniProgramComponentPropertyValue, MiniProgramComponentRawOptions, MiniProgramInstance, MiniProgramPageLifetimes } from "./types/miniprogram.mjs";
+import { ComponentPropsOptions, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InferNativePropType, InferNativeProps, InferPropType, InferProps, NativePropType, NativePropsOptions, NativeTypeHint, NativeTypedProperty, PropConstructor, PropOptions, PropType } from "./types/props/propTypes.mjs";
+import { MiniProgramRouterNavigateToOption, MiniProgramRouterReLaunchOption, MiniProgramRouterRedirectToOption, MiniProgramRouterSwitchTabOption, SetupContextRouter, WevuTypedRouterRouteMap } from "./types/props/router.mjs";
+import { ComponentPublicInstance, ComputedDefinitions, ExtractComputed, ExtractMethods, MethodDefinitions, ModelBinding, ModelBindingOptions, ModelBindingPayload } from "./types/core.mjs";
+import { AppConfig, InternalRuntimeState, InternalRuntimeStateFields, RuntimeApp, RuntimeInstance, WevuPlugin } from "./types/runtime.mjs";
+import { SetupContext, SetupContextNativeInstance, SetupFunction } from "./types/props/setup.mjs";
+import "./types/props.mjs";
+import { AllowedComponentProps, ComponentCustomProps, ComponentOptionsMixin, DefineComponent, NativeComponent, ObjectDirective, PublicProps, ShallowUnwrapRef, VNode, VNodeProps } from "../vue-types.mjs";
+import { SetDataDebugInfo, SetDataSnapshotOptions } from "./types/setData.mjs";
+import { CreateAppOptions, DataOption, DefineAppOptions, DefineComponentOptions, PageFeatures } from "./types/options.mjs";
+//#region src/runtime/types.d.ts
+interface WevuGlobalComponents {}
+interface WevuGlobalDirectives {}
+interface GlobalComponents extends WevuGlobalComponents {}
+interface GlobalDirectives extends WevuGlobalDirectives {}
+interface TemplateRefs {}
+interface TemplateRefValue {
+  selector: string;
+  boundingClientRect: (cb?: (value: HostMiniProgramBoundingClientRectResult | null) => void) => Promise<HostMiniProgramBoundingClientRectResult | null>;
+  scrollOffset: (cb?: (value: HostMiniProgramScrollOffsetResult | null) => void) => Promise<HostMiniProgramScrollOffsetResult | null>;
+  fields: (fields: HostMiniProgramNodesRefFields, cb?: (value: any) => void) => Promise<any | null>;
+  node: (cb?: (value: any) => void) => Promise<any | null>;
+}
+type MiniProgramTemplateRefValue = TemplateRefValue;
+//#endregion
+export { type AlipayMiniProgramHostNamespace, type AlipayMiniProgramHostSourceContract, type AllowedComponentProps, type AppConfig, type ComponentCustomProps, type ComponentOptionsMixin, type ComponentPropsOptions, type ComponentPublicInstance, type ComputedDefinitions, type CreateAppOptions, type DataOption, type DefaultMiniProgramHostNamespace, type DefaultMiniProgramHostSourceContract, type DefineAppOptions, type DefineComponent, type DefineComponentOptions, type DouyinMiniProgramHostNamespace, type DouyinMiniProgramHostSourceContract, type ExtractComputed, type ExtractDefaultPropTypes, type ExtractMethods, type ExtractPropTypes, type ExtractPublicPropTypes, GlobalComponents, GlobalDirectives, type HostMiniProgramAddToFavoritesOption, type HostMiniProgramAppOptions, type HostMiniProgramAppTrivialInstance, type HostMiniProgramBehaviorIdentifier, type HostMiniProgramBoundingClientRectResult, type HostMiniProgramComponentAllFullProperty, type HostMiniProgramComponentAllProperty, type HostMiniProgramComponentBehaviorOptions, type HostMiniProgramComponentEmptyArray, type HostMiniProgramComponentInstance, type HostMiniProgramComponentMethodOption, type HostMiniProgramComponentPropertyOption, type HostMiniProgramComponentPropertyValue, type HostMiniProgramComponentShortProperty, type HostMiniProgramComponentTrivialInstance, type HostMiniProgramComponentTrivialOption, type HostMiniProgramIntersectionObserver, type HostMiniProgramIntersectionObserverOptions, type HostMiniProgramLaunchOptions, type HostMiniProgramMemoryWarningResult, type HostMiniProgramNavigateToOption, type HostMiniProgramNodesRef, type HostMiniProgramNodesRefFields, type HostMiniProgramPageLifetime, type HostMiniProgramPageNotFoundOptions, type HostMiniProgramPageResizeOption, type HostMiniProgramPageScrollOption, type HostMiniProgramPageTrivialInstance, type HostMiniProgramReLaunchOption, type HostMiniProgramRedirectToOption, type HostMiniProgramRouter, type HostMiniProgramSaveExitState, type HostMiniProgramScrollOffsetResult, type HostMiniProgramSelectorQuery, type HostMiniProgramShareAppMessageOption, type HostMiniProgramSwitchTabOption, type HostMiniProgramTabItemTapOption, type HostMiniProgramThemeChangeResult, type HostMiniProgramTriggerEventOptions, type HostMiniProgramUnhandledRejectionResult, type InferNativePropType, type InferNativeProps, type InferPropType, type InferProps, type InternalRuntimeState, type InternalRuntimeStateFields, type MethodDefinitions, type MiniProgramAdapter, type HostMiniProgramAddToFavoritesOption as MiniProgramAddToFavoritesOption, type MiniProgramAppOptions, type MiniProgramBehaviorIdentifier, type HostMiniProgramBoundingClientRectResult as MiniProgramBoundingClientRectResult, type HostMiniProgramComponentAllFullProperty as MiniProgramComponentAllFullProperty, type HostMiniProgramComponentAllProperty as MiniProgramComponentAllProperty, type HostMiniProgramComponentBehaviorOptions as MiniProgramComponentBehaviorOptions, type HostMiniProgramComponentEmptyArray as MiniProgramComponentEmptyArray, type MiniProgramComponentInstance, type HostMiniProgramComponentMethodOption as MiniProgramComponentMethodOption, type MiniProgramComponentOptions, type HostMiniProgramComponentPropertyOption as MiniProgramComponentPropertyOption, type MiniProgramComponentPropertyValue, type MiniProgramComponentRawOptions, type HostMiniProgramComponentShortProperty as MiniProgramComponentShortProperty, type MiniProgramHostNamespace, type MiniProgramHostNamespaceBySource, type MiniProgramHostSourceName, type MiniProgramHostSourceRegistry, type MiniProgramInstance, type HostMiniProgramIntersectionObserver as MiniProgramIntersectionObserver, type HostMiniProgramIntersectionObserverOptions as MiniProgramIntersectionObserverOptions, type HostMiniProgramLaunchOptions as MiniProgramLaunchOptions, type HostMiniProgramMemoryWarningResult as MiniProgramMemoryWarningResult, type HostMiniProgramNavigateToOption as MiniProgramNavigateToOption, type HostMiniProgramNodesRef as MiniProgramNodesRef, type HostMiniProgramNodesRefFields as MiniProgramNodesRefFields, type HostMiniProgramPageLifetime as MiniProgramPageLifetime, type MiniProgramPageLifetimes, type HostMiniProgramPageNotFoundOptions as MiniProgramPageNotFoundOptions, type HostMiniProgramPageResizeOption as MiniProgramPageResizeOption, type HostMiniProgramPageScrollOption as MiniProgramPageScrollOption, type MiniProgramPlatformHostNamespaceBySource, type MiniProgramPlatformHostSourceName, type MiniProgramPlatformHostSourceRegistry, type HostMiniProgramReLaunchOption as MiniProgramReLaunchOption, type HostMiniProgramRedirectToOption as MiniProgramRedirectToOption, type HostMiniProgramRouter as MiniProgramRouter, type MiniProgramRouterNavigateToOption, type MiniProgramRouterReLaunchOption, type MiniProgramRouterRedirectToOption, type MiniProgramRouterSwitchTabOption, type MiniProgramRuntimeHostNamespaceBySource, type MiniProgramRuntimeHostSourceName, type MiniProgramRuntimeHostSourceRegistry, type HostMiniProgramSaveExitState as MiniProgramSaveExitState, type HostMiniProgramScrollOffsetResult as MiniProgramScrollOffsetResult, type HostMiniProgramSelectorQuery as MiniProgramSelectorQuery, type HostMiniProgramShareAppMessageOption as MiniProgramShareAppMessageOption, type HostMiniProgramSwitchTabOption as MiniProgramSwitchTabOption, type HostMiniProgramTabItemTapOption as MiniProgramTabItemTapOption, MiniProgramTemplateRefValue, type HostMiniProgramThemeChangeResult as MiniProgramThemeChangeResult, type HostMiniProgramUnhandledRejectionResult as MiniProgramUnhandledRejectionResult, type ModelBinding, type ModelBindingOptions, type ModelBindingPayload, type NativeComponent, type NativePropType, type NativePropsOptions, type NativeTypeHint, type NativeTypedProperty, type ObjectDirective, type PageFeatures, type PropConstructor, type PropOptions, type PropType, type PublicProps, type RuntimeApp, type RuntimeInstance, type SetDataDebugInfo, type SetDataSnapshotOptions, type SetupContext, type SetupContextNativeInstance, type SetupContextRouter, type SetupFunction, type ShallowUnwrapRef, TemplateRefValue, TemplateRefs, type HostMiniProgramTriggerEventOptions as TriggerEventOptions, type TtMiniProgramHostNamespace, type TtMiniProgramHostSourceContract, type VNode, type VNodeProps, type WechatMiniProgramHostNamespace, type WechatMiniProgramHostSourceContract, WevuGlobalComponents, WevuGlobalDirectives, type WevuPlugin, type WevuTypedRouterRouteMap };

package/dist/runtime/uniAppHost.d.mts

@@ -0,0 +1,8 @@
+//#region src/runtime/uniAppHost.d.ts
+type UniAppHost = Record<string, any>;
+/**
+ * 在原生小程序宿主上补齐 uni-app 专属 API，并保持未适配 API 继续继承宿主实现。
+ */
+declare function createUniAppHost(host: UniAppHost): UniAppHost;
+//#endregion
+export { createUniAppHost };

package/dist/runtime/uniAppHost.mjs

@@ -0,0 +1 @@
+const e=new Map,t=new WeakMap;function n(e,t=0){let n=Number(e);return Number.isFinite(n)&&n>=0?n:t}function r(e){let t=String(e||`en`).trim().replace(`_`,`-`).toLowerCase();return t===`zh-tw`||t===`zh-hk`||t===`zh-mo`||t.startsWith(`zh-hant`)?`zh-Hant`:t.startsWith(`zh`)?`zh-Hans`:t.split(`-`)[0]||`en`}function i(e={}){var t;if(e.safeAreaInsets)return e;let r=n(e.windowWidth,n(e.screenWidth)),i=n(e.windowHeight,n(e.screenHeight)),a=n(e.screenWidth,r),o=n(e.screenHeight,i),s=(t=e.safeArea)==null?{bottom:i,left:0,right:r,top:0}:t;return{...e,safeArea:s,safeAreaInsets:{bottom:Math.max(0,o-n(s.bottom,i)),left:n(s.left),right:Math.max(0,a-n(s.right,r)),top:n(s.top)}}}function a(t,n){var r;if(typeof t!=`string`||typeof n!=`function`)return;let i=(r=e.get(t))==null?new Set:r;i.add({handler:n,original:n}),e.set(t,i)}function o(t,n){if(t===void 0){e.clear();return}if(typeof t!=`string`)return;if(typeof n!=`function`){e.delete(t);return}let r=e.get(t);if(r){for(let e of r)(e.original===n||e.handler===n)&&r.delete(e);r.size===0&&e.delete(t)}}function s(t,n){var r;if(typeof t!=`string`||typeof n!=`function`)return;let i=(...e)=>{o(t,n),n(...e)},a=(r=e.get(t))==null?new Set:r;a.add({handler:i,original:n}),e.set(t,a)}function c(t,...n){let r=e.get(t);if(r)for(let{handler:e}of[...r])e(...n)}function l(e){let l=t.get(e);if(l)return l;let u=Object.create(e);t.set(e,u);let d=()=>{var t,n;return i((t=(n=e.getSystemInfoSync)==null?void 0:n.call(e))==null?{}:t)};return Object.assign(u,{$emit:c,$off:o,$on:a,$once:s,getLocale(){var t,n;return typeof e.getLocale==`function`?r(e.getLocale()):r((t=(n=e.getAppBaseInfo)==null?void 0:n.call(e).language)==null?d().language:t)},getSystemInfoSync:d,getWindowInfo(){var t,n;return i((t=(n=e.getWindowInfo)==null?void 0:n.call(e))==null?d():t)},rpx2px(e){let t=n(d().windowWidth);return Number.isFinite(e)&&t>0?e*t/750:0}}),u}export{l as createUniAppHost};

package/dist/runtime/updatePerformance.d.mts

@@ -0,0 +1,13 @@
+//#region src/runtime/updatePerformance.d.ts
+type UpdatePerformanceListenerResult = Record<string, any>;
+type UpdatePerformanceListener = (result: UpdatePerformanceListenerResult) => void;
+type UseUpdatePerformanceListenerStopHandle = () => void;
+/**
+ * 在 setup 中注册更新性能监听，并在卸载时自动清理。
+ *
+ * - 底层能力：`instance.setUpdatePerformanceListener(listener)`。
+ * - 清理策略：卸载时回传 `undefined` 作为监听器，平台不支持时静默降级。
+ */
+declare function useUpdatePerformanceListener(listener: UpdatePerformanceListener): UseUpdatePerformanceListenerStopHandle;
+//#endregion
+export { UpdatePerformanceListener, UpdatePerformanceListenerResult, UseUpdatePerformanceListenerStopHandle, useUpdatePerformanceListener };

package/dist/runtime/updatePerformance.mjs

@@ -0,0 +1 @@
+import{getCurrentInstance as e}from"./hooks/base.mjs";import{onDetached as t,onUnload as n}from"./hooks/register.mjs";function r(e){let t=e,n=t.setUpdatePerformanceListener;if(typeof n==`function`)return e=>{n.call(t,e)}}function i(i){let a=e();if(!a)throw Error(`useUpdatePerformanceListener() 必须在 setup() 的同步阶段调用`);if(typeof i!=`function`)throw TypeError(`useUpdatePerformanceListener() 需要传入监听函数`);let o=r(a);if(!o)throw Error(`当前实例不支持 setUpdatePerformanceListener，请检查基础库版本或组件上下文`);o(i);let s=!1,c=()=>{if(!s){s=!0;try{o(void 0)}catch(e){}}};return n(c),t(c),c}export{i as useUpdatePerformanceListener};

package/dist/runtime/use.d.mts

@@ -0,0 +1,13 @@
+import { RuntimeApp, WevuPlugin } from "./types/runtime.mjs";
+import "./types.mjs";
+//#region src/runtime/use.d.ts
+/**
+ * 在 `app` 级 `setup()` 中显式获取运行时 app，提供与 `app.use()` / `app.provide()` 对齐的 SFC 写法。
+ */
+declare function defineAppSetup<T>(setup: (app: RuntimeApp<any, any, any>) => T): T;
+/**
+ * 在 `app` 级 `setup()` 中安装插件，提供与 `app.use()` 对齐的 SFC 调用方式。
+ */
+declare function use(plugin: WevuPlugin, ...options: any[]): RuntimeApp<any, any, any>;
+//#endregion
+export { defineAppSetup, use };

package/dist/runtime/use.mjs

@@ -0,0 +1 @@
+import{getCurrentInstance as e}from"./hooks/base.mjs";import{WEVU_IS_APP_INSTANCE_KEY as t,WEVU_RUNTIME_APP_KEY as n}from"@weapp-core/constants";function r(){let r=e();if(r!=null&&r[t]&&r[n])return r[n];throw Error(`defineAppSetup() / use() 只能在 app setup 上下文中调用`)}function i(e){return e(r())}function a(e,...t){return r().use(e,...t)}export{i as defineAppSetup,a as use};

package/dist/runtime/vueCompat/context.d.mts

@@ -0,0 +1,8 @@
+import { SetupContextNativeInstance } from "../types/props/setup.mjs";
+import "../types.mjs";
+//#region src/runtime/vueCompat/context.d.ts
+declare function useAttrs(): Record<string, any>;
+declare function useSlots(): Record<string, any>;
+declare function useNativeInstance(): SetupContextNativeInstance;
+//#endregion
+export { useAttrs, useNativeInstance, useSlots };

package/dist/runtime/vueCompat/context.mjs

@@ -0,0 +1 @@
+import{getCurrentSetupContext as e}from"../hooks/base.mjs";const t=Object.freeze(Object.create(null));function n(){var t;let n=e();if(!n)throw Error(`useAttrs() 必须在 setup() 的同步阶段调用`);return(t=n.attrs)==null?{}:t}function r(){var n;let r=e();if(!r)throw Error(`useSlots() 必须在 setup() 的同步阶段调用`);return(n=r.slots)==null?t:n}function i(){let t=e();if(!(t!=null&&t.instance))throw Error(`useNativeInstance() 必须在 setup() 的同步阶段调用`);return t.instance}export{n as useAttrs,i as useNativeInstance,r as useSlots};