@pisell/materials 3.3.88 → 3.3.90

package/lib/components/PisellCards/components/TextCard/components/BadgeWrapper.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { BadgeWrapperProps } from '../types';
+/**
+ * BadgeWrapper 角标包装组件
+ * 负责角标的渲染和定位，支持红点、数字、文本三种类型
+ *
+ * @example
+ * ```tsx
+ * // 红点角标
+ * <BadgeWrapper badge={{ type: 'dot' }}>
+ *   <TextCard text="Item" />
+ * </BadgeWrapper>
+ *
+ * // 数字角标
+ * <BadgeWrapper badge={{ type: 'number', content: 99 }}>
+ *   <TextCard text="Item" />
+ * </BadgeWrapper>
+ *
+ * // 文本角标
+ * <BadgeWrapper badge={{ type: 'text', content: 'New' }}>
+ *   <TextCard text="Item" />
+ * </BadgeWrapper>
+ * ```
+ */
+declare const BadgeWrapper: React.FC<BadgeWrapperProps>;
+export default BadgeWrapper;

package/lib/components/PisellCards/components/TextCard/components/IconWrapper.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { IconWrapperProps } from '../types';
+/**
+ * IconWrapper 图标包装组件
+ * 负责统一图标渲染逻辑，支持自定义图标大小和颜色
+ *
+ * @example
+ * ```tsx
+ * <IconWrapper
+ *   icon={<BellIcon />}
+ *   position="prefix"
+ *   config={{ size: 16, color: '#666' }}
+ * />
+ * ```
+ */
+declare const IconWrapper: React.FC<IconWrapperProps>;
+export default IconWrapper;

package/lib/components/PisellCards/components/TextCard/components/TextContent.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { TextContentProps } from '../types';
+/**
+ * TextContent 文本内容组件
+ * 负责渲染主文本内容，处理文本省略逻辑
+ *
+ * @example
+ * ```tsx
+ * <TextContent
+ *   text="这是一段很长的文本内容"
+ *   textConfig={{
+ *     maxLines: 2,
+ *     ellipsis: true,
+ *     fontSize: 14,
+ *     color: '#333'
+ *   }}
+ * />
+ * ```
+ */
+declare const TextContent: React.FC<TextContentProps>;
+export default TextContent;

package/lib/components/PisellCards/components/TextCard/components/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TextCard 子组件导出
+ */
+export { default as TextContent } from './TextContent';
+export { default as IconWrapper } from './IconWrapper';
+export { default as BadgeWrapper } from './BadgeWrapper';

package/lib/components/PisellCards/components/TextCard/index.d.ts

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

package/lib/components/PisellCards/components/TextCard/types.d.ts

@@ -0,0 +1,270 @@
+import { CSSProperties, ReactNode } from 'react';
+import { PisellBasicCardProps } from '../../types';
+/**
+ * 样式变体类型
+ */
+export declare type TextCardVariant = 'text' | 'filled' | 'outlined' | 'light' | 'gradient' | 'dashed';
+/**
+ * 尺寸类型
+ */
+export declare type TextCardSize = 'small' | 'default' | 'large';
+/**
+ * 宽度模式
+ */
+export declare type TextCardWidthMode = 'auto' | 'fixed' | 'full';
+/**
+ * 图标配置
+ */
+export interface IconConfig {
+    /**
+     * 图标大小（单位：px）
+     */
+    size?: number;
+    /**
+     * 图标颜色
+     */
+    color?: string;
+}
+/**
+ * 标签配置
+ */
+export interface TagConfig {
+    /**
+     * 标签颜色
+     */
+    color?: string;
+    /**
+     * 标签自定义样式
+     */
+    style?: CSSProperties;
+}
+/**
+ * 角标类型
+ */
+export declare type BadgeType = 'dot' | 'number' | 'text';
+/**
+ * 角标位置
+ */
+export declare type BadgePosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+/**
+ * 角标配置
+ */
+export interface BadgeConfig {
+    /**
+     * 角标类型
+     * @default 'dot'
+     */
+    type?: BadgeType;
+    /**
+     * 角标内容（数字或文本）
+     * 当 type 为 'number' 或 'text' 时有效
+     */
+    content?: ReactNode;
+    /**
+     * 角标位置
+     * @default 'top-right'
+     */
+    position?: BadgePosition;
+    /**
+     * 角标偏移量 [x, y]
+     * 正数向右/下偏移，负数向左/上偏移
+     */
+    offset?: [number, number];
+    /**
+     * 角标颜色
+     */
+    color?: string;
+    /**
+     * 角标自定义样式
+     */
+    style?: CSSProperties;
+}
+/**
+ * 文本配置
+ */
+export interface TextConfig {
+    /**
+     * 字体大小（单位：px）
+     */
+    fontSize?: number;
+    /**
+     * 字体粗细
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     */
+    color?: string;
+    /**
+     * 最大显示行数
+     * @default 1
+     */
+    maxLines?: number;
+    /**
+     * 是否显示省略号
+     * @default true
+     */
+    ellipsis?: boolean;
+    /**
+     * 文本对齐方式
+     * @default 'left'
+     */
+    textAlign?: 'left' | 'center' | 'right';
+    flex?: string;
+}
+/**
+ * TextCard 组件 Props
+ * 基于 PisellBasicCardProps 扩展
+ * 注意：重写 onClick 为可选属性
+ */
+export interface TextCardProps extends Omit<PisellBasicCardProps, 'onClick'> {
+    /**
+     * 卡片显示的文本内容（必填）
+     */
+    text: ReactNode;
+    /**
+     * 卡片样式变体
+     * @default 'text'
+     */
+    variant?: TextCardVariant;
+    /**
+     * 卡片尺寸
+     * @default 'default'
+     */
+    size?: TextCardSize;
+    /**
+     * 是否可点击
+     * @default true
+     */
+    clickable?: boolean;
+    /**
+     * 前置图标
+     * 支持 ReactNode（如 antd Icon、svg 等）
+     */
+    prefixIcon?: ReactNode;
+    /**
+     * 后置图标
+     * 支持 ReactNode（如 antd Icon、svg 等）
+     */
+    suffixIcon?: ReactNode;
+    /**
+     * 图标配置
+     * 统一配置前置和后置图标的大小和颜色
+     */
+    iconConfig?: IconConfig;
+    /**
+     * 后置标签
+     * 支持 ReactNode（如 antd Tag、Badge 等）
+     */
+    tag?: ReactNode;
+    /**
+     * 标签配置
+     */
+    tagConfig?: TagConfig;
+    /**
+     * 角标配置
+     * 用于显示红点、数字或文本提示
+     */
+    badge?: BadgeConfig;
+    /**
+     * 前置插槽
+     * 用于替换前置图标，优先级高于 prefixIcon
+     */
+    prefixSlot?: ReactNode;
+    /**
+     * 后置插槽
+     * 用于替换后置图标和标签，优先级高于 suffixIcon 和 tag
+     */
+    suffixSlot?: ReactNode;
+    /**
+     * 文本配置
+     * 用于自定义文本样式和显示行为
+     */
+    textConfig?: TextConfig;
+    /**
+     * 宽度模式
+     * - auto: 内容撑满，最大宽度 maxWidth
+     * - fixed: 固定宽度 width
+     * - full: 撑满父容器，最小宽度 28px
+     * @default 'auto'
+     */
+    widthMode?: TextCardWidthMode;
+    /**
+     * 固定宽度值
+     * 当 widthMode='fixed' 时有效
+     */
+    width?: number | string;
+    /**
+     * 最大宽度
+     * 当 widthMode='auto' 时有效
+     * @default 400
+     */
+    maxWidth?: number | string;
+    /**
+     * 点击事件
+     * 当 clickable=true 且不在 disabled/loading 状态时触发
+     * 注意：PisellBasicCardProps 中的 onClick 是必填的，这里重新定义为可选
+     */
+    onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+    /**
+     * 自定义渲染函数
+     * 完全自定义组件的渲染内容
+     * 当提供此函数时，组件内置的渲染逻辑将被忽略
+     */
+    render?: (props: TextCardProps) => ReactNode;
+}
+/**
+ * TextContent 组件 Props
+ * 文本内容子组件
+ */
+export interface TextContentProps {
+    /**
+     * 文本内容
+     */
+    text: ReactNode;
+    /**
+     * 文本配置
+     */
+    textConfig?: TextConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    active?: PisellBasicCardProps['active'];
+}
+/**
+ * IconWrapper 组件 Props
+ * 图标包装子组件
+ */
+export interface IconWrapperProps {
+    /**
+     * 图标内容
+     */
+    icon: ReactNode;
+    /**
+     * 图标配置
+     */
+    config?: IconConfig;
+    /**
+     * 图标位置
+     */
+    position: 'prefix' | 'suffix';
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * BadgeWrapper 组件 Props
+ * 角标包装子组件
+ */
+export interface BadgeWrapperProps {
+    /**
+     * 角标配置
+     */
+    badge?: BadgeConfig;
+    /**
+     * 子元素
+     */
+    children: ReactNode;
+}

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

@@ -0,0 +1,14 @@
+declare const PisellCards: {
+    TabCard: (props: any) => import("react").JSX.Element;
+    TextCard: (props: any) => import("react").JSX.Element;
+    GraphicTextCard: (props: import("./components/GraphicTextCard").GraphicTextCardProps) => import("react").JSX.Element;
+    MultilevelCard: (props: any) => import("react").JSX.Element;
+    PisellImageCard: (props: import("./components/PisellImageCard").PisellImageCardProps) => import("react").JSX.Element;
+};
+export default PisellCards;
+export type { PisellBasicCardProps } from './types';
+export type { TabCardProps, BadgeConfig } from './components/TabCard/types';
+export type { TextCardProps } from './components/TextCard/types';
+export type { GraphicTextCardProps, GraphicTextCardVariant, GraphicTextCardSize, GraphicConfig, } from './components/GraphicTextCard/types';
+export type { MultilevelCardProps } from './components/MultilevelCard/types';
+export type { PisellImageCardProps, ImageDataSource, ImageFillMode, } from './components/PisellImageCard/types';

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

@@ -0,0 +1,10 @@
+import React from "react";
+import { ConfigProviderProps as OriginalConfigProviderProps } from "antd/es/config-provider";
+import "dayjs/locale/zh-cn";
+import "dayjs/locale/ja";
+import "dayjs/locale/pt";
+export interface ConfigProviderProps extends OriginalConfigProviderProps {
+    [key: string]: any;
+}
+declare const ConfigProvider: (props: ConfigProviderProps) => React.JSX.Element;
+export default ConfigProvider;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useDataSourceKey.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const useDataSourceKey: () => {
     dataSourceKey: string | undefined;
     dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useDrawerState.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const useDrawerState: (operationContent?: {
     [key: string]: import("react").ReactNode;
 } | undefined) => any;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useTableQuery.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataSourceTableProps } from '../type';
 declare type Params = {
     pagination?: {

package/lib/components/dataSourceComponents/dataSourceTable/type.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="react" />
+import { ColumnType } from 'antd/es/table';
+import { LocalSettingsType } from '../../table/types';
+import { DataSourceType } from '../provider/dataSource/DataSourceContext';
+export declare type OperationItem = {
+    label?: string;
+    openMode: 'modal' | 'drawer' | 'custom';
+    openContentSize: 'small' | 'middle' | 'large';
+    openTitle: string;
+    actionType: 'detail' | 'edit' | 'delete' | 'custom';
+    key: string;
+    buttonProps?: any;
+    onClick?: (record: any) => void;
+    afterClose?: () => void;
+};
+export interface DataSourceTableProps {
+    __id?: string;
+    currentComponentId?: string;
+    currentSettingKey?: string;
+    title?: string | React.ReactNode | (() => React.ReactNode);
+    subTitle?: string | React.ReactNode | (() => React.ReactNode);
+    titleButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    };
+    tableButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    };
+    buttons?: any[];
+    operation?: {
+        show: boolean;
+        title: string;
+        width: number;
+        align: 'left' | 'center' | 'right';
+        fixed: 'left' | 'right' | false;
+        type: 'link' | 'button';
+        items: OperationItem[];
+    };
+    operationContent?: {
+        [key: string]: React.ReactNode;
+    };
+    dataSource: DataSourceType;
+    columns: ColumnType<any>[];
+    filter: any;
+    search?: {
+        show: boolean;
+        placeholder: string;
+    };
+    __designMode: string;
+    componentId: string;
+    clickToDetail?: {
+        show: boolean;
+        useCustomAction: boolean;
+        actionType: string;
+        openMode: 'modal' | 'drawer';
+        openContentSize: 'small' | 'middle' | 'large';
+        openTitle: string;
+        key: string;
+    };
+    onRow?: any;
+    filterBy?: Record<string, any>;
+    sortBy: string;
+    tabs?: {
+        show: boolean;
+        type: string;
+        items: {
+            name: string;
+            filterBy: Record<string, any>;
+            sortBy: string;
+        }[];
+    };
+    onValuesChange?: (changedValues: any, values: any) => void;
+    extraParams?: {
+        list?: Record<string, any>;
+        get?: Record<string, any>;
+        update?: Record<string, any>;
+        create?: Record<string, any>;
+        destroy?: Record<string, any>;
+    };
+    localSettings?: LocalSettingsType;
+}

package/lib/components/dataSourceComponents/fields/Input.Phone/serve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export declare const getShopCountryDataList: (locale?: any) => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

package/lib/components/dataSourceComponents/fields/Tabs/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 /** 包装 DataSource 层（提供数据源上下文） */
 declare const FormItemTabs: (props: import("./type").TabsProps & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
     options?: any;

package/lib/components/dataSourceComponents/fields/Upload/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const SUPPORTED_LANGUAGES: readonly ["original", "en", "zh-CN", "zh-HK", "ja", "pt"];
+export declare const DEFAULT_MAX_COUNT = 9;
+export declare const DEFAULT_UID = "-1";
+export declare const MEDIA_TYPES: {
+    readonly VIDEO: "video/";
+    readonly AUDIO: "audio/";
+};
+export declare const IMAGE_QUALITY = 0.8;
+export declare const IMAGE_TYPE = "image/jpeg";

package/lib/components/dataSourceComponents/fields/Upload/utils.d.ts

@@ -15,4 +15,4 @@ export declare const getFileMetadataParams: (file: RcFile & {
     metadata?: MediaMetadata;
 }) => Record<string, any>;
 export declare const isValueEqual: (value: any, fileListValue: any) => boolean;
-export declare const getBaseTime: (size: number) => 2000 | 1000 | 4000 | 8000;
+export declare const getBaseTime: (size: number) => 1000 | 2000 | 4000 | 8000;

package/lib/components/dataSourceComponents/fields/index.d.ts

@@ -80,16 +80,7 @@ declare const formFieldMap: {
         extraParams?: Record<string, any> | undefined;
     }) => import("react").JSX.Element;
 };
-declare const getFieldComponent: (fieldComponent: string) => ((props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
-    options?: any;
-    optionSourceType?: "default" | "custom" | "api" | undefined;
-    labelField: string;
-    valueField: string;
-    extraParams?: Record<string, any> | undefined;
-} & {
-    dataSource?: any;
-    extraParams?: Record<string, any> | undefined;
-}) => import("react").JSX.Element) | (import("react").FC<{}> & {
+declare const getFieldComponent: (fieldComponent: string) => (import("react").FC<{}> & {
     Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
 } & {
     Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
@@ -128,7 +119,16 @@ declare const getFieldComponent: (fieldComponent: string) => ((props: import("./
     extraParams?: Record<string, any> | undefined;
 }) => import("react").JSX.Element) | import("react").FC<any> | import("react").FC<import("./TimePicker/type").TimePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Phone/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Mobile/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & {
     onChange: (value: string) => void;
-} & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./DateRangePicker/type").DateRangePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Upload/type").UploadProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Translation/type").TranslationProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | ((props: import("./Tabs/type").TabsProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
+} & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./DateRangePicker/type").DateRangePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Upload/type").UploadProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Translation/type").TranslationProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | ((props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
+    options?: any;
+    optionSourceType?: "default" | "custom" | "api" | undefined;
+    labelField: string;
+    valueField: string;
+    extraParams?: Record<string, any> | undefined;
+} & {
+    dataSource?: any;
+    extraParams?: Record<string, any> | undefined;
+}) => import("react").JSX.Element) | ((props: import("./Tabs/type").TabsProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
     options?: any;
     optionSourceType?: "default" | "custom" | "api" | undefined;
     labelField: string;

package/lib/components/drag-sort-tree/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import './index.less';
+import { SortType } from './types';
+declare const DragSortTree: (props: SortType) => React.JSX.Element;
+export default DragSortTree;

package/lib/components/filter/components/Dropdown/types.d.ts

@@ -0,0 +1,13 @@
+import { FilterItemProps } from '../../types';
+export interface DropdownProps {
+    quickFilter: FilterItemProps[];
+    otherFilter: FilterItemProps[];
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    onChange: (list: {
+        quickFilter: FilterItemProps[];
+        otherFilter: FilterItemProps[];
+    }) => void;
+    quickFilterMaxLength: number;
+    formFiltersPrefix: string;
+}

package/lib/components/filter/components/FilterButton/types.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../../types';
+export declare type FilterValueType = {
+    quickFilter: FilterItemProps[];
+    otherFilter: FilterItemProps[];
+    /** 筛选项表单值，字段名 -> 值，与 Form 的 values 一致 */
+    values?: Record<string, any>;
+};
+export declare type FilterListProps = {
+    value?: FilterValueType;
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    onChange?: (value: FilterValueType) => void;
+    quickFilterMaxLength: number;
+    formFiltersPrefix: string;
+    renderItem?: (item: any, otherProps?: any) => React.ReactNode;
+    placement?: 'top' | 'left' | 'right' | 'bottom' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom';
+    /** 筛选按钮尺寸，与 antd Button size 一致 */
+    size?: 'small' | 'middle' | 'large';
+    /** 筛选触发按钮的 className，用于定制样式（如与设计系统对齐） */
+    buttonClassName?: string;
+    /** 筛选按钮文案，不传则使用 materials 内置多语言 */
+    buttonText?: string;
+};

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

@@ -0,0 +1,48 @@
+import { ModeType } from "../table/types";
+/**
+ * 筛选总配置
+ */
+export declare type FilterType = {
+    /** 筛选是否展示 */
+    show: boolean;
+    /** 筛选项排序按钮是否展示 */
+    sortButtonShow: boolean;
+    /** 筛选列表 */
+    list: FilterItemProps[];
+    items?: string[];
+    /** 快速筛选最大长度 */
+    quickFilterMaxLength: number;
+    /** 配置存储模式 */
+    storageMode: "" | "localStorage";
+    /** 筛选列表项dom */
+    dom?: any;
+};
+/**
+ * 筛选列表项配置
+ * - type 为 single/input/rangePicker 等时使用内置或映射组件
+ * - type 为 "custom" 时使用 other.component，组件接收 value/onChange（由 Form 注入）
+ */
+export declare type FilterItemProps = {
+    type: "single" | "input" | "datePicker" | "rangePicker" | "rangePickerNew" | "search" | "custom";
+    name?: string | string[];
+    key: string;
+    props?: object;
+    label?: string;
+    sort?: boolean;
+    localFilter?: boolean;
+    other: Record<string, any>;
+    isCustom?: boolean;
+    columnKey?: string;
+    isHidden?: boolean;
+};
+/**
+ * 筛选组件属性
+ */
+export interface FilterProps {
+    filter: FilterType;
+    isRenderFormContent: boolean;
+    onValuesChange?: () => void;
+    tableId?: string;
+    viewMode?: ModeType;
+    isMobile?: boolean;
+}