@pisell/materials 1.0.983 → 1.0.988

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/GraphicTextCard/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellCards/components/GraphicTextCard/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/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/lib/components/PisellCards/components/GraphicTextCard/utils/index.js

@@ -0,0 +1,55 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellCards/components/GraphicTextCard/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  getDefaultGraphicSize: () => getDefaultGraphicSize
+});
+module.exports = __toCommonJS(utils_exports);
+var getDefaultGraphicSize = (variant, size) => {
+  if (variant === "vertical-image" || variant === "vertical-icon") {
+    const sizeMap = {
+      small: { width: 28, height: 28 },
+      default: { width: 36, height: 36 },
+      large: { width: 44, height: 44 }
+    };
+    return sizeMap[size];
+  }
+  if (variant === "horizontal") {
+    const sizeMap = {
+      small: { width: 48, height: 40 },
+      default: { width: 64, height: 52 },
+      large: { width: 80, height: 64 }
+    };
+    return sizeMap[size];
+  }
+  if (variant === "card") {
+    const sizeMap = {
+      small: { width: 56, height: 56 },
+      default: { width: 72, height: 60 },
+      large: { width: 88, height: 72 }
+    };
+    return sizeMap[size];
+  }
+  return { width: 36, height: 36 };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDefaultGraphicSize
+});

package/lib/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) => JSX.Element;
+export default Provider;

package/lib/components/PisellCards/components/MultilevelCard/MultilevelCard.js

@@ -0,0 +1,137 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellCards/components/MultilevelCard/MultilevelCard.tsx
+var MultilevelCard_exports = {};
+__export(MultilevelCard_exports, {
+  MultilevelCard: () => MultilevelCard,
+  default: () => MultilevelCard_default
+});
+module.exports = __toCommonJS(MultilevelCard_exports);
+var import_react = __toESM(require("react"));
+var import_react_dom = __toESM(require("react-dom"));
+var import_classnames = __toESM(require("classnames"));
+var import_components = require("./components");
+var import_hooks = require("./hooks");
+var import_MultilevelCard = require("./MultilevelCard.less");
+var MultilevelCard = (props) => {
+  const {
+    card,
+    panel,
+    dataSource,
+    active,
+    disabled,
+    loading,
+    children,
+    onClick,
+    trigger = "click",
+    hoverDelay,
+    panelWidthMode = "full",
+    panelWidth,
+    panelStyle,
+    panelClassName,
+    panelContainer,
+    animation = true,
+    animationDuration = 300,
+    onExpandChange,
+    onPanelMount,
+    onPanelUnmount,
+    className,
+    style,
+    __designMode
+  } = props;
+  const { expanded, setExpanded } = (0, import_hooks.useMultilevelCardExpand)({
+    active,
+    trigger,
+    onExpandChange
+  });
+  const { onMouseEnter, onMouseLeave } = (0, import_hooks.useMultilevelCardHover)({
+    enabled: trigger === "hover",
+    delay: hoverDelay,
+    onExpandChange: setExpanded
+  });
+  (0, import_react.useEffect)(() => {
+    document.body.id = "body";
+  }, []);
+  const renderPanel = () => {
+    if (!panel || !expanded) {
+      return null;
+    }
+    const panelElement = /* @__PURE__ */ import_react.default.createElement(
+      import_components.PanelWrapper,
+      {
+        visible: expanded,
+        widthMode: panelWidthMode,
+        width: panelWidth,
+        style: panelStyle,
+        className: panelClassName,
+        animation,
+        animationDuration,
+        onMount: onPanelMount,
+        onUnmount: onPanelUnmount,
+        onMouseEnter: trigger === "hover" ? onMouseEnter : void 0,
+        onMouseLeave: trigger === "hover" ? onMouseLeave : void 0,
+        props
+      },
+      panel == null ? void 0 : panel(props)
+    );
+    if ((panelContainer == null ? void 0 : panelContainer(props)) && typeof document !== "undefined") {
+      return import_react_dom.default.createPortal(
+        panelElement,
+        panelContainer(props)
+      );
+    }
+    return panelElement;
+  };
+  const multilevelCardClassName = (0, import_classnames.default)(
+    "multilevel-card",
+    {
+      "multilevel-card--expanded": expanded,
+      "multilevel-card--click": trigger === "click",
+      "multilevel-card--hover": trigger === "hover"
+    },
+    className
+  );
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: multilevelCardClassName, style }, /* @__PURE__ */ import_react.default.createElement(
+    import_components.CardWrapper,
+    {
+      trigger,
+      onMouseEnter,
+      onMouseLeave,
+      className: "multilevel-card__card"
+    },
+    card == null ? void 0 : card(props)
+  ), renderPanel());
+};
+MultilevelCard.displayName = "MultilevelCard";
+var Provider = (props) => /* @__PURE__ */ import_react.default.createElement(MultilevelCard, { ...props == null ? void 0 : props.props, ...props });
+var MultilevelCard_default = Provider;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MultilevelCard
+});

package/lib/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/lib/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/lib/components/PisellCards/components/MultilevelCard/components/CardWrapper.js

@@ -0,0 +1,79 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellCards/components/MultilevelCard/components/CardWrapper.tsx
+var CardWrapper_exports = {};
+__export(CardWrapper_exports, {
+  CardWrapper: () => CardWrapper
+});
+module.exports = __toCommonJS(CardWrapper_exports);
+var import_react = __toESM(require("react"));
+var CardWrapper = (props) => {
+  const { children, trigger, onClick, onMouseEnter, onMouseLeave, className } = props;
+  if (!import_react.default.isValidElement(children)) {
+    console.warn("[MultilevelCard] card 必须是 ReactElement");
+    return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, children);
+  }
+  const enhancedCard = import_react.default.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;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CardWrapper
+});

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