wevu 6.18.7 → 6.19.1

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

@@ -0,0 +1,112 @@
+//#region src/runtime/types/miniprogramHostSources.d.ts
+declare namespace WechatMiniProgramHostNamespace {
+  export import App = WechatMiniprogram.App;
+  export import Behavior = WechatMiniprogram.Behavior;
+  export import Component = WechatMiniprogram.Component;
+  export import Page = WechatMiniprogram.Page;
+  export import BoundingClientRectCallbackResult = WechatMiniprogram.BoundingClientRectCallbackResult;
+  export import ScrollOffsetCallbackResult = WechatMiniprogram.ScrollOffsetCallbackResult;
+  export import NodesRef = WechatMiniprogram.NodesRef;
+  export import SelectorQuery = WechatMiniprogram.SelectorQuery;
+  export import CreateIntersectionObserverOption = WechatMiniprogram.CreateIntersectionObserverOption;
+  export import IntersectionObserver = WechatMiniprogram.IntersectionObserver;
+  export import OnUnhandledRejectionListenerResult = WechatMiniprogram.OnUnhandledRejectionListenerResult;
+  export import OnThemeChangeListenerResult = WechatMiniprogram.OnThemeChangeListenerResult;
+  export import OnMemoryWarningListenerResult = WechatMiniprogram.OnMemoryWarningListenerResult;
+  export import SwitchTabOption = WechatMiniprogram.SwitchTabOption;
+  export import ReLaunchOption = WechatMiniprogram.ReLaunchOption;
+  export import RedirectToOption = WechatMiniprogram.RedirectToOption;
+  export import NavigateToOption = WechatMiniprogram.NavigateToOption;
+}
+declare namespace AlipayMiniProgramHostNamespace {}
+declare namespace DouyinMiniProgramHostNamespace {}
+declare namespace TtMiniProgramHostNamespace {}
+declare namespace DefaultMiniProgramHostNamespace {
+  export import App = WechatMiniProgramHostNamespace.App;
+  export import Behavior = WechatMiniProgramHostNamespace.Behavior;
+  export import Component = WechatMiniProgramHostNamespace.Component;
+  export import Page = WechatMiniProgramHostNamespace.Page;
+  export import BoundingClientRectCallbackResult = WechatMiniProgramHostNamespace.BoundingClientRectCallbackResult;
+  export import ScrollOffsetCallbackResult = WechatMiniProgramHostNamespace.ScrollOffsetCallbackResult;
+  export import NodesRef = WechatMiniProgramHostNamespace.NodesRef;
+  export import SelectorQuery = WechatMiniProgramHostNamespace.SelectorQuery;
+  export import CreateIntersectionObserverOption = WechatMiniProgramHostNamespace.CreateIntersectionObserverOption;
+  export import IntersectionObserver = WechatMiniProgramHostNamespace.IntersectionObserver;
+  export import OnUnhandledRejectionListenerResult = WechatMiniProgramHostNamespace.OnUnhandledRejectionListenerResult;
+  export import OnThemeChangeListenerResult = WechatMiniProgramHostNamespace.OnThemeChangeListenerResult;
+  export import OnMemoryWarningListenerResult = WechatMiniProgramHostNamespace.OnMemoryWarningListenerResult;
+  export import SwitchTabOption = WechatMiniProgramHostNamespace.SwitchTabOption;
+  export import ReLaunchOption = WechatMiniProgramHostNamespace.ReLaunchOption;
+  export import RedirectToOption = WechatMiniProgramHostNamespace.RedirectToOption;
+  export import NavigateToOption = WechatMiniProgramHostNamespace.NavigateToOption;
+}
+declare namespace MiniProgramHostNamespace {
+  export import App = DefaultMiniProgramHostNamespace.App;
+  export import Behavior = DefaultMiniProgramHostNamespace.Behavior;
+  export import Component = DefaultMiniProgramHostNamespace.Component;
+  export import Page = DefaultMiniProgramHostNamespace.Page;
+  export import BoundingClientRectCallbackResult = DefaultMiniProgramHostNamespace.BoundingClientRectCallbackResult;
+  export import ScrollOffsetCallbackResult = DefaultMiniProgramHostNamespace.ScrollOffsetCallbackResult;
+  export import NodesRef = DefaultMiniProgramHostNamespace.NodesRef;
+  export import SelectorQuery = DefaultMiniProgramHostNamespace.SelectorQuery;
+  export import CreateIntersectionObserverOption = DefaultMiniProgramHostNamespace.CreateIntersectionObserverOption;
+  export import IntersectionObserver = DefaultMiniProgramHostNamespace.IntersectionObserver;
+  export import OnUnhandledRejectionListenerResult = DefaultMiniProgramHostNamespace.OnUnhandledRejectionListenerResult;
+  export import OnThemeChangeListenerResult = DefaultMiniProgramHostNamespace.OnThemeChangeListenerResult;
+  export import OnMemoryWarningListenerResult = DefaultMiniProgramHostNamespace.OnMemoryWarningListenerResult;
+  export import SwitchTabOption = DefaultMiniProgramHostNamespace.SwitchTabOption;
+  export import ReLaunchOption = DefaultMiniProgramHostNamespace.ReLaunchOption;
+  export import RedirectToOption = DefaultMiniProgramHostNamespace.RedirectToOption;
+  export import NavigateToOption = DefaultMiniProgramHostNamespace.NavigateToOption;
+}
+type MiniProgramPlatformHostSourceName = 'default' | 'wechat' | 'alipay' | 'douyin';
+type MiniProgramRuntimeHostSourceName = 'wx' | 'my' | 'tt';
+type MiniProgramHostSourceName = MiniProgramPlatformHostSourceName | MiniProgramRuntimeHostSourceName;
+interface DefaultMiniProgramHostSourceContract {
+  BoundingClientRectCallbackResult: DefaultMiniProgramHostNamespace.BoundingClientRectCallbackResult;
+  ScrollOffsetCallbackResult: DefaultMiniProgramHostNamespace.ScrollOffsetCallbackResult;
+  NodesRef: DefaultMiniProgramHostNamespace.NodesRef;
+  SelectorQuery: DefaultMiniProgramHostNamespace.SelectorQuery;
+  CreateIntersectionObserverOption: DefaultMiniProgramHostNamespace.CreateIntersectionObserverOption;
+  IntersectionObserver: DefaultMiniProgramHostNamespace.IntersectionObserver;
+  OnUnhandledRejectionListenerResult: DefaultMiniProgramHostNamespace.OnUnhandledRejectionListenerResult;
+  OnThemeChangeListenerResult: DefaultMiniProgramHostNamespace.OnThemeChangeListenerResult;
+  OnMemoryWarningListenerResult: DefaultMiniProgramHostNamespace.OnMemoryWarningListenerResult;
+  SwitchTabOption: DefaultMiniProgramHostNamespace.SwitchTabOption;
+  ReLaunchOption: DefaultMiniProgramHostNamespace.ReLaunchOption;
+  RedirectToOption: DefaultMiniProgramHostNamespace.RedirectToOption;
+  NavigateToOption: DefaultMiniProgramHostNamespace.NavigateToOption;
+}
+/**
+ * @description 微信平台命名兼容契约；当前默认宿主语义仍复用微信底座，但上层主链路应优先依赖 default。
+ */
+interface WechatMiniProgramHostSourceContract extends DefaultMiniProgramHostSourceContract {}
+/**
+ * @description 支付宝宿主类型契约占位；后续接入稳定 typings 时在此扩展。
+ */
+interface AlipayMiniProgramHostSourceContract extends Record<never, never> {}
+/**
+ * @description 抖音宿主类型契约占位；后续接入稳定 typings 时在此扩展。
+ */
+interface DouyinMiniProgramHostSourceContract extends Record<never, never> {}
+/**
+ * @description `tt` 命名兼容入口，保持与抖音宿主语义主名一致。
+ */
+interface TtMiniProgramHostSourceContract extends DouyinMiniProgramHostSourceContract {}
+interface MiniProgramPlatformHostSourceRegistry {
+  default: DefaultMiniProgramHostSourceContract;
+  wechat: WechatMiniProgramHostSourceContract;
+  alipay: AlipayMiniProgramHostSourceContract;
+  douyin: DouyinMiniProgramHostSourceContract;
+}
+interface MiniProgramRuntimeHostSourceRegistry {
+  wx: DefaultMiniProgramHostSourceContract;
+  my: AlipayMiniProgramHostSourceContract;
+  tt: TtMiniProgramHostSourceContract;
+}
+interface MiniProgramHostSourceRegistry extends MiniProgramPlatformHostSourceRegistry, MiniProgramRuntimeHostSourceRegistry {}
+type MiniProgramPlatformHostNamespaceBySource<TSourceName extends MiniProgramPlatformHostSourceName = MiniProgramPlatformHostSourceName> = MiniProgramPlatformHostSourceRegistry[TSourceName];
+type MiniProgramRuntimeHostNamespaceBySource<TSourceName extends MiniProgramRuntimeHostSourceName = MiniProgramRuntimeHostSourceName> = MiniProgramRuntimeHostSourceRegistry[TSourceName];
+type MiniProgramHostNamespaceBySource<TSourceName extends MiniProgramHostSourceName = MiniProgramHostSourceName> = MiniProgramHostSourceRegistry[TSourceName];
+//#endregion
+export { AlipayMiniProgramHostNamespace, AlipayMiniProgramHostSourceContract, DefaultMiniProgramHostNamespace, DefaultMiniProgramHostSourceContract, DouyinMiniProgramHostNamespace, DouyinMiniProgramHostSourceContract, MiniProgramHostNamespace, MiniProgramHostNamespaceBySource, MiniProgramHostSourceName, MiniProgramHostSourceRegistry, MiniProgramPlatformHostNamespaceBySource, MiniProgramPlatformHostSourceName, MiniProgramPlatformHostSourceRegistry, MiniProgramRuntimeHostNamespaceBySource, MiniProgramRuntimeHostSourceName, MiniProgramRuntimeHostSourceRegistry, TtMiniProgramHostNamespace, TtMiniProgramHostSourceContract, WechatMiniProgramHostNamespace, WechatMiniProgramHostSourceContract };

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

@@ -0,0 +1,136 @@
+import { MiniProgramAppOptions, MiniProgramComponentOptions, MiniProgramPageLifetimes } from "./miniprogram.mjs";
+import { ComponentPropsOptions } from "./props/propTypes.mjs";
+import { ComputedDefinitions, MethodDefinitions } from "./core.mjs";
+import { SetupContext, SetupFunction } from "./props/setup.mjs";
+import "./props.mjs";
+import { SetDataSnapshotOptions } from "./setData.mjs";
+//#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;
+  /**
+   * 允许将运行时传入的 `undefined` props 兼容为 `null` 输入，避免小程序对已声明类型 props 报告 `null` 类型告警。
+   *
+   * 适合迁移 Vue 组件或需要兼容 `undefined -> null` 传参链路的场景；默认关闭，避免影响原生 `properties` 的严格类型语义。
+   */
+  allowNullPropInput?: boolean;
+  /**
+   * 允许函数值作为组件 prop 通过小程序 data/properties 链路传递。
+   *
+   * - `auto` / undefined：默认由 SFC 编译器精确标记模板中的函数 prop 绑定。
+   * - `true`：手写组件或动态传参场景下全量允许函数进入快照。
+   * - `false`：关闭函数 prop 快照放行。
+   */
+  allowFunctionProps?: boolean | 'auto';
+  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
+export { CreateAppOptions, DataOption, DefineAppOptions, DefineComponentOptions, PageFeatures };

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 };