@ant-design/agentic-ui 2.8.0 → 2.9.0

package/dist/History/utils/index.js

@@ -1,35 +1,38 @@
-// src/History/utils/index.ts
 import dayjs from "dayjs";
-var formatTime = (time) => {
-  var _a, _b;
-  if (!time) {
-    return "";
-  }
-  if (dayjs().isSame(dayjs(time), "day")) {
-    return "今日";
-  }
-  if (dayjs().isSame(dayjs(time).add(1, "day"), "day")) {
-    return "昨日";
-  }
-  if (dayjs().isSame(dayjs(time).add(7, "day"), "day")) {
-    return "一周内";
-  }
-  return (_b = (_a = dayjs(time)) == null ? void 0 : _a.fromNow) == null ? void 0 : _b.call(_a);
+/**
+ * 格式化时间显示
+ * @param time 时间戳或时间字符串
+ * @returns 格式化后的时间字符串
+ */ export var formatTime = function(time) {
+    var _dayjs_fromNow, _dayjs;
+    if (!time) {
+        return '';
+    }
+    // 如果是今天
+    if (dayjs().isSame(dayjs(time), 'day')) {
+        return '今日';
+    }
+    if (dayjs().isSame(dayjs(time).add(1, 'day'), 'day')) {
+        return '昨日';
+    }
+    if (dayjs().isSame(dayjs(time).add(7, 'day'), 'day')) {
+        return '一周内';
+    }
+    //@ts-ignore 如果是昨天
+    return (_dayjs = dayjs(time)) === null || _dayjs === void 0 ? void 0 : (_dayjs_fromNow = _dayjs.fromNow) === null || _dayjs_fromNow === void 0 ? void 0 : _dayjs_fromNow.call(_dayjs);
 };
-var groupByCategory = (list, getCategoryKey) => {
-  return list.reduce(
-    (prev, curr) => {
-      const group = getCategoryKey(curr);
-      if (!prev[group]) {
-        prev[group] = [];
-      }
-      prev[group].push(curr);
-      return prev;
-    },
-    {}
-  );
-};
-export {
-  formatTime,
-  groupByCategory
+/**
+ * 按指定键对数组进行分组
+ * @param list 要分组的数组
+ * @param getCategoryKey 分组键的获取函数
+ * @returns 分组后的对象
+ */ export var groupByCategory = function(list, getCategoryKey) {
+    return list.reduce(function(prev, curr) {
+        var group = getCategoryKey(curr);
+        if (!prev[group]) {
+            prev[group] = [];
+        }
+        prev[group].push(curr);
+        return prev;
+    }, {});
 };

package/dist/Hooks/useAutoScroll.js

@@ -1,90 +1,268 @@
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
+function _array_like_to_array(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 _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
     };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, g, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
     };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
-
-// src/Hooks/useAutoScroll.tsx
+    return g = {
+        next: verb(0),
+        "throw": verb(1),
+        "return": verb(2)
+    }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(_)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
 import { useEffect, useRef } from "react";
 import { useThrottleFn } from "./useThrottleFn";
-var SCROLL_TOLERANCE = 20;
-var useAutoScroll = (props = {
-  SCROLL_TOLERANCE
-}) => {
-  const containerRef = useRef(null);
-  const lastScrollHeight = useRef(0);
-  const isLocked = useRef(false);
-  const observer = useRef(null);
-  const _checkScroll = (force = false) => __async(void 0, null, function* () {
-    var _a, _b;
-    const container = containerRef.current;
-    if (!container)
-      return;
-    (_a = props.onResize) == null ? void 0 : _a.call(props, {
-      width: container.clientWidth,
-      height: container.clientHeight
-    });
-    const currentScrollHeight = container.scrollHeight;
-    const prevScrollHeight = lastScrollHeight.current;
-    const isNearBottom = container.scrollTop + container.clientHeight >= prevScrollHeight - ((props == null ? void 0 : props.SCROLL_TOLERANCE) || SCROLL_TOLERANCE);
-    const shouldScroll = force || currentScrollHeight > prevScrollHeight && (isNearBottom || isLocked.current);
-    if (shouldScroll && container.scrollTo) {
-      (_b = container.scrollTo) == null ? void 0 : _b.call(container, {
-        top: currentScrollHeight,
-        behavior: "smooth"
-      });
-      isLocked.current = false;
-    }
-    lastScrollHeight.current = currentScrollHeight;
-  });
-  const checkScroll = useThrottleFn(_checkScroll, props.timeout || 160);
-  useEffect(() => {
-    const container = containerRef.current;
-    if (!container)
-      return;
-    observer.current = new MutationObserver((mutations) => {
-      const hasAddedNodes = mutations.some((m) => m.addedNodes.length > 0);
-      if (hasAddedNodes)
-        checkScroll == null ? void 0 : checkScroll();
-    });
-    observer.current.observe(container, {
-      childList: true,
-      // 监听子元素变化
-      subtree: true,
-      // 监听所有后代
-      attributes: false,
-      characterData: false
-    });
-    return () => {
-      var _a;
-      return (_a = observer.current) == null ? void 0 : _a.disconnect();
+var SCROLL_TOLERANCE = 20; // 滚动到底部的容差阈值
+/**
+ * useAutoScroll Hook - 自动滚动 Hook
+ *
+ * 该 Hook 提供自动滚动功能，当容器内容增加时自动滚动到底部。
+ * 支持用户滚动锁定检测、DOM 变化监听、手动滚动等功能。
+ *
+ * @description 自动滚动 Hook，提供智能滚动到底部功能
+ * @template T - HTMLDivElement 类型
+ * @param {Object} props - Hook 配置参数
+ * @param {number} [props.SCROLL_TOLERANCE=20] - 滚动到底部的容差阈值
+ * @param {(size: {width: number, height: number}) => void} [props.onResize] - 容器尺寸变化回调
+ * @param {any[]} [props.deps] - 依赖数组，用于重新初始化 MutationObserver
+ * @param {number} [props.timeout=160] - 节流时间间隔（毫秒）
+ *
+ * @example
+ * ```tsx
+ * const { containerRef, scrollToBottom } = useAutoScroll({
+ *   SCROLL_TOLERANCE: 30,
+ *   onResize: () => {},
+ *   timeout: 200
+ * });
+ *
+ * @returns {Object} Hook 返回值
+ * @returns {React.RefObject<T>} returns.containerRef - 容器引用
+ * @returns {() => void} returns.scrollToBottom - 手动滚动到底部方法
+ *
+ * @remarks
+ * - 自动检测内容变化并滚动到底部
+ * - 支持用户滚动锁定检测
+ * - 使用 MutationObserver 监听 DOM 变化
+ * - 提供节流功能避免频繁滚动
+ * - 支持手动触发滚动
+ * - 智能判断是否应该自动滚动
+ * - 提供容器尺寸变化回调
+ */ export var useAutoScroll = function() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {
+        SCROLL_TOLERANCE: SCROLL_TOLERANCE
+    };
+    var containerRef = useRef(null);
+    var lastScrollHeight = useRef(0);
+    var isLocked = useRef(false); // 用户滚动锁定状态
+    var observer = useRef(null);
+    // 主滚动逻辑
+    var _checkScroll = /*#__PURE__*/ function() {
+        var _ref = _async_to_generator(function() {
+            var force, _props_onResize, container, currentScrollHeight, prevScrollHeight, isNearBottom, shouldScroll, _container_scrollTo;
+            var _arguments = arguments;
+            return _ts_generator(this, function(_state) {
+                force = _arguments.length > 0 && _arguments[0] !== void 0 ? _arguments[0] : false;
+                container = containerRef.current;
+                if (!container) return [
+                    2
+                ];
+                (_props_onResize = props.onResize) === null || _props_onResize === void 0 ? void 0 : _props_onResize.call(props, {
+                    width: container.clientWidth,
+                    height: container.clientHeight
+                });
+                currentScrollHeight = container.scrollHeight;
+                prevScrollHeight = lastScrollHeight.current;
+                // 计算用户是否在底部区域
+                isNearBottom = container.scrollTop + container.clientHeight >= prevScrollHeight - ((props === null || props === void 0 ? void 0 : props.SCROLL_TOLERANCE) || SCROLL_TOLERANCE);
+                // 触发滚动的情况：
+                // 1. 强制滚动（手动触发）
+                // 2. 内容高度增加且用户原本在底部
+                shouldScroll = force || currentScrollHeight > prevScrollHeight && (isNearBottom || isLocked.current);
+                if (shouldScroll && container.scrollTo) {
+                    ;
+                    (_container_scrollTo = container.scrollTo) === null || _container_scrollTo === void 0 ? void 0 : _container_scrollTo.call(container, {
+                        top: currentScrollHeight,
+                        behavior: 'smooth'
+                    });
+                    isLocked.current = false; // 滚动后解除锁定
+                }
+                lastScrollHeight.current = currentScrollHeight;
+                return [
+                    2
+                ];
+            });
+        });
+        return function _checkScroll() {
+            return _ref.apply(this, arguments);
+        };
+    }();
+    var checkScroll = useThrottleFn(_checkScroll, props.timeout || 160);
+    // DOM 变化监听（MutationObserver）
+    useEffect(function() {
+        var container = containerRef.current;
+        if (!container) return;
+        observer.current = new MutationObserver(function(mutations) {
+            // 过滤出添加节点的变化
+            var hasAddedNodes = mutations.some(function(m) {
+                return m.addedNodes.length > 0;
+            });
+            if (hasAddedNodes) checkScroll === null || checkScroll === void 0 ? void 0 : checkScroll();
+        });
+        observer.current.observe(container, {
+            childList: true,
+            subtree: true,
+            attributes: false,
+            characterData: false
+        });
+        return function() {
+            var _observer_current;
+            return (_observer_current = observer.current) === null || _observer_current === void 0 ? void 0 : _observer_current.disconnect();
+        };
+    }, _to_consumable_array(props.deps || []));
+    // 暴露手动滚动方法
+    var scrollToBottom = function() {
+        checkScroll === null || checkScroll === void 0 ? void 0 : checkScroll(true);
+    };
+    return {
+        containerRef: containerRef,
+        scrollToBottom: scrollToBottom
     };
-  }, [...props.deps || []]);
-  const scrollToBottom = () => {
-    checkScroll == null ? void 0 : checkScroll(true);
-  };
-  return {
-    containerRef,
-    scrollToBottom
-  };
-};
-var useAutoScroll_default = useAutoScroll;
-export {
-  useAutoScroll_default as default,
-  useAutoScroll
 };
+export default useAutoScroll;

package/dist/Hooks/useClickAway.js

@@ -1,23 +1,62 @@
-// src/Hooks/useClickAway.ts
 import { useEffect } from "react";
-var EVENT = "mousedown";
-var useClickAway = (callback, ref) => {
-  useEffect(() => {
-    const listener = (event) => {
-      var _a;
-      if (!ref || !ref.current || ref.current.contains(event.target) || ((_a = ref.current.parentNode) == null ? void 0 : _a.contains(event.target))) {
-        return;
-      }
-      callback(event);
-    };
-    document.addEventListener(EVENT, listener);
-    return () => {
-      document.removeEventListener(EVENT, listener);
-    };
-  }, [ref, callback]);
-};
-var useClickAway_default = useClickAway;
-export {
-  useClickAway_default as default,
-  useClickAway
+var EVENT = 'mousedown';
+/**
+ * useClickAway Hook - 点击外部区域检测 Hook
+ *
+ * 该 Hook 用于检测用户是否点击了指定元素外部的区域，常用于实现下拉菜单、
+ * 弹出层等组件的自动关闭功能。
+ *
+ * @description 点击外部区域检测 Hook，用于实现组件外部点击关闭功能
+ * @param {Function} callback - 点击外部区域时的回调函数
+ * @param {React.RefObject<HTMLDivElement>} ref - 被监听的元素引用
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLDivElement>(null);
+ *
+ * useClickAway(() => {
+ *   console.log('点击了外部区域');
+ *   setOpen(false);
+ * }, ref);
+ *
+ * return (
+ *   <div ref={ref}>
+ *     <button onClick={() => setOpen(true)}>打开菜单</button>
+ *     {open && <div>菜单内容</div>}
+ *   </div>
+ * );
+ * ```
+ *
+ * @remarks
+ * - 自动监听全局 mousedown 事件
+ * - 智能判断点击目标是否在指定元素内部
+ * - 支持父节点包含检测
+ * - 组件卸载时自动清理事件监听
+ * - 适用于下拉菜单、弹出层等场景
+ */ export var useClickAway = function(callback, ref) {
+    useEffect(function() {
+        /**
+     * 鼠标点击事件的监听函数
+     *
+     * @param event - 鼠标点击事件对象
+     */ var listener = function(event) {
+            var _ref_current_parentNode;
+            // 如果ref为null或ref.current为null，或者ref.current包含事件目标元素，则不做任何操作
+            if (!ref || !ref.current || ref.current.contains(event.target) || ((_ref_current_parentNode = ref.current.parentNode) === null || _ref_current_parentNode === void 0 ? void 0 : _ref_current_parentNode.contains(event.target))) {
+                return;
+            }
+            // 执行回调函数，并传递事件对象
+            callback(event);
+        };
+        // 监听全局鼠标点击事件，并执行listener函数
+        document.addEventListener(EVENT, listener);
+        // 在组件卸载时，移除鼠标点击事件监听
+        return function() {
+            document.removeEventListener(EVENT, listener);
+        };
+    }, [
+        ref,
+        callback
+    ]);
 };
+export default useClickAway;

package/dist/Hooks/useCopied.js

@@ -1,22 +1,74 @@
-// src/Hooks/useCopied.ts
+function _array_like_to_array(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 _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    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 _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
 import { useCallback, useEffect, useMemo, useState } from "react";
-var useCopied = () => {
-  const [copied, setCopy] = useState(false);
-  useEffect(() => {
-    if (!copied)
-      return;
-    const timer = setTimeout(() => {
-      setCopy(false);
-    }, 1e3);
-    return () => {
-      if (typeof clearTimeout !== "undefined") {
-        clearTimeout(timer);
-      }
-    };
-  }, [copied]);
-  const setCopied = useCallback(() => setCopy(true), []);
-  return useMemo(() => ({ copied, setCopied }), [copied]);
-};
-export {
-  useCopied
+export var useCopied = function() {
+    var _useState = _sliced_to_array(useState(false), 2), copied = _useState[0], setCopy = _useState[1];
+    useEffect(function() {
+        if (!copied) return;
+        var timer = setTimeout(function() {
+            setCopy(false);
+        }, 1000);
+        return function() {
+            if (typeof clearTimeout !== 'undefined') {
+                clearTimeout(timer);
+            }
+        };
+    }, [
+        copied
+    ]);
+    var setCopied = useCallback(function() {
+        return setCopy(true);
+    }, []);
+    return useMemo(function() {
+        return {
+            copied: copied,
+            setCopied: setCopied
+        };
+    }, [
+        copied
+    ]);
 };