@pisell/materials 6.7.4 → 6.8.2

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

@@ -0,0 +1,35 @@
+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/index.tsx
+var MultilevelCard_exports = {};
+__export(MultilevelCard_exports, {
+  default: () => import_MultilevelCard.default
+});
+module.exports = __toCommonJS(MultilevelCard_exports);
+var import_MultilevelCard = __toESM(require("./MultilevelCard"));

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

@@ -0,0 +1,202 @@
+import { CSSProperties, ReactNode } from 'react';
+import { PisellBasicCardProps } from '../../types';
+/**
+ * 触发方式类型
+ */
+export declare type MultilevelCardTrigger = 'click' | 'hover';
+/**
+ * 次级面板宽度模式
+ */
+export declare type MultilevelCardPanelWidthMode = 'auto' | 'fixed' | 'full';
+/**
+ * Hover 延迟配置
+ */
+export interface MultilevelCardHoverDelay {
+    /**
+     * 鼠标进入延迟时间（毫秒）
+     * @default 100
+     */
+    enter?: number;
+    /**
+     * 鼠标离开延迟时间（毫秒）
+     * @default 200
+     */
+    leave?: number;
+}
+/**
+ * MultilevelCard 组件 Props
+ */
+export interface MultilevelCardProps<T> extends PisellBasicCardProps {
+    /**
+     * 主卡片插槽
+     * 传入任意 Card 组件（如 TextCard、GraphicTextCard 等）
+     * 主卡片需实现 PisellBasicCardProps 中的 active 属性（click 模式下）
+     */
+    card: (props: T) => ReactNode;
+    /**
+     * 次级面板插槽
+     * 传入自定义内容，当主卡片 active 时展示
+     */
+    panel?: (props: T) => ReactNode;
+    /**
+     * 触发方式
+     * - click: 点击触发，通过主卡片的 active 状态控制展开/收起
+     * - hover: 悬停触发，鼠标进入展开，离开时收起
+     * @default 'click'
+     */
+    trigger?: MultilevelCardTrigger;
+    /**
+     * hover 模式下的延迟时间（毫秒）
+     * 用于防抖处理，避免鼠标快速划过时频繁触发
+     * @default { enter: 100, leave: 200 }
+     */
+    hoverDelay?: MultilevelCardHoverDelay;
+    /**
+     * 次级面板宽度模式
+     * - auto: 内容撑满
+     * - fixed: 固定宽度，需配合 panelWidth 使用
+     * - full: 撑满父容器
+     * @default 'full'
+     */
+    panelWidthMode?: MultilevelCardPanelWidthMode;
+    /**
+     * 固定宽度值（单位：px 或任意 CSS 宽度值）
+     * 当 panelWidthMode='fixed' 时有效
+     * @example 300 | '300px' | '50%'
+     */
+    panelWidth?: number | string;
+    /**
+     * 次级面板样式
+     * 用于自定义次级面板的样式
+     */
+    panelStyle?: CSSProperties;
+    /**
+     * 次级面板类名
+     * 用于自定义次级面板的类名
+     */
+    panelClassName?: string;
+    /**
+     * 次级面板容器
+     * 传入 DOM 节点，次级面板将渲染到该节点中（使用 Portal）
+     * 不传则默认渲染在组件内部（主卡片下方）
+     */
+    panelContainer?: (props: any) => HTMLElement | null;
+    /**
+     * 是否启用动画
+     * 控制次级面板展开/收起时的过渡动画
+     * @default true
+     */
+    animation?: boolean;
+    /**
+     * 动画持续时间（毫秒）
+     * @default 300
+     */
+    animationDuration?: number;
+    /**
+     * 展开状态变化回调
+     * @param expanded - 是否展开
+     */
+    onExpandChange?: (expanded: boolean) => void;
+    /**
+     * 次级面板渲染完成回调
+     * 当次级面板挂载到 DOM 时触发
+     */
+    onPanelMount?: () => void;
+    /**
+     * 次级面板卸载回调
+     * 当次级面板从 DOM 卸载时触发
+     */
+    onPanelUnmount?: () => void;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+}
+/**
+ * CardWrapper 组件 Props
+ * 主卡片包装器子组件
+ */
+export interface CardWrapperProps {
+    /**
+     * 主卡片内容
+     */
+    children: ReactNode;
+    /**
+     * 触发方式
+     */
+    trigger: MultilevelCardTrigger;
+    /**
+     * 点击事件
+     */
+    onClick?: () => void;
+    /**
+     * 鼠标进入事件
+     */
+    onMouseEnter?: () => void;
+    /**
+     * 鼠标离开事件
+     */
+    onMouseLeave?: () => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * PanelWrapper 组件 Props
+ * 次级面板包装器子组件
+ */
+export interface PanelWrapperProps {
+    /**
+     * 次级面板内容
+     */
+    children?: ReactNode;
+    /**
+     * 是否可见
+     */
+    visible: boolean;
+    /**
+     * 宽度模式
+     */
+    widthMode?: MultilevelCardPanelWidthMode;
+    /**
+     * 固定宽度值
+     */
+    width?: number | string;
+    /**
+     * 是否启用动画
+     */
+    animation?: boolean;
+    /**
+     * 动画持续时间（毫秒）
+     */
+    animationDuration?: number;
+    /**
+     * 渲染完成回调
+     */
+    onMount?: () => void;
+    /**
+     * 卸载回调
+     */
+    onUnmount?: () => void;
+    /**
+     * 鼠标进入事件（hover 模式下使用）
+     */
+    onMouseEnter?: () => void;
+    /**
+     * 鼠标离开事件（hover 模式下使用）
+     */
+    onMouseLeave?: () => void;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}

package/lib/components/PisellCards/components/MultilevelCard/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/MultilevelCard/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

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

@@ -0,0 +1,6 @@
+/**
+ * 格式化宽度值
+ * @param width - 宽度值（数字或字符串）
+ * @returns 格式化后的宽度值
+ */
+export declare const formatWidth: (width: number | string | undefined) => string | undefined;

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

@@ -0,0 +1,37 @@
+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/MultilevelCard/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  formatWidth: () => formatWidth
+});
+module.exports = __toCommonJS(utils_exports);
+var formatWidth = (width) => {
+  if (width === void 0) {
+    return void 0;
+  }
+  if (typeof width === "number") {
+    return `${width}px`;
+  }
+  return width;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatWidth
+});

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

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

package/lib/components/PisellCards/components/PisellImageCard/PisellImageCard.js

@@ -0,0 +1,131 @@
+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/PisellImageCard/PisellImageCard.tsx
+var PisellImageCard_exports = {};
+__export(PisellImageCard_exports, {
+  default: () => PisellImageCard_default
+});
+module.exports = __toCommonJS(PisellImageCard_exports);
+var import_react = __toESM(require("react"));
+var import_hooks = require("./hooks");
+var import_utils = require("./utils");
+var import_PisellImageCard = require("./PisellImageCard.less");
+var import_utils2 = require("@pisell/utils");
+var PisellImageCard = (props) => {
+  const {
+    dataSource = {},
+    fillMode = "cover",
+    lazy = false,
+    active,
+    disabled,
+    loading: loadingState,
+    children,
+    onClick,
+    aliWidth,
+    ...restProps
+  } = props;
+  const { src, alt, errorSrc, fallbackSrc, text } = dataSource;
+  const {
+    loading: imageLoading,
+    error: imageError,
+    imgRef
+  } = (0, import_hooks.useImageLoad)(src, lazy);
+  const { mergedStyle, mergedClassName } = (0, import_hooks.usePisellImageCardStyle)(props);
+  const displaySource = (0, import_react.useMemo)(() => {
+    if (imageLoading && fallbackSrc) {
+      return fallbackSrc;
+    }
+    if (imageError && errorSrc) {
+      return errorSrc;
+    }
+    if (src) {
+      return src;
+    }
+    return null;
+  }, [imageLoading, imageError, src, errorSrc, fallbackSrc]);
+  const showTextFallback = (0, import_react.useMemo)(() => {
+    return alt;
+  }, [displaySource, alt]);
+  const truncatedText = (0, import_react.useMemo)(() => {
+    if (text) {
+      return text;
+    }
+    return (0, import_utils.getTruncatedText)(alt, 2);
+  }, [alt, text]);
+  const handleClick = (0, import_react.useCallback)(
+    (e) => {
+      if ((disabled == null ? void 0 : disabled.value) || (loadingState == null ? void 0 : loadingState.value)) {
+        return;
+      }
+      onClick == null ? void 0 : onClick(e);
+    },
+    [disabled, loadingState, onClick]
+  );
+  const renderExtra = (0, import_react.useCallback)(() => {
+    if ((loadingState == null ? void 0 : loadingState.value) && (loadingState == null ? void 0 : loadingState.extra)) {
+      return /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-image-card__extra" }, loadingState.extra);
+    }
+    if ((disabled == null ? void 0 : disabled.value) && (disabled == null ? void 0 : disabled.extra)) {
+      return /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-image-card__extra" }, disabled.extra);
+    }
+    if ((active == null ? void 0 : active.value) && (active == null ? void 0 : active.extra)) {
+      return /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-image-card__extra" }, active.extra);
+    }
+    return null;
+  }, [active, disabled, loadingState]);
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      ref: imgRef,
+      className: mergedClassName,
+      style: mergedStyle,
+      onClick: handleClick,
+      "data-active": active == null ? void 0 : active.value,
+      "data-disabled": disabled == null ? void 0 : disabled.value,
+      "data-loading": (loadingState == null ? void 0 : loadingState.value) || imageLoading,
+      ...restProps
+    },
+    displaySource && /* @__PURE__ */ import_react.default.createElement(
+      "img",
+      {
+        src: import_utils2.image.ali(displaySource, aliWidth),
+        alt: alt || "",
+        className: "pisell-image-card__image",
+        style: {
+          objectFit: (0, import_utils.getImageObjectFit)(fillMode)
+        }
+      }
+    ),
+    showTextFallback && /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-image-card__text-fallback" }, truncatedText),
+    renderExtra(),
+    children
+  );
+};
+var Provider = (props) => /* @__PURE__ */ import_react.default.createElement(PisellImageCard, { ...props == null ? void 0 : props.props, ...props });
+var PisellImageCard_default = Provider;

package/lib/components/PisellCards/components/PisellImageCard/PisellImageCard.less

@@ -0,0 +1,94 @@
+@prefix: pisell-image-card;
+
+// 默认尺寸
+@default-width: 100%;
+@default-height: 100%;
+
+// 状态颜色
+@active-border-color: #1890ff;
+@disabled-opacity: 0.6;
+
+// 文字降级样式
+@text-fallback-bg: #f0f0f0;
+@text-fallback-color: #999;
+@text-fallback-font-size: 24px;
+
+.@{prefix} {
+  position: relative;
+  display: inline-block;
+  overflow: hidden;
+  box-sizing: border-box;
+
+  // 图片元素
+  &__image {
+    width: 100%;
+    height: 100%;
+    display: block;
+  }
+
+  // 文字降级展示
+  &__text-fallback {
+    width: 100%;
+    height: 100%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background-color: @text-fallback-bg;
+    color: @text-fallback-color;
+    font-size: @text-fallback-font-size;
+    font-weight: 500;
+    user-select: none;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  // 填充模式：cover
+  &--cover &__image {
+    object-fit: cover;
+  }
+
+  // 填充模式：contain
+  &--contain &__image {
+    object-fit: contain;
+  }
+
+  // 填充模式：fill
+  &--fill &__image {
+    object-fit: fill;
+  }
+
+  // 填充模式：none
+  &--none &__image {
+    object-fit: none;
+  }
+
+  // 激活状态
+  &--active {
+    border: 2px solid @active-border-color;
+  }
+
+  // 禁用状态
+  &--disabled {
+    opacity: @disabled-opacity;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  // 加载状态
+  &--loading {
+    cursor: wait;
+  }
+
+  // 状态 extra 内容
+  &__extra {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+}

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

@@ -0,0 +1,5 @@
+/**
+ * PisellImageCard Hooks 导出
+ */
+export { useImageLoad } from './useImageLoad';
+export { usePisellImageCardStyle } from './usePisellImageCardStyle';

package/lib/components/PisellCards/components/PisellImageCard/hooks/index.js

@@ -0,0 +1,32 @@
+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/PisellImageCard/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useImageLoad: () => import_useImageLoad.useImageLoad,
+  usePisellImageCardStyle: () => import_usePisellImageCardStyle.usePisellImageCardStyle
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useImageLoad = require("./useImageLoad");
+var import_usePisellImageCardStyle = require("./usePisellImageCardStyle");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useImageLoad,
+  usePisellImageCardStyle
+});

package/lib/components/PisellCards/components/PisellImageCard/hooks/useImageLoad.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+/**
+ * 图片加载状态管理 Hook
+ * @param src - 图片地址
+ * @param lazy - 是否启用懒加载
+ * @returns 加载状态对象
+ */
+export declare const useImageLoad: (src?: string, lazy?: boolean) => {
+    loading: boolean;
+    error: boolean;
+    imgRef: import("react").RefObject<HTMLImageElement>;
+};

package/lib/components/PisellCards/components/PisellImageCard/hooks/useImageLoad.js

@@ -0,0 +1,86 @@
+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/PisellImageCard/hooks/useImageLoad.ts
+var useImageLoad_exports = {};
+__export(useImageLoad_exports, {
+  useImageLoad: () => useImageLoad
+});
+module.exports = __toCommonJS(useImageLoad_exports);
+var import_react = require("react");
+var useImageLoad = (src, lazy) => {
+  const [loading, setLoading] = (0, import_react.useState)(!!src);
+  const [error, setError] = (0, import_react.useState)(false);
+  const imgRef = (0, import_react.useRef)(null);
+  const observerRef = (0, import_react.useRef)(null);
+  (0, import_react.useEffect)(() => {
+    if (!src) {
+      setLoading(false);
+      setError(false);
+      return;
+    }
+    setLoading(true);
+    setError(false);
+    if (lazy && "IntersectionObserver" in window && imgRef.current) {
+      observerRef.current = new IntersectionObserver(
+        (entries) => {
+          entries.forEach((entry) => {
+            var _a;
+            if (entry.isIntersecting) {
+              loadImage();
+              (_a = observerRef.current) == null ? void 0 : _a.disconnect();
+            }
+          });
+        },
+        {
+          rootMargin: "50px"
+          // 提前 50px 开始加载
+        }
+      );
+      observerRef.current.observe(imgRef.current);
+      return () => {
+        var _a;
+        (_a = observerRef.current) == null ? void 0 : _a.disconnect();
+      };
+    } else {
+      loadImage();
+    }
+  }, [src, lazy]);
+  const loadImage = () => {
+    if (!src) return;
+    const img = new Image();
+    img.src = src;
+    img.onload = () => {
+      setLoading(false);
+      setError(false);
+    };
+    img.onerror = () => {
+      setLoading(false);
+      setError(true);
+    };
+  };
+  return {
+    loading,
+    error,
+    imgRef
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useImageLoad
+});

package/lib/components/PisellCards/components/PisellImageCard/hooks/usePisellImageCardStyle.d.ts

@@ -0,0 +1,10 @@
+import { PisellImageCardProps } from '../types';
+/**
+ * 样式合并 Hook
+ * @param props - 组件 Props
+ * @returns 合并后的样式和类名
+ */
+export declare const usePisellImageCardStyle: (props: PisellImageCardProps) => {
+    mergedStyle: React.CSSProperties;
+    mergedClassName: string;
+};