ADR-0047: 호출 블록을 처음 펼 때 Method의 접기 영역을 그 자리의 접기 영역으로 복사한다
이후 변경
- 2026-11-21: 펴 보기도 실행 취소의 대상이 되어, 처음 펼 때의 복사는 그 펴 보기와 한 단계다. “결정”의 표에서 “호출 블록을 펼 때”는 따로 만드는 단계가 아니라 펴 보기의 단계이고, 그 단계를 실행 취소하면 사본이 사라지면서 호출 블록도 접힌다(“결과”의 “펴진 채
b4/가 남음”은 더 일어나지 않음) → ADR-0048
배경
펴 보인 호출 블록 안에는 Method의 접기 영역(FoldMark)과 그 자리의 접기 영역(SiteFold, 1.6 펴 보인 곳의 접기 영역)이 함께 그려졌다. Method의 접기 영역은 Method의 것이라 펴 보인 곳에서 풀거나 이름을 바꿀 수 없었다(접힘만 그 자리의 것이었다 → ADR-0046). 메인테이너가 이것을 결함으로 알렸다: 펴 보인 곳에서 접기 영역을 풀 수 없다.
메인테이너가 시안 M69의 SF1에서 2번 “처음 펼 때 Method의 접기 영역을 이 자리로 복사”를 골랐다(2026-11-21 → CB14). “접기영역은 가시성과 강조를 위한 것입니다. 다이어그램의 진정한 내용이 아니에요. 따라서 메소드에서 변경한 것을 호출블록 펼침에 적용할 필요가 없습니다.” 견준 안과 그림 → 시안 M69 https://claude.ai/artifact/FewcYev31r8gVFanWEKiqV · 사본 journal/assets/2026-11-21-site-fold-remove-study.html
- 호출 블록을 처음 펴는 순간(ADR-0046이 Method의 접힘을 가져오는 때와 같다) Method의 접기 영역을 이름과 접힘까지 그 자리의 접기 영역으로 복사한다.
- 그 뒤로 그 자리의 접기 영역은 그 자리의 것이다. 풀기 · 이름 편집 · 접고 펴기가 그 자리에만 적용되고, Method에서 더하거나 풀거나 이름을 바꾼 것은 이미 펴 본 자리에 전달되지 않는다.
- 그 자리에는 Method의 접기 영역을 더 그리지 않는다.
관련 요구사항: R-EDIT-15, R-EDIT-16, R-FMT-11.
결정 기준
- 모델과 파일의 구조를 바꾸지 않는다. 이 변경 전의 앱으로 새 파일을 열어도 깨지지 않는다(파서는 정의되지 않은 키를 거부한다 → 3.3 노드별 필드).
- 같은 모델은 같은 바이트로 저장한다(QA-03). 펴 본 Method에 접기 영역이 없는 문서는 저장 결과가 지금과 같다.
- 열고 바로 저장하면 그대로다(QA-04). 한 번 복사한 자리는 다시 열어도 다시 복사하지 않는다.
- 그 자리의 접기 영역은 지금처럼 내용(
Call.siteFolds, ADR-0017)이다. 만들고 푸는 것은 실행 취소의 대상이다.
검토한 대안
A. 복사했다는 표시를 호출 블록(내용)에 둔다
- 장점: 복사와 표시가 같은 실행 취소 단계에 묶인다.
- 단점:
Call에 새 필드가 필요하다. 이전 앱이 정의되지 않은 키 때문에 파일을 거부한다.
B. 복사했다는 표시로 ADR-0046의 b4/를 쓴다
- 장점: 새 표기가 없다.
b4/는 이미 “이 자리는 자기 접힘을 갖는다”이고, 처음 펼 때 함께 생긴다. 접힘과 접기 영역을 한 번에 가져오므로 뜻이 맞는다. 이전 앱은 이 항목을 없는 id로 읽고 무시한다. - 단점: 표시는 뷰 상태(실행 취소의 대상이 아님)이고 복사한 영역은 내용이라, 복사를 실행 취소하면 표시만 남는다(아래 “결과”).
C. 복사하지 않고 Method의 접기 영역마다 “이 자리에서 숨김 · 이름”을 둔다
- 장점: 내용이 바뀌지 않는다.
- 단점: Method의 변경이 계속 전달된다. 메인테이너가 고른 규칙(2)과 다르다.
결정
B를 택한다.
- 복사:
core의settleSiteFolds(doc)가 그려지는 경로 가운데b4/가 없는 것마다 ADR-0046대로 접힘을 가져오고, 그 경로가 끝나는 Method의 접기 영역 전부(안쪽 줄의 것까지, 이름 포함)를 가장 바깥 호출 블록의siteFolds에 새 id로 더한다.via는 경로에서 가장 바깥 호출 블록을 뺀 것이다(b4/b9이면["b9"]). Method에서 접혀 있던 영역은 그 사본의 id를view.folded에 적는다. 그 자리에 범위(first·last)가 같은 영역이 이미 있으면 그 영역은 복사하지 않는다(붙여넣은 호출 블록, 실행 취소로 돌아온 영역의 중복을 막는다). - 그리기:
b4/가 있는 자리에서는 Method의FoldMark를 그리지 않고 그 자리의 영역만 그린다(shownItems).b4/가 없는 자리(아직 정리하지 않은 이전 파일을core만으로 그릴 때)는 지금처럼 Method의 것을 그린다. - 만들기 검사: 펴 보인 곳에서 새 접기 영역은 그 자리의 영역(복사한 것 포함)과만 같은 범위 · 걸침을 검사한다(CB10). Method의 영역은 그 자리에 그려지지 않으므로 세지 않는다.
- 실행 취소: 복사는 내용을 바꾼다. 일어난 곳에 따라 이렇게 한다.
| 복사가 일어난 때 | 실행 취소 · 저장 표시 |
|---|---|
| 호출 블록을 펼 때(뷰 변경) | 실행 취소 단계 하나를 따로 만든다. 문서는 바뀐 것(●)이 된다 |
| 명령이 내용을 바꾸며 새 자리가 그려질 때(풀기, 호출 대상 바꾸기 등) | 그 명령의 단계에 묶인다 |
| 실행 취소 · 다시 실행 뒤 | 그 단계에 묶인다(새 단계를 만들지 않는다) |
| 문서를 열 때(이전 파일) | 단계를 만들지 않고 바뀐 것으로 표시하지도 않는다. 연 모습이 기준이다 |
| 보기 모드에서 펼 때 | 단계를 만들지 않고 저장 표시도 그대로다 |
- 파일에 적는 것: ADR-0046의 규칙에 하나를 더한다. 경로가 끝나는 Method에 접기 영역이 있으면
b4/를 언제나 적는다(다시 열 때 또 복사하지 않도록). Method에 접기 영역이 없으면 지금처럼 다시 열어 같은 모습이 되는 자리는 적지 않는다.b4/r3처럼 경로 뒤에 붙인 항목은 분기 · 반복 블록만 적는다. Method의 접기 영역의 id는 더 적지 않는다(그 자리에 그려지지 않으므로 뜻이 없다). - 이전 파일: 펴 보인 호출 블록에
b4/가 없으면 처음 펴는 것으로 보고 열 때 복사한다. 연 모습은 지금과 같다(Method의 영역이 같은 범위 · 이름 · 접힘의 사본으로 바뀐다). - 호출 블록이 바뀔 때: ADR-0046의 표에 다음을 더한다.
| 일 | 그 자리의 접기 영역 |
|---|---|
| 호출 블록 풀기 | b4/가 있으면 그 자리의 영역만 보통 접기 영역이 되어 들어온다(Method의 영역은 들어오지 않는다). 없으면 지금처럼 Method의 영역과 그 자리의 영역이 함께 들어온다 |
| 호출 대상 바꾸기 | 지금처럼 그 호출 블록의 siteFolds를 비운다. 새 Method를 처음 펴는 것과 같아 새 Method의 영역을 복사한다 |
| 호출 블록 복사 · 붙여넣기 | 사본은 siteFolds(복사한 영역 포함)를 가져가고 b4/는 가져가지 않는다. 처음 펼 때 같은 범위가 없는 Method의 영역만 더 복사한다 |
결과
- 좋아지는 점: 펴 보인 곳의 접기 영역이 모두 같은 규칙(풀기 · 이름 편집 · 접고 펴기)을 따른다. 파일의 구조와 형식 버전이 그대로다. 이전 앱은 사본을 그 자리의 영역으로 읽는다(Method의 영역과 범위가 같으면 하나만 그린다).
- 감수하는 점:
- 처음 펴는 것이 Method에 접기 영역이 있을 때 실행 취소 단계 하나와 저장 표시를 만든다(메인테이너가 받아들임). 그 단계를 실행 취소하면 그 자리의 사본이 사라지고, 호출 블록은 펴진 채
b4/가 남아 다시 복사하지 않는다. 그 자리에는 접기 영역이 없는 모습이 된다. 다시 실행하면 돌아온다. - 이전 파일을 열고 바로 저장하면, 펴 보인 호출 블록이 부르는 Method에 접기 영역이 있을 때 바이트가 바뀐다(사본과
b4/가 더해진다). 그 뒤로는 열고 저장해도 그대로다. - 닫힌 자리에서
b4/를 적지 않는 경우(Method에 접기 영역이 없고 접힌 것도 없음), 그 파일을 다시 연 뒤 Method에 접기 영역을 더하고 그 호출 블록을 펴면 처음 펴는 것처럼 복사한다. ADR-0046이 감수한 것과 같은 까닭(바이트가 같아야 함)이다.
- 처음 펴는 것이 Method에 접기 영역이 있을 때 실행 취소 단계 하나와 저장 표시를 만든다(메인테이너가 받아들임). 그 단계를 실행 취소하면 그 자리의 사본이 사라지고, 호출 블록은 펴진 채
- 후속 작업: 없음.