@pisell/materials 6.7.3 → 6.8.1

package/es/components/PisellSteps/PisellSteps.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["type", "current", "defaultCurrent", "direction", "size", "status", "initial", "items", "percent", "labelPlacement", "responsive", "onChange", "className", "style", "progressDot", "clickable", "allowClickFinished", "showProgressPercent", "iconSize", "iconColor", "connectorStyle", "connectorPosition", "animated", "gridLayout", "gridColumns", "itemLayout", "itemGap", "enableAnchor", "anchorContainer", "__designMode", "__id", "other"];
+var _excluded = ["type", "current", "defaultCurrent", "direction", "size", "status", "initial", "items", "labelPlacement", "responsive", "onChange", "className", "style", "progressDot", "clickable", "allowClickFinished", "connectorStyle", "gridLayout", "gridColumns", "itemGap", "enableAnchor", "anchorContainer", "mobileMode", "mobileBreakpoint", "__designMode", "__id", "other"];
 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); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -45,7 +45,6 @@ var PisellSteps = function PisellSteps(_ref) {
     initial = _ref$initial === void 0 ? 0 : _ref$initial,
     _ref$items = _ref.items,
     items = _ref$items === void 0 ? [] : _ref$items,
-    percent = _ref.percent,
     _ref$labelPlacement = _ref.labelPlacement,
     labelPlacement = _ref$labelPlacement === void 0 ? 'horizontal' : _ref$labelPlacement,
     _ref$responsive = _ref.responsive,
@@ -58,24 +57,18 @@ var PisellSteps = function PisellSteps(_ref) {
     clickable = _ref$clickable === void 0 ? false : _ref$clickable,
     _ref$allowClickFinish = _ref.allowClickFinished,
     allowClickFinished = _ref$allowClickFinish === void 0 ? true : _ref$allowClickFinish,
-    _ref$showProgressPerc = _ref.showProgressPercent,
-    showProgressPercent = _ref$showProgressPerc === void 0 ? false : _ref$showProgressPerc,
-    iconSize = _ref.iconSize,
-    iconColor = _ref.iconColor,
     connectorStyle = _ref.connectorStyle,
-    _ref$connectorPositio = _ref.connectorPosition,
-    connectorPosition = _ref$connectorPositio === void 0 ? 'center' : _ref$connectorPositio,
-    _ref$animated = _ref.animated,
-    animated = _ref$animated === void 0 ? true : _ref$animated,
     _ref$gridLayout = _ref.gridLayout,
     gridLayout = _ref$gridLayout === void 0 ? false : _ref$gridLayout,
     gridColumns = _ref.gridColumns,
-    _ref$itemLayout = _ref.itemLayout,
-    itemLayout = _ref$itemLayout === void 0 ? 'horizontal' : _ref$itemLayout,
     itemGap = _ref.itemGap,
     _ref$enableAnchor = _ref.enableAnchor,
     enableAnchor = _ref$enableAnchor === void 0 ? false : _ref$enableAnchor,
     anchorContainer = _ref.anchorContainer,
+    _ref$mobileMode = _ref.mobileMode,
+    mobileMode = _ref$mobileMode === void 0 ? 'full' : _ref$mobileMode,
+    _ref$mobileBreakpoint = _ref.mobileBreakpoint,
+    mobileBreakpoint = _ref$mobileBreakpoint === void 0 ? 744 : _ref$mobileBreakpoint,
     __designMode = _ref.__designMode,
     __id = _ref.__id,
     other = _ref.other,
@@ -92,13 +85,40 @@ var PisellSteps = function PisellSteps(_ref) {
   // 锚链接功能
   useAnchor(currentStep, enableAnchor, anchorContainer);
 
-  // 响应式监听
-  var isMobile = useResponsive(768);
+  // 响应式监听（使用自定义断点）
+  var isMobile = useResponsive(mobileBreakpoint);
+
+  // 判断是否显示移动端当前步骤视图
+  var showMobileCurrentView = useMemo(function () {
+    if (mobileMode === 'current') return true;
+    if (mobileMode === 'auto' && isMobile) return true;
+    return false;
+  }, [mobileMode, isMobile]);
+
+  // 确保 items 始终是数组
+  var safeItems = useMemo(function () {
+    if (!items) return [];
+    if (!Array.isArray(items)) return [];
+    return items;
+  }, [items]);
+
+  // 获取当前步骤信息（用于移动端显示）
+  var currentStepItem = useMemo(function () {
+    var visibleItems = safeItems.filter(function (item) {
+      return !item.hidden;
+    });
+    var adjustedIndex = currentStep - initial;
+    // 确保索引在有效范围内
+    if (adjustedIndex < 0 || adjustedIndex >= visibleItems.length) {
+      return null;
+    }
+    return visibleItems[adjustedIndex] || null;
+  }, [safeItems, currentStep, initial]);
 
   // 处理步骤数据
   var processedItems = useMemo(function () {
     // 过滤隐藏的步骤
-    var visibleItems = items.filter(function (item) {
+    var visibleItems = safeItems.filter(function (item) {
       return !item.hidden;
     });
 
@@ -120,7 +140,10 @@ var PisellSteps = function PisellSteps(_ref) {
     }
 
     // 处理每个步骤项
-    return visibleItems.map(function (item, index) {
+    return visibleItems.filter(function (item) {
+      return item != null;
+    }) // 过滤掉 null 或 undefined 的项
+    .map(function (item, index) {
       var adjustedIndex = index + initial;
 
       // 计算步骤状态
@@ -154,67 +177,67 @@ var PisellSteps = function PisellSteps(_ref) {
         onClick: clickable || item.onClick ? handleClick : undefined
       });
     });
-  }, [items, currentStep, initial, status, clickable, handleStepClick, __designMode]);
+  }, [safeItems, currentStep, initial, status, clickable, handleStepClick, __designMode]);
 
   // 合并样式类名
   var wrapperClassName = useMemo(function () {
     var classes = ['pisell-steps'];
     if (className) classes.push(className);
-    if (type !== 'default') classes.push("pisell-steps-".concat(type));
+    // type 只支持 'default' 和 'navigation'，dot 模式通过 progressDot 控制
+    if (type === 'navigation') classes.push('pisell-steps-navigation');
+    // 如果设置了 progressDot，添加 dot 样式类
+    if (progressDot) classes.push('pisell-steps-dot');
     if (size !== 'default') classes.push("pisell-steps-".concat(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-".concat(connectorPosition));
-    if (itemLayout === 'vertical') classes.push('pisell-steps-item-vertical');
+    // 如果设置了 itemGap，添加标记类名
+    if (itemGap !== undefined && itemGap !== null) {
+      classes.push('pisell-steps-has-item-gap');
+    }
+    // labelPlacement 通过 antd Steps 的 labelPlacement 属性控制，不需要额外的类名
+
     return classes.join(' ');
-  }, [className, type, size, direction, responsive, animated, clickable, gridLayout, connectorPosition, itemLayout]);
+  }, [className, type, progressDot, size, direction, responsive, clickable, gridLayout, itemGap]);
 
   // 合并自定义样式
   var wrapperStyle = useMemo(function () {
     var customStyle = _objectSpread({}, style);
-    if (iconSize) {
-      customStyle['--pisell-steps-icon-size'] = "".concat(iconSize, "px");
-    }
-    if (iconColor) {
-      customStyle['--pisell-steps-icon-color'] = iconColor;
-    }
-    if (itemGap) {
+
+    // itemGap 用于控制图标和文本之间的间距
+    // 只有当 itemGap 有值时才设置 CSS 变量，否则保持 antd 原样式
+    if (itemGap !== undefined && itemGap !== null) {
       customStyle['--pisell-steps-item-gap'] = "".concat(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]);
-
-  // 处理进度百分比显示
-  var effectivePercent = showProgressPercent ? percent : undefined;
-
-  // 根据 type 设置 Ant Design 的展示类型
-  var antdType = type === 'dot' ? 'inline' : type === 'navigation' ? 'navigation' : 'default';
+  }, [style, itemGap, gridColumns, gridLayout]);
   return /*#__PURE__*/React.createElement("div", {
-    className: wrapperClassName,
-    style: wrapperStyle,
+    className: showMobileCurrentView ? "pisell-steps pisell-steps-mobile-current ".concat(className || '') : wrapperClassName,
+    style: showMobileCurrentView ? style : wrapperStyle,
     "data-component": "pisell-steps",
     "data-id": __id
-  }, /*#__PURE__*/React.createElement(AntdSteps, _extends({
-    current: currentStep - initial,
+  }, showMobileCurrentView ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-steps-mobile-current__info"
+  }, (currentStepItem === null || currentStepItem === void 0 ? void 0 : currentStepItem.title) && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-steps-mobile-current__number"
+  }, currentStepItem.title), (currentStepItem === null || currentStepItem === void 0 ? void 0 : currentStepItem.description) && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-steps-mobile-current__title"
+  }, currentStepItem.description)) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(AntdSteps, _extends({
+    current: Math.max(0, currentStep - initial),
     direction: direction,
     size: size === 'large' ? 'default' : size,
     status: status,
     items: processedItems,
-    percent: effectivePercent,
     labelPlacement: labelPlacement,
-    type: antdType,
-    progressDot: type === 'dot' ? progressDot : false
-  }, restProps, other)), showProgressPercent && percent !== undefined && /*#__PURE__*/React.createElement("div", {
-    className: "pisell-steps-progress-info"
-  }, /*#__PURE__*/React.createElement("span", {
-    className: "pisell-steps-progress-percent"
-  }, percent, "%")));
+    type: type,
+    progressDot: progressDot
+  }, restProps, other || {}))));
 };
 
 // 添加 displayName 用于调试

package/es/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/es/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/es/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/es/components/PisellSteps/hooks/useAnchor.js

@@ -11,6 +11,11 @@ import { useEffect, useRef } from 'react';
 export function useAnchor(currentStep, enableAnchor, anchorContainer) {
   var previousStepRef = useRef(currentStep);
   useEffect(function () {
+    // SSR 环境下不执行
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+      return;
+    }
+
     // 未启用锚链接，直接返回
     if (!enableAnchor) {
       return;

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

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

package/es/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/es/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/es/components/PisellSteps/hooks/useStepsState.js

@@ -17,20 +17,26 @@ import { useState, useCallback, useEffect, useRef } from 'react';
 export function useStepsState(current) {
   var defaultCurrent = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
   var onChange = arguments.length > 2 ? arguments[2] : undefined;
+  // 确保 defaultCurrent 是有效的数字
+  var safeDefaultCurrent = typeof defaultCurrent === 'number' && !isNaN(defaultCurrent) && defaultCurrent >= 0 ? defaultCurrent : 0;
+
+  // 确保 current 是有效的数字（如果提供）
+  var safeCurrent = current !== undefined && typeof current === 'number' && !isNaN(current) && current >= 0 ? current : undefined;
+
   // 内部状态（非受控模式使用）
-  var _useState = useState(defaultCurrent),
+  var _useState = useState(safeDefaultCurrent),
     _useState2 = _slicedToArray(_useState, 2),
     innerCurrent = _useState2[0],
     setInnerCurrent = _useState2[1];
 
   // 记录上一次的步骤，用于判断变更方向
-  var previousCurrentRef = useRef(defaultCurrent);
+  var previousCurrentRef = useRef(safeDefaultCurrent);
 
   // 判断是否为受控模式
-  var isControlled = current !== undefined;
+  var isControlled = safeCurrent !== undefined;
 
   // 当前步骤值
-  var currentStep = isControlled ? current : innerCurrent;
+  var currentStep = isControlled ? safeCurrent : innerCurrent;
 
   // 设置步骤的函数
   var setCurrentStep = useCallback(function (value) {
@@ -52,9 +58,9 @@ export function useStepsState(current) {
 
   // 受控模式下，同步更新 previousCurrentRef
   useEffect(function () {
-    if (isControlled && current !== undefined) {
-      previousCurrentRef.current = current;
+    if (isControlled && safeCurrent !== undefined) {
+      previousCurrentRef.current = safeCurrent;
     }
-  }, [current, isControlled]);
+  }, [safeCurrent, isControlled]);
   return [currentStep, setCurrentStep];
 }

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