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

package/fe/packages/ui/react/hooks/useExecuteOnce.d.ts

@@ -1,30 +0,0 @@
-export declare const executionPhaseType: {
-    readonly mount: "mount";
-    readonly render: "render";
-    readonly unMount: "unMount";
-};
-type ExecutionPhaseTypeKeys = keyof typeof executionPhaseType;
-export type ExecutionPhaseType = (typeof executionPhaseType)[ExecutionPhaseTypeKeys];
-/**
- *
- * @description 在各个阶段只触发一次
- *  @demo
- * ```
-    const count = useExecuteOnce(() => {
-        console.log('123'); // 只会在第一次render时触发
-        return 123
-    })
-
-    // count 123
-
- * ```
- */
-export default function useExecuteOnce<T>(factory: () => T, 
-/**
- * @default executionPhase = render
- */
-options?: {
-    executionPhase: ExecutionPhaseType[] | ExecutionPhaseType;
-}): T | null;
-export {};
-//# sourceMappingURL=useExecuteOnce.d.ts.map

package/fe/packages/ui/react/hooks/useExecuteOnce.js

@@ -1,57 +0,0 @@
-import { useEffect, useMemo, useRef } from 'react';
-export const executionPhaseType = {
-    mount: 'mount',
-    render: 'render',
-    unMount: 'unMount',
-};
-// type ExecutionPhaseType =
-//   (typeof executionPhaseType)[keyof typeof executionPhaseType];
-/**
- *
- * @description 在各个阶段只触发一次
- *  @demo
- * ```
-    const count = useExecuteOnce(() => {
-        console.log('123'); // 只会在第一次render时触发
-        return 123
-    })
-
-    // count 123
-
- * ```
- */
-export default function useExecuteOnce(factory, 
-/**
- * @default executionPhase = render
- */
-options) {
-    const { executionPhase: pExecutionPhase = executionPhaseType.render } = options ?? {};
-    const result = useRef(null);
-    const _executionPhase = useMemo(() => (typeof pExecutionPhase === 'string' ? [pExecutionPhase] : pExecutionPhase), [pExecutionPhase]);
-    const allowExecution = useRef([]);
-    // 跳过依赖;
-    const executionPhase = useRef(_executionPhase);
-    const runFN = (phase) => {
-        if (!allowExecution.current.includes(phase)) {
-            result.current = factory();
-            allowExecution.current.push(phase);
-        }
-    };
-    const fn = useRef(runFN);
-    executionPhase.current = _executionPhase;
-    fn.current = runFN;
-    if (executionPhase.current.includes(executionPhaseType.render)) {
-        fn.current(executionPhaseType.render);
-    }
-    useEffect(() => {
-        if (executionPhase.current.includes(executionPhaseType.mount)) {
-            fn.current(executionPhaseType['mount']);
-        }
-        return () => {
-            if (executionPhase.current.includes(executionPhaseType['unMount'])) {
-                fn.current(executionPhaseType['unMount']);
-            }
-        };
-    }, []);
-    return result.current;
-}

package/fe/packages/ui/react/hooks/useInit.js

@@ -1,9 +0,0 @@
-import { useRef } from 'react';
-const useInit = (callback) => {
-    const isInit = useRef(false);
-    if (!isInit.current) {
-        callback(isInit.current);
-        isInit.current = true;
-    }
-};
-export default useInit;

package/fe/packages/ui/react/hooks/useLanguage.d.ts

@@ -1,2 +0,0 @@
-export declare function useLanguage(): import("..").I18nStore;
-//# sourceMappingURL=useLanguage.d.ts.map

package/fe/packages/ui/react/hooks/useLanguage.js

@@ -1,4 +0,0 @@
-import { useLanguages } from '../stores/language';
-export function useLanguage() {
-    return useLanguages();
-}

package/fe/packages/ui/react/hooks/usePagination.js

@@ -1,27 +0,0 @@
-import { useCallback, useRef, useState } from 'react';
-import useInit from './useInit';
-export default function usePagination(params) {
-    const initValue = {
-        ...(params?.defaultValue ?? { current: 1, size: 10, total: 0 }),
-        onChange: () => { },
-    };
-    const paginationData = useRef({ ...initValue });
-    const [, changeView] = useState(0);
-    const updata = useCallback((params) => {
-        if (typeof params.current !== 'undefined') {
-            paginationData.current.current = params.current;
-        }
-        if (typeof params.size !== 'undefined') {
-            paginationData.current.size = params.size;
-        }
-        if (typeof params.total !== 'undefined') {
-            paginationData.current.total = params.total;
-        }
-        if ([params.size, params.current, params.total].some((i) => typeof i !== 'undefined'))
-            changeView((e) => e + 1);
-    }, []);
-    useInit(() => {
-        paginationData.current.onChange = updata;
-    });
-    return paginationData;
-}

package/fe/packages/ui/react/hooks/useRefState.js

@@ -1,29 +0,0 @@
-import { useState as RUS, useCallback, useLayoutEffect, useRef } from 'react';
-import useInit from './useInit';
-export default function useRefState(initialState) {
-    const [v, setValue] = RUS(initialState);
-    const data = useRef({ data: undefined });
-    const callbackRef = useRef(null);
-    const [callbackVersion, setCallbackVersion] = RUS(0);
-    useInit(() => {
-        data.current.data = v;
-    });
-    const setData = useCallback((action, callback) => {
-        const value = typeof action === 'function' ? action(data.current.data) : action;
-        setValue(value);
-        data.current.data = value;
-        if (callback) {
-            callbackRef.current = callback;
-            setCallbackVersion((version) => version + 1);
-        }
-    }, [setCallbackVersion, setValue]);
-    useLayoutEffect(() => {
-        if (callbackRef.current) {
-            const callback = callbackRef.current;
-            callbackRef.current = null;
-            callback(data.current.data);
-        }
-    }, [callbackVersion]);
-    return [v, setData, data];
-    // as [ExtractFNType<S>, SetState<S>];
-}

package/fe/packages/ui/react/hooks/useWatch.js

@@ -1,87 +0,0 @@
-import { useEffect, useRef } from 'react';
-export const identityCompare = (value, prevValue) => Object.is(value, prevValue);
-export const shallowCompare = (value, prevValue) => {
-    if (Object.is(value, prevValue)) {
-        return true;
-    }
-    if (Array.isArray(value) && Array.isArray(prevValue)) {
-        if (value.length !== prevValue.length) {
-            return false;
-        }
-        return value.every((item, index) => Object.is(item, prevValue[index]));
-    }
-    if (value &&
-        prevValue &&
-        typeof value === 'object' &&
-        typeof prevValue === 'object') {
-        const valuePrototype = Object.getPrototypeOf(value);
-        const prevValuePrototype = Object.getPrototypeOf(prevValue);
-        if (valuePrototype !== prevValuePrototype ||
-            (valuePrototype !== Object.prototype && valuePrototype !== null)) {
-            return false;
-        }
-        const valueKeys = Object.keys(value);
-        const prevValueKeys = Object.keys(prevValue);
-        if (valueKeys.length !== prevValueKeys.length) {
-            return false;
-        }
-        return valueKeys.every((key) => Object.prototype.hasOwnProperty.call(prevValue, key) &&
-            Object.is(value[key], prevValue[key]));
-    }
-    return false;
-};
-export const defaultCompare = (value, prevValue) => {
-    if (Array.isArray(value) && Array.isArray(prevValue)) {
-        return shallowCompare(value, prevValue);
-    }
-    return identityCompare(value, prevValue);
-};
-const getCompare = (compare) => {
-    if (compare === 'identity') {
-        return identityCompare;
-    }
-    if (compare === 'shallow') {
-        return shallowCompare;
-    }
-    return compare ?? defaultCompare;
-};
-const useStableWatchValue = (value, compare) => {
-    const valueRef = useRef(value);
-    if (!compare(value, valueRef.current)) {
-        valueRef.current = value;
-    }
-    return valueRef.current;
-};
-export function useWatch(source, selectorOrCallback, callbackOrOptions, options) {
-    const hasSelector = typeof callbackOrOptions === 'function';
-    const selector = hasSelector ? selectorOrCallback : null;
-    const callback = hasSelector
-        ? callbackOrOptions
-        : selectorOrCallback;
-    const watchOptions = hasSelector ? options : callbackOrOptions;
-    const nextValue = selector ? selector(source) : source;
-    const stableValue = useStableWatchValue(nextValue, getCompare(watchOptions?.compare));
-    const isInit = useRef(false);
-    const valueRef = useRef(stableValue);
-    const callbackRef = useRef(callback);
-    const optionsRef = useRef(watchOptions);
-    callbackRef.current = callback;
-    optionsRef.current = watchOptions;
-    useEffect(() => {
-        if (!isInit.current) {
-            isInit.current = true;
-            valueRef.current = stableValue;
-            if (optionsRef.current?.immediate) {
-                return callbackRef.current(stableValue, undefined);
-            }
-            return;
-        }
-        const prevValue = valueRef.current;
-        if (Object.is(stableValue, prevValue)) {
-            return;
-        }
-        valueRef.current = stableValue;
-        return callbackRef.current(stableValue, prevValue);
-    }, [stableValue]);
-}
-export default useWatch;

package/fe/packages/ui/react/hooks/useWatch.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=useWatch.test.d.ts.map

package/fe/packages/ui/react/hooks/useWatch.test.js

@@ -1,22 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { defaultCompare, identityCompare, shallowCompare } from './useWatch';
-test('defaultCompare treats inline arrays with the same items as equal', () => {
-    assert.equal(defaultCompare([1, 'a'], [1, 'a']), true);
-});
-test('defaultCompare detects changed array items', () => {
-    assert.equal(defaultCompare([1, 'a'], [1, 'b']), false);
-});
-test('defaultCompare uses identity for object values', () => {
-    assert.equal(defaultCompare({ current: 1 }, { current: 1 }), false);
-});
-test('identityCompare detects changed array references', () => {
-    assert.equal(identityCompare([1, 2], [1, 2]), false);
-});
-test('shallowCompare supports selector array results', () => {
-    assert.equal(shallowCompare([1, 10], [1, 10]), true);
-    assert.equal(shallowCompare([1, 10], [2, 10]), false);
-});
-test('shallowCompare does not treat non-plain objects as equal by empty keys', () => {
-    assert.equal(shallowCompare(new Date(0), new Date(0)), false);
-});

package/fe/packages/ui/react/i18n/I18nProvider.d.ts

@@ -1,31 +0,0 @@
-import type { I18nLanguage, I18nResources } from '../../../common/i18n';
-import { type ReactNode } from 'react';
-export interface I18nProviderProps {
-    /**
-     * 外部控制的显示语言。
-     */
-    language?: I18nLanguage;
-    /**
-     * 未命中当前语言文案时的兜底语言。
-     */
-    fallbackLanguage?: I18nLanguage;
-    /**
-     * 业务侧注入的多语言资源。
-     */
-    resources?: I18nResources;
-    /**
-     * 是否把传入 resources 和现有 resources 合并。默认 true。
-     */
-    mergeResources?: boolean;
-    /**
-     * 是否把 language 写入 localStorage。默认 true。
-     */
-    persist?: boolean;
-    /**
-     * localStorage key。
-     */
-    storageKey?: string;
-    children: ReactNode;
-}
-export declare function I18nProvider({ language, fallbackLanguage, resources, mergeResources, persist, storageKey, children, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=I18nProvider.d.ts.map

package/fe/packages/ui/react/i18n/I18nProvider.js

@@ -1,25 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { defaultLanguage, languageLocalKey } from '../../../common/i18n';
-import { useEffect } from 'react';
-import { useI18nStore } from './useI18n';
-export function I18nProvider({ language = defaultLanguage, fallbackLanguage = defaultLanguage, resources, mergeResources = true, persist = true, storageKey = languageLocalKey, children, }) {
-    const configureI18n = useI18nStore((state) => state.configureI18n);
-    const setLanguage = useI18nStore((state) => state.setLanguage);
-    const setFallbackLanguage = useI18nStore((state) => state.setFallbackLanguage);
-    const setResources = useI18nStore((state) => state.setResources);
-    useEffect(() => {
-        configureI18n({ persist, storageKey });
-    }, [configureI18n, persist, storageKey]);
-    useEffect(() => {
-        setLanguage(language);
-    }, [language, setLanguage]);
-    useEffect(() => {
-        setFallbackLanguage(fallbackLanguage);
-    }, [fallbackLanguage, setFallbackLanguage]);
-    useEffect(() => {
-        if (!resources)
-            return;
-        setResources(resources, { merge: mergeResources });
-    }, [mergeResources, resources, setResources]);
-    return _jsx(_Fragment, { children: children });
-}

package/fe/packages/ui/react/i18n/index.d.ts

@@ -1,4 +0,0 @@
-export * from '../../../common/i18n';
-export * from './I18nProvider';
-export * from './useI18n';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,3 +0,0 @@
-export * from '../../../common/i18n';
-export * from './I18nProvider';
-export * from './useI18n';

package/fe/packages/ui/react/i18n/useI18n.d.ts

@@ -1,13 +0,0 @@
-import type { I18nInterpolationValues, I18nTranslateOptions } from '../../../common/i18n';
-export declare const useI18nStore: import("..").StoreHook<{
-    getState: () => import("..").I18nStore;
-    getInitialState: () => import("..").I18nStore;
-    setState: (partial: Partial<import("..").I18nStore> | ((state: import("..").I18nStore) => Partial<import("..").I18nStore>)) => void;
-    subscribe: (listener: import("..").I18nStoreListener) => () => void;
-}>;
-/**
- * React 组件内使用的翻译 hook。
- * 会订阅 language、fallbackLanguage、resources，语言或资源变化时触发组件更新。
- */
-export declare function useI18n(): <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;
-//# sourceMappingURL=useI18n.d.ts.map

package/fe/packages/ui/react/i18n/useI18n.js

@@ -1,18 +0,0 @@
-import { i18nStore, translate } from '../../../common/i18n';
-import { useCallback } from 'react';
-import { createStoreHook } from '../lib/createStoreHook';
-export const useI18nStore = createStoreHook(i18nStore);
-/**
- * React 组件内使用的翻译 hook。
- * 会订阅 language、fallbackLanguage、resources，语言或资源变化时触发组件更新。
- */
-export function useI18n() {
-    const language = useI18nStore((state) => state.language);
-    const fallbackLanguage = useI18nStore((state) => state.fallbackLanguage);
-    const resources = useI18nStore((state) => state.resources);
-    return useCallback((key, fillingData, options) => translate({
-        language,
-        fallbackLanguage,
-        resources,
-    }, key, fillingData, options), [fallbackLanguage, language, resources]);
-}

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

@@ -1,5 +0,0 @@
-export * from './components';
-export * from './i18n';
-export * from './lib/createStoreHook';
-export * from './lib/utils';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +0,0 @@
-export * from './components';
-export * from './i18n';
-// export * from './hooks'
-// export * from './stores'
-export * from './lib/createStoreHook';
-export * from './lib/utils';

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

@@ -1,6 +0,0 @@
-import { useStore } from 'zustand';
-export function createStoreHook(store) {
-    return ((selector) => {
-        return selector ? useStore(store, selector) : useStore(store);
-    });
-}

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

@@ -1,66 +0,0 @@
-/**
- * 导出 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 { type TableColumnDef } from '../components';
-export declare const ExportType: {
-    /**
-     * 当前查询条件下所有页
-     */
-    readonly all: 0;
-    /**
-     * 当前页
-     */
-    readonly current: 1;
-};
-export type ExportType = (typeof ExportType)[keyof typeof ExportType];
-interface ExportExcelParams<T> {
-    /** 获取数据方法 */
-    fetchData: (pageNum: number, pageSize: number, searchParams?: Record<string, any>) => Promise<{
-        records: T[];
-        total: number;
-    }>;
-    /** 直接复用 DataTable 的 columns 配置  会自动过滤 操作栏*/
-    columns: TableColumnDef<T>[];
-    /** 导出类型：all=当前查询条件下所有页；current=当前页 */
-    exportType: ExportType;
-    /** 当前页码（导出当前页时使用）默认 1 */
-    currentPage?: number;
-    /** 每页条数，默认 2000 */
-    pageSize?: number;
-    /**
-     * 最大导出条数，超过则停止继续请求
-     * @default 10000
-     */
-    maxCount?: number;
-    /**
-     * 当前页已有数据
-     * - 当 exportType === 'current' 且传入该字段时，将直接使用该数据，不会再次请求接口
-     */
-    currentPageData?: T[];
-    /** 文件名（不含扩展名），默认：export-YYYYMMDDHHmmss */
-    fileName?: string;
-}
-/**
- * 通用导出 Excel 方法
- */
-export declare function exportToExcel<T>(options: ExportExcelParams<T>): Promise<void>;
-export {};
-//# sourceMappingURL=export.d.ts.map

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

@@ -1,138 +0,0 @@
-/**
- * 导出 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

@@ -1,34 +0,0 @@
-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