@hkyhy/marsun-components-core 0.1.3 → 0.1.8

package/dist/components/Filter/useFilterState.d.ts

@@ -0,0 +1,49 @@
+import { default as React } from 'react';
+import { SelectedItem } from './types';
+/**
+ * 筛选项注册信息
+ */
+interface FilterRegistration {
+    /** 筛选项标签 */
+    label: string;
+    /** 当前值的展示文案（如 "技术中心" / "审核员"），为空则不显示该条目 */
+    valueLabel: string;
+    /** 移除回调 */
+    onRemove: () => void;
+}
+/** Context 类型 */
+interface FilterContextValue {
+    /** 注册筛选条件（有值时调用） */
+    register: (key: string, reg: FilterRegistration) => void;
+    /** 注销筛选条件（组件卸载或值清空时调用） */
+    unregister: (key: string) => void;
+}
+/** 供子组件使用 —— 在 CommonFilter 内部注册自身状态（不在 CommonFilter 内时安全返回 null） */
+export declare function useFilterRegister(): FilterContextValue | null;
+interface UseFilterStateReturn {
+    /** 所有已注册的筛选项 */
+    registrations: Record<string, FilterRegistration>;
+    /** 已选条目数组（过滤掉无 valueLabel 的项） */
+    selectedItems: SelectedItem[];
+    /** 注册方法 */
+    register: (key: string, reg: FilterRegistration) => void;
+    /** 注销方法 */
+    unregister: (key: string) => void;
+    /** 清空全部 */
+    clearAll: () => void;
+}
+/**
+ * 筛选状态管理 Hook
+ *
+ * 各 Filter 子组件通过 `register(key, { label, valueLabel, onRemove })` 注册，
+ * CommonFilter 自动聚合成 `selectedItems` 展示。
+ */
+export declare function useFilterState(): UseFilterStateReturn;
+interface FilterProviderProps {
+    children: React.ReactNode;
+    /** register / unregister 方法 */
+    ctx: Pick<UseFilterStateReturn, 'register' | 'unregister'>;
+}
+/** 内部 Provider，将 register/unregister 注入给子组件 */
+export declare const FilterProvider: React.FC<FilterProviderProps>;
+export default useFilterState;

package/dist/components/Form/FetchSelect.d.ts

@@ -0,0 +1,21 @@
+import { SelectProps } from 'antd';
+import { default as React } from 'react';
+export interface SelectOptionItem {
+    label: React.ReactNode;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+export type FetchSelectProps = Omit<SelectProps, 'options' | 'loading' | 'filterOption' | 'optionLabelProp'> & {
+    /** props 模式选项（优先） */
+    options?: SelectOptionItem[];
+    fetchUrl?: string;
+    fetchOptions?: RequestInit;
+    transformData?: (raw: unknown) => SelectOptionItem[];
+    enabled?: boolean;
+    /** 自定义选项行渲染 */
+    optionRender?: (option: SelectOptionItem) => React.ReactNode;
+};
+/** 泛化下拉选择：支持 props 或 fetch+transformData */
+declare const FetchSelect: React.FC<FetchSelectProps>;
+export default FetchSelect;

package/dist/components/Form/FetchTreeSelect.d.ts

@@ -0,0 +1,22 @@
+import { TreeSelectProps } from 'antd';
+import { default as React } from 'react';
+export interface TreeNodeOption {
+    value: string;
+    title: React.ReactNode;
+    key: string;
+    children?: TreeNodeOption[];
+    disabled?: boolean;
+}
+export type FetchTreeSelectProps = Omit<TreeSelectProps, 'treeData' | 'loading'> & {
+    /** props 模式树数据（优先） */
+    treeData?: TreeNodeOption[];
+    /** fetch 模式 URL */
+    fetchUrl?: string;
+    fetchOptions?: RequestInit;
+    /** 将 API 响应转为 treeData */
+    transformData?: (raw: unknown) => TreeNodeOption[];
+    enabled?: boolean;
+};
+/** 泛化树形选择：支持 props 或 fetch+transformData，无业务数据转换 */
+declare const FetchTreeSelect: React.FC<FetchTreeSelectProps>;
+export default FetchTreeSelect;

package/dist/components/Form/PersonOptionRow/index.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { PersonOption } from '../../Filter/types';
+export interface PersonOptionRowProps {
+    option: Pick<PersonOption, 'label' | 'departmentName' | 'email' | 'phone' | 'employeeId'>;
+    className?: string;
+}
+/** 人员选项行：姓名 + 部门 + 右侧 info 图标，hover 展示联系方式 */
+declare const PersonOptionRow: React.FC<PersonOptionRowProps>;
+export default PersonOptionRow;

package/dist/components/Form/StepForm.d.ts

@@ -0,0 +1,42 @@
+import { StepItem, StepModalProps } from '../Modal';
+import { Form } from 'antd';
+import { default as React } from 'react';
+export interface StepFormProps extends Omit<StepModalProps, 'steps'> {
+    /** 步骤列表 */
+    steps: StepFormItem[];
+    /** antd Form 实例 */
+    form: ReturnType<typeof Form.useForm>[0];
+}
+/** 扩展 StepItem，增加表单校验步骤支持 */
+export interface StepFormItem extends Omit<StepItem, 'beforeEnter'> {
+    /** 进入下一步前校验的表单字段列表，不传则不做表单校验 */
+    validateFields?: string[];
+    /** 自定义校验（在 validateFields 之后执行） */
+    beforeEnter?: (values: Record<string, unknown>) => boolean | Promise<boolean>;
+}
+/**
+ * 步骤式表单弹窗
+ *
+ * 在 StepModal 基础上集成 Form 校验能力，
+ * 每个步骤可声明需要校验的字段，点击"下一步"时自动 validateFields。
+ *
+ * 用法：
+ * ```tsx
+ * const [form] = Form.useForm();
+ * const [current, setCurrent] = useState('basic');
+ *
+ * <StepForm
+ *   form={form}
+ *   open={open}
+ *   current={current}
+ *   onCancel={onCancel}
+ *   onStepChange={setCurrent}
+ *   steps={[
+ *     { key: 'basic', title: '基本信息', validateFields: ['name'], content: <BasicStep /> },
+ *     { key: 'detail', title: '详细信息', content: <DetailStep /> },
+ *   ]}
+ * />
+ * ```
+ */
+declare const StepForm: React.FC<StepFormProps>;
+export default StepForm;

package/dist/components/Form/index.d.ts

@@ -0,0 +1,8 @@
+export { default as StepForm } from './StepForm';
+export type { StepFormItem, StepFormProps } from './StepForm';
+export { default as FetchTreeSelect } from './FetchTreeSelect';
+export type { FetchTreeSelectProps, TreeNodeOption } from './FetchTreeSelect';
+export { default as FetchSelect } from './FetchSelect';
+export type { FetchSelectProps, SelectOptionItem } from './FetchSelect';
+export { default as PersonOptionRow } from './PersonOptionRow';
+export type { PersonOptionRowProps } from './PersonOptionRow';

package/dist/components/Icons/index.d.ts

@@ -0,0 +1,85 @@
+import { LucideIcon, LucideProps } from 'lucide-react';
+import { default as React } from 'react';
+export type IconProps = LucideProps & {
+    spin?: boolean;
+    rotate?: number;
+};
+declare const createIcon: (Icon: LucideIcon, options?: {
+    filled?: boolean;
+}) => React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ArrowLeft: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ArrowLeftRight: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const BarChart3: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const BookOpen: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Bot: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Check: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronDown: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronLeft: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronRight: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronUp: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CircleAlert: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CircleCheck: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CircleHelp: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CirclePlay: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CircleX: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ClipboardCheck: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Clock: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CloudDownload: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CloudUpload: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Code: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Copy: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Crown: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Database: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Download: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Eye: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const File: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const FileArchive: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const FileImage: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const FileSpreadsheet: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const FileText: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Flag: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Flame: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Folder: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const FolderOpen: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Hash: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const House: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Import: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Inbox: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Info: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const LayoutDashboard: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const LayoutGrid: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Loader2: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Lock: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const LogOut: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const MessageCircle: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const MessageSquare: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const PanelLeftClose: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const PanelLeftOpen: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Pause: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Pencil: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Plus: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Presentation: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const RefreshCw: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const RotateCw: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Send: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Settings: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Shield: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ShieldCheck: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const SlidersHorizontal: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Square: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Star: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ThumbsDown: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ThumbsUp: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Trash2: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Trophy: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Undo2: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Upload: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const User: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const UserPlus: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const UserRoundCog: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Users: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const X: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export { createIcon };
+export declare const ICON_NAMES: readonly ["ArrowLeft", "ArrowLeftRight", "BarChart3", "BookOpen", "Bot", "Check", "ChevronDown", "ChevronLeft", "ChevronRight", "ChevronUp", "CircleAlert", "CircleCheck", "CircleHelp", "CirclePlay", "CircleX", "ClipboardCheck", "Clock", "CloudDownload", "CloudUpload", "Code", "Copy", "Crown", "Database", "Download", "Eye", "File", "FileArchive", "FileImage", "FileSpreadsheet", "FileText", "Flag", "Flame", "Folder", "FolderOpen", "Hash", "House", "Import", "Inbox", "Info", "LayoutDashboard", "LayoutGrid", "Loader2", "Lock", "LogOut", "MessageCircle", "MessageSquare", "PanelLeftClose", "PanelLeftOpen", "Pause", "Pencil", "Plus", "Presentation", "RefreshCw", "RotateCw", "Send", "Settings", "Shield", "ShieldCheck", "SlidersHorizontal", "Square", "Star", "ThumbsDown", "ThumbsUp", "Trash2", "Trophy", "Undo2", "Upload", "User", "UserPlus", "UserRoundCog", "Users", "X"];
+export type IconName = (typeof ICON_NAMES)[number];
+export declare const ICON_REGISTRY: Record<IconName, React.FC<IconProps>>;

package/dist/components/Layout/PageHeaderLayout/index.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+export interface PageHeaderLayoutProps {
+    title: string;
+    onBack?: () => void;
+    actions?: React.ReactNode;
+    /** 页面说明提示，显示在头部下方、内容区上方 */
+    description?: React.ReactNode;
+    children?: React.ReactNode;
+}
+/** 页面头部布局：返回按钮 + 标题 + 操作区 + 说明提示 + 内容 */
+declare const PageHeaderLayout: React.FC<PageHeaderLayoutProps>;
+export default PageHeaderLayout;

package/dist/components/Layout/index.d.ts

@@ -0,0 +1,2 @@
+export { default as PageHeaderLayout } from './PageHeaderLayout';
+export type { PageHeaderLayoutProps } from './PageHeaderLayout';

package/dist/components/Modal/StepModal/index.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { StepModalProps } from '../StepModalTypes';
+/**
+ * 步骤式弹窗
+ *
+ * 将多步骤流程封装在同一个 Modal 中，自动管理步骤导航、标题切换和底部按钮。
+ *
+ * 用法：
+ * ```tsx
+ * const [current, setCurrent] = useState('select');
+ * <StepModal
+ *   open={open}
+ *   current={current}
+ *   onCancel={onCancel}
+ *   steps={[
+ *     { key: 'select', title: '选择文件', content: <SelectStep /> },
+ *     { key: 'uploading', title: '上传文件', content: <UploadingStep /> },
+ *     { key: 'result', title: '上传结果', content: <ResultStep /> },
+ *   ]}
+ *   onStepChange={setCurrent}
+ * />
+ * ```
+ */
+declare const StepModal: React.FC<StepModalProps>;
+export default StepModal;

package/dist/components/Modal/StepModalTypes.d.ts

@@ -0,0 +1,40 @@
+import { default as React } from 'react';
+/** 步骤项定义 */
+export interface StepItem {
+    /** 步骤唯一 key */
+    key: string;
+    /** 步骤标题 */
+    title: string;
+    /** 步骤描述（可选，显示在 Steps 下方） */
+    description?: string;
+    /** 步骤内容，支持直接 JSX 或函数返回 JSX（延迟求值） */
+    content: React.ReactNode | (() => React.ReactNode);
+    /** 底部按钮区域，不传则使用默认的"取消/下一步"逻辑，支持函数延迟求值 */
+    footer?: React.ReactNode | (() => React.ReactNode);
+    /** 是否允许返回上一步 */
+    allowBack?: boolean;
+    /** 进入该步骤前的校验，返回 true 允许进入，false 阻止 */
+    beforeEnter?: () => boolean | Promise<boolean>;
+}
+export interface StepModalProps {
+    /** 弹窗标题（覆盖步骤标题） */
+    title?: string;
+    /** 步骤列表 */
+    steps: StepItem[];
+    /** 当前步骤 key */
+    current: string;
+    /** 弹窗是否打开 */
+    open: boolean;
+    /** 取消/关闭回调 */
+    onCancel: () => void;
+    /** 弹窗宽度 */
+    width?: number;
+    /** 是否显示 Steps 导航条 */
+    showSteps?: boolean;
+    /** 是否允许点击遮罩关闭 */
+    maskClosable?: boolean;
+    /** 自定义 className */
+    className?: string;
+    /** 切换步骤回调 */
+    onStepChange?: (key: string) => void;
+}

package/dist/components/Modal/index.d.ts

@@ -0,0 +1,2 @@
+export { default as StepModal } from './StepModal';
+export type { StepItem, StepModalProps } from './StepModalTypes';

package/dist/components/Stat/StatCard/index.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+export interface StatCardProps {
+    /** 标题 */
+    title: string;
+    /** 数值 */
+    value: number;
+    /** 前缀图标 */
+    prefix?: React.ReactNode;
+    /** 数值颜色 */
+    color?: string;
+    /** 点击回调 */
+    onClick?: () => void;
+    /** 是否内联模式（不使用 Card 包裹） */
+    inline?: boolean;
+    /** 内联模式下的字体大小 */
+    fontSize?: number;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/** 可点击的统计卡片 */
+declare const StatCard: React.FC<StatCardProps>;
+export default StatCard;

package/dist/components/Stat/StatCardList.d.ts

@@ -0,0 +1,26 @@
+import { ColProps } from 'antd/es/grid';
+import { default as React } from 'react';
+import { StatCardProps } from './StatCard';
+export interface StatItem extends Omit<StatCardProps, 'inline' | 'fontSize'> {
+    /** 卡片占列配置，不传则根据总 items 数自动计算 */
+    colProps?: ColProps;
+    /** 是否隐藏，为 true 时不渲染 */
+    hidden?: boolean;
+    /** 后缀 */
+    suffix?: React.ReactNode;
+}
+export interface StatCardListProps {
+    /** 统计项列表 */
+    items: StatItem[];
+    /** 行间距 */
+    gutter?: [number, number];
+    /** 容器 className */
+    className?: string;
+    /** 是否内联模式 */
+    inline?: boolean;
+    /** 内联模式字体大小 */
+    fontSize?: number;
+}
+/** 统计卡片列表 */
+declare const StatCardList: React.FC<StatCardListProps>;
+export default StatCardList;

package/dist/components/Stat/StatPendingBreakdown/index.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { StatItem } from '../StatCardList';
+export interface StatPendingBreakdownProps {
+    /** 卡片标题 */
+    title?: string;
+    /** 数据可见范围说明，显示在标题下方 */
+    subtitle?: React.ReactNode;
+    /** 汇总统计项 */
+    summaryItems?: StatItem[];
+    /** 待审核明细统计项 */
+    detailItems: StatItem[];
+    /** 汇总区字体大小 */
+    summaryFontSize?: number;
+    /** 明细区字体大小 */
+    detailFontSize?: number;
+    /** 明细区标题 */
+    detailLabel?: string;
+    /** 容器 className */
+    className?: string;
+    /** 无 Card 包裹，仅展示统计内容（用于外层已有 Card 的场景） */
+    plain?: boolean;
+}
+/** 待审核汇总 + 明细独立展示区块 */
+declare const StatPendingBreakdown: React.FC<StatPendingBreakdownProps>;
+export default StatPendingBreakdown;

package/dist/components/Stat/index.d.ts

@@ -0,0 +1,6 @@
+export { default as StatCard } from './StatCard';
+export type { StatCardProps } from './StatCard';
+export { default as StatCardList } from './StatCardList';
+export type { StatCardListProps, StatItem } from './StatCardList';
+export { default as StatPendingBreakdown } from './StatPendingBreakdown';
+export type { StatPendingBreakdownProps } from './StatPendingBreakdown';

package/dist/components/Tag/FileTags.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { TagsProps } from './Tags';
+export type FileTagsProps = Omit<TagsProps, 'color'>;
+/** 文件标签统一样式（Tags + INFO 色） */
+declare const FileTags: React.FC<FileTagsProps>;
+export default FileTags;

package/dist/components/Tag/SemanticTag.d.ts

@@ -0,0 +1,52 @@
+import { default as React } from 'react';
+/**
+ * 语义化颜色常量
+ * 统一管理所有 Tag 的颜色，避免各处硬编码不一致
+ *
+ * 主题色（primary/success/info/warning/danger）使用 CSS 变量，跟随系统主题色动态变化
+ * 固定色（default/processing/other/volcano/cyan/gold/lime）集中管理，不随主题变化
+ */
+export declare const SEMANTIC_COLORS: {
+    /** 主题色（跟随系统主题色动态变化） */
+    readonly PRIMARY: "primary";
+    /** 默认/中性 */
+    readonly DEFAULT: "default";
+    /** 信息/提示 */
+    readonly INFO: "info";
+    /** 进行中/处理中 */
+    readonly PROCESSING: "processing";
+    /** 成功/已完成/已通过 */
+    readonly SUCCESS: "success";
+    /** 警告/待处理 */
+    readonly WARNING: "warning";
+    /** 危险/紧急/已驳回 */
+    readonly DANGER: "danger";
+    /** 其他/特殊 */
+    readonly OTHER: "other";
+    /** 火山/待领导审批 */
+    readonly VOLCANO: "volcano";
+    /** 青色/辅助 */
+    readonly CYAN: "cyan";
+    /** 金色/高优先级 */
+    readonly GOLD: "gold";
+    /** 石灰/低优先级 */
+    readonly LIME: "lime";
+};
+export type SemanticColor = (typeof SEMANTIC_COLORS)[keyof typeof SEMANTIC_COLORS];
+interface SemanticTagProps {
+    /** 标签文本 */
+    children: React.ReactNode;
+    /** 语义化颜色，优先使用 SEMANTIC_COLORS 中的值 */
+    color?: SemanticColor | string;
+    /** antd Tag 其余属性 */
+    [key: string]: unknown;
+}
+/**
+ * 统一 Tag 组件
+ * - 主题色（primary/success/info/warning/danger）使用 CSS 变量，跟随系统主题色动态变化
+ * - 固定色集中管理，避免硬编码
+ * - 文字颜色 = 语义色，背景色 = 语义色 6% 透明度
+ * - 统一尺寸：height 24px, line-height 24px, padding 0 8px
+ */
+declare const SemanticTag: React.FC<SemanticTagProps>;
+export default SemanticTag;

package/dist/components/Tag/Tags/index.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { SemanticColor } from '../SemanticTag';
+export interface TagsProps {
+    /** 标签列表 */
+    tags?: string[];
+    /** 最多展示的标签数量；未传或 tags 数量未超出时展示全部 */
+    showLength?: number;
+    /** 无标签时的占位，传 null 则不渲染 */
+    empty?: React.ReactNode;
+    className?: string;
+    /** 标签颜色，默认 INFO */
+    color?: SemanticColor | string;
+}
+/** 通用标签列表（SemanticTag + showLength 截断） */
+declare const Tags: React.FC<TagsProps>;
+export default Tags;

package/dist/components/Tag/index.d.ts

@@ -0,0 +1,6 @@
+export { default as FileTags } from './FileTags';
+export type { FileTagsProps } from './FileTags';
+export { default as Tags } from './Tags';
+export type { TagsProps } from './Tags';
+export { SEMANTIC_COLORS, default as SemanticTag } from './SemanticTag';
+export type { SemanticColor } from './SemanticTag';

package/dist/components/TooltipInfo/TooltipInfo.d.ts

@@ -0,0 +1,19 @@
+import { TooltipProps } from 'antd';
+import { default as React } from 'react';
+import { DescriptionItem } from '../Descriptions/CommonDescriptions';
+export interface TooltipInfoProps extends Pick<TooltipProps, 'placement' | 'mouseEnterDelay' | 'mouseLeaveDelay'> {
+    /** 详情描述项，内部使用 CommonDescriptions 渲染 */
+    content: DescriptionItem[];
+    children: React.ReactNode;
+    /** CommonDescriptions 列数，默认 1 */
+    column?: number;
+    /** 为 true 或 content 为空时不展示 Tooltip */
+    hidden?: boolean;
+    /** @deprecated 使用 classNames.root */
+    overlayClassName?: string;
+    /** @deprecated 使用 styles.root */
+    overlayStyle?: React.CSSProperties;
+}
+/** Tooltip 详情展示，内部统一使用 CommonDescriptions */
+declare const TooltipInfo: React.FC<TooltipInfoProps>;
+export default TooltipInfo;

package/dist/components/TooltipInfo/index.d.ts

@@ -0,0 +1,2 @@
+export { default as TooltipInfo } from './TooltipInfo';
+export type { TooltipInfoProps } from './TooltipInfo';

package/dist/components/Tour/AppTour/index.d.ts

@@ -0,0 +1,19 @@
+import { TourProps } from 'antd';
+import { default as React } from 'react';
+export interface AppTourStep {
+    title: string;
+    description: React.ReactNode;
+    target?: () => HTMLElement;
+    placement?: TourProps['steps'] extends (infer S)[] | undefined ? S extends {
+        placement?: infer P;
+    } ? P : never : never;
+}
+export interface AppTourProps {
+    steps: AppTourStep[];
+    /** localStorage key，用于记录是否已完成导览 */
+    storageKey?: string;
+    /** 是否自动打开（首次） */
+    autoOpen?: boolean;
+}
+declare const AppTour: React.FC<AppTourProps>;
+export default AppTour;

package/dist/components/Tour/index.d.ts

@@ -0,0 +1,2 @@
+export { default as AppTour } from './AppTour';
+export type { AppTourProps, AppTourStep } from './AppTour';

package/dist/components/Upload/index.d.ts

@@ -0,0 +1,66 @@
+import { UploadFile } from 'antd/es/upload/interface';
+import { default as React } from 'react';
+/** 上传变体 */
+export type UploadVariant = 'panel' | 'button';
+export interface CommonUploadProps {
+    value?: UploadFile[];
+    onChange?: (value: UploadFile[]) => void;
+    className?: string;
+    /** 单文件大小限制（字节），默认 500MB */
+    fileSize?: number;
+    /** 最大上传数量 */
+    maxLength?: number;
+    multiple?: boolean;
+    /** 目录上传模式（webkitdirectory），选中整个文件夹并保留 webkitRelativePath */
+    directory?: boolean;
+    size?: 'small' | 'middle' | 'large';
+    accept?: string;
+    /** panel = 拖拽面板（Dragger 样式），button = 按钮（默认） */
+    variant?: UploadVariant;
+    children?: React.ReactNode;
+    renderTips?: () => React.ReactNode;
+    /** 是否展示已上传文件列表，默认 true（tips 下方） */
+    showFileList?: boolean;
+    onSave?: (fileList: UploadFile[]) => void;
+    ossUpload?: boolean;
+    onUpload?: (options: {
+        file: File;
+        onSuccess: (url?: string) => void;
+        onError: (err: Error) => void;
+    }) => Promise<void> | void;
+    getPermission?: (file: File) => boolean;
+    concurrentCount?: number;
+}
+export type CommonUploadRef = {
+    upload: () => void;
+    uploading: boolean;
+};
+/**
+ * CommonUpload — 通用上传组件
+ *
+ * - 在 antd `<Form.Item>` 内使用时，通过 `value`/`onChange` 自动接入表单
+ * - 独立使用时，通过 `onSave` 获取文件列表
+ *
+ * ## 两种变体
+ *
+ * - **`variant="button"`（默认）** — 虚线边框按钮 + 底部提示文案 + 已传文件列表
+ * - **`variant="panel"`** — Dragger 拖拽面板 + 底部已传文件列表
+ *
+ * @example
+ * ```tsx
+ * // 在 Form.Item 中使用
+ * <Form.Item name="files" label="简历附件" rules={[{ required: true, message: '请上传文件' }]}>
+ *   <CommonUpload accept=".pdf,.jpg,.png" maxLength={10} />
+ * </Form.Item>
+ *
+ * // 独立使用（Modal 内、非表单场景）
+ * <CommonUpload variant="panel" accept=".doc,.pdf" onSave={(list) => setFiles(list)} />
+ *
+ * // ref 手动触发上传
+ * const ref = useRef<CommonUploadRef>(null);
+ * <CommonUpload ref={ref} onUpload={...} />;
+ * ref.current?.upload();
+ * ```
+ */
+declare const CommonUpload: React.ForwardRefExoticComponent<CommonUploadProps & React.RefAttributes<CommonUploadRef>>;
+export default CommonUpload;