설정 파일 3형제 — JSON · YAML · TOML

# 같은 데이터 3가지 포맷

━━━ JSON ━━━
{
  "name": "jit",
  "version": "1.0",
  "deps": ["react", "next"],
  "server": { "port": 3000, "host": "localhost" }
}

━━━ YAML ━━━
name: jit
version: "1.0"         # 인용 없으면 1 (숫자)로 해석됨!
deps:
  - react
  - next
server:
  port: 3000
  host: localhost

━━━ TOML ━━━
name = "jit"
version = "1.0"
deps = ["react", "next"]

[server]
port = 3000
host = "localhost"

# JSON 함정 체크리스트
❌ { "a": 1, }               // trailing comma 금지
❌ { 'a': 1 }                // 홑따옴표 금지
❌ // 주석                   // 주석 금지
✅ { "a": 1 }

# YAML 함정 (실전 사고 많음)
❌ tab 들여쓰기 → 에러      // 반드시 스페이스
❌ version: 1.0               // 1.0 → 1 (float 해석)
✅ version: "1.0"
❌ no: 1                      // "no" 키 → false로 해석될 위험
✅ "no": 1

# TOML 함정
❌ duplicate keys 금지
❌ 문자열은 " " (홑따옴표도 되지만 escape 다름)
✅ 엄격한 문법이 장점 (모호한 파싱 거의 없음)

// 파싱·직렬화 비교

// JSON (내장)
JSON.parse('{"a":1}');         // { a: 1 }
JSON.stringify(obj, null, 2);  // 2칸 들여쓰기

// YAML — js-yaml 라이브러리
import yaml from "js-yaml";
const data = yaml.load(yamlString);
yaml.dump(obj);

// TOML — @iarna/toml 또는 smol-toml
import TOML from "smol-toml";
TOML.parse(tomlString);