@ubean/pages 0.5.2 → 0.6.0-beta.1

package/dist/index.d.ts

@@ -359,13 +359,16 @@ interface UseDeferredDataResult<T> {
  * 在组件中使用延迟数据。
  *
  * - **SSR**: 注册 promise 但不阻塞渲染,组件渲染 fallback;渲染完成后数据流式注入
- * - **客户端水合**: 从 `__UBEAN_DEFERRED__` 读取已解析数据,立即显示(无闪烁)
+ * - **客户端水合**: 首帧与 SSR 一致(仍是 fallback),挂载后再采用 `__UBEAN_DEFERRED__` 里的数据
+ *   (不发第二次请求);**不能**在 setup 里就应用 —— 那会让客户端首帧与 SSR 的 DOM 不同,
+ *   Vue 报 hydration mismatch,且被匹配上的元素会留下 SSR 的旧属性(实测 class 没被更新)
  * - **客户端导航**: 调用 factory 获取数据,显示 pending → resolved
  *
  * @example
  * ```vue
  * <script setup>
- * import { defer, useDeferredData } from 'ubean';
+ * // 页面/组件在客户端图里，从 `ubean/client` 导入（不要从聚合入口 `ubean`）
+ * import { defer, useDeferredData } from 'ubean/client';
  *
  * const { data: comments, pending } = useDeferredData(
  *   'comments',

package/dist/index.js

@@ -1,4 +1,4 @@
-import { ref, shallowRef } from "vue";
+import { getCurrentInstance, onMounted, ref, shallowRef } from "vue";
 //#region src/protocol.ts
 const PAGE_DATA_ID = "__UBEAN_PAGE_DATA__";
 const LOCALE_DATA_ID = "__UBEAN_LOCALE__";
@@ -853,13 +853,16 @@ function __resetDeferredCache() {
 * 在组件中使用延迟数据。
 *
 * - **SSR**: 注册 promise 但不阻塞渲染,组件渲染 fallback;渲染完成后数据流式注入
-* - **客户端水合**: 从 `__UBEAN_DEFERRED__` 读取已解析数据,立即显示(无闪烁)
+* - **客户端水合**: 首帧与 SSR 一致(仍是 fallback),挂载后再采用 `__UBEAN_DEFERRED__` 里的数据
+*   (不发第二次请求);**不能**在 setup 里就应用 —— 那会让客户端首帧与 SSR 的 DOM 不同,
+*   Vue 报 hydration mismatch,且被匹配上的元素会留下 SSR 的旧属性(实测 class 没被更新)
 * - **客户端导航**: 调用 factory 获取数据,显示 pending → resolved
 *
 * @example
 * ```vue
 * <script setup>
-* import { defer, useDeferredData } from 'ubean';
+* // 页面/组件在客户端图里，从 `ubean/client` 导入（不要从聚合入口 `ubean`）
+* import { defer, useDeferredData } from 'ubean/client';
 *
 * const { data: comments, pending } = useDeferredData(
 *   'comments',
@@ -879,25 +882,23 @@ function useDeferredData(key, deferred) {
 	const data = shallowRef(void 0);
 	const pending = ref(true);
 	const error = shallowRef(null);
-	if (typeof window === "undefined") {
-		__registerDeferred(key, deferred.factory());
-		pending.value = true;
-	} else {
-		const cached = readClientCache()?.[key];
-		if (cached !== void 0) {
-			if (cached !== null && typeof cached === "object" && "__deferredError" in cached) error.value = new Error(String(cached.__deferredError));
-			else data.value = cached;
-			pending.value = false;
-		} else {
-			pending.value = true;
-			deferred.factory().then((result) => {
+	if (typeof window === "undefined") __registerDeferred(key, deferred.factory());
+	else {
+		const adopt = () => {
+			const cached = readClientCache()?.[key];
+			if (cached === void 0) return deferred.factory().then((result) => {
 				data.value = result;
 				pending.value = false;
 			}).catch((err) => {
 				error.value = err instanceof Error ? err : new Error(String(err));
 				pending.value = false;
 			});
-		}
+			if (cached !== null && typeof cached === "object" && "__deferredError" in cached) error.value = new Error(String(cached.__deferredError));
+			else data.value = cached;
+			pending.value = false;
+		};
+		if (getCurrentInstance()) onMounted(adopt);
+		else queueMicrotask(adopt);
 	}
 	return {
 		data,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/pages",
-  "version": "0.5.2",
+  "version": "0.6.0-beta.1",
   "description": "Page data protocol and isomorphic data layer for ubean (PageObject, useData, invalidateData)",
   "files": [
     "dist"
@@ -16,7 +16,7 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.5.2"
+    "@ubean/shared": "0.6.0-beta.1"
   },
   "devDependencies": {
     "@types/node": "^26.5.0",