@pisell/materials 1.0.977 → 1.0.979

package/es/components/PisellSteps/PisellSteps.js

@@ -1,200 +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 = ["current", "items", "type", "size", "direction", "status", "progressDot", "labelPlacement", "percent", "responsive", "onChange", "className", "style", "connectorStyle", "showConnector", "iconPosition"];
+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 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 _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 React, { useMemo, useCallback } from 'react';
-import { Steps } from 'antd';
-import classNames from 'classnames';
+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 进行二次封装，提供更强大的功能和更灵活的样式定制
  *
- * @example
- * ```tsx
- * <PisellSteps
- *   current={1}
- *   items={[
- *     { title: 'Finished', description: 'This is a description.' },
- *     { title: 'In Progress', description: 'This is a description.' },
- *     { title: 'Waiting', description: 'This is a description.' },
- *   ]}
- *   onChange={(current) => console.log('Step changed to:', current)}
- * />
- * ```
+ * 基于 Ant Design Steps 组件进行二次封装和增强
+ * 支持多种展示样式、布局方式和丰富的交互功能
+ *
+ * @author Pisell Team
+ * @version 1.0.0
  */
 var PisellSteps = function PisellSteps(_ref) {
-  var _ref$current = _ref.current,
-    current = _ref$current === void 0 ? 0 : _ref$current,
-    _ref$items = _ref.items,
-    items = _ref$items === void 0 ? [] : _ref$items,
-    _ref$type = _ref.type,
+  var _ref$type = _ref.type,
     type = _ref$type === void 0 ? 'default' : _ref$type,
-    _ref$size = _ref.size,
-    size = _ref$size === void 0 ? 'default' : _ref$size,
+    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$progressDot = _ref.progressDot,
-    progressDot = _ref$progressDot === void 0 ? false : _ref$progressDot,
+    _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,
-    percent = _ref.percent,
     _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$showConnector = _ref.showConnector,
-    showConnector = _ref$showConnector === void 0 ? true : _ref$showConnector,
-    _ref$iconPosition = _ref.iconPosition,
-    iconPosition = _ref$iconPosition === void 0 ? 'top' : _ref$iconPosition,
+    _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 computedItems = useMemo(function () {
-    return items.map(function (item, index) {
-      // 如果步骤已经指定了状态，则使用指定的状态
-      var itemStatus = item.status || 'wait';
+  // 状态管理：支持受控和非受控模式
+  var _useStepsState = useStepsState(controlledCurrent, defaultCurrent, onChange),
+    _useStepsState2 = _slicedToArray(_useStepsState, 2),
+    currentStep = _useStepsState2[0],
+    setCurrentStep = _useStepsState2[1];
 
-      // 如果没有指定状态，则根据当前步骤索引自动计算
-      if (!item.status) {
-        if (index < current) {
-          itemStatus = 'finish';
-        } else if (index === current) {
-          itemStatus = status;
-        } else {
-          itemStatus = 'wait';
-        }
-      }
-      return _objectSpread(_objectSpread({}, item), {}, {
-        status: itemStatus
-      });
-    });
-  }, [items, current, status]);
+  // 处理步骤点击逻辑
+  var handleStepClick = useStepClick(currentStep, clickable, allowClickFinished, setCurrentStep);
 
-  /**
-   * 处理步骤点击事件
-   * 默认行为：只允许点击已完成的步骤进行返回
-   * 禁用的步骤不可点击
-   */
-  var handleStepClick = useCallback(function (index) {
-    var _targetItem$onClick;
-    var targetItem = items[index];
+  // 锚链接功能
+  useAnchor(currentStep, enableAnchor, anchorContainer);
 
-    // 如果步骤被禁用，不触发任何操作
-    if (targetItem !== null && targetItem !== void 0 && targetItem.disabled) {
-      return;
-    }
+  // 响应式监听
+  var isMobile = useResponsive(768);
 
-    // 默认只允许点击已完成的步骤（索引小于当前步骤）
-    if (index < current) {
-      onChange === null || onChange === void 0 || onChange(index);
+  // 处理步骤数据
+  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'
+      }];
     }
 
-    // 触发步骤自身的 onClick 回调
-    targetItem === null || targetItem === void 0 || (_targetItem$onClick = targetItem.onClick) === null || _targetItem$onClick === void 0 || _targetItem$onClick.call(targetItem);
-  }, [items, current, onChange]);
+    // 处理每个步骤项
+    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);
 
-  /**
-   * 转换 items 为 Ant Design Steps 所需的格式
-   * 保留所有必要的属性，确保完整的功能支持
-   */
-  var antdItems = useMemo(function () {
-    return computedItems.map(function (item) {
-      return {
-        title: item.title,
-        subTitle: item.subTitle,
-        description: item.description,
-        status: item.status,
-        icon: item.icon,
-        disabled: item.disabled,
-        className: classNames(item.className, {
-          'pisell-steps-item-clickable': !item.disabled && item.status === 'finish'
-        }),
-        style: item.style
+      // 处理点击事件
+      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
+      });
     });
-  }, [computedItems]);
+  }, [items, currentStep, initial, status, clickable, handleStepClick, __designMode]);
 
-  /**
-   * 合并样式
-   * 支持通过 CSS Variables 传递连接器样式
-   */
-  var mergedStyle = useMemo(function () {
-    var baseStyle = _objectSpread({}, style);
+  // 合并样式类名
+  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]);
 
-    // 如果提供了连接器样式，通过 CSS Variables 传递
-    if (connectorStyle) {
-      Object.entries(connectorStyle).forEach(function (_ref2) {
-        var _ref3 = _slicedToArray(_ref2, 2),
-          key = _ref3[0],
-          value = _ref3[1];
-        var cssVarKey = "--pisell-step-connector-".concat(key.replace(/([A-Z])/g, '-$1').toLowerCase());
-        baseStyle[cssVarKey] = value;
-      });
+  // 合并自定义样式
+  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");
     }
-    return baseStyle;
-  }, [style, connectorStyle]);
+    if (gridColumns && gridLayout) {
+      customStyle['--pisell-steps-grid-columns'] = gridColumns;
+    }
+    return customStyle;
+  }, [style, iconSize, iconColor, itemGap, gridColumns, gridLayout]);
 
-  /**
-   * 合并类名
-   * 根据不同的配置添加对应的样式类
-   */
-  var mergedClassName = useMemo(function () {
-    return classNames('pisell-steps', "pisell-steps-".concat(type), "pisell-steps-".concat(size), "pisell-steps-".concat(direction), {
-      'pisell-steps-dot': progressDot,
-      'pisell-steps-responsive': responsive,
-      'pisell-steps-no-connector': !showConnector,
-      'pisell-steps-label-vertical': labelPlacement === 'vertical',
-      'pisell-steps-icon-bottom': iconPosition === 'bottom'
-    }, className);
-  }, [type, size, direction, progressDot, responsive, showConnector, labelPlacement, iconPosition, className]);
+  // 处理进度百分比显示
+  var effectivePercent = showProgressPercent ? percent : undefined;
 
-  /**
-   * 处理 progressDot 属性
-   * 支持布尔值和函数两种形式
-   */
-  var renderProgressDot = useMemo(function () {
-    if (typeof progressDot === 'function') {
-      return progressDot;
-    }
-    return progressDot;
-  }, [progressDot]);
-  return /*#__PURE__*/React.createElement(Steps, _extends({}, restProps, {
-    type: type,
-    current: current,
-    items: antdItems,
-    size: size,
+  // 根据 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,
-    progressDot: renderProgressDot,
+    items: processedItems,
+    percent: effectivePercent,
     labelPlacement: labelPlacement,
-    percent: percent,
-    responsive: responsive,
-    onChange: handleStepClick,
-    className: mergedClassName,
-    style: mergedStyle
-  }));
+    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;