wevu 0.0.1 → 0.0.2-alpha.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as isReactive, c as touchReactive, d as stop, f as nextTick, i as isObject, l as computed, n as ref, o as reactive, p as queueJob, r as unref, s as toRaw, t as isRef, u as effect } from "./ref-DS-k2oUF.mjs";
+import { _ as computed, a as isRef, b as nextTick, c as isObject, d as isShallowReactive, f as markRaw, g as touchReactive, h as toRaw, i as customRef, l as isRaw, m as shallowReactive, n as defineStore, o as ref, p as reactive, r as createStore, s as unref, t as storeToRefs, u as isReactive, v as effect, x as queueJob, y as stop } from "./store-BcU7YVhB.mjs";
 
 //#region src/reactivity/readonly.ts
 function readonly(target) {
@@ -30,6 +30,77 @@ function readonly(target) {
 	});
 }
 
+//#endregion
+//#region src/reactivity/shallowRef.ts
+function shallowRef(value, defaultValue) {
+	return 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 (!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 (isRef(value)) return value;
+	return 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()) {
@@ -90,8 +161,8 @@ function watch(source, cb, options = {}) {
 	};
 }
 /**
-* 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;
@@ -397,9 +468,100 @@ 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 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),
@@ -452,29 +614,54 @@ function mountRuntimeInstance(target, runtimeApp, watchMap, setup) {
 	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);
@@ -877,54 +1064,227 @@ function setComputedValue(setters, key, value) {
 
 //#endregion
 //#region src/runtime/define.ts
+/**
+* 按 Vue 3 风格定义一个小程序组件（始终注册为 Component，页面请用 definePage）。
+*
+* @param options 组件定义项
+* @returns 可手动注册的组件定义
+*
+* @example
+* ```ts
+* defineComponent({
+*   data: () => ({ count: 0 }),
+*   setup() {
+*     onMounted(() => console.log('mounted'))
+*   }
+* })
+* ```
+*/
 function defineComponent(options) {
-	const { type = "component", data, computed: computed$1, methods, watch: watch$1, setup, ...mpOptions } = options;
+	const { data, computed: computed$1, methods, watch: watch$1, setup, props, ...mpOptions } = options;
+	const mpOptionsWithProps = normalizeProps(mpOptions, props);
 	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) => {} };
+	const componentOptions = {
+		data,
+		computed: computed$1,
+		methods,
+		watch: watch$1,
+		setup: setupWrapper,
+		mpOptions: mpOptionsWithProps
+	};
+	registerComponent(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptionsWithProps);
+	return {
+		__wevu_runtime: runtimeApp,
+		__wevu_options: componentOptions
+	};
 }
+/**
+* 按 Vue 3 风格定义一个小程序页面
+*
+* @param options 页面定义
+* @param features 页面特性（例如 listenPageScroll、enableShareAppMessage 等）
+* @returns 页面定义
+*
+* @example
+* ```ts
+* definePage({
+*   data: () => ({ count: 0 }),
+*   setup() {
+*     const count = ref(0)
+*     onMounted(() => console.log('page mounted'))
+*     return { count }
+*   }
+* }, {
+*   listenPageScroll: true,
+*   enableShareAppMessage: true
+* })
+* ```
+*/
 function definePage(options, features) {
-	const { data, computed: computed$1, methods, watch: watch$1, setup, ...mpOptions } = options;
+	const { data, computed: computed$1, methods, watch: watch$1, setup, props: _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);
 	};
+	const componentOptions = {
+		type: "page",
+		data,
+		computed: computed$1,
+		methods,
+		watch: watch$1,
+		setup: setupWrapper,
+		mpOptions,
+		features
+	};
 	registerPage(runtimeApp, methods ?? {}, watch$1, setupWrapper, mpOptions, features);
-	return { mount: () => {} };
+	return {
+		mount: () => {},
+		__wevu_runtime: runtimeApp,
+		__wevu_options: componentOptions
+	};
 }
 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
-export { callHookList, callHookReturn, computed, createApp, defineComponent, definePage, effect, getCurrentInstance, getDeepWatchStrategy, inject, isReactive, isRef, mountRuntimeInstance, nextTick, onAddToFavorites, onAppError, onAppHide, onAppShow, onHide, onPageScroll, onReady, onRouteDone, onSaveExitState, onShareAppMessage, onShareTimeline, onShow, onTabItemTap, onUnload, provide, reactive, readonly, ref, registerApp, registerComponent, registerPage, setCurrentInstance, setDeepWatchStrategy, stop, teardownRuntimeInstance, toRaw, touchReactive, traverse, unref, watch, watchEffect };
+export { callHookList, callHookReturn, callUpdateHooks, computed, createApp, createStore, createWevuComponent, defineComponent, definePage, defineStore, effect, getCurrentInstance, getDeepWatchStrategy, inject, injectGlobal, isRaw, isReactive, isRef, isShallowReactive, isShallowRef, markRaw, mountRuntimeInstance, nextTick, onActivated, onAddToFavorites, onAppError, onAppHide, onAppShow, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onErrorCaptured, onHide, onMounted, onPageScroll, onReady, onRouteDone, onSaveExitState, onServerPrefetch, onShareAppMessage, onShareTimeline, onShow, onTabItemTap, onUnload, onUnmounted, onUpdated, provide, provideGlobal, reactive, readonly, ref, registerApp, registerComponent, registerPage, runSetupFunction, setCurrentInstance, setDeepWatchStrategy, shallowReactive, shallowRef, stop, storeToRefs, teardownRuntimeInstance, toRaw, toRef, toRefs, touchReactive, traverse, triggerRef, unref, watch, watchEffect };