# CoffeeScript Compiler

## 개요
CoffeeScript Compiler는 CoffeeScript로 작성된 소스 코드를 브라우저나 Node.js 환경에서 실행 가능한 JavaScript 코드로 변환하는 트랜스파일러(Transpiler)입니다. CoffeeScript는 JavaScript의 복잡한 문법을 간결하게 줄여 생산성을 높이는 것을 목적으로 하며, 컴파일러는 이러한 고수준의 문법을 표준 JavaScript 문법으로 매핑하여 출력합니다.

## 설치 및 설정
CoffeeScript Compiler는 Node.js 환경에서 npm(Node Package Manager)을 통해 설치할 수 있습니다. 전역 설치를 통해 터미널 어디서든 `coffee` 명령어를 사용할 수 있습니다.

```bash
npm install -g coffeescript
```

## 주요 기능

### 컴파일 옵션
CLI(Command Line Interface)를 통해 다양한 컴파일 옵션을 제공합니다. 주요 옵션은 다음과 같습니다.

| 옵션 | 설명 | 비고 |
| :--- | :--- | :--- |
| `-c` 또는 `--compile` | `.coffee` 파일을 `.js` 파일로 컴파일하여 저장합니다. | 파일 출력 모드 |
| `-w` 또는 `--watch` | 파일 변경을 감지하여 자동으로 다시 컴파일합니다. | 개발 환경 유용 |
| `-p` 또는 `--print` | 컴파일된 결과를 파일로 저장하지 않고 표준 출력(stdout)으로 출력합니다. | 빠른 테스트용 |
| `-v` 또는 `--version` | 설치된 CoffeeScript의 버전을 표시합니다. | 버전 확인 |

### Watch 모드
개발 과정에서 소스 코드를 수정할 때마다 수동으로 컴파일하는 번거로움을 줄이기 위해 Watch 모드를 제공합니다. `-w` 옵션을 사용하면 컴파일러가 대상 디렉터리의 파일 변경 사항을 실시간으로 감시하며, 저장이 일어날 때마다 즉시 JavaScript로 변환합니다.

```bash
coffee -cw .
```

## 작동 원리
CoffeeScript Compiler는 다음과 같은 단계로 작동합니다.

1. **소스 코드 분석 (Parsing)**: 작성된 CoffeeScript 코드를 읽어 들여 문법적 구조를 분석합니다.
2. **AST 생성 (Abstract Syntax Tree)**: 분석된 코드를 바탕으로 추상 구문 트리(AST)를 생성하여 코드의 논리적 구조를 계층적으로 표현합니다.
3. **JS 생성 (Code Generation)**: 생성된 AST를 순회하며 이에 대응하는 JavaScript 문법으로 변환하여 최종 소스 코드를 출력합니다.

## 예제

### CoffeeScript 코드 (`example.coffee`)
```coffeescript
# 간결한 함수 정의와 문자열 보간
square = (x) -> x * x

numbers = [1, 2, 3, 4, 5]
squaredNumbers = numbers.map square

console.log "결과: #{squaredNumbers}"
```

### 변환된 JavaScript 코드 (`example.js`)
```javascript
"use strict";

var square, numbers, squaredNumbers;

square = function(x) {
  return x * x;
};

numbers = [1, 2, 3, 4, 5];
squaredNumbers = numbers.map(square);

console.log("결과: " + squaredNumbers);
```