@pisell/materials 3.3.77 → 3.3.79

package/lib/components/PisellScrollView/hooks/useScrollState.js

@@ -0,0 +1,208 @@
+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/PisellScrollView/hooks/useScrollState.ts
+var useScrollState_exports = {};
+__export(useScrollState_exports, {
+  useScrollState: () => useScrollState
+});
+module.exports = __toCommonJS(useScrollState_exports);
+var import_react = require("react");
+var debounce = (fn, delay) => {
+  let timeoutId = null;
+  return (...args) => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      fn(...args);
+      timeoutId = null;
+    }, delay);
+  };
+};
+var useScrollState = ({
+  containerRef,
+  overflow
+}) => {
+  const [scrollState, setScrollState] = (0, import_react.useState)(() => ({
+    scrollTop: 0,
+    scrollLeft: 0,
+    percentY: 0,
+    percentX: 0,
+    scrollHeight: 0,
+    scrollWidth: 0,
+    clientHeight: 0,
+    clientWidth: 0,
+    direction: null,
+    isScrollToTop: overflow === "y" || overflow === "both",
+    isScrollToBottom: false,
+    isScrollToLeft: overflow === "x" || overflow === "both",
+    isScrollToRight: false,
+    isOverflows: false
+  }));
+  const isMountedRef = (0, import_react.useRef)(true);
+  const resizeObserverRef = (0, import_react.useRef)(null);
+  const calculateScrollState = (0, import_react.useCallback)(
+    (prevState = null) => {
+      const container = containerRef.current;
+      if (!container) return null;
+      try {
+        const {
+          scrollTop,
+          scrollLeft,
+          scrollHeight,
+          scrollWidth,
+          clientHeight,
+          clientWidth
+        } = container;
+        const isOverflows = scrollHeight > clientHeight || scrollWidth > clientWidth;
+        const isScrollToTop = scrollTop <= 0;
+        const isScrollToBottom = scrollTop + clientHeight >= scrollHeight - 1;
+        const isScrollToLeft = scrollLeft <= 0;
+        const isScrollToRight = scrollLeft + clientWidth >= scrollWidth - 1;
+        let direction = null;
+        if (prevState) {
+          const deltaY = Math.abs(scrollTop - prevState.scrollTop);
+          const deltaX = Math.abs(scrollLeft - prevState.scrollLeft);
+          if (deltaY > deltaX && deltaY > 0) {
+            direction = scrollTop > prevState.scrollTop ? "down" : "up";
+          } else if (deltaX > 0) {
+            direction = scrollLeft > prevState.scrollLeft ? "right" : "left";
+          } else {
+            direction = prevState.direction;
+          }
+        }
+        const maxScrollTop = Math.max(0, scrollHeight - clientHeight);
+        const maxScrollLeft = Math.max(0, scrollWidth - clientWidth);
+        const percentY = maxScrollTop > 0 ? scrollTop / maxScrollTop * 100 : 0;
+        const percentX = maxScrollLeft > 0 ? scrollLeft / maxScrollLeft * 100 : 0;
+        return {
+          scrollTop,
+          scrollLeft,
+          scrollHeight,
+          scrollWidth,
+          clientHeight,
+          clientWidth,
+          percentY,
+          percentX,
+          direction,
+          isScrollToTop,
+          isScrollToBottom,
+          isScrollToLeft,
+          isScrollToRight,
+          isOverflows
+        };
+      } catch (error) {
+        console.warn("[useScrollState] 计算滚动状态时出错:", error);
+        return null;
+      }
+    },
+    [containerRef]
+  );
+  const updateScrollState = (0, import_react.useCallback)(() => {
+    if (!isMountedRef.current) return;
+    setScrollState((prev) => {
+      const newState = calculateScrollState(prev);
+      return newState || prev;
+    });
+  }, [calculateScrollState]);
+  const updateOverflowState = (0, import_react.useCallback)(() => {
+    if (!isMountedRef.current) return;
+    const newState = calculateScrollState(null);
+    if (newState) {
+      setScrollState((prev) => ({
+        ...prev,
+        scrollHeight: newState.scrollHeight,
+        scrollWidth: newState.scrollWidth,
+        clientHeight: newState.clientHeight,
+        clientWidth: newState.clientWidth,
+        isOverflows: newState.isOverflows,
+        isScrollToTop: newState.isScrollToTop,
+        isScrollToBottom: newState.isScrollToBottom,
+        isScrollToLeft: newState.isScrollToLeft,
+        isScrollToRight: newState.isScrollToRight
+      }));
+    }
+  }, [calculateScrollState]);
+  (0, import_react.useEffect)(() => {
+    isMountedRef.current = true;
+    const container = containerRef.current;
+    if (!container) return;
+    const debouncedUpdateOverflow = debounce(updateOverflowState, 50);
+    updateOverflowState();
+    if (typeof ResizeObserver === "undefined") {
+      const handleResize = () => debouncedUpdateOverflow();
+      window.addEventListener("resize", handleResize);
+      return () => {
+        isMountedRef.current = false;
+        window.removeEventListener("resize", handleResize);
+      };
+    }
+    try {
+      resizeObserverRef.current = new ResizeObserver((entries) => {
+        if (entries.length > 0 && isMountedRef.current) {
+          debouncedUpdateOverflow();
+        }
+      });
+      resizeObserverRef.current.observe(container);
+      const children = container.children;
+      for (let i = 0; i < children.length; i++) {
+        resizeObserverRef.current.observe(children[i]);
+      }
+      const mutationObserver = new MutationObserver((mutations) => {
+        if (!isMountedRef.current || !resizeObserverRef.current) return;
+        mutations.forEach((mutation) => {
+          mutation.addedNodes.forEach((node) => {
+            var _a;
+            if (node instanceof Element) {
+              (_a = resizeObserverRef.current) == null ? void 0 : _a.observe(node);
+            }
+          });
+        });
+        debouncedUpdateOverflow();
+      });
+      mutationObserver.observe(container, {
+        childList: true,
+        subtree: false
+      });
+      const handleWindowResize = () => debouncedUpdateOverflow();
+      window.addEventListener("resize", handleWindowResize);
+      return () => {
+        var _a;
+        isMountedRef.current = false;
+        (_a = resizeObserverRef.current) == null ? void 0 : _a.disconnect();
+        resizeObserverRef.current = null;
+        mutationObserver.disconnect();
+        window.removeEventListener("resize", handleWindowResize);
+      };
+    } catch (error) {
+      console.warn("[useScrollState] 初始化 ResizeObserver 失败:", error);
+      const handleResize = () => debouncedUpdateOverflow();
+      window.addEventListener("resize", handleResize);
+      return () => {
+        isMountedRef.current = false;
+        window.removeEventListener("resize", handleResize);
+      };
+    }
+  }, [containerRef, updateOverflowState]);
+  return { scrollState, updateScrollState };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useScrollState
+});

package/lib/components/PisellScrollView/index.d.ts

@@ -0,0 +1,3 @@
+import PisellScrollView from './PisellScrollView';
+export type { PisellScrollViewProps, PisellScrollViewRef } from './types';
+export default PisellScrollView;

package/lib/components/PisellScrollView/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/PisellScrollView/index.tsx
+var PisellScrollView_exports = {};
+__export(PisellScrollView_exports, {
+  default: () => PisellScrollView_default
+});
+module.exports = __toCommonJS(PisellScrollView_exports);
+var import_PisellScrollView = __toESM(require("./PisellScrollView"));
+var PisellScrollView_default = import_PisellScrollView.default;

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

@@ -0,0 +1,203 @@
+import React, { ReactNode, CSSProperties } from 'react';
+/**
+ * 滚动位置配置
+ */
+export interface ScrollPosition {
+    /** 竖向滚动位置（像素） */
+    scrollTop?: number;
+    /** 横向滚动位置（像素） */
+    scrollLeft?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动到元素配置
+ */
+export interface ScrollToElementConfig {
+    /** 目标元素 ID */
+    targetId: string;
+    /** 对齐方式 */
+    align?: 'start' | 'center' | 'end' | 'nearest';
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+    /** 偏移量 */
+    offset?: number;
+}
+/**
+ * 滚动百分比配置
+ */
+export interface ScrollPercentage {
+    /** 竖向滚动百分比 (0-100) */
+    percentY?: number;
+    /** 横向滚动百分比 (0-100) */
+    percentX?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动按钮配置
+ */
+export interface ScrollActionsConfig {
+    show?: boolean;
+    /** 按钮类型 */
+    type: "backTop" | "rArrows" | "lrArrows" | "tbArrows" | "custom";
+    style?: CSSProperties;
+    scrollDistance?: number;
+    /** 按钮配置 根据type不同，配置不同 */
+    config?: any;
+}
+/**
+ * 滚动事件数据
+ */
+export interface ScrollEventData {
+    /** 当前滚动位置 */
+    scrollTop: number;
+    scrollLeft: number;
+    /** 滚动百分比 */
+    percentY: number;
+    percentX: number;
+    /** 可滚动高度/宽度 */
+    scrollHeight: number;
+    scrollWidth: number;
+    /** 容器尺寸 */
+    clientHeight: number;
+    clientWidth: number;
+    /** 滚动方向 */
+    direction: 'up' | 'down' | 'left' | 'right' | null;
+    /** 是否滚动到顶部 */
+    isScrollToTop: boolean;
+    /** 是否滚动到底部 */
+    isScrollToBottom: boolean;
+    /** 是否滚动到左边 */
+    isScrollToLeft: boolean;
+    /** 是否滚动到右边 */
+    isScrollToRight: boolean;
+    /** 是否已经产生滚动条 */
+    isOverflows: boolean;
+}
+/**
+ * 视图监听配置
+ */
+export interface IntersectionConfig {
+    /** 是否启用视图监听 */
+    enabled?: boolean;
+    /** 交叉阈值 (0-1) */
+    threshold?: number | number[];
+    /** 根边距 */
+    rootMargin?: string;
+    /** 元素进入视图回调 */
+    onEnterViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 元素离开视图回调 */
+    onLeaveViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 可见度变化回调 */
+    onVisibilityChange?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 需要监听的元素选择器 */
+    targetSelector?: string;
+}
+/**
+ * 吸附滚动配置
+ */
+export interface SnapScrollConfig {
+    /** 是否启用吸附滚动 */
+    enabled?: boolean;
+    /** 吸附类型 */
+    type?: 'mandatory' | 'proximity';
+    /** 吸附对齐方式 */
+    align?: 'start' | 'center' | 'end';
+    /** 吸附开始回调 */
+    onSnapStart?: (targetIndex: number, targetPosition: number) => void;
+    /** 吸附结束回调 */
+    onSnapEnd?: (currentIndex: number, currentPosition: number) => void;
+}
+/**
+ * PisellScrollView 组件 Props
+ */
+export interface PisellScrollViewProps {
+    /** 子元素 */
+    children?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 滚动方向 */
+    overflow?: 'auto' | 'scroll' | 'hidden' | 'x' | 'y' | 'both';
+    /** 滚动条样式 */
+    scrollbarStyle?: 'default' | 'thin' | 'minimal' | 'rounded' | 'overlay' | 'custom' | 'none';
+    /** 自定义滚动条类名（当 scrollbarStyle 为 'custom' 时使用） */
+    scrollbarClassName?: string;
+    /** 是否显示滚动按钮 */
+    showScrollButtons?: boolean;
+    /** 箭头操作 */
+    scrollActionsConfig?: ScrollActionsConfig;
+    /** 滚动时触发 */
+    onScroll?: (data: ScrollEventData) => void;
+    /** 开始滚动时触发 */
+    onScrollStart?: (data: ScrollEventData) => void;
+    /** 滚动结束时触发（防抖延迟，默认 150ms） */
+    onScrollEnd?: (data: ScrollEventData) => void;
+    /** 滚动结束防抖延迟时间（ms） */
+    scrollEndDelay?: number;
+    /** 到达顶部时触发 */
+    onReachTop?: (data: ScrollEventData) => void;
+    /** 到达底部时触发 */
+    onReachBottom?: (data: ScrollEventData) => void;
+    /** 到达左边时触发 */
+    onReachLeft?: (data: ScrollEventData) => void;
+    /** 到达右边时触发 */
+    onReachRight?: (data: ScrollEventData) => void;
+    /** 边界阈值（到达边界的像素阈值） */
+    reachThreshold?: number;
+    /** IntersectionObserver 配置 */
+    intersection?: IntersectionConfig;
+    /** 吸附滚动配置 */
+    snapScroll?: SnapScrollConfig;
+    /** 容器宽度 */
+    width?: number | string;
+    /** 容器高度 */
+    height?: number | string;
+    /** 最大宽度 */
+    maxWidth?: number | string;
+    /** 最大高度 */
+    maxHeight?: number | string;
+    /** 最小宽度 */
+    minWidth?: number | string;
+    /** 最小高度 */
+    minHeight?: number | string;
+    /** Ref 引用 */
+    ref?: React.Ref<PisellScrollViewRef>;
+    /** 设计模式 */
+    __designMode?: boolean;
+}
+/**
+ * 组件暴露的方法
+ */
+export interface PisellScrollViewRef {
+    /** 滚动到指定位置 */
+    scrollTo: (position: ScrollPosition) => void;
+    /** 滚动到指定元素 */
+    scrollToElement: (config: ScrollToElementConfig) => void;
+    /** 滚动到百分比位置 */
+    scrollToPercentage: (percentage: ScrollPercentage) => void;
+    /** 滚动到顶部 */
+    scrollToTop: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到底部 */
+    scrollToBottom: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最左侧 */
+    scrollToLeft: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最右侧 */
+    scrollToRight: (behavior?: 'auto' | 'smooth') => void;
+    /** 获取当前滚动信息 */
+    getScrollData: () => ScrollEventData;
+    /** 获取滚动容器 DOM 元素 */
+    getScrollContainer: () => HTMLElement | null;
+    /** 滚动到指定吸附点（索引） */
+    scrollToSnapPoint: (index: number, behavior?: 'auto' | 'smooth') => void;
+    /** 获取所有吸附点位置 */
+    getSnapPoints: () => number[];
+    /** 获取当前吸附点索引 */
+    getCurrentSnapIndex: () => number;
+    /** 滚动到下一个吸附点 */
+    scrollToNextSnap: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到上一个吸附点 */
+    scrollToPrevSnap: (behavior?: 'auto' | 'smooth') => void;
+}

package/lib/components/PisellScrollView/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/PisellScrollView/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import './PisellSteps.less';
+import type { PisellStepsProps } from './types';
+/**
+ * PisellSteps 步骤条组件
+ *
+ * 基于 Ant Design Steps 组件进行二次封装和增强
+ * 支持多种展示样式、布局方式和丰富的交互功能
+ *
+ * @author Pisell Team
+ * @version 1.0.0
+ */
+declare const PisellSteps: React.FC<PisellStepsProps>;
+export default PisellSteps;