@spacego/fe-components 0.1.1 → 0.2.1

package/lib/types/fe-table/fe-table-utils/index.d.ts

@@ -0,0 +1,193 @@
+import { FormInstance } from 'antd';
+import { ITableColumns, ITableParams } from '../type/table.d';
+import * as React from 'react';
+/**
+ * 判断是否需要重新请求前一页数据
+ * @param record 当前数据记录
+ * @param pageNo 当前页码
+ * @returns 是否需要重新请求前一页
+ */
+export declare const shouldRequestPreviousPage: (record: any[], pageNo: number) => boolean;
+/**
+ * 渲染操作按钮
+ */
+export declare const renderActionButtons: <T extends Record<string, any>>(record: T, index: number, columnsHandleConfig: any[], btnPermissionList: string[] | undefined, modal: any) => import("react/jsx-runtime").JSX.Element | never[];
+/**
+ * 创建单元格渲染器
+ */
+export declare const createCellRenderer: (column: ITableColumns<any>) => ((text: any, record: any, index: number) => React.ReactNode) | ((_: any, record: any) => import("react/jsx-runtime").JSX.Element);
+/**
+ * 添加序号列
+ */
+export declare const addIndexColumn: (columns: ITableColumns<any>[], showIndex?: boolean, pageNo?: number, pageSize?: number) => ITableColumns<any>[];
+/**
+ * 添加操作列并处理所有列的渲染函数
+ */
+export declare const processTableColumns: (columns: ITableColumns<any>[], columnsHandleConfig: any[] | undefined, btnPermissionList: string[] | undefined, columnsHandleAttr: ITableParams<any>["columnsHandleAttr"], modal: any) => {
+    render: ((text: any, record: any, index: number) => React.ReactNode) | ((_: any, record: any) => import("react/jsx-runtime").JSX.Element);
+    dataIndex: string | number | symbol;
+    key?: React.Key;
+    title: string | React.ReactNode;
+    titleRender?: React.ReactNode;
+    showHint?: boolean;
+    hintText?: string | React.ReactNode;
+    ellipsis?: boolean | {
+        showTitle: boolean;
+    };
+    align?: "left" | "center" | "right";
+    fixed?: false | "left" | "right";
+    width?: number;
+    dataType?: "string" | "integer" | "double" | "dict";
+    renderType?: import('../type/table.d').TRenderType;
+    renderParams?: {
+        tooltip: boolean;
+        ellipsis: boolean;
+        maxLines?: number;
+    };
+    defaultRenderParams?: {
+        filter?: any;
+        dictfilterParams?: {
+            dictList: Array<{
+                dataIndex: string;
+                label: string;
+            }>;
+        };
+    };
+    tagRenderParams?: {
+        filter?: any;
+        dictfilterParams?: {
+            dictList: Array<{
+                dataIndex: string;
+                label: string;
+            }>;
+        };
+        separator?: string;
+        themeEnums?: Record<string, "processing" | "success" | "error" | "default" | "warning">;
+    };
+    editRenderParams?: import('../type/table.d').IEditRenderParams;
+    thousandsParams?: {
+        precision?: number;
+        fillZero?: boolean;
+        separator?: string;
+    };
+    hideInSetting?: boolean;
+}[];
+/**
+ * 应用列样式
+ */
+export declare const applyColumnStyles: (columns: ITableColumns<any>[]) => {
+    ellipsis: boolean | {
+        showTitle: boolean;
+    };
+    align: "center" | "left" | "right";
+    dataIndex: string | number | symbol;
+    key?: React.Key;
+    title: string | React.ReactNode;
+    titleRender?: React.ReactNode;
+    showHint?: boolean;
+    hintText?: string | React.ReactNode;
+    render?: (text: any, record: any, index: number) => React.ReactNode;
+    fixed?: false | "left" | "right";
+    width?: number;
+    dataType?: "string" | "integer" | "double" | "dict";
+    renderType?: import('../type/table.d').TRenderType;
+    renderParams?: {
+        tooltip: boolean;
+        ellipsis: boolean;
+        maxLines?: number;
+    };
+    defaultRenderParams?: {
+        filter?: any;
+        dictfilterParams?: {
+            dictList: Array<{
+                dataIndex: string;
+                label: string;
+            }>;
+        };
+    };
+    tagRenderParams?: {
+        filter?: any;
+        dictfilterParams?: {
+            dictList: Array<{
+                dataIndex: string;
+                label: string;
+            }>;
+        };
+        separator?: string;
+        themeEnums?: Record<string, "processing" | "success" | "error" | "default" | "warning">;
+    };
+    editRenderParams?: import('../type/table.d').IEditRenderParams;
+    thousandsParams?: {
+        precision?: number;
+        fillZero?: boolean;
+        separator?: string;
+    };
+    hideInSetting?: boolean;
+}[];
+/**
+ * 解析表单数据，将带行ID后缀的字段名转换为按行分组的数据
+ * @param formData 原始表单数据 (如 {name_1: 'John', age_1: 25, name_2: 'Jane'})
+ * @param rowKey 行标识字段名
+ * @returns 按行分组的数据 (如 {'1': {name: 'John', age: 25}, '2': {name: 'Jane'}})
+ */
+export declare const parseTableFormData: (formData: Record<string, any>, rowKey?: string) => Record<string, any>;
+/**
+ * 从当前行数据中提取行ID
+ * @param record 当前行记录
+ * @param rowKey 行标识字段名
+ * @returns 行ID
+ */
+export declare const getRowIdFromRecord: (record: any, rowKey?: string) => string;
+/**
+ * 根据字段名和行ID构建表单字段名
+ * @param fieldName 字段名
+ * @param rowId 行ID
+ * @returns 表单字段名 (如 'name_1')
+ */
+export declare const buildFormFieldName: (fieldName: string, rowId: string) => string;
+/**
+ * 处理表格校验规则，注入表格上下文
+ * @param rules 原始校验规则数组
+ * @param record 当前行记录
+ * @param rowKey 行标识字段名
+ * @param formInstance 表单实例
+ * @returns 处理后的校验规则数组
+ */
+export declare const processTableRules: (rules: any[] | undefined, record: any, rowKey: string, formInstance: any) => any[];
+/**
+ * 表格上下文类型定义
+ */
+export interface TableContext {
+    /** 当前行记录（包含最新表单数据） */
+    currentRecord: Record<string, any>;
+    /** 所有表格行数据 */
+    allTableData: Record<string, any>;
+    /** 表单实例 */
+    form: FormInstance;
+}
+/**
+ * 创建表格校验上下文
+ * @param record 当前行记录
+ * @param rowKey 行标识字段名
+ * @param formInstance 表单实例
+ * @returns 表格校验上下文对象
+ */
+export declare const createTableContext: (record: any, rowKey: string, formInstance: any) => TableContext;
+/**
+ * 处理对象中的事件处理器，注入表格上下文
+ * @param obj 包含事件处理器的对象
+ * @param record 当前行记录
+ * @param rowKey 行标识字段名
+ * @param formInstance 表单实例
+ * @returns 处理后的对象
+ */
+export declare const processEventHandlers: (obj: Record<string, any> | undefined, record: any, rowKey: string, formInstance: any) => Record<string, any>;
+/**
+ * 深度处理表单属性中所有 *Attributes 对象的事件处理器
+ * @param formProps 表单属性配置
+ * @param record 当前行记录
+ * @param rowKey 行标识字段名
+ * @param formInstance 表单实例
+ * @returns 处理后的表单属性配置
+ */
+export declare const enhanceFormPropsWithContext: (formProps: any, record: any, rowKey: string, formInstance: any) => any;

package/lib/types/fe-table/index.d.ts

@@ -0,0 +1,6 @@
+export { default as FeTable } from './fe-table';
+export { shouldRequestPreviousPage } from './fe-table-utils';
+export * from './type/table.d';
+export * from './type/table-context.d';
+export { default as UseEditTable } from './use-edit-table';
+export { default as UseTable } from './use-table';

package/lib/types/fe-table/type/table-context.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 可编辑表格上下文类型定义
+ */
+export interface TableContext {
+  /**
+   * 当前行记录（包含最新表单数据）
+   * 注意：这里的字段值是已经从表单中获取的最新值
+   */
+
+  currentRecord: Record<string, any>;
+
+  /**
+   * 所有表格行数据
+   * 格式: { rowId: rowData }
+   * 例如: { '1': { id: 1, name: '张三' }, '2': { id: 2, name: '李四' } }
+   */
+  allTableData: Record<string, Record<string, any>>;
+
+  /**
+   * Ant Design Form 表单实例
+   * 可以使用所有表单方法，如：
+   * - getFieldValue(name)
+   * - setFieldValue(name, value)
+   * - getFieldsValue()
+   * - setFieldsValue(values)
+   * - validateFields()
+   */
+  form: any;
+}
+
+/**
+ * 带表格上下文的事件处理器类型
+ * 用于为事件处理器提供类型提示
+ *
+ * @example
+ * ```typescript
+ * import type { TableEventHandler } from '@orchid/fe-table';
+ *
+ * const handleBlur: TableEventHandler<[React.FocusEvent]> = (event, tableContext) => {
+ *   const { currentRecord, form } = tableContext;
+ *   // ...
+ * };
+ * ```
+ */
+export type TableEventHandler<T extends any[] = any[]> = (...args: [...T, TableContext]) => void | Promise<void>;
+
+/**
+ * 表格值变更事件处理器
+ */
+export type TableValueChangeHandler = TableEventHandler<[any]>;
+
+/**
+ * 表格点击事件处理器
+ */
+export type TableClickHandler = TableEventHandler<[React.MouseEvent]>;
+
+/**
+ * 表格焦点事件处理器
+ */
+export type TableFocusHandler = TableEventHandler<[React.FocusEvent]>;