fat-design 0.0.1-beta.20250930224035 → 0.0.1-beta.20251010070112

package/types/0buildTypes/libs.d.ts

@@ -14,6 +14,7 @@ export { default as Cascader } from './cascader';
 export { default as CascaderSelect } from './cascader-select';
 export { default as Checkbox } from './checkbox';
 export { default as Collapse } from './collapse';
+export { default as Comments } from './comments';
 export { default as ConfigProvider } from './config-provider';
 export { default as DatePicker } from './date-picker';
 export { default as DetailPage } from './pages/detail-page';

package/types/comments/index.d.ts

@@ -0,0 +1,279 @@
+/// <reference types="react" />
+
+import { ReactNode, ReactElement, Component } from 'react';
+import CommonProps from '../util';
+import { PaginationProps } from '../pagination';
+
+export interface CommentItem {
+    /**
+     * 评论唯一标识
+     */
+    id: string | number;
+    /**
+     * 评论内容
+     */
+    content: string;
+    /**
+     * 评论作者
+     */
+    author: {
+        /**
+         * 作者名称
+         */
+        name: string;
+        /**
+         * 作者头像
+         */
+        avatar?: string;
+        /**
+         * 作者ID
+         */
+        id?: string | number;
+        /**
+         * 用户信息修改时间（可选，用于性能优化）
+         */
+        modifiedAt?: string | Date;
+    };
+    /**
+     * 评论时间
+     */
+    createdAt: string | Date;
+    /**
+     * 修改时间（可选，用于性能优化）
+     */
+    modifiedAt?: string | Date;
+    /**
+     * 点赞数
+     */
+    likes?: number;
+    /**
+     * 是否已点赞
+     */
+    liked?: boolean;
+    /**
+     * 二级评论列表
+     */
+    children?: CommentItem[];
+    /**
+     * 二级评论总数（用于分页）
+     */
+    childrenTotal?: number;
+    /**
+     * 自定义数据
+     */
+    [key: string]: any;
+}
+
+export interface CommentInputProps {
+    /**
+     * 输入框占位符
+     */
+    placeholder?: string;
+    /**
+     * 输入框值
+     */
+    value?: string;
+    /**
+     * 输入框值变化回调
+     */
+    onChange?: (value: string) => void;
+    /**
+     * 提交回调
+     */
+    onSubmit?: (content: string) => void | Promise<void>;
+    /**
+     * 是否显示提交按钮
+     */
+    showSubmitButton?: boolean;
+    /**
+     * 提交按钮文字
+     */
+    submitText?: string;
+    /**
+     * 是否正在加载
+     */
+    loading?: boolean;
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * 输入框行数
+     */
+    rows?: number;
+    /**
+     * 自定义渲染函数
+     */
+    render?: (props: CommentInputProps) => ReactNode;
+}
+
+export interface CommentItemRenderProps {
+    /**
+     * 评论数据
+     */
+    comment: CommentItem;
+    /**
+     * 是否为二级评论
+     */
+    isChild?: boolean;
+    /**
+     * 回复评论回调
+     */
+    onReply?: (parentId: string | number, content: string) => void | Promise<void>;
+    /**
+     * 点赞回调
+     */
+    onLike?: (commentId: string | number) => void | Promise<void>;
+    /**
+     * 删除回调
+     */
+    onDelete?: (commentId: string | number) => void | Promise<void>;
+    /**
+     * 编辑回调
+     */
+    onEdit?: (commentId: string | number, content: string) => void | Promise<void>;
+    /**
+     * 加载更多子评论
+     */
+    onLoadMoreChildren?: (parentId: string | number, page: number, pageSize: number) => void | Promise<void>;
+    /**
+     * 显示所有子评论（对话框模式）
+     */
+    onShowAllChildren?: (parentId: string | number) => void;
+}
+
+export interface CommentsAPI {
+    /**
+     * 加载评论列表
+     */
+    loadComments?: (page: number, pageSize: number) => Promise<{
+        list: CommentItem[];
+        total: number;
+    }>;
+    /**
+     * 加载子评论列表
+     */
+    loadChildComments?: (parentId: string | number, page: number, pageSize: number) => Promise<{
+        list: CommentItem[];
+        total: number;
+    }>;
+    /**
+     * 提交一级评论
+     */
+    submitComment?: (content: string) => Promise<CommentItem>;
+    /**
+     * 提交二级评论
+     */
+    submitReply?: (parentId: string | number, content: string) => Promise<CommentItem>;
+    /**
+     * 点赞评论
+     */
+    likeComment?: (commentId: string | number) => Promise<void>;
+    /**
+     * 删除评论
+     */
+    deleteComment?: (commentId: string | number) => Promise<void>;
+    /**
+     * 编辑评论
+     */
+    editComment?: (commentId: string | number, content: string) => Promise<void>;
+}
+
+export interface CommentsProps extends CommonProps {
+    /**
+     * 评论数据（非受控模式）
+     */
+    defaultComments?: CommentItem[];
+    /**
+     * 评论数据（受控模式）
+     */
+    comments?: CommentItem[];
+    /**
+     * 评论总数
+     */
+    total?: number;
+    /**
+     * 当前页码
+     */
+    current?: number;
+    /**
+     * 每页评论数
+     */
+    pageSize?: number;
+    /**
+     * 一级评论输入框位置
+     */
+    inputPosition?: 'top' | 'bottom' | 'none';
+    /**
+     * 二级评论默认显示数量
+     */
+    defaultChildrenCount?: number;
+    /**
+     * 二级评论最大显示数量
+     */
+    maxChildrenCount?: number;
+    /**
+     * API 接口配置
+     */
+    api?: CommentsAPI;
+    /**
+     * 分页配置
+     */
+    paginationProps?: PaginationProps;
+    /**
+     * 一级评论输入框配置
+     */
+    inputProps?: CommentInputProps;
+    /**
+     * 二级评论输入框配置
+     */
+    childInputProps?: CommentInputProps;
+    /**
+     * 自定义评论项渲染
+     */
+    renderComment?: (props: CommentItemRenderProps) => ReactNode;
+    /**
+     * 自定义一级评论输入框渲染
+     */
+    renderInput?: (props: CommentInputProps) => ReactNode;
+    /**
+     * 自定义二级评论输入框渲染
+     */
+    renderChildInput?: (props: CommentInputProps) => ReactNode;
+    /**
+     * 页码变化回调
+     */
+    onPageChange?: (page: number, pageSize: number) => void;
+    /**
+     * 评论数据变化回调
+     */
+    onChange?: (comments: CommentItem[]) => void;
+    /**
+     * 提交评论成功回调
+     */
+    onCommentSubmit?: (comment: CommentItem) => void;
+    /**
+     * 提交回复成功回调
+     */
+    onReplySubmit?: (reply: CommentItem, parentId: string | number) => void;
+    /**
+     * 是否显示分页
+     */
+    showPagination?: boolean;
+    /**
+     * 空状态提示
+     */
+    emptyText?: ReactNode;
+    /**
+     * 是否显示用户悬浮卡片
+     */
+    showUserCard?: boolean;
+    /**
+     * 自定义用户卡片渲染
+     */
+    userCardRender?: (user: CommentItem['author']) => ReactNode;
+}
+
+export default class Comments extends Component<CommentsProps, any> {
+    static displayName: 'Comments';
+}

package/types/empty/index.d.ts

@@ -0,0 +1,79 @@
+/// <reference types="react" />
+
+import * as React from 'react';
+import CommonProps from '../util';
+
+/**
+ * Empty组件的图片类型常量
+ */
+export const EMPTY_TYPE: {
+    DEFAULT: 'DEFAULT';
+    SIMPLE: 'SIMPLE';
+};
+
+export interface EmptyProps extends React.HTMLAttributes<HTMLDivElement>, CommonProps {
+    /**
+     * 组件样式类名前缀
+     */
+    prefixCls?: string;
+
+    /**
+     * 自定义样式类名
+     */
+    className?: string;
+
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+
+    /**
+     * 图片样式
+     */
+    imageStyle?: React.CSSProperties;
+
+    /**
+     * 自定义图片类型
+     */
+    image?: string | React.ReactNode;
+
+    /**
+     * 自定义描述内容
+     */
+    description?: React.ReactNode;
+
+    /**
+     * 国际化配置
+     */
+    locale?: {
+        description?: string;
+    };
+
+    /**
+     * 子元素（显示在底部）
+     */
+    children?: React.ReactNode;
+
+    /**
+     * 是否为右到左布局
+     */
+    rtl?: boolean;
+
+    /**
+     * 自定义图片节点
+     */
+    imageNode?: React.ReactNode;
+
+    /**
+     * 组件样式前缀
+     */
+    prefix?: string;
+}
+
+declare const Empty: React.FC<EmptyProps> & {
+    defaultProps: Partial<EmptyProps>;
+    SIMPLE: string;
+    DEFAULT: string;
+};
+
+export default Empty;

package/types/index.d.ts

@@ -8,7 +8,6 @@ export { PopConfirm } from './balloon-confirm';
 export { default as BatchInput } from './batch-input';
 export { default as Breadcrumb } from './breadcrumb';
 export { default as Box } from './box';
-export { default as Filter } from './filter';
 export { default as Button } from './button';
 export { default as Calendar } from './calendar';
 export { default as Card } from './card';
@@ -16,12 +15,16 @@ export { default as Cascader } from './cascader';
 export { default as CascaderSelect } from './cascader-select';
 export { default as Checkbox } from './checkbox';
 export { default as Collapse } from './collapse';
+export { default as Comments } from './comments';
 export { default as ConfigProvider } from './config-provider';
 export { default as DatePicker } from './date-picker';
 export { default as Dialog } from './dialog';
 export { default as Divider } from './divider';
 export { default as Drawer } from './drawer';
 export { default as Dropdown } from './dropdown';
+export { default as EditableTable } from './editable-table';
+export { default as Empty, EMPTY_TYPE } from './empty';
+export { default as Filter } from './filter';
 export { default as Form } from './form';
 export { default as Grid } from './grid';
 export { default as Icon } from './icon';
@@ -59,10 +62,8 @@ export { default as Upload } from './upload';
 export { default as VirtualList } from './virtual-list';
 export { default as Image } from './image';
 export { default as QueryForm } from './query-form';
-export { default as EditableTable } from './editable-table';
 export { default as SortableList } from './sortable-list';
 export { default as hooks } from './0buildTypes/hooks';
-export { default as Empty } from './0buildTypes/empty';
 
 
 export * from './0buildTypes/others';