@_tc/template-core 0.2.0-bate.0 → 0.2.0-bate.10

package/README.md

@@ -116,9 +116,9 @@ export default {
 }
 ```
 
-`auth.ATKey` / `auth.RTKey` 用于约定业务鉴权中间件读取短 token 和刷新 token 的 header 名；默认分别为 `Authorization` 和 `RT`。
+`auth.ATKey` / `auth.RTKey` 用于约定项目鉴权中间件读取短 token 和刷新 token 的 header 名；默认分别为 `Authorization` 和 `RT`。
 
-静态资源挂载顺序为：框架 `app/public`、项目 `app/public`、`additionalPublicPaths`。Nunjucks 模板查找顺序为：框架 `app/public/dist`、项目 `app/public/dist`、`additionalPublicPaths`。当 `buildFE` 输出到自定义目录时，可以用 `additionalPublicPaths` 把该目录交给 Koa 提供静态资源访问和模板渲染；如果需要模板查找也命中追加目录，请传绝对路径数组。
+静态资源挂载顺序为：项目 `app/public`、框架 `app/public`、`additionalPublicPaths`。Nunjucks 模板查找顺序为：项目 `app/public/dist`、框架 `app/public/dist`、`additionalPublicPaths/dist`。这些目录由 `app.publicsPath` 统一维护。当 `buildFE` 输出到自定义目录时，可以用 `additionalPublicPaths` 把该目录交给 Koa 提供静态资源访问和模板渲染；如果需要模板查找也命中追加目录，请传绝对路径数组。
 
 ### buildFE 参数说明
 
@@ -127,7 +127,7 @@ buildFE(mode: 'dev' | 'prod', options?: BuildFEOptions)
 ```
 
 **mode**：构建模式
-- `'dev'`：开发模式，构建一次并监听业务 `frontend/` 变化后重建
+- `'dev'`：开发模式，构建一次并监听项目 `frontend/` 变化后重建
 - `'prod'`：生产模式，构建优化后的静态资源
 
 **options.output**：构建输出位置
@@ -135,6 +135,10 @@ buildFE(mode: 'dev' | 'prod', options?: BuildFEOptions)
 - `'run'`：输出到项目根目录的 `app/public/dist`，适合 TypeScript 编译后的项目
 - `() => string`：自定义函数，返回输出目录；建议返回绝对路径
 
+**options.minifyHtml**：是否压缩 Vite 输出的 HTML 内容后再写出最终 `.tpl` / `.html` 文件，默认 `false`
+
+构建完成后会在输出目录写入 `FEBuildKey`。服务端渲染 HTML 时会读取 `public/dist/FEBuildKey`，构建 key 变化后自动清空本地 HTML ETag 缓存。
+
 示例：
 
 ```ts
@@ -148,6 +152,9 @@ await buildFE('prod', { output: 'run' })
 await buildFE('prod', {
   output: () => join(__dirname, 'dist/public')
 })
+
+// 压缩最终模板输出
+await buildFE('prod', { minifyHtml: true })
 ```
 
 配置文件：
@@ -169,20 +176,23 @@ http://localhost:9000/dash?projk=demo
 
 ## 常用公开入口
 
-完整 exports 以发布包内 `package.json` 为准，除下表外还包含 `./fe/main`、`./fe/*`、`./fe/rc/*`、`./fe/rc/hooks/*` 等子路径。
+完整 exports 以发布包内 `package.json` 为准，除下表外还包含 `./fe/main`、`./fe/common/request`、`./fe/*`、`./fe/rc/*`、`./fe/rc/hooks` 等子路径。
 
 | 入口 | 用途 |
 | --- | --- |
 | `@_tc/template-core` | 服务启动、基础 Controller/Service、Koa 类型 |
 | `@_tc/template-core/bundler` | 构建入口，提供前端资源构建 `buildFE` 和消费方 Node/backend 构建 `buildBE` |
-| `@_tc/template-core/fe` | 前端初始化、Dash 路由扩展、请求方法、SchemaPage 事件、共享状态和内置前端组件 |
+| `@_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` 会导出常用 Node 侧类型，业务项目写 `app/*` 文件时建议优先复用这些类型。
+`@_tc/template-core` 会导出常用 Node 侧类型，项目编写 `app/*` 文件时建议优先复用这些类型。
 
 | 类型 | 使用场景 |
 | --- | --- |
@@ -280,7 +290,7 @@ VS Code 建议安装官方 Tailwind CSS IntelliSense 插件，并在工作区 `.
 ## 内置功能
 
 - Koa 服务启动：`serverStart(options)`。
-- 约定式加载：自动加载 `config`、`extend`、`router-schema`、`service`、`controller`、`middlewares`、根级 `middleware`、`router`。
+- 约定式加载：自动加载 `config`、`extends`、`router-schema`、`service`、`controller`、`middlewares`、根级 `middleware`、`router`。
 - 双层 app：框架内置 `app/` 和项目 `app/` 一起加载。
 - 默认项目接口：
   - `GET /api/project/model_list`
@@ -292,8 +302,8 @@ VS Code 建议安装官方 Tailwind CSS IntelliSense 插件，并在工作区 `.
 - Schema CRUD：根据 `model` 中的 `schemaConfig` 生成搜索、表格、新增、编辑、详情。
 - 内置 UI 组件：提供丰富的 React 组件库，详见下方"内置 UI 组件"章节。
 - API 中间件：错误处理、静态资源、body parser、项目上下文、接口签名、参数校验。
-- 前端构建：扫描框架和项目的 `frontend/**/*.entry.{ts,tsx,js,jsx}`，输出服务端可渲染的 `.entry.tpl` 和对应 `.entry.html`。
-- 类型扩展：支持扩展 SchemaForm、CallCom、KoaApp。
+- 前端构建：扫描框架和项目的 `frontend/**/*.entry.{ts,tsx,js,jsx}`，输出服务端可渲染的 `.entry.tpl`，并写入 `FEBuildKey` 供 HTML ETag 缓存失效使用。
+- 类型扩展：支持扩展 SchemaForm、SchemaTable 单元格渲染组件、CallCom、KoaApp。
 
 ## 前端公共能力
 
@@ -303,21 +313,36 @@ VS Code 建议安装官方 Tailwind CSS IntelliSense 插件，并在工作区 `.
 import {
   api,
   apiFreezerStore,
+  addLanguageResources,
   AsyncSelect,
+  clearAuthToken,
   eventsInfo,
+  getCurrentLanguage,
+  getFallbackLanguage,
   FreezeState,
   get,
+  getSupportedLanguages,
+  getAuthToken,
   LanguageSwitch,
+  localKeyMap,
   merge,
   modeStore,
   post,
+  renderImportComponent,
+  registerFrontendI18nResources,
   request,
   schemaEventBus,
   schemaStore,
+  setFallbackLanguage,
+  setLanguage,
+  setResources,
+  setAuthToken,
   ThemeSwitch,
+  t,
   useApiFreezer,
   useModeStore,
   useSchemaStore,
+  useText,
 } from '@_tc/template-core/fe'
 
 import type {
@@ -333,6 +358,8 @@ import type {
   PageResponse,
   RequestConfig,
   ResponseConfig,
+  SchemaTableRenderComponent,
+  SchemaTableRenderComponentsMap,
   SchemaFormComponentsMap,
   SchemaFormNamespace,
   SelectProps,
@@ -345,30 +372,50 @@ import type {
 | --- | --- |
 | 应用启动 | `initApp` |
 | 内置前端组件 | `AsyncSelect`、`LanguageSwitch`、`ThemeSwitch` |
+| 组件加载辅助 | `renderImportComponent` |
 | Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext`、`DashComponentsMap`、`DashHeaderUserAreaProps`、`DashRouteGuard` |
-| SchemaPage 类型 | `CallComComponentsMap`、`CallComRenderer` |
+| SchemaPage 类型 | `CallComComponentsMap`、`CallComRenderer`、`SchemaTableRenderComponent`、`SchemaTableRenderComponentsMap` |
 | SchemaForm 类型 | `FormFieldSchema`、`SchemaFormComponentsMap`、`SchemaFormNamespace`、`SelectProps` |
 | 请求方法 | `api`、`request`、`get`、`post`、`put`、`patch`、`del` |
 | 请求类型 | `BaseResponse`、`PageParams`、`PageResponse`、`RequestConfig`、`ResponseConfig`、`AxiosError` |
+| RAF 风格计时器 | `rafSetTimeout`、`rafSetInterval`、`rafClearTimeout`、`rafClearInterval`、`clearRafTimer`、`RafTimerId`、`RafTimerCallback` |
+| Token 工具 | `getAuthToken`、`setAuthToken`、`clearAuthToken`、`localKeyMap` |
+| 多语言工具 | `useText`、`getText`、`t`、`registerFrontendI18nResources`、`addLanguageResources`、`setLanguage`、`setFallbackLanguage`、`setResources`、`getCurrentLanguage`、`getFallbackLanguage`、`getSupportedLanguages` |
 | 请求冻结 | `apiFreezerStore`、`useApiFreezer`、`FreezeState`、`ApiFreezerRequestMatcher` |
 | 事件工具 | `eventsInfo`、`merge` |
 | 共享状态 | `modeStore`、`useModeStore`、`schemaStore`、`useSchemaStore`、`schemaEventBus` |
 
 `modeStore` 管项目模型和当前项目数据，`schemaStore` 管当前 Schema 页面的 schema/cache，`schemaEventBus` 用来在 Search、Table、CallCom 之间通信。
 
+`renderImportComponent` 封装了 `React.lazy` + `Suspense`，默认会用页面骨架屏作为 fallback。`getAuthToken()`、`setAuthToken()` 和 `clearAuthToken()` 用于读写或清理本地短 token，`localKeyMap` 暴露对应的本地存储 key 常量。
+
 只使用请求层时，也可以从 `@_tc/template-core/fe/common/request` 导入 `api`、请求方法和请求类型；这是发布包显式子路径，不要下钻到 `frontend/src/common/request`。
 
 ### 前端多语言
 
-TemplateCore 前端通过 `@_tc/template-core/fe` 暴露 i18n 能力。框架内置中文、英文资源，项目可以继续追加自己的资源。
+TemplateCore 前端通过 `@_tc/template-core/fe` 暴露 i18n 能力。框架内置中文、英文资源，但不会在普通自定义页面 import 前端入口时自动注册，避免非 Dashboard 页面把框架文案整包带入运行时资源。
+
+默认 Dashboard 入口会自动调用 `registerFrontendI18nResources()`，所以 Dashboard、Schema CRUD、内置页头、语言切换等框架页面可以直接使用框架内置文案。自定义入口如果也要复用这些框架文案，需要在渲染前手动注册：
+
+```ts
+import { initApp, registerFrontendI18nResources } from '@_tc/template-core/fe'
+
+initApp(App, {
+  beforeRender: async () => {
+    await registerFrontendI18nResources()
+  },
+})
+```
+
+项目可以继续追加自己的资源或新增语种。
 
 **追加自定义语言资源**：
 
 ```ts
-import { i18nStore } from '@_tc/template-core/fe'
+import { addLanguageResources } from '@_tc/template-core/fe'
 
-i18nStore.getState().addResources('zh-CN', {
-  business: {
+addLanguageResources('zh-CN', {
+  app: {
     product: {
       menu: '商品管理',
       name: '商品名称',
@@ -378,8 +425,8 @@ i18nStore.getState().addResources('zh-CN', {
   },
 })
 
-i18nStore.getState().addResources('en-US', {
-  business: {
+addLanguageResources('en-US', {
+  app: {
     product: {
       menu: 'Products',
       name: 'Product name',
@@ -390,17 +437,49 @@ i18nStore.getState().addResources('en-US', {
 })
 ```
 
+**新增语种并切换**：
+
+```ts
+import { addLanguageResources, setLanguage } from '@_tc/template-core/fe'
+
+addLanguageResources('ja-JP', {
+  app: {
+    product: {
+      menu: '商品管理',
+    },
+  },
+})
+
+setLanguage('ja-JP')
+```
+
+`addLanguageResources()` 用于追加或新增某个语种的文案，默认会深合并同语种资源；传 `{ merge: false }` 可以替换该语种资源。`setResources(resources, { merge: true })` 可批量合并多语种资源。`LanguageSwitch` 默认会把已注册语种加入选项；需要自定义展示文案时仍可传入 `options`。
+
+React 组件 render 中使用 `useText()` 读取文案。它会订阅语言和资源变化，调用 `setLanguage()` 后组件会自动重渲染：
+
+```tsx
+import { useText } from '@_tc/template-core/fe'
+
+function ProductTitle() {
+  const text = useText()
+
+  return <h1>{text('$i18n::app.product.menu')}</h1>
+}
+```
+
+`getText()` 是普通函数，适合请求错误、日志、校验工具或事件回调等非 React 场景；它不会主动触发 React 组件重渲染。
+
 资源注册时不写 `$i18n::` 前缀，配置中使用时才写：
 
 ```ts
-const title = '$i18n::business.product.createTitle'
+const title = '$i18n::app.product.createTitle'
 ```
 
 **在 model / Schema 配置中使用**：
 
 ```ts
 {
-  name: '$i18n::business.product.menu',
+  name: '$i18n::app.product.menu',
   moduleType: 'schema',
   schemaConfig: {
     schema: {
@@ -408,7 +487,7 @@ const title = '$i18n::business.product.createTitle'
       properties: {
         name: {
           type: 'string',
-          label: '$i18n::business.product.name',
+          label: '$i18n::app.product.name',
           minLength: 2,
           createFormOption: {
             comType: 'input',
@@ -422,7 +501,7 @@ const title = '$i18n::business.product.createTitle'
     tableConfig: {
       headerButtons: [
         {
-          label: '$i18n::business.product.create',
+          label: '$i18n::app.product.create',
           eventKey: 'callComponent',
           eventOption: { comName: 'createForm' },
         },
@@ -430,7 +509,7 @@ const title = '$i18n::business.product.createTitle'
     },
     componentConfig: {
       createForm: {
-        title: '$i18n::business.product.createTitle',
+        title: '$i18n::app.product.createTitle',
         saveBtnText: '$i18n::common.submit',
       },
     },
@@ -469,7 +548,7 @@ export function Toolbar() {
 }
 ```
 
-`LanguageSwitch` 默认提供 `zh-CN` 和 `en-US`，也支持传入 `options` 覆盖语言列表。组件内部会调用 `i18nStore.getState().setLanguage()`，因此会沿用 `tc_language` 的持久化行为。
+`LanguageSwitch` 默认提供 `zh-CN` 和 `en-US`，也支持传入 `options` 覆盖语言列表。组件当前是按钮 + 下拉菜单形态，`option.label` 支持 ReactNode，`buttonClassName` 可自定义触发按钮样式。组件内部会调用 `i18nStore.getState().setLanguage()`，因此会沿用 `tc_language` 的持久化行为。
 
 **AJV 校验文案**：
 
@@ -495,7 +574,7 @@ export function Toolbar() {
 }
 ```
 
-`ThemeSwitch` 会切换 `document.documentElement` 上的 `dark` class，并同步 `color-scheme`。默认写入 localStorage，key 是 `tc_theme`。刷新页面后会优先读取本地主题；没有本地主题时，读取当前根节点是否已有 `dark` class。
+`ThemeSwitch` 会切换 `document.documentElement` 上的 `dark` class，并同步 `color-scheme`。默认写入 localStorage，key 是 `tc_theme`。刷新页面后会优先读取本地主题；没有本地主题时，读取当前根节点是否已有 `dark` class。默认 Dashboard 会在渲染前调用 `initThemeMode()`，让已保存主题尽早生效。
 
 常用参数：
 
@@ -507,6 +586,21 @@ export function Toolbar() {
 | `persist` | 是否写入 localStorage，默认 `true`。 |
 | `storageKey` | 自定义本地存储 key，默认 `tc_theme`。 |
 
+如需在自定义入口或组件外手动初始化/切换主题，可以从 `@_tc/template-core/fe` 导入主题工具：
+
+```ts
+import { applyThemeMode, getCurrentThemeMode, initThemeMode, themeSwitchStorageKey } from '@_tc/template-core/fe'
+
+initThemeMode()
+applyThemeMode('dark', true)
+```
+
+RAF 风格计时器由 `@tc/common/rafTimer` 提供，浏览器优先使用 `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 自动降级计时器实现。
+
 ### 前端请求封装详解
 
 框架内置的请求封装基于 `@tc/common/http`，底层使用原生 `fetch` API，实现了类似 Axios 的接口和拦截器机制，提供了签名、鉴权、错误处理等能力。
@@ -516,6 +610,7 @@ export function Toolbar() {
 - `timeout`：15000ms（15秒）
 - `credentials`：`'include'`，支持跨域携带 cookie
 - `window._signKey`：由服务端页面模板从 `app.config.signKey` 注入
+- 默认会先设置 `Content-Type: application/json`；如果是上传文件、`FormData` 或其他内容类型，请在请求配置里显式覆盖
 
 **请求拦截器**：
 
@@ -738,7 +833,7 @@ app/middlewares/**/*.(js|ts)     -> app.middlewares
 app/middleware.(js|ts)           -> 全局中间件编排，按框架 -> 项目顺序执行
 app/router/**/*.(js|ts)          -> Koa router
 app/router-schema/**/*.(js|ts)   -> app.routerSchema
-app/extend/*.(js|ts)             -> app.extends
+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 按需读取的项目模型配置
@@ -872,10 +967,10 @@ const unsafeUsers = app.extends.db.queryDB(
 )
 ```
 
-业务项目可以用自己的 `app/extend/db.ts` 覆盖默认实现。建议保留同一组方法名，这样 controller/service 调用方不用调整。
+项目可以用自己的 `app/extends/db.ts` 覆盖默认实现。建议保留同一组方法名，这样 controller/service 调用方不用调整。
 
 ```ts
-// app/extend/db.ts
+// app/extends/db.ts
 import type { DB, DBFactory } from '@_tc/template-core'
 
 interface DataOptions {
@@ -988,7 +1083,7 @@ export default (app: KoaApp, router: Router) => {
 - 每个 `app/router/*.ts` 文件都会获得独立的 `koa-router` 实例。
 - 可以通过 `router.level = number` 控制挂载顺序，数值越小越早挂载。
 - 默认 `level` 是 `0`，框架兜底 router 是 `99`。
-- 通配、兜底、重定向类路由建议设置较大的 `level`，避免抢先匹配业务 API。
+- 通配、兜底、重定向类路由建议设置较大的 `level`，避免抢先匹配项目 API。
 
 ```ts
 import type { KoaApp, Router } from '@_tc/template-core'
@@ -1277,7 +1372,7 @@ DELETE {api}        -> 删除
 
 ### 服务端兜底路由守卫
 
-业务项目可以创建 `app/router-guard.ts` 或 `app/router-guard.js`。它只在所有正常 `app/router/*` 路由都没有命中时执行。
+项目可以创建 `app/router-guard.ts` 或 `app/router-guard.js`。它只在所有正常 `app/router/*` 路由都没有命中时执行。
 
 ```ts
 import type { Ctx, KoaApp } from '@_tc/template-core'
@@ -1302,7 +1397,7 @@ export default (_app: KoaApp) => {
 
 ### 扩展 Dashboard 顶部用户区域
 
-业务项目可以创建 `frontend/extended/dash/components.tsx`，通过组件映射填充内置 Dashboard 页头右侧区域。
+项目可以创建 `frontend/extended/dash/components.tsx`，通过组件映射填充内置 Dashboard 页头右侧区域。
 
 ```tsx
 // frontend/extended/dash/components.tsx
@@ -1323,7 +1418,7 @@ export default components
 
 ### 扩展 Dashboard 登录守卫
 
-业务项目可以创建 `frontend/extended/dash/routeGuard.ts`，用于在 Dashboard 内置 `homePage` / 首菜单重定向前做登录判断。
+项目可以创建 `frontend/extended/dash/routeGuard.ts`，用于在 Dashboard 内置 `homePage` / 首菜单重定向前做登录判断。
 
 ```ts
 // frontend/extended/dash/routeGuard.ts
@@ -1339,9 +1434,9 @@ export default dashRouteGuard
 返回值规则：
 
 - 返回 `string`：框架使用 `window.location.href` 跳转，登录页不需要在 Dash 路由下。
-- 返回非 `string`：中断 Dashboard 内置重定向，业务方可自行跳转或处理提示。
+- 返回非 `string`：中断 Dashboard 内置重定向，使用方可自行跳转或处理提示。
 - `DashRouteGuardResult` 是 `string | undefined`；`undefined`（包括已登录分支的隐式返回）也会打断 Dashboard 内置重定向。
-- 没有业务 `routeGuard` 文件时，框架使用兜底空对象，不影响默认 Dashboard 重定向。
+- 没有自定义 `routeGuard` 文件时，框架使用兜底空对象，不影响默认 Dashboard 重定向。
 
 ### 扩展 SchemaForm 字段组件
 
@@ -1511,6 +1606,90 @@ remark: {
 }
 ```
 
+### 扩展 SchemaTable 单元格渲染组件
+
+SchemaPage 表格列支持通过 `tableOption.renderComponent` 使用内置或自定义注册的渲染组件。内置组件：
+
+- `PreviewImage`：把当前单元格值渲染成图片预览；值是数组时直接作为图片列表，值是单个字符串时自动转成单图数组。
+
+直接使用内置组件：
+
+```ts
+cover: {
+  type: 'string',
+  label: '封面',
+  tableOption: {
+    renderComponent: 'PreviewImage',
+    renderComponentProps: {
+      width: 48,
+      height: 48,
+    },
+  },
+}
+```
+
+自定义渲染组件时，先声明 props 类型：
+
+```ts
+// typing/template-core.d.ts
+import '@_tc/template-core/model'
+
+declare module '@_tc/template-core/model' {
+  export namespace SchemaTableNamespace {
+    interface RenderComponentPropsMap {
+      PriceCell: {
+        value?: unknown
+        record?: Record<string, unknown>
+        rowIndex?: number
+        fieldKey?: string
+        currency?: string
+      }
+    }
+  }
+}
+```
+
+注册运行时组件：
+
+```ts
+// frontend/extended/SchemaPage/SchemaTable/data.ts
+import { lazy } from 'react'
+import type { SchemaTableRenderComponentsMap } from '@_tc/template-core/fe'
+
+const componentsMap = {
+  PriceCell: lazy(() => import('../../components/PriceCell')),
+} satisfies SchemaTableRenderComponentsMap
+
+export default componentsMap
+```
+
+组件会收到 `value`、`record`、`rowIndex`、`fieldKey`，以及 `renderComponentProps` 中的自定义参数：
+
+```tsx
+// frontend/components/PriceCell.tsx
+export default function PriceCell(props: {
+  value?: unknown
+  currency?: string
+}) {
+  return <span>{props.currency ?? '¥'}{Number(props.value ?? 0).toFixed(2)}</span>
+}
+```
+
+model 中使用：
+
+```ts
+price: {
+  type: 'number',
+  label: '价格',
+  tableOption: {
+    renderComponent: 'PriceCell',
+    renderComponentProps: {
+      currency: '¥',
+    },
+  },
+}
+```
+
 ## 如何配置类型扩展
 
 ### tsconfig
@@ -1610,6 +1789,22 @@ declare module '@_tc/template-core/model' {
 - `OptionMap` 对应字段上的 `xxxOption`。
 - 运行时组件注册在 `frontend/extended/SchemaPage/CallCom/data.ts`。
 
+### SchemaTable 渲染组件类型扩展
+
+扩展目标：
+
+```ts
+declare module '@_tc/template-core/model' {
+  export namespace SchemaTableNamespace {
+    interface RenderComponentPropsMap {}
+  }
+}
+```
+
+- `RenderComponentPropsMap` 的 key 对应 `tableOption.renderComponent`。
+- 运行时组件注册在 `frontend/extended/SchemaPage/SchemaTable/data.ts`。
+- 组件运行时会自动收到 `value`、`record`、`rowIndex`、`fieldKey`；`renderComponentProps` 只配置自定义参数。
+
 ### KoaApp 类型扩展
 
 使用方推荐增强根包 `@_tc/template-core`：
@@ -1792,6 +1987,16 @@ await buildFE('prod', {
 })
 ```
 
+也可以压缩最终模板输出：
+
+```ts
+await buildFE('prod', {
+  minifyHtml: true,
+})
+```
+
+构建完成后会在输出目录写入 `FEBuildKey`，服务端渲染 HTML 时会用它判断本地 HTML ETag 缓存是否需要清空。
+
 ## Node/backend 构建 buildBE
 
 消费方 Node/backend 侧构建使用 `buildBE()`。它复用发布包内的 `scripts/vite-build/buildEntries`，只是提供消费方默认配置。
@@ -1953,6 +2158,6 @@ await buildBE({
 - `model` 数组合并依赖稳定 `key`。
 - Dashboard 默认需要 URL 带 `?projk=项目key`。
 - Dashboard 登录守卫放在 `frontend/extended/dash/routeGuard.ts`；登录页通常不在 Dash 路由下，返回登录页 URL 即可。
-- 服务端兜底守卫放在业务 `app/router-guard.ts|js`，不是 `app/business` 子目录。
+- 服务端兜底守卫放在项目根目录的 `app/router-guard.ts|js`。
 - 前端入口必须命名为 `.entry.tsx`、`.entry.ts`、`.entry.jsx` 或 `.entry.js`。
 - 入口同目录的 `.html` 只能作为插槽文件使用，不能写完整 HTML 文档；页面外壳始终由 `app/view/entry.tpl` 生成。

package/cjs/app/controller/view.js

@@ -1 +1 @@
-var e=e=>JSON.stringify(e).replace(/</g,`\\u003c`).replace(/>/g,`\\u003e`).replace(/&/g,`\\u0026`).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`),t=(t=>class{async renderPage(n,r){if(n.path.includes(`${t.options.apiPrefix}/`))await r();else{t.extends.logger.log(` - render page: `+n.params.page);try{t.extends.renderView(`${n.params.page}.entry.tpl`,n,{projKey:n.query.projk,name:t.options?.name,env:t.envs.get(),basePath:e(`${t.options.pageBasePage}${n.params.page}`),projKeyJson:e(String(n.query.projk??``)),signKey:e(t.config.signKey),options:e(t.options)})}catch(e){console.log(`-------------- render view error --------------`),console.log(e),t.extends.generateErrorMessage(`template not found`,{status:404,showError:!0,code:0})}}}});module.exports=t;
+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(),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.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;

package/cjs/app/{extend → extends}/db.js

@@ -6,7 +6,7 @@ require(`../../_virtual/_rolldown/runtime.js`);let e=require(`node:fs`),t=requir
                  FROM tc_framework_data
                  WHERE namespace = ?
                  ORDER BY updated_at DESC, data_key ASC
-                 LIMIT ? OFFSET ?`,[d(e?.namespace),t,n]).map(e=>_(e))},countDBData:e=>{let t=y.getDBFirst(`SELECT COUNT(1) AS count_value FROM tc_framework_data WHERE namespace = ?`,[d(e?.namespace)]);return Number(t?.count_value??0)},clearDBData:e=>y.runDB(`DELETE FROM tc_framework_data WHERE namespace = ?`,[d(e?.namespace)]).changes,closeDB:()=>{c||=(i?.close(),!0)}};return y}function a(e){let t=`node:sqlite`,n;try{n=require(t)}catch(e){throw Error(`[db] 默认数据库依赖 Node.js 内置 ${t}，当前运行环境不可用。请升级 Node.js，或在业务项目覆盖 app/extend/db.ts。${y(e)}`)}if(!n.DatabaseSync)throw Error(`[db] ${t} 未提供 DatabaseSync，无法初始化默认 SQLite 数据库。`);return new n.DatabaseSync(e)}function o(e){e.exec(`
+                 LIMIT ? OFFSET ?`,[d(e?.namespace),t,n]).map(e=>_(e))},countDBData:e=>{let t=y.getDBFirst(`SELECT COUNT(1) AS count_value FROM tc_framework_data WHERE namespace = ?`,[d(e?.namespace)]);return Number(t?.count_value??0)},clearDBData:e=>y.runDB(`DELETE FROM tc_framework_data WHERE namespace = ?`,[d(e?.namespace)]).changes,closeDB:()=>{c||=(i?.close(),!0)}};return y}function a(e){let t=`node:sqlite`,n;try{n=require(t)}catch(e){throw Error(`[db] 默认数据库依赖 Node.js 内置 ${t}，当前运行环境不可用。请升级 Node.js，或在业务项目覆盖 app/extends/db.ts。${y(e)}`)}if(!n.DatabaseSync)throw Error(`[db] ${t} 未提供 DatabaseSync，无法初始化默认 SQLite 数据库。`);return new n.DatabaseSync(e)}function o(e){e.exec(`
         CREATE TABLE IF NOT EXISTS tc_framework_data (
             namespace TEXT NOT NULL,
             data_key TEXT NOT NULL,

package/cjs/app/extends/localCacheHtmlEtag.js

@@ -0,0 +1 @@
+const e=require(`../../_virtual/_rolldown/runtime.js`);let t=require(`fs`),n=require(`path`);n=e.__toESM(n);var r=`./dist/FEBuildKey`,i={etags:{},FEBuildKey:null},a=(e=>{let a=(e,t)=>{i.etags[e]=t},o=e=>!!s(e),s=e=>i.etags[e]||null,c=e=>{i.FEBuildKey=e},l=()=>i.FEBuildKey||null,u=()=>{for(let i of e.publicsPath){let e=n.default.resolve(i,r);if((0,t.existsSync)(e))return e}},d=()=>{let e,n=u();return n&&(e=(0,t.readFileSync)(n,`utf-8`)),e===l()};return{keepFreshFEBuildKey:()=>{if(!d()){let e=u();if(e){let n=(0,t.readFileSync)(e,`utf-8`);if(n){c(n),i.etags={};return}}console.log(`--- 没找到前端构建key文件 ---`),console.log(`--- filePath ---   ->  `,e)}},hasEtag:o,getEtag:s,setEtag:a}});module.exports=a;

package/cjs/app/extends/render-view.js

@@ -0,0 +1 @@
+const e=require(`../../_virtual/_rolldown/runtime.js`);let t=require(`node:path`);t=e.__toESM(t);let n=require(`nunjucks`);n=e.__toESM(n);var r=e=>{let r=e.publicsPath.map(e=>t.default.resolve(e,`./dist`));console.log(r);let i=n.default.configure(r,{autoescape:!0,throwOnUndefined:!1,trimBlocks:!1,lstripBlocks:!1,noCache:e.envs.get()===`local`,...typeof e.config.nunjucks==`object`?e.config.nunjucks:{}});return e.extends.nunjucksEnv=i,(e,t,n)=>t.body=i.render(e,Object.assign({},t.state,n))};module.exports=r;

package/cjs/app/middleware.js

@@ -1 +1 @@
-const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/core/paths.js`);let n=require(`koa-compress`);n=e.__toESM(n);let r=require(`path`),i=require(`koa-bodyparser`);i=e.__toESM(i);let a=require(`koa-static`);a=e.__toESM(a);var o=(0,i.default)({formLimit:`1000mb`,enableTypes:[`form`,`json`,`text`]}),s=e=>{let i=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:365*24*60*60*1e3};e.use(e.middlewares.errorHandle),e.use((0,n.default)({threshold:2048}));let s=(0,r.resolve)(t.getAppPath(e,`business`),`./public`),c=(0,r.resolve)(t.getAppPath(e,`frame`),`./public`),l=e.options.additionalPublicPaths??[];l=Array.isArray(l)?l:[l],e.use((0,a.default)(c,i)),e.use((0,a.default)(s,i)),l.forEach(t=>e.use((0,a.default)(t,i))),e.use(o),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=s;
+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:365*24*60*60*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;

package/cjs/app/view/entry.tpl

@@ -3,22 +3,6 @@
     <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <script>
-            ;(() => {
-                const root = document.documentElement
-                let theme = root.classList.contains('dark') ? 'dark' : 'light'
-
-                try {
-                    const storedTheme = window.localStorage.getItem('tc_theme')
-                    if (storedTheme === 'light' || storedTheme === 'dark') {
-                        theme = storedTheme
-                    }
-                } catch (_error) {}
-
-                root.classList.toggle('dark', theme === 'dark')
-                root.style.colorScheme = theme
-            })()
-        </script>
         <link rel="icon" type="image/x-icon" href="/static/logo.png" />
         <title>{{ name }}</title>
         <!-- TC_HEAD_SLOT -->

package/cjs/bundler/buildFE.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../packages/common/log/index.js`),t=require(`./state.js`),n=require(`./dev.js`),r=require(`./prod.js`);var i=(i,a)=>{switch(t.setBuildFEOptions(a),i){case`dev`:return n.dev();case`prod`:return r.prod();default:return e.logRed(`Usage: npx tsx scripts/index.ts [dev|prod]`),Promise.resolve()}};exports.buildFE=i;

package/cjs/bundler/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./buildBE.js`),t=require(`../packages/common/log/index.js`),n=require(`./state.js`),r=require(`./dev.js`),i=require(`./prod.js`);var a=(e,a)=>{switch(n.setBuildFEOptions(a),e){case`dev`:return r.dev();case`prod`:return i.prod();default:return t.logRed(`Usage: npx tsx scripts/index.ts [dev|prod]`),Promise.resolve()}};exports.buildBE=e.buildBE,exports.buildFE=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./buildBE.js`),t=require(`./buildFE.js`);exports.buildBE=e.buildBE,exports.buildFE=t.buildFE;

package/cjs/bundler/state.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={options:{output:`frame`}};function t(t){e.options={output:`frame`,...t}}exports.buildFESharedState=e,exports.setBuildFEOptions=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={options:{output:`frame`,minifyHtml:!1}};function t(t){e.options={output:`frame`,minifyHtml:!1,...t}}exports.buildFESharedState=e,exports.setBuildFEOptions=t;

package/cjs/bundler/utils.js

@@ -1,3 +1,3 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/utils/path.js`);require(`../packages/utils/index.js`);const n=require(`../packages/common/log/index.js`),r=require(`./state.js`);let i=require(`path`);i=e.__toESM(i);let a=require(`glob`);a=e.__toESM(a);let o=require(`fs`),s=require(`vite`),c=require(`@tailwindcss/vite`);c=e.__toESM(c);let l=require(`module`),u=require(`url`);var d=typeof __filename==`string`?__filename:(0,u.fileURLToPath)({}.url),f=i.default.dirname(d),p=process.cwd(),m=(0,l.createRequire)(d),h=i.default.resolve(f,`../../`),g=i.default.resolve(f,`../`),_=i.default.resolve(h,`./fe/frontend`),v=i.default.resolve(p,`.`),y=i.default.resolve(v,`./frontend`),b=e=>i.default.dirname(m.resolve(`${e}/package.json`)),x=i.default.join(v,`.tc-entry-html`),S=`<!-- {{InsertScript}} -->`,C={head:`<!-- TC_HEAD_SLOT -->`,bodyBeforeRoot:`<!-- TC_BODY_BEFORE_ROOT_SLOT -->`,bodyAfterRoot:`<!-- TC_BODY_AFTER_ROOT_SLOT -->`},w=[`head`,`body-before-root`,`body-after-root`],T=()=>({head:``,"body-before-root":``,"body-after-root":``}),E=e=>e.split(i.default.sep).join(`/`),D=e=>{let t=E(e);return t.startsWith(`.`)||t.startsWith(`/`)?t:`./${t}`},O=e=>/<html[\s>]/i.test(e)&&e.includes(`window['_basePath']`)&&/<div\s+id=["']root["']\s*><\/div>/i.test(e),k=e=>{let t=T(),r=(0,o.readFileSync)(e,`utf-8`),i=/<!--\s*tc-slot:([\w-]+)\s*-->([\s\S]*?)<!--\s*\/tc-slot:\1\s*-->/g,a=!1,s=r;if(r.replace(i,(n,r,i)=>{if(a=!0,!w.includes(r))throw Error(`Invalid html slot "${r}" in ${e}. Allowed slots: ${w.join(`, `)}.`);return t[r]+=i.trim()?`${i}\n`:``,s=s.replace(n,``),n}),s.trim()){if(O(r))return n.logYellow(`ignored legacy generated entry html: ${e}`),T();throw Error([`Invalid custom entry html: ${e}.`,`Custom entry html can only contain tc-slot blocks, for example:`,`<!-- tc-slot:head -->`,`<meta name="description" content="..." />`,`<!-- /tc-slot:head -->`].join(`
-`))}return a&&n.logYellow(`using custom entry html slots: ${e}`),t},A=(e,n)=>{let r=i.default.basename(e),s=[i.default.join(e,`${n}.html`),i.default.join(e,`${r}.html`)].find(e=>(0,o.existsSync)(e));if(s)return s;if(a.sync(t.resolve(e,`*.html`)).length)throw Error([`Entry html filename is not supported in ${e}.`,`Use ${n}.html or ${r}.html as a tc-slot file.`].join(`
-`))},j=(e,t)=>e.replace(C.head,t.head).replace(C.bodyBeforeRoot,t[`body-before-root`]).replace(C.bodyAfterRoot,t[`body-after-root`]),M=(e,t,n,r)=>{let a=i.default.join(x,`${n}.html`),s=D(i.default.relative(i.default.dirname(a),t));return(0,o.writeFileSync)(a,j(e,r).replace(S,`<script type="module" src="${s}"><\/script>`)),a};function N(){n.logWhite(`frameFEPath: `+_),n.logWhite(`runFEPath: `+y);let e=[_,y].reduce((e,n)=>{let r=[`js`,`jsx`,`ts`,`tsx`].map(e=>t.resolve(n,`/**`,`/*.`+e)),i=a.sync(r).filter(e=>e.includes(`.entry.`)).filter(e=>!e.includes(`.d.ts`));return[...e,...i]},[]),r={};if(!e.length)return r;(0,o.rmSync)(x,{recursive:!0,force:!0}),(0,o.mkdirSync)(x,{recursive:!0});let s=(0,o.readFileSync)(i.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);for(let t=0;t<e.length;t++){let n=e[t],a=i.default.resolve(n,`../`),o=A(a,i.default.basename(n).replace(/\.entry\.[^.]+$/,``)),c=o?i.default.basename(o,`.html`):a.split(i.default.sep).at(-1);r[c]=M(s,n,c,o?k(o):T())}return r}function P(){let e=r.buildFESharedState.options.output??`frame`;return e!==`frame`&&n.logRed(`Please pay attention to the build output.`),e===`run`?i.default.join(v,`./app/public/dist`):typeof e==`function`?e():i.default.join(g,`./app/public/dist`)}var F=async e=>{let t=(await import(`chokidar`)).watch(y,{ignored:/(^|[\/\\])\../,persistent:!0,ignoreInitial:!0}),r=!1;t.on(`change`,async t=>{if(!r){r=!0,n.logYellow(`changed: ${t}`);try{await e?.()}catch(e){n.logRed(e)}finally{r=!1}}}),n.logYellow(`watching ${y}/...`)};function I(e=`.html`){let t=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=P();if(!(0,o.existsSync)(e))return;let r=a.sync(`**/*.html`,{cwd:e,dot:!0});for(let n of r){let r=i.default.join(e,n),a=i.default.basename(n,`.html`),s=`.entry`;a.indexOf(s)===-1&&(a+=s);for(let n of t){let t=a+n,s=i.default.join(e,t);r!==s&&(0,o.copyFileSync)(r,s)}t.some(t=>r===i.default.join(e,a+t))||(0,o.unlinkSync)(r)}let s=[...new Set(r.map(e=>i.default.dirname(e)))].sort().reverse(),c=e=>{if(!((0,o.existsSync)(e)?(0,o.readdirSync)(e):[1]).length){(0,o.rmdirSync)(e);let t=e.split(i.default.sep).slice(0,-1);t.length&&c(t.join(i.default.sep))}};for(let t of s)t&&t!==`.`&&c(i.default.join(e,t));let l=t.flatMap(t=>a.sync(`**/*`+t,{cwd:e,dot:!0}));for(let e of l)n.logYellow(`final file path -----> `+e)}}}function L(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,a=y,s=`./defaultAlias`])=>{let c=t.map(e=>i.default.resolve(a,r+e)).find(e=>(0,o.existsSync)(e)),l=i.default.resolve(f,s);return c&&(l=c),e[n]=l,e},{})}var R=(...e)=>new RegExp(e.join(`[\\/]`)),z=e=>`_${e}_tcC`,B=async(e,t)=>{try{await(0,s.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),I([`.tpl`]),(0,c.default)()],build:{outDir:P(),emptyOutDir:!0,sourcemap:t===`dev`?`inline`:`hidden`,rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:z(`__nm`),test:R(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:z(`r`),test:R(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:z(`r-d`),test:R(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:z(`r-r-d`),test:R(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:z(`ajv`),test:R(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:z(`ui-lib`),test:R(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:z(`ui-f-lib`),test:R(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react/hooks":i.default.resolve(f,`../../fe/packages/react/hooks/`),"@tc/ui-react":i.default.resolve(f,`../../fe/packages/react/ui/`),...L([[`@tc/scalability/SchemaForm/frameData`,`./extended/SchemaForm/data`,_],[`@tc/scalability/SchemaForm/data`,`./extended/SchemaForm/data`],[`@tc/scalability/SchemaPage/CallCom/data`,`./extended/SchemaPage/CallCom/data`],[`@tc/scalability/dash/customRoutes`,`./extended/dash/customRoutes`],[`@tc/scalability/dash/init`,`./extended/dash/init`],[`@tc/scalability/dash/components`,`./extended/dash/components`],[`@tc/scalability/dash/routeGuard`,`./extended/dash/routeGuard`,void 0,`./defaultRouteGuard`]])}}}),n.logJoinColorized(n.colorize(`builded`,`green`),n.colorize(` -> `,`white`),n.colorize(`time: `,`cyan`),n.colorize(new Date,`pink`))}catch(e){if(n.logRed(e),t!==`dev`)throw e}};exports.VBuildFE=B,exports.entries=N,exports.outDir=P,exports.watchFiles=F;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/common/log/index.js`),n=require(`../packages/utils/path.js`);require(`../packages/utils/index.js`);const r=require(`./state.js`);let i=require(`fs`),a=require(`path`);a=e.__toESM(a);let o=require(`glob`);o=e.__toESM(o);let s=require(`vite`),c=require(`@tailwindcss/vite`);c=e.__toESM(c);let l=require(`module`),u=require(`url`);var d=typeof __filename==`string`?__filename:(0,u.fileURLToPath)({}.url),f=a.default.dirname(d),p=process.cwd(),m=(0,l.createRequire)(d),h=a.default.resolve(f,`../../`),g=a.default.resolve(f,`../`),_=a.default.resolve(h,`./fe/frontend`),v=a.default.resolve(p,`.`),y=a.default.resolve(v,`./frontend`),b=e=>a.default.dirname(m.resolve(`${e}/package.json`)),x=a.default.join(v,`.tc-entry-html`),S=`<!-- {{InsertScript}} -->`,C={head:`<!-- TC_HEAD_SLOT -->`,bodyBeforeRoot:`<!-- TC_BODY_BEFORE_ROOT_SLOT -->`,bodyAfterRoot:`<!-- TC_BODY_AFTER_ROOT_SLOT -->`},w=[`head`,`body-before-root`,`body-after-root`],T=()=>({head:``,"body-before-root":``,"body-after-root":``}),E=e=>e.trim().replace(/<!--(?!\s*(?:tc-slot:|\/tc-slot:))[\s\S]*?-->/g,``).replace(/>\s+</g,`><`),D=e=>{let t=[],n=e.replace(/<(script|style|textarea|pre)\b[\s\S]*?<\/\1>/gi,e=>{let n=`__TC_HTML_PRESERVED_${t.length}__`;return t.push(e),n}).replace(/<!--(?!\s*(?:tc-slot:|\/tc-slot:|\{\{InsertScript\}\}|TC_))[\s\S]*?-->/g,``).replace(/>\s+</g,`><`).trim();return t.reduce((e,t,n)=>e.replace(`__TC_HTML_PRESERVED_${n}__`,t),n)},O=e=>e.split(a.default.sep).join(`/`),k=e=>{let t=O(e);return t.startsWith(`.`)||t.startsWith(`/`)?t:`./${t}`},A=e=>/<html[\s>]/i.test(e)&&e.includes(`window['_basePath']`)&&/<div\s+id=["']root["']\s*><\/div>/i.test(e),j=e=>{let n=T(),r=(0,i.readFileSync)(e,`utf-8`),a=/<!--\s*tc-slot:([\w-]+)\s*-->([\s\S]*?)<!--\s*\/tc-slot:\1\s*-->/g,o=!1,s=r;if(r.replace(a,(t,r,i)=>{if(o=!0,!w.includes(r))throw Error(`Invalid html slot "${r}" in ${e}. Allowed slots: ${w.join(`, `)}.`);return n[r]+=i.trim()?`${i}\n`:``,s=s.replace(t,``),t}),s.trim()){if(A(r))return t.logYellow(`ignored legacy generated entry html: ${e}`),T();throw Error([`Invalid custom entry html: ${e}.`,`Custom entry html can only contain tc-slot blocks, for example:`,`<!-- tc-slot:head -->`,`<meta name="description" content="..." />`,`<!-- /tc-slot:head -->`].join(`
+`))}return o&&t.logYellow(`using custom entry html slots: ${e}`),n},M=(e,t)=>{let r=a.default.basename(e),s=[a.default.join(e,`${t}.html`),a.default.join(e,`${r}.html`)].find(e=>(0,i.existsSync)(e));if(s)return s;if(o.sync(n.resolve(e,`*.html`)).length)throw Error([`Entry html filename is not supported in ${e}.`,`Use ${t}.html or ${r}.html as a tc-slot file.`].join(`
+`))},N=(e,t)=>e.replace(C.head,E(t.head)).replace(C.bodyBeforeRoot,E(t[`body-before-root`])).replace(C.bodyAfterRoot,E(t[`body-after-root`])),P=(e=new Date)=>{let t=(e,t=2)=>e.toString().padStart(t,`0`);return[e.getFullYear(),t(e.getMonth()+1),t(e.getDate()),t(e.getHours())].join(`/`)+`:${t(e.getMinutes())}:${t(e.getSeconds())}:${t(e.getMilliseconds(),3)}`},F=(e,t,n,r)=>{let o=a.default.join(x,`${n}.html`),s=k(a.default.relative(a.default.dirname(o),t));return(0,i.writeFileSync)(o,N(e,r).replace(S,`<script type="module" src="${s}"><\/script>`)),o};function I(){t.logWhite(`frameFEPath: `+_),t.logWhite(`runFEPath: `+y);let e=[_,y].reduce((e,t)=>{let r=[`js`,`jsx`,`ts`,`tsx`].map(e=>n.resolve(t,`/**`,`/*.`+e)),i=o.sync(r).filter(e=>e.includes(`.entry.`)).filter(e=>!e.includes(`.d.ts`));return[...e,...i]},[]),r={};if(!e.length)return r;(0,i.rmSync)(x,{recursive:!0,force:!0}),(0,i.mkdirSync)(x,{recursive:!0});let s=(0,i.readFileSync)(a.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);for(let t=0;t<e.length;t++){let n=e[t],i=a.default.resolve(n,`../`),o=M(i,a.default.basename(n).replace(/\.entry\.[^.]+$/,``)),c=o?a.default.basename(o,`.html`):i.split(a.default.sep).at(-1);r[c]=F(s,n,c,o?j(o):T())}return r}function L(){let e=r.buildFESharedState.options.output??`frame`;return e!==`frame`&&t.logRed(`Please pay attention to the build output.`),e===`run`?a.default.join(v,`./app/public/dist`):typeof e==`function`?e():a.default.join(g,`./app/public/dist`)}var R=async e=>{let n=(await import(`chokidar`)).watch(y,{ignored:/(^|[\/\\])\../,persistent:!0,ignoreInitial:!0}),r=!1;n.on(`change`,async n=>{if(!r){r=!0,t.logYellow(`changed: ${n}`);try{await e?.()}catch(e){t.logRed(e)}finally{r=!1}}}),t.logYellow(`watching ${y}/...`)};function z(){return{name:`flatten-html`,apply:`build`,closeBundle(){let e=L(),t=P();(0,i.writeFileSync)(n.resolve(e,`./FEBuildKey`),t)}}}function B(e=`.html`){let n=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=L();if(!(0,i.existsSync)(e))return;let s=r.buildFESharedState.options.minifyHtml??!1,c=o.sync(`**/*.html`,{cwd:e,dot:!0});for(let t of c){let r=a.default.join(e,t),o=(0,i.readFileSync)(r,`utf-8`),c=s?D(o):o,l=a.default.basename(t,`.html`),u=`.entry`;l.indexOf(u)===-1&&(l+=u);for(let t of n){let n=l+t,o=a.default.join(e,n);r===o?s&&(0,i.writeFileSync)(o,c):(0,i.writeFileSync)(o,c)}n.some(t=>r===a.default.join(e,l+t))||(0,i.unlinkSync)(r)}let l=[...new Set(c.map(e=>a.default.dirname(e)))].sort().reverse(),u=e=>{if(!((0,i.existsSync)(e)?(0,i.readdirSync)(e):[1]).length){(0,i.rmdirSync)(e);let t=e.split(a.default.sep).slice(0,-1);t.length&&u(t.join(a.default.sep))}};for(let t of l)t&&t!==`.`&&u(a.default.join(e,t));let d=n.flatMap(t=>o.sync(`**/*`+t,{cwd:e,dot:!0}));for(let e of d)t.logYellow(`final file path -----> `+e)}}}function V(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,o=y,s=`./defaultAlias`])=>{let c=t.map(e=>a.default.resolve(o,r+e)).find(e=>(0,i.existsSync)(e)),l=a.default.resolve(f,s);return c&&(l=c),e[n]=l,e},{})}var H=(...e)=>new RegExp(e.join(`[\\/]`)),U=e=>`_${e}_tcC`,W=async(e,n)=>{try{await(0,s.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),B([`.tpl`]),z(),(0,c.default)()],build:{outDir:L(),emptyOutDir:!0,sourcemap:n===`dev`?`inline`:`hidden`,rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:U(`__nm`),test:H(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:U(`r`),test:H(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:U(`r-d`),test:H(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:U(`r-r-d`),test:H(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:U(`ajv`),test:H(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:U(`ui-lib`),test:H(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:U(`ui-f-lib`),test:H(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react/hooks":a.default.resolve(f,`../../fe/packages/react/hooks/`),"@tc/ui-react":a.default.resolve(f,`../../fe/packages/react/ui/`),...V([[`@tc/scalability/SchemaForm/frameData`,`./extended/SchemaForm/data`,_],[`@tc/scalability/SchemaForm/data`,`./extended/SchemaForm/data`],[`@tc/scalability/SchemaPage/CallCom/data`,`./extended/SchemaPage/CallCom/data`],[`@tc/scalability/SchemaPage/SchemaTable/data`,`./extended/SchemaPage/SchemaTable/data`],[`@tc/scalability/dash/customRoutes`,`./extended/dash/customRoutes`],[`@tc/scalability/dash/init`,`./extended/dash/init`],[`@tc/scalability/dash/components`,`./extended/dash/components`],[`@tc/scalability/dash/routeGuard`,`./extended/dash/routeGuard`,void 0,`./defaultRouteGuard`]])}}}),t.logJoinColorized(t.colorize(`builded`,`green`),t.colorize(` -> `,`white`),t.colorize(`time: `,`cyan`),t.colorize(new Date,`pink`))}catch(e){if(t.logRed(e),n!==`dev`)throw e}};exports.VBuildFE=W,exports.entries=I,exports.generateBuildKeyPlugin=z,exports.outDir=L,exports.watchFiles=R;