@pisell/materials 6.3.23 → 6.3.25

package/es/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/es/components/PisellCards/components/GraphicTextCard/types.js

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

package/es/components/PisellCards/components/GraphicTextCard/utils/index.d.ts

@@ -0,0 +1,19 @@
+import { GraphicTextCardVariant, GraphicTextCardSize } from '../types';
+/**
+ * 获取图形区域的默认尺寸
+ * 根据样式变体和尺寸返回对应的默认宽高
+ *
+ * @param variant - 样式变体
+ * @param size - 尺寸
+ * @returns 默认的宽度和高度
+ *
+ * @example
+ * ```ts
+ * const size = getDefaultGraphicSize('vertical-image', 'default');
+ * // 返回 { width: 36, height: 36 }
+ * ```
+ */
+export declare const getDefaultGraphicSize: (variant: GraphicTextCardVariant, size: GraphicTextCardSize) => {
+    width: number | string;
+    height: number | string;
+};

package/es/components/PisellCards/components/GraphicTextCard/utils/index.js

@@ -0,0 +1,78 @@
+/**
+ * 获取图形区域的默认尺寸
+ * 根据样式变体和尺寸返回对应的默认宽高
+ * 
+ * @param variant - 样式变体
+ * @param size - 尺寸
+ * @returns 默认的宽度和高度
+ * 
+ * @example
+ * ```ts
+ * const size = getDefaultGraphicSize('vertical-image', 'default');
+ * // 返回 { width: 36, height: 36 }
+ * ```
+ */
+export var getDefaultGraphicSize = function getDefaultGraphicSize(variant, size) {
+  // 样式一和样式二（垂直布局）- 正方形图标/图片
+  if (variant === 'vertical-image' || variant === 'vertical-icon') {
+    var sizeMap = {
+      small: {
+        width: 28,
+        height: 28
+      },
+      default: {
+        width: 36,
+        height: 36
+      },
+      large: {
+        width: 44,
+        height: 44
+      }
+    };
+    return sizeMap[size];
+  }
+
+  // 样式三（横向布局）- 矩形图片
+  if (variant === 'horizontal') {
+    var _sizeMap = {
+      small: {
+        width: 48,
+        height: 40
+      },
+      default: {
+        width: 64,
+        height: 52
+      },
+      large: {
+        width: 80,
+        height: 64
+      }
+    };
+    return _sizeMap[size];
+  }
+
+  // 样式四（卡片式）- 矩形图片（上下布局）
+  if (variant === 'card') {
+    var _sizeMap2 = {
+      small: {
+        width: 56,
+        height: 56
+      },
+      default: {
+        width: 72,
+        height: 60
+      },
+      large: {
+        width: 88,
+        height: 72
+      }
+    };
+    return _sizeMap2[size];
+  }
+
+  // 默认尺寸
+  return {
+    width: 36,
+    height: 36
+  };
+};

package/es/components/PisellCards/components/MultilevelCard/MultilevelCard.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { MultilevelCardProps } from './types';
+import './MultilevelCard.less';
+/**
+ * MultilevelCard 组件
+ * 多层级卡片组件，支持点击或 hover 展开次级面板
+ *
+ * @example
+ * ```tsx
+ * <MultilevelCard
+ *   card={<TextCard text="分类1" />}
+ *   panel={<div>次级内容</div>}
+ *   trigger="click"
+ * />
+ * ```
+ */
+export declare const MultilevelCard: React.FC<MultilevelCardProps<any>>;
+declare const Provider: (props: any) => React.JSX.Element;
+export default Provider;

package/es/components/PisellCards/components/MultilevelCard/MultilevelCard.js

@@ -0,0 +1,122 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+import React, { useEffect } from 'react';
+import ReactDOM from 'react-dom';
+import classNames from 'classnames';
+import { CardWrapper, PanelWrapper } from "./components";
+import { useMultilevelCardExpand, useMultilevelCardHover } from "./hooks";
+import "./MultilevelCard.less";
+
+/**
+ * MultilevelCard 组件
+ * 多层级卡片组件，支持点击或 hover 展开次级面板
+ *
+ * @example
+ * ```tsx
+ * <MultilevelCard
+ *   card={<TextCard text="分类1" />}
+ *   panel={<div>次级内容</div>}
+ *   trigger="click"
+ * />
+ * ```
+ */
+export var MultilevelCard = function MultilevelCard(props) {
+  var card = props.card,
+    panel = props.panel,
+    dataSource = props.dataSource,
+    active = props.active,
+    disabled = props.disabled,
+    loading = props.loading,
+    children = props.children,
+    onClick = props.onClick,
+    _props$trigger = props.trigger,
+    trigger = _props$trigger === void 0 ? 'click' : _props$trigger,
+    hoverDelay = props.hoverDelay,
+    _props$panelWidthMode = props.panelWidthMode,
+    panelWidthMode = _props$panelWidthMode === void 0 ? 'full' : _props$panelWidthMode,
+    panelWidth = props.panelWidth,
+    panelStyle = props.panelStyle,
+    panelClassName = props.panelClassName,
+    panelContainer = props.panelContainer,
+    _props$animation = props.animation,
+    animation = _props$animation === void 0 ? true : _props$animation,
+    _props$animationDurat = props.animationDuration,
+    animationDuration = _props$animationDurat === void 0 ? 300 : _props$animationDurat,
+    onExpandChange = props.onExpandChange,
+    onPanelMount = props.onPanelMount,
+    onPanelUnmount = props.onPanelUnmount,
+    className = props.className,
+    style = props.style,
+    __designMode = props.__designMode;
+
+  // 展开/收起状态管理
+  var _useMultilevelCardExp = useMultilevelCardExpand({
+      active: active,
+      trigger: trigger,
+      onExpandChange: onExpandChange
+    }),
+    expanded = _useMultilevelCardExp.expanded,
+    setExpanded = _useMultilevelCardExp.setExpanded;
+
+  // Hover 交互处理
+  var _useMultilevelCardHov = useMultilevelCardHover({
+      enabled: trigger === 'hover',
+      delay: hoverDelay,
+      onExpandChange: setExpanded
+    }),
+    onMouseEnter = _useMultilevelCardHov.onMouseEnter,
+    onMouseLeave = _useMultilevelCardHov.onMouseLeave;
+  useEffect(function () {
+    document.body.id = 'body';
+  }, []);
+
+  // 渲染次级面板
+  var renderPanel = function renderPanel() {
+    // 如果没有 panel 内容，不渲染
+    if (!panel || !expanded) {
+      return null;
+    }
+    var panelElement = /*#__PURE__*/React.createElement(PanelWrapper, {
+      visible: expanded,
+      widthMode: panelWidthMode,
+      width: panelWidth,
+      style: panelStyle,
+      className: panelClassName,
+      animation: animation,
+      animationDuration: animationDuration,
+      onMount: onPanelMount,
+      onUnmount: onPanelUnmount,
+      onMouseEnter: trigger === 'hover' ? onMouseEnter : undefined,
+      onMouseLeave: trigger === 'hover' ? onMouseLeave : undefined,
+      props: props
+    }, panel === null || panel === void 0 ? void 0 : panel(props));
+
+    // 如果指定了容器，使用 Portal 渲染
+    if (panelContainer !== null && panelContainer !== void 0 && panelContainer(props) && typeof document !== 'undefined') {
+      return /*#__PURE__*/ReactDOM.createPortal(panelElement, panelContainer(props));
+    }
+    return panelElement;
+  };
+
+  // 组件类名
+  var multilevelCardClassName = classNames('multilevel-card', {
+    'multilevel-card--expanded': expanded,
+    'multilevel-card--click': trigger === 'click',
+    'multilevel-card--hover': trigger === 'hover'
+  }, className);
+  return /*#__PURE__*/React.createElement("div", {
+    className: multilevelCardClassName,
+    style: style
+  }, /*#__PURE__*/React.createElement(CardWrapper, {
+    trigger: trigger,
+    onMouseEnter: onMouseEnter,
+    onMouseLeave: onMouseLeave,
+    className: "multilevel-card__card"
+  }, card === null || card === void 0 ? void 0 : card(props)), renderPanel());
+};
+
+// 设置显示名称（用于调试）
+MultilevelCard.displayName = 'MultilevelCard';
+var Provider = function Provider(props) {
+  return /*#__PURE__*/React.createElement(MultilevelCard, _extends({}, props === null || props === void 0 ? void 0 : props.props, props));
+};
+export default Provider;

package/es/components/PisellCards/components/MultilevelCard/MultilevelCard.less

@@ -0,0 +1,52 @@
+// MultilevelCard 组件样式
+
+.multilevel-card {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  scroll-snap-align: start;
+
+  // 主卡片区域
+  &__card {
+    position: relative;
+  }
+
+  // 次级面板区域
+  .multilevel-card-panel {
+    position: relative;
+    overflow: hidden;
+    max-height: 0;
+    opacity: 0;
+
+    // 可见状态
+    &--visible {
+      max-height: 2000px; // 足够大的值，确保内容完全展示
+      opacity: 1;
+    }
+
+    // 隐藏状态
+    &--hidden {
+      max-height: 0;
+      opacity: 0;
+    }
+  }
+
+  // Click 模式
+  &--click {
+    .multilevel-card__card {
+      cursor: pointer;
+    }
+  }
+
+  // Hover 模式
+  &--hover {
+    .multilevel-card__card {
+      cursor: pointer;
+    }
+  }
+
+  // 展开状态
+  &--expanded {
+    // 可以在这里添加展开状态下的样式
+  }
+}

package/es/components/PisellCards/components/MultilevelCard/components/CardWrapper.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { CardWrapperProps } from '../types';
+/**
+ * CardWrapper 组件
+ * 主卡片包装器，负责注入事件监听
+ */
+export declare const CardWrapper: React.FC<CardWrapperProps>;

package/es/components/PisellCards/components/MultilevelCard/components/CardWrapper.js

@@ -0,0 +1,54 @@
+import React from 'react';
+/**
+ * CardWrapper 组件
+ * 主卡片包装器，负责注入事件监听
+ */
+export var CardWrapper = function CardWrapper(props) {
+  var children = props.children,
+    trigger = props.trigger,
+    onClick = props.onClick,
+    onMouseEnter = props.onMouseEnter,
+    onMouseLeave = props.onMouseLeave,
+    className = props.className;
+
+  // 如果 children 不是 ReactElement，直接渲染
+  if (! /*#__PURE__*/React.isValidElement(children)) {
+    console.warn('[MultilevelCard] card 必须是 ReactElement');
+    return /*#__PURE__*/React.createElement(React.Fragment, null, children);
+  }
+
+  // 克隆主卡片元素，注入事件监听
+  var enhancedCard = /*#__PURE__*/React.cloneElement(children, {
+    // onClick: (e: React.MouseEvent<HTMLDivElement>) => {
+    //   // 先调用原有的 onClick
+    //   const originalOnClick = (children as React.ReactElement).props.onClick;
+    //   originalOnClick?.(e);
+    //   // 如果是 click 模式，不需要额外处理（通过 active 控制）
+    //   // 这里预留扩展
+    //   onClick?.();
+    // },
+    // onMouseEnter: (e: React.MouseEvent<HTMLDivElement>) => {
+    //   // 先调用原有的 onMouseEnter
+    //   const originalOnMouseEnter = (children as React.ReactElement).props.onMouseEnter;
+    //   originalOnMouseEnter?.(e);
+    //   // Hover 模式下的处理
+    //   if (trigger === 'hover') {
+    //     onMouseEnter?.();
+    //   }
+    // },
+    // onMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => {
+    //   // 先调用原有的 onMouseLeave
+    //   const originalOnMouseLeave = (children as React.ReactElement).props.onMouseLeave;
+    //   originalOnMouseLeave?.(e);
+    //   // Hover 模式下的处理
+    //   if (trigger === 'hover') {
+    //     onMouseLeave?.();
+    //   }
+    // },
+    // className: classNames(
+    //   (children as React.ReactElement).props.className,
+    //   className
+    // ),
+  });
+  return enhancedCard;
+};

package/es/components/PisellCards/components/MultilevelCard/components/PanelWrapper.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { PanelWrapperProps } from '../types';
+/**
+ * PanelWrapper 组件
+ * 次级面板包装器，负责展开/收起动画和样式处理
+ */
+export declare const PanelWrapper: React.FC<PanelWrapperProps>;