@cloudtower/eagle 0.0.0-no-uikit-1 → 0.0.0-theme-rc-1

package/dist/src/core/LineChart/lineChartDisplayUtils.d.ts

@@ -0,0 +1,7 @@
+import { ILineChartMetricStream, ILineChartThresholdIntersectionInfo, ILineChartThresholdTooltipInfo } from "../../core/LineChart/type";
+import type { AxisDomain } from "recharts/types/util/types";
+export declare const DEFAULT_LINE_CHART_STROKE = "#3182bd";
+export declare const isFiniteNumber: (value: unknown) => value is number;
+export declare const getLineChartStreamStroke: (stream: ILineChartMetricStream) => string;
+export declare const getLineChartDefaultYAxisTicks: (domain: AxisDomain | undefined) => [number, number] | undefined;
+export declare const getLineChartLegacyThresholdTooltipInfo: (info: ILineChartThresholdIntersectionInfo) => ILineChartThresholdTooltipInfo;

package/dist/src/core/LineChart/lineSegments.d.ts

@@ -0,0 +1,16 @@
+export interface ILineChartLinePoint {
+    t: number;
+    x: number;
+    y: number;
+}
+export interface ILineChartLinePointInput {
+    t?: number;
+    x?: number | null;
+    y?: number | null;
+}
+export interface ILineChartLineSegment {
+    dashed: boolean;
+    points: ILineChartLinePoint[];
+}
+export declare const getLineChartLineSegments: (points: ILineChartLinePointInput[], forecastStartTimestamp?: number) => ILineChartLineSegment[];
+export declare const getLineChartLinePath: (points: ILineChartLinePoint[]) => string;

package/dist/src/core/LineChart/styled.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="react" />
+export declare const MetricPlaceholderWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const MetricLegendTabStyle: import("@linaria/core").LinariaClassName;
+export declare const LegendStyle: import("@linaria/core").LinariaClassName;
+export declare const LegendItemsStyle: import("@linaria/core").LinariaClassName;
+export declare const LegendItemsStyleDropdown: import("@linaria/core").LinariaClassName;
+export declare const ColorBlockStyle: import("@linaria/core").LinariaClassName;
+export declare const ExtraResource: import("@linaria/core").LinariaClassName;
+export declare const LineChartWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const ChartContentWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const ThresholdTooltipOverlay: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const TooltipWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const TooltipColumn: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const LineChartColorBlockStyle: import("@linaria/core").LinariaClassName;

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

@@ -0,0 +1,282 @@
+import { IChartProps } from "../../core/LineChart/RenderChart";
+import { PickerDateRange } from "../../coreX/DateRangePicker/dateRangePicker.type";
+import { Dayjs } from "dayjs";
+import { TFunction } from "i18next";
+import { CSSProperties, ReactElement } from "react";
+export interface ILineChartMetricData {
+    id: string;
+}
+export interface ILineChartDataPoint {
+    t: number;
+    v?: number;
+    [key: DataPointValueKey]: number | undefined;
+}
+type DataPointValueKey = `v${number}`;
+export interface ILineChartILegend {
+    id: string;
+    name: string;
+    color?: string;
+    fill?: string;
+    stroke?: boolean;
+    iconSuffix?: ReactElement;
+}
+export interface ILineChartMetricStream {
+    points: ILineChartDataPoint[];
+    legend: ILineChartILegend;
+    step: number;
+    tolerance: number;
+}
+export interface ILineChartMetric {
+    sample_streams: ILineChartMetricStream[];
+    unit: ILineChartMetricUnit;
+    dropped: boolean;
+}
+export declare enum ILineChartTimeUnit {
+    Day = "DAY",
+    Hour = "HOUR",
+    Month = "MONTH"
+}
+export declare enum ILineChartMetricUnit {
+    Count = "COUNT",
+    DataRateBit = "DATA_RATE_BIT",
+    DataRateByte = "DATA_RATE_BYTE",
+    DataSize = "DATA_SIZE",
+    Frequency = "FREQUENCY",
+    Load = "LOAD",
+    Percent = "PERCENT",
+    Ratio = "RATIO",
+    Temperature = "TEMPERATURE",
+    Time = "TIME"
+}
+export declare enum ILineChartGraphType {
+    Area = "AREA",
+    Stack = "STACK"
+}
+export type ILineChartDateRange = [Dayjs, Dayjs];
+/**
+ * 曲线区域高亮区间
+ * @description 仅在指定时间段内填充曲线以下区域，可按图例定向生效
+ */
+export interface ILineChartAreaHighlightRange {
+    /** 区间开始时间戳（毫秒） */
+    start: number;
+    /** 区间结束时间戳（毫秒） */
+    end: number;
+    /** 区域填充色 */
+    fill: string;
+    /** 填充透明度 */
+    fillOpacity?: number;
+    /** 指定生效的图例 ID，不传则对全部曲线生效 */
+    legendId?: string;
+}
+/**
+ * 阈值线交点 tooltip 信息
+ */
+export interface ILineChartThresholdIntersectionInfo {
+    /** 交点时间戳（毫秒） */
+    timestamp: number;
+    /** 交点插值后的数值 */
+    value: number;
+    /** 阈值线数值 */
+    thresholdValue: number;
+    /** 格式化后的交点值 */
+    formattedValue: string;
+    /** 格式化后的阈值值 */
+    formattedThresholdValue: string;
+    /** 当前交点所属图例 */
+    legend: ILineChartILegend;
+}
+/**
+ * Legacy threshold tooltip information
+ * @description Kept for compatibility with existing consumers of renderThresholdTooltip
+ */
+export interface ILineChartThresholdTooltipInfo {
+    current: string;
+    max: string;
+}
+export interface ILineChartThresholdIntersectionLabelProps {
+    /** 胶囊文案，支持固定文本或按交点信息动态生成 */
+    text?: string | ((info: ILineChartThresholdIntersectionInfo) => string);
+    /** Whether to show the current intersection label */
+    visible?: boolean | ((info: ILineChartThresholdIntersectionInfo) => boolean);
+    /** 胶囊背景色 */
+    color?: string;
+    /** 胶囊文字颜色 */
+    textColor?: string;
+}
+/**
+ * 单条水平阈值线配置
+ */
+export interface ILineChartThresholdLineProps {
+    /** 阈值线对应的数值 */
+    value: number;
+    /** 阈值线颜色 */
+    stroke?: string;
+    /** 阈值线虚线样式 */
+    strokeDasharray?: string;
+    className?: string;
+    style?: CSSProperties;
+    /** 交点上方胶囊配置 */
+    intersectionLabelProps?: ILineChartThresholdIntersectionLabelProps;
+    /** 自定义交点 tooltip 内容 */
+    renderTooltip?: (info: ILineChartThresholdIntersectionInfo) => ReactElement;
+}
+/**
+ * 图表内部配置项
+ * @description LineChart 内部消费的完整配置集合
+ */
+export type ChartProps = {
+    /** 指标名称 */
+    metric: string;
+    /** 图例 tooltip */
+    legendTooltip?: ReactElement;
+    /** 阈值线交点 tooltip，自定义内容时优先生效 */
+    renderThresholdTooltip?: (info: ILineChartThresholdTooltipInfo) => ReactElement;
+    /** Area highlight ranges below the curve */
+    areaHighlightRanges?: ILineChartAreaHighlightRange[];
+    /** Forecast start timestamp in milliseconds. Forecast points use a dashed line. */
+    forecastStartTimestamp?: number;
+    /** 水平阈值线配置 */
+    thresholdLineProps?: ILineChartThresholdLineProps;
+    yAxisAlign?: "left" | "right";
+    showXaxis?: boolean;
+    showLegend?: boolean;
+    uuid: string;
+    height: number;
+    range: string;
+    type: ILineChartGraphType;
+    mode?: "simple" | "legend" | "single";
+    offScreen: boolean;
+    averageLine?: boolean;
+    addView?: () => void;
+    exportCSV?: () => void;
+    dateRange?: ILineChartDateRange;
+    formatLegendItemName?: FormatName;
+    history: History;
+};
+export interface ILineChartLegend {
+    id: string;
+    name: string;
+    color?: string;
+    fill?: string;
+    stroke?: boolean;
+}
+/**
+ * 折线图组件属性接口
+ * @description 用于展示时序数据的折线图组件，支持多种展示模式和交互功能
+ */
+export type LineChartProps = {
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
+    /**
+     * 图表高度
+     * @default 154
+     */
+    height?: number;
+    /**
+     * 是否显示鼠标悬停指示器
+     * @default true
+     */
+    showPointer?: boolean;
+    /**
+     * Y轴对齐方式
+     * @default "left"
+     */
+    yAxisAlign?: "left" | "right";
+    /**
+     * 是否显示X轴
+     * @default false
+     */
+    showXaxis?: boolean;
+    /**
+     * 是否显示图例
+     * @default true
+     */
+    showLegend?: boolean;
+    /**
+     * 图表核心配置项
+     * @description 包含图表的所有核心配置，如数据、样式、交互等
+     */
+    chartProps: Omit<IChartProps, "uuid">;
+};
+/**
+ * 图例名称格式化函数类型
+ */
+export type FormatName = (params: {
+    /** 指标类型 */
+    type: string | undefined;
+    /** 指标名称 */
+    metricName: string;
+    /** 国际化函数 */
+    t: TFunction;
+    /** 数据索引 */
+    dIndex: number;
+}) => string;
+/**
+ * 指标属性接口
+ * @description 用于配置指标相关的展示和行为
+ */
+export type LineChartMetricProps = {
+    /** 指标名称 */
+    metric: string;
+    /**
+     * 图表高度
+     * @default 154
+     */
+    height?: number;
+    /**
+     * 是否显示鼠标悬停指示器
+     * @default true
+     */
+    showPointer?: boolean;
+    /**
+     * Y轴对齐方式
+     * @default "left"
+     */
+    yAxisAlign?: "left" | "right";
+    /**
+     * 是否显示X轴
+     * @default false
+     */
+    showXaxis?: boolean;
+    /**
+     * 是否显示图例
+     * @default true
+     */
+    showLegend?: boolean;
+    /**
+     * 指标宽度配置
+     * @description 用于配置不同指标的宽度
+     */
+    metricWidth?: Record<string, number>;
+    /**
+     * 展示模式
+     * @default "legend"
+     * - simple: 简单模式，不显示图例
+     * - legend: 图例模式，显示完整图例
+     * - single: 单一模式，适用于单指标展示
+     */
+    mode?: "simple" | "legend" | "single";
+    /**
+     * 是否显示平均线
+     * @default false
+     */
+    averageLine?: boolean;
+    /** 日期范围 */
+    dateRange?: PickerDateRange;
+    /** 图例项名称格式化函数 */
+    formatLegendItemName?: FormatName;
+    /** 曲线以下区域高亮区间 */
+    areaHighlightRanges?: ILineChartAreaHighlightRange[];
+    /** Forecast start timestamp in milliseconds. Forecast points use a dashed line. */
+    forecastStartTimestamp?: number;
+    /** 水平阈值线配置 */
+    thresholdLineProps?: ILineChartThresholdLineProps;
+    /** 阈值线交点 tooltip，自定义内容时优先生效 */
+    renderThresholdTooltip?: (info: ILineChartThresholdTooltipInfo) => ReactElement;
+    /** 历史记录对象 */
+    history: History;
+} & Pick<ChartProps, "legendTooltip">;
+export {};

package/dist/src/core/LineChart/utils.d.ts

@@ -0,0 +1,83 @@
+import { ILineChartAreaHighlightRange, ILineChartDataPoint, ILineChartDateRange, ILineChartGraphType, ILineChartILegend, ILineChartMetric, ILineChartMetricStream, ILineChartMetricUnit } from "../../core/LineChart/type";
+import { formatBitPerSecond, formatBps, formatBytes, formatCount, formatFrequency, formatNanoSecond, formatPercent, formatTemperature } from "../../utils/tower";
+import { NameType, Payload, ValueType } from "recharts/types/component/DefaultTooltipContent";
+export interface ILineChartThresholdIntersectionPoint {
+    timestamp: number;
+    value: number;
+    legend: ILineChartILegend;
+    streamIndex: number;
+}
+export { DEFAULT_LINE_CHART_STROKE, getLineChartDefaultYAxisTicks, getLineChartLegacyThresholdTooltipInfo, getLineChartStreamStroke, } from "./lineChartDisplayUtils";
+export { getLineChartAreaHighlightRuns, type ILineChartAreaHighlightPoint, } from "./areaHighlightUtils";
+export { getLineChartLinePath, getLineChartLineSegments, type ILineChartLinePoint, type ILineChartLinePointInput, type ILineChartLineSegment, } from "./lineSegments";
+export interface ILineChartMetricPayloadMatch<TValue extends ValueType = number, TName extends NameType = string, TLegend extends {
+    id: string;
+} = ILineChartILegend> {
+    legend: TLegend;
+    payload: Payload<TValue, TName>;
+}
+export declare function filterLineChartPointsByDateRange(points: ILineChartDataPoint[], dateRange?: ILineChartDateRange): ILineChartDataPoint[];
+export declare const parseLineChartRange: (range: string) => {
+    span: number;
+    unit: "h" | "d";
+};
+export declare const lineChartXaxisCal: (lastTime: number, dateRange: ILineChartDateRange, width: number) => number[];
+export declare const lineChartTickFormatter: (tick: number, dateRange: ILineChartDateRange) => string;
+export declare function getLineChartXAxisDomain(dateRange: ILineChartDateRange, xaxisLastTime?: number): [number, number];
+export declare const getLineChartMetricPayloadMatches: <TValue extends ValueType = number, TName extends NameType = string, TLegend extends {
+    id: string;
+} = ILineChartILegend>(payload: readonly Payload<TValue, TName>[] | undefined, legends?: readonly TLegend[]) => ILineChartMetricPayloadMatch<TValue, TName, TLegend>[];
+export declare const getLineChartAreaHighlightRanges: (ranges: ILineChartAreaHighlightRange[] | undefined, xDomain: [number, number]) => {
+    start: number;
+    end: number;
+    fill: string;
+    fillOpacity?: number | undefined;
+    legendId?: string | undefined;
+}[];
+export declare const getLineChartRangeTimestamp: (dateRange: ILineChartDateRange) => number;
+export declare const getLineChartThresholdIntersections: (streams: ILineChartMetricStream[], thresholdValue: number, xDomain?: [number, number]) => ILineChartThresholdIntersectionPoint[];
+export declare const getLineChartStep: (dateRange: ILineChartDateRange) => number;
+export declare const filterLineChartDataOverlapping: <Data extends {
+    t: number;
+    v?: number | undefined;
+} = {
+    t: number;
+    v?: number | undefined;
+}>(data: Data[], startTimestamp: number, length: number, step: number, tolerance: number) => (Data | {
+    t: number;
+    v: number;
+})[];
+export declare const convertLineChartDataStruct: (streams: ILineChartDataPoint[][]) => ILineChartDataPoint[];
+export declare const filterLineChartOverlappingMetric: (metric: ILineChartMetric, dateRange: ILineChartDateRange) => {
+    sample_streams: {
+        points: (ILineChartDataPoint | {
+            t: number;
+            v: number;
+        })[];
+        legend: ILineChartILegend;
+        step: number;
+        tolerance: number;
+    }[];
+    unit: ILineChartMetricUnit;
+    dropped: boolean;
+};
+export declare const deletePointsOutOfRange: (data: ILineChartDataPoint[], timeRange: ILineChartDateRange, now: number) => ILineChartDataPoint[];
+export declare const getFirstExpectedTimestamp: (data: ILineChartDataPoint[], timeRange: ILineChartDateRange, now: number, step: number, dateRange: ILineChartDateRange | undefined) => number;
+export declare const addMissingDataWithZero: (data: ILineChartDataPoint[], timeRange: ILineChartDateRange, unit: ILineChartMetricUnit, step: number, dateRange?: ILineChartDateRange) => ILineChartDataPoint[];
+export declare const convertLineChartUnit: (value: number, from: string, to: string, decimals?: number) => number;
+export declare const UNIT_FORMATTER: {
+    readonly PERCENT: readonly [typeof formatPercent, "%", 2, false];
+    readonly RATIO: readonly [typeof formatPercent, "%"];
+    readonly COUNT: readonly [typeof formatCount, ""];
+    readonly DATA_SIZE: readonly [typeof formatBytes, "B"];
+    readonly DATA_RATE_BYTE: readonly [typeof formatBps, "Bps"];
+    readonly DATA_RATE_BIT: readonly [typeof formatBitPerSecond, "bps"];
+    readonly TIME: readonly [typeof formatNanoSecond, "ns"];
+    readonly FREQUENCY: readonly [typeof formatFrequency, "Hz"];
+    readonly TEMPERATURE: readonly [typeof formatTemperature, "℃"];
+    readonly LOAD: readonly [typeof formatCount, ""];
+};
+export declare const getLineChartYDataMax: (dataPoints: ILineChartDataPoint[], type: ILineChartGraphType, extraValues?: number[]) => number;
+export declare const getYAxisUpperBound: (max: number, type: ILineChartMetricUnit) => number;
+export declare const getYAxisDomain: (dataPoints: ILineChartDataPoint[], graphType: ILineChartGraphType, unitType: ILineChartMetricUnit, extraValues?: number[]) => [number, number];
+export declare function lineChartYaxisTickFormatter(value?: number, unit?: ILineChartMetricUnit): string;

package/dist/src/core/Loading/loading.type.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="react" />
-export type LoadingComponentType = React.FunctionComponent<{
+import React from "react";
+export type LoadingComponentType = React.FunctionComponent<React.HTMLAttributes<HTMLDivElement> & {
     fullView?: boolean;
 }>;

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,187 @@
+/// <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;
+    /** 字段级错误信息，展示在上传区域下方，优先级高于组件内部的文件数量超限提示 */
+    error?: React.ReactNode;
+    /**
+     * 文件验证函数
+     * @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;
+    /** 是否禁用文件移除功能 */
+    disableRemove?: boolean;
+    /** 字段级错误信息，展示在上传区域下方，优先级高于组件内部的文件数量超限提示 */
+    error?: React.ReactNode;
+    /**
+     * 文件验证函数
+     * @param file 当前文件
+     * @param files 文件列表
+     * @returns 返回包含错误信息或自定义数据的 Promise
+     */
+    validate?: (file: LocalUploadFile, files?: LocalUploadFile[]) => Promise<{
+        error?: string;
+        data?: any;
+    }>;
+    /** 文件移除事件回调 */
+    onRemove?: (file: LocalUploadFile) => void;
+};
+/**
+ * 文件列表属性
+ */
+export type LocalUploadFileListProps = {
+    /** 自定义类名 */
+    className?: string;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 移除文件回调 */
+    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;
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
+    /** 标签 */
+    label?: React.ReactNode;
+    /** 标签位置 */
+    labelPosition?: "top" | "left";
+    /** 描述文本 */
+    description?: React.ReactNode;
+    /** 额外信息 */
+    info?: React.ReactNode;
+    /** 上传类型：按钮或拖拽 */
+    type?: "button" | "dragger";
+    /** 是否支持多选 */
+    multiple?: boolean;
+    /** 接受的文件类型 */
+    accept?: LocalUploadAccept;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 最大文件数量 */
+    maxCount?: number;
+    /** 文件列表 */
+    fileList: LocalUploadFile[];
+    /** 设置文件列表 */
+    setFileList: (files: LocalUploadFile[]) => void;
+    /** 是否禁用文件列表的移除功能 */
+    disableRemoveList?: boolean;
+    /** 字段级错误信息，展示在上传区域下方，优先级高于组件内部的文件数量超限提示 */
+    error?: React.ReactNode;
+    /**
+     * 文件验证函数
+     * @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,24 @@
+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;
+    disableRemove?: boolean;
+    onRemove?: (file: LocalUploadFile) => void;
+}>;
+export declare const UploadFileList: React.FC<LocalUploadFileListProps>;

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

@@ -0,0 +1 @@
+export {};