# HML 1.1.0 네이티브 실행기

HML 소스 파일을 C++17 실행기가 직접 해석합니다. 배포 ZIP에는 실행기와 VS Code 확장, 표준 라이브러리 안내, 예제가 들어 있습니다.

## 실행하기

macOS 또는 Linux에서 압축을 푼 폴더의 터미널을 열고 실행합니다.

```sh
./hml --version
./hml examples/helloworld.hml
```

Windows PowerShell에서는 `.\hml.exe examples\helloworld.hml`을 실행합니다. macOS ZIP은 macOS 14 이상에서 사용하는 Universal 빌드입니다. Apple의 Developer ID 서명과 공증을 받지 않은 배포본이라 다운로드한 실행기에 시스템 경고가 표시될 수 있습니다.

VS Code에는 압축에 포함된 운영체제와 CPU에 맞는 `.vsix`를 **Extensions: Install from VSIX…**로 설치하세요. `.hml` 편집기 오른쪽 위 **▶ HML: Run File**을 누르면 확장에 포함된 네이티브 실행기가 시작됩니다. Mac의 경우 Apple Silicon용 VS Code는 `darwin-arm64`, Intel용 VS Code는 `darwin-x64` 파일을 선택합니다.

## 언어 및 표준 라이브러리

변수·함수·클래스, 조건·반복, 리스트·맵, 로컬 모듈, 예외 복구와 오류 코드를 지원합니다. 표준 모듈 10개가 포함되며, `std:stats`는 HML 소스로 실행기에 내장됩니다. 구현에는 JSON 처리용 nlohmann/json 헤더와 Unicode 데이터가 포함됩니다. 정수는 부호 있는 64비트로 제한됩니다. 더 큰 정수가 필요한 기존 프로그램에는 1.0.1 실행기가 제공됩니다.

## 소스에서 빌드하기

C++17 컴파일러와 CMake 3.16 이상이 필요합니다. 프로젝트 루트에서 실행합니다.

```sh
cmake -S native -B build/native -DCMAKE_BUILD_TYPE=Release
cmake --build build/native --config Release
```

개발 환경에서는 `HML_TEST_RUNNER`에 네이티브 실행 파일 경로를 설정해 같은 테스트를 실행할 수 있습니다.
