@ubean/islands 0.6.0 → 0.6.1-beta.2

package/dist/runtime.d.ts

@@ -58,6 +58,8 @@ export declare function hydrateIslands(options?: HydrateIslandsOptions): void;
 export declare const SERVER_COMPONENT_ENDPOINT = "/__server-component";
 /**
  * 注册服务端组件到全局注册表 (SSR 构建中由 `defineServerIsland` 自动调用)。
+ *
+ * 同名重复注册会覆盖 —— HMR 重新求值页面模块时因此能拿到最新组件引用。
  */
 export declare function registerServerComponent(path: string, component: Component): void;
 /**

package/dist/runtime.js

@@ -138,9 +138,73 @@ function hydrateIslands(options = {}) {
 		} else doHydrate();
 	}
 }
+/**
+* 把注册表里的 value 归一化成「组件或组件 Promise」。
+*
+* 注册表的 value 有两种合法形态,**而且都是函数**,不能靠 `typeof` 区分:
+*  - 惰性 loader:`() => import('…')` —— 必须**调用**才能拿到组件
+*  - 函数式组件:`(props, ctx) => VNode` —— 必须原样交给 Vue
+*
+* 判据是「调用后的返回值是不是 thenable」。
+*
+* 这修复了一个**静默**错误:`virtual:ubean-islands-registry` 导出的是惰性
+* loader,而此前 `Promise.resolve(loader)` 不会调用 loader —— 它只是把
+* loader 本身当成组件交给 Vue。Vue 于是把 `import()` 的 Promise 渲染成文本
+* 节点 `[object Promise]`,而 `hydrateIsland` 又提前打上
+* `data-hydrated="true"`,最终表现为「水合标记已完成、内容却是
+* `[object Promise]`」——断言 `data-hydrated` 的测试会误判为通过,
+* 只有真正读 DOM 内容的测试才能发现(靠 30s 超时暴露)。
+*/
+function resolveComponentValue(value) {
+	if (typeof value !== "function") return unwrapComponentModule(value);
+	const asRecord = value;
+	if (asRecord.render || asRecord.setup) return value;
+	try {
+		const maybe = unwrapComponentModule(value());
+		if (maybe && typeof maybe.then === "function") return maybe.then((unwrapped) => unwrapComponentModule(unwrapped));
+		if (looksLikeComponent(maybe)) return maybe;
+	} catch {}
+	return value;
+}
+/**
+* 判断一次试探性调用的返回值「像不像组件」。
+*
+* 关键是排除 VNode:函数式组件 `(props, ctx) => VNode` 被以 `undefined` props
+* 调用时返回的正是 VNode,若把它当成组件返回,就会把渲染结果当组件二次挂载。
+* Vue 的 VNode 带 `__v_isVNode` 标记,用它做否定判据。
+*/
+function looksLikeComponent(value) {
+	if (typeof value === "function") return true;
+	if (!value || typeof value !== "object") return false;
+	const record = value;
+	if (record.__v_isVNode) return false;
+	return "render" in record || "setup" in record || "__name" in record || "template" in record;
+}
+/**
+* 拆掉 ESM 模块命名空间,取出 `default` 导出。
+*
+* 惰性 loader 的真实形态是 `() => import('/src/components/X.vue')`,它 resolve 的
+* **不是组件本身**,而是模块命名空间 `{ default: Component }`。若把命名空间当组件
+* 交给 Vue,会得到 `[Vue warn] Component is missing template or render function: Module`
+* —— 内容依然是空的。这里统一在「调用后」和「Promise resolve 后」两处拆包。
+*
+* 只认带 `default` 且**没有** `__esModule` 标记之外其它组件特征的普通对象,
+* 避免误拆 `defineAsyncComponent` 之类的合法组件对象。
+*/
+function unwrapComponentModule(value) {
+	if (!value || typeof value !== "object") return value;
+	const record = value;
+	if (record.__v_isVNode || record.render || record.setup || record.template) return value;
+	if (!("default" in record)) return value;
+	const inner = record.default;
+	return looksLikeComponent(inner) ? inner : value;
+}
 function resolveComponent(name, components, getComponent) {
-	if (components[name]) return components[name];
-	if (getComponent) return getComponent(name);
+	if (components[name]) return resolveComponentValue(components[name]);
+	if (getComponent) {
+		const resolved = getComponent(name);
+		return resolved ? resolveComponentValue(resolved) : null;
+	}
 	const registered = Object.keys(components);
 	console.warn(`[ubean:islands] Island component "${name}" not found in registry.\nPossible causes:\n  1. Component is globally registered or dynamically imported — pass it via hydrateIslands({ components: { ${name}: YourComp } })\n  2. Component name mismatch between template tag and import\n  3. Component is auto-imported by unplugin-vue-components (no static import → not in auto-registry)\nRegistered components: ${registered.length > 0 ? registered.join(", ") : "(none)"}`);
 	return null;
@@ -159,24 +223,43 @@ const SERVER_COMPONENT_ENDPOINT = "/__server-component";
 *
 * 中间件 `createServerComponentMiddleware()` 通过 `getServerComponent(path)` 取出
 * 组件,用 `renderToString(h(Comp, props))` 重新渲染并返回 HTML。
+*
+* **真·进程单例(挂在 `globalThis` 上)** —— 不能用模块级 `Map`:dev 的 SSR 图会把本文件
+* 内联进 Vite 预构建 chunk(实测 `form-action-*.js`),而 `createUbeanApp()` 由 `@ubean/app`
+* 的产物静态 `import '@ubean/islands/server'` 走 Node 原生解析取到**另一份** `dist/runtime.js`。
+* 模块级状态只在同一个模块实例内共享,于是「SSR 渲染时注册」与「`POST /__server-component`
+* 查找」读的是两个 Map,表现为该端点恒 404 `Component not registered for path`。
+*
+* 同类先例:`@ubean/vue` 的 matcher 注册表(`packages/vue/src/matchers.ts`)与
+* `@ubean/build` 的模块注册表都出于同一理由挂在 `globalThis` 上(AGENTS.md §8 #19)。
 */
-const serverComponentRegistry = /* @__PURE__ */ new Map();
+const SERVER_COMPONENT_REGISTRY_KEY = "__ubean_server_component_registry__";
+function getServerComponentRegistry() {
+	const store = globalThis;
+	const existing = store[SERVER_COMPONENT_REGISTRY_KEY];
+	if (existing instanceof Map) return existing;
+	const created = /* @__PURE__ */ new Map();
+	store[SERVER_COMPONENT_REGISTRY_KEY] = created;
+	return created;
+}
 /**
 * 注册服务端组件到全局注册表 (SSR 构建中由 `defineServerIsland` 自动调用)。
+*
+* 同名重复注册会覆盖 —— HMR 重新求值页面模块时因此能拿到最新组件引用。
 */
 function registerServerComponent(path, component) {
-	serverComponentRegistry.set(path, component);
+	getServerComponentRegistry().set(path, component);
 }
 /**
 * 从全局注册表取出服务端组件 (由 `createServerComponentMiddleware` 调用)。
 * 未注册时返回 `undefined`。
 */
 function getServerComponent(path) {
-	return serverComponentRegistry.get(path);
+	return getServerComponentRegistry().get(path);
 }
 /** 清空注册表 (仅用于测试)。 */
 function _clearServerComponentRegistry() {
-	serverComponentRegistry.clear();
+	getServerComponentRegistry().clear();
 }
 /**
 * 定义服务端 island — 将异步组件包裹在 `<Suspense>` 边界中,实现 Partial

package/dist/vite.js

@@ -1,6 +1,6 @@
 import { legacyDirectiveToStrategy, strategyToLegacyDirective } from "./directive.js";
 import { readFileSync, readdirSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { dirname, join, resolve } from "pathe";
 //#region src/vite.ts
 /**
 * `v-client.*` 指令属性名(Phase 4: 唯一支持的客户端 island 语法)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/islands",
-  "version": "0.6.0",
+  "version": "0.6.1-beta.2",
   "description": "Islands architecture for ubean (Vite plugin for client:load/idle/visible/media/only directives, bootstrap script, client hydrate runtime)",
   "files": [
     "dist"
@@ -36,18 +36,19 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.6.0",
-    "hono": "4.13.12",
+    "@ubean/shared": "0.6.1-beta.2",
+    "hono": "4.13.13",
+    "pathe": "^2.0.3",
     "vue": "^3.5.43"
   },
   "devDependencies": {
     "@types/node": "^26.6.4",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0",
-    "vite-plus": "1.0.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
+    "vite-plus": "1.1.0"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0"
   },
   "peerDependenciesMeta": {
     "vite": {