one-design-next 0.0.9 → 0.0.11

package/README.md

@@ -155,11 +155,11 @@ one-design-next/
 
 | 阶段 | Skill | 职责 |
 |:-----|:------|:-----|
-| **P1** 需求 | `p1-design-analyst` · `p1-design-spec` | 需求结构化分析、组件级设计说明 |
-| **P2** 知识 | `p2-one-design` · `p2-block-catalog` · `p2-business-knowledge` | 组件库知识、区块目录、业务页面知识 |
-| **P3** 质量 | `p3-audit` · `p3-polish` | 代码质量审查、发布前精修 |
-| **P4** 转化 | `p4-figma-to-block` · `p4-component-update-process` | 设计稿转区块、组件更新流程 |
-| **P5** 落地 | `p5-figma-to-page` · `p5-feedback` | 整页拼装、上下文与反馈采集 |
+| **P1** 设计 | `p1-design-analyst` · `p1-design-spec` | 需求结构化分析、组件级设计说明 |
+| **P2** 知识 | `p2-one-design` · `p2-block-catalog` · `p2-business-knowledge` · `p2-page-catalog` | 组件库知识、区块目录、业务页面知识 |
+| **P3** 执行 | `p3-page-implement` | 用 ODN 组件 + 区块拼装页面代码 |
+| **P4** 质量 | `p4-audit` · `p4-polish` | 代码质量审查、发布前精修 |
+| **内部维护** | `p4-figma-to-block` · `p5-figma-to-page` · `p4-component-update-process` · `p5-dmp-web-restore` · `p5-fe-free-trade-restore` | 设计稿转区块/整页、组件更新、线上页面还原（仅维护者本地用） |
 | **辅助** | `ten-questions` · `philosophy-talks` | 方法论讨论与设计哲学 |
 
 ### 多产品 Skill 发布

package/dist/_genui-types.d.ts

@@ -61,7 +61,24 @@ export interface SkillItem {
 export interface SendMeta {
     attachments?: Attachment[];
     webSearch?: boolean;
-    skill?: string;
+    /**
+     * 编辑器内插入的 chip 列表（按出现顺序）。
+     * - 来源包含工具栏按钮、`/` 触发、`@` 触发等
+     * - 通过 `kind` 字段区分 skill / mention / 自定义类型
+     * - 业务方按需 filter，例如：`meta.chips?.filter(c => c.kind === 'skill')`
+     *
+     * BREAKING（pre-1.0）：取代 v0.0.x 的 `skill?: string` 单值字段。
+     * 老业务迁移：`meta.skill` → `meta.chips?.find(c => c.kind === 'skill')?.label`
+     */
+    chips?: ComposerChipMeta[];
+}
+/** SendMeta.chips 的元素结构；与 components/composer/chip.tsx ChipData 对齐。 */
+export interface ComposerChipMeta {
+    id: string;
+    skillId: string;
+    label: string;
+    icon: string;
+    kind?: 'skill' | 'mention' | (string & {});
 }
 export type AgentEvent = {
     kind: 'thinking';

package/dist/cascader/index.d.ts

@@ -44,12 +44,8 @@ export interface BaseCascaderProps extends Omit<RcCascaderProps<DefaultOptionTyp
     separator?: string;
     /** 自定义下拉列表中每一项的渲染（rc-cascader 原生支持） */
     optionRender?: (option: DefaultOptionType) => React.ReactNode;
-    /**
-     * 点击非叶节点内容区域时的行为
-     * - `true`：选中非叶节点并关闭下拉
-     * - `'keep-open'`：选中非叶节点并触发 onChange，但保持下拉展开（子菜单继续展开）
-     */
-    changeOnSelect?: boolean | 'keep-open';
+    /** 点击非叶节点内容区域时也触发 onChange（下拉保持展开，子菜单继续展开） */
+    changeOnSelect?: boolean;
 }
 export type CascaderProps<V = (string | number)[] | null> = BaseCascaderProps & {
     mode?: 'single' | 'multiple';

package/dist/cascader/index.js

@@ -3,11 +3,10 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
 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 _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 _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; }
-function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function (_e) { function e(_x) { return _e.apply(this, arguments); } e.toString = function () { return _e.toString(); }; return e; }(function (e) { throw e; }), f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function (_e2) { function e(_x2) { return _e2.apply(this, arguments); } e.toString = function () { return _e2.toString(); }; return e; }(function (e) { didErr = true; err = e; }), f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 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; }
 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; }
@@ -90,41 +89,6 @@ function CascaderInner(_ref) {
   var processedOptions = React.useMemo(function () {
     return processOptions(options, mergedFieldNames, optionPopoverProps);
   }, [options, mergedFieldNames, optionPopoverProps]);
-
-  // 根据完整路径从 processedOptions 中查找对应的 option 对象
-  var resolvePathOptions = React.useCallback(function (fullPath) {
-    var result = [];
-    var currentOptions = processedOptions;
-    var vField = mergedFieldNames.value || 'value';
-    var cField = mergedFieldNames.children || 'children';
-    var _iterator = _createForOfIteratorHelper(fullPath),
-      _step;
-    try {
-      var _loop = function _loop() {
-          var val = _step.value;
-          if (!currentOptions) return 0; // break
-          var found = currentOptions.find(function (opt) {
-            return opt[vField] === val;
-          });
-          if (found) {
-            result.push(found);
-            currentOptions = found[cField];
-          } else {
-            return 0; // break
-          }
-        },
-        _ret;
-      for (_iterator.s(); !(_step = _iterator.n()).done;) {
-        _ret = _loop();
-        if (_ret === 0) break;
-      }
-    } catch (err) {
-      _iterator.e(err);
-    } finally {
-      _iterator.f();
-    }
-    return result;
-  }, [processedOptions, mergedFieldNames]);
   var prefixCls = 'odn-select';
   var _useIcons = useIcons(_objectSpread(_objectSpread({}, restProps), {}, {
       hasFeedback: false,
@@ -211,70 +175,6 @@ function CascaderInner(_ref) {
     }
   };
 
-  // 单选模式下 pathKey → 带类型的 fullPath 映射，用于事件委托时还原路径
-  var pathKeyMap = React.useMemo(function () {
-    if (mode !== 'single') return null;
-    var SPLIT = '__RC_CASCADER_SPLIT__';
-    var map = new Map();
-    var traverse = function traverse(opts) {
-      if (!opts) return;
-      var _iterator2 = _createForOfIteratorHelper(opts),
-        _step2;
-      try {
-        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-          var opt = _step2.value;
-          var fullPath = opt.__fullPath__;
-          if (fullPath) {
-            map.set(fullPath.join(SPLIT), fullPath);
-          }
-          var cField = mergedFieldNames.children || 'children';
-          var children = opt[cField];
-          if (children && Array.isArray(children)) traverse(children);
-        }
-      } catch (err) {
-        _iterator2.e(err);
-      } finally {
-        _iterator2.f();
-      }
-    };
-    traverse(processedOptions);
-    return map;
-  }, [mode, processedOptions, mergedFieldNames]);
-
-  // 单选模式下：通过 onClickCapture 在 dropdown 层面拦截点击
-  // 点击展开图标区域 → 放行，由 rc-cascader 处理展开
-  // 点击其他区域（内容 / padding） → 拦截，手动选中 + 关闭
-  var handleSingleSelectCapture = React.useCallback(function (e) {
-    if (!pathKeyMap) return;
-    var target = e.target;
-    var expandIcon = target.closest('.odn-cascader-menu-item-expand-icon');
-    var menuItem = target.closest('.odn-cascader-menu-item');
-    if (!menuItem || expandIcon) return;
-    if (menuItem.classList.contains('odn-cascader-menu-item-disabled')) return;
-    if (menuItem.getAttribute('title') === 'divider') return;
-    var pathKey = menuItem.getAttribute('data-path-key');
-    if (!pathKey) return;
-    var fullPath = pathKeyMap.get(pathKey);
-    if (!fullPath) return;
-    var pathOptions = resolvePathOptions(fullPath);
-    var lastOption = pathOptions[pathOptions.length - 1];
-    if (!lastOption) return;
-    var cField = mergedFieldNames.children || 'children';
-    var hasChildren = lastOption[cField] && Array.isArray(lastOption[cField]) && lastOption[cField].length > 0;
-
-    // 非叶节点仅在 changeOnSelect 时才可点击选中
-    if (hasChildren && !changeOnSelectProp) return;
-
-    // keep-open：触发 onChange 但不关闭下拉，让 rc-cascader 继续展开子菜单
-    if (hasChildren && changeOnSelectProp === 'keep-open') {
-      handleChange(fullPath, pathOptions, e);
-      return;
-    }
-    e.stopPropagation();
-    handleChange(fullPath, pathOptions, e);
-    handleVisibleChange(false);
-  }, [pathKeyMap, mergedFieldNames, changeOnSelectProp, resolvePathOptions, handleChange, handleVisibleChange]);
-
   // 转换 value 类型以兼容 rc-cascader
   var rcValue = value === null ? undefined : value;
   var rcDefaultValue = defaultValue === null ? undefined : defaultValue;
@@ -371,49 +271,34 @@ function CascaderInner(_ref) {
     },
     dropdownMatchSelectWidth: dropdownMatchSelectWidth,
     optionRender: optionRenderProp,
-    // 单选模式不传 changeOnSelect 给 rc-cascader，
-    // 使展开图标点击时 isSelectable 对非叶节点返回 false，只触发展开
-    changeOnSelect: mode === 'single' ? false : !!changeOnSelectProp
+    changeOnSelect: !!changeOnSelectProp
   });
-  var dropdownRender = React.useMemo(function () {
-    var searchRenderFn = showInnerSearch ? function (menu) {
-      var searchNode = /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
-        className: "odn-select-dropdown-search"
-      }, /*#__PURE__*/React.createElement(Icon, {
-        name: "search",
-        className: "odn-select-dropdown-search-icon"
-      }), /*#__PURE__*/React.createElement("input", {
-        ref: dropdownSearchInputRef,
-        className: "odn-select-dropdown-search-input",
-        placeholder: "\u8BF7\u8F93\u5165",
-        value: searchValue,
-        onChange: function onChange(e) {
-          var value = e.target.value;
-          if (searchValueProp === undefined) {
-            setSearchValue(value);
-          }
-          if (_onSearch) {
-            _onSearch(value);
-          }
-        },
-        onKeyDown: function onKeyDown(e) {
-          e.stopPropagation();
+  var dropdownRender = showInnerSearch ? function (menu) {
+    var searchNode = /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
+      className: "odn-select-dropdown-search"
+    }, /*#__PURE__*/React.createElement(Icon, {
+      name: "search",
+      className: "odn-select-dropdown-search-icon"
+    }), /*#__PURE__*/React.createElement("input", {
+      ref: dropdownSearchInputRef,
+      className: "odn-select-dropdown-search-input",
+      placeholder: "\u8BF7\u8F93\u5165",
+      value: searchValue,
+      onChange: function onChange(e) {
+        var value = e.target.value;
+        if (searchValueProp === undefined) {
+          setSearchValue(value);
         }
-      })));
-      return /*#__PURE__*/React.createElement(React.Fragment, null, searchNode, menu);
-    } : undefined;
-
-    // 单选模式：在 dropdown 层面用 onClickCapture 拦截内容区域点击
-    if (mode === 'single') {
-      return function (menu) {
-        var rendered = searchRenderFn ? searchRenderFn(menu) : menu;
-        return /*#__PURE__*/React.createElement("div", {
-          onClickCapture: handleSingleSelectCapture
-        }, rendered);
-      };
-    }
-    return searchRenderFn;
-  }, [showInnerSearch, searchValue, searchValueProp, _onSearch, mode, handleSingleSelectCapture]);
+        if (_onSearch) {
+          _onSearch(value);
+        }
+      },
+      onKeyDown: function onKeyDown(e) {
+        e.stopPropagation();
+      }
+    })));
+    return /*#__PURE__*/React.createElement(React.Fragment, null, searchNode, menu);
+  } : undefined;
   if (mode === 'multiple') {
     return /*#__PURE__*/React.createElement(RcCascader, _extends({}, commonProps, {
       value: rcValue,

package/dist/composer/chip.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Composer · 编辑器内的 chip 视觉
+ *
+ * 当前形态极简：[icon][label][×]
+ * - hover 时 icon 变 ×（左槽位互斥），节省横向空间
+ * - × 用 onMouseDown preventDefault 防止 contenteditable 把焦点吃过去
+ *
+ * 视觉是 inline-flex 的 atomic 元素；其 DOM 容器（host span）由 useChipManager
+ * 创建并维护 contentEditable=false / data-mention-id；这里只渲染 host 内的内容。
+ */
+/// <reference types="react" />
+/** chip 渲染所需的最小数据结构。 */
+export interface ChipData {
+    /** chip 实例唯一 id（与 value marker 中的 id 对应） */
+    id: string;
+    /** 业务定义 id（如 skill id / mention 对象 id），业务方在 onSend 时反查源数据用 */
+    skillId: string;
+    /** chip 显示文本 */
+    label: string;
+    /** chip 显示 icon name */
+    icon: string;
+    /**
+     * chip 语义来源标记，业务方自定义。Composer 内部不消费 kind，
+     * 仅原样透传到 onSend(meta.chips)，方便业务方按 kind 分类。
+     * 约定：'skill' = 工具栏按钮 / `/` 触发选出来的能力；
+     *       'mention' = `@` 触发的对象引用；
+     *       其他自定义字符串业务方自行解释。
+     */
+    kind?: 'skill' | 'mention' | (string & {});
+}
+export interface ChipProps {
+    data: ChipData;
+    onRemove: () => void;
+}
+export declare function Chip({ data, onRemove }: ChipProps): import("react").JSX.Element;
+export default Chip;

package/dist/composer/chip.js

@@ -0,0 +1,49 @@
+/**
+ * Composer · 编辑器内的 chip 视觉
+ *
+ * 当前形态极简：[icon][label][×]
+ * - hover 时 icon 变 ×（左槽位互斥），节省横向空间
+ * - × 用 onMouseDown preventDefault 防止 contenteditable 把焦点吃过去
+ *
+ * 视觉是 inline-flex 的 atomic 元素；其 DOM 容器（host span）由 useChipManager
+ * 创建并维护 contentEditable=false / data-mention-id；这里只渲染 host 内的内容。
+ */
+
+import Icon from "../icon";
+
+/** chip 渲染所需的最小数据结构。 */
+
+export function Chip(_ref) {
+  var data = _ref.data,
+    onRemove = _ref.onRemove;
+  return /*#__PURE__*/React.createElement("span", {
+    "data-odn-composer-chip": true,
+    "data-state": "valid"
+  }, /*#__PURE__*/React.createElement("span", {
+    "data-odn-composer-chip-icon": true,
+    "aria-hidden": true
+  }, /*#__PURE__*/React.createElement(Icon, {
+    name: data.icon,
+    size: 12
+  })), /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    "data-odn-composer-chip-remove": true,
+    "aria-label": "\u79FB\u9664 ".concat(data.label),
+    onMouseDown: function onMouseDown(e) {
+      // 阻止 contenteditable 把焦点拽走 / 光标错位
+      e.preventDefault();
+      e.stopPropagation();
+    },
+    onClick: function onClick(e) {
+      e.preventDefault();
+      e.stopPropagation();
+      onRemove();
+    }
+  }, /*#__PURE__*/React.createElement(Icon, {
+    name: "x",
+    size: 12
+  })), /*#__PURE__*/React.createElement("span", {
+    "data-odn-composer-chip-label": true
+  }, data.label));
+}
+export default Chip;

package/dist/composer/editor.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Composer · 编辑器（contenteditable 实现）
+ *
+ * 替代 Input.Textarea 在 Composer 内部承担"输入区"角色。
+ *
+ * 阶段（按 MR 拆分）：
+ *  - [step 2] 基础壳：纯文本输入 + autoSize + Enter 自插 br + IME 短路
+ *  - [step 3] chip 命令式 API + Portal 渲染 + Backspace 整块删
+ *  - [step 4] @ + / 触发判定 + 浮层信号 + replaceTriggerWithChip ← 当前
+ *
+ * 与 Input.Textarea 的对外 API 尽量对齐：
+ *   value / defaultValue / onChange / placeholder / autoSize / onPressEnter
+ *
+ * chip 模型（hybrid）：
+ *   - DOM 由 contenteditable 自治：每个 chip 是 contentEditable=false 的 span（host），带 data-mention-id
+ *   - 视觉由 React Portal 注入到 host 内：chip.tsx 负责
+ *   - chip 状态（id ↔ host）由 useChipManager 维护
+ */
+/// <reference types="react" />
+import { type ChipData } from './chip';
+/** Composer editor 触发态对外信号——告诉父组件该弹浮层选 skill 了。 */
+export interface ComposerEditorTriggerInfo {
+    /** 触发字符（@ 或 /） */
+    trigger: string;
+    /** 触发字符之后到 caret 的查询串 */
+    query: string;
+    /**
+     * 触发字符 + query 整段的 client rect。父组件用它定位浮层。
+     * 滚动 / resize 后如需最新位置，可重新调用 ref.getTriggerRect()。
+     */
+    rect: DOMRect;
+}
+export interface ComposerEditorAutoSize {
+    minRows?: number;
+    maxRows?: number;
+}
+export interface ComposerEditorProps {
+    /** 受控值。string，未来会含 marker（chip 序列化为 `\u200b\u2063id\u2063\u200b`）。 */
+    value?: string;
+    /** 非受控初始值。 */
+    defaultValue?: string;
+    /** 值变化回调；参数是 raw string，含 marker。 */
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    autoSize?: ComposerEditorAutoSize;
+    /**
+     * Enter 键回调。
+     * - 返回 `false` 阻止默认行为
+     * - 调用 `e.preventDefault()` 同样阻止
+     * - 默认行为（未阻止）= 自插 `<br>` 换行
+     *
+     * 父组件（Composer）在这里根据 submitType 决定 Enter 是"发送"还是"让默认换行"。
+     */
+    onPressEnter?: (e: React.KeyboardEvent<HTMLDivElement>) => void | false;
+    /**
+     * 启用的触发字符。默认 `['@', '/']`。
+     * 设为空数组可禁用触发判定。
+     */
+    triggers?: readonly string[];
+    /**
+     * 触发态变化回调：
+     *   - 进入触发态 → 传入 info
+     *   - 仍在触发态但 query / rect 变化 → 传入新 info
+     *   - 退出触发态（按 Esc 之外的方式：删触发字符、空格隔断、光标移开等）→ 传入 null
+     * IME 合成期间不会触发。
+     */
+    onTriggerChange?: (info: ComposerEditorTriggerInfo | null) => void;
+    /**
+     * 仅当 trigger 处于活动态（triggerRef.current 非空）时调用：
+     * 把 ↑↓ Enter Esc Tab 等导航键先丢给父组件让它驱动浮层选择。
+     * - 返回 `true` → editor 视为父已处理，不再走自身换行 / 提交逻辑
+     * - 返回 `false / undefined` → editor 走原默认（onPressEnter / 换行 / 删 chip 等）
+     *
+     * 父组件如需 preventDefault，请在 handler 内自己调用——editor 不会替父代劳，
+     * 避免某些导航键（如 Tab）在父决定让默认通过时误吃。
+     */
+    onTriggerKeyDown?: (e: React.KeyboardEvent<HTMLDivElement>) => boolean | void;
+    /**
+     * 编辑器可视高度变化回调。
+     * height = editor.offsetHeight（受 max-height clamp）；atMax 表示触顶。
+     * Composer 的 lite 升格逻辑、scrollbar 显隐都用这个。
+     */
+    onHeightChange?: (height: number, atMax: boolean) => void;
+    /**
+     * 剪贴板含文件（如截图、资源管理器复制文件）时回调；由上层转为附件等。
+     * 若提供且 `files.length > 0`，编辑器会 `preventDefault` 且不再插入纯文本。
+     */
+    onPasteFiles?: (files: File[]) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface ComposerEditorRef {
+    focus: (options?: FocusOptions) => void;
+    blur: () => void;
+    /** 清空：文本 + 全部 chip + 抛 onChange('') */
+    clear: () => void;
+    /** 在当前光标位置插入 chip；多次调用产生多个 chip。 */
+    insertChip: (data: ChipData) => void;
+    /** 按 chip id 移除（也可由 chip 上的 × 自行触发）。 */
+    removeChip: (id: string) => void;
+    /**
+     * 把当前 trigger 区段（含触发字符 + query）替换为 chip。
+     * 如果当前没有活动 trigger，退化为 insertChip 在光标位置插入。
+     * 配合浮层"用户选了某个 skill"的回调使用。
+     */
+    replaceTriggerWithChip: (data: ChipData) => void;
+    /** 主动取消当前触发态（不修改 DOM，只清状态 + 抛 onTriggerChange(null)）。 */
+    cancelTrigger: () => void;
+    /** 取最新的 trigger rect，便于浮层在滚动 / resize 时刷新位置。 */
+    getTriggerRect: () => DOMRect | null;
+    /**
+     * 取当前编辑器内全部 chip 的快照（按 DOM 出现顺序）。
+     * 父组件 onSend 时用，避免自行 parse value marker。
+     */
+    getChips: () => ChipData[];
+    /** 底层 contenteditable 元素 */
+    nativeElement: HTMLDivElement | null;
+}
+export declare const ComposerEditor: import("react").ForwardRefExoticComponent<ComposerEditorProps & import("react").RefAttributes<ComposerEditorRef>>;
+export default ComposerEditor;