@ubean/build 0.6.0-beta.3 → 0.6.0-beta.5

package/dist/production.js

@@ -1,2 +1,2 @@
-import { C as getPresetBuildConfig, S as generateVirtualModulesToDisk, T as buildWithEnvironments, b as generateNodeServerEntry, v as createIslandsSsrStubPlugin, w as serializePagesForEntry, x as generateStandardHandlerEntry, y as generateCloudflareWorkerEntry } from "./vite-D0ugppt1.js";
+import { C as getPresetBuildConfig, S as generateVirtualModulesToDisk, T as buildWithEnvironments, b as generateNodeServerEntry, v as createIslandsSsrStubPlugin, w as serializePagesForEntry, x as generateStandardHandlerEntry, y as generateCloudflareWorkerEntry } from "./vite-C2bhAcof.js";
 export { buildWithEnvironments, createIslandsSsrStubPlugin, generateCloudflareWorkerEntry, generateNodeServerEntry, generateStandardHandlerEntry, generateVirtualModulesToDisk, getPresetBuildConfig, serializePagesForEntry };

package/dist/{vite-D0ugppt1.js → vite-C2bhAcof.js}

@@ -1,7 +1,7 @@
 import { a as ssrSingletonProdOptimizeExclude, m as createVirtualRegistry, o as ssrSingletonProdSsr, y as __exportAll } from "./ssr-singleton-Bbds29jS.js";
 import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-BK0L1Op-.js";
 import { i as generateOpenApiTypes, r as generateTypes } from "./codegen-Up8-XhRo.js";
-import { _ as toWebRequest, a as createVueAppEntryVirtualModule, b as getDevScanCoordinator, g as sendWebResponse, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, u as ensureDevApp } from "./vue-D9vD1-im.js";
+import { _ as toWebRequest, a as createVueAppEntryVirtualModule, b as getDevScanCoordinator, g as sendWebResponse, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, u as ensureDevApp } from "./vue-DR8VizGq.js";
 import { createStaticSsgRenderer } from "./static-render.js";
 import { prerender, resolvePrerenderStaticDir } from "./prerender.js";
 import { join, relative, resolve } from "pathe";
@@ -1172,9 +1172,9 @@ async function runPrerenderStep(options) {
 * ```
 *
 * 三个阶段刻意拆成三个出口（RM-V21），因为**谁来建 builder** 有两种情况：
-* - `buildWithEnvironments()`：调用方（CLI 的旧路径或未来的薄别名）自己建 builder，
-*   env 定义在这里；
-* - 插件（`ubeanPlugin` 的 `config` 钩子）在 `experimental.viteBuilder` 打开时提供
+* - `buildWithEnvironments()`：调用方自己建 builder，env 定义在这里（旧路径已随 RM-V36 删除，
+*   该出口保留给仍自行驱动构建的场景）；
+* - 插件（`ubeanPlugin` 的 `config` 钩子）提供
 *   `builder.buildApp`：此时 builder 由 Vite 自己创建、env 由同一钩子注册，插件只需
 *   `prepareBuild` + `runEnvBuilds` —— **不能**再调 `buildWithEnvironments`（那会递归建 builder）。
 *
@@ -2290,9 +2290,9 @@ function candidateFileKeys(file) {
 * 在**主进程**里跑 SSR 模块图）。因此「dev 下服务端代码在 worker 里执行」目前**不成立**，本模块
 * 与它的测试（`dev-environment.test.ts` / `dev-worker.test.ts`）验证的是能力与 IPC 契约，不是线上
 * 行为。Phase 4 的 RM-V28（跨环境单例代理）与 RM-V29（services 环境机制）都服务于这套多环境
-* 拓扑，在拓扑被采用之前不落地 —— 结论与理由见 docs/vite-plugin-migration.md。
+* 拓扑，在拓扑被采用之前不落地 —— 结论与理由见 docs/adr/0012-vite-plugin-first-lifecycle.md。
 *
-* 分工（依据 `docs/env-runner-spike.md` §7 的实测结论）：
+* 分工（依据 ADR-0012 §3 落地注记与 docs/adr/0013-platform-artifact-contract.md 的实测结论）：
 * - **Vite 自己**负责模块图语义与 `vite:invoke` 的分发 —— `DevEnvironment` 构造时会把传入的
 *   transport 规范化，并挂到 `environment.hot`（`NormalizedHotChannel`）上，其
 *   `handleInvoke()` 是公开方法，不需要我们复刻；
@@ -2461,6 +2461,13 @@ function ubeanPlugin(options) {
 	let ubeanConfig = options?.config ?? tryGetConfig() ?? void 0;
 	/** 已跑过 codegen 的扫描结果（`buildStart` 会在两个环境各跑一次）。 */
 	let lastCodegenScan = null;
+	/**
+	* dev 扫描协调器（`configureServer` 建立、`buildStart` 用）。
+	*
+	* Vite 的顺序是 `configureServer` → `buildStart`，且 dev 下每个环境各跑一次 `buildStart`
+	* （`prime` 幂等），所以这里用闭包引用登记结构基线。
+	*/
+	let devCoordinator;
 	/** client manifest 的内存载体（RM-V18）：`buildApp` 填、本插件的 load 读。 */
 	const assetManifestRef = { current: null };
 	let srcDirAbs = "";
@@ -2544,7 +2551,8 @@ function ubeanPlugin(options) {
 				ubeanConfig = await loadUbeanConfig();
 				ensureDerived();
 			}
-			await scanAndRegister();
+			const initial = await scanAndRegister();
+			if (initial) devCoordinator?.prime(initial);
 		},
 		resolveId(id) {
 			if (this.environment?.name === "ubean" && isWorkerTarget()) {
@@ -2600,15 +2608,23 @@ function ubeanPlugin(options) {
 			return null;
 		},
 		configureServer(server) {
-			getDevScanCoordinator(server, (source) => ({
+			const coordinator = getDevScanCoordinator(server, (source) => ({
 				rootDir: ubeanConfig.rootDir,
 				srcDir: ubeanConfig.srcDir,
 				dirs: ubeanConfig.dir,
 				ignore: ubeanConfig.scanOptions?.ignore,
 				source,
 				scan: () => scanProjectOnce(),
-				reload: () => server.ws.send({ type: "full-reload" })
-			})).subscribe(async (result, changed) => {
+				reload: () => server.ws.send({ type: "full-reload" }),
+				onStructureUnchanged: (changed) => {
+					const config = ubeanConfig;
+					if (!config?.logging.lifecycle) return;
+					const files = changed.map((file) => relative(config.rootDir, file)).join(", ");
+					server.config.logger.info(`[ubean] structure unchanged (${files}) — keeping HMR, no full reload`);
+				}
+			}));
+			devCoordinator = coordinator;
+			coordinator.subscribe(async (result, changed) => {
 				await applyScan(result);
 				await runProjectCodegen(result);
 				for (const mod of VIRTUAL_MODULES) {
@@ -2665,6 +2681,7 @@ function ubeanPlugin(options) {
 		const result = await scanProjectOnce();
 		await applyScan(result);
 		await runProjectCodegen(result);
+		return result;
 	}
 	/**
 	* 生成项目类型声明（`.ubean/routes.d.ts`、`pages.d.ts`、`i18n.d.ts`、`auto-imports.d.ts`、

package/dist/vite.d.ts

@@ -496,8 +496,13 @@ interface DevScanCoordinatorOptions {
   source: DevScanSource;
   /** 扫描实现；默认 `scanProject`（调用方一般不需要覆盖）。 */
   scan?: () => Promise<ScanResult>;
-  /** 扫描结束后、重载前的用户回调（`full-reload` 由协调器统一发）。 */
+  /**
+   * 扫描产物与基线不一致（结构变化）时的重载回调：`full-reload` 由协调器统一发。
+   * 产物一致时**不调用**（那次改动交给 Vite 的 HMR）。
+   */
   reload?: () => void;
+  /** 扫描产物与基线一致（结构没变、不发重载）时的回调，供调用方记日志。 */
+  onStructureUnchanged?: (changed: string[]) => void;
   debounceMs?: number;
   /** 扫描失败回调；默认打到 console.error。 */
   onError?: (error: unknown) => void;
@@ -507,6 +512,11 @@ interface DevScanCoordinator {
   subscribe(fn: DevScanSubscriber): () => void;
   /** 建立监听（幂等）。 */
   start(): void;
+  /**
+   * 登记结构基线：把「当前磁盘上的结构」交给协调器，作为后续「结构是否变化」的比对面。
+   * 只记基线，不通知订阅者、不重载（供插件在 `buildStart` 的首次扫描后调用）。
+   */
+  prime(result: ScanResult): void;
   /** 手动触发一次扫描（DevTools CRUD 后、测试）。 */
   rescan(changed?: string[]): Promise<ScanResult>;
   /** 是否已有订阅者（供调用方判断「框架是否接管了 dev 重载」）。 */

package/dist/vite.js

@@ -1,4 +1,4 @@
 import { m as createVirtualRegistry } from "./ssr-singleton-Bbds29jS.js";
-import { A as toVueRouterPagePath, C as bootstrapDevApp, D as resolveLocaleVueParam, E as resolveDevSecurityHeaders, O as enhanceDevApp, S as peekDevScanCoordinator, T as createDevAppReady, _ as toWebRequest, b as getDevScanCoordinator, c as collectDevCssLinks, d as getDevApp, f as injectStylesheetLinks, g as sendWebResponse, h as ubeanDevRequestPlugin, k as buildDevSsrRoutes, l as createUbeanRequestHandlers, m as isViteResourceRequest, p as isFrameworkHtmlPage, s as DEVTOOLS_PASS_THROUGH_PREFIXES, u as ensureDevApp, v as DEV_SCAN_DIRS, w as createDevApp, x as onDevScan, y as createDevScanCoordinator } from "./vue-D9vD1-im.js";
-import { D as createCloudflarePreviewRunner, E as MINIFLARE_INSTALL_HINT, O as defaultLoadMiniflare, _ as ubeanPreviewPlugin, a as createEnvRunnerTransport, c as getDevWorkerEntrySource, d as attachPreviewMiddleware, f as createPreviewMiddleware, g as sendPreviewStatus, h as sendPreviewFile, i as bridgeEnvRunnerInvokes, k as readCompatibilityDate, l as invalidateDevWorkerModules, m as resolvePreviewFile, n as UBEAN_DEV_ENV_NAME, o as createUbeanDevEnvironmentFactory, p as previewMimeType, r as UbeanDevEnvironment, s as DEV_WORKER_FILE, t as ubeanPlugin, u as writeDevWorkerEntry } from "./vite-D0ugppt1.js";
+import { A as toVueRouterPagePath, C as bootstrapDevApp, D as resolveLocaleVueParam, E as resolveDevSecurityHeaders, O as enhanceDevApp, S as peekDevScanCoordinator, T as createDevAppReady, _ as toWebRequest, b as getDevScanCoordinator, c as collectDevCssLinks, d as getDevApp, f as injectStylesheetLinks, g as sendWebResponse, h as ubeanDevRequestPlugin, k as buildDevSsrRoutes, l as createUbeanRequestHandlers, m as isViteResourceRequest, p as isFrameworkHtmlPage, s as DEVTOOLS_PASS_THROUGH_PREFIXES, u as ensureDevApp, v as DEV_SCAN_DIRS, w as createDevApp, x as onDevScan, y as createDevScanCoordinator } from "./vue-DR8VizGq.js";
+import { D as createCloudflarePreviewRunner, E as MINIFLARE_INSTALL_HINT, O as defaultLoadMiniflare, _ as ubeanPreviewPlugin, a as createEnvRunnerTransport, c as getDevWorkerEntrySource, d as attachPreviewMiddleware, f as createPreviewMiddleware, g as sendPreviewStatus, h as sendPreviewFile, i as bridgeEnvRunnerInvokes, k as readCompatibilityDate, l as invalidateDevWorkerModules, m as resolvePreviewFile, n as UBEAN_DEV_ENV_NAME, o as createUbeanDevEnvironmentFactory, p as previewMimeType, r as UbeanDevEnvironment, s as DEV_WORKER_FILE, t as ubeanPlugin, u as writeDevWorkerEntry } from "./vite-C2bhAcof.js";
 export { DEVTOOLS_PASS_THROUGH_PREFIXES, DEV_SCAN_DIRS, DEV_WORKER_FILE, MINIFLARE_INSTALL_HINT, UBEAN_DEV_ENV_NAME, UbeanDevEnvironment, attachPreviewMiddleware, bootstrapDevApp, bridgeEnvRunnerInvokes, buildDevSsrRoutes, collectDevCssLinks, createCloudflarePreviewRunner, createDevApp, createDevAppReady, createDevScanCoordinator, createEnvRunnerTransport, createPreviewMiddleware, createUbeanDevEnvironmentFactory, createUbeanRequestHandlers, createVirtualRegistry, defaultLoadMiniflare, enhanceDevApp, ensureDevApp, getDevApp, getDevScanCoordinator, getDevWorkerEntrySource, injectStylesheetLinks, invalidateDevWorkerModules, isFrameworkHtmlPage, isViteResourceRequest, onDevScan, peekDevScanCoordinator, previewMimeType, readCompatibilityDate, resolveDevSecurityHeaders, resolveLocaleVueParam, resolvePreviewFile, sendPreviewFile, sendPreviewStatus, sendWebResponse, toVueRouterPagePath, toWebRequest, ubeanDevRequestPlugin, ubeanPlugin, ubeanPreviewPlugin, writeDevWorkerEntry };

package/dist/{vue-D9vD1-im.js → vue-DR8VizGq.js}

@@ -1,7 +1,7 @@
 import { c as getComponentResolvers, h as defineVirtualModule, i as ssrSingletonDevPolicy, l as getCssImports, m as createVirtualRegistry } from "./ssr-singleton-Bbds29jS.js";
 import { D as toArray, E as resolveComponentsConfig, T as resolveAutoImportsConfig, d as COMPONENT_HALF_GLOBS, x as getAutoImportPresets } from "./codegen-Up8-XhRo.js";
 import { createRequire } from "node:module";
-import { join, resolve } from "pathe";
+import { join, relative, resolve } from "pathe";
 import { loadUbeanConfig } from "@ubean/config";
 import { scanProject } from "@ubean/scan";
 import { applyServerConfig, createUbeanApp } from "@ubean/app";
@@ -427,6 +427,8 @@ function createDevScanCoordinator(options) {
 	let running = null;
 	let rerunRequested = false;
 	let started = false;
+	/** 上一次扫描产物 = 「当前结构」。由 `prime()` 登记，之后每次扫描后更新。 */
+	let baseline;
 	const warn = options.onError ?? ((error) => console.error("[ubean] scan failed:", error));
 	/** 扫描目录（绝对）与「额外监听的文件」（入口文件，由扫描结果给出）。 */
 	const scanDirPaths = DEV_SCAN_DIRS.map((dir) => `${srcDirNormalized}/${dir}`);
@@ -467,6 +469,20 @@ function createDevScanCoordinator(options) {
 			source.add(entry.fullPath);
 		}
 	}
+	/**
+	* 扫描产物是否与基线不同（= 项目结构变了）。
+	*
+	* 判据刻意用**整份产物的序列化**，而不是手写「哪些字段算结构」的清单：扫描器是路由表/元数据的
+	* 唯一生产者，产物一致即结构一致；清单则会随 `definePage` 之类新增字段而失配 —— 漏一个字段，
+	* 浏览器就会带着旧元数据一直跑（且没有任何报错）。扫描产物是纯数据（实测两次扫描序列化结果
+	* 逐字节相同），所以直接比对。
+	*
+	* 无基线时一律返回 `true`：`prime()` 之前的行为与整改前一致（保守多发一次重载）。
+	*/
+	function structureChanged(result) {
+		if (baseline === void 0) return true;
+		return JSON.stringify(result) !== JSON.stringify(baseline);
+	}
 	async function runScan(changed) {
 		const result = await (options.scan ?? (() => scanProject({
 			cwd: rootDir,
@@ -475,8 +491,11 @@ function createDevScanCoordinator(options) {
 			ignore: options.ignore
 		})))();
 		registerExtraFiles(result);
+		const structural = structureChanged(result);
+		baseline = result;
 		for (const subscriber of subscribers) await subscriber(result, changed);
-		options.reload?.();
+		if (structural) options.reload?.();
+		else options.onStructureUnchanged?.(changed);
 		return result;
 	}
 	async function rescan(changed = []) {
@@ -525,6 +544,9 @@ function createDevScanCoordinator(options) {
 			source.on("unlink", onFileEvent);
 			source.on("change", onFileEvent);
 		},
+		prime(result) {
+			baseline = result;
+		},
 		rescan,
 		subscriberCount: () => subscribers.size,
 		stop() {
@@ -1495,7 +1517,9 @@ function ubeanVite(options) {
 		});
 	}
 	async function scanAndRegister() {
-		applyScan(await scanProjectOnce());
+		const result = await scanProjectOnce();
+		applyScan(result);
+		return result;
 	}
 	/**
 	* 依据扫描结果重建本插件的虚拟模块。
@@ -1510,11 +1534,19 @@ function ubeanVite(options) {
 		virtualRegistry.register(createClientEntryVirtualModule());
 	}
 	const HASH_IDS = Object.keys(HASH_ID_TO_VIRTUAL);
+	/**
+	* dev 扫描协调器（`configureServer` 建立）。
+	*
+	* `buildStart` 需要它来登记结构基线，但 Vite 的顺序是 `configureServer` → `buildStart`
+	* （dev 下每个环境各跑一次 `buildStart`，`prime` 幂等），所以这里是闭包引用而不是参数传递。
+	*/
+	let devCoordinator;
 	const plugins = [{
 		name: "ubean:vue",
 		enforce: "pre",
 		async buildStart() {
-			await scanAndRegister();
+			const result = await scanAndRegister();
+			devCoordinator?.prime(result);
 		},
 		resolveId(id, importer, opts) {
 			if (HASH_ID_TO_VIRTUAL[id]) return toResolvedVirtualId(HASH_ID_TO_VIRTUAL[id]);
@@ -1596,15 +1628,22 @@ function ubeanVite(options) {
 			return result.replace("</body>", `  <script type="module" src="${CLIENT_ENTRY_URL}"><\/script>\n</body>`);
 		},
 		configureServer(server) {
-			getDevScanCoordinator(server, (source) => ({
+			const coordinator = getDevScanCoordinator(server, (source) => ({
 				rootDir: ubeanConfig.rootDir,
 				srcDir: ubeanConfig.srcDir,
 				dirs: ubeanConfig.dir,
 				ignore: ubeanConfig.scanOptions?.ignore,
 				source,
 				scan: scanProjectOnce,
-				reload: () => server.ws.send({ type: "full-reload" })
-			})).subscribe((result) => {
+				reload: () => server.ws.send({ type: "full-reload" }),
+				onStructureUnchanged: (changed) => {
+					if (!ubeanConfig.logging.lifecycle) return;
+					const files = changed.map((file) => relative(ubeanConfig.rootDir, file)).join(", ");
+					server.config.logger.info(`[ubean] structure unchanged (${files}) — keeping HMR, no full reload`);
+				}
+			}));
+			devCoordinator = coordinator;
+			coordinator.subscribe((result) => {
 				applyScan(result);
 				for (const vid of VIRTUAL_IDS) {
 					const mod = server.moduleGraph.getModuleById(toResolvedVirtualId(vid));

package/dist/vue.js

@@ -1,2 +1,2 @@
-import { a as createVueAppEntryVirtualModule, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, t as VUE_PLUGIN_INCLUDE } from "./vue-D9vD1-im.js";
+import { a as createVueAppEntryVirtualModule, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, t as VUE_PLUGIN_INCLUDE } from "./vue-DR8VizGq.js";
 export { VUE_PLUGIN_INCLUDE, createClientEntryVirtualModule, createServerEntryVirtualModule, createVueAppEntryVirtualModule, createVuePagesVirtualModule, ubeanVite as default, ubeanVite };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.6.0-beta.3",
+  "version": "0.6.0-beta.5",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -45,19 +45,19 @@
   },
   "dependencies": {
     "@intlify/unplugin-vue-i18n": "11.2.5",
-    "@ubean/app": "0.6.0-beta.3",
-    "@ubean/client": "0.6.0-beta.3",
-    "@ubean/config": "0.6.0-beta.3",
-    "@ubean/i18n": "0.6.0-beta.3",
-    "@ubean/islands": "0.6.0-beta.3",
-    "@ubean/markdown": "0.6.0-beta.3",
-    "@ubean/pages": "0.6.0-beta.3",
-    "@ubean/preset": "0.6.0-beta.3",
-    "@ubean/routes": "0.6.0-beta.3",
-    "@ubean/scan": "0.6.0-beta.3",
-    "@ubean/server": "0.6.0-beta.3",
-    "@ubean/shared": "0.6.0-beta.3",
-    "@ubean/vue": "0.6.0-beta.3",
+    "@ubean/app": "0.6.0-beta.5",
+    "@ubean/client": "0.6.0-beta.5",
+    "@ubean/config": "0.6.0-beta.5",
+    "@ubean/i18n": "0.6.0-beta.5",
+    "@ubean/islands": "0.6.0-beta.5",
+    "@ubean/markdown": "0.6.0-beta.5",
+    "@ubean/pages": "0.6.0-beta.5",
+    "@ubean/preset": "0.6.0-beta.5",
+    "@ubean/routes": "0.6.0-beta.5",
+    "@ubean/scan": "0.6.0-beta.5",
+    "@ubean/server": "0.6.0-beta.5",
+    "@ubean/shared": "0.6.0-beta.5",
+    "@ubean/vue": "0.6.0-beta.5",
     "@vitejs/plugin-vue": "^6.0.9",
     "openapi-typescript": "^7.13.0",
     "pathe": "^2.0.3",
@@ -69,14 +69,14 @@
     "vue-i18n": "11.4.12"
   },
   "devDependencies": {
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.3",
     "hono": "4.13.9",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-    "vite-plus": "latest"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0-rc.1",
+    "vite-plus": "1.0.0-rc.1"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@latest"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0-rc.1"
   },
   "peerDependenciesMeta": {
     "vite": {