@_tc/template-core 0.2.11 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @_tc/template-core
 
-TemplateCore 是一个基于 TypeScript、Koa、React 的后台框架包。它把后端约定式加载、前端 Dashboard、Schema CRUD 页面、model 类型和类型扩展放到同一个 npm 包里，项目只需要按目录补充自己的 `app/`、`model/`、`frontend/`。
+TemplateCore 是一个基于 TypeScript、Koa、React 的后台框架包。它把后端约定式加载、前端 Dashboard、Schema CRUD 页面、models 类型和类型扩展放到同一个 npm 包里，项目只需要按目录补充自己的 `app/`、`models/`、`frontend/`。
 
 预览 & 文档地址：https://t-c-s-p.allomg.qzz.io/preview
 
@@ -34,7 +34,9 @@ my-admin/
 │   ├── src/          # 库代码
 │   ├── apps/         # 应用入口
 │   └── extended/     # 扩展点
-├── model/
+├── ssr/
+│   └── apps/         # SSR 页面入口，可选
+├── models/
 │   └── product/
 │       ├── mode.ts
 │       └── project/
@@ -55,7 +57,7 @@ async function main() {
   await serverStart({
     name: 'my-admin',
     baseDir: join(__dirname, '.'),
-    pageBasePage: '/',
+    pageBasePath: '/',
     additionalPublicPaths: [join(__dirname, 'dist/public')],
   })
 
@@ -76,7 +78,8 @@ main().catch((error) => {
 | --- | --- | --- | --- | --- |
 | `name` | `string` | 否 | - | 应用名称 |
 | `baseDir` | `string` | 否 | - | 项目根目录，通常为 `join(__dirname, '.')` |
-| `pageBasePage` | `string` | 否 | `'/'` | 页面访问前缀，所有前端页面路由的基础路径 |
+| `pageBasePath` | `string` | 否 | `'/'` | 页面访问前缀，所有前端页面路由的基础路径 |
+| `ssrPageBasePath` | `string` | 否 | `'/fessr'` | SSR 页面访问前缀，如 `/tssr` 会让 SSR 页面路由变成 `/tssr/:page` |
 | `homePage` | `string` | 否 | - | 应用首页路径 |
 | `additionalPublicPaths` | `string | string[]` | 否 | - | 追加静态资源目录；如需同时作为 Nunjucks 模板查找目录，建议传绝对路径数组 |
 
@@ -141,6 +144,96 @@ await buildFE('prod', {
 await buildFE('prod', { minifyHtml: true })
 ```
 
+### SSR 页面（可选）
+
+SSR 入口放在根级 `ssr/apps/{page}/{page}.entry.tsx`。SSR 和 CSR 并存，SSR 页面默认通过 `/fessr/:page` 访问，不影响现有 `frontend/apps/` 页面。
+
+```text
+my-admin/
+└── ssr/
+    └── apps/
+        └── hello/
+            └── hello.entry.tsx
+```
+
+```tsx
+import { createSSREntry } from '@_tc/template-core/ssr/createSSREntry'
+import type { SSRPageMetaResolver, SSRPropsContext } from '@_tc/template-core/ssr'
+
+interface HelloProps {
+  name: string
+}
+
+function HelloPage({ name }: HelloProps) {
+  return <h1>Hello, {name}</h1>
+}
+
+export async function getServerProps(context: SSRPropsContext) {
+  return { name: (context.query.name as string) || 'SSR' }
+}
+
+export const pageTitle: SSRPageMetaResolver<HelloProps> = ({ props }) => `Hello, ${props.name}`
+export const pageDescription: SSRPageMetaResolver<HelloProps> = ({ path }) => `SSR hello page at ${path}`
+
+export default HelloPage
+
+createSSREntry(HelloPage)
+```
+
+SSR 运行时会通过 React streaming bootstrap 动态 import 客户端入口。页面包含 `Suspense` 边界时，服务端可以先输出 shell / fallback，浏览器侧先启动 hydration，pending 内容后续继续 stream；如果页面没有 `Suspense` 边界，hydration 时机通常会接近完整 root HTML 到达之后。完整机制见 [Streaming Bootstrap 说明](./ssr/STREAMING_BOOTSTRAP.md)。
+
+`pageTitle` / `pageDescription` 可以导出字符串，也可以导出同步或异步函数。函数会在 `getServerProps()` 之后执行，入参包含 `params`、`query`、`path`、`app`、`ctx` 和 `props`。
+
+组件级流式异步数据可以使用 `StreamingRender`。它会在服务端 Suspense 中等待 `getData()`，把结果随 HTML 片段用 JSON script 注入，客户端 hydration 时优先复用这份数据。
+
+```tsx
+import { StreamingRender } from '@_tc/template-core/ssr/components'
+
+function OverviewPanel() {
+  return (
+    <StreamingRender
+      keyName="overview"
+      fallback={<div>Loading...</div>}
+      getData={loadOverview}
+    >
+      {(data) => <OverviewView data={data} />}
+    </StreamingRender>
+  )
+}
+```
+
+`keyName` 需要在页面内稳定且唯一；`getData()` 的返回值必须可 JSON 序列化，并且会进入 HTML，不能包含 token、密钥等敏感信息。客户端找不到对应注入数据时也可能执行 `getData()`，因此数据函数需要兼容浏览器 fallback，或在函数内部显式区分服务端和客户端逻辑。底层 Suspense Promise hook 可从 `@_tc/template-core/ssr/hooks` 或 `@_tc/template-core/ssr/hooks/useSuspensePromise` 引入。
+
+启动时构建 SSR 双产物：
+
+```ts
+import { join } from 'path'
+import { serverStart } from '@_tc/template-core'
+import { buildSSR, watchSSRFiles } from '@_tc/template-core/bundler'
+
+const baseDir = join(__dirname, '.')
+
+await serverStart({
+  name: 'my-admin',
+  baseDir,
+  ssrPageBasePath: '/fessr',
+})
+
+await buildSSR({ baseDir, output: 'run' })
+await watchSSRFiles({ baseDir, output: 'run' })
+```
+
+访问：
+
+```text
+http://localhost:9000/fessr/hello
+http://localhost:9000/fessr/hello?name=TemplateCore
+```
+
+`buildSSR()` 会构建私有 `{ssrPrivateRoot}/ssr-server/{page}.mjs`、私有 `{ssrPrivateRoot}/ssr-manifest/manifest.json`，并把 SSR hydration 入口并入 FE browser build。浏览器侧静态资源走普通 `/dist/assets/*`，可与 CSR 入口共享 chunk；SSR HTML 会根据 manifest 生成 preload，并通过 React bootstrap dynamic import 启动对应客户端入口。服务端会从 `{publicPath}/../.tc/ssr` 查找 server bundle 和 manifest。`/dist/ssr-server/*` 和 `/dist/.vite/*` 会被拦截为 404，避免私有产物或误放文件直连暴露。如果 `output` 使用自定义目录，需要把对应 public 根目录加入 `additionalPublicPaths`。
+
+`*.entry.tsx` 会被 server/client 两次构建处理，顶层代码需要同时兼容 Node 和浏览器。Node-only 逻辑建议放到 `*.server.ts`，并在 `getServerProps()` 内动态导入；浏览器 API 需要放到 `useEffect` 或 `typeof window !== 'undefined'` 守卫之后。`getServerProps()` 运行在 Node 侧，不要直接复用依赖 `window` / `localStorage` 签名上下文的前端 API 层。
+
 配置文件：
 
 ```ts
@@ -161,7 +254,7 @@ export default {
 http://localhost:9000/dash?projk=demo
 ```
 
-`projk` 对应 `model/{modelKey}/project/{projectKey}.ts` 里的 `projectKey`。
+`projk` 对应 `models/{modelKey}/project/{projectKey}.ts` 里的 `projectKey`。
 
 ## 内置功能
 
@@ -179,23 +272,30 @@ http://localhost:9000/dash?projk=demo
 - 内置 UI 组件：提供丰富的 React 组件库，详见下方"内置 UI 组件"章节。
 - API 中间件：错误处理、静态资源、body parser、项目上下文、接口签名、参数校验。
 - 前端构建：扫描框架和项目的 `frontend/**/*.entry.{ts,tsx,js,jsx}`，输出服务端可渲染的 `.entry.tpl`，并写入 `FEBuildKey` 供 HTML ETag 缓存失效使用。
+- SSR 页面：扫描框架和项目的 `ssr/apps/**/*.entry.{ts,tsx,js,jsx}`，输出 server/client 双产物并通过 `/fessr/:page` 服务端渲染。
 - 类型扩展：支持扩展 SchemaForm、SchemaTable 单元格渲染组件、CallCom、KoaApp。
 
 ## 常用公开入口
 
-完整 exports 以发布包内 `package.json` 为准，除下表外还包含 `./fe/main`、`./fe/common/request`、`./fe/*`、`./fe/rc/*`、`./fe/rc/hooks` 等子路径。
+完整 exports 以发布包内 `package.json` 为准，除下表外还包含 `./fe/main`、`./fe/common/request`、`./ssr`、`./ssr/createSSREntry`、`./ssr/components`、`./ssr/components/StreamingRender`、`./ssr/hooks`、`./ssr/hooks/useSuspensePromise`、`./fe/*`、`./fe/rc/*`、`./fe/rc/hooks` 等子路径。
 
 | 入口 | 用途 |
 | --- | --- |
 | `@_tc/template-core` | 服务启动、基础 Controller/Service、Koa 类型 |
-| `@_tc/template-core/bundler` | 构建入口，提供前端资源构建 `buildFE` 和消费方 Node/backend 构建 `buildBE` |
+| `@_tc/template-core/bundler` | 构建入口，提供 `buildFE`、`buildBE`、`buildSSR`、`watchSSRFiles` |
+| `@_tc/template-core/ssr` | SSR 类型与运行时辅助，导出 `SSRPropsContext`、`SSRPageMetaResolver`、`StreamingRender`、`useSuspensePromise` |
+| `@_tc/template-core/ssr/createSSREntry` | SSR 页面客户端 hydration 工厂 |
+| `@_tc/template-core/ssr/components` | SSR 组件汇总入口，导出 `StreamingRender` |
+| `@_tc/template-core/ssr/components/StreamingRender` | `StreamingRender` 显式子路径 |
+| `@_tc/template-core/ssr/hooks` | SSR hooks 汇总入口，导出 `useSuspensePromise` |
+| `@_tc/template-core/ssr/hooks/useSuspensePromise` | `useSuspensePromise` 显式子路径 |
 | `@_tc/template-core/fe` | 前端初始化、动态组件渲染辅助、Dash 路由扩展、请求方法、SchemaPage 事件、token 工具、共享状态和内置前端组件 |
 | `@_tc/template-core/fe/main` | 前端初始化入口 |
 | `@_tc/template-core/fe/common/request` | 请求实例、请求方法和请求类型的显式子路径 |
 | `@_tc/template-core/fe/rc` | UI/SchemaForm 组件和类型 |
 | `@_tc/template-core/fe/rc/hooks` | React hooks 汇总入口 |
 | `@_tc/template-core/fe/tailwind_ui.css` | 前端全局样式入口，源码对应 `frontend/src/main.css` |
-| `@_tc/template-core/model` | model 配置类型 |
+| `@_tc/template-core/models` | model 配置类型 |
 
 ### 后端类型
 
@@ -245,14 +345,14 @@ export const demoRouter = ((app, router) => {
 `model` 是后台菜单、项目和 Schema 页面的数据源。框架会读取：
 
 ```text
-model/{modelKey}/mode.ts
-model/{modelKey}/project/{projectKey}.ts
+models/{modelKey}/mode.ts
+models/{modelKey}/project/{projectKey}.ts
 ```
 
-`mode.ts` 定义模型模板：
+`mode.ts` 定义模型基础配置：
 
 ```ts
-import type { ModelDataType } from '@_tc/template-core/model'
+import type { ModelDataType } from '@_tc/template-core/models'
 
 const model: ModelDataType = {
   mode: 'MB',
@@ -373,14 +473,14 @@ export default {
 - `project` 会继承同目录上层 `mode`。
 - 对象递归合并，`project` 覆盖 `mode`。
 - 数组按 `key` 合并：同 key 覆盖，不同 key 新增。
-- `model/index.ts` 或 `model/index.js` 会被 loader 跳过。
+- `models/index.ts` 或 `models/index.js` 会被 loader 跳过。
 
 ### model 数组合并示例
 
 假设 `mode.ts` 定义了两个菜单项：
 
 ```ts
-// model/product/mode.ts
+// models/product/mode.ts
 export default {
   name: '商品后台',
   menu: [
@@ -411,7 +511,7 @@ export default {
 `project/demo.ts` 可以：
 
 ```ts
-// model/product/project/demo.ts
+// models/product/project/demo.ts
 export default {
   name: 'Demo 企业商品后台',
   menu: [
@@ -553,7 +653,7 @@ app/router-schema/**/*.(js|ts)   -> app.routerSchema
 app/extends/*.(js|ts)            -> app.extends
 config/config.default.(js|ts)    -> app.config
 config/config.{env}.(js|ts)      -> app.config
-model/**/*.(js|ts)               -> 内置 project service 按需读取的项目模型配置
+models/**/*.(js|ts)               -> 内置 project service 按需读取的项目模型配置
 ```
 
 内置扩展：
@@ -1101,7 +1201,7 @@ Schema 表单校验会把 AJV keyword 映射到内置语言 key，覆盖 `requir
 
 非必填字段为空时会跳过 AJV 校验，空值包括 `undefined`、`null`、空字符串、空数组和空对象。
 
-如果需要扩展更多 AJV 文案，在源码项目中同步增加：
+如果需要扩展更多 AJV 文案，需要在 TemplateCore 源码中补充后重新发布：
 
 1. `frontend/src/defaultPages/SchemaPage/utils/validator.ts` 的 `formatError()` 映射。
 2. `frontend/src/language/zh-CN.ts` 和 `frontend/src/language/en-US.ts` 文案。
@@ -1140,15 +1240,15 @@ initThemeMode()
 applyThemeMode('dark', true)
 ```
 
-RAF 风格计时器由 `@tc/common/rafTimer` 提供，浏览器优先使用 `requestAnimationFrame`，缺少 RAF 时自动降级到 `setTimeout`。
+RAF 风格计时器通过 `@_tc/template-core/fe` 对外提供，浏览器优先使用 `requestAnimationFrame`，缺少 RAF 时自动降级到 `setTimeout`。
 
 `@_tc/template-core/fe/rc` 和 `@_tc/template-core/fe/rc/hooks` 也会随发布包提供对应 UI 与 hooks 入口；hooks 汇总入口包含 `useBreadcrumb`、`useExecuteOnce`、`useInit`、`useLanguage`、`usePagination`、`useRefState`、`useWatch`。
 
-`useRefState` 支持可选的 `delayTiming` 参数，传入大于 0 的值时会延迟 state 提交，并复用 `@tc/common/rafTimer` 的浏览器优先、Node/SSR 自动降级计时器实现。
+`useRefState` 支持可选的 `delayTiming` 参数，传入大于 0 的值时会延迟 state 提交，并复用包内浏览器优先、Node/SSR 自动降级的计时器实现。
 
 ### 前端请求封装详解
 
-框架内置的请求封装基于 `@tc/common/http`，底层使用原生 `fetch` API，实现了类似 Axios 的接口和拦截器机制，提供了签名、鉴权、错误处理等能力。
+框架内置的请求封装通过 `@_tc/template-core/fe` 和 `@_tc/template-core/fe/common/request` 对外提供，底层使用原生 `fetch` API，实现了类似 Axios 的接口和拦截器机制，提供了签名、鉴权、错误处理等能力。
 
 **基础配置**：
 - `BASE_URL`：固定为 `/api`
@@ -1259,7 +1359,7 @@ try {
 
 ## 样式与 Tailwind V4
 
-使用内置前端或 UI 组件时，需要引入包内样式。默认 `@_tc/template-core/fe` 的 `initApp` 会经过源码入口 `frontend/src/main.tsx` 引入 `frontend/src/main.css`；如果项目侧自定义入口、只使用 `fe/rc` 组件，或希望样式入口更明确，建议显式引入：
+使用内置前端或 UI 组件时，需要引入包内样式。默认 Dashboard 入口已经包含包内全局样式；如果项目侧自定义入口、只使用 `fe/rc` 组件，或希望样式入口更明确，建议显式引入：
 
 ```ts
 // frontend/xxx/xxx.entry.tsx
@@ -1274,7 +1374,7 @@ import '@_tc/template-core/fe/tailwind_ui.css'
 
 /* 扫描项目源码 */
 @source "./**/*.{js,ts,jsx,tsx}";
-@source "../model/**/*.{js,ts,jsx,tsx}";
+@source "../models/**/*.{js,ts,jsx,tsx}";
 ```
 
 Tailwind V4 默认会忽略 `node_modules` 和 `.gitignore` 中的文件。如果没有使用上面的 `tailwind_ui.css`，或者项目侧构建链路绕过了 TemplateCore 的样式入口，需要手动把包加入 Tailwind 扫描：
@@ -1284,7 +1384,7 @@ Tailwind V4 默认会忽略 `node_modules` 和 `.gitignore` 中的文件。如
 @import "tailwindcss";
 
 @source "./**/*.{js,ts,jsx,tsx}";
-@source "../model/**/*.{js,ts,jsx,tsx}";
+@source "../models/**/*.{js,ts,jsx,tsx}";
 @source "../node_modules/@_tc/template-core";
 ```
 
@@ -1478,7 +1578,7 @@ frontend/report/index.html      yes
 frontend/report/report.html     yes
 ```
 
-不要在插槽文件里写 `<!DOCTYPE html>`、`<html>`、`<body>` 或 `<div id="root"></div>`。页面外壳由 TemplateCore 的 `app/view/entry.tpl` 统一生成，`window._basePath`、`window._projKey`、`window._signKey`、`window.appOptions` 也由它注入。
+不要在插槽文件里写 `<!DOCTYPE html>`、`<html>`、`<body>` 或 `<div id="root"></div>`。页面外壳由 TemplateCore 的 `app/view/entry.tpl` 统一生成，`window._basePath`、`window._projKey`、`window._signKey`、`window._renderMode`、`window._isSSR`、`window.appOptions` 也由它注入。
 
 扩展 Dashboard 路由：
 
@@ -1579,12 +1679,12 @@ import { buildBE } from '@_tc/template-core/bundler'
 
 await buildBE({
   rootDir: process.cwd(),
-  input: ['index.ts', 'index.js', 'app', 'config', 'model'],
+  input: ['index.ts', 'index.js', 'app', 'config', 'models'],
   outDir: 'dist',
   format: 'cjs',
   alias: {
     '@app': './app',
-    '@model': './model',
+    '@model': './models',
   },
 })
 ```
@@ -1604,7 +1704,7 @@ await buildBE({
 import chokidar from 'chokidar'
 import { buildBE } from '@_tc/template-core/bundler'
 
-const input = ['index.ts', 'index.js', 'app', 'config', 'model']
+const input = ['index.ts', 'index.js', 'app', 'config', 'models']
 
 let building = false
 let pending = false
@@ -1626,7 +1726,7 @@ async function runBuild() {
       format: 'cjs',
       alias: {
         '@app': './app',
-        '@model': './model',
+        '@model': './models',
       },
     })
     console.log('[buildBE] done')
@@ -1671,7 +1771,7 @@ chokidar
 默认会在当前工作目录构建这些入口：
 
 ```ts
-['index.ts', 'index.js', 'app', 'config', 'model']
+['index.ts', 'index.js', 'app', 'config', 'models']
 ```
 
 不存在的默认入口会自动跳过；如果没有任何匹配源码，构建仍会失败。输出到 `dist`，格式为 `cjs`。默认 `outputStructure: "preserve"` 按源路径输出，`bundleDependencies: false` 会 external Node 内置模块和 npm 包，不会把依赖打进产物。`buildBE` 会按同一组 input 扫描并复制内置白名单资源扩展，主要覆盖 `app`、`config`、`model` 目录。
@@ -1680,12 +1780,12 @@ chokidar
 
 ```ts
 await buildBE({
-  input: ['app', 'config', 'model'],
+  input: ['app', 'config', 'models'],
   outDir: 'dist',
   format: ['es', 'cjs'],
   alias: {
     '@app': './app',
-    '@model': './model',
+    '@model': './models',
   },
 })
 ```
@@ -1707,7 +1807,7 @@ await buildBE({
 
 ```ts
 await buildBE({
-  input: ['app', 'config', 'model'],
+  input: ['app', 'config', 'models'],
   allowMissingInput: true,
 })
 ```
@@ -1743,8 +1843,8 @@ export default components
 // frontend/extended/dash/routeGuard.ts
 import type { DashRouteGuard } from '@_tc/template-core/fe'
 
-const dashRouteGuard: DashRouteGuard = ({ isLoggedIn }) => {
-  if (!isLoggedIn) return '/login'
+const dashRouteGuard: DashRouteGuard = ({ isLoggedIn, isSSR }) => {
+  if (!isLoggedIn) return isSSR ? '/login?from=ssr' : '/login'
 }
 
 export default dashRouteGuard
@@ -1754,6 +1854,7 @@ export default dashRouteGuard
 
 - 返回 `string`：框架使用 `window.location.href` 跳转，登录页不需要在 Dash 路由下。
 - 返回非 `string`：中断 Dashboard 内置重定向，使用方可自行跳转或处理提示。
+- 入参包含 `renderMode: 'csr' | 'ssr'` 和 `isSSR`，可区分 SSR hydration 后的守卫跳转和普通 CSR 跳转。
 - `DashRouteGuardResult` 是 `string | undefined`；`undefined`（包括已登录分支的隐式返回）也会打断 Dashboard 内置重定向。
 - 没有自定义 `routeGuard` 文件时，框架使用兜底空对象，不影响默认 Dashboard 重定向。
 
@@ -1830,9 +1931,9 @@ CallCom 是 SchemaPage 中的弹窗、抽屉、面板类组件。内置组件有
 
 ```ts
 // typing/template-core.d.ts
-import '@_tc/template-core/model'
+import '@_tc/template-core/models'
 
-declare module '@_tc/template-core/model' {
+declare module '@_tc/template-core/models' {
   export namespace CallComNamespace {
     interface ConfigMap {
       auditPanel: {
@@ -1951,9 +2052,9 @@ cover: {
 
 ```ts
 // typing/template-core.d.ts
-import '@_tc/template-core/model'
+import '@_tc/template-core/models'
 
-declare module '@_tc/template-core/model' {
+declare module '@_tc/template-core/models' {
   export namespace SchemaTableNamespace {
     interface RenderComponentPropsMap {
       PriceCell: {
@@ -2017,7 +2118,7 @@ price: {
 
 ```json
 {
-  "include": ["app/**/*", "model/**/*", "frontend/**/*", "typing/**/*.d.ts"]
+  "include": ["app/**/*", "models/**/*", "frontend/**/*", "typing/**/*.d.ts"]
 }
 ```
 
@@ -2044,9 +2145,9 @@ declare module '@_tc/template-core/fe/rc' {
 
 ```ts
 // typing/template-core.d.ts
-import '@_tc/template-core/model'
+import '@_tc/template-core/models'
 
-declare module '@_tc/template-core/model' {
+declare module '@_tc/template-core/models' {
   interface ModelModeMap {
     portal: {
       portalConfig: {
@@ -2061,7 +2162,7 @@ declare module '@_tc/template-core/model' {
 使用新 `mode`：
 
 ```ts
-import type { ModelDataType } from '@_tc/template-core/model'
+import type { ModelDataType } from '@_tc/template-core/models'
 
 const model: ModelDataType<'portal'> = {
   mode: 'portal',
@@ -2080,7 +2181,7 @@ export default model
 继续使用内置管理后台时：
 
 ```ts
-import type { ModelDataType } from '@_tc/template-core/model'
+import type { ModelDataType } from '@_tc/template-core/models'
 
 const model: ModelDataType<'MB'> = {
   mode: 'MB',
@@ -2096,7 +2197,7 @@ const model: ModelDataType<'MB'> = {
 扩展目标：
 
 ```ts
-declare module '@_tc/template-core/model' {
+declare module '@_tc/template-core/models' {
   export namespace CallComNamespace {
     interface ConfigMap {}
     interface OptionMap {}
@@ -2113,7 +2214,7 @@ declare module '@_tc/template-core/model' {
 扩展目标：
 
 ```ts
-declare module '@_tc/template-core/model' {
+declare module '@_tc/template-core/models' {
   export namespace SchemaTableNamespace {
     interface RenderComponentPropsMap {}
   }
@@ -2203,7 +2304,7 @@ cp -R node_modules/@_tc/template-core/.skills/tc-component-usage-skills "${CODEX
 
 ## 注意事项
 
-- 不要在项目代码里引用 `dist/fe/*`、`dist/model/*` 这类构建产物路径。
+- 不要在项目代码里引用 `dist/fe/*`、`dist/models/*` 这类构建产物路径。
 - npm 使用方只使用公开入口：`@_tc/template-core/*`。
 - SchemaForm 和 CallCom 的类型扩展、运行时注册都要做，少一个就只会“类型通过但页面不显示”或“页面能配但类型报错”。
 - `model` 数组合并依赖稳定 `key`。

package/cjs/app/controller/ssr.js

@@ -0,0 +1 @@
+const e=require(`../../_virtual/_rolldown/runtime.js`),t=require(`../../packages/common/ssr/hydration.js`),n=require(`../../ssrSharedData/outputPaths.js`),r=require(`../html/shell.js`),i=require(`../ssr/html.js`),a=require(`../ssr/manifest.js`);let o=require(`node:fs`);o=e.__toESM(o);let s=require(`node:path`);s=e.__toESM(s);let c=require(`node:stream`),l=require(`node:url`);var u=/^[A-Za-z0-9_-]+$/,d=1e4,f=3e4;function p(e){return e instanceof Error?e:Error(String(e))}async function m(e,t,n){let r=typeof e==`function`?await e(t):e;return r==null?n:String(r)}function h(e){e.compress=!1}function g(e,t,n={}){let r=new c.Writable({write(e,n,r){if(t.destroyed){r(Error(`SSR response stream is already closed.`));return}if(t.write(e,n)){r();return}t.once(`drain`,r)},final(e){if(t.destroyed){e();return}t.end(()=>{n.onComplete?.(),e()})},destroy(e,n){e&&!t.destroyed&&t.destroy(e),n()}});t.once(`close`,()=>{!t.readableEnded&&!r.destroyed&&(n.onAbort?.(),e.abort(Error(`SSR response stream closed before rendering completed.`)),r.destroy(Error(`SSR response stream closed before rendering completed.`)))}),t.once(`error`,t=>{n.onAbort?.(),e.abort(t),r.destroyed||r.destroy(t)}),r.once(`error`,()=>void 0),e.pipe(r)}var _=(e=>{function _(t){for(let r of e.publicsPath){let e=n.resolveSSRPrivateDir(r,t);if(o.default.existsSync(e))return e}return null}let v=new Map,y=new Map;function b(e){return typeof e==`string`&&u.test(e)}function x(e,t){let n=s.default.relative(t,e);return!!n&&!n.startsWith(`..`)&&!s.default.isAbsolute(n)}function S(e,t){if(!b(t))return null;let n=o.default.realpathSync(e);return[`${t}.mjs`,`${t}.js`].map(t=>s.default.resolve(e,t)).find(t=>!x(t,e)||!o.default.existsSync(t)?!1:x(o.default.realpathSync(t),n))??null}function C(e,t){let n=(0,l.pathToFileURL)(e);return n.searchParams.set(`t`,String(t)),n.href}async function w(e){let t=_(n.SSR_SERVER_OUT_DIR);if(!t)return null;let r=S(t,e);if(!r)return null;let i=o.default.statSync(r),a=v.get(e);if(a&&a.path===r&&a.mtime===i.mtimeMs)return a.module;let s=await import(C(r,i.mtimeMs));return v.set(e,{module:s,mtime:i.mtimeMs,path:r}),s}async function T(e){let t=_(n.SSR_MANIFEST_OUT_DIR);if(!t)return null;let r=s.default.resolve(t,n.SSR_CLIENT_MANIFEST_FILE);if(!o.default.existsSync(r))return null;let i=o.default.statSync(r),a=y.get(r);if(a&&a.mtime===i.mtimeMs)return a.manifest;let c=o.default.readFileSync(r,`utf-8`),l=JSON.parse(c);return y.set(r,{manifest:l,mtime:i.mtimeMs}),l}function E(t,n,r,a,o,s){h(t),t.status=r,t.type=`text/html`,t.body=i.renderSSRErrorHtml({app:e,ctx:t,page:n,status:r,title:a,message:o,error:s})}return class{async renderSSRPage(o,s){let l=o.params.page;if(h(o),!b(l)){E(o,String(l??`unknown`),404,`SSR page not found`,`The requested SSR page is not registered.`);return}e.extends.logger.log(` - SSR render: ${l}`);try{let s=await w(l);if(!s){e.extends.logger.log(` - SSR bundle not found: ${l}, falling back`),E(o,l,404,`SSR bundle not found`,`No server bundle was found for "${l}".`);return}let u=s.default,h=s.getServerProps,_={params:o.params,query:o.query,path:o.path,app:e,ctx:o},v={};typeof h==`function`&&(v=await h(_)??{});let y={..._,props:v},b=await m(s.pageTitle,y,l),x=await m(s.pageDescription,y,``),S=t.createHydrationData(v,{title:b,description:x,pathname:o.path}),C=t.serializeHydrationDataScriptContent(S),D=await T(l),O=a.findSSRClientEntry(D,l),k=a.generateSSRPreloadLinks(D,O),A=O?.file?`import(${r.serializeForHtmlScript(n.ssrClientAssetUrl(O.file))})`:void 0,j=await import(`react`),M=i.createSSRDocumentElement(j,{app:e,ctx:o,page:l,title:S.meta.title??l,description:S.meta.description??``,preloadLinks:k,hydrationScriptContent:C,appNode:j.createElement(u,v)}),{renderToPipeableStream:N}=await import(`react-dom/server`);await new Promise((t,n)=>{let r=null,i=null,a=!1,s=null,u=!1,m=null,h=null,_=()=>{m&&=(clearTimeout(m),null)},v=()=>{h&&=(clearTimeout(h),null)},y=e=>{let t=p(e);v(),r?.abort(t),i?.destroy(t)},b=()=>{u||(_(),u=!0,t())},x=e=>{u||(_(),v(),u=!0,n(e))};try{r=N(M,{bootstrapScriptContent:A,onShellReady(){if(s){r?.abort(s),x(s);return}let e=new c.PassThrough;i=e,o.body=e,o.type=`text/html`,a=!0,_(),h=setTimeout(()=>{y(Error(`SSR stream render timed out after ${f}ms.`))},f);try{g(r,e,{onAbort:v,onComplete:v}),b()}catch(t){e.destroy(p(t)),v(),x(t)}},onShellError(e){r?.abort(e),x(e)},onError(t){if(!a){s=t;return}e.extends.logger.log(` - SSR stream error after shell: ${l}`),console.error(`[SSR Stream Error]`,t),v(),y(t)}}),u||(m=setTimeout(()=>{let e=Error(`SSR shell render timed out after ${d}ms.`);r?.abort(e),x(e)},d))}catch(e){x(e)}})}catch(t){e.extends.logger.log(` - SSR render error: ${l}`),console.error(`[SSR Error]`,t),E(o,l,500,`SSR render error`,`The SSR page failed while loading data or rendering.`,t)}}}});module.exports=_;

package/cjs/app/controller/view.js

@@ -1 +1 @@
-const e=require(`../../packages/common/string/index.js`);var t=e=>JSON.stringify(e).replace(/</g,`\\u003c`).replace(/>/g,`\\u003e`).replace(/&/g,`\\u0026`).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`),n=(n=>class{async renderPage(r,i){let a=r.path;if(n.extends.localCacheHtmlEtag.keepFreshFEBuildKey(),a.includes(`${n.options.apiPrefix}/`))await i();else{n.extends.logger.log(` - render page: `+r.params.page);try{let i=r.query.projk;Array.isArray(i)&&(i=e.joinStr(...i));let a={projKey:i??``,name:n.options?.name??``,env:n.envs.get(),FEBasePage:t(`${n.options.pageBasePage}`),basePath:t(`${n.options.pageBasePage}${r.params.page}`),projKeyJson:t(String(r.query.projk??``)),signKey:t(n.config.signKey),options:t(n.options)},o=n.extends.renderView(`${r.params.page}.entry.tpl`,r,a),s=e.joinStr(a.basePath,a.name,a.env,a.projKey);if(!n.extends.localCacheHtmlEtag.hasEtag(s)){let e=n.extends.crypto.hmacSign(o);n.extends.localCacheHtmlEtag.setEtag(s,e)}let c=n.extends.localCacheHtmlEtag.getEtag(s);if(c||console.log(`---- etag 缓存异常 请检查服务 ----`),r.etag=c??Date.now()+``,r.set(`Cache-Control`,`public, max-age=${(n.config.resourceCacheTimeMs??300*1e3)/1e3}, immutable`),r.fresh){r.status=304;return}}catch(e){console.log(`-------------- render view error --------------`),console.log(e),n.extends.generateErrorMessage(`template not found`,{status:404,showError:!0,code:0})}}}});module.exports=n;
+const e=require(`../../packages/common/string/index.js`),t=require(`../../packages/core/paths.js`);var n=e=>JSON.stringify(e).replace(/</g,`\\u003c`).replace(/>/g,`\\u003e`).replace(/&/g,`\\u0026`).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`),r=(r=>class{async renderPage(i,a){let o=i.path;if(r.extends.localCacheHtmlEtag.keepFreshFEBuildKey(),o.includes(`${r.options.apiPrefix}/`))await a();else{r.extends.logger.log(` - render page: `+i.params.page);try{let a=i.query.projk;Array.isArray(a)&&(a=e.joinStr(...a));let o=t.normalizeRouteBasePath(r.options.pageBasePath)||`/`,s=o===`/`?`/${i.params.page}`:`${o}/${i.params.page}`,c={projKey:a??``,name:r.options?.name??``,env:r.envs.get(),FEBasePage:n(o),basePath:n(s),projKeyJson:n(String(i.query.projk??``)),signKey:n(r.config.signKey),options:n(r.options)},l=r.extends.renderView(`${i.params.page}.entry.tpl`,i,c),u=e.joinStr(c.basePath,c.name,c.env,c.projKey);if(!r.extends.localCacheHtmlEtag.hasEtag(u)){let e=r.extends.crypto.hmacSign(l);r.extends.localCacheHtmlEtag.setEtag(u,e)}let d=r.extends.localCacheHtmlEtag.getEtag(u);if(d||console.log(`---- etag 缓存异常 请检查服务 ----`),i.etag=d??Date.now()+``,i.set(`Cache-Control`,`public, max-age=${(r.config.resourceCacheTimeMs??300*1e3)/1e3}, immutable`),i.fresh){i.status=304;return}}catch(e){console.log(`-------------- render view error --------------`),console.log(e),r.extends.generateErrorMessage(`template not found`,{status:404,showError:!0,code:0})}}}});module.exports=r;

package/cjs/app/html/shell.js

@@ -0,0 +1,36 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={head:`<!-- TC_SHARED_HEAD -->`,runtimeContext:`<!-- TC_RUNTIME_CONTEXT -->`},t=e=>JSON.stringify(e).replace(/</g,`\\u003c`).replace(/>/g,`\\u003e`).replace(/&/g,`\\u0026`).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`);function n(e){return String(e).replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#39;`)}function r(e){return n(e)}function i(){return`;(() => {
+    const storageKey = 'tc_theme'
+    let mode = 'dark'
+
+    try {
+        const storedMode = localStorage.getItem(storageKey)
+        if (storedMode === 'light' || storedMode === 'dark') {
+            mode = storedMode
+        }
+    } catch (error) {
+        // Keep the template default when localStorage is unavailable.
+    }
+
+    const root = document.documentElement
+    root.classList.toggle('dark', mode === 'dark')
+    root.style.colorScheme = mode
+})()`}function a(){return`<script>${i()}<\/script>`}function o({titleHtml:e,descriptionAttr:t,preloadLinks:n=``}){let r=typeof t==`string`?`\n    <meta name="description" content="${t}" />`:``,i=n?`\n    ${n}`:``;return`    <meta charset="UTF-8" />
+    ${a()}
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/x-icon" href="/static/logo.png" />
+    <title>${e}</title>${r}${i}`}function s(){return o({titleHtml:`{{ name }}`})}function c({basePathExpression:e,feBasePageExpression:t,projKeyExpression:n,signKeyExpression:r,renderModeExpression:i}){return`window['_basePath'] = ${e}
+window['_FEBasePage'] = ${t}
+window['_projKey'] = ${n}
+window['_signKey'] = ${r}
+window['_renderMode'] = ${i}
+window['_isSSR'] = window['_renderMode'] === 'ssr'
+const s = document.getElementById('input')
+s.parentElement.removeChild(s)`}function l(){return`const appOptionsScript = document.getElementById('app-options-data')
+window['appOptions'] = JSON.parse(appOptionsScript.textContent || '{}')
+appOptionsScript.parentElement.removeChild(appOptionsScript)`}function u(e){return`<script id="input">
+        ${c(e)}
+    <\/script>
+    <script type="application/json" id="app-options-data">${e.optionsJsonHtml}<\/script>
+    <script>
+        ${l()}
+    <\/script>`}function d(){return u({basePathExpression:`{{basePath | safe}}`,feBasePageExpression:`{{FEBasePage | safe}}`,projKeyExpression:`{{projKeyJson | safe}}`,signKeyExpression:`{{signKey | safe}}`,renderModeExpression:t(`csr`),optionsJsonHtml:`{{ options | safe }}`})}function f(e,t,n){if(!e.includes(t))throw Error(`CSR entry template is missing shared shell marker: ${t}`);return e.replace(t,n)}function p(t){return f(f(t,e.head,s()),e.runtimeContext,d())}exports.applySharedCSRShellTemplate=p,exports.escapeHtml=n,exports.escapeHtmlAttr=r,exports.renderAppOptionsScriptContent=l,exports.renderCSRDocumentHeadTemplate=s,exports.renderCSRRuntimeContextScriptsTemplate=d,exports.renderDocumentHeadHtml=o,exports.renderRuntimeContextScriptsFromExpressions=u,exports.renderRuntimeInputScriptContentFromExpressions=c,exports.renderThemeScript=a,exports.renderThemeScriptContent=i,exports.serializeForHtmlScript=t,exports.sharedCSRShellMarkers=e;

package/cjs/app/middleware.js

@@ -1 +1 @@
-const e=require(`../_virtual/_rolldown/runtime.js`);let t=require(`koa-compress`);t=e.__toESM(t);let n=require(`koa-bodyparser`);n=e.__toESM(n);let r=require(`koa-static`);r=e.__toESM(r);var i=(0,n.default)({formLimit:`1000mb`,enableTypes:[`form`,`json`,`text`]}),a=e=>{let n=e.envs.isLocal()?{maxage:0,setHeaders(e){e.setHeader(`Cache-Control`,`no-store, no-cache, must-revalidate, proxy-revalidate`),e.setHeader(`Pragma`,`no-cache`),e.setHeader(`Expires`,`0`)}}:{maxage:e.config.resourceCacheTimeMs??300*1e3};e.use(e.middlewares.errorHandle),e.use((0,t.default)({threshold:2048})),e.publicsPath.forEach(t=>e.use((0,r.default)(t,n))),e.use(i),e.use(e.middlewares.requestParameterParsing),e.use(e.middlewares.projectHandler),!e.envs.isLocal()&&e.use(e.middlewares.apiSignVerify),e.use(e.middlewares.apiParamsVerify)};module.exports=a;
+const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../ssrSharedData/outputPaths.js`);let n=require(`koa-compress`);n=e.__toESM(n);let r=require(`koa-bodyparser`);r=e.__toESM(r);let i=require(`koa-static`);i=e.__toESM(i);var a=(0,r.default)({formLimit:`1000mb`,enableTypes:[`form`,`json`,`text`]}),o=e=>{let r=e.envs.isLocal()?{maxage:0,setHeaders(e){e.setHeader(`Cache-Control`,`no-store, no-cache, must-revalidate, proxy-revalidate`),e.setHeader(`Pragma`,`no-cache`),e.setHeader(`Expires`,`0`)}}:{maxage:e.config.resourceCacheTimeMs??300*1e3};e.use(e.middlewares.errorHandle),e.use((0,n.default)({threshold:2048}));let o=[`/dist/${t.SSR_SERVER_OUT_DIR}`,`/dist/.vite`];e.use(async(e,t)=>{if(o.some(t=>e.path===t||e.path.startsWith(`${t}/`))){e.status=404;return}await t()}),e.publicsPath.forEach(t=>e.use((0,i.default)(t,r))),e.use(a),e.use(e.middlewares.requestParameterParsing),e.use(e.middlewares.projectHandler),!e.envs.isLocal()&&e.use(e.middlewares.apiSignVerify),e.use(e.middlewares.apiParamsVerify)};module.exports=o;

package/cjs/app/router/ssr.js

@@ -0,0 +1 @@
+const e=require(`../../packages/core/paths.js`);var t=(t,n)=>{let r=e.normalizeRouteBasePath(t.options.ssrPageBasePath,`/fessr`);n.level=1,n.get([`${r}/:page`,`${r}/:page/:rest(.*)`],t.controller.ssr.renderSSRPage.bind(t.controller.ssr))};module.exports=t;

package/cjs/app/router/view.js

@@ -1 +1 @@
-var e=(e,t)=>{let{pageBasePage:n}=e.options;t.level=2,t.get([`${n}:page`,`${n}:page/:r(.*)`],e.controller.view.renderPage.bind(e.controller.view))};module.exports=e;
+const e=require(`../../packages/core/paths.js`);var t=(t,n)=>{let r=e.normalizeRouteBasePath(t.options.pageBasePath);n.level=2,n.get([`${r}/:page`,`${r}/:page/:r(.*)`],t.controller.view.renderPage.bind(t.controller.view))};module.exports=t;

package/cjs/app/ssr/html.js

@@ -0,0 +1,17 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../packages/core/paths.js`),t=require(`../html/shell.js`);function n(...e){return`/${e.filter(Boolean).map(e=>e.replace(/^\/+|\/+$/g,``)).filter(Boolean).join(`/`)}`}function r(e){let t=e.query.projk;return Array.isArray(t)?t.join(``):String(t??``)}function i(i,a,o){let s=e.normalizeRouteBasePath(i.options.pageBasePath)||`/`,c=n(e.normalizeRouteBasePath(i.options.ssrPageBasePath,`/fessr`)||`/fessr`,o),l=r(a);return{basePathExpression:t.serializeForHtmlScript(c),feBasePageExpression:t.serializeForHtmlScript(s),projKeyExpression:t.serializeForHtmlScript(l),signKeyExpression:t.serializeForHtmlScript(i.config.signKey),renderModeExpression:t.serializeForHtmlScript(`ssr`),optionsJsonHtml:t.serializeForHtmlScript(i.options)}}function a(e,n,r){return t.renderRuntimeInputScriptContentFromExpressions(i(e,n,r))}function o(e,n,r){return t.renderRuntimeContextScriptsFromExpressions(i(e,n,r))}function s(e){let{app:t,ctx:n,page:r,hydrationScript:i=``,clientScript:a=``}=e;return{beforeAppHtml:`<!DOCTYPE html>
+<html lang="en" class="dark" style="color-scheme: dark">
+<head>
+${c(e)}
+</head>
+${o(t,n,r)}
+<body>
+    <div id="root">`,afterAppHtml:`</div>
+    ${i}
+    ${a}
+</body>
+</html>`}}function c(e){let{title:n,description:r=``,preloadLinks:i=``}=e;return t.renderDocumentHeadHtml({titleHtml:t.escapeHtml(n),descriptionAttr:t.escapeHtmlAttr(r),preloadLinks:i})}function l(e,n){let{app:r,ctx:i,page:o,appNode:s,hydrationScriptContent:l=``}=n;return e.createElement(`html`,{lang:`en`,className:`dark`,style:{colorScheme:`dark`}},e.createElement(`head`,{dangerouslySetInnerHTML:{__html:c(n)}}),e.createElement(`body`,null,e.createElement(`script`,{id:`input`,dangerouslySetInnerHTML:{__html:a(r,i,o)}}),e.createElement(`script`,{type:`application/json`,id:`app-options-data`,dangerouslySetInnerHTML:{__html:t.serializeForHtmlScript(r.options)}}),e.createElement(`script`,{dangerouslySetInnerHTML:{__html:t.renderAppOptionsScriptContent()}}),l?e.createElement(`script`,{dangerouslySetInnerHTML:{__html:l}}):null,e.createElement(`div`,{id:`root`},s)))}function u(e){let{appHtml:t,...n}=e,{beforeAppHtml:r,afterAppHtml:i}=s(n);return`${r}${t}${i}`}function d(e){let{app:n,ctx:r,page:i,status:a,title:o,message:s,error:c}=e,l=n.config.ssr?.exposeErrorDetails??n.envs.isLocal(),d=c instanceof Error?c.stack||c.message:String(c??``),f=l&&d?`<pre style="white-space:pre-wrap;margin-top:16px;padding:12px;border:1px solid #d8dee4;background:#f6f8fa;color:#24292f;overflow:auto">${t.escapeHtml(d)}</pre>`:``;return u({app:n,ctx:r,page:i,title:o,description:s,appHtml:`<main style="font-family:system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;max-width:720px;margin:72px auto;padding:0 24px;line-height:1.5;color:#24292f">
+            <p style="margin:0 0 8px;color:#57606a;font-size:14px">SSR ${a}</p>
+            <h1 style="margin:0 0 12px;font-size:28px;line-height:1.2">${t.escapeHtml(o)}</h1>
+            <p style="margin:0;color:#57606a">${t.escapeHtml(s)}</p>
+            ${f}
+        </main>`})}exports.createSSRDocumentElement=l,exports.escapeHtml=t.escapeHtml,exports.escapeHtmlAttr=t.escapeHtmlAttr,exports.renderSSRErrorHtml=d,exports.renderSSRHtmlShell=u,exports.renderSSRHtmlShellParts=s,exports.serializeForHtmlScript=t.serializeForHtmlScript;

package/cjs/app/ssr/manifest.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../_virtual/_rolldown/runtime.js`),t=require(`../../ssrSharedData/outputPaths.js`);let n=require(`node:path`);n=e.__toESM(n);function r(e){return String(e).replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#39;`)}function i(e,t,r){let i=t.split(n.default.sep).join(`/`),a=r.src?.split(n.default.sep).join(`/`);return[r.name,i,a].filter(e=>!!e).some(t=>{let r=t.split(n.default.sep).join(`/`),i=n.default.basename(r).replace(/\.entry\.[^.]+$/,``);return r===e||i===e||n.default.basename(n.default.dirname(r))===e})}function a(e,t){if(!e)return null;let n=Object.entries(e),r=n.find(([,e])=>e.isEntry&&e.name===t);if(r)return r[1];let a=n.find(([e,n])=>n.isEntry&&i(t,e,n));return a?a[1]:n.find(([e,n])=>i(t,e,n))?.[1]??null}function o(e,n){if(!e||!n)return``;let i=e,a=[],o=new Set,s=new Set;function c(e){o.has(e)||(o.add(e),a.push(`<link rel="modulepreload" href="${r(t.ssrClientAssetUrl(e))}" />`))}function l(e){o.has(e)||(o.add(e),a.push(`<link rel="stylesheet" href="${r(t.ssrClientAssetUrl(e))}" />`))}function u(e){if(!s.has(e)){s.add(e),e.file&&c(e.file);for(let t of e.css??[])l(t);for(let t of e.imports??[]){let e=i[t];e&&u(e)}}}return u(n),a.join(`
+`)}exports.findSSRClientEntry=a,exports.generateSSRPreloadLinks=o;

package/cjs/app/view/entry.tpl

@@ -1,46 +1,11 @@
 <!DOCTYPE html>
 <html lang="en" class="dark" style="color-scheme: dark">
     <head>
-        <meta charset="UTF-8" />
-        <script>
-            ;(() => {
-                const storageKey = 'tc_theme'
-                let mode = 'dark'
-
-                try {
-                    const storedMode = localStorage.getItem(storageKey)
-                    if (storedMode === 'light' || storedMode === 'dark') {
-                        mode = storedMode
-                    }
-                } catch (error) {
-                    // Keep the template default when localStorage is unavailable.
-                }
-
-                const root = document.documentElement
-                root.classList.toggle('dark', mode === 'dark')
-                root.style.colorScheme = mode
-            })()
-        </script>
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <link rel="icon" type="image/x-icon" href="/static/logo.png" />
-        <title>{{ name }}</title>
+        <!-- TC_SHARED_HEAD -->
         <!-- TC_HEAD_SLOT -->
     </head>
 
-    <script id="input">
-        window['_basePath'] = {{basePath | safe}}
-        window['_FEBasePage'] = {{FEBasePage | safe}}
-        window['_projKey'] = {{projKeyJson | safe}}
-        window['_signKey'] = {{signKey | safe}}
-        const s = document.getElementById('input')
-        s.parentElement.removeChild(s)
-    </script>
-    <script type="application/json" id="app-options-data">{{ options | safe }}</script>
-    <script>
-        const appOptionsScript = document.getElementById('app-options-data')
-        window['appOptions'] = JSON.parse(appOptionsScript.textContent || '{}')
-        appOptionsScript.parentElement.removeChild(appOptionsScript)
-    </script>
+    <!-- TC_RUNTIME_CONTEXT -->
 
     <body>
         <!-- TC_BODY_BEFORE_ROOT_SLOT -->

package/cjs/bundler/buildBE.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../scripts/vite-build/build.js`);require(`../scripts/vite-build/index.js`);var t=[`index.ts`,`index.js`,`app`,`config`,`model`];async function n(n={}){return e.buildEntries({...n,rootDir:n.rootDir,input:n.input??t,outDir:n.outDir??`dist`,format:n.format??`cjs`,alias:n.alias,allowMissingInput:n.allowMissingInput??!n.input,outputStructure:n.outputStructure??`preserve`,bundleDependencies:n.bundleDependencies??!1,externalNodeBuiltins:n.externalNodeBuiltins??!0,dts:n.dts??!1,copy:n.copy??{input:n.input??t,extensions:{input:[`.tpl`,`.html`,`.css`,`.scss`,`.sass`,`.less`,`.svg`,`.png`,`.jpg`,`.jpeg`,`.gif`,`.webp`,`.ico`,`.json`,`.md`,`.txt`,`.xml`,`.yml`,`.yaml`],mergeDefault:!1}}})}exports.buildBE=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../scripts/vite-build/build.js`);require(`../scripts/vite-build/index.js`);var t=[`index.ts`,`index.js`,`app`,`config`,`models`];async function n(n={}){return e.buildEntries({...n,rootDir:n.rootDir,input:n.input??t,outDir:n.outDir??`dist`,format:n.format??`cjs`,alias:n.alias,allowMissingInput:n.allowMissingInput??!n.input,outputStructure:n.outputStructure??`preserve`,bundleDependencies:n.bundleDependencies??!1,externalNodeBuiltins:n.externalNodeBuiltins??!0,dts:n.dts??!1,copy:n.copy??{input:n.input??t,extensions:{input:[`.tpl`,`.html`,`.css`,`.scss`,`.sass`,`.less`,`.svg`,`.png`,`.jpg`,`.jpeg`,`.gif`,`.webp`,`.ico`,`.json`,`.md`,`.txt`,`.xml`,`.yml`,`.yaml`],mergeDefault:!1}}})}exports.buildBE=n;

package/cjs/bundler/buildSSR.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/common/log/index.js`),n=require(`../ssrSharedData/outputPaths.js`),r=require(`./feSharedConfig.js`),i=require(`./ssrEntries.js`),a=require(`./state.js`),o=require(`./utils.js`);let s=require(`path`);s=e.__toESM(s);let c=require(`vite`);var l=r.createBundlerPaths();function u(e){return i.collectBundlerSSREntries(l,e)}function d(e){return n.resolveSSRServerOutDir({...e,frameNodePath:l.frameNodePath})}function f(e){return n.resolveSSRClientOutDir({...e,frameNodePath:l.frameNodePath})}function p(e){return n.resolveSSRManifestOutDir({...e,frameNodePath:l.frameNodePath})}async function m(e,n){t.logGreen(`[SSR] Building server bundle...`),await(0,c.build)({configFile:!1,plugins:r.createFEBasePlugins(),build:{outDir:d(n),emptyOutDir:!0,ssr:!0,rolldownOptions:{input:e,external:r.ssrReactExternal,output:{codeSplitting:{groups:o.createFECodeSplittingGroups()}}}},ssr:{external:r.ssrReactExternal,noExternal:r.createSSRNoExternal(l,n?.ssrNoExternal)},resolve:{alias:r.createSSRResolveAlias(l,n)}}),t.logGreen(`[SSR] Server bundle done.`)}async function h(e,n){t.logGreen(`[SSR] Building shared browser client bundle...`);let r={...a.buildFESharedState.options};a.setBuildFEOptions({...r,baseDir:n?.baseDir??r.baseDir,output:n?.output??r.output,minifyHtml:n?.minifyHtml??r.minifyHtml});try{await o.VBuildFE(o.entries(a.buildFESharedState.options),void 0,{ssrInput:e,ssrManifestOutDir:p(n)})}finally{a.setBuildFEOptions(r)}t.logGreen(`[SSR] Shared browser client bundle done.`)}async function g(e){let n=u(e);if(Object.keys(n).length)try{await m(n,e),await h(n,e),t.logGreen(`[SSR] All builds completed.`)}catch(e){throw t.logRed(`[SSR] Build failed:`),t.logRed(e),e}}async function _(e){let r=await import(`chokidar`),i=e?.debounceMs??200,a=s.default.resolve(n.resolveRunPath(e),`./ssr/apps`),o=[...new Set([l.frameSSRAppsPath,a])],c=r.watch(o,{ignored:e=>{let t=e.split(s.default.sep).join(`/`);return/(^|\/)\./.test(t)||/(^|\/)node_modules(\/|$)/.test(t)||/(^|\/)(dist|build|coverage)(\/|$)/.test(t)||/(^|\/)ssr-(server|client)(\/|$)/.test(t)},depth:8,persistent:!0,ignoreInitial:!0,usePolling:!0,interval:300}),u,d=!1,f=!1,p=async()=>{if(d){f=!0;return}d=!0;try{do{f=!1;try{await g(e)}catch(e){t.logRed(e)}}while(f)}finally{d=!1}},m=e=>{t.logYellow(`[SSR] changed: ${e}`),u&&clearTimeout(u),u=setTimeout(()=>{u=void 0,p()},i)};return c.on(`all`,(e,t)=>{[`add`,`change`,`unlink`,`unlinkDir`].includes(e)&&m(t)}),c.on(`error`,e=>{t.logRed(`[SSR] watcher error:`),t.logRed(e)}),t.logYellow(`[SSR] watching ${o.join(`, `)}/...`),c}exports.buildSSR=g,exports.ssrClientOutDir=f,exports.ssrEntries=u,exports.ssrManifestOutDir=p,exports.ssrServerOutDir=d,exports.watchSSRFiles=_;