ADR-0017: 접는 범위의 이름은 모델에 저장한다

이후 변경

  • 2026-11-21: 호출 블록을 처음 펼 때 Method의 접기 영역을 이름과 함께 그 호출 블록의 접기 영역으로 복사한다. 그 뒤로 그 자리의 이름은 Method의 이름과 따로다 → ADR-0047
  • 2026-11-03: 접기를 만들었다. 만들 때 이름을 적지 않고 기본 이름(“첫 블록의 텍스트 외 n개”)을 그대로 둔 접기 영역도 이름 없이 파일에 저장되고, 다시 묻지 않는다. 펴 보인 곳의 접기 영역도 이름을 그 호출 블록에 저장한다 → FD2, 접기 · 펼치기
  • 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). “보기 상태”는 뷰 상태다. → 01-architecture
  • 2026-10-17: 접기 영역은 블록을 품는 블록이 아니라 줄(Seq)에 붙은 범위 마커(FoldMark: 같은 줄의 처음 블록 id · 끝 블록 id + 이름)로 모델에 둔다. 블록 트리는 바뀌지 않는다(메인테이너: “A3 · 1번”) → 4.4 문서 모델
  • 2026-10-10: 이 문서가 기준으로 삼은 ADR-0016이 ADR-0018로 대체되었다. 이제 접힘 상태도 파일에 저장하므로 “접고 펴기만 해서는 파일이 바뀌지 않아야 한다”는 기준은 더 적용되지 않는다. 이름을 모델에 저장한다는 결정은 그대로다.
  • 2026-10-10: 용어를 다시 바꿨다. “이름 붙은 범위”(한때 “이름 붙은 영역”)는 지금의 접기 영역이다. 강조 영역을 없앤 뒤로 이 묶음의 쓰임이 접기뿐이고, 이름을 적지 않아도 생기기 때문이다 → 06-glossary
  • 2026-10-10: 강조 영역 요구사항을 없앴다. “강조 영역의 이름은 강조 영역에 저장한다”는 지금 해당하지 않는다. 이름은 모두 접기 영역에 저장한다 → DR-0004
  • 2026-10-10: 용어를 바꿨다. 이 문서의 “선택 범위”는 지금의 선택 영역, “이름 붙은 범위”는 이름 붙은 영역이다. 뜻은 같다 → 06-glossary

배경

선택 범위를 접으면 그 칸에 이름이 보이고, 이름은 처음 접을 때 묻는다. (R-EDIT-14) ADR-0016은 접힘 상태를 파일 밖에 두기로 하고, 이름을 어디에 둘지는 후속 결정으로 남겼다.

이름은 “지금 접혀 있다”는 뷰 상태가 아니다. “이 블록들은 무엇을 한다”는 내용에 가깝다.

결정 기준

  • 다른 기기나 다른 배포 대상에서 열어도 이름이 남아야 한다.
  • 접고 펴기만 해서는 파일이 바뀌지 않아야 한다. (ADR-0016)

검토한 대안

파일 밖에 접힘 상태와 함께 둔다

  • 장점: 모델이 그대로다.
  • 단점: 다른 기기에서 열면 이름을 잃는다. 사용자가 적은 내용이 파일에 남지 않는다.

모델에 저장한다

  • 장점: 이름이 파일과 함께 다닌다.
  • 단점: 강조하지 않은 선택 범위에 이름을 붙이려면, 모델에 “이름 붙은 범위”라는 개념이 새로 생긴다.

결정

접는 범위의 이름은 모델에 저장한다.

  • 강조 영역의 이름은 강조 영역에 저장한다.
  • 강조하지 않은 선택 범위에 이름을 붙이면, 모델에 이름 붙은 범위가 생긴다. 범위 규칙은 선택 범위와 같다(같은 부모 아래 연속된 블록들). → ADR-0008
  • 이름을 붙이거나 바꾸면 파일이 바뀐다. 접고 펴는 것은 여전히 파일을 바꾸지 않는다.

결과

  • 좋아지는 점: 이름이 어디서 열어도 남는다.
  • 감수하는 점: 모델이 블록 트리 외에 “범위”를 다뤄야 한다. 범위 안의 블록을 지우거나 옮길 때 범위를 어떻게 갱신할지(불변식) 정해야 한다.
  • 후속 작업: 설계 문서 01-model에 이름 붙은 범위와 강조 영역의 표현, 편집할 때 범위를 고치는 규칙 추가. 파일 형식 01-file-format에 반영