@ubean/islands 0.5.1 → 0.6.0-beta.1

package/dist/vite.js

@@ -1,6 +1,6 @@
 import { legacyDirectiveToStrategy, strategyToLegacyDirective } from "./directive.js";
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
 //#region src/vite.ts
 /**
 * `v-client.*` 指令属性名(Phase 4: 唯一支持的客户端 island 语法)。
@@ -49,8 +49,27 @@ const SERVER_COMPONENT_STUB_RESOLVED_ID = `\0${SERVER_COMPONENT_STUB_VIRTUAL_ID}
 /** `.client.vue` 在 SSR 构建中的通用占位符虚拟模块 ID */
 const CLIENT_COMPONENT_PLACEHOLDER_VIRTUAL_ID = "virtual:ubean-client-component-placeholder";
 const CLIENT_COMPONENT_PLACEHOLDER_RESOLVED_ID = `\0${CLIENT_COMPONENT_PLACEHOLDER_VIRTUAL_ID}`;
-/** `.client.vue` 在 client 构建中文件级包装虚拟模块 ID 前缀 */
+/**
+* `.client.vue` 在 client 构建中文件级包装虚拟模块 ID 前缀。
+*
+* ID 形如 `\0virtual:ubean-client-component:<真实路径><WRAPPER_TAIL>` —— **尾标不能省**：
+* 若 ID 直接以 `.vue` 结尾，`@vitejs/plugin-vue` 会把它当作真实 SFC 去读盘，报
+* `The argument 'path' must be a string … without null bytes`（实测：dev 走不到这条路径，
+* 生产构建必挂）。尾标让文件名不再匹配 `/`\.vue$/`，Vue 插件自然跳过。
+*/
 const CLIENT_COMPONENT_WRAPPER_PREFIX = "\0virtual:ubean-client-component:";
+/** 包装虚拟模块 ID 的尾标（见 `CLIENT_COMPONENT_WRAPPER_PREFIX` 的说明）。 */
+const WRAPPER_VIRTUAL_TAIL = ".ubean-wrapper";
+/**
+* 是否是 `@vitejs/plugin-vue` 为 SFC 生成的**子请求**（`Foo.vue?vue&type=script&lang.ts` 等）。
+*
+* 包装/重定向**只对主文件 id 生效**：子请求是 Vue 插件自己的内部模块，重定向它们会得到
+* `\0virtual:…:<真实路径>?vue&type=script…` 这种拼接产物 —— Vue 插件随后把它当真实文件读盘，
+* 报 `The argument 'path' must be a string … without null bytes`（实测生产构建必挂、dev 侥幸不挂）。
+*/
+function isVueSubRequest(id) {
+	return id.includes("?");
+}
 /**
 * Task 9.3: 配对组件 (`Foo.vue` 同时存在 `.server.vue` + `.client.vue`) 在
 * SSR / client 构建中生成的虚拟包装模块 ID 前缀。
@@ -809,6 +828,33 @@ function transformVueSfcIslands(code, filePath) {
 const ISLANDS_REGISTRY_VIRTUAL_ID = "virtual:ubean-islands-registry";
 /** Vite 内部解析后的虚拟模块 ID（`\0` 前缀防止其他插件处理） */
 const ISLANDS_REGISTRY_RESOLVED_ID = `\0${ISLANDS_REGISTRY_VIRTUAL_ID}`;
+/** 扫描时要跳过的目录（构建产物与依赖不可能是用户写的 island 用法）。 */
+const SCAN_SKIP_DIRS = [
+	"node_modules",
+	".git",
+	".ubean",
+	"dist",
+	".temp",
+	"coverage"
+];
+/** 递归列出项目内所有 `.vue` 源文件（绝对路径）。 */
+function listVueFiles(root) {
+	const out = [];
+	const walk = (dir) => {
+		let entries;
+		try {
+			entries = readdirSync(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) if (entry.isDirectory()) {
+			if (SCAN_SKIP_DIRS.includes(entry.name)) continue;
+			walk(join(dir, entry.name));
+		} else if (entry.isFile() && entry.name.endsWith(".vue")) out.push(join(dir, entry.name));
+	};
+	walk(root);
+	return out;
+}
 function ubeanIslandsPlugin(_options = {}) {
 	let viteConfig;
 	let enabled = true;
@@ -859,27 +905,52 @@ function ubeanIslandsPlugin(_options = {}) {
 			viteConfig = config;
 			enabled = _options.enabled !== false;
 		},
+		/**
+		* 构建期**主动**扫盘预填注册表（RM-V24）。
+		*
+		* 原先注册表只由 `transform` 在遍历 SFC 主模块时填充，而注册表模块在客户端构建里先于
+		* 页面被加载（页面是惰性 `() => import(...)`）—— 于是 `load` 读到的 map 为空，产出
+		* `export const islands = {}`，**岛屿组件永不进入 bundle**：页面只剩按名字渲染的
+		* `<ubean-island>` 外壳，水合时按注册表查不到组件。实测症状是产物里 `IslandClock` /
+		* `IslandCounter` 等 chunk 全部消失，而体积门禁只守增长，反而报「预算 OK」。
+		*
+		* 因此这里在构建开始前把磁盘上所有含 `v-client.*` 的 SFC 扫一遍预填 —— 注册表内容不再
+		* 依赖模块转换顺序。dev 路径行为不变（transform 仍会增量更新，HMR 清理逻辑照旧）。
+		*/
+		async buildStart() {
+			if (!enabled) return;
+			for (const file of listVueFiles(viteConfig.root)) {
+				let code;
+				try {
+					code = readFileSync(file, "utf-8");
+				} catch {
+					continue;
+				}
+				if (!ANY_DIRECTIVE_RE.test(code)) continue;
+				updateRegistry(collectIslandComponents(code, file), file);
+			}
+		},
 		configureServer(server) {
 			devServer = server;
 		},
 		async resolveId(id, importer, options) {
 			if (id === "virtual:ubean-islands-registry") return ISLANDS_REGISTRY_RESOLVED_ID;
 			if (!enabled) return void 0;
-			if (!options?.ssr && isServerComponentFile(id)) return SERVER_COMPONENT_STUB_RESOLVED_ID;
-			if (isClientComponentFile(id) && !importer?.startsWith(CLIENT_COMPONENT_WRAPPER_PREFIX) && !importer?.startsWith(PAIRED_COMPONENT_WRAPPER_PREFIX)) {
+			if (!options?.ssr && !isVueSubRequest(id) && isServerComponentFile(id)) return SERVER_COMPONENT_STUB_RESOLVED_ID;
+			if (!isVueSubRequest(id) && isClientComponentFile(id) && !importer?.startsWith(CLIENT_COMPONENT_WRAPPER_PREFIX) && !importer?.startsWith(PAIRED_COMPONENT_WRAPPER_PREFIX)) {
 				if (options?.ssr) return CLIENT_COMPONENT_PLACEHOLDER_RESOLVED_ID;
 				const resolved = await this.resolve(id, importer, { skipSelf: true });
 				if (!resolved) return void 0;
-				return `${CLIENT_COMPONENT_WRAPPER_PREFIX}${resolved.id}`;
+				return `${CLIENT_COMPONENT_WRAPPER_PREFIX}${resolved.id}${WRAPPER_VIRTUAL_TAIL}`;
 			}
-			if (importer && !importer.startsWith("\0") && id.endsWith(".vue") && !isServerComponentFile(id) && !isClientComponentFile(id) && id.startsWith(".")) {
+			if (importer && !importer.startsWith("\0") && !isVueSubRequest(id) && id.endsWith(".vue") && !isServerComponentFile(id) && !isClientComponentFile(id) && id.startsWith(".")) {
 				const importerDir = dirname(resolve(importer));
 				const baseName = resolve(importerDir, id).slice(0, -4);
 				const serverSibling = `${baseName}.server.vue`;
 				const clientSibling = `${baseName}.client.vue`;
 				const hasServer = existsSync(serverSibling);
 				const hasClient = existsSync(clientSibling);
-				if (hasServer && hasClient) return `${PAIRED_COMPONENT_WRAPPER_PREFIX}${serverSibling}${PAIRED_PATH_SEPARATOR}${clientSibling}`;
+				if (hasServer && hasClient) return `${PAIRED_COMPONENT_WRAPPER_PREFIX}${serverSibling}${PAIRED_PATH_SEPARATOR}${clientSibling}${WRAPPER_VIRTUAL_TAIL}`;
 				if (hasServer) return serverSibling;
 				if (hasClient) return clientSibling;
 			}
@@ -889,11 +960,11 @@ function ubeanIslandsPlugin(_options = {}) {
 			if (id === SERVER_COMPONENT_STUB_RESOLVED_ID) return `import { ServerComponentStub } from '@ubean/islands/runtime';\nexport default ServerComponentStub;`;
 			if (id === CLIENT_COMPONENT_PLACEHOLDER_RESOLVED_ID) return `import { ClientComponentPlaceholder } from '@ubean/islands/runtime';\nexport default ClientComponentPlaceholder;`;
 			if (id.startsWith(CLIENT_COMPONENT_WRAPPER_PREFIX)) {
-				const realPath = id.slice(32);
+				const realPath = id.slice(32).replace(WRAPPER_VIRTUAL_TAIL, "");
 				return `import RealComp from ${JSON.stringify(realPath)};\nimport { defineClientComponent } from '@ubean/islands/runtime';\nexport default defineClientComponent(RealComp);`;
 			}
 			if (id.startsWith(PAIRED_COMPONENT_WRAPPER_PREFIX)) {
-				const payload = id.slice(32);
+				const payload = id.slice(32).replace(WRAPPER_VIRTUAL_TAIL, "");
 				const sepIdx = payload.indexOf(PAIRED_PATH_SEPARATOR);
 				if (sepIdx === -1) return void 0;
 				const serverPath = payload.slice(0, sepIdx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/islands",
-  "version": "0.5.1",
+  "version": "0.6.0-beta.1",
   "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.5.1",
+    "@ubean/shared": "0.6.0-beta.1",
     "hono": "4.13.7",
     "vue": "^3.5.42"
   },