@pisell/materials 1.0.987 → 1.0.988

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, .pisell-lowcode-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) !important;
     }
   }
-}
 
-// ============ 动画效果 ============
-.@{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) !important;
   }
-  
-  .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;
@@ -348,3 +318,15 @@
     line-height: 28px;
   }
 }
+
+// ============ 滚动模式样式 ============
+.@{pisell-steps-prefix}-scroll-view {
+  width: 100%;
+  position: relative;
+
+  // 滚动内容容器
+  .@{pisell-steps-prefix}-scroll-content {
+    display: inline-flex;
+    min-width: max-content;
+  }
+}

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/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

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

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

@@ -1,13 +1,10 @@
 import type { StepsProps, StepProps } from 'antd';
 import type { CSSProperties, ReactNode } from 'react';
+import type { ScrollActionsConfig } from '../PisellScrollView/types';
 /**
  * 步骤状态类型
  */
 export declare type StepStatus = 'wait' | 'process' | 'finish' | 'error';
-/**
- * 步骤条展示类型
- */
-export declare type StepType = 'default' | 'dot' | 'navigation';
 /**
  * 步骤条方向
  */
@@ -20,10 +17,6 @@ export declare type StepSize = 'small' | 'default' | 'large';
  * 标签放置位置
  */
 export declare type StepLabelPlacement = 'horizontal' | 'vertical';
-/**
- * 连接器位置
- */
-export declare type ConnectorPosition = 'center' | 'top' | 'bottom';
 /**
  * 单个步骤项配置
  */
@@ -79,12 +72,14 @@ export interface PisellStepItem extends Omit<StepProps, 'status' | 'onClick'> {
 /**
  * PisellSteps 组件 Props
  */
-export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'onChange' | 'current' | 'status' | 'size' | 'direction'> {
+export interface PisellStepsProps extends Omit<StepsProps, 'items' | 'onChange' | 'current' | 'status' | 'size' | 'direction'> {
     /**
-     * 步骤条类型
+     * 步骤条类型（直接使用 antd 的 type）
+     * @description 'default' - 默认样式，'navigation' - 导航样式
+     * @description dot 模式通过 progressDot 属性来控制，不需要单独的 type
      * @default 'default'
      */
-    type?: StepType;
+    type?: StepsProps['type'];
     /**
      * 当前步骤（受控模式）
      */
@@ -119,11 +114,9 @@ export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'o
      */
     items?: PisellStepItem[];
     /**
-     * 当前步骤的进度百分比（0-100）
-     */
-    percent?: number;
-    /**
-     * 标签文本位置
+     * 标签文本位置（标识区和文本区的布局方式）
+     * @description 'horizontal' - 文本在图标右侧（水平布局），'vertical' - 文本在图标下方（垂直布局）
+     * @description 仅在 direction='horizontal' 时生效
      * @default 'horizontal'
      */
     labelPlacement?: StepLabelPlacement;
@@ -164,33 +157,6 @@ export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'o
      * @default true
      */
     allowClickFinished?: boolean;
-    /**
-     * 是否显示进度百分比（在连接器上）
-     * @default false
-     */
-    showProgressPercent?: boolean;
-    /**
-     * 图标尺寸（单位：px）
-     */
-    iconSize?: number;
-    /**
-     * 图标颜色
-     */
-    iconColor?: string;
-    /**
-     * 连接器自定义样式
-     */
-    connectorStyle?: CSSProperties;
-    /**
-     * 连接器位置
-     * @default 'center'
-     */
-    connectorPosition?: ConnectorPosition;
-    /**
-     * 是否开启动画
-     * @default true
-     */
-    animated?: boolean;
     /**
      * 是否开启栅格布局
      * @default false
@@ -200,13 +166,9 @@ export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'o
      * 栅格列数（仅在 gridLayout=true 时有效）
      */
     gridColumns?: number;
-    /**
-     * 标识区和文本区的布局方式
-     * @default 'horizontal'
-     */
-    itemLayout?: 'horizontal' | 'vertical';
     /**
      * 标识区和文本区的间距（单位：px）
+     * @description 控制图标和文本之间的间距
      */
     itemGap?: number;
     /**
@@ -231,6 +193,17 @@ export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'o
      * @default 744
      */
     mobileBreakpoint?: number;
+    /**
+     * 是否启用横向滚动模式
+     * @description 当步骤条宽度不足时，启用横向滚动并显示左右箭头按钮
+     * @default false
+     */
+    enableScrollMode?: boolean;
+    /**
+     * 滚动箭头配置
+     * @description 配置滚动箭头的显示类型和滚动距离
+     */
+    scrollActionsConfig?: ScrollActionsConfig;
     /**
      * 设计模式标识（低代码引擎使用）
      */

package/lib/components/PisellSuperTabs/PisellSuperTabs.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { PisellSuperTabsProps } from './types';
 import './PisellSuperTabs.less';
 /**

package/lib/components/PisellTabbar/PisellTabbar.d.ts

@@ -1,3 +1,3 @@
-import PisellTabbar3 from '../PisellTabbar3';
+import PisellTabbar2 from '../PisellTabbar2';
 import './PisellTabbar.less';
-export default PisellTabbar3;
+export default PisellTabbar2;

package/lib/components/PisellTabbar/PisellTabbar.js

@@ -39,7 +39,7 @@ var import_hooks = require("./hooks");
 var import_utils = require("./utils");
 var import_constants = require("./constants");
 var import_mock = __toESM(require("./mock"));
-var import_PisellTabbar3 = __toESM(require("../PisellTabbar3"));
+var import_PisellTabbar2 = __toESM(require("../PisellTabbar2"));
 var import_PisellTabbar = require("./PisellTabbar.less");
 var PisellTabbar = (props) => {
   const {
@@ -183,4 +183,4 @@ var PisellTabbar = (props) => {
   )) : null;
 };
 PisellTabbar.displayName = "PisellTabbar";
-var PisellTabbar_default = import_PisellTabbar3.default;
+var PisellTabbar_default = import_PisellTabbar2.default;

package/lib/components/PisellTabbar2/PisellTabbar.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { getDefaultActiveKey } from './utils';
 import { PisellTabbarProps } from './types';
 import './PisellTabbar.less';
 /**
@@ -16,5 +17,7 @@ import './PisellTabbar.less';
  * />
  * ```
  */
-declare const PisellTabbar: React.FC<PisellTabbarProps>;
+declare const PisellTabbar: React.FC<PisellTabbarProps> & {
+    getDefaultActiveKey: typeof getDefaultActiveKey;
+};
 export default PisellTabbar;

package/lib/components/PisellTabbar2/PisellTabbar.js

@@ -74,11 +74,15 @@ var PisellTabbar = (props) => {
   const handleLevel1Change = (0, import_react.useCallback)(
     (key, item) => {
       var _a, _b;
-      setActiveKey(
-        0,
-        key,
-        ((_a = item == null ? void 0 : item.children) == null ? void 0 : _a.length) ? (_b = item == null ? void 0 : item.children[0]) == null ? void 0 : _b.id : void 0
-      );
+      if (item.childrenMaxLevel !== void 0 && item.childrenMaxLevel < 2) {
+        setActiveKey(0, key, 0);
+      } else {
+        setActiveKey(
+          0,
+          key,
+          ((_a = item == null ? void 0 : item.children) == null ? void 0 : _a.length) ? (_b = item == null ? void 0 : item.children[0]) == null ? void 0 : _b.id : void 0
+        );
+      }
     },
     [setActiveKey]
   );
@@ -104,7 +108,7 @@ var PisellTabbar = (props) => {
       if (maxLevel < 2) return null;
       const childrenMaxLevel = panelProps.dataSource.childrenMaxLevel || 2;
       if (childrenMaxLevel < 2) {
-        return renderLevel3(panelProps);
+        return renderLevel3(panelProps, true);
       }
       let _dataSource = panelProps.dataSource.children || [];
       if (_dataSource.length) {
@@ -167,7 +171,7 @@ var PisellTabbar = (props) => {
     ]
   );
   const renderLevel3 = (0, import_react.useCallback)(
-    (panelProps2) => {
+    (panelProps2, isLevel2) => {
       if (maxLevel < 3) return null;
       let _dataSource2 = panelProps2.dataSource.children || [];
       if (_dataSource2.length) {
@@ -181,14 +185,14 @@ var PisellTabbar = (props) => {
         {
           skuId: `sku-list-tabbar-${panelProps2.dataSource.id}`,
           dataSource: _dataSource2,
-          activePanelKey: getActiveKey(2),
+          activePanelKey: getActiveKey(isLevel2 ? 1 : 2),
           level: "level3",
-          setActivePanelKey: handleLevel3Change,
-          expand: getExpand("level3"),
-          handleExpand: () => toggleExpand("level3"),
+          setActivePanelKey: isLevel2 ? handleLevel2Change : handleLevel3Change,
+          expand: getExpand(isLevel2 ? "level2" : "level3"),
+          handleExpand: () => toggleExpand(isLevel2 ? "level2" : "level3"),
           levelConfig: getLevelConfig("level3"),
           expandConfig,
-          positionId: getLevelConfig("level3").positionId
+          positionId: getLevelConfig(isLevel2 ? "level2" : "level3").positionId
         }
       );
     },
@@ -205,6 +209,7 @@ var PisellTabbar = (props) => {
   (0, import_react.useEffect)(() => {
     document.body.id = "body";
   }, []);
+  console.log("activeKeyactiveKey", activeKey);
   return dataSource.length ? /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)("pisell-tabbar2", className), style }, /* @__PURE__ */ import_react.default.createElement(
     import_components.TabbarLevel,
     {
@@ -227,7 +232,10 @@ var PisellTabbar = (props) => {
           gap: 12
         },
         panelStyle: {
-          height: "100%",
+          position: "absolute",
+          top: 40,
+          right: 0,
+          height: "calc(100% - 40px)",
           transition: "0.3s ease-in-out"
         },
         startSlot: null,
@@ -251,4 +259,5 @@ var PisellTabbar = (props) => {
   )) : null;
 };
 PisellTabbar.displayName = "PisellTabbar";
+PisellTabbar.getDefaultActiveKey = import_utils.getDefaultActiveKey;
 var PisellTabbar_default = PisellTabbar;

package/lib/components/PisellTabbar2/PisellTabbar.less

@@ -4,6 +4,7 @@
 .pisell-tabbar2 {
   // height: 100vh;
   width: 96px;
+  height: 100%;
   // position: fixed;
   // top: 0;
   // right: 0;