@tiny-codes/react-easy 1.4.19 → 1.4.20

package/es/hooks/useMovable.d.ts

@@ -0,0 +1,36 @@
+import { type RefObject } from 'react';
+export interface UseMovableProps {
+    /**
+     * - **EN:** Whether dragging is enabled, default is `true`
+     * - **CN:** 是否启用拖动，默认`true`
+     */
+    enabled?: boolean;
+    /**
+     * - **EN:** The ref of the container element
+     * - **CN:** 容器元素的ref
+     */
+    containerRef: RefObject<HTMLElement>;
+    /**
+     * - **EN:** Selectors of elements that should not trigger dragging, e.g., interactive controls
+     * - **CN:** 不应触发拖动的元素的选择器，例如交互控件
+     */
+    ignoreSelectors?: string[];
+    /**
+     * - **EN:** Key for storing position in localStorage; if not provided, position won't be saved
+     * - **CN:** 用于在 localStorage 中存储位置的键；如果未提供，则不会保存位置
+     */
+    storageKey?: string;
+}
+/**
+ * - **EN:** Hook to make an element movable by dragging, with position persistence using localStorage
+ * - **CN:** 通过拖动使元素可移动的钩子，并使用 localStorage 持久化位置
+ */
+declare const useMovable: (props: UseMovableProps) => {
+    onPointerDown: (e: React.PointerEvent<HTMLDivElement>) => void;
+    position: MovePosition | undefined;
+};
+export interface MovePosition {
+    left: number;
+    top: number;
+}
+export default useMovable;

package/es/hooks/useMovable.js

@@ -0,0 +1,126 @@
+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; }
+import { useEffect, useRef, useState } from 'react';
+import { useLocalStorage } from 'react-use';
+import useRefFunction from "./useRefFunction";
+import useRefValue from "./useRefValue";
+/**
+ * - **EN:** Hook to make an element movable by dragging, with position persistence using localStorage
+ * - **CN:** 通过拖动使元素可移动的钩子，并使用 localStorage 持久化位置
+ */
+var useMovable = function useMovable(props) {
+  var enabled = props.enabled,
+    containerRef = props.containerRef,
+    ignoreSelectors = props.ignoreSelectors,
+    storageKey = props.storageKey;
+  var storageKeyRef = useRefValue(storageKey);
+  var _useLocalStorage = useLocalStorage(storageKey !== null && storageKey !== void 0 ? storageKey : ''),
+    _useLocalStorage2 = _slicedToArray(_useLocalStorage, 2),
+    savedPosition = _useLocalStorage2[0],
+    savePosition = _useLocalStorage2[1];
+  var savePositionRef = useRefValue(savePosition);
+  var _useState = useState(savedPosition !== null && savedPosition !== void 0 ? savedPosition : undefined),
+    _useState2 = _slicedToArray(_useState, 2),
+    position = _useState2[0],
+    setPosition = _useState2[1];
+  var draggingRef = useRef(false);
+  var dragOffsetRef = useRef({
+    x: 0,
+    y: 0
+  });
+  var sizeRef = useRef({
+    w: 0,
+    h: 0
+  });
+
+  // Drag start (exclude interactive controls)
+  var handlePointerDown = useRefFunction(function (e) {
+    var _position$left, _position$top;
+    var target = e.target;
+    // Set the selector for elements that do not trigger dragging
+    if (ignoreSelectors && target.closest(ignoreSelectors.join(','))) return;
+    if (!containerRef.current) return;
+    var rect = containerRef.current.getBoundingClientRect();
+    sizeRef.current = {
+      w: rect.width,
+      h: rect.height
+    };
+    var currentLeft = (_position$left = position === null || position === void 0 ? void 0 : position.left) !== null && _position$left !== void 0 ? _position$left : rect.left;
+    var currentTop = (_position$top = position === null || position === void 0 ? void 0 : position.top) !== null && _position$top !== void 0 ? _position$top : rect.top;
+    dragOffsetRef.current = {
+      x: e.clientX - currentLeft,
+      y: e.clientY - currentTop
+    };
+    draggingRef.current = true;
+    try {
+      var _containerRef$current, _containerRef$current2;
+      (_containerRef$current = (_containerRef$current2 = containerRef.current).setPointerCapture) === null || _containerRef$current === void 0 || _containerRef$current.call(_containerRef$current2, e.pointerId);
+    } catch (_unused) {
+      // do nothing
+    }
+    e.preventDefault();
+  });
+
+  // Adjust position when window size changes
+  useEffect(function () {
+    if (!position) return;
+    var maxLeft = Math.max(0, window.innerWidth - sizeRef.current.w);
+    var maxTop = Math.max(0, window.innerHeight - sizeRef.current.h);
+    var clampedLeft = Math.min(Math.max(0, position.left), maxLeft);
+    var clampedTop = Math.min(Math.max(0, position.top), maxTop);
+    if (clampedLeft !== position.left || clampedTop !== position.top) {
+      var pos = {
+        left: clampedLeft,
+        top: clampedTop
+      };
+      setPosition(pos);
+      if (storageKeyRef.current) {
+        savePositionRef.current(pos);
+      }
+    }
+  }, [position]);
+
+  // Update position during dragging; restrict within the visible area.
+  useEffect(function () {
+    var onMove = function onMove(e) {
+      if (!draggingRef.current) return;
+      var newLeft = e.clientX - dragOffsetRef.current.x;
+      var newTop = e.clientY - dragOffsetRef.current.y;
+      var maxLeft = Math.max(0, window.innerWidth - sizeRef.current.w);
+      var maxTop = Math.max(0, window.innerHeight - sizeRef.current.h);
+      var clampedLeft = Math.min(Math.max(0, newLeft), maxLeft);
+      var clampedTop = Math.min(Math.max(0, newTop), maxTop);
+      var pos = {
+        left: clampedLeft,
+        top: clampedTop
+      };
+      setPosition(pos);
+      if (storageKeyRef.current) {
+        savePositionRef.current(pos);
+      }
+    };
+    var onUp = function onUp() {
+      if (draggingRef.current) draggingRef.current = false;
+    };
+    if (enabled) {
+      window.addEventListener('pointermove', onMove);
+      window.addEventListener('pointerup', onUp);
+      window.addEventListener('pointercancel', onUp);
+    }
+    return function () {
+      window.removeEventListener('pointermove', onMove);
+      window.removeEventListener('pointerup', onUp);
+      window.removeEventListener('pointercancel', onUp);
+    };
+  }, [enabled]);
+  return {
+    onPointerDown: handlePointerDown,
+    position: position
+  };
+};
+export default useMovable;
+//# sourceMappingURL=useMovable.js.map

package/es/hooks/useMovable.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","useState","useLocalStorage","useRefFunction","useRefValue","useMovable","props","enabled","containerRef","ignoreSelectors","storageKey","storageKeyRef","_useLocalStorage","_useLocalStorage2","_slicedToArray","savedPosition","savePosition","savePositionRef","_useState","undefined","_useState2","position","setPosition","draggingRef","dragOffsetRef","x","y","sizeRef","w","h","handlePointerDown","e","_position$left","_position$top","target","closest","join","current","rect","getBoundingClientRect","width","height","currentLeft","left","currentTop","top","clientX","clientY","_containerRef$current","_containerRef$current2","setPointerCapture","call","pointerId","_unused","preventDefault","maxLeft","Math","max","window","innerWidth","maxTop","innerHeight","clampedLeft","min","clampedTop","pos","onMove","newLeft","newTop","onUp","addEventListener","removeEventListener","onPointerDown"],"sources":["../../src/hooks/useMovable.ts"],"sourcesContent":["import { type RefObject, useEffect, useRef, useState } from 'react';\nimport { useLocalStorage } from 'react-use';\nimport useRefFunction from './useRefFunction';\nimport useRefValue from './useRefValue';\n\nexport interface UseMovableProps {\n  /**\n   * - **EN:** Whether dragging is enabled, default is `true`\n   * - **CN:** 是否启用拖动，默认`true`\n   */\n  enabled?: boolean;\n  /**\n   * - **EN:** The ref of the container element\n   * - **CN:** 容器元素的ref\n   */\n  containerRef: RefObject<HTMLElement>;\n  /**\n   * - **EN:** Selectors of elements that should not trigger dragging, e.g., interactive controls\n   * - **CN:** 不应触发拖动的元素的选择器，例如交互控件\n   */\n  ignoreSelectors?: string[];\n  /**\n   * - **EN:** Key for storing position in localStorage; if not provided, position won't be saved\n   * - **CN:** 用于在 localStorage 中存储位置的键；如果未提供，则不会保存位置\n   */\n  storageKey?: string;\n}\n\n/**\n * - **EN:** Hook to make an element movable by dragging, with position persistence using localStorage\n * - **CN:** 通过拖动使元素可移动的钩子，并使用 localStorage 持久化位置\n */\nconst useMovable = (props: UseMovableProps) => {\n  const { enabled, containerRef, ignoreSelectors, storageKey } = props;\n\n  const storageKeyRef = useRefValue(storageKey);\n  const [savedPosition, savePosition] = useLocalStorage<MovePosition>(storageKey ?? '');\n  const savePositionRef = useRefValue(savePosition);\n  const [position, setPosition] = useState<MovePosition | undefined>(savedPosition ?? undefined);\n  const draggingRef = useRef(false);\n  const dragOffsetRef = useRef({ x: 0, y: 0 });\n  const sizeRef = useRef({ w: 0, h: 0 });\n\n  // Drag start (exclude interactive controls)\n  const handlePointerDown = useRefFunction((e: React.PointerEvent<HTMLDivElement>) => {\n    const target = e.target as HTMLElement;\n    // Set the selector for elements that do not trigger dragging\n    if (ignoreSelectors && target.closest(ignoreSelectors.join(','))) return;\n\n    if (!containerRef.current) return;\n    const rect = containerRef.current.getBoundingClientRect();\n    sizeRef.current = { w: rect.width, h: rect.height };\n    const currentLeft = position?.left ?? rect.left;\n    const currentTop = position?.top ?? rect.top;\n\n    dragOffsetRef.current = { x: e.clientX - currentLeft, y: e.clientY - currentTop };\n    draggingRef.current = true;\n    try {\n      containerRef.current.setPointerCapture?.(e.pointerId);\n    } catch {\n      // do nothing\n    }\n    e.preventDefault();\n  });\n\n  // Adjust position when window size changes\n  useEffect(() => {\n    if (!position) return;\n    const maxLeft = Math.max(0, window.innerWidth - sizeRef.current.w);\n    const maxTop = Math.max(0, window.innerHeight - sizeRef.current.h);\n    const clampedLeft = Math.min(Math.max(0, position.left), maxLeft);\n    const clampedTop = Math.min(Math.max(0, position.top), maxTop);\n    if (clampedLeft !== position.left || clampedTop !== position.top) {\n      const pos = { left: clampedLeft, top: clampedTop };\n      setPosition(pos);\n      if (storageKeyRef.current) {\n        savePositionRef.current(pos);\n      }\n    }\n  }, [position]);\n\n  // Update position during dragging; restrict within the visible area.\n  useEffect(() => {\n    const onMove = (e: PointerEvent) => {\n      if (!draggingRef.current) return;\n      const newLeft = e.clientX - dragOffsetRef.current.x;\n      const newTop = e.clientY - dragOffsetRef.current.y;\n      const maxLeft = Math.max(0, window.innerWidth - sizeRef.current.w);\n      const maxTop = Math.max(0, window.innerHeight - sizeRef.current.h);\n      const clampedLeft = Math.min(Math.max(0, newLeft), maxLeft);\n      const clampedTop = Math.min(Math.max(0, newTop), maxTop);\n      const pos = { left: clampedLeft, top: clampedTop };\n      setPosition(pos);\n      if (storageKeyRef.current) {\n        savePositionRef.current(pos);\n      }\n    };\n    const onUp = () => {\n      if (draggingRef.current) draggingRef.current = false;\n    };\n    if (enabled) {\n      window.addEventListener('pointermove', onMove);\n      window.addEventListener('pointerup', onUp);\n      window.addEventListener('pointercancel', onUp);\n    }\n    return () => {\n      window.removeEventListener('pointermove', onMove);\n      window.removeEventListener('pointerup', onUp);\n      window.removeEventListener('pointercancel', onUp);\n    };\n  }, [enabled]);\n\n  return {\n    onPointerDown: handlePointerDown,\n    position,\n  };\n};\n\nexport interface MovePosition {\n  left: number;\n  top: number;\n}\n\nexport default useMovable;\n"],"mappings":"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"}

package/es/hooks/useProcessingText.d.ts

@@ -0,0 +1,38 @@
+export interface UseProcessingTextProps {
+    /**
+     * - **EN:** Whether the animation is enabled, default is `true`
+     * - **CN:** 是否启用，默认`true`
+     */
+    enabled?: boolean;
+    /**
+     * - **EN:** Prefix text (e.g., "Processing"), default is `""`
+     * - **CN:** 前缀文本（例如 "处理中"），默认`""`
+     */
+    prefixText?: string;
+    /**
+     * - **EN:** Dot text (e.g., "."), default is `"."`
+     * - **CN:** 点文本（例如 "."），默认`"."`
+     */
+    dotText?: string;
+    /**
+     * - **EN:** Animation interval (milliseconds), default is `300`
+     * - **CN:** 动画间隔（毫秒），默认`300`
+     */
+    interval?: number;
+    /**
+     * - **EN:** Maximum number of dots, default is `3`
+     * - **CN:** 最大点数，默认`3`
+     */
+    maxDots?: number;
+}
+/**
+ * - **EN:** Hook to create a processing text animation (e.g., "Processing.", "Processing..",
+ *   "Processing...")
+ * - **CN:** 创建处理文本动画的钩子（例如 "处理中."、"处理中.."、"处理中..."）
+ *
+ * @param props Configuration options
+ *
+ * @returns Animated processing text
+ */
+declare function useProcessingText(props?: UseProcessingTextProps): string;
+export default useProcessingText;

package/es/hooks/useProcessingText.js

@@ -0,0 +1,57 @@
+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; }
+import { useEffect, useRef, useState } from 'react';
+/**
+ * - **EN:** Hook to create a processing text animation (e.g., "Processing.", "Processing..",
+ *   "Processing...")
+ * - **CN:** 创建处理文本动画的钩子（例如 "处理中."、"处理中.."、"处理中..."）
+ *
+ * @param props Configuration options
+ *
+ * @returns Animated processing text
+ */
+function useProcessingText(props) {
+  var _ref = props || {},
+    _ref$enabled = _ref.enabled,
+    enabled = _ref$enabled === void 0 ? true : _ref$enabled,
+    _ref$prefixText = _ref.prefixText,
+    prefixText = _ref$prefixText === void 0 ? '' : _ref$prefixText,
+    _ref$dotText = _ref.dotText,
+    dotText = _ref$dotText === void 0 ? '.' : _ref$dotText,
+    _ref$interval = _ref.interval,
+    interval = _ref$interval === void 0 ? 300 : _ref$interval,
+    _ref$maxDots = _ref.maxDots,
+    maxDots = _ref$maxDots === void 0 ? 3 : _ref$maxDots;
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    dots = _useState2[0],
+    setDots = _useState2[1];
+  var timerRef = useRef(0);
+  useEffect(function () {
+    if (enabled) {
+      timerRef.current = window.setInterval(function () {
+        setDots(function (prev) {
+          return (prev + 1) % (maxDots + 1);
+        });
+      }, interval);
+    } else {
+      setDots(0);
+      if (timerRef.current) {
+        clearInterval(timerRef.current);
+      }
+    }
+    return function () {
+      if (timerRef.current) {
+        clearInterval(timerRef.current);
+      }
+    };
+  }, [enabled, interval, maxDots]);
+  var text = prefixText + dotText.repeat(dots);
+  return text;
+}
+export default useProcessingText;
+//# sourceMappingURL=useProcessingText.js.map

package/es/hooks/useProcessingText.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","useState","useProcessingText","props","_ref","_ref$enabled","enabled","_ref$prefixText","prefixText","_ref$dotText","dotText","_ref$interval","interval","_ref$maxDots","maxDots","_useState","_useState2","_slicedToArray","dots","setDots","timerRef","current","window","setInterval","prev","clearInterval","text","repeat"],"sources":["../../src/hooks/useProcessingText.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nexport interface UseProcessingTextProps {\n  /**\n   * - **EN:** Whether the animation is enabled, default is `true`\n   * - **CN:** 是否启用，默认`true`\n   */\n  enabled?: boolean;\n  /**\n   * - **EN:** Prefix text (e.g., \"Processing\"), default is `\"\"`\n   * - **CN:** 前缀文本（例如 \"处理中\"），默认`\"\"`\n   */\n  prefixText?: string;\n  /**\n   * - **EN:** Dot text (e.g., \".\"), default is `\".\"`\n   * - **CN:** 点文本（例如 \".\"），默认`\".\"`\n   */\n  dotText?: string;\n  /**\n   * - **EN:** Animation interval (milliseconds), default is `300`\n   * - **CN:** 动画间隔（毫秒），默认`300`\n   */\n  interval?: number;\n  /**\n   * - **EN:** Maximum number of dots, default is `3`\n   * - **CN:** 最大点数，默认`3`\n   */\n  maxDots?: number;\n}\n/**\n * - **EN:** Hook to create a processing text animation (e.g., \"Processing.\", \"Processing..\",\n *   \"Processing...\")\n * - **CN:** 创建处理文本动画的钩子（例如 \"处理中.\"、\"处理中..\"、\"处理中...\"）\n *\n * @param props Configuration options\n *\n * @returns Animated processing text\n */\nfunction useProcessingText(props?: UseProcessingTextProps) {\n  const { enabled = true, prefixText = '', dotText = '.', interval = 300, maxDots = 3 } = props || {};\n  const [dots, setDots] = useState(0);\n  const timerRef = useRef(0);\n\n  useEffect(() => {\n    if (enabled) {\n      timerRef.current = window.setInterval(() => {\n        setDots((prev) => (prev + 1) % (maxDots + 1));\n      }, interval);\n    } else {\n      setDots(0);\n      if (timerRef.current) {\n        clearInterval(timerRef.current);\n      }\n    }\n    return () => {\n      if (timerRef.current) {\n        clearInterval(timerRef.current);\n      }\n    };\n  }, [enabled, interval, maxDots]);\n\n  const text = prefixText + dotText.repeat(dots);\n  return text;\n}\n\nexport default useProcessingText;\n"],"mappings":";;;;;;AAAA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AA6BnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACC,KAA8B,EAAE;EACzD,IAAAC,IAAA,GAAwFD,KAAK,IAAI,CAAC,CAAC;IAAAE,YAAA,GAAAD,IAAA,CAA3FE,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,IAAI,GAAAA,YAAA;IAAAE,eAAA,GAAAH,IAAA,CAAEI,UAAU;IAAVA,UAAU,GAAAD,eAAA,cAAG,EAAE,GAAAA,eAAA;IAAAE,YAAA,GAAAL,IAAA,CAAEM,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,GAAG,GAAAA,YAAA;IAAAE,aAAA,GAAAP,IAAA,CAAEQ,QAAQ;IAARA,QAAQ,GAAAD,aAAA,cAAG,GAAG,GAAAA,aAAA;IAAAE,YAAA,GAAAT,IAAA,CAAEU,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,CAAC,GAAAA,YAAA;EACnF,IAAAE,SAAA,GAAwBd,QAAQ,CAAC,CAAC,CAAC;IAAAe,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAA5BG,IAAI,GAAAF,UAAA;IAAEG,OAAO,GAAAH,UAAA;EACpB,IAAMI,QAAQ,GAAGpB,MAAM,CAAC,CAAC,CAAC;EAE1BD,SAAS,CAAC,YAAM;IACd,IAAIO,OAAO,EAAE;MACXc,QAAQ,CAACC,OAAO,GAAGC,MAAM,CAACC,WAAW,CAAC,YAAM;QAC1CJ,OAAO,CAAC,UAACK,IAAI;UAAA,OAAK,CAACA,IAAI,GAAG,CAAC,KAAKV,OAAO,GAAG,CAAC,CAAC;QAAA,EAAC;MAC/C,CAAC,EAAEF,QAAQ,CAAC;IACd,CAAC,MAAM;MACLO,OAAO,CAAC,CAAC,CAAC;MACV,IAAIC,QAAQ,CAACC,OAAO,EAAE;QACpBI,aAAa,CAACL,QAAQ,CAACC,OAAO,CAAC;MACjC;IACF;IACA,OAAO,YAAM;MACX,IAAID,QAAQ,CAACC,OAAO,EAAE;QACpBI,aAAa,CAACL,QAAQ,CAACC,OAAO,CAAC;MACjC;IACF,CAAC;EACH,CAAC,EAAE,CAACf,OAAO,EAAEM,QAAQ,EAAEE,OAAO,CAAC,CAAC;EAEhC,IAAMY,IAAI,GAAGlB,UAAU,GAAGE,OAAO,CAACiB,MAAM,CAACT,IAAI,CAAC;EAC9C,OAAOQ,IAAI;AACb;AAEA,eAAexB,iBAAiB"}

package/es/utils/base64.d.ts

@@ -45,4 +45,10 @@ export declare function arrayBufferToBase64(buf: ArrayBuffer): string;
  *
  * @returns The decoded ArrayBuffer | 解码后的 ArrayBuffer
  */
-export declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+export declare function base64ToArrayBuffer(base64: string, opts?: {
+    /**
+     * - EN: Use URL-safe Base64 if true (replace -_ back to +/ and restore padding)
+     * - CN: 为 true 时按 URL 安全 Base64 进行规范化（将 -_ 还原为 +/ 并补齐 =）
+     */
+    urlSafe?: boolean;
+}): ArrayBuffer;

package/es/utils/base64.js

@@ -124,16 +124,37 @@ export function arrayBufferToBase64(buf) {
  * @returns The decoded ArrayBuffer | 解码后的 ArrayBuffer
  */
 export function base64ToArrayBuffer(base64) {
-  if (typeof Buffer !== 'undefined') {
-    var buffer = Buffer.from(base64, 'base64');
-    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+  var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _opts$urlSafe3 = opts.urlSafe,
+    urlSafe = _opts$urlSafe3 === void 0 ? false : _opts$urlSafe3;
+  if (base64 == null || base64 === '') return new ArrayBuffer(0);
+
+  // Normalize to standard Base64 (align with base64ToString)
+  var normalized = base64;
+  if (urlSafe) {
+    normalized = normalized.replace(/-/g, '+').replace(/_/g, '/');
   }
-  var binaryString = atob(base64);
-  var len = binaryString.length;
-  var bytes = new Uint8Array(len);
-  for (var i = 0; i < len; i++) {
-    bytes[i] = binaryString.charCodeAt(i);
+  var padNeeded = normalized.length % 4;
+  if (padNeeded === 2) normalized += '==';else if (padNeeded === 3) normalized += '=';else if (padNeeded === 1) {
+    throw new Error('Invalid Base64 string length');
+  }
+  try {
+    if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {
+      // Node.js / environments with Buffer
+      var buf = Buffer.from(normalized, 'base64');
+      return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+    } else {
+      // Browser
+      var binary = atob(normalized);
+      var len = binary.length;
+      var bytes = new Uint8Array(len);
+      for (var i = 0; i < len; i++) {
+        bytes[i] = binary.charCodeAt(i);
+      }
+      return bytes.buffer;
+    }
+  } catch (e) {
+    throw new Error('Failed to decode Base64: ' + (e instanceof Error ? e.message : String(e)));
   }
-  return bytes.buffer;
 }
 //# sourceMappingURL=base64.js.map

package/es/utils/base64.js.map

@@ -1 +1 @@
-{"version":3,"names":["stringToBase64","content","opts","arguments","length","undefined","_opts$urlSafe","urlSafe","base64","hasBuffer","Buffer","from","toString","encoder","TextEncoder","bytes","encode","binary","_iterator","_createForOfIteratorHelper","_step","s","n","done","i","value","String","fromCharCode","err","e","f","btoa","replace","base64ToString","_opts$urlSafe2","normalized","padNeeded","Error","atob","len","Uint8Array","charCodeAt","decoder","TextDecoder","decode","message","arrayBufferToBase64","buf","chunk","apply","_toConsumableArray","subarray","padding","repeat","base64ToArrayBuffer","buffer","slice","byteOffset","byteLength","binaryString"],"sources":["../../src/utils/base64.ts"],"sourcesContent":["/**\n * - **EN:** Encode a UTF-8 string into Base64 (standard or URL-safe).\n * - **CN:** 将 UTF-8 字符串编码为 Base64（标准或 URL 安全格式）。\n *\n * @param content Input text to encode | 要编码的输入文本\n *\n * @returns Base64 encoded string | Base64 编码后的字符串\n */\nexport function stringToBase64(\n  content: string,\n  opts: {\n    /**\n     * - **EN:** Use URL-safe Base64 if true (replace +/ with -_ and strip =)\n     * - **CN:** 为 true 时使用 URL 安全 Base64（将 +/ 替换为 -_ 并去掉 =）\n     */\n    urlSafe?: boolean;\n  } = {}\n): string {\n  const { urlSafe = false } = opts;\n  if (content == null || content === '') return '';\n\n  let base64: string;\n  const hasBuffer = typeof Buffer !== 'undefined' && typeof Buffer.from === 'function';\n  if (hasBuffer) {\n    // Node.js\n    base64 = Buffer.from(content, 'utf8').toString('base64');\n  } else {\n    // Browser\n    const encoder = new TextEncoder();\n    const bytes = encoder.encode(content);\n    let binary = '';\n    for (const i of bytes) {\n      binary += String.fromCharCode(i);\n    }\n    base64 = btoa(binary);\n  }\n\n  if (urlSafe) {\n    // Replace chars and strip padding for URL-safe variant\n    base64 = base64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/u, '');\n  }\n  return base64;\n}\n\n/**\n * - EN: Decode a Base64 (standard or URL-safe) string into UTF-8 text.\n * - CN: 将（标准或 URL 安全）Base64 字符串解码为 UTF-8 文本。\n *\n * @param content Base64 encoded string | Base64 编码字符串\n *\n * @returns Decoded UTF-8 string | 解码后的 UTF-8 字符串\n */\nexport function base64ToString(\n  content: string,\n  opts: {\n    /**\n     * - **EN:** Use URL-safe Base64 if true (replace +/ with -_ and strip =)\n     * - **CN:** 为 true 时使用 URL 安全 Base64（将 +/ 替换为 -_ 并去掉 =）\n     */\n    urlSafe?: boolean;\n  } = {}\n): string {\n  const { urlSafe = false } = opts;\n  if (content == null || content === '') return '';\n\n  let normalized = content;\n  if (urlSafe) {\n    normalized = normalized.replace(/-/g, '+').replace(/_/g, '/');\n  }\n  // Restore padding if stripped\n  const padNeeded = normalized.length % 4;\n  if (padNeeded === 2) normalized += '==';\n  else if (padNeeded === 3) normalized += '=';\n  else if (padNeeded === 1) {\n    throw new Error('Invalid Base64 string length');\n  }\n\n  const hasBuffer = typeof Buffer !== 'undefined' && typeof Buffer.from === 'function';\n  try {\n    if (hasBuffer) {\n      return Buffer.from(normalized, 'base64').toString('utf8');\n    } else {\n      const binary = atob(normalized);\n      const len = binary.length;\n      const bytes = new Uint8Array(len);\n      for (let i = 0; i < len; i++) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      const decoder = new TextDecoder();\n      return decoder.decode(bytes);\n    }\n  } catch (e) {\n    throw new Error('Failed to decode Base64: ' + (e instanceof Error ? e.message : String(e)));\n  }\n}\n\n/**\n * - **EN:** Convert an ArrayBuffer to a Base64 encoded string.\n * - **CN:** 将 ArrayBuffer 转换为 Base64 编码的字符串。\n *\n * @param buf The ArrayBuffer to convert | 要转换的 ArrayBuffer\n *\n * @returns The Base64 encoded string | Base64 编码的字符串\n */\nexport function arrayBufferToBase64(buf: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(buf).toString('base64');\n  }\n  const bytes = new Uint8Array(buf);\n  const chunk = 0x8000;\n  let binary = '';\n  for (let i = 0; i < bytes.length; i += chunk) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));\n  }\n  let base64 = btoa(binary);\n  // Add padding for Base64\n  const padding = (4 - (base64.length % 4)) % 4;\n  if (padding) base64 += '='.repeat(padding);\n  return base64;\n}\n\n/**\n * - **EN:** Decode a Base64 (standard or URL-safe) string into an ArrayBuffer.\n * - **CN:** 将（标准或 URL 安全）Base64 字符串解码为 ArrayBuffer。\n *\n * @param base64 The Base64 encoded string | Base64 编码的字符串\n *\n * @returns The decoded ArrayBuffer | 解码后的 ArrayBuffer\n */\nexport function base64ToArrayBuffer(base64: string): ArrayBuffer {\n  if (typeof Buffer !== 'undefined') {\n    const buffer = Buffer.from(base64, 'base64');\n    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);\n  }\n  const binaryString = atob(base64);\n  const len = binaryString.length;\n  const bytes = new Uint8Array(len);\n  for (let i = 0; i < len; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n  return bytes.buffer;\n}\n"],"mappings":"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"}
+{"version":3,"names":["stringToBase64","content","opts","arguments","length","undefined","_opts$urlSafe","urlSafe","base64","hasBuffer","Buffer","from","toString","encoder","TextEncoder","bytes","encode","binary","_iterator","_createForOfIteratorHelper","_step","s","n","done","i","value","String","fromCharCode","err","e","f","btoa","replace","base64ToString","_opts$urlSafe2","normalized","padNeeded","Error","atob","len","Uint8Array","charCodeAt","decoder","TextDecoder","decode","message","arrayBufferToBase64","buf","chunk","apply","_toConsumableArray","subarray","padding","repeat","base64ToArrayBuffer","_opts$urlSafe3","ArrayBuffer","buffer","slice","byteOffset","byteLength"],"sources":["../../src/utils/base64.ts"],"sourcesContent":["/**\n * - **EN:** Encode a UTF-8 string into Base64 (standard or URL-safe).\n * - **CN:** 将 UTF-8 字符串编码为 Base64（标准或 URL 安全格式）。\n *\n * @param content Input text to encode | 要编码的输入文本\n *\n * @returns Base64 encoded string | Base64 编码后的字符串\n */\nexport function stringToBase64(\n  content: string,\n  opts: {\n    /**\n     * - **EN:** Use URL-safe Base64 if true (replace +/ with -_ and strip =)\n     * - **CN:** 为 true 时使用 URL 安全 Base64（将 +/ 替换为 -_ 并去掉 =）\n     */\n    urlSafe?: boolean;\n  } = {}\n): string {\n  const { urlSafe = false } = opts;\n  if (content == null || content === '') return '';\n\n  let base64: string;\n  const hasBuffer = typeof Buffer !== 'undefined' && typeof Buffer.from === 'function';\n  if (hasBuffer) {\n    // Node.js\n    base64 = Buffer.from(content, 'utf8').toString('base64');\n  } else {\n    // Browser\n    const encoder = new TextEncoder();\n    const bytes = encoder.encode(content);\n    let binary = '';\n    for (const i of bytes) {\n      binary += String.fromCharCode(i);\n    }\n    base64 = btoa(binary);\n  }\n\n  if (urlSafe) {\n    // Replace chars and strip padding for URL-safe variant\n    base64 = base64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/u, '');\n  }\n  return base64;\n}\n\n/**\n * - EN: Decode a Base64 (standard or URL-safe) string into UTF-8 text.\n * - CN: 将（标准或 URL 安全）Base64 字符串解码为 UTF-8 文本。\n *\n * @param content Base64 encoded string | Base64 编码字符串\n *\n * @returns Decoded UTF-8 string | 解码后的 UTF-8 字符串\n */\nexport function base64ToString(\n  content: string,\n  opts: {\n    /**\n     * - **EN:** Use URL-safe Base64 if true (replace +/ with -_ and strip =)\n     * - **CN:** 为 true 时使用 URL 安全 Base64（将 +/ 替换为 -_ 并去掉 =）\n     */\n    urlSafe?: boolean;\n  } = {}\n): string {\n  const { urlSafe = false } = opts;\n  if (content == null || content === '') return '';\n\n  let normalized = content;\n  if (urlSafe) {\n    normalized = normalized.replace(/-/g, '+').replace(/_/g, '/');\n  }\n  // Restore padding if stripped\n  const padNeeded = normalized.length % 4;\n  if (padNeeded === 2) normalized += '==';\n  else if (padNeeded === 3) normalized += '=';\n  else if (padNeeded === 1) {\n    throw new Error('Invalid Base64 string length');\n  }\n\n  const hasBuffer = typeof Buffer !== 'undefined' && typeof Buffer.from === 'function';\n  try {\n    if (hasBuffer) {\n      return Buffer.from(normalized, 'base64').toString('utf8');\n    } else {\n      const binary = atob(normalized);\n      const len = binary.length;\n      const bytes = new Uint8Array(len);\n      for (let i = 0; i < len; i++) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      const decoder = new TextDecoder();\n      return decoder.decode(bytes);\n    }\n  } catch (e) {\n    throw new Error('Failed to decode Base64: ' + (e instanceof Error ? e.message : String(e)));\n  }\n}\n\n/**\n * - **EN:** Convert an ArrayBuffer to a Base64 encoded string.\n * - **CN:** 将 ArrayBuffer 转换为 Base64 编码的字符串。\n *\n * @param buf The ArrayBuffer to convert | 要转换的 ArrayBuffer\n *\n * @returns The Base64 encoded string | Base64 编码的字符串\n */\nexport function arrayBufferToBase64(buf: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(buf).toString('base64');\n  }\n  const bytes = new Uint8Array(buf);\n  const chunk = 0x8000;\n  let binary = '';\n  for (let i = 0; i < bytes.length; i += chunk) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));\n  }\n  let base64 = btoa(binary);\n  // Add padding for Base64\n  const padding = (4 - (base64.length % 4)) % 4;\n  if (padding) base64 += '='.repeat(padding);\n  return base64;\n}\n\n/**\n * - **EN:** Decode a Base64 (standard or URL-safe) string into an ArrayBuffer.\n * - **CN:** 将（标准或 URL 安全）Base64 字符串解码为 ArrayBuffer。\n *\n * @param base64 The Base64 encoded string | Base64 编码的字符串\n *\n * @returns The decoded ArrayBuffer | 解码后的 ArrayBuffer\n */\nexport function base64ToArrayBuffer(\n  base64: string,\n  opts: {\n    /**\n     * - EN: Use URL-safe Base64 if true (replace -_ back to +/ and restore padding)\n     * - CN: 为 true 时按 URL 安全 Base64 进行规范化（将 -_ 还原为 +/ 并补齐 =）\n     */\n    urlSafe?: boolean;\n  } = {}\n): ArrayBuffer {\n  const { urlSafe = false } = opts;\n  if (base64 == null || base64 === '') return new ArrayBuffer(0);\n\n  // Normalize to standard Base64 (align with base64ToString)\n  let normalized = base64;\n  if (urlSafe) {\n    normalized = normalized.replace(/-/g, '+').replace(/_/g, '/');\n  }\n  const padNeeded = normalized.length % 4;\n  if (padNeeded === 2) normalized += '==';\n  else if (padNeeded === 3) normalized += '=';\n  else if (padNeeded === 1) {\n    throw new Error('Invalid Base64 string length');\n  }\n\n  try {\n    if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n      // Node.js / environments with Buffer\n      const buf = Buffer.from(normalized, 'base64');\n      return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);\n    } else {\n      // Browser\n      const binary = atob(normalized);\n      const len = binary.length;\n      const bytes = new Uint8Array(len);\n      for (let i = 0; i < len; i++) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      return bytes.buffer;\n    }\n  } catch (e) {\n    throw new Error('Failed to decode Base64: ' + (e instanceof Error ? e.message : String(e)));\n  }\n}\n"],"mappings":"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"}

package/lib/components/Animation/Pulse/index.d.ts

@@ -0,0 +1,52 @@
+import type { CSSProperties, FC } from 'react';
+export interface PulseAnimationProps {
+    className?: string;
+    style?: CSSProperties;
+    barStyle?: CSSProperties;
+    prefixCls?: string;
+    /**
+     * - **EN:** Number of bars, default is `24`
+     * - **CN:** 心跳柱子数量，默认`24`
+     */
+    bars?: number;
+    /**
+     * - **EN:** Gap between bars, default is `4px`
+     * - **CN:** 心跳柱子间隙，默认`4px`
+     */
+    barGap?: CSSProperties['gap'];
+    /**
+     * - **EN:** Background color of the bars, default is theme's `colorFillSecondary`
+     * - **CN:** 心跳柱子背景色，默认主题的 `colorFillSecondary`
+     */
+    barColor?: CSSProperties['backgroundColor'];
+    /**
+     * - **EN:** Minimum height of the bar, default is `10%`
+     * - **CN:** 心跳柱子最小高度，默认`10%`
+     */
+    /**
+     * - **EN:** Maximum height of the bar, default is `90%`
+     * - **CN:** 心跳柱子最大高度，默认`90%`
+     */
+    /**
+     * - **EN:** Animation duration in seconds, default is `1.6` seconds
+     * - **CN:** 动画持续时间，单位秒，默认`1.6`秒
+     */
+    duration?: number;
+    /**
+     * - **EN:** Animation delay rate, the delay between bars is calculated based on `{bars *
+     *   delayRate}`, default is `0.09`
+     * - **CN:** 动画延迟的百分比，根据 `{bars * delayRate}` 计算柱子之间的延迟，默认 `0.09`
+     */
+    delayRate?: number;
+}
+/**
+ * - **EN:** Pulse animation component, used to indicate loading or processing state
+ *
+ * > Use `token.AnimationPulse` to globally configure `barMinSize` and `barMaxSize` properties
+ *
+ * - **CN:** 脉动动画组件，用于表示加载或处理状态
+ *
+ * > 使用 `token.AnimationPulse` 来全局配置 `barMinSize` 和 `barMaxSize` 属性
+ */
+export declare const PulseAnimation: FC<PulseAnimationProps>;
+export default PulseAnimation;

package/lib/components/Animation/Pulse/index.js

@@ -0,0 +1,88 @@
+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/Animation/Pulse/index.tsx
+var Pulse_exports = {};
+__export(Pulse_exports, {
+  PulseAnimation: () => PulseAnimation,
+  default: () => Pulse_default
+});
+module.exports = __toCommonJS(Pulse_exports);
+var import_react = require("react");
+var import_antd = require("antd");
+var import_classnames = __toESM(require("classnames"));
+var import_style = __toESM(require("./style"));
+var PulseAnimation = (props) => {
+  const {
+    bars = 8,
+    barGap,
+    barColor,
+    duration,
+    delayRate = 0.09,
+    prefixCls: prefixClsInProps,
+    className,
+    style,
+    barStyle
+  } = props;
+  const { getPrefixCls } = (0, import_react.useContext)(import_antd.ConfigProvider.ConfigContext);
+  const prefixCls = getPrefixCls("animation-pulse", prefixClsInProps);
+  const [wrapCSSVar, hashId, cssVarCls] = (0, import_style.default)(prefixCls);
+  const array = (0, import_react.useMemo)(() => Array.from({ length: bars }), [bars]);
+  return wrapCSSVar(
+    /* @__PURE__ */ React.createElement(
+      "div",
+      {
+        className: (0, import_classnames.default)(prefixCls, hashId, cssVarCls, className),
+        style: {
+          gridTemplateColumns: `repeat(${array.length}, 1fr)`,
+          gap: barGap,
+          ...style
+        }
+      },
+      array.map((_, i) => /* @__PURE__ */ React.createElement(
+        "div",
+        {
+          key: i,
+          className: `${prefixCls}-bar`,
+          style: {
+            animationDuration: duration != null ? `${duration}s` : void 0,
+            animationDelay: `${i % array.length * delayRate}s`,
+            backgroundColor: barColor != null ? barColor : void 0,
+            ...barStyle
+          }
+        }
+      ))
+    )
+  );
+};
+var Pulse_default = PulseAnimation;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PulseAnimation
+});
+//# sourceMappingURL=index.js.map

package/lib/components/Animation/Pulse/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/Animation/Pulse/index.tsx"],
+  "sourcesContent": ["import type { CSSProperties, FC } from 'react';\nimport { useContext, useMemo } from 'react';\nimport { ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport useStyle from './style';\n\nexport interface PulseAnimationProps {\n  className?: string;\n  style?: CSSProperties;\n  barStyle?: CSSProperties;\n  prefixCls?: string;\n  /**\n   * - **EN:** Number of bars, default is `24`\n   * - **CN:** 心跳柱子数量，默认`24`\n   */\n\n  bars?: number;\n  /**\n   * - **EN:** Gap between bars, default is `4px`\n   * - **CN:** 心跳柱子间隙，默认`4px`\n   */\n  barGap?: CSSProperties['gap'];\n  /**\n   * - **EN:** Background color of the bars, default is theme's `colorFillSecondary`\n   * - **CN:** 心跳柱子背景色，默认主题的 `colorFillSecondary`\n   */\n  barColor?: CSSProperties['backgroundColor'];\n  /**\n   * - **EN:** Minimum height of the bar, default is `10%`\n   * - **CN:** 心跳柱子最小高度，默认`10%`\n   */\n  // barMinSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Maximum height of the bar, default is `90%`\n   * - **CN:** 心跳柱子最大高度，默认`90%`\n   */\n  // barMaxSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Animation duration in seconds, default is `1.6` seconds\n   * - **CN:** 动画持续时间，单位秒，默认`1.6`秒\n   */\n  duration?: number;\n  /**\n   * - **EN:** Animation delay rate, the delay between bars is calculated based on `{bars *\n   *   delayRate}`, default is `0.09`\n   * - **CN:** 动画延迟的百分比，根据 `{bars * delayRate}` 计算柱子之间的延迟，默认 `0.09`\n   */\n  delayRate?: number;\n}\n\n/**\n * - **EN:** Pulse animation component, used to indicate loading or processing state\n *\n * > Use `token.AnimationPulse` to globally configure `barMinSize` and `barMaxSize` properties\n *\n * - **CN:** 脉动动画组件，用于表示加载或处理状态\n *\n * > 使用 `token.AnimationPulse` 来全局配置 `barMinSize` 和 `barMaxSize` 属性\n */\nexport const PulseAnimation: FC<PulseAnimationProps> = (props) => {\n  const {\n    bars = 8,\n    barGap,\n    barColor,\n    duration,\n    delayRate = 0.09,\n    prefixCls: prefixClsInProps,\n    className,\n    style,\n    barStyle,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('animation-pulse', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const array = useMemo(() => Array.from({ length: bars }), [bars]);\n\n  return wrapCSSVar(\n    <div\n      className={classNames(prefixCls, hashId, cssVarCls, className)}\n      style={{\n        gridTemplateColumns: `repeat(${array.length}, 1fr)`,\n        gap: barGap,\n        ...style,\n      }}\n    >\n      {array.map((_, i) => (\n        <div\n          // eslint-disable-next-line react/no-array-index-key\n          key={i}\n          className={`${prefixCls}-bar`}\n          style={{\n            animationDuration: duration != null ? `${duration}s` : undefined,\n            animationDelay: `${(i % array.length) * delayRate}s`,\n            backgroundColor: barColor != null ? barColor : undefined,\n            ...barStyle,\n          }}\n        />\n      ))}\n    </div>\n  );\n};\n\nexport default PulseAnimation;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAoC;AACpC,kBAA+B;AAC/B,wBAAuB;AACvB,mBAAqB;AAuDd,IAAM,iBAA0C,CAAC,UAAU;AAChE,QAAM;AAAA,IACJ,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,EAAE,aAAa,QAAI,yBAAW,2BAAe,aAAa;AAChE,QAAM,YAAY,aAAa,mBAAmB,gBAAgB;AAClE,QAAM,CAAC,YAAY,QAAQ,SAAS,QAAI,aAAAA,SAAS,SAAS;AAC1D,QAAM,YAAQ,sBAAQ,MAAM,MAAM,KAAK,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AAEhE,SAAO;AAAA,IACL;AAAA,MAAC;AAAA;AAAA,QACC,eAAW,kBAAAC,SAAW,WAAW,QAAQ,WAAW,SAAS;AAAA,QAC7D,OAAO;AAAA,UACL,qBAAqB,UAAU,MAAM;AAAA,UACrC,KAAK;AAAA,UACL,GAAG;AAAA,QACL;AAAA;AAAA,MAEC,MAAM,IAAI,CAAC,GAAG,MACb;AAAA,QAAC;AAAA;AAAA,UAEC,KAAK;AAAA,UACL,WAAW,GAAG;AAAA,UACd,OAAO;AAAA,YACL,mBAAmB,YAAY,OAAO,GAAG,cAAc;AAAA,YACvD,gBAAgB,GAAI,IAAI,MAAM,SAAU;AAAA,YACxC,iBAAiB,YAAY,OAAO,WAAW;AAAA,YAC/C,GAAG;AAAA,UACL;AAAA;AAAA,MACF,CACD;AAAA,IACH;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;",
+  "names": ["useStyle", "classNames"]
+}

package/lib/components/Animation/Pulse/style/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+declare const _default: (prefixCls: string, rootCls?: string | undefined) => readonly [(node: import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>, string, string];
+export default _default;

package/lib/components/Animation/Pulse/style/index.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/Animation/Pulse/style/index.ts
+var style_exports = {};
+__export(style_exports, {
+  default: () => style_default
+});
+module.exports = __toCommonJS(style_exports);
+var import_internal = require("antd/es/theme/internal");
+var genStyle = (token) => {
+  var _a, _b, _c;
+  const { componentCls } = token;
+  const componentClsNoPrefix = componentCls.replace(/^\./, "");
+  return {
+    [componentCls]: {
+      display: "grid",
+      alignItems: "end",
+      width: "100%",
+      height: "100%",
+      inset: 0,
+      gap: 4,
+      [`${componentCls}-bar`]: {
+        width: "100%",
+        background: token.colorFillSecondary,
+        borderRadius: 4,
+        opacity: 0.85,
+        animation: `${componentClsNoPrefix} 1.6s ease-in-out infinite`,
+        transformOrigin: "bottom"
+      },
+      [`@keyframes ${componentClsNoPrefix}`]: {
+        "0%": { height: ((_a = token.AnimationPulse) == null ? void 0 : _a.barMinSize) ?? "10%" },
+        "50%": { height: ((_b = token.AnimationPulse) == null ? void 0 : _b.barMaxSize) ?? "90%" },
+        "100%": { height: ((_c = token.AnimationPulse) == null ? void 0 : _c.barMinSize) ?? "10%" }
+      }
+    }
+  };
+};
+var style_default = (0, import_internal.genStyleHooks)("AnimationPulse", genStyle);
+//# sourceMappingURL=index.js.map

package/lib/components/Animation/Pulse/style/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/components/Animation/Pulse/style/index.ts"],
+  "sourcesContent": ["import { genStyleHooks } from 'antd/es/theme/internal';\nimport type { AliasToken, GenerateStyle } from 'antd/es/theme/internal';\nimport type { CSSObject } from '@ant-design/cssinjs';\nimport type { FullToken } from '@ant-design/cssinjs-utils';\n\ntype PulseToken = FullToken<\n  {\n    AnimationPulse?: {\n      barMinSize?: string | number;\n      barMaxSize?: string | number;\n    };\n  },\n  AliasToken,\n  'AnimationPulse'\n>;\n\nconst genStyle: GenerateStyle<PulseToken> = (token): CSSObject => {\n  const { componentCls } = token;\n  const componentClsNoPrefix = componentCls.replace(/^\\./, '');\n  return {\n    [componentCls]: {\n      display: 'grid',\n      alignItems: 'end',\n      width: '100%',\n      height: '100%',\n      inset: 0,\n      gap: 4,\n\n      [`${componentCls}-bar`]: {\n        width: '100%',\n        background: token.colorFillSecondary,\n        borderRadius: 4,\n        opacity: 0.85,\n        animation: `${componentClsNoPrefix} 1.6s ease-in-out infinite`,\n        transformOrigin: 'bottom',\n      },\n\n      [`@keyframes ${componentClsNoPrefix}`]: {\n        '0%': { height: token.AnimationPulse?.barMinSize ?? '10%' },\n        '50%': { height: token.AnimationPulse?.barMaxSize ?? '90%' },\n        '100%': { height: token.AnimationPulse?.barMinSize ?? '10%' },\n      },\n    },\n  };\n};\n\nexport default genStyleHooks('AnimationPulse' as never, genStyle);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAA8B;AAgB9B,IAAM,WAAsC,CAAC,UAAqB;AAhBlE;AAiBE,QAAM,EAAE,aAAa,IAAI;AACzB,QAAM,uBAAuB,aAAa,QAAQ,OAAO,EAAE;AAC3D,SAAO;AAAA,IACL,CAAC,YAAY,GAAG;AAAA,MACd,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,KAAK;AAAA,MAEL,CAAC,GAAG,kBAAkB,GAAG;AAAA,QACvB,OAAO;AAAA,QACP,YAAY,MAAM;AAAA,QAClB,cAAc;AAAA,QACd,SAAS;AAAA,QACT,WAAW,GAAG;AAAA,QACd,iBAAiB;AAAA,MACnB;AAAA,MAEA,CAAC,cAAc,sBAAsB,GAAG;AAAA,QACtC,MAAM,EAAE,UAAQ,WAAM,mBAAN,mBAAsB,eAAc,MAAM;AAAA,QAC1D,OAAO,EAAE,UAAQ,WAAM,mBAAN,mBAAsB,eAAc,MAAM;AAAA,QAC3D,QAAQ,EAAE,UAAQ,WAAM,mBAAN,mBAAsB,eAAc,MAAM;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,oBAAQ,+BAAc,kBAA2B,QAAQ;",
+  "names": []
+}