@finesoft/front 0.1.32 → 0.1.34

package/dist/{app-OOLQDVXA.js → app-D4K35MX3.js}

@@ -1,10 +1,10 @@
 import {
   createSSRApp
-} from "./chunk-UHQBKSHL.js";
+} from "./chunk-SFGR32K6.js";
 import "./chunk-AYO3UUQC.js";
 import "./chunk-OXKFPW4U.js";
 import "./chunk-PSPVIVC2.js";
 export {
   createSSRApp
 };
-//# sourceMappingURL=app-OOLQDVXA.js.map
+//# sourceMappingURL=app-D4K35MX3.js.map

package/dist/{chunk-UHQBKSHL.js → chunk-SFGR32K6.js}

@@ -24,6 +24,19 @@ function createInternalFetch(appFetch, depth = 1) {
 }
 
 // ../server/src/app.ts
+function matchRenderModeOverride(url, renderModes) {
+  if (!renderModes) return null;
+  const path = url.split("?")[0];
+  if (renderModes[path]) return renderModes[path];
+  for (const [pattern, mode] of Object.entries(renderModes)) {
+    if (pattern.includes("*")) {
+      const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+      const re = new RegExp("^" + escaped.replace(/\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
 function createSSRApp(options) {
   const {
     root,
@@ -33,7 +46,8 @@ function createSSRApp(options) {
     ssrProductionModule,
     supportedLocales,
     defaultLocale,
-    parentFetch
+    parentFetch,
+    renderModes
   } = options;
   const app = new Hono();
   const ISR_CACHE_MAX = 1e3;
@@ -119,6 +133,10 @@ function createSSRApp(options) {
         supportedLocales,
         defaultLocale
       );
+      const overrideMode = matchRenderModeOverride(url, renderModes);
+      if (overrideMode === "csr") {
+        return c.html(injectCSRShell(template, locale));
+      }
       const cacheKey = `${locale}:${url}`;
       const cached = isrCache.get(cacheKey);
       if (cached) return c.html(cached);
@@ -146,7 +164,7 @@ function createSSRApp(options) {
         html: appHtml,
         serializedData
       });
-      if (renderMode === "prerender") {
+      if (renderMode === "prerender" || overrideMode === "prerender") {
         isrSet(cacheKey, finalHtml);
       }
       return c.html(finalHtml);
@@ -167,4 +185,4 @@ export {
   createInternalFetch,
   createSSRApp
 };
-//# sourceMappingURL=chunk-UHQBKSHL.js.map
+//# sourceMappingURL=chunk-SFGR32K6.js.map

package/dist/chunk-SFGR32K6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../server/src/app.ts","../../server/src/internal-fetch.ts"],"sourcesContent":["/**\n * createSSRApp — 创建 Hono SSR 应用\n *\n * 提供 SSR 通配路由，读取模板、加载 SSR 模块、渲染。\n * 应用层可在此之上追加自定义路由（API 代理等）。\n */\n\nimport { injectCSRShell, injectSSRContent } from \"@finesoft/ssr\";\nimport { Hono } from \"hono\";\nimport type { ViteDevServer } from \"vite\";\nimport {\n\tcreateInternalFetch,\n\tMAX_SSR_DEPTH,\n\tSSR_DEPTH_HEADER,\n} from \"./internal-fetch\";\nimport { parseAcceptLanguage } from \"./locale\";\n\n/**\n * 匹配 Vite 配置级别的 renderMode 覆盖。\n * 精确路径优先，然后 glob 模式。\n */\nfunction matchRenderModeOverride(\n\turl: string,\n\trenderModes?: Record<string, string>,\n): string | null {\n\tif (!renderModes) return null;\n\tconst path = url.split(\"?\")[0];\n\tif (renderModes[path]) return renderModes[path];\n\tfor (const [pattern, mode] of Object.entries(renderModes)) {\n\t\tif (pattern.includes(\"*\")) {\n\t\t\tconst escaped = pattern.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t\t\tconst re = new RegExp(\"^\" + escaped.replace(/\\*/g, \".*\") + \"$\");\n\t\t\tif (re.test(path)) return mode;\n\t\t}\n\t}\n\treturn null;\n}\n\nexport interface SSRModule {\n\trender: (\n\t\turl: string,\n\t\tlocale: string,\n\t\tssrContext?: { fetch?: typeof globalThis.fetch },\n\t) => Promise<{\n\t\thtml: string;\n\t\thead: string;\n\t\tcss: string;\n\t\tserverData: unknown;\n\t\trenderMode?: string;\n\t}>;\n\tserializeServerData: (data: unknown) => string;\n}\n\nexport interface SSRAppOptions {\n\t/** 项目根路径 */\n\troot: string;\n\t/** Vite dev server（仅开发模式） */\n\tvite?: ViteDevServer;\n\t/** 是否生产环境 */\n\tisProduction: boolean;\n\t/** SSR 入口文件路径（开发用，如 \"/src/ssr.ts\"） */\n\tssrEntryPath?: string;\n\t/** 生产环境 SSR 模块路径（如 \"../dist/server/ssr.js\"） */\n\tssrProductionModule?: string;\n\t/** 支持的语言列表 */\n\tsupportedLocales?: string[];\n\t/** 默认语言 */\n\tdefaultLocale?: string;\n\t/**\n\t * 父级 Hono app 的 fetch 函数，用于 SSR 内部路由回环。\n\t * SSR 渲染时，控制器的 fetch 请求（如 /api/apple/*）会通过此函数\n\t * 直接在进程内路由到代理 handler，避免网络自请求死锁。\n\t */\n\tparentFetch?: (request: Request) => Response | Promise<Response>;\n\t/**\n\t * 按路由覆盖渲染模式（精确路径或 glob 模式）。\n\t * 优先级高于路由级 renderMode。\n\t */\n\trenderModes?: Record<string, string>;\n}\n\nexport function createSSRApp(options: SSRAppOptions): Hono {\n\tconst {\n\t\troot,\n\t\tvite,\n\t\tisProduction,\n\t\tssrEntryPath = \"/src/ssr.ts\",\n\t\tssrProductionModule,\n\t\tsupportedLocales,\n\t\tdefaultLocale,\n\t\tparentFetch,\n\t\trenderModes,\n\t} = options;\n\n\tconst app = new Hono();\n\n\t/** ISR 内存缓存（prerender 路由首次请求后缓存，LRU 驱逐） */\n\tconst ISR_CACHE_MAX = 1000;\n\tconst isrCache = new Map<string, string>();\n\tfunction isrSet(key: string, val: string) {\n\t\tif (isrCache.size >= ISR_CACHE_MAX) {\n\t\t\tconst first = isrCache.keys().next().value;\n\t\t\tif (first !== undefined) isrCache.delete(first);\n\t\t}\n\t\tisrCache.set(key, val);\n\t}\n\n\t/** 生产环境模板缓存（模板不变，避免每请求重复读盘） */\n\tlet templateCache: string | undefined;\n\n\tasync function readTemplate(url: string): Promise<string> {\n\t\tif (!isProduction && vite) {\n\t\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\t\tconst raw = readFileSync(resolve(root, \"index.html\"), \"utf-8\");\n\t\t\treturn vite.transformIndexHtml(url, raw);\n\t\t}\n\n\t\tif (templateCache) return templateCache;\n\n\t\tconst isDeno = typeof (globalThis as any).Deno !== \"undefined\";\n\t\tif (isDeno) {\n\t\t\ttemplateCache = (globalThis as any).Deno.readTextFileSync(\n\t\t\t\tnew URL(\"../dist/client/index.html\", import.meta.url),\n\t\t\t);\n\t\t\treturn templateCache!;\n\t\t}\n\n\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\ttemplateCache = readFileSync(\n\t\t\tresolve(root, \"dist/client/index.html\"),\n\t\t\t\"utf-8\",\n\t\t);\n\t\treturn templateCache!;\n\t}\n\n\tasync function loadSSRModule(): Promise<SSRModule> {\n\t\tif (!isProduction && vite) {\n\t\t\treturn (await vite.ssrLoadModule(ssrEntryPath)) as SSRModule;\n\t\t}\n\t\tif (ssrProductionModule) {\n\t\t\treturn import(\n\t\t\t\t/* @vite-ignore */ ssrProductionModule\n\t\t\t) as Promise<SSRModule>;\n\t\t}\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\tconst { pathToFileURL } = await import(/* @vite-ignore */ \"node:url\");\n\t\tconst absPath = pathToFileURL(resolve(root, \"dist/server/ssr.js\")).href;\n\t\treturn import(/* @vite-ignore */ absPath) as Promise<SSRModule>;\n\t}\n\n\tapp.get(\"*\", async (c) => {\n\t\t// 递归深度保护：从请求头读取 SSR 深度\n\t\tconst ssrDepth = parseInt(c.req.header(SSR_DEPTH_HEADER) ?? \"0\", 10);\n\t\tif (ssrDepth >= MAX_SSR_DEPTH) {\n\t\t\treturn c.text(\"SSR recursion loop detected\", 508);\n\t\t}\n\n\t\tconst url =\n\t\t\tc.req.path +\n\t\t\t(c.req.url.includes(\"?\") ? \"?\" + c.req.url.split(\"?\")[1] : \"\");\n\n\t\ttry {\n\t\t\tconst template = await readTemplate(url);\n\t\t\tconst { render, serializeServerData } = await loadSSRModule();\n\n\t\t\tconst locale = parseAcceptLanguage(\n\t\t\t\tc.req.header(\"accept-language\"),\n\t\t\t\tsupportedLocales,\n\t\t\t\tdefaultLocale,\n\t\t\t);\n\n\t\t\t// Vite 配置级别覆盖：CSR 直接返回空壳\n\t\t\tconst overrideMode = matchRenderModeOverride(url, renderModes);\n\t\t\tif (overrideMode === \"csr\") {\n\t\t\t\treturn c.html(injectCSRShell(template, locale));\n\t\t\t}\n\n\t\t\t// ISR 缓存命中（key 含 locale，避免跨语言缓存污染）\n\t\t\tconst cacheKey = `${locale}:${url}`;\n\t\t\tconst cached = isrCache.get(cacheKey);\n\t\t\tif (cached) return c.html(cached);\n\n\t\t\t// 每请求创建 internalFetch，深度通过请求头传递\n\t\t\tconst requestFetch = parentFetch\n\t\t\t\t? createInternalFetch(parentFetch, ssrDepth + 1)\n\t\t\t\t: undefined;\n\n\t\t\tconst {\n\t\t\t\thtml: appHtml,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\tserverData,\n\t\t\t\trenderMode,\n\t\t\t} = await render(\n\t\t\t\turl,\n\t\t\t\tlocale,\n\t\t\t\trequestFetch ? { fetch: requestFetch } : undefined,\n\t\t\t);\n\n\t\t\t// CSR 模式：返回空壳 HTML\n\t\t\tif (renderMode === \"csr\") {\n\t\t\t\treturn c.html(injectCSRShell(template, locale));\n\t\t\t}\n\n\t\t\tconst serializedData = serializeServerData(serverData);\n\n\t\t\tconst finalHtml = injectSSRContent({\n\t\t\t\ttemplate,\n\t\t\t\tlocale,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\thtml: appHtml,\n\t\t\t\tserializedData,\n\t\t\t});\n\n\t\t\t// Prerender ISR 缓存（包括 Vite 配置覆盖和路由级）\n\t\t\tif (renderMode === \"prerender\" || overrideMode === \"prerender\") {\n\t\t\t\tisrSet(cacheKey, finalHtml);\n\t\t\t}\n\n\t\t\treturn c.html(finalHtml);\n\t\t} catch (e) {\n\t\t\tif (!isProduction && vite) {\n\t\t\t\tvite.ssrFixStacktrace(e as Error);\n\t\t\t}\n\t\t\tconsole.error(\"[SSR Error]\", e);\n\t\t\treturn c.text(\"Internal Server Error\", 500);\n\t\t}\n\t});\n\n\treturn app;\n}\n","/**\n * createInternalFetch — SSR 内部路由回环 fetch 包装器\n *\n * 将相对路径（/api/…）请求转为 Hono app.fetch 内存调用，\n * 绝对 URL 和非字符串 input 走 globalThis.fetch（真实网络）。\n *\n * 递归深度保护采用请求头传递：每次 SSR 回环在请求头中写入深度值，\n * SSR catch-all 读取深度判断是否超限。对比闭包计数器方案：\n * - 并发安全：无共享可变状态\n * - 跨渲染准确：深度随请求在 Hono 路由链中传递\n */\n\nexport const SSR_DEPTH_HEADER = \"x-ssr-depth\";\nexport const MAX_SSR_DEPTH = 5;\n\n/**\n * 创建请求级 internal fetch\n *\n * @param appFetch - Hono app.fetch（父级路由）\n * @param depth - 当前 SSR 深度（由 catch-all handler 从请求头读取后 +1 传入）\n */\nexport function createInternalFetch(\n\tappFetch: (request: Request) => Response | Promise<Response>,\n\tdepth: number = 1,\n): typeof globalThis.fetch {\n\treturn ((input: RequestInfo | URL, init?: RequestInit) => {\n\t\t// 只拦截相对路径（以 / 开头），其他一律走真实网络\n\t\tif (typeof input === \"string\" && input.startsWith(\"/\")) {\n\t\t\tconst request = new Request(`http://localhost${input}`, init);\n\t\t\trequest.headers.set(SSR_DEPTH_HEADER, String(depth));\n\t\t\treturn Promise.resolve(appFetch(request));\n\t\t}\n\n\t\t// 绝对 URL / URL 对象 / Request 对象 → 走正常网络\n\t\treturn globalThis.fetch(input, init);\n\t}) as typeof globalThis.fetch;\n}\n"],"mappings":"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","names":["readFileSync","resolve"]}

package/dist/index.cjs

@@ -1177,6 +1177,19 @@ var app_exports = {};
 __export(app_exports, {
   createSSRApp: () => createSSRApp
 });
+function matchRenderModeOverride(url, renderModes) {
+  if (!renderModes) return null;
+  const path = url.split("?")[0];
+  if (renderModes[path]) return renderModes[path];
+  for (const [pattern, mode] of Object.entries(renderModes)) {
+    if (pattern.includes("*")) {
+      const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+      const re = new RegExp("^" + escaped.replace(/\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
 function createSSRApp(options) {
   const {
     root,
@@ -1186,7 +1199,8 @@ function createSSRApp(options) {
     ssrProductionModule,
     supportedLocales,
     defaultLocale,
-    parentFetch
+    parentFetch,
+    renderModes
   } = options;
   const app = new import_hono.Hono();
   const ISR_CACHE_MAX = 1e3;
@@ -1272,6 +1286,10 @@ function createSSRApp(options) {
         supportedLocales,
         defaultLocale
       );
+      const overrideMode = matchRenderModeOverride(url, renderModes);
+      if (overrideMode === "csr") {
+        return c.html(injectCSRShell(template, locale));
+      }
       const cacheKey = `${locale}:${url}`;
       const cached = isrCache.get(cacheKey);
       if (cached) return c.html(cached);
@@ -1299,7 +1317,7 @@ function createSSRApp(options) {
         html: appHtml,
         serializedData
       });
-      if (renderMode === "prerender") {
+      if (renderMode === "prerender" || overrideMode === "prerender") {
         isrSet(cacheKey, finalHtml);
       }
       return c.html(finalHtml);
@@ -1358,6 +1376,7 @@ __export(index_exports, {
   deserializeServerData: () => deserializeServerData,
   detectRuntime: () => detectRuntime,
   finesoftFrontViteConfig: () => finesoftFrontViteConfig,
+  generateProxyCode: () => generateProxyCode,
   generateUuid: () => generateUuid,
   getBaseUrl: () => getBaseUrl,
   injectCSRShell: () => injectCSRShell,
@@ -1379,6 +1398,7 @@ __export(index_exports, {
   registerActionHandlers: () => registerActionHandlers,
   registerExternalUrlHandler: () => registerExternalUrlHandler,
   registerFlowActionHandler: () => registerFlowActionHandler,
+  registerProxyRoutes: () => registerProxyRoutes,
   removeHost: () => removeHost,
   removeQueryParams: () => removeQueryParams,
   removeScheme: () => removeScheme,
@@ -1732,6 +1752,120 @@ init_src();
 // src/index.ts
 init_src2();
 
+// ../server/src/proxy.ts
+function sanitizeProxyPath(raw) {
+  if (raw.startsWith("//")) return null;
+  return raw.startsWith("/") ? raw : `/${raw}`;
+}
+function validateConfig(config) {
+  if (!config.prefix.startsWith("/")) {
+    throw new Error(
+      `[proxy] prefix must start with "/": "${config.prefix}"`
+    );
+  }
+  if (!config.target.startsWith("https://")) {
+    throw new Error(`[proxy] target must use HTTPS: "${config.target}"`);
+  }
+}
+function registerProxyRoutes(app, configs) {
+  for (const config of configs) {
+    validateConfig(config);
+    const methods = config.methods ?? ["all"];
+    const pattern = `${config.prefix}/*`;
+    const handler = async (c) => {
+      const subPath = sanitizeProxyPath(
+        c.req.path.replace(config.prefix, "")
+      );
+      if (!subPath) return c.text("Invalid path", 400);
+      const targetUrl = new URL(subPath, config.target);
+      const reqUrl = new URL(c.req.url);
+      reqUrl.searchParams.forEach(
+        (v, k) => targetUrl.searchParams.set(k, v)
+      );
+      const headers = { ...config.headers };
+      if (config.auth) {
+        const token = process.env[config.auth.envKey] ?? "";
+        if (token) {
+          headers.Authorization = config.auth.type === "bearer" ? `Bearer ${token}` : `Basic ${token}`;
+        }
+      }
+      try {
+        const resp = await fetch(targetUrl.toString(), {
+          headers,
+          redirect: config.followRedirects ? "follow" : "manual"
+        });
+        const body = await resp.text();
+        const respHeaders = {
+          "Content-Type": resp.headers.get("Content-Type") ?? "application/json"
+        };
+        if (config.cache) {
+          respHeaders["Cache-Control"] = config.cache;
+        }
+        return c.newResponse(body, resp.status, respHeaders);
+      } catch (e) {
+        console.error(`[Proxy ${config.prefix}]`, e);
+        return c.json({ error: "Proxy request failed" }, 502);
+      }
+    };
+    for (const method of methods) {
+      app[method](pattern, handler);
+    }
+  }
+}
+function generateProxyCode(configs) {
+  if (!configs || configs.length === 0) return "";
+  for (const config of configs) {
+    validateConfig(config);
+  }
+  const blocks = [];
+  blocks.push(`
+// \u2500\u2500\u2500 \u6846\u67B6\u58F0\u660E\u5F0F\u4EE3\u7406\u8DEF\u7531 \u2500\u2500\u2500
+function _sanitizeProxyPath(raw) {
+  if (raw.startsWith("//")) return null;
+  return raw.startsWith("/") ? raw : "/" + raw;
+}
+`);
+  for (const config of configs) {
+    const methods = config.methods ?? ["all"];
+    const pattern = `"${config.prefix}/*"`;
+    const headersJson = JSON.stringify(config.headers ?? {});
+    const cacheStr = config.cache ? JSON.stringify(config.cache) : "null";
+    const redirect = config.followRedirects ? '"follow"' : '"manual"';
+    let authCode = "";
+    if (config.auth) {
+      const envKey = JSON.stringify(config.auth.envKey);
+      const prefix = config.auth.type === "bearer" ? "Bearer " : "Basic ";
+      authCode = `
+  const _token = (typeof process !== "undefined" && process.env && process.env[${envKey}]) || "";
+  if (_token) _headers.Authorization = "${prefix}" + _token;`;
+    }
+    const handlerCode = `async (c) => {
+  const _sub = _sanitizeProxyPath(c.req.path.replace(${JSON.stringify(
+      config.prefix
+    )}, ""));
+  if (!_sub) return c.text("Invalid path", 400);
+  const _target = new URL(_sub, ${JSON.stringify(config.target)});
+  const _reqUrl = new URL(c.req.url);
+  _reqUrl.searchParams.forEach((v, k) => _target.searchParams.set(k, v));
+  const _headers = ${headersJson};${authCode}
+  try {
+    const _resp = await fetch(_target.toString(), { headers: _headers, redirect: ${redirect} });
+    const _body = await _resp.text();
+    const _rh = { "Content-Type": _resp.headers.get("Content-Type") || "application/json" };
+    if (${cacheStr}) _rh["Cache-Control"] = ${cacheStr};
+    return c.newResponse(_body, _resp.status, _rh);
+  } catch (_e) {
+    console.error("[Proxy ${config.prefix}]", _e);
+    return c.json({ error: "Proxy request failed" }, 502);
+  }
+}`;
+    for (const method of methods) {
+      blocks.push(`app.${method}(${pattern}, ${handlerCode});`);
+    }
+  }
+  return blocks.join("\n");
+}
+
 // ../server/src/adapters/shared.ts
 var BUILD_TOOL_EXTERNALS = [
   "vite",
@@ -1814,6 +1948,7 @@ function matchRenderMode(url) {
 }
 
 const app = new Hono();
+${generateProxyCode(ctx.proxies ?? [])}
 ${setupCall}
 ${opts.platformMiddleware ?? ""}
 
@@ -2673,6 +2808,7 @@ async function createServer(config = {}) {
     defaultLocale,
     port = Number(process.env.PORT) || 3e3,
     setup,
+    proxies,
     ssr
   } = config;
   const root = rootOverride ?? process.cwd();
@@ -2709,6 +2845,9 @@ async function createServer(config = {}) {
     });
   }
   const app = new import_hono3.Hono();
+  if (proxies?.length) {
+    registerProxyRoutes(app, proxies);
+  }
   if (setup) {
     await setup(app);
   }
@@ -2765,6 +2904,7 @@ function finesoftFrontViteConfig(options = {}) {
   let resolvedCommand;
   let resolvedResolve;
   let resolvedCss;
+  const CSS_EXTENSIONS = /\.(css|scss|less|sass|styl|stylus|pcss|postcss)($|\?)/;
   return {
     name: "finesoft-front",
     config(userConfig, env) {
@@ -2784,6 +2924,82 @@ function finesoftFrontViteConfig(options = {}) {
       resolvedCss = config.css;
       root = config.root;
     },
+    /**
+     * Dev 模式 CSS 内联 — 消除 SSR 首屏布局抖动
+     *
+     * Vite dev 模式下，global.scss 等非组件 CSS 通过 JS 模块系统异步加载，
+     * 导致 SSR HTML 初次渲染缺少布局关键样式（box-sizing、flex 布局、padding-top 等）。
+     *
+     * 此 hook 在 HTML 模板变换阶段（SSR 渲染之前）：
+     * 1. 找到浏览器入口脚本（排除 /@vite/client 等内部脚本）
+     * 2. 编译入口脚本，填充 Vite 模块图
+     * 3. 遍历模块图收集所有 CSS 依赖（排除 .svelte 组件 CSS，由 SSR 渲染自行处理）
+     * 4. 通过 ssrLoadModule 获取编译后 CSS（SCSS→CSS）
+     * 5. 注入 <style data-vite-dev-id> 标签到 <head>
+     *
+     * data-vite-dev-id 确保 Vite HMR 客户端复用已有标签，避免重复注入。
+     */
+    transformIndexHtml: {
+      order: "pre",
+      async handler(html, ctx) {
+        const server = ctx.server;
+        if (!server) return;
+        const urlPath = (ctx.originalUrl || ctx.path || "").split(
+          "?"
+        )[0];
+        if (/\.\w+$/.test(urlPath) && !urlPath.endsWith(".html")) {
+          return;
+        }
+        const scripts = [
+          ...html.matchAll(
+            /<script\b[^>]*\bsrc=["']([^"']+)["'][^>]*>/g
+          )
+        ];
+        const appEntry = scripts.find((m) => !m[1].startsWith("/@"));
+        if (!appEntry) return;
+        const browserEntry = appEntry[1];
+        try {
+          await server.transformRequest(browserEntry);
+        } catch {
+          return;
+        }
+        const cssUrls = [];
+        const visited = /* @__PURE__ */ new Set();
+        function walk(mod) {
+          if (!mod?.url || visited.has(mod.url)) return;
+          visited.add(mod.url);
+          if (CSS_EXTENSIONS.test(mod.url) && !mod.url.includes(".svelte")) {
+            cssUrls.push(mod.url);
+          }
+          if (mod.importedModules) {
+            for (const imported of mod.importedModules) {
+              walk(imported);
+            }
+          }
+        }
+        const mg = server.moduleGraph;
+        const browserMod = await mg.getModuleByUrl(browserEntry);
+        if (browserMod) walk(browserMod);
+        if (cssUrls.length === 0) return;
+        const tags = [];
+        for (const url of cssUrls) {
+          try {
+            const mod = await server.ssrLoadModule(url);
+            const css = mod?.default;
+            if (typeof css === "string" && css.length > 0) {
+              tags.push({
+                tag: "style",
+                attrs: { "data-vite-dev-id": url },
+                children: css,
+                injectTo: "head"
+              });
+            }
+          } catch {
+          }
+        }
+        return tags;
+      }
+    },
     // ─── Dev ───────────────────────────────────────────────
     configureServer(server) {
       return async () => {
@@ -2797,6 +3013,9 @@ function finesoftFrontViteConfig(options = {}) {
           "@hono/node-server"
         );
         const app = new HonoClass();
+        if (options.proxies?.length) {
+          registerProxyRoutes(app, options.proxies);
+        }
         if (typeof options.setup === "function") {
           await options.setup(app);
         } else if (typeof options.setup === "string") {
@@ -2811,7 +3030,8 @@ function finesoftFrontViteConfig(options = {}) {
           ssrEntryPath: "/" + ssrEntry,
           supportedLocales: options.locales,
           defaultLocale: options.defaultLocale,
-          parentFetch: app.fetch.bind(app)
+          parentFetch: app.fetch.bind(app),
+          renderModes: options.renderModes
         });
         app.route("/", ssrApp);
         const listener = getRequestListener(app.fetch);
@@ -2847,6 +3067,9 @@ function finesoftFrontViteConfig(options = {}) {
         );
         const app = new HonoClass();
         const isrCache = /* @__PURE__ */ new Map();
+        if (options.proxies?.length) {
+          registerProxyRoutes(app, options.proxies);
+        }
         if (typeof options.setup === "function") {
           await options.setup(app);
         } else if (typeof options.setup === "string") {
@@ -3001,6 +3224,7 @@ function finesoftFrontViteConfig(options = {}) {
             defaultLocale,
             templateHtml,
             renderModes: options.renderModes,
+            proxies: options.proxies,
             resolvedResolve,
             resolvedCss,
             vite,
@@ -3058,6 +3282,7 @@ function finesoftFrontViteConfig(options = {}) {
   deserializeServerData,
   detectRuntime,
   finesoftFrontViteConfig,
+  generateProxyCode,
   generateUuid,
   getBaseUrl,
   injectCSRShell,
@@ -3079,6 +3304,7 @@ function finesoftFrontViteConfig(options = {}) {
   registerActionHandlers,
   registerExternalUrlHandler,
   registerFlowActionHandler,
+  registerProxyRoutes,
   removeHost,
   removeQueryParams,
   removeScheme,