@pisell/materials 6.11.19 → 6.11.20

package/es/components/table/types.d.ts

@@ -0,0 +1,268 @@
+import { FilterType } from "../filter/types";
+import { SortItemProps } from "../sort/types";
+import React from "react";
+export declare type StorageMode = "" | "localStorage";
+/**
+ * 排序总配置
+ */
+export declare type SortType = {
+    /** 排序是否展示 */
+    show: boolean;
+    /** 排序存储模式 */
+    storageMode: StorageMode;
+    list: SortItemProps[];
+};
+/**
+ * 列展示总配置
+ */
+export declare type ColumnSettingType = {
+    /** 列设置是否展示 */
+    show: boolean;
+    /** 列设置存储模式 */
+    storageMode: StorageMode;
+};
+declare type DataSourceListItemType = {
+    isCustom: boolean;
+    columnKey?: string;
+    label?: string;
+    name?: string | string[];
+    isHidden?: boolean;
+};
+/**
+ * 数据源分组总配置
+ */
+export declare type DataSourceGroupType = {
+    /** 分组设置是否展示 */
+    show: boolean;
+    /** 分组设置存储模式 */
+    storageMode: StorageMode;
+    /**  */
+    list: DataSourceListItemType[];
+};
+/**
+ * Gallery封面总配置
+ */
+declare type GalleryCoverType = {
+    /** 封面是否展示 */
+    show: boolean;
+    /**
+     * 封面图片可以使用的字段
+     */
+    fields: string[];
+    /**
+     * 封面高度
+     */
+    height: number;
+    /** 图片裁剪方式 */
+    objectFit: "fill" | "cover";
+};
+/**
+ * Gallery标题总配置
+ */
+declare type GalleryTitleType = {
+    /** 标题使用的字段 */
+    field: string;
+    /** 标题行数 */
+    line: number;
+};
+/**
+ * Gallery头部区域总配置
+ */
+declare type GalleryHeaderType = {
+    /** 头部区域插槽 */
+    slot?: (record: Record<string, any>, index: number) => React.ReactNode;
+    /** 头部区域其他字段设置 */
+    fields: {
+        /** 头部区域其他字段是否展示 */
+        show: boolean;
+        /** 头部区域其他字段 */
+        list: string[];
+    };
+};
+/**
+ * Gallery内容区域总配置
+ */
+declare type GalleryContentType = {
+    /** 内容区域字段配置 */
+    fields: {
+        columnKey: string;
+        show: boolean;
+    }[];
+};
+export declare type GallerySettingValueType = {
+    coverField: string | "noCover";
+    coverObjectFit: "fill" | "cover";
+    compactMode: "default" | "compact";
+    isShowLabel: boolean;
+};
+/**
+ * Gallery底部区域总配置
+ */
+declare type GalleryFooterType = {
+    /** 底部区域自定义渲染 */
+    render: (record: Record<string, any>, index: number) => React.ReactNode;
+    /** 底部区域高度 */
+    height: number;
+};
+/**
+ * Gallery模式总配置
+ */
+export declare type GallerySettingType = {
+    /** 卡片最小宽度 */
+    cardMinWidth: number;
+    /** 卡片最大宽度 */
+    cardMaxWidth: number;
+    /** 水平间隔 */
+    horizontalGutter: number;
+    /** 垂直间隔 */
+    verticalGutter: number;
+    /** 封面配置 */
+    cover: GalleryCoverType;
+    /** 标题配置 */
+    title: GalleryTitleType;
+    /** 头部区域 */
+    header: GalleryHeaderType;
+    /** 内容区域 */
+    content: GalleryContentType;
+    /** 固定高度 */
+    fixedHeight: boolean;
+    /** 固定的卡片高度 */
+    cardHeight: number;
+    /** 固定顶部 */
+    fixedHeader: boolean;
+    /** 固定底部 */
+    fixedFooter: boolean;
+    /** 底部区域 */
+    footer: GalleryFooterType;
+    /** 卡片点击时间 */
+    onItem: (record: Record<string, any>, index: number) => void;
+};
+/** 视图模式 */
+export declare type ModeType = "grid" | "gallery" | "kanban";
+/**
+ * 视图模式总配置
+ */
+export declare type GridViewType = {
+    /** 默认视图模式 */
+    defaultViewMode: ModeType;
+    /** 开启多视图模式可进行页面内转换 */
+    multiple: boolean;
+    /** 当前可用的视图模式列表 */
+    modeList: ModeType[];
+};
+declare type SortDetail = {
+    fromIndex: number;
+    toIndex: number;
+    dataSource: Record<string, any>[];
+    fromId: number | string;
+    toId: number | string;
+    fromItem: Record<string, any>;
+    toItem: Record<string, any>;
+};
+/** 导入导出模式 */
+export declare type ExportImportModeType = "import" | "export" | "export_file" | "import_log";
+/**
+ * @title: 导出导入api
+ * @description:
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2024-09-11 15:44
+ */
+export declare type ApiProps = {
+    export?: string;
+    import?: string;
+    export_file: string;
+    import_log?: string;
+    template?: string;
+};
+/**
+ * 导入导出配置
+ */
+export declare type ExportImportType = {
+    /** 是否展示 */
+    show: boolean;
+    /** 当前所选项 */
+    selectLists: string[];
+    /** 导入模版链接 */
+    templateFileUrl: string;
+    /** 标题 */
+    title: string;
+    hiddenKeys?: string[];
+    apiUrl?: ApiProps;
+    otherParams?: any;
+};
+/**
+ * 设置记忆范围
+ */
+export declare type LocalSettingsScope = "filters" | "sorting" | "columns";
+/**
+ * 本地记忆设置
+ */
+export declare type LocalSettingsType = {
+    /** 启用设置记忆 */
+    enable: boolean;
+    /** 记忆范围 */
+    scope: LocalSettingsScope[];
+    /** 不需要记忆的筛选字段（当 scope 包含 filters 时生效） */
+    excludedFilterFields?: string[];
+};
+export declare type GridViewProps = {
+    columns: any;
+    dataSource: any[];
+    dispatch: any;
+    /**
+     * 画册模式的配置
+     */
+    gallery: GallerySettingType;
+    /**
+     * 视图设置
+     */
+    view: GridViewType;
+    style: React.CSSProperties;
+    pagination: any;
+    filter: FilterType;
+    buttons: React.ReactNode | any[];
+    actionButtons: any;
+    sort: SortType;
+    title?: React.ReactNode | (() => React.ReactNode);
+    showTitle?: boolean;
+    subTitle?: React.ReactNode | (() => React.ReactNode);
+    showSubTitle?: boolean;
+    exportImport: ExportImportType;
+    onValuesChange: (changedValues: any, values: any) => void;
+    summary: any;
+    utils: any;
+    rowKey: ((record: Record<string, any>) => string) | string;
+    columnSetting?: ColumnSettingType;
+    dataSourceGroup?: DataSourceGroupType;
+    loading: boolean;
+    dragSort: boolean;
+    onSortChange?: (detail: SortDetail) => boolean;
+    __id?: string;
+    __designMode?: "design";
+    /**
+     * 当前本地配置的key 用此hash是否改变用来判断是否清空本地配置 不填默认使用columns数据生成hash
+     */
+    currentSettingKey?: string;
+    /**
+    * 当前本地配置的唯一值, 不填默认使用currentSettingKey
+    */
+    currentComponentId?: string;
+    /**
+     * 当前表格中数据发生变化事件 包含本地筛选和外部传入数据变化
+     * @param currentDataSource
+     */
+    onDataSourceChange?: (currentDataSource: Record<string, any>[]) => void;
+    tabs: {
+        show: boolean;
+        type: 'default' | 'button' | 'buttonGroup' | 'dropdown';
+        items: {
+            name: string;
+            filterBy?: Record<string, any>;
+            sortBy?: string;
+        }[];
+    };
+    /** 本地记忆设置 */
+    localSettings?: LocalSettingsType;
+};
+export {};

package/es/components/versionModal/index.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { Version } from '../versionSelect';
+import './index.less';
+interface PublishVersionModalProps {
+    visible: boolean;
+    currentVersion: string;
+    onCancel: () => void;
+    onConfirm: (data: VersionData) => void;
+    isShowNote?: boolean;
+    confirmLoading?: boolean;
+    versions?: Version[];
+    isShowBasedOn?: boolean;
+    isShowCurrentVersion?: boolean;
+    isValidateVersion?: boolean;
+}
+interface VersionData {
+    version: string;
+    note: string;
+    baseVersion?: string;
+    versionType?: string;
+}
+declare const PublishVersionModal: React.FC<PublishVersionModalProps>;
+export default PublishVersionModal;

package/es/hooks/useResponsive.d.ts

@@ -1,4 +1,4 @@
 declare type ResponsiveConfig = Record<string, number>;
 export declare function configResponsive(config: ResponsiveConfig): void;
-export default function useResponsive(): "phone" | "pc" | "ipad";
+export default function useResponsive(): "pc" | "ipad" | "phone";
 export {};

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

@@ -0,0 +1,290 @@
+import { CSSProperties, ReactNode } from 'react';
+import { PisellBasicCardProps } from '../../types';
+import { PisellImageCardProps } from '../PisellImageCard/types';
+/**
+ * 样式变体类型
+ */
+export declare type GraphicTextCardVariant = 'vertical-image' | 'vertical-icon' | 'horizontal' | 'card';
+/**
+ * 尺寸类型
+ */
+export declare type GraphicTextCardSize = 'small' | 'default' | 'large';
+/**
+ * 宽度模式
+ */
+export declare type GraphicTextCardWidthMode = 'auto' | 'fixed' | 'full';
+/**
+ * 图形区域配置
+ */
+export interface GraphicConfig extends PisellImageCardProps {
+    hidden?: boolean;
+    /**
+     * 图形区域宽度（单位：px）
+     * 如不设置，将根据 variant 和 size 自动计算
+     */
+    width?: number;
+    /**
+     * 图形区域高度（单位：px）
+     * 如不设置，将根据 variant 和 size 自动计算
+     */
+    height?: number;
+    /**
+     * 图形区域圆角
+     */
+    borderRadius?: number | string;
+    /**
+     * 图形区域背景色
+     */
+    background?: string;
+    /**
+     * 图形区域边框
+     */
+    border?: string;
+    /**
+     * 图形区域阴影
+     */
+    boxShadow?: string;
+    /**
+     * 图形区域内边距
+     */
+    padding?: number | string;
+    /**
+     * 图标大小（当使用 icon 时有效，单位：px）
+     */
+    iconSize?: number;
+    /**
+     * 图标颜色（当使用 icon 时有效）
+     */
+    iconColor?: 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';
+}
+/**
+ * GraphicTextCard 组件 Props
+ * 基于 PisellBasicCardProps 扩展
+ * 注意：重写 onClick 为可选属性
+ */
+export interface GraphicTextCardProps extends Omit<PisellBasicCardProps, 'onClick'> {
+    /**
+     * 卡片显示的文本内容（必填）
+     */
+    text: ReactNode;
+    /**
+     * 卡片样式变体
+     * @default 'vertical-image'
+     */
+    variant?: GraphicTextCardVariant;
+    /**
+     * 卡片尺寸
+     * @default 'default'
+     */
+    size?: GraphicTextCardSize;
+    /**
+     * 是否可点击
+     * @default true
+     */
+    clickable?: boolean;
+    /**
+     * 图片地址
+     * 与 icon 二选一，优先使用 image
+     */
+    image?: string;
+    /**
+     * 图标
+     * 支持 ReactNode（如 antd Icon、svg 等）或图标 URL
+     * 与 image 二选一
+     */
+    icon?: ReactNode;
+    /**
+     * 图形区域配置
+     * 用于自定义图形区域的样式和尺寸
+     */
+    graphicConfig?: GraphicConfig;
+    /**
+     * 图形区域插槽
+     * 用于完全自定义图形区域，优先级高于 image 和 icon
+     */
+    graphicSlot?: ReactNode;
+    /**
+     * 角标配置
+     * 用于显示红点、数字或文本提示
+     */
+    badge?: BadgeConfig;
+    /**
+     * 前置插槽
+     * 用于在图形区域前添加自定义内容
+     */
+    prefixSlot?: ReactNode;
+    /**
+     * 后置插槽
+     * 用于在文本内容后添加自定义内容
+     */
+    suffixSlot?: ReactNode;
+    /**
+     * 文本配置
+     * 用于自定义文本样式和显示行为
+     */
+    textConfig?: TextConfig;
+    /**
+     * 宽度模式
+     * - auto: 内容撑满，最大宽度 maxWidth
+     * - fixed: 固定宽度 width
+     * - full: 撑满父容器
+     * @default 'auto'
+     */
+    widthMode?: GraphicTextCardWidthMode;
+    /**
+     * 固定宽度值
+     * 当 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: GraphicTextCardProps) => ReactNode;
+}
+/**
+ * GraphicArea 组件 Props
+ * 图形区域子组件
+ */
+export interface GraphicAreaProps {
+    /**
+     * 图片地址
+     */
+    image?: string;
+    /**
+     * 图标内容
+     */
+    icon?: ReactNode;
+    /**
+     * 图形配置
+     */
+    config?: GraphicConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    aliWidth?: number;
+}
+/**
+ * TextContent 组件 Props
+ * 文本内容子组件
+ */
+export interface TextContentProps {
+    /**
+     * 文本内容
+     */
+    text: ReactNode;
+    /**
+     * 文本配置
+     */
+    textConfig?: TextConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    active: PisellBasicCardProps['active'];
+}
+/**
+ * BadgeWrapper 组件 Props
+ * 角标包装子组件
+ */
+export interface BadgeWrapperProps {
+    /**
+     * 角标配置
+     */
+    badge?: BadgeConfig;
+    /**
+     * 子元素
+     */
+    children: ReactNode;
+}

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import './TextCard.less';
+/**
+ * Provider 包装器
+ * 兼容 PisellCards 系统的 props 传递方式
+ */
+declare const Provider: (props: any) => React.JSX.Element;
+export default Provider;

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/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;