wevu 6.11.1 → 6.11.4

package/dist/index.d.mts

@@ -397,6 +397,7 @@ interface InternalRuntimeStateFields {
   __wevu?: RuntimeInstance<any, any, any>;
   __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>;
@@ -1071,6 +1072,61 @@ type UseIntersectionObserverResult = WechatMiniprogram.IntersectionObserver;
  */
 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;
@@ -1326,7 +1382,17 @@ type EmitFn<Options = ObjectEmitsOptions, Event extends keyof Options = keyof Op
 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 ScriptSetupDefineOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions> = Omit<DefineComponentOptions<ComponentPropsOptions, D, C, M>, 'props' | 'options'> & {
+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() 声明。
    */
@@ -1347,6 +1413,18 @@ type ScriptSetupDefineOptions<D extends object = Record<string, any>, C extends
    * 小程序 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）。
    */
@@ -1377,9 +1455,8 @@ declare function defineExpose<T extends Record<string, any> = Record<string, any
 /**
  * defineOptions 设置 `<script setup>` 组件选项（仅类型层）。
  */
-declare function defineOptions<D extends object = Record<string, any>, C extends ComputedDefinitions = ComputedDefinitions, M extends MethodDefinitions = MethodDefinitions>(options?: ScriptSetupDefineOptions<D, C, M> & {
-  options?: WechatMiniprogram.Component.ComponentOptions;
-}): 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>): 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 类型（仅类型层）。
  */
@@ -1416,4 +1493,4 @@ declare function defineModel<T = any, M extends PropertyKey = string, G = T, 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 { ActionContext, ActionSubscriber, type AllowedComponentProps, type AppConfig, type ComponentCustomProps, ComponentDefinition, type ComponentOptionsMixin, type ComponentPropsOptions, type ComponentPublicInstance, type ComponentTypeEmits, type ComputedDefinitions, ComputedGetter, ComputedRef, ComputedSetter, type CreateAppOptions, CustomRefFactory, CustomRefOptions, CustomRefSource, type DataOption, type DefineAppOptions, type DefineComponent, type DefineComponentOptions, DefineComponentTypePropsOptions, DefineComponentWithTypeProps, DefineModelModifiers, DefineModelTransformOptions, DefineStoreOptions, DisposableBag, DisposableLike, DisposableMethodName, DisposableObject, EffectScope, type EmitFn, type EmitsOptions, type ExtractComputed, type ExtractDefaultPropTypes, type ExtractMethods, type ExtractPropTypes, type ExtractPublicPropTypes, GlobalComponents, GlobalDirectives, type InferNativePropType, type InferNativeProps, type InferPropType, type InferProps, type InternalRuntimeState, type InternalRuntimeStateFields, type MapSources, MaybeRef, MaybeRefOrGetter, type MaybeUndefined, type MethodDefinitions, type MiniProgramAdapter, type MiniProgramAppOptions, type MiniProgramBehaviorIdentifier, type MiniProgramComponentBehaviorOptions, type MiniProgramComponentOptions, type MiniProgramComponentRawOptions, type MiniProgramInstance, type MiniProgramPageLifetimes, type ModelBinding, type ModelBindingOptions, type ModelBindingPayload, ModelModifiers, ModelRef, type MultiWatchSources, type MutationKind, type MutationOp, type MutationRecord, MutationType, type NativeComponent, type NativePropType, type NativePropsOptions, type NativeTypeHint, type NativeTypedProperty, type ObjectDirective, type OnCleanup, type PageFeatures, PageLayoutMeta, PageLayoutState, PageMeta, type PrelinkReactiveTreeOptions, type PropConstructor, type PropOptions, type PropType, type PublicProps, Ref, type RuntimeApp, type RuntimeInstance, type SetDataDebugInfo, type SetDataSnapshotOptions, type SetupContext, type SetupContextNativeInstance, type SetupContextRouter, SetupContextWithTypeProps, type SetupFunction, SetupFunctionWithTypeProps, ShallowRef, type ShallowUnwrapRef, StoreManager, StoreSubscribeOptions, StoreToRefsResult, SubscriptionCallback, TemplateRef, TemplateRefValue, TemplateRefs, ToRefs, type TriggerEventOptions, UpdatePerformanceListener, UpdatePerformanceListenerResult, UseIntersectionObserverOptions, UseIntersectionObserverResult, UseModelOptions, UsePageScrollThrottleOptions, UsePageScrollThrottleStopHandle, UseUpdatePerformanceListenerStopHandle, type VNode, type VNodeProps, type WatchCallback, type WatchEffect, type WatchEffectOptions, type WatchMultiSources, type WatchOptions, type WatchScheduler, type WatchSource, type WatchSourceValue, type WatchSources, type WatchStopHandle, WevuComponentConstructor, WevuDefaults, WevuGlobalComponents, WevuGlobalDirectives, WevuPageLayoutMap, type WevuPlugin, type WevuTypedRouterRouteMap, WritableComputedOptions, WritableComputedRef, addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, customRef, defineComponent, defineEmits, defineExpose, defineModel, defineOptions, definePageMeta, defineProps, defineSlots, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, hasInjectionContext, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, normalizeClass, normalizeStyle, onActivated, onAddToFavorites, onAttached, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onDetached, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMemoryWarning, 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, resolveRuntimePageLayoutName, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setPageLayout, setRuntimeSetDataVisibility, setWevuDefaults, shallowReactive, shallowReadonly, shallowRef, startBatch, stop, storeToRefs, syncRuntimePageLayoutState, syncRuntimePageLayoutStateFromRuntime, teardownRuntimeInstance, toRaw, toRef, toRefs, toValue, touchReactive, traverse, triggerRef, unref, useAttrs, useBindModel, useDisposables, useIntersectionObserver, useModel, useNativeInstance, useNativePageRouter, useNativeRouter, usePageLayout, usePageScrollThrottle, useSlots, useTemplateRef, useUpdatePerformanceListener, watch, watchEffect, withDefaults };
+export { ActionContext, ActionSubscriber, type AllowedComponentProps, type AppConfig, type ComponentCustomProps, ComponentDefinition, type ComponentOptionsMixin, type ComponentPropsOptions, type ComponentPublicInstance, type ComponentTypeEmits, type ComputedDefinitions, ComputedGetter, ComputedRef, ComputedSetter, type CreateAppOptions, CustomRefFactory, CustomRefOptions, CustomRefSource, type DataOption, type DefineAppOptions, type DefineComponent, type DefineComponentOptions, DefineComponentTypePropsOptions, DefineComponentWithTypeProps, DefineModelModifiers, DefineModelTransformOptions, DefineStoreOptions, DisposableBag, DisposableLike, DisposableMethodName, DisposableObject, EffectScope, type EmitFn, type EmitsOptions, type ExtractComputed, type ExtractDefaultPropTypes, type ExtractMethods, type ExtractPropTypes, type ExtractPublicPropTypes, GlobalComponents, GlobalDirectives, type InferNativePropType, type InferNativeProps, type InferPropType, type InferProps, type InternalRuntimeState, type InternalRuntimeStateFields, LayoutHostBinding, type MapSources, MaybeRef, MaybeRefOrGetter, type MaybeUndefined, type MethodDefinitions, type MiniProgramAdapter, type MiniProgramAppOptions, type MiniProgramBehaviorIdentifier, type MiniProgramComponentBehaviorOptions, type MiniProgramComponentOptions, type MiniProgramComponentRawOptions, type MiniProgramInstance, type MiniProgramPageLifetimes, type ModelBinding, type ModelBindingOptions, type ModelBindingPayload, ModelModifiers, ModelRef, type MultiWatchSources, type MutationKind, type MutationOp, type MutationRecord, MutationType, type NativeComponent, type NativePropType, type NativePropsOptions, type NativeTypeHint, type NativeTypedProperty, type ObjectDirective, type OnCleanup, type PageFeatures, PageLayoutMeta, PageLayoutState, PageMeta, type PrelinkReactiveTreeOptions, type PropConstructor, type PropOptions, type PropType, type PublicProps, Ref, type RuntimeApp, type RuntimeInstance, type SetDataDebugInfo, type SetDataSnapshotOptions, type SetupContext, type SetupContextNativeInstance, type SetupContextRouter, SetupContextWithTypeProps, type SetupFunction, SetupFunctionWithTypeProps, ShallowRef, type ShallowUnwrapRef, StoreManager, StoreSubscribeOptions, StoreToRefsResult, SubscriptionCallback, TemplateRef, TemplateRefValue, TemplateRefs, ToRefs, type TriggerEventOptions, UpdatePerformanceListener, UpdatePerformanceListenerResult, UseIntersectionObserverOptions, UseIntersectionObserverResult, UseModelOptions, UsePageScrollThrottleOptions, UsePageScrollThrottleStopHandle, UseUpdatePerformanceListenerStopHandle, type VNode, type VNodeProps, type WatchCallback, type WatchEffect, type WatchEffectOptions, type WatchMultiSources, type WatchOptions, type WatchScheduler, type WatchSource, type WatchSourceValue, type WatchSources, type WatchStopHandle, WevuComponentConstructor, WevuDefaults, WevuGlobalComponents, WevuGlobalDirectives, WevuPageLayoutMap, type WevuPlugin, type WevuTypedRouterRouteMap, WritableComputedOptions, WritableComputedRef, addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, customRef, defineComponent, defineEmits, defineExpose, defineModel, defineOptions, definePageMeta, defineProps, defineSlots, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, hasInjectionContext, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, normalizeClass, normalizeStyle, onActivated, onAddToFavorites, onAttached, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onDetached, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMemoryWarning, 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, registerPageLayoutBridge, registerRuntimeLayoutHosts, removeMutationRecorder, resetWevuDefaults, resolveLayoutBridge, resolveLayoutHost, resolveRuntimePageLayoutName, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setPageLayout, setRuntimeSetDataVisibility, setWevuDefaults, shallowReactive, shallowReadonly, shallowRef, startBatch, stop, storeToRefs, syncRuntimePageLayoutState, syncRuntimePageLayoutStateFromRuntime, teardownRuntimeInstance, toRaw, toRef, toRefs, toValue, touchReactive, traverse, triggerRef, unref, unregisterPageLayoutBridge, unregisterRuntimeLayoutHosts, useAttrs, useBindModel, useDisposables, useIntersectionObserver, useLayoutBridge, useLayoutHosts, useModel, useNativeInstance, useNativePageRouter, useNativeRouter, usePageLayout, usePageScrollThrottle, useSlots, useTemplateRef, useUpdatePerformanceListener, waitForLayoutHost, watch, watchEffect, withDefaults };

package/dist/index.mjs

@@ -124,6 +124,81 @@ function traverse(value, depth = Infinity, seen = /* @__PURE__ */ new Map()) {
 	return value;
 }
 //#endregion
+//#region src/runtime/hooks/vue.ts
+/**
+* Vue 3 对齐：组件/页面已挂载，映射小程序 onReady
+*/
+function onMounted(handler) {
+	pushHook(assertInSetup("onMounted"), "onReady", handler);
+}
+/**
+* Vue 3 对齐：组件/页面更新后触发。
+* 小程序没有专用 update 生命周期，这里在每次 setData 完成后调用。
+*/
+function onUpdated(handler) {
+	pushHook(assertInSetup("onUpdated"), "__wevuOnUpdated", handler);
+}
+/**
+* Vue 3 对齐：卸载前触发。
+* 小程序无 before-unload 生命周期，setup 时同步执行以保持语义。
+*/
+function onBeforeUnmount(handler) {
+	assertInSetup("onBeforeUnmount");
+	handler();
+}
+/**
+* Vue 3 对齐：组件/页面卸载；映射到页面 onUnload 或组件 detached
+*/
+function onUnmounted(handler) {
+	pushHook(assertInSetup("onUnmounted"), "onUnload", handler);
+}
+/**
+* Vue 3 对齐：挂载前；setup 时同步触发以模拟 beforeMount 语义
+*/
+function onBeforeMount(handler) {
+	assertInSetup("onBeforeMount");
+	handler();
+}
+/**
+* Vue 3 对齐：更新前；在每次 setData 前触发
+*/
+function onBeforeUpdate(handler) {
+	pushHook(assertInSetup("onBeforeUpdate"), "__wevuOnBeforeUpdate", handler);
+}
+/**
+* Vue 3 对齐：错误捕获；映射到小程序 onError
+*/
+function onErrorCaptured(handler) {
+	const instance = assertInSetup("onErrorCaptured");
+	pushHook(instance, "onError", (err) => handler(err, instance, ""));
+}
+/**
+* Vue 3 对齐：组件激活；映射到小程序 onShow
+*/
+function onActivated(handler) {
+	pushHook(assertInSetup("onActivated"), "onShow", handler);
+}
+/**
+* Vue 3 对齐：组件失活；映射到小程序 onHide
+*/
+function onDeactivated(handler) {
+	pushHook(assertInSetup("onDeactivated"), "onHide", handler);
+}
+/**
+* Vue 3 对齐：服务端渲染前置钩子。
+* 小程序无此场景，保留空实现以保持 API 兼容。
+*/
+function onServerPrefetch(_handler) {
+	assertInSetup("onServerPrefetch");
+}
+/**
+* 派发更新阶段钩子（框架内部调度入口）。
+* @internal
+*/
+function callUpdateHooks(target, phase) {
+	callHookList(target, phase === "before" ? "__wevuOnBeforeUpdate" : "__wevuOnUpdated");
+}
+//#endregion
 //#region src/reactivity/watch/types.ts
 let __deepWatchStrategy = "version";
 /**
@@ -207,6 +282,7 @@ function dispatchScheduledJob(job, flush, isFirstRun, scheduler) {
 //#region src/reactivity/watch.ts
 function watch(source, cb, options = {}) {
 	var _options$flush;
+	const ownerInstance = getCurrentInstance();
 	const watchGetterContext = createWatchGetter(source);
 	const getter = applyDeepWatchGetter(watchGetterContext.getter, source, watchGetterContext.isMultiSource, watchGetterContext.isReactiveSource, options.deep);
 	let cleanup;
@@ -228,7 +304,13 @@ function watch(source, cb, options = {}) {
 		if (!runner.active || paused || token !== pauseToken) return;
 		const newValue = runner();
 		cleanup === null || cleanup === void 0 || cleanup();
-		cbWithOnce(newValue, oldValue, onCleanup);
+		const previousInstance = getCurrentInstance();
+		setCurrentInstance(ownerInstance);
+		try {
+			cbWithOnce(newValue, oldValue, onCleanup);
+		} finally {
+			setCurrentInstance(previousInstance);
+		}
 		oldValue = newValue;
 	};
 	const scheduledJob = () => runJob(scheduledToken);
@@ -272,6 +354,7 @@ function watch(source, cb, options = {}) {
 */
 function watchEffect(effectFn, options = {}) {
 	var _options$flush2;
+	const ownerInstance = getCurrentInstance();
 	let cleanup;
 	const onCleanup = (fn) => {
 		cleanup = fn;
@@ -293,7 +376,13 @@ function watchEffect(effectFn, options = {}) {
 	runner = effect(() => {
 		cleanup === null || cleanup === void 0 || cleanup();
 		cleanup = void 0;
-		effectFn(onCleanup);
+		const previousInstance = getCurrentInstance();
+		setCurrentInstance(ownerInstance);
+		try {
+			effectFn(onCleanup);
+		} finally {
+			setCurrentInstance(previousInstance);
+		}
 	}, {
 		lazy: true,
 		scheduler: () => {
@@ -1678,81 +1767,6 @@ function applyWevuComponentDefaults(options) {
 	return mergeWithDefaults(currentDefaults.component, options);
 }
 //#endregion
-//#region src/runtime/hooks/vue.ts
-/**
-* Vue 3 对齐：组件/页面已挂载，映射小程序 onReady
-*/
-function onMounted(handler) {
-	pushHook(assertInSetup("onMounted"), "onReady", handler);
-}
-/**
-* Vue 3 对齐：组件/页面更新后触发。
-* 小程序没有专用 update 生命周期，这里在每次 setData 完成后调用。
-*/
-function onUpdated(handler) {
-	pushHook(assertInSetup("onUpdated"), "__wevuOnUpdated", handler);
-}
-/**
-* Vue 3 对齐：卸载前触发。
-* 小程序无 before-unload 生命周期，setup 时同步执行以保持语义。
-*/
-function onBeforeUnmount(handler) {
-	assertInSetup("onBeforeUnmount");
-	handler();
-}
-/**
-* Vue 3 对齐：组件/页面卸载；映射到页面 onUnload 或组件 detached
-*/
-function onUnmounted(handler) {
-	pushHook(assertInSetup("onUnmounted"), "onUnload", handler);
-}
-/**
-* Vue 3 对齐：挂载前；setup 时同步触发以模拟 beforeMount 语义
-*/
-function onBeforeMount(handler) {
-	assertInSetup("onBeforeMount");
-	handler();
-}
-/**
-* Vue 3 对齐：更新前；在每次 setData 前触发
-*/
-function onBeforeUpdate(handler) {
-	pushHook(assertInSetup("onBeforeUpdate"), "__wevuOnBeforeUpdate", handler);
-}
-/**
-* Vue 3 对齐：错误捕获；映射到小程序 onError
-*/
-function onErrorCaptured(handler) {
-	const instance = assertInSetup("onErrorCaptured");
-	pushHook(instance, "onError", (err) => handler(err, instance, ""));
-}
-/**
-* Vue 3 对齐：组件激活；映射到小程序 onShow
-*/
-function onActivated(handler) {
-	pushHook(assertInSetup("onActivated"), "onShow", handler);
-}
-/**
-* Vue 3 对齐：组件失活；映射到小程序 onHide
-*/
-function onDeactivated(handler) {
-	pushHook(assertInSetup("onDeactivated"), "onHide", handler);
-}
-/**
-* Vue 3 对齐：服务端渲染前置钩子。
-* 小程序无此场景，保留空实现以保持 API 兼容。
-*/
-function onServerPrefetch(_handler) {
-	assertInSetup("onServerPrefetch");
-}
-/**
-* 派发更新阶段钩子（框架内部调度入口）。
-* @internal
-*/
-function callUpdateHooks(target, phase) {
-	callHookList(target, phase === "before" ? "__wevuOnBeforeUpdate" : "__wevuOnUpdated");
-}
-//#endregion
 //#region src/runtime/register/inline.ts
 const AMP_RE$1 = /&/g;
 const QUOT_RE$1 = /"/g;
@@ -1880,6 +1894,148 @@ function runInlineExpression(ctx, expr, event, inlineMap) {
 	if (typeof handler === "function") return handler.apply(ctx, resolvedArgs);
 }
 //#endregion
+//#region src/runtime/register/component/lifecycle/platform.ts
+let wxPatched = false;
+let currentPageInstance;
+const PAGE_SCROLL_HOOK_DEPTH_KEY = "__wevuPageScrollHookDepth";
+function getCurrentPageInstance() {
+	return currentPageInstance;
+}
+function bindCurrentPageInstance(target) {
+	currentPageInstance = target;
+}
+function releaseCurrentPageInstance(target) {
+	if (currentPageInstance === target) currentPageInstance = void 0;
+}
+function runInPageScrollHook(target, task) {
+	var _PAGE_SCROLL_HOOK_DEP;
+	target[PAGE_SCROLL_HOOK_DEPTH_KEY] = Number((_PAGE_SCROLL_HOOK_DEP = target[PAGE_SCROLL_HOOK_DEPTH_KEY]) !== null && _PAGE_SCROLL_HOOK_DEP !== void 0 ? _PAGE_SCROLL_HOOK_DEP : 0) + 1;
+	try {
+		return task();
+	} finally {
+		var _PAGE_SCROLL_HOOK_DEP2;
+		const nextDepth = Number((_PAGE_SCROLL_HOOK_DEP2 = target[PAGE_SCROLL_HOOK_DEPTH_KEY]) !== null && _PAGE_SCROLL_HOOK_DEP2 !== void 0 ? _PAGE_SCROLL_HOOK_DEP2 : 1) - 1;
+		if (nextDepth <= 0) delete target[PAGE_SCROLL_HOOK_DEPTH_KEY];
+		else target[PAGE_SCROLL_HOOK_DEPTH_KEY] = nextDepth;
+	}
+}
+function resolvePageOptions(target) {
+	const direct = target.options;
+	if (direct && typeof direct === "object") return direct;
+	if (typeof getCurrentPages === "function") {
+		const pages = getCurrentPages();
+		const page = Array.isArray(pages) ? pages.at(-1) : void 0;
+		const options = page && typeof page === "object" ? page.options : void 0;
+		if (options && typeof options === "object") return options;
+	}
+	return {};
+}
+function ensureWxPatched() {
+	if (wxPatched) return;
+	wxPatched = true;
+	const wxGlobal = getMiniProgramGlobalObject();
+	if (!wxGlobal || typeof wxGlobal !== "object") return;
+	const rawStartPullDownRefresh = wxGlobal.startPullDownRefresh;
+	if (typeof rawStartPullDownRefresh === "function") wxGlobal.startPullDownRefresh = function startPullDownRefreshPatched(...args) {
+		const result = rawStartPullDownRefresh.apply(this, args);
+		if (currentPageInstance) callHookList(currentPageInstance, "onPullDownRefresh", []);
+		return result;
+	};
+	const rawPageScrollTo = wxGlobal.pageScrollTo;
+	if (typeof rawPageScrollTo === "function") wxGlobal.pageScrollTo = function pageScrollToPatched(options, ...rest) {
+		const result = rawPageScrollTo.apply(this, [options, ...rest]);
+		if (currentPageInstance) {
+			const pageInstance = currentPageInstance;
+			runInPageScrollHook(pageInstance, () => {
+				callHookList(pageInstance, "onPageScroll", [options !== null && options !== void 0 ? options : {}]);
+			});
+		}
+		return result;
+	};
+}
+function ensurePageShareMenus(options) {
+	const { enableOnShareAppMessage, enableOnShareTimeline } = options;
+	if (!enableOnShareAppMessage && !enableOnShareTimeline) return;
+	const wxGlobal = getMiniProgramGlobalObject();
+	if (!wxGlobal || typeof wxGlobal.showShareMenu !== "function") return;
+	const showMenu = (payload) => {
+		try {
+			wxGlobal.showShareMenu(payload);
+		} catch (_unused) {}
+	};
+	if (!(enableOnShareAppMessage || enableOnShareTimeline)) return;
+	const menus = ["shareAppMessage"];
+	if (enableOnShareTimeline) menus.push("shareTimeline");
+	showMenu({
+		withShareTicket: true,
+		menus
+	});
+}
+//#endregion
+//#region src/runtime/pageLayout.ts
+const PAGE_LAYOUT_SETTER_KEY = "__wevuSetPageLayout";
+const NO_LAYOUT_RUNTIME_KEY = "__wv_no_layout";
+function resolveCurrentPageInstance$1() {
+	const runtimeCurrentPage = getCurrentPageInstance();
+	if (runtimeCurrentPage) return runtimeCurrentPage;
+	const getCurrentPagesFn = globalThis.getCurrentPages;
+	if (typeof getCurrentPagesFn !== "function") return;
+	return getCurrentPagesFn().at(-1);
+}
+function normalizeRuntimePageLayoutName(layout) {
+	return layout === NO_LAYOUT_RUNTIME_KEY ? false : layout;
+}
+/**
+* 获取当前页面 layout 状态。
+*/
+function usePageLayout() {
+	var _currentInstance$__we, _runtimeState$__wv_pa;
+	if (!getCurrentSetupContext()) throw new Error("usePageLayout() 必须在 setup() 的同步阶段调用");
+	const currentInstance = getCurrentInstance();
+	const runtimeState = currentInstance === null || currentInstance === void 0 || (_currentInstance$__we = currentInstance.__wevu) === null || _currentInstance$__we === void 0 ? void 0 : _currentInstance$__we.state;
+	const pageLayoutState = reactive({
+		name: normalizeRuntimePageLayoutName(runtimeState === null || runtimeState === void 0 ? void 0 : runtimeState.__wv_page_layout_name),
+		props: { ...(_runtimeState$__wv_pa = runtimeState === null || runtimeState === void 0 ? void 0 : runtimeState.__wv_page_layout_props) !== null && _runtimeState$__wv_pa !== void 0 ? _runtimeState$__wv_pa : {} }
+	});
+	if (currentInstance) currentInstance.__wevuPageLayoutState = pageLayoutState;
+	return readonly(pageLayoutState);
+}
+function syncRuntimePageLayoutState(target, layout, props) {
+	const state = target.__wevuPageLayoutState;
+	if (!state) return;
+	state.name = layout;
+	state.props = { ...props };
+}
+function syncRuntimePageLayoutStateFromRuntime(target) {
+	var _target$__wevu, _runtimeState$__wv_pa2;
+	const state = target.__wevuPageLayoutState;
+	const runtimeState = (_target$__wevu = target.__wevu) === null || _target$__wevu === void 0 ? void 0 : _target$__wevu.state;
+	if (!state || !runtimeState) return;
+	state.name = normalizeRuntimePageLayoutName(runtimeState.__wv_page_layout_name);
+	state.props = { ...(_runtimeState$__wv_pa2 = runtimeState.__wv_page_layout_props) !== null && _runtimeState$__wv_pa2 !== void 0 ? _runtimeState$__wv_pa2 : {} };
+}
+/**
+* 显式切换当前页面使用的 layout。
+*/
+function setPageLayout(layout, props) {
+	const currentInstance = getCurrentInstance();
+	const directSetter = currentInstance === null || currentInstance === void 0 ? void 0 : currentInstance[PAGE_LAYOUT_SETTER_KEY];
+	if (typeof directSetter === "function") {
+		directSetter(layout, props);
+		return;
+	}
+	const currentPage = resolveCurrentPageInstance$1();
+	const pageSetter = currentPage === null || currentPage === void 0 ? void 0 : currentPage[PAGE_LAYOUT_SETTER_KEY];
+	if (typeof pageSetter === "function") {
+		pageSetter(layout, props);
+		return;
+	}
+	throw new Error("setPageLayout() 未找到当前页面实例。请在页面 setup()、事件回调或当前页面上下文中调用。");
+}
+function resolveRuntimePageLayoutName(layout) {
+	return layout === false ? NO_LAYOUT_RUNTIME_KEY : layout;
+}
+//#endregion
 //#region src/runtime/scopedSlots.ts
 const ownerStore = /* @__PURE__ */ new Map();
 let ownerSeed = 0;
@@ -1990,14 +2146,18 @@ function mergeComponentRefValue(wrapper, exposed) {
 	return markNoSetData(new Proxy(wrapper, {
 		get(target, key, receiver) {
 			if (Reflect.has(target, key)) return Reflect.get(target, key, receiver);
-			return source[key];
+			const value = source[key];
+			if (typeof value === "function") return value.bind(source);
+			return value;
 		},
 		set(target, key, value, receiver) {
+			if (Reflect.has(target, key)) return Reflect.set(target, key, value, receiver);
 			if (key in source) {
 				source[key] = value;
 				return true;
 			}
-			return Reflect.set(target, key, value, receiver);
+			source[key] = value;
+			return true;
 		},
 		has(target, key) {
 			return Reflect.has(target, key) || key in source;
@@ -2847,6 +3007,18 @@ function registerWatches(runtime, watchMap, instance) {
 }
 //#endregion
 //#region src/runtime/register/runtimeInstance.ts
+function attachPageLayoutSetter(target) {
+	if (typeof target.route !== "string" || !target.route) return;
+	target.__wevuSetPageLayout = (layout, props) => {
+		var _target$__wevu;
+		const runtimeState = (_target$__wevu = target.__wevu) === null || _target$__wevu === void 0 ? void 0 : _target$__wevu.state;
+		if (!runtimeState || typeof runtimeState !== "object") return;
+		runtimeState.__wv_page_layout_name = resolveRuntimePageLayoutName(layout);
+		const nextProps = layout === false ? {} : props !== null && props !== void 0 ? props : {};
+		runtimeState.__wv_page_layout_props = nextProps;
+		syncRuntimePageLayoutState(target, layout, nextProps);
+	};
+}
 /**
 * 挂载运行时实例（框架内部注册流程使用）。
 * @internal
@@ -2972,6 +3144,7 @@ function mountRuntimeInstance(target, runtimeApp, watchMap, setup, options) {
 		writable: false
 	});
 	target.__wevu = runtimeWithDefaults;
+	attachPageLayoutSetter(target);
 	attachOwnerSnapshot(target, runtimeWithDefaults, ownerId);
 	if (watchMap) {
 		const stops = registerWatches(runtimeWithDefaults, watchMap, target);
@@ -3158,81 +3331,6 @@ function resolveComponentFeatures(options) {
 	};
 }
 //#endregion
-//#region src/runtime/register/component/lifecycle/platform.ts
-let wxPatched = false;
-let currentPageInstance;
-const PAGE_SCROLL_HOOK_DEPTH_KEY = "__wevuPageScrollHookDepth";
-function bindCurrentPageInstance(target) {
-	currentPageInstance = target;
-}
-function releaseCurrentPageInstance(target) {
-	if (currentPageInstance === target) currentPageInstance = void 0;
-}
-function runInPageScrollHook(target, task) {
-	var _PAGE_SCROLL_HOOK_DEP;
-	target[PAGE_SCROLL_HOOK_DEPTH_KEY] = Number((_PAGE_SCROLL_HOOK_DEP = target[PAGE_SCROLL_HOOK_DEPTH_KEY]) !== null && _PAGE_SCROLL_HOOK_DEP !== void 0 ? _PAGE_SCROLL_HOOK_DEP : 0) + 1;
-	try {
-		return task();
-	} finally {
-		var _PAGE_SCROLL_HOOK_DEP2;
-		const nextDepth = Number((_PAGE_SCROLL_HOOK_DEP2 = target[PAGE_SCROLL_HOOK_DEPTH_KEY]) !== null && _PAGE_SCROLL_HOOK_DEP2 !== void 0 ? _PAGE_SCROLL_HOOK_DEP2 : 1) - 1;
-		if (nextDepth <= 0) delete target[PAGE_SCROLL_HOOK_DEPTH_KEY];
-		else target[PAGE_SCROLL_HOOK_DEPTH_KEY] = nextDepth;
-	}
-}
-function resolvePageOptions(target) {
-	const direct = target.options;
-	if (direct && typeof direct === "object") return direct;
-	if (typeof getCurrentPages === "function") {
-		const pages = getCurrentPages();
-		const page = Array.isArray(pages) ? pages.at(-1) : void 0;
-		const options = page && typeof page === "object" ? page.options : void 0;
-		if (options && typeof options === "object") return options;
-	}
-	return {};
-}
-function ensureWxPatched() {
-	if (wxPatched) return;
-	wxPatched = true;
-	const wxGlobal = getMiniProgramGlobalObject();
-	if (!wxGlobal || typeof wxGlobal !== "object") return;
-	const rawStartPullDownRefresh = wxGlobal.startPullDownRefresh;
-	if (typeof rawStartPullDownRefresh === "function") wxGlobal.startPullDownRefresh = function startPullDownRefreshPatched(...args) {
-		const result = rawStartPullDownRefresh.apply(this, args);
-		if (currentPageInstance) callHookList(currentPageInstance, "onPullDownRefresh", []);
-		return result;
-	};
-	const rawPageScrollTo = wxGlobal.pageScrollTo;
-	if (typeof rawPageScrollTo === "function") wxGlobal.pageScrollTo = function pageScrollToPatched(options, ...rest) {
-		const result = rawPageScrollTo.apply(this, [options, ...rest]);
-		if (currentPageInstance) {
-			const pageInstance = currentPageInstance;
-			runInPageScrollHook(pageInstance, () => {
-				callHookList(pageInstance, "onPageScroll", [options !== null && options !== void 0 ? options : {}]);
-			});
-		}
-		return result;
-	};
-}
-function ensurePageShareMenus(options) {
-	const { enableOnShareAppMessage, enableOnShareTimeline } = options;
-	if (!enableOnShareAppMessage && !enableOnShareTimeline) return;
-	const wxGlobal = getMiniProgramGlobalObject();
-	if (!wxGlobal || typeof wxGlobal.showShareMenu !== "function") return;
-	const showMenu = (payload) => {
-		try {
-			wxGlobal.showShareMenu(payload);
-		} catch (_unused) {}
-	};
-	if (!(enableOnShareAppMessage || enableOnShareTimeline)) return;
-	const menus = ["shareAppMessage"];
-	if (enableOnShareTimeline) menus.push("shareTimeline");
-	showMenu({
-		withShareTicket: true,
-		menus
-	});
-}
-//#endregion
 //#region src/runtime/register/component/lifecycle/optionalHooks.ts
 function attachOptionalPageLifecycleHooks(pageLifecycleHooks, options) {
 	const { enableOnSaveExitState, enableOnPullDownRefresh, enableOnReachBottom, enableOnPageScroll, enableOnRouteDone, enableOnTabItemTap, enableOnResize, enableOnShareAppMessage, enableOnShareTimeline, enableOnAddToFavorites, effectiveOnSaveExitState, effectiveOnPullDownRefresh, effectiveOnReachBottom, effectiveOnPageScroll, effectiveOnRouteDone, effectiveOnTabItemTap, effectiveOnResize, effectiveOnShareAppMessage, effectiveOnShareTimeline, effectiveOnAddToFavorites, hasHook } = options;
@@ -3532,6 +3630,7 @@ function prepareComponentOptions(mpOptions) {
 		"definitionFilter",
 		"export",
 		"__wevuTemplateRefs",
+		"__wevuLayoutHosts",
 		"setupLifecycle",
 		"features",
 		"__wevu_isPage"
@@ -3580,6 +3679,8 @@ function prepareComponentOptions(mpOptions) {
 	}
 	const templateRefs = restOptions.__wevuTemplateRefs;
 	delete restOptions.__wevuTemplateRefs;
+	const layoutHosts = restOptions.__wevuLayoutHosts;
+	delete restOptions.__wevuLayoutHosts;
 	const userObservers = restOptions.observers;
 	const setupLifecycle = restOptions.setupLifecycle === "created" ? "created" : "attached";
 	delete restOptions.setupLifecycle;
@@ -3599,6 +3700,7 @@ function prepareComponentOptions(mpOptions) {
 		restOptions,
 		topLevelMethods,
 		templateRefs,
+		layoutHosts,
 		userObservers,
 		setupLifecycle,
 		legacyCreated,
@@ -3742,72 +3844,233 @@ function createPropsSync(options) {
 	};
 }
 //#endregion
-//#region src/runtime/pageLayout.ts
-const PAGE_LAYOUT_SETTER_KEY = "__wevuSetPageLayout";
-const NO_LAYOUT_RUNTIME_KEY = "__wv_no_layout";
+//#region src/runtime/layoutBridge.ts
+const pageLayoutBridges = /* @__PURE__ */ new Map();
+const layoutBridgePageKeys = "__wevuLayoutBridgePageKeys";
+const LEADING_SLASH_RE = /^\/+/;
 function resolveCurrentPageInstance() {
 	const getCurrentPagesFn = globalThis.getCurrentPages;
 	if (typeof getCurrentPagesFn !== "function") return;
 	return getCurrentPagesFn().at(-1);
 }
-function normalizeRuntimePageLayoutName(layout) {
-	return layout === NO_LAYOUT_RUNTIME_KEY ? false : layout;
+function normalizeSelectors(selectors) {
+	return Array.from(new Set(Array.isArray(selectors) ? selectors : [selectors])).filter((selector) => typeof selector === "string" && selector.length > 0);
+}
+function resolvePageKeys(page) {
+	const keys = [];
+	if (!page || typeof page !== "object") return keys;
+	const webviewId = page.__wxWebviewId__;
+	if (typeof webviewId === "number" || typeof webviewId === "string") keys.push(`webview:${String(webviewId)}`);
+	const exparserNodeId = page.__wxExparserNodeId__;
+	if (typeof exparserNodeId === "number" || typeof exparserNodeId === "string") keys.push(`exparser:${String(exparserNodeId)}`);
+	const route = typeof page.route === "string" ? page.route.replace(LEADING_SLASH_RE, "") : "";
+	if (route) keys.push(`route:${route}`);
+	return Array.from(new Set(keys));
+}
+function resolvePageFromContext(context) {
+	if (context && typeof context.__wevuSetPageLayout === "function") return context;
+	return resolveCurrentPageInstance();
+}
+function resolveNativeLayoutContext(context) {
+	var _context$__wevu, _context$$state;
+	if (!context || typeof context !== "object") return;
+	const runtimeNativeInstance = (_context$__wevu = context.__wevu) === null || _context$__wevu === void 0 || (_context$__wevu = _context$__wevu.state) === null || _context$__wevu === void 0 ? void 0 : _context$__wevu.__wevuNativeInstance;
+	if (runtimeNativeInstance && typeof runtimeNativeInstance === "object") return runtimeNativeInstance;
+	const stateNativeInstance = (_context$$state = context.$state) === null || _context$$state === void 0 ? void 0 : _context$$state.__wevuNativeInstance;
+	if (stateNativeInstance && typeof stateNativeInstance === "object") return stateNativeInstance;
+	if (context.__wevuNativeInstance && typeof context.__wevuNativeInstance === "object") return context.__wevuNativeInstance;
+	return context;
+}
+function resolveHostEntry(entry) {
+	if (typeof entry === "function") return entry();
+	if (isRef(entry)) return entry.value;
+	return entry;
+}
+function findLayoutHostBinding(bindings, key) {
+	return bindings.find((binding) => binding.key === key);
+}
+function safeSelectComponent(target, selector) {
+	const selectComponent = target === null || target === void 0 ? void 0 : target.selectComponent;
+	if (typeof selectComponent !== "function") return null;
+	try {
+		var _selectComponent$call;
+		return (_selectComponent$call = selectComponent.call(target, selector)) !== null && _selectComponent$call !== void 0 ? _selectComponent$call : null;
+	} catch (_unused) {
+		return null;
+	}
+}
+function resolveDeclaredLayoutHostFromRefs(binding, context) {
+	var _ref, _context$__wevu$state, _context$__wevu2, _context$$state2, _refMap$get$value, _refMap$get;
+	if (!binding.refName) return null;
+	const refMap = getTemplateRefMap(context);
+	const stateRefs = (_ref = (_context$__wevu$state = (_context$__wevu2 = context.__wevu) === null || _context$__wevu2 === void 0 || (_context$__wevu2 = _context$__wevu2.state) === null || _context$__wevu2 === void 0 ? void 0 : _context$__wevu2.$refs) !== null && _context$__wevu$state !== void 0 ? _context$__wevu$state : (_context$$state2 = context.$state) === null || _context$$state2 === void 0 ? void 0 : _context$$state2.$refs) !== null && _ref !== void 0 ? _ref : context.$refs;
+	const refValue = (_refMap$get$value = refMap === null || refMap === void 0 || (_refMap$get = refMap.get(binding.refName)) === null || _refMap$get === void 0 ? void 0 : _refMap$get.value) !== null && _refMap$get$value !== void 0 ? _refMap$get$value : stateRefs === null || stateRefs === void 0 ? void 0 : stateRefs[binding.refName];
+	if (Array.isArray(refValue)) {
+		var _refValue$;
+		return (_refValue$ = refValue[0]) !== null && _refValue$ !== void 0 ? _refValue$ : null;
+	}
+	return refValue !== null && refValue !== void 0 ? refValue : null;
+}
+function createDeclaredLayoutHostBridge(bindings, context) {
+	const nativeContext = resolveNativeLayoutContext(context);
+	const bridgeBase = nativeContext && typeof nativeContext === "object" ? Object.create(nativeContext) : {};
+	return Object.assign(bridgeBase, { selectComponent(key) {
+		const binding = findLayoutHostBinding(bindings, key);
+		if (!binding) return null;
+		if (binding.kind === "component" || !binding.kind) {
+			var _ref2, _safeSelectComponent;
+			const cachedHost = resolveDeclaredLayoutHostFromRefs(binding, context);
+			if (cachedHost) return cachedHost;
+			return (_ref2 = (_safeSelectComponent = safeSelectComponent(nativeContext, binding.selector)) !== null && _safeSelectComponent !== void 0 ? _safeSelectComponent : safeSelectComponent(resolveCurrentPageInstance(), binding.selector)) !== null && _ref2 !== void 0 ? _ref2 : null;
+		}
+		return null;
+	} });
 }
 /**
-* 获取当前页面 layout 状态。
+* 为当前页面注册 layout bridge，使页面或子组件可消费 layout 内部能力。
 */
-function usePageLayout() {
-	var _currentInstance$__we, _runtimeState$__wv_pa;
-	if (!getCurrentSetupContext()) throw new Error("usePageLayout() 必须在 setup() 的同步阶段调用");
-	const currentInstance = getCurrentInstance();
-	const runtimeState = currentInstance === null || currentInstance === void 0 || (_currentInstance$__we = currentInstance.__wevu) === null || _currentInstance$__we === void 0 ? void 0 : _currentInstance$__we.state;
-	const pageLayoutState = reactive({
-		name: normalizeRuntimePageLayoutName(runtimeState === null || runtimeState === void 0 ? void 0 : runtimeState.__wv_page_layout_name),
-		props: { ...(_runtimeState$__wv_pa = runtimeState === null || runtimeState === void 0 ? void 0 : runtimeState.__wv_page_layout_props) !== null && _runtimeState$__wv_pa !== void 0 ? _runtimeState$__wv_pa : {} }
+function registerPageLayoutBridge(selectors, context) {
+	const bridgeContext = context !== null && context !== void 0 ? context : getCurrentInstance();
+	const page = resolvePageFromContext(bridgeContext);
+	const pageKeys = resolvePageKeys(page);
+	if (!bridgeContext || !page || pageKeys.length === 0) return false;
+	for (const pageKey of pageKeys) {
+		var _pageLayoutBridges$ge;
+		const registry = (_pageLayoutBridges$ge = pageLayoutBridges.get(pageKey)) !== null && _pageLayoutBridges$ge !== void 0 ? _pageLayoutBridges$ge : /* @__PURE__ */ new Map();
+		for (const selector of normalizeSelectors(selectors)) registry.set(selector, bridgeContext);
+		pageLayoutBridges.set(pageKey, registry);
+	}
+	bridgeContext[layoutBridgePageKeys] = pageKeys;
+	return true;
+}
+/**
+* 移除当前页面的 layout bridge 注册。
+*/
+function unregisterPageLayoutBridge(selectors, context) {
+	var _bridgeContext$layout;
+	const bridgeContext = context !== null && context !== void 0 ? context : getCurrentInstance();
+	const page = resolvePageFromContext(bridgeContext);
+	const pageKeys = (_bridgeContext$layout = bridgeContext === null || bridgeContext === void 0 ? void 0 : bridgeContext[layoutBridgePageKeys]) !== null && _bridgeContext$layout !== void 0 ? _bridgeContext$layout : resolvePageKeys(page);
+	if (!bridgeContext || !Array.isArray(pageKeys) || pageKeys.length === 0) return false;
+	let removed = false;
+	for (const pageKey of pageKeys) {
+		const registry = pageLayoutBridges.get(pageKey);
+		if (!registry) continue;
+		for (const selector of normalizeSelectors(selectors)) if (registry.get(selector) === bridgeContext) {
+			registry.delete(selector);
+			removed = true;
+		}
+		if (registry.size === 0) pageLayoutBridges.delete(pageKey);
+	}
+	delete bridgeContext[layoutBridgePageKeys];
+	return removed;
+}
+/**
+* 解析当前页面已注册的 layout bridge，找不到时回退到传入上下文。
+*/
+function resolveLayoutBridge(selector, fallbackContext) {
+	var _resolveCurrentPageIn, _ref3;
+	const bridgeContext = resolvePageKeys((_resolveCurrentPageIn = resolveCurrentPageInstance()) !== null && _resolveCurrentPageIn !== void 0 ? _resolveCurrentPageIn : resolvePageFromContext(fallbackContext)).map((pageKey) => {
+		var _pageLayoutBridges$ge2;
+		return (_pageLayoutBridges$ge2 = pageLayoutBridges.get(pageKey)) === null || _pageLayoutBridges$ge2 === void 0 ? void 0 : _pageLayoutBridges$ge2.get(selector);
+	}).find(Boolean);
+	return (_ref3 = bridgeContext !== null && bridgeContext !== void 0 ? bridgeContext : fallbackContext) !== null && _ref3 !== void 0 ? _ref3 : getCurrentInstance();
+}
+/**
+* 解析当前页面 layout 内通过指定 key 暴露的宿主实例。
+*/
+function resolveLayoutHost(key, options = {}) {
+	var _options$context, _bridge$selectCompone;
+	const bridge = resolveLayoutBridge(key, (_options$context = options.context) !== null && _options$context !== void 0 ? _options$context : options.fallbackContext);
+	const host = bridge === null || bridge === void 0 || (_bridge$selectCompone = bridge.selectComponent) === null || _bridge$selectCompone === void 0 ? void 0 : _bridge$selectCompone.call(bridge, key);
+	return host !== null && host !== void 0 ? host : null;
+}
+/**
+* 等待当前页面 layout 宿主实例可用，适合页面初次进入时的异步宿主解析。
+*/
+function waitForLayoutHost(key, options = {}) {
+	var _options$retries, _options$interval;
+	const retries = (_options$retries = options.retries) !== null && _options$retries !== void 0 ? _options$retries : 20;
+	const interval = (_options$interval = options.interval) !== null && _options$interval !== void 0 ? _options$interval : 16;
+	const host = resolveLayoutHost(key, options);
+	if (host || retries <= 0) return Promise.resolve(host);
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			resolve(waitForLayoutHost(key, {
+				...options,
+				retries: retries - 1
+			}));
+		}, interval);
 	});
-	if (currentInstance) currentInstance.__wevuPageLayoutState = pageLayoutState;
-	return readonly(pageLayoutState);
 }
-function syncRuntimePageLayoutState(target, layout, props) {
-	const state = target.__wevuPageLayoutState;
-	if (!state) return;
-	state.name = layout;
-	state.props = { ...props };
+/**
+* 在 layout 生命周期内暴露 bridge，使页面或子组件可访问 layout 内部实例。
+*/
+function useLayoutBridge(selectors, options = {}) {
+	if (!getCurrentSetupContext()) throw new Error("useLayoutBridge() 必须在 setup() 的同步阶段调用");
+	const context = getCurrentInstance();
+	const normalizedSelectors = normalizeSelectors(selectors);
+	const resolveComponent = options.resolveComponent;
+	const nativeContext = resolveNativeLayoutContext(context);
+	const bridgeBase = nativeContext && typeof nativeContext === "object" ? Object.create(nativeContext) : {};
+	const bridge = Object.assign(bridgeBase, { selectComponent(selector) {
+		var _nativeContext$select, _currentPage$selectCo, _currentPage$selectCo2;
+		if (!normalizedSelectors.includes(selector)) return null;
+		const resolvedComponent = resolveComponent === null || resolveComponent === void 0 ? void 0 : resolveComponent(selector);
+		if (resolvedComponent !== void 0) return resolvedComponent;
+		const nativeContext = resolveNativeLayoutContext(context);
+		const directMatch = nativeContext === null || nativeContext === void 0 || (_nativeContext$select = nativeContext.selectComponent) === null || _nativeContext$select === void 0 ? void 0 : _nativeContext$select.call(nativeContext, selector);
+		if (directMatch) return directMatch;
+		const currentPage = resolveCurrentPageInstance();
+		return (_currentPage$selectCo = currentPage === null || currentPage === void 0 || (_currentPage$selectCo2 = currentPage.selectComponent) === null || _currentPage$selectCo2 === void 0 ? void 0 : _currentPage$selectCo2.call(currentPage, selector)) !== null && _currentPage$selectCo !== void 0 ? _currentPage$selectCo : null;
+	} });
+	registerPageLayoutBridge(normalizedSelectors, bridge);
+	onAttached(() => {
+		registerPageLayoutBridge(normalizedSelectors, bridge);
+	});
+	onDetached(() => {
+		unregisterPageLayoutBridge(normalizedSelectors, bridge);
+	});
 }
-function syncRuntimePageLayoutStateFromRuntime(target) {
-	var _target$__wevu, _runtimeState$__wv_pa2;
-	const state = target.__wevuPageLayoutState;
-	const runtimeState = (_target$__wevu = target.__wevu) === null || _target$__wevu === void 0 ? void 0 : _target$__wevu.state;
-	if (!state || !runtimeState) return;
-	state.name = normalizeRuntimePageLayoutName(runtimeState.__wv_page_layout_name);
-	state.props = { ...(_runtimeState$__wv_pa2 = runtimeState.__wv_page_layout_props) !== null && _runtimeState$__wv_pa2 !== void 0 ? _runtimeState$__wv_pa2 : {} };
+/**
+* 使用编译期注入的宿主绑定信息，直接从当前 layout 运行时实例解析子组件宿主并注册 bridge。
+*/
+function registerRuntimeLayoutHosts(bindings, context) {
+	if (!bindings.length) return null;
+	const bridgeContext = context !== null && context !== void 0 ? context : getCurrentInstance();
+	if (!bridgeContext) return null;
+	const bridge = createDeclaredLayoutHostBridge(bindings, bridgeContext);
+	registerPageLayoutBridge(bindings.map((binding) => binding.key), bridge);
+	return bridge;
 }
 /**
-* 显式切换当前页面使用的 layout。
+* 移除运行时自动注册的 layout 宿主 bridge。
 */
-function setPageLayout(layout, props) {
-	const currentInstance = getCurrentInstance();
-	const directSetter = currentInstance === null || currentInstance === void 0 ? void 0 : currentInstance[PAGE_LAYOUT_SETTER_KEY];
-	if (typeof directSetter === "function") {
-		directSetter(layout, props);
-		return;
-	}
-	const currentPage = resolveCurrentPageInstance();
-	const pageSetter = currentPage === null || currentPage === void 0 ? void 0 : currentPage[PAGE_LAYOUT_SETTER_KEY];
-	if (typeof pageSetter === "function") {
-		pageSetter(layout, props);
-		return;
-	}
-	throw new Error("setPageLayout() 未找到当前页面实例。请在页面 setup()、事件回调或当前页面上下文中调用。");
+function unregisterRuntimeLayoutHosts(bindings, context) {
+	if (!bindings.length) return false;
+	const bridgeContext = context !== null && context !== void 0 ? context : getCurrentInstance();
+	if (!bridgeContext) return false;
+	return unregisterPageLayoutBridge(bindings.map((binding) => binding.key), bridgeContext);
 }
-function resolveRuntimePageLayoutName(layout) {
-	return layout === false ? NO_LAYOUT_RUNTIME_KEY : layout;
+/**
+* 使用 key -> 宿主实例的映射批量暴露 layout 内部宿主，适合 toast/dialog 等共享反馈节点。
+*/
+function useLayoutHosts(hosts) {
+	useLayoutBridge(Object.keys(hosts), { resolveComponent(key) {
+		return resolveHostEntry(hosts[key]);
+	} });
 }
 //#endregion
 //#region src/runtime/register/component/registerDefinition.ts
 function registerComponentDefinition(options) {
-	const { runtimeApp, watch, setup, restOptions, pageLifecycleHooks, finalObservers, userLifetimes, userPageLifetimes, finalMethods, finalOptions, applyExtraInstanceFields, templateRefs, attachWevuPropKeys, setupLifecycle, syncWevuPropsFromInstance, isPage, legacyCreated, getRuntimeOwnerLabel } = options;
+	const { runtimeApp, watch, setup, restOptions, pageLifecycleHooks, finalObservers, userLifetimes, userPageLifetimes, finalMethods, finalOptions, applyExtraInstanceFields, templateRefs, layoutHosts, attachWevuPropKeys, setupLifecycle, syncWevuPropsFromInstance, isPage, legacyCreated, getRuntimeOwnerLabel } = options;
 	const pageShareMethodBridges = {};
+	const attachRuntimeLayoutHosts = (instance) => {
+		if (!Array.isArray(layoutHosts) || !layoutHosts.length) return;
+		if (instance.__wevuLayoutHostBridge) return;
+		const bridge = registerRuntimeLayoutHosts(layoutHosts, instance);
+		if (bridge) instance.__wevuLayoutHostBridge = bridge;
+	};
 	const attachPageLayoutSetter = (instance) => {
 		if (!isPage) return;
 		instance.__wevuSetPageLayout = (layout, props) => {
@@ -3881,6 +4144,7 @@ function registerComponentDefinition(options) {
 				}
 				syncWevuPropsFromInstance(this);
 				attachPageLayoutSetter(this);
+				attachRuntimeLayoutHosts(this);
 				if (setupLifecycle === "created") enableDeferredSetData(this);
 				callHookList(this, "onAttached", args);
 				if (typeof userLifetimes.attached === "function") userLifetimes.attached.apply(this, args);
@@ -3910,6 +4174,10 @@ function registerComponentDefinition(options) {
 					return;
 				}
 				clearTemplateRefs(this);
+				if (Array.isArray(layoutHosts) && layoutHosts.length && this.__wevuLayoutHostBridge) {
+					unregisterRuntimeLayoutHosts(layoutHosts, this.__wevuLayoutHostBridge);
+					delete this.__wevuLayoutHostBridge;
+				}
 				teardownRuntimeInstance(this);
 				if (typeof userLifetimes.detached === "function") userLifetimes.detached.apply(this, args);
 			},
@@ -3974,7 +4242,7 @@ function registerComponentDefinition(options) {
 */
 function registerComponent(runtimeApp, methods, watch, setup, mpOptions) {
 	var _multipleSlots;
-	const { userMethods, userLifetimes, userPageLifetimes, userOptions, restOptions, topLevelMethods, templateRefs, userObservers, setupLifecycle, legacyCreated, isPage, features, userOnLoad, userOnUnload, userOnShow, userOnHide, userOnReady, userOnSaveExitState, userOnPullDownRefresh, userOnReachBottom, userOnPageScroll, userOnRouteDone, userOnTabItemTap, userOnResize, userOnShareAppMessage, userOnShareTimeline, userOnAddToFavorites, applyExtraInstanceFields } = prepareComponentOptions(mpOptions);
+	const { userMethods, userLifetimes, userPageLifetimes, userOptions, restOptions, topLevelMethods, templateRefs, layoutHosts, userObservers, setupLifecycle, legacyCreated, isPage, features, userOnLoad, userOnUnload, userOnShow, userOnHide, userOnReady, userOnSaveExitState, userOnPullDownRefresh, userOnReachBottom, userOnPageScroll, userOnRouteDone, userOnTabItemTap, userOnResize, userOnShareAppMessage, userOnShareTimeline, userOnAddToFavorites, applyExtraInstanceFields } = prepareComponentOptions(mpOptions);
 	const { enableOnPullDownRefresh, enableOnReachBottom, enableOnPageScroll, enableOnRouteDone, enableOnRouteDoneFallback, enableOnTabItemTap, enableOnResize, enableOnShareAppMessage, enableOnShareTimeline, enableOnAddToFavorites, enableOnSaveExitState, effectiveOnSaveExitState, effectiveOnPullDownRefresh, effectiveOnReachBottom, effectiveOnPageScroll, effectiveOnRouteDone, effectiveOnTabItemTap, effectiveOnResize, effectiveOnShareAppMessage, effectiveOnShareTimeline, effectiveOnAddToFavorites } = resolveComponentFeatures({
 		features,
 		userOnSaveExitState,
@@ -4069,6 +4337,7 @@ function registerComponent(runtimeApp, methods, watch, setup, mpOptions) {
 		finalOptions,
 		applyExtraInstanceFields,
 		templateRefs,
+		layoutHosts,
 		attachWevuPropKeys,
 		setupLifecycle,
 		syncWevuPropsFromInstance,
@@ -4990,4 +5259,4 @@ function useTemplateRef(name) {
 	return target;
 }
 //#endregion
-export { addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, customRef, defineComponent, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, hasInjectionContext, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, normalizeClass, normalizeStyle, onActivated, onAddToFavorites, onAttached, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onDetached, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMemoryWarning, 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, resolveRuntimePageLayoutName, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setPageLayout, setRuntimeSetDataVisibility, setWevuDefaults, shallowReactive, shallowReadonly, shallowRef, startBatch, stop, storeToRefs, syncRuntimePageLayoutState, syncRuntimePageLayoutStateFromRuntime, teardownRuntimeInstance, toRaw, toRef, toRefs, toValue, touchReactive, traverse, triggerRef, unref, useAttrs, useBindModel, useDisposables, useIntersectionObserver, useModel, useNativeInstance, useNativePageRouter, useNativeRouter, usePageLayout, usePageScrollThrottle, useSlots, useTemplateRef, useUpdatePerformanceListener, watch, watchEffect };
+export { addMutationRecorder, batch, callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, createWevuScopedSlotComponent, customRef, defineComponent, defineStore, effect, effectScope, endBatch, getCurrentInstance, getCurrentScope, getCurrentSetupContext, getDeepWatchStrategy, getReactiveVersion, hasInjectionContext, inject, injectGlobal, isNoSetData, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markNoSetData, markRaw, mergeModels, mountRuntimeInstance, nextTick, normalizeClass, normalizeStyle, onActivated, onAddToFavorites, onAttached, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onDetached, onError, onErrorCaptured, onHide, onLaunch, onLoad, onMemoryWarning, 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, registerPageLayoutBridge, registerRuntimeLayoutHosts, removeMutationRecorder, resetWevuDefaults, resolveLayoutBridge, resolveLayoutHost, resolveRuntimePageLayoutName, runSetupFunction, setCurrentInstance, setCurrentSetupContext, setDeepWatchStrategy, setPageLayout, setRuntimeSetDataVisibility, setWevuDefaults, shallowReactive, shallowReadonly, shallowRef, startBatch, stop, storeToRefs, syncRuntimePageLayoutState, syncRuntimePageLayoutStateFromRuntime, teardownRuntimeInstance, toRaw, toRef, toRefs, toValue, touchReactive, traverse, triggerRef, unref, unregisterPageLayoutBridge, unregisterRuntimeLayoutHosts, useAttrs, useBindModel, useDisposables, useIntersectionObserver, useLayoutBridge, useLayoutHosts, useModel, useNativeInstance, useNativePageRouter, useNativeRouter, usePageLayout, usePageScrollThrottle, useSlots, useTemplateRef, useUpdatePerformanceListener, waitForLayoutHost, watch, watchEffect };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wevu",
   "type": "module",
-  "version": "6.11.1",
+  "version": "6.11.4",
   "description": "Vue 3 风格的小程序运行时，包含响应式、diff+setData 与轻量状态管理",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -96,7 +96,7 @@
   "dependencies": {
     "vue": "^3.5.30",
     "@wevu/api": "0.2.2",
-    "@wevu/compiler": "6.11.1"
+    "@wevu/compiler": "6.11.4"
   },
   "scripts": {
     "dev": "tsdown -w",