@ubean/build 0.6.0-beta.1 → 0.6.0-beta.2

package/dist/codegen/index.d.ts

@@ -99,6 +99,8 @@ interface AutoImportResult {
   components: ComponentInfo[];
   autoImportsDtsPath: string;
   componentsDtsPath: string;
+  /** 虚拟组件（配对/单边基名）的 ambient 声明文件。没有虚拟组件时内容为空声明。 */
+  virtualComponentsDtsPath: string;
 }
 export declare function generateAutoImports(_scanResult: ScanResult, options: GenerateAutoImportsOptions): Promise<AutoImportResult>;
 export declare function getBuiltinComposables(): Import[];
@@ -228,6 +230,7 @@ export interface CodegenResult {
   i18nTypesPath?: string | null;
   autoImportsDtsPath?: string;
   componentsDtsPath?: string;
+  virtualComponentsDtsPath?: string;
   generated: string[];
 }
 export declare function generateTypes(result: ScanResult, options: CodegenOptions): Promise<CodegenResult>;

package/dist/codegen/index.js

@@ -1,2 +1,2 @@
-import { C as getUbeanComponentsConfig, E as toArray, S as getUbeanAutoImportConfig, T as resolveComponentsConfig, _ as VUE_ROUTER_PRESET, a as generateOpenApiTypesFromServer, b as getAutoImportPresets, c as generateI18nTypes, d as HONO_OPENAPI_PRESET, f as UBEAN_CLIENT_PRESET, g as VUE_PRESET, h as VUE_MACROS_PRESET, i as generateOpenApiTypes, l as messagesToTsType, m as VUE_I18N_PRESET, n as CODEGEN_FILES, o as generatePageTypes, p as UBEAN_SERVER_PRESET, r as generateTypes, s as generateRouteTypes, t as CODEGEN_CONTRACT_VERSION, u as BUILTIN_PRESETS, v as generateAutoImports, w as resolveAutoImportsConfig, x as getBuiltinComposables, y as generateImportsTransform } from "../codegen-B3oGeRtK.js";
+import { C as getUbeanAutoImportConfig, D as toArray, E as resolveComponentsConfig, S as getBuiltinComposables, T as resolveAutoImportsConfig, _ as VUE_PRESET, a as generateOpenApiTypesFromServer, b as generateImportsTransform, c as generateI18nTypes, f as HONO_OPENAPI_PRESET, g as VUE_MACROS_PRESET, h as VUE_I18N_PRESET, i as generateOpenApiTypes, l as messagesToTsType, m as UBEAN_SERVER_PRESET, n as CODEGEN_FILES, o as generatePageTypes, p as UBEAN_CLIENT_PRESET, r as generateTypes, s as generateRouteTypes, t as CODEGEN_CONTRACT_VERSION, u as BUILTIN_PRESETS, v as VUE_ROUTER_PRESET, w as getUbeanComponentsConfig, x as getAutoImportPresets, y as generateAutoImports } from "../codegen-Up8-XhRo.js";
 export { BUILTIN_PRESETS, CODEGEN_CONTRACT_VERSION, CODEGEN_FILES, HONO_OPENAPI_PRESET, UBEAN_CLIENT_PRESET, UBEAN_SERVER_PRESET, VUE_I18N_PRESET, VUE_MACROS_PRESET, VUE_PRESET, VUE_ROUTER_PRESET, generateAutoImports, generateI18nTypes, generateImportsTransform, generateOpenApiTypes, generateOpenApiTypesFromServer, generatePageTypes, generateRouteTypes, generateTypes, getAutoImportPresets, getBuiltinComposables, getUbeanAutoImportConfig, getUbeanComponentsConfig, messagesToTsType, resolveAutoImportsConfig, resolveComponentsConfig, toArray };

package/dist/{codegen-B3oGeRtK.js → codegen-Up8-XhRo.js}

@@ -260,23 +260,55 @@ function transformImportPath(filePath, srcDir) {
 function isPackageSource(from) {
 	return !from.startsWith(".") && !from.startsWith("/") && !from.startsWith("~");
 }
+/**
+* `.server.vue` / `.client.vue` 不是独立组件，**不能**进自动导入表。
+*
+* 它们是同一个组件的两个变体：`.client.vue` 客户端独有、`.server.vue` 服务端独有，
+* 成对出现时（`Foo.server.vue` + `Foo.client.vue`）由 `@ubean/islands` 的
+* `resolveId` 按基名 `Foo.vue` 生成配对包装。用户侧的用法是**显式 import**
+* （`import Foo from './Foo.vue'` 或直接 import 某一半），不存在 `<Foo.server />` 这种写法。
+*
+* 而按文件名派生名字会把它们扫成 `Foo.server` / `Foo.client` —— 这些名字进了
+* `components.d.ts` 就是**非法 TypeScript**：ubean 自己的写入器会产出未加引号的
+* 带点键（接口成员不允许限定名，`@ts-nocheck` 也压不住语法错误），
+* unplugin-vue-components 重写时会产出 `const 'Foo.server': …`（`declare global` 块里
+* 非法）—— 结果示例项目的 `pnpm type-check` 直接红。
+*
+* codegen 侧在 `scanComponentsDir` 里按这个形态分区（半成品不进组件表，但会被收成虚拟组件）；
+* unplugin 没有分区逻辑，所以这份 glob 直接喂给它的 `globsExclude`（`./vue-plugin.ts`），
+* 保证两个写入器都不产出这些条目。
+*/
+const COMPONENT_HALF_GLOBS = ["**/*.server.vue", "**/*.client.vue"];
 async function scanComponentsDir(dir, srcDir, directoryAsNamespace, ignore = [
 	"**/*.test.*",
 	"**/*.spec.*",
 	"**/_*"
 ]) {
 	const components = [];
+	const virtualComponents = [];
 	const files = await glob("**/*.vue", {
 		cwd: dir,
 		dot: true,
 		ignore,
 		absolute: true
 	}).catch(() => []);
+	/** 基名 → 半成品真实路径（`/foo/Base.server.vue` 等）。 */
+	const halves = /* @__PURE__ */ new Map();
+	/** 同目录下真实存在的 `.vue` 基名 —— 它们由 TS 自行解析，不需要 ambient 声明。 */
+	const realBases = /* @__PURE__ */ new Set();
 	for (const fullPath of files.sort()) {
 		const relativeToSrc = toPosixPath(relative(srcDir, fullPath));
 		const relativeToDir = toPosixPath(relative(dir, fullPath));
 		const base = fileBasename(fullPath);
 		if (base.startsWith("_")) continue;
+		const half = /^(.*)\.(server|client)$/.exec(base);
+		if (half) {
+			const entry = halves.get(half[1]) ?? {};
+			entry[half[2]] = fullPath;
+			halves.set(half[1], entry);
+			continue;
+		}
+		realBases.add(base);
 		let name;
 		if (directoryAsNamespace) {
 			const dirPart = fileDirname(relativeToDir) === "." ? "" : fileDirname(relativeToDir);
@@ -291,7 +323,18 @@ async function scanComponentsDir(dir, srcDir, directoryAsNamespace, ignore = [
 			pascalName: name
 		});
 	}
-	return components;
+	for (const [baseName, pair] of halves) {
+		if (realBases.has(baseName)) continue;
+		virtualComponents.push({
+			baseName,
+			name: toPascalCase(baseName),
+			typeSourcePath: pair.server ?? pair.client
+		});
+	}
+	return {
+		components,
+		virtualComponents
+	};
 }
 async function generateAutoImports(_scanResult, options) {
 	const { cwd, srcDir, buildDir, dirs = {}, autoImports: autoImportsInput, components: componentsInput } = options;
@@ -304,6 +347,7 @@ async function generateAutoImports(_scanResult, options) {
 	const componentsDir = dirs.components || "components";
 	let composablesImports = [];
 	let components = [];
+	const virtualComponents = [];
 	const autoImportsDtsPath = join(outDir, "auto-imports.d.ts");
 	const componentsDtsPath = join(outDir, "components.d.ts");
 	if (resolvedAutoImports.enabled) {
@@ -330,29 +374,86 @@ async function generateAutoImports(_scanResult, options) {
 				from: transformImportPath(imp.from, srcDir)
 			};
 		});
-		const dtsContent = toTypeDeclarationFile(composablesImports, { resolvePath: (imp) => {
-			if (isPackageSource(imp.from)) return imp.from;
-			return transformImportPath(imp.from, srcDir);
-		} });
-		await writeFile(autoImportsDtsPath, dtsContent, "utf-8");
+		const resolveFrom = (from) => isPackageSource(from) ? from : transformImportPath(from, srcDir);
+		const dtsContent = toTypeDeclarationFile(composablesImports, { resolvePath: (imp) => resolveFrom(imp.from) });
+		await writeFile(autoImportsDtsPath, `${dtsContent}\n\n${buildTemplateAutoImportBlock(composablesImports, resolveFrom)}`, "utf-8");
 	} else await writeFile(autoImportsDtsPath, "// Auto-generated by ubean - auto-imports disabled\n/* eslint-disable */\n// @ts-nocheck\nexport {}\n", "utf-8");
 	if (resolvedComponents.enabled) {
 		const allComponentsDirs = [join(srcDir, componentsDir), ...resolvedComponents.options.dirs ?? []];
 		for (const dir of allComponentsDirs) {
 			const scanned = await scanComponentsDir(dir, srcDir, directoryAsNamespace);
-			components.push(...scanned);
+			components.push(...scanned.components);
+			virtualComponents.push(...scanned.virtualComponents);
 		}
 	}
 	const componentsDts = generateComponentsDts(components, componentsDtsPath);
 	await writeFile(componentsDtsPath, componentsDts, "utf-8");
+	const virtualComponentsDtsPath = join(outDir, "virtual-components.d.ts");
+	await writeFile(virtualComponentsDtsPath, generateVirtualComponentsDts(virtualComponents, virtualComponentsDtsPath), "utf-8");
 	return {
 		composablesImports,
 		components,
 		autoImportsDtsPath,
-		componentsDtsPath
+		componentsDtsPath,
+		virtualComponentsDtsPath
 	};
 }
 /**
+* 生成「模板里的自动导入」声明段（对齐 `AutoImport({ vueTemplate: true })` 的产物）。
+*
+* **为什么必须自己产出这段**：模板表达式里的标识符由 vue 的**组件实例类型**解析
+* （vue-tsc 把模板编译成 `__VLS_ctx.x`，即 `ComponentCustomProperties`），而不是走模块作用域的
+* 全局声明。只有 `declare global { const … }` 时，`<script setup>` 里的自动导入照常工作，而
+* **模板里**用同一个 helper 会报 `Property 'isPageCached' does not exist on type '{ $: … }'`。
+*
+* ubean 的 codegen 与 unplugin-auto-import 写的是同一份文件（谁后写谁赢），所以两边都必须产出
+* 这段：codegen 只在 `prepare` / CLI dev / build 跑，unplugin 在每次 Vite dev/build 重写 ——
+* 少一段就会出现「先跑 CLI 时红、跑过一次 dev 后变绿」这种漂移。
+*/
+function buildTemplateAutoImportBlock(imports, resolveFrom) {
+	return [
+		"// for vue template auto import",
+		"import { UnwrapRef } from 'vue'",
+		"declare module 'vue' {",
+		"  interface GlobalComponents {}",
+		"  interface ComponentCustomProperties {",
+		...imports.filter((imp) => imp.name && imp.from && imp.type !== true).map((imp) => `    readonly ${toDtsKey(imp.name)}: UnwrapRef<typeof import('${resolveFrom(imp.from)}')['${imp.name}']>`).sort(),
+		"  }",
+		"}"
+	].join("\n");
+}
+/**
+* 生成 `.ubean/virtual-components.d.ts` —— 虚拟组件（配对/单边基名）的 ambient 声明。
+*
+* 为什么必须单独一份文件：这份内容会被 `unplugin-vue-components` 的重写丢掉（它只捞
+* `GlobalComponents` 接口里的条目，周围的 `declare module` 语句一律不保留），而
+* `components.d.ts` 正是它拥有的文件。
+*
+* 用**通配**说明符（`*foo.vue`）而不是相对路径：`declare module` 里的相对路径只在「说明符
+* 字符串完全相同」时匹配，而同一个虚拟组件可以从任意目录、任意相对路径导入。通配声明只在
+* TS 无法解析到真实文件时才生效，因此不会遮蔽真实 `.vue` 文件。
+*
+* 类型取服务端变体（配对与 server-only 都有），单边 `.client.vue` 则取客户端变体 —— 与
+* 运行时首屏渲染的那一侧一致。
+*/
+function generateVirtualComponentsDts(virtual, dtsPath) {
+	const dtsDir = fileDirname(toPosixPath(normalize(dtsPath)));
+	const lines = [
+		"// Auto-generated by ubean - do not edit manually",
+		"/* eslint-disable */",
+		"// @ts-nocheck",
+		"",
+		"// 本文件刻意保持 script（非模块）语义，让下面的声明成为全局 ambient 声明。",
+		""
+	];
+	const sorted = [...virtual].sort((a, b) => a.baseName.localeCompare(b.baseName));
+	for (const comp of sorted) {
+		const rel = toPosixPath(relative(dtsDir, toPosixPath(normalize(comp.typeSourcePath))));
+		lines.push(`// ${comp.name}：磁盘上没有 ${comp.baseName}.vue，由 @ubean/islands 按同名 .server.vue / .client.vue 合成`, `declare module '*${comp.baseName}.vue' {`, `  const component: typeof import('./${rel}')['default'];`, "  export default component;", "}", "");
+	}
+	return `${lines.join("\n")}\n`;
+}
+/**
 * Generate the `.ubean/components.d.ts` in a format compatible with
 * unplugin-vue-components (both writers own the same file).
 *
@@ -390,12 +491,26 @@ function generateComponentsDts(components, dtsPath) {
 		"  export interface GlobalComponents {"
 	];
 	const sorted = [...entries.entries()].sort(([a], [b]) => a.localeCompare(b));
-	lines.push(...sorted.map(([name, declaration]) => `    ${name}: ${declaration}`));
+	lines.push(...sorted.map(([name, declaration]) => `    ${toDtsKey(name)}: ${declaration}`));
 	lines.push("  }");
 	lines.push("}");
 	lines.push("");
 	return `${lines.join("\n")}\n`;
 }
+/**
+* 接口成员名 → 合法的 TS 键。
+*
+* 名字里含 `.` 时（如 `My.Comp.vue` 这种文件名）直接写就是**限定名**，在接口里是语法
+* 错误 —— 而语法错误不受本文件顶部 `@ts-nocheck` 影响，整个 d.ts 会连累项目 type-check。
+* 加引号后是合法的字符串字面量键，且 unplugin-vue-components 重写时也用同样形式
+* （实测它把非标识符名写成 `'My.Comp': …`），两边不会互相反复改写。
+*
+* 注意这里只改**写法**不改名字：名字必须与 unplugin 的派生结果一致，否则两个写入器
+* 会各自重写同一份文件。
+*/
+function toDtsKey(name) {
+	return /^[A-Za-z_$][\w$]*$/.test(name) ? name : JSON.stringify(name);
+}
 function getBuiltinComposables() {
 	const imports = [];
 	for (const preset of BUILTIN_PRESETS) for (const name of preset.imports) if (typeof name === "string") imports.push({
@@ -725,6 +840,12 @@ const CODEGEN_FILES = [
 		module: null,
 		required: true,
 		types: []
+	},
+	{
+		name: "virtual-components.d.ts",
+		module: null,
+		required: false,
+		types: []
 	}
 ];
 async function generateTypes(result, options) {
@@ -741,13 +862,13 @@ async function generateTypes(result, options) {
 	generated.push(pageTypesPath);
 	const i18nTypesPath = await generateI18nTypes(result, { outDir });
 	if (i18nTypesPath) generated.push(i18nTypesPath);
-	const { autoImportsDtsPath, componentsDtsPath } = await generateAutoImports(result, {
+	const { autoImportsDtsPath, componentsDtsPath, virtualComponentsDtsPath } = await generateAutoImports(result, {
 		cwd,
 		srcDir,
 		buildDir,
 		...autoImportOptions
 	});
-	generated.push(autoImportsDtsPath, componentsDtsPath);
+	generated.push(autoImportsDtsPath, componentsDtsPath, virtualComponentsDtsPath);
 	const manifest = {
 		contractVersion: 1,
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -765,8 +886,9 @@ async function generateTypes(result, options) {
 		i18nTypesPath,
 		autoImportsDtsPath,
 		componentsDtsPath,
+		virtualComponentsDtsPath,
 		generated
 	};
 }
 //#endregion
-export { getUbeanComponentsConfig as C, toArray as E, getUbeanAutoImportConfig as S, resolveComponentsConfig as T, VUE_ROUTER_PRESET as _, generateOpenApiTypesFromServer as a, getAutoImportPresets as b, generateI18nTypes as c, HONO_OPENAPI_PRESET as d, UBEAN_CLIENT_PRESET as f, VUE_PRESET as g, VUE_MACROS_PRESET as h, generateOpenApiTypes as i, messagesToTsType as l, VUE_I18N_PRESET as m, CODEGEN_FILES as n, generatePageTypes as o, UBEAN_SERVER_PRESET as p, generateTypes as r, generateRouteTypes as s, CODEGEN_CONTRACT_VERSION as t, BUILTIN_PRESETS as u, generateAutoImports as v, resolveAutoImportsConfig as w, getBuiltinComposables as x, generateImportsTransform as y };
+export { getUbeanAutoImportConfig as C, toArray as D, resolveComponentsConfig as E, getBuiltinComposables as S, resolveAutoImportsConfig as T, VUE_PRESET as _, generateOpenApiTypesFromServer as a, generateImportsTransform as b, generateI18nTypes as c, COMPONENT_HALF_GLOBS as d, HONO_OPENAPI_PRESET as f, VUE_MACROS_PRESET as g, VUE_I18N_PRESET as h, generateOpenApiTypes as i, messagesToTsType as l, UBEAN_SERVER_PRESET as m, CODEGEN_FILES as n, generatePageTypes as o, UBEAN_CLIENT_PRESET as p, generateTypes as r, generateRouteTypes as s, CODEGEN_CONTRACT_VERSION as t, BUILTIN_PRESETS as u, VUE_ROUTER_PRESET as v, getUbeanComponentsConfig as w, getAutoImportPresets as x, generateAutoImports as y };

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-DvHEv7Op.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-VaaeRB17.js";
 export { buildWithEnvironments, createIslandsSsrStubPlugin, generateCloudflareWorkerEntry, generateNodeServerEntry, generateStandardHandlerEntry, generateVirtualModulesToDisk, getPresetBuildConfig, serializePagesForEntry };

package/dist/{vite-DvHEv7Op.js → vite-VaaeRB17.js}

@@ -1,6 +1,7 @@
 import { a as ssrSingletonProdOptimizeExclude, m as createVirtualRegistry, o as ssrSingletonProdSsr, y as __exportAll } from "./ssr-singleton-DPTawJSx.js";
 import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-CvGWlsXj.js";
-import { D as getDevScanCoordinator, a as createVueAppEntryVirtualModule, g as toWebRequest, h as sendWebResponse, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule } from "./vue-BrbbaXTC.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-CKAJjBBR.js";
 import { createStaticSsgRenderer } from "./static-render.js";
 import { prerender, resolvePrerenderStaticDir } from "./prerender.js";
 import { join, relative, resolve } from "pathe";
@@ -11,9 +12,9 @@ import { isEphemeralCachePreset, registerBuiltinPresets, resolvePresetByName, re
 import { createServerRouter } from "@ubean/routes";
 import { scanProject } from "@ubean/scan";
 import { getLogger } from "@ubean/shared/logger";
-import { getVueLocaleParam } from "@ubean/i18n";
 import * as nodeFsPromises from "node:fs/promises";
 import { cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { getVueLocaleParam } from "@ubean/i18n";
 import { getColorModeScript, resolveColorModeConfig } from "@ubean/client";
 import { DevEnvironment, createBuilder, normalizePath, perEnvironmentPlugin } from "vite";
 import { ubeanIslandsPlugin } from "@ubean/islands/vite";
@@ -348,7 +349,7 @@ export async function renderStaticPage(input) {
 * 核心插件是唯一提供者，取值顺序为「调用方传入的内存 manifest（RM-V18 的传递）→ 服务端
 * outDir 旁的磁盘 manifest（`<outputDir>/public/.vite/manifest.json`）→ 空 + 构建期告警」。
 */
-const logger$5 = getLogger("build");
+const logger$6 = getLogger("build");
 /** 本插件提供的虚拟模块 id。 */
 const ASSET_MANIFEST_VIRTUAL_ID = "virtual:ubean-asset-manifest";
 const RESOLVED_ID = `\0${ASSET_MANIFEST_VIRTUAL_ID}`;
@@ -434,7 +435,7 @@ function ubeanAssetManifestPlugin(getManifest, getServerOutDir) {
 		load(id, options) {
 			if (id !== RESOLVED_ID) return void 0;
 			const { tags, source } = resolveInjectedAssetTags(getManifest(), getServerOutDir?.());
-			if (source === "none") logger$5.warn(`${ASSET_MANIFEST_VIRTUAL_ID} 注入时没有可用的 client manifest（环境：${options?.ssr ? "server" : "client"}）—— 产出的 HTML 将不含 asset tags。`);
+			if (source === "none") logger$6.warn(`${ASSET_MANIFEST_VIRTUAL_ID} 注入时没有可用的 client manifest（环境：${options?.ssr ? "server" : "client"}）—— 产出的 HTML 将不含 asset tags。`);
 			return `export const assetTags = ${JSON.stringify({
 				...tags,
 				favicon: null
@@ -667,7 +668,7 @@ function isDirectory(path) {
 *
 * 这里只搬移、不改语义：所有行为与旧编排原先逐段一致。
 */
-const logger$4 = getLogger("build");
+const logger$5 = getLogger("build");
 /** 产物目录布局（`dist/` 根、`dist/public`、`dist/server`，虚拟模块落 `.ubean/virtual`）。 */
 function getBuildOutDirs(cwd, outputDir) {
 	const outputRoot = resolve(cwd, outputDir);
@@ -682,7 +683,7 @@ function getBuildOutDirs(cwd, outputDir) {
 /** 清空并重建产物目录（页面/服务端目录按 mode 决定是否创建）。 */
 async function cleanBuildOutput(options) {
 	const { outDirs, hasPages, hasServer, mode, ssrEnabled } = options;
-	logger$4.info(`Cleaning output directory... (mode=${mode}${mode === "fullstack" ? `, ssr=${ssrEnabled}` : ""})`);
+	logger$5.info(`Cleaning output directory... (mode=${mode}${mode === "fullstack" ? `, ssr=${ssrEnabled}` : ""})`);
 	if (existsSync(outDirs.root)) await rm(outDirs.root, {
 		recursive: true,
 		force: true
@@ -751,7 +752,7 @@ ${tags.css ? `  ${tags.css.split("\n").join("\n  ")}\n` : ""}</head>
 async function writePresetWrapper(options) {
 	const { mode, presetBuildConfig, outDirs, entries } = options;
 	if (mode === "ssg") {
-		logger$4.info("SSG mode: skipping preset server wrapper (static output only)");
+		logger$5.info("SSG mode: skipping preset server wrapper (static output only)");
 		return "entry.mjs";
 	}
 	if (presetBuildConfig.entryType === "node") {
@@ -775,7 +776,7 @@ assets = { directory = "./public" }
 `.trim();
 		await writeFile(join(outDirs.root, "wrangler.toml"), wranglerToml, "utf-8");
 		const unsupported = findUnsupportedNodeImports(outDirs.server);
-		if (unsupported.length > 0) logger$4.warn(`worker 产物包含 workerd 不支持的 Node 内建导入（${unsupported.join("、")}）—— Worker 运行时会在启动时直接失败。来源通常是仅 Node 可用的静态服务/文件系统路径。`);
+		if (unsupported.length > 0) logger$5.warn(`worker 产物包含 workerd 不支持的 Node 内建导入（${unsupported.join("、")}）—— Worker 运行时会在启动时直接失败。来源通常是仅 Node 可用的静态服务/文件系统路径。`);
 		return "worker.mjs";
 	}
 	await writeFile(join(outDirs.server, "handler.mjs"), entries.standard(), "utf-8");
@@ -799,11 +800,11 @@ async function writeBuildManifest(options) {
 		preset: preset.name || "standard"
 	};
 	await writeFile(join(outDirs.root, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
-	logger$4.info(`Build complete! Output: ${outDirs.root}`);
-	if (hasPages) logger$4.info(`  Client assets: ${outDirs.public}`);
+	logger$5.info(`Build complete! Output: ${outDirs.root}`);
+	if (hasPages) logger$5.info(`  Client assets: ${outDirs.public}`);
 	if (hasServer) {
-		logger$4.info(`  Server bundle: ${outDirs.server}`);
-		logger$4.info(`  Entry: ${serverEntry}`);
+		logger$5.info(`  Server bundle: ${outDirs.server}`);
+		logger$5.info(`  Entry: ${serverEntry}`);
 	}
 	return manifest;
 }
@@ -929,6 +930,79 @@ function createBuildEnvironments(input) {
 	};
 }
 //#endregion
+//#region src/vite/openapi-step.ts
+/**
+* 构建期生成 `.ubean/openapi.d.ts`（OpenAPI → TypeScript 类型）。
+*
+* **为什么需要这一步**：`/_openapi.json` 是 `generateSpecs(app, …)`（hono-openapi）从 Hono app
+* 现算的，需要 routes 已经注册并加载完毕。`ubean dev` 靠「起 server 再 HTTP 拉一次」拿到它，
+* 于是类型声明**只在跑过一次 dev 之后才存在** —— 干净检出下 `pnpm type-check` 会报一片
+* `Cannot find module '../../.ubean/openapi'` 以及连带的 `pathParams`/`query` 类型不匹配
+* （实测：示例项目因此在 CI 里根本没法把 type-check 变成门禁）。
+*
+* 构建产物里的 `entry.mjs` 恰好就是那份 app，所以这里发一个**进程内请求**取 schema：不发网络、
+* 不依赖 dev server，与 `createSsrFetcher` 同源（同一条「import entry → createFetchHandler →
+* 合成 `http://localhost<path>` 请求」的路子）。
+*
+* 放在 `runEnvBuilds` 里而不是 CLI：`ubean build` 与 `vite build` 两条路径都要产出它
+* （ADR-0012 的产物一致性）。
+*/
+const logger$4 = getLogger("build");
+/**
+* 从一个 app 的 `/_openapi.json` 生成类型声明（**进程内**请求，不走 HTTP）。
+*
+* 构建路径（`runOpenApiTypesStep`）与 dev 路径（核心插件的 `listening` 钩子，见
+* `ensureDevApp`）共用这段：两者唯一的差别是 app 从哪来。
+*/
+async function generateOpenApiTypesFromApp(app, options) {
+	const response = await app.fetch(new Request("http://localhost/_openapi.json"));
+	if (!response.ok) return { skipped: `/_openapi.json responded ${response.status}` };
+	if (!(response.headers.get("content-type") || "").includes("json")) return { skipped: "no JSON response" };
+	const schema = await response.json();
+	return { filePath: await generateOpenApiTypes(schema, { outDir: join(options.cwd, options.buildDir) }) };
+}
+/**
+* 从构建好的 SSR entry 取 `/_openapi.json` 并生成类型声明。
+*
+* 任何一步不成立都**不抛错**：类型声明是 DX 产物，不该让构建失败（与预渲染的容错策略一致）。
+* 无后端模式（ssg / spa）本就没有服务端产物或该路由返回 HTML，直接跳过。
+*/
+async function runOpenApiTypesStep(options) {
+	const { cwd, manifest, buildDir } = options;
+	const entryPath = resolve(cwd, manifest.serverDir, "entry.mjs");
+	if (!existsSync(entryPath)) return { skipped: "no server entry" };
+	let mod;
+	try {
+		mod = await import(
+			/* @vite-ignore */
+			pathToFileURL(entryPath).href
+);
+	} catch (err) {
+		logger$4.warn(`Failed to load SSR entry for OpenAPI types: ${err instanceof Error ? err.message : String(err)}`);
+		return { skipped: "entry import failed" };
+	}
+	try {
+		const createApp = mod.createApp;
+		if (typeof createApp !== "function") return { skipped: "no createApp export" };
+		const app = await createApp({ openAPI: {
+			scalarPath: "/_scalar",
+			openAPIPath: "/_openapi.json"
+		} });
+		if (typeof app?.fetch !== "function") return { skipped: "app.fetch not available" };
+		return await generateOpenApiTypesFromApp(app, {
+			cwd,
+			buildDir
+		});
+	} catch (err) {
+		logger$4.warn(`Failed to generate OpenAPI types: ${err instanceof Error ? err.message : String(err)}`);
+		return { skipped: "generation failed" };
+	} finally {
+		try {
+			await mod.close?.();
+		} catch {}
+	}
+}
+//#endregion
 //#region src/vite/prerender-step.ts
 /**
 * 预渲染步骤（RM-V21 的最后一环）。
@@ -1254,6 +1328,15 @@ async function runEnvBuilds(builder, prepared) {
 		manifest: builtManifest,
 		contentSnapshot: prepared.contentSnapshot
 	});
+	if (hasServer) {
+		const openApiResult = await runOpenApiTypesStep({
+			cwd,
+			manifest: builtManifest,
+			buildDir: ".ubean"
+		});
+		if (openApiResult.filePath) logger$2.info(`OpenAPI types generated: ${openApiResult.filePath}`);
+		else if (openApiResult.skipped) logger$2.info(`OpenAPI types skipped (${openApiResult.skipped}).`);
+	}
 	return builtManifest;
 }
 /**
@@ -2376,6 +2459,8 @@ async function buildEnvironmentsForConfig(config) {
 function ubeanPlugin(options) {
 	const virtualRegistry = options?.registry ?? createVirtualRegistry();
 	let ubeanConfig = options?.config ?? tryGetConfig() ?? void 0;
+	/** 已跑过 codegen 的扫描结果（`buildStart` 会在两个环境各跑一次）。 */
+	let lastCodegenScan = null;
 	/** client manifest 的内存载体（RM-V18）：`buildApp` 填、本插件的 load 读。 */
 	const assetManifestRef = { current: null };
 	let srcDirAbs = "";
@@ -2425,8 +2510,9 @@ function ubeanPlugin(options) {
 				* `dist/{public,server,manifest.json}`。builder 与 environments 由 Vite 按本钩子创建，
 				* 插件只跑拆分好的阶段（`prepareBuild` → `runEnvBuilds`），**不**自建 builder（会递归）。
 				*
-				* 已知缺口：**预渲染**尚未接入本路径（`prerender()` 目前由 CLI 调用），因此
-				* `vite build` 的产物缺静态 HTML，与 `ubean build` 仍不等价（RM-V23 的矩阵会据此判定）。
+				* 预渲染也在本路径内（`runEnvBuilds` → `runPrerenderStep`，同一份实现 CLI 路径也在用）。
+				* 实测（2026-09，examples/ubean-test，`vp build` vs `ubean build`）：产物树逐项一致，
+				* 189 个文件全部对应，仅资源哈希不同 —— 别再照抄「`vite build` 缺静态 HTML」的旧结论。
 				*/
 				builder: { async buildApp(builder) {
 					const [{ createBuildContext, prepareBuild, runEnvBuilds }, { resolvePresetByName, registerBuiltinPresets }, { loadContentForBuild }] = await Promise.all([
@@ -2524,6 +2610,7 @@ function ubeanPlugin(options) {
 				reload: () => server.ws.send({ type: "full-reload" })
 			})).subscribe(async (result, changed) => {
 				await applyScan(result);
+				await runProjectCodegen(result);
 				for (const mod of VIRTUAL_MODULES) {
 					const module = server.moduleGraph.getModuleById(VIRTUAL_PREFIX + mod);
 					if (module) server.moduleGraph.invalidateModule(module);
@@ -2534,6 +2621,24 @@ function ubeanPlugin(options) {
 					data: { file }
 				});
 			});
+			if (process.env.UBEAN_CODEGEN_BY_CLI !== "1") {
+				const runOpenApiTypes = async () => {
+					if (!ubeanConfig) return;
+					try {
+						const app = await ensureDevApp(server);
+						if (!app) return;
+						const result = await generateOpenApiTypesFromApp(app, {
+							cwd: ubeanConfig.rootDir,
+							buildDir: ".ubean"
+						});
+						if (result.filePath) logger.info(`OpenAPI types generated: ${result.filePath}`);
+					} catch (err) {
+						logger.warn(`Failed to generate OpenAPI types: ${err instanceof Error ? err.message : String(err)}`);
+					}
+				};
+				if (server.httpServer) server.httpServer.once("listening", () => void runOpenApiTypes());
+				else runOpenApiTypes();
+			}
 		},
 		/**
 		* RM-V24：`vite preview` 接管。
@@ -2557,7 +2662,41 @@ function ubeanPlugin(options) {
 	}
 	async function scanAndRegister() {
 		if (!ubeanConfig) return;
-		await applyScan(await scanProjectOnce());
+		const result = await scanProjectOnce();
+		await applyScan(result);
+		await runProjectCodegen(result);
+	}
+	/**
+	* 生成项目类型声明（`.ubean/routes.d.ts`、`pages.d.ts`、`i18n.d.ts`、`auto-imports.d.ts`、
+	* `components.d.ts`、`virtual-components.d.ts` …）。
+	*
+	* **为什么由插件负责**：此前只有 CLI（`ubean dev` / `build` / `prepare`）会跑这套 codegen，
+	* 于是裸 Vite 路径（`vite dev` / `vite build`）下这些文件根本不生成 —— 用户的 type-check
+	* 与编辑器补全直接不成立。实测：`vp build` 之后示例的 `pnpm type-check` 报
+	* `Cannot find module '../components/sc/ThemeBadge.vue'`（虚拟组件声明缺失），以及
+	* `routes.d.ts`/`pages.d.ts` 缺失导致的一连串类型错误。ADR-0012 说两条路径等价，
+	* 那这一步也得在两条路径上都成立。
+	*
+	* 与 CLI 的分工：CLI 已经生成过时插件让位（`UBEAN_CODEGEN_BY_CLI` / 构建期的
+	* `UBEAN_BUILD_DRIVEN_BY_CLI`），避免同一份产物被两个执行者反复重写。
+	*/
+	async function runProjectCodegen(result) {
+		if (!ubeanConfig) return;
+		if (process.env.UBEAN_CODEGEN_BY_CLI === "1" || process.env.UBEAN_BUILD_DRIVEN_BY_CLI === "1") return;
+		if (lastCodegenScan === result) return;
+		lastCodegenScan = result;
+		try {
+			await generateTypes(result, {
+				cwd: ubeanConfig.rootDir,
+				srcDir: ubeanConfig.srcDir,
+				buildDir: ".ubean",
+				dirs: ubeanConfig.dir,
+				autoImports: ubeanConfig.autoImports,
+				components: ubeanConfig.components
+			});
+		} catch (err) {
+			logger.warn(`Failed to generate type definitions: ${err instanceof Error ? err.message : String(err)}`);
+		}
 	}
 	/**
 	* 依据扫描结果重建路由/中间件注册与虚拟模块。与扫描分离（RM-V13）：dev 下由

package/dist/vite.d.ts

@@ -1,9 +1,9 @@
 import { i as VirtualModuleResolver, o as createVirtualRegistry, r as VirtualModuleRegistry } from "./virtual-registry-CaU8k-YP.js";
 import { ResolvedConfig } from "@ubean/config";
 import { ScanResult, ScannedLayout, ScannedPageRoute } from "@ubean/scan";
+import { UbeanApp } from "@ubean/app";
 import { Connect, DevEnvironment, DevEnvironmentContext, HotChannel, Logger, Plugin, ResolvedConfig as ResolvedConfig$1, ViteDevServer } from "vite";
 import { PageRenderer, PageRenderer as PageRenderer$1 } from "@ubean/pages";
-import { UbeanApp } from "@ubean/app";
 import { IncomingMessage, ServerResponse } from "node:http";
 //#region src/dev/dev-worker.d.ts
 /** 生成到 `.ubean/` 下的文件名。 */
@@ -199,6 +199,16 @@ interface DevBootstrapOptions {
 export declare function getDevApp(server: ViteDevServer): {
   fetch: (request: Request) => Response | Promise<Response>;
 } | undefined;
+/**
+ * 按需触发自举（而不是等第一个请求），返回当前 app。
+ *
+ * 用途：裸 `vite dev` 下没有 CLI 去生成 OpenAPI 类型，而该类型来自 app 的 `/_openapi.json` ——
+ * 消费方（`@ubean/build` 的 dev openapi 步骤）需要能主动把 app 立起来，不能等页面请求。
+ * 与 `getDevApp` 一样挂在 server 对象上（插件与 CLI 可能持有不同的模块实例）。
+ */
+export declare function ensureDevApp(server: ViteDevServer): Promise<{
+  fetch: (request: Request) => Response | Promise<Response>;
+}> | undefined;
 interface DevRequestHandlers {
   /** `configureServer` 钩子体内使用：排在 Vite transform/静态中间件之前。 */
   pre: Connect.NextHandleFunction;

package/dist/vite.js

@@ -1,4 +1,4 @@
 import { m as createVirtualRegistry } from "./ssr-singleton-DPTawJSx.js";
-import { C as buildDevSsrRoutes, D as getDevScanCoordinator, E as createDevScanCoordinator, O as onDevScan, S as enhanceDevApp, T as DEV_SCAN_DIRS, _ as bootstrapDevApp, b as resolveDevSecurityHeaders, c as collectDevCssLinks, d as injectStylesheetLinks, f as isFrameworkHtmlPage, g as toWebRequest, h as sendWebResponse, k as peekDevScanCoordinator, l as createUbeanRequestHandlers, m as ubeanDevRequestPlugin, p as isViteResourceRequest, s as DEVTOOLS_PASS_THROUGH_PREFIXES, u as getDevApp, v as createDevApp, w as toVueRouterPagePath, x as resolveLocaleVueParam, y as createDevAppReady } from "./vue-BrbbaXTC.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-DvHEv7Op.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, getDevApp, getDevScanCoordinator, getDevWorkerEntrySource, injectStylesheetLinks, invalidateDevWorkerModules, isFrameworkHtmlPage, isViteResourceRequest, onDevScan, peekDevScanCoordinator, previewMimeType, readCompatibilityDate, resolveDevSecurityHeaders, resolveLocaleVueParam, resolvePreviewFile, sendPreviewFile, sendPreviewStatus, sendWebResponse, toVueRouterPagePath, toWebRequest, ubeanDevRequestPlugin, ubeanPlugin, ubeanPreviewPlugin, writeDevWorkerEntry };
+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-CKAJjBBR.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-VaaeRB17.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-BrbbaXTC.js → vue-CKAJjBBR.js}

@@ -1,9 +1,10 @@
 import { c as getComponentResolvers, h as defineVirtualModule, i as ssrSingletonDevPolicy, l as getCssImports, m as createVirtualRegistry } from "./ssr-singleton-DPTawJSx.js";
-import { E as toArray, T as resolveComponentsConfig, b as getAutoImportPresets, w as resolveAutoImportsConfig } from "./codegen-B3oGeRtK.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 { loadUbeanConfig } from "@ubean/config";
 import { scanProject } from "@ubean/scan";
+import { applyServerConfig, createUbeanApp } from "@ubean/app";
 import { getVueLocaleParam, toVueRouterLocalePath } from "@ubean/i18n";
 import { getColorModeScript, getPartyTownScript, resolveColorModeConfig, resolvePartyTownConfig } from "@ubean/client";
 import { transformWithOxc } from "vite";
@@ -14,201 +15,7 @@ import AutoImport from "unplugin-auto-import/vite";
 import { ubeanMdxPlugin } from "@ubean/markdown";
 import { renderFaviconLink } from "@ubean/pages";
 import VueI18nPlugin from "@intlify/unplugin-vue-i18n/vite";
-import { applyServerConfig, createUbeanApp } from "@ubean/app";
 import { generatePagesModuleSource } from "@ubean/vue/vite";
-//#region src/dev/dev-scan.ts
-/** 触发扫描的目录名（相对 `srcDir`）。并集来自 core 与 vue 两个插件此前的清单。 */
-const DEV_SCAN_DIRS = [
-	"routes",
-	"middleware",
-	"pages",
-	"layouts",
-	"plugins",
-	"app",
-	"api",
-	"locales"
-];
-const SCAN_FILE_EXTENSIONS = /\.(ts|js|mjs|cjs|mts|cts|vue|json|md|mdx)$/;
-/**
-* `srcDir` **根部**的入口文件名（`app.ts` / `app.vue` / `App.vue` / `server.ts` /
-* `server.dev.ts` …）。它们不在任何被监听的目录里，却同样决定服务端行为
-* （appRoot、defineApp、defineServer），因此必须纳入判据。
-*
-* 用静态规则而不是「等第一次扫描拿到 appEntry 再登记」：后者在入口文件本身是第一个改动对象时
-* 会漏掉 —— 首次扫描永远等不到，入口文件也就永远进不了监听集合（这正是此前「改 app.ts
-* 完全不触发重扫」的缺陷）。
-*/
-const ENTRY_FILE_PATTERN = /^(app|App)(\.(server|client))?\.(ts|js|mjs|mts|vue)$|^server(\.(dev|prod))?\.(ts|js|mjs|mts)$/;
-function createDevScanCoordinator(options) {
-	const { rootDir, source, debounceMs = 150 } = options;
-	const srcDir = options.srcDir.startsWith("/") ? options.srcDir : `${rootDir}/${options.srcDir}`;
-	const srcDirNormalized = srcDir.replace(/\/+$/, "");
-	const subscribers = /* @__PURE__ */ new Set();
-	const pending = /* @__PURE__ */ new Set();
-	let debounceTimer = null;
-	let running = null;
-	let rerunRequested = false;
-	let started = false;
-	const warn = options.onError ?? ((error) => console.error("[ubean] scan failed:", error));
-	/** 扫描目录（绝对）与「额外监听的文件」（入口文件，由扫描结果给出）。 */
-	const scanDirPaths = DEV_SCAN_DIRS.map((dir) => `${srcDirNormalized}/${dir}`);
-	const extraWatchFiles = /* @__PURE__ */ new Set();
-	function isIgnored(file) {
-		if (file.startsWith(".ubean/") || file.includes("/.ubean/")) return true;
-		if (file.includes("/node_modules/") || file.includes("/.git/")) return true;
-		if (file.endsWith(".bak")) return true;
-		return (options.ignore ?? []).some((pattern) => file.includes(pattern.replace(/\*/g, "")));
-	}
-	/**
-	* 事件是否与扫描相关。
-	*
-	* 判据是**绝对路径**（Vite 的 watcher 给的就是绝对路径）：早先 CLI 那套监听自己把
-	* `srcDir` 与事件名拼成路径，`path.join` 遇到绝对路径不重置导致拼出 `<cwd><cwd>/src/...`，
-	* 所有监听目标 ENOENT 且异常被吞 —— 表现为「服务端改动完全不生效」。这里不做任何路径拼接。
-	*/
-	function isScanRelevant(file) {
-		if (!file.endsWith(".vue") && !SCAN_FILE_EXTENSIONS.test(file)) return false;
-		if (extraWatchFiles.has(file)) return true;
-		if (!file.startsWith(`${srcDirNormalized}/`)) return false;
-		const rest = file.slice(srcDirNormalized.length + 1);
-		if (DEV_SCAN_DIRS.includes(rest.split("/")[0])) return true;
-		return !rest.includes("/") && ENTRY_FILE_PATTERN.test(rest);
-	}
-	function registerExtraFiles(result) {
-		const entries = [
-			result.appEntry?.shared,
-			result.appEntry?.server,
-			result.appEntry?.client,
-			result.appEntry?.root,
-			result.serverEntry?.shared,
-			result.serverEntry?.dev,
-			result.serverEntry?.prod
-		];
-		for (const entry of entries) if (entry?.exists && entry.fullPath && !extraWatchFiles.has(entry.fullPath)) {
-			extraWatchFiles.add(entry.fullPath);
-			source.add(entry.fullPath);
-		}
-	}
-	async function runScan(changed) {
-		const result = await (options.scan ?? (() => scanProject({
-			cwd: rootDir,
-			srcDir,
-			dirs: options.dirs,
-			ignore: options.ignore
-		})))();
-		registerExtraFiles(result);
-		for (const subscriber of subscribers) await subscriber(result, changed);
-		options.reload?.();
-		return result;
-	}
-	async function rescan(changed = []) {
-		if (running) {
-			rerunRequested = true;
-			return running;
-		}
-		running = runScan(changed).catch((error) => {
-			warn(error);
-			throw error;
-		});
-		try {
-			return await running;
-		} finally {
-			running = null;
-			if (rerunRequested) {
-				rerunRequested = false;
-				rescan([...pending]).catch(() => {});
-			}
-		}
-	}
-	function queue(file) {
-		pending.add(file);
-		if (debounceTimer) clearTimeout(debounceTimer);
-		debounceTimer = setTimeout(() => {
-			debounceTimer = null;
-			const changed = [...pending];
-			pending.clear();
-			rescan(changed).catch(() => {});
-		}, debounceMs);
-	}
-	const onFileEvent = (file) => {
-		if (isIgnored(file) || !isScanRelevant(file)) return;
-		queue(file);
-	};
-	return {
-		subscribe(fn) {
-			subscribers.add(fn);
-			return () => subscribers.delete(fn);
-		},
-		start() {
-			if (started) return;
-			started = true;
-			for (const dir of scanDirPaths) source.add(dir);
-			source.on("add", onFileEvent);
-			source.on("unlink", onFileEvent);
-			source.on("change", onFileEvent);
-		},
-		rescan,
-		subscriberCount: () => subscribers.size,
-		stop() {
-			if (!started) return;
-			started = false;
-			source.off?.("add", onFileEvent);
-			source.off?.("unlink", onFileEvent);
-			source.off?.("change", onFileEvent);
-			if (debounceTimer) {
-				clearTimeout(debounceTimer);
-				debounceTimer = null;
-			}
-			pending.clear();
-		}
-	};
-}
-const SCAN_STATE_KEY = "__ubeanScanState";
-function scanStateOf(server) {
-	const holder = server;
-	holder[SCAN_STATE_KEY] ??= {};
-	return holder[SCAN_STATE_KEY];
-}
-/**
-* 取（或建立）该 dev server 的协调器。
-*
-* core 与 vue 插件都调用它，因此**先到的那个**负责建实例；后到的拿同一个。
-* `init` 只在首次调用时执行。
-*/
-function getDevScanCoordinator(server, init) {
-	const state = scanStateOf(server);
-	if (state.coordinator) return state.coordinator;
-	const coordinator = createDevScanCoordinator(init(server.watcher));
-	state.coordinator = coordinator;
-	if (state.pending) {
-		for (const fn of state.pending) coordinator.subscribe(fn);
-		state.pending = void 0;
-	}
-	coordinator.start();
-	return coordinator;
-}
-/**
-* 取该 dev server **已存在**的协调器（不存在返回 undefined）。
-*
-* 给「只想触发一次扫描」的调用方用（CLI 的 `rescan()`）：`getDevScanCoordinator` 需要 init
-* 参数、会在缺失时建实例，不适合这里。
-*/
-function peekDevScanCoordinator(server) {
-	return scanStateOf(server).coordinator;
-}
-/**
-* 订阅 dev 扫描（CLI 用：每次扫描后重建 Hono app 并让浏览器重载）。
-*
-* 允许在协调器建立之前订阅：`getDevScanCoordinator` 会把已登记的订阅转交给新实例。
-*/
-function onDevScan(server, handler) {
-	const state = scanStateOf(server);
-	if (state.coordinator) return state.coordinator.subscribe(handler);
-	state.pending ??= /* @__PURE__ */ new Set();
-	state.pending.add(handler);
-	return () => state.pending?.delete(handler);
-}
-//#endregion
 //#region src/dev/dev-ssr-routes.ts
 /**
 * dev/SSR 路由表（RM-V11 的组成部件，从 CLI dev server 抽出）。
@@ -587,6 +394,199 @@ function resolveLocaleVueParam(config) {
 	});
 }
 //#endregion
+//#region src/dev/dev-scan.ts
+/** 触发扫描的目录名（相对 `srcDir`）。并集来自 core 与 vue 两个插件此前的清单。 */
+const DEV_SCAN_DIRS = [
+	"routes",
+	"middleware",
+	"pages",
+	"layouts",
+	"plugins",
+	"app",
+	"api",
+	"locales"
+];
+const SCAN_FILE_EXTENSIONS = /\.(ts|js|mjs|cjs|mts|cts|vue|json|md|mdx)$/;
+/**
+* `srcDir` **根部**的入口文件名（`app.ts` / `app.vue` / `App.vue` / `server.ts` /
+* `server.dev.ts` …）。它们不在任何被监听的目录里，却同样决定服务端行为
+* （appRoot、defineApp、defineServer），因此必须纳入判据。
+*
+* 用静态规则而不是「等第一次扫描拿到 appEntry 再登记」：后者在入口文件本身是第一个改动对象时
+* 会漏掉 —— 首次扫描永远等不到，入口文件也就永远进不了监听集合（这正是此前「改 app.ts
+* 完全不触发重扫」的缺陷）。
+*/
+const ENTRY_FILE_PATTERN = /^(app|App)(\.(server|client))?\.(ts|js|mjs|mts|vue)$|^server(\.(dev|prod))?\.(ts|js|mjs|mts)$/;
+function createDevScanCoordinator(options) {
+	const { rootDir, source, debounceMs = 150 } = options;
+	const srcDir = options.srcDir.startsWith("/") ? options.srcDir : `${rootDir}/${options.srcDir}`;
+	const srcDirNormalized = srcDir.replace(/\/+$/, "");
+	const subscribers = /* @__PURE__ */ new Set();
+	const pending = /* @__PURE__ */ new Set();
+	let debounceTimer = null;
+	let running = null;
+	let rerunRequested = false;
+	let started = false;
+	const warn = options.onError ?? ((error) => console.error("[ubean] scan failed:", error));
+	/** 扫描目录（绝对）与「额外监听的文件」（入口文件，由扫描结果给出）。 */
+	const scanDirPaths = DEV_SCAN_DIRS.map((dir) => `${srcDirNormalized}/${dir}`);
+	const extraWatchFiles = /* @__PURE__ */ new Set();
+	function isIgnored(file) {
+		if (file.startsWith(".ubean/") || file.includes("/.ubean/")) return true;
+		if (file.includes("/node_modules/") || file.includes("/.git/")) return true;
+		if (file.endsWith(".bak")) return true;
+		return (options.ignore ?? []).some((pattern) => file.includes(pattern.replace(/\*/g, "")));
+	}
+	/**
+	* 事件是否与扫描相关。
+	*
+	* 判据是**绝对路径**（Vite 的 watcher 给的就是绝对路径）：早先 CLI 那套监听自己把
+	* `srcDir` 与事件名拼成路径，`path.join` 遇到绝对路径不重置导致拼出 `<cwd><cwd>/src/...`，
+	* 所有监听目标 ENOENT 且异常被吞 —— 表现为「服务端改动完全不生效」。这里不做任何路径拼接。
+	*/
+	function isScanRelevant(file) {
+		if (!file.endsWith(".vue") && !SCAN_FILE_EXTENSIONS.test(file)) return false;
+		if (extraWatchFiles.has(file)) return true;
+		if (!file.startsWith(`${srcDirNormalized}/`)) return false;
+		const rest = file.slice(srcDirNormalized.length + 1);
+		if (DEV_SCAN_DIRS.includes(rest.split("/")[0])) return true;
+		return !rest.includes("/") && ENTRY_FILE_PATTERN.test(rest);
+	}
+	function registerExtraFiles(result) {
+		const entries = [
+			result.appEntry?.shared,
+			result.appEntry?.server,
+			result.appEntry?.client,
+			result.appEntry?.root,
+			result.serverEntry?.shared,
+			result.serverEntry?.dev,
+			result.serverEntry?.prod
+		];
+		for (const entry of entries) if (entry?.exists && entry.fullPath && !extraWatchFiles.has(entry.fullPath)) {
+			extraWatchFiles.add(entry.fullPath);
+			source.add(entry.fullPath);
+		}
+	}
+	async function runScan(changed) {
+		const result = await (options.scan ?? (() => scanProject({
+			cwd: rootDir,
+			srcDir,
+			dirs: options.dirs,
+			ignore: options.ignore
+		})))();
+		registerExtraFiles(result);
+		for (const subscriber of subscribers) await subscriber(result, changed);
+		options.reload?.();
+		return result;
+	}
+	async function rescan(changed = []) {
+		if (running) {
+			rerunRequested = true;
+			return running;
+		}
+		running = runScan(changed).catch((error) => {
+			warn(error);
+			throw error;
+		});
+		try {
+			return await running;
+		} finally {
+			running = null;
+			if (rerunRequested) {
+				rerunRequested = false;
+				rescan([...pending]).catch(() => {});
+			}
+		}
+	}
+	function queue(file) {
+		pending.add(file);
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(() => {
+			debounceTimer = null;
+			const changed = [...pending];
+			pending.clear();
+			rescan(changed).catch(() => {});
+		}, debounceMs);
+	}
+	const onFileEvent = (file) => {
+		if (isIgnored(file) || !isScanRelevant(file)) return;
+		queue(file);
+	};
+	return {
+		subscribe(fn) {
+			subscribers.add(fn);
+			return () => subscribers.delete(fn);
+		},
+		start() {
+			if (started) return;
+			started = true;
+			for (const dir of scanDirPaths) source.add(dir);
+			source.on("add", onFileEvent);
+			source.on("unlink", onFileEvent);
+			source.on("change", onFileEvent);
+		},
+		rescan,
+		subscriberCount: () => subscribers.size,
+		stop() {
+			if (!started) return;
+			started = false;
+			source.off?.("add", onFileEvent);
+			source.off?.("unlink", onFileEvent);
+			source.off?.("change", onFileEvent);
+			if (debounceTimer) {
+				clearTimeout(debounceTimer);
+				debounceTimer = null;
+			}
+			pending.clear();
+		}
+	};
+}
+const SCAN_STATE_KEY = "__ubeanScanState";
+function scanStateOf(server) {
+	const holder = server;
+	holder[SCAN_STATE_KEY] ??= {};
+	return holder[SCAN_STATE_KEY];
+}
+/**
+* 取（或建立）该 dev server 的协调器。
+*
+* core 与 vue 插件都调用它，因此**先到的那个**负责建实例；后到的拿同一个。
+* `init` 只在首次调用时执行。
+*/
+function getDevScanCoordinator(server, init) {
+	const state = scanStateOf(server);
+	if (state.coordinator) return state.coordinator;
+	const coordinator = createDevScanCoordinator(init(server.watcher));
+	state.coordinator = coordinator;
+	if (state.pending) {
+		for (const fn of state.pending) coordinator.subscribe(fn);
+		state.pending = void 0;
+	}
+	coordinator.start();
+	return coordinator;
+}
+/**
+* 取该 dev server **已存在**的协调器（不存在返回 undefined）。
+*
+* 给「只想触发一次扫描」的调用方用（CLI 的 `rescan()`）：`getDevScanCoordinator` 需要 init
+* 参数、会在缺失时建实例，不适合这里。
+*/
+function peekDevScanCoordinator(server) {
+	return scanStateOf(server).coordinator;
+}
+/**
+* 订阅 dev 扫描（CLI 用：每次扫描后重建 Hono app 并让浏览器重载）。
+*
+* 允许在协调器建立之前订阅：`getDevScanCoordinator` 会把已登记的订阅转交给新实例。
+*/
+function onDevScan(server, handler) {
+	const state = scanStateOf(server);
+	if (state.coordinator) return state.coordinator.subscribe(handler);
+	state.pending ??= /* @__PURE__ */ new Set();
+	state.pending.add(handler);
+	return () => state.pending?.delete(handler);
+}
+//#endregion
 //#region src/dev/node-web.ts
 /**
 * `node:http` 请求 → Web `Request`。
@@ -862,6 +862,19 @@ const DEV_APP_KEY = "__ubeanDevApp";
 function getDevApp(server) {
 	return server[DEV_APP_KEY];
 }
+/**
+* 按需触发自举（而不是等第一个请求），返回当前 app。
+*
+* 用途：裸 `vite dev` 下没有 CLI 去生成 OpenAPI 类型，而该类型来自 app 的 `/_openapi.json` ——
+* 消费方（`@ubean/build` 的 dev openapi 步骤）需要能主动把 app 立起来，不能等页面请求。
+* 与 `getDevApp` 一样挂在 server 对象上（插件与 CLI 可能持有不同的模块实例）。
+*/
+function ensureDevApp(server) {
+	const ensure = server[DEV_ENSURE_KEY];
+	return ensure?.();
+}
+/** `ensureDevApp` 在 server 对象上的键（由 `createLazyBootstrapHandler` 登记）。 */
+const DEV_ENSURE_KEY = "__ubeanEnsureDevApp";
 function createLazyBootstrapHandler(server, options = {}) {
 	let bootstrapPromise = null;
 	const start = async () => {
@@ -878,7 +891,7 @@ function createLazyBootstrapHandler(server, options = {}) {
 	onDevScan(server, async (result) => {
 		await (await bootstrapPromise?.catch(() => null))?.rebuild(result);
 	});
-	return async (request) => {
+	const ensureBootstrap = async () => {
 		bootstrapPromise ??= start().then((bootstrap) => {
 			server[DEV_APP_KEY] = bootstrap.app;
 			return bootstrap;
@@ -886,7 +899,11 @@ function createLazyBootstrapHandler(server, options = {}) {
 		const bootstrap = await bootstrapPromise;
 		await bootstrap.ready();
 		server[DEV_APP_KEY] = bootstrap.app;
-		return bootstrap.app.fetch(request);
+		return bootstrap;
+	};
+	server[DEV_ENSURE_KEY] = async () => (await ensureBootstrap()).app;
+	return async (request) => {
+		return (await ensureBootstrap()).app.fetch(request);
 	};
 }
 /** 500 错误页。dev 才看得到，直接给可读的原文与栈。 */
@@ -1666,11 +1683,13 @@ function ubeanVite(options) {
 			dirs: componentsDirs,
 			extensions,
 			include: includePatterns,
+			globsExclude: [...toArray(userComponents.globsExclude), ...COMPONENT_HALF_GLOBS],
 			dts: userComponents.dts === void 0 ? join(dtsDir, "components.d.ts") : userComponents.dts,
 			resolvers: [...dynamicResolvers, ...toArray(userComponents.resolvers)]
 		}));
 	} else plugins.push(Components({
 		dts: true,
+		globsExclude: COMPONENT_HALF_GLOBS,
 		resolvers: dynamicResolvers
 	}));
 	const searchConfig = ubeanConfig.search;
@@ -1726,4 +1745,4 @@ async function runPagefindIndexing(ubeanConfig, searchConfig) {
 	});
 }
 //#endregion
-export { buildDevSsrRoutes as C, getDevScanCoordinator as D, createDevScanCoordinator as E, onDevScan as O, enhanceDevApp as S, DEV_SCAN_DIRS as T, bootstrapDevApp as _, createVueAppEntryVirtualModule as a, resolveDevSecurityHeaders as b, collectDevCssLinks as c, injectStylesheetLinks as d, isFrameworkHtmlPage as f, toWebRequest as g, sendWebResponse as h, createServerEntryVirtualModule as i, peekDevScanCoordinator as k, createUbeanRequestHandlers as l, ubeanDevRequestPlugin as m, ubeanVite as n, createVuePagesVirtualModule as o, isViteResourceRequest as p, createClientEntryVirtualModule as r, DEVTOOLS_PASS_THROUGH_PREFIXES as s, VUE_PLUGIN_INCLUDE as t, getDevApp as u, createDevApp as v, toVueRouterPagePath as w, resolveLocaleVueParam as x, createDevAppReady as y };
+export { toVueRouterPagePath as A, bootstrapDevApp as C, resolveLocaleVueParam as D, resolveDevSecurityHeaders as E, enhanceDevApp as O, peekDevScanCoordinator as S, createDevAppReady as T, toWebRequest as _, createVueAppEntryVirtualModule as a, getDevScanCoordinator as b, collectDevCssLinks as c, getDevApp as d, injectStylesheetLinks as f, sendWebResponse as g, ubeanDevRequestPlugin as h, createServerEntryVirtualModule as i, buildDevSsrRoutes as k, createUbeanRequestHandlers as l, isViteResourceRequest as m, ubeanVite as n, createVuePagesVirtualModule as o, isFrameworkHtmlPage as p, createClientEntryVirtualModule as r, DEVTOOLS_PASS_THROUGH_PREFIXES as s, VUE_PLUGIN_INCLUDE as t, ensureDevApp as u, DEV_SCAN_DIRS as v, createDevApp as w, onDevScan as x, createDevScanCoordinator as y };

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-BrbbaXTC.js";
+import { a as createVueAppEntryVirtualModule, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, t as VUE_PLUGIN_INCLUDE } from "./vue-CKAJjBBR.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.1",
+  "version": "0.6.0-beta.2",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -45,20 +45,20 @@
   },
   "dependencies": {
     "@intlify/unplugin-vue-i18n": "11.2.5",
-    "@ubean/app": "0.6.0-beta.1",
-    "@ubean/client": "0.6.0-beta.1",
-    "@ubean/config": "0.6.0-beta.1",
-    "@ubean/i18n": "0.6.0-beta.1",
-    "@ubean/islands": "0.6.0-beta.1",
-    "@ubean/markdown": "0.6.0-beta.1",
-    "@ubean/pages": "0.6.0-beta.1",
-    "@ubean/preset": "0.6.0-beta.1",
-    "@ubean/routes": "0.6.0-beta.1",
-    "@ubean/scan": "0.6.0-beta.1",
-    "@ubean/server": "0.6.0-beta.1",
-    "@ubean/shared": "0.6.0-beta.1",
-    "@ubean/vue": "0.6.0-beta.1",
-    "@vitejs/plugin-vue": "^6.0.8",
+    "@ubean/app": "0.6.0-beta.2",
+    "@ubean/client": "0.6.0-beta.2",
+    "@ubean/config": "0.6.0-beta.2",
+    "@ubean/i18n": "0.6.0-beta.2",
+    "@ubean/islands": "0.6.0-beta.2",
+    "@ubean/markdown": "0.6.0-beta.2",
+    "@ubean/pages": "0.6.0-beta.2",
+    "@ubean/preset": "0.6.0-beta.2",
+    "@ubean/routes": "0.6.0-beta.2",
+    "@ubean/scan": "0.6.0-beta.2",
+    "@ubean/server": "0.6.0-beta.2",
+    "@ubean/shared": "0.6.0-beta.2",
+    "@ubean/vue": "0.6.0-beta.2",
+    "@vitejs/plugin-vue": "^6.0.9",
     "openapi-typescript": "^7.13.0",
     "pathe": "^2.0.3",
     "tinyglobby": "^0.2.17",
@@ -66,17 +66,17 @@
     "unplugin-auto-import": "21.1.0",
     "unplugin-vue-components": "^32.1.0",
     "unplugin-vue-markdown": "^32.1.1",
-    "vue-i18n": "11.4.10"
+    "vue-i18n": "11.4.12"
   },
   "devDependencies": {
-    "@types/node": "^26.5.0",
-    "hono": "4.13.7",
+    "@types/node": "^26.6.1",
+    "hono": "4.13.8",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
-    "vite-plus": "0.3.1"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.3",
+    "vite-plus": "0.3.3"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.3"
   },
   "peerDependenciesMeta": {
     "vite": {