@ant-design/agentic-ui 2.8.0 → 2.10.0

package/dist/Hooks/useRefFunction/index.js

@@ -1,13 +1,78 @@
-// src/Hooks/useRefFunction/index.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_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+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);
+}
 import { useCallback, useRef } from "react";
-var useRefFunction = (reFunction) => {
-  const ref = useRef(null);
-  ref.current = reFunction;
-  return useCallback((...rest) => {
-    var _a;
-    return (_a = ref.current) == null ? void 0 : _a.call(ref, ...rest);
-  }, []);
-};
-export {
-  useRefFunction
+/**
+ * useRefFunction Hook - 函数引用 Hook
+ *
+ * 该 Hook 用于创建一个稳定的函数引用，避免因为函数重新创建导致的子组件不必要的重新渲染。
+ * 通过 useRef 保存最新的函数引用，同时使用 useCallback 返回稳定的函数。
+ *
+ * @description 函数引用 Hook，用于创建稳定的函数引用避免子组件重新渲染
+ * @template T - 函数类型
+ * @param {T} reFunction - 需要创建引用的函数
+ * @returns {T} 稳定的函数引用
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const [count, setCount] = useState(0);
+ *
+ *   // 使用 useRefFunction 创建稳定的函数引用
+ *   const handleClick = useRefFunction((value: number) => {
+ *     console.log('点击了:', value);
+ *     setCount(count + value);
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <p>计数: {count}</p>
+ *       <ChildComponent onClick={handleClick} />
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @remarks
+ * - 避免函数重新创建导致的子组件重新渲染
+ * - 保持函数引用的稳定性
+ * - 适用于需要传递给子组件的回调函数
+ * - 使用 useRef 保存最新函数引用
+ * - 使用 useCallback 返回稳定函数
+ */ var useRefFunction = function(reFunction) {
+    var ref = useRef(null);
+    ref.current = reFunction;
+    return useCallback(function() {
+        for(var _len = arguments.length, rest = new Array(_len), _key = 0; _key < _len; _key++){
+            rest[_key] = arguments[_key];
+        }
+        var _ref_current;
+        var _ref_current1;
+        return (_ref_current1 = ref.current) === null || _ref_current1 === void 0 ? void 0 : (_ref_current = _ref_current1).call.apply(_ref_current, [
+            ref
+        ].concat(_to_consumable_array(rest)));
+    }, []);
 };
+export { useRefFunction };

package/dist/Hooks/useSpeechSynthesis.js

@@ -1,108 +1,152 @@
-// src/Hooks/useSpeechSynthesis.ts
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-var useSpeechSynthesis = (options) => {
-  const { text, defaultRate = 1 } = options;
-  const isSupported = useMemo(
-    () => typeof window !== "undefined" && !!window.speechSynthesis,
-    []
-  );
-  const [rate, setRate] = useState(defaultRate);
-  const [isPlaying, setIsPlaying] = useState(false);
-  const utterRef = useRef(null);
-  const stop = useCallback(() => {
-    if (!isSupported)
-      return;
+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 {
-      if (utterRef.current) {
-        utterRef.current.onend = null;
-        utterRef.current.onerror = null;
-      }
-      window.speechSynthesis.cancel();
-    } catch (e) {
+        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;
+        }
     }
-    utterRef.current = null;
-    setIsPlaying(false);
-  }, [isSupported]);
-  const start = useCallback(() => {
-    if (!isSupported)
-      return;
-    if (!text)
-      return;
-    try {
-      if (utterRef.current) {
-        utterRef.current.onend = null;
-        utterRef.current.onerror = null;
-      }
-      window.speechSynthesis.cancel();
-      const utter = new SpeechSynthesisUtterance(text);
-      utter.rate = rate;
-      utterRef.current = utter;
-      utter.onend = () => {
-        setIsPlaying(false);
+    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, useRef, useState } from "react";
+export var useSpeechSynthesis = function(options) {
+    var text = options.text, _options_defaultRate = options.defaultRate, defaultRate = _options_defaultRate === void 0 ? 1 : _options_defaultRate;
+    var isSupported = useMemo(function() {
+        return typeof window !== 'undefined' && !!window.speechSynthesis;
+    }, []);
+    var _useState = _sliced_to_array(useState(defaultRate), 2), rate = _useState[0], setRate = _useState[1];
+    var _useState1 = _sliced_to_array(useState(false), 2), isPlaying = _useState1[0], setIsPlaying = _useState1[1];
+    var utterRef = useRef(null);
+    var stop = useCallback(function() {
+        if (!isSupported) return;
+        try {
+            if (utterRef.current) {
+                utterRef.current.onend = null;
+                utterRef.current.onerror = null;
+            }
+            window.speechSynthesis.cancel();
+        } catch (e) {}
         utterRef.current = null;
-      };
-      utter.onerror = () => {
         setIsPlaying(false);
-        utterRef.current = null;
-      };
-      window.speechSynthesis.speak(utter);
-      setIsPlaying(true);
-    } catch (e) {
-      setIsPlaying(false);
-    }
-  }, [isSupported, text, rate]);
-  const pause = useCallback(() => {
-    if (!isSupported)
-      return;
-    try {
-      window.speechSynthesis.pause();
-    } catch (e) {
-    }
-  }, [isSupported]);
-  const resume = useCallback(() => {
-    if (!isSupported)
-      return;
-    try {
-      window.speechSynthesis.resume();
-    } catch (e) {
-    }
-  }, [isSupported]);
-  useEffect(() => {
-    if (!isSupported)
-      return;
-    if (!isPlaying)
-      return;
-    start();
-  }, [rate]);
-  useEffect(() => {
-    if (!isSupported)
-      return;
-    return () => {
-      if (utterRef.current) {
+    }, [
+        isSupported
+    ]);
+    var start = useCallback(function() {
+        if (!isSupported) return;
+        if (!text) return;
         try {
-          utterRef.current.onend = null;
-          utterRef.current.onerror = null;
-          window.speechSynthesis.cancel();
+            if (utterRef.current) {
+                utterRef.current.onend = null;
+                utterRef.current.onerror = null;
+            }
+            window.speechSynthesis.cancel();
+            var utter = new SpeechSynthesisUtterance(text);
+            utter.rate = rate;
+            utterRef.current = utter;
+            utter.onend = function() {
+                setIsPlaying(false);
+                utterRef.current = null;
+            };
+            utter.onerror = function() {
+                setIsPlaying(false);
+                utterRef.current = null;
+            };
+            window.speechSynthesis.speak(utter);
+            setIsPlaying(true);
         } catch (e) {
+            setIsPlaying(false);
         }
-        utterRef.current = null;
-      }
-      setIsPlaying(false);
+    }, [
+        isSupported,
+        text,
+        rate
+    ]);
+    var pause = useCallback(function() {
+        if (!isSupported) return;
+        try {
+            window.speechSynthesis.pause();
+        } catch (e) {}
+    }, [
+        isSupported
+    ]);
+    var resume = useCallback(function() {
+        if (!isSupported) return;
+        try {
+            window.speechSynthesis.resume();
+        } catch (e) {}
+    }, [
+        isSupported
+    ]);
+    // 变更倍速：若正在播报，重启使之生效
+    useEffect(function() {
+        if (!isSupported) return;
+        if (!isPlaying) return;
+        start();
+    }, [
+        rate
+    ]);
+    // 卸载时清理（不触发 onStop）
+    useEffect(function() {
+        if (!isSupported) return;
+        return function() {
+            if (utterRef.current) {
+                try {
+                    utterRef.current.onend = null;
+                    utterRef.current.onerror = null;
+                    window.speechSynthesis.cancel();
+                } catch (e) {}
+                utterRef.current = null;
+            }
+            setIsPlaying(false);
+        };
+    }, [
+        isSupported
+    ]);
+    return {
+        isSupported: isSupported,
+        isPlaying: isPlaying,
+        rate: rate,
+        setRate: setRate,
+        start: start,
+        stop: stop,
+        pause: pause,
+        resume: resume
     };
-  }, [isSupported]);
-  return {
-    isSupported,
-    isPlaying,
-    rate,
-    setRate,
-    start,
-    stop,
-    pause,
-    resume
-  };
-};
-var useSpeechSynthesis_default = useSpeechSynthesis;
-export {
-  useSpeechSynthesis_default as default,
-  useSpeechSynthesis
 };
+export default useSpeechSynthesis;

package/dist/Hooks/useStyle/index.js

@@ -1,64 +1,99 @@
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
     }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-
-// src/Hooks/useStyle/index.tsx
-import {
-  createStyleRegister,
-  globalThemeToken
-} from "@ant-design/theme-token";
-import { ConfigProvider as AntdConfigProvider, theme as antdTheme } from "antd";
-import { useContext } from "react";
-var resetComponent = (token) => ({
-  [`${token.componentCls}`]: {
-    boxSizing: "border-box",
-    margin: 0,
-    padding: 0,
-    color: token.colorText,
-    fontSize: "1em",
-    lineHeight: token.lineHeight,
-    listStyle: "none",
-    "svg.sofa-icons-icon > g": {
-      clipPath: "none!important"
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
     }
-  }
-});
-function useEditorStyleRegister(componentName, styleFn) {
-  var _a, _b;
-  const { token, hashId, theme } = ((_b = (_a = antdTheme) == null ? void 0 : _a.useToken) == null ? void 0 : _b.call(_a)) || {};
-  const chatToken = __spreadProps(__spreadValues({}, token), {
-    chatCls: "",
-    antCls: ""
-  });
-  const { getPrefixCls } = useContext(AntdConfigProvider.ConfigContext);
-  chatToken.chatCls = `.${getPrefixCls("agentic-ui")}`;
-  chatToken.antCls = `.${getPrefixCls()}`;
-  const genStyles = createStyleRegister({
-    hashId: hashId || "",
-    token: chatToken,
-    theme,
-    cssVariables: globalThemeToken
-  });
-  const result = genStyles(componentName, styleFn);
-  return result || { wrapSSR: (node) => node, hashId: "" };
+    return keys;
 }
-export {
-  resetComponent,
-  useEditorStyleRegister
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+import { createStyleRegister, globalThemeToken } from "@ant-design/theme-token";
+import { ConfigProvider as AntdConfigProvider, theme as antdTheme } from "antd";
+import { useContext } from "react";
+export var resetComponent = function(token) {
+    return _define_property({}, "".concat(token.componentCls), {
+        boxSizing: 'border-box',
+        margin: 0,
+        padding: 0,
+        color: token.colorText,
+        fontSize: '1em',
+        lineHeight: token.lineHeight,
+        listStyle: 'none',
+        'svg.sofa-icons-icon > g': {
+            clipPath: 'none!important'
+        }
+    });
 };
+/**
+ * 封装了一下 antd 的 useStyle，支持了一下antd@4
+ * @param componentName {string} 组件的名字
+ * @param styleFn {GenerateStyle} 生成样式的函数
+ * @returns UseStyleResult
+ */ export function useEditorStyleRegister(componentName, styleFn) {
+    var _antdTheme_useToken;
+    var _ref = (antdTheme === null || antdTheme === void 0 ? void 0 : (_antdTheme_useToken = antdTheme.useToken) === null || _antdTheme_useToken === void 0 ? void 0 : _antdTheme_useToken.call(antdTheme)) || {}, token = _ref.token, hashId = _ref.hashId, theme = _ref.theme;
+    var chatToken = _object_spread_props(_object_spread({}, token), {
+        chatCls: '',
+        antCls: ''
+    });
+    var getPrefixCls = useContext(AntdConfigProvider.ConfigContext).getPrefixCls;
+    chatToken.chatCls = ".".concat(getPrefixCls('agentic-ui'));
+    chatToken.antCls = ".".concat(getPrefixCls());
+    var genStyles = createStyleRegister({
+        hashId: hashId || '',
+        token: chatToken,
+        theme: theme,
+        cssVariables: globalThemeToken
+    });
+    var result = genStyles(componentName, styleFn);
+    // 确保总是返回一个有效的对象
+    return result || {
+        wrapSSR: function(node) {
+            return node;
+        },
+        hashId: ''
+    };
+}

package/dist/Hooks/useThrottleFn/index.js

@@ -1,44 +1,44 @@
-// src/Hooks/useThrottleFn/index.ts
 import { useCallback, useEffect, useRef } from "react";
-function useThrottleFn(fn, interval = 100) {
-  const fnRef = useRef(fn);
-  const timeoutRef = useRef(null);
-  const lastArgsRef = useRef(null);
-  const lastThisRef = useRef(null);
-  const lastCallRef = useRef(0);
-  fnRef.current = fn;
-  const throttledFn = useCallback(
-    function(...args) {
-      const now = Date.now();
-      const remainingTime = interval - (now - lastCallRef.current);
-      lastArgsRef.current = args;
-      lastThisRef.current = this;
-      if (remainingTime <= 0) {
-        if (timeoutRef.current) {
-          clearTimeout(timeoutRef.current);
-          timeoutRef.current = null;
+export function useThrottleFn(fn) {
+    var interval = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 100;
+    var fnRef = useRef(fn);
+    var timeoutRef = useRef(null);
+    var lastArgsRef = useRef(null);
+    var lastThisRef = useRef(null);
+    var lastCallRef = useRef(0);
+    fnRef.current = fn;
+    var throttledFn = useCallback(function() {
+        for(var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++){
+            args[_key] = arguments[_key];
         }
-        lastCallRef.current = now;
-        fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
-      } else if (!timeoutRef.current) {
-        timeoutRef.current = setTimeout(() => {
-          lastCallRef.current = Date.now();
-          timeoutRef.current = null;
-          fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
-        }, remainingTime);
-      }
-    },
-    [interval]
-  );
-  useEffect(() => {
-    return () => {
-      if (timeoutRef.current) {
-        clearTimeout(timeoutRef.current);
-      }
-    };
-  }, []);
-  return throttledFn;
+        var now = Date.now();
+        var remainingTime = interval - (now - lastCallRef.current);
+        lastArgsRef.current = args;
+        lastThisRef.current = this;
+        if (remainingTime <= 0) {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+                timeoutRef.current = null;
+            }
+            lastCallRef.current = now;
+            fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
+        } else if (!timeoutRef.current) {
+            timeoutRef.current = setTimeout(function() {
+                lastCallRef.current = Date.now();
+                timeoutRef.current = null;
+                fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
+            }, remainingTime);
+        }
+    }, [
+        interval
+    ]);
+    // 清理超时
+    useEffect(function() {
+        return function() {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, []);
+    return throttledFn;
 }
-export {
-  useThrottleFn
-};