@_tc/template-core 0.0.1-bate.59 → 0.0.1-bate.60

package/.skills/tc-component-usage-skills/reference/template-core-frontend.md

@@ -6,10 +6,12 @@ Use these when building business UI on top of TemplateCore, especially Dashboard
 
 ```tsx
 import { AsyncSelect, LanguageSwitch, ThemeSwitch } from '@_tc/template-core/fe'
+import { api, get, post, request } from '@_tc/template-core/fe/common/request'
+import type { BaseResponse, RequestConfig, ResponseConfig } from '@_tc/template-core/fe/common/request'
 import { Button, DataTable, TableSearch } from '@_tc/template-core/fe/rc'
 ```
 
-Inside this repository, use `@tc/ui-react` for the raw UI workspace package. In published business projects, prefer `@_tc/template-core/fe/rc` for UI components and `@_tc/template-core/fe` for frontend runtime helpers.
+Inside this repository, use `@tc/ui-react` for the raw UI workspace package. In published business projects, prefer `@_tc/template-core/fe/rc` for UI components, `@_tc/template-core/fe` for frontend runtime helpers, and `@_tc/template-core/fe/common/request` when only the request layer is needed.
 
 ## LanguageSwitch
 

package/.skills/tc-generator/reference/runtime-extensions.md

@@ -239,6 +239,16 @@ Import TemplateCore frontend helpers from `@_tc/template-core/fe`:
 import { AsyncSelect, LanguageSwitch, ThemeSwitch } from '@_tc/template-core/fe'
 ```
 
+Request helpers and request types are available from the root frontend entry or the explicit request subpath:
+
+```ts
+import { api, get, post, request } from '@_tc/template-core/fe'
+import type { BaseResponse, RequestConfig, ResponseConfig } from '@_tc/template-core/fe'
+
+import { api as requestApi } from '@_tc/template-core/fe/common/request'
+import type { BaseResponse as ApiResponse } from '@_tc/template-core/fe/common/request'
+```
+
 Import UI components from the published UI re-export:
 
 ```tsx

package/AGENT_README.md

@@ -19,6 +19,7 @@ TemplateCore 是一个 TypeScript + Koa + React 的后台框架包。它提供
 | `@_tc/template-core` | `serverStart`、`baseFn`、Koa/Controller/Service 类型。 |
 | `@_tc/template-core/bundler` | `buildFE()`、`buildBE()`。 |
 | `@_tc/template-core/fe` | 前端初始化、请求方法、Dashboard/Schema 类型、共享状态、业务前端组件。 |
+| `@_tc/template-core/fe/common/request` | 请求实例、请求方法和请求类型的显式子路径。 |
 | `@_tc/template-core/fe/rc` | React UI 组件和 SchemaForm 组件。 |
 | `@_tc/template-core/fe/tailwind_ui.css` | 内置前端/UI 全局样式。 |
 | `@_tc/template-core/model` | `ModelDataType` 等 model 配置类型。 |
@@ -365,6 +366,7 @@ import '@_tc/template-core/fe/tailwind_ui.css'
 
 ```ts
 import {
+  api,
   get,
   post,
   request,
@@ -374,6 +376,19 @@ import {
   LanguageSwitch,
   ThemeSwitch,
 } from '@_tc/template-core/fe'
+
+import type {
+  BaseResponse,
+  RequestConfig,
+  ResponseConfig,
+} from '@_tc/template-core/fe'
+```
+
+只需要请求层时，可以走显式子路径：
+
+```ts
+import { api, get, post, request } from '@_tc/template-core/fe/common/request'
+import type { BaseResponse, RequestConfig, ResponseConfig } from '@_tc/template-core/fe/common/request'
 ```
 
 UI 组件从 `@_tc/template-core/fe/rc` 导入：
@@ -384,7 +399,8 @@ import { Button, DataTable, Form, Input, Modal, Select } from '@_tc/template-cor
 
 常用前端能力：
 
-- 请求方法：`request`、`get`、`post`、`put`、`patch`、`del`。
+- 请求方法：`api`、`request`、`get`、`post`、`put`、`patch`、`del`。
+- 请求类型：`BaseResponse`、`PageParams`、`PageResponse`、`RequestConfig`、`ResponseConfig`、`AxiosError`。
 - 请求 header：自动添加 `s_t`、`s_sign`、`projk`；存在短 token 时添加 `Authorization: Bearer ${token}`。
 - 本地 key：短 token 是 `localStorage.auth_token`，项目 key 是 `localStorage.p_J_k`；刷新 token header 默认名是 `RT`。
 - `getAuthToken()` 是同步函数，读取前无需 `await`。
@@ -413,6 +429,12 @@ const AdminApp = ({ children }: { children: ReactNode }) => (
 
 initApp(AdminApp, {
   initModeData: false,
+  beforeRender: async () => {
+    // 注册请求拦截器等渲染前初始化逻辑
+  },
+  afterRender: () => {
+    // 首次渲染提交后的逻辑
+  },
 })
 ```
 
@@ -586,9 +608,11 @@ chokidar
 
 1. SchemaForm 字段类型、CallCom 组件、Koa app 类型都支持 TypeScript 声明合并。
 2. 运行时组件通常放在业务 `frontend/extended/`。
-3. Dashboard 扩展点包括 `frontend/extended/dash/customRoutes.tsx`、`frontend/extended/dash/components.tsx`、`frontend/extended/dash/routeGuard.ts`。
-4. `dash/routeGuard` 用来判断登录。返回登录页 URL 字符串时，Dashboard 用 `window.location.href` 跳转；`DashRouteGuardResult` 是 `string | undefined`，`undefined`（包括已登录分支的隐式返回）会打断 Dashboard 内置重定向，业务方可自行跳转。
-5. 优先查看公开入口 `.d.ts` 和 npm 包根目录 `README.md`；如果当前环境是源码仓库，再继续读 `docs/type-extension.md` 和 `docs/schema-form.md`。
+3. Dashboard 扩展点包括 `frontend/extended/dash/init.ts`、`frontend/extended/dash/customRoutes.tsx`、`frontend/extended/dash/components.tsx`、`frontend/extended/dash/routeGuard.ts`。
+4. `dash/init` 在 React 渲染前执行，适合注册 axios 拦截器等全局初始化逻辑；类型是 `DashInit`。
+5. `dash/routeGuard` 用来判断登录。返回登录页 URL 字符串时，Dashboard 用 `window.location.href` 跳转；`DashRouteGuardResult` 是 `string | undefined`，`undefined`（包括已登录分支的隐式返回）会打断 Dashboard 内置重定向，业务方可自行跳转。
+6. 自定义入口的 `initApp` 支持 `beforeRender` / `afterRender`，分别在 React 渲染前和首次渲染提交后触发。
+7. 优先查看公开入口 `.d.ts` 和 npm 包根目录 `README.md`；如果当前环境是源码仓库，再继续读 `docs/type-extension.md` 和 `docs/schema-form.md`。
 
 ## 8. 继续深入
 

package/README.md

@@ -189,7 +189,7 @@ http://localhost:9000/dash?projk=demo
 | `Ctx` | Controller、middleware、router handler 的 Koa 请求上下文类型，包含框架补充的 `ctx.params` 和可选 `ctx.reqData`。 |
 | `ControllerFN` | `app/controller/*.ts` 默认导出工厂函数的约束类型，适合配合 `satisfies ControllerFN` 保留 controller 实例方法类型。 |
 | `ServiceFN` | `app/service/*.ts` 默认导出工厂函数的约束类型，适合配合 `satisfies ServiceFN` 约束 service class 工厂。 |
-| `MiddlewareFN` | `app/middleware/*.ts` 默认导出工厂函数的约束类型，返回标准 Koa middleware。 |
+| `MiddlewareFN` | `app/middlewares/*.ts` 默认导出工厂函数的约束类型，返回标准 Koa middleware。 |
 | `RouterFN` | `app/router/*.ts` 默认导出函数的约束类型，用于接收 `app` 和 `router` 并注册路由。 |
 
 示例：
@@ -301,6 +301,7 @@ VS Code 建议安装官方 Tailwind CSS IntelliSense 插件，并在工作区 `.
 
 ```ts
 import {
+  api,
   apiFreezerStore,
   AsyncSelect,
   eventsInfo,
@@ -320,6 +321,7 @@ import {
 } from '@_tc/template-core/fe'
 
 import type {
+  BaseResponse,
   CallComComponentsMap,
   CallComRenderer,
   DashComponentsMap,
@@ -327,6 +329,10 @@ import type {
   DashRoutesExtender,
   FormFieldSchema,
   ApiFreezerRequestMatcher,
+  PageParams,
+  PageResponse,
+  RequestConfig,
+  ResponseConfig,
   SchemaFormComponentsMap,
   SchemaFormNamespace,
   SelectProps,
@@ -342,13 +348,16 @@ import type {
 | Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext`、`DashComponentsMap`、`DashHeaderUserAreaProps`、`DashRouteGuard` |
 | SchemaPage 类型 | `CallComComponentsMap`、`CallComRenderer` |
 | SchemaForm 类型 | `FormFieldSchema`、`SchemaFormComponentsMap`、`SchemaFormNamespace`、`SelectProps` |
-| 请求方法 | `request`、`get`、`post`、`put`、`patch`、`del` |
+| 请求方法 | `api`、`request`、`get`、`post`、`put`、`patch`、`del` |
+| 请求类型 | `BaseResponse`、`PageParams`、`PageResponse`、`RequestConfig`、`ResponseConfig`、`AxiosError` |
 | 请求冻结 | `apiFreezerStore`、`useApiFreezer`、`FreezeState`、`ApiFreezerRequestMatcher` |
 | 事件工具 | `eventsInfo`、`merge` |
 | 共享状态 | `modeStore`、`useModeStore`、`schemaStore`、`useSchemaStore`、`schemaEventBus` |
 
 `modeStore` 管项目模型和当前项目数据，`schemaStore` 管当前 Schema 页面的 schema/cache，`schemaEventBus` 用来在 Search、Table、CallCom 之间通信。
 
+只使用请求层时，也可以从 `@_tc/template-core/fe/common/request` 导入 `api`、请求方法和请求类型；这是发布包显式子路径，不要下钻到 `frontend/src/common/request`。
+
 ### 前端多语言
 
 TemplateCore 前端通过 `@_tc/template-core/fe` 暴露 i18n 能力。框架内置中文、英文资源，项目可以继续追加自己的资源。
@@ -538,7 +547,8 @@ export function Toolbar() {
 **使用示例**：
 
 ```ts
-import { get, post, put, del } from '@_tc/template-core/fe'
+import { api, get, post, put, del } from '@_tc/template-core/fe'
+import type { BaseResponse, RequestConfig, ResponseConfig } from '@_tc/template-core/fe'
 
 // GET 请求
 const data = await get('/product/list', { page: 1, pageSize: 10 })
@@ -553,6 +563,22 @@ await put('/product', { id: 1, name: '新名称' })
 await del('/product', { id: 1 })
 ```
 
+如果希望把请求能力单独拆出来导入：
+
+```ts
+import {
+  api,
+  get,
+  post,
+  request,
+} from '@_tc/template-core/fe/common/request'
+import type {
+  BaseResponse,
+  RequestConfig,
+  ResponseConfig,
+} from '@_tc/template-core/fe/common/request'
+```
+
 **请求冻结器**：
 
 请求冻结器用于在某段流程中暂停普通 API 请求，典型场景是 RT 刷新 token：刷新期间冻结其它请求，刷新接口本身走白名单放行，刷新完成后再解冻并回放队列。
@@ -708,7 +734,7 @@ function MyComponent() {
 ```text
 app/controller/**/*.(js|ts)      -> app.controller
 app/service/**/*.(js|ts)         -> app.service
-app/middleware/**/*.(js|ts)      -> app.middlewares
+app/middlewares/**/*.(js|ts)     -> app.middlewares
 app/middleware.(js|ts)           -> 全局中间件编排，按框架 -> 项目顺序执行
 app/router/**/*.(js|ts)          -> Koa router
 app/router-schema/**/*.(js|ts)   -> app.routerSchema

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`,`.html`]),(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/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;
+`))},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`,`.html`]),(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;

package/esm/bundler/utils.js

@@ -228,6 +228,7 @@ var Y = (...e) => new RegExp(e.join("[\\/]")), X = (e) => `_${e}_tcC`, Z = async
 					["@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",

package/fe/frontend/apps/dash/dash.entry.js

@@ -50,5 +50,10 @@ var getDefaultPageRoutes = () => {
 initApp(({ children }) => /* @__PURE__ */ jsx("div", {
 	className: "dash",
 	children
-}), { routes: getDefaultPageRoutes() });
+}), {
+	routes: getDefaultPageRoutes(),
+	beforeRender: async (context) => {
+		if (typeof defaultAlias_default === "function") await defaultAlias_default(context);
+	}
+});
 //#endregion

package/fe/frontend/apps/dash/types.d.ts

@@ -1,11 +1,13 @@
 import type { ProjectInfo } from "../../src/api/baseInfo";
 import type { RouteInfo } from "../../src/components/Router";
+import type { InitAppHook } from "../../src/main";
 import type { ComponentType, LazyExoticComponent } from "react";
 export type DashRoutesContext = {
     topRoutes: RouteInfo[];
     sidebarRoutes: RouteInfo[];
 };
 export type DashRoutesExtender = (context: DashRoutesContext) => void;
+export type DashInit = InitAppHook;
 export type DashHeaderUserAreaProps = {
     projectInfo: ProjectInfo | null;
 };

package/fe/frontend/src/index.d.ts

@@ -4,7 +4,8 @@ export * from "./main";
 export type { CallComComponentsMap, CallComRenderer } from "./defaultPages/SchemaPage/schemaType";
 export * from "./components/index";
 export type { FormFieldSchema, SchemaFormComponentsMap, SchemaFormNamespace, SelectProps } from "../../packages/react/ui/index";
-export { del, get, patch, post, put, request } from "./common/request";
+export { api, del, get, patch, post, put, request } from "./common/request";
+export type { AxiosError, BaseResponse, PageParams, PageResponse, RequestConfig, ResponseConfig } from "./common/request";
 export * from "./defaultPages/SchemaPage/data/eventInfo";
 export { merge } from "./defaultPages/SchemaPage/utils/permissions";
 export * from "./exportStore";

package/fe/frontend/src/index.js

@@ -2,7 +2,7 @@ import { getAuthToken, localKeyMap, setAuthToken } from "./common/auth/index.js"
 import { i18n, i18nStore } from "../../packages/common/i18n/index.js";
 import "../../packages/react/ui/i18n/index.js";
 import { FreezeState, apiFreezerStore, useApiFreezer } from "./stores/apiFreezer.js";
-import { del, get, patch, post, put, request } from "./common/request.js";
+import { api, del, get, patch, post, put, request } from "./common/request.js";
 import { modeStore, useModeStore } from "./stores/mode.js";
 import HeaderView from "./components/BasePage/HeaderView.js";
 import { generateRouter } from "./components/Router/index.js";
@@ -17,4 +17,4 @@ import ThemeSwitch_default from "./components/ThemeSwitch/index.js";
 import "./components/index.js";
 import { eventsInfo } from "./defaultPages/SchemaPage/data/eventInfo.js";
 import { merge } from "./defaultPages/SchemaPage/utils/permissions.js";
-export { AsyncSelect_default as AsyncSelect, FreezeState, HeaderView, LanguageSwitch_default as LanguageSwitch, ThemeSwitch_default as ThemeSwitch, apiFreezerStore, del, eventsInfo, generateRouter, get, getAuthToken, i18n, i18nStore, initApp, localKeyMap, merge, modeStore, patch, post, put, request, schemaEventBus, schemaStore, setAuthToken, themeSwitchStorageKey, useApiFreezer, useModeStore, useSchemaStore };
+export { AsyncSelect_default as AsyncSelect, FreezeState, HeaderView, LanguageSwitch_default as LanguageSwitch, ThemeSwitch_default as ThemeSwitch, api, apiFreezerStore, del, eventsInfo, generateRouter, get, getAuthToken, i18n, i18nStore, initApp, localKeyMap, merge, modeStore, patch, post, put, request, schemaEventBus, schemaStore, setAuthToken, themeSwitchStorageKey, useApiFreezer, useModeStore, useSchemaStore };

package/fe/frontend/src/main.d.ts

@@ -4,11 +4,17 @@ import { RouterType } from "./components/Router/type";
 import { type ReactNode } from "react";
 import "./main.css";
 import "./typing/window";
+export type InitAppHookContext = {
+    rootElement: HTMLElement;
+};
+export type InitAppHook = (context: InitAppHookContext) => void | Promise<void>;
 export declare const initApp: (RootComponent: (props: {
     children: Exclude<ReactNode, null | undefined>;
 }) => JSX.Element, options?: {
     routes?: RouteInfo[];
     routerType?: RouterType;
     modelType?: string;
+    beforeRender?: InitAppHook;
+    afterRender?: InitAppHook;
     initModeData?: boolean;
 }) => void;

package/fe/frontend/src/main.js

@@ -4,7 +4,8 @@ import { renderImportComponent } from "./common/importComponent.js";
 import { generateRouter } from "./components/Router/index.js";
 import "./exportStore.js";
 /* empty css      */
-import { Fragment, jsx } from "react/jsx-runtime";
+import { useEffect } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 import { createRoot } from "react-dom/client";
 //#region frontend/src/main.tsx
 var renderRouter = async ({ routerDom, requestModelData }) => {
@@ -40,21 +41,37 @@ var renderRouter = async ({ routerDom, requestModelData }) => {
 			}, fail);
 		});
 	}
-	return { default: () => /* @__PURE__ */ jsx(Fragment, { children: routerDom }) };
+	return { default: () => /* @__PURE__ */ jsx(Fragment$1, { children: routerDom }) };
+};
+var AppLifecycle = ({ children, hookContext, afterRender }) => {
+	useEffect(() => {
+		afterRender?.(hookContext);
+	}, [afterRender, hookContext]);
+	return /* @__PURE__ */ jsx(Fragment$1, { children });
 };
 var initApp = (RootComponent, options) => {
 	console.log("initApp");
-	const root = createRoot(document.getElementById("root"));
-	const { routerType = "browser", routes: pRoutes = [], initModeData = true, modelType = "MD" } = options ?? {};
-	const routes = [...pRoutes];
-	const usedRouter = !!routes.length;
-	let routerDom;
-	if (usedRouter) routerDom = generateRouter(routes, routerType);
-	const Component = renderImportComponent(renderRouter({
-		routerDom,
-		requestModelData: initModeData || modelType === "MD"
-	}));
-	root.render(/* @__PURE__ */ jsx(RootComponent, { children: Component }));
+	const bootstrap = async () => {
+		const rootElement = document.getElementById("root");
+		const root = createRoot(rootElement);
+		const { routerType = "browser", routes: pRoutes = [], initModeData = true, modelType = "MD", beforeRender, afterRender } = options ?? {};
+		const routes = [...pRoutes];
+		const usedRouter = !!routes.length;
+		let routerDom;
+		if (usedRouter) routerDom = generateRouter(routes, routerType);
+		const hookContext = { rootElement };
+		await beforeRender?.(hookContext);
+		const Component = renderImportComponent(renderRouter({
+			routerDom,
+			requestModelData: initModeData || modelType === "MD"
+		}));
+		root.render(/* @__PURE__ */ jsx(AppLifecycle, {
+			hookContext,
+			afterRender,
+			children: /* @__PURE__ */ jsx(RootComponent, { children: Component })
+		}));
+	};
+	bootstrap();
 };
 //#endregion
 export { initApp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.0.1-bate.59",
+  "version": "0.0.1-bate.60",
   "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
   "types": "./types/index.d.ts",
   "exports": {
@@ -24,6 +24,11 @@
       "require": "./fe/frontend/src/index.js",
       "types": "./fe/frontend/src/index.d.ts"
     },
+    "./fe/common/request": {
+      "import": "./fe/frontend/src/common/request.js",
+      "require": "./fe/frontend/src/common/request.js",
+      "types": "./fe/frontend/src/common/request.d.ts"
+    },
     "./fe/rc": {
       "import": "./fe/packages/react/ui/index.js",
       "require": "./fe/packages/react/ui/index.js",

package/types/packages/core/loader/middleware.d.ts

@@ -5,7 +5,7 @@ import type { KoaApp } from "../types";
  *
  * @param app
  *
- *  加载 xx/app/middleware 文件夹下所有文件，可通过 'app.middleware.${目录}.${文件}' 访问
+ *  加载 xx/app/middlewares 文件夹下所有文件，可通过 'app.middlewares.${目录}.${文件}' 访问
  */
 declare const _default: (app: KoaApp) => void;
 export default _default;