@_tc/template-core 0.1.12 → 0.1.14

package/README.md

@@ -157,7 +157,7 @@ http://localhost:9000/dash?projk=demo
 | --- | --- |
 | `@_tc/template-core` | 服务启动、基础 Controller/Service、Koa 类型 |
 | `@_tc/template-core/bundler` | 前端构建函数 `buildFE` |
-| `@_tc/template-core/fe` | 前端初始化、Dash 路由扩展、请求方法、SchemaPage 事件和共享状态 |
+| `@_tc/template-core/fe` | 前端初始化、Dash 路由扩展、请求方法、SchemaPage 事件、共享状态和内置前端组件 |
 | `@_tc/template-core/fe/rc` | UI/SchemaForm 组件和类型 |
 | `@_tc/template-core/fe/tailwind_ui.css` | 前端全局样式入口，源码对应 `frontend/src/main.css` |
 | `@_tc/template-core/model` | model 配置类型 |
@@ -241,15 +241,18 @@ VS Code 建议安装官方 Tailwind CSS IntelliSense 插件，并在工作区 `.
 ```ts
 import {
   apiFreezerStore,
+  AsyncSelect,
   eventsInfo,
   FreezeState,
   get,
+  LanguageSwitch,
   merge,
   modeStore,
   post,
   request,
   schemaEventBus,
   schemaStore,
+  ThemeSwitch,
   useApiFreezer,
   useModeStore,
   useSchemaStore,
@@ -258,6 +261,7 @@ import {
 import type {
   CallComComponentsMap,
   CallComRenderer,
+  DashComponentsMap,
   DashRoutesExtender,
   FormFieldSchema,
   ApiFreezerRequestMatcher,
@@ -272,7 +276,8 @@ import type {
 | 类型 | 导出内容 |
 | --- | --- |
 | 应用启动 | `initApp` |
-| Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext` |
+| 内置前端组件 | `AsyncSelect`、`LanguageSwitch`、`ThemeSwitch` |
+| Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext`、`DashComponentsMap`、`DashHeaderUserAreaProps` |
 | SchemaPage 类型 | `CallComComponentsMap`、`CallComRenderer` |
 | SchemaForm 类型 | `FormFieldSchema`、`SchemaFormComponentsMap`、`SchemaFormNamespace`、`SelectProps` |
 | 请求方法 | `request`、`get`、`post`、`put`、`patch`、`del` |
@@ -383,6 +388,18 @@ i18nStore.getState().setLanguage('zh-CN')
 
 默认会写入 localStorage，key 是 `tc_language`。刷新页面后会继续使用上次语言。
 
+项目页面可以直接使用语言选择组件：
+
+```tsx
+import { LanguageSwitch } from '@_tc/template-core/fe'
+
+export function Toolbar() {
+  return <LanguageSwitch />
+}
+```
+
+`LanguageSwitch` 默认提供 `zh-CN` 和 `en-US`，也支持传入 `options` 覆盖语言列表。组件内部会调用 `i18nStore.getState().setLanguage()`，因此会沿用 `tc_language` 的持久化行为。
+
 **AJV 校验文案**：
 
 Schema 表单校验会把 AJV keyword 映射到内置语言 key，覆盖 `required`、`type`、`format`、`minimum`、`maximum`、`minLength`、`maxLength`、`pattern`、`enum`、`oneOf`、`anyOf` 等常见规则。
@@ -395,6 +412,30 @@ Schema 表单校验会把 AJV keyword 映射到内置语言 key，覆盖 `requir
 2. `frontend/src/language/zh-CN.ts` 和 `frontend/src/language/en-US.ts` 文案。
 3. `frontend/src/language/index.ts` 的 `frontendLangKeys`。
 
+### 前端主题切换
+
+项目页面可以使用 `ThemeSwitch` 切换浅色和深色模式：
+
+```tsx
+import { ThemeSwitch } from '@_tc/template-core/fe'
+
+export function Toolbar() {
+  return <ThemeSwitch />
+}
+```
+
+`ThemeSwitch` 会切换 `document.documentElement` 上的 `dark` class，并同步 `color-scheme`。默认写入 localStorage，key 是 `tc_theme`。刷新页面后会优先读取本地主题；没有本地主题时，读取当前根节点是否已有 `dark` class。
+
+常用参数：
+
+| 参数 | 说明 |
+| --- | --- |
+| `value` / `onChange` | 受控模式，值为 `light` 或 `dark`。 |
+| `defaultValue` | 非受控初始主题。 |
+| `showLabel` | 是否展示当前主题文本。 |
+| `persist` | 是否写入 localStorage，默认 `true`。 |
+| `storageKey` | 自定义本地存储 key，默认 `tc_theme`。 |
+
 ### 前端请求封装详解
 
 框架内置的请求封装基于 `@tc/common/http`，底层使用原生 `fetch` API，实现了类似 Axios 的接口和拦截器机制，提供了签名、鉴权、错误处理等能力。
@@ -614,6 +655,159 @@ model/**/*.(js|ts)               -> 项目模型配置
 内置扩展：
 
 - `app.extends.$fetch`：Node 侧基于 `fetch` 的 axios 风格请求实例，支持 `get/post/put/patch/delete` 和 `create(config)`。
+- `app.extends.db`：默认 SQLite 框架数据库，提供 `getDBData/setDBData` 等通用数据方法。
+
+### 数据库扩展
+
+默认 `app.extends.db` 使用 SQLite 保存数据，数据库文件位于项目根目录 `.template-core/template-core.sqlite`。可以在配置中调整路径：
+
+```ts
+// config/config.default.ts
+export default {
+  db: {
+    path: 'data/app.sqlite',
+  },
+}
+```
+
+Controller 中使用：
+
+```ts
+import { baseFn, type ControllerFN, type Ctx } from '@_tc/template-core'
+
+const getSettingController = ((app) => {
+  const BaseController = baseFn.baseControllerFn(app)
+
+  return class SettingController extends BaseController {
+    detail = async (ctx: Ctx) => {
+      const data = app.extends.db.getDBData('site-setting', {
+        namespace: 'setting',
+      })
+
+      this.success(ctx, data ?? {})
+    }
+
+    save = async (ctx: Ctx) => {
+      app.extends.db.setDBData('site-setting', ctx.request.body, {
+        namespace: 'setting',
+      })
+
+      this.success(ctx, true)
+    }
+  }
+}) satisfies ControllerFN
+
+export default getSettingController
+```
+
+常用方法：
+
+- `getDBData(key, options)`：读取 JSON 数据。
+- `setDBData(key, value, options)`：写入 JSON 数据。
+- `hasDBData(key, options)`：判断数据是否存在。
+- `deleteDBData(key, options)`：删除单条数据。
+- `listDBData(options)`：分页列出当前 namespace 下的数据。
+- `countDBData(options)` / `clearDBData(options)`：统计和清空当前 namespace。
+- `queryDB(sql, params)` / `runDB(sql, params)`：直接执行 SQLite SQL。
+- `transactionDB(handler)`：事务执行。
+- `closeDB()`：关闭连接。
+
+SQL 注入边界：
+
+- `getDBData`、`setDBData`、`deleteDBData`、`listDBData` 这类通用方法内部使用参数绑定，不需要手写 SQL。
+- `queryDB`、`runDB`、`getDBFirst` 是原始 SQL 入口，用户输入必须放到 `params`，不要拼接到 SQL 字符串里。
+- `execDB` 没有参数绑定能力，只建议用于固定 SQL，例如建表或迁移。
+
+```ts
+// 推荐：参数绑定
+const users = app.extends.db.queryDB(
+  'SELECT * FROM user WHERE name = ?',
+  [ctx.query.name as string]
+)
+
+// 不推荐：拼接用户输入，有 SQL 注入风险
+const unsafeUsers = app.extends.db.queryDB(
+  `SELECT * FROM user WHERE name = '${ctx.query.name}'`
+)
+```
+
+业务项目可以用自己的 `app/extend/db.ts` 覆盖默认实现。建议保留同一组方法名，这样 controller/service 调用方不用调整。
+
+```ts
+// app/extend/db.ts
+import type { DB, DBFactory } from '@_tc/template-core'
+
+interface DataOptions {
+  namespace?: string
+}
+
+const store = new Map<string, unknown>()
+
+const getDB = ((_app) => {
+  const toKey = (key: string, namespace = 'framework') => `${namespace}:${key}`
+
+  const db = {
+    dbPath: 'memory',
+    getDBConnection: () => {
+      throw new Error('memory db 没有底层 SQLite connection')
+    },
+    execDB: () => undefined,
+    runDB: () => ({ changes: 0, lastInsertRowid: 0 }),
+    queryDB: <T extends object = Record<string, unknown>>() => [] as T[],
+    getDBFirst: <T extends object = Record<string, unknown>>() => undefined as T | undefined,
+    transactionDB: <T>(handler: (db: DB) => T) => handler(db),
+    getDBData: <T = unknown>(key: string, options?: DataOptions) => {
+      return store.get(toKey(key, options?.namespace)) as T | undefined
+    },
+    getDBDataRecord: <T = unknown>(key: string, options?: DataOptions) => {
+      const value = store.get(toKey(key, options?.namespace)) as T | undefined
+      if (value === undefined) return undefined
+
+      return {
+        key,
+        value,
+        namespace: options?.namespace ?? 'framework',
+        createdAt: '',
+        updatedAt: '',
+      }
+    },
+    setDBData: <T = unknown>(key: string, value: T, options?: DataOptions) => {
+      store.set(toKey(key, options?.namespace), value)
+      return { changes: 1, lastInsertRowid: 0 }
+    },
+    hasDBData: (key: string, options?: DataOptions) => {
+      return store.has(toKey(key, options?.namespace))
+    },
+    deleteDBData: (key: string, options?: DataOptions) => {
+      return store.delete(toKey(key, options?.namespace))
+    },
+    listDBData: <T = unknown>(options?: DataOptions) => {
+      const namespace = options?.namespace ?? 'framework'
+
+      return Array.from(store.entries())
+        .filter(([key]) => key.startsWith(`${namespace}:`))
+        .map(([key, value]) => ({
+          key: key.slice(namespace.length + 1),
+          value: value as T,
+          namespace,
+          createdAt: '',
+          updatedAt: '',
+        }))
+    },
+    countDBData: () => store.size,
+    clearDBData: () => {
+      const size = store.size
+      store.clear()
+      return size
+    },
+    closeDB: () => undefined,
+  } satisfies DB
+
+  return db
+}) satisfies DBFactory
+
+export default getDB
+```
 
 Controller 示例：
 
@@ -926,6 +1120,27 @@ DELETE {api}        -> 删除
 
 ## 如何扩展组件
 
+### 扩展 Dashboard 顶部用户区域
+
+业务项目可以创建 `frontend/extended/dash/components.tsx`，通过组件映射填充内置 Dashboard 页头右侧区域。
+
+```tsx
+// frontend/extended/dash/components.tsx
+import type { DashComponentsMap } from '@_tc/template-core/fe'
+
+const components = {
+  'HeaderView.userArea': ({ projectInfo }) => {
+    return <div>{projectInfo?.name}</div>
+  },
+} satisfies DashComponentsMap
+
+export default components
+```
+
+当前支持的 Dashboard 组件扩展槽位：
+
+- `HeaderView.userArea`：Dashboard 顶部右侧区域。
+
 ### 扩展 SchemaForm 字段组件
 
 1. 声明字段类型。

package/cjs/app/extend/db.js

@@ -1 +1,20 @@
-async function e(e){return console.log(e),{}}module.exports=e;
+require(`../../_virtual/_rolldown/runtime.js`);let e=require(`node:fs`),t=require(`node:path`);var n=`framework`,r=`.template-core/template-core.sqlite`;function i(n){let r=s(n),i,c=!1,l=0,g=()=>(v(c),i||((0,e.mkdirSync)((0,t.dirname)(r),{recursive:!0}),i=a(r),o(i)),i),y={dbPath:r,getDBConnection:g,execDB:e=>{g().exec(e)},runDB:(e,t)=>{let n=g().prepare(e).run(...u(t));return{changes:Number(n.changes??0),lastInsertRowid:n.lastInsertRowid??0}},queryDB:(e,t)=>g().prepare(e).all(...u(t)),getDBFirst:(e,t)=>g().prepare(e).get(...u(t)),transactionDB:e=>{let t=g(),n=`tc_savepoint_${l}`,r=l===0;t.exec(r?`BEGIN IMMEDIATE`:`SAVEPOINT ${n}`),l+=1;try{let i=e(y);return--l,t.exec(r?`COMMIT`:`RELEASE SAVEPOINT ${n}`),i}catch(e){throw--l,t.exec(r?`ROLLBACK`:`ROLLBACK TO SAVEPOINT ${n}`),r||t.exec(`RELEASE SAVEPOINT ${n}`),e}},getDBData:(e,t)=>y.getDBDataRecord(e,t)?.value,getDBDataRecord:(e,t)=>{let n=y.getDBFirst(`SELECT namespace, data_key, data_value, created_at, updated_at FROM tc_framework_data WHERE namespace = ? AND data_key = ? LIMIT 1`,[d(t?.namespace),f(e)]);return n?_(n):void 0},setDBData:(e,t,n)=>{let r=new Date().toISOString();return y.runDB(`INSERT INTO tc_framework_data (namespace, data_key, data_value, created_at, updated_at)
+                 VALUES (?, ?, ?, ?, ?)
+                 ON CONFLICT(namespace, data_key) DO UPDATE SET
+                    data_value = excluded.data_value,
+                    updated_at = excluded.updated_at`,[d(n?.namespace),f(e),h(t),r,r])},hasDBData:(e,t)=>!!y.getDBFirst(`SELECT 1 AS exists_value FROM tc_framework_data WHERE namespace = ? AND data_key = ? LIMIT 1`,[d(t?.namespace),f(e)]),deleteDBData:(e,t)=>y.runDB(`DELETE FROM tc_framework_data WHERE namespace = ? AND data_key = ?`,[d(t?.namespace),f(e)]).changes>0,listDBData:e=>{let t=p(e?.limit),n=m(e?.offset);return y.queryDB(`SELECT namespace, data_key, data_value, created_at, updated_at
+                 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(`
+        CREATE TABLE IF NOT EXISTS tc_framework_data (
+            namespace TEXT NOT NULL,
+            data_key TEXT NOT NULL,
+            data_value TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            updated_at TEXT NOT NULL,
+            PRIMARY KEY (namespace, data_key)
+        );
+        CREATE INDEX IF NOT EXISTS idx_tc_framework_data_namespace_updated_at
+            ON tc_framework_data (namespace, updated_at);
+    `)}function s(e){let n=c(e),i=typeof n==`string`?n:n?.path??n?.filename??n?.sqlitePath??l(n?.sqlite);return i?(0,t.isAbsolute)(i)?i:(0,t.resolve)(e.baseDir,i):(0,t.resolve)(e.baseDir,r)}function c(e){let t=e.config;return t.db??(t.sqlite?{sqlite:t.sqlite}:void 0)}function l(e){if(e)return typeof e==`string`?e:e.path??e.filename}function u(e){return e?Array.isArray(e)?e:[e]:[]}function d(e=n){let t=e.trim();if(!t)throw Error(`[db] namespace 不能为空`);return t}function f(e){let t=e.trim();if(!t)throw Error(`[db] key 不能为空`);return t}function p(e=100){if(!Number.isSafeInteger(e)||e<=0)throw Error(`[db] limit 必须是大于 0 的整数`);return e}function m(e=0){if(!Number.isSafeInteger(e)||e<0)throw Error(`[db] offset 必须是大于等于 0 的整数`);return e}function h(e){try{let t=JSON.stringify(e);if(t===void 0)throw Error(`value is not JSON serializable`);return t}catch(e){throw Error(`[db] value 必须可以被 JSON.stringify 序列化。${y(e)}`)}}function g(e){return JSON.parse(e)}function _(e){return{key:e.data_key,value:g(e.data_value),namespace:e.namespace,createdAt:e.created_at,updatedAt:e.updated_at}}function v(e){if(e)throw Error(`[db] SQLite 数据库连接已关闭`)}function y(e){return e instanceof Error&&e.message?` Cause: ${e.message}`:``}module.exports=i;

package/cjs/bundler/utils.js

@@ -1 +1 @@
-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(`@tailwindcss/vite`);s=e.__toESM(s);let c=require(`module`),l=require(`url`),u=require(`vite`);var d=typeof __filename==`string`?__filename:(0,l.fileURLToPath)({}.url),f=i.default.dirname(d),p=process.cwd(),m=(0,c.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`));function x(){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;let s;for(let n=0;n<e.length;n++){let c=e[n],l=i.default.resolve(c,`../`),u=a.sync(t.resolve(l,`*.html`))[0];if(u){let e=i.default.basename(u,`.html`);r[e]=i.default.resolve(p,u)}else{s||=(0,o.readFileSync)(i.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);let e=c.split(i.default.sep).at(-1),t=s.replace(`<!-- {{InsertScript}} -->`,`<script type="module" src="./${e}"><\/script>`),n=l.split(i.default.sep).at(-1),a=i.default.join(l,n+`.html`);(0,o.writeFileSync)(a,t),r[n]=a}}return r}function S(){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 C=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 w(e=`.html`){let t=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=S();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 T(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,a=y])=>{let s=t.map(e=>i.default.resolve(a,r+e)).find(e=>(0,o.existsSync)(e)),c=i.default.resolve(f,`./defaultAlias`);return s&&(c=s),e[n]=c,e},{})}var E=(...e)=>new RegExp(e.join(`[\\/]`)),D=e=>`_${e}_tcC`,O=async(e,t)=>{try{await(0,u.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),w([`.tpl`,`.html`]),(0,s.default)()],build:{outDir:S(),emptyOutDir:!0,sourcemap:t===`dev`?`inline`:`hidden`,modulePreload:{polyfill:!1},rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:D(`__nm`),test:E(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:D(`r`),test:E(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:D(`r-d`),test:E(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`r-r-d`),test:E(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:D(`ajv`),test:E(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`ui-lib`),test:E(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:D(`ui-f-lib`),test:E(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react":i.default.resolve(f,`../../fe/packages/ui/react/`),...T([[`@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`]])}}}),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=O,exports.entries=x,exports.outDir=S,exports.watchFiles=C;
+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(`@tailwindcss/vite`);s=e.__toESM(s);let c=require(`module`),l=require(`url`),u=require(`vite`);var d=typeof __filename==`string`?__filename:(0,l.fileURLToPath)({}.url),f=i.default.dirname(d),p=process.cwd(),m=(0,c.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`));function x(){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;let s;for(let n=0;n<e.length;n++){let c=e[n],l=i.default.resolve(c,`../`),u=a.sync(t.resolve(l,`*.html`))[0];if(u){let e=i.default.basename(u,`.html`);r[e]=i.default.resolve(p,u)}else{s||=(0,o.readFileSync)(i.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);let e=c.split(i.default.sep).at(-1),t=s.replace(`<!-- {{InsertScript}} -->`,`<script type="module" src="./${e}"><\/script>`),n=l.split(i.default.sep).at(-1),a=i.default.join(l,n+`.html`);(0,o.writeFileSync)(a,t),r[n]=a}}return r}function S(){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 C=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 w(e=`.html`){let t=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=S();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 T(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,a=y])=>{let s=t.map(e=>i.default.resolve(a,r+e)).find(e=>(0,o.existsSync)(e)),c=i.default.resolve(f,`./defaultAlias`);return s&&(c=s),e[n]=c,e},{})}var E=(...e)=>new RegExp(e.join(`[\\/]`)),D=e=>`_${e}_tcC`,O=async(e,t)=>{try{await(0,u.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),w([`.tpl`,`.html`]),(0,s.default)()],build:{outDir:S(),emptyOutDir:!0,sourcemap:t===`dev`?`inline`:`hidden`,rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:D(`__nm`),test:E(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:D(`r`),test:E(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:D(`r-d`),test:E(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`r-r-d`),test:E(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:D(`ajv`),test:E(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`ui-lib`),test:E(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:D(`ui-f-lib`),test:E(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react":i.default.resolve(f,`../../fe/packages/ui/react/`),...T([[`@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`]])}}}),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=O,exports.entries=x,exports.outDir=S,exports.watchFiles=C;

package/esm/app/extend/db.js

@@ -1,6 +1,141 @@
+import { __require as e } from "../../_virtual/_rolldown/runtime.js";
+import { mkdirSync as t } from "node:fs";
+import { dirname as n, isAbsolute as r, resolve as i } from "node:path";
 //#region app/extend/db.ts
-async function e(e) {
-	return console.log(e), {};
+var a = "framework", o = ".template-core/template-core.sqlite";
+function s(e) {
+	let r = u(e), i, a = !1, o = 0, s = () => (x(a), i || (t(n(r), { recursive: !0 }), i = c(r), l(i)), i), d = {
+		dbPath: r,
+		getDBConnection: s,
+		execDB: (e) => {
+			s().exec(e);
+		},
+		runDB: (e, t) => {
+			let n = s().prepare(e).run(...p(t));
+			return {
+				changes: Number(n.changes ?? 0),
+				lastInsertRowid: n.lastInsertRowid ?? 0
+			};
+		},
+		queryDB: (e, t) => s().prepare(e).all(...p(t)),
+		getDBFirst: (e, t) => s().prepare(e).get(...p(t)),
+		transactionDB: (e) => {
+			let t = s(), n = `tc_savepoint_${o}`, r = o === 0;
+			t.exec(r ? "BEGIN IMMEDIATE" : `SAVEPOINT ${n}`), o += 1;
+			try {
+				let i = e(d);
+				return --o, t.exec(r ? "COMMIT" : `RELEASE SAVEPOINT ${n}`), i;
+			} catch (e) {
+				throw --o, t.exec(r ? "ROLLBACK" : `ROLLBACK TO SAVEPOINT ${n}`), r || t.exec(`RELEASE SAVEPOINT ${n}`), e;
+			}
+		},
+		getDBData: (e, t) => d.getDBDataRecord(e, t)?.value,
+		getDBDataRecord: (e, t) => {
+			let n = d.getDBFirst("SELECT namespace, data_key, data_value, created_at, updated_at FROM tc_framework_data WHERE namespace = ? AND data_key = ? LIMIT 1", [m(t?.namespace), h(e)]);
+			return n ? b(n) : void 0;
+		},
+		setDBData: (e, t, n) => {
+			let r = (/* @__PURE__ */ new Date()).toISOString();
+			return d.runDB("INSERT INTO tc_framework_data (namespace, data_key, data_value, created_at, updated_at)\n                 VALUES (?, ?, ?, ?, ?)\n                 ON CONFLICT(namespace, data_key) DO UPDATE SET\n                    data_value = excluded.data_value,\n                    updated_at = excluded.updated_at", [
+				m(n?.namespace),
+				h(e),
+				v(t),
+				r,
+				r
+			]);
+		},
+		hasDBData: (e, t) => !!d.getDBFirst("SELECT 1 AS exists_value FROM tc_framework_data WHERE namespace = ? AND data_key = ? LIMIT 1", [m(t?.namespace), h(e)]),
+		deleteDBData: (e, t) => d.runDB("DELETE FROM tc_framework_data WHERE namespace = ? AND data_key = ?", [m(t?.namespace), h(e)]).changes > 0,
+		listDBData: (e) => {
+			let t = g(e?.limit), n = _(e?.offset);
+			return d.queryDB("SELECT namespace, data_key, data_value, created_at, updated_at\n                 FROM tc_framework_data\n                 WHERE namespace = ?\n                 ORDER BY updated_at DESC, data_key ASC\n                 LIMIT ? OFFSET ?", [
+				m(e?.namespace),
+				t,
+				n
+			]).map((e) => b(e));
+		},
+		countDBData: (e) => {
+			let t = d.getDBFirst("SELECT COUNT(1) AS count_value FROM tc_framework_data WHERE namespace = ?", [m(e?.namespace)]);
+			return Number(t?.count_value ?? 0);
+		},
+		clearDBData: (e) => d.runDB("DELETE FROM tc_framework_data WHERE namespace = ?", [m(e?.namespace)]).changes,
+		closeDB: () => {
+			a ||= (i?.close(), !0);
+		}
+	};
+	return d;
+}
+function c(t) {
+	let n = "node:sqlite", r;
+	try {
+		r = e(n);
+	} catch (e) {
+		throw Error(`[db] 默认数据库依赖 Node.js 内置 ${n}，当前运行环境不可用。请升级 Node.js，或在业务项目覆盖 app/extend/db.ts。${S(e)}`);
+	}
+	if (!r.DatabaseSync) throw Error(`[db] ${n} 未提供 DatabaseSync，无法初始化默认 SQLite 数据库。`);
+	return new r.DatabaseSync(t);
+}
+function l(e) {
+	e.exec("\n        CREATE TABLE IF NOT EXISTS tc_framework_data (\n            namespace TEXT NOT NULL,\n            data_key TEXT NOT NULL,\n            data_value TEXT NOT NULL,\n            created_at TEXT NOT NULL,\n            updated_at TEXT NOT NULL,\n            PRIMARY KEY (namespace, data_key)\n        );\n        CREATE INDEX IF NOT EXISTS idx_tc_framework_data_namespace_updated_at\n            ON tc_framework_data (namespace, updated_at);\n    ");
+}
+function u(e) {
+	let t = d(e), n = typeof t == "string" ? t : t?.path ?? t?.filename ?? t?.sqlitePath ?? f(t?.sqlite);
+	return n ? r(n) ? n : i(e.baseDir, n) : i(e.baseDir, o);
+}
+function d(e) {
+	let t = e.config;
+	return t.db ?? (t.sqlite ? { sqlite: t.sqlite } : void 0);
+}
+function f(e) {
+	if (e) return typeof e == "string" ? e : e.path ?? e.filename;
+}
+function p(e) {
+	return e ? Array.isArray(e) ? e : [e] : [];
+}
+function m(e = a) {
+	let t = e.trim();
+	if (!t) throw Error("[db] namespace 不能为空");
+	return t;
+}
+function h(e) {
+	let t = e.trim();
+	if (!t) throw Error("[db] key 不能为空");
+	return t;
+}
+function g(e = 100) {
+	if (!Number.isSafeInteger(e) || e <= 0) throw Error("[db] limit 必须是大于 0 的整数");
+	return e;
+}
+function _(e = 0) {
+	if (!Number.isSafeInteger(e) || e < 0) throw Error("[db] offset 必须是大于等于 0 的整数");
+	return e;
+}
+function v(e) {
+	try {
+		let t = JSON.stringify(e);
+		if (t === void 0) throw Error("value is not JSON serializable");
+		return t;
+	} catch (e) {
+		throw Error(`[db] value 必须可以被 JSON.stringify 序列化。${S(e)}`);
+	}
+}
+function y(e) {
+	return JSON.parse(e);
+}
+function b(e) {
+	return {
+		key: e.data_key,
+		value: y(e.data_value),
+		namespace: e.namespace,
+		createdAt: e.created_at,
+		updatedAt: e.updated_at
+	};
+}
+function x(e) {
+	if (e) throw Error("[db] SQLite 数据库连接已关闭");
+}
+function S(e) {
+	return e instanceof Error && e.message ? ` Cause: ${e.message}` : "";
 }
 //#endregion
-export { e as default };
+export { s as default };

package/esm/bundler/utils.js

@@ -124,7 +124,6 @@ var F = (...e) => new RegExp(e.join("[\\/]")), I = (e) => `_${e}_tcC`, L = async
 				outDir: j(),
 				emptyOutDir: !0,
 				sourcemap: i === "dev" ? "inline" : "hidden",
-				modulePreload: { polyfill: !1 },
 				rolldownOptions: {
 					input: e,
 					output: { codeSplitting: { groups: [
@@ -192,7 +191,8 @@ var F = (...e) => new RegExp(e.join("[\\/]")), I = (e) => `_${e}_tcC`, L = 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/customRoutes", "./extended/dash/customRoutes"],
+					["@tc/scalability/dash/components", "./extended/dash/components"]
 				])
 			} }
 		}), n(t("builded", "green"), t(" -> ", "white"), t("time: ", "cyan"), t(/* @__PURE__ */ new Date(), "pink"));

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

@@ -7,6 +7,7 @@ import { findMenuItem, leftSidebarBasePath } from '../../src/common/menu';
 import HeaderView from '../../src/components/BasePage/HeaderView';
 import useRouterParams from '../../src/hooks/useRouterParams';
 import { useModeStore } from '../../src/stores/mode';
+import dashComponents from '@tc/scalability/dash/components';
 import { Menu } from '../../../packages/ui/react/components';
 import useInit from '../../../packages/ui/react/hooks/useInit';
 const normalizePathname = (pathname) => {
@@ -92,6 +93,7 @@ const getRenderableHomePage = (projectInfo) => {
 };
 const Dashboard = () => {
     const { initModeData, initData, projectInfo } = useModeStore();
+    const HeaderUserArea = dashComponents['HeaderView.userArea'];
     useInit(() => {
         !initData && initModeData();
     });
@@ -168,7 +170,7 @@ const Dashboard = () => {
             document.title = projectInfo?.name ?? title;
         return title ? getText(title) : undefined;
     };
-    return (_jsxs("div", { className: "dash-main h-screen flex flex-col overflow-hidden bg-theme-bg text-foreground", children: [_jsx(HeaderView, { icon: projectInfo?.icon, title: getTitle(), menu: menu }), _jsx("div", { className: "dash-container min-h-0 flex-1 overflow-hidden", children: _jsx(Outlet, {}) })] }));
+    return (_jsxs("div", { className: "dash-main h-screen flex flex-col overflow-hidden bg-theme-bg text-foreground", children: [_jsx(HeaderView, { icon: projectInfo?.icon, title: getTitle(), menu: menu, userArea: HeaderUserArea ? _jsx(HeaderUserArea, { projectInfo: projectInfo }) : undefined }), _jsx("div", { className: "dash-container min-h-0 flex-1 overflow-hidden", children: _jsx(Outlet, {}) })] }));
 };
 Dashboard.displayName = 'Dashboard';
 export default Dashboard;

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

@@ -1,4 +1,6 @@
+import type { ProjectInfo } from '../../src/api/baseInfo';
 import type { RouteInfo } from '../../src/components/Router';
+import type { ComponentType, LazyExoticComponent } from 'react';
 export type DashRoutesContext = {
     /**
      * 扩展 topMenu 自定义页面
@@ -14,4 +16,10 @@ export type DashRoutesContext = {
     sidebarRoutes: RouteInfo[];
 };
 export type DashRoutesExtender = (context: DashRoutesContext) => void;
+export type DashHeaderUserAreaProps = {
+    projectInfo: ProjectInfo | null;
+};
+export type DashComponentsMap = {
+    'HeaderView.userArea'?: ComponentType<DashHeaderUserAreaProps> | LazyExoticComponent<ComponentType<DashHeaderUserAreaProps>>;
+};
 //# sourceMappingURL=types.d.ts.map

package/fe/frontend/src/components/LanguageSwitch/LanguageSwitch.d.ts

@@ -0,0 +1,14 @@
+import { type SelectProps } from '../../../../packages/ui/react';
+export type LanguageSwitchValue = 'zh-CN' | 'en-US' | (string & {});
+export type LanguageSwitchOption = Omit<NonNullable<SelectProps['options']>[number], 'value'> & {
+    value: LanguageSwitchValue;
+};
+export interface LanguageSwitchProps extends Omit<SelectProps, 'options' | 'value' | 'defaultValue' | 'onChange'> {
+    value?: LanguageSwitchValue;
+    defaultValue?: LanguageSwitchValue;
+    options?: LanguageSwitchOption[];
+    onChange?: (language: LanguageSwitchValue) => void;
+}
+declare const LanguageSwitch: ({ value, defaultValue, options, onChange, className, placeholder, clearable, searchable, getPopupContainer, ...props }: LanguageSwitchProps) => import("react/jsx-runtime").JSX.Element;
+export default LanguageSwitch;
+//# sourceMappingURL=LanguageSwitch.d.ts.map

package/fe/frontend/src/components/LanguageSwitch/LanguageSwitch.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getText } from '../../common/language';
+import { frontendLangKeys } from '../../language';
+import { cn, Select } from '../../../../packages/ui/react';
+import { i18nStore, useI18nStore } from '../../../../packages/ui/react/i18n';
+import { useMemo } from 'react';
+const getDefaultLanguageOptions = () => [
+    {
+        label: getText(frontendLangKeys.languageSwitchZhCN),
+        value: 'zh-CN',
+        searchText: 'zh-CN 中文 简体中文',
+    },
+    {
+        label: getText(frontendLangKeys.languageSwitchEnUS),
+        value: 'en-US',
+        searchText: 'en-US English',
+    },
+];
+const LanguageSwitch = ({ value, defaultValue, options, onChange, className, placeholder, clearable = false, searchable = false, getPopupContainer = 'parent', ...props }) => {
+    const currentLanguage = useI18nStore((state) => state.language);
+    const mergedOptions = useMemo(() => options ?? getDefaultLanguageOptions(), [currentLanguage, options]);
+    const selectedLanguage = value ?? currentLanguage ?? defaultValue;
+    const handleChange = (language) => {
+        if (!language)
+            return;
+        const nextLanguage = String(language);
+        i18nStore.getState().setLanguage(nextLanguage);
+        onChange?.(nextLanguage);
+    };
+    return (_jsx(Select, { ...props, className: cn('w-32 shrink-0', className), clearable: clearable, getPopupContainer: getPopupContainer, options: mergedOptions, placeholder: placeholder ?? getText(frontendLangKeys.languageSwitchPlaceholder), searchable: searchable, value: selectedLanguage ?? defaultValue, onChange: handleChange }));
+};
+export default LanguageSwitch;

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

@@ -0,0 +1,4 @@
+import LanguageSwitch from './LanguageSwitch';
+export * from './LanguageSwitch';
+export default LanguageSwitch;
+//# sourceMappingURL=index.d.ts.map

package/fe/frontend/src/components/LanguageSwitch/index.js

@@ -0,0 +1,3 @@
+import LanguageSwitch from './LanguageSwitch';
+export * from './LanguageSwitch';
+export default LanguageSwitch;

package/fe/frontend/src/components/ThemeSwitch/ThemeSwitch.d.ts

@@ -0,0 +1,15 @@
+export type ThemeSwitchMode = 'light' | 'dark';
+export interface ThemeSwitchProps {
+    value?: ThemeSwitchMode;
+    defaultValue?: ThemeSwitchMode;
+    onChange?: (mode: ThemeSwitchMode) => void;
+    disabled?: boolean;
+    className?: string;
+    showLabel?: boolean;
+    persist?: boolean;
+    storageKey?: string;
+}
+export declare const themeSwitchStorageKey = "tc_theme";
+declare const ThemeSwitch: ({ value, defaultValue, onChange, disabled, className, showLabel, persist, storageKey, }: ThemeSwitchProps) => import("react/jsx-runtime").JSX.Element;
+export default ThemeSwitch;
+//# sourceMappingURL=ThemeSwitch.d.ts.map