declare namespace API {
  namespace Comment {
    type CommentStatus = "normal" | "waiting" | "rejected";

    interface ICommentData {
      id: number;
      uuid: string;

      uid: number | null;
      name: string | null;
      email: string | null;
      site: string | null;
      avatar: string;
      open_id: string | null;

      ref: string;
      status: CommentStatus;
      content: string;
      parent: string | null;
      // root 后端会自动推算，根据它 parent 的 root 字段填充
      root: string | null;
      ip: string;
      ua: string;
      location: string | null;
      is_private: boolean;
      is_ai_bot: boolean;

      created_at: string | null;
      updated_at: string | null;
    }

    interface ICommentDetailData extends ICommentData {
      children: ICommentDetailData[];
    }

    interface ICommentRankData {
      name: string;
      avatar: string;
      site: string | null;
      total: number;
    }
  }
}