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

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/config-provider/index.d.ts

@@ -1,3 +1,3 @@
-import ConfigProvider from '../0buildTypes/config-provider/index';
-
-export default ConfigProvider;
+import ConfigProvider from '../0buildTypes/config-provider/index';
+
+export default ConfigProvider;

package/types/date-picker/index.d.ts

@@ -1,123 +1,123 @@
-/// <reference types="react" />
-import * as React from 'react';
-import CommonProps from '../util';
-import { Dayjs, ConfigType } from 'dayjs';
-import { PopupProps } from '../overlay';
-import { InputProps } from '../input';
-
-export default class DatePicker extends React.Component<DatePickerProps, any> {
-    static RangePicker: typeof RangePicker;
-    static MonthPicker: typeof MonthPicker;
-    static YearPicker: typeof YearPicker;
-    static WeekPicker: typeof WeekPicker;
-    static QuarterPicker: typeof QuarterPicker;
-}
-
-export class YearPicker extends React.Component<DatePickerProps, any> {
-    mode: 'year';
-}
-export class MonthPicker extends React.Component<DatePickerProps, any> {
-    mode: 'month';
-}
-export class WeekPicker extends React.Component<DatePickerProps, any> {
-    mode: 'week';
-}
-export class QuarterPicker extends React.Component<DatePickerProps, any> {
-    mode: 'quarter';
-}
-export class RangePicker extends React.Component<RangePickerProps, any> {
-    type: 'range';
-}
-interface HTMLAttributesWeak extends React.HTMLAttributes<HTMLElement> {
-    defaultValue?: any;
-    onChange?: any;
-}
-export interface DatePickerProps extends HTMLAttributesWeak, CommonProps {
-    type?: 'date' | 'range';
-    name?: string;
-    mode?: 'date' | 'month' | 'week' | 'quarter' | 'year';
-    value?: ConfigType;
-    defaultValue?: ConfigType;
-    defaultPanelValue?: Dayjs;
-    disabledDate?: (value: Dayjs, mode: 'date' | 'month' | 'week' | 'quarter' | 'year') => boolean;
-    extraFooterRender?: React.ReactNode | (() => React.ReactNode);
-    preset?: object | Array<object>;
-    showTime?: boolean;
-    showOk?: boolean;
-    resetTime?: boolean;
-    timePanelProps?: object;
-    disabledTime?: object;
-
-    onOk?: (value: Dayjs, strVal: string) => void;
-    onChange?: (value: Dayjs, strVal: string) => void;
-    onVisibleChange?: (visible: boolean) => void;
-    onPanelChange?: (panelValue: Dayjs, mode: 'date' | 'month' | 'week' | 'quarter' | 'year') => void;
-
-    format?: string | ((value: Dayjs) => string);
-    /**
-     * 输出格式：控制 onChange、onOk 事件的输出值格式
-     *  - string 类型：根据时间格式进行转换
-     *  - function 类型：((value: Dayjs, strVal: string) => any)
-     *
-     * @version 1.23
-     */
-    outputFormat?: string | ((value: Dayjs, strVal: string) => any);
-    disabled?: boolean;
-    state?: 'success' | 'loading' | 'error';
-    size?: 'small' | 'medium' | 'large';
-    hasBorder?: boolean;
-    inputProps?: InputProps;
-    inputReadOnly?: boolean;
-    hasClear?: boolean;
-    label?: React.ReactNode;
-    separator?: React.ReactNode;
-    placeholder?: string;
-
-    visible?: boolean;
-    defaultVisible?: boolean;
-    popupTriggerType?: 'click' | 'hover';
-    popupAlign?: string;
-    popupContainer?: string | HTMLElement | ((target: HTMLElement) => HTMLElement);
-    popupStyle?: React.CSSProperties;
-    popupClassName?: string;
-    popupProps?: PopupProps;
-    followTrigger?: boolean;
-    popupComponent?: React.Component;
-    dateCellRender?: (value: Dayjs) => React.ReactNode;
-    monthCellRender?: (value: Dayjs) => React.ReactNode;
-    dateInputAriaLabel?: string;
-    isPreview?: boolean;
-    renderPreview?: (value: Dayjs) => React.ReactNode;
-}
-
-export interface RangePickerProps
-    extends Omit<
-        DatePickerProps,
-        | 'value'
-        | 'placeholder'
-        | 'defaultValue'
-        | 'format'
-        | 'onOk'
-        | 'onChange'
-        | 'dateInputAriaLabel'
-        | 'disabled'
-        | 'outputFormat'
-    > {
-    value?: Array<ConfigType>;
-    defaultValue?: Array<ConfigType>;
-    format?: string | ((value: Dayjs) => string) | Array<string> | Array<(value: Dayjs) => string>;
-    onOk?: (value: Array<Dayjs>, strVal: Array<string>) => void;
-    onChange?: (value: Array<Dayjs>, strVal: Array<string>) => void;
-    /**
-     * 输出格式：控制 onChange、onOk 事件的输出值格式
-     *  - string 类型：根据时间格式进行转换
-     *  - function 类型：((value: Dayjs, strVal: string) => any)
-     *
-     * @version 1.23
-     */
-    outputFormat?: string | ((value: Dayjs) => string) | Array<string> | Array<(value: Dayjs) => string>;
-    placeholder?: string | Array<string>;
-    dateInputAriaLabel?: Array<string> | string;
-    disabled?: boolean | boolean[];
-    onCalendarChange?: (values: [Dayjs, Dayjs], formatString: [string, string]) => void;
-}
+/// <reference types="react" />
+import * as React from 'react';
+import CommonProps from '../util';
+import { Dayjs, ConfigType } from 'dayjs';
+import { PopupProps } from '../overlay';
+import { InputProps } from '../input';
+
+export default class DatePicker extends React.Component<DatePickerProps, any> {
+    static RangePicker: typeof RangePicker;
+    static MonthPicker: typeof MonthPicker;
+    static YearPicker: typeof YearPicker;
+    static WeekPicker: typeof WeekPicker;
+    static QuarterPicker: typeof QuarterPicker;
+}
+
+export class YearPicker extends React.Component<DatePickerProps, any> {
+    mode: 'year';
+}
+export class MonthPicker extends React.Component<DatePickerProps, any> {
+    mode: 'month';
+}
+export class WeekPicker extends React.Component<DatePickerProps, any> {
+    mode: 'week';
+}
+export class QuarterPicker extends React.Component<DatePickerProps, any> {
+    mode: 'quarter';
+}
+export class RangePicker extends React.Component<RangePickerProps, any> {
+    type: 'range';
+}
+interface HTMLAttributesWeak extends React.HTMLAttributes<HTMLElement> {
+    defaultValue?: any;
+    onChange?: any;
+}
+export interface DatePickerProps extends HTMLAttributesWeak, CommonProps {
+    type?: 'date' | 'range';
+    name?: string;
+    mode?: 'date' | 'month' | 'week' | 'quarter' | 'year';
+    value?: ConfigType;
+    defaultValue?: ConfigType;
+    defaultPanelValue?: Dayjs;
+    disabledDate?: (value: Dayjs, mode: 'date' | 'month' | 'week' | 'quarter' | 'year') => boolean;
+    extraFooterRender?: React.ReactNode | (() => React.ReactNode);
+    preset?: object | Array<object>;
+    showTime?: boolean;
+    showOk?: boolean;
+    resetTime?: boolean;
+    timePanelProps?: object;
+    disabledTime?: object;
+
+    onOk?: (value: Dayjs, strVal: string) => void;
+    onChange?: (value: Dayjs, strVal: string) => void;
+    onVisibleChange?: (visible: boolean) => void;
+    onPanelChange?: (panelValue: Dayjs, mode: 'date' | 'month' | 'week' | 'quarter' | 'year') => void;
+
+    format?: string | ((value: Dayjs) => string);
+    /**
+     * 输出格式：控制 onChange、onOk 事件的输出值格式
+     *  - string 类型：根据时间格式进行转换
+     *  - function 类型：((value: Dayjs, strVal: string) => any)
+     *
+     * @version 1.23
+     */
+    outputFormat?: string | ((value: Dayjs, strVal: string) => any);
+    disabled?: boolean;
+    state?: 'success' | 'loading' | 'error';
+    size?: 'small' | 'medium' | 'large';
+    hasBorder?: boolean;
+    inputProps?: InputProps;
+    inputReadOnly?: boolean;
+    hasClear?: boolean;
+    label?: React.ReactNode;
+    separator?: React.ReactNode;
+    placeholder?: string;
+
+    visible?: boolean;
+    defaultVisible?: boolean;
+    popupTriggerType?: 'click' | 'hover';
+    popupAlign?: string;
+    popupContainer?: string | HTMLElement | ((target: HTMLElement) => HTMLElement);
+    popupStyle?: React.CSSProperties;
+    popupClassName?: string;
+    popupProps?: PopupProps;
+    followTrigger?: boolean;
+    popupComponent?: React.Component;
+    dateCellRender?: (value: Dayjs) => React.ReactNode;
+    monthCellRender?: (value: Dayjs) => React.ReactNode;
+    dateInputAriaLabel?: string;
+    isPreview?: boolean;
+    renderPreview?: (value: Dayjs) => React.ReactNode;
+}
+
+export interface RangePickerProps
+    extends Omit<
+        DatePickerProps,
+        | 'value'
+        | 'placeholder'
+        | 'defaultValue'
+        | 'format'
+        | 'onOk'
+        | 'onChange'
+        | 'dateInputAriaLabel'
+        | 'disabled'
+        | 'outputFormat'
+    > {
+    value?: Array<ConfigType>;
+    defaultValue?: Array<ConfigType>;
+    format?: string | ((value: Dayjs) => string) | Array<string> | Array<(value: Dayjs) => string>;
+    onOk?: (value: Array<Dayjs>, strVal: Array<string>) => void;
+    onChange?: (value: Array<Dayjs>, strVal: Array<string>) => void;
+    /**
+     * 输出格式：控制 onChange、onOk 事件的输出值格式
+     *  - string 类型：根据时间格式进行转换
+     *  - function 类型：((value: Dayjs, strVal: string) => any)
+     *
+     * @version 1.23
+     */
+    outputFormat?: string | ((value: Dayjs) => string) | Array<string> | Array<(value: Dayjs) => string>;
+    placeholder?: string | Array<string>;
+    dateInputAriaLabel?: Array<string> | string;
+    disabled?: boolean | boolean[];
+    onCalendarChange?: (values: [Dayjs, Dayjs], formatString: [string, string]) => void;
+}