ambient 선언 경계

전역 스크립트 스코프 구분

HTML 스크립트가 만든 값은 모듈 import가 아니라 전역 계약으로 선언해야 안전합니다.

값 하나

declare var

외부 스크립트가 만든 전역 상수나 설정 객체를 타입으로 고정합니다.

브라우저 객체

interface Window

분석 도구, SDK처럼 window에 붙는 속성을 프로젝트 전체에서 공유합니다.

묶음 API

declare namespace

여러 함수와 클래스를 하나의 전역 이름 아래 구조화합니다.

스크립트 로드 -> 전역 이름 확인 -> 선언 파일 배치 -> 타입 검사

핵심은 런타임에 실제로 존재하는 전역 이름만 선언하고, 모듈 import로 해결할 수 있는 코드는 declare module로 분리하는 것입니다.