@dcloudio/uni-app-x 0.7.116 → 0.7.117

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcloudio/uni-app-x",
-  "version": "0.7.116",
+  "version": "0.7.117",
   "description": "uni-app x types",
   "typings": "index.d.ts",
   "main": "index.d.ts",

package/types/dom2-internal/sharedData.d.ts

@@ -333,70 +333,73 @@ declare global {
 
 declare global {
   /**
-   * 动态 sharedData class 的最小描述信息。
+   * 动态 sharedData 字段定义。
    *
-   * 该描述信息由 sharedData bundle provider 返回，
-   * 供动态 sharedData 实例初始化字段槽和 flag 分配使用。
+   * 这里保留最小运行时需要的信息：
+   * - fieldId：字段编号
+   * - flagGroupId：所在 flag group
+   * - flagBit：所在 bit
    */
-  interface UniDynamicSharedDataClassDefinition {
+  interface UniSharedDataDynamicFieldDefinition {
     /**
-     * sharedData class 名称。
-     *
-     * 用于调试、日志和与静态 sharedData class 对照。
+     * 当前 template 内唯一的字段编号。
      */
-    readonly sharedDataClassName: string
+    readonly fieldId: number
 
     /**
-     * 当前 template 内唯一的 sharedData class 编号。
+     * 该字段对应的 flag group 编号。
      */
-    readonly sharedDataClassId: number
+    readonly flagGroupId: number
 
     /**
-     * 该 class 持有的字段数量。
+     * 该字段在 flag group 中对应的 bit。
      */
-    readonly fieldCount: number
+    readonly flagBit: number
+  }
 
+  /**
+   * 动态 sharedData class 定义。
+   *
+   * 用于：
+   * - 构造动态 sharedData 实例时初始化字段槽
+   * - 初始化 flag group
+   * - 调试 / 诊断 / 宿主校验
+   */
+  interface UniSharedDataDynamicClassDefinition {
     /**
-     * 该 class 持有的 flag group 数量。
+     * 对齐静态 sharedData class 的名称。
+     *
+     * 主要用于调试、日志和对照，不参与热路径判断。
      */
-    readonly flagGroupCount: number
+    readonly sharedDataClassName: string
 
     /**
-     * 当前 class 的字段声明。
+     * 当前 template 内唯一的 sharedData class 编号。
+     *
+     * root page / root component 固定为 0。
      */
-    readonly fields: ReadonlyArray<UniDynamicSharedDataField>
-  }
+    readonly sharedDataClassId: number
 
-  /**
-   * 动态 sharedData 字段声明。
-   */
-  interface UniDynamicSharedDataField {
     /**
-     * 当前 template 内唯一的字段编号。
+     * 当前 class 的字段数量。
      */
-    readonly fieldId: number
+    readonly fieldCount: number
 
     /**
-     * 对应的 flag group 编号。
+     * 当前 class 的 flag group 数量。
      */
-    readonly flagGroupId: number
+    readonly flagGroupCount: number
 
     /**
-     * 对应的 flag bit。
+     * 当前 class 的字段定义。
      */
-    readonly flagBit: number
+    readonly fields: ReadonlyArray<UniSharedDataDynamicFieldDefinition>
   }
 
   /**
-   * 动态 sharedData 的最小初始化参数。
-   *
-   * 所有动态 sharedData 实例统一通过：
-   * - `bundleKey`
-   * - `sharedDataClassId`
+   * 动态 sharedData 的初始化参数。
    *
-   * 完成初始化。
-   *
-   * root page / root component 的 `sharedDataClassId` 固定由编译器传入 `0`。
+   * 这是 renderSharedData 直接使用的构造参数。
    */
   interface UniDynamicSharedDataInitOptions {
     /**
@@ -407,176 +410,251 @@ declare global {
     /**
      * 当前实例对应的 sharedData class 编号。
      *
-     * root page / root component 固定为 `0`，
-     * 其他 scoped sharedData 使用编译器分配的实际 classId。
+     * 约束：
+     * - root page：0
+     * - root component：0
+     * - scoped sharedData：编译器分配的实际 classId
      */
     readonly sharedDataClassId: number
   }
 
-  interface UniDynamicSharedDataBundle {
-    getSharedDataClassDefinition(sharedDataClassId: number): UniDynamicSharedDataClassDefinition
-  }
-
   /**
-   * 动态 sharedData bundle provider 的接口定义。
+   * UniSharedDataDynamicState 的初始化参数。
+   *
+   * 这是宿主真实实现类在内部创建 state 时使用的参数。
+   * renderSharedData 不直接传这个对象。
    */
-  interface UniDynamicSharedDataBundleProvider {
+  interface UniSharedDataDynamicStateOptions extends UniDynamicSharedDataInitOptions {
     /**
-     * 根据 bundleKey 加载对应的动态 bundle。
-     * @param bundleKey
+     * 按 bundleKey 读取原始二进制 bytes。
+     *
+     * 只负责读取 bytes。
+     * 缓存、decode、classDefinition 查询由当前仓库实现。
      */
-    loadBundle(bundleKey: string): UniDynamicSharedDataBundle
+    readonly readBytes: (bundleKey: string) => Uint8Array
   }
 
   /**
-   * 普通动态 sharedData 的最小读取接口。
-   *
-   * 解释器只依赖字段与 flag 读取。
-   *
-   * 非解释器使用的内部字段、方法，命名尽量贴近静态 sharedData：
-   * - 复用已有静态基类字段
-   * - 内部方法沿用 `_xxx` 风格
+   * 普通动态 sharedData 的最小读取协议。
    *
-   * 这样外部仓库实现动态 sharedData 时，底层更容易复用现有代码。
+   * 解释器只依赖这些读取能力。
    */
   interface IUniDynamicSharedData {
+    /**
+     * 当前实例所属 bundleKey。
+     */
+    readonly _bundleKey: string
+
+    /**
+     * 当前实例对应的 sharedData class 编号。
+     */
+    readonly _sharedDataClassId: number
+
+    /**
+     * 当前实例绑定的 class 定义。
+     */
+    readonly _sharedDataClass: UniSharedDataDynamicClassDefinition
+
     /**
      * 按字段编号读取值。
-     *
-     * 这里的 `fieldId` 由编译器 shared schema 分配，
-     * 解释器与真实实现都以该编号作为统一索引。
      */
     getField(fieldId: number): UniSharedDataAny
 
     /**
-     * 按 flag 组编号读取脏标记。
-     *
-     * 返回值与静态 sharedData 的 flag group 对齐，
-     * 解释器只关心位图值本身，不关心内部存储结构。
+     * 按 flag group 编号读取脏标记位图。
      */
     getFlag(flagGroupId: number): number
   }
 
   /**
-   * 动态组件 sharedData 的最小接口。
+   * 动态组件 sharedData 的最小读取协议。
    *
-   * 对齐静态 renderer 会直接读取的 component builtin：
-   * - `_vueId`
-   * - `_flatten`
-   * - `_renderer`
+   * 对齐静态 renderer 会直接读取的 builtin。
    */
   interface IUniDynamicSharedDataComponent extends IUniDynamicSharedData {
-    /**
-     * 返回组件或页面实例的 vueId。
-     */
     getVueId(): number
-
-    /**
-     * 返回组件当前 flatten 状态。
-     */
     getFlatten(): UniSharedDataComponentFlatten
-
-    /**
-     * 返回当前 renderer 类型。
-     */
     getRenderer(): UniSharedDataComponentRenderer
   }
 
   /**
-   * 动态页面 sharedData 的最小接口。
-   *
-   * 接口层明确表达：dynamic page 也是 dynamic component。
+   * 动态页面 sharedData 的最小读取协议。
    *
-   * 当前阶段 page 不额外增加读取能力，直接继承 component 接口。
-   * `_flushJobs`、`_render`、`_textLayouts` 等行为属于真实运行时职责，
-   * 不放进当前解释器契约。
+   * 当前阶段 page 不额外增加读取面，直接继承 component 协议。
    */
   interface IUniDynamicSharedDataPage extends IUniDynamicSharedDataComponent {}
 
   /**
-   * 动态普通 scope 的最终目标基类。
+   * 动态 sharedData 的运行时状态对象。
    *
-   * 外部仓库的真实实现应继承静态基类 `UniSharedData`，
-   * 并通过 `bundleKey + sharedDataClassId` 初始化实例。
+   * 职责：
+   * - load bytes
+   * - bundle cache
+   * - decode
+   * - sharedDataClassId -> classDefinition
+   * - 字段值存储
+   * - flags 存储
+   * - render callback 执行
    */
-  abstract class UniDynamicSharedData extends UniSharedData implements IUniDynamicSharedData {
+  class UniSharedDataDynamicState {
+    constructor(owner: IUniDynamicSharedData | IUniDynamicSharedDataComponent | IUniDynamicSharedDataPage, options: UniSharedDataDynamicStateOptions)
+
     /**
-     * 当前实例所属 bundleKey。
+     * 当前实例绑定的 classDefinition。
      */
-    readonly _bundleKey: string
+    getClassDefinition(): UniSharedDataDynamicClassDefinition
 
     /**
-     * 当前实例对应的 sharedData class 编号。
+     * 读取字段值。
      */
-    readonly _sharedDataClassId: number
+    getField(fieldId: number): UniSharedDataAny
 
     /**
-     * 当前动态实例对应的 sharedData class 描述。
+     * 读取 flag group。
+     */
+    getFlag(flagGroupId: number): number
+
+    /**
+     * 写字段值。
      *
-     * 该 metadata 由实例构造时通过 bundle provider 获取。
+     * 返回值表示该写入是否产生有效变化。
      */
-    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+    setField(fieldId: number, value: UniSharedDataAny | null): boolean
 
-    constructor(scope: UniSharedDataPage, dynamicOptions: UniDynamicSharedDataInitOptions)
+    /**
+     * 清空当前实例的 flags。
+     */
+    resetFlags(): void
 
-    abstract getField(fieldId: number): UniSharedDataAny
-    abstract getFlag(flagGroupId: number): number
+    /**
+     * 执行动态 renderElement callback。
+     *
+     * 返回值必须和静态渲染一致。
+     */
+    renderElement(): UniElementBlock
 
     /**
-     * 动态 `renderSharedData` 主路径固定传 `fieldId`。
+     * 执行动态 renderKotlinElement callback。
      *
-     * 这里保留 `string` / `number` 双签名：
-     * - `string`：与静态基类签名保持兼容，不需要支持
-     * - `number`：动态 sharedData 通过字段编号设置数据，供解释器渲染器使用
+     * 返回值必须和静态渲染一致。
+     */
+    renderKotlinElement(): UniElementBlock
+
+    /**
+     * 执行动态 renderNativeView callback。
+     *
+     * 返回值必须和静态渲染一致。
+     */
+    renderNativeView(): UniNativeViewBlock
+  }
+
+  /**
+   * 普通动态 scope sharedData。
+   *
+   * 真实实现由宿主仓库提供。
+   * renderSharedData 会直接 new 该类。
+   */
+  class UniDynamicSharedData extends UniSharedData implements IUniDynamicSharedData {
+    readonly _bundleKey: string
+    readonly _sharedDataClassId: number
+    readonly _sharedDataClass: UniSharedDataDynamicClassDefinition
+    readonly _dynamicState: UniSharedDataDynamicState
+
+    constructor(dynamicOptions: UniDynamicSharedDataInitOptions)
+
+    getField(fieldId: number): UniSharedDataAny
+    getFlag(flagGroupId: number): number
+
+    /**
+     * 仅做类型，动态 sharedData 不支持按 name 写入。
+     */
+    _setData(name: string, value: UniSharedDataAny | null): void
+    /**
+     * 动态渲染始终按 fieldId 写入。
+     */
+    _setData(fieldId: number, value: UniSharedDataAny | null): void
+
+    /**
+     * 对齐静态 sharedData 生命周期。
+     */
+    _resetFlags(): void
+
+    /**
+     * 保持和静态渲染一致的 callback 入口。
      */
-    abstract _setData(key: string, value: any | null): void
-    abstract _setData(fieldId: number, value: any | null): void
+    _renderElement(): UniElementBlock
+    _renderKotlinElement(): UniElementBlock
+    _renderNativeView(): UniNativeViewBlock
   }
 
   /**
-   * 动态组件 scope 的最终目标基类。
+   * 动态组件 root sharedData。
    *
-   * 外部仓库真实实现需要保持与静态 `UniSharedDataComponent`
-   * 相同的组件级 builtin 语义，并通过 `bundleKey + sharedDataClassId`
-   * 初始化实例。
+   * renderSharedData 会直接 new 该类，
+   * 且 sharedDataClassId 固定为 0。
    */
-  abstract class UniDynamicSharedDataComponent extends UniSharedDataComponent implements IUniDynamicSharedDataComponent {
+  class UniDynamicSharedDataComponent extends UniSharedDataComponent implements IUniDynamicSharedDataComponent {
     readonly _bundleKey: string
     readonly _sharedDataClassId: number
-    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+    readonly _sharedDataClass: UniSharedDataDynamicClassDefinition
+    readonly _dynamicState: UniSharedDataDynamicState
 
-    constructor(scope: UniSharedDataPage, options: UniSharedDataComponentOptions, dynamicOptions: UniDynamicSharedDataInitOptions)
+    constructor(dynamicOptions: UniDynamicSharedDataInitOptions)
+
+    getField(fieldId: number): UniSharedDataAny
+    getFlag(flagGroupId: number): number
+    getVueId(): number
+    getFlatten(): UniSharedDataComponentFlatten
+    getRenderer(): UniSharedDataComponentRenderer
+    /**
+     * 仅做类型，动态 sharedData 不支持按 name 写入。
+     */
+    _setData(name: string, value: UniSharedDataAny | null): void
+    /**
+     * 动态渲染始终按 fieldId 写入。
+     */
+    _setData(fieldId: number, value: UniSharedDataAny | null): void
+
+    _resetFlags(): void
 
-    abstract getField(fieldId: number): UniSharedDataAny
-    abstract getFlag(flagGroupId: number): number
-    abstract _setData(key: string, value: any | null): void
-    abstract _setData(fieldId: number, value: any | null): void
-    abstract getVueId(): number
-    abstract getFlatten(): UniSharedDataComponentFlatten
-    abstract getRenderer(): UniSharedDataComponentRenderer
+    _renderElement(): UniElementBlock
+    _renderKotlinElement(): UniElementBlock
+    _renderNativeView(): UniNativeViewBlock
   }
 
   /**
-   * 动态页面 scope 的最终目标基类。
+   * 动态页面 root sharedData。
    *
-   * 外部仓库真实实现应继承 `UniSharedDataPage`，
-   * 并沿用 component builtin 读取面，通过 `bundleKey + sharedDataClassId`
-   * 初始化实例。
+   * renderSharedData 会直接 new 该类，
+   * 且 sharedDataClassId 固定为 0。
    */
-  abstract class UniDynamicSharedDataPage extends UniSharedDataPage implements IUniDynamicSharedDataPage {
+  class UniDynamicSharedDataPage extends UniSharedDataPage implements IUniDynamicSharedDataPage {
     readonly _bundleKey: string
     readonly _sharedDataClassId: number
-    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+    readonly _sharedDataClass: UniSharedDataDynamicClassDefinition
+    readonly _dynamicState: UniSharedDataDynamicState
+
+    constructor(dynamicOptions: UniDynamicSharedDataInitOptions)
+
+    getField(fieldId: number): UniSharedDataAny
+    getFlag(flagGroupId: number): number
+    getVueId(): number
+    getFlatten(): UniSharedDataComponentFlatten
+    getRenderer(): UniSharedDataComponentRenderer
 
-    constructor(pageIdOrScope: number | UniSharedDataPage, options: UniSharedDataComponentOptions, dynamicOptions: UniDynamicSharedDataInitOptions)
+    /**
+     * 仅做类型，动态 sharedData 不支持按 name 写入。
+     */
+    _setData(name: string, value: UniSharedDataAny | null): void
+    /**
+     * 动态渲染始终按 fieldId 写入。
+     */
+    _setData(fieldId: number, value: UniSharedDataAny | null): void
+    _resetFlags(): void
 
-    abstract getField(fieldId: number): UniSharedDataAny
-    abstract getFlag(flagGroupId: number): number
-    abstract _setData(key: string, value: any | null): void
-    abstract _setData(fieldId: number, value: any | null): void
-    abstract getVueId(): number
-    abstract getFlatten(): UniSharedDataComponentFlatten
-    abstract getRenderer(): UniSharedDataComponentRenderer
+    _renderElement(): UniElementBlock
+    _renderKotlinElement(): UniElementBlock
+    _renderNativeView(): UniNativeViewBlock
   }
 }
 

package/types/uni/uts-plugin-api/lib/uni-editor/utssdk/global.d.ts

@@ -6,6 +6,7 @@
   UniEditorElementOptions as UniEditorElementOptionsOrigin,
   UniEditorElementInsertImageOptions as UniEditorElementInsertImageOptionsOrigin,
   UniEditorElementInsertTextOptions as UniEditorElementInsertTextOptionsOrigin,
+  UniEditorElementInsertMentionOptions as UniEditorElementInsertMentionOptionsOrigin,
   UniEditorElementSetContentsOptions as UniEditorElementSetContentsOptionsOrigin,
   UniEditorElementGetSelectionTextOptionsRes as UniEditorElementGetSelectionTextOptionsResOrigin,
   UniEditorElementGetSelectionTextOptions as UniEditorElementGetSelectionTextOptionsOrigin,
@@ -25,6 +26,7 @@
   type UniEditorElementOptions = UniEditorElementOptionsOrigin
   type UniEditorElementInsertImageOptions = UniEditorElementInsertImageOptionsOrigin
   type UniEditorElementInsertTextOptions = UniEditorElementInsertTextOptionsOrigin
+  type UniEditorElementInsertMentionOptions = UniEditorElementInsertMentionOptionsOrigin
   type UniEditorElementSetContentsOptions = UniEditorElementSetContentsOptionsOrigin
   type UniEditorElementGetSelectionTextOptionsRes = UniEditorElementGetSelectionTextOptionsResOrigin
   type UniEditorElementGetSelectionTextOptions = UniEditorElementGetSelectionTextOptionsOrigin

package/types/uni/uts-plugin-api/lib/uni-editor/utssdk/index.d.ts

@@ -6,6 +6,7 @@
   UniEditorElementOptions,
   UniEditorElementInsertImageOptions,
   UniEditorElementInsertTextOptions,
+  UniEditorElementInsertMentionOptions,
   UniEditorElementSetContentsOptions,
   UniEditorElementGetSelectionTextOptionsRes,
   UniEditorElementGetSelectionTextOptions,

package/types/uni/uts-plugin-api/lib/uni-editor/utssdk/interface.d.ts

@@ -33,6 +33,35 @@ export type UniEditorElementInsertTextOptions = {
   complete ?: ((res : UniEditorElementOptionsCompleteRes) => void) | null
 }
 
+export type UniEditorElementInsertMentionOptions = {
+  /**
+   * 被 @ 的人 id
+   */
+  id ?: string | null,
+  /**
+   * 被 @ 的人名字
+   */
+  name?: string | null,
+  /**
+   * 提及文本颜色，默认为 #1677ff
+   * @defaultValue #1677ff
+   */
+  color?: string | null,
+  /**
+   * 提及背景颜色，默认为 #e6f3ff
+   * @defaultValue #e6f3ff
+   */
+  background?: string | null,
+  /**
+   * 提及圆角，默认为 4px
+   * @defaultValue 4px
+   */
+  radius?: string | null,
+  success ?: ((res : UniEditorElementOptionsSuccessRes) => void) | null
+  fail ?: ((res : UniEditorElementOptionsFailRes) => void) | null
+  complete ?: ((res : UniEditorElementOptionsCompleteRes) => void) | null
+}
+
 export type UniEditorElementSetContentsOptions = {
   delta ?: any | null,
   html ?: string | null,
@@ -70,6 +99,7 @@ export interface IUniEditorElement extends UniElement {
   insertDivider(options : UniEditorElementOptions | null) : void
   insertImage(options : UniEditorElementInsertImageOptions | null) : void
   insertText(options : UniEditorElementInsertTextOptions | null) : void
+  insertMention(options ?: UniEditorElementInsertMentionOptions | null) : void
   setContents(options : UniEditorElementSetContentsOptions | null) : void
   getContents(options : UniEditorElementGetContentsOptions | null) : void
   clear(options : UniEditorElementOptions | null) : void
@@ -554,6 +584,30 @@ export interface EditorContext {
    * }
    */
   insertText(options ?: UniEditorElementInsertTextOptions | null) : void
+  /**
+   * 插入可整块删除的提及，提及文本默认为 @名字，当选区存在时覆盖选区文本，当选区不存在时插入到光标处
+   * @uniPlatform {
+   *   "app": {
+   *     "android": {
+   *       "osVer": "4.4",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04"
+   *     },
+   *     "ios": {
+   *       "osVer": "12.0",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04"
+   *     },
+   *     "harmony": {
+   *       "osVer": "√",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04",
+   *       "unixVaporVer": "5.04"
+   *     }
+   *   },
+   * }
+   */
+  insertMention(options ?: UniEditorElementInsertMentionOptions | null) : void
   /**
    * 初始化编辑器内容，html和delta同时存在时仅delta生效
    * @uniPlatform {
@@ -771,8 +825,8 @@ export interface EditorContext {
    */
   blur(options ?: UniEditorElementOptions | null) : void
 }
-
-export type CreateEditorContextAsync = (options: CreateEditorContextAsyncOptions) => void
+
+export type CreateEditorContextAsync = (options: CreateEditorContextAsyncOptions) => void
 
 export interface Uni {
   /**
@@ -852,4 +906,4 @@ export interface Uni {
    * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
    */
   createEditorContextAsync : CreateEditorContextAsync
-}
+}

package/types/uni/uts-plugin-component/lib/uni-editor/utssdk/global.d.ts

@@ -6,6 +6,7 @@
   UniEditorElementOptions as UniEditorElementOptionsOrigin,
   UniEditorElementInsertImageOptions as UniEditorElementInsertImageOptionsOrigin,
   UniEditorElementInsertTextOptions as UniEditorElementInsertTextOptionsOrigin,
+  UniEditorElementInsertMentionOptions as UniEditorElementInsertMentionOptionsOrigin,
   UniEditorElementSetContentsOptions as UniEditorElementSetContentsOptionsOrigin,
   UniEditorElementGetSelectionTextOptionsRes as UniEditorElementGetSelectionTextOptionsResOrigin,
   UniEditorElementGetSelectionTextOptions as UniEditorElementGetSelectionTextOptionsOrigin,
@@ -25,6 +26,7 @@
   type UniEditorElementOptions = UniEditorElementOptionsOrigin
   type UniEditorElementInsertImageOptions = UniEditorElementInsertImageOptionsOrigin
   type UniEditorElementInsertTextOptions = UniEditorElementInsertTextOptionsOrigin
+  type UniEditorElementInsertMentionOptions = UniEditorElementInsertMentionOptionsOrigin
   type UniEditorElementSetContentsOptions = UniEditorElementSetContentsOptionsOrigin
   type UniEditorElementGetSelectionTextOptionsRes = UniEditorElementGetSelectionTextOptionsResOrigin
   type UniEditorElementGetSelectionTextOptions = UniEditorElementGetSelectionTextOptionsOrigin

package/types/uni/uts-plugin-component/lib/uni-editor/utssdk/index.d.ts

@@ -6,6 +6,7 @@
   UniEditorElementOptions,
   UniEditorElementInsertImageOptions,
   UniEditorElementInsertTextOptions,
+  UniEditorElementInsertMentionOptions,
   UniEditorElementSetContentsOptions,
   UniEditorElementGetSelectionTextOptionsRes,
   UniEditorElementGetSelectionTextOptions,

package/types/uni/uts-plugin-component/lib/uni-editor/utssdk/interface.d.ts

@@ -33,6 +33,35 @@ export type UniEditorElementInsertTextOptions = {
   complete ?: ((res : UniEditorElementOptionsCompleteRes) => void) | null
 }
 
+export type UniEditorElementInsertMentionOptions = {
+  /**
+   * 被 @ 的人 id
+   */
+  id ?: string | null,
+  /**
+   * 被 @ 的人名字
+   */
+  name?: string | null,
+  /**
+   * 提及文本颜色，默认为 #1677ff
+   * @defaultValue #1677ff
+   */
+  color?: string | null,
+  /**
+   * 提及背景颜色，默认为 #e6f3ff
+   * @defaultValue #e6f3ff
+   */
+  background?: string | null,
+  /**
+   * 提及圆角，默认为 4px
+   * @defaultValue 4px
+   */
+  radius?: string | null,
+  success ?: ((res : UniEditorElementOptionsSuccessRes) => void) | null
+  fail ?: ((res : UniEditorElementOptionsFailRes) => void) | null
+  complete ?: ((res : UniEditorElementOptionsCompleteRes) => void) | null
+}
+
 export type UniEditorElementSetContentsOptions = {
   delta ?: any | null,
   html ?: string | null,
@@ -70,6 +99,7 @@ export interface IUniEditorElement extends UniElement {
   insertDivider(options : UniEditorElementOptions | null) : void
   insertImage(options : UniEditorElementInsertImageOptions | null) : void
   insertText(options : UniEditorElementInsertTextOptions | null) : void
+  insertMention(options ?: UniEditorElementInsertMentionOptions | null) : void
   setContents(options : UniEditorElementSetContentsOptions | null) : void
   getContents(options : UniEditorElementGetContentsOptions | null) : void
   clear(options : UniEditorElementOptions | null) : void
@@ -554,6 +584,30 @@ export interface EditorContext {
    * }
    */
   insertText(options ?: UniEditorElementInsertTextOptions | null) : void
+  /**
+   * 插入可整块删除的提及，提及文本默认为 @名字，当选区存在时覆盖选区文本，当选区不存在时插入到光标处
+   * @uniPlatform {
+   *   "app": {
+   *     "android": {
+   *       "osVer": "4.4",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04"
+   *     },
+   *     "ios": {
+   *       "osVer": "12.0",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04"
+   *     },
+   *     "harmony": {
+   *       "osVer": "√",
+   *       "uniVer": "x",
+   *       "unixVer": "5.04",
+   *       "unixVaporVer": "5.04"
+   *     }
+   *   },
+   * }
+   */
+  insertMention(options ?: UniEditorElementInsertMentionOptions | null) : void
   /**
    * 初始化编辑器内容，html和delta同时存在时仅delta生效
    * @uniPlatform {
@@ -771,8 +825,8 @@ export interface EditorContext {
    */
   blur(options ?: UniEditorElementOptions | null) : void
 }
-
-export type CreateEditorContextAsync = (options: CreateEditorContextAsyncOptions) => void
+
+export type CreateEditorContextAsync = (options: CreateEditorContextAsyncOptions) => void
 
 export interface Uni {
   /**
@@ -852,4 +906,4 @@ export interface Uni {
    * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
    */
   createEditorContextAsync : CreateEditorContextAsync
-}
+}