@cloudtower/eagle 0.35.1 → 0.35.2

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

@@ -14,12 +14,12 @@ export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
     showOk?: boolean;
     /** 确定按钮的文本 */
     okText?: string;
-    /** 确定按钮的 loading */
-    okLoading?: boolean;
     /** 确定按钮的属性 */
     okButtonProps?: ButtonProps;
     /** 错误信息 */
     error?: React.ReactNode;
+    /** 是否隐藏 footer */
+    hideFooter?: boolean;
     /** 是否展示在 modal footer 的错误图标, 默认展示 */
     showFooterErrorIcon?: boolean;
     /** 确定按钮的回调 */

package/dist/src/core/{Modal/modal.type.d.ts → LegacyModal/LegacyModal.type.d.ts}

@@ -21,7 +21,18 @@ export type WizardSteps = {
     /** 是否禁用当前步骤 */
     disabled?: boolean;
 }[];
-export type ModalProps = Omit<AntdModalProps, "okType"> & {
+/**
+ * @deprecated This component is deprecated and will be removed in future versions.
+ * Please use the following alternatives:
+ * - For standard dialogs: use `MediumDialog` or `SmallDialog`
+ * - For fullscreen dialogs: use `ImmersiveDialog`
+ * - For wizard-style dialogs: use `WizardDialog`
+ * @see MediumDialog
+ * @see SmallDialog
+ * @see ImmersiveDialog
+ * @see WizardDialog
+ */
+export type LegacyModalProps = Omit<AntdModalProps, "okType"> & {
     /** 确认按钮加载状态 */
     confirmLoading?: boolean;
     /** 是否全屏显示 */

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

@@ -0,0 +1,16 @@
+import React from "react";
+import { LegacyModalProps } from "./LegacyModal.type";
+/**
+ * @deprecated This component is deprecated and will be removed in future versions.
+ * Please use the following alternatives:
+ * - For standard dialogs: use `MediumDialog` or `SmallDialog`
+ * - For fullscreen dialogs: use `ImmersiveDialog`
+ * - For wizard-style dialogs: use `WizardDialog`
+ * @see MediumDialog
+ * @see SmallDialog
+ * @see ImmersiveDialog
+ * @see WizardDialog
+ */
+declare const LegacyModal: React.FC<LegacyModalProps>;
+export default LegacyModal;
+export * from "./LegacyModal.type";

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

@@ -0,0 +1,15 @@
+import React from "react";
+import { UploadWrapper } from "./LocalUpload.style";
+import type { LocalUploadProps } from "./LocalUpload.type";
+import { UploadButton, UploadDescription, UploadDragger, UploadFileInfo, UploadFileList, UploadLabel } from "./LocalUpload.widget";
+type UploadComponents = {
+    Wrapper: typeof UploadWrapper;
+    Label: typeof UploadLabel;
+    Description: typeof UploadDescription;
+    Button: typeof UploadButton;
+    Dragger: typeof UploadDragger;
+    FileList: typeof UploadFileList;
+    FileInfo: typeof UploadFileInfo;
+};
+export declare const LocalUpload: React.ForwardRefExoticComponent<LocalUploadProps & React.RefAttributes<HTMLDivElement>> & UploadComponents;
+export {};

package/dist/src/core/LocalUpload/LocalUpload.hooks.d.ts

@@ -0,0 +1,32 @@
+import type { LocalUploadButtonProps, LocalUploadDraggerProps, LocalUploadFile } from "./LocalUpload.type";
+/**
+ * Custom hook to handle file validation automatically.
+ * When files with status "need-validate" are detected, it validates them
+ * and updates their status based on the validation result.
+ *
+ * @param options - Configuration options
+ * @param options.fileList - Current file list
+ * @param options.setFileList - Function to update file list
+ * @param options.validate - Validation function
+ * @param options.createNewFile - Whether to create a new File object when updating (for immutability)
+ */
+export declare const useFileValidation: ({ fileList, setFileList, validate, createNewFile, }: {
+    fileList: LocalUploadFile[];
+    setFileList: (files: LocalUploadFile[]) => void;
+    validate?: LocalUploadDraggerProps["validate"] | LocalUploadButtonProps["validate"];
+    createNewFile?: boolean | undefined;
+}) => void;
+/**
+ * Custom hook to clear error message when file count changes and is within the max count limit.
+ * This hook tracks file count changes using a ref to avoid unnecessary updates.
+ *
+ * @param options - Configuration options
+ * @param options.fileList - Current file list
+ * @param options.maxCount - Maximum allowed file count
+ * @param options.setError - Function to set error message
+ */
+export declare const useFileCountErrorClear: ({ fileList, maxCount, setError, }: {
+    fileList: LocalUploadFile[];
+    maxCount: number;
+    setError: (error: string) => void;
+}) => void;

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

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

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

@@ -0,0 +1,175 @@
+/// <reference types="react" />
+import { AntdRcFile, AntdUploadProps } from "../../antd";
+/**
+ * 上传文件对象
+ * 继承自 Antd 的 RcFile，并添加额外的状态和错误信息
+ */
+export interface LocalUploadFile extends AntdRcFile {
+    /** 文件唯一标识 */
+    uid: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** 文件名 */
+    name: string;
+    /** 文件类型 */
+    type: string;
+    /** 备用文件名 */
+    fileName?: string | undefined;
+    /** 文件状态 */
+    fileStatus: "error" | "success" | "need-validate" | "validating";
+    /** 自定义数据 */
+    data?: any;
+    /** 错误信息 */
+    error?: string | null;
+}
+/**
+ * 文件接受类型
+ * 限制只能是以 . 开头的文件扩展名
+ */
+export type LocalUploadAccept = `.${string}`;
+/**
+ * 上传按钮属性
+ */
+export type LocalUploadButtonProps = Pick<AntdUploadProps, "accept" | "multiple" | "disabled"> & {
+    /** 自定义类名 */
+    className?: string;
+    /** 是否隐藏图标 */
+    hideIcon?: boolean;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 设置文件列表 */
+    setFileList: (files: LocalUploadFile[]) => void;
+    /** 最大文件数量 */
+    maxCount?: number;
+    /**
+     * 文件验证函数
+     * @param file 当前文件
+     * @param files 文件列表
+     * @returns 返回包含错误信息或自定义数据的 Promise
+     */
+    validate?: (file: LocalUploadFile, files?: LocalUploadFile[]) => Promise<{
+        error?: string;
+        data?: any;
+    }>;
+};
+/**
+ * 拖拽上传属性
+ */
+export type LocalUploadDraggerProps = Pick<AntdUploadProps, "accept" | "multiple" | "disabled"> & {
+    /** 自定义类名 */
+    className?: string;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 设置文件列表 */
+    setFileList: (files: LocalUploadFile[]) => void;
+    /** 最大文件数量 */
+    maxCount?: number;
+    /**
+     * 文件验证函数
+     * @param file 当前文件
+     * @param files 文件列表
+     * @returns 返回包含错误信息或自定义数据的 Promise
+     */
+    validate?: (file: LocalUploadFile, files?: LocalUploadFile[]) => Promise<{
+        error?: string;
+        data?: any;
+    }>;
+};
+/**
+ * 文件列表属性
+ */
+export type LocalUploadFileListProps = {
+    /** 自定义类名 */
+    className?: string;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 列表展示类型 */
+    type?: "list" | "info";
+    /** 移除文件回调 */
+    removeFile: (id: string) => void;
+    /** 是否禁用移除操作 */
+    disableRemove?: boolean;
+    /** 文件移除事件回调 */
+    onRemove?: (file: LocalUploadFile) => void;
+};
+/**
+ * 文件信息展示属性
+ */
+export type LocalUploadFileInfoProps = {
+    /** 文件对象 */
+    file: {
+        /** 文件状态 */
+        fileStatus?: "error" | "success" | "need-validate" | "validating";
+        /** 文件名 */
+        name: string;
+        /** 备用文件名 */
+        fileName?: string;
+        /** 文件大小 */
+        size?: number;
+        /** 文件唯一标识 */
+        uid?: string;
+        /** 错误信息 */
+        error?: string | null;
+    };
+    /** 移除文件回调 */
+    removeFile: (id: string) => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 文件移除事件回调 */
+    onRemove?: (file: LocalUploadFile) => void;
+};
+/**
+ * Upload 组件属性
+ */
+export type LocalUploadProps = {
+    /** 自定义类名 */
+    className?: string;
+    /** 标签 */
+    label?: React.ReactNode;
+    /** 描述文本 */
+    description?: React.ReactNode;
+    /** 额外信息 */
+    info?: React.ReactNode;
+    /** 上传类型：按钮或拖拽 */
+    type?: "button" | "dragger";
+    /** 列表展示类型 */
+    listType?: "list" | "info";
+    /** 是否支持多选 */
+    multiple?: boolean;
+    /** 接受的文件类型 */
+    accept?: LocalUploadAccept;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 最大文件数量 */
+    maxCount?: number;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 设置文件列表 */
+    setFileList: (files: LocalUploadFile[]) => void;
+    /** 是否禁用文件列表的移除功能 */
+    disableRemoveList?: boolean;
+    /**
+     * 文件验证函数
+     * @param file 当前文件
+     * @param files 文件列表
+     * @returns 返回包含错误信息或自定义数据的 Promise
+     *
+     * @example
+     * ```ts
+     * const validate = async (file: LocalUploadFile) => {
+     *   if (file.size > 5 * 1024 * 1024) {
+     *     return { error: "文件大小不能超过 5MB" };
+     *   }
+     *   return { data: { validated: true } };
+     * };
+     * ```
+     */
+    validate?: (file: LocalUploadFile, files?: LocalUploadFile[]) => Promise<{
+        error?: string;
+        data?: any;
+    }>;
+    /** 按钮属性 */
+    buttonProps?: Pick<LocalUploadButtonProps, "className" | "hideIcon">;
+    /** 文件移除事件回调 */
+    onRemove?: (file: LocalUploadFile) => void;
+};

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

@@ -0,0 +1,23 @@
+import React from "react";
+import type { LocalUploadButtonProps, LocalUploadDraggerProps, LocalUploadFile, LocalUploadFileInfoProps, LocalUploadFileListProps } from "./LocalUpload.type";
+export declare const UploadLabel: React.FC<{
+    className?: string;
+    children?: React.ReactNode;
+}>;
+export declare const UploadDescription: React.FC<{
+    className?: string;
+    children?: React.ReactNode;
+}>;
+export declare const UploadButton: React.FC<LocalUploadButtonProps & {
+    children?: React.ReactNode;
+}>;
+export declare const UploadDragger: React.FC<LocalUploadDraggerProps & {
+    children?: React.ReactNode;
+}>;
+export declare const UploadFileInfo: React.FC<LocalUploadFileInfoProps>;
+export declare const FileListItem: React.FC<{
+    file: LocalUploadFile;
+    removeFile: (id: string) => void;
+    onRemove?: (file: LocalUploadFile) => void;
+}>;
+export declare const UploadFileList: React.FC<LocalUploadFileListProps>;

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

@@ -0,0 +1,2 @@
+export * from "./LocalUpload";
+export * from "./LocalUpload.type";

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

@@ -34,6 +34,8 @@ export interface SmallDialogProps {
     children?: React.ReactNode;
     /** 展示在 modal footer 的错误文案 */
     error?: React.ReactNode;
+    /** 是否隐藏 footer */
+    hideFooter?: boolean;
     /** 是否展示在 modal footer 的错误图标, 默认展示 */
     showFooterErrorIcon?: boolean;
     /** 确认按钮加载状态 */

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,42 @@
+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 组件的属性
+ */
+export type TabProps = {
+    /** 外层容器的类名 */
+    className?: 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/index.d.ts

@@ -44,16 +44,17 @@ export * from "./InputNumber";
 export * from "./InputPassword";
 export * from "./InputTagItem";
 export * from "./KitStoreProvider";
+export * from "./LegacyModal";
 export * from "./LegacySelect";
 export * from "./Legend";
 export * from "./LineChart";
 export * from "./Link";
 export * from "./Loading";
+export * from "./LocalUpload";
 export * from "./MediumDialog";
 export * from "./message";
 export * from "./message-group";
 export * from "./Metric";
-export * from "./Modal";
 export * from "./ModalStack";
 export * from "./Overflow";
 export * from "./Pagination";
@@ -76,6 +77,7 @@ export * from "./StepProgress";
 export * from "./Steps";
 export * from "./Styled";
 export * from "./Switch";
+export * from "./Tab";
 export * from "./Table";
 export * from "./TableForm";
 export * from "./Tag";
@@ -141,6 +143,7 @@ export { default as InputNumber } from "./InputNumber";
 export { default as InputPassword } from "./InputPassword";
 export { default as InputTagItem } from "./InputTagItem";
 export { default as KitStoreProvider } from "./KitStoreProvider";
+export { default as LegacyModal } from "./LegacyModal";
 export { default as LegacySelect } from "./LegacySelect";
 export { default as Legend } from "./Legend";
 export { default as LineChart } from "./LineChart";
@@ -148,7 +151,6 @@ export { default as Link } from "./Link";
 export { default as Loading } from "./Loading";
 export { default as message } from "./message";
 export { default as Metric } from "./Metric";
-export { default as Modal } from "./Modal";
 export { default as ModalStack } from "./ModalStack";
 export { default as Nav } from "./Nav";
 export { default as Overflow } from "./Overflow";

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

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { type ConfigProps } from "../ConfigProvider";
 type NoticeType = "info" | "success" | "error" | "warning" | "loading";
 export declare const DEFAULT_DURATION = 3;
 export declare function getKeyThenIncreaseKey(): number;
@@ -10,6 +11,10 @@ export interface ConfigOptions {
     transitionName?: string;
     maxCount?: number;
     rtl?: boolean;
+    /**
+     * ConfigProvider 的配置，用于在 message 中传递 context
+     */
+    configProviderProps?: ConfigProps;
 }
 export interface ThenableArgument {
     (val: any): void;