@ai-group/chat-sdk 3.7.1-alpha1 → 3.7.1-alpha3

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useXAi","XAiProvider","XAiChatbot","XAiSDK","XAiSender","FileGallery","XAiConversations","XAdkThoughtChain","useXAiSDK","request","XAdkProvider","XAdkChatbot","XAdkSender","useADKChat","baseChatStrategies","basePreset","baseToolKindResolver","mergeChatStrategies","resolvePresetUploadRequest","resolveChatPreset","createXGroupUploadRequest","xGroupAdkPreset","xGroupToolKindResolver","useChatState","useChatActions","useSession","FolderTree","default","MarkdownRender","FunctionCallRender","ThinkRender","tokens","tokenDefaults","token","cssVarStyle","useAdkConversation","createXGroupOpenApiTransport"],"sources":["../../src/index.ts"],"sourcesContent":["// index.ts\nimport { useXAi } from \"./context/AiProviderContext\";\nimport XAiProvider from \"./components/XAiProvider\";\nimport XAiChatbot from \"./components/XAiChatbot\";\nimport XAiSDK from \"./components/XAiSDK\";\nimport XAiSender from \"./components/XAiSender\";\nimport FileGallery from \"./components/FileGallery\";\nimport XAiConversations from \"./components/XAiConversations\";\nimport XAdkThoughtChain from \"./components/XAdkThoughtChain\";\nimport useXAiSDK from \"./hooks/useXAiSDK\";\nimport request from \"./utils/request\";\n\n// 新的 Compound Components 架构\nimport XAdkProvider from \"./components/XAdkProvider\";\nimport XAdkChatbot from \"./components/XAdkChatbot\";\nimport XAdkSender from \"./components/XAdkSender\";\nimport useADKChat from \"./hooks/useADKChat\";\nimport {\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  createXGroupUploadRequest,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n} from \"./presets/xgroup\";\n\n// 导出新的 Context Hooks\nexport {\n  useChatState,\n  useChatActions,\n  useSession,\n} from \"./components/XAdkProvider/context\";\n\nexport * from \"./types\";\n\n// 导出自定义 Hook 相关类型\nexport type { ChatHookResult, ChatHookFactory } from \"./types/ChatHook\";\n\n// 旧 API - 保持向后兼容\nexport {\n  useXAi,\n  XAiProvider,\n  XAiChatbot,\n  XAiSDK,\n  XAiSender,\n  XAiConversations,\n  useXAiSDK,\n  request,\n};\n\n// 新 API - 推荐使用\nexport {\n  XAdkProvider,\n  XAdkChatbot,\n  XAdkSender,\n  FileGallery,\n  XAdkThoughtChain,\n  useADKChat,\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  createXGroupUploadRequest,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n};\n\n// FolderTree 文件树组件\nimport FolderTree from \"./components/FolderTree\";\nexport { FolderTree };\nexport type {\n  FolderTreeProps,\n  FolderTreeData,\n  FileContentService,\n  FolderTreeRef,\n} from \"./components/FolderTree\";\n\n// 基础组件导出 - 供高级用户和业务侧使用\nexport { default as MarkdownRender } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport { default as FunctionCallRender } from \"./components/XAdkChatbot/components/FunctionCallRender\";\nexport { default as ThinkRender } from \"./components/XAdkChatbot/components/ThinkRender\";\n\n// 基础组件类型导出\nexport type { MarkdownRenderProps } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport type { FunctionCallRenderProps } from \"./types/FunctionCallRender\";\nexport type {\n  XAdkThoughtChainProps,\n  ThoughtChainItemType,\n  ThoughtChainStatus,\n} from \"./types/XAdkThoughtChain\";\n\n// 设计令牌导出 - 供引用方覆盖样式\nexport { tokens, tokenDefaults, token, cssVarStyle } from \"./styles/tokens\";\n\n// Headless ADK data-flow APIs\nexport * from \"./core\";\nexport { default as useAdkConversation } from \"./react/useAdkConversation\";\nexport type { UseAdkConversationResult } from \"./react/useAdkConversation\";\nexport { createXGroupOpenApiTransport } from \"./presets/xgroup\";\nexport type { XGroupOpenApiTransportOptions } from \"./presets/xgroup\";\n"],"mappings":"AAAA;AACA,SAASA,MAAM;AACf,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,MAAM;AACb,OAAOC,SAAS;AAChB,OAAOC,WAAW;AAClB,OAAOC,gBAAgB;AACvB,OAAOC,gBAAgB;AACvB,OAAOC,SAAS;AAChB,OAAOC,OAAO;;AAEd;AACA,OAAOC,YAAY;AACnB,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,UAAU;AACjB,SACEC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBC,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBC,yBAAyB,EACzBC,eAAe,EACfC,sBAAsB;;AAGxB;AACA,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU;AAGZ;;AAEA;;AAGA;AACA,SACEzB,MAAM,EACNC,WAAW,EACXC,UAAU,EACVC,MAAM,EACNC,SAAS,EACTE,gBAAgB,EAChBE,SAAS,EACTC,OAAO;;AAGT;AACA,SACEC,YAAY,EACZC,WAAW,EACXC,UAAU,EACVP,WAAW,EACXE,gBAAgB,EAChBM,UAAU,EACVC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBI,yBAAyB,EACzBH,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBE,eAAe,EACfC,sBAAsB;;AAGxB;AACA,OAAOI,UAAU;AACjB,SAASA,UAAU;AAQnB;AACA,SAASC,OAAO,IAAIC,cAAc;AAClC,SAASD,OAAO,IAAIE,kBAAkB;AACtC,SAASF,OAAO,IAAIG,WAAW;;AAE/B;;AASA;AACA,SAASC,MAAM,EAAEC,aAAa,EAAEC,KAAK,EAAEC,WAAW;;AAElD;AACA;AACA,SAASP,OAAO,IAAIQ,kBAAkB;AAEtC,SAASC,4BAA4B"}
+{"version":3,"names":["useXAi","XAiProvider","XAiChatbot","XAiSDK","XAiSender","FileGallery","XAiConversations","XAdkThoughtChain","useXAiSDK","request","XAdkProvider","XAdkChatbot","XAdkSender","useADKChat","baseChatStrategies","basePreset","baseToolKindResolver","mergeChatStrategies","resolvePresetUploadRequest","resolveChatPreset","createXGroupUploadRequest","xGroupAdkPreset","xGroupToolKindResolver","useChatState","useChatActions","useSession","Sources","FolderTree","default","MarkdownRender","FunctionCallRender","ThinkRender","tokens","tokenDefaults","token","cssVarStyle","useAdkConversation","createXGroupOpenApiTransport"],"sources":["../../src/index.ts"],"sourcesContent":["// index.ts\nimport { useXAi } from \"./context/AiProviderContext\";\nimport XAiProvider from \"./components/XAiProvider\";\nimport XAiChatbot from \"./components/XAiChatbot\";\nimport XAiSDK from \"./components/XAiSDK\";\nimport XAiSender from \"./components/XAiSender\";\nimport FileGallery from \"./components/FileGallery\";\nimport XAiConversations from \"./components/XAiConversations\";\nimport XAdkThoughtChain from \"./components/XAdkThoughtChain\";\nimport useXAiSDK from \"./hooks/useXAiSDK\";\nimport request from \"./utils/request\";\n\n// 新的 Compound Components 架构\nimport XAdkProvider from \"./components/XAdkProvider\";\nimport XAdkChatbot from \"./components/XAdkChatbot\";\nimport XAdkSender from \"./components/XAdkSender\";\nimport useADKChat from \"./hooks/useADKChat\";\nimport {\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  createXGroupUploadRequest,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n} from \"./presets/xgroup\";\n\n// 导出新的 Context Hooks\nexport {\n  useChatState,\n  useChatActions,\n  useSession,\n} from \"./components/XAdkProvider/context\";\n\nexport * from \"./types\";\n\n// 导出自定义 Hook 相关类型\nexport type { ChatHookResult, ChatHookFactory } from \"./types/ChatHook\";\n\n// 旧 API - 保持向后兼容\nexport {\n  useXAi,\n  XAiProvider,\n  XAiChatbot,\n  XAiSDK,\n  XAiSender,\n  XAiConversations,\n  useXAiSDK,\n  request,\n};\n\n// 新 API - 推荐使用\nexport {\n  XAdkProvider,\n  XAdkChatbot,\n  XAdkSender,\n  FileGallery,\n  XAdkThoughtChain,\n  useADKChat,\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  createXGroupUploadRequest,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n};\n\n// Sources 来源引用组件\nimport Sources from \"./components/Sources\";\nexport { Sources };\nexport type { SourcesProps, SourcesItem, SourcesRef } from \"./types/Sources\";\n\n// FolderTree 文件树组件\nimport FolderTree from \"./components/FolderTree\";\nexport { FolderTree };\nexport type {\n  FolderTreeProps,\n  FolderTreeData,\n  FileContentService,\n  FolderTreeRef,\n} from \"./components/FolderTree\";\n\n// 基础组件导出 - 供高级用户和业务侧使用\nexport { default as MarkdownRender } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport { default as FunctionCallRender } from \"./components/XAdkChatbot/components/FunctionCallRender\";\nexport { default as ThinkRender } from \"./components/XAdkChatbot/components/ThinkRender\";\n\n// 基础组件类型导出\nexport type { MarkdownRenderProps } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport type { FunctionCallRenderProps } from \"./types/FunctionCallRender\";\nexport type {\n  XAdkThoughtChainProps,\n  ThoughtChainItemType,\n  ThoughtChainStatus,\n} from \"./types/XAdkThoughtChain\";\n\n// 设计令牌导出 - 供引用方覆盖样式\nexport { tokens, tokenDefaults, token, cssVarStyle } from \"./styles/tokens\";\n\n// Headless ADK data-flow APIs\nexport * from \"./core\";\nexport { default as useAdkConversation } from \"./react/useAdkConversation\";\nexport type { UseAdkConversationResult } from \"./react/useAdkConversation\";\nexport { createXGroupOpenApiTransport } from \"./presets/xgroup\";\nexport type { XGroupOpenApiTransportOptions } from \"./presets/xgroup\";\n"],"mappings":"AAAA;AACA,SAASA,MAAM;AACf,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,MAAM;AACb,OAAOC,SAAS;AAChB,OAAOC,WAAW;AAClB,OAAOC,gBAAgB;AACvB,OAAOC,gBAAgB;AACvB,OAAOC,SAAS;AAChB,OAAOC,OAAO;;AAEd;AACA,OAAOC,YAAY;AACnB,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,UAAU;AACjB,SACEC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBC,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBC,yBAAyB,EACzBC,eAAe,EACfC,sBAAsB;;AAGxB;AACA,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU;AAGZ;;AAEA;;AAGA;AACA,SACEzB,MAAM,EACNC,WAAW,EACXC,UAAU,EACVC,MAAM,EACNC,SAAS,EACTE,gBAAgB,EAChBE,SAAS,EACTC,OAAO;;AAGT;AACA,SACEC,YAAY,EACZC,WAAW,EACXC,UAAU,EACVP,WAAW,EACXE,gBAAgB,EAChBM,UAAU,EACVC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBI,yBAAyB,EACzBH,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBE,eAAe,EACfC,sBAAsB;;AAGxB;AACA,OAAOI,OAAO;AACd,SAASA,OAAO;AAGhB;AACA,OAAOC,UAAU;AACjB,SAASA,UAAU;AAQnB;AACA,SAASC,OAAO,IAAIC,cAAc;AAClC,SAASD,OAAO,IAAIE,kBAAkB;AACtC,SAASF,OAAO,IAAIG,WAAW;;AAE/B;;AASA;AACA,SAASC,MAAM,EAAEC,aAAa,EAAEC,KAAK,EAAEC,WAAW;;AAElD;AACA;AACA,SAASP,OAAO,IAAIQ,kBAAkB;AAEtC,SAASC,4BAA4B"}

package/dist/esm/types/FileGallery.d.ts

@@ -27,9 +27,12 @@ export type ImageDisplayMode = "thumbnail" | "preview" | "full";
 export type MediaDisplayMode = "inline" | "card";
 /** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */
 export type FileCardType = "file" | "image" | "audio" | "video";
+/** 文件卡片尺寸：default 适合消息区，small 适合输入框上下文区 */
+export type FileGallerySize = "default" | "small";
 export interface FileGalleryProps {
     file: FileItem;
     align?: "left" | "right";
+    size?: FileGallerySize;
     removable?: boolean;
     onRemove?: (id: string) => void;
     className?: string;

package/dist/esm/types/FileGallery.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/FileGallery.ts"],"sourcesContent":["/**\n * 统一的文件数据接口\n * 兼容 LocalFile (XAdkSender) 和 FileData (XadkChatbot)\n */\nexport interface FileItem {\n  // 基础字段\n  id?: string;\n  uid?: string;\n  name?: string;\n  displayName?: string;\n  size?: number;\n  type?: string;\n  mimeType?: string;\n\n  // 本地文件对象 (XAdkSender)\n  file?: File;\n\n  // 上传状态 (XAdkSender)\n  status?: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  progress?: number;\n  errorMessage?: string;\n\n  // URL 字段\n  fileUri?: string; // XadkChatbot\n  tempUrl?: string; // XAdkSender\n  response?: any;\n}\n\n/** 文件图标类型 */\nexport type FileIconType =\n  | \"pdf\"\n  | \"word\"\n  | \"excel\"\n  | \"ppt\"\n  | \"audio\"\n  | \"video\"\n  | \"zip\"\n  | \"markdown\"\n  | \"image\"\n  | \"default\";\n\n/** 图片展示模式 */\nexport type ImageDisplayMode = \"thumbnail\" | \"preview\" | \"full\";\n\n/** 音视频展示模式 */\nexport type MediaDisplayMode = \"inline\" | \"card\";\n\n/** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */\nexport type FileCardType = \"file\" | \"image\" | \"audio\" | \"video\";\n\nexport interface FileGalleryProps {\n  file: FileItem;\n  align?: \"left\" | \"right\"; // 卡片内部布局：图标在左(默认)或右\n  removable?: boolean;\n  onRemove?: (id: string) => void;\n  className?: string;\n  style?: React.CSSProperties;\n  /** 点击文件卡片回调（非图片、非音视频文件） */\n  onClick?: (file: FileItem) => void;\n\n  /**\n   * 文件卡片类型\n   * - 不传：自动根据文件扩展名/MIME推断，图片/音频/视频使用原生渲染\n   * - 'file'：强制以附件卡片展示（音视频不可播放）\n   * - 'image' / 'audio' / 'video'：强制指定类型\n   */\n  type?: FileCardType;\n\n  // ========== 图片相关 ==========\n  /** 图片展示模式: thumbnail(缩略图) | preview(中等预览) | full(全宽) */\n  imageDisplayMode?: ImageDisplayMode;\n  /** 图片自定义宽度 */\n  imageWidth?: number | string;\n  /** 图片自定义高度 */\n  imageHeight?: number | string;\n  /** 图片加载策略 */\n  imageLoading?: \"lazy\" | \"eager\";\n  /** 图片 alt 文本 */\n  imageAlt?: string;\n\n  // ========== 音视频相关 ==========\n  /** 自动播放(仅音频) */\n  mediaAutoPlay?: boolean;\n  /** 循环播放 */\n  mediaLoop?: boolean;\n  /** 静音 */\n  mediaMuted?: boolean;\n  /** 视频封面图 URL */\n  mediaPoster?: string;\n  /** 透传给原生 video 标签的属性 */\n  videoProps?: Partial<React.JSX.IntrinsicElements[\"video\"]>;\n  /** 透传给原生 audio 标签的属性 */\n  audioProps?: Partial<React.JSX.IntrinsicElements[\"audio\"]>;\n\n  // ========== 自定义图标 ==========\n  /** 按文件类型自定义图标映射 */\n  iconMap?: Partial<Record<FileIconType, React.ReactNode>>;\n  /** 完全自定义图标（优先级最高，覆盖所有类型） */\n  customIcon?: React.ReactNode;\n}\n\nexport interface FileItemComponentProps {\n  file: FileItem;\n  removable: boolean;\n  onRemove: (id: string) => void;\n}\n"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/FileGallery.ts"],"sourcesContent":["/**\n * 统一的文件数据接口\n * 兼容 LocalFile (XAdkSender) 和 FileData (XadkChatbot)\n */\nexport interface FileItem {\n  // 基础字段\n  id?: string;\n  uid?: string;\n  name?: string;\n  displayName?: string;\n  size?: number;\n  type?: string;\n  mimeType?: string;\n\n  // 本地文件对象 (XAdkSender)\n  file?: File;\n\n  // 上传状态 (XAdkSender)\n  status?: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  progress?: number;\n  errorMessage?: string;\n\n  // URL 字段\n  fileUri?: string; // XadkChatbot\n  tempUrl?: string; // XAdkSender\n  response?: any;\n}\n\n/** 文件图标类型 */\nexport type FileIconType =\n  | \"pdf\"\n  | \"word\"\n  | \"excel\"\n  | \"ppt\"\n  | \"audio\"\n  | \"video\"\n  | \"zip\"\n  | \"markdown\"\n  | \"image\"\n  | \"default\";\n\n/** 图片展示模式 */\nexport type ImageDisplayMode = \"thumbnail\" | \"preview\" | \"full\";\n\n/** 音视频展示模式 */\nexport type MediaDisplayMode = \"inline\" | \"card\";\n\n/** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */\nexport type FileCardType = \"file\" | \"image\" | \"audio\" | \"video\";\n\n/** 文件卡片尺寸：default 适合消息区，small 适合输入框上下文区 */\nexport type FileGallerySize = \"default\" | \"small\";\n\nexport interface FileGalleryProps {\n  file: FileItem;\n  align?: \"left\" | \"right\"; // 卡片内部布局：图标在左(默认)或右\n  size?: FileGallerySize;\n  removable?: boolean;\n  onRemove?: (id: string) => void;\n  className?: string;\n  style?: React.CSSProperties;\n  /** 点击文件卡片回调（非图片、非音视频文件） */\n  onClick?: (file: FileItem) => void;\n\n  /**\n   * 文件卡片类型\n   * - 不传：自动根据文件扩展名/MIME推断，图片/音频/视频使用原生渲染\n   * - 'file'：强制以附件卡片展示（音视频不可播放）\n   * - 'image' / 'audio' / 'video'：强制指定类型\n   */\n  type?: FileCardType;\n\n  // ========== 图片相关 ==========\n  /** 图片展示模式: thumbnail(缩略图) | preview(中等预览) | full(全宽) */\n  imageDisplayMode?: ImageDisplayMode;\n  /** 图片自定义宽度 */\n  imageWidth?: number | string;\n  /** 图片自定义高度 */\n  imageHeight?: number | string;\n  /** 图片加载策略 */\n  imageLoading?: \"lazy\" | \"eager\";\n  /** 图片 alt 文本 */\n  imageAlt?: string;\n\n  // ========== 音视频相关 ==========\n  /** 自动播放(仅音频) */\n  mediaAutoPlay?: boolean;\n  /** 循环播放 */\n  mediaLoop?: boolean;\n  /** 静音 */\n  mediaMuted?: boolean;\n  /** 视频封面图 URL */\n  mediaPoster?: string;\n  /** 透传给原生 video 标签的属性 */\n  videoProps?: Partial<React.JSX.IntrinsicElements[\"video\"]>;\n  /** 透传给原生 audio 标签的属性 */\n  audioProps?: Partial<React.JSX.IntrinsicElements[\"audio\"]>;\n\n  // ========== 自定义图标 ==========\n  /** 按文件类型自定义图标映射 */\n  iconMap?: Partial<Record<FileIconType, React.ReactNode>>;\n  /** 完全自定义图标（优先级最高，覆盖所有类型） */\n  customIcon?: React.ReactNode;\n}\n\nexport interface FileItemComponentProps {\n  file: FileItem;\n  removable: boolean;\n  onRemove: (id: string) => void;\n}\n"],"mappings":""}

package/dist/esm/types/Sources.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+export type SemanticType = 'root' | 'title' | 'content';
+export interface SourcesItem {
+    key?: React.Key;
+    title: React.ReactNode;
+    url?: string;
+    icon?: React.ReactNode;
+    description?: React.ReactNode;
+}
+export interface SourcesProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {
+    prefixCls?: string;
+    style?: React.CSSProperties;
+    styles?: Partial<Record<SemanticType, React.CSSProperties>>;
+    className?: string;
+    classNames?: Partial<Record<SemanticType, string>>;
+    rootClassName?: string;
+    inline?: boolean;
+    items?: Array<SourcesItem>;
+    title?: React.ReactNode;
+    expandIconPosition?: 'start' | 'end';
+    onClick?: (item: SourcesItem) => void;
+    popoverOverlayWidth?: number | string;
+    activeKey?: React.Key;
+    expanded?: boolean;
+    onExpand?: (expand: boolean) => void;
+    defaultExpanded?: boolean;
+}
+export type SourcesRef = {
+    nativeElement: HTMLElement;
+};

package/dist/esm/types/Sources.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Sources.js.map

package/dist/esm/types/Sources.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/Sources.ts"],"sourcesContent":["export type SemanticType = 'root' | 'title' | 'content';\n\nexport interface SourcesItem {\n  key?: React.Key;\n  title: React.ReactNode;\n  url?: string;\n  icon?: React.ReactNode;\n  description?: React.ReactNode;\n}\n\nexport interface SourcesProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {\n  prefixCls?: string;\n  style?: React.CSSProperties;\n  styles?: Partial<Record<SemanticType, React.CSSProperties>>;\n  className?: string;\n  classNames?: Partial<Record<SemanticType, string>>;\n  rootClassName?: string;\n  inline?: boolean;\n  items?: Array<SourcesItem>;\n  title?: React.ReactNode;\n  expandIconPosition?: 'start' | 'end';\n  onClick?: (item: SourcesItem) => void;\n  popoverOverlayWidth?: number | string;\n  activeKey?: React.Key;\n  expanded?: boolean;\n  onExpand?: (expand: boolean) => void;\n  defaultExpanded?: boolean;\n}\n\nexport type SourcesRef = {\n  nativeElement: HTMLElement;\n};"],"mappings":""}

package/dist/esm/types/XAdkSender.d.ts

@@ -13,6 +13,8 @@ export interface QuickListOption {
 export interface QuickKeyConfig {
     /** 触发字符，如 '@', '#', '$' */
     key: string;
+    /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */
+    tagType?: string;
     /** 列表标题 */
     title?: string;
     /** 列表数据 */
@@ -28,6 +30,10 @@ export interface InputTag {
     label: string;
     /** 标签类型，如 'aggregation', 'skill', 'app' */
     type: string;
+    /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */
+    value?: string;
+    /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */
+    trigger?: string;
     color?: string;
     icon?: React.ReactNode;
     /** 原始数据 */
@@ -36,6 +42,32 @@ export interface InputTag {
 export interface InlineTagRenderInfo {
     onRemove: () => void;
 }
+export type XAdkSenderSubmitFormat = "text" | "structured" | "markdown" | "xml";
+export type XAdkSenderSubmitPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "tag";
+    tag: InputTag;
+};
+export interface XAdkSenderFormatTagContext {
+    format: Exclude<XAdkSenderSubmitFormat, "structured">;
+    index: number;
+}
+export interface XAdkSenderSubmitData<TPayload = unknown> {
+    /** 根据 submitFormat 生成的最终内容，默认是纯文本 */
+    text: string;
+    /** 去掉标签后的用户原始输入文本 */
+    rawText: string;
+    /** 当前提交格式 */
+    format: XAdkSenderSubmitFormat;
+    /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */
+    parts: XAdkSenderSubmitPart[];
+    files: ServerFile[];
+    tags?: InputTag[];
+    /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */
+    payload?: TPayload;
+}
 export interface UploadFileResult {
     fileName?: string;
     fileId?: string | number;
@@ -120,11 +152,7 @@ export interface SenderUIProps {
     defaultValue?: string;
     onClear?: () => void;
     onChange?: (value: string) => void;
-    onSubmit?: (data: {
-        text: string;
-        files: ServerFile[];
-        tags?: InputTag[];
-    }) => void;
+    onSubmit?: (data: XAdkSenderSubmitData) => void;
     onStop?: () => void;
     /** 自定义发送按钮渲染 */
     sendButtonRender?: (info: {
@@ -137,7 +165,7 @@ export interface SenderUIProps {
     }) => React.ReactNode;
     /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */
     suffix?: React.ReactNode | false | SlotRenderFunction;
-    /** 头部面板 */
+    /** 输入主体内部的头部内容 */
     header?: React.ReactNode | false | SlotRenderFunction;
     /** 前缀内容 */
     prefix?: React.ReactNode | false | SlotRenderFunction;
@@ -159,9 +187,27 @@ export interface SenderUIProps {
     onTagsChange?: (tags: InputTag[]) => void;
     /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */
     onQuickKeyTrigger?: (key: string, keyword: string) => void;
+    /**
+     * 提交内容格式：
+     * - text: 默认，输出文字 + 标签文本（如 /生图技能）
+     * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText
+     * - markdown/xml: 输出对应标记文本
+     */
+    submitFormat?: XAdkSenderSubmitFormat;
+    /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */
+    formatTag?: (tag: InputTag, context: XAdkSenderFormatTagContext) => string;
+    /**
+     * 基于 SDK 标准提交结构派生业务 payload。
+     * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。
+     */
+    transformSubmitData?: (data: Omit<XAdkSenderSubmitData, "payload">) => unknown;
 }
 export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
 export interface XAdkSenderHandle {
     addFiles: (files: File[]) => void;
+    /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */
+    insertTag: (tag: InputTag) => void;
+    /** 聚焦输入区 */
+    focus: () => void;
 }
 export {};

package/dist/esm/types/XAdkSender.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"sourcesContent":["// types/XAdkSender.ts\nimport React from \"react\";\n\n// ===================== 快捷键/标签相关类型 =====================\n\n/** 快捷键触发的列表项 */\nexport interface QuickListOption {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: React.ReactNode;\n  /** 分组名（用于聚合列表，子分组通过下划线分割） */\n  group?: string;\n  [key: string]: any;\n}\n\n/** 快捷键配置 */\nexport interface QuickKeyConfig {\n  /** 触发字符，如 '@', '#', '$' */\n  key: string;\n  /** 列表标题 */\n  title?: string;\n  /** 列表数据 */\n  options: QuickListOption[];\n  /** 自定义列表项渲染 */\n  renderItem?: (option: QuickListOption) => React.ReactNode;\n  /** 选中回调 */\n  onSelect?: (option: QuickListOption) => void;\n}\n\n/** 输入框内标签 */\nexport interface InputTag {\n  id: string;\n  label: string;\n  /** 标签类型，如 'aggregation', 'skill', 'app' */\n  type: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 原始数据 */\n  data?: any;\n}\n\nexport interface InlineTagRenderInfo {\n  onRemove: () => void;\n}\n\n// ===================== 上传相关类型 =====================\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  placeholder?: string;\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: {\n    text: string;\n    files: ServerFile[];\n    tags?: InputTag[];\n  }) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 头部面板 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */\n  footerLeft?: React.ReactNode | false | SlotRenderFunction;\n\n  // 快捷键/标签功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联标签渲染 */\n  renderTag?: (\n    tag: InputTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：标签列表 */\n  tags?: InputTag[];\n  /** 非受控：默认标签列表 */\n  defaultTags?: InputTag[];\n  /** 标签变化回调 */\n  onTagsChange?: (tags: InputTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n}\n"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"sourcesContent":["// types/XAdkSender.ts\nimport React from \"react\";\n\n// ===================== 快捷键/标签相关类型 =====================\n\n/** 快捷键触发的列表项 */\nexport interface QuickListOption {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: React.ReactNode;\n  /** 分组名（用于聚合列表，子分组通过下划线分割） */\n  group?: string;\n  [key: string]: any;\n}\n\n/** 快捷键配置 */\nexport interface QuickKeyConfig {\n  /** 触发字符，如 '@', '#', '$' */\n  key: string;\n  /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */\n  tagType?: string;\n  /** 列表标题 */\n  title?: string;\n  /** 列表数据 */\n  options: QuickListOption[];\n  /** 自定义列表项渲染 */\n  renderItem?: (option: QuickListOption) => React.ReactNode;\n  /** 选中回调 */\n  onSelect?: (option: QuickListOption) => void;\n}\n\n/** 输入框内标签 */\nexport interface InputTag {\n  id: string;\n  label: string;\n  /** 标签类型，如 'aggregation', 'skill', 'app' */\n  type: string;\n  /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */\n  value?: string;\n  /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */\n  trigger?: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 原始数据 */\n  data?: any;\n}\n\nexport interface InlineTagRenderInfo {\n  onRemove: () => void;\n}\n\nexport type XAdkSenderSubmitFormat = \"text\" | \"structured\" | \"markdown\" | \"xml\";\n\nexport type XAdkSenderSubmitPart =\n  | { type: \"text\"; text: string }\n  | { type: \"tag\"; tag: InputTag };\n\nexport interface XAdkSenderFormatTagContext {\n  format: Exclude<XAdkSenderSubmitFormat, \"structured\">;\n  index: number;\n}\n\nexport interface XAdkSenderSubmitData<TPayload = unknown> {\n  /** 根据 submitFormat 生成的最终内容，默认是纯文本 */\n  text: string;\n  /** 去掉标签后的用户原始输入文本 */\n  rawText: string;\n  /** 当前提交格式 */\n  format: XAdkSenderSubmitFormat;\n  /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */\n  parts: XAdkSenderSubmitPart[];\n  files: ServerFile[];\n  tags?: InputTag[];\n  /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */\n  payload?: TPayload;\n}\n\n// ===================== 上传相关类型 =====================\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  placeholder?: string;\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: XAdkSenderSubmitData) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 输入主体内部的头部内容 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */\n  footerLeft?: React.ReactNode | false | SlotRenderFunction;\n\n  // 快捷键/标签功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联标签渲染 */\n  renderTag?: (\n    tag: InputTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：标签列表 */\n  tags?: InputTag[];\n  /** 非受控：默认标签列表 */\n  defaultTags?: InputTag[];\n  /** 标签变化回调 */\n  onTagsChange?: (tags: InputTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n  /**\n   * 提交内容格式：\n   * - text: 默认，输出文字 + 标签文本（如 /生图技能）\n   * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText\n   * - markdown/xml: 输出对应标记文本\n   */\n  submitFormat?: XAdkSenderSubmitFormat;\n  /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */\n  formatTag?: (\n    tag: InputTag,\n    context: XAdkSenderFormatTagContext,\n  ) => string;\n  /**\n   * 基于 SDK 标准提交结构派生业务 payload。\n   * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。\n   */\n  transformSubmitData?: (\n    data: Omit<XAdkSenderSubmitData, \"payload\">,\n  ) => unknown;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n  /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */\n  insertTag: (tag: InputTag) => void;\n  /** 聚焦输入区 */\n  focus: () => void;\n}\n"],"mappings":""}

package/dist/esm/types/index.d.ts

@@ -11,3 +11,4 @@ export * from "./FileGallery";
 export * from "./common";
 export * from "./FunctionCallRender";
 export * from "./ChatStrategies";
+export * from "./Sources";

package/dist/esm/types/index.js

@@ -11,4 +11,5 @@ export * from "./FileGallery";
 export * from "./common";
 export * from "./FunctionCallRender";
 export * from "./ChatStrategies";
+export * from "./Sources";
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from \"./XAiChatbot\";\nexport * from \"./XAiMessage\";\nexport * from \"./XAiProvider\";\nexport * from \"./XAiSender\";\nexport * from \"./XAiConversations\";\nexport * from \"./XAdkProvider\";\nexport * from \"./XAdkChatbot\";\nexport * from \"./XAdkSender\";\nexport * from \"./XAdkThoughtChain\";\nexport * from \"./FileGallery\";\nexport * from \"./common\";\nexport * from \"./FunctionCallRender\";\nexport * from \"./ChatStrategies\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"names":[],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from \"./XAiChatbot\";\nexport * from \"./XAiMessage\";\nexport * from \"./XAiProvider\";\nexport * from \"./XAiSender\";\nexport * from \"./XAiConversations\";\nexport * from \"./XAdkProvider\";\nexport * from \"./XAdkChatbot\";\nexport * from \"./XAdkSender\";\nexport * from \"./XAdkThoughtChain\";\nexport * from \"./FileGallery\";\nexport * from \"./common\";\nexport * from \"./FunctionCallRender\";\nexport * from \"./ChatStrategies\";\nexport * from \"./Sources\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}