one-design-next 0.0.20 → 0.0.22

package/dist/chart/index.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import './style';
-export interface AvatarProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface ChartProps extends React.HTMLAttributes<HTMLDivElement> {
     /**
      * @description 是否禁用
      * @default false
@@ -10,5 +10,5 @@ export interface AvatarProps extends React.HTMLAttributes<HTMLDivElement> {
 /**
  * Chart 图表
  */
-declare const Chart: React.FC<AvatarProps>;
+declare const Chart: React.FC<ChartProps>;
 export default Chart;

package/dist/composer/editor.js

@@ -129,7 +129,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   var lastEditorRangeRef = useRef(null);
   /** 抑制换行后短窗口内的 selection 二次校正，避免首次 chip 后换行闪烁。 */
   var suppressSelectionNormalizeCountRef = useRef(0);
-  /** 用户刚执行“主动换行”时，允许 empty 判定在一次变更内保持非空。 */
+  /** 用户刚执行"主动换行"时，允许 empty 判定在一次变更内保持非空。 */
   var forceNonEmptyOnceRef = useRef(false);
 
   /** 派生：编辑器是否完全空（无文本 + 无 chip），驱动 placeholder。 */
@@ -137,17 +137,27 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     _useState2 = _slicedToArray(_useState, 2),
     empty = _useState2[0],
     setEmpty = _useState2[1];
-  /** 输入模态：键盘操作时置为 keyboard，用于抑制“鼠标隐藏但 hover 仍生效”的视觉残留。 */
-  var _useState3 = useState('pointer'),
+  /**
+   * contenteditable 的 DOM 由浏览器直接改写。受控模式下，输入后延后一帧校验：
+   * - 父组件已回写 value：DOM 与 valueProp 一致，不做事
+   * - 父组件未回写 value：把 DOM 拉回 valueProp，维持受控语义
+   */
+  var _useState3 = useState(0),
     _useState4 = _slicedToArray(_useState3, 2),
-    inputModality = _useState4[0],
-    setInputModality = _useState4[1];
+    controlledSyncTick = _useState4[0],
+    setControlledSyncTick = _useState4[1];
+  var controlledSyncRafRef = useRef(null);
+  /** 输入模态：键盘操作时置为 keyboard，用于抑制"鼠标隐藏但 hover 仍生效"的视觉残留。 */
+  var _useState5 = useState('pointer'),
+    _useState6 = _slicedToArray(_useState5, 2),
+    inputModality = _useState6[0],
+    setInputModality = _useState6[1];
 
   /** ScrollArea root 显式高度。Base UI viewport=100%，root 必须有确定 height。 */
-  var _useState5 = useState(null),
-    _useState6 = _slicedToArray(_useState5, 2),
-    scrollHeight = _useState6[0],
-    setScrollHeight = _useState6[1];
+  var _useState7 = useState(null),
+    _useState8 = _slicedToArray(_useState7, 2),
+    scrollHeight = _useState8[0],
+    setScrollHeight = _useState8[1];
 
   /** onHeightChange 用 ref 稳定，避免 ResizeObserver effect 反复 cleanup/重建。 */
   var onHeightChangeRef = useRef(onHeightChange);
@@ -189,9 +199,33 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   }, [minHeightPx, maxHeightPx]);
   var shouldShowPlaceholder = useCallback(function (el) {
     if (!isEditorEmpty(el)) return false;
-    // placeholder 仅在“单行且空内容”展示
-    var lineCount = el.querySelectorAll('br').length + 1;
-    return lineCount <= 1;
+    // 编辑器文本为空时，清理浏览器残留的 <br> 以确保 placeholder 正常显示
+    var brs = el.querySelectorAll('br');
+    if (brs.length > 0) {
+      brs.forEach(function (br) {
+        return br.remove();
+      });
+    }
+    return true;
+  }, []);
+  var scheduleControlledSync = useCallback(function () {
+    if (!isControlled) return;
+    if (controlledSyncRafRef.current != null) {
+      cancelAnimationFrame(controlledSyncRafRef.current);
+    }
+    controlledSyncRafRef.current = requestAnimationFrame(function () {
+      controlledSyncRafRef.current = null;
+      setControlledSyncTick(function (v) {
+        return v + 1;
+      });
+    });
+  }, [isControlled]);
+  useEffect(function () {
+    return function () {
+      if (controlledSyncRafRef.current != null) {
+        cancelAnimationFrame(controlledSyncRafRef.current);
+      }
+    };
   }, []);
   var fireChange = useCallback(function () {
     var el = editorRef.current;
@@ -205,9 +239,10 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     }
     forceNonEmptyOnceRef.current = false;
     onChange === null || onChange === void 0 || onChange(getPlainText(el));
+    scheduleControlledSync();
     // editor.height 锁定时 RO 不触发，主动同步一次，确保升格判定能拿到 scrollHeight
     syncHeight();
-  }, [onChange, shouldShowPlaceholder, syncHeight]);
+  }, [onChange, scheduleControlledSync, shouldShowPlaceholder, syncHeight]);
 
   /* ─────────────────────────────────────
    * chip 管理
@@ -283,7 +318,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
         var el = editorRef.current;
         if (!el) return;
         // 优先恢复缓存光标到真实 selection；菜单点击时 selection 已经离开 editor，
-        // 直接走 useChipManager 的 fallback 会落到 editor 末尾，导致“飞到第一/末行”。
+        // 直接走 useChipManager 的 fallback 会落到 editor 末尾，导致"飞到第一/末行"。
         var cached = lastEditorRangeRef.current;
         if (cached && cached.startContainer.isConnected && cached.endContainer.isConnected && el.contains(cached.startContainer) && el.contains(cached.endContainer)) {
           var sel = window.getSelection();
@@ -420,15 +455,21 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   }, [syncHeight]);
 
   /* ─────────────────────────────────────
-   * 受控同步：仅当外部 value 与内部 plain text 真不一致才重置 DOM
-   * 「最佳努力」受控——避免每次 keystroke 都重建 DOM 导致光标跳。
+   * 受控同步：仅在外部 value 变化，或输入后延迟校验 tick 变化时校验 DOM。
+   * contenteditable 不像原生 input 会被 React 自动回写 value；如果父组件
+   * 在 onChange 里不回写，DOM 会继续保留用户刚输入的内容，造成"看起来受控，
+   * 实际脱离 valueProp"的假受控状态。
+   *
+   * 不能每次 render 都同步：输入换行会触发高度测量等内部 render，若此时父组件
+   * 正常回写 value 尚未完成，就会被旧 valueProp 抢先覆盖 DOM，导致光标跳回行首。
+   * 因此输入后用 requestAnimationFrame 延后一拍，只在父组件没回写时兜底。
    *
    * 注：当前阶段还未实现「从 marker 反序列化 chip」，所以重置 DOM 时
    * 只是 textContent= 写入；marker 字符会进入 DOM 当作不可见文本。
    * 同时必须 resetChips()，否则旧的 chip host 已被销毁，但 React state
    * 里残留的 chip 数据会让 portal 渲染挂在 detached node（沉默泄漏）。
    * ───────────────────────────────────── */
-  useEffect(function () {
+  useLayoutEffect(function () {
     if (!isControlled) return;
     var el = editorRef.current;
     if (!el) return;
@@ -441,8 +482,9 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
         triggerRef.current = null;
         onTriggerChange === null || onTriggerChange === void 0 || onTriggerChange(null);
       }
+      syncHeight();
     }
-  }, [valueProp, isControlled, resetChips, onTriggerChange]);
+  }, [controlledSyncTick, isControlled, onTriggerChange, resetChips, shouldShowPlaceholder, syncHeight, valueProp]);
 
   /* ─────────────────────────────────────
    * 输入事件
@@ -531,7 +573,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
           var node = range.startContainer,
             offset = range.startOffset;
 
-          // 用户换行生成的 "<br> + CARET_SPACER"：一次 Backspace 应合并删除，避免看起来“卡一下”
+          // 用户换行生成的 "<br> + CARET_SPACER"：一次 Backspace 应合并删除，避免看起来"卡一下"
           {
             var spacerText = null;
             var br = null;

package/dist/composer/index.d.ts

@@ -55,6 +55,12 @@ export interface ComposerProps {
      * - 返回 `false` 或 `Promise<false>` → 发送失败，**不清空**输入框与附件。
      * - 返回 `void` / `true` 或 `Promise<void | true>` → 发送成功，正常清空。
      * - 不返回（旧用法）→ 视为成功，保持向后兼容。
+     *
+     * **清空范围（重要）**：组件只清空它自己拥有的内部状态。
+     * - `value` / `attachments` 受控时，发送后组件**不会**自动清空也不会
+     *   代抛 onChange('') / onAttachmentsChange([])；如需清空，请在 onSend
+     *   内自行 `setValue('')` / `setAttachments([])`。
+     * - `value` / `attachments` 非受控时，组件按上述返回值语义自动清空。
      */
     onSend: (segments: ComposerSegment[], meta?: SendMeta) => void | boolean | Promise<void | boolean>;
     onStop?: () => void;

package/dist/composer/index.js

@@ -268,10 +268,24 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
    *   - meta：attachments / webSearch 等非正文数据；都为空时不传
    *
    * 需要单串文本的业务方在 onSend 内自行调 segmentsToReadableText。
-   * onSend 返回 false 或 Promise<false> 时视为发送失败，不清空；否则正常清空。 */
+   * onSend 返回 false 或 Promise<false> 时视为发送失败，不清空；否则正常清空。
+   *
+   * 清空策略按受控/非受控分两条路径——受控时**完全不动** value / attachments，
+   * 把决策权留给业务方（在 onSend 内自行 setValue('') / setAttachments([])）：
+   *
+   * - 受控 value：editor.clear() 会直接 innerHTML='' + resetChips()，
+   *   若业务方未立即把 valueProp 回写为 ''，editor 的受控同步 effect 会用
+   *   旧 valueProp 重置 textContent，但 chip host 已销毁、chip state 已清，
+   *   导致 chip 永久丢失 + 文本闪一下又回来。
+   *   也不能由组件代抛 onChange('')——常见写法 `onChange={setValue}` 会被
+   *   立即回写，等于组件强行清空 value，违反受控合约。
+   * - 受控 attachments：useControlledState 的 setter 写不进 mergedValue；
+   *   也不能代抛 onAttachmentsChange([])——同样会被业务方常见的
+   *   `onAttachmentsChange={setAttachments}` 直接回写。
+   * - webSearch 无受控接口，直接清。 */
   var handleSend = useCallback( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-    var _editorRef$current$ge2, _editorRef$current10, _editorRef$current11;
-    var chips, segments, hasAttachments, meta, hasMeta, result;
+    var _editorRef$current$ge2, _editorRef$current10;
+    var chips, segments, hasAttachments, meta, hasMeta, result, _editorRef$current11;
     return _regeneratorRuntime().wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -305,15 +319,19 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
           return _context.abrupt("return");
         case 16:
           closeParamPanel();
-          (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.clear();
-          setAttachments([]);
+          if (valueProp === undefined) {
+            (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.clear();
+          }
+          if (attachmentsProp === undefined) {
+            setAttachments([]);
+          }
           setWebSearch(false);
         case 20:
         case "end":
           return _context.stop();
       }
     }, _callee);
-  })), [text, attachments, webSearch, onSend, disabled, closeParamPanel]);
+  })), [text, attachments, webSearch, onSend, disabled, closeParamPanel, valueProp, attachmentsProp, setAttachments]);
 
   /* ---- File upload ----
    * 三入口（按钮 / 拖入 / 粘贴）共用此函数。先做内置校验（数量、单文件体积、重名），
@@ -459,6 +477,10 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     });
   }, [skills, triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.query]);
 
+  /* trigger 浮层渲染条件：editor 处于 `/` 触发态 + 业务方传了 skills。
+   * `@` 触发本轮不接（mention 数据源待业务接入），onTriggerChange 拿到也不弹。 */
+  var triggerMenuVisible = !!(triggerInfo && triggerInfo.trigger === '/' && skills && skills.length > 0);
+
   /* query 变化或浮层关闭 → 高亮项重置到第一项。
    * 用 query 而不是 triggerInfo 整体当依赖：rect 变化（光标移位）不应该 reset。 */
   useEffect(function () {
@@ -470,6 +492,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
    * - Enter / Tab 选中当前高亮项
    * - Escape 关 menu，焦点保留在 editor */
   var handleTriggerKeyDown = useCallback(function (e) {
+    if (!triggerMenuVisible) return false;
     var list = filteredSkills;
     var max = list ? list.length - 1 : -1;
     if (e.key === 'ArrowDown') {
@@ -500,7 +523,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       return true;
     }
     return false;
-  }, [filteredSkills, triggerActiveIndex]);
+  }, [filteredSkills, handleSelectSkill, triggerActiveIndex, triggerMenuVisible]);
 
   /* trigger 浮 anchor：跟随 caret 的 0×0 隐形元素，给 Popover 当 children。
    * Popover 需要 DOM children 当 reference，没有"虚拟 anchor" API，只能这么搞。 */
@@ -730,10 +753,6 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     "data-odn-composer-file-input": true,
     onChange: handleFileChange
   });
-
-  /* trigger 浮层渲染条件：editor 处于 `/` 触发态 + 业务方传了 skills。
-   * `@` 触发本轮不接（mention 数据源待业务接入），onTriggerChange 拿到也不弹。 */
-  var triggerMenuVisible = !!(triggerInfo && triggerInfo.trigger === '/' && skills && skills.length > 0);
   var paramPanelNode = function (_editorRef$current$ge3, _editorRef$current16, _boxRef$current) {
     if (!paramEdit || !renderParamPanel) return null;
     var chips = (_editorRef$current$ge3 = (_editorRef$current16 = editorRef.current) === null || _editorRef$current16 === void 0 ? void 0 : _editorRef$current16.getChips()) !== null && _editorRef$current$ge3 !== void 0 ? _editorRef$current$ge3 : [];

package/dist/drawer/index.d.ts

@@ -50,6 +50,10 @@ export interface DrawerProps {
      * @description 样式
      */
     style?: React.CSSProperties;
+    /**
+     * @description 抽屉宽度（仅左右抽屉生效）
+     */
+    width?: React.CSSProperties['width'];
     /**
      * @description 是否显示
      */

package/dist/drawer/index.js

@@ -53,6 +53,7 @@ var Drawer = function Drawer(_ref) {
     _ref$stepTransitionTy = _ref.stepTransitionType,
     stepTransitionType = _ref$stepTransitionTy === void 0 ? defaultProps.stepTransitionType : _ref$stepTransitionTy,
     style = _ref.style,
+    width = _ref.width,
     className = _ref.className,
     zIndex = _ref.zIndex,
     container = _ref.container,
@@ -146,9 +147,11 @@ var Drawer = function Drawer(_ref) {
       }
     }, 0);
   }, [steps, step]);
-  var drawerStyle = _objectSpread(_objectSpread({
+  var drawerStyle = _objectSpread(_objectSpread(_objectSpread({
     zIndex: zIndex ? Number(zIndex) : undefined
-  }, style), elevated ? {} : paddingStylePack);
+  }, placement === 'left' || placement === 'right' ? {
+    width: width
+  } : undefined), style), elevated ? {} : paddingStylePack);
   return /*#__PURE__*/React.createElement(ModalRoot, {
     open: visible,
     onOpenChange: onVisibleChange,

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { default as Button, type ButtonProps } from './button';
 export { default as Calendar, type CalendarProps } from './calendar';
 export { default as Cascader, type CascaderProps } from './cascader';
 export { default as Card, type CardProps, type CardElevation, type CardHeaderProps, type CardHeaderSize } from './card';
-export { default as Chart } from './chart';
+export { default as Chart, type ChartProps } from './chart';
 export { default as Checkbox, type CheckboxGroupProps, type CheckboxProps } from './checkbox';
 export { default as Collapse, type CollapseProps, type CollapseItem } from './collapse';
 export { default as ColorPicker, type ColorPickerProps } from './color-picker';
@@ -70,6 +70,7 @@ 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 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';
 export { default as Suggestions, type SuggestionsProps } from './suggestions';
 export { default as UserBubble, type UserBubbleProps } from './user-bubble';

package/dist/index.js

@@ -75,6 +75,7 @@ export { default as Fab } from "./fab";
 export { default as MessageImage } from "./message-image";
 export { default as PreviewPanel } from "./preview-panel";
 export { default as Sources } from "./sources";
+export { default as Provenance } from "./provenance";
 export { default as StreamText } from "./stream-text";
 export { default as Suggestions } from "./suggestions";
 export { default as UserBubble } from "./user-bubble";

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

@@ -7,6 +7,8 @@ export interface PreviewPanelProps {
     onTabChange?: (id: string) => void;
     onTabClose?: (id: string) => void;
     onCloseAll?: () => void;
+    /** 关闭外层容器（如关闭整个 Drawer） */
+    onCloseContainer?: () => void;
     /**
      * 下载当前激活标签。传入时在 header 右侧渲染下载按钮，点击时回调会收到当前激活 tab；
      * 未传则不渲染下载按钮（向后兼容）。
@@ -31,7 +33,7 @@ export interface PreviewPanelProps {
      */
     widthMode?: 'half' | 'fill';
 }
-export declare function PreviewPanel({ tabs, activeTabId, onTabChange, onTabClose, onCloseAll, 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, }: PreviewPanelProps): import("react").JSX.Element;
 export declare namespace PreviewPanel {
     var displayName: string;
 }

package/dist/preview-panel/index.js

@@ -11,6 +11,7 @@ export function PreviewPanel(_ref) {
     onTabChange = _ref.onTabChange,
     onTabClose = _ref.onTabClose,
     onCloseAll = _ref.onCloseAll,
+    onCloseContainer = _ref.onCloseContainer,
     onDownload = _ref.onDownload,
     onOpenInBrowser = _ref.onOpenInBrowser,
     open = _ref.open,
@@ -132,6 +133,14 @@ export function PreviewPanel(_ref) {
     "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",
+    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,
     role: "status"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one-design-next",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "One Design Next from TAD@tencent.com",
   "packageManager": "pnpm@10.33.0",
   "module": "dist/index.js",
@@ -24,6 +24,7 @@
     "lint:es": "eslint \"{components,test}/**/*.{js,jsx,ts,tsx}\"",
     "prepublishOnly": "father doctor && npm run build",
     "create-component": "node scripts/create-component.js",
+    "gen:test": "node scripts/gen-test.mjs",
     "test": "vitest",
     "test:ci": "vitest run",
     "test:visual:update": "UPDATE_VISUAL=1 vitest run",
@@ -84,6 +85,8 @@
   "devDependencies": {
     "@commitlint/cli": "^17.1.2",
     "@commitlint/config-conventional": "^17.1.0",
+    "@fontsource/jetbrains-mono": "^5.2.8",
+    "@fontsource/noto-sans-sc": "^5.2.9",
     "@tailwindcss/postcss": "^4",
     "@tailwindcss/vite": "^4.3.0",
     "@testing-library/dom": "^10.4.1",