@_tc/template-core 0.0.1 → 0.0.2

package/fe/packages/ui/react/lib/export.js

@@ -0,0 +1,138 @@
+/**
+ * 导出 Excel 工具方法
+ *
+ * 功能：
+ * - 支持导出「当前页」或「当前查询条件下的全部页数据」
+ * - 通过 DataTable 的 columns 控制导出列及顺序
+ *
+ * 使用方式（示例）：
+ * ```ts
+ * await exportToExcel({
+ *   fetchData: (pageNum, pageSize) => getWithdrawList({ ...searchParams, pageNum, pageSize }),
+ *   columns, // 直接复用 DataTable 的 columns
+ *   exportType: 'all', // 'all' 导出全部页；'current' 仅导出当前页
+ *   currentPage,
+ *   pageSize,
+ *   total,
+ *   currentPageData: tableData, // 可选，导出当前页时直接使用现有数据，避免重复请求
+ *   fileName: '提币记录',
+ * })
+ * ```
+ */
+import { message } from '../components';
+import * as XLSX from 'xlsx';
+const getTextFromReactNode = (node) => {
+    if (node == null || typeof node !== 'object') {
+        return node;
+    }
+    if ('props' in node && node.props && typeof node.props === 'object' && 'children' in node.props) {
+        const children = node.props.children;
+        if (Array.isArray(children)) {
+            return children.map((child) => getTextFromReactNode(child)).flat();
+        }
+        return getTextFromReactNode(children);
+    }
+    return String(node);
+};
+export const ExportType = {
+    /**
+     * 当前查询条件下所有页
+     */
+    all: 0,
+    /**
+     * 当前页
+     */
+    current: 1,
+};
+/** 读取嵌套字段值，支持 a.b.c 形式 */
+const getValue = (row, dataIndex) => {
+    const key = String(dataIndex);
+    if (!key.includes('.'))
+        return row?.[key];
+    return key.split('.').reduce((acc, cur) => (acc == null ? acc : acc[cur]), row);
+};
+/**
+ * 通用导出 Excel 方法
+ */
+export async function exportToExcel(options) {
+    const { fetchData, exportType, currentPage = 1, pageSize = 2000, maxCount = 10000, currentPageData, fileName, } = options;
+    const defaultSearchParams = { export: true };
+    const cols = options.columns;
+    const fieldConfigs = cols
+        // 过滤掉操作列
+        .filter((col) => !col.isAction && col.key !== 'action')
+        .map((col) => ({
+        title: col.title,
+        dataIndex: (col.dataIndex || col.key),
+        render: col.renderExport ?? col.render,
+    }));
+    if (!fieldConfigs.length) {
+        console.warn('[exportToExcel] 导出列配置为空，已终止导出');
+        return;
+    }
+    const infoMessageId = message.info('导出中...', { duration: 999999999 });
+    try {
+        let allData = [];
+        if (exportType === ExportType.current) {
+            // 优先使用已存在的当前页数据，避免重复请求
+            if (currentPageData && currentPageData.length) {
+                allData = currentPageData;
+            }
+            else {
+                const res = await fetchData(currentPage, pageSize, defaultSearchParams);
+                allData = res.records || [];
+            }
+        }
+        else {
+            // 导出所有页：按页拉取，直到数据不足一整页或达到最大条数
+            const list = [];
+            for (let page = 1;; page += 1) {
+                const res = await fetchData(page, pageSize, defaultSearchParams);
+                const records = res.records || [];
+                if (!records.length)
+                    break;
+                list.push(...records);
+                // 达到最大条数后直接截断并停止
+                if (list.length >= maxCount) {
+                    list.length = maxCount;
+                    break;
+                }
+                // 本页数据不足 pageSize，说明已到最后一页
+                if (records.length < pageSize)
+                    break;
+            }
+            allData = list;
+        }
+        if (!allData.length) {
+            message.warning?.('暂无可导出的数据');
+            message.close(infoMessageId);
+            return;
+        }
+        // 构建表头
+        const header = fieldConfigs.map((f) => f.title);
+        // 构建数据行
+        const dataRows = allData.map((row, index) => fieldConfigs.map((f) => {
+            const v = f.render ? f.render(getValue(row, f.dataIndex), row, index) : getValue(row, f.dataIndex);
+            // 如果v是ReactNode
+            // 需要获取最深层的text
+            if (v && typeof v === 'object' && 'props' in v && 'children' in v.props) {
+                return getTextFromReactNode(v);
+            }
+            return v;
+        }));
+        const worksheet = XLSX.utils.aoa_to_sheet([header, ...dataRows]);
+        const workbook = XLSX.utils.book_new();
+        XLSX.utils.book_append_sheet(workbook, worksheet, 'Sheet1');
+        const now = new Date();
+        const pad = (n) => (n < 10 ? `0${n}` : String(n));
+        const defaultName = `export-${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+        XLSX.writeFile(workbook, `${fileName || defaultName}.xlsx`);
+        message.close(infoMessageId);
+        message.success?.('导出成功');
+    }
+    catch (error) {
+        console.error('[exportToExcel] 导出失败:', error);
+        message.close(infoMessageId);
+        message.error?.('导出失败，请稍后重试');
+    }
+}

package/fe/packages/ui/react/lib/utils.d.ts

@@ -0,0 +1,34 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * 日期时间格式化工具
+ */
+/**
+ * 格式化日期时间
+ * @param date 日期字符串或 Date 对象
+ * @param format 格式化模板，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的字符串
+ */
+export declare function formatDateTime(date: string | Date | null | undefined | number, format?: string): string;
+/**
+ * 格式化日期
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串 YYYY-MM-DD
+ */
+export declare function formatDate(date: string | Date | null | undefined): string;
+/**
+ * 格式化时间
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串 HH:mm:ss
+ */
+export declare function formatTime(date: string | Date | null | undefined): string;
+/**
+ * 生成开始结束时间
+ * @param dates 日期字符串或 Date 对象数组
+ * @returns 开始结束时间对象 { start: string; end: string }
+ */
+export declare function generateStartEndTime(dates: string[] | Date[] | null | undefined): {
+    start: string;
+    end: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/fe/packages/ui/react/lib/utils.js

@@ -0,0 +1,70 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/**
+ * 日期时间格式化工具
+ */
+/**
+ * 格式化日期时间
+ * @param date 日期字符串或 Date 对象
+ * @param format 格式化模板，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的字符串
+ */
+export function formatDateTime(date, format = "YYYY-MM-DD HH:mm:ss") {
+    if (!date)
+        return "-";
+    let d = new Date(date);
+    // 接口返回的时间戳为 秒
+    const tmpY = d.getFullYear();
+    if (typeof date === "number" && tmpY === 1970) {
+        d = new Date(date * 1000);
+    }
+    if (isNaN(d.getTime()))
+        return "-";
+    const year = d.getFullYear();
+    const month = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    const hours = String(d.getHours()).padStart(2, "0");
+    const minutes = String(d.getMinutes()).padStart(2, "0");
+    const seconds = String(d.getSeconds()).padStart(2, "0");
+    return format
+        .replace("YYYY", String(year))
+        .replace("MM", month)
+        .replace("DD", day)
+        .replace("HH", hours)
+        .replace("mm", minutes)
+        .replace("ss", seconds);
+}
+/**
+ * 格式化日期
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串 YYYY-MM-DD
+ */
+export function formatDate(date) {
+    return formatDateTime(date, "YYYY-MM-DD");
+}
+/**
+ * 格式化时间
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串 HH:mm:ss
+ */
+export function formatTime(date) {
+    return formatDateTime(date, "HH:mm:ss");
+}
+/**
+ * 生成开始结束时间
+ * @param dates 日期字符串或 Date 对象数组
+ * @returns 开始结束时间对象 { start: string; end: string }
+ */
+export function generateStartEndTime(dates) {
+    if (!dates)
+        return { start: "", end: "" };
+    const start = dates[0];
+    const end = dates[dates.length - 1];
+    return {
+        start: formatDateTime(start, "YYYY-MM-DD 00:00:00"),
+        end: formatDateTime(end, "YYYY-MM-DD 23:59:59"),
+    };
+}

package/fe/packages/ui/react/stores/breadcrumb.d.ts

@@ -0,0 +1,15 @@
+import type { BreadcrumbItemData } from '../components/breadcrumb';
+type State = {
+    items: BreadcrumbItemData[];
+};
+type Actions = {
+    setItems: (items: BreadcrumbItemData[]) => void;
+    addItem: (item: BreadcrumbItemData) => void;
+    removeItem: (id: string | number) => void;
+    clearItems: () => void;
+    setActiveItem: (id: string | number) => void;
+};
+export declare const breadcrumbStore: import("zustand").UseBoundStore<import("zustand").StoreApi<State & Actions>>;
+export declare const useBreadcrumbStore: import("zustand").UseBoundStore<import("zustand").StoreApi<State & Actions>>;
+export {};
+//# sourceMappingURL=breadcrumb.d.ts.map

package/fe/packages/ui/react/stores/breadcrumb.js

@@ -0,0 +1,66 @@
+import { create } from 'zustand';
+const BREADCRUMB_STORAGE_KEY = 'app-breadcrumb';
+const loadBreadcrumbFromStorage = () => {
+    try {
+        const stored = localStorage.getItem(BREADCRUMB_STORAGE_KEY);
+        if (stored) {
+            const items = JSON.parse(stored);
+            return items.map((item) => ({
+                id: item.id,
+                label: item.label || item.name || '',
+                desctext: item.desctext,
+                path: item.path,
+                active: item.active,
+                closable: item.closable,
+            }));
+        }
+    }
+    catch {
+        // ignore
+    }
+    return [];
+};
+const saveBreadcrumbToStorage = (items) => {
+    try {
+        localStorage.setItem(BREADCRUMB_STORAGE_KEY, JSON.stringify(items));
+    }
+    catch {
+        // ignore
+    }
+};
+export const breadcrumbStore = create((set) => ({
+    items: loadBreadcrumbFromStorage(),
+    setItems: (items) => {
+        set({ items });
+    },
+    addItem: (item) => {
+        set((state) => {
+            if (state.items.some((i) => i.id === item.id)) {
+                return state;
+            }
+            return { items: [...state.items, item] };
+        });
+    },
+    removeItem: (id) => {
+        set((state) => ({
+            items: state.items.filter((item) => item.id !== id || item.closable === false),
+        }));
+    },
+    clearItems: () => {
+        set((state) => ({
+            items: state.items.filter((item) => item.closable === false),
+        }));
+    },
+    setActiveItem: (id) => {
+        set((state) => ({
+            items: state.items.map((item) => ({
+                ...item,
+                active: item.id === id,
+            })),
+        }));
+    },
+}));
+breadcrumbStore.subscribe((state) => {
+    saveBreadcrumbToStorage(state.items);
+});
+export const useBreadcrumbStore = breadcrumbStore;

package/fe/packages/ui/react/stores/language.d.ts

@@ -0,0 +1,4 @@
+export { getLanguage, i18n, t } from '../../../common/i18n';
+export type { I18nLanguage as Language } from '../../../common/i18n';
+export { useI18nStore as useLanguages } from '../i18n';
+//# sourceMappingURL=language.d.ts.map

package/fe/packages/ui/react/stores/language.js

@@ -0,0 +1,2 @@
+export { getLanguage, i18n, t } from '../../../common/i18n';
+export { useI18nStore as useLanguages } from '../i18n';

package/{typings/type.d.ts → fe/packages/ui/react/types/index.d.ts}

@@ -1,2 +1,2 @@
 export type MOmit<T, K extends keyof T> = Omit<T, K>;
-//# sourceMappingURL=type.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/fe/packages/ui/react/types/index.js

@@ -0,0 +1 @@
+export {};

package/fe/typings/type.d.ts

@@ -0,0 +1,5 @@
+export type MOmit<T, K extends keyof T> = Omit<T, K>;
+export type UnionToTuple<T> = [T] extends [never] ? [] : ((t: T) => T) extends (t: infer U) => infer U ? [...UnionToTuple<Exclude<T, U>>, U] : never;
+export type MergeType<T extends unknown[]> = T extends [infer F, ...infer R] ? F & (R extends [] ? MergeType<R> : {}) : {};
+export type GetInstance<T extends (...args: never[]) => unknown> = T extends (...args: never[]) => infer R ? R extends new () => infer C ? C : R extends Promise<infer P> ? P extends new () => infer C2 ? C2 : never : never : never;
+//# sourceMappingURL=type.d.ts.map

package/fe/typings/type.js

@@ -0,0 +1 @@
+export {};

package/model/index.d.ts

@@ -1,2 +1,2 @@
-export { test_2a, test_2a as default } from "./test2";
+export type { ModelDataType } from './types';
 //# sourceMappingURL=index.d.ts.map

package/model/test.d.ts

@@ -1,6 +1,2 @@
-export declare const a = 1;
-declare const _default: {
-    a: number;
-};
-export default _default;
+export {};
 //# sourceMappingURL=test.d.ts.map

package/model/types/data/button.d.ts

@@ -0,0 +1,32 @@
+import type { ButtonProps } from '../../../fe/packages/ui/react';
+import { ComponentNames } from './component';
+type ButtonTemplates = {
+    /**
+     * 按钮名
+     */
+    label?: string;
+} & ButtonProps;
+type ParamsValueData = 'schema::tableKey' | string | number;
+type RemoveBtn = {
+    eventKey: 'remove';
+    /**
+     * 事件配置 (参数配置)
+     */
+    eventOption: {
+        params: {
+            /**
+             *  @example user_id: 'schema::tableKey' | '123' | 123
+             */
+            [paramKey: string]: ParamsValueData;
+        };
+    };
+};
+type HandlerBtn = {
+    eventKey: 'callComponent';
+    eventOption: {
+        comName: ComponentNames;
+    };
+};
+export type BaseButton = ButtonTemplates & (RemoveBtn | HandlerBtn);
+export {};
+//# sourceMappingURL=button.d.ts.map

package/model/types/data/component.d.ts

@@ -0,0 +1,40 @@
+import type { FormFieldType, FormItemProps, SchemaFormAllPropsMap } from '../../../fe/packages/ui/react';
+import type { BuiltInCallComConfigMap } from '../../../fe/frontend/src/defaultPages/SchemaPage/components/CallCom/builtIn';
+export type { BuiltInCallComConfigMap, BuiltInCallComNames } from '../../../fe/frontend/src/defaultPages/SchemaPage/components/CallCom/builtIn';
+export declare namespace CallComNamespace {
+    interface ConfigMap {
+    }
+    interface OptionMap {
+    }
+}
+export type ComponentConfig = BuiltInCallComConfigMap & Partial<CallComNamespace.ConfigMap>;
+export type ComponentNames = Extract<keyof ComponentConfig, string>;
+type FormComponentOption = FormItemProps & {
+    /**
+     * 是否展示 默认为true
+     */
+    visible?: boolean;
+    /**
+     * 是否禁用
+     */
+    disbaled?: boolean;
+    /**
+     * 默认值
+     */
+    default?: any;
+} & ComponentOption;
+export type BuiltInCallComOptionMap = {
+    createForm: FormComponentOption;
+    editForm: FormComponentOption;
+    detailPanel: {};
+};
+export type ComponentsOption = BuiltInCallComOptionMap & Partial<{
+    [K in Exclude<ComponentNames, keyof BuiltInCallComOptionMap>]: K extends keyof CallComNamespace.OptionMap ? CallComNamespace.OptionMap[K] : Record<string, unknown>;
+}>;
+export type ComponentFieldOption<N extends ComponentNames> = N extends keyof BuiltInCallComOptionMap ? BuiltInCallComOptionMap[N] : N extends keyof CallComNamespace.OptionMap ? CallComNamespace.OptionMap[N] : Record<string, unknown>;
+export type ComponentOption = {
+    [K in FormFieldType]: {
+        comType: K;
+    } & (K extends keyof SchemaFormAllPropsMap ? SchemaFormAllPropsMap[K] : unknown);
+}[FormFieldType];
+//# sourceMappingURL=component.d.ts.map

package/model/types/data/fetchInfo.d.ts

@@ -0,0 +1,20 @@
+export type FetchInfo = {
+    /**
+     * 表单主键，  获取数据源的key
+     */
+    fetchKey: string;
+    /**
+     * 请求配置 如果不配置则使用 统一的 [get] api 内容
+     */
+    fetchConfig?: {
+        /**
+         * 获取数据的
+         */
+        url: string;
+        /**
+         * 请求方式
+         */
+        method?: 'get' | 'post';
+    };
+};
+//# sourceMappingURL=fetchInfo.d.ts.map

package/model/types/data/schema.d.ts

@@ -0,0 +1,98 @@
+import { TableColumnDef } from '../../../fe/packages/ui/react';
+import type { JSONSchema7 } from 'json-schema';
+import { MOmit } from '../../../fe/typings/type';
+import { BaseButton } from './button';
+import { ComponentConfig, ComponentNames, ComponentsOption } from './component';
+import { SearchOption } from './search';
+export type TableColumnsSchema = {
+    tableOption?: MOmit<TableColumnDef, 'key' | 'title'> & {
+        /**
+         * 是否显示
+         */
+        visible?: boolean;
+        /**
+         * 	保留几位小数
+         */
+        toFixed?: number;
+    };
+};
+export type TableSearchOption = {
+    /**
+     * 不配置则不在 search 中显示
+     */
+    searchOption?: {
+        /**
+         * 控件默认值
+         */
+        default?: any;
+    } & SearchOption;
+};
+export type TableConfig = {
+    /**
+     * table 头部按钮
+     */
+    headerButtons?: BaseButton[];
+    /**
+     * 每一行的按钮
+     */
+    rowButtons?: BaseButton[];
+};
+export type SearchConfig = {};
+export type BaseOption<O> = {
+    option: O;
+};
+export type UsedConfigSchema<T = {}> = {
+    type: 'object' | 'string' | 'array' | 'number' | 'boolean';
+    properties: {
+        /**
+         * [字段 key]: 字段描述
+         */
+        [key: string]: T & MOmit<UsedConfigSchema, 'properties'> & {
+            /**
+             * 展示 字符
+             */
+            label: string;
+            /**
+             *  原数据 序列化后 会丢失编写时的顺序
+             * 	字段层级  默认10
+             *
+             */
+            level?: number;
+        };
+    };
+    required?: string[];
+} & Omit<JSONSchema7, 'properties'>;
+export type TableComponentConfig = {
+    [K in ComponentNames as `${K & string}Option`]?: ComponentsOption[K];
+};
+export type ConfigSchema = UsedConfigSchema<TableColumnsSchema & TableSearchOption & TableComponentConfig>;
+export interface SchemaDataType {
+    /**
+     * 数据源地址  遵循 RESTFUL 规范
+     * *[参考地址](https://www.ruanyifeng.com/blog/2014/05/restful_api.html)*
+     *
+     * 即:
+     *
+     * - 获取数据 GET [api]
+     * - 新增数据 POST [api]
+     * - ...
+     */
+    api: string;
+    /**
+     * 板块数据结构
+     */
+    schema?: ConfigSchema;
+    /**
+     * 表格 (展示) 配置
+     */
+    tableConfig?: TableConfig;
+    /**
+     * 搜索 配置
+     */
+    searchConfig?: SearchConfig;
+    /**
+     * 模块组件
+     */
+    componentConfig?: ComponentConfig;
+}
+//# sourceMappingURL=schema.d.ts.map

package/model/types/data/search.d.ts

@@ -0,0 +1,7 @@
+import type { SchemaFormAllPropsMap, FormFieldType } from '../../../fe/packages/ui/react';
+export type SearchOption = {
+    [K in FormFieldType]: {
+        comType: K;
+    } & (K extends keyof SchemaFormAllPropsMap ? SchemaFormAllPropsMap[K] : unknown);
+}[FormFieldType];
+//# sourceMappingURL=search.d.ts.map

package/model/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { ModelDataType } from './model';
+export type { BuiltInCallComConfigMap, BuiltInCallComNames, BuiltInCallComOptionMap, CallComNamespace, ComponentConfig, ComponentFieldOption, ComponentNames, ComponentsOption, } from './data/component';
+//# sourceMappingURL=index.d.ts.map

package/model/types/menuType.d.ts

@@ -0,0 +1,73 @@
+import { SchemaDataType } from "./data/schema";
+/**
+ *  - parent menuLaout === 'top'
+ *    - child menuLayout === 'top' | 'left'
+ *  - parent menuLayout === 'left'
+ *    - child menuLayout === 'left'
+ */
+export type MenuLayout = "left" | "top";
+interface BaseMenu {
+    key: string;
+    icon?: string;
+    /**
+     * 菜单名称
+     */
+    name: string;
+}
+interface GroupMenuType<T extends MenuLayout> extends BaseMenu {
+    menuType: "group";
+    subMenu: T extends "top" ? TopMenuType[] : LeftMenuType[];
+}
+interface ModuleMenuType extends BaseMenu {
+    menuType: "module";
+}
+/**
+ *
+ * ----------------------------- moduletype -----------------------------
+ *
+ */
+interface IframeModuleType {
+    moduleType: "iframe";
+    iframeConfig: {
+        /**
+         * iframe 路径
+         */
+        path: string;
+    };
+}
+interface CustomModuleType {
+    moduleType: "custom";
+    customConfig: {
+        /**
+         * 自定义路由路径
+         */
+        path: string;
+    };
+}
+interface SchemaModuleType {
+    moduleType: "schema";
+    schemaConfig: SchemaDataType;
+}
+export interface SidebarModuleType {
+    moduleType: "sidebar";
+    sidebarConfig: {
+        menu: BaseMenuType[];
+        /**
+         * 只能为left
+         */
+        menuLayout?: "left";
+    };
+}
+export type BasicModuleType = SchemaModuleType | CustomModuleType | IframeModuleType;
+export type BaseMenuType = GroupMenuType<"left"> | (ModuleMenuType & BasicModuleType);
+type ModuleType = BasicModuleType | SidebarModuleType;
+/**
+ * top 包含所有
+ */
+export type TopMenuType = GroupMenuType<"top"> | (ModuleMenuType & ModuleType);
+/**
+ * left 不包含 sidebar
+ */
+export type LeftMenuType = GroupMenuType<"left"> | BaseMenuType;
+export {};
+//# sourceMappingURL=menuType.d.ts.map

package/model/types/model.d.ts

@@ -0,0 +1,33 @@
+import { TopMenuType, LeftMenuType } from "./menuType";
+type MTopMenuType = {
+    /**
+     * 默认为 left
+     */
+    menuLayout: "top";
+    menu: TopMenuType[];
+};
+type MLeftMenuType = {
+    /**
+     * 默认为 left
+     */
+    menuLayout?: "left";
+    menu: LeftMenuType[];
+};
+export type ModeMenuType = MTopMenuType | MLeftMenuType;
+export type ModelDataType = {
+    /**
+     * - 使用哪一块的模型数据 内置 MB
+     * 	- MB = 管理后台
+     */
+    mode: "MB";
+    key?: string;
+    name: string;
+    desc: string;
+    icon: string;
+    /**
+     * 首页(项目配置)
+     */
+    homePage: string;
+} & ModeMenuType;
+export {};
+//# sourceMappingURL=model.d.ts.map