one-design-next 0.0.59 → 0.0.61

package/dist/composer/index.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="react" />
+import type { IconName } from '../icon';
 import type { Attachment, ComposerSegment, SkillGroup, SkillItem, SendMeta } from '../_genui-types';
 import type { ChipData } from '../_genui-types';
 import type { ComposerParamPanelContext } from './param-panel';
@@ -7,6 +8,20 @@ export type { ComposerParamPanelContext } from './param-panel';
 export type ComposerTool = 'attachment' | 'webSearch' | 'skill';
 export type ComposerVariant = 'full' | 'lite';
 export type SubmitType = 'enter' | 'shiftEnter';
+/**
+ * 工具按钮的自定义配置。
+ * - `icon`：图标名称（Icon 组件的 name），字段不传则不渲染图标。
+ * - `label`：按钮文字，字段不传则不渲染文字。
+ * - 整个配置对象不传（key 不存在于 `toolConfigs`）时使用内置默认值。
+ * - 传了配置对象但 icon / label 字段都未设置时，兜底显示工具英文名
+ *   （如 "attachment" / "webSearch" / "skill"）作为 label，无图标，
+ *   方便开发者一眼看出配置遗漏。
+ */
+export interface ComposerToolConfig {
+    /** 图标名称，类型与 Icon 组件的 name 一致 */
+    icon?: IconName | (string & {});
+    label?: string;
+}
 export interface ComposerRef {
     /** 聚焦输入框 */
     focus: (options?: FocusOptions) => void;
@@ -102,6 +117,28 @@ export interface ComposerProps {
      * @default true
      */
     toolsLabeled?: boolean;
+    /**
+     * 各工具按钮的自定义配置（icon / label）。按 `ComposerTool` 类型做 key：
+     * - `attachment`：附件按钮
+     * - `webSearch`：联网按钮
+     * - `skill`：技能按钮
+     *
+     * **语义约定**：
+     * - key 不存在于 `toolConfigs` → 使用内置默认值（如附件 = paperclip + '附件'）
+     * - key 存在但配置对象中只有 `icon` → 只渲染图标
+     * - key 存在但配置对象中只有 `label` → 只渲染文字
+     * - key 存在但配置对象为空 `{}` → 兜底显示工具英文名（如 "attachment"）作为 label，无图标
+     *
+     * @example
+     * ```tsx
+     * toolConfigs={{
+     *   attachment: { icon: 'paperclip', label: '上传' },
+     *   webSearch: { label: '搜索' },        // 仅文字
+     *   skill: { icon: 'command' },           // 仅图标
+     * }}
+     * ```
+     */
+    toolConfigs?: Partial<Record<ComposerTool, ComposerToolConfig>>;
     /** 技能列表；当 tools 包含 'skill' 时生效 */
     skills?: SkillItem[];
     /**

package/dist/composer/index.js

@@ -55,7 +55,32 @@ function isFileAccepted(file, accept) {
     return !!mime && mime === rule;
   });
 }
+
+/**
+ * 工具按钮的自定义配置。
+ * - `icon`：图标名称（Icon 组件的 name），字段不传则不渲染图标。
+ * - `label`：按钮文字，字段不传则不渲染文字。
+ * - 整个配置对象不传（key 不存在于 `toolConfigs`）时使用内置默认值。
+ * - 传了配置对象但 icon / label 字段都未设置时，兜底显示工具英文名
+ *   （如 "attachment" / "webSearch" / "skill"）作为 label，无图标，
+ *   方便开发者一眼看出配置遗漏。
+ */
+
 var DEFAULT_TOOLS = ['attachment', 'webSearch', 'skill'];
+var DEFAULT_TOOL_CONFIGS = {
+  attachment: {
+    icon: 'paperclip',
+    label: '附件'
+  },
+  webSearch: {
+    icon: 'globe',
+    label: '联网'
+  },
+  skill: {
+    icon: 'command',
+    label: '技能'
+  }
+};
 export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   var _paramEdit$chipId;
   var valueProp = _ref.value,
@@ -80,6 +105,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     tools = _ref$tools === void 0 ? DEFAULT_TOOLS : _ref$tools,
     _ref$toolsLabeled = _ref.toolsLabeled,
     toolsLabeled = _ref$toolsLabeled === void 0 ? true : _ref$toolsLabeled,
+    toolConfigs = _ref.toolConfigs,
     skills = _ref.skills,
     skillGroups = _ref.skillGroups,
     onManageSkills = _ref.onManageSkills,
@@ -640,6 +666,26 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   var effectiveLabeled = isLite ? false : toolsLabeled;
   // lite 模式下仅允许一个工具按钮（数量在两态下保持恒定）
   var effectiveTools = isLite ? tools.slice(0, 1) : tools;
+
+  /* 统一解析 toolConfigs：
+   * - 不传 toolConfigs → 全部用 DEFAULT_TOOL_CONFIGS
+   * - 传了 toolConfigs → 每个 key 看用户配置：有 icon 或 label 就用它，否则兜底 { label: key }
+   */
+  var resolvedToolConfigs = function () {
+    if (!toolConfigs) return DEFAULT_TOOL_CONFIGS;
+    var resolve = function resolve(key) {
+      var cfg = toolConfigs[key];
+      if (cfg && (cfg.icon || cfg.label)) return cfg;
+      return {
+        label: key
+      };
+    };
+    return {
+      attachment: resolve('attachment'),
+      webSearch: resolve('webSearch'),
+      skill: resolve('skill')
+    };
+  }();
   if (process.env.NODE_ENV !== 'production' && isLite && tools.length > 1) {
     // eslint-disable-next-line no-console
     console.warn("[Composer] variant=\"lite\" \u4EC5\u652F\u6301\u4E00\u4E2A\u5DE5\u5177\u6309\u94AE\uFF0C\u5DF2\u5FFD\u7565\u5176\u4F59 ".concat(tools.length - 1, " \u4E2A\u3002\u82E5\u9700\u8981\u591A\u4E2A\u5DE5\u5177\u6309\u94AE\uFF0C\u8BF7\u4F7F\u7528 variant=\"full\"\u3002"));
@@ -652,6 +698,11 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
    * skill 的 Popover 在 disabled 时禁用 trigger，避免弹出菜单。 */
   var renderAttachmentBtn = function renderAttachmentBtn() {
     var btnDisabled = disabled || attachmentsDisabled;
+    var _resolvedToolConfigs$ = resolvedToolConfigs.attachment,
+      icon = _resolvedToolConfigs$.icon,
+      label = _resolvedToolConfigs$.label;
+    var showIcon = !!icon;
+    var showLabel = effectiveLabeled && !!label;
     return /*#__PURE__*/React.createElement(HoverFill, {
       key: "attachment",
       "data-odn-composer-tool-btn-wrap": true,
@@ -672,17 +723,22 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       },
       disabled: btnDisabled,
       "data-odn-composer-tool-btn": true,
-      "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
+      "data-odn-composer-tool-iconic": !showLabel || undefined,
       "data-odn-composer-tool-disabled": btnDisabled || undefined,
-      "aria-label": "\u9644\u4EF6",
+      "aria-label": label || 'attachment',
       "aria-disabled": btnDisabled || undefined,
-      title: effectiveLabeled ? undefined : '附件'
-    }, /*#__PURE__*/React.createElement(Icon, {
-      name: "paperclip",
+      title: showLabel ? undefined : label || 'attachment'
+    }, showIcon && /*#__PURE__*/React.createElement(Icon, {
+      name: icon,
       size: 16
-    }), effectiveLabeled && /*#__PURE__*/React.createElement("span", null, "\u9644\u4EF6")));
+    }), showLabel && /*#__PURE__*/React.createElement("span", null, label)));
   };
   var renderWebSearchBtn = function renderWebSearchBtn() {
+    var _resolvedToolConfigs$2 = resolvedToolConfigs.webSearch,
+      icon = _resolvedToolConfigs$2.icon,
+      label = _resolvedToolConfigs$2.label;
+    var showIcon = !!icon;
+    var showLabel = effectiveLabeled && !!label;
     return /*#__PURE__*/React.createElement(HoverFill, {
       key: "webSearch",
       "data-odn-composer-tool-btn-wrap": true,
@@ -703,23 +759,28 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       },
       disabled: disabled,
       "data-odn-composer-tool-btn": true,
-      "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
+      "data-odn-composer-tool-iconic": !showLabel || undefined,
       "data-odn-composer-tool-active": webSearch || undefined,
       "data-odn-composer-tool-disabled": disabled || undefined,
-      "aria-label": "\u8054\u7F51",
+      "aria-label": label || 'webSearch',
       "aria-pressed": webSearch,
       "aria-disabled": disabled || undefined,
-      title: effectiveLabeled ? undefined : '联网'
-    }, /*#__PURE__*/React.createElement(Icon, {
-      name: "globe",
+      title: showLabel ? undefined : label || 'webSearch'
+    }, showIcon && /*#__PURE__*/React.createElement(Icon, {
+      name: icon,
       size: 16
-    }), effectiveLabeled && /*#__PURE__*/React.createElement("span", null, "\u8054\u7F51")));
+    }), showLabel && /*#__PURE__*/React.createElement("span", null, label)));
   };
   var renderSkillBtn = function renderSkillBtn() {
     var hasAnySkills = skills && skills.length > 0 || skillGroups && skillGroups.some(function (g) {
       return g.skills.length > 0;
     });
     if (!hasAnySkills) return null;
+    var _resolvedToolConfigs$3 = resolvedToolConfigs.skill,
+      icon = _resolvedToolConfigs$3.icon,
+      label = _resolvedToolConfigs$3.label;
+    var showIcon = !!icon;
+    var showLabel = effectiveLabeled && !!label;
     return /*#__PURE__*/React.createElement(Popover, {
       key: "skill",
       trigger: "click",
@@ -759,16 +820,16 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
         return e.preventDefault();
       },
       "data-odn-composer-tool-btn": true,
-      "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
+      "data-odn-composer-tool-iconic": !showLabel || undefined,
       "data-odn-composer-tool-active": toolMenuOpen || undefined,
       "data-odn-composer-tool-disabled": disabled || undefined,
-      "aria-label": "\u6280\u80FD",
+      "aria-label": label || 'skill',
       "aria-disabled": disabled || undefined,
-      title: effectiveLabeled ? undefined : '技能'
-    }, /*#__PURE__*/React.createElement(Icon, {
-      name: "command",
+      title: showLabel ? undefined : label || 'skill'
+    }, showIcon && /*#__PURE__*/React.createElement(Icon, {
+      name: icon,
       size: 16
-    }), effectiveLabeled && /*#__PURE__*/React.createElement("span", null, "\u6280\u80FD"))));
+    }), showLabel && /*#__PURE__*/React.createElement("span", null, label))));
   };
   var toolNodes = effectiveTools.map(function (t) {
     if (t === 'attachment') return renderAttachmentBtn();

package/dist/index.d.ts

@@ -61,7 +61,7 @@ export { ClarifyDockPanel, ClarifyDockTrigger, useClarifyDockState, clarifyDockL
 export { default as Artifact, type ArtifactProps } from './artifact';
 export { default as Attachments, type AttachmentsProps } from './attachments';
 export { default as CodeBlock, type CodeBlockProps } from './code-block';
-export { default as Composer, type ComposerProps, type ComposerRef } from './composer';
+export { default as Composer, type ComposerProps, type ComposerRef, type ComposerToolConfig, type ComposerTool } from './composer';
 export { default as Invocation, InvocationParamPopover, type InvocationProps, type InvocationParamPopoverProps, } from './invocation';
 export { type ComposerParamPanelContext } from './composer/param-panel';
 export { default as Mention, type MentionProps } from './mention';
@@ -70,7 +70,7 @@ export { default as SkillSlot, type SkillSlotHandle, type SkillSlotProps } from
 export { default as ErrorBlock, type ErrorBlockProps } from './error-block';
 export { default as Fab, type FabProps } from './fab';
 export { default as MessageImage, type MessageImageProps, type MessageImageItem } from './message-image';
-export { default as PreviewPanel, type PreviewPanelProps } from './preview-panel';
+export { default as PreviewPanel, type PreviewPanelProps, type PreviewPanelActionTooltips } from './preview-panel';
 export { default as Sources, type SourcesProps } from './sources';
 export { default as Provenance, type ProvenanceProps, type ProvenanceType } from './provenance';
 export { default as StreamText, type StreamTextProps, type TypographyOverrides } from './stream-text';

package/dist/preview-panel/index.d.ts

@@ -1,6 +1,16 @@
 /// <reference types="react" />
 import type { PreviewTab } from '../_genui-types';
 import './style';
+export interface PreviewPanelActionTooltips {
+    /** "在浏览器打开"按钮的 tooltip 文案 */
+    openInBrowser?: React.ReactNode;
+    /** "下载"按钮的 tooltip 文案 */
+    download?: React.ReactNode;
+    /** "收起预览"按钮的 tooltip 文案 */
+    closeAll?: React.ReactNode;
+    /** "关闭抽屉"按钮的 tooltip 文案 */
+    closeContainer?: React.ReactNode;
+}
 export interface PreviewPanelProps {
     tabs: PreviewTab[];
     activeTabId?: string | null;
@@ -32,8 +42,13 @@ export interface PreviewPanelProps {
      * fill：展开时占满父容器宽度（用于 Drawer 内固定像素侧栏等场景）
      */
     widthMode?: 'half' | 'fill';
+    /**
+     * 操作按钮的 Tooltip 文案配置。传入对应字段时，hover 按钮会展示黑色 Tooltip；
+     * 未传则不渲染 Tooltip（向后兼容）。
+     */
+    actionTooltips?: PreviewPanelActionTooltips;
 }
-export declare function PreviewPanel({ tabs, activeTabId, onTabChange, onTabClose, onCloseAll, onCloseContainer, onDownload, onOpenInBrowser, open, emptyTitle, emptyDescription, widthMode, }: PreviewPanelProps): import("react").JSX.Element;
+export declare function PreviewPanel({ tabs, activeTabId, onTabChange, onTabClose, onCloseAll, onCloseContainer, onDownload, onOpenInBrowser, open, emptyTitle, emptyDescription, widthMode, actionTooltips, }: PreviewPanelProps): import("react").JSX.Element;
 export declare namespace PreviewPanel {
     var displayName: string;
 }

package/dist/preview-panel/index.js

@@ -1,29 +1,50 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["tooltip"];
 import { useRef } from 'react';
 import Button from "../button";
 import Icon from "../icon";
+import Tooltip from "../tooltip";
 import StreamText from "../stream-text";
 import { OdnOverlayVerticalScrollbar, useOverlayScrollbarReveal } from "../overlay-vertical-scrollbar";
 import "./style";
-export function PreviewPanel(_ref) {
-  var _ref2, _tabs$find;
-  var tabs = _ref.tabs,
-    activeTabId = _ref.activeTabId,
-    onTabChange = _ref.onTabChange,
-    onTabClose = _ref.onTabClose,
-    onCloseAll = _ref.onCloseAll,
-    onCloseContainer = _ref.onCloseContainer,
-    onDownload = _ref.onDownload,
-    onOpenInBrowser = _ref.onOpenInBrowser,
-    open = _ref.open,
-    _ref$emptyTitle = _ref.emptyTitle,
-    emptyTitle = _ref$emptyTitle === void 0 ? '暂无附件' : _ref$emptyTitle,
-    _ref$emptyDescription = _ref.emptyDescription,
-    emptyDescription = _ref$emptyDescription === void 0 ? '对话生成的附件会显示在这里' : _ref$emptyDescription,
-    _ref$widthMode = _ref.widthMode,
-    widthMode = _ref$widthMode === void 0 ? 'half' : _ref$widthMode;
-  var activeTab = (_ref2 = (_tabs$find = tabs.find(function (t) {
+/** 内部辅助：有 tooltip 文案时包裹 Tooltip，否则仅渲染按钮 */
+function ActionButton(_ref) {
+  var tooltip = _ref.tooltip,
+    btnProps = _objectWithoutProperties(_ref, _excluded);
+  var btn = /*#__PURE__*/React.createElement(Button, _extends({
+    light: true,
+    size: "medium"
+  }, btnProps));
+  if (tooltip) {
+    return /*#__PURE__*/React.createElement(Tooltip, {
+      placement: "bottom",
+      popup: tooltip
+    }, btn);
+  }
+  return btn;
+}
+export function PreviewPanel(_ref2) {
+  var _ref3, _tabs$find;
+  var tabs = _ref2.tabs,
+    activeTabId = _ref2.activeTabId,
+    onTabChange = _ref2.onTabChange,
+    onTabClose = _ref2.onTabClose,
+    onCloseAll = _ref2.onCloseAll,
+    onCloseContainer = _ref2.onCloseContainer,
+    onDownload = _ref2.onDownload,
+    onOpenInBrowser = _ref2.onOpenInBrowser,
+    open = _ref2.open,
+    _ref2$emptyTitle = _ref2.emptyTitle,
+    emptyTitle = _ref2$emptyTitle === void 0 ? '暂无附件' : _ref2$emptyTitle,
+    _ref2$emptyDescriptio = _ref2.emptyDescription,
+    emptyDescription = _ref2$emptyDescriptio === void 0 ? '对话生成的附件会显示在这里' : _ref2$emptyDescriptio,
+    _ref2$widthMode = _ref2.widthMode,
+    widthMode = _ref2$widthMode === void 0 ? 'half' : _ref2$widthMode,
+    actionTooltips = _ref2.actionTooltips;
+  var activeTab = (_ref3 = (_tabs$find = tabs.find(function (t) {
     return t.id === activeTabId;
-  })) !== null && _tabs$find !== void 0 ? _tabs$find : tabs[0]) !== null && _ref2 !== void 0 ? _ref2 : null;
+  })) !== null && _tabs$find !== void 0 ? _tabs$find : tabs[0]) !== null && _ref3 !== void 0 ? _ref3 : null;
   var isOpen = open !== null && open !== void 0 ? open : tabs.length > 0;
   var isEmpty = tabs.length === 0;
   var previewScrollRef = useRef(null);
@@ -102,44 +123,36 @@ export function PreviewPanel(_ref) {
     })));
   })), /*#__PURE__*/React.createElement("div", {
     "data-odn-preview-panel-actions": true
-  }, /*#__PURE__*/React.createElement(Button, {
-    light: true,
-    size: "medium",
+  }, /*#__PURE__*/React.createElement(ActionButton, {
+    tooltip: actionTooltips === null || actionTooltips === void 0 ? void 0 : actionTooltips.openInBrowser,
     icon: "arrow-up-right",
     onClick: handleOpenInBrowser,
     disabled: !activeTab,
     "data-odn-preview-panel-open-browser": true,
-    title: "\u5728\u6D4F\u89C8\u5668\u6253\u5F00",
     "aria-label": "\u5728\u6D4F\u89C8\u5668\u6253\u5F00"
-  }), onDownload && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Button, {
-    light: true,
-    size: "medium",
+  }), onDownload && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ActionButton, {
+    tooltip: actionTooltips === null || actionTooltips === void 0 ? void 0 : actionTooltips.download,
     icon: "download-2",
     onClick: function onClick() {
       return activeTab && onDownload(activeTab);
     },
     disabled: !activeTab,
     "data-odn-preview-panel-download": true,
-    title: "\u4E0B\u8F7D",
     "aria-label": "\u4E0B\u8F7D"
   }), /*#__PURE__*/React.createElement("span", {
     "data-odn-preview-panel-action-divider": true,
     "aria-hidden": true
-  })), /*#__PURE__*/React.createElement(Button, {
-    light: true,
-    size: "medium",
+  })), /*#__PURE__*/React.createElement(ActionButton, {
+    tooltip: actionTooltips === null || actionTooltips === void 0 ? void 0 : actionTooltips.closeAll,
     icon: "panel-right",
     onClick: onCloseAll,
     "data-odn-preview-panel-close-all": true,
-    title: "\u6536\u8D77\u9884\u89C8",
     "aria-label": "\u6536\u8D77\u9884\u89C8"
-  }), onCloseContainer && /*#__PURE__*/React.createElement(Button, {
-    light: true,
-    size: "medium",
+  }), onCloseContainer && /*#__PURE__*/React.createElement(ActionButton, {
+    tooltip: actionTooltips === null || actionTooltips === void 0 ? void 0 : actionTooltips.closeContainer,
     icon: "cancel",
     onClick: onCloseContainer,
     "data-odn-preview-panel-close-container": true,
-    title: "\u5173\u95ED\u62BD\u5C49",
     "aria-label": "\u5173\u95ED\u62BD\u5C49"
   }))), isEmpty ? /*#__PURE__*/React.createElement("div", {
     "data-odn-preview-panel-empty-state": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one-design-next",
-  "version": "0.0.59",
+  "version": "0.0.61",
   "description": "One Design Next from TAD@tencent.com",
   "packageManager": "pnpm@11.8.0",
   "module": "dist/index.js",