@pisell/materials 6.7.4 → 6.8.2

package/lib/components/PisellSteps/PisellSteps.less

@@ -0,0 +1,320 @@
+// PisellSteps 组件样式
+// 基于 Ant Design Steps 进行样式扩展和定制
+
+@pisell-steps-prefix: pisell-steps;
+
+// ============ CSS 变量定义 ============
+.@{pisell-steps-prefix} {
+  // 间距相关
+  --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%;
+
+  // 默认尺寸（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-light);
+
+      > .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,
+  .pisell-lowcode-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: 14px;
+  }
+}
+
+.@{pisell-steps-prefix}-large {
+  .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,
+  .pisell-lowcode-steps-item-title {
+    font-size: 16px;
+  }
+
+  .ant-steps-item-description,
+  .pisell-lowcode-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);
+  }
+}
+
+// 连接器位置样式已移除
+
+// ============ 标识区和文本区间距 =============
+// 控制图标和文本之间的间距
+// 只有当设置了 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);
+    }
+  }
+
+  // 水平布局时（labelPlacement='horizontal'），控制图标右侧的间距
+  .ant-steps-item {
+    .ant-steps-item-icon {
+      margin-right: var(--pisell-steps-item-gap) !important;
+    }
+  }
+
+  // 低代码平台中的样式支持 - 水平布局
+  .pisell-lowcode-steps-item-icon {
+    margin-right: var(--pisell-steps-item-gap) !important;
+  }
+
+  // 低代码平台垂直布局 - 设置内容区域的上边距
+  &.pisell-lowcode-steps-label-vertical,
+  .pisell-lowcode-steps-label-vertical {
+    .pisell-lowcode-steps-item-content {
+      margin-top: var(--pisell-steps-item-gap);
+    }
+  }
+}
+
+// 动画效果样式已移除
+
+// ============ 进度百分比显示 ============
+// 进度百分比样式已移除，直接使用 antd Steps 的默认进度条样式
+
+// ============ 竖向布局特殊样式 ============
+.@{pisell-steps-prefix}-vertical {
+  .ant-steps-item {
+    padding-bottom: var(--pisell-steps-margin);
+
+    &:last-child {
+      padding-bottom: 0;
+    }
+  }
+}
+
+// ============ 自定义图标尺寸 ============
+// ============ 禁用状态 ============
+.@{pisell-steps-prefix} {
+  .ant-steps-item-disabled {
+    cursor: not-allowed;
+    opacity: 0.5;
+
+    &:hover {
+      .ant-steps-item-icon {
+        transform: none;
+      }
+    }
+  }
+}
+
+// ============ 移动端当前步骤视图 ============
+.@{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/lib/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/lib/components/PisellSteps/hooks/index.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useAnchor: () => import_useAnchor.useAnchor,
+  useResponsive: () => import_useResponsive.useResponsive,
+  useStepClick: () => import_useStepClick.useStepClick,
+  useStepsState: () => import_useStepsState.useStepsState
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useStepsState = require("./useStepsState");
+var import_useStepClick = require("./useStepClick");
+var import_useAnchor = require("./useAnchor");
+var import_useResponsive = require("./useResponsive");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useAnchor,
+  useResponsive,
+  useStepClick,
+  useStepsState
+});

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

@@ -0,0 +1,66 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/hooks/useAnchor.ts
+var useAnchor_exports = {};
+__export(useAnchor_exports, {
+  useAnchor: () => useAnchor
+});
+module.exports = __toCommonJS(useAnchor_exports);
+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;
+    }
+    if (previousStepRef.current === currentStep) {
+      return;
+    }
+    previousStepRef.current = currentStep;
+    const anchorId = `pisell-steps-anchor-${currentStep}`;
+    const anchorElement = document.getElementById(anchorId);
+    if (!anchorElement) {
+      return;
+    }
+    let scrollContainer = window;
+    if (anchorContainer) {
+      if (typeof anchorContainer === "string") {
+        const container = document.querySelector(anchorContainer);
+        if (container instanceof HTMLElement) {
+          scrollContainer = container;
+        }
+      } else if (anchorContainer instanceof HTMLElement) {
+        scrollContainer = anchorContainer;
+      }
+    }
+    const scrollOptions = {
+      behavior: "smooth",
+      block: "start",
+      inline: "nearest"
+    };
+    anchorElement.scrollIntoView(scrollOptions);
+  }, [currentStep, enableAnchor, anchorContainer]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useAnchor
+});

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/useResponsive.js

@@ -0,0 +1,48 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/hooks/useResponsive.ts
+var useResponsive_exports = {};
+__export(useResponsive_exports, {
+  useResponsive: () => useResponsive
+});
+module.exports = __toCommonJS(useResponsive_exports);
+var import_react = require("react");
+function useResponsive(breakpoint = 768) {
+  const [isMobile, setIsMobile] = (0, import_react.useState)(
+    typeof window !== "undefined" ? window.innerWidth < breakpoint : false
+  );
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    const handleResize = () => {
+      setIsMobile(window.innerWidth < breakpoint);
+    };
+    window.addEventListener("resize", handleResize);
+    handleResize();
+    return () => {
+      window.removeEventListener("resize", handleResize);
+    };
+  }, [breakpoint]);
+  return isMobile;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useResponsive
+});

package/lib/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/lib/components/PisellSteps/hooks/useStepClick.js

@@ -0,0 +1,55 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/hooks/useStepClick.ts
+var useStepClick_exports = {};
+__export(useStepClick_exports, {
+  useStepClick: () => useStepClick
+});
+module.exports = __toCommonJS(useStepClick_exports);
+var import_react = require("react");
+var import_utils = require("../utils");
+function useStepClick(currentStep, clickable, allowClickFinished, onStepChange) {
+  const handleStepClick = (0, import_react.useCallback)(
+    (index, item) => {
+      if (item.disabled) {
+        return;
+      }
+      if (!clickable) {
+        return;
+      }
+      const canClick = (0, import_utils.isStepClickable)(
+        index,
+        currentStep,
+        item.status || "wait",
+        clickable,
+        allowClickFinished
+      );
+      if (!canClick) {
+        return;
+      }
+      onStepChange(index);
+    },
+    [currentStep, clickable, allowClickFinished, onStepChange]
+  );
+  return handleStepClick;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useStepClick
+});

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

@@ -0,0 +1,56 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/hooks/useStepsState.ts
+var useStepsState_exports = {};
+__export(useStepsState_exports, {
+  useStepsState: () => useStepsState
+});
+module.exports = __toCommonJS(useStepsState_exports);
+var import_react = require("react");
+function useStepsState(current, defaultCurrent = 0, onChange) {
+  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;
+      if (!isControlled) {
+        setInnerCurrent(value);
+      }
+      if (onChange && value !== previousCurrent) {
+        onChange(value);
+      }
+      previousCurrentRef.current = value;
+    },
+    [isControlled, onChange]
+  );
+  (0, import_react.useEffect)(() => {
+    if (isControlled && safeCurrent !== void 0) {
+      previousCurrentRef.current = safeCurrent;
+    }
+  }, [safeCurrent, isControlled]);
+  return [currentStep, setCurrentStep];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useStepsState
+});

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

package/lib/components/PisellSteps/index.js

@@ -0,0 +1,36 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/index.tsx
+var PisellSteps_exports = {};
+__export(PisellSteps_exports, {
+  default: () => PisellSteps_default
+});
+module.exports = __toCommonJS(PisellSteps_exports);
+var import_PisellSteps = __toESM(require("./PisellSteps"));
+var PisellSteps_default = import_PisellSteps.default;