ProseMirror: 특정 노드 중첩 시 splitBlock 명령 크래시

현상

2025년 4월, prosemirror-commands(v1.6.2에서 수정됨)에서 회귀 버그가 발견되었습니다. 부모 노드 내에 형제 노드가 존재하는 블록의 가장 끝에서 splitBlock 명령을 실행할 때, 분할 깊이를 찾는 로직이 문서 크기를 잘못 계산하여 치명적인 RangeError를 유발했습니다. 이로 인해 복잡한 구조를 가진 문서에서 에디터를 사용할 수 없는 문제가 발생했습니다.

재현 단계

1. 1.6.0 이상 1.6.2 미만의 prosemirror-commands를 사용합니다.
2. 블록 노드(예: blockquote) 내부에 또 다른 블록(예: paragraph)이 있고, 그 뒤에 형제 노드가 뒤따르는 문서를 생성합니다.
3. 내부 단락의 가장 끝에 캐럿을 위치시킵니다.
4. splitBlock 명령을 실행합니다(예: Enter 키 입력).

관찰된 동작

• 크래시: 브라우저 콘솔에 ProseMirror 라이브러리 내부에서 발생한 RangeError: Position out of range가 기록됩니다.
• 뷰 동결: DOM이 업데이트되지 않으며 이후의 추가 입력이 차단될 수 있습니다.

예상 동작

부모 노드의 구조를 유지하면서 내부 블록만 정상적으로 분할되어야 합니다.

참고 및 해결 방법

해결책: Commands 패키지 업데이트

이는 라이브러리 레벨의 로직 오류였습니다. 문장 경계 근처에서 분할할 때 범위 계산 방식을 수정하여 해결되었습니다.

# 최신 버전으로 업데이트하여 해결
npm update prosemirror-commands

• ProseMirror-commands v1.6.2 릴리스 노트
• ProseMirror GitHub 커밋: fix(splitBlock) correctly calculate range