ADR-0003: 구현 언어 TypeScript

이후 변경

  • 2026-10-25: IDE 플러그인이 대상이 되어(2026-10-14) IntelliJ 셸의 호스트 쪽은 TypeScript 밖일 수 있다(웹뷰 안의 편집기는 그대로 TypeScript) → 2.7 IDE 플러그인 (나중에), ADR-0036
  • 2026-10-22: 용어를 SW 엔지니어의 말로 고쳤다(뜻은 그대로). → 01-architecture

배경

ADR-0002에 따라 세 대상이 코어와 편집 UI를 공유한다. 세 대상 중 Obsidian 플러그인은 JavaScript로만 만들 수 있다.

결정 기준

  • Obsidian 플러그인에서 실행 가능해야 한다.
  • 웹(정적 사이트)과 데스크톱에서도 같은 코드가 돌아야 한다.
  • 트리 모델의 불변식을 타입 시스템으로 최대한 표현할 수 있어야 한다.

검토한 대안

JavaScript

  • 장점: 빌드 단계가 단순
  • 단점: 노드 타입이 많은 트리 모델에서 타입 오류를 잡기 어려움

TypeScript

  • 장점: Obsidian 플러그인 공식 개발 언어, 노드 타입을 판별 유니온(discriminated union)으로 표현 가능
  • 단점: 빌드 설정 필요

다른 언어 + WebAssembly (Rust 등)

  • 장점: 성능
  • 단점: 편집 UI는 결국 웹 기술이 필요해 두 언어를 관리해야 함, 이 규모에서는 성능 이점이 작음

결정

모든 패키지와 앱을 TypeScript로 작성한다.

결과

  • 좋아지는 점: 한 언어로 전체를 관리, 모델 타입을 컴파일 타임에 검사
  • 감수하는 점: 데스크톱도 웹 기술 기반 프레임워크로 제한됨 → ADR-0009