@_tc/template-core 0.0.1-bate.2 → 0.0.1-bate.21

package/esm/packages/core/types.d.ts

@@ -0,0 +1,75 @@
+import Koa from "koa";
+import type Router from "koa-router";
+import type { EnvReturn } from "./env";
+import type { AppPathInfo } from "./paths";
+export interface IService {
+    [key: string]: unknown;
+}
+export interface IController {
+    [key: string]: unknown;
+}
+export interface IExtends {
+    [key: string]: unknown;
+}
+export interface IMiddlewares {
+    [key: string]: unknown;
+}
+export declare namespace FrameworkAugment {
+    interface IServiceAugmented {
+    }
+    interface IControllerAugmented {
+    }
+    interface IExtendsAugmented {
+    }
+    interface IMiddlewaresAugmented {
+    }
+    interface AppConfigAugmented {
+    }
+}
+export type ICTX = Parameters<Router.IMiddleware<any, {}>>[0];
+export interface KoaAppExtensions {
+    baseDir: string;
+    frameBaseDir: string;
+    businessPath: string;
+    paths: AppPathInfo[];
+    framePath: string;
+    envs: EnvReturn;
+    config: FrameworkAugment.AppConfigAugmented;
+    extends: FrameworkAugment.IExtendsAugmented;
+    controller: FrameworkAugment.IControllerAugmented;
+    service: FrameworkAugment.IServiceAugmented;
+    middlewares: FrameworkAugment.IMiddlewaresAugmented;
+    model: unknown[];
+    routerSchema: Record<string, unknown>;
+    currentUseRouter: Router;
+    options: AppOptions;
+    logger?: {
+        info: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+    };
+    [key: string]: unknown;
+}
+export interface AppConfigBase {
+    port?: number;
+    host?: string;
+    env?: string;
+}
+export interface AppConfig extends AppConfigBase {
+    [key: string]: unknown;
+}
+export interface StartOptions {
+    name?: string;
+    homePage?: string;
+    frameBaseDir?: string;
+}
+export interface AppOptions extends StartOptions {
+    overwriteOriginalLogs?: boolean;
+    [key: string]: unknown;
+}
+export type KoaApp = Koa & KoaAppExtensions;
+export type KoaMiddleware = Koa.Middleware;
+export type { EnvType, EnvKeys } from "./env";
+/** 文件处理回调函数 */
+export type ProcessingFileCallbackFN = <T extends Record<string, unknown>>(fileName: string, filePath: string, isDir: boolean, tempData: T) => T | undefined;
+//# sourceMappingURL=types.d.ts.map

package/esm/packages/core/types.js

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

package/esm/packages/utils/getAllFilesInFolder.d.ts

@@ -0,0 +1,10 @@
+export interface GetAllFilesInFolder {
+    /**
+     *
+     * @param paths
+     * @returns filesPath
+     */
+    getAllFilesInFolder(...paths: string[]): string[];
+}
+export declare const getAllFilesInFolder: (...paths: string[]) => string[];
+//# sourceMappingURL=getAllFilesInFolder.d.ts.map

package/esm/packages/utils/getAllFilesInFolder.js

@@ -0,0 +1,8 @@
+import { resolve } from "./path";
+import * as glob from "glob";
+export const getAllFilesInFolder = (...paths) => {
+    const filePath = resolve(...paths);
+    const fileList = glob.sync(resolve(filePath, "**", "*.js"));
+    const tFileList = glob.sync(resolve(filePath, "**", "*.ts")).filter(f => f.indexOf('.d.ts') === -1);
+    return [...fileList, ...tFileList];
+};

package/esm/packages/utils/getAllFnReturnValue.js

@@ -0,0 +1,6 @@
+"use strict";
+// export const getAllFnReturnValue =<T>(fnValue: T | Promise<T> ) =>{
+// if(fnValue instanceof Promise){
+//     retu
+// }
+// }

package/esm/packages/utils/index.js

@@ -0,0 +1,4 @@
+export * from "./path";
+export * from "./loadFile";
+export * from "./getAllFilesInFolder";
+export * from "./runFileFn";

package/esm/packages/utils/loadFile.d.ts

@@ -0,0 +1,21 @@
+export type PreProcessingFileCallbackFN = <T extends Record<string, any>>(filePath: string, result: T) => any;
+export type ProcessingFileCallbackFN = <T extends Record<string, any>>(fileName: string, filePath: string, isDir: boolean, tempData: T) => T | undefined;
+export type LoadFileCallbackFN = (filePath: string) => any;
+export interface LoadFileCallbackOptions {
+    loadFileCallback?: LoadFileCallbackFN;
+    processingFileCallback?: ProcessingFileCallbackFN;
+    preProcessingFileCallback?: PreProcessingFileCallbackFN;
+}
+/**
+ *
+ * @param baseDir
+ * @param key
+ * @param callbackOpt
+ */
+declare function loadFileFn<T extends Record<string, unknown>>(baseDir: string, key: string, callbackOpt?: LoadFileCallbackOptions): T;
+export { loadFileFn };
+declare const _default: {
+    loadFileFn: typeof loadFileFn;
+};
+export default _default;
+//# sourceMappingURL=loadFile.d.ts.map

package/esm/packages/utils/loadFile.js

@@ -0,0 +1,63 @@
+import { getAllFilesInFolder } from "./getAllFilesInFolder";
+import { resolve, splicing } from "./path";
+import { sep } from "path";
+/**
+ *
+ * @param baseDir
+ * @param key
+ * @param callbackOpt
+ */
+function loadFileFn(baseDir, key, callbackOpt) {
+    const { loadFileCallback, processingFileCallback, preProcessingFileCallback, } = callbackOpt ?? {};
+    if (!key ||
+        !(loadFileCallback || processingFileCallback || preProcessingFileCallback)) {
+        throw Error(!key ? "key is request" : "callbackOpt is request");
+    }
+    const { _processingFileCallback, _preProcessingFileCallback } = {
+        _processingFileCallback: processingFileCallback
+            ? processingFileCallback
+            : (fileName, filePath, isDir, tempData) => {
+                if (!isDir) {
+                    // 最后一级
+                    const fileContent = loadFileCallback(filePath);
+                    if (fileContent)
+                        tempData[fileName] = fileContent;
+                    return undefined;
+                }
+                else {
+                    if (tempData[fileName]) {
+                        tempData[fileName] = {};
+                    }
+                    return tempData[fileName];
+                }
+            },
+        _preProcessingFileCallback: preProcessingFileCallback
+            ? preProcessingFileCallback
+            : (name, result) => {
+                const searchString = splicing(key, { position: "after" });
+                const file = name;
+                name = name.substring(name.lastIndexOf(searchString) + searchString.length, name.lastIndexOf("."));
+                //  -_ 转为驼峰
+                name = name.replace(/[_-].{1}/gi, (key) => key[1].toUpperCase());
+                let tempData = result;
+                const names = name.split(sep);
+                for (let index = 0; index < names.length; index++) {
+                    const tName = names[index];
+                    const tempResult = _processingFileCallback(tName, file, index !== names.length - 1, tempData);
+                    if (tempResult) {
+                        tempData = tempResult;
+                    }
+                }
+                return result;
+            },
+    };
+    const fileList = getAllFilesInFolder(baseDir, key);
+    let result = {};
+    fileList.forEach((file) => {
+        // 提取文件名称
+        result = _preProcessingFileCallback(resolve(file), result);
+    });
+    return result;
+}
+export { loadFileFn };
+export default { loadFileFn };

package/esm/packages/utils/path.d.ts

@@ -0,0 +1,25 @@
+export interface SplicingOptions {
+    /**
+     * @default '/''
+     */
+    symbol?: string;
+    /**
+     * @default before
+     */
+    position?: "after" | "before";
+}
+/**
+ *  splicing('path') : /path
+ */
+export declare function splicing(str: string, opt?: SplicingOptions): string;
+/**
+ *
+ * @param paths
+ * @description input [a,b,c] -> out a/b/c
+ *
+ * window: input [a,b,c] -> out a\b\c
+ *
+ * 拼接路径
+ */
+export declare function resolve(...paths: string[]): string;
+//# sourceMappingURL=path.d.ts.map

package/esm/packages/utils/path.js

@@ -0,0 +1,27 @@
+import * as path from "path";
+import { sep } from "path";
+/**
+ *  splicing('path') : /path
+ */
+export function splicing(str, opt) {
+    const { symbol, position } = opt ?? {
+        symbol: sep,
+        position: "before",
+    };
+    // before <- symbol + str
+    // after -> str + symbol
+    return [str, symbol][position === "before" ? "reduceRight" : "reduce"]((o, c) => o + c, "");
+}
+/**
+ *
+ * @param paths
+ * @description input [a,b,c] -> out a/b/c
+ *
+ * window: input [a,b,c] -> out a\b\c
+ *
+ * 拼接路径
+ */
+export function resolve(...paths) {
+    const [basePath, ...otherPath] = paths;
+    return path.resolve(basePath, otherPath.length ? "." + splicing(otherPath.join(sep)) : "");
+}

package/esm/packages/utils/runFileFn.js

@@ -0,0 +1 @@
+export const runFileFn = (fn) => typeof fn === "function" ? fn : fn.default;

package/esm/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;
+//# sourceMappingURL=type.d.ts.map

package/esm/typings/type.js

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

package/fe/frontend/main.js

@@ -0,0 +1,6 @@
+import { createRoot } from "react-dom/client";
+export const initApp = (rootComponent) => {
+    const root = createRoot(document.getElementById("#root"));
+    // 挂在 根节点
+    root.render(rootComponent);
+};

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

@@ -0,0 +1,3 @@
+declare const _default: () => import("react/jsx-runtime").JSX.Element;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/fe/frontend/testPage/index.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "../../packages/ui/react/components";
+import TestPage from "../../packages/ui/react/components/testPage";
+export default () => {
+    return (_jsxs("div", { children: [_jsx("h1", { children: "test page" }), _jsx(Button, { children: "click me" }), _jsx(TestPage, {})] }));
+};

package/fe/frontend/testPage/testPage.entry.d.ts

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

package/fe/frontend/testPage/testPage.entry.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import App from "./index";
+import { initApp } from "../main";
+initApp(_jsx(App, {}));

package/fe/packages/ui/react/assets/table/no-result.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="120" height="120" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">
+  <rect x="3" y="3" width="18" height="18" rx="2" ry="2"/>
+  <line x1="3" y1="9" x2="21" y2="9"/>
+  <line x1="9" y1="21" x2="9" y2="9"/>
+</svg>

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

@@ -2,12 +2,36 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react';
 export type ButtonVariant = 'default' | 'primary' | 'text' | 'link';
 export type ButtonSize = 'sm' | 'md' | 'lg';
 export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * 按钮变体
+     * @default 'default'
+     */
     variant?: ButtonVariant;
+    /**
+     * 按钮尺寸
+     * @default 'md'
+     */
     size?: ButtonSize;
+    /**
+     * 是否显示加载状态
+     */
     loading?: boolean;
+    /**
+     * 左侧图标
+     */
     leftIcon?: ReactNode;
+    /**
+     * 右侧图标
+     */
     rightIcon?: ReactNode;
+    /**
+     * 是否去除下划线（仅对 variant="link" 有效）
+     * @default false
+     */
     noUnderline?: boolean;
+    /**
+     * 作为子元素，用于更灵活的布局
+     */
     children?: ReactNode;
 }
 declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;

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

@@ -0,0 +1,42 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../../lib/utils';
+import { forwardRef } from 'react';
+const Button = forwardRef(({ className, variant = 'default', size = 'md', disabled, loading, leftIcon, rightIcon, noUnderline, children, ...props }, ref) => {
+    const isDisabled = disabled || loading;
+    // 基础样式
+    const baseStyles = 'inline-flex items-center justify-center rounded-lg font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2';
+    // 变体样式
+    const variantStyles = {
+        default: 'bg-white border border-border text-foreground hover:bg-muted/50 focus-visible:ring-border',
+        primary: 'bg-theme text-theme-foreground border border-theme hover:bg-theme/90 focus-visible:ring-theme',
+        text: 'bg-transparent border-0 text-foreground hover:bg-muted/30 focus-visible:ring-border',
+        // 链接样式按钮：无背景、无边框、与正文相同颜色，仅在悬停时下划线（可通过 noUnderline 控制）
+        link: 'bg-transparent border-0 text-foreground focus-visible:ring-border',
+    };
+    // 禁用状态样式（根据不同 variant）
+    const disabledStyles = {
+        default: 'disabled:bg-white/60 disabled:border-border/60 disabled:text-foreground/60 disabled:hover:bg-white/60',
+        primary: 'disabled:bg-theme/60 disabled:border-theme/0 disabled:text-theme-foreground/60 disabled:hover:bg-theme/60',
+        text: 'disabled:text-foreground/40 disabled:hover:bg-transparent',
+        link: 'disabled:text-foreground/40',
+    };
+    // 尺寸样式
+    const sizeStyles = {
+        sm: 'h-8 px-3 text-sm',
+        md: 'h-10 px-4 text-sm',
+        lg: 'h-12 px-6 text-base',
+    };
+    // 展示内容
+    const contents = [
+        leftIcon && (_jsx("span", { className: cn('flex items-center', 'mr-2'), children: leftIcon }, "left")),
+        children,
+        rightIcon ? (_jsx("span", { className: cn('flex items-center', 'ml-2'), children: rightIcon }, "right")) : undefined,
+    ].filter(Boolean);
+    return (_jsx("button", { ref: ref, className: cn(baseStyles, variantStyles[variant], disabledStyles[variant], 
+        // link 模式不固定高度/内边距，更接近普通文字
+        variant === 'link' ? 'h-auto px-0 py-0 text-sm font-normal' : sizeStyles[size], variant === 'link' ? '' : 'before:content-normal', 
+        // link 模式下，根据 noUnderline 控制下划线
+        variant === 'link' && !noUnderline && 'hover:underline', variant === 'link' && !noUnderline && 'disabled:hover:no-underline', isDisabled && 'cursor-not-allowed', className), disabled: isDisabled, ...props, children: contents }));
+});
+Button.displayName = 'Button';
+export { Button };

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

@@ -3,6 +3,10 @@ import { type ButtonProps } from './Button';
 export type SumbitButtonProps = MOmit<ButtonProps, '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 };

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

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../lib/utils';
+import { useState } from 'react';
+import { Button } from './Button';
+/**
+ *
+ * 会自动添加loading 其余同button一致
+ */
+const SumbitButton = (props) => {
+    const { onClick, leftIcon, size = 'md', ...bprops } = props;
+    const [loading, uLoading] = useState(false);
+    // Loading spinner icon - 根据按钮尺寸调整大小
+    const spinnerSize = {
+        sm: 'h-3 w-3',
+        md: 'h-4 w-4',
+        lg: 'h-5 w-5',
+    };
+    const loadingIcon = loading ? (_jsx("span", { className: cn('flex items-center', 'mr-2'), children: _jsxs("svg", { className: cn('animate-spin', spinnerSize[size]), xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", children: [_jsx("circle", { className: "opacity-25", cx: "12", cy: "12", r: "10", stroke: "currentColor", strokeWidth: "4" }), _jsx("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" })] }) })) : null;
+    return (_jsx(Button, { loading: loading, leftIcon: loading ? loadingIcon : leftIcon, onClick: async (e) => {
+            if (loading)
+                return;
+            uLoading(true);
+            try {
+                return await onClick?.(e);
+            }
+            finally {
+                uLoading(false);
+            }
+        }, ...bprops }));
+};
+const AsynchronousButton = SumbitButton;
+export { AsynchronousButton, SumbitButton };

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

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

package/{packages → fe/packages}/ui/react/components/Checkbox/Checkbox.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Checkbox = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
-const utils_1 = require("../../lib/utils");
-const react_1 = require("react");
-const Checkbox = (0, react_1.forwardRef)(({ className, checked: _controlledChecked, value, defaultChecked, indeterminate, onChange, ...props }, ref) => {
-    const internalRef = (0, react_1.useRef)(null);
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../../lib/utils';
+import { forwardRef, useLayoutEffect, useRef, useState } from 'react';
+const Checkbox = forwardRef(({ className, checked: _controlledChecked, value, defaultChecked, indeterminate, onChange, ...props }, ref) => {
+    const internalRef = useRef(null);
     const controlledChecked = value ?? _controlledChecked;
     const setRefs = (element) => {
         internalRef.current = element;
@@ -19,13 +16,13 @@ const Checkbox = (0, react_1.forwardRef)(({ className, checked: _controlledCheck
             element.indeterminate = indeterminate ?? false;
         }
     };
-    (0, react_1.useLayoutEffect)(() => {
+    useLayoutEffect(() => {
         if (internalRef.current) {
             internalRef.current.indeterminate = indeterminate ?? false;
         }
     }, [indeterminate]);
     const isControlled = controlledChecked !== undefined;
-    const [internalChecked, setInternalChecked] = (0, react_1.useState)(defaultChecked ?? false);
+    const [internalChecked, setInternalChecked] = useState(defaultChecked ?? false);
     const checked = isControlled ? controlledChecked : internalChecked;
     const handleChange = (e) => {
         const newChecked = e.target.checked;
@@ -34,8 +31,7 @@ const Checkbox = (0, react_1.forwardRef)(({ className, checked: _controlledCheck
         }
         onChange?.(newChecked, e);
     };
-    return ((0, jsx_runtime_1.jsx)("input", { type: "checkbox", ref: setRefs, checked: checked, onChange: handleChange, className: (0, utils_1.cn)('w-4 h-4 rounded border-gray-300 accent-theme', className), ...props }));
+    return (_jsx("input", { type: "checkbox", ref: setRefs, checked: checked, onChange: handleChange, className: cn('w-4 h-4 rounded border-gray-300 accent-theme', className), ...props }));
 });
-exports.Checkbox = Checkbox;
 Checkbox.displayName = 'Checkbox';
-//# sourceMappingURL=Checkbox.js.map
+export { Checkbox };

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

@@ -0,0 +1 @@
+export * from './Checkbox';

package/{packages → fe/packages}/ui/react/components/ConfirmDialog.d.ts

@@ -1,11 +1,19 @@
 export interface ConfirmDialogProps {
+    /** 是否显示 */
     open: boolean;
+    /** 标题 */
     title?: string;
+    /** 内容 */
     content: string;
+    /** 确认按钮文本 */
     okText?: string;
+    /** 取消按钮文本 */
     cancelText?: string;
+    /** 确认按钮加载状态 */
     loading?: boolean;
+    /** 确认回调 */
     onOk: () => void | Promise<void>;
+    /** 取消回调 */
     onCancel: () => void;
 }
 export declare function ConfirmDialog({ open, title, content, okText, cancelText, loading, onOk, onCancel, }: ConfirmDialogProps): import("react/jsx-runtime").JSX.Element;

package/fe/packages/ui/react/components/ConfirmDialog.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from './Button';
+import { Modal } from './Modal';
+export function ConfirmDialog({ open, title = '提示', content, okText = '确认', cancelText = '取消', loading = false, onOk, onCancel, }) {
+    const handleOk = async () => {
+        await onOk();
+    };
+    return (_jsx(Modal, { open: open, onClose: onCancel, title: title, width: 450, footer: _jsxs("div", { className: "flex justify-end gap-3", children: [_jsx(Button, { onClick: onCancel, className: "min-w-[100px] bg-white border-[hsl(var(--theme-primary))] text-[hsl(var(--theme-primary))] hover:bg-[hsl(var(--theme-primary))]/5", children: cancelText }), _jsx(Button, { variant: "primary", loading: loading, onClick: handleOk, className: "min-w-[100px] bg-[hsl(var(--theme-primary))] hover:bg-[hsl(var(--theme-primary))]/90 border-[hsl(var(--theme-primary))] text-[hsl(var(--theme-primary-foreground))]", children: okText })] }), children: _jsx("div", { className: "py-4 text-base text-foreground", children: content }) }));
+}

package/fe/packages/ui/react/components/DataTable/ActionBtn.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MoreHorizontal } from 'lucide-react';
+import { Dropdown } from '../Dropdown';
+export const ActionBtn = ({ actions }) => {
+    if (actions.length === 0) {
+        return '-';
+    }
+    if (actions.length === 1) {
+        const action = actions[0];
+        return (_jsx("button", { onClick: action.onClick, className: "inline-flex items-center justify-center w-8 h-8 rounded transition-colors", children: action.label }));
+    }
+    return (_jsx(Dropdown, { items: actions, children: _jsx("button", { className: "inline-flex items-center justify-center w-8 h-8 rounded transition-colors", children: _jsx(MoreHorizontal, { className: "h-5 w-5 text-gray-600" }) }) }));
+};

package/{packages → fe/packages}/ui/react/components/DataTable/data-table.d.ts

@@ -3,10 +3,25 @@ import { type PaginationProps } from '../Pagination';
 import type { ColumnDef } from '../types/baseType';
 export type { ColumnDef } from '../types/baseType';
 type RowSelection<T> = {
+    /**
+     * 受控用法：完全由外部维护选中 keys
+     */
     selectedRowKeys?: Array<string | number>;
+    /**
+     * 非受控用法：仅作为初始值，后续由内部维护
+     */
     defaultSelectedRowKeys?: Array<string | number>;
+    /**
+     * 选中项变化回调（受控/非受控都会触发）
+     */
     onChange?: (selectedRowKeys: Array<string | number>, selectedRows: T[], isAll: boolean) => void;
+    /**
+     * 全选 受控
+     */
     isAll?: boolean;
+    /**
+     * theader checkbox
+     */
     beforeCheckboxNode?: ReactNode;
 };
 interface DataTableProps<T = Record<string, unknown>> {
@@ -16,6 +31,10 @@ interface DataTableProps<T = Record<string, unknown>> {
     rowSelection?: RowSelection<T>;
     pagination?: PaginationProps;
     loading?: boolean;
+    /**
+     * 统一配置 column width 默认100px
+     * 会被columns[number].width覆盖
+     */
     defaultColumnWidth?: number;
 }
 export declare function DataTable<T = Record<string, unknown>>({ columns, data: pData, loading, rowKey, rowSelection, defaultColumnWidth, pagination: pPagination, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;