# samples — 문법 탐침

여기 있는 `.cool` 파일은 **명세가 아니라 탐침**이다. 목적은
`docs/thesis.md`의 v0 성공 기준 중 "체감" 항목 — 확정된 규칙으로 짠 코드가
사람이 읽을 만한지 — 을 눈으로 확인하는 것. 문법 정의는 `docs/grammar.ebnf`.

파서는 아직 없으므로 이 파일들은 컴파일되지 않는다.

| 파일 | 검증 대상 |
|---|---|
| 01_capability_signature | capability 파라미터, effects 절 어순, capability struct 관용구 |
| 02_higher_order_effects | effect 변수, 구문 수준 제한, 명시적 인스턴스화 |
| 03_scope_concurrency | TaskScope, 이름 있는 scope, 중첩 시 수명 표현 |
| 04_enum_match_interface | enum 정의 본문이 interface surface에 들어가는 경로 |
| 05_move_errors | **에러가 나야 하는** 코드 — 진단 하나씩 |
| 06_affine_closure | callable affinity (fn vs affine fn), own과의 직교성 |
| 07_module_interface | interface artifact가 담아야 할 것 전부 |
| 08_syntax_errors | **파서가** 거부해야 하는 코드 |

05와 08은 통과하면 안 되는 파일이다. 각 함수 주석의 `[E-...]` 태그가 기대
진단이다. 둘의 목적이 다르다 — **05는 구문은 맞지만 검사기가 거부해야 하고,
08은 파서가 거부해야 한다.** 그래서 파일을 나눴다: 한 파일에 섞으면 파서가
첫 오류에서 멈춰 검사기 케이스에 영영 도달하지 못한다.

오류 복구는 아직 없다. 파서는 첫 오류에서 멈춘다.

## 확정된 표기

- 어순: `fn 이름(파라미터) effects {...} -> 반환타입`.
  함수 타입도 동일: `fn(a) effects e -> b`
- 파라미터는 기본이 빌림(use, 무표기). 소유 이전만 `own` 유표기.
  capability든 클로저든 일반 affine 값이든 규칙은 하나다
- 파라미터 밖(반환 타입, struct 필드, channel 원소)은 항상 owned, 무표기
- 제네릭은 대괄호: 타입 `List[a]`, 식 `map[Int, String, {fs.read}](xs, f)`.
  인덱싱 연산자는 두지 않는다 (`List.at`)
- 수식어 순서: `own` / `mut`가 먼저, 타입 수식어 `affine`은 타입 안
- 모듈: 파일 = 모듈, `pub`이 exported, `import "domain/path" as Name`
- 재수출: `reexport Name` (전용 키워드 — hash 전파를 동반한다)
- effect 집합: `effects {Type.method, ...}`, 빈 집합은 생략
- effect 변수: `[e: effects]` 선언, 합집합 `e1 | e2`는 결과 위치 전용
- 문 구분은 줄바꿈 (Go식 자동 삽입)
- 블록은 식. 마지막 식이 값이고 `return`은 조기 탈출 전용
- `if`와 `match`는 식. `match` 가드 없음
- 리스트 리터럴 `[a, b, c]`, 빈 리터럴은 타입 주석 필요
- 오류 전파 `?`는 `Result` 전용