@cloudtower/eagle 0.0.0-no-uikit-1 → 0.0.0-theme-rc-1

package/dist/src/core/SmallDialog/SmallDialog.type.d.ts

@@ -0,0 +1,199 @@
+import { ButtonProps } from "../../core/Button";
+import { SafeReactNode } from "../../spec";
+import React from "react";
+/**
+ * @description 小尺寸弹窗组件，固定宽度 492px，适用于确认操作、简短表单、信息提示等场景。
+ * 通过 `usePushModal` 打开弹窗，在 `onOk`/`onCancel` 回调中调用 `popModal()` 关闭弹窗。
+ * 弹窗基于 Redux 模态栈管理（KitStoreProvider），支持多层弹窗嵌套。
+ *
+ * @example 基础确认弹窗
+ * ```tsx
+ * import { SmallDialog } from "@cloudtower/eagle";
+ * import { usePushModal } from "@cloudtower/eagle/lib/core/KitStoreProvider";
+ *
+ * const MyComponent = () => {
+ *   const pushModal = usePushModal();
+ *
+ *   const openDialog = () => {
+ *     pushModal(
+ *       <SmallDialog
+ *         title="确认操作"
+ *         onOk={(popModal) => {
+ *           // 执行确认逻辑
+ *           popModal();
+ *         }}
+ *         onCancel={(popModal) => {
+ *           popModal();
+ *         }}
+ *       >
+ *         确定要执行此操作吗？
+ *       </SmallDialog>
+ *     );
+ *   };
+ *
+ *   return <Button onClick={openDialog}>打开弹窗</Button>;
+ * };
+ * ```
+ *
+ * @example 异步提交弹窗（含 confirmLoading）
+ * ```tsx
+ * const [loading, setLoading] = useState(false);
+ *
+ * pushModal(
+ *   <SmallDialog
+ *     title="删除确认"
+ *     confirmLoading={loading}
+ *     onOk={async (popModal) => {
+ *       setLoading(true);
+ *       try {
+ *         await deleteResource();
+ *         popModal();
+ *       } catch (e) {
+ *         // 处理错误，弹窗保持打开
+ *       } finally {
+ *         setLoading(false);
+ *       }
+ *     }}
+ *     onCancel={(popModal) => popModal()}
+ *   >
+ *     删除后数据将无法恢复，是否继续？
+ *   </SmallDialog>
+ * );
+ * ```
+ *
+ * @see MediumDialog 中等尺寸弹窗（720px），适用于复杂表单
+ * @see ImmersiveDialog 沉浸式全屏弹窗，适用于复杂表单和详情编辑
+ * @see WizardDialog 向导式弹窗，适用于分步操作
+ * @see DeleteDialog 删除确认弹窗，基于 SmallDialog 的业务封装，位于 coreX/Dialogs/
+ * @see RejectDialog 操作拒绝反馈弹窗，基于 SmallDialog 的业务封装，位于 coreX/Dialogs/
+ */
+export interface SmallDialogProps {
+    /**
+     * 弹窗宽度
+     * @default 492
+     */
+    width?: number | string;
+    /** 弹窗标题，支持 ReactNode 自定义渲染 */
+    title: SafeReactNode;
+    /**
+     * 自定义标题渲染组件，替换默认的标题渲染逻辑。
+     * 默认标题使用 `Typo.Display.d2_bold_title` 样式。
+     */
+    TitleRender?: React.FC<{
+        title?: SafeReactNode;
+    }>;
+    /** 取消按钮文案，默认根据 `showOk` 决定：showOk=true 时为"取消"，showOk=false 时为"关闭" */
+    cancelText?: string;
+    /** 确认按钮文案，默认为"确认"；当 `initializingError` 有值时默认为"重试" */
+    okText?: string;
+    /**
+     * 是否显示确认按钮。设为 false 时仅显示取消按钮，
+     * 且取消按钮样式从 `quiet` 变为 `ordinary`，文案默认从"取消"变为"关闭"。
+     * @default true
+     */
+    showOk?: boolean;
+    /**
+     * 点击确认按钮的回调。
+     * @param popModal - 关闭当前弹窗的函数，调用后将弹窗从模态栈中移除。
+     * 在异步操作中，可先执行业务逻辑，成功后再调用 popModal() 关闭弹窗；
+     * 若未提供 onOk，点击确认按钮将直接调用 popModal() 关闭弹窗。
+     *
+     * @example
+     * ```tsx
+     * onOk={async (popModal) => {
+     *   await submitData();
+     *   popModal();
+     * }}
+     * ```
+     */
+    onOk?: (popModal: () => void) => void;
+    /**
+     * 点击取消按钮、右上角关闭按钮或遮罩层时的回调。
+     * @param popModal - 关闭当前弹窗的函数，调用后将弹窗从模态栈中移除。
+     * 若未提供 onCancel，上述关闭操作将直接调用 popModal() 关闭弹窗。
+     *
+     * @example
+     * ```tsx
+     * onCancel={(popModal) => {
+     *   // 可在关闭前执行清理逻辑
+     *   popModal();
+     * }}
+     * ```
+     */
+    onCancel?: (popModal: () => void) => void;
+    /**
+     * 是否可点击遮罩层关闭弹窗，点击遮罩层会触发 onCancel 回调
+     * @default true
+     */
+    maskClosable?: boolean;
+    /**
+     * 是否显示右上角关闭按钮，点击关闭按钮会触发 onCancel 回调
+     * @default true
+     */
+    closable?: boolean;
+    /** 自定义弹窗容器类名 */
+    className?: string;
+    /** 自定义 footer 区域类名 */
+    footerClassName?: string;
+    /** 确认按钮的额外属性，会透传给 Button 组件。若同时设置了 okText，okText 优先 */
+    okButtonProps?: ButtonProps;
+    /** 取消按钮的额外属性，会透传给 Button 组件。若同时设置了 cancelText，cancelText 优先 */
+    cancelButtonProps?: ButtonProps;
+    /** 弹窗主体内容，当 `initializing` 为 true 时显示骨架屏，当 `initializingError` 有值时显示错误状态 */
+    children?: SafeReactNode;
+    /** 展示在 footer 区域的错误文案，支持 ReactNode。最多显示 3 行，超出后 tooltip 展示完整内容 */
+    error?: SafeReactNode;
+    /**
+     * 是否隐藏 footer 区域（包括确认/取消按钮和错误信息）
+     * @default false
+     */
+    hideFooter?: boolean;
+    /**
+     * 是否在 footer 错误文案前展示错误图标
+     * @default true
+     */
+    showFooterErrorIcon?: boolean;
+    /**
+     * 确认按钮加载状态，为 true 时确认按钮显示 loading 动画且不可重复点击
+     * @default false
+     */
+    confirmLoading?: boolean;
+    /**
+     * 是否仅初始化一次。首次初始化成功后，忽略后续的 `initializing` 和 `initializingError`。
+     *
+     * @description
+     * `initializing` 为 false 或未传入，且 `initializingError` 无值时，视为初始化成功；
+     * 首次渲染就满足该条件时也会记录成功。成功前允许失败后重试，再次进入加载状态。
+     * 记录在组件卸载后重置。同一实例切换资源时，可通过 `key` 重新挂载。
+     * 延迟启动请求时，需要在准备期间保持 `initializing=true`。
+     * 设为 false 时，两项初始化状态完全跟随外部传入的值。
+     *
+     * @default true
+     */
+    initializeOnce?: boolean;
+    /**
+     * 是否处于初始化加载中状态。为 true 时，标题显示骨架屏、
+     * 内容区域显示骨架屏（行数由 `initializingSkeletonRows` 控制）、footer 隐藏。
+     * 初始化完成后设为 false，若加载失败可设置 `initializingError` 展示错误状态。
+     * 默认仅在首次初始化成功前生效；设 `initializeOnce=false` 可反复进入加载状态。
+     */
+    initializing?: boolean;
+    /**
+     * 初始化错误内容。有值时弹窗进入错误状态：标题变为"加载失败"，
+     * 内容区域显示错误详情，确认按钮文案变为"重试"。
+     * 与 `initializing` 配合使用：先设 initializing=true 加载，
+     * 失败时设 initializing=false 且 initializingError="错误信息"。
+     * 默认在首次初始化成功后被忽略。
+     */
+    initializingError?: string | SafeReactNode;
+    /**
+     * 初始化骨架屏行数，仅在 `initializing` 为 true 时生效
+     * @default 2
+     */
+    initializingSkeletonRows?: number;
+    /**
+     * 测试标识符前缀，用于自动化测试定位元素。
+     * 派生子 testid：`${testId}-cancel`（取消按钮）、`${testId}-ok`（确认按钮）、`${testId}-close`（关闭按钮）
+     */
+    "data-testid"?: string;
+}

package/dist/src/core/SmallDialog/SmallDialog.widget.d.ts

@@ -0,0 +1,9 @@
+import { SafeReactNode } from "../../spec";
+import React from "react";
+export declare const ModelTitleSkeleton: React.FC;
+export declare const ModelContentSkeleton: React.FC<{
+    num?: number;
+}>;
+export declare const ModelInitializingError: React.FC<{
+    error?: string | SafeReactNode;
+}>;

package/dist/src/core/SmallDialog/__test__/initialization.test.d.ts

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

package/dist/src/core/SmallDialog/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./SmallDialog";
+export * from "./SmallDialog.style";
+export * from "./SmallDialog.type";

package/dist/src/core/SmallDialog/useDialogInitialization.d.ts

@@ -0,0 +1,6 @@
+import type { SmallDialogProps } from "./SmallDialog.type";
+/** 记录一次挂载周期内的首次初始化成功，成功前仍允许失败重试。 */
+export declare const useDialogInitialization: ({ initializeOnce, initializing, initializingError, }: Pick<SmallDialogProps, "initializeOnce" | "initializing" | "initializingError">) => {
+    initializing: boolean | undefined;
+    initializingError: import("../..").SafeReactNode;
+};

package/dist/src/core/StepProgress/stepProgress.type.d.ts

@@ -2,4 +2,5 @@ export interface ICircleProgressProps {
     percent: number;
     color?: string;
     className?: string;
+    "data-testid"?: string;
 }

package/dist/src/core/Steps/steps.type.d.ts

@@ -5,6 +5,7 @@ export type StepProps = {
     title: string;
     style?: React.CSSProperties;
     disabled?: boolean;
+    "data-testid"?: string;
 };
 export type IStepsProps = {
     className?: string;

package/dist/src/core/Styled/index.d.ts

@@ -19,6 +19,12 @@ export declare const TagSpan: import("@linaria/react").StyledComponent<import("r
 export declare const FullView: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
 export declare const NameTag: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & Record<never, unknown>>;
 export declare const FormItemDiv: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+/**
+ * FieldTitle 组件
+ * 使用场景：用于表单字段的标题展示
+ * 使用地方：主要在 Modal 等表单容器中使用
+ * 注意：默认字体大小为 12px，可通过 --field-title-font-size CSS 变量覆盖
+ */
 export declare const FieldTitle: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
 export declare const ExpandArrow: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLElement> & import("react").HTMLAttributes<HTMLElement> & Record<never, unknown>>;
 export declare const WarningAlert: import("@linaria/core").LinariaClassName;
@@ -45,4 +51,5 @@ export declare const RadioDesc: import("@linaria/react").StyledMeta & import("re
 }>;
 export declare const radioStyle: import("@linaria/core").LinariaClassName;
 export declare const CannotOperationInfo: import("@linaria/core").LinariaClassName;
+export declare const UnitStyle: import("@linaria/core").LinariaClassName;
 export {};

package/dist/src/core/Switch/switch.type.d.ts

@@ -1,4 +1,5 @@
 import { SwitchProps as AntdSwitchProps } from "antd/lib/switch";
 export type SwitchProps = Omit<AntdSwitchProps, "size"> & {
     size?: "small" | "default" | "large";
+    "data-testid"?: string;
 };

package/dist/src/core/Tab/Tab.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { TabProps } from "./Tab.type";
+export declare const Tab: (props: TabProps) => React.JSX.Element;

package/dist/src/core/Tab/Tab.style.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+export declare const TabMenuWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const TabTitleElStyle: import("@linaria/core").LinariaClassName;
+export declare const MoreThanTooltipStyle: import("@linaria/core").LinariaClassName;
+export declare const IconStyle: import("@linaria/core").LinariaClassName;

package/dist/src/core/Tab/Tab.type.d.ts

@@ -0,0 +1,46 @@
+import React from "react";
+/**
+ * Tab 项的数据结构
+ */
+export type TabItem = {
+    /** Tab 的唯一标识符 */
+    key: string;
+    /** Tab 的标题，可以是字符串、ReactNode 或函数 */
+    title: string | React.ReactNode | ((props: {
+        isActive: boolean;
+    }) => React.ReactNode);
+    /** Tab 的内容 */
+    children: React.ReactNode;
+    /** 测试标识，挂在 tab 标题的点击目标上 */
+    "data-testid"?: string;
+};
+/**
+ * Tab 组件的属性
+ */
+export type TabProps = {
+    /** 外层容器的类名 */
+    className?: string;
+    /** 测试标识 */
+    "data-testid"?: string;
+    /** 内容区域的类名 */
+    contentClassName?: string;
+    /** 当前选中的 Tab 的 key */
+    selectedKey: string;
+    /** Tab 列表 */
+    tabs: TabItem[];
+    /** Tab 切换时的回调 */
+    onChange?: (key: string) => void;
+    /** 额外的插槽内容，显示在 tab bar 的右侧 */
+    extraSlot?: React.ReactNode;
+    /** Tab 的大小 */
+    size?: "small" | "medium";
+};
+/**
+ * 激活 Tab 的类型枚举
+ */
+export declare enum ActiveTabType {
+    /** 普通类型的 Tab */
+    Common = 0,
+    /** 在更多菜单中的 Tab */
+    More = 1
+}

package/dist/src/core/Tab/index.d.ts

@@ -0,0 +1 @@
+export * from "./Tab";

package/dist/src/core/Tab/useTabAdaptiveLayout.d.ts

@@ -0,0 +1,23 @@
+import { TabItem } from "../../core/Tab/Tab.type";
+import { RefObject } from "react";
+/**
+ * Tab 自适应布局 Hook
+ *
+ * 根据可用空间自动计算哪些 tab 需要隐藏到"更多"菜单中。
+ * 当容器尺寸变化、tabs 列表变化或 selectedKey 变化时，会自动重新计算布局。
+ *
+ * @param tabs - Tab 列表
+ * @param tabsRef - Tab 容器的 ref
+ * @param extraSlotRef - 额外插槽的 ref（用于计算可用宽度）
+ * @param selectedKey - 当前选中的 tab key（用于触发重新计算，当选中项在"更多"菜单中时会影响按钮宽度）
+ *
+ * @returns moreTabs - 需要隐藏到"更多"菜单的 tabs 列表
+ *
+ * @example
+ * ```tsx
+ * const tabsRef = useRef<HTMLDivElement>(null);
+ * const extraSlotRef = useRef<HTMLDivElement>(null);
+ * const moreTabs = useTabAdaptiveLayout(tabs, tabsRef, extraSlotRef, selectedKey);
+ * ```
+ */
+export declare const useTabAdaptiveLayout: (tabs: TabItem[], tabsRef: RefObject<HTMLDivElement>, extraSlotRef: RefObject<HTMLDivElement>, selectedKey?: string) => TabItem[];

package/dist/src/core/Table/TableSkeleton.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+export interface ITableSkeletonProps {
+    rowsCount?: number;
+    headerHeight?: number;
+    itemHeight?: number;
+}
+export declare const TableSkeleton: (props: ITableSkeletonProps) => React.JSX.Element;

package/dist/src/core/Table/TableWidget.d.ts

@@ -1,4 +1,8 @@
 import React from "react";
+/**
+ * @deprecated
+ * use TableSkeleton instead
+ */
 export declare const TableLoading: React.FC;
 export declare const KitTableContext: React.Context<{
     onClearSearchButtonEffect?: ((base: string) => void) | undefined;

package/dist/src/core/Table/index.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { TableProps } from "./table.type";
+export declare const emptyTableStyle: import("@linaria/core").LinariaClassName;
 export declare const tableStyleCover: import("@linaria/core").LinariaClassName;
 declare const Table: <T extends {
     id: string;
@@ -7,4 +8,5 @@ declare const Table: <T extends {
 export default Table;
 export * from "./common";
 export * from "./table.type";
+export * from "./TableSkeleton";
 export * from "./TableWidget";

package/dist/src/core/Table/table.type.d.ts

@@ -1,6 +1,7 @@
-/// <reference types="react" />
 import { ColumnsType, ColumnType, TableProps as AntdTableProps } from "antd/lib/table";
-import { TableRowSelection } from "antd/lib/table/interface";
+import { ExpandableConfig, TableRowSelection } from "antd/lib/table/interface";
+import React from "react";
+import { ITableSkeletonProps } from "./TableSkeleton";
 interface IdObject {
     id: string;
 }
@@ -11,36 +12,155 @@ type Columns<T> = ColumnsType<T>[0];
 export interface RequiredColumnProps<T> extends Omit<Columns<T>, "onHeaderCell" | "onCell" | "title"> {
     key: Exclude<Columns<T>["key"], undefined | number>;
     dataIndex: Exclude<ColumnType<T>["dataIndex"], undefined>;
+    /**
+     * 是否支持排序。设置为 true 时，点击表头可触发排序。
+     * @default false
+     */
     sortable?: boolean;
+    /**
+     * 列宽度。支持数字（像素）或字符串（如 "20%"）。
+     */
     width?: number | string;
     onHeaderCell?: (column: ColumnType<T>) => any;
     onCell?: (column: T) => any;
     /**
-     * removed params for title function
-     * because we need to cast the function in customize column
-     * which cannot access the header params
+     * 列标题。支持 React 节点或返回 React 节点的函数。
+     * 注意：函数形式不接收参数，与 antd 原生 title 函数签名不同。
      */
     title: React.ReactNode | (() => React.ReactNode);
+    /**
+     * 是否允许用户自定义该列。用于列配置功能。
+     * @default true
+     */
     customizable?: boolean;
 }
 export type SorterOrder = "descend" | "ascend" | undefined;
+/**
+ * 表格组件，基于 antd Table 二次封装，提供统一的 CloudTower 表格样式。
+ *
+ * @description
+ * 用于展示结构化数据列表，支持排序、行选择、展开行、加载状态、错误状态等功能。
+ * 数据源要求每条记录包含 id 字段作为唯一标识。
+ *
+ * @example
+ * // 基础用法
+ * import { Table } from "@cloudtower/eagle";
+ *
+ * interface VMData {
+ *   id: string;
+ *   name: string;
+ *   status: string;
+ *   cpu: number;
+ * }
+ *
+ * const columns = [
+ *   { key: "name", title: "名称", dataIndex: "name" },
+ *   { key: "status", title: "状态", dataIndex: "status" },
+ *   { key: "cpu", title: "CPU", dataIndex: "cpu" },
+ * ];
+ *
+ * <Table<VMData> columns={columns} dataSource={vms} />
+ *
+ * @example
+ * // 带行选择
+ * import { Table } from "@cloudtower/eagle";
+ * import { useState } from "react";
+ *
+ * const [selectedKeys, setSelectedKeys] = useState<string[]>([]);
+ *
+ * <Table<VMData>
+ *   columns={columns}
+ *   dataSource={vms}
+ *   rowSelection={{
+ *     selectedRowKeys: selectedKeys,
+ *     onChange: (keys) => setSelectedKeys(keys as string[]),
+ *   }}
+ * />
+ *
+ * @example
+ * // 带排序和加载状态
+ * import { Table } from "@cloudtower/eagle";
+ *
+ * <Table<VMData>
+ *   columns={columns}
+ *   dataSource={vms}
+ *   loading={isLoading}
+ *   onSorterChange={(order, key) => {
+ *     console.log("排序:", order, key);
+ *   }}
+ * />
+ *
+ * @see TableForm - 表格表单，用于行内编辑场景
+ * @see SummaryTable - 摘要表格，用于键值对信息展示
+ * @see BatchOperation - 批量操作工具栏，配合行选择使用
+ */
 export interface TableProps<T extends {
     id: string;
 }> {
+    /**
+     * 是否显示边框。
+     * @default false
+     */
     bordered?: boolean;
+    /**
+     * 是否显示加载状态。为 true 时显示骨架屏加载动画。
+     * @default false
+     */
     loading?: boolean;
+    /**
+     * 错误状态内容。传入后将覆盖 dataSource，显示错误信息而非数据。
+     */
     error?: React.ReactNode | string;
+    /**
+     * 数据源数组。每条记录必须包含 id 字段作为唯一标识。
+     */
     dataSource: T[] | undefined;
+    /**
+     * 列配置数组。定义表格的列结构。
+     */
     columns: RequiredColumnProps<T>[];
+    /**
+     * 排序变化回调。当用户点击可排序列的表头时触发。
+     * @param order - 排序方向："descend"（降序）、"ascend"（升序）、null（取消排序）
+     * @param key - 排序列的 key
+     */
     onSorterChange?: (order: SorterOrder | null, key?: string | number) => void;
+    /**
+     * 行点击回调。
+     * @deprecated 请使用 onRow 替代
+     * @param record - 点击行的数据记录
+     * @param index - 行索引
+     * @param evt - 鼠标事件
+     */
     onRowClick?: (record: T, index: number, evt: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+    /**
+     * 行样式类名函数。根据行数据和索引返回自定义类名。
+     */
     rowClassName?: (record: T, index: number) => string;
+    /**
+     * 表格滚动配置。
+     * @example
+     * // 固定表头，内容区滚动
+     * scroll={{ y: 400 }}
+     * // 水平滚动
+     * scroll={{ x: 1200 }}
+     */
     scroll?: {
         x?: number | string | true;
         y?: number | string;
     };
+    /**
+     * 列宽调整回调。启用 resizable 后，用户拖拽调整列宽时触发。
+     */
     onResize?: (column: RequiredColumnProps<T>[]) => void;
+    /**
+     * 是否允许调整列宽。
+     * @default false
+     */
     resizable?: boolean;
+    /**
+     * 自定义表格组件。用于覆盖默认的 table/thead/tbody 渲染。
+     */
     components?: {
         table?: (props: any) => any;
         header?: {
@@ -54,20 +174,67 @@ export interface TableProps<T extends {
             cell?: (props: any) => any;
         };
     };
+    /**
+     * 行操作菜单组件。在每行末尾渲染操作按钮或菜单。
+     */
     RowMenu?: React.FC<{
         record: T;
         index: number;
     }>;
+    /**
+     * 行选择配置。启用后显示复选框列，支持单选或多选。
+     * @see https://ant.design/components/table-cn#rowSelection
+     */
     rowSelection?: TableRowSelection<T>;
+    /**
+     * 空数据时的显示内容。
+     */
     empty?: string | React.ReactNode;
+    /**
+     * 表格布局方式。
+     * - "fixed"：固定布局，列宽由第一行决定
+     * - "auto"：自动布局，列宽由内容决定
+     * @default "fixed"
+     */
     tableLayout?: "fixed" | "auto";
+    /**
+     * 初始化加载状态。
+     * @deprecated 请使用 loading 替代
+     */
     initLoading?: boolean;
+    /**
+     * 行的唯一标识字段。支持字符串或函数。
+     * @default "id"
+     */
     rowKey?: AntdTableProps<T>["rowKey"];
+    /**
+     * 表格容器引用。用于获取表格尺寸信息。
+     */
     wrapper?: React.MutableRefObject<HTMLDivElement | null>;
+    /**
+     * 分页配置。传入后将启用前端分页，通常用于骨架屏行数计算。
+     */
     pagination?: {
         current: number;
         pageSize: number;
     };
+    /**
+     * 行属性配置。用于设置行事件（如 onClick、onMouseEnter 等）。
+     * @see https://ant.design/components/table-cn#onRow
+     */
     onRow?: AntdTableProps<T>["onRow"];
+    /**
+     * 骨架屏配置。自定义加载状态下的骨架屏样式。
+     */
+    skeletonProps?: ITableSkeletonProps;
+    /**
+     * 展开行配置。用于渲染可展开的行内容。
+     * @see https://ant.design/components/table-cn#expandable
+     */
+    expandable?: ExpandableConfig<T>;
+    /**
+     * 用于测试的标识符，会传递到表格根容器元素。
+     */
+    "data-testid"?: string;
 }
 export {};

package/dist/src/core/TableForm/const.d.ts

@@ -1,9 +1,9 @@
 export declare const COLOR_MAP: {
-    readonly primary: "#0080FF";
-    readonly info: "#0080FF";
-    readonly success: "#00BA5D";
+    readonly primary: string;
+    readonly info: string;
+    readonly success: string;
     readonly warning: "#FFA500";
-    readonly danger: "#F0483E";
-    readonly error: "#F0483E";
-    readonly normal: "rgba(44, 56, 82, 0.6)";
+    readonly danger: string;
+    readonly error: string;
+    readonly normal: string;
 };