wevu 0.0.1 → 1.0.0-alpha.1

package/dist/index.cjs

@@ -1,8 +1,8 @@
-const require_ref = require('./ref-DtCdcykK.cjs');
+const require_store = require('./store-Cmw9vWBT.cjs');
 
 //#region src/reactivity/readonly.ts
 function readonly(target) {
-	if (require_ref.isRef(target)) {
+	if (require_store.isRef(target)) {
 		const source = target;
 		return {
 			get value() {
@@ -13,7 +13,7 @@ function readonly(target) {
 			}
 		};
 	}
-	if (!require_ref.isObject(target)) return target;
+	if (!require_store.isObject(target)) return target;
 	return new Proxy(target, {
 		set() {
 			throw new Error("Cannot set property on readonly object");
@@ -30,10 +30,81 @@ function readonly(target) {
 	});
 }
 
+//#endregion
+//#region src/reactivity/shallowRef.ts
+function shallowRef(value, defaultValue) {
+	return require_store.customRef((track, trigger) => ({
+		get() {
+			track();
+			return value;
+		},
+		set(newValue) {
+			if (Object.is(value, newValue)) return;
+			value = newValue;
+			trigger();
+		}
+	}), defaultValue);
+}
+/**
+* 判断传入值是否为浅层 ref。
+*
+* @param r 待判断的值
+* @returns 若为浅层 ref 则返回 true
+*/
+function isShallowRef(r) {
+	return r && typeof r === "object" && "value" in r && typeof r.value !== "function";
+}
+/**
+* 主动触发一次浅层 ref 的更新（无需深度比较）。
+*
+* @param ref 需要触发的 ref
+*/
+function triggerRef(ref$1) {
+	if (ref$1 && typeof ref$1 === "object" && "value" in ref$1) ref$1.value = ref$1.value;
+}
+
+//#endregion
+//#region src/reactivity/toRefs.ts
+/**
+* 将一个响应式对象转换成“同结构的普通对象”，其中每个字段都是指向原对象对应属性的 ref。
+*
+* @param object 待转换的响应式对象
+* @returns 包含若干 ref 的普通对象
+*
+* @example
+* ```ts
+* const state = reactive({ foo: 1, bar: 2 })
+* const stateAsRefs = toRefs(state)
+*
+* stateAsRefs.foo.value++ // 2
+* state.foo // 2
+* ```
+*/
+function toRefs(object) {
+	if (!require_store.isReactive(object)) console.warn(`toRefs() expects a reactive object but received a plain one.`);
+	const result = Array.isArray(object) ? Array.from({ length: object.length }) : {};
+	for (const key in object) result[key] = toRef(object, key);
+	return result;
+}
+function toRef(object, key, defaultValue) {
+	const value = object[key];
+	if (require_store.isRef(value)) return value;
+	return require_store.customRef((track, trigger) => ({
+		get() {
+			track();
+			return object[key];
+		},
+		set(newValue) {
+			object[key] = newValue;
+			trigger();
+		}
+	}), defaultValue);
+}
+
 //#endregion
 //#region src/reactivity/traverse.ts
 function traverse(value, seen = /* @__PURE__ */ new Set()) {
-	if (!require_ref.isObject(value) || seen.has(value)) return value;
+	if (!require_store.isObject(value) || seen.has(value)) return value;
 	seen.add(value);
 	for (const key in value) traverse(value[key], seen);
 	return value;
@@ -51,15 +122,15 @@ function getDeepWatchStrategy() {
 function watch(source, cb, options = {}) {
 	let getter;
 	if (typeof source === "function") getter = source;
-	else if (require_ref.isRef(source)) getter = () => source.value;
-	else if (require_ref.isReactive(source)) getter = () => source;
+	else if (require_store.isRef(source)) getter = () => source.value;
+	else if (require_store.isReactive(source)) getter = () => source;
 	else throw new Error("Invalid watch source");
 	if (options.deep) {
 		const baseGetter = getter;
 		getter = () => {
 			const val = baseGetter();
-			if (__deepWatchStrategy === "version" && require_ref.isReactive(val)) {
-				require_ref.touchReactive(val);
+			if (__deepWatchStrategy === "version" && require_store.isReactive(val)) {
+				require_store.touchReactive(val);
 				return val;
 			}
 			return traverse(val);
@@ -78,37 +149,37 @@ function watch(source, cb, options = {}) {
 		cb(newValue, oldValue, onCleanup);
 		oldValue = newValue;
 	};
-	runner = require_ref.effect(() => getter(), {
-		scheduler: () => require_ref.queueJob(job),
+	runner = require_store.effect(() => getter(), {
+		scheduler: () => require_store.queueJob(job),
 		lazy: true
 	});
 	if (options.immediate) job();
 	else oldValue = runner();
 	return () => {
 		cleanup?.();
-		require_ref.stop(runner);
+		require_store.stop(runner);
 	};
 }
 /**
-* watchEffect registers a reactive effect with optional cleanup.
-* The effect executes immediately and re-runs when its dependencies change.
+* watchEffect 注册一个响应式副作用，可选清理函数。
+* 副作用会立即执行，并在依赖变化时重新运行。
 */
 function watchEffect(effectFn) {
 	let cleanup;
 	const onCleanup = (fn) => {
 		cleanup = fn;
 	};
-	const runner = require_ref.effect(() => {
+	const runner = require_store.effect(() => {
 		cleanup?.();
 		cleanup = void 0;
 		effectFn(onCleanup);
-	}, { scheduler: () => require_ref.queueJob(() => {
+	}, { scheduler: () => require_store.queueJob(() => {
 		if (runner.active) runner();
 	}) });
 	runner();
 	return () => {
 		cleanup?.();
-		require_ref.stop(runner);
+		require_store.stop(runner);
 	};
 }
 
@@ -218,9 +289,9 @@ function isPlainObject(value) {
 	return proto === null || proto === Object.prototype;
 }
 function toPlain(value, seen = /* @__PURE__ */ new WeakMap()) {
-	const unwrapped = require_ref.unref(value);
+	const unwrapped = require_store.unref(value);
 	if (typeof unwrapped !== "object" || unwrapped === null) return unwrapped;
-	const raw = require_ref.isReactive(unwrapped) ? require_ref.toRaw(unwrapped) : unwrapped;
+	const raw = require_store.isReactive(unwrapped) ? require_store.toRaw(unwrapped) : unwrapped;
 	if (seen.has(raw)) return seen.get(raw);
 	if (Array.isArray(raw)) {
 		const arr = [];
@@ -397,9 +468,114 @@ function onAddToFavorites(handler) {
 	if (!__currentInstance) throw new Error("onAddToFavorites() must be called synchronously inside setup()");
 	pushHook(__currentInstance, "onAddToFavorites", handler, { single: true });
 }
+/**
+* Vue 3 对齐：组件/页面已挂载，映射小程序 onReady
+*/
+function onMounted(handler) {
+	if (!__currentInstance) throw new Error("onMounted() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "onReady", handler);
+}
+/**
+* Vue 3 对齐：组件/页面更新后触发。
+* 小程序没有专用 update 生命周期，这里在每次 setData 完成后调用。
+*/
+function onUpdated(handler) {
+	if (!__currentInstance) throw new Error("onUpdated() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "__wevuOnUpdated", handler);
+}
+/**
+* Vue 3 对齐：卸载前触发。
+* 小程序无 before-unload 生命周期，setup 时同步执行以保持语义。
+*/
+function onBeforeUnmount(handler) {
+	if (!__currentInstance) throw new Error("onBeforeUnmount() must be called synchronously inside setup()");
+	handler();
+}
+/**
+* Vue 3 对齐：组件/页面卸载；映射到页面 onUnload 或组件 detached
+*/
+function onUnmounted(handler) {
+	if (!__currentInstance) throw new Error("onUnmounted() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "onUnload", handler);
+}
+/**
+* Vue 3 对齐：挂载前；setup 时同步触发以模拟 beforeMount 语义
+*/
+function onBeforeMount(handler) {
+	if (!__currentInstance) throw new Error("onBeforeMount() must be called synchronously inside setup()");
+	handler();
+}
+/**
+* Vue 3 对齐：更新前；在每次 setData 前触发
+*/
+function onBeforeUpdate(handler) {
+	if (!__currentInstance) throw new Error("onBeforeUpdate() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "__wevuOnBeforeUpdate", handler);
+}
+/**
+* Vue 3 对齐：错误捕获；映射到小程序 onError
+*/
+function onErrorCaptured(handler) {
+	if (!__currentInstance) throw new Error("onErrorCaptured() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "onAppError", (err) => handler(err, __currentInstance, ""));
+}
+/**
+* Vue 3 对齐：组件激活；映射到小程序 onShow
+*/
+function onActivated(handler) {
+	if (!__currentInstance) throw new Error("onActivated() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "onShow", handler);
+}
+/**
+* Vue 3 对齐：组件失活；映射到小程序 onHide
+*/
+function onDeactivated(handler) {
+	if (!__currentInstance) throw new Error("onDeactivated() must be called synchronously inside setup()");
+	pushHook(__currentInstance, "onHide", handler);
+}
+/**
+* Vue 3 对齐：服务端渲染前置钩子。
+* 小程序无此场景，保留空实现以保持 API 兼容。
+*/
+function onServerPrefetch(_handler) {
+	if (!__currentInstance) throw new Error("onServerPrefetch() must be called synchronously inside setup()");
+}
+function callUpdateHooks(target, phase) {
+	callHookList(target, phase === "before" ? "__wevuOnBeforeUpdate" : "__wevuOnUpdated");
+}
 
 //#endregion
 //#region src/runtime/register.ts
+function runInlineExpression(ctx, expr, event) {
+	const handlerName = typeof expr === "string" ? expr : void 0;
+	if (!handlerName) return;
+	const argsRaw = (event?.currentTarget)?.dataset?.wvArgs ?? (event?.target)?.dataset?.wvArgs;
+	let args = [];
+	if (typeof argsRaw === "string") try {
+		args = JSON.parse(argsRaw);
+	} catch {
+		args = [];
+	}
+	const resolvedArgs = args.map((item) => item === "$event" ? event : item);
+	const handler = ctx?.[handlerName];
+	if (typeof handler === "function") return handler.apply(ctx, resolvedArgs);
+}
+function runSetupFunction(setup, props, context) {
+	if (typeof setup !== "function") return;
+	const runtimeContext = context?.runtime ?? {
+		methods: Object.create(null),
+		state: {},
+		proxy: {},
+		watch: () => () => {},
+		bindModel: () => {}
+	};
+	if (context) context.runtime = runtimeContext;
+	const finalContext = {
+		...context ?? {},
+		runtime: runtimeContext
+	};
+	return setup.length >= 2 ? setup(props, finalContext) : setup(finalContext);
+}
 function normalizeWatchDescriptor(descriptor, runtime, instance) {
 	if (typeof descriptor === "function") return {
 		handler: descriptor.bind(runtime.proxy),
@@ -449,32 +625,58 @@ function registerWatches(runtime, watchMap, instance) {
 	return stops;
 }
 function mountRuntimeInstance(target, runtimeApp, watchMap, setup) {
+	if (target.__wevu) return target.__wevu;
 	const runtime = runtimeApp.mount({ setData(payload) {
 		if (typeof target.setData === "function") target.setData(payload);
 	} });
+	const runtimeProxy = runtime?.proxy ?? {};
+	const runtimeState = runtime?.state ?? {};
+	if (!runtime?.methods) try {
+		runtime.methods = Object.create(null);
+	} catch {}
+	const runtimeMethods = runtime?.methods ?? Object.create(null);
+	const runtimeWatch = runtime?.watch ?? (() => () => {});
+	const runtimeBindModel = runtime?.bindModel ?? (() => {});
+	const runtimeWithDefaults = {
+		...runtime ?? {},
+		state: runtimeState,
+		proxy: runtimeProxy,
+		methods: runtimeMethods,
+		watch: runtimeWatch,
+		bindModel: runtimeBindModel
+	};
 	Object.defineProperty(target, "$wevu", {
-		value: runtime,
+		value: runtimeWithDefaults,
 		configurable: true,
 		enumerable: false,
 		writable: false
 	});
-	target.__wevu = runtime;
+	target.__wevu = runtimeWithDefaults;
 	if (watchMap) {
-		const stops = registerWatches(runtime, watchMap, target);
+		const stops = registerWatches(runtimeWithDefaults, watchMap, target);
 		if (stops.length) target.__wevuWatchStops = stops;
 	}
 	if (setup) {
+		const props = target.properties || {};
 		const context = {
-			runtime,
-			state: runtime.state,
-			proxy: runtime.proxy,
-			bindModel: runtime.bindModel.bind(runtime),
-			watch: runtime.watch.bind(runtime),
-			instance: target
+			props,
+			runtime: runtimeWithDefaults,
+			state: runtimeState,
+			proxy: runtimeProxy,
+			bindModel: runtimeBindModel.bind(runtimeWithDefaults),
+			watch: runtimeWatch.bind(runtimeWithDefaults),
+			instance: target,
+			emit: (event, ...args) => {
+				if (typeof target.triggerEvent === "function") target.triggerEvent(event, ...args);
+			},
+			expose: (exposed) => {
+				target.__wevuExposed = exposed;
+			},
+			attrs: {}
 		};
 		setCurrentInstance(target);
 		try {
-			const result = setup(context);
+			const result = runSetupFunction(setup, props, context);
 			if (result && typeof result === "object") Object.keys(result).forEach((key) => {
 				const val = result[key];
 				if (typeof val === "function") runtime.methods[key] = (...args) => val.apply(runtime.proxy, args);
@@ -495,6 +697,7 @@ function mountRuntimeInstance(target, runtimeApp, watchMap, setup) {
 }
 function teardownRuntimeInstance(target) {
 	const runtime = target.__wevu;
+	if (runtime && target.__wevuHooks) callHookList(target, "onUnload", []);
 	if (target.__wevuHooks) target.__wevuHooks = void 0;
 	const stops = target.__wevuWatchStops;
 	if (Array.isArray(stops)) for (const stop$1 of stops) try {
@@ -510,6 +713,10 @@ function registerApp(runtimeApp, methods, watch$1, setup, mpOptions) {
 	const methodNames = Object.keys(methods ?? {});
 	const appOptions = { ...mpOptions };
 	appOptions.globalData = appOptions.globalData ?? {};
+	if (!appOptions.__weapp_vite_inline) appOptions.__weapp_vite_inline = function __weapp_vite_inline(event) {
+		const expr = event?.currentTarget?.dataset?.wvHandler ?? event?.target?.dataset?.wvHandler;
+		return runInlineExpression(this.__wevu?.proxy ?? this, expr, event);
+	};
 	const userOnLaunch = appOptions.onLaunch;
 	appOptions.onLaunch = function onLaunch(...args) {
 		mountRuntimeInstance(this, runtimeApp, watch$1, setup);
@@ -544,89 +751,38 @@ function registerApp(runtimeApp, methods, watch$1, setup, mpOptions) {
 	}
 	App(appOptions);
 }
-function registerPage(runtimeApp, methods, watch$1, setup, mpOptions, features) {
-	if (typeof Page !== "function") throw new TypeError("definePage requires the global Page constructor to be available");
-	const methodNames = Object.keys(methods ?? {});
-	const pageOptions = { ...mpOptions };
-	const userOnLoad = mpOptions.onLoad;
-	pageOptions.onLoad = function onLoad(...args) {
-		mountRuntimeInstance(this, runtimeApp, watch$1, setup);
-		callHookList(this, "onShow", args);
-		if (typeof userOnLoad === "function") userOnLoad.apply(this, args);
-	};
-	const userOnUnload = mpOptions.onUnload;
-	pageOptions.onUnload = function onUnload$1(...args) {
-		teardownRuntimeInstance(this);
-		if (typeof userOnUnload === "function") userOnUnload.apply(this, args);
+function registerComponent(runtimeApp, methods, watch$1, setup, mpOptions, features) {
+	const { methods: userMethods = {}, lifetimes: userLifetimes = {}, pageLifetimes: userPageLifetimes = {}, options: userOptions = {}, ...rest } = mpOptions;
+	const userOnLoad = rest.onLoad;
+	const userOnUnload = rest.onUnload;
+	const userOnShow = rest.onShow;
+	const userOnHide = rest.onHide;
+	const userOnReady = rest.onReady;
+	const userOnSaveExitState = rest.onSaveExitState;
+	const userOnPageScroll = rest.onPageScroll;
+	const userOnShareAppMessage = rest.onShareAppMessage;
+	const userOnShareTimeline = rest.onShareTimeline;
+	const userOnAddToFavorites = rest.onAddToFavorites;
+	const restOptions = { ...rest };
+	delete restOptions.onLoad;
+	delete restOptions.onUnload;
+	delete restOptions.onShow;
+	delete restOptions.onHide;
+	delete restOptions.onReady;
+	delete restOptions.onSaveExitState;
+	delete restOptions.onPageScroll;
+	delete restOptions.onShareAppMessage;
+	delete restOptions.onShareTimeline;
+	delete restOptions.onAddToFavorites;
+	const finalOptions = {
+		multipleSlots: userOptions.multipleSlots ?? true,
+		...userOptions
 	};
-	const userOnShow = mpOptions.onShow;
-	pageOptions.onShow = function onShow$1(...args) {
-		callHookList(this, "onShow", args);
-		if (typeof userOnShow === "function") userOnShow.apply(this, args);
-	};
-	const userOnHide = mpOptions.onHide;
-	pageOptions.onHide = function onHide$1(...args) {
-		callHookList(this, "onHide", args);
-		if (typeof userOnHide === "function") userOnHide.apply(this, args);
-	};
-	const userOnReady = mpOptions.onReady;
-	pageOptions.onReady = function onReady$1(...args) {
-		callHookList(this, "onReady", args);
-		if (typeof userOnReady === "function") return userOnReady.apply(this, args);
-	};
-	const userOnSaveExitState = mpOptions.onSaveExitState;
-	pageOptions.onSaveExitState = function onSaveExitState$1(...args) {
-		const ret = callHookReturn(this, "onSaveExitState", args);
-		if (ret !== void 0) return ret;
-		if (typeof userOnSaveExitState === "function") return userOnSaveExitState.apply(this, args);
-	};
-	if (features?.listenPageScroll) {
-		const userOnPageScroll = mpOptions.onPageScroll;
-		pageOptions.onPageScroll = function onPageScroll$1(...args) {
-			callHookList(this, "onPageScroll", args);
-			if (typeof userOnPageScroll === "function") return userOnPageScroll.apply(this, args);
-		};
-	}
-	if (features?.enableShareAppMessage) {
-		const userOnShare = mpOptions.onShareAppMessage;
-		pageOptions.onShareAppMessage = function pageOnShareAppMessage(...args) {
-			const ret = callHookReturn(this, "onShareAppMessage", args);
-			if (ret !== void 0) return ret;
-			if (typeof userOnShare === "function") return userOnShare.apply(this, args);
-		};
-	}
-	if (features?.enableShareTimeline) {
-		const userOnShareTimeline = mpOptions.onShareTimeline;
-		pageOptions.onShareTimeline = function pageOnShareTimeline(...args) {
-			const ret = callHookReturn(this, "onShareTimeline", args);
-			if (ret !== void 0) return ret;
-			if (typeof userOnShareTimeline === "function") return userOnShareTimeline.apply(this, args);
-		};
-	}
-	if (features?.enableAddToFavorites) {
-		const userOnAddToFavorites = mpOptions.onAddToFavorites;
-		pageOptions.onAddToFavorites = function pageOnAddToFavorites(...args) {
-			const ret = callHookReturn(this, "onAddToFavorites", args);
-			if (ret !== void 0) return ret;
-			if (typeof userOnAddToFavorites === "function") return userOnAddToFavorites.apply(this, args);
-		};
-	}
-	for (const methodName of methodNames) {
-		const userMethod = mpOptions[methodName];
-		pageOptions[methodName] = function runtimeMethod(...args) {
-			const runtime = this.__wevu;
-			let result;
-			const bound = runtime?.methods?.[methodName];
-			if (bound) result = bound.apply(runtime.proxy, args);
-			if (typeof userMethod === "function") return userMethod.apply(this, args);
-			return result;
-		};
-	}
-	Page(pageOptions);
-}
-function registerComponent(runtimeApp, methods, watch$1, setup, mpOptions) {
-	const { methods: userMethods = {}, lifetimes: userLifetimes = {}, pageLifetimes: userPageLifetimes = {}, ...rest } = mpOptions;
 	const finalMethods = { ...userMethods };
+	if (!finalMethods.__weapp_vite_inline) finalMethods.__weapp_vite_inline = function __weapp_vite_inline(event) {
+		const expr = event?.currentTarget?.dataset?.wvHandler ?? event?.target?.dataset?.wvHandler;
+		return runInlineExpression(this.__wevu?.proxy ?? this, expr, event);
+	};
 	const methodNames = Object.keys(methods ?? {});
 	for (const methodName of methodNames) {
 		const userMethod = finalMethods[methodName];
@@ -648,8 +804,58 @@ function registerComponent(runtimeApp, methods, watch$1, setup, mpOptions) {
 	};
 	wrapSpecial("onTabItemTap");
 	wrapSpecial("onRouteDone");
+	const pageLifecycleHooks = {
+		onLoad(...args) {
+			mountRuntimeInstance(this, runtimeApp, watch$1, setup);
+			if (typeof userOnLoad === "function") return userOnLoad.apply(this, args);
+		},
+		onUnload(...args) {
+			teardownRuntimeInstance(this);
+			if (typeof userOnUnload === "function") return userOnUnload.apply(this, args);
+		},
+		onShow(...args) {
+			callHookList(this, "onShow", args);
+			if (typeof userOnShow === "function") return userOnShow.apply(this, args);
+		},
+		onHide(...args) {
+			callHookList(this, "onHide", args);
+			if (typeof userOnHide === "function") return userOnHide.apply(this, args);
+		},
+		onReady(...args) {
+			if (!this.__wevuReadyCalled) {
+				this.__wevuReadyCalled = true;
+				callHookList(this, "onReady", args);
+			}
+			if (typeof userOnReady === "function") return userOnReady.apply(this, args);
+		},
+		onSaveExitState(...args) {
+			const ret = callHookReturn(this, "onSaveExitState", args);
+			if (ret !== void 0) return ret;
+			if (typeof userOnSaveExitState === "function") return userOnSaveExitState.apply(this, args);
+		}
+	};
+	if (features?.listenPageScroll) pageLifecycleHooks.onPageScroll = function onPageScroll$1(...args) {
+		callHookList(this, "onPageScroll", args);
+		if (typeof userOnPageScroll === "function") return userOnPageScroll.apply(this, args);
+	};
+	if (features?.enableShareAppMessage) pageLifecycleHooks.onShareAppMessage = function onShareAppMessage$1(...args) {
+		const ret = callHookReturn(this, "onShareAppMessage", args);
+		if (ret !== void 0) return ret;
+		if (typeof userOnShareAppMessage === "function") return userOnShareAppMessage.apply(this, args);
+	};
+	if (features?.enableShareTimeline) pageLifecycleHooks.onShareTimeline = function onShareTimeline$1(...args) {
+		const ret = callHookReturn(this, "onShareTimeline", args);
+		if (ret !== void 0) return ret;
+		if (typeof userOnShareTimeline === "function") return userOnShareTimeline.apply(this, args);
+	};
+	if (features?.enableAddToFavorites) pageLifecycleHooks.onAddToFavorites = function onAddToFavorites$1(...args) {
+		const ret = callHookReturn(this, "onAddToFavorites", args);
+		if (ret !== void 0) return ret;
+		if (typeof userOnAddToFavorites === "function") return userOnAddToFavorites.apply(this, args);
+	};
 	Component({
-		...rest,
+		...restOptions,
+		...pageLifecycleHooks,
 		lifetimes: {
 			...userLifetimes,
 			attached: function attached(...args) {
@@ -657,7 +863,10 @@ function registerComponent(runtimeApp, methods, watch$1, setup, mpOptions) {
 				if (typeof userLifetimes.attached === "function") userLifetimes.attached.apply(this, args);
 			},
 			ready: function ready(...args) {
-				callHookList(this, "onReady", args);
+				if (!this.__wevuReadyCalled) {
+					this.__wevuReadyCalled = true;
+					callHookList(this, "onReady", args);
+				}
 				if (typeof userLifetimes.ready === "function") userLifetimes.ready.apply(this, args);
 			},
 			detached: function detached(...args) {
@@ -676,7 +885,8 @@ function registerComponent(runtimeApp, methods, watch$1, setup, mpOptions) {
 				if (typeof userPageLifetimes.hide === "function") userPageLifetimes.hide.apply(this, args);
 			}
 		},
-		methods: finalMethods
+		methods: finalMethods,
+		options: finalOptions
 	});
 }
 
@@ -690,7 +900,7 @@ function createApp(options) {
 	const appConfig = { globalProperties: {} };
 	const runtimeApp = {
 		mount(adapter) {
-			const state = require_ref.reactive((data ?? (() => ({})))());
+			const state = require_store.reactive((data ?? (() => ({})))());
 			const computedDefs = resolvedComputed;
 			const methodDefs = resolvedMethods;
 			const computedRefs = Object.create(null);
@@ -775,18 +985,18 @@ function createApp(options) {
 			});
 			Object.keys(computedDefs).forEach((key) => {
 				const definition = computedDefs[key];
-				if (typeof definition === "function") computedRefs[key] = require_ref.computed(() => definition.call(publicInstance));
+				if (typeof definition === "function") computedRefs[key] = require_store.computed(() => definition.call(publicInstance));
 				else {
 					const getter = definition.get?.bind(publicInstance);
 					if (!getter) throw new Error(`Computed property "${key}" requires a getter`);
 					const setter = definition.set?.bind(publicInstance);
 					if (setter) {
 						computedSetters[key] = setter;
-						computedRefs[key] = require_ref.computed({
+						computedRefs[key] = require_store.computed({
 							get: getter,
 							set: setter
 						});
-					} else computedRefs[key] = require_ref.computed(getter);
+					} else computedRefs[key] = require_store.computed(getter);
 				}
 			});
 			const currentAdapter = adapter ?? { setData: () => {} };
@@ -808,12 +1018,12 @@ function createApp(options) {
 					if (result && typeof result.then === "function") result.catch(() => {});
 				}
 			};
-			const tracker = require_ref.effect(() => {
-				require_ref.touchReactive(state);
+			const tracker = require_store.effect(() => {
+				require_store.touchReactive(state);
 				Object.keys(computedRefs).forEach((key) => computedRefs[key].value);
-			}, { scheduler: () => require_ref.queueJob(job) });
+			}, { scheduler: () => require_store.queueJob(job) });
 			job();
-			stopHandles.push(() => require_ref.stop(tracker));
+			stopHandles.push(() => require_store.stop(tracker));
 			function registerWatch(source, cb, watchOptions) {
 				const stopHandle = watch(source, (value, oldValue) => cb(value, oldValue), watchOptions);
 				stopHandles.push(stopHandle);
@@ -877,98 +1087,259 @@ function setComputedValue(setters, key, value) {
 
 //#endregion
 //#region src/runtime/define.ts
+/**
+* 按 Vue 3 风格定义一个小程序组件/页面。
+*
+* - 统一注册为 `Component()`
+*
+* @param options 组件定义项
+* @returns 可手动注册的组件定义
+*
+* @example
+* ```ts
+* defineComponent({
+*   data: () => ({ count: 0 }),
+*   setup() {
+*     onMounted(() => console.log('mounted'))
+*   }
+* })
+* ```
+*
+* @example
+* ```ts
+* defineComponent({
+*   features: { listenPageScroll: true },
+*   setup() {
+*     onPageScroll(() => {})
+*   }
+* })
+* ```
+*/
 function defineComponent(options) {
-	const { type = "component", data, computed: computed$1, methods, watch: watch$1, setup, ...mpOptions } = options;
+	const { features, data, computed: computed$1, methods, watch: watch$1, setup, props, ...mpOptions } = options;
 	const runtimeApp = createApp({
 		data,
 		computed: computed$1,
 		methods
 	});
 	const setupWrapper = (ctx) => {
-		const result = setup?.(ctx);
+		const result = runSetupFunction(setup, ctx?.props ?? {}, ctx);
 		if (result) applySetupResult(ctx.runtime, ctx.instance, result);
 	};
-	if (type === "component") registerComponent(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptions);
-	else registerPage(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptions, void 0);
-	return { mount: (_features) => {} };
-}
-function definePage(options, features) {
-	const { data, computed: computed$1, methods, watch: watch$1, setup, ...mpOptions } = options;
-	const runtimeApp = createApp({
+	const mpOptionsWithProps = normalizeProps(mpOptions, props);
+	const componentOptions = {
 		data,
 		computed: computed$1,
-		methods
-	});
-	const setupWrapper = (ctx) => {
-		const result = setup?.(ctx);
-		if (result) applySetupResult(ctx.runtime, ctx.instance, result);
+		methods,
+		watch: watch$1,
+		setup: setupWrapper,
+		mpOptions: mpOptionsWithProps,
+		features
+	};
+	registerComponent(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptionsWithProps, features);
+	return {
+		__wevu_runtime: runtimeApp,
+		__wevu_options: componentOptions
 	};
-	registerPage(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptions, features);
-	return { mount: () => {} };
 }
 function applySetupResult(runtime, _target, result) {
+	const methods = runtime?.methods ?? Object.create(null);
+	const state = runtime?.state ?? Object.create(null);
+	if (runtime && !runtime.methods) try {
+		runtime.methods = methods;
+	} catch {}
+	if (runtime && !runtime.state) try {
+		runtime.state = state;
+	} catch {}
 	Object.keys(result).forEach((key) => {
 		const val = result[key];
-		if (typeof val === "function") runtime.methods[key] = (...args) => val.apply(runtime.proxy, args);
-		else runtime.state[key] = val;
+		if (typeof val === "function") methods[key] = (...args) => val.apply(runtime?.proxy ?? runtime, args);
+		else state[key] = val;
+	});
+	if (runtime) {
+		runtime.methods = runtime.methods ?? methods;
+		runtime.state = runtime.state ?? state;
+	}
+}
+/**
+* 从 Vue SFC 选项创建 wevu 组件，供 weapp-vite 编译产物直接调用的兼容入口。
+*
+* @param options 组件选项，可能包含小程序特有的 properties
+*/
+function createWevuComponent(options) {
+	const { properties, props, ...restOptions } = options;
+	defineComponent(normalizeProps(restOptions, props, properties));
+}
+function normalizeProps(baseOptions, props, explicitProperties) {
+	if (explicitProperties || !props) return {
+		...baseOptions,
+		...explicitProperties ? { properties: explicitProperties } : {}
+	};
+	const properties = {};
+	Object.entries(props).forEach(([key, definition]) => {
+		if (definition === null || definition === void 0) return;
+		if (Array.isArray(definition) || typeof definition === "function") {
+			properties[key] = { type: definition };
+			return;
+		}
+		if (typeof definition === "object") {
+			const propOptions = {};
+			if ("type" in definition && definition.type !== void 0) propOptions.type = definition.type;
+			const defaultValue = "default" in definition ? definition.default : definition.value;
+			if (defaultValue !== void 0) propOptions.value = typeof defaultValue === "function" ? defaultValue() : defaultValue;
+			properties[key] = propOptions;
+		}
 	});
+	return {
+		...baseOptions,
+		properties
+	};
 }
 
 //#endregion
 //#region src/runtime/provide.ts
-const __wevuProvideStore = /* @__PURE__ */ new Map();
+const PROVIDE_SCOPE_KEY = Symbol("wevu.provideScope");
+const __wevuGlobalProvideStore = /* @__PURE__ */ new Map();
+/**
+* 在组件上下文中向后代注入值（与 Vue 3 行为兼容），若没有当前实例则回落到全局存储。
+*
+* @param key 注入键，可为字符串、Symbol 或对象
+* @param value 提供的值
+*
+* @example
+* ```ts
+* defineComponent({
+*   setup() {
+*     provide(TOKEN_KEY, { data: 'value' })
+*   }
+* })
+* ```
+*/
 function provide(key, value) {
-	__wevuProvideStore.set(key, value);
+	const instance = getCurrentInstance();
+	if (instance) {
+		let scope = instance[PROVIDE_SCOPE_KEY];
+		if (!scope) {
+			scope = /* @__PURE__ */ new Map();
+			instance[PROVIDE_SCOPE_KEY] = scope;
+		}
+		scope.set(key, value);
+	} else __wevuGlobalProvideStore.set(key, value);
 }
+/**
+* 从祖先组件（或全局存储）读取提供的值。
+*
+* @param key 注入键，需与 provide 使用的键保持一致
+* @param defaultValue 未找到提供者时的默认值
+* @returns 匹配到的值或默认值
+*
+* @example
+* ```ts
+* defineComponent({
+*   setup() {
+*     const data = inject(TOKEN_KEY)
+*     const value = inject('key', 'default')
+*   }
+* })
+* ```
+*/
 function inject(key, defaultValue) {
-	if (__wevuProvideStore.has(key)) return __wevuProvideStore.get(key);
+	const instance = getCurrentInstance();
+	if (instance) {
+		let current = instance;
+		while (current) {
+			const scope = current[PROVIDE_SCOPE_KEY];
+			if (scope && scope.has(key)) return scope.get(key);
+			current = null;
+		}
+	}
+	if (__wevuGlobalProvideStore.has(key)) return __wevuGlobalProvideStore.get(key);
 	if (arguments.length >= 2) return defaultValue;
 	throw new Error(`wevu.inject: no value found for key`);
 }
+/**
+* 全局注入值，适用于组件外部调用场景。
+*/
+function provideGlobal(key, value) {
+	__wevuGlobalProvideStore.set(key, value);
+}
+/**
+* 从全局存储读取值，适用于组件外部调用场景。
+*/
+function injectGlobal(key, defaultValue) {
+	if (__wevuGlobalProvideStore.has(key)) return __wevuGlobalProvideStore.get(key);
+	if (arguments.length >= 2) return defaultValue;
+	throw new Error(`injectGlobal() no matching provider for key: ${String(key)}`);
+}
 
 //#endregion
 exports.callHookList = callHookList;
 exports.callHookReturn = callHookReturn;
-exports.computed = require_ref.computed;
+exports.callUpdateHooks = callUpdateHooks;
+exports.computed = require_store.computed;
 exports.createApp = createApp;
+exports.createStore = require_store.createStore;
+exports.createWevuComponent = createWevuComponent;
 exports.defineComponent = defineComponent;
-exports.definePage = definePage;
-exports.effect = require_ref.effect;
+exports.defineStore = require_store.defineStore;
+exports.effect = require_store.effect;
 exports.getCurrentInstance = getCurrentInstance;
 exports.getDeepWatchStrategy = getDeepWatchStrategy;
 exports.inject = inject;
-exports.isReactive = require_ref.isReactive;
-exports.isRef = require_ref.isRef;
+exports.injectGlobal = injectGlobal;
+exports.isRaw = require_store.isRaw;
+exports.isReactive = require_store.isReactive;
+exports.isRef = require_store.isRef;
+exports.isShallowReactive = require_store.isShallowReactive;
+exports.isShallowRef = isShallowRef;
+exports.markRaw = require_store.markRaw;
 exports.mountRuntimeInstance = mountRuntimeInstance;
-exports.nextTick = require_ref.nextTick;
+exports.nextTick = require_store.nextTick;
+exports.onActivated = onActivated;
 exports.onAddToFavorites = onAddToFavorites;
 exports.onAppError = onAppError;
 exports.onAppHide = onAppHide;
 exports.onAppShow = onAppShow;
+exports.onBeforeMount = onBeforeMount;
+exports.onBeforeUnmount = onBeforeUnmount;
+exports.onBeforeUpdate = onBeforeUpdate;
+exports.onDeactivated = onDeactivated;
+exports.onErrorCaptured = onErrorCaptured;
 exports.onHide = onHide;
+exports.onMounted = onMounted;
 exports.onPageScroll = onPageScroll;
 exports.onReady = onReady;
 exports.onRouteDone = onRouteDone;
 exports.onSaveExitState = onSaveExitState;
+exports.onServerPrefetch = onServerPrefetch;
 exports.onShareAppMessage = onShareAppMessage;
 exports.onShareTimeline = onShareTimeline;
 exports.onShow = onShow;
 exports.onTabItemTap = onTabItemTap;
 exports.onUnload = onUnload;
+exports.onUnmounted = onUnmounted;
+exports.onUpdated = onUpdated;
 exports.provide = provide;
-exports.reactive = require_ref.reactive;
+exports.provideGlobal = provideGlobal;
+exports.reactive = require_store.reactive;
 exports.readonly = readonly;
-exports.ref = require_ref.ref;
+exports.ref = require_store.ref;
 exports.registerApp = registerApp;
 exports.registerComponent = registerComponent;
-exports.registerPage = registerPage;
+exports.runSetupFunction = runSetupFunction;
 exports.setCurrentInstance = setCurrentInstance;
 exports.setDeepWatchStrategy = setDeepWatchStrategy;
-exports.stop = require_ref.stop;
+exports.shallowReactive = require_store.shallowReactive;
+exports.shallowRef = shallowRef;
+exports.stop = require_store.stop;
+exports.storeToRefs = require_store.storeToRefs;
 exports.teardownRuntimeInstance = teardownRuntimeInstance;
-exports.toRaw = require_ref.toRaw;
-exports.touchReactive = require_ref.touchReactive;
+exports.toRaw = require_store.toRaw;
+exports.toRef = toRef;
+exports.toRefs = toRefs;
+exports.touchReactive = require_store.touchReactive;
 exports.traverse = traverse;
-exports.unref = require_ref.unref;
+exports.triggerRef = triggerRef;
+exports.unref = require_store.unref;
 exports.watch = watch;
 exports.watchEffect = watchEffect;