@pisell/materials 1.0.983 → 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 {
+  .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);
+  // 低代码平台中的样式支持 - 水平布局
+  .pisell-lowcode-steps-item-icon {
+    margin-right: var(--pisell-steps-item-gap) !important;
   }
-  
-  .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-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,43 @@
     }
   }
 }
+
+// ============ 移动端当前步骤视图 ============
+.@{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;
+  }
+}
+
+// ============ 滚动模式样式 ============
+.@{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.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/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;
     /**
@@ -218,6 +180,30 @@ export interface PisellStepsProps extends Omit<StepsProps, 'type' | 'items' | 'o
      * 锚链接容器选择器（仅在 enableAnchor=true 时有效）
      */
     anchorContainer?: string | HTMLElement;
+    /**
+     * 移动端显示模式
+     * - 'full': 显示完整步骤条（默认）
+     * - 'current': 只显示当前步骤信息
+     * - 'auto': 自动根据屏幕宽度切换（<744px 时显示当前步骤）
+     * @default 'full'
+     */
+    mobileMode?: 'full' | 'current' | 'auto';
+    /**
+     * 移动端断点宽度（单位：px）
+     * @default 744
+     */
+    mobileBreakpoint?: number;
+    /**
+     * 是否启用横向滚动模式
+     * @description 当步骤条宽度不足时，启用横向滚动并显示左右箭头按钮
+     * @default false
+     */
+    enableScrollMode?: boolean;
+    /**
+     * 滚动箭头配置
+     * @description 配置滚动箭头的显示类型和滚动距离
+     */
+    scrollActionsConfig?: ScrollActionsConfig;
     /**
      * 设计模式标识（低代码引擎使用）
      */

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

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import type { PisellSuperTabsProps } from './types';
+import './PisellSuperTabs.less';
+/**
+ * PisellSuperTabs 组件
+ * @description 通用导航框架封装的全能型 Tab 组件
+ * @template T - 数据源项的类型
+ */
+declare const PisellSuperTabs: {
+    <T>(props: PisellSuperTabsProps<T>): JSX.Element;
+    displayName: string;
+};
+export default PisellSuperTabs;