@agentscope-ai/chat 1.1.4 → 1.1.7

package/{dist/chat-anywhere → lib/ChatAnywhere}/hooks/useMessages.js

@@ -1,9 +1,15 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { 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 _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(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(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _arrayLikeToArray(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 ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import React from 'react';
 import { useChatAnywhere } from "./ChatAnywhereProvider";
 export function useMessages() {
@@ -18,12 +24,14 @@ export function useMessages() {
     setMessages = _useChatAnywhere.setMessages,
     getMessages = _useChatAnywhere.getMessages;
   var updateMessage = React.useCallback(function (message) {
-    setMessages(function (prev) {
+    // @ts-ignore
+    setMessages === null || setMessages === void 0 || setMessages(function (prev) {
       var index = prev.findIndex(function (item) {
         return item.id === message.id;
       });
       if (index > -1) {
-        return [].concat(_toConsumableArray(prev.slice(0, index)), [message], _toConsumableArray(prev.slice(index + 1)));
+        var nextMessage = _objectSpread(_objectSpread({}, prev[index]), message);
+        return [].concat(_toConsumableArray(prev.slice(0, index)), [nextMessage], _toConsumableArray(prev.slice(index + 1)));
       } else {
         return [].concat(_toConsumableArray(prev), [message]);
       }

package/{dist/chat-anywhere → lib/ChatAnywhere}/index.d.ts

@@ -2,8 +2,11 @@ import React from 'react';
 import { v4 as uuid } from 'uuid';
 import { ChatAnywhereRef, useChatAnywhere } from './hooks/ChatAnywhereProvider';
 import { IChatAnywhereConfig } from './hooks/types';
+import { useMessages } from './hooks/useMessages';
+import { useInput } from './hooks/useInput';
+import { useSessionList } from './hooks/useSessionList';
 export type { ChatAnywhereRef };
-export { uuid, useChatAnywhere };
+export { uuid, useChatAnywhere, useMessages, useInput, useSessionList };
 export type { TMessage, TSession } from './hooks/types';
 declare const _default: React.ForwardRefExoticComponent<IChatAnywhereConfig & React.RefAttributes<unknown>>;
 export default _default;

package/{dist/chat-anywhere → lib/ChatAnywhere}/index.js

@@ -1,6 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 var _excluded = ["cardConfig"];
-function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -23,8 +22,15 @@ import { v4 as uuid } from 'uuid';
 import { CustomCardsProvider } from "./..";
 import { ChatAnywhereProvider, useChatAnywhere } from "./hooks/ChatAnywhereProvider";
 import ContextRef from "./Chat/Ref";
-export { uuid, useChatAnywhere };
+import { useMessages } from "./hooks/useMessages";
+import { useInput } from "./hooks/useInput";
+import { useSessionList } from "./hooks/useSessionList";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
+export { uuid, useChatAnywhere, useMessages, useInput, useSessionList };
 export default /*#__PURE__*/forwardRef(function (chatanywhereConfig, ref) {
+  var _rest$uiConfig;
   var _useState = useState(0),
     _useState2 = _slicedToArray(_useState, 2),
     key = _useState2[0],
@@ -32,9 +38,10 @@ export default /*#__PURE__*/forwardRef(function (chatanywhereConfig, ref) {
   var cardConfig = chatanywhereConfig.cardConfig,
     rest = _objectWithoutProperties(chatanywhereConfig, _excluded);
   var chatRef = useRef(null);
+  var inputRef = useRef(null);
   var contextRef = useRef(null);
   React.useImperativeHandle(ref, function () {
-    return _objectSpread(_objectSpread(_objectSpread({}, chatRef.current), contextRef.current), {}, {
+    return _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, chatRef.current), inputRef.current), contextRef.current), {}, {
       reload: function reload() {
         setKey(function (key) {
           return key + 1;
@@ -42,17 +49,23 @@ export default /*#__PURE__*/forwardRef(function (chatanywhereConfig, ref) {
       }
     });
   });
-  return /*#__PURE__*/React.createElement(ChatAnywhereProvider, _extends({}, rest, {
+  return /*#__PURE__*/_createElement(ChatAnywhereProvider, _objectSpread(_objectSpread({}, rest), {}, {
     key: key
-  }), /*#__PURE__*/React.createElement(CustomCardsProvider, {
-    cardConfig: cardConfig
-  }, /*#__PURE__*/React.createElement(Layout, {
-    top: rest.uiConfig.header ? /*#__PURE__*/React.createElement(Header, null) : null,
-    left: rest.onSessionKeyChange ? /*#__PURE__*/React.createElement(SessionList, null) : null,
-    right: /*#__PURE__*/React.createElement(Chat, {
-      ref: chatRef
-    })
-  }), /*#__PURE__*/React.createElement(ContextRef, {
-    ref: contextRef
-  })));
+  }), /*#__PURE__*/_jsxs(CustomCardsProvider, {
+    cardConfig: cardConfig,
+    children: [/*#__PURE__*/_jsx(Layout, {
+      top: (_rest$uiConfig = rest.uiConfig) !== null && _rest$uiConfig !== void 0 && _rest$uiConfig.header ? /*#__PURE__*/_jsx(Header, {}) : null,
+      left: rest.onSessionKeyChange ? /*#__PURE__*/_jsx(SessionList, {}) : null
+      // @ts-ignore
+      ,
+      right: /*#__PURE__*/_jsx(Chat, {
+        ref: {
+          chatRef: chatRef,
+          inputRef: inputRef
+        }
+      })
+    }), /*#__PURE__*/_jsx(ContextRef, {
+      ref: contextRef
+    })]
+  }));
 });

package/{dist/conversations → lib/Conversations}/GroupTitle.d.ts

@@ -1,6 +1,10 @@
 import type { ConfigProviderProps, GetProp } from 'antd';
 import React from 'react';
 export interface GroupTitleProps {
+    /**
+     * @description 分组标题的内容，支持文本或React元素
+     * @descriptionEn Content of the group title, supports text or React elements
+     */
     children?: React.ReactNode;
 }
 export declare const GroupTitleContext: React.Context<{

package/{dist/conversations → lib/Conversations}/GroupTitle.js

@@ -1,15 +1,17 @@
 import { Typography } from 'antd';
 import classnames from 'classnames';
 import React from 'react';
-// User should not care about internal state.
-// Which should pass by context instead.
+import { jsx as _jsx } from "react/jsx-runtime";
 export var GroupTitleContext = /*#__PURE__*/React.createContext(null);
 var GroupTitle = function GroupTitle(_ref) {
   var children = _ref.children;
   var _React$useContext = React.useContext(GroupTitleContext),
     prefixCls = _React$useContext.prefixCls;
-  return /*#__PURE__*/React.createElement("div", {
-    className: classnames("".concat(prefixCls, "-group-title"))
-  }, children && /*#__PURE__*/React.createElement(Typography.Text, null, children));
+  return /*#__PURE__*/_jsx("div", {
+    className: classnames("".concat(prefixCls, "-group-title")),
+    children: children && /*#__PURE__*/_jsx(Typography.Text, {
+      children: children
+    })
+  });
 };
 export default GroupTitle;

package/{dist/conversations → lib/Conversations}/Item.d.ts

@@ -10,5 +10,6 @@ export interface ConversationsItemProps extends Omit<React.HTMLAttributes<HTMLLI
     active?: boolean;
     onClick?: (info: Conversation) => void;
 }
+export declare function useEditable(id: any): any[];
 declare const ConversationsItem: React.FC<ConversationsItemProps>;
 export default ConversationsItem;

package/lib/Conversations/Item.js

@@ -0,0 +1,208 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["prefixCls", "info", "className", "direction", "onClick", "active", "menu"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(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 _objectWithoutPropertiesLoose(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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { 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 _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(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(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(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 _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { Dropdown, Tooltip } from 'antd';
+import classnames from 'classnames';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
+import pickAttrs from 'rc-util/lib/pickAttrs';
+import { SparkMoreLine } from '@agentscope-ai/icons';
+import { IconButton } from "@ali/agentscope-ai-design";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var stopPropagation = function stopPropagation(e) {
+  e.stopPropagation();
+};
+var editableMap = {};
+export function useEditable(id) {
+  var _useState = useState(editableMap[id]),
+    _useState2 = _slicedToArray(_useState, 2),
+    editable = _useState2[0],
+    setEditable = _useState2[1];
+  return [editable, function (value) {
+    for (var key in editableMap) {
+      editableMap[key] = false;
+    }
+    editableMap[id] = value;
+    setEditable(value);
+  }];
+}
+var ConversationsItem = function ConversationsItem(props) {
+  var _useEditable = useEditable(props.info.key),
+    _useEditable2 = _slicedToArray(_useEditable, 2),
+    editable = _useEditable2[0],
+    setEditable = _useEditable2[1];
+  var prefixCls = props.prefixCls,
+    info = props.info,
+    className = props.className,
+    direction = props.direction,
+    onClick = props.onClick,
+    active = props.active,
+    menu = props.menu,
+    restProps = _objectWithoutProperties(props, _excluded);
+  var domProps = pickAttrs(restProps, {
+    aria: true,
+    data: true,
+    attr: true
+  });
+  var disabled = info.disabled;
+  var _React$useState = React.useState(false),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    inEllipsis = _React$useState2[0],
+    onEllipsis = _React$useState2[1];
+  var _React$useState3 = React.useState(false),
+    _React$useState4 = _slicedToArray(_React$useState3, 2),
+    opened = _React$useState4[0],
+    setOpened = _React$useState4[1];
+  var mergedCls = classnames(className, "".concat(prefixCls, "-item"), _defineProperty({}, "".concat(prefixCls, "-item-active"), active && !disabled), _defineProperty({}, "".concat(prefixCls, "-item-disabled"), disabled), _defineProperty({}, "".concat(prefixCls, "-item-timeline"), info.timeline));
+  var onInternalClick = function onInternalClick() {
+    if (!disabled && onClick) {
+      onClick(info);
+    }
+  };
+  var onOpenChange = function onOpenChange(open) {
+    if (open) {
+      setOpened(!open);
+    }
+  };
+  var dropdownMenu = useMemo(function () {
+    return _objectSpread(_objectSpread({}, menu), {}, {
+      onClick: function onClick(e) {
+        e.domEvent.stopPropagation();
+        if (e.key === 'edit') {
+          setEditable(true);
+        } else {
+          var _menu$onClick;
+          (_menu$onClick = menu.onClick) === null || _menu$onClick === void 0 || _menu$onClick.call(menu, e);
+        }
+      },
+      // @ts-ignore
+      onEdit: menu.onEdit || function (label) {
+        return menu.onClick({
+          key: 'edit',
+          // @ts-ignore
+          label: label
+        });
+      }
+    });
+  }, [menu]);
+
+  // debugger;
+
+  return /*#__PURE__*/_jsx(Tooltip, {
+    title: info.label,
+    open: inEllipsis && opened,
+    onOpenChange: setOpened,
+    placement: direction === 'rtl' ? 'left' : 'right',
+    children: /*#__PURE__*/_jsxs("li", _objectSpread(_objectSpread({}, domProps), {}, {
+      className: mergedCls,
+      onClick: onInternalClick,
+      children: [/*#__PURE__*/_jsxs("div", {
+        className: "".concat(prefixCls, "-content"),
+        children: [info.icon && /*#__PURE__*/_jsx("div", {
+          className: "".concat(prefixCls, "-icon"),
+          children: info.icon
+        }), info.timeline && /*#__PURE__*/_jsx("div", {
+          className: "".concat(prefixCls, "-timeline")
+        }), /*#__PURE__*/_jsx(Label, {
+          editable: editable,
+          setEditable: setEditable,
+          prefixCls: prefixCls,
+          info: info
+          // @ts-ignore
+          ,
+          onEdit: dropdownMenu.onEdit
+        }), menu && !disabled && /*#__PURE__*/_jsx(Dropdown, {
+          menu: dropdownMenu,
+          placement: direction === 'rtl' ? 'bottomLeft' : 'bottomRight',
+          trigger: ['click'],
+          disabled: disabled,
+          onOpenChange: onOpenChange,
+          children: /*#__PURE__*/_jsx(IconButton, {
+            bordered: false,
+            icon: /*#__PURE__*/_jsx(SparkMoreLine, {}),
+            onClick: stopPropagation,
+            disabled: disabled,
+            className: "".concat(prefixCls, "-menu-icon")
+          })
+        })]
+      }), info.desc && /*#__PURE__*/_jsx("div", {
+        className: "".concat(prefixCls, "-desc"),
+        style: info.timeline ? {
+          marginLeft: 16
+        } : {},
+        children: info.desc
+      })]
+    }))
+  });
+};
+function Label(props) {
+  var editable = props.editable,
+    prefixCls = props.prefixCls,
+    info = props.info,
+    setEditable = props.setEditable,
+    onEdit = props.onEdit;
+  var _useState3 = useState(info.label),
+    _useState4 = _slicedToArray(_useState3, 2),
+    label = _useState4[0],
+    setLabel = _useState4[1];
+  return editable ? /*#__PURE__*/_jsx(Input, {
+    prefixCls: prefixCls,
+    value: label,
+    onBlur: function onBlur(v) {
+      var _onEdit;
+      if (v === label) return setEditable(false);
+      (_onEdit = onEdit(v)) === null || _onEdit === void 0 || _onEdit.then(function () {
+        setLabel(v);
+      }).catch(function () {
+        setLabel(label);
+      }).finally(function () {
+        setEditable(false);
+      });
+    },
+    setEditable: setEditable
+  }) : /*#__PURE__*/_jsx("div", {
+    className: "".concat(prefixCls, "-label"),
+    children: label
+  });
+}
+function Input(_ref) {
+  var prefixCls = _ref.prefixCls,
+    value = _ref.value,
+    _onBlur = _ref.onBlur,
+    setEditable = _ref.setEditable;
+  var _useState5 = useState(value),
+    _useState6 = _slicedToArray(_useState5, 2),
+    v = _useState6[0],
+    sv = _useState6[1];
+  var ref = useRef();
+  useEffect(function () {
+    ref.current.focus();
+  }, []);
+  useEffect(function () {
+    sv(value);
+  }, [value]);
+  return /*#__PURE__*/_jsx("input", {
+    ref: ref,
+    className: "".concat(prefixCls, "-label-edit"),
+    value: v,
+    onChange: function onChange(e) {
+      return sv(e.target.value);
+    },
+    onBlur: function onBlur() {
+      return _onBlur(v);
+    }
+  });
+}
+export default ConversationsItem;

package/lib/Conversations/hooks/useGroupable.d.ts

@@ -0,0 +1,8 @@
+import type { Conversation, Groupable } from '../interface';
+type GroupList = {
+    data: Conversation[];
+    name?: string;
+    title?: Groupable['title'];
+}[];
+declare const useGroupable: (groupable?: boolean | Groupable, items?: Conversation[]) => [groupList: GroupList, enableGroup: boolean];
+export default useGroupable;

package/lib/Conversations/index.d.ts

@@ -0,0 +1,55 @@
+import type { MenuProps } from 'antd';
+import React from 'react';
+import type { Conversation, Groupable } from './interface';
+export interface ConversationsProps extends React.HTMLAttributes<HTMLUListElement> {
+    /**
+     * @description 会话列表的数据源数组，包含所有会话信息
+     * @descriptionEn Data source array for the conversation list containing all conversation information
+     */
+    items?: Conversation[];
+    /**
+     * @description 当前激活的会话标识符，用于高亮显示选中项
+     * @descriptionEn Currently active conversation identifier for highlighting selected item
+     */
+    activeKey?: Conversation['key'];
+    /**
+     * @description 组件初始化时的默认选中会话标识符
+     * @descriptionEn Default selected conversation identifier when component initializes
+     */
+    defaultActiveKey?: Conversation['key'];
+    /**
+     * @description 会话选择发生变化时的回调函数，接收新的会话标识符
+     * @descriptionEn Callback function when conversation selection changes, receives new conversation identifier
+     */
+    onActiveChange?: (value: string) => void;
+    /**
+     * @description 会话操作菜单配置，支持静态配置或动态函数返回
+     * @descriptionEn Conversation operation menu configuration, supports static config or dynamic function return
+     */
+    menu?: MenuProps | ((value: Conversation) => MenuProps);
+    /**
+     * @description 语义化样式对象，用于精确控制不同区域的样式
+     * @descriptionEn Semantic style object for precise control of different area styles
+     */
+    styles?: Partial<Record<'item', React.CSSProperties>>;
+    /**
+     * @description 语义化CSS类名，用于为不同区域添加自定义类名
+     * @descriptionEn Semantic CSS class names for adding custom classes to different areas
+     */
+    classNames?: Partial<Record<'item', string>>;
+    /**
+     * @description 自定义CSS类名前缀，用于样式隔离和主题定制
+     * @descriptionEn Custom CSS class name prefix for style isolation and theme customization
+     */
+    prefixCls?: string;
+    /**
+     * @description 自定义根容器的CSS类名，用于覆盖默认样式
+     * @descriptionEn Custom CSS class name for the root container to override default styles
+     */
+    rootClassName?: string;
+}
+declare const Conversations: React.FC<ConversationsProps & {
+    groupable?: boolean | Groupable;
+}>;
+export type { Conversation };
+export default Conversations;

package/{dist/conversations → lib/Conversations}/index.js

@@ -1,6 +1,7 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 var _excluded = ["prefixCls", "rootClassName", "items", "activeKey", "defaultActiveKey", "onActiveChange", "menu", "styles", "classNames", "groupable", "className", "style"];
-function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
@@ -21,12 +22,9 @@ import { useProviderContext } from "./..";
 import useGroupable from "./hooks/useGroupable";
 import useStyle from "./style";
 import pickAttrs from 'rc-util/lib/pickAttrs';
-
-/**
- * @desc 会话列表组件参数
- * @descEN Props for the conversation list component
- */
-
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
 var Conversations = function Conversations(props) {
   var customizePrefixCls = props.prefixCls,
     rootClassName = props.rootClassName,
@@ -48,8 +46,6 @@ var Conversations = function Conversations(props) {
     aria: true,
     data: true
   });
-
-  // ============================ ActiveKey ============================
   var _useMergedState = useMergedState(defaultActiveKey, {
       value: activeKey
     }),
@@ -61,64 +57,57 @@ var Conversations = function Conversations(props) {
     groupList = _useGroupable2[0],
     enableGroup = _useGroupable2[1];
   var _useProviderContext = useProviderContext(),
-    getPrefixCls = _useProviderContext.getPrefixCls,
-    direction = _useProviderContext.direction;
-  var prefixCls = getPrefixCls('conversations', customizePrefixCls);
-  var _useStyle = useStyle(prefixCls),
-    _useStyle2 = _slicedToArray(_useStyle, 3),
-    wrapCSSVar = _useStyle2[0],
-    hashId = _useStyle2[1],
-    cssVarCls = _useStyle2[2];
-  var mergedCls = classnames(prefixCls, className, rootClassName, hashId, cssVarCls, _defineProperty({}, "".concat(prefixCls, "-rtl"), direction === 'rtl'));
+    direction = _useProviderContext.direction,
+    getPrefixCls = _useProviderContext.getPrefixCls;
+  var prefixCls = getPrefixCls('conversations');
+  var Style = useStyle();
+  var mergedCls = classnames(prefixCls, className, rootClassName, _defineProperty({}, "".concat(prefixCls, "-rtl"), direction === 'rtl'));
   var onConversationItemClick = function onConversationItemClick(info) {
     setMergedActiveKey(info.key);
     if (onActiveChange) {
       onActiveChange(info.key);
     }
   };
-
-  // ============================ Render ============================
-  return wrapCSSVar( /*#__PURE__*/React.createElement("ul", _extends({}, domProps, {
-    style: style,
-    className: mergedCls
-  }), groupList.map(function (groupInfo, groupIndex) {
-    var convItems = groupInfo.data.map(function (convInfo, convIndex) {
-      return /*#__PURE__*/React.createElement(ConversationsItem, {
-        key: convInfo.key || "key-".concat(convIndex),
-        info: convInfo,
-        prefixCls: prefixCls,
-        direction: direction,
-        className: classnames(classNames.item),
-        style: styles.item,
-        menu: typeof menu === 'function' ? menu(convInfo) : menu,
-        active: mergedActiveKey === convInfo.key,
-        onClick: onConversationItemClick
-      });
-    });
-
-    // With group to show the title
-    if (enableGroup) {
-      var _groupInfo$title;
-      return /*#__PURE__*/React.createElement("li", {
-        key: groupInfo.name || "key-".concat(groupIndex)
-      }, /*#__PURE__*/React.createElement(GroupTitleContext.Provider, {
-        value: {
-          prefixCls: prefixCls
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(Style, {}), /*#__PURE__*/_jsx("ul", _objectSpread(_objectSpread({}, domProps), {}, {
+      style: style,
+      className: mergedCls,
+      children: groupList.map(function (groupInfo, groupIndex) {
+        var convItems = groupInfo.data.map(function (convInfo, convIndex) {
+          return /*#__PURE__*/_jsx(ConversationsItem, {
+            info: convInfo,
+            prefixCls: prefixCls,
+            direction: direction,
+            className: classnames(classNames.item),
+            style: styles.item,
+            menu: typeof menu === 'function' ? menu(convInfo) : menu,
+            active: mergedActiveKey === convInfo.key,
+            onClick: onConversationItemClick
+          }, convInfo.key || "key-".concat(convIndex));
+        });
+        if (enableGroup) {
+          var _groupInfo$title;
+          return /*#__PURE__*/_jsxs("li", {
+            children: [/*#__PURE__*/_jsx(GroupTitleContext.Provider, {
+              value: {
+                prefixCls: prefixCls
+              },
+              children: ((_groupInfo$title = groupInfo.title) === null || _groupInfo$title === void 0 ? void 0 : _groupInfo$title.call(groupInfo, groupInfo.name, {
+                components: {
+                  GroupTitle: GroupTitle
+                }
+              })) || /*#__PURE__*/_jsx(GroupTitle, {
+                children: groupInfo.name
+              }, groupInfo.name)
+            }), /*#__PURE__*/_jsx("ul", {
+              className: "".concat(prefixCls, "-list"),
+              children: convItems
+            })]
+          }, groupInfo.name || "key-".concat(groupIndex));
         }
-      }, ((_groupInfo$title = groupInfo.title) === null || _groupInfo$title === void 0 ? void 0 : _groupInfo$title.call(groupInfo, groupInfo.name, {
-        components: {
-          GroupTitle: GroupTitle
-        }
-      })) || /*#__PURE__*/React.createElement(GroupTitle, {
-        key: groupInfo.name
-      }, groupInfo.name)), /*#__PURE__*/React.createElement("ul", {
-        className: "".concat(prefixCls, "-list")
-      }, convItems));
-    }
-    return convItems;
-  })));
+        return convItems;
+      })
+    }))]
+  });
 };
-if (process.env.NODE_ENV !== 'production') {
-  Conversations.displayName = 'Conversations';
-}
 export default Conversations;

package/lib/Conversations/interface.d.ts

@@ -0,0 +1,56 @@
+import type React from 'react';
+import type { AnyObject } from '../Util/type';
+import type { GroupTitleProps } from './GroupTitle';
+type GroupType = string;
+export interface Conversation extends AnyObject {
+    /**
+     * @description 会话的唯一标识符，用于区分不同的聊天会话
+     * @descriptionEn Unique identifier for the conversation to distinguish different chat sessions
+     */
+    key: string;
+    /**
+     * @description 会话的显示名称，支持文本或React元素
+     * @descriptionEn Display name for the conversation, supports text or React elements
+     */
+    label?: React.ReactNode;
+    /**
+     * @description 会话创建或最后活动的时间戳，用于排序和显示
+     * @descriptionEn Timestamp of conversation creation or last activity for sorting and display
+     */
+    timestamp?: number;
+    /**
+     * @description 会话的图标元素，用于视觉识别
+     * @descriptionEn Icon element for the conversation for visual identification
+     */
+    icon?: React.ReactNode;
+    /**
+     * @description 是否禁用该会话，影响交互功能
+     * @descriptionEn Whether to disable this conversation, affects interaction functionality
+     */
+    disabled?: boolean;
+    /**
+     * @description 是否在时间线中显示该会话，用于分组显示
+     * @descriptionEn Whether to show this conversation in timeline for grouped display
+     */
+    timeline?: boolean;
+}
+export type GroupSorter = Parameters<GroupType[]['sort']>[0];
+export type GroupTitleRenderComponents = {
+    components: {
+        GroupTitle: React.ComponentType<GroupTitleProps>;
+    };
+};
+export type GroupTitleRender = ((group: GroupType, info: GroupTitleRenderComponents) => React.ReactNode) | undefined;
+export interface Groupable {
+    /**
+     * @description 会话分组的排序函数，用于自定义排序逻辑
+     * @descriptionEn Sorting function for conversation grouping for custom sorting logic
+     */
+    sort?: GroupSorter;
+    /**
+     * @description 自定义分组标题的渲染函数，用于个性化显示
+     * @descriptionEn Custom rendering function for group titles for personalized display
+     */
+    title?: GroupTitleRender;
+}
+export {};

package/lib/Conversations/style.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => () => import("react/jsx-runtime").JSX.Element;
+export default _default;