@pisell/materials 6.7.3 → 6.8.1

package/lib/components/PisellSteps/PisellSteps.js

@@ -47,7 +47,6 @@ var PisellSteps = ({
   status = "process",
   initial = 0,
   items = [],
-  percent,
   labelPlacement = "horizontal",
   responsive = true,
   onChange,
@@ -57,18 +56,14 @@ var PisellSteps = ({
   // 扩展功能属性
   clickable = false,
   allowClickFinished = true,
-  showProgressPercent = false,
-  iconSize,
-  iconColor,
   connectorStyle,
-  connectorPosition = "center",
-  animated = true,
   gridLayout = false,
   gridColumns,
-  itemLayout = "horizontal",
   itemGap,
   enableAnchor = false,
   anchorContainer,
+  mobileMode = "full",
+  mobileBreakpoint = 744,
   // 低代码属性
   __designMode,
   __id,
@@ -87,9 +82,27 @@ var PisellSteps = ({
     setCurrentStep
   );
   (0, import_hooks.useAnchor)(currentStep, enableAnchor, anchorContainer);
-  const isMobile = (0, import_hooks.useResponsive)(768);
+  const isMobile = (0, import_hooks.useResponsive)(mobileBreakpoint);
+  const showMobileCurrentView = (0, import_react.useMemo)(() => {
+    if (mobileMode === "current") return true;
+    if (mobileMode === "auto" && isMobile) return true;
+    return false;
+  }, [mobileMode, isMobile]);
+  const safeItems = (0, import_react.useMemo)(() => {
+    if (!items) return [];
+    if (!Array.isArray(items)) return [];
+    return items;
+  }, [items]);
+  const currentStepItem = (0, import_react.useMemo)(() => {
+    const visibleItems = safeItems.filter((item) => !item.hidden);
+    const adjustedIndex = currentStep - initial;
+    if (adjustedIndex < 0 || adjustedIndex >= visibleItems.length) {
+      return null;
+    }
+    return visibleItems[adjustedIndex] || null;
+  }, [safeItems, currentStep, initial]);
   const processedItems = (0, import_react.useMemo)(() => {
-    const visibleItems = items.filter((item) => !item.hidden);
+    const visibleItems = safeItems.filter((item) => !item.hidden);
     if (__designMode === "design" && visibleItems.length === 0) {
       return [
         {
@@ -109,7 +122,7 @@ var PisellSteps = ({
         }
       ];
     }
-    return visibleItems.map((item, index) => {
+    return visibleItems.filter((item) => item != null).map((item, index) => {
       const adjustedIndex = index + initial;
       let stepStatus;
       if (item.status) {
@@ -139,7 +152,7 @@ var PisellSteps = ({
       };
     });
   }, [
-    items,
+    safeItems,
     currentStep,
     initial,
     status,
@@ -150,72 +163,62 @@ var PisellSteps = ({
   const wrapperClassName = (0, import_react.useMemo)(() => {
     const classes = ["pisell-steps"];
     if (className) classes.push(className);
-    if (type !== "default") classes.push(`pisell-steps-${type}`);
+    if (type === "navigation") classes.push("pisell-steps-navigation");
+    if (progressDot) classes.push("pisell-steps-dot");
     if (size !== "default") classes.push(`pisell-steps-${size}`);
     if (direction === "vertical") classes.push("pisell-steps-vertical");
     if (responsive) classes.push("pisell-steps-responsive");
-    if (animated) classes.push("pisell-steps-animated");
     if (clickable) classes.push("pisell-steps-clickable");
     if (gridLayout) classes.push("pisell-steps-grid-layout");
-    if (connectorPosition !== "center")
-      classes.push(`pisell-steps-connector-${connectorPosition}`);
-    if (itemLayout === "vertical") classes.push("pisell-steps-item-vertical");
+    if (itemGap !== void 0 && itemGap !== null) {
+      classes.push("pisell-steps-has-item-gap");
+    }
     return classes.join(" ");
   }, [
     className,
     type,
+    progressDot,
     size,
     direction,
     responsive,
-    animated,
     clickable,
     gridLayout,
-    connectorPosition,
-    itemLayout
+    itemGap
   ]);
   const wrapperStyle = (0, import_react.useMemo)(() => {
     const customStyle = { ...style };
-    if (iconSize) {
-      customStyle["--pisell-steps-icon-size"] = `${iconSize}px`;
-    }
-    if (iconColor) {
-      customStyle["--pisell-steps-icon-color"] = iconColor;
-    }
-    if (itemGap) {
+    if (itemGap !== void 0 && itemGap !== null) {
       customStyle["--pisell-steps-item-gap"] = `${itemGap}px`;
+      customStyle["--pisell-steps-has-item-gap"] = "1";
     }
     if (gridColumns && gridLayout) {
       customStyle["--pisell-steps-grid-columns"] = gridColumns;
     }
     return customStyle;
-  }, [style, iconSize, iconColor, itemGap, gridColumns, gridLayout]);
-  const effectivePercent = showProgressPercent ? percent : void 0;
-  const antdType = type === "dot" ? "inline" : type === "navigation" ? "navigation" : "default";
+  }, [style, itemGap, gridColumns, gridLayout]);
   return /* @__PURE__ */ import_react.default.createElement(
     "div",
     {
-      className: wrapperClassName,
-      style: wrapperStyle,
+      className: showMobileCurrentView ? `pisell-steps pisell-steps-mobile-current ${className || ""}` : wrapperClassName,
+      style: showMobileCurrentView ? style : wrapperStyle,
       "data-component": "pisell-steps",
       "data-id": __id
     },
-    /* @__PURE__ */ import_react.default.createElement(
+    showMobileCurrentView ? /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-steps-mobile-current__info" }, (currentStepItem == null ? void 0 : currentStepItem.title) && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-steps-mobile-current__number" }, currentStepItem.title), (currentStepItem == null ? void 0 : currentStepItem.description) && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-steps-mobile-current__title" }, currentStepItem.description)) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, /* @__PURE__ */ import_react.default.createElement(
       import_antd.Steps,
       {
-        current: currentStep - initial,
+        current: Math.max(0, currentStep - initial),
         direction,
         size: size === "large" ? "default" : size,
         status,
         items: processedItems,
-        percent: effectivePercent,
         labelPlacement,
-        type: antdType,
-        progressDot: type === "dot" ? progressDot : false,
+        type,
+        progressDot,
         ...restProps,
-        ...other
+        ...other || {}
       }
-    ),
-    showProgressPercent && percent !== void 0 && /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-steps-progress-info" }, /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-steps-progress-percent" }, percent, "%"))
+    ))
   );
 };
 PisellSteps.displayName = "PisellSteps";

package/lib/components/PisellSteps/PisellSteps.less

@@ -5,17 +5,13 @@
 
 // ============ CSS 变量定义 ============
 .@{pisell-steps-prefix} {
-  // 图标相关
-  --pisell-steps-icon-size: 32px;
-  --pisell-steps-icon-color: inherit;
-  
   // 间距相关
   --pisell-steps-item-gap: 8px;
   --pisell-steps-margin: 16px;
-  
+
   // 栅格布局
   --pisell-steps-grid-columns: 3;
-  
+
   // 颜色变量
   --pisell-steps-primary-color: #7f56d9;
   --pisell-steps-primary-light: #f4ebff;
@@ -31,17 +27,24 @@
   position: relative;
   width: 100%;
 
+  // 默认尺寸（32px）- 当没有设置 size 或 size='default' 时
+  .ant-steps-item-icon {
+    width: 32px;
+    height: 32px;
+    line-height: 32px;
+  }
+
   // 覆盖 Ant Design 默认样式，使用自定义主题色
   .ant-steps-item-finish {
     .ant-steps-item-icon {
       background-color: var(--pisell-steps-primary-light);
-      border-color: var(--pisell-steps-primary-color);
-      
+      border-color: var(--pisell-steps-primary-light);
+
       > .ant-steps-icon {
         color: var(--pisell-steps-primary-color);
       }
     }
-    
+
     .ant-steps-item-tail::after {
       background-color: var(--pisell-steps-primary-color);
     }
@@ -51,7 +54,7 @@
     .ant-steps-item-icon {
       background-color: var(--pisell-steps-primary-color);
       border-color: var(--pisell-steps-primary-color);
-      
+
       > .ant-steps-icon {
         color: #ffffff;
       }
@@ -62,7 +65,7 @@
     .ant-steps-item-icon {
       background-color: var(--pisell-steps-border-color);
       border-color: var(--pisell-steps-border-color);
-      
+
       > .ant-steps-icon {
         color: var(--pisell-steps-text-secondary);
       }
@@ -73,7 +76,7 @@
     .ant-steps-item-icon {
       background-color: var(--pisell-steps-error-color);
       border-color: var(--pisell-steps-error-color);
-      
+
       > .ant-steps-icon {
         color: #ffffff;
       }
@@ -83,7 +86,8 @@
 
 // ============ 可点击样式 ============
 .@{pisell-steps-prefix}-clickable {
-  .ant-steps-item {
+  .ant-steps-item,
+  .pisell-lowcode-steps-item {
     cursor: pointer;
     transition: all 0.3s ease;
 
@@ -111,29 +115,32 @@
     line-height: 24px;
     font-size: 12px;
   }
-  
+
   .ant-steps-item-title {
     font-size: 14px;
   }
-  
+
   .ant-steps-item-description {
-    font-size: 12px;
+    font-size: 14px;
   }
 }
 
 .@{pisell-steps-prefix}-large {
-  .ant-steps-item-icon {
-    width: 40px;
-    height: 40px;
-    line-height: 40px;
-    font-size: 18px;
+  .ant-steps-item-icon,
+  .pisell-lowcode-steps-item-icon {
+    width: 40px !important;
+    height: 40px !important;
+    line-height: 40px !important;
+    font-size: 16px !important;
   }
-  
-  .ant-steps-item-title {
-    font-size: 18px;
+
+  .ant-steps-item-title,
+  .pisell-lowcode-steps-item-title {
+    font-size: 16px;
   }
-  
-  .ant-steps-item-description {
+
+  .ant-steps-item-description,
+  .pisell-lowcode-steps-item-description {
     font-size: 16px;
   }
 }
@@ -144,7 +151,7 @@
   .ant-steps-item-icon {
     width: 8px;
     height: 8px;
-    
+
     .ant-steps-icon-dot {
       width: 8px;
       height: 8px;
@@ -156,7 +163,7 @@
 .@{pisell-steps-prefix}-navigation {
   .ant-steps-item {
     padding: 12px 24px;
-    
+
     &::before {
       content: '';
       position: absolute;
@@ -177,29 +184,29 @@
   @media (max-width: 768px) {
     overflow-x: auto;
     -webkit-overflow-scrolling: touch;
-    
+
     .ant-steps {
       min-width: max-content;
     }
-    
+
     .ant-steps-item {
       min-width: 120px;
       flex-shrink: 0;
     }
   }
-  
+
   @media (max-width: 480px) {
     .ant-steps-item {
       min-width: 100px;
-      
+
       .ant-steps-item-title {
         font-size: 12px;
       }
-      
+
       .ant-steps-item-description {
         display: none;
       }
-      
+
       .ant-steps-item-icon {
         width: 24px;
         height: 24px;
@@ -219,100 +226,63 @@
   }
 }
 
-// ============ 连接器位置 ============
-.@{pisell-steps-prefix}-connector-top {
-  .ant-steps-item-tail {
-    top: 8px;
-  }
-}
+// 连接器位置样式已移除
 
-.@{pisell-steps-prefix}-connector-bottom {
-  .ant-steps-item-tail {
-    top: auto;
-    bottom: 8px;
+// ============ 标识区和文本区间距 =============
+// 控制图标和文本之间的间距
+// 只有当设置了 itemGap 时才应用自定义间距，否则保持 antd 原样式
+.@{pisell-steps-prefix}-has-item-gap {
+  // 垂直布局时（labelPlacement='vertical'），控制内容区域的上边距
+  .ant-steps-label-vertical {
+    .ant-steps-item-content {
+      margin-top: var(--pisell-steps-item-gap);
+    }
   }
-}
 
-// ============ 项布局 ============
-.@{pisell-steps-prefix}-item-vertical {
+  // 水平布局时（labelPlacement='horizontal'），控制图标右侧的间距
   .ant-steps-item {
-    flex-direction: column;
-    
     .ant-steps-item-icon {
-      margin-bottom: var(--pisell-steps-item-gap);
+      margin-right: var(--pisell-steps-item-gap);
     }
   }
-}
 
-// ============ 动画效果 ============
-.@{pisell-steps-prefix}-animated {
-  .ant-steps-item {
-    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
-  }
-  
-  .ant-steps-item-icon {
-    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  // 低代码平台中的样式支持 - 水平布局
+  .pisell-lowcode-steps-item-icon {
+    margin-right: var(--pisell-steps-item-gap);
   }
-  
-  .ant-steps-item-tail::after {
-    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+
+  // 低代码平台垂直布局 - 设置内容区域的上边距
+  &.pisell-lowcode-steps-label-vertical,
+  .pisell-lowcode-steps-label-vertical {
+    .pisell-lowcode-steps-item-content {
+      margin-top: var(--pisell-steps-item-gap);
+    }
   }
 }
 
+// 动画效果样式已移除
+
 // ============ 进度百分比显示 ============
-.@{pisell-steps-prefix}-progress-info {
-  position: absolute;
-  top: 50%;
-  left: 50%;
-  transform: translate(-50%, -50%);
-  pointer-events: none;
-  
-  .@{pisell-steps-prefix}-progress-percent {
-    display: inline-block;
-    padding: 2px 8px;
-    background-color: var(--pisell-steps-primary-color);
-    color: #ffffff;
-    font-size: 12px;
-    border-radius: 10px;
-    font-weight: 500;
-  }
-}
+// 进度百分比样式已移除，直接使用 antd Steps 的默认进度条样式
 
 // ============ 竖向布局特殊样式 ============
 .@{pisell-steps-prefix}-vertical {
   .ant-steps-item {
     padding-bottom: var(--pisell-steps-margin);
-    
+
     &:last-child {
       padding-bottom: 0;
     }
   }
-  
-  .@{pisell-steps-prefix}-progress-info {
-    left: 16px;
-    transform: translateY(-50%);
-  }
 }
 
 // ============ 自定义图标尺寸 ============
-.@{pisell-steps-prefix} {
-  .ant-steps-item-icon {
-    width: var(--pisell-steps-icon-size);
-    height: var(--pisell-steps-icon-size);
-    line-height: var(--pisell-steps-icon-size);
-    
-    .ant-steps-icon {
-      color: var(--pisell-steps-icon-color);
-    }
-  }
-}
-
 // ============ 禁用状态 ============
 .@{pisell-steps-prefix} {
   .ant-steps-item-disabled {
     cursor: not-allowed;
     opacity: 0.5;
-    
+
     &:hover {
       .ant-steps-item-icon {
         transform: none;
@@ -320,3 +290,31 @@
     }
   }
 }
+
+// ============ 移动端当前步骤视图 ============
+.@{pisell-steps-prefix}-mobile-current {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+
+  &__info {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: center;
+    overflow: hidden;
+  }
+
+  &__number {
+    font-size: 14px;
+    color: black;
+    line-height: 20px;
+  }
+
+  &__title {
+    color: black;
+    font-size: 20px;
+    font-weight: 600;
+    line-height: 28px;
+  }
+}

package/lib/components/PisellSteps/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useStepsState } from './useStepsState';
+export { useStepClick } from './useStepClick';
+export { useAnchor } from './useAnchor';
+export { useResponsive } from './useResponsive';

package/lib/components/PisellSteps/hooks/useAnchor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 锚链接功能 Hook
+ * 当开启锚链接时，自动滚动到当前步骤对应的锚点
+ *
+ * @param currentStep - 当前步骤索引
+ * @param enableAnchor - 是否启用锚链接
+ * @param anchorContainer - 锚链接容器选择器或元素
+ */
+export declare function useAnchor(currentStep: number, enableAnchor: boolean, anchorContainer?: string | HTMLElement): void;

package/lib/components/PisellSteps/hooks/useAnchor.js

@@ -26,6 +26,9 @@ var import_react = require("react");
 function useAnchor(currentStep, enableAnchor, anchorContainer) {
   const previousStepRef = (0, import_react.useRef)(currentStep);
   (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      return;
+    }
     if (!enableAnchor) {
       return;
     }

package/lib/components/PisellSteps/hooks/useResponsive.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 响应式监听 Hook
+ * 监听窗口大小变化，返回当前是否为移动端
+ *
+ * @param breakpoint - 断点宽度（默认 768px）
+ * @returns 是否为移动端
+ */
+export declare function useResponsive(breakpoint?: number): boolean;

package/lib/components/PisellSteps/hooks/useStepClick.d.ts

@@ -0,0 +1,11 @@
+import type { PisellStepItem } from '../types';
+/**
+ * 处理步骤点击逻辑的 Hook
+ *
+ * @param currentStep - 当前步骤索引
+ * @param clickable - 是否允许点击步骤切换
+ * @param allowClickFinished - 是否允许点击已完成的步骤
+ * @param onStepChange - 步骤变更回调函数
+ * @returns 步骤点击处理函数
+ */
+export declare function useStepClick(currentStep: number, clickable: boolean, allowClickFinished: boolean, onStepChange: (step: number) => void): (index: number, item: PisellStepItem) => void;

package/lib/components/PisellSteps/hooks/useStepsState.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 管理步骤条状态的 Hook（支持受控和非受控模式）
+ *
+ * @param current - 受控模式下的当前步骤
+ * @param defaultCurrent - 非受控模式下的默认当前步骤
+ * @param onChange - 步骤变更回调函数
+ * @returns [currentStep, setCurrentStep] - 当前步骤和设置步骤的函数
+ */
+export declare function useStepsState(current?: number, defaultCurrent?: number, onChange?: (current: number) => void): [number, (value: number) => void];

package/lib/components/PisellSteps/hooks/useStepsState.js

@@ -24,10 +24,12 @@ __export(useStepsState_exports, {
 module.exports = __toCommonJS(useStepsState_exports);
 var import_react = require("react");
 function useStepsState(current, defaultCurrent = 0, onChange) {
-  const [innerCurrent, setInnerCurrent] = (0, import_react.useState)(defaultCurrent);
-  const previousCurrentRef = (0, import_react.useRef)(defaultCurrent);
-  const isControlled = current !== void 0;
-  const currentStep = isControlled ? current : innerCurrent;
+  const safeDefaultCurrent = typeof defaultCurrent === "number" && !isNaN(defaultCurrent) && defaultCurrent >= 0 ? defaultCurrent : 0;
+  const safeCurrent = current !== void 0 && typeof current === "number" && !isNaN(current) && current >= 0 ? current : void 0;
+  const [innerCurrent, setInnerCurrent] = (0, import_react.useState)(safeDefaultCurrent);
+  const previousCurrentRef = (0, import_react.useRef)(safeDefaultCurrent);
+  const isControlled = safeCurrent !== void 0;
+  const currentStep = isControlled ? safeCurrent : innerCurrent;
   const setCurrentStep = (0, import_react.useCallback)(
     (value) => {
       const previousCurrent = previousCurrentRef.current;
@@ -42,10 +44,10 @@ function useStepsState(current, defaultCurrent = 0, onChange) {
     [isControlled, onChange]
   );
   (0, import_react.useEffect)(() => {
-    if (isControlled && current !== void 0) {
-      previousCurrentRef.current = current;
+    if (isControlled && safeCurrent !== void 0) {
+      previousCurrentRef.current = safeCurrent;
     }
-  }, [current, isControlled]);
+  }, [safeCurrent, isControlled]);
   return [currentStep, setCurrentStep];
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -0,0 +1,3 @@
+import PisellSteps from './PisellSteps';
+export type { PisellStepsProps, PisellStepItem, StepStatus, StepDirection, StepSize } from './types';
+export default PisellSteps;