@ant-design/agentic-ui 2.7.1 → 2.9.0

package/dist/ToolUseBar/index.js

@@ -1,20 +1,88 @@
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-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];
+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 _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 _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/ToolUseBar/index.tsx
+    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 _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 _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 _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 { ConfigProvider } from "antd";
 import classNames from "classnames";
 import { useMergedState } from "rc-util";
@@ -23,103 +91,148 @@ import { ToolUseBarItem } from "./ToolUseBarItem";
 import { useStyle } from "./style";
 export * from "./ToolUseBarItem";
 export * from "./ToolUseBarThink";
-var ToolUseBarComponent = (_a) => {
-  var _b = _a, {
-    tools,
-    onActiveKeysChange,
-    onExpandedKeysChange,
-    light = false
-  } = _b, props = __objRest(_b, [
-    "tools",
-    "onActiveKeysChange",
-    "onExpandedKeysChange",
-    "light"
-  ]);
-  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const prefixCls = getPrefixCls("agentic-tool-use-bar");
-  const { wrapSSR, hashId } = useStyle(prefixCls);
-  const [activeKeys, setActiveKeys] = useMergedState(
-    props.defaultActiveKeys || [],
-    {
-      value: props.activeKeys,
-      defaultValue: props.defaultActiveKeys,
-      onChange: onActiveKeysChange
-    }
-  );
-  const [expandedKeys, setExpandedKeys] = useMergedState(
-    props.defaultExpandedKeys || [],
-    {
-      value: props.expandedKeys,
-      onChange: onExpandedKeysChange
-    }
-  );
-  const handleActiveChange = useCallback(
-    (id, active) => {
-      if (onActiveKeysChange) {
-        const newActiveKeys = active ? [...activeKeys, id] : activeKeys.filter((key) => key !== id);
-        setActiveKeys(newActiveKeys);
-      }
-    },
-    [onActiveKeysChange, activeKeys, setActiveKeys]
-  );
-  const handleExpandedChange = useCallback(
-    (id, expanded) => {
-      const newExpandedKeys = expanded ? [...expandedKeys, id] : expandedKeys.filter((key) => key !== id);
-      const removedKeys = expandedKeys.filter(
-        (key) => !newExpandedKeys.includes(key)
-      );
-      setExpandedKeys(newExpandedKeys);
-      if (onExpandedKeysChange) {
-        onExpandedKeysChange(newExpandedKeys, removedKeys);
-      }
-    },
-    [onExpandedKeysChange, expandedKeys, setExpandedKeys]
-  );
-  const toolItems = useMemo(() => {
-    if (!(tools == null ? void 0 : tools.length))
-      return null;
-    return tools.map((tool) => {
-      var _a2;
-      return /* @__PURE__ */ React.createElement(
-        ToolUseBarItem,
-        {
-          key: tool.id,
-          tool,
-          onClick: props.onToolClick,
-          isActive: activeKeys.includes(tool.id),
-          onActiveChange: handleActiveChange,
-          isExpanded: onExpandedKeysChange ? expandedKeys.includes(tool.id) : void 0,
-          onExpandedChange: onExpandedKeysChange ? handleExpandedChange : void 0,
-          defaultExpanded: (_a2 = props.defaultExpandedKeys) == null ? void 0 : _a2.includes(tool.id),
-          prefixCls,
-          hashId,
-          light
+/**
+ * ToolUseBar 组件 - 工具使用栏组件
+ *
+ * 该组件显示工具使用列表，支持工具的展开/折叠、激活状态管理等功能。
+ * 每个工具项显示工具名称、目标、时间等信息，支持点击交互。
+ *
+ * @component
+ * @description 工具使用栏组件，显示工具使用列表和状态
+ * @param {ToolUseBarProps} props - 组件属性
+ * @param {ToolUseItem[]} [props.tools] - 工具使用列表
+ * @param {string[]} [props.activeKeys] - 当前激活的工具ID列表
+ * @param {string[]} [props.defaultActiveKeys] - 默认激活的工具ID列表
+ * @param {(keys: string[]) => void} [props.onActiveKeysChange] - 激活状态变化回调
+ * @param {string[]} [props.expandedKeys] - 当前展开的工具ID列表
+ * @param {string[]} [props.defaultExpandedKeys] - 默认展开的工具ID列表
+ * @param {(keys: string[]) => void} [props.onExpandedKeysChange] - 展开状态变化回调
+ * @param {(tool: ToolUseItem) => void} [props.onToolClick] - 工具点击回调
+ * @param {string} [props.className] - 自定义CSS类名
+ * @param {React.CSSProperties} [props.style] - 自定义样式
+ *
+ * @example
+ * ```tsx
+ * <ToolUseBar
+ *   tools={toolList}
+ *   activeKeys={['tool1', 'tool2']}
+ *   onActiveKeysChange={(keys) => setActiveKeys(keys)}
+ *   expandedKeys={['tool1']}
+ *   onExpandedKeysChange={(keys) => setExpandedKeys(keys)}
+ *   onToolClick={(tool) => console.log('点击工具:', tool.toolName)}
+ * />
+ * ```
+ *
+ * @returns {React.ReactElement} 渲染的工具使用栏组件
+ *
+ * @remarks
+ * - 支持工具列表的受控和非受控展开/折叠
+ * - 支持工具的受控和非受控激活状态管理
+ * - 显示工具名称、目标、时间等信息
+ * - 支持工具点击交互
+ * - 提供加载状态显示
+ * - 支持错误状态处理
+ */ var ToolUseBarComponent = function(_param) {
+    var tools = _param.tools, onActiveKeysChange = _param.onActiveKeysChange, onExpandedKeysChange = _param.onExpandedKeysChange, _param_light = _param.light, light = _param_light === void 0 ? false : _param_light, props = _object_without_properties(_param, [
+        "tools",
+        "onActiveKeysChange",
+        "onExpandedKeysChange",
+        "light"
+    ]);
+    var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
+    var prefixCls = getPrefixCls('agentic-tool-use-bar');
+    var _useStyle = useStyle(prefixCls), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
+    var _useMergedState = _sliced_to_array(useMergedState(props.defaultActiveKeys || [], {
+        value: props.activeKeys,
+        defaultValue: props.defaultActiveKeys,
+        onChange: onActiveKeysChange
+    }), 2), activeKeys = _useMergedState[0], setActiveKeys = _useMergedState[1];
+    var _useMergedState1 = _sliced_to_array(useMergedState(props.defaultExpandedKeys || [], {
+        value: props.expandedKeys,
+        onChange: onExpandedKeysChange
+    }), 2), expandedKeys = _useMergedState1[0], setExpandedKeys = _useMergedState1[1];
+    var handleActiveChange = useCallback(function(id, active) {
+        if (onActiveKeysChange) {
+            var newActiveKeys = active ? _to_consumable_array(activeKeys).concat([
+                id
+            ]) : activeKeys.filter(function(key) {
+                return key !== id;
+            });
+            setActiveKeys(newActiveKeys);
         }
-      );
+    }, [
+        onActiveKeysChange,
+        activeKeys,
+        setActiveKeys
+    ]);
+    var handleExpandedChange = useCallback(function(id, expanded) {
+        var newExpandedKeys = expanded ? _to_consumable_array(expandedKeys).concat([
+            id
+        ]) : expandedKeys.filter(function(key) {
+            return key !== id;
+        });
+        // 计算被移除的键
+        var removedKeys = expandedKeys.filter(function(key) {
+            return !newExpandedKeys.includes(key);
+        });
+        setExpandedKeys(newExpandedKeys);
+        // 调用回调函数，传递新的展开键列表和被移除的键列表
+        if (onExpandedKeysChange) {
+            onExpandedKeysChange(newExpandedKeys, removedKeys);
+        }
+    }, [
+        onExpandedKeysChange,
+        expandedKeys,
+        setExpandedKeys
+    ]);
+    // 使用 useMemo 优化工具列表的渲染
+    var toolItems = useMemo(function() {
+        if (!(tools === null || tools === void 0 ? void 0 : tools.length)) return null;
+        return tools.map(function(tool) {
+            var _props_defaultExpandedKeys;
+            return /*#__PURE__*/ React.createElement(ToolUseBarItem, {
+                key: tool.id,
+                tool: tool,
+                onClick: props.onToolClick,
+                isActive: activeKeys.includes(tool.id),
+                onActiveChange: handleActiveChange,
+                isExpanded: onExpandedKeysChange ? expandedKeys.includes(tool.id) : undefined,
+                onExpandedChange: onExpandedKeysChange ? handleExpandedChange : undefined,
+                defaultExpanded: (_props_defaultExpandedKeys = props.defaultExpandedKeys) === null || _props_defaultExpandedKeys === void 0 ? void 0 : _props_defaultExpandedKeys.includes(tool.id),
+                prefixCls: prefixCls,
+                hashId: hashId,
+                light: light
+            });
+        });
+    }, [
+        tools,
+        props.onToolClick,
+        activeKeys,
+        handleActiveChange,
+        onExpandedKeysChange,
+        expandedKeys,
+        handleExpandedChange,
+        props.defaultExpandedKeys,
+        prefixCls,
+        hashId,
+        light
+    ]);
+    // 使用 useMemo 优化样式类名
+    var containerClassName = useMemo(function() {
+        return classNames(prefixCls, hashId, props.className);
+    }, [
+        prefixCls,
+        hashId,
+        props.className
+    ]);
+    if (!(tools === null || tools === void 0 ? void 0 : tools.length)) return /*#__PURE__*/ React.createElement("div", {
+        className: containerClassName,
+        "data-testid": "ToolUse"
     });
-  }, [
-    tools,
-    props.onToolClick,
-    activeKeys,
-    handleActiveChange,
-    onExpandedKeysChange,
-    expandedKeys,
-    handleExpandedChange,
-    props.defaultExpandedKeys,
-    prefixCls,
-    hashId,
-    light
-  ]);
-  const containerClassName = useMemo(() => {
-    return classNames(prefixCls, hashId, props.className);
-  }, [prefixCls, hashId, props.className]);
-  if (!(tools == null ? void 0 : tools.length))
-    return /* @__PURE__ */ React.createElement("div", { className: containerClassName, "data-testid": "ToolUse" });
-  return wrapSSR(
-    /* @__PURE__ */ React.createElement("div", { className: containerClassName, "data-testid": "ToolUse" }, toolItems)
-  );
-};
-var ToolUseBar = memo(ToolUseBarComponent);
-export {
-  ToolUseBar
+    return wrapSSR(/*#__PURE__*/ React.createElement("div", {
+        className: containerClassName,
+        "data-testid": "ToolUse"
+    }, toolItems));
 };
+// 使用 memo 优化组件，避免不必要的重新渲染
+export var ToolUseBar = /*#__PURE__*/ memo(ToolUseBarComponent);