편집 문법의 하이라키와 기본 Profile 계약을 구체화한다

[developer-1px]

여러 editor가 같은 API 이름을 제공해도 대상·후속 선택·Undo 단위와 기본 입력의 의미는 달랐다. standards/editing-grammar.md에 11개 앱 사례와 역사적·현재 공식 자료를 연결하고, 공통 규칙·대상별 계약·입력 계약을 조합하는 Hands profile의 하이라키와 기본 동작을 구체화한다.

단축키로 드러난 작업부터 비교해 탐색·선택·전체 선택·편집·교환·복원·내부 편집 등 12개 기본 동작을 계약표로 정리한다. Text·Document·Tree·Sheet·Object의 작업 대상과 후속 선택을 비교하며, 근육기억으로 익힌 조작과 설정을 생략한 기본 동작도 호환성 계약에 포함한다.

설계와 최소 변경안

• 기존 EG 규칙 9개와 canonical owner를 유지한다. 역사적 반례와 적용 조건을 명시하고, 의미 분류·계약의 조합·실제 구현 책임을 구별한다.
• Alpha의 ph를 X로 교체한 뒤 Undo/Redo하는 공개 API 실행에서 내용·선택 범위·방향·History가 기대와 일치했다. 이 범위에는 Core·History API 확장을 제안하지 않는다.
• 기본 전체 선택은 반복해도 선택을 유지하도록 정한다. 현재 Affordance의 토글 호출을 보존하면서 반복 정책을 선택하는 경로, 구조 editor에서 전체 선택을 한 전이로 적용하는 작업을 제안한다.
• 유효한 대상의 draft가 검증 거절되면 유지하고 재시도할 수 있도록 정한다. 현재 rename session은 editor 거절 후에도 draft를 종료하므로, 기존 void callback을 보존하는 성공 확인 경로의 API 초안과 완료 조건을 적는다.
• Rich Text Web과 구조 입력의 공통 Undo 해석을 Web resolver에 연결하는 변경안을 제시한다. 기존 modifier 수용 범위와 native lifecycle은 호환성 검증 대상으로 남긴다.
• 중첩·Toolbar 대상·여러 view의 History·native Cut·IME 등 12개 조합 검증 질문에서 기존 suite, 임시 공개 API 확인, 아직 검증하지 않은 입력 경로를 구별한다.

검증

• 커밋 97405f78의 CI: Plan·Package·Site 통과, External kit은 계획에 따라 skipped
• 현재 source의 관련 package 빌드: npm exec tsc -- -b packages/json-document-rich-text packages/json-document-affordance 통과
• 관련 기존 테스트: 10 files / 166 tests 통과 — grammar binding, select-all, History, Tree·Object·Sheet, Affordance·Web adapter
• 임시 공개 API 확인: 방향 2 × Undo 후 선택 이동 여부 2 × 직접 호출·metaKey·ctrlKey 해석 3 = 12개 사례 통과
• 현재 전체 선택 토글과 rename 거절 후 draft 종료를 별도로 재현. 제안한 기본 계약의 통과로 집계하지 않음
• npm run docs:evaluate, git diff --check 통과
• 내부 Markdown 링크 46개 참조 / 38개 대상 존재 확인
• GitHub GFM 렌더링: 표 16개 열 구조, code block 6개, 중복 없는 anchor 확인
• 기존 EG 규칙 9개와 canonical owner 표 보존, 전체 diff 검토 완료

변경 파일은 설계 문서 하나다. API 초안과 최소 변경안은 아직 runtime에 적용하지 않았다. 임시 실행의 재현 코드는 이슈에 보관하며 영구 conformance suite의 새 테스트로 집계하지 않는다. DOM/native 입력 전체, 모든 Hands의 구현 완료, Stable admission 또는 독립 구현 간 상호운용을 인증하는 결과가 아니다. show-me는 UI 변경이 없어 해당하지 않는다.

학습 기록

• 추가 조사 읽기 순서
• 단축키와 근육기억에서 문법 도출하기
• 기본 계약표·최소 변경안의 승인 범위
• 공개 API 실행 결과·현재 공백·재현 코드

Closes #725

[developer-1px]

최신 main과 통합하면서 독립적으로 추가된 Paste × Image TBD와 편집 문법 조합 검증 질문을 모두 보존했습니다. runtime 변경 없이 docs:evaluate, git diff --check, pre-push build가 통과했습니다.