composition 중 외부 상태 업데이트·React render·decorations 변경 충돌 조사

[developer-1px]

조사할 것

IME composition 중에 toolbar state, decorations, collaborative update, async React render, remote patch가 들어오면 browser composition target DOM이 바뀔 수 있다. composition을 깨지 않으면서 외부 model update를 반영하는 정책을 조사한다.

근거

• ProseMirror changelog에는 composition 중 document/decorations 변경을 즉시 보여주되, focused text node에 영향을 주는 decorations는 composition cancel 방지를 위해 지연한다는 변경이 있다.
  • https://raw.githubusercontent.com/ProseMirror/prosemirror-view/master/CHANGELOG.md
• ProseMirror changelog에는 composition과 동시에 같은 위치에 content가 삽입되어 invalid change position이 계산된 문제도 있다.
  • https://raw.githubusercontent.com/ProseMirror/prosemirror-view/master/CHANGELOG.md
• Lexical changelog에는 composition 중 format/style 이동 금지, typeahead menu가 IME composition 중 닫히지 않도록 하는 수정이 있다.
  • https://raw.githubusercontent.com/facebook/lexical/main/CHANGELOG.md
• Lexical PR #8148은 composition 중 다른 node로 이동할 때 format/style을 적용하지 않도록 수정했다.
  • [lexical] Bug Fix: Do not apply format and style when moving to different node in composition facebook/lexical#8148

확인 질문

• composition 중 외부 patch를 즉시 model에 적용할 수 있는가?
• focused text leaf를 바꾸는 render/decorator update는 compositionend까지 지연해야 하는가?
• remote update가 composition target과 같은 block을 수정하면 우선순위는 무엇인가?
• React render가 active text leaf DOM을 재생성하면 composition을 어떻게 보존할 것인가?

완료 기준

• composition 중 허용/지연/금지할 update 종류를 표로 만든다.
• active text leaf DOM을 건드리는 render update 감지 기준을 정한다.
• remote patch 또는 async local patch와 composition이 충돌할 때 정책을 정한다.
• composition 중 decoration/toolbar/typeahead update trace scenario를 정의한다.

선행 조건

없음. 바로 시작 가능.

[developer-1px]

완료했습니다.

• docs/editor-composition-render-update-policy-audit.md를 추가했습니다.
• composition 중 update를 허용/지연/금지로 분류했습니다.
• active text leaf DOM을 건드리는 render/decorator/patch 감지 기준을 정했습니다.
• remote patch 또는 async local patch가 composition target과 충돌할 때 queue/rebase/conflict 정책을 정했습니다.
• composition 중 decoration/toolbar/typeahead/remote update trace scenario를 정의했습니다.
• 현재 구현에는 remote/collab queue와 decoration engine이 없다는 점을 구현 사실로 분리했습니다.
• README Docs inventory에 새 문서를 등록했습니다.

검증:

• pnpm run verify:docs
• pnpm run verify:internal -- --repeat=1

커밋: 3bed598