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

  1. 호출 블록을 처음 펴는 순간(ADR-0046이 Method의 접힘을 가져오는 때와 같다) Method의 접기 영역을 이름과 접힘까지 그 자리의 접기 영역으로 복사한다.
  2. 그 뒤로 그 자리의 접기 영역은 그 자리의 것이다. 풀기 · 이름 편집 · 접고 펴기가 그 자리에만 적용되고, Method에서 더하거나 풀거나 이름을 바꾼 것은 이미 펴 본 자리에 전달되지 않는다.
  3. 그 자리에는 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이 감수한 것과 같은 까닭(바이트가 같아야 함)이다.
  • 후속 작업: 없음.