ime.formatUpdate event

提供输入法合成期间的临时下划线、选中或转换目标范围，供自绘编辑器呈现候选状态。

Event payload

{
  handle,
  revision: u64,
  formats: Array<{
    range: { start, end },
    style: "input" | "converted" | "target" | "selected"
  }>
}

Examples

host.events.on('ime.formatUpdate', ({ revision, formats }) => {
  if (revision === editor.revision) editor.setImeDecorations(formats);
});

Delivery rules

格式只影响临时呈现，不进入应用富文本模型。宿主只能发送封闭 style 枚举；未知值是协议错误。范围使用 UTF-16 code unit offset，范围和数量有预算。

Requirements

• 事件声明：ime.formatUpdate
• 来源：活动 ime-session 句柄
• 信任档位：继承 ime.openSession 的 green

See also

ime.composition、ime.updateState()