@ubean/build 0.6.1 → 0.6.3

package/dist/vite.d.ts

@@ -108,15 +108,19 @@ export declare function createUbeanDevEnvironmentFactory(runner: EnvRunnerLike):
 //#endregion
 //#region src/dev/dev-request-router.d.ts
 /**
- * DevTools 相关、**必须交给 Vite** 的命名空间前缀（DTK 外壳 + ubean DevTools SPA）。
+ * DevTools 相关、**必须交给 Vite** 的命名空间前缀（devframe hub 外壳 + ubean DevTools SPA）。
  *
  * 它们全落在 `_` / `__` 保留命名空间里，判据默认会判给 ubean → 应用 404，因此调用方要把这份
- * 前缀整体传给 `passThrough`。两个条目覆盖了 DTK 实际使用的四个名字：
- * - `/__devtools` → `/__devtools/`（外壳 HTML、RPC、WS）、`/__devtools-assets/`（DTK 自带 UI
- *   的静态资源，dock 图标的 `vite-plus.svg` 就在这里）、`/__devtools-client-imports.js`
- *   （dock 客户端模块的虚拟模块）；
- * - `/_devtools` → `/_devtools/index.html`（DTK 以 iframe 载入的 SPA）及其 `assets/*` 与
- *   `/_devtools/__connection.json`。裸 `/_devtools` 由 `devtoolsRedirect` 抢先 302，不受影响。
+ * 前缀整体传给 `passThrough`。三个条目覆盖了 devframe hub 实际使用的名字：
+ * - `/__devframes` → hub base（默认 `/__devframes/`）：外壳 HTML、`__connection.json`、
+ *   `__ws`（WebSocket upgrade）、`__sse`、`__mcp`、`__client-imports.js`、每个 devframe 的
+ *   静态产物（`/__devframes/<id>/`）与远程 assets 代理；
+ * - `/_devtools` → ubean DevTools 的 devframe 挂载点（`basePath`）：`index.html` 与
+ *   `assets/*` 及 `/_devtools/__connection.json`。裸 `/_devtools` 由 `devtoolsRedirect`
+ *   抢先 302 到 hub 外壳，不受影响；
+ * - `/__devtools` → **历史条目**（旧 DTK 外壳），保留是为了兼容仍装了 `@vitejs/devtools` 的
+ *   用户项目 —— 那套外壳的 `/__devtools-assets/`、`/__devtools-client-imports.js` 仍在
+ *   `__` 命名空间里。
  *
  * 2026-09-17 实测：`/__devtools-assets/vite-plus.svg`（应用页控制台报 404）与
  * `/_devtools/index.html`（DevTools 面板空白的真凶）此前都落进了应用 404。
@@ -131,16 +135,21 @@ export declare function isFrameworkHtmlPage(url: string): boolean;
  */
 export declare function isViteResourceRequest(url: string, headers?: IncomingMessage['headers']): boolean;
 /**
- * 从客户端模块图收集 render-blocking CSS 链接。
+ * 收集 render-blocking CSS 链接。
  *
- * dev 下由 JS 引入的 CSS（虚拟 uno.css 入口、全局样式、字体 css）要等客户端模块图执行完才生效，
- * SSR HTML 在这段间隙是**无样式**的（FOUC）。把同一批 CSS 以阻塞 `<link>` 注入，浏览器可与 JS
- * 并行抓取，首屏即有样式。
+ * dev 下由 JS 引入的 CSS 要等模块图执行完才生效，SSR HTML 在这段间隙是**无样式**的（FOUC）。
+ * 把同一批 CSS 以阻塞 `<link>` 注入，浏览器可与 JS 并行抓取，首屏即有样式。
+ *
+ * 数据源是 **ssr + client 两个模块图**，缺一不可：
+ * - `client` 提供客户端入口 import 的全局样式（虚拟 uno.css、`@vean/ui/styles.css`）；
+ * - `ssr` 提供 SFC `<style>` 块，且**首次页面请求时 client 图是空的**（它由浏览器后续请求
+ *   客户端入口才填充）—— 只读 client 图等于首个请求永远注入 0 个链接，正是 FOUC 的来源。
  *
  * `?direct` 让 Vite 的 transform 中间件返回原始 CSS（`Content-Type: text/css`）而不是注入式 JS
- * 包装；URL 自带查询串的模块（SFC `<style>` 块形如 `*.vue?vue&type=style`）无法这样服务，跳过。
+ * 包装。它必须紧跟路径（`?direct&vue&…`）：Vite 的 `CSS_LANGS_RE` 只认 `.css` 结尾或紧跟
+ * `?`，写成 `&lang.css&direct` 会落到 JS 分支，浏览器拒绝把 JS 当样式表。
  */
-export declare function collectDevCssLinks(moduleGraph: ViteDevServer['environments']['client']['moduleGraph']): string[];
+export declare function collectDevCssLinks(server: ViteDevServer): string[];
 /** 在 `</head>` 前插入阻塞样式链接。 */
 export declare function injectStylesheetLinks(html: string, hrefs: string[]): string;
 interface DevRequestRouterOptions {

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-Dh1dtOIU.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-KFKQ41Jy.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-CAQVpHaN.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-D9LgxIQD.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-Dh1dtOIU.js → vue-CAQVpHaN.js}

@@ -694,20 +694,28 @@ const RESERVED_APP_PREFIXES = [
 	"/api/"
 ];
 /**
-* DevTools 相关、**必须交给 Vite** 的命名空间前缀（DTK 外壳 + ubean DevTools SPA）。
+* DevTools 相关、**必须交给 Vite** 的命名空间前缀（devframe hub 外壳 + ubean DevTools SPA）。
 *
 * 它们全落在 `_` / `__` 保留命名空间里，判据默认会判给 ubean → 应用 404，因此调用方要把这份
-* 前缀整体传给 `passThrough`。两个条目覆盖了 DTK 实际使用的四个名字：
-* - `/__devtools` → `/__devtools/`（外壳 HTML、RPC、WS）、`/__devtools-assets/`（DTK 自带 UI
-*   的静态资源，dock 图标的 `vite-plus.svg` 就在这里）、`/__devtools-client-imports.js`
-*   （dock 客户端模块的虚拟模块）；
-* - `/_devtools` → `/_devtools/index.html`（DTK 以 iframe 载入的 SPA）及其 `assets/*` 与
-*   `/_devtools/__connection.json`。裸 `/_devtools` 由 `devtoolsRedirect` 抢先 302，不受影响。
+* 前缀整体传给 `passThrough`。三个条目覆盖了 devframe hub 实际使用的名字：
+* - `/__devframes` → hub base（默认 `/__devframes/`）：外壳 HTML、`__connection.json`、
+*   `__ws`（WebSocket upgrade）、`__sse`、`__mcp`、`__client-imports.js`、每个 devframe 的
+*   静态产物（`/__devframes/<id>/`）与远程 assets 代理；
+* - `/_devtools` → ubean DevTools 的 devframe 挂载点（`basePath`）：`index.html` 与
+*   `assets/*` 及 `/_devtools/__connection.json`。裸 `/_devtools` 由 `devtoolsRedirect`
+*   抢先 302 到 hub 外壳，不受影响；
+* - `/__devtools` → **历史条目**（旧 DTK 外壳），保留是为了兼容仍装了 `@vitejs/devtools` 的
+*   用户项目 —— 那套外壳的 `/__devtools-assets/`、`/__devtools-client-imports.js` 仍在
+*   `__` 命名空间里。
 *
 * 2026-09-17 实测：`/__devtools-assets/vite-plus.svg`（应用页控制台报 404）与
 * `/_devtools/index.html`（DevTools 面板空白的真凶）此前都落进了应用 404。
 */
-const DEVTOOLS_PASS_THROUGH_PREFIXES = ["/__devtools", "/_devtools"];
+const DEVTOOLS_PASS_THROUGH_PREFIXES = [
+	"/__devframes",
+	"/__devtools",
+	"/_devtools"
+];
 /**
 * 框架内置的 **HTML 页面**（不是应用页面）：`/_scalar`（Scalar API 文档）与 `/_devtools`
 * （DevTools SPA）。
@@ -721,9 +729,19 @@ const DEVTOOLS_PASS_THROUGH_PREFIXES = ["/__devtools", "/_devtools"];
 * `transformIndexHtml`（决定要不要注入客户端入口）；单点维护，避免两边各写一份字符串判定。
 */
 const FRAMEWORK_HTML_PAGES = ["/_devtools", "/_scalar"];
+/**
+* devframe hub 自身的 base（`DEVFRAMES_HUB_BASE`）以及 hub 下的全部子路径。
+*
+* hub 的外壳页与 devframe 的产物都不带应用的挂载点，且 `@devframes/hub-ui` 的嵌入式引导脚本
+* 由 hub 自己注入（`transformIndexHtml` 会再注一份应用入口 → 同一个页面被启动两次，devframe
+* 会在 console 报 `A client context is already published on this page`）。因此整个
+* `/__devframes/` 命名空间都跳过 HTML transform。
+*/
+const HUB_BASE_PREFIX = "/__devframes/";
 /** 该 URL 是否指向框架内置的 HTML 页面（见 {@link FRAMEWORK_HTML_PAGES}）。 */
 function isFrameworkHtmlPage(url) {
 	const pathname = url.split("?")[0].split("#")[0];
+	if (pathname === HUB_BASE_PREFIX.slice(0, -1) || pathname.startsWith(HUB_BASE_PREFIX)) return true;
 	return FRAMEWORK_HTML_PAGES.some((page) => pathname === page || pathname.startsWith(`${page}/`));
 }
 /** 「取模块而不是取页面」的查询标记：Vite 的 import-analysis 会在这些请求上加它们。 */
@@ -856,24 +874,42 @@ function toDevCssHref(url) {
 	return url.includes("\0") ? `${VALID_ID_PREFIX}${url.replace(/\0/g, NULL_BYTE_PLACEHOLDER)}` : url;
 }
 /**
-* 从客户端模块图收集 render-blocking CSS 链接。
+* 收集 render-blocking CSS 链接。
 *
-* dev 下由 JS 引入的 CSS（虚拟 uno.css 入口、全局样式、字体 css）要等客户端模块图执行完才生效，
-* SSR HTML 在这段间隙是**无样式**的（FOUC）。把同一批 CSS 以阻塞 `<link>` 注入，浏览器可与 JS
-* 并行抓取，首屏即有样式。
+* dev 下由 JS 引入的 CSS 要等模块图执行完才生效，SSR HTML 在这段间隙是**无样式**的（FOUC）。
+* 把同一批 CSS 以阻塞 `<link>` 注入，浏览器可与 JS 并行抓取，首屏即有样式。
+*
+* 数据源是 **ssr + client 两个模块图**，缺一不可：
+* - `client` 提供客户端入口 import 的全局样式（虚拟 uno.css、`@vean/ui/styles.css`）；
+* - `ssr` 提供 SFC `<style>` 块，且**首次页面请求时 client 图是空的**（它由浏览器后续请求
+*   客户端入口才填充）—— 只读 client 图等于首个请求永远注入 0 个链接，正是 FOUC 的来源。
 *
 * `?direct` 让 Vite 的 transform 中间件返回原始 CSS（`Content-Type: text/css`）而不是注入式 JS
-* 包装；URL 自带查询串的模块（SFC `<style>` 块形如 `*.vue?vue&type=style`）无法这样服务，跳过。
+* 包装。它必须紧跟路径（`?direct&vue&…`）：Vite 的 `CSS_LANGS_RE` 只认 `.css` 结尾或紧跟
+* `?`，写成 `&lang.css&direct` 会落到 JS 分支，浏览器拒绝把 JS 当样式表。
 */
-function collectDevCssLinks(moduleGraph) {
+function collectDevCssLinks(server) {
 	const links = /* @__PURE__ */ new Set();
-	for (const mod of moduleGraph.idToModuleMap.values()) {
-		const { url, id } = mod;
-		if (!url || url.includes("?")) continue;
-		if (id?.endsWith(".css") || url.endsWith(".css")) links.add(`${toDevCssHref(url)}?direct`);
+	for (const name of ["ssr", "client"]) {
+		const moduleGraph = server.environments[name]?.moduleGraph;
+		if (!moduleGraph) continue;
+		for (const mod of moduleGraph.idToModuleMap.values()) {
+			const { url, id } = mod;
+			if (!url) continue;
+			if (!isCssModuleUrl(url) && !isCssModuleUrl(String(id ?? ""))) continue;
+			const [pathname, query = ""] = toDevCssHref(url).split(/(?=\?)/);
+			const search = (query.slice(1) ? query.slice(1).split("&") : []).filter((part) => part !== "direct" && !part.startsWith("direct="));
+			links.add(search.length ? `${pathname}?direct&${search.join("&")}` : `${pathname}?direct`);
+		}
 	}
 	return [...links];
 }
+/** CSS 模块判据：`.css` 结尾，或 SFC 的 `<style>` 块（`?vue&type=style&…`）。 */
+function isCssModuleUrl(url) {
+	const [pathname, search = ""] = url.split(/(?=\?)/);
+	if (pathname.endsWith(".css")) return true;
+	return search.includes("type=style");
+}
 /** 在 `</head>` 前插入阻塞样式链接。 */
 function injectStylesheetLinks(html, hrefs) {
 	if (!hrefs.length || !html.includes("</head>")) return html;
@@ -982,7 +1018,7 @@ function createUbeanRequestHandlers(server, options) {
 		const isPage = !isFrameworkHtmlPage(url);
 		if (contentType.includes("text/html") && webRes.body && !skipTransform && isPage) {
 			const html = await webRes.text();
-			const cssLinks = collectDevCssLinks(server.environments.client.moduleGraph);
+			const cssLinks = collectDevCssLinks(server);
 			const transformed = await server.transformIndexHtml(url, injectStylesheetLinks(html, cssLinks));
 			res.statusCode = webRes.status;
 			res.statusMessage = webRes.statusText;
@@ -1053,7 +1089,7 @@ function ubeanDevRequestPlugin(options) {
 				const pathname = (req.url || "/").split("?")[0].split("#")[0];
 				if (pathname === "/_devtools" || pathname === "/_devtools/") {
 					res.statusCode = 302;
-					res.setHeader("Location", "/__devtools/");
+					res.setHeader("Location", "/__devframes/");
 					res.end();
 					return;
 				}

package/dist/vue.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -44,20 +44,20 @@
     }
   },
   "dependencies": {
-    "@intlify/unplugin-vue-i18n": "11.2.5",
-    "@ubean/app": "0.6.1",
-    "@ubean/client": "0.6.1",
-    "@ubean/config": "0.6.1",
-    "@ubean/i18n": "0.6.1",
-    "@ubean/islands": "0.6.1",
-    "@ubean/markdown": "0.6.1",
-    "@ubean/pages": "0.6.1",
-    "@ubean/preset": "0.6.1",
-    "@ubean/routes": "0.6.1",
-    "@ubean/scan": "0.6.1",
-    "@ubean/server": "0.6.1",
-    "@ubean/shared": "0.6.1",
-    "@ubean/vue": "0.6.1",
+    "@intlify/unplugin-vue-i18n": "11.2.6",
+    "@ubean/app": "0.6.3",
+    "@ubean/client": "0.6.3",
+    "@ubean/config": "0.6.3",
+    "@ubean/i18n": "0.6.3",
+    "@ubean/islands": "0.6.3",
+    "@ubean/markdown": "0.6.3",
+    "@ubean/pages": "0.6.3",
+    "@ubean/preset": "0.6.3",
+    "@ubean/routes": "0.6.3",
+    "@ubean/scan": "0.6.3",
+    "@ubean/server": "0.6.3",
+    "@ubean/shared": "0.6.3",
+    "@ubean/vue": "0.6.3",
     "@vitejs/plugin-vue": "^6.0.10",
     "openapi-typescript": "^7.13.0",
     "pathe": "^2.0.3",
@@ -70,14 +70,14 @@
   },
   "devDependencies": {
     "@types/node": "^26.6.5",
-    "@vue/compiler-sfc": "^3.5.43",
+    "@vue/compiler-sfc": "^3.5.44",
     "hono": "4.13.13",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
-    "vite-plus": "1.1.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
+    "vite-plus": "1.3.0"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0"
   },
   "peerDependenciesMeta": {
     "vite": {