@ubean/islands 0.3.7 → 0.4.0

package/dist/server-component.d.ts

@@ -12,7 +12,7 @@ declare const SERVER_COMPONENT_RESPONSE_HEADER = "x-ubean-server-component";
  * 用法 (通常由 `createUbeanApp()` 自动挂载,用户无需手动调用):
  *
  * ```ts
- * import { createUbeanApp } from 'ubean/runtime/app';
+ * import { createUbeanApp } from 'ubean/server';
  * import { createServerComponentMiddleware, SERVER_COMPONENT_ENDPOINT } from '@ubean/islands/server';
  *
  * const app = createUbeanApp();

package/dist/server-component.js

@@ -12,7 +12,7 @@ const SERVER_COMPONENT_RESPONSE_HEADER = "x-ubean-server-component";
 * 用法 (通常由 `createUbeanApp()` 自动挂载,用户无需手动调用):
 *
 * ```ts
-* import { createUbeanApp } from 'ubean/runtime/app';
+* import { createUbeanApp } from 'ubean/server';
 * import { createServerComponentMiddleware, SERVER_COMPONENT_ENDPOINT } from '@ubean/islands/server';
 *
 * const app = createUbeanApp();

package/dist/vite.d.ts

@@ -118,14 +118,16 @@ declare function collectIslandComponents(code: string, sourceFile: string): Isla
 /**
  * 生成 `virtual:ubean-islands-registry` 模块内容。
  *
+ * 组件以惰性 loader（`() => import(...)`）形式导出 —— 内核 `hydrateIslands`
+ * 的 `components` 类型本就接受 `Component | (() => Promise<Component>)`，
+ * `Promise.resolve` 统一解析。惰性加载保证 islands 组件不因注册表被客户端
+ * 入口静态导入而进入 entry chunk（islands 按需加载是架构前提）。
+ *
  * 输出示例：
  * ```ts
- * import __island_0 from '/src/components/IslandCounter.vue';
- * import __island_1 from '/src/components/IslandMedia.vue';
- *
  * export const islands = {
- *   "IslandCounter": __island_0,
- *   "IslandMedia": __island_1
+ *   "IslandCounter": () => import('/src/components/IslandCounter.vue'),
+ *   "IslandMedia": () => import('/src/components/IslandMedia.vue')
  * };
  * ```
  *

package/dist/vite.js

@@ -572,14 +572,16 @@ function extractScriptBlock(code) {
 /**
 * 生成 `virtual:ubean-islands-registry` 模块内容。
 *
+* 组件以惰性 loader（`() => import(...)`）形式导出 —— 内核 `hydrateIslands`
+* 的 `components` 类型本就接受 `Component | (() => Promise<Component>)`，
+* `Promise.resolve` 统一解析。惰性加载保证 islands 组件不因注册表被客户端
+* 入口静态导入而进入 entry chunk（islands 按需加载是架构前提）。
+*
 * 输出示例：
 * ```ts
-* import __island_0 from '/src/components/IslandCounter.vue';
-* import __island_1 from '/src/components/IslandMedia.vue';
-*
 * export const islands = {
-*   "IslandCounter": __island_0,
-*   "IslandMedia": __island_1
+*   "IslandCounter": () => import('/src/components/IslandCounter.vue'),
+*   "IslandMedia": () => import('/src/components/IslandMedia.vue')
 * };
 * ```
 *
@@ -587,17 +589,9 @@ function extractScriptBlock(code) {
 */
 function generateRegistryModule(components) {
 	if (components.size === 0) return "export const islands = {};";
-	const imports = [];
 	const entries = [];
-	let idx = 0;
-	for (const [name, entry] of components) {
-		const varName = `__island_${idx++}`;
-		imports.push(`import ${varName} from ${JSON.stringify(entry.importPath)};`);
-		entries.push(`  ${JSON.stringify(name)}: ${varName},`);
-	}
+	for (const [name, entry] of components) entries.push(`  ${JSON.stringify(name)}: () => import(${JSON.stringify(entry.importPath)}),`);
 	return [
-		...imports,
-		"",
 		"export const islands = {",
 		...entries,
 		"};"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/islands",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "description": "Islands architecture for ubean (Vite plugin for client:load/idle/visible/media/only directives, bootstrap script, client hydrate runtime)",
   "files": [
     "dist"
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.3.7",
+    "@ubean/shared": "0.4.0",
     "hono": "4.13.5",
     "vue": "^3.5.42"
   },