@_tc/template-core 0.1.13 → 0.1.15

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

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getText } from '../../common/language';
+import { frontendLangKeys } from '../../language';
+import { cn, Switch, Tooltip } from '../../../../packages/ui/react';
+import { useI18nStore } from '../../../../packages/ui/react/i18n';
+import { Moon, Sun } from 'lucide-react';
+import { useEffect, useState } from 'react';
+export const themeSwitchStorageKey = 'tc_theme';
+const canUseDocument = () => typeof document !== 'undefined';
+const canUseLocalStorage = () => typeof localStorage !== 'undefined';
+const getStoredThemeMode = (storageKey) => {
+    if (!canUseLocalStorage())
+        return null;
+    const value = localStorage.getItem(storageKey);
+    return value === 'light' || value === 'dark' ? value : null;
+};
+const getCurrentThemeMode = (defaultValue, storageKey = themeSwitchStorageKey) => {
+    const storedMode = getStoredThemeMode(storageKey);
+    if (storedMode)
+        return storedMode;
+    if (defaultValue)
+        return defaultValue;
+    if (!canUseDocument())
+        return 'light';
+    return document.documentElement.classList.contains('dark') ? 'dark' : 'light';
+};
+const applyThemeMode = (mode, persist, storageKey) => {
+    if (!canUseDocument())
+        return;
+    const root = document.documentElement;
+    root.classList.toggle('dark', mode === 'dark');
+    root.style.colorScheme = mode;
+    if (persist && canUseLocalStorage()) {
+        localStorage.setItem(storageKey, mode);
+    }
+};
+const ThemeSwitch = ({ value, defaultValue, onChange, disabled, className, showLabel = false, persist = true, storageKey = themeSwitchStorageKey, }) => {
+    useI18nStore((state) => state.language);
+    const [internalMode, setInternalMode] = useState(() => getCurrentThemeMode(defaultValue, storageKey));
+    const isControlled = value !== undefined;
+    const mode = isControlled ? value : internalMode;
+    const checked = mode === 'dark';
+    useEffect(() => {
+        applyThemeMode(mode, persist, storageKey);
+    }, [mode, persist, storageKey]);
+    const handleChange = (nextChecked) => {
+        const nextMode = nextChecked ? 'dark' : 'light';
+        if (!isControlled) {
+            setInternalMode(nextMode);
+        }
+        onChange?.(nextMode);
+    };
+    const label = mode === 'dark' ? getText(frontendLangKeys.themeSwitchDark) : getText(frontendLangKeys.themeSwitchLight);
+    const tooltip = checked
+        ? getText(frontendLangKeys.themeSwitchToLight)
+        : getText(frontendLangKeys.themeSwitchToDark);
+    return (_jsxs("div", { className: cn('inline-flex shrink-0 items-center gap-2 text-foreground', className), children: [_jsx(Sun, { className: cn('h-4 w-4', checked ? 'text-muted-foreground' : 'text-foreground'), "aria-hidden": "true" }), _jsx(Tooltip, { content: tooltip, placement: "bottom", children: _jsx(Switch, { checked: checked, disabled: disabled, onChange: handleChange }) }), _jsx(Moon, { className: cn('h-4 w-4', checked ? 'text-foreground' : 'text-muted-foreground'), "aria-hidden": "true" }), showLabel && _jsx("span", { className: "min-w-8 text-xs text-muted-foreground", children: label })] }));
+};
+export default ThemeSwitch;

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

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

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

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

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

@@ -0,0 +1,11 @@
+export { default as AsyncSelect } from './AsyncSelect';
+export * from './AsyncSelect';
+export { default as HeaderView } from './BasePage/HeaderView';
+export * from './BasePage/HeaderView';
+export { default as LanguageSwitch } from './LanguageSwitch';
+export * from './LanguageSwitch';
+export * from './Router';
+export * from './Router/type';
+export { default as ThemeSwitch } from './ThemeSwitch';
+export * from './ThemeSwitch';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,10 @@
+export { default as AsyncSelect } from './AsyncSelect';
+export * from './AsyncSelect';
+export { default as HeaderView } from './BasePage/HeaderView';
+export * from './BasePage/HeaderView';
+export { default as LanguageSwitch } from './LanguageSwitch';
+export * from './LanguageSwitch';
+export * from './Router';
+export * from './Router/type';
+export { default as ThemeSwitch } from './ThemeSwitch';
+export * from './ThemeSwitch';

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

@@ -3,6 +3,7 @@ export type * from '../apps/dash/types';
 export * from './main';
 export type { CallComComponentsMap, CallComRenderer } from './defaultPages/SchemaPage/schemaType';
 export type { FormFieldSchema, SchemaFormComponentsMap, SchemaFormNamespace, SelectProps } from '../../packages/ui/react';
+export * from './components';
 export { del, get, patch, post, put, request } from './common/request';
 /**
  * callCom 事件通信 权限

package/fe/frontend/src/index.js

@@ -1,5 +1,6 @@
 import './typing/scalability';
 export * from './main';
+export * from './components';
 // 导出请求方法
 export { del, get, patch, post, put, request } from './common/request';
 /**

package/fe/frontend/src/language/en-US.d.ts

@@ -5,6 +5,19 @@ export declare const frontendEnUSResources: {
             readonly uiComponentsTitle: "UI Components";
             readonly uiComponentsButton: "Click me";
         };
+        readonly components: {
+            readonly languageSwitch: {
+                readonly placeholder: "Select language";
+                readonly zhCN: "简体中文";
+                readonly enUS: "English";
+            };
+            readonly themeSwitch: {
+                readonly light: "Light";
+                readonly dark: "Dark";
+                readonly toLight: "Switch to light theme";
+                readonly toDark: "Switch to dark theme";
+            };
+        };
         readonly common: {
             readonly yes: "Yes";
             readonly no: "No";

package/fe/frontend/src/language/en-US.js

@@ -5,6 +5,19 @@ export const frontendEnUSResources = {
             uiComponentsTitle: 'UI Components',
             uiComponentsButton: 'Click me',
         },
+        components: {
+            languageSwitch: {
+                placeholder: 'Select language',
+                zhCN: '简体中文',
+                enUS: 'English',
+            },
+            themeSwitch: {
+                light: 'Light',
+                dark: 'Dark',
+                toLight: 'Switch to light theme',
+                toDark: 'Switch to dark theme',
+            },
+        },
         common: {
             yes: 'Yes',
             no: 'No',

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

@@ -6,6 +6,13 @@ export declare const frontendLangKeys: {
     readonly appTitle: string;
     readonly uiComponentsTitle: string;
     readonly uiComponentsButton: string;
+    readonly languageSwitchPlaceholder: string;
+    readonly languageSwitchZhCN: string;
+    readonly languageSwitchEnUS: string;
+    readonly themeSwitchLight: string;
+    readonly themeSwitchDark: string;
+    readonly themeSwitchToLight: string;
+    readonly themeSwitchToDark: string;
     readonly yes: string;
     readonly no: string;
     readonly noData: string;

package/fe/frontend/src/language/index.js

@@ -10,6 +10,13 @@ export const frontendLangKeys = {
     appTitle: withI18nKey('frontend.app.title'),
     uiComponentsTitle: withI18nKey('frontend.app.uiComponentsTitle'),
     uiComponentsButton: withI18nKey('frontend.app.uiComponentsButton'),
+    languageSwitchPlaceholder: withI18nKey('frontend.components.languageSwitch.placeholder'),
+    languageSwitchZhCN: withI18nKey('frontend.components.languageSwitch.zhCN'),
+    languageSwitchEnUS: withI18nKey('frontend.components.languageSwitch.enUS'),
+    themeSwitchLight: withI18nKey('frontend.components.themeSwitch.light'),
+    themeSwitchDark: withI18nKey('frontend.components.themeSwitch.dark'),
+    themeSwitchToLight: withI18nKey('frontend.components.themeSwitch.toLight'),
+    themeSwitchToDark: withI18nKey('frontend.components.themeSwitch.toDark'),
     yes: withI18nKey('frontend.common.yes'),
     no: withI18nKey('frontend.common.no'),
     noData: withI18nKey('frontend.common.noData'),

package/fe/frontend/src/language/zh-CN.d.ts

@@ -5,6 +5,19 @@ export declare const frontendZhCNResources: {
             readonly uiComponentsTitle: "UI 组件";
             readonly uiComponentsButton: "点击我";
         };
+        readonly components: {
+            readonly languageSwitch: {
+                readonly placeholder: "选择语言";
+                readonly zhCN: "简体中文";
+                readonly enUS: "English";
+            };
+            readonly themeSwitch: {
+                readonly light: "浅色";
+                readonly dark: "深色";
+                readonly toLight: "切换为浅色主题";
+                readonly toDark: "切换为深色主题";
+            };
+        };
         readonly common: {
             readonly yes: "是";
             readonly no: "否";

package/fe/frontend/src/language/zh-CN.js

@@ -5,6 +5,19 @@ export const frontendZhCNResources = {
             uiComponentsTitle: 'UI 组件',
             uiComponentsButton: '点击我',
         },
+        components: {
+            languageSwitch: {
+                placeholder: '选择语言',
+                zhCN: '简体中文',
+                enUS: 'English',
+            },
+            themeSwitch: {
+                light: '浅色',
+                dark: '深色',
+                toLight: '切换为浅色主题',
+                toDark: '切换为深色主题',
+            },
+        },
         common: {
             yes: '是',
             no: '否',

package/fe/packages/ui/react/components/Button/{SumbitButton.d.ts → SubmitButton.d.ts}

@@ -1,13 +1,13 @@
 import type { MOmit } from '../../types';
 import { type ButtonElementProps } from './Button';
-export type SumbitButtonProps = MOmit<ButtonElementProps, 'onClick'> & {
+export type SubmitButtonProps = MOmit<ButtonElementProps, 'onClick'> & {
     onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => Promise<void | boolean> | void;
 };
 /**
  *
  * 会自动添加loading 其余同button一致
  */
-declare const SumbitButton: (props: SumbitButtonProps) => import("react/jsx-runtime").JSX.Element;
-declare const AsynchronousButton: (props: SumbitButtonProps) => import("react/jsx-runtime").JSX.Element;
-export { AsynchronousButton, SumbitButton };
-//# sourceMappingURL=SumbitButton.d.ts.map
+declare const SubmitButton: (props: SubmitButtonProps) => import("react/jsx-runtime").JSX.Element;
+declare const AsynchronousButton: (props: SubmitButtonProps) => import("react/jsx-runtime").JSX.Element;
+export { AsynchronousButton, SubmitButton };
+//# sourceMappingURL=SubmitButton.d.ts.map

package/fe/packages/ui/react/components/Button/{SumbitButton.js → SubmitButton.js}

@@ -6,7 +6,7 @@ import { Button } from './Button';
  *
  * 会自动添加loading 其余同button一致
  */
-const SumbitButton = (props) => {
+const SubmitButton = (props) => {
     const { onClick, className, loading: loadingProp, ...bprops } = props;
     const [loading, uLoading] = useState(false);
     return (_jsx(Button, { className: cn('tc-ui-submit-button', className), loading: loading || loadingProp, onClick: async (e) => {
@@ -21,5 +21,5 @@ const SumbitButton = (props) => {
             }
         }, ...bprops }));
 };
-const AsynchronousButton = SumbitButton;
-export { AsynchronousButton, SumbitButton };
+const AsynchronousButton = SubmitButton;
+export { AsynchronousButton, SubmitButton };

package/fe/packages/ui/react/components/Button/index.d.ts

@@ -1,4 +1,4 @@
 export { Button } from './Button';
 export type { ButtonElementProps, ButtonLinkProps, ButtonProps, ButtonSize, ButtonState, ButtonVariant } from './Button';
-export * from './SumbitButton';
+export * from './SubmitButton';
 //# sourceMappingURL=index.d.ts.map

package/fe/packages/ui/react/components/Button/index.js

@@ -1,2 +1,2 @@
 export { Button } from './Button';
-export * from './SumbitButton';
+export * from './SubmitButton';

package/fe/packages/ui/react/components/Modal/ModalManager.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type SumbitButtonProps } from '../Button';
+import { type SubmitButtonProps } from '../Button';
 import { type ModalProps } from './Modal';
 type ModalConfig = Omit<ModalProps, 'open' | 'onClose' | 'children'> & {
     id: string;
@@ -31,7 +31,7 @@ export declare const openConfirmModal: (pConfig: Pick<OpenModalConfig, "content"
     /** 取消按钮文本 */
     cancelText?: string;
     /** 确认回调 */
-    onOk?: SumbitButtonProps["onClick"];
+    onOk?: SubmitButtonProps["onClick"];
     /** 取消回调 */
     onCancel?: () => void;
 }) => string;
@@ -48,7 +48,7 @@ export declare const modal: {
         /** 取消按钮文本 */
         cancelText?: string;
         /** 确认回调 */
-        onOk?: SumbitButtonProps["onClick"];
+        onOk?: SubmitButtonProps["onClick"];
         /** 取消回调 */
         onCancel?: () => void;
     }) => string;

package/fe/packages/ui/react/components/TableSearch/index.d.ts

@@ -1,2 +1,3 @@
 export { default as TableSearch } from './TableSearch';
+export type { TableSearchSchema } from './TableSearch';
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
   "types": "./types/index.d.ts",
   "exports": {

package/types/app/extend/db.d.ts

@@ -1,2 +1,55 @@
 import type { KoaApp } from "../type";
-export default function getDB(app: KoaApp): Promise<{}>;
+export type DBValue = unknown;
+export type SQLiteValue = string | number | bigint | null | Uint8Array;
+export type SQLiteParams = SQLiteValue[] | Record<string, SQLiteValue>;
+export interface DBDataOptions {
+    namespace?: string;
+}
+export interface ListDBDataOptions extends DBDataOptions {
+    limit?: number;
+    offset?: number;
+}
+export interface DBDataRecord<T = DBValue> {
+    key: string;
+    value: T;
+    namespace: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DBRunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+export interface FrameworkDB {
+    dbPath: string;
+    getDBConnection: () => unknown;
+    /**
+     * 仅用于固定 SQL，例如建表或迁移。不要拼接用户输入。
+     */
+    execDB: (sql: string) => void;
+    /**
+     * 执行写入 SQL。用户输入必须通过 params 参数绑定，不要拼接到 sql 字符串中。
+     */
+    runDB: (sql: string, params?: SQLiteParams) => DBRunResult;
+    /**
+     * 查询多行数据。用户输入必须通过 params 参数绑定，不要拼接到 sql 字符串中。
+     */
+    queryDB: <T extends object = Record<string, unknown>>(sql: string, params?: SQLiteParams) => T[];
+    /**
+     * 查询单行数据。用户输入必须通过 params 参数绑定，不要拼接到 sql 字符串中。
+     */
+    getDBFirst: <T extends object = Record<string, unknown>>(sql: string, params?: SQLiteParams) => T | undefined;
+    transactionDB: <T>(handler: (db: FrameworkDB) => T) => T;
+    getDBData: <T = DBValue>(key: string, options?: DBDataOptions) => T | undefined;
+    getDBDataRecord: <T = DBValue>(key: string, options?: DBDataOptions) => DBDataRecord<T> | undefined;
+    setDBData: <T = DBValue>(key: string, value: T, options?: DBDataOptions) => DBRunResult;
+    hasDBData: (key: string, options?: DBDataOptions) => boolean;
+    deleteDBData: (key: string, options?: DBDataOptions) => boolean;
+    listDBData: <T = DBValue>(options?: ListDBDataOptions) => DBDataRecord<T>[];
+    countDBData: (options?: DBDataOptions) => number;
+    clearDBData: (options?: DBDataOptions) => number;
+    closeDB: () => void;
+}
+export type DB = FrameworkDB;
+export type DBFactory = (app: KoaApp) => DB | Promise<DB>;
+export default function getDB(app: KoaApp): FrameworkDB;

package/types/config/config.default.d.ts

@@ -1,8 +1,38 @@
+export interface DefaultSQLiteConfig {
+    path?: string;
+    filename?: string;
+}
+export interface DefaultDBConfig {
+    /**
+     * SQLite 数据库文件路径。相对路径会基于业务项目 baseDir 解析。
+     */
+    path?: string;
+    /**
+     * SQLite 数据库文件路径，作用同 path。
+     */
+    filename?: string;
+    /**
+     * 兼容旧式或直观命名，作用同 path。
+     */
+    sqlitePath?: string;
+    /**
+     * SQLite 子配置。传字符串时表示数据库文件路径。
+     */
+    sqlite?: string | DefaultSQLiteConfig;
+}
 export interface DefaultAppConfig {
     frameName: string;
     port?: number;
     host?: string;
     env?: string;
+    /**
+     * 框架默认数据库配置。默认使用 SQLite。
+     */
+    db?: string | DefaultDBConfig;
+    /**
+     * SQLite 数据库路径或配置。等价于 db.sqlite。
+     */
+    sqlite?: string | DefaultSQLiteConfig;
     signKey: string;
     apiSignVerify?: {
         whiteList?: string[];

package/types/index.d.ts

@@ -4,6 +4,7 @@ import "./app/typings";
 import { MOmit } from "./typings/type";
 export type { FrameworkAugment, KoaApp } from "./packages/core/index";
 export type { ControllerFN, Ctx, ServiceFN } from "./app/type";
+export type { DB, DBDataOptions, DBDataRecord, DBFactory, DBRunResult, FrameworkDB, ListDBDataOptions, SQLiteParams, SQLiteValue, } from "./app/extend/db";
 export type { Router };
 export declare const serverStart: (options?: MOmit<StartOptions, "frameBaseDir">) => Promise<import("./packages/core/index").KoaApp>;
 export declare const baseFn: {