ADR-0046: 펴 보인 호출 블록의 접힘은 경로마다 view.folded에 경로를 앞에 붙여 저장한다

이후 변경

  • 2026-11-21: 펴 보인 곳에서 접고 펴는 것(경로를 앞에 붙인 view.folded의 항목을 넣고 빼는 것)과 펴 보기도 실행 취소의 대상이 되었다 → ADR-0048
  • 2026-11-21: 처음 펼 때 Method의 접기 영역도 그 자리의 접기 영역(siteFolds)으로 복사하고, 그 뒤로 그 자리에는 Method의 접기 영역을 그리지 않는다. b4/는 “복사함”의 표시도 되고, Method에 접기 영역이 있으면 파일에 언제나 적는다. 경로 뒤의 항목(b4/r3)은 분기 · 반복 블록만 남는다 → ADR-0047, CB14
  • 2026-11-19: 펴 보인 곳의 분기 · 반복 블록의 본문도 그 자리에서 접고 펼 수 있게 했다. 이 ADR의 “결과”가 감수한다고 적은 한계(접힌 채 가져온 분기를 펼 수 없음)는 없어졌다. 저장 방식은 이 ADR 그대로다(b4/r3) → CB13, 호출 블록 펴 보기

배경

지금까지 펴 보인 블록 안의 접힘은 Method에 저장된 접힘을 따랐다. view.folded에 id가 한 번만 있으므로 펴 보인 곳에서 접으면 Method와 그 Method를 펴 보인 모든 곳이 함께 바뀌었다(CB12).

메인테이너가 규칙을 다시 정했다(2026-11-19 → CB13). “함수호출을 펼치고, 그 안의 접기영역을 접었다 펼쳤다하니, 함수에서도 해당 접기영역이 같이 움직이네요. 안 그랬으면 좋겠어요.” “반대로 메소드에서 접거나 펼쳐도 호출 블록에는 영향을 주지 말아야합니다. 호출 블록은 처음 펼칠 때만 영향을 받습니다.”

  1. 호출 블록을 처음 펴는 순간의 Method 접힘을 그 호출 블록으로 가져온다.
  2. 그 뒤 호출 블록, Method, 같은 Method를 호출하는 다른 호출 블록의 접힘은 서로 영향을 주지 않는다. 겹쳐 펴 보인 안쪽 호출 블록도 경로마다 따로다.
  3. 닫았다가 다시 펴면 그 자리에서 마지막으로 본 접힘이 보이고, 이 상태는 파일에 저장된다.
  4. 이미 저장한 문서의 펴 보인 호출 블록은 열 때 그때의 Method 접힘을 가져와 지금 모습 그대로 보인다.

관련 요구사항: R-EDIT-15, R-FMT-11.

결정 기준

  • 펴 보인 호출 블록 안에 접힌 것이 없는 문서는 저장 결과가 지금과 바이트까지 같다(QA-03).
  • 열고 바로 저장하면 그대로다(QA-04).
  • 이 변경 전의 앱으로 새 파일을 열어도 깨지지 않는다. 파서는 정의되지 않은 키가 있는 객체를 깨진 파일로 거부한다(3.3 노드별 필드).
  • 접힘은 뷰 상태다. 실행 취소의 대상이 아니고, 없어진 id를 가리켜도 오류가 아니다(약한 참조).

검토한 대안

A. view에 새 필드를 둔다 (siteFolded: [{ path, folded }])

  • 장점: 구조가 드러난다. 스키마로 모양을 검증할 수 있다.
  • 단점: 이 변경 전의 앱이 정의되지 않은 키 때문에 파일을 깨진 파일로 거부한다. 막으려고 형식 버전을 올리면 모든 파일의 바이트가 바뀌어 첫 기준을 어긴다.

B. view.folded의 항목에 경로를 앞에 붙인다

  • 장점: 파일의 구조가 그대로다. 이전 앱은 이 항목을 없는 id로 읽어 무시하고(약한 참조), 저장할 때 버린다. 화면 id(b4/b17, CB3)와 같은 표기라 레이아웃의 접두사를 그대로 쓴다.
  • 단점: 문자열 안에 구조가 있다. folded의 항목이 모두 id라는 가정이 깨지므로 읽는 곳을 한 모듈(core/src/model/site-folded.ts)에 모아야 한다.

C. 호출 블록(내용)에 접힘을 둔다

  • 장점: 호출 블록을 복사 · 삭제할 때 저절로 따라간다.
  • 단점: 접고 펴는 것이 내용을 바꾸어 실행 취소의 대상이 된다. 뷰 상태와 내용을 나눈 원칙(ADR-0018, Q9)을 어긴다.

결정

B를 택한다. 호출 경로 b4(겹쳐 폈으면 b4/b9)마다 view.folded에 다음 항목을 둔다.

항목뜻
b4/이 자리는 자기 접힘을 갖는다(표시). 없으면 아직 Method의 접힘을 가져오지 않은 자리다
b4/r3이 자리에서 Method의 분기 · 반복 블록 · 접기 영역 r3이 접혀 있다

이 자리의 접기 영역(SiteFold)은 이미 자리마다 다른 id이므로 지금처럼 경로 없이 적는다.

  • 가져오기: editor의 세션은 문서를 받거나 뷰 상태 · 내용이 바뀔 때마다, 그려지는 경로 가운데 표시가 없는 것에 그 순간의 Method 접힘을 복사한다(settleSiteFolds). 레이아웃은 표시가 없는 자리를 Method의 접힘으로 그린다.
  • 파일에 적는 것: 다시 열었을 때 같은 모습이 되는 자리는 적지 않는다. 펴 보인 자리는 접힘이 Method와 같으면, 닫힌 자리는 이 자리와 Method 모두 접힌 것이 없으면 적지 않는다. 그 밖에는 표시와 접힌 항목을 문서 순서로 folded의 뒤에 적는다. 없어진 경로, Method에 없는 id는 적지 않는다.
  • 호출 블록이 바뀔 때:
일그 자리의 접힘
호출 블록 풀기 (CB8)들어온 사본이 그 자리의 접힘을 이어받는다. 안쪽에서 펴 보인 호출 블록의 접힘은 그 사본의 경로로 옮긴다
호출 대상 바꾸기버린다. 새 Method를 처음 펴는 것과 같다
호출 블록 복사 · 붙여넣기이어받지 않는다. 사본은 새 호출 블록이라 처음 펼 때 Method의 접힘을 가져온다
호출 블록 삭제, Method 삭제세션에는 남겨 실행 취소하면 되돌아온다. 파일에는 적지 않는다
새 Method로 빼기따로 처리하지 않는다. 블록의 id가 그대로라 호출 블록의 접힘은 유지되고, 경로가 없어진 항목은 파일에 적지 않는다

결과

  • 좋아지는 점: 이전 앱과 파일을 주고받아도 깨지지 않는다. 이전 앱이 저장하면 이 항목이 사라지고, 새 앱은 그 파일을 규칙 4대로 연다. 파일의 구조와 형식 버전이 그대로다.
  • 감수하는 점:
    • 닫힌 호출 블록에서 이 자리와 Method 모두 접힌 것이 없으면 파일에 남지 않는다. 그래서 그 파일을 다시 연 뒤 Method에서 접고 나서 이 호출 블록을 펴면, 처음 펴는 것처럼 Method의 접힘을 가져온다. “접힌 것이 없는 문서는 바이트가 같다”는 기준과 양립할 수 없어 감수한다.
    • 호출 대상 바꾸기를 실행 취소해도 버린 접힘은 돌아오지 않는다(뷰 상태는 실행 취소의 대상이 아니다).
    • 펴 보인 곳의 분기 · 반복 블록의 본문은 접고 펼 수 없다(지금 그대로다). 그래서 처음 펼 때 접힌 채 가져온 분기는 그 자리에서 펼 수 없다 → 호출 블록 펴 보기
  • 후속 작업: 없음.