ADR-0042: 블록 텍스트의 언어는 글꼴을 바꾸지 않는다. 언어마다의 렉서는 core에 둔다

누가 무엇을 정했나

메인테이너가 2026-11-03에 “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.”라고 했다. 이 ADR은 Claude의 추천안대로 구현한 것이고, 메인테이너가 2026-11-10에 승인했다.

배경

블록 텍스트의 언어(R-LAY-06)와 구문 강조(R-LAY-07)를 넣는다. 강조의 방법(언어마다 렉서 하나, 파싱하지 않음)은 ADR-0032가 정했다. 남은 것은 둘이다.

  1. 글꼴. 시각 디자인 명세는 “코드 언어면 고정폭, 일반 텍스트면 비례폭”이라고 적어 두었다(4.3 글꼴의 지난 판). 그런데 ADR-0034는 “그 값이 없는 파일(MVP로 저장한 파일 전부)은 D2Coding으로 그린다”고 약속했다. MVP로 저장한 파일에는 "textKind": "plain"(일반 텍스트)이 적혀 있다. 일반 텍스트를 비례폭으로 그리면 이 파일들의 블록 폭이 모두 바뀐다. 번들한 비례폭 글꼴도 아직 없다.
  2. 렉서의 자리와 모양. 저장되는 SVG에도 같은 색이 들어가므로(ADR-0018) 렌더러가 쓸 수 있는 곳이어야 한다.

결정 기준

  • 이미 저장한 그림이 열 때 달라지지 않는다(ADR-0034의 약속, R-FMT-03)
  • 언어를 바꾸는 일이 레이아웃을 바꾸지 않는다. 테마처럼 색만 바뀌면 사용자가 예측하기 쉽다
  • 웹의 첫 내려받기(번들 사이즈 체크)를 크게 늘리지 않는다
  • 렉서는 불완전한 조각에서도 틀리지 않고, 언어를 더하기 쉽다

검토한 대안

대안 A: 일반 텍스트는 비례폭 글꼴로 그린다 (명세의 지난 판)

  • 장점: 문장으로 적은 블록이 덜 딱딱하고 좁다
  • 단점: MVP로 저장한 파일이 모두 다시 배치된다(ADR-0034와 어긋남). 한글을 갖춘 비례폭 글꼴(예: Pretendard 624 KB)을 골라 폭 테이블 · 화면 조각 · 저장 서브셋을 둘째 글꼴로 모두 다시 만들어야 하고, 저장 파일에 글꼴이 둘 들어갈 수 있다. 글꼴 고르기는 시안으로 견주어야 할 결정이다(ADR-0034는 시안 M29로 정했다)

대안 B: 비례폭은 새 값(예: "prose")으로 따로 둔다

  • 장점: "plain" 파일은 그대로다
  • 단점: “일반 텍스트”가 둘이 되어 사용자에게 설명하기 어렵다. 비례폭 글꼴이 없다는 점은 A와 같다

대안 C: 모든 언어를 기본 블록 글꼴(D2Coding)로 그린다

  • 장점: 어느 파일도 다시 배치되지 않는다. 언어를 바꾸면 색만 바뀐다. 더 실을 글꼴이 없다
  • 단점: 문장으로 적는 문서도 고정폭이다(MVP와 같음)

결정

대안 C. 블록 텍스트의 언어는 구문 강조만 정하고, 글꼴은 언어와 상관없이 기본 블록 글꼴이다. 비례폭 글꼴은 글꼴을 고르는 일과 함께 따로 정한다(12. 미결정 사항). 그때도 언어가 아니라 다른 문서 설정으로 고르게 해야, 이미 저장한 파일이 바뀌지 않는다.

렉서는 ADR-0032대로 언어마다 하나이고, core의 src/packages/core/src/text/syntax.ts에 둔다.

  • 언어 하나는 키워드 집합과 몇 가지 표시(줄 주석의 표시, 블록 주석의 시작 · 끝, 따옴표, 여러 줄 문자열, $가 이름의 일부인지, 지시문, Bash의 “낱말 처음의 #만 주석”)로 적는다. 렉서는 이 표 하나를 읽는 스캐너 하나다. 외부 라이브러리는 쓰지 않는다(웹 첫 내려받기에 gzip 3 KB 안쪽이 더해짐. 2026-11-03 빌드의 첫 내려받기는 183 KB, 한도 212 KB)
  • 토큰은 키워드 · 문자열 · 숫자 · 주석 · 그 밖이다. 토큰을 이으면 원래 텍스트가 된다(속성 기반 테스트)
  • buildScene()이 settings.textKind를 받아, 줄마다 토큰을 TextRun(색이 있는 <tspan fill>)으로 바꾼다. 색은 테마 토큰 syntax.keyword · syntax.comment · syntax.literal이다. 테마가 이 토큰을 바꾸면 강조의 색도 바뀐다
  • 레이아웃은 언어를 읽지 않는다. 같은 글꼴 · 같은 굵기라 폭이 같다(테스트가 모든 언어에서 레이아웃이 같음을 확인)

결과

  • 좋아지는 점: MVP 파일은 그대로 열린다. 언어를 바꾸면 그림의 색만 바뀌고 블록은 움직이지 않는다. 글꼴 파이프라인과 번들 크기는 그대로다
  • 감수하는 점: 일반 텍스트도 고정폭이라, 문장으로 적은 블록은 비례폭보다 넓다(ADR-0034가 감수한 점 그대로)
  • 후속 작업: 비례폭 글꼴과 그것을 고르는 자리 → 12. 미결정 사항