@finesoft/front 0.1.18 → 0.1.20

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { FrameworkConfig, Framework, BasePage, PrefetchedIntent } from './browser.cjs';
-export { ACTION_KINDS, Action, ActionDispatcher, ActionHandler, ActionHandlerDependencies, AsyncMapper, BaseController, BaseItem, BaseLogger, BaseShelf, BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, ExternalUrlAction, ExternalUrlDependencies, FeatureFlags, FlowAction, FlowActionCallbacks, FlowActionDependencies, History, HttpClient, HttpClientConfig, HttpError, Intent, IntentController, IntentDispatcher, Locale, Logger, LoggerFactory, Logger as LoggerInterface, LruMap, Mapper, MetricsRecorder, Net, None, Optional, PrefetchedIntents, RouteDefinition, RouteMatch, Router, Storage, buildUrl, createPrefetchedIntentsFromDom, defineRoutes, deserializeServerData, generateUuid, getBaseUrl, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, shouldLog, stableStringify, startBrowserApp, tryScroll } from './browser.cjs';
+export { ACTION_KINDS, Action, ActionDispatcher, ActionHandler, ActionHandlerDependencies, AsyncMapper, BaseController, BaseItem, BaseLogger, BaseShelf, BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, ExternalUrlAction, ExternalUrlDependencies, FeatureFlags, FlowAction, FlowActionCallbacks, FlowActionDependencies, History, HttpClient, HttpClientConfig, HttpError, Intent, IntentController, IntentDispatcher, Locale, Logger, LoggerFactory, Logger as LoggerInterface, LruMap, Mapper, MetricsRecorder, Net, None, Optional, PrefetchedIntents, RenderMode, RouteDefinition, RouteMatch, Router, Storage, buildUrl, createPrefetchedIntentsFromDom, defineRoutes, deserializeServerData, generateUuid, getBaseUrl, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, shouldLog, stableStringify, startBrowserApp, tryScroll } from './browser.cjs';
 import * as node_fs from 'node:fs';
 import { Hono } from 'hono';
 import { ViteDevServer } from 'vite';
@@ -35,6 +35,8 @@ interface SSRRenderResult {
     head: string;
     css: string;
     serverData: PrefetchedIntent[];
+    /** 该路由的渲染模式（由 Router 返回） */
+    renderMode?: string;
 }
 declare function ssrRender(options: SSRRenderOptions): Promise<SSRRenderResult>;
 
@@ -88,6 +90,11 @@ interface InjectSSROptions {
     serializedData: string;
 }
 declare function injectSSRContent(options: InjectSSROptions): string;
+/**
+ * CSR 空壳注入 — 只替换 lang，清空 body/head/data 占位符
+ * 用于 renderMode === "csr" 的路由
+ */
+declare function injectCSRShell(template: string, locale: string): string;
 
 /**
  * serializeServerData — 将 PrefetchedIntents 数据序列化为安全的 JSON
@@ -121,6 +128,11 @@ interface AdapterContext {
     resolvedResolve: unknown;
     /** Vite 的 css 配置 */
     resolvedCss: unknown;
+    /**
+     * 按路由覆盖的渲染模式。
+     * key: 精确路径或 glob 模式，value: "ssr" | "csr" | "prerender"
+     */
+    renderModes?: Record<string, string>;
     vite: any;
     fs: typeof node_fs;
     path: {
@@ -264,6 +276,7 @@ interface SSRModule {
         head: string;
         css: string;
         serverData: unknown;
+        renderMode?: string;
     }>;
     serializeServerData: (data: unknown) => string;
 }
@@ -413,6 +426,20 @@ interface FinesoftFrontViteOptions {
      * - 不设置则不生成部署产物
      */
     adapter?: string | Adapter;
+    /**
+     * 按路由覆盖渲染模式（优先级高于 RouteDefinition.renderMode）。
+     * key: 精确路径或 glob 模式，如 "/search" 或 "/blog/*"
+     * value: "ssr" | "csr" | "prerender"
+     *
+     * @example
+     * ```ts
+     * renderModes: {
+     *   "/search": "csr",
+     *   "/blog/*": "prerender",
+     * }
+     * ```
+     */
+    renderModes?: Record<string, "ssr" | "csr" | "prerender">;
 }
 declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     name: string;
@@ -425,4 +452,4 @@ declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     closeBundle(): Promise<void>;
 };
 
-export { type Adapter, type AdapterContext, BasePage, type FinesoftFrontViteOptions, Framework, FrameworkConfig, type InjectSSROptions, PrefetchedIntent, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, SSR_PLACEHOLDERS, type ServerConfig, type ServerInstance, type StartServerOptions, autoAdapter, cloudflareAdapter, createSSRApp, createSSRRender, createServer, detectRuntime, finesoftFrontViteConfig, injectSSRContent, netlifyAdapter, nodeAdapter, parseAcceptLanguage, resolveAdapter, resolveRoot, serializeServerData, ssrRender, startServer, staticAdapter, vercelAdapter };
+export { type Adapter, type AdapterContext, BasePage, type FinesoftFrontViteOptions, Framework, FrameworkConfig, type InjectSSROptions, PrefetchedIntent, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, SSR_PLACEHOLDERS, type ServerConfig, type ServerInstance, type StartServerOptions, autoAdapter, cloudflareAdapter, createSSRApp, createSSRRender, createServer, detectRuntime, finesoftFrontViteConfig, injectCSRShell, injectSSRContent, netlifyAdapter, nodeAdapter, parseAcceptLanguage, resolveAdapter, resolveRoot, serializeServerData, ssrRender, startServer, staticAdapter, vercelAdapter };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { FrameworkConfig, Framework, BasePage, PrefetchedIntent } from './browser.js';
-export { ACTION_KINDS, Action, ActionDispatcher, ActionHandler, ActionHandlerDependencies, AsyncMapper, BaseController, BaseItem, BaseLogger, BaseShelf, BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, ExternalUrlAction, ExternalUrlDependencies, FeatureFlags, FlowAction, FlowActionCallbacks, FlowActionDependencies, History, HttpClient, HttpClientConfig, HttpError, Intent, IntentController, IntentDispatcher, Locale, Logger, LoggerFactory, Logger as LoggerInterface, LruMap, Mapper, MetricsRecorder, Net, None, Optional, PrefetchedIntents, RouteDefinition, RouteMatch, Router, Storage, buildUrl, createPrefetchedIntentsFromDom, defineRoutes, deserializeServerData, generateUuid, getBaseUrl, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, shouldLog, stableStringify, startBrowserApp, tryScroll } from './browser.js';
+export { ACTION_KINDS, Action, ActionDispatcher, ActionHandler, ActionHandlerDependencies, AsyncMapper, BaseController, BaseItem, BaseLogger, BaseShelf, BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, ExternalUrlAction, ExternalUrlDependencies, FeatureFlags, FlowAction, FlowActionCallbacks, FlowActionDependencies, History, HttpClient, HttpClientConfig, HttpError, Intent, IntentController, IntentDispatcher, Locale, Logger, LoggerFactory, Logger as LoggerInterface, LruMap, Mapper, MetricsRecorder, Net, None, Optional, PrefetchedIntents, RenderMode, RouteDefinition, RouteMatch, Router, Storage, buildUrl, createPrefetchedIntentsFromDom, defineRoutes, deserializeServerData, generateUuid, getBaseUrl, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, shouldLog, stableStringify, startBrowserApp, tryScroll } from './browser.js';
 import * as node_fs from 'node:fs';
 import { Hono } from 'hono';
 import { ViteDevServer } from 'vite';
@@ -35,6 +35,8 @@ interface SSRRenderResult {
     head: string;
     css: string;
     serverData: PrefetchedIntent[];
+    /** 该路由的渲染模式（由 Router 返回） */
+    renderMode?: string;
 }
 declare function ssrRender(options: SSRRenderOptions): Promise<SSRRenderResult>;
 
@@ -88,6 +90,11 @@ interface InjectSSROptions {
     serializedData: string;
 }
 declare function injectSSRContent(options: InjectSSROptions): string;
+/**
+ * CSR 空壳注入 — 只替换 lang，清空 body/head/data 占位符
+ * 用于 renderMode === "csr" 的路由
+ */
+declare function injectCSRShell(template: string, locale: string): string;
 
 /**
  * serializeServerData — 将 PrefetchedIntents 数据序列化为安全的 JSON
@@ -121,6 +128,11 @@ interface AdapterContext {
     resolvedResolve: unknown;
     /** Vite 的 css 配置 */
     resolvedCss: unknown;
+    /**
+     * 按路由覆盖的渲染模式。
+     * key: 精确路径或 glob 模式，value: "ssr" | "csr" | "prerender"
+     */
+    renderModes?: Record<string, string>;
     vite: any;
     fs: typeof node_fs;
     path: {
@@ -264,6 +276,7 @@ interface SSRModule {
         head: string;
         css: string;
         serverData: unknown;
+        renderMode?: string;
     }>;
     serializeServerData: (data: unknown) => string;
 }
@@ -413,6 +426,20 @@ interface FinesoftFrontViteOptions {
      * - 不设置则不生成部署产物
      */
     adapter?: string | Adapter;
+    /**
+     * 按路由覆盖渲染模式（优先级高于 RouteDefinition.renderMode）。
+     * key: 精确路径或 glob 模式，如 "/search" 或 "/blog/*"
+     * value: "ssr" | "csr" | "prerender"
+     *
+     * @example
+     * ```ts
+     * renderModes: {
+     *   "/search": "csr",
+     *   "/blog/*": "prerender",
+     * }
+     * ```
+     */
+    renderModes?: Record<string, "ssr" | "csr" | "prerender">;
 }
 declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     name: string;
@@ -425,4 +452,4 @@ declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     closeBundle(): Promise<void>;
 };
 
-export { type Adapter, type AdapterContext, BasePage, type FinesoftFrontViteOptions, Framework, FrameworkConfig, type InjectSSROptions, PrefetchedIntent, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, SSR_PLACEHOLDERS, type ServerConfig, type ServerInstance, type StartServerOptions, autoAdapter, cloudflareAdapter, createSSRApp, createSSRRender, createServer, detectRuntime, finesoftFrontViteConfig, injectSSRContent, netlifyAdapter, nodeAdapter, parseAcceptLanguage, resolveAdapter, resolveRoot, serializeServerData, ssrRender, startServer, staticAdapter, vercelAdapter };
+export { type Adapter, type AdapterContext, BasePage, type FinesoftFrontViteOptions, Framework, FrameworkConfig, type InjectSSROptions, PrefetchedIntent, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, SSR_PLACEHOLDERS, type ServerConfig, type ServerInstance, type StartServerOptions, autoAdapter, cloudflareAdapter, createSSRApp, createSSRRender, createServer, detectRuntime, finesoftFrontViteConfig, injectCSRShell, injectSSRContent, netlifyAdapter, nodeAdapter, parseAcceptLanguage, resolveAdapter, resolveRoot, serializeServerData, ssrRender, startServer, staticAdapter, vercelAdapter };

package/dist/index.js

@@ -7,17 +7,18 @@ import {
   registerFlowActionHandler,
   startBrowserApp,
   tryScroll
-} from "./chunk-T2AQHAYK.js";
+} from "./chunk-H3RNYNSD.js";
 import {
   createSSRApp
-} from "./chunk-Z4MHYAS3.js";
+} from "./chunk-SN3OO3DU.js";
 import {
   SSR_PLACEHOLDERS,
   createSSRRender,
+  injectCSRShell,
   injectSSRContent,
   serializeServerData,
   ssrRender
-} from "./chunk-2VETWTN5.js";
+} from "./chunk-5ZECBECP.js";
 import {
   ACTION_KINDS,
   ActionDispatcher,
@@ -57,7 +58,7 @@ import {
   resetFilterCache,
   shouldLog,
   stableStringify
-} from "./chunk-RVKDILGM.js";
+} from "./chunk-BUYWNNNQ.js";
 import {
   parseAcceptLanguage
 } from "./chunk-FYP2ZYYV.js";
@@ -75,6 +76,7 @@ function generateSSREntry(ctx, opts) {
   const setupCall = ctx.setupPath ? `if (typeof _setupDefault === "function") await _setupDefault(app);` : ``;
   const locales = JSON.stringify(ctx.locales);
   const defaultLocale = JSON.stringify(ctx.defaultLocale);
+  const renderModes = JSON.stringify(ctx.renderModes ?? {});
   return `
 import { Hono } from "hono";
 ${opts.platformImport}
@@ -84,6 +86,7 @@ ${setupImport}
 const TEMPLATE = ${JSON.stringify(ctx.templateHtml)};
 const LOCALES = ${locales};
 const DEFAULT_LOCALE = ${defaultLocale};
+const RENDER_MODES = ${renderModes};
 
 function parseAcceptLanguage(header) {
   if (!header) return DEFAULT_LOCALE;
@@ -106,6 +109,28 @@ function injectSSR(t, locale, head, css, html, data) {
     .replace("<!--ssr-data-->", '<script id="serialized-server-data" type="application/json">' + data + "</script>");
 }
 
+function injectCSRShell(t, locale) {
+  return t
+    .replace("<!--ssr-lang-->", locale)
+    .replace("<!--ssr-head-->", "")
+    .replace("<!--ssr-body-->", "")
+    .replace("<!--ssr-data-->", "");
+}
+
+function matchRenderMode(url) {
+  const path = url.split("?")[0];
+  if (RENDER_MODES[path]) return RENDER_MODES[path];
+  for (const [pattern, mode] of Object.entries(RENDER_MODES)) {
+    if (pattern.includes("*")) {
+      const re = new RegExp("^" + pattern.replace(/\\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
+
+const isrCache = new Map();
+
 const app = new Hono();
 ${setupCall}
 
@@ -113,9 +138,33 @@ app.get("*", async (c) => {
   const url = c.req.path + (c.req.url.includes("?") ? "?" + c.req.url.split("?")[1] : "");
   try {
     const locale = parseAcceptLanguage(c.req.header("accept-language"));
-    const { html: appHtml, head, css, serverData } = await render(url, locale);
+
+    // Vite \u914D\u7F6E\u7EA7\u522B\u8986\u76D6: CSR \u76F4\u63A5\u8FD4\u56DE\u7A7A\u58F3
+    const overrideMode = matchRenderMode(url);
+    if (overrideMode === "csr") {
+      return c.html(injectCSRShell(TEMPLATE, locale));
+    }
+
+    // ISR \u7F13\u5B58\u547D\u4E2D
+    const cached = isrCache.get(url);
+    if (cached) return c.html(cached);
+
+    const { html: appHtml, head, css, serverData, renderMode } = await render(url, locale);
+
+    // \u8DEF\u7531\u7EA7 CSR
+    if (renderMode === "csr") {
+      return c.html(injectCSRShell(TEMPLATE, locale));
+    }
+
     const serializedData = serializeServerData(serverData);
-    return c.html(injectSSR(TEMPLATE, locale, head, css, appHtml, serializedData));
+    const finalHtml = injectSSR(TEMPLATE, locale, head, css, appHtml, serializedData);
+
+    // Prerender ISR \u7F13\u5B58\uFF08\u5305\u62EC Vite \u914D\u7F6E\u8986\u76D6\u548C\u8DEF\u7531\u7EA7\uFF09
+    if (renderMode === "prerender" || overrideMode === "prerender") {
+      isrCache.set(url, finalHtml);
+    }
+
+    return c.html(finalHtml);
   } catch (e) {
     console.error("[SSR Error]", e);
     return c.text("Internal Server Error", 500);
@@ -154,6 +203,89 @@ function copyStaticAssets(ctx, destDir, opts) {
     fs.rmSync(path.join(destDir, "index.html"), { force: true });
   }
 }
+async function prerenderRoutes(ctx, routesExport = "src/lib/bootstrap.ts") {
+  const { fs, path, root, vite } = ctx;
+  const { pathToFileURL } = await import(
+    /* @vite-ignore */
+    "url"
+  );
+  await vite.build({
+    root,
+    build: {
+      ssr: routesExport,
+      outDir: path.resolve(root, "dist/server"),
+      emptyOutDir: false,
+      rollupOptions: {
+        output: { entryFileNames: "_routes_prerender.mjs" }
+      }
+    },
+    resolve: ctx.resolvedResolve
+  });
+  const routesPath = pathToFileURL(
+    path.resolve(root, "dist/server/_routes_prerender.mjs")
+  ).href;
+  const routesMod = await import(
+    /* @vite-ignore */
+    routesPath
+  );
+  const routes = routesMod.routes ?? routesMod.default ?? [];
+  fs.rmSync(path.resolve(root, "dist/server/_routes_prerender.mjs"), {
+    force: true
+  });
+  const prerenderPaths = /* @__PURE__ */ new Set();
+  for (const r of routes) {
+    if (r.renderMode === "prerender" && r.path && !r.path.includes(":")) {
+      prerenderPaths.add(r.path);
+    }
+  }
+  if (ctx.renderModes) {
+    for (const [pattern, mode] of Object.entries(ctx.renderModes)) {
+      if (mode === "prerender" && !pattern.includes("*") && !pattern.includes(":")) {
+        prerenderPaths.add(pattern);
+      }
+    }
+  }
+  if (prerenderPaths.size === 0) return [];
+  const ssrPath = pathToFileURL(
+    path.resolve(root, "dist/server/ssr.js")
+  ).href;
+  const ssrModule = await import(
+    /* @vite-ignore */
+    ssrPath
+  );
+  const results = [];
+  for (const routePath of prerenderPaths) {
+    for (const locale of ctx.locales) {
+      const url = locale === ctx.defaultLocale ? routePath : `/${locale}${routePath === "/" ? "" : routePath}`;
+      try {
+        const {
+          html: appHtml,
+          head,
+          css,
+          serverData
+        } = await ssrModule.render(url, locale);
+        const serializedData = ssrModule.serializeServerData(serverData);
+        const finalHtml = ctx.templateHtml.replace("<!--ssr-lang-->", locale).replace(
+          "<!--ssr-head-->",
+          head + "\n<style>" + css + "</style>"
+        ).replace("<!--ssr-body-->", appHtml).replace(
+          "<!--ssr-data-->",
+          '<script id="serialized-server-data" type="application/json">' + serializedData + "</script>"
+        );
+        results.push({ url, html: finalHtml });
+      } catch (e) {
+        console.warn(`  [prerender] Failed to render ${url}:`, e);
+      }
+    }
+  }
+  if (results.length > 0) {
+    console.log(
+      `  Pre-rendered ${results.length} pages (${prerenderPaths.size} routes \xD7 ${ctx.locales.length} locales)
+`
+    );
+  }
+  return results;
+}
 
 // ../server/src/adapters/cloudflare.ts
 function cloudflareAdapter() {
@@ -179,6 +311,14 @@ function cloudflareAdapter() {
           // 这些构建工具运行时不需要，且 fsevents 是 macOS .node 原生二进制无法打包
         });
         copyStaticAssets(ctx, path.resolve(outputDir, "assets"));
+        const prerendered = await prerenderRoutes(ctx);
+        for (const { url, html } of prerendered) {
+          const filePath = url === "/" ? path.join(outputDir, "assets", "index.html") : path.join(outputDir, "assets", url, "index.html");
+          fs.mkdirSync(path.resolve(filePath, ".."), {
+            recursive: true
+          });
+          fs.writeFileSync(filePath, html);
+        }
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
@@ -222,6 +362,13 @@ function netlifyAdapter() {
         path.resolve(root, "dist/client/_redirects"),
         redirects
       );
+      const prerendered = await prerenderRoutes(ctx);
+      const clientDir = path.resolve(root, "dist/client");
+      for (const { url, html } of prerendered) {
+        const filePath = url === "/" ? path.join(clientDir, "index.html") : path.join(clientDir, url, "index.html");
+        fs.mkdirSync(path.resolve(filePath, ".."), { recursive: true });
+        fs.writeFileSync(filePath, html);
+      }
       console.log(
         "  Netlify output \u2192 .netlify/functions-internal/ssr/\n  Publish dir: dist/client/\n"
       );
@@ -255,6 +402,18 @@ serve({ fetch: app.fetch, port }, (info) => {
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
+      const prerendered = await prerenderRoutes(ctx);
+      if (prerendered.length > 0) {
+        const prerenderDir = path.resolve(root, "dist/prerender");
+        fs.mkdirSync(prerenderDir, { recursive: true });
+        for (const { url, html } of prerendered) {
+          const filePath = url === "/" ? path.join(prerenderDir, "index.html") : path.join(prerenderDir, url, "index.html");
+          fs.mkdirSync(path.resolve(filePath, ".."), {
+            recursive: true
+          });
+          fs.writeFileSync(filePath, html);
+        }
+      }
       console.log(
         "  Node output \u2192 dist/server/index.mjs\n  Run: node dist/server/index.mjs\n"
       );
@@ -283,7 +442,7 @@ function staticAdapter(opts = {}) {
         ssrPath
       );
       ctx.copyStaticAssets(outputDir, { excludeHtml: true });
-      const routePaths = await extractRoutes(ctx, opts);
+      const { paths: routePaths, defs: routeDefs } = await extractRoutesWithModes(ctx, opts);
       const allUrls = [];
       for (const routePath of routePaths) {
         for (const locale of ctx.locales) {
@@ -302,21 +461,37 @@ function staticAdapter(opts = {}) {
             ctx.locales,
             ctx.defaultLocale
           );
-          const {
-            html: appHtml,
-            head,
-            css,
-            serverData
-          } = await ssrModule.render(url, locale);
-          const serializedData = ssrModule.serializeServerData(serverData);
-          const finalHtml = injectSSRForStatic(
-            ctx.templateHtml,
-            locale,
-            head,
-            css,
-            appHtml,
-            serializedData
+          const routeDef = routeDefs.find(
+            (r) => r.path === stripLocalePrefix(url, ctx.locales)
+          );
+          const mode = resolveRenderMode(
+            stripLocalePrefix(url, ctx.locales),
+            routeDef?.renderMode,
+            ctx.renderModes
           );
+          let finalHtml;
+          if (mode === "csr") {
+            finalHtml = injectCSRShellForStatic(
+              ctx.templateHtml,
+              locale
+            );
+          } else {
+            const {
+              html: appHtml,
+              head,
+              css,
+              serverData
+            } = await ssrModule.render(url, locale);
+            const serializedData = ssrModule.serializeServerData(serverData);
+            finalHtml = injectSSRForStatic(
+              ctx.templateHtml,
+              locale,
+              head,
+              css,
+              appHtml,
+              serializedData
+            );
+          }
           const filePath = url === "/" ? path.join(outputDir, "index.html") : path.join(outputDir, url, "index.html");
           fs.mkdirSync(path.resolve(filePath, ".."), {
             recursive: true
@@ -331,9 +506,10 @@ function staticAdapter(opts = {}) {
     }
   };
 }
-async function extractRoutes(ctx, opts) {
+async function extractRoutesWithModes(ctx, opts) {
   const routesFile = opts.routesExport ?? "src/lib/bootstrap.ts";
   const paths = [];
+  const defs = [];
   try {
     const { pathToFileURL } = await import(
       /* @vite-ignore */
@@ -363,6 +539,7 @@ async function extractRoutes(ctx, opts) {
       for (const r of routes) {
         if (r.path && !r.path.includes(":")) {
           paths.push(r.path);
+          defs.push({ path: r.path, renderMode: r.renderMode });
         }
       }
     }
@@ -382,7 +559,7 @@ async function extractRoutes(ctx, opts) {
     }
   }
   if (paths.length === 0) paths.push("/");
-  return paths;
+  return { paths, defs };
 }
 function inferLocale(url, locales, defaultLocale) {
   const segments = url.split("/").filter(Boolean);
@@ -397,6 +574,29 @@ function injectSSRForStatic(template, locale, head, css, html, serializedData) {
     '<script id="serialized-server-data" type="application/json">' + serializedData + "</script>"
   );
 }
+function injectCSRShellForStatic(template, locale) {
+  return template.replace("<!--ssr-lang-->", locale).replace("<!--ssr-head-->", "").replace("<!--ssr-body-->", "").replace("<!--ssr-data-->", "");
+}
+function stripLocalePrefix(url, locales) {
+  const segments = url.split("/").filter(Boolean);
+  if (segments.length > 0 && locales.includes(segments[0])) {
+    const rest = segments.slice(1).join("/");
+    return rest ? `/${rest}` : "/";
+  }
+  return url;
+}
+function resolveRenderMode(routePath, routeRenderMode, renderModes) {
+  if (renderModes) {
+    if (renderModes[routePath]) return renderModes[routePath];
+    for (const [pattern, mode] of Object.entries(renderModes)) {
+      if (pattern.includes("*")) {
+        const re = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+        if (re.test(routePath)) return mode;
+      }
+    }
+  }
+  return routeRenderMode ?? "ssr";
+}
 
 // ../server/src/adapters/vercel.ts
 function vercelAdapter() {
@@ -407,8 +607,8 @@ function vercelAdapter() {
       const outputDir = path.resolve(root, ".vercel/output");
       fs.rmSync(outputDir, { recursive: true, force: true });
       const entrySource = generateSSREntry(ctx, {
-        platformImport: `import { handle } from "hono/vercel";`,
-        platformExport: `export default handle(app);`
+        platformImport: `import { getRequestListener } from "@hono/node-server";`,
+        platformExport: `export default getRequestListener(app.fetch);`
       });
       const tempEntry = path.resolve(root, ".vercel-entry.tmp.mjs");
       fs.writeFileSync(tempEntry, entrySource);
@@ -455,6 +655,13 @@ function vercelAdapter() {
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
+      const prerendered = await prerenderRoutes(ctx);
+      const staticDir = path.resolve(root, ".vercel/output/static");
+      for (const { url, html } of prerendered) {
+        const filePath = url === "/" ? path.join(staticDir, "index.html") : path.join(staticDir, url, "index.html");
+        fs.mkdirSync(path.resolve(filePath, ".."), { recursive: true });
+        fs.writeFileSync(filePath, html);
+      }
       console.log("  Vercel output \u2192 .vercel/output/\n");
     }
   };
@@ -720,6 +927,18 @@ function resolveSetupFn(mod) {
   const first = Object.values(mod).find((v) => typeof v === "function");
   return first ?? null;
 }
+function matchRenderModeConfig(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 re = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
 function finesoftFrontViteConfig(options = {}) {
   const ssrEntry = options.ssr?.entry ?? "src/ssr.ts";
   let root = process.cwd();
@@ -752,7 +971,7 @@ function finesoftFrontViteConfig(options = {}) {
           /* @vite-ignore */
           "hono"
         );
-        const { createSSRApp: createSSRApp2 } = await import("./app-MYBG3TGV.js");
+        const { createSSRApp: createSSRApp2 } = await import("./app-Z3EFLAP2.js");
         const { getRequestListener } = await import(
           /* @vite-ignore */
           "@hono/node-server"
@@ -799,9 +1018,9 @@ function finesoftFrontViteConfig(options = {}) {
           /* @vite-ignore */
           "hono"
         );
-        const { injectSSRContent: injectSSRContent2 } = await import(
+        const { injectSSRContent: injectSSRContent2, injectCSRShell: injectCSRShell2 } = await import(
           /* @vite-ignore */
-          "./src-7D236CLJ.js"
+          "./src-KUWACLPD.js"
         );
         const { parseAcceptLanguage: parseAcceptLanguage2 } = await import("./locale-YK3THSI6.js");
         const { getRequestListener } = await import(
@@ -809,6 +1028,7 @@ function finesoftFrontViteConfig(options = {}) {
           "@hono/node-server"
         );
         const app = new HonoClass();
+        const isrCache = /* @__PURE__ */ new Map();
         if (typeof options.setup === "function") {
           await options.setup(app);
         } else if (typeof options.setup === "string") {
@@ -847,12 +1067,25 @@ function finesoftFrontViteConfig(options = {}) {
               options.locales,
               options.defaultLocale
             );
+            const overrideMode = matchRenderModeConfig(
+              url,
+              options.renderModes
+            );
+            if (overrideMode === "csr") {
+              return c.html(injectCSRShell2(template, locale));
+            }
+            const cached = isrCache.get(url);
+            if (cached) return c.html(cached);
             const {
               html: appHtml,
               head,
               css,
-              serverData
+              serverData,
+              renderMode
             } = await ssrModule.render(url, locale);
+            if (renderMode === "csr") {
+              return c.html(injectCSRShell2(template, locale));
+            }
             const serializedData = ssrModule.serializeServerData(serverData);
             const finalHtml = injectSSRContent2({
               template,
@@ -862,6 +1095,9 @@ function finesoftFrontViteConfig(options = {}) {
               html: appHtml,
               serializedData
             });
+            if (renderMode === "prerender" || overrideMode === "prerender") {
+              isrCache.set(url, finalHtml);
+            }
             return c.html(finalHtml);
           } catch (e) {
             console.error("[SSR Preview Error]", e);
@@ -932,6 +1168,7 @@ function finesoftFrontViteConfig(options = {}) {
             locales,
             defaultLocale,
             templateHtml,
+            renderModes: options.renderModes,
             resolvedResolve,
             resolvedCss,
             vite,
@@ -990,6 +1227,7 @@ export {
   finesoftFrontViteConfig,
   generateUuid,
   getBaseUrl,
+  injectCSRShell,
   injectSSRContent,
   isCompoundAction,
   isExternalUrlAction,