wevu 6.12.3 → 6.13.0

package/dist/index-B7QVA9YG.d.mts

@@ -0,0 +1,1009 @@
+import { t as WeappIntrinsicElements } from "./weappIntrinsicElements-BogJZUKk.mjs";
+import { A as ComputedDefinitions, D as MiniProgramPageLifetimes, F as ModelBindingOptions, I as ModelBindingPayload, N as MethodDefinitions, P as ModelBinding, Qt as ShallowRef, T as MiniProgramComponentRawOptions, Zt as Ref, _ as RuntimeApp, c as ShallowUnwrapRef, cn as SetupContextRouter, d as SetupContext, f as SetupContextNativeInstance, fn as ComponentPropsOptions, h as InternalRuntimeState, k as ComponentPublicInstance, p as SetupFunction, v as RuntimeInstance, w as MiniProgramComponentOptions, x as MiniProgramAppOptions, y as WevuPlugin, yn as InferProps } from "./vue-types-D8BVm-8u.mjs";
+//#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';
+  /**
+   * 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;
+}
+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
+type DataOption<D extends object> = D | (() => D);
+interface DefineComponentOptions<P extends ComponentPropsOptions = ComponentPropsOptions, D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions, S extends Record<string, any> | void = Record<string, any> | void> extends MiniProgramComponentOptions, MiniProgramPageLifetimes {
+  /**
+   * 页面特性开关（用于按需注入 Page 事件处理函数）。
+   *
+   * 说明：小程序的部分页面事件/菜单项具有“按需派发/按需展示”特性，
+   * 只有定义了对应的 `onXXX` 方法才会触发/展示（如 `onPageScroll`、`onShareTimeline`）。
+   * 因此 wevu 需要在注册阶段（Component()）就决定是否注入这些 onXXX。
+   *
+   * - 若你在 options 中显式定义了原生 `onXXX`，wevu 会自动桥接对应 hook（无需 features）。
+   * - 若你只想在 `setup()` 里使用 wevu hook（不额外写原生 `onXXX`），则通过 `features` 显式开启注入。
+   */
+  features?: PageFeatures;
+  /**
+   * 类 Vue 的 props 定义（会被规范化为小程序 `properties`）
+   */
+  props?: P;
+  watch?: Record<string, any>;
+  setup?: SetupFunction<P, D, C, M, S>;
+  /**
+   * setup 执行时机：
+   * - created：与旧行为一致（默认 defer setData 到 attached）
+   * - attached：更接近 Vue 3（props 在 attached 时已就绪）
+   *
+   * @default 'attached'
+   */
+  setupLifecycle?: 'created' | 'attached';
+  /**
+   * 组件 data（建议使用函数返回初始值）。
+   */
+  data?: DataOption<D>;
+  /**
+   * 组件 computed（会参与快照 diff）。
+   */
+  computed?: C;
+  /**
+   * setData 快照控制选项（用于优化性能与 payload）。
+   */
+  setData?: SetDataSnapshotOptions;
+  /**
+   * 组件 methods（会绑定到 public instance 上）。
+   */
+  methods?: M;
+  /**
+   * 透传/扩展字段：允许携带其他小程序原生 Component 选项或自定义字段。
+   * 说明：为保持兼容性保留索引签名，但仍会对已知字段提供智能提示。
+   */
+  [key: string]: any;
+}
+type AppSetupProps = {};
+interface DefineAppOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions> extends MiniProgramAppOptions {
+  watch?: Record<string, any>;
+  setup?: (props: AppSetupProps, ctx: SetupContext<D, C, M, AppSetupProps>) => Record<string, any> | void;
+  [key: string]: any;
+}
+interface CreateAppOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions> extends MiniProgramAppOptions {
+  data?: DataOption<D>;
+  computed?: C;
+  methods?: M;
+  setData?: SetDataSnapshotOptions;
+  watch?: Record<string, any>;
+  setup?: (props: AppSetupProps, ctx: SetupContext<D, C, M, AppSetupProps>) => Record<string, any> | void;
+  [key: string]: any;
+}
+interface PageFeatures {
+  /**
+   * 启用页面滚动事件（注入 `onPageScroll`）。
+   */
+  enableOnPageScroll?: boolean;
+  /**
+   * 启用下拉刷新事件（注入 `onPullDownRefresh`；仍需在页面配置开启 enablePullDownRefresh）。
+   */
+  enableOnPullDownRefresh?: boolean;
+  /**
+   * 启用触底事件（注入 `onReachBottom`）。
+   */
+  enableOnReachBottom?: boolean;
+  /**
+   * 启用路由动画完成事件（注入 `onRouteDone`）。
+   */
+  enableOnRouteDone?: boolean;
+  /**
+   * 启用 onReady 阶段的 routeDone 兜底补发。
+   *
+   * 默认关闭：保持与微信小程序平台事件更一致的行为。
+   * 仅当个别 IDE/基础库未派发 routeDone 且业务确实依赖该时机时再开启。
+   */
+  enableOnRouteDoneFallback?: boolean;
+  /**
+   * 启用 Tab 点击事件（注入 `onTabItemTap`）。
+   */
+  enableOnTabItemTap?: boolean;
+  /**
+   * 启用窗口尺寸变化事件（注入 `onResize`）。
+   */
+  enableOnResize?: boolean;
+  /**
+   * 启用“转发/分享给朋友”（注入 `onShareAppMessage`，使右上角菜单显示“转发”）。
+   */
+  enableOnShareAppMessage?: boolean;
+  /**
+   * 启用“分享到朋友圈”（注入 `onShareTimeline`，使右上角菜单显示“分享到朋友圈”）。
+   */
+  enableOnShareTimeline?: boolean;
+  /**
+   * 启用“收藏”（注入 `onAddToFavorites`）。
+   */
+  enableOnAddToFavorites?: boolean;
+  /**
+   * 启用“退出状态保存”（注入 `onSaveExitState`）。
+   */
+  enableOnSaveExitState?: boolean;
+}
+//#endregion
+//#region src/runtime/types.d.ts
+interface WevuGlobalComponents {}
+interface WevuGlobalDirectives {}
+interface GlobalComponents extends WevuGlobalComponents {}
+interface GlobalDirectives extends WevuGlobalDirectives {}
+interface TemplateRefs {}
+type NodesRefFields = Parameters<WechatMiniprogram.NodesRef['fields']>[0];
+interface TemplateRefValue {
+  selector: string;
+  boundingClientRect: (cb?: (value: WechatMiniprogram.BoundingClientRectCallbackResult | null) => void) => Promise<WechatMiniprogram.BoundingClientRectCallbackResult | null>;
+  scrollOffset: (cb?: (value: WechatMiniprogram.ScrollOffsetCallbackResult | null) => void) => Promise<WechatMiniprogram.ScrollOffsetCallbackResult | null>;
+  fields: (fields: NodesRefFields, cb?: (value: any) => void) => Promise<any | null>;
+  node: (cb?: (value: any) => void) => Promise<any | null>;
+}
+//#endregion
+//#region src/runtime/templateRefTypes.d.ts
+type WeappTemplateRefElements = { [K in keyof WeappIntrinsicElements]: TemplateRefValue };
+declare global {
+  interface HTMLElementTagNameMap extends WeappTemplateRefElements {}
+}
+//#endregion
+//#region src/vue-augment.d.ts
+declare module '@vue/runtime-core' {
+  interface GlobalComponents extends WevuGlobalComponents {}
+  interface GlobalDirectives extends WevuGlobalDirectives {}
+}
+//#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
+//#region src/runtime/defaults.d.ts
+interface WevuDefaults {
+  app?: Partial<CreateAppOptions<any, any, any>>;
+  component?: Partial<DefineComponentOptions<any, any, any, any>>;
+}
+declare function setWevuDefaults(next: WevuDefaults): void;
+declare function resetWevuDefaults(): void;
+//#endregion
+//#region src/runtime/register/inline.d.ts
+interface InlineExpressionEntry {
+  keys: string[];
+  indexKeys?: string[];
+  scopeResolvers?: Array<InlineExpressionScopeResolver | ((ctx: any, scope: Record<string, any>, event: any) => any) | undefined>;
+  fn: (ctx: any, scope: Record<string, any>, event: any) => any;
+}
+interface InlineExpressionScopeResolver {
+  type: 'for-item';
+  path: string;
+  indexKey: string;
+}
+type InlineExpressionMap = Record<string, InlineExpressionEntry>;
+//#endregion
+//#region src/runtime/define.d.ts
+/**
+ * defineComponent 返回的组件定义描述，用于手动注册或高级用法。
+ */
+interface ComponentDefinition<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> {
+  /**
+   * 内部 runtime app（高级能力使用），不对外暴露正式 API。
+   * @internal
+   */
+  __wevu_runtime: RuntimeApp<D, C, M>;
+  /**
+   * 内部选项快照（高级能力使用），包含 data/computed/methods 等。
+   * @internal
+   */
+  __wevu_options: {
+    data: () => D;
+    computed: C;
+    methods: M;
+    setData: SetDataSnapshotOptions | undefined;
+    watch: Record<string, any> | undefined;
+    setup: ((props: any, ctx: any) => any) | undefined;
+    mpOptions: MiniProgramComponentRawOptions;
+  };
+}
+type SetupBindings<S> = Exclude<S, void> extends never ? Record<string, never> : Exclude<S, void>;
+type ResolveProps<P> = P extends ComponentPropsOptions ? InferProps<P> : P;
+interface WevuComponentConstructor<Props, RawBindings, D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> {
+  new (): ComponentPublicInstance<D, C, M, Props> & ShallowUnwrapRef<RawBindings>;
+}
+interface SetupContextWithTypeProps<TypeProps> {
+  props: TypeProps;
+  [key: string]: any;
+}
+type SetupFunctionWithTypeProps<TypeProps> = (props: TypeProps, ctx: SetupContextWithTypeProps<TypeProps>) => Record<string, any> | void;
+interface DefineComponentTypePropsOptions<TypeProps> {
+  __typeProps: TypeProps;
+  setup?: SetupFunctionWithTypeProps<TypeProps>;
+  [key: string]: any;
+}
+interface DefineComponentWithTypeProps<TypeProps> {
+  new (): {
+    $props: TypeProps;
+  } & Record<string, any>;
+}
+/**
+ * 按 Vue 3 风格定义一个小程序组件/页面。
+ *
+ * - 统一注册为 `Component()`
+ *
+ * @param options 组件定义项
+ * @returns 可手动注册的组件定义
+ *
+ * @example
+ * ```ts
+ * defineComponent({
+ *   data: () => ({ count: 0 }),
+ *   setup() {
+ *     onMounted(() => console.log('已挂载'))
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * defineComponent({
+ *   setup() {
+ *     onPageScroll(() => {})
+ *   }
+ * })
+ * ```
+ */
+declare function defineComponent<TypeProps = any>(options: DefineComponentTypePropsOptions<TypeProps>): DefineComponentWithTypeProps<TypeProps>;
+declare function defineComponent<P extends ComponentPropsOptions = ComponentPropsOptions, D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions, S extends Record<string, any> | void = Record<string, any> | void>(options: DefineComponentOptions<P, D, C, M, S>): WevuComponentConstructor<ResolveProps<P>, SetupBindings<S>, D, C, M>;
+/**
+ * 从 Vue SFC 选项创建 wevu 组件，供 weapp-vite 编译产物直接调用的兼容入口。
+ *
+ * @param options 组件选项，可能包含小程序特有的 properties
+ * @internal
+ */
+declare function createWevuComponent<P extends ComponentPropsOptions = ComponentPropsOptions, D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions>(options: DefineComponentOptions<P, D, C, M> & {
+  properties?: WechatMiniprogram.Component.PropertyOption;
+}): void;
+/**
+ * scoped slot 兼容组件入口（编译产物内部使用）。
+ * @internal
+ */
+declare function createWevuScopedSlotComponent(overrides?: {
+  computed?: ComputedDefinitions;
+  inlineMap?: InlineExpressionMap;
+}): void;
+//#endregion
+//#region src/runtime/disposables.d.ts
+type DisposableMethodName = 'dispose' | 'abort' | 'cancel' | 'stop' | 'disconnect' | 'destroy' | 'close';
+type DisposableObject = Partial<Record<DisposableMethodName, () => void>>;
+type DisposableLike = (() => void) | DisposableObject;
+interface DisposableBag {
+  /**
+   * 注册一个清理项，返回“取消注册”函数（不会立即执行清理）。
+   */
+  add: (target: DisposableLike | null | undefined) => () => void;
+  /**
+   * 立即执行并清空当前 bag 中的全部清理项（幂等）。
+   */
+  dispose: () => void;
+  /**
+   * 注册 timeout，并在 bag dispose 时自动 clearTimeout。
+   */
+  setTimeout: (handler: (...args: any[]) => void, timeout?: number, ...args: any[]) => ReturnType<typeof setTimeout>;
+  /**
+   * 注册 interval，并在 bag dispose 时自动 clearInterval。
+   */
+  setInterval: (handler: (...args: any[]) => void, timeout?: number, ...args: any[]) => ReturnType<typeof setInterval>;
+}
+/**
+ * 在 setup() 中创建一个“清理袋”，统一管理副作用释放。
+ *
+ * 典型用法：注册定时器、请求任务、事件监听退订函数，
+ * 在页面/组件卸载时自动批量清理，减少内存泄漏风险。
+ */
+declare function useDisposables(): DisposableBag;
+//#endregion
+//#region src/runtime/hooks/base.d.ts
+declare function getCurrentInstance<T extends InternalRuntimeState = InternalRuntimeState>(): T | undefined;
+/**
+ * 设置当前运行时实例（框架内部使用）。
+ * @internal
+ */
+declare function setCurrentInstance(inst: InternalRuntimeState | undefined): void;
+declare function getCurrentSetupContext<T = any>(): T | undefined;
+/**
+ * 设置当前 setup 上下文（框架内部使用）。
+ * @internal
+ */
+declare function setCurrentSetupContext(ctx: any | undefined): void;
+/**
+ * 调用批量 hook（框架内部调度入口）。
+ * @internal
+ */
+declare function callHookList(target: InternalRuntimeState, name: string, args?: any[]): void;
+/**
+ * 调用返回值型 hook（框架内部调度入口）。
+ * @internal
+ */
+declare function callHookReturn(target: InternalRuntimeState, name: string, args?: any[]): any;
+//#endregion
+//#region src/runtime/hooks/register.d.ts
+declare function onLaunch(handler: (options: WechatMiniprogram.App.LaunchShowOption) => void): void;
+declare function onPageNotFound(handler: (options: WechatMiniprogram.App.PageNotFoundOption) => void): void;
+declare function onUnhandledRejection(handler: WechatMiniprogram.OnUnhandledRejectionCallback): void;
+declare function onThemeChange(handler: WechatMiniprogram.OnThemeChangeCallback): void;
+declare function onMemoryWarning(handler: WechatMiniprogram.OnMemoryWarningCallback): void;
+declare function onShow(handler: () => void): void;
+declare function onShow(handler: (options: WechatMiniprogram.App.LaunchShowOption) => void): void;
+declare function onLoad(handler: WechatMiniprogram.Page.ILifetime['onLoad']): void;
+declare function onHide(handler: () => void): void;
+declare function onUnload(handler: () => void): void;
+declare function onReady(handler: () => void): void;
+declare function onPullDownRefresh(handler: WechatMiniprogram.Page.ILifetime['onPullDownRefresh']): void;
+declare function onReachBottom(handler: WechatMiniprogram.Page.ILifetime['onReachBottom']): void;
+declare function onPageScroll(handler: (opt: WechatMiniprogram.Page.IPageScrollOption) => void): void;
+declare function onRouteDone(handler: WechatMiniprogram.Page.ILifetime['onRouteDone'] | ((opt?: unknown) => void)): void;
+declare function onTabItemTap(handler: (opt: WechatMiniprogram.Page.ITabItemTapOption) => void): void;
+declare function onResize(handler: (opt: WechatMiniprogram.Page.IResizeOption) => void): void;
+declare function onMoved(handler: () => void): void;
+declare function onAttached(handler: () => void): void;
+declare function onDetached(handler: () => void): void;
+declare function onError(handler: (err: any) => void): void;
+declare function onSaveExitState(handler: () => WechatMiniprogram.Page.ISaveExitState): void;
+declare function onShareAppMessage(handler: WechatMiniprogram.Page.ILifetime['onShareAppMessage']): void;
+declare function onShareTimeline(handler: WechatMiniprogram.Page.ILifetime['onShareTimeline']): void;
+declare function onAddToFavorites(handler: WechatMiniprogram.Page.ILifetime['onAddToFavorites']): void;
+//#endregion
+//#region src/runtime/hooks/vue.d.ts
+/**
+ * Vue 3 对齐：组件/页面已挂载，映射小程序 onReady
+ */
+declare function onMounted(handler: () => void): void;
+/**
+ * Vue 3 对齐：组件/页面更新后触发。
+ * 小程序没有专用 update 生命周期，这里在每次 setData 完成后调用。
+ */
+declare function onUpdated(handler: () => void): void;
+/**
+ * Vue 3 对齐：卸载前触发。
+ * 小程序无 before-unload 生命周期，setup 时同步执行以保持语义。
+ */
+declare function onBeforeUnmount(handler: () => void): void;
+/**
+ * Vue 3 对齐：组件/页面卸载；映射到页面 onUnload 或组件 detached
+ */
+declare function onUnmounted(handler: () => void): void;
+/**
+ * Vue 3 对齐：挂载前；setup 时同步触发以模拟 beforeMount 语义
+ */
+declare function onBeforeMount(handler: () => void): void;
+/**
+ * Vue 3 对齐：更新前；在每次 setData 前触发
+ */
+declare function onBeforeUpdate(handler: () => void): void;
+/**
+ * Vue 3 对齐：错误捕获；映射到小程序 onError
+ */
+declare function onErrorCaptured(handler: (err: any, instance: any, info: string) => void): void;
+/**
+ * Vue 3 对齐：组件激活；映射到小程序 onShow
+ */
+declare function onActivated(handler: () => void): void;
+/**
+ * Vue 3 对齐：组件失活；映射到小程序 onHide
+ */
+declare function onDeactivated(handler: () => void): void;
+/**
+ * Vue 3 对齐：服务端渲染前置钩子。
+ * 小程序无此场景，保留空实现以保持 API 兼容。
+ */
+declare function onServerPrefetch(_handler: () => void): void;
+/**
+ * 派发更新阶段钩子（框架内部调度入口）。
+ * @internal
+ */
+declare function callUpdateHooks(target: InternalRuntimeState, phase: 'before' | 'after'): void;
+//#endregion
+//#region src/runtime/intersectionObserver.d.ts
+type UseIntersectionObserverOptions = WechatMiniprogram.CreateIntersectionObserverOption;
+type UseIntersectionObserverResult = WechatMiniprogram.IntersectionObserver;
+/**
+ * 在 setup 中创建 IntersectionObserver，并在卸载时自动断开。
+ *
+ * - 优先使用 `ctx.instance.createIntersectionObserver(options)`。
+ * - 不可用时回退到 `wx.createIntersectionObserver(instance, options)`。
+ */
+declare function useIntersectionObserver(options?: UseIntersectionObserverOptions): UseIntersectionObserverResult;
+//#endregion
+//#region src/runtime/layoutBridge.d.ts
+type LayoutBridgeContext = Record<string, any>;
+type LayoutBridgeComponentResolver = (selector: string) => any;
+type LayoutHostMap = Record<string, unknown>;
+interface LayoutHostBinding {
+  key: string;
+  refName?: string;
+  selector: string;
+  kind?: 'component';
+}
+interface LayoutHostResolveOptions<T = any> {
+  context?: T;
+  fallbackContext?: T;
+  interval?: number;
+  retries?: number;
+}
+/**
+ * 为当前页面注册 layout bridge，使页面或子组件可消费 layout 内部能力。
+ */
+declare function registerPageLayoutBridge(selectors: string | string[], context?: LayoutBridgeContext): boolean;
+/**
+ * 移除当前页面的 layout bridge 注册。
+ */
+declare function unregisterPageLayoutBridge(selectors: string | string[], context?: LayoutBridgeContext): boolean;
+/**
+ * 解析当前页面已注册的 layout bridge，找不到时回退到传入上下文。
+ */
+declare function resolveLayoutBridge<T = any>(selector: string, fallbackContext?: T): T | undefined;
+/**
+ * 解析当前页面 layout 内通过指定 key 暴露的宿主实例。
+ */
+declare function resolveLayoutHost<T = any, C = any>(key: string, options?: LayoutHostResolveOptions<C>): T | null;
+/**
+ * 等待当前页面 layout 宿主实例可用，适合页面初次进入时的异步宿主解析。
+ */
+declare function waitForLayoutHost<T = any, C = any>(key: string, options?: LayoutHostResolveOptions<C>): Promise<T | null>;
+/**
+ * 在 layout 生命周期内暴露 bridge，使页面或子组件可访问 layout 内部实例。
+ */
+declare function useLayoutBridge(selectors: string | string[], options?: {
+  resolveComponent?: LayoutBridgeComponentResolver;
+}): void;
+/**
+ * 使用编译期注入的宿主绑定信息，直接从当前 layout 运行时实例解析子组件宿主并注册 bridge。
+ */
+declare function registerRuntimeLayoutHosts(bindings: LayoutHostBinding[], context?: LayoutBridgeContext): any;
+/**
+ * 移除运行时自动注册的 layout 宿主 bridge。
+ */
+declare function unregisterRuntimeLayoutHosts(bindings: LayoutHostBinding[], context?: LayoutBridgeContext): boolean;
+/**
+ * 使用 key -> 宿主实例的映射批量暴露 layout 内部宿主，适合 toast/dialog 等共享反馈节点。
+ */
+declare function useLayoutHosts(hosts: LayoutHostMap): void;
+//#endregion
+//#region src/runtime/noSetData.d.ts
+declare function markNoSetData<T extends object>(value: T): T;
+declare function isNoSetData(value: unknown): boolean;
+//#endregion
+//#region src/runtime/pageLayout.d.ts
+interface WevuPageLayoutMap {}
+type ResolveTypedPageLayoutName = keyof WevuPageLayoutMap extends never ? string : Extract<keyof WevuPageLayoutMap, string>;
+type ResolveTypedPageLayoutProps<Name extends string> = Name extends keyof WevuPageLayoutMap ? WevuPageLayoutMap[Name] : Record<string, any>;
+type PageLayoutNamedState = { [Name in ResolveTypedPageLayoutName]: {
+  name: Name;
+  props: ResolveTypedPageLayoutProps<Name>;
+} }[ResolveTypedPageLayoutName];
+type PageLayoutState = PageLayoutNamedState | {
+  name: false;
+  props: Record<string, any>;
+} | {
+  name: undefined;
+  props: Record<string, any>;
+};
+/**
+ * 获取当前页面 layout 状态。
+ */
+declare function usePageLayout(): Readonly<PageLayoutState>;
+declare function syncRuntimePageLayoutState(target: Record<string, any>, layout: string | false, props: Record<string, any>): void;
+declare function syncRuntimePageLayoutStateFromRuntime(target: Record<string, any>): void;
+declare function setPageLayout(layout: false): void;
+declare function setPageLayout<Name extends ResolveTypedPageLayoutName>(layout: Name, props?: ResolveTypedPageLayoutProps<Name>): void;
+declare function resolveRuntimePageLayoutName(layout: string | false): string;
+//#endregion
+//#region src/runtime/pageScroll.d.ts
+interface UsePageScrollThrottleOptions {
+  /**
+   * 节流间隔（毫秒），默认 80ms。
+   */
+  interval?: number;
+  /**
+   * 是否在窗口起始边缘立即触发，默认 true。
+   */
+  leading?: boolean;
+  /**
+   * 是否在窗口结束边缘补一次回调，默认 true。
+   */
+  trailing?: boolean;
+  /**
+   * 持续滚动时的最大等待时间（毫秒）。
+   * 当 trailing 为 false 时，可用于兜底触发一次回调。
+   */
+  maxWait?: number;
+}
+type UsePageScrollThrottleStopHandle = () => void;
+/**
+ * 在 setup 中注册节流后的 onPageScroll 监听，并在卸载时自动清理。
+ */
+declare function usePageScrollThrottle(handler: (opt: WechatMiniprogram.Page.IPageScrollOption) => void, options?: UsePageScrollThrottleOptions): UsePageScrollThrottleStopHandle;
+//#endregion
+//#region src/runtime/provide.d.ts
+/**
+ * 写入全局 provide 存储，供运行时内部与兼容层复用。
+ */
+declare function setGlobalProvidedValue<T>(key: any, value: T): void;
+/**
+ * 判断当前是否存在可用的注入上下文。
+ *
+ * wevu 目前的依赖注入上下文来自同步 `setup()` 阶段的当前实例；
+ * 若未来补充 app 级 provider，这里可继续扩展判断来源。
+ */
+declare function hasInjectionContext(): boolean;
+/**
+ * 在组件上下文中向后代注入值（与 Vue 3 行为兼容），若没有当前实例则回落到全局存储。
+ *
+ * @param key 注入键，可为字符串、Symbol 或对象
+ * @param value 提供的值
+ *
+ * @example
+ * ```ts
+ * defineComponent({
+ *   setup() {
+ *     provide(TOKEN_KEY, { data: 'value' })
+ *   }
+ * })
+ * ```
+ */
+declare function provide<T>(key: any, value: T): void;
+/**
+ * 从祖先组件（或全局存储）读取提供的值。
+ *
+ * @param key 注入键，需与 provide 使用的键保持一致
+ * @param defaultValue 未找到提供者时的默认值
+ * @returns 匹配到的值或默认值
+ *
+ * @example
+ * ```ts
+ * defineComponent({
+ *   setup() {
+ *     const data = inject(TOKEN_KEY)
+ *     const value = inject('key', 'default')
+ *   }
+ * })
+ * ```
+ */
+declare function inject<T>(key: any, defaultValue?: T): T;
+/**
+ * 全局注入值，适用于历史兼容场景。
+ *
+ * @deprecated 已弃用，仅用于兼容/过渡。推荐优先使用 `provide()`，
+ * 在无实例上下文时 `provide()` 会自动回落到全局存储。
+ */
+declare function provideGlobal<T>(key: any, value: T): void;
+/**
+ * 从全局存储读取值，适用于历史兼容场景。
+ *
+ * @deprecated 已弃用，仅用于兼容/过渡。推荐优先使用 `inject()`，
+ * 在无实例上下文时 `inject()` 会自动从全局存储读取。
+ */
+declare function injectGlobal<T>(key: any, defaultValue?: T): T;
+//#endregion
+//#region src/runtime/register/watch.d.ts
+type WatchHandler = (this: any, value: any, oldValue: any) => void;
+type WatchDescriptor = WatchHandler | string | {
+  handler: WatchHandler | string;
+  immediate?: boolean;
+  deep?: boolean;
+};
+type WatchMap = Record<string, WatchDescriptor>;
+//#endregion
+//#region src/runtime/register/app.d.ts
+/**
+ * 注册 App 入口（框架内部使用）。
+ * @internal
+ */
+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
+/**
+ * 注册组件入口（框架内部使用）。
+ * @internal
+ */
+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<D extends object, C extends ComputedDefinitions, M extends MethodDefinitions> = DefineComponentOptions<ComponentPropsOptions, D, C, M>['setup'] | DefineAppOptions<D, C, M>['setup'];
+/**
+ * 挂载运行时实例（框架内部注册流程使用）。
+ * @internal
+ */
+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?: {
+  deferSetData?: boolean;
+}): RuntimeInstance<D, C, M>;
+declare function setRuntimeSetDataVisibility(target: InternalRuntimeState, visible: boolean): void;
+/**
+ * 卸载运行时实例（框架内部注册流程使用）。
+ * @internal
+ */
+declare function teardownRuntimeInstance(target: InternalRuntimeState): void;
+//#endregion
+//#region src/runtime/register/setup.d.ts
+type SetupRunner = {
+  bivarianceHack: (props: Record<string, any>, ctx: any) => any;
+}['bivarianceHack'];
+/**
+ * 执行 setup 函数并注入运行时上下文（框架内部使用）。
+ * @internal
+ */
+declare function runSetupFunction(setup: SetupRunner | undefined, props: Record<string, any>, context: any): unknown;
+//#endregion
+//#region src/runtime/template.d.ts
+declare function normalizeStyle(value: any): string;
+declare function normalizeClass(value: any): string;
+//#endregion
+//#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
+//#region src/runtime/use.d.ts
+/**
+ * 在 `app` 级 `setup()` 中安装插件，提供与 `app.use()` 对齐的 SFC 调用方式。
+ */
+declare function use(plugin: WevuPlugin, ...options: any[]): RuntimeApp<any, any, any>;
+//#endregion
+//#region src/runtime/vueCompat/context.d.ts
+declare function useAttrs(): Record<string, any>;
+declare function useSlots(): Record<string, any>;
+declare function useNativeInstance(): SetupContextNativeInstance;
+//#endregion
+//#region src/runtime/vueCompat/model.d.ts
+type ModelModifiers<M extends PropertyKey = string> = Record<M, true | undefined>;
+type ModelRef$1<T, M extends PropertyKey = string, G = T, S = T> = Ref<G, S> & [ModelRef$1<T, M, G, S>, ModelModifiers<M>];
+interface UseModelOptions<T, M extends PropertyKey = string, G = T, S = T> {
+  get?: (value: T, modifiers: ModelModifiers<M>) => G;
+  set?: (value: S, modifiers: ModelModifiers<M>) => T;
+}
+declare function useModel<T = any, M extends PropertyKey = string>(props: Record<string, any>, name: string): ModelRef$1<T, M, T, T>;
+declare function useModel<T = any, M extends PropertyKey = string, G = T, S = T>(props: Record<string, any>, name: string, options: UseModelOptions<T, M, G, S>): ModelRef$1<T, M, G, S>;
+/**
+ * useBindModel 返回绑定到当前运行时实例的 bindModel。
+ * 该方法必须在 setup() 的同步阶段调用。
+ */
+type BindModelWithHelper<DefaultEvent extends string = 'input', DefaultValueProp extends string = 'value'> = (<T = any>(path: string, options?: ModelBindingOptions<T>) => ModelBinding<T>) & {
+  model: <T = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T>(path: string, options?: ModelBindingOptions<T, Event, ValueProp, Formatted>) => ModelBindingPayload<T, Event, ValueProp, Formatted>;
+  value: <T = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T>(path: string, options?: ModelBindingOptions<T, Event, ValueProp, Formatted>) => Formatted;
+  on: <T = any, Event extends string = DefaultEvent, ValueProp extends string = DefaultValueProp, Formatted = T>(path: string, options?: ModelBindingOptions<T, 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>(a: T, b: T): T;
+//#endregion
+//#region src/runtime/vueCompat/router.d.ts
+type RuntimeRouter = SetupContextRouter;
+/**
+ * 在 setup 中获取与当前组件路径语义一致的原生 Router 对象。
+ *
+ * - 优先使用实例上的 `this.router`（组件路径语义）。
+ * - 不可用时回退到 `this.pageRouter`。
+ * - 低版本基础库再回退到全局 `wx.*` 路由方法。
+ *
+ * 如需更贴近 Vue Router 的高阶能力（导航守卫、失败类型、统一解析），
+ * 推荐改用 `wevu/router` 子入口的 `useRouter()`。
+ */
+declare function useNativeRouter(): RuntimeRouter;
+/**
+ * 在 setup 中获取与当前页面路径语义一致的原生 Router 对象。
+ *
+ * - 优先使用实例上的 `this.pageRouter`（页面路径语义）。
+ * - 不可用时回退到 `this.router`。
+ * - 低版本基础库再回退到全局 `wx.*` 路由方法。
+ *
+ * 如需更贴近 Vue Router 的高阶能力（导航守卫、失败类型、统一解析），
+ * 推荐改用 `wevu/router` 子入口的 `useRouter()`。
+ */
+declare function useNativePageRouter(): RuntimeRouter;
+//#endregion
+//#region src/runtime/vueCompat/templateRef.d.ts
+type TemplateRef<T = unknown> = Readonly<ShallowRef<T | null>>;
+declare function useTemplateRef<K extends keyof TemplateRefs>(name: K): TemplateRef<TemplateRefs[K]>;
+declare function useTemplateRef<T = unknown>(name: string): TemplateRef<T>;
+//#endregion
+//#region src/macros/shared.d.ts
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
+type ComponentObjectPropsOptions = ComponentPropsOptions;
+type ExtractPropTypes<P extends ComponentObjectPropsOptions> = InferProps<P>;
+type DefineProps<T, BKeys extends keyof T> = Readonly<T> & { readonly [K in BKeys]-?: boolean };
+type BooleanKey<T, K extends keyof T = keyof T> = K extends any ? T[K] extends boolean | undefined ? T[K] extends never | undefined ? never : K : never : never;
+type DefinePropsFromArray<PropNames extends string = string> = Prettify<Readonly<{ [key in PropNames]?: any }>>;
+type DefinePropsFromOptions<PP extends ComponentObjectPropsOptions = ComponentObjectPropsOptions> = Prettify<Readonly<ExtractPropTypes<PP>>>;
+type NotUndefined<T> = T extends undefined ? never : T;
+type MappedOmit<T, K extends keyof any> = { [P in keyof T as P extends K ? never : P]: T[P] };
+type InferDefaults<T> = { [K in keyof T]?: InferDefault<T, T[K]> };
+type NativeType = null | undefined | number | string | boolean | symbol | ((...args: any[]) => any);
+type InferDefault<P, T> = ((props: P) => T & {}) | (T extends NativeType ? T : never);
+type PropsWithDefaults<T, Defaults extends InferDefaults<T>, BKeys extends keyof T> = T extends unknown ? Readonly<MappedOmit<T, keyof Defaults>> & { readonly [K in keyof Defaults as K extends keyof T ? K : never]-?: K extends keyof T ? Defaults[K] extends undefined ? IfAny<Defaults[K], NotUndefined<T[K]>, T[K]> : NotUndefined<T[K]> : never } & { readonly [K in BKeys]-?: K extends keyof Defaults ? Defaults[K] extends undefined ? boolean | undefined : boolean : boolean } : never;
+type UnionToIntersection<U> = (U extends any ? (arg: U) => any : never) extends ((arg: infer I) => any) ? I : never;
+type ObjectEmitsOptions = Record<string, ((...args: any[]) => any) | null>;
+type EmitsOptions = ObjectEmitsOptions | string[];
+type EmitFn<Options = ObjectEmitsOptions, Event extends keyof Options = keyof Options> = Options extends Array<infer V> ? (event: V, ...args: any[]) => void : {} extends Options ? (event: string, ...args: any[]) => void : UnionToIntersection<{ [K in Event]: Options[K] extends ((...args: infer Args) => any) ? (event: K, ...args: Args) => void : Options[K] extends any[] ? (event: K, ...args: Options[K]) => void : (event: K, ...args: any[]) => void }[Event]>;
+type ComponentTypeEmits = ((...args: any[]) => any) | Record<string, any>;
+type RecordToUnion<T extends Record<string, any>> = T[keyof T];
+type ShortEmits<T extends Record<string, any>> = UnionToIntersection<RecordToUnion<{ [K in keyof T]: (evt: K, ...args: T[K]) => void }>>;
+type ScriptSetupNativePropertyOption = WechatMiniprogram.Component.PropertyOption;
+type ScriptSetupNativeMethodOption = WechatMiniprogram.Component.MethodOption;
+type ScriptSetupNativeBehaviorOption = WechatMiniprogram.Component.IEmptyArray;
+type ScriptSetupNativeInstance<D extends object, P extends ScriptSetupNativePropertyOption, M extends ScriptSetupNativeMethodOption> = WechatMiniprogram.Component.Instance<D, P, M, ScriptSetupNativeBehaviorOption>;
+type ScriptSetupObservedProperty<TProperty extends WechatMiniprogram.Component.AllFullProperty, TInstance> = Omit<TProperty, 'observer'> & {
+  observer?: string | ((this: TInstance, newVal: WechatMiniprogram.Component.PropertyToData<TProperty>, oldVal: WechatMiniprogram.Component.PropertyToData<TProperty>, changedPath: Array<string | number>) => void);
+};
+type ScriptSetupPropertyObserver<TProperty extends WechatMiniprogram.Component.AllProperty, TInstance> = TProperty extends infer TCurrent extends WechatMiniprogram.Component.AllFullProperty ? ScriptSetupObservedProperty<TCurrent, TInstance> : TProperty;
+type ScriptSetupNativeProperties<D extends object, P extends ScriptSetupNativePropertyOption, M extends ScriptSetupNativeMethodOption> = { [K in keyof P]: ScriptSetupPropertyObserver<P[K], ScriptSetupNativeInstance<D, P, M>> };
+type ScriptSetupNativeMethods<D extends object, P extends ScriptSetupNativePropertyOption, M extends ScriptSetupNativeMethodOption> = M & ThisType<ScriptSetupNativeInstance<D, P, M>>;
+type ScriptSetupDefineOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions, P extends ScriptSetupNativePropertyOption = ScriptSetupNativePropertyOption> = Omit<DefineComponentOptions<ComponentPropsOptions, D, C, M>, 'props' | 'options' | 'data' | 'methods'> & {
+  /**
+   * props 必须通过 defineProps() 声明。
+   */
+  props?: never;
+  /**
+   * emits 必须通过 defineEmits() 声明。
+   */
+  emits?: never;
+  /**
+   * expose 必须通过 defineExpose() 声明。
+   */
+  expose?: never;
+  /**
+   * slots 必须通过 defineSlots() 声明。
+   */
+  slots?: never;
+  /**
+   * 小程序 Component 选项（multipleSlots/styleIsolation 等）。
+   */
+  options?: WechatMiniprogram.Component.ComponentOptions;
+  /**
+   * 小程序原生 properties。
+   */
+  properties?: ScriptSetupNativeProperties<D, P, M>;
+  /**
+   * 小程序原生 data。
+   */
+  data?: D | (() => D);
+  /**
+   * 小程序原生 methods。
+   */
+  methods?: ScriptSetupNativeMethods<D, P, M>;
+  /**
+   * setup 执行时机（默认 attached）。
+   */
+  setupLifecycle?: 'created' | 'attached';
+};
+//#endregion
+//#region src/macros.d.ts
+/**
+ * defineProps 声明（类型层宏）。
+ */
+declare function defineProps<PropNames extends string = string>(props: PropNames[]): DefinePropsFromArray<PropNames>;
+declare function defineProps<PP extends ComponentPropsOptions = ComponentPropsOptions>(props: PP): DefinePropsFromOptions<PP>;
+declare function defineProps<TypeProps>(): DefineProps<TypeProps, BooleanKey<TypeProps>>;
+/**
+ * withDefaults 为 defineProps 声明默认值（类型层）。
+ */
+declare function withDefaults<T, BKeys extends keyof T, Defaults extends InferDefaults<T>>(props: DefineProps<T, BKeys>, defaults: Defaults): PropsWithDefaults<T, Defaults, BKeys>;
+/**
+ * defineEmits 声明（类型层宏）。
+ */
+declare function defineEmits<EE extends string = string>(emits?: EE[]): EmitFn<EE[]>;
+declare function defineEmits<E extends EmitsOptions = EmitsOptions>(emits?: E): EmitFn<E>;
+declare function defineEmits<T extends ComponentTypeEmits>(): T extends ((...args: any[]) => any) ? T : ShortEmits<T>;
+/**
+ * defineExpose 向父级 ref 暴露成员（仅类型层）。
+ */
+declare function defineExpose<T extends Record<string, any> = Record<string, any>>(exposed?: T): void;
+/**
+ * defineOptions 设置 `<script setup>` 组件选项（仅类型层）。
+ */
+declare function defineOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions, P extends WechatMiniprogram.Component.PropertyOption = WechatMiniprogram.Component.PropertyOption>(options?: ScriptSetupDefineOptions<D, C, M, P>): void;
+declare function defineOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions, P extends WechatMiniprogram.Component.PropertyOption = WechatMiniprogram.Component.PropertyOption>(options?: () => ScriptSetupDefineOptions<D, C, M, P> | Promise<ScriptSetupDefineOptions<D, C, M, P>>): void;
+/**
+ * defineSlots 声明 slots 类型（仅类型层）。
+ */
+declare function defineSlots<T extends Record<string, any> = Record<string, any>>(): T;
+type PageLayoutMeta = string | false | {
+  name: string;
+  props?: Record<string, unknown>;
+};
+interface PageMeta {
+  layout?: PageLayoutMeta;
+  [key: string]: unknown;
+}
+/**
+ * definePageMeta 声明页面级元信息（仅类型层）。
+ */
+declare function definePageMeta(meta: PageMeta): void;
+/**
+ * defineModel 声明 v-model 绑定（类型层宏）。
+ */
+type DefineModelModifiers<M extends PropertyKey = string> = Record<M, true | undefined>;
+type ModelRef<T, M extends PropertyKey = string, G = T, S = T> = Ref<G, S> & [ModelRef<T, M, G, S>, DefineModelModifiers<M>];
+interface DefineModelTransformOptions<T, M extends PropertyKey = string, G = T, S = T> {
+  get?: (value: T, modifiers: DefineModelModifiers<M>) => G;
+  set?: (value: S, modifiers: DefineModelModifiers<M>) => T;
+}
+type DefineModelBaseOptions<T, M extends PropertyKey = string, G = T, S = T> = Record<string, any> & DefineModelTransformOptions<T, M, G, S>;
+type DefineModelRequiredOptions<T> = {
+  default: T | (() => T);
+} | {
+  required: true;
+};
+declare function defineModel<T = any, M extends PropertyKey = string, G = T, S = T>(options: DefineModelBaseOptions<T, M, G, S> & DefineModelRequiredOptions<T>): ModelRef<T, M, G, S>;
+declare function defineModel<T = any, M extends PropertyKey = string, G = T, S = T>(name: string, options: DefineModelBaseOptions<T, M, G, S> & DefineModelRequiredOptions<T>): ModelRef<T, M, G, S>;
+declare function defineModel<T = any, M extends PropertyKey = string, G = T, S = T>(options?: DefineModelBaseOptions<T | undefined, M, G | undefined, S | undefined>): ModelRef<T | undefined, M, G | undefined, S | undefined>;
+declare function defineModel<T = any, M extends PropertyKey = string, G = T, S = T>(name?: string, options?: DefineModelBaseOptions<T | undefined, M, G | undefined, S | undefined>): ModelRef<T | undefined, M, G | undefined, S | undefined>;
+//#endregion
+export { resolveRuntimePageLayoutName as $, onUnload as $t, UpdatePerformanceListener as A, CreateAppOptions as An, onAddToFavorites as At, registerComponent as B, onPageScroll as Bt, mergeModels as C, createApp as Cn, onBeforeUpdate as Ct, useNativeInstance as D, TemplateRefs as Dn, onServerPrefetch as Dt, useAttrs as E, TemplateRefValue as En, onMounted as Et, normalizeStyle as F, SetDataDebugInfo as Fn, onLaunch as Ft, provide as G, onRouteDone as Gt, hasInjectionContext as H, onReachBottom as Ht, runSetupFunction as I, SetDataSnapshotOptions as In, onLoad as It, UsePageScrollThrottleOptions as J, onShareTimeline as Jt, provideGlobal as K, onSaveExitState as Kt, mountRuntimeInstance as L, onMemoryWarning as Lt, UseUpdatePerformanceListenerStopHandle as M, DefineAppOptions as Mn, onDetached as Mt, useUpdatePerformanceListener as N, DefineComponentOptions as Nn, onError as Nt, useSlots as O, WevuGlobalComponents as On, onUnmounted as Ot, normalizeClass as P, PageFeatures as Pn, onHide as Pt, WevuPageLayoutMap as Q, onUnhandledRejection as Qt, setRuntimeSetDataVisibility as R, onMoved as Rt, UseModelOptions as S, setWevuDefaults as Sn, onBeforeUnmount as St, useModel as T, GlobalDirectives as Tn, onErrorCaptured as Tt, inject as U, onReady as Ut, registerApp as V, onPullDownRefresh as Vt, injectGlobal as W, onResize as Wt, usePageScrollThrottle as X, onTabItemTap as Xt, UsePageScrollThrottleStopHandle as Y, onShow as Yt, PageLayoutState as Z, onThemeChange as Zt, TemplateRef as _, createWevuComponent as _n, UseIntersectionObserverResult as _t, PageMeta as a, setCurrentSetupContext as an, markNoSetData as at, useNativeRouter as b, WevuDefaults as bn, onActivated as bt, defineModel as c, DisposableMethodName as cn, registerRuntimeLayoutHosts as ct, defineProps as d, ComponentDefinition as dn, unregisterPageLayoutBridge as dt, callHookList as en, setPageLayout as et, defineSlots as f, DefineComponentTypePropsOptions as fn, unregisterRuntimeLayoutHosts as ft, EmitsOptions as g, WevuComponentConstructor as gn, UseIntersectionObserverOptions as gt, EmitFn as h, SetupFunctionWithTypeProps as hn, waitForLayoutHost as ht, PageLayoutMeta as i, setCurrentInstance as in, isNoSetData as it, UpdatePerformanceListenerResult as j, DataOption as jn, onAttached as jt, use as k, WevuGlobalDirectives as kn, onUpdated as kt, defineOptions as l, DisposableObject as ln, resolveLayoutBridge as lt, ComponentTypeEmits as m, SetupContextWithTypeProps as mn, useLayoutHosts as mt, DefineModelTransformOptions as n, getCurrentInstance as nn, syncRuntimePageLayoutStateFromRuntime as nt, defineEmits as o, DisposableBag as on, LayoutHostBinding as ot, withDefaults as p, DefineComponentWithTypeProps as pn, useLayoutBridge as pt, setGlobalProvidedValue as q, onShareAppMessage as qt, ModelRef as r, getCurrentSetupContext as rn, usePageLayout as rt, defineExpose as s, DisposableLike as sn, registerPageLayoutBridge as st, DefineModelModifiers as t, callHookReturn as tn, syncRuntimePageLayoutState as tt, definePageMeta as u, useDisposables as un, resolveLayoutHost as ut, useTemplateRef as v, createWevuScopedSlotComponent as vn, useIntersectionObserver as vt, useBindModel as w, GlobalComponents as wn, onDeactivated as wt, ModelModifiers as x, resetWevuDefaults as xn, onBeforeMount as xt, useNativePageRouter as y, defineComponent as yn, callUpdateHooks as yt, teardownRuntimeInstance as z, onPageNotFound as zt };