@ant-design/agentic-ui 2.8.0 → 2.9.0

package/dist/BackTo/BackTop.js

@@ -1,79 +1,159 @@
-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));
-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 _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;
-};
-
-// src/BackTo/BackTop.tsx
+    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));
+        });
+    }
+    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;
+}
 import React, { forwardRef } from "react";
 import scrollTo from "../Utils/scrollTo";
-import {
-  ScrollVisibleButton
-} from "./ScrollVisibleButton";
+import { ScrollVisibleButton } from "./ScrollVisibleButton";
 import { TopIcon } from "./icons/TopIcon";
 var DEFAULT_DURATION = 450;
 var DEFAULT_VISIBLE_THRESHOLD = 400;
-var getShouldVisible = (propsShouldVisible) => {
-  return (scrollTop, container) => {
-    if (typeof propsShouldVisible === "function") {
-      return propsShouldVisible(scrollTop, container);
-    }
-    return scrollTop >= (propsShouldVisible != null ? propsShouldVisible : DEFAULT_VISIBLE_THRESHOLD);
-  };
+var getShouldVisible = function(propsShouldVisible) {
+    return function(scrollTop, container) {
+        if (typeof propsShouldVisible === 'function') {
+            return propsShouldVisible(scrollTop, container);
+        }
+        return scrollTop >= (propsShouldVisible !== null && propsShouldVisible !== void 0 ? propsShouldVisible : DEFAULT_VISIBLE_THRESHOLD);
+    };
 };
-var BackTop = forwardRef(
-  (props, ref) => {
-    const _a = props, {
-      duration = DEFAULT_DURATION,
-      onClick,
-      shouldVisible: propsShouldVisible
-    } = _a, rest = __objRest(_a, [
-      "duration",
-      "onClick",
-      "shouldVisible"
+/**
+ * BackTop 组件 - 返回顶部按钮组件
+ *
+ * 该组件提供一个返回顶部的浮动按钮，点击后平滑滚动到页面顶部。
+ * 当滚动距离超过指定阈值时自动显示，支持自定义滚动持续时间和显示条件。
+ *
+ * @component
+ * @description 返回顶部按钮，点击后平滑滚动到页面顶部
+ * @param {BackTopProps} props - 组件属性
+ * @param {number} [props.duration=450] - 滚动到顶部的持续时间（毫秒）
+ * @param {number | ((scrollTop: number, container: HTMLElement | Window) => boolean)} [props.shouldVisible=400] - 显示条件阈值或自定义函数
+ * @param {(e: React.MouseEvent, container: HTMLElement | Window) => void} [props.onClick] - 点击回调函数
+ * @param {string} [props.className] - 自定义CSS类名
+ * @param {React.CSSProperties} [props.style] - 自定义样式
+ * @param {HTMLElement | Window} [props.target] - 滚动容器，默认为 window
+ *
+ * @example
+ * ```tsx
+ * // 基本用法
+ * <BackTop />
+ *
+ * // 自定义滚动持续时间
+ * <BackTop duration={300} />
+ *
+ * // 自定义显示阈值
+ * <BackTop shouldVisible={600} />
+ *
+ * // 自定义显示条件
+ * <BackTop
+ *   shouldVisible={(scrollTop) => scrollTop > 500}
+ * />
+ *
+ * // 指定滚动容器
+ * <BackTop target={document.getElementById('container')} />
+ * ```
+ *
+ * @returns {React.ReactElement} 渲染的返回顶部按钮组件
+ *
+ * @remarks
+ * - 默认在滚动距离超过 400px 时显示
+ * - 支持平滑滚动动画
+ * - 可自定义滚动持续时间
+ * - 支持自定义显示条件
+ * - 支持指定滚动容器
+ * - 使用 forwardRef 支持 ref 传递
+ * - 提供完整的无障碍支持
+ */ export var BackTop = /*#__PURE__*/ forwardRef(function(props, ref) {
+    var _props_duration = props.duration, duration = _props_duration === void 0 ? DEFAULT_DURATION : _props_duration, onClick = props.onClick, propsShouldVisible = props.shouldVisible, rest = _object_without_properties(props, [
+        "duration",
+        "onClick",
+        "shouldVisible"
     ]);
-    const shouldVisible = getShouldVisible(propsShouldVisible);
-    const handleClick = (e, container) => {
-      scrollTo(0, { container, duration });
-      onClick == null ? void 0 : onClick(e, container);
+    var shouldVisible = getShouldVisible(propsShouldVisible);
+    var handleClick = function(e, container) {
+        scrollTo(0, {
+            container: container,
+            duration: duration
+        });
+        onClick === null || onClick === void 0 ? void 0 : onClick(e, container);
     };
-    return /* @__PURE__ */ React.createElement(
-      ScrollVisibleButton,
-      __spreadProps(__spreadValues({}, rest), {
-        ref,
-        shouldVisible,
+    return /*#__PURE__*/ React.createElement(ScrollVisibleButton, _object_spread_props(_object_spread({}, rest), {
+        ref: ref,
+        shouldVisible: shouldVisible,
         onClick: handleClick
-      }),
-      /* @__PURE__ */ React.createElement(TopIcon, null)
-    );
-  }
-);
-export {
-  BackTop
-};
+    }), /*#__PURE__*/ React.createElement(TopIcon, null));
+});

package/dist/BackTo/ScrollVisibleButton.js

@@ -1,116 +1,142 @@
-var __defProp = Object.defineProperty;
-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 __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 _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;
-};
-
-// src/BackTo/ScrollVisibleButton.tsx
+    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;
+}
 import { ConfigProvider, Tooltip } from "antd";
 import classNames from "classnames";
 import { AnimatePresence, motion } from "framer-motion";
 import { isObject } from "lodash-es";
-import React, {
-  forwardRef,
-  isValidElement,
-  useContext,
-  useImperativeHandle
-} from "react";
-import {
-  useScrollVisible
-} from "./hooks/useScrollVisible";
+import React, { forwardRef, isValidElement, useContext, useImperativeHandle } from "react";
+import { useScrollVisible } from "./hooks/useScrollVisible";
 import { prefixCls, useStyle } from "./style";
 var DEFAULT_VISIBLE_THRESHOLD = 400;
-var getDefaultTarget = () => window;
-var getShouldVisibleHandler = (propsShouldVisible) => {
-  return (scrollTop, container) => {
-    if (typeof propsShouldVisible === "function") {
-      return propsShouldVisible(scrollTop, container);
+var getDefaultTarget = function() {
+    return window;
+};
+var getShouldVisibleHandler = function(propsShouldVisible) {
+    return function(scrollTop, container) {
+        if (typeof propsShouldVisible === 'function') {
+            return propsShouldVisible(scrollTop, container);
+        }
+        return scrollTop >= propsShouldVisible;
+    };
+};
+var getTooltipProps = function(tooltip) {
+    if (isObject(tooltip) && !/*#__PURE__*/ isValidElement(tooltip)) {
+        return tooltip;
     }
-    return scrollTop >= propsShouldVisible;
-  };
+    return {
+        title: tooltip
+    };
 };
-var getTooltipProps = (tooltip) => {
-  if (isObject(tooltip) && !isValidElement(tooltip)) {
-    return tooltip;
-  }
-  return { title: tooltip };
+var EXIT_ANIMATION = {
+    opacity: 0
 };
-var EXIT_ANIMATION = { opacity: 0 };
-var ScrollVisibleButton = forwardRef(
-  (_a, ref) => {
-    var _b = _a, {
-      className,
-      style,
-      shouldVisible: propsShouldVisible = DEFAULT_VISIBLE_THRESHOLD,
-      target,
-      onClick,
-      tooltip,
-      children
-    } = _b, rest = __objRest(_b, [
-      "className",
-      "style",
-      "shouldVisible",
-      "target",
-      "onClick",
-      "tooltip",
-      "children"
+/**
+ * ScrollVisibleButton 组件
+ *
+ * 根据滚动位置显示/隐藏的按钮，支持平滑动画效果
+ *
+ * @example
+ * ```tsx
+ * <ScrollVisibleButton
+ *   tooltip="返回顶部"
+ *   shouldVisible={400}
+ *   onClick={handleClick}
+ * >
+ *   <ArrowUpIcon />
+ * </ScrollVisibleButton>
+ * ```
+ */ export var ScrollVisibleButton = /*#__PURE__*/ forwardRef(function(_param, ref) {
+    var className = _param.className, style = _param.style, tmp = _param.shouldVisible, propsShouldVisible = tmp === void 0 ? DEFAULT_VISIBLE_THRESHOLD : tmp, target = _param.target, onClick = _param.onClick, tooltip = _param.tooltip, children = _param.children, rest = _object_without_properties(_param, [
+        "className",
+        "style",
+        "shouldVisible",
+        "target",
+        "onClick",
+        "tooltip",
+        "children"
     ]);
-    const context = useContext(ConfigProvider.ConfigContext);
-    const baseCls = context == null ? void 0 : context.getPrefixCls(prefixCls);
-    const { wrapSSR, hashId } = useStyle(baseCls);
-    const internalRef = React.useRef(null);
-    useImperativeHandle(ref, () => ({
-      nativeElement: internalRef.current
-    }));
-    const getTarget = target || getDefaultTarget;
-    const shouldVisible = getShouldVisibleHandler(propsShouldVisible);
-    const { visible, currentContainer } = useScrollVisible({
-      target: getTarget,
-      shouldVisible
+    var context = useContext(ConfigProvider.ConfigContext);
+    var baseCls = context === null || context === void 0 ? void 0 : context.getPrefixCls(prefixCls);
+    var _useStyle = useStyle(baseCls), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
+    var internalRef = React.useRef(null);
+    useImperativeHandle(ref, function() {
+        return {
+            nativeElement: internalRef.current
+        };
     });
-    const handleClick = (e) => {
-      onClick == null ? void 0 : onClick(e, currentContainer.current);
+    var getTarget = target || getDefaultTarget;
+    var shouldVisible = getShouldVisibleHandler(propsShouldVisible);
+    var _useScrollVisible = useScrollVisible({
+        target: getTarget,
+        shouldVisible: shouldVisible
+    }), visible = _useScrollVisible.visible, currentContainer = _useScrollVisible.currentContainer;
+    var handleClick = function(e) {
+        onClick === null || onClick === void 0 ? void 0 : onClick(e, currentContainer.current);
     };
-    const button = /* @__PURE__ */ React.createElement(
-      "button",
-      __spreadValues({
+    var button = /*#__PURE__*/ React.createElement("button", _object_spread({
         ref: internalRef,
         className: classNames(baseCls, className, hashId),
-        style,
+        style: style,
         type: "button",
         onClick: handleClick
-      }, rest),
-      /* @__PURE__ */ React.createElement("div", { className: `${baseCls}-content ${hashId}` }, children)
-    );
-    const buttonWithTooltip = tooltip ? /* @__PURE__ */ React.createElement(Tooltip, __spreadValues({}, getTooltipProps(tooltip)), button) : button;
-    return wrapSSR(
-      /* @__PURE__ */ React.createElement(AnimatePresence, null, visible && /* @__PURE__ */ React.createElement(motion.div, { exit: EXIT_ANIMATION }, buttonWithTooltip))
-    );
-  }
-);
-export {
-  ScrollVisibleButton
-};
+    }, rest), /*#__PURE__*/ React.createElement("div", {
+        className: "".concat(baseCls, "-content ").concat(hashId)
+    }, children));
+    var buttonWithTooltip = tooltip ? /*#__PURE__*/ React.createElement(Tooltip, getTooltipProps(tooltip), button) : button;
+    return wrapSSR(/*#__PURE__*/ React.createElement(AnimatePresence, null, visible && /*#__PURE__*/ React.createElement(motion.div, {
+        exit: EXIT_ANIMATION
+    }, buttonWithTooltip)));
+});

package/dist/BackTo/hooks/useScrollVisible.js

@@ -1,38 +1,84 @@
-// src/BackTo/hooks/useScrollVisible.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, useRef, useState } from "react";
 import getScroll from "../../Utils/getScroll";
 import throttleByAnimationFrame from "../../Utils/throttleByAnimationFrame";
-var useScrollVisible = ({
-  target,
-  shouldVisible
-}) => {
-  const [visible, setVisible] = useState(false);
-  const getShouldVisible = useCallback(
-    (scrollTop) => {
-      const container = target();
-      return shouldVisible(scrollTop, container);
-    },
-    [target, shouldVisible]
-  );
-  const handleScroll = throttleByAnimationFrame(
-    (e) => {
-      const scrollTop = getScroll(e.target);
-      setVisible(getShouldVisible(scrollTop));
-    }
-  );
-  const currentContainer = useRef(window);
-  useEffect(() => {
-    const container = target();
-    handleScroll({ target: container });
-    currentContainer.current = container;
-    container == null ? void 0 : container.addEventListener("scroll", handleScroll);
-    return () => {
-      handleScroll.cancel();
-      container == null ? void 0 : container.removeEventListener("scroll", handleScroll);
+export var useScrollVisible = function(param) {
+    var target = param.target, shouldVisible = param.shouldVisible;
+    var _useState = _sliced_to_array(useState(false), 2), visible = _useState[0], setVisible = _useState[1];
+    var getShouldVisible = useCallback(function(scrollTop) {
+        var container = target();
+        return shouldVisible(scrollTop, container);
+    }, [
+        target,
+        shouldVisible
+    ]);
+    var handleScroll = throttleByAnimationFrame(function(e) {
+        var scrollTop = getScroll(e.target);
+        setVisible(getShouldVisible(scrollTop));
+    });
+    var currentContainer = useRef(window);
+    useEffect(function() {
+        var container = target();
+        handleScroll({
+            target: container
+        });
+        currentContainer.current = container;
+        container === null || container === void 0 ? void 0 : container.addEventListener('scroll', handleScroll);
+        return function() {
+            handleScroll.cancel();
+            container === null || container === void 0 ? void 0 : container.removeEventListener('scroll', handleScroll);
+        };
+    }, [
+        target,
+        getShouldVisible
+    ]);
+    return {
+        visible: visible,
+        currentContainer: currentContainer
     };
-  }, [target, getShouldVisible]);
-  return { visible, currentContainer };
-};
-export {
-  useScrollVisible
 };