@pisell/materials 6.7.1 → 6.7.3

package/es/components/PisellSteps/PisellSteps.js

@@ -0,0 +1,222 @@
+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"];
+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; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { Steps as AntdSteps } from 'antd';
+import React, { useMemo } from 'react';
+import "./PisellSteps.less";
+import { useStepsState, useStepClick, useAnchor, useResponsive } from "./hooks";
+import { getStepStatus, mergeStepClassName } from "./utils";
+
+/**
+ * PisellSteps 步骤条组件
+ *
+ * 基于 Ant Design Steps 组件进行二次封装和增强
+ * 支持多种展示样式、布局方式和丰富的交互功能
+ *
+ * @author Pisell Team
+ * @version 1.0.0
+ */
+var PisellSteps = function PisellSteps(_ref) {
+  var _ref$type = _ref.type,
+    type = _ref$type === void 0 ? 'default' : _ref$type,
+    controlledCurrent = _ref.current,
+    _ref$defaultCurrent = _ref.defaultCurrent,
+    defaultCurrent = _ref$defaultCurrent === void 0 ? 0 : _ref$defaultCurrent,
+    _ref$direction = _ref.direction,
+    direction = _ref$direction === void 0 ? 'horizontal' : _ref$direction,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? 'default' : _ref$size,
+    _ref$status = _ref.status,
+    status = _ref$status === void 0 ? 'process' : _ref$status,
+    _ref$initial = _ref.initial,
+    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,
+    responsive = _ref$responsive === void 0 ? true : _ref$responsive,
+    onChange = _ref.onChange,
+    className = _ref.className,
+    style = _ref.style,
+    progressDot = _ref.progressDot,
+    _ref$clickable = _ref.clickable,
+    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,
+    __designMode = _ref.__designMode,
+    __id = _ref.__id,
+    other = _ref.other,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  // 状态管理：支持受控和非受控模式
+  var _useStepsState = useStepsState(controlledCurrent, defaultCurrent, onChange),
+    _useStepsState2 = _slicedToArray(_useStepsState, 2),
+    currentStep = _useStepsState2[0],
+    setCurrentStep = _useStepsState2[1];
+
+  // 处理步骤点击逻辑
+  var handleStepClick = useStepClick(currentStep, clickable, allowClickFinished, setCurrentStep);
+
+  // 锚链接功能
+  useAnchor(currentStep, enableAnchor, anchorContainer);
+
+  // 响应式监听
+  var isMobile = useResponsive(768);
+
+  // 处理步骤数据
+  var processedItems = useMemo(function () {
+    // 过滤隐藏的步骤
+    var visibleItems = items.filter(function (item) {
+      return !item.hidden;
+    });
+
+    // 设计模式下提供默认数据
+    if (__designMode === 'design' && visibleItems.length === 0) {
+      return [{
+        title: '步骤一',
+        description: 'This is a description.',
+        status: 'finish'
+      }, {
+        title: '步骤二',
+        description: 'This is a description.',
+        status: 'process'
+      }, {
+        title: '步骤三',
+        description: 'This is a description.',
+        status: 'wait'
+      }];
+    }
+
+    // 处理每个步骤项
+    return visibleItems.map(function (item, index) {
+      var adjustedIndex = index + initial;
+
+      // 计算步骤状态
+      // 优先级：item.status > 当前步骤使用全局status > 根据索引自动计算
+      var stepStatus;
+      if (item.status) {
+        // 如果步骤项自己有状态，优先使用
+        stepStatus = item.status;
+      } else if (adjustedIndex === currentStep) {
+        // 如果是当前步骤，使用全局的 status
+        stepStatus = status;
+      } else {
+        // 其他步骤根据索引自动计算
+        stepStatus = getStepStatus(adjustedIndex, currentStep);
+      }
+
+      // 合并类名
+      var stepClassName = mergeStepClassName('pisell-steps-item', stepStatus, item.className);
+
+      // 处理点击事件
+      var handleClick = function handleClick() {
+        if (!item.disabled) {
+          var _item$onClick;
+          (_item$onClick = item.onClick) === null || _item$onClick === void 0 || _item$onClick.call(item);
+          handleStepClick(adjustedIndex, item);
+        }
+      };
+      return _objectSpread(_objectSpread({}, item), {}, {
+        status: stepStatus,
+        className: stepClassName,
+        onClick: clickable || item.onClick ? handleClick : undefined
+      });
+    });
+  }, [items, 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));
+    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');
+    return classes.join(' ');
+  }, [className, type, size, direction, responsive, animated, clickable, gridLayout, connectorPosition, itemLayout]);
+
+  // 合并自定义样式
+  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) {
+      customStyle['--pisell-steps-item-gap'] = "".concat(itemGap, "px");
+    }
+    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';
+  return /*#__PURE__*/React.createElement("div", {
+    className: wrapperClassName,
+    style: wrapperStyle,
+    "data-component": "pisell-steps",
+    "data-id": __id
+  }, /*#__PURE__*/React.createElement(AntdSteps, _extends({
+    current: 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, "%")));
+};
+
+// 添加 displayName 用于调试
+PisellSteps.displayName = 'PisellSteps';
+export default PisellSteps;

package/es/components/PisellSteps/PisellSteps.less

@@ -0,0 +1,322 @@
+// PisellSteps 组件样式
+// 基于 Ant Design Steps 进行样式扩展和定制
+
+@pisell-steps-prefix: pisell-steps;
+
+// ============ 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;
+  --pisell-steps-text-color: rgba(0, 0, 0, 0.88);
+  --pisell-steps-text-secondary: rgba(0, 0, 0, 0.45);
+  --pisell-steps-border-color: rgba(0, 0, 0, 0.06);
+  --pisell-steps-error-color: #ff4d4f;
+  --pisell-steps-success-color: #52c41a;
+}
+
+// ============ 基础样式 ============
+.@{pisell-steps-prefix} {
+  position: relative;
+  width: 100%;
+
+  // 覆盖 Ant Design 默认样式，使用自定义主题色
+  .ant-steps-item-finish {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-primary-light);
+      border-color: var(--pisell-steps-primary-color);
+      
+      > .ant-steps-icon {
+        color: var(--pisell-steps-primary-color);
+      }
+    }
+    
+    .ant-steps-item-tail::after {
+      background-color: var(--pisell-steps-primary-color);
+    }
+  }
+
+  .ant-steps-item-process {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-primary-color);
+      border-color: var(--pisell-steps-primary-color);
+      
+      > .ant-steps-icon {
+        color: #ffffff;
+      }
+    }
+  }
+
+  .ant-steps-item-wait {
+    .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);
+      }
+    }
+  }
+
+  .ant-steps-item-error {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-error-color);
+      border-color: var(--pisell-steps-error-color);
+      
+      > .ant-steps-icon {
+        color: #ffffff;
+      }
+    }
+  }
+}
+
+// ============ 可点击样式 ============
+.@{pisell-steps-prefix}-clickable {
+  .ant-steps-item {
+    cursor: pointer;
+    transition: all 0.3s ease;
+
+    &:hover {
+      .ant-steps-item-icon {
+        transform: scale(1.1);
+      }
+    }
+
+    &-finish {
+      &:hover {
+        .ant-steps-item-title {
+          color: var(--pisell-steps-primary-color);
+        }
+      }
+    }
+  }
+}
+
+// ============ 尺寸变体 ============
+.@{pisell-steps-prefix}-small {
+  .ant-steps-item-icon {
+    width: 24px;
+    height: 24px;
+    line-height: 24px;
+    font-size: 12px;
+  }
+  
+  .ant-steps-item-title {
+    font-size: 14px;
+  }
+  
+  .ant-steps-item-description {
+    font-size: 12px;
+  }
+}
+
+.@{pisell-steps-prefix}-large {
+  .ant-steps-item-icon {
+    width: 40px;
+    height: 40px;
+    line-height: 40px;
+    font-size: 18px;
+  }
+  
+  .ant-steps-item-title {
+    font-size: 18px;
+  }
+  
+  .ant-steps-item-description {
+    font-size: 16px;
+  }
+}
+
+// ============ 类型变体 ============
+// Dot 类型
+.@{pisell-steps-prefix}-dot {
+  .ant-steps-item-icon {
+    width: 8px;
+    height: 8px;
+    
+    .ant-steps-icon-dot {
+      width: 8px;
+      height: 8px;
+    }
+  }
+}
+
+// Navigation 类型
+.@{pisell-steps-prefix}-navigation {
+  .ant-steps-item {
+    padding: 12px 24px;
+    
+    &::before {
+      content: '';
+      position: absolute;
+      top: 0;
+      right: -12px;
+      width: 0;
+      height: 0;
+      border-top: 24px solid transparent;
+      border-bottom: 24px solid transparent;
+      border-left: 12px solid var(--pisell-steps-border-color);
+      z-index: 1;
+    }
+  }
+}
+
+// ============ 响应式样式 ============
+.@{pisell-steps-prefix}-responsive {
+  @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;
+        line-height: 24px;
+        font-size: 12px;
+      }
+    }
+  }
+}
+
+// ============ 栅格布局 ============
+.@{pisell-steps-prefix}-grid-layout {
+  .ant-steps {
+    display: grid;
+    grid-template-columns: repeat(var(--pisell-steps-grid-columns), 1fr);
+    gap: var(--pisell-steps-margin);
+  }
+}
+
+// ============ 连接器位置 ============
+.@{pisell-steps-prefix}-connector-top {
+  .ant-steps-item-tail {
+    top: 8px;
+  }
+}
+
+.@{pisell-steps-prefix}-connector-bottom {
+  .ant-steps-item-tail {
+    top: auto;
+    bottom: 8px;
+  }
+}
+
+// ============ 项布局 ============
+.@{pisell-steps-prefix}-item-vertical {
+  .ant-steps-item {
+    flex-direction: column;
+    
+    .ant-steps-item-icon {
+      margin-bottom: 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);
+  }
+  
+  .ant-steps-item-tail::after {
+    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+}
+
+// ============ 进度百分比显示 ============
+.@{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;
+  }
+}
+
+// ============ 竖向布局特殊样式 ============
+.@{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;
+      }
+    }
+  }
+}

package/es/components/PisellSteps/hooks/index.js

@@ -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.js

@@ -0,0 +1,55 @@
+import { useEffect, useRef } from 'react';
+
+/**
+ * 锚链接功能 Hook
+ * 当开启锚链接时，自动滚动到当前步骤对应的锚点
+ * 
+ * @param currentStep - 当前步骤索引
+ * @param enableAnchor - 是否启用锚链接
+ * @param anchorContainer - 锚链接容器选择器或元素
+ */
+export function useAnchor(currentStep, enableAnchor, anchorContainer) {
+  var previousStepRef = useRef(currentStep);
+  useEffect(function () {
+    // 未启用锚链接，直接返回
+    if (!enableAnchor) {
+      return;
+    }
+
+    // 步骤未发生变化，直接返回
+    if (previousStepRef.current === currentStep) {
+      return;
+    }
+
+    // 更新上一步记录
+    previousStepRef.current = currentStep;
+
+    // 查找锚点元素
+    var anchorId = "pisell-steps-anchor-".concat(currentStep);
+    var anchorElement = document.getElementById(anchorId);
+    if (!anchorElement) {
+      return;
+    }
+
+    // 获取滚动容器
+    var scrollContainer = window;
+    if (anchorContainer) {
+      if (typeof anchorContainer === 'string') {
+        var container = document.querySelector(anchorContainer);
+        if (container instanceof HTMLElement) {
+          scrollContainer = container;
+        }
+      } else if (anchorContainer instanceof HTMLElement) {
+        scrollContainer = anchorContainer;
+      }
+    }
+
+    // 滚动到锚点
+    var scrollOptions = {
+      behavior: 'smooth',
+      block: 'start',
+      inline: 'nearest'
+    };
+    anchorElement.scrollIntoView(scrollOptions);
+  }, [currentStep, enableAnchor, anchorContainer]);
+}

package/es/components/PisellSteps/hooks/useResponsive.js

@@ -0,0 +1,43 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useEffect, useState } from 'react';
+
+/**
+ * 响应式监听 Hook
+ * 监听窗口大小变化，返回当前是否为移动端
+ * 
+ * @param breakpoint - 断点宽度（默认 768px）
+ * @returns 是否为移动端
+ */
+export function useResponsive() {
+  var breakpoint = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 768;
+  var _useState = useState(typeof window !== 'undefined' ? window.innerWidth < breakpoint : false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isMobile = _useState2[0],
+    setIsMobile = _useState2[1];
+  useEffect(function () {
+    // 服务端渲染时不执行
+    if (typeof window === 'undefined') {
+      return;
+    }
+    var handleResize = function handleResize() {
+      setIsMobile(window.innerWidth < breakpoint);
+    };
+
+    // 添加监听器
+    window.addEventListener('resize', handleResize);
+
+    // 初始化检查
+    handleResize();
+
+    // 清理监听器
+    return function () {
+      window.removeEventListener('resize', handleResize);
+    };
+  }, [breakpoint]);
+  return isMobile;
+}

package/es/components/PisellSteps/hooks/useStepClick.js

@@ -0,0 +1,35 @@
+import { useCallback } from 'react';
+import { isStepClickable } from "../utils";
+
+/**
+ * 处理步骤点击逻辑的 Hook
+ * 
+ * @param currentStep - 当前步骤索引
+ * @param clickable - 是否允许点击步骤切换
+ * @param allowClickFinished - 是否允许点击已完成的步骤
+ * @param onStepChange - 步骤变更回调函数
+ * @returns 步骤点击处理函数
+ */
+export function useStepClick(currentStep, clickable, allowClickFinished, onStepChange) {
+  var handleStepClick = useCallback(function (index, item) {
+    // 检查是否禁用
+    if (item.disabled) {
+      return;
+    }
+
+    // 检查是否可点击
+    if (!clickable) {
+      return;
+    }
+
+    // 检查步骤状态是否允许点击
+    var canClick = isStepClickable(index, currentStep, item.status || 'wait', clickable, allowClickFinished);
+    if (!canClick) {
+      return;
+    }
+
+    // 触发步骤变更
+    onStepChange(index);
+  }, [currentStep, clickable, allowClickFinished, onStepChange]);
+  return handleStepClick;
+}