wevu 1.0.3 → 1.0.6

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Ref as Ref$1 } from "@vue/reactivity";
-import { ComponentOptionsMixin, DefineComponent, PublicProps } from "vue";
+import { AllowedComponentProps, ComponentCustomProps, ComponentOptionsMixin, DefineComponent, ObjectDirective, PublicProps, ShallowUnwrapRef, VNode, VNodeProps } from "vue";
 
 //#region src/reactivity/ref.d.ts
 type Ref<T$1 = any, S = T$1> = Ref$1<T$1, S>;
@@ -44,6 +44,7 @@ interface ReactiveEffect<T$1 = any> {
 declare function startBatch(): void;
 declare function endBatch(): void;
 declare function batch<T$1>(fn: () => T$1): T$1;
+declare function stop(runner: ReactiveEffect): void;
 interface EffectScope {
   active: boolean;
   effects: ReactiveEffect[];
@@ -60,10 +61,8 @@ interface EffectOptions {
   onStop?: () => void;
 }
 declare function effect<T$1 = any>(fn: () => T$1, options?: EffectOptions): ReactiveEffect<T$1>;
-declare function stop(runner: ReactiveEffect): void;
 //#endregion
-//#region src/reactivity/reactive.d.ts
-declare function getReactiveVersion(target: object): number;
+//#region src/reactivity/reactive/mutation.d.ts
 type MutationOp = 'set' | 'delete';
 type MutationKind = 'property' | 'array';
 interface MutationRecord {
@@ -71,20 +70,19 @@ interface MutationRecord {
   kind: MutationKind;
   op: MutationOp;
   /**
-   * dot path（例如 `a.b.c`）；若路径无法可靠解析则为 undefined。
+   * dot path (e.g. `a.b.c`); undefined when path is not reliable.
    */
   path?: string;
   /**
-   * 当路径不唯一/无法可靠解析时，给 patch 模式的“局部回退”提示顶层 key 集合。
+   * Top-level keys to fallback when path is not unique.
    */
   fallbackTopKeys?: string[];
 }
 type MutationRecorder = (record: MutationRecord) => void;
 declare function addMutationRecorder(recorder: MutationRecorder): void;
 declare function removeMutationRecorder(recorder: MutationRecorder): void;
-declare function reactive<T$1 extends object>(target: T$1): T$1;
-declare function isReactive(value: unknown): boolean;
-declare function toRaw<T$1>(observed: T$1): T$1;
+//#endregion
+//#region src/reactivity/reactive/patch.d.ts
 interface PrelinkReactiveTreeOptions {
   shouldIncludeTopKey?: (key: string) => boolean;
   maxDepth?: number;
@@ -95,6 +93,8 @@ declare function prelinkReactiveTree(root: object, options?: PrelinkReactiveTree
  * 让 effect 订阅整个对象的“版本号”，无需深度遍历即可对任何字段变化做出响应。
  */
 declare function touchReactive(target: object): void;
+//#endregion
+//#region src/reactivity/reactive/shallow.d.ts
 /**
  * 创建一个浅层响应式代理：仅跟踪第一层属性变更，不深度递归嵌套对象。
  *
@@ -114,6 +114,14 @@ declare function shallowReactive<T$1 extends object>(target: T$1): T$1;
  * 判断一个值是否为 shallowReactive 创建的浅层响应式对象
  */
 declare function isShallowReactive(value: unknown): boolean;
+//#endregion
+//#region src/reactivity/reactive/shared.d.ts
+declare function toRaw<T$1>(observed: T$1): T$1;
+//#endregion
+//#region src/reactivity/reactive.d.ts
+declare function getReactiveVersion(target: object): number;
+declare function reactive<T$1 extends object>(target: T$1): T$1;
+declare function isReactive(value: unknown): boolean;
 /**
  * 标记对象为“原始”状态，后续不会被转换为响应式，返回原对象本身。
  *
@@ -152,20 +160,6 @@ declare function readonly<T$1 extends object>(target: T$1): T$1;
 declare function readonly<T$1>(target: Ref<T$1>): Readonly<Ref<T$1>>;
 //#endregion
 //#region src/reactivity/shallowRef.d.ts
-/**
- * 创建一个“浅层” ref：它只在 .value 被整体替换时触发依赖，不会对内部对象做深层响应式处理。
- *
- * @param value 初始值
- * @param defaultValue 传递给 customRef 的默认值，可用于兜底
- * @returns 仅跟踪自身 .value 变更的浅层 ref
- *
- * @example
- * ```ts
- * const state = shallowRef({ count: 0 })
- * state.value = { count: 1 } // 会触发依赖
- * state.value.count++ // 不会触发依赖（内部属性未被深度代理）
- * ```
- */
 declare function shallowRef<T$1>(value: T$1): Ref<T$1>;
 declare function shallowRef<T$1>(value: T$1, defaultValue: T$1): Ref<T$1>;
 /**
@@ -183,22 +177,6 @@ declare function isShallowRef(r: any): r is Ref<any>;
 declare function triggerRef<T$1>(ref: Ref<T$1>): void;
 //#endregion
 //#region src/reactivity/toRefs.d.ts
-/**
- * 将一个响应式对象转换成“同结构的普通对象”，其中每个字段都是指向原对象对应属性的 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
- * ```
- */
-declare function toRefs<T$1 extends object>(object: T$1): ToRefs<T$1>;
 /**
  * 为源响应式对象的单个属性创建 ref，可读可写并与原属性保持同步。
  *
@@ -217,6 +195,22 @@ declare function toRefs<T$1 extends object>(object: T$1): ToRefs<T$1>;
  */
 declare function toRef<T$1 extends object, K$1 extends keyof T$1>(object: T$1, key: K$1): Ref<T$1[K$1]>;
 declare function toRef<T$1 extends object, K$1 extends keyof T$1>(object: T$1, key: K$1, defaultValue: T$1[K$1]): Ref<T$1[K$1]>;
+/**
+ * 将一个响应式对象转换成“同结构的普通对象”，其中每个字段都是指向原对象对应属性的 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
+ * ```
+ */
+declare function toRefs<T$1 extends object>(object: T$1): ToRefs<T$1>;
 /**
  * toRefs 返回值的类型辅助
  */
@@ -230,137 +224,47 @@ interface WatchOptions {
   immediate?: boolean;
   deep?: boolean;
 }
-type WatchSource<T$1 = any> = (() => T$1) | Ref<T$1> | object;
+type WatchSource<T$1 = any> = (() => T$1) | Ref<T$1>;
+type WatchSourceValue<S> = S extends Ref<infer V> ? V : S extends (() => infer V) ? V : S extends object ? S : never;
+type IsTuple<T$1 extends ReadonlyArray<any>> = number extends T$1['length'] ? false : true;
+type WatchMultiSources<T$1 extends ReadonlyArray<WatchSource<any>>> = IsTuple<T$1> extends true ? { [K in keyof T$1]: WatchSourceValue<T$1[K]> } : Array<WatchSourceValue<T$1[number]>>;
 type WatchStopHandle = () => void;
 type DeepWatchStrategy = 'version' | 'traverse';
 declare function setDeepWatchStrategy(strategy: DeepWatchStrategy): void;
 declare function getDeepWatchStrategy(): DeepWatchStrategy;
 declare function watch<T$1>(source: WatchSource<T$1>, cb: (value: T$1, oldValue: T$1, onCleanup: (cleanupFn: () => void) => void) => void, options?: WatchOptions): WatchStopHandle;
+declare function watch<T$1 extends object>(source: T$1 extends ReadonlyArray<any> ? never : T$1, cb: (value: T$1, oldValue: T$1, onCleanup: (cleanupFn: () => void) => void) => void, options?: WatchOptions): WatchStopHandle;
+declare function watch<T$1 extends ReadonlyArray<WatchSource<any>>>(source: T$1, cb: (value: WatchMultiSources<T$1>, oldValue: WatchMultiSources<T$1>, onCleanup: (cleanupFn: () => void) => void) => void, options?: WatchOptions): WatchStopHandle;
 /**
  * watchEffect 注册一个响应式副作用，可选清理函数。
  * 副作用会立即执行，并在依赖变化时重新运行。
  */
 declare function watchEffect(effectFn: (onCleanup: (cleanupFn: () => void) => void) => void): WatchStopHandle;
 //#endregion
-//#region src/runtime/types.d.ts
+//#region src/runtime/types/core.d.ts
 type ComputedDefinitions = Record<string, ComputedGetter<any> | WritableComputedOptions<any>>;
 type MethodDefinitions = Record<string, (...args: any[]) => any>;
 type ExtractComputed<C extends ComputedDefinitions> = { [K in keyof C]: C[K] extends ComputedGetter<infer R> ? R : C[K] extends WritableComputedOptions<infer R> ? R : never };
 type ExtractMethods<M extends MethodDefinitions> = { [K in keyof M]: M[K] extends ((...args: infer P) => infer R) ? (...args: P) => R : never };
-type ComponentPublicInstance<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = D & ExtractComputed<C> & ExtractMethods<M>;
-interface MiniProgramAdapter {
-  setData?: (payload: Record<string, any>) => void | Promise<void>;
+type ComponentPublicInstance<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions> = D & ExtractComputed<C> & ExtractMethods<M> & {
+  $attrs: Record<string, any>;
+};
+interface ModelBindingOptions<T$1 = any, Event extends string = string, ValueProp extends string = string, Formatted = T$1> {
+  event?: Event;
+  valueProp?: ValueProp;
+  parser?: (payload: any) => T$1;
+  formatter?: (value: T$1) => Formatted;
 }
-interface SetDataSnapshotOptions {
-  /**
-   * setData 策略：
-   * - diff：全量快照 + diff（默认，兼容性最好）
-   * - patch：按变更路径增量产出 payload（性能更好；在共享引用等场景会自动回退 diff）
-   */
-  strategy?: 'diff' | 'patch';
-  /**
-   * 仅下发指定的顶层字段（包含 data/setup 返回值与 computed）。
-   * 若为空则默认下发所有字段。
-   */
-  pick?: string[];
-  /**
-   * 排除指定的顶层字段（包含 data/setup 返回值与 computed）。
-   */
-  omit?: string[];
-  /**
-   * 是否将 computed 的结果参与 setData（默认 true）。
-   */
-  includeComputed?: 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;
-  /**
-   * 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;
+type ModelBindingPayload<T$1 = any, Event extends string = 'input', ValueProp extends string = 'value', Formatted = T$1> = { [K in ValueProp]: Formatted } & { [K in `on${Capitalize<Event>}`]: (event: any) => void };
+interface ModelBinding<T$1 = any> {
+  value: T$1;
+  update: (value: T$1) => void;
+  model: <Event extends string = 'input', ValueProp extends string = 'value', Formatted = T$1>(options?: ModelBindingOptions<T$1, Event, ValueProp, Formatted>) => ModelBindingPayload<T$1, Event, ValueProp, Formatted>;
 }
-interface SetDataDebugInfo {
-  mode: 'patch' | 'diff';
-  reason: 'patch' | 'diff' | 'needsFullSnapshot' | 'maxPatchKeys' | 'maxPayloadBytes';
-  pendingPatchKeys: number;
-  payloadKeys: number;
-  estimatedBytes?: number;
-  bytes?: number;
-  mergedSiblingParents?: number;
-  computedDirtyKeys?: number;
+//#endregion
+//#region src/runtime/types/miniprogram.d.ts
+interface MiniProgramAdapter {
+  setData?: (payload: Record<string, any>) => void | Promise<void>;
 }
 type MiniProgramComponentBehaviorOptions = WechatMiniprogram.Component.ComponentOptions;
 type MpComponentOptions = WechatMiniprogram.Component.TrivialOption;
@@ -428,24 +332,21 @@ interface MiniProgramComponentOptions {
   detached?: MpComponentOptions['detached'];
   error?: MpComponentOptions['error'];
 }
-interface ModelBindingOptions<T$1 = any> {
-  event?: string;
-  valueProp?: string;
-  parser?: (payload: any) => T$1;
-  formatter?: (value: T$1) => any;
-}
-interface ModelBinding<T$1 = any> {
-  value: T$1;
-  update: (value: T$1) => void;
-  model: (options?: ModelBindingOptions<T$1>) => Record<string, any>;
-}
+type MiniProgramAppOptions<T$1 extends Record<string, any> = Record<string, any>> = WechatMiniprogram.App.Options<T$1>;
+type TriggerEventOptions = WechatMiniprogram.Component.TriggerEventOption;
+type MiniProgramInstance = WechatMiniprogram.Component.TrivialInstance | WechatMiniprogram.Page.TrivialInstance | WechatMiniprogram.App.TrivialInstance;
+type MiniProgramPageLifetimes = Partial<WechatMiniprogram.Page.ILifetime>;
+type MiniProgramComponentRawOptions = Omit<WechatMiniprogram.Component.TrivialOption, 'behaviors'> & {
+  behaviors?: MiniProgramBehaviorIdentifier[];
+} & MiniProgramPageLifetimes & Record<string, any>;
+//#endregion
+//#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;
 };
-type MiniProgramAppOptions<T$1 extends Record<string, any> = Record<string, any>> = WechatMiniprogram.App.Options<T$1>;
 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>;
@@ -462,6 +363,16 @@ interface RuntimeInstance<D extends object, C extends ComputedDefinitions, M ext
   snapshot: () => Record<string, any>;
   unmount: () => void;
 }
+interface InternalRuntimeStateFields {
+  __wevu?: RuntimeInstance<any, any, any>;
+  __wevuWatchStops?: WatchStopHandle[];
+  $wevu?: RuntimeInstance<any, any, any>;
+  __wevuHooks?: Record<string, any>;
+  __wevuExposed?: Record<string, any>;
+}
+type InternalRuntimeState = InternalRuntimeStateFields & Partial<MiniProgramInstance>;
+//#endregion
+//#region src/runtime/types/props.d.ts
 type PropMethod<T$1, TConstructor = any> = [T$1] extends [((...args: any) => any) | undefined] ? {
   new (): TConstructor;
   (): T$1;
@@ -503,6 +414,8 @@ type InferPropType<O> = O extends null ? any : O extends {
 } ? InferPropConstructor<T> : O extends PropType<infer V> ? V : InferPropConstructor<O>;
 type InferPropConstructor<T$1> = T$1 extends readonly any[] ? InferPropConstructor<T$1[number]> : T$1 extends undefined ? any : T$1 extends null ? any : T$1 extends BooleanConstructor ? boolean : T$1 extends NumberConstructor ? number : T$1 extends StringConstructor ? string : T$1 extends DateConstructor ? Date : T$1 extends ArrayConstructor ? any[] : T$1 extends ObjectConstructor ? Record<string, any> : T$1 extends PropConstructor<infer V> ? V : any;
 type InferProps<P$1 extends ComponentPropsOptions = ComponentPropsOptions> = { [K in keyof Pick<P$1, RequiredKeys<P$1>>]: HasDefault<P$1[K]> extends true ? Exclude<InferPropType<P$1[K]>, undefined> : InferPropType<P$1[K]> } & { [K in keyof Pick<P$1, OptionalKeys<P$1>>]?: InferPropType<P$1[K]> };
+type ExtractPropTypes<P$1 extends ComponentPropsOptions = ComponentPropsOptions> = InferProps<P$1>;
+type ExtractPublicPropTypes<P$1 extends ComponentPropsOptions = ComponentPropsOptions> = InferProps<P$1>;
 type SetupFunction<P$1 extends ComponentPropsOptions, D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = (props: InferProps<P$1>, ctx: SetupContext<D, C, M, P$1>) => Record<string, any> | void;
 interface SetupContext<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions, P$1 extends ComponentPropsOptions = ComponentPropsOptions> {
   /**
@@ -520,7 +433,7 @@ interface SetupContext<D extends object, C extends ComputedDefinitions, M extend
   /**
    * 公开实例代理
    */
-  proxy: ComponentPublicInstance<D, C, M>;
+  proxy: RuntimeInstance<D, C, M>['proxy'];
   /**
    * 双向绑定辅助方法
    */
@@ -553,20 +466,121 @@ interface SetupContext<D extends object, C extends ComputedDefinitions, M extend
    */
   slots: Record<string, any>;
 }
-type TriggerEventOptions = WechatMiniprogram.Component.TriggerEventOption;
-interface InternalRuntimeStateFields {
-  __wevu?: RuntimeInstance<any, any, any>;
-  __wevuWatchStops?: WatchStopHandle[];
-  $wevu?: RuntimeInstance<any, any, any>;
-  __wevuHooks?: Record<string, any>;
-  __wevuExposed?: Record<string, any>;
+//#endregion
+//#region src/runtime/types/setData.d.ts
+interface SetDataSnapshotOptions {
+  /**
+   * setData 策略：
+   * - diff：全量快照 + diff（默认，兼容性最好）
+   * - patch：按变更路径增量产出 payload（性能更好；在共享引用等场景会自动回退 diff）
+   */
+  strategy?: 'diff' | 'patch';
+  /**
+   * 仅下发指定的顶层字段（包含 data/setup 返回值与 computed）。
+   * 若为空则默认下发所有字段。
+   */
+  pick?: string[];
+  /**
+   * 排除指定的顶层字段（包含 data/setup 返回值与 computed）。
+   */
+  omit?: string[];
+  /**
+   * 是否将 computed 的结果参与 setData（默认 true）。
+   */
+  includeComputed?: 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;
+  /**
+   * 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;
 }
-type MiniProgramInstance = WechatMiniprogram.Component.TrivialInstance | WechatMiniprogram.Page.TrivialInstance | WechatMiniprogram.App.TrivialInstance;
-type InternalRuntimeState = InternalRuntimeStateFields & Partial<MiniProgramInstance>;
-type MiniProgramPageLifetimes = Partial<WechatMiniprogram.Page.ILifetime>;
-type MiniProgramComponentRawOptions = Omit<WechatMiniprogram.Component.TrivialOption, 'behaviors'> & {
-  behaviors?: MiniProgramBehaviorIdentifier[];
-} & MiniProgramPageLifetimes & Record<string, any>;
+interface SetDataDebugInfo {
+  mode: 'patch' | 'diff';
+  reason: 'patch' | 'diff' | 'needsFullSnapshot' | 'maxPatchKeys' | 'maxPayloadBytes';
+  pendingPatchKeys: number;
+  payloadKeys: number;
+  estimatedBytes?: number;
+  bytes?: number;
+  mergedSiblingParents?: number;
+  computedDirtyKeys?: number;
+}
+//#endregion
+//#region src/runtime/types/options.d.ts
 interface DefineComponentOptions<P$1 extends ComponentPropsOptions = ComponentPropsOptions, D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions> extends MiniProgramComponentOptions, MiniProgramPageLifetimes {
   /**
    * 页面特性开关（用于按需注入 Page 事件处理函数）。
@@ -664,6 +678,10 @@ interface PageFeatures {
   enableOnSaveExitState?: boolean;
 }
 //#endregion
+//#region src/runtime/types.d.ts
+interface GlobalComponents {}
+interface GlobalDirectives {}
+//#endregion
 //#region src/runtime/app.d.ts
 declare function createApp<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(options: CreateAppOptions<D, C, M>): RuntimeApp<D, C, M>;
 //#endregion
@@ -712,7 +730,7 @@ interface ComponentDefinition<D extends object, C extends ComputedDefinitions, M
  * defineComponent({
  *   data: () => ({ count: 0 }),
  *   setup() {
- *     onMounted(() => console.log('mounted'))
+ *     onMounted(() => console.log('已挂载'))
  *   }
  * })
  * ```
@@ -735,7 +753,9 @@ declare function defineComponent<P$1 extends ComponentPropsOptions = ComponentPr
 declare function createWevuComponent<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(options: DefineComponentOptions<ComponentPropsOptions, D, C, M> & {
   properties?: WechatMiniprogram.Component.PropertyOption;
 }): void;
-declare function createWevuScopedSlotComponent(): void;
+declare function createWevuScopedSlotComponent(overrides?: {
+  computed?: ComputedDefinitions;
+}): void;
 //#endregion
 //#region src/runtime/hooks.d.ts
 declare function getCurrentInstance<T$1 extends InternalRuntimeState = InternalRuntimeState>(): T$1 | undefined;
@@ -859,7 +879,7 @@ declare function provideGlobal<T$1>(key: any, value: T$1): void;
  */
 declare function injectGlobal<T$1>(key: any, defaultValue?: T$1): T$1;
 //#endregion
-//#region src/runtime/register.d.ts
+//#region src/runtime/register/watch.d.ts
 type WatchHandler = (this: any, value: any, oldValue: any) => void;
 type WatchDescriptor = WatchHandler | string | {
   handler: WatchHandler | string;
@@ -867,19 +887,42 @@ type WatchDescriptor = WatchHandler | string | {
   deep?: boolean;
 };
 type WatchMap = Record<string, WatchDescriptor>;
-type RuntimeSetupFunction<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'] | DefineAppOptions<D, C, M>['setup'];
-declare function runSetupFunction(setup: ((...args: any[]) => any) | undefined, props: Record<string, any>, context: any): any;
-declare function mountRuntimeInstance<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(target: InternalRuntimeState, runtimeApp: RuntimeApp<D, C, M>, watchMap: WatchMap | undefined, setup?: RuntimeSetupFunction<D, C, M>, options?: {
+//#endregion
+//#region src/runtime/register/app.d.ts
+declare function registerApp<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(runtimeApp: RuntimeApp<D, C, M>, methods: MethodDefinitions, watch: WatchMap | undefined, setup: DefineAppOptions<D, C, M>['setup'], mpOptions: MiniProgramAppOptions): void;
+//#endregion
+//#region src/runtime/register/component.d.ts
+declare function registerComponent<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(runtimeApp: RuntimeApp<D, C, M>, methods: MethodDefinitions, watch: WatchMap | undefined, setup: DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'], mpOptions: MiniProgramComponentRawOptions): void;
+//#endregion
+//#region src/runtime/register/runtimeInstance.d.ts
+type RuntimeSetupFunction$1<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'] | DefineAppOptions<D, C, M>['setup'];
+declare function mountRuntimeInstance<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(target: InternalRuntimeState, runtimeApp: RuntimeApp<D, C, M>, watchMap: WatchMap | undefined, setup?: RuntimeSetupFunction$1<D, C, M>, options?: {
   deferSetData?: boolean;
 }): RuntimeInstance<D, C, M>;
 declare function teardownRuntimeInstance(target: InternalRuntimeState): void;
-declare function registerApp<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(runtimeApp: RuntimeApp<D, C, M>, methods: MethodDefinitions, watch: WatchMap | undefined, setup: DefineAppOptions<D, C, M>['setup'], mpOptions: MiniProgramAppOptions): void;
-declare function registerComponent<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions>(runtimeApp: RuntimeApp<D, C, M>, methods: MethodDefinitions, watch: WatchMap | undefined, setup: DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'], mpOptions: MiniProgramComponentRawOptions): void;
+//#endregion
+//#region src/runtime/register/setup.d.ts
+type RuntimeSetupFunction<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'] | DefineAppOptions<D, C, M>['setup'];
+declare function runSetupFunction(setup: RuntimeSetupFunction<any, any, any> | undefined, props: Record<string, any>, context: any): void | Record<string, any>;
+//#endregion
+//#region src/runtime/template.d.ts
+declare function normalizeStyle(value: any): string;
+declare function normalizeClass(value: any): string;
 //#endregion
 //#region src/runtime/vueCompat.d.ts
 declare function useAttrs(): Record<string, any>;
 declare function useSlots(): Record<string, any>;
 declare function useModel<T$1 = any>(props: Record<string, any>, name: string): Ref<T$1>;
+/**
+ * useBindModel 返回绑定到当前运行时实例的 bindModel。
+ * 该方法必须在 setup() 的同步阶段调用。
+ */
+type BindModelWithHelper<DefaultEvent extends string = 'input', DefaultValueProp extends string = 'value'> = (<T$1 = any>(path: string, options?: ModelBindingOptions<T$1>) => ModelBinding<T$1>) & {
+  model: <T$1 = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T$1>(path: string, options?: ModelBindingOptions<T$1, Event, ValueProp, Formatted>) => ModelBindingPayload<T$1, Event, ValueProp, Formatted>;
+  value: <T$1 = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T$1>(path: string, options?: ModelBindingOptions<T$1, Event, ValueProp, Formatted>) => Formatted;
+  on: <T$1 = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T$1>(path: string, options?: ModelBindingOptions<T$1, Event, ValueProp, Formatted>) => (event: any) => void;
+};
+declare function useBindModel<DefaultEvent extends string = 'input', DefaultValueProp extends string = 'value'>(defaultOptions?: ModelBindingOptions<any, DefaultEvent, DefaultValueProp, any>): BindModelWithHelper<DefaultEvent, DefaultValueProp>;
 declare function mergeModels<T$1>(a: T$1, b: T$1): T$1;
 //#endregion
 //#region src/store/types.d.ts
@@ -951,4 +994,174 @@ declare function createStore(): StoreManager;
 type StoreToRefsResult<T$1 extends Record<string, any>> = { [K in keyof T$1]: T$1[K] extends ((...args: any[]) => any) ? T$1[K] : T$1[K] extends Ref<infer V> ? Ref<V> : Ref<T$1[K]> };
 declare function storeToRefs<T$1 extends Record<string, any>>(store: T$1): StoreToRefsResult<T$1>;
 //#endregion
-export { ActionSubscriber, AppConfig, ComponentDefinition, type ComponentOptionsMixin, ComponentPropsOptions, ComponentPublicInstance, ComputedDefinitions, ComputedGetter, ComputedRef, ComputedSetter, CreateAppOptions, DefineAppOptions, type DefineComponent, DefineComponentOptions, DefineStoreOptions, EffectScope, ExtractComputed, ExtractMethods, InferPropType, InferProps, InternalRuntimeState, InternalRuntimeStateFields, MethodDefinitions, MiniProgramAdapter, MiniProgramAppOptions, MiniProgramBehaviorIdentifier, MiniProgramComponentBehaviorOptions, MiniProgramComponentOptions, MiniProgramComponentRawOptions, MiniProgramInstance, MiniProgramPageLifetimes, ModelBinding, ModelBindingOptions, MutationKind, MutationOp, MutationRecord, MutationType, PageFeatures, PrelinkReactiveTreeOptions, PropConstructor, PropOptions, PropType, type PublicProps, Ref, RuntimeApp, RuntimeInstance, SetDataDebugInfo, SetDataSnapshotOptions, SetupContext, SetupFunction, StoreManager, SubscriptionCallback, ToRefs, TriggerEventOptions, WatchOptions, WatchStopHandle, WevuDefaults, WevuPlugin, WritableComputedOptions, WritableComputedRef, addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, defineComponent, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, onActivated, onAddToFavorites, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMounted, onMoved, onPageNotFound, onPageScroll, onPullDownRefresh, onReachBottom, onReady, onResize, onRouteDone, onSaveExitState, onScopeDispose, onServerPrefetch, onShareAppMessage, onShareTimeline, onShow, onTabItemTap, onThemeChange, onUnhandledRejection, onUnload, onUnmounted, onUpdated, prelinkReactiveTree, provide, provideGlobal, reactive, readonly, ref, registerApp, registerComponent, removeMutationRecorder, resetWevuDefaults, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setWevuDefaults, shallowReactive, shallowRef, startBatch, stop, storeToRefs, teardownRuntimeInstance, toRaw, toRef, toRefs, touchReactive, traverse, triggerRef, unref, useAttrs, useModel, useSlots, watch, watchEffect };
+//#region src/index.d.ts
+type Prettify<T$1> = { [K in keyof T$1]: T$1[K] } & {};
+type LooseRequired<T$1> = { [P in keyof (T$1 & Required<T$1>)]: T$1[P] };
+type IfAny<T$1, Y, N> = 0 extends 1 & T$1 ? Y : N;
+type ComponentObjectPropsOptions = ComponentPropsOptions;
+type ExtractPropTypes$1<P$1 extends ComponentObjectPropsOptions> = InferProps<P$1>;
+type DefineProps<T$1, BKeys extends keyof T$1> = Readonly<T$1> & { readonly [K in BKeys]-?: boolean };
+type BooleanKey<T$1, K$1 extends keyof T$1 = keyof T$1> = K$1 extends any ? T$1[K$1] extends boolean | undefined ? T$1[K$1] extends never | undefined ? never : K$1 : never : never;
+/**
+ * wevu + Volar 类型检查使用的 script-setup 宏。
+ *
+ * 这些只是类型声明，运行时不存在。
+ * 请确保 `vueCompilerOptions.lib = "wevu"`，让 Volar 从本文件解析它们。
+ *
+ * 常见搭配示例（仅类型层）：
+ * - defineProps + withDefaults：声明 Props 并补默认值
+ * - defineEmits：约束事件与负载类型
+ * - defineSlots：约束插槽与插槽参数
+ * - defineModel：声明双向绑定字段
+ */
+/**
+ * defineProps 数组语法。
+ *
+ * @example
+ * ```ts
+ * const props = defineProps(['title', 'count'])
+ * const { title } = defineProps(['title'])
+ * ```
+ */
+declare function defineProps<PropNames extends string = string>(props: PropNames[]): Prettify<Readonly<{ [key in PropNames]?: any }>>;
+/**
+ * defineProps 运行时 props 配置。
+ *
+ * @example
+ * ```ts
+ * const props = defineProps({
+ *   title: String,
+ *   count: Number,
+ *   active: Boolean,
+ *   color: {
+ *     type: String,
+ *     default: 'red',
+ *   },
+ * })
+ * ```
+ */
+declare function defineProps<PP extends ComponentObjectPropsOptions = ComponentObjectPropsOptions>(props: PP): Prettify<Readonly<ExtractPropTypes$1<PP>>>;
+/**
+ * defineProps 泛型类型声明。
+ *
+ * @example
+ * ```ts
+ * const props = defineProps<{
+ *   title?: string
+ *   count: number
+ *   active?: boolean
+ * }>()
+ *
+ * const props2 = defineProps<{
+ *   size?: 'sm' | 'md' | 'lg'
+ * }>()
+ * ```
+ */
+declare function defineProps<TypeProps>(): DefineProps<LooseRequired<TypeProps>, BooleanKey<TypeProps>>;
+type NotUndefined<T$1> = T$1 extends undefined ? never : T$1;
+type MappedOmit<T$1, K$1 extends keyof any> = { [P in keyof T$1 as P extends K$1 ? never : P]: T$1[P] };
+type InferDefaults<T$1> = { [K in keyof T$1]?: InferDefault<T$1, T$1[K]> };
+type NativeType = null | undefined | number | string | boolean | symbol | Function;
+type InferDefault<P$1, T$1> = ((props: P$1) => T$1 & {}) | (T$1 extends NativeType ? T$1 : never);
+type PropsWithDefaults<T$1, Defaults extends InferDefaults<T$1>, BKeys extends keyof T$1> = T$1 extends unknown ? Readonly<MappedOmit<T$1, keyof Defaults>> & { readonly [K in keyof Defaults as K extends keyof T$1 ? K : never]-?: K extends keyof T$1 ? Defaults[K] extends undefined ? IfAny<Defaults[K], NotUndefined<T$1[K]>, T$1[K]> : NotUndefined<T$1[K]> : never } & { readonly [K in BKeys]-?: K extends keyof Defaults ? Defaults[K] extends undefined ? boolean | undefined : boolean : boolean } : never;
+/**
+ * withDefaults 为 defineProps 指定默认值（仅类型层）。
+ * 默认值会影响可选/必选推导，但不生成运行时代码。
+ *
+ * @example
+ * ```ts
+ * const props = withDefaults(defineProps<{
+ *   title?: string
+ *   size?: 'sm' | 'md' | 'lg'
+ * }>(), {
+ *   title: 'Empty',
+ *   size: 'md',
+ * })
+ * ```
+ */
+declare function withDefaults<T$1, BKeys extends keyof T$1, Defaults extends InferDefaults<T$1>>(props: DefineProps<T$1, BKeys>, defaults: Defaults): PropsWithDefaults<T$1, Defaults, BKeys>;
+type EmitsOptions = Record<string, ((...args: any[]) => any) | null> | string[];
+/**
+ * defineEmits 字符串数组或映射写法。
+ *
+ * @example
+ * ```ts
+ * const emit = defineEmits(['change', 'open'])
+ * emit('change', { id: 1 })
+ *
+ * const emit2 = defineEmits({
+ *   change: (payload: { id: number }) => true,
+ *   close: null,
+ * })
+ * emit2('change', { id: 2 })
+ *
+ * const emit3 = defineEmits(['tap', 'confirm'])
+ * emit3('confirm')
+ * ```
+ */
+declare function defineEmits<EE extends string = string>(emits?: EE[]): (event: EE, detail?: any) => void;
+declare function defineEmits<E extends Record<string, ((...args: any[]) => any) | null>>(emits?: E): (event: keyof E & string, detail?: any) => void;
+/**
+ * defineEmits 显式签名写法。
+ *
+ * @example
+ * ```ts
+ * const emit = defineEmits<(e: 'save' | 'cancel', id?: number) => void>()
+ * emit('save', 1)
+ * ```
+ */
+declare function defineEmits<T$1 extends (...args: any[]) => any>(): T$1;
+/**
+ * defineExpose 向父级 ref 暴露成员。
+ * 仅影响类型提示，不会生成运行时代码。
+ *
+ * @example
+ * ```ts
+ * defineExpose({
+ *   focus,
+ *   reset,
+ * })
+ * ```
+ */
+declare function defineExpose<T$1 extends Record<string, any> = Record<string, any>>(exposed?: T$1): void;
+/**
+ * defineOptions 设置组件选项。
+ * 适合声明组件名、样式隔离等静态选项。
+ *
+ * @example
+ * ```ts
+ * defineOptions({
+ *   name: 'EmptyState',
+ *   inheritAttrs: false,
+ *   virtualHost: true,
+ * })
+ * ```
+ */
+declare function defineOptions(options: Record<string, any>): void;
+/**
+ * defineSlots 声明 slots 类型。
+ * 用于限定插槽名称与插槽参数结构。
+ *
+ * @example
+ * ```ts
+ * const slots = defineSlots<{
+ *   default?: (props: { text: string }) => any
+ *   footer?: () => any
+ * }>()
+ * ```
+ */
+declare function defineSlots<T$1 extends Record<string, any> = Record<string, any>>(): T$1;
+/**
+ * defineModel 声明 v-model 绑定（weapp 变体）。
+ * 支持默认字段与自定义字段名。
+ *
+ * @example
+ * ```ts
+ * const modelValue = defineModel<string>()
+ * const checked = defineModel<boolean>('checked')
+ * const count = defineModel<number>('count', { default: 0 })
+ * ```
+ */
+declare function defineModel<T$1 = any>(name?: string, options?: Record<string, any>): Ref<T$1 | undefined>;
+//#endregion
+export { ActionSubscriber, type AllowedComponentProps, type AppConfig, type ComponentCustomProps, ComponentDefinition, type ComponentOptionsMixin, type ComponentPropsOptions, type ComponentPublicInstance, type ComputedDefinitions, ComputedGetter, ComputedRef, ComputedSetter, type CreateAppOptions, type DefineAppOptions, type DefineComponent, type DefineComponentOptions, DefineStoreOptions, EffectScope, EmitsOptions, type ExtractComputed, type ExtractMethods, type ExtractPropTypes, type ExtractPublicPropTypes, GlobalComponents, GlobalDirectives, type InferPropType, type InferProps, type InternalRuntimeState, type InternalRuntimeStateFields, type MethodDefinitions, type MiniProgramAdapter, type MiniProgramAppOptions, type MiniProgramBehaviorIdentifier, type MiniProgramComponentBehaviorOptions, type MiniProgramComponentOptions, type MiniProgramComponentRawOptions, type MiniProgramInstance, type MiniProgramPageLifetimes, type ModelBinding, type ModelBindingOptions, type ModelBindingPayload, type MutationKind, type MutationOp, type MutationRecord, MutationType, type ObjectDirective, type PageFeatures, type PrelinkReactiveTreeOptions, type PropConstructor, type PropOptions, type PropType, type PublicProps, Ref, type RuntimeApp, type RuntimeInstance, type SetDataDebugInfo, type SetDataSnapshotOptions, type SetupContext, type SetupFunction, type ShallowUnwrapRef, StoreManager, SubscriptionCallback, ToRefs, type TriggerEventOptions, type VNode, type VNodeProps, WatchOptions, WatchStopHandle, WevuDefaults, type WevuPlugin, WritableComputedOptions, WritableComputedRef, addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, defineComponent, defineEmits, defineExpose, defineModel, defineOptions, defineProps, defineSlots, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, normalizeClass, normalizeStyle, onActivated, onAddToFavorites, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMounted, onMoved, onPageNotFound, onPageScroll, onPullDownRefresh, onReachBottom, onReady, onResize, onRouteDone, onSaveExitState, onScopeDispose, onServerPrefetch, onShareAppMessage, onShareTimeline, onShow, onTabItemTap, onThemeChange, onUnhandledRejection, onUnload, onUnmounted, onUpdated, prelinkReactiveTree, provide, provideGlobal, reactive, readonly, ref, registerApp, registerComponent, removeMutationRecorder, resetWevuDefaults, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setWevuDefaults, shallowReactive, shallowRef, startBatch, stop, storeToRefs, teardownRuntimeInstance, toRaw, toRef, toRefs, touchReactive, traverse, triggerRef, unref, useAttrs, useBindModel, useModel, useSlots, watch, watchEffect, withDefaults };