@ant-design/agentic-ui 2.8.0 → 2.9.0

package/dist/Hooks/useDebounceFn/index.js

@@ -1,59 +1,217 @@
-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/useDebounceFn/index.ts
+    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 { useCallback, useEffect, useRef } from "react";
 import { useRefFunction } from "../useRefFunction";
-function useDebounceFn(fn, wait) {
-  const callback = useRefFunction(fn);
-  const timer = useRef();
-  const cancel = useCallback(() => {
-    if (timer.current) {
-      clearTimeout(timer.current);
-      timer.current = null;
-    }
-  }, []);
-  const run = useCallback(
-    (...args) => __async(this, null, function* () {
-      if (wait === 0 || wait === void 0) {
-        return callback(...args);
-      }
-      cancel();
-      return new Promise((resolve) => {
-        timer.current = setTimeout(() => __async(this, null, function* () {
-          resolve(yield callback(...args));
-          return;
-        }), wait);
-      });
-    }),
-    [callback, cancel, wait]
-  );
-  useEffect(() => {
-    return cancel;
-  }, [cancel]);
-  return {
-    run,
-    cancel
-  };
-}
-export {
-  useDebounceFn
-};
+/**
+ * 一个去抖的 hook，传入一个 function，返回一个去抖后的 function
+ * @param  {(...args:T) => Promise<any>} fn
+ * @param  {number} wait?
+ */ export function useDebounceFn(fn, wait) {
+    var callback = useRefFunction(fn);
+    var timer = useRef();
+    var cancel = useCallback(function() {
+        if (timer.current) {
+            clearTimeout(timer.current);
+            timer.current = null;
+        }
+    }, []);
+    var run = useCallback(/*#__PURE__*/ _async_to_generator(function() {
+        var _len, args, _key;
+        var _arguments = arguments;
+        return _ts_generator(this, function(_state) {
+            for(_len = _arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++){
+                args[_key] = _arguments[_key];
+            }
+            if (wait === 0 || wait === undefined) {
+                return [
+                    2,
+                    callback.apply(void 0, _to_consumable_array(args))
+                ];
+            }
+            cancel();
+            return [
+                2,
+                new Promise(function(resolve) {
+                    timer.current = setTimeout(/*#__PURE__*/ _async_to_generator(function() {
+                        return _ts_generator(this, function(_state) {
+                            switch(_state.label){
+                                case 0:
+                                    return [
+                                        4,
+                                        callback.apply(void 0, _to_consumable_array(args))
+                                    ];
+                                case 1:
+                                    resolve.apply(void 0, [
+                                        _state.sent()
+                                    ]);
+                                    return [
+                                        2
+                                    ];
+                            }
+                        });
+                    }), wait);
+                })
+            ];
+        });
+    }), [
+        callback,
+        cancel,
+        wait
+    ]);
+    useEffect(function() {
+        return cancel;
+    }, [
+        cancel
+    ]);
+    return {
+        run: run,
+        cancel: cancel
+    };
+}

package/dist/Hooks/useIntersectionOnce.js

@@ -1,79 +1,168 @@
-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 _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 _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));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
+    return obj;
+}
+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 target;
-};
-
-// src/Hooks/useIntersectionOnce.ts
-import { useEffect, useRef, useState } from "react";
-var useIntersectionOnce = (targetRef, options = {}) => {
-  const _a = options, { root } = _a, restOptions = __objRest(_a, ["root"]);
-  const [isIntersecting, setIntersecting] = useState(false);
-  const observerRef = useRef(null);
-  useEffect(() => {
-    if (isIntersecting)
-      return;
-    const element = targetRef.current;
-    if (!element)
-      return;
-    if (typeof IntersectionObserver === "undefined") {
-      setIntersecting(true);
-      return;
+    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 _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]);
+        });
     }
-    const resolvedRoot = root && "current" in root ? root.current : root;
-    observerRef.current = new IntersectionObserver(
-      (entries) => {
-        entries.forEach((entry) => {
-          var _a2;
-          if (entry.isIntersecting || entry.intersectionRatio > 0) {
-            setIntersecting(true);
-            (_a2 = observerRef.current) == null ? void 0 : _a2.disconnect();
-          }
+    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);
+    }
+    return keys;
+}
+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));
         });
-      },
-      __spreadProps(__spreadValues({}, restOptions), { root: resolvedRoot != null ? resolvedRoot : null })
-    );
-    observerRef.current.observe(element);
-    return () => {
-      var _a2;
-      (_a2 = observerRef.current) == null ? void 0 : _a2.disconnect();
-      observerRef.current = null;
-    };
-  }, [
-    targetRef,
-    restOptions.rootMargin,
-    restOptions.threshold,
-    root,
-    isIntersecting
-  ]);
-  return isIntersecting;
-};
-export {
-  useIntersectionOnce
+    }
+    return target;
+}
+function _object_without_properties(source, excluded) {
+    if (source == null) return {};
+    var target = _object_without_properties_loose(source, excluded);
+    var key, i;
+    if (Object.getOwnPropertySymbols) {
+        var sourceSymbolKeys = Object.getOwnPropertySymbols(source);
+        for(i = 0; i < sourceSymbolKeys.length; i++){
+            key = sourceSymbolKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+    }
+    return target;
+}
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {};
+    var sourceKeys = Object.keys(source);
+    var key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+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 { useEffect, useRef, useState } from "react";
+export var useIntersectionOnce = function(targetRef) {
+    var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+    var root = options.root, restOptions = _object_without_properties(options, [
+        "root"
+    ]);
+    var _useState = _sliced_to_array(useState(false), 2), isIntersecting = _useState[0], setIntersecting = _useState[1];
+    var observerRef = useRef(null);
+    useEffect(function() {
+        if (isIntersecting) return;
+        var element = targetRef.current;
+        if (!element) return;
+        if (typeof IntersectionObserver === 'undefined') {
+            setIntersecting(true);
+            return;
+        }
+        var resolvedRoot = root && 'current' in root ? root.current : root;
+        observerRef.current = new IntersectionObserver(function(entries) {
+            entries.forEach(function(entry) {
+                if (entry.isIntersecting || entry.intersectionRatio > 0) {
+                    var _observerRef_current;
+                    setIntersecting(true);
+                    (_observerRef_current = observerRef.current) === null || _observerRef_current === void 0 ? void 0 : _observerRef_current.disconnect();
+                }
+            });
+        }, _object_spread_props(_object_spread({}, restOptions), {
+            root: resolvedRoot !== null && resolvedRoot !== void 0 ? resolvedRoot : null
+        }));
+        observerRef.current.observe(element);
+        return function() {
+            var _observerRef_current;
+            (_observerRef_current = observerRef.current) === null || _observerRef_current === void 0 ? void 0 : _observerRef_current.disconnect();
+            observerRef.current = null;
+        };
+    }, [
+        targetRef,
+        restOptions.rootMargin,
+        restOptions.threshold,
+        root,
+        isIntersecting
+    ]);
+    return isIntersecting;
 };

package/dist/Hooks/useLanguage.js

@@ -1,29 +1,70 @@
-// src/Hooks/useLanguage.ts
 import { useCallback, useContext } from "react";
 import { I18nContext } from "../I18n";
-function useLanguage() {
-  const context = useContext(I18nContext);
-  if (!context) {
-    throw new Error("useLanguage must be used within I18nProvide");
-  }
-  const { language, locale, setLanguage } = context;
-  const toggleLanguage = useCallback(() => {
-    const newLanguage = language === "zh-CN" ? "en-US" : "zh-CN";
-    setLanguage == null ? void 0 : setLanguage(newLanguage);
-  }, [language, setLanguage]);
-  const isChinese = language === "zh-CN";
-  const isEnglish = language === "en-US";
-  return {
-    language,
-    locale,
-    setLanguage,
-    toggleLanguage,
-    isChinese,
-    isEnglish
-  };
+/**
+ * useLanguage Hook - 语言切换 Hook
+ *
+ * 该 Hook 提供语言切换的便捷接口，包括当前语言状态、切换语言方法等。
+ * 自动与 Ant Design ConfigProvider 和浏览器语言设置同步。
+ *
+ * @description 语言切换 Hook，提供语言状态和切换方法
+ * @returns {Object} 语言相关的状态和方法
+ * @returns {string} returns.language - 当前语言 ('zh-CN' | 'en-US')
+ * @returns {Object} returns.locale - 当前语言的标签对象
+ * @returns {Function} returns.setLanguage - 切换语言的方法
+ * @returns {Function} returns.toggleLanguage - 切换中英文的方法
+ * @returns {boolean} returns.isChinese - 是否为中文
+ * @returns {boolean} returns.isEnglish - 是否为英文
+ *
+ * @example
+ * ```tsx
+ * const { language, locale, setLanguage, toggleLanguage, isChinese } = useLanguage();
+ *
+ * // 切换到英文
+ * setLanguage('en-US');
+ *
+ * // 切换中英文
+ * toggleLanguage();
+ *
+ * // 根据语言显示不同内容
+ * return (
+ *   <div>
+ *     {isChinese ? '中文内容' : 'English Content'}
+ *     <button onClick={toggleLanguage}>
+ *       {locale.switchLanguage}
+ *     </button>
+ *   </div>
+ * );
+ * ```
+ *
+ * @remarks
+ * - 必须在 I18nProvide 组件内部使用
+ * - 自动与 Ant Design ConfigProvider 同步
+ * - 支持 localStorage 持久化
+ * - 提供便捷的语言判断方法
+ */ export function useLanguage() {
+    var context = useContext(I18nContext);
+    if (!context) {
+        throw new Error('useLanguage must be used within I18nProvide');
+    }
+    var language = context.language, locale = context.locale, setLanguage = context.setLanguage;
+    // 切换中英文的方法
+    var toggleLanguage = useCallback(function() {
+        var newLanguage = language === 'zh-CN' ? 'en-US' : 'zh-CN';
+        setLanguage === null || setLanguage === void 0 ? void 0 : setLanguage(newLanguage);
+    }, [
+        language,
+        setLanguage
+    ]);
+    // 语言判断方法
+    var isChinese = language === 'zh-CN';
+    var isEnglish = language === 'en-US';
+    return {
+        language: language,
+        locale: locale,
+        setLanguage: setLanguage,
+        toggleLanguage: toggleLanguage,
+        isChinese: isChinese,
+        isEnglish: isEnglish
+    };
 }
-var useLanguage_default = useLanguage;
-export {
-  useLanguage_default as default,
-  useLanguage
-};
+export default useLanguage;