Markdown 기호의 원문 투영과 커서 이동·편집을 연결한다

[developer-1px]

목표

• 결과: 제목 블록과 왼쪽 H1~H6 표시를 유지하면서 방향키로 제목 표시의 원문 위치에 이동해 편집할 수 있다.
• 완료 조건: 좌우 이동, 해당 위치에서 # 입력·Delete·Backspace, 제목 단계 변경과 일반 문장 전환, 실행 취소를 실제 Bear 화면에서 검증한다.
• 유지 조건: Markdown 원문·복사·선택 좌표를 보존하고 기존 IME 처리를 유지한다. 다른 Markdown 문법의 표시 정책은 변경하지 않는다.

범위와 근거

사용자 요청: “heading만 헤딩 블록을 유지하고 h1/h2/h3/4 등의 표기를 좌측 블록 옆에 기호로 표기”, “키보드 왼쪽으로 커서도 H1 마크로 보낼수있고 # 이나 del bs 등도 가능하게”.
기존 app-bear 구현 위에 제목 표시와 편집 연결을 추가한다. Bear 화면에 편집 로직을 직접 추가하지 않고 기존 정본 패키지의 책임 경계를 따른다.

진행 및 검증

1. 제목 원문과 시각적 표시·커서 좌표 연결
2. 입력·삭제·선택·실행 취소 검증
3. 관련 패키지 테스트·타입 검사와 Chrome Bear 흐름 검증 후 PR

후속 합의: 인용문 Enter

사용자 요청에 따라 내용이 있는 인용 줄에서 Enter를 누르면 같은 글상자를 다음 줄로 이어가고, 빈 인용 줄에서 Enter를 누르면 일반 문단으로 빠져나옵니다. 원문 결정은 Markdown 공개 API, 입력 수명은 contenteditable, 변경·선택·Undo는 Editing이 소유합니다. 붙여넣기는 원문 그대로 유지합니다. 원문·IME 명령 연결·실제 Bear Enter 및 Undo/Redo·Usage 소스 등록을 검증합니다.

후속 합의: 수직 커서 이동의 경계 보정

실제 키 입력으로 확인한 인용문 경계부터 순차 개선합니다. 첫 범위는 동일한 원문 offset의 유효한 DOM 선택을 보존하고, 숨긴 인용 기호와 블록 배치 때문에 발생하는 수직 이동 정지·건너뛰기를 줄이는 것입니다. 일반 텍스트·자동 줄바꿈의 native 이동을 유지하며, ↑↓와 Shift 선택·기존 원문 편집을 검증합니다. 전면적인 수직 이동 엔진 도입은 이번 범위가 아닙니다.

2026-09-11 수직 이동 조사 기록

• 재현 원문: abcdefghij\n> quote text\n> next line\n\nabcdefghij, 시작 offset 7. Chrome에서 ↓ 직후 native 선택은 숨긴 > 의 시작(offset 11)에 놓이지만, 원문 선택 동기화가 같은 offset인 이전 개행 Text node 끝으로 다시 배치했습니다. setBaseAndExtent 전후 DOM endpoint와 좌표를 기록해 확인했습니다.
• 첫 수정: 명시적 affinity가 없는 endpoint는 현재 DOM 위치가 같은 원문 offset을 가리키면 보존합니다. anchor/focus를 각각 판단하며, DOM 교체로 무효화되면 기존 복원을 수행합니다. projection adapter도 모든 위치에 backward를 강제하지 않습니다. following의 명시적 forward 정책은 유지합니다.
• 결과: 인용 진입 뒤 모델 동기화가 커서를 인용 밖으로 옮기는 문제가 사라졌고, 재현 fixture에서 아래 문단까지 내려간 뒤 위로 돌아올 때 시작 offset 7과 가로 위치가 복원됐습니다.
• 남은 현상: native ↑가 인용 내부 줄을 건너뛰거나 숨긴 인용 접두사에 멈추는 현상은 여전히 있습니다. 첫 수정이 전체 수직 이동 해결을 뜻하지 않습니다.
• 비교 실험: 인용 display를 inline-block에서 block으로 바꾸면 위쪽 진입은 달라지지만 여분의 빈 줄과 가로 위치 손실이 발생했습니다. 숨긴 source를 static·font-size:0으로 바꿔도 추가 정지가 생겼습니다. 두 CSS 실험은 제품에 반영하지 않았습니다.
• 일반 텍스트의 긴 줄→짧은 줄→긴 줄, 인용 내부 자동 줄바꿈은 기존 native 이동으로 정상 왕복했습니다. 원문에 실제 빈 줄이 있는 제목·목록 사이 정지와 인용 경계 결함을 구분합니다.

후속 합의: 문법별 예외를 공용 화면 줄 탐색으로 수렴

사용자가 다양한 실제 키 입력 검사를 통해 하나의 솔루션과 생태계 모듈을 찾도록 요청했습니다. 이전 단계의 전면 이동 보류 범위를 확장해, 원문 문자열 DOM adapter의 선택적 공용 수직 이동 기능을 구현·검증합니다.

책임 감사 범위는 source-string contenteditable 입력·DOM 복원·투영, Markdown Web·React, Bear와 Markdown caret Usage입니다. 저장소 검색에서 이에 해당하는 기존 화면 줄 이동 구현은 없었습니다. 분류는 contenteditable의 canonical API gap 1건, Markdown Web/React의 canonical consumer 2건, Bear/Usage의 Host composition 2건입니다. 구조화된 Rich Text의 node-point 선택과 Canvas 공간 navigation은 좌표·의미 계약이 달라 범위 밖입니다.

createTextNavigationDOMAdapter가 보이는 DOM 줄·hit test·가로 목표 위치를 소유하고 기존 projection adapter가 이를 조합합니다. 입력 수명과 키 해석은 기존 binding/Web adapter, 원문·선택·History는 Editing에 남깁니다. 목표는 인용·제목·목록·todo·코드·표·빈 줄·wrap·Shift 선택·스크롤에 동일 알고리즘을 적용하는 것입니다. 수직 writing mode와 Alt/Ctrl/Meta 명령은 native 경로를 유지합니다. 공개 export·소유 API 문서·Usage·source registration과 Markdown 없는 직접 소비 검사까지 연결합니다.

화면 줄 탐색 구현 및 검증 완료

공개 createTextNavigationDOMAdapter를 contenteditable 정본에 추가했습니다. 최종 조합은 Markdown Web이 공개 투영 adapter와 공개 탐색 adapter를 감싸는 형태이며, 투영 adapter 자체에 수직 탐색을 강제하지 않습니다. Bear에는 별도 키 이동 구현을 두지 않습니다. 패키지 API 문서·Usage·소스 등록을 연결했습니다.

브라우저 Range와 caret hit testing으로 보이는 줄을 탐색하고 가로 목표·Shift anchor·스크롤 노출을 유지합니다. 일반 문단, 인용·중첩 인용, 제목, 목록, task, 코드, inline, 표, 한글·emoji 줄바꿈, 빈 마지막 줄과 포인터 초기화를 검사했습니다. Markdown 없이 일반 텍스트 1,000줄에도 같은 공개 API를 적용했습니다.

Chrome 회귀 검사 71개 정상 통과 후, 최종 공개 조합 및 1,000줄 탐색 검사 25개를 정상 재검증했습니다(각 준비 포함). contenteditable 49개, Markdown Web 29개, Usage 등록 1개 단위 검사와 변경 패키지 타입 검사·전체 패키지 빌드 통과. 기존 native ↑ 인용 줄 건너뛰기와 숨긴 기호의 추가 정지는 회귀 검사로 해결을 확인했습니다. Chrome 가로 쓰기 source-text DOM 범위이며, 세로 쓰기·배치 미지원은 native fallback입니다. 구조화된 rich-text와 Canvas의 별도 좌표 모델은 이번 범위 밖입니다.

최종 사이트 production 빌드 통과. 기존 theme utility·chunk 크기 경고는 유지됩니다.

[developer-1px]

목표

• 결과: 제목 블록과 왼쪽 H1~H6 표시를 유지하면서 방향키로 제목 표시의 원문 위치에 이동해 편집할 수 있다.
• 완료 조건: 좌우 이동, 해당 위치에서 # 입력·Delete·Backspace, 제목 단계 변경과 일반 문장 전환, 실행 취소를 실제 Bear 화면에서 검증한다.
• 유지 조건: Markdown 원문·복사·선택 좌표를 보존하고 기존 IME 처리를 유지한다. 다른 Markdown 문법의 표시 정책은 변경하지 않는다.

범위와 근거

사용자 요청: “heading만 헤딩 블록을 유지하고 h1/h2/h3/4 등의 표기를 좌측 블록 옆에 기호로 표기”, “키보드 왼쪽으로 커서도 H1 마크로 보낼수있고 # 이나 del bs 등도 가능하게”.
기존 app-bear 구현 위에 제목 표시와 편집 연결을 추가한다. Bear 화면에 편집 로직을 직접 추가하지 않고 기존 정본 패키지의 책임 경계를 따른다.

진행 및 검증

1. 제목 원문과 시각적 표시·커서 좌표 연결
2. 입력·삭제·선택·실행 취소 검증
3. 관련 패키지 테스트·타입 검사와 Chrome Bear 흐름 검증 후 PR

[developer-1px]

제목 H1~H6의 원문 접두사에 native caret을 유지하고, 공용 TextDOMAdapter의 선택적 resolveHorizontalSelection 계약으로 접두사와 본문의 같은 원문 offset 경계를 연결했습니다. 키 이벤트 처리는 contenteditable binding이 담당하며 Bear에는 편집 로직을 추가하지 않았습니다.

Chrome에서 모든 제목 단계의 왕복 방향키·Shift 선택/복사·# 입력·Backspace·Delete·Undo와 모바일 caret 위치를 확인했습니다. 기존 한글 IME 재현 흐름도 통과했습니다. 제목 표시의 CSS 대체 텍스트는 복사 원문에 추가되지 않습니다.

기존 Bear 구현에 의존하므로 app-bear를 base로 하는 PR에 이번 제목 변경만 담습니다. main 병합은 이번 범위에 포함하지 않습니다.

[developer-1px]

PR #766을 열었습니다. feat/765-heading-marker의 21d235b3를 push했고 원격 PR head와 일치합니다.

단위 테스트 56개, Chrome 제목·문법 및 Bear·IME 검사, 변경 패키지 타입 검사, 전체 패키지·사이트 빌드가 통과했습니다. 사이트 빌드는 빈 theme utility 및 큰 chunk 경고를 출력했습니다. 자동 PR 검사는 등록되어 있지 않아 원격 CI 통과로 보고하지 않습니다.

목표의 이동·입력·삭제·Undo 조건을 충족했으며 Markdown 원문·복사·기존 IME 동작을 보존했습니다. 이번 PR은 app-bear 기준이며 main 병합은 수행하지 않았습니다.

[developer-1px]

승인된 계약 변경 — 시각적 투영 구간을 정본 모듈로 만든다

사용자 승인: “해보자 이건 핵심 모듈이니까”. 직전 논의의 원문 구간 투영 계약과 정본 모듈 감사 결과를 적용한다.

• 결과: H1~H6는 한 시각적 단위로 표시하고 방향키는 마커 앞뒤로 이동한다. 커서는 실제 마커 표시 영역의 양 끝에 맞는다.
• 완료: 제목 시작 → 마커 뒤 → 마커 앞 및 역방향 이동, # 입력·Backspace·Delete·Shift 선택·복사·Undo와 시각적 커서 정렬을 검증한다. 마커 밖에서는 native caret을 사용한다.
• 유지: Markdown 문자열을 정본으로 유지한다. 문서 모델 atom이나 원문 전체를 한 번에 삭제하는 정책은 도입하지 않는다. 제목 뒤 공백과 본문 시작은 원문 좌표로 구분한다. 기존 IME 동작을 보존한다.

기존 글자별 접두사 이동을 마커 앞뒤 이동으로 변경한다. 모듈은 원문 구간·표시 요소·선택 경계의 대응을 소유하며 Markdown은 제목 구간·H 표시에 대한 정책만 제공한다. 키 해석은 기존 Web keyboard adapter를 사용하고, DOM 선택 복원의 경계 선택 능력은 contenteditable 정본 API를 확장한다.

진행: 공용 계약·소유자 테스트 → Markdown 소비 전환 → 소유 패키지 문서·Usage·소스 등록 → 브라우저와 IME 검증 → 기존 PR #766 갱신. 다른 문법과 협업 runtime의 적용은 범위 밖이다.

[developer-1px]

공용 createTextProjectionDOMAdapter/TextProjection을 contenteditable Adapter에 구현했습니다. Markdown은 제목 원문 범위와 H 표시 요소를 제공하는 소비자입니다. 좌우 키 해석은 Web keyboard adapter로 통합했고 Markdown의 직접 setBaseAndExtent 보정을 제거했습니다. DOM 복원은 공용 affinity 계약으로 한 번만 수행합니다.

Chrome 15개 검사(서버 준비 1개 포함)에서 H1~H6 마커 양 끝의 caret 좌표·높이, 앞뒤 이동·Shift 복사·# 입력·삭제·Undo·모바일 및 기존 한글 IME 흐름을 확인했습니다. 공용 구간 테스트는 Markdown 없는 [[key]] fixture와 인접 구간을 사용합니다.

소유 패키지의 API reference, CSS export, Usage source registration을 추가했습니다. 패키지 dry-run에서 JS·타입·CSS 포함을 확인했고 소스 연결 회귀 검사도 통과했습니다. 타입 검사·전체 패키지·사이트 빌드가 통과했으며 사이트 빌드는 기존과 동일한 빈 theme utility 및 큰 chunk 경고를 출력했습니다.

[developer-1px]

PR #766을 최종 계약에 맞춰 갱신하고 74d25317을 push했습니다. 원격 PR head와 작업 HEAD가 일치하며 작업 트리는 깨끗합니다.

정본 모듈·공개 API·소유자 계약 테스트·문서·Usage·소스 등록·배포 CSS를 연결했습니다. Markdown의 직접 DOM 선택 재설정과 binding의 좌우 키 해석 중복을 제거했습니다. 총 단위/Usage 검사 61개와 Chrome 검사 15개, 타입·빌드 검증이 통과했습니다. 남은 main 병합은 수행하지 않았으며 PR은 열려 있습니다.

[developer-1px]

REC ba95af50에서 제목 본문 시작(source offset 23)의 deleteContentBackward가 바로 앞 공백(offset 22) 대신 제목 뒤 개행을 삭제하는 것을 확인했습니다. 반복 입력은 후속 문단을 합치며 숨긴 문법까지 제거했습니다.

초기 Bear 문서에서 실제 Cmd+ArrowLeft → Backspace 5회로 같은 실패를 재현했습니다. 공용 투영 adapter에 원문 삭제 범위 계산 계약을 추가하고, binding이 해당 경계의 cancelable 삭제를 Editing replace로 반영하도록 수정했습니다. 삭제는 grapheme 한 개 또는 선택 범위를 대상으로 하며 Undo는 삭제 직전 caret을 보존합니다. 조립 중 IME와 native lease는 가로채지 않습니다.

수정 후 동일 재현에서 앞쪽 원문만 5회 삭제되고 후속 문단·문법이 보존되며 Undo 5회로 원문 전체가 복원되는 것을 확인했습니다. 기존 제목·IME 회귀 검사와 타입 검증을 진행합니다.

[developer-1px]

ba95af50 회귀를 59cbcd7d로 수정하고 PR #766에 push했습니다. Chrome에서 동일 실패를 먼저 확인한 뒤 수정 후 연속 Backspace 5회·Undo 5회와 후속 문단 보존을 검증했습니다.

contenteditable 41개·Markdown Web 21개 단위 테스트, Chrome 16개 검사, 변경 패키지 타입 검사·전체 패키지·사이트 빌드가 통과했습니다. 기존 한글 IME 흐름도 통과했습니다. 사이트 빌드의 빈 theme utility·큰 chunk 경고는 남아 있습니다.

[developer-1px]

승인된 계약 변경 — 원문 보존형 Markdown 편집

사용자 승인: 공백을 그대로 허용하는 편집용 Markdown 사례를 조사한 뒤 “그렇게 만들자”.

• Outcome: CommonMark + GFM을 해석하되 편집 화면은 원문 공백을 보존한다. 제목의 H1~H6 표시는 유지하고 기호 뒤 공백을 그대로 표시·편집한다.
• Done: 제목의 연속 공백·탭·앞뒤 공백이 원문 좌표와 시각적 폭을 유지하고, 방향키·입력·삭제·복사·Undo가 원문에 대응함을 검증한다. 원문 보존과 기호 표시를 구분하는 편집 계약을 기존 소유자 문서에 명시한다.
• Don't: CommonMark/GFM 파서의 문법 의미, 원문 문자열 정본, 기존 IME 처리를 유지한다. 새 Markdown dialect나 문서 모델 atom을 만들지 않는다.

기존 제목 접두사 전체를 숨기던 표현에서 기호만 투영하고 공백은 노출하도록 변경한다. 기존 정본 Markdown Web adapter에서 처리하며 Bear에는 별도 편집 로직을 추가하지 않는다.

진행: 원문 gap 처리 확인 → 제목 기호·공백 분리 및 계약 문서 → 원문 좌표와 Chrome 편집 회귀 검증 → 기존 PR #766 갱신.

[developer-1px]

제목 접두사에서 H1~H6로 투영할 기호만 분리했습니다. 연속 공백·탭·제목 앞뒤 공백은 일반 원문으로 남아 시각적 폭과 개별 커서 이동을 유지합니다. CommonMark/GFM 파서와 Bear의 편집 조합은 그대로 사용합니다. 소유 패키지의 원문 보존형 편집 계약과 Usage의 공백 예제를 갱신했습니다.

검증: Markdown Web 25개 단위 검사, 소스 등록 검사 1개, 패키지 타입 검사와 사이트 빌드 통과. Chrome에서 기존 H1~H6·IME·전체 문법 15개 시나리오와 REC 경계 2개 시나리오를 통과했습니다.

기존 REC 검사의 Cmd+ArrowLeft 기대 위치는 숨겨진 공백 이후였으나, 공백 노출 후 실제 위치는 공백 앞(source offset 22)입니다. 실제 위치를 확인하고 줄 시작과 제목 본문 시작(offset 23)을 각각 검증하도록 분리했습니다. 두 경우 모두 Backspace 5회·Undo 5회 및 후속 문단 보존이 통과했습니다. 최초 전체 실행의 실패 trace 수집이 종료되지 않아 해당 실행을 중단하고 REC 두 경우를 별도로 실행했습니다. 사이트 빌드의 기존 빈 theme utility·큰 chunk 경고는 남아 있습니다.

[developer-1px]

5ef68857을 PR #766에 push하고 원격 head 일치를 확인했습니다. 승인된 공백 보존 계약·구현·검증·Usage가 연결되어 있으며 작업 트리는 깨끗합니다. pre-push 전체 패키지 빌드도 통과했습니다. PR은 app-bear 기준으로 열려 있습니다.

[developer-1px]

승인된 계약 변경 — 제목과 본문의 시작선 정렬

사용자 승인: 첫 문법 구분 공백은 마커 쪽, 추가 공백은 본문 쪽에 배치하자는 설명에 “그렇게 하자”.

• Outcome: # Bear의 제목 글자와 일반 본문의 시작선을 맞춘다.
• Done: H1~H6의 정렬, 추가 공백의 폭, 기존 커서 경계 이동·삭제·Undo를 Chrome에서 검증한다.
• 유지: 첫 구분 공백도 원문에 보존하고 편집할 수 있다. CommonMark/GFM 의미와 기존 IME 처리를 유지한다.
  기존 Markdown Web 표시 owner에서 첫 구분 공백의 배치를 수정하고 API 문서와 회귀 검사를 갱신한다.

[developer-1px]

6207c108을 PR #766에 push했습니다. 첫 구분 공백은 마커와 본문 사이에 배치하고 추가 공백은 제목 안에 보존합니다. H1~H6 제목·본문 시작선 정렬과 추가 공백 폭, 기존 커서·삭제·Undo 및 Bear/IME 총 20개 제품 시나리오, 단위 25개, 전체 패키지·사이트 빌드가 통과했습니다. Cmd+ArrowLeft는 정렬된 제목 본문 시작(offset 23)에 도착하며 두 REC 경로의 Backspace·Undo 회귀도 통과했습니다. 사이트 빌드의 기존 경고는 유지됩니다.

[developer-1px]

승인된 계약 변경 — Markdown 기호 전반에 원문 투영 적용

사용자 요청: “이 모듈을 바탕으로 모든 md가 만드는 기호에 적용해보자. li 불릿, blockquoute code fence ol, todo 등등”, 이어서 goal 등록 요청.

• Outcome: 기존 CommonMark + GFM의 기호를 제목과 같은 원문 구간 투영 모듈로 표시하고 편집한다. 목록 불릿·번호, 인용, 코드 펜스, 체크박스 및 기존 인라인·표 기호를 포함한다.
• Done: 문법별 기호가 정확한 원문 구간과 대응하고, 좌우 경계 이동·입력·Backspace·Delete·선택·복사·Undo와 공백 보존을 검증한다. 중첩 문법과 코드 안의 문자 구분, 기존 제목 정렬·IME 회귀를 검증한다. 소유 패키지 API·문서·Usage·소스 등록을 연결한다.
• 유지: 원문 문자열과 CommonMark/GFM 해석이 정본이다. 문서 모델 atom이나 전체 기호를 한 번에 삭제하는 정책을 도입하지 않는다. 기존 Chrome 프로필·작업 트리의 사용자 데이터를 보존한다.

파서가 인식한 기호 위치와 Markdown Web의 표시 정책을 분리하고, 모든 기호의 좌표·커서·삭제는 기존 contenteditable/Editing 정본 API를 소비한다. Bear와 Demo는 조합과 예제만 소유한다.

진행: 파서의 원문 기호 범위 → Markdown Web 소비 전환 → 문법별 원문/브라우저 회귀 → 문서·Usage 확인 → 기존 PR #766 갱신. 병합은 포함하지 않는다.

[developer-1px]

Markdown의 공개 markers 범위와 MarkdownMarker/MarkdownMarkerKind를 추가했습니다. 기호 인식은 같은 CommonMark/GFM 파싱 과정에서 수행하며 점진적 편집 시 범위도 이동합니다. 중첩 인용·목록의 실제 기호와 코드/HTML의 일반 문장부호를 구분합니다.

Markdown Web의 목록·번호·체크박스·인용·펜스·인라인·표·구분선·Setext·각주·참조·escape·hard break가 기존 공용 원문 구간 투영을 소비합니다. Entity가 섞인 문장에서도 기존 해석 글자를 유지하기 위해 같은 파서 계열의 decode-string을 명시 의존성으로 연결했습니다. 일반 단어는 원문 텍스트로 남아 글자별 이동하며 entity 원문만 한 표시 구간을 가집니다.

공용 contenteditable 모듈에 문법 분기를 추가하지 않았고 Bear에도 편집 코드를 추가하지 않았습니다. Markdown Web의 제목 정규식 인식과 별도 task 표시를 제거했습니다. 소유 패키지 API·문서·Usage·기호 인식 소스 등록을 연결했습니다.

검증: Markdown 45개 + Markdown Web 26개 단위, Usage 소스 연결 1개, Chrome 51개 검사(준비 1개 포함), 패키지 타입 검사·사이트 빌드 통과. Chrome은 26개 문법 fixture의 좌우·Shift 복사·입력·양방향 삭제·Undo, 제목 정렬·공백·IME, 코드 내용·표 행 간격·구분선 폭을 확인했습니다. 사이트 빌드에는 기존 빈 theme utility·큰 chunk 경고가 있습니다.

시각 검증에서 발견한 인라인 코드 내용 숨김과 표의 빈 행을 수정한 뒤 회귀 검사를 추가했습니다. 새 작성 명령이나 문서 모델 atom은 추가하지 않았습니다.