@pisell/materials 1.0.1078 → 1.0.1079

package/lib/components/hardwareErrorTip/logCard/index.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import './index.less';
+declare const DEVICE_TYPE_MAP: {
+    readonly printer: any;
+    readonly barcode_scanner: any;
+    readonly cds: any;
+    readonly kds: any;
+    readonly display: any;
+    readonly card_reader: any;
+    readonly till: any;
+    readonly scale: any;
+};
+export interface LogCardData {
+    log_level: 0 | 1 | 2;
+    message: string;
+    time: string;
+    device: {
+        device_type: keyof typeof DEVICE_TYPE_MAP;
+        device_name: string;
+        device_idfa: string;
+    };
+    data?: string;
+}
+interface ILogCardProps {
+    data: LogCardData;
+}
+declare const LogCard: (props: ILogCardProps) => React.JSX.Element;
+export default LogCard;

package/lib/components/hardwareErrorTip/types.d.ts

@@ -0,0 +1,28 @@
+export declare const prefix = "pisell-lowcode";
+export declare const ErrorTypeTheme: {
+    readonly fatal: {
+        readonly iconColor: "#cf1322";
+        readonly backgroundColor: "#fff1f0";
+        readonly shadowColor: "#ffa39e";
+        readonly badgeColor: "#fee2e1";
+    };
+    readonly critical: {
+        readonly iconColor: "#d4380d";
+        readonly backgroundColor: "#fff2e8";
+        readonly shadowColor: "#ffbb96";
+        readonly badgeColor: "#ffedd5";
+    };
+    readonly normal: {
+        readonly iconColor: "#0958d9";
+        readonly backgroundColor: "#e6f4ff";
+        readonly shadowColor: "#91caff";
+        readonly badgeColor: "#d2eafd";
+    };
+    readonly info: {
+        readonly iconColor: "#389e0d";
+        readonly backgroundColor: "#f6ffed";
+        readonly shadowColor: "#b7eb8f";
+        readonly badgeColor: "#dcfce7";
+    };
+};
+export declare const errorTypes: any[];

package/lib/components/iconfont/index.d.ts

@@ -0,0 +1,8 @@
+import { IconComponentProps } from '@ant-design/icons/es/components/Icon';
+import React from 'react';
+interface IconFontProps extends IconComponentProps {
+    type: string;
+    onClick?: React.MouseEventHandler<HTMLSpanElement>;
+}
+declare const IconFont: React.FC<IconFontProps>;
+export default IconFont;

package/lib/components/login-and-register/index.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+import './index.less';
+/**
+ * loginAndRegister组件的属性接口
+ */
+export interface loginAndRegisterProps {
+    /** Logo相关配置 */
+    showLogo?: boolean;
+    logo?: string;
+    logoPosition?: 'left' | 'center' | 'right';
+    logoSize?: {
+        width?: number;
+        height?: number;
+    };
+    /** 标题相关配置 */
+    title?: string;
+    showTitle?: boolean;
+    titleAlign?: 'left' | 'center' | 'right';
+    /** 副标题相关配置 */
+    subtitle?: string;
+    showSubtitle?: boolean;
+    subtitleAlign?: 'left' | 'center' | 'right';
+    /** 登录方式配置 */
+    loginMethods?: ('email' | 'google' | 'facebook' | 'apple')[];
+    defaultLoginMethod?: 'email' | 'google' | 'facebook' | 'apple';
+    /** 表单配置 */
+    emailLabel?: string;
+    passwordLabel?: string;
+    emailPlaceholder?: string;
+    passwordPlaceholder?: string;
+    emailRules?: any[];
+    buttonText?: string;
+    rememberMeText?: string;
+    forgotPasswordText?: string;
+    showRememberMe?: boolean;
+    showForgotPassword?: boolean;
+    /** 社交登录配置 */
+    socialLoginTexts?: {
+        google?: string;
+        facebook?: string;
+        apple?: string;
+    };
+    /** 底部配置 */
+    showFooter?: boolean;
+    showSignUp?: boolean;
+    signUpText?: string;
+    signUpLink?: string;
+    signUpPosition?: 'left' | 'center' | 'right';
+    otherLinks?: Array<{
+        text: string;
+        url: string;
+    }>;
+    otherLinksPosition?: 'left' | 'center' | 'right';
+    /** 登录/注册切换配置 */
+    showTabs?: boolean;
+    loginTabText?: string;
+    registerTabText?: string;
+    /** 注册表单配置 */
+    registerEmailPlaceholder?: string;
+    registerPasswordPlaceholder?: string;
+    registerButtonText?: string;
+    /** 事件回调 */
+    onLogin?: (values: {
+        email: string;
+        loginMethod: string;
+    }) => void;
+    onSocialLogin?: (type: 'google' | 'facebook' | 'apple') => void;
+    onSignUp?: () => void;
+    onRegister?: (values: {
+        email: string;
+        password: string;
+    }) => void;
+    /** 新增背景图片属性 */
+    backgroundImage?: string;
+}
+/**
+ * Saas登录组件
+ * @param props - 组件属性
+ * @returns React组件
+ */
+declare const loginAndRegister: React.FC<loginAndRegisterProps>;
+export default loginAndRegister;

package/lib/components/pisell-config-provider/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { PisellContextType } from './context';
+interface PisellConfigProviderType {
+    platform?: PisellContextType['platform'];
+    children: React.ReactNode;
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    getSymbolic?: () => string;
+}
+declare const PisellConfigProvider: React.FC<PisellConfigProviderType>;
+export default PisellConfigProvider;

package/lib/components/pisellActionPanel/PisellActionPanel.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { PisellActionPanelProps } from './types';
+import './PisellActionPanel.less';
+/**
+ * PisellActionPanel 操作面板
+ * 用于统一承载、编排和呈现一组用户可执行操作（Actions）的 Pro 组件。
+ * 支持分组、布局、对齐、主/次/危险层级与条件显隐。
+ *
+ * 设计文档：Action Panel (pcp_ge_actionPanel_V1.0)
+ *
+ * @param props 组件 Props
+ */
+export declare function PisellActionPanel({ groups, layout, align, overflowStrategy, groupGap, itemGap, className, style, }: PisellActionPanelProps): React.JSX.Element;

package/lib/components/pisellActionPanel/PisellActionPanel.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellActionPanel } from './PisellActionPanel';
+declare const meta: Meta<typeof PisellActionPanel>;
+export default meta;
+declare type Story = StoryObj<typeof PisellActionPanel>;
+/** 默认：单组两按钮 */
+export declare const Default: Story;
+/** 右对齐（表单底部常见） */
+export declare const AlignRight: Story;
+/** 多组：主操作 + 危险操作 */
+export declare const MultipleGroups: Story;
+/** 竖向布局 */
+export declare const VerticalLayout: Story;
+/** 条件显隐（某条 visible: false） */
+export declare const ConditionalVisible: Story;
+/** 居中 */
+export declare const AlignCenter: Story;
+/** space-between 两端对齐 */
+export declare const SpaceBetween: Story;

package/lib/components/pisellActionPanel/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellActionPanel 组件导出
+ * 操作面板：统一承载、编排一组用户可执行操作
+ */
+export { PisellActionPanel } from './PisellActionPanel';
+export type { PisellActionPanelProps, PisellActionPanelGroup, PisellActionPanelItem, ActionPanelLayout, ActionPanelAlign, ActionPanelOverflowStrategy, ActionPanelItemPriority, } from './types';

package/lib/components/pisellActionPanel/types.d.ts

@@ -0,0 +1,83 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 操作项层级（主/次/危险）
+ */
+export declare type ActionPanelItemPriority = 'primary' | 'secondary' | 'danger' | 'default';
+/**
+ * Action Panel 单条操作项
+ * 对应设计文档 Action Item，可渲染为 Button / IconButton
+ */
+export interface PisellActionPanelItem {
+    /** 唯一 key，用于 React key；不传则用 index */
+    key?: string;
+    /** 展示文案（Button 时显示） */
+    label?: string;
+    /** 图标节点（可单独图标或与 label 同显） */
+    icon?: ReactNode;
+    /** 点击回调 */
+    onClick?: () => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否显示（条件显隐） @default true */
+    visible?: boolean;
+    /** 层级：主/次/危险/默认，影响按钮样式 */
+    priority?: ActionPanelItemPriority;
+    /** 单项内联样式 */
+    style?: CSSProperties;
+    /** 单项类名 */
+    className?: string;
+}
+/**
+ * Action Panel 分组
+ * 对应设计文档 Action Group，内包含多个 Action Item
+ */
+export interface PisellActionPanelGroup {
+    /** 唯一 key；不传则用 index */
+    key?: string;
+    /** 本组操作项 */
+    items: PisellActionPanelItem[];
+    /** 组内整体优先级（可影响组内按钮默认 priority） */
+    priority?: ActionPanelItemPriority;
+    /** 是否显示该组 @default true */
+    visible?: boolean;
+    /** 组内对齐方式（组内多个 item 时的对齐） */
+    align?: 'start' | 'center' | 'end';
+    /** 组容器类名 */
+    className?: string;
+    /** 组容器样式 */
+    style?: CSSProperties;
+}
+/**
+ * Panel 布局方式
+ */
+export declare type ActionPanelLayout = 'horizontal' | 'vertical' | 'grid';
+/**
+ * Panel 对齐方式
+ */
+export declare type ActionPanelAlign = 'left' | 'center' | 'right' | 'space-between';
+/**
+ * 溢出策略：换行 / 滚动 / 更多菜单收纳
+ */
+export declare type ActionPanelOverflowStrategy = 'wrap' | 'scroll' | 'moreMenu';
+/**
+ * PisellActionPanel 组件 Props
+ * 设计文档：Action Panel (pcp_ge_actionPanel_V1.0)
+ */
+export interface PisellActionPanelProps {
+    /** 操作分组列表，顺序即展示顺序 */
+    groups: PisellActionPanelGroup[];
+    /** 布局方式 @default 'horizontal' */
+    layout?: ActionPanelLayout;
+    /** 整体对齐方式 @default 'left' */
+    align?: ActionPanelAlign;
+    /** 溢出策略 @default 'wrap' */
+    overflowStrategy?: ActionPanelOverflowStrategy;
+    /** 组与组之间的间距（CSS gap 或 number px） */
+    groupGap?: number | string;
+    /** 组内操作项之间的间距（CSS gap 或 number px） */
+    itemGap?: number | string;
+    /** 根节点类名 */
+    className?: string;
+    /** 根节点样式 */
+    style?: CSSProperties;
+}

package/lib/components/pisellBaseCard/PisellBaseCard.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellBaseCardProps } from './types';
+import './PisellBaseCard.less';
+/**
+ * PisellBaseCard 基础卡片容器
+ * 提供可定制的容器用于承载子内容，支持默认/悬停/按下/禁用四态样式，可点击时支持焦点与键盘触发
+ */
+export declare function PisellBaseCard({ children, className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick, }: PisellBaseCardProps): React.JSX.Element;

package/lib/components/pisellBaseCard/PisellBaseCard.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellBaseCard } from './PisellBaseCard';
+declare const meta: Meta<typeof PisellBaseCard>;
+export default meta;
+declare type Story = StoryObj<typeof PisellBaseCard>;
+/** 默认：可点击、无内容 */
+export declare const Default: Story;
+/** 带内容 */
+export declare const WithChildren: Story;
+/** 可点击并带点击回调 */
+export declare const Clickable: Story;
+/** 禁用态 */
+export declare const Disabled: Story;
+/** 不可点击（仅容器） */
+export declare const NotClickable: Story;
+/** 自定义默认样式 */
+export declare const CustomStyle: Story;
+/** 悬停/按下/禁用样式 */
+export declare const StateStyles: Story;

package/lib/components/pisellBaseCard/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PisellBaseCard 组件导出
+ */
+export { PisellBaseCard } from './PisellBaseCard';
+export type { PisellBaseCardProps } from './types';

package/lib/components/pisellBaseCard/types.d.ts

@@ -0,0 +1,45 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * PisellBaseCard 组件 Props
+ * @description 基础卡片容器，支持四态样式与可点击配置，无选中逻辑（选中由低代码处理）
+ */
+export interface PisellBaseCardProps {
+    /**
+     * 卡片内容，由低代码插槽或直接传入
+     */
+    children?: ReactNode;
+    /**
+     * 自定义类名，应用于根节点
+     */
+    className?: string;
+    /**
+     * 默认状态下的内联样式（背景、圆角、边框、阴影、padding、宽高等）
+     */
+    style?: CSSProperties;
+    /**
+     * 悬停时的样式覆盖，与 style 合并后应用
+     */
+    hoverStyle?: CSSProperties;
+    /**
+     * 按下（active）时的样式覆盖，与 style 合并后应用
+     */
+    activeStyle?: CSSProperties;
+    /**
+     * 禁用时的样式覆盖，与 style 合并后应用
+     */
+    disabledStyle?: CSSProperties;
+    /**
+     * 是否可点击（可聚焦并触发 onClick）
+     * @default true
+     */
+    clickable?: boolean;
+    /**
+     * 是否禁用，禁用时应用 disabledStyle 且不响应点击与焦点
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 点击回调，仅在 clickable 且非 disabled 时触发
+     */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+}

package/lib/components/pisellBatchActionBar/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellBatchActionBar 组件导出
+ * @description 批量操作栏组件，用于承载基于选中对象的批量行为操作
+ */
+export { default } from './PisellBatchActionBar';
+export type { PisellBatchActionBarProps, BatchActionItem, DefaultActionsConfig, BatchActionConfirmConfig, BatchActionBarPosition, } from './types';

package/lib/components/pisellCustomerBrief/PisellCustomerBrief.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PisellCustomerBriefProps } from './types';
+import './PisellCustomerBrief.less';
+/**
+ * PisellCustomerBrief 客户简要卡片
+ * 基于 PisellEntityCard，用于展示客户（Customer）实体的核心识别信息与客户级属性。
+ * 设计文档：Customer Info (pcl_customerInfon_V1.0)
+ *
+ * - 无头像时显示默认占位 Avatar
+ * - 文本过长按配置省略
+ * - Actions 为空时不占位
+ *
+ * @param props 组件 Props
+ */
+export declare function PisellCustomerBrief({ name, subtitle, avatar, email, address, company, date, extendedFields, tags, actions, showActions, showAvatar, showPrimaryText, showSubtitle, showExtended, showTags, density, layout, width, swipeToDelete, onDelete, tagPosition, contentGap, primaryLineClamp, secondaryLineClamp, renderMedia, renderPrimary, renderSubtitle, renderSecondary, renderTags, renderActions, className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick, }: PisellCustomerBriefProps): React.JSX.Element;

package/lib/components/pisellCustomerBrief/PisellCustomerBrief.stories.d.ts

@@ -0,0 +1,23 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellCustomerBrief } from './PisellCustomerBrief';
+declare const meta: Meta<typeof PisellCustomerBrief>;
+export default meta;
+declare type Story = StoryObj<typeof PisellCustomerBrief>;
+/** 默认：客户名称 + 副标题 + 扩展信息 + 标签 */
+export declare const Default: Story;
+/** 无头像（默认占位） */
+export declare const NoAvatar: Story;
+/** 有头像 */
+export declare const WithAvatar: Story;
+/** B5 密度：扩展信息多行 */
+export declare const B5Extended: Story;
+/** 带操作区：图标 + 文本 + 按钮 */
+export declare const WithActions: Story;
+/** 竖向布局 */
+export declare const VerticalLayout: Story;
+/** 左滑删除 */
+export declare const SwipeToDelete: Story;
+/** 可点击卡片 */
+export declare const Clickable: Story;
+/** 禁用态 */
+export declare const Disabled: Story;

package/lib/components/pisellCustomerBrief/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellCustomerBrief 组件导出
+ * 客户简要卡片，基于 PisellEntityCard
+ */
+export { PisellCustomerBrief } from './PisellCustomerBrief';
+export type { PisellCustomerBriefProps, CustomerBriefExtendedField } from './types';

package/lib/components/pisellCustomerBrief/types.d.ts

@@ -0,0 +1,82 @@
+import type { ReactNode } from 'react';
+import type { PisellBaseCardProps } from '../pisellBaseCard/types';
+import type { EntityCardActionItem, EntityCardDensity, EntityCardLayout, EntityCardTagItem, EntityCardWidth } from '../pisellEntityCard/types';
+/**
+ * 客户简要卡片扩展字段项（用于 B5/B9 等多行展示）
+ * 与 Entity Card 的 secondaryTexts 对应，语义为客户领域
+ */
+export interface CustomerBriefExtendedField {
+    /** 展示文案（如 Email、Address、Company、Date、自定义属性） */
+    text: string;
+    /** 是否显示提示图标 */
+    showTooltip?: boolean;
+}
+/**
+ * PisellCustomerBrief 组件 Props
+ * 基于 PisellEntityCard，用于展示客户（Customer）实体的核心识别信息与客户级属性
+ * 设计文档：Customer Info (pcl_customerInfon_V1.0)
+ */
+export interface PisellCustomerBriefProps extends Pick<PisellBaseCardProps, 'className' | 'style' | 'hoverStyle' | 'activeStyle' | 'disabledStyle' | 'clickable' | 'disabled' | 'onClick'> {
+    /** 客户名称（主文案） */
+    name: string;
+    /** 副标题，与主标题同行（如电话、客户编号） */
+    subtitle?: string;
+    /** 头像图片地址；不传则显示默认占位 Avatar */
+    avatar?: string;
+    /** 邮箱 */
+    email?: string;
+    /** 地址 */
+    address?: string;
+    /** 公司 */
+    company?: string;
+    /** 日期类信息（如创建日期、跟进日期） */
+    date?: string;
+    /** 自定义扩展字段，顺序即展示顺序 */
+    extendedFields?: CustomerBriefExtendedField[];
+    /** 标签列表（如等级、状态） */
+    tags?: EntityCardTagItem[];
+    /** 操作项：仅图标 / 图标+文本 / 按钮 */
+    actions?: EntityCardActionItem[];
+    /** 是否显示操作区 @default false */
+    showActions?: boolean;
+    /** 是否显示头像 @default true */
+    showAvatar?: boolean;
+    /** 是否显示主文案 @default true */
+    showPrimaryText?: boolean;
+    /** 是否显示副标题 @default true */
+    showSubtitle?: boolean;
+    /** 是否显示扩展信息（email/address/company/date/extendedFields） @default true */
+    showExtended?: boolean;
+    /** 是否显示标签 @default true */
+    showTags?: boolean;
+    /** 信息密度 @default 'B2' */
+    density?: EntityCardDensity;
+    /** 布局方向 @default 'horizontal' */
+    layout?: EntityCardLayout;
+    /** 卡片宽度 @default 'content' */
+    width?: EntityCardWidth;
+    /** 是否开启左滑删除 @default false */
+    swipeToDelete?: boolean;
+    /** 左滑删除回调 */
+    onDelete?: () => void;
+    /** 标签位置 @default 'below' */
+    tagPosition?: 'inline' | 'below';
+    /** 内容区间距 */
+    contentGap?: number | string;
+    /** 主文案行数限制 */
+    primaryLineClamp?: number;
+    /** 扩展信息行数限制（按密度有默认值） */
+    secondaryLineClamp?: number;
+    /** 自定义渲染媒体区 */
+    renderMedia?: () => ReactNode;
+    /** 自定义渲染主文案区 */
+    renderPrimary?: () => ReactNode;
+    /** 自定义渲染副标题区 */
+    renderSubtitle?: () => ReactNode;
+    /** 自定义渲染扩展信息区 */
+    renderSecondary?: () => ReactNode;
+    /** 自定义渲染标签区 */
+    renderTags?: () => ReactNode;
+    /** 自定义渲染操作区 */
+    renderActions?: () => ReactNode;
+}

package/lib/components/pisellDataSourceContainer/hooks/useHandleAction.d.ts

@@ -0,0 +1,32 @@
+import { DataSourceContainerProps } from '../type';
+import { FormInstance } from 'antd';
+declare const useHandleAction: (initialParams: Record<string, any> | undefined, options: DataSourceContainerProps['pagination'], form: FormInstance | undefined) => {
+    list: {
+        pagination?: {
+            pageNumber: number;
+            pageSize: number;
+        } | undefined;
+        data: {
+            list: any;
+            count: any;
+        };
+        onSearch: (newParams?: Record<string, any>) => void;
+        onReset: () => void;
+        onPageChange: (pageNumber: number, pageSize: number) => void;
+        loading: boolean;
+        error?: Error | undefined;
+        params: any;
+        cancel: () => void;
+        refresh: () => void;
+        refreshAsync: () => Promise<any>;
+        run: (...params: any) => void;
+        runAsync: (...params: any) => Promise<any>;
+        mutate: (data?: any) => void;
+    };
+    get: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    update: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    create: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    destroy: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    getCurrentRecord: () => any;
+};
+export default useHandleAction;

package/lib/components/pisellDataSourceContainer/provider/ChildComponentProps.d.ts

@@ -0,0 +1,13 @@
+import React, { ReactNode } from 'react';
+import { FormInstance } from 'antd';
+import { ChildComponentPropsType } from '../type';
+declare type ChildComponentPropsContextType = ChildComponentPropsType & {
+    form: FormInstance;
+};
+interface ChildComponentPropsProviderProps {
+    childComponentProps?: ChildComponentPropsType;
+    children: ReactNode;
+}
+export declare const ChildComponentPropsProvider: React.FC<ChildComponentPropsProviderProps>;
+export declare const useChildComponentPropsContext: () => ChildComponentPropsContextType;
+export {};

package/lib/components/pisellDataSourceContainer/provider/RefManager.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { RefManagerContextType } from '../type';
+export declare const RefManagerContext: React.Context<RefManagerContextType | null>;
+interface RefManagerProviderProps {
+    children: React.ReactNode;
+}
+export declare const RefManagerProvider: React.FC<RefManagerProviderProps>;
+export declare const useRefManagerProvider: () => RefManagerContextType;
+export {};

package/lib/components/pisellDataSourceContainer/type.d.ts

@@ -0,0 +1,84 @@
+import { DataSourceContextProps, DataSourceContextType } from '../dataSourceComponents/provider/dataSource/DataSourceContext';
+import { Result } from 'ahooks/es/useRequest/src/types';
+import { TableProps as AntdTableProps, PaginationProps, TabsProps as AntdTabsProps, FormInstance as AntdFormInstance } from 'antd';
+import { SortListProps } from '../sort/types';
+import { FilterItemProps } from '../filter/types';
+import { FilterListProps } from '../filter/components/FilterButton/types';
+/**
+ * 子组件属性集合类型定义
+ */
+export interface ChildComponentPropsType {
+    /** Filter 组件属性 */
+    filterComponent?: {
+        value: {
+            quickFilter?: FilterItemProps[];
+            otherFilter?: FilterItemProps[];
+        };
+        formFiltersPrefix?: string;
+        quickFilterMaxLength?: number;
+    };
+    /** QuickFilter 组件属性 */
+    quickFilterComponent?: {
+        filterList: FilterItemProps[];
+        formFiltersPrefix?: string;
+    };
+    /** FilterButton 组件属性 */
+    filterButtonComponent?: FilterListProps;
+    /** tabsComponent 组件属性 */
+    tabsComponent?: {
+        items: AntdTabsProps['items'];
+        type?: 'default' | 'button' | 'buttonGroup' | 'dropdown';
+    };
+    /** Sort 组件属性 */
+    sortComponent?: SortListProps;
+    /** Table 组件属性 */
+    tableComponent?: AntdTableProps<any>;
+    /** ColumnsSetting 组件属性 */
+    columnsSettingComponent?: {
+        value?: Record<string, any>[];
+        onChange?: (val: Record<string, any>[]) => void;
+    };
+    /** Pagination 组件属性 */
+    paginationComponent?: PaginationProps;
+}
+export interface DataSourceContainerProps extends DataSourceContextProps {
+    pagination?: boolean | {
+        pageNumber: number;
+        pageSize: number;
+    };
+    childComponentProps?: ChildComponentPropsType;
+}
+/**
+ * 扩展的 HandleActionContextType
+ */
+export interface HandleActionContextType extends Omit<DataSourceContextType, 'list'> {
+    list: Result<any, any> & {
+        onSearch: (newParams?: Record<string, any>) => void;
+        onReset: () => void;
+        onPageChange: (pageNumber: number, pageSize: number) => void;
+        pagination?: {
+            pageNumber: number;
+            pageSize: number;
+        };
+    };
+}
+export interface RefManagerContextType {
+    getRef: <T = any>(id: string) => T | undefined;
+    registerRef: <T = any>(id: string, ref: T) => void;
+    unregisterRef: (id: string) => void;
+    getSharedState: <T = any>(key: string) => T | undefined;
+    setSharedState: <T = any>(key: string, value: T) => void;
+    subscribeSharedState: <T = any>(key: string, callback: (value: T) => void) => () => void;
+}
+export interface DataSourceContainerContextType {
+    serverActions: HandleActionContextType;
+    refManager: RefManagerContextType;
+    form: AntdFormInstance;
+}
+export interface UseContainerContextReturnType {
+    serverActions: HandleActionContextType;
+    refManager: RefManagerContextType;
+    form: AntdFormInstance;
+    onValuesChange: (changedValues: Record<string, any>, allValues: Record<string, any>) => void;
+    [key: string]: any;
+}