feat: Add API Extractor and comprehensive documentation system (v0.5.0)

[crowrish]

🎯 개요

Microsoft API Extractor를 도입하여 전문적인 API 문서화 시스템을 구축하고 개발 워크플로우를 대폭 개선했습니다.

✨ 새로운 기능

📖 API 문서화 시스템

• Microsoft API Extractor 통합
• 자동 생성 API 문서 (docs/ 폴더, 1000+ 파일)
• GitHub Pages 지원 - 온라인 문서 호스팅
• 통합 타입 선언 파일 (dist/neople-openapi-types.d.ts)

🔧 개발 도구 개선

• API 호환성 추적 (api-reports/)
• TSDoc 설정 최적화 (커스텀 @endpoint 태그 지원)
• 향상된 빌드 파이프라인
• 새로운 npm 스크립트: build:full, docs:generate

📋 변경사항

📦 새 파일들

• api-extractor.json - API Extractor 설정
• tsdoc.json - TSDoc 설정 (커스텀 태그 정의)
• docs/ - 자동 생성 API 문서 (GitHub Pages용)
• api-reports/ - API 변경사항 추적 파일
• GITHUB_PAGES_SETUP.md - GitHub Pages 설정 가이드
• example-usage.md - API Extractor 활용 예시

🔄 업데이트된 파일들

• package.json - 버전 0.5.0, 새로운 스크립트, API Extractor 의존성
• README.md - GitHub Pages 링크, 버전 히스토리, 새로운 빌드 명령어
• .gitignore - API Extractor 출력 파일 관리

🌐 GitHub Pages 문서

설정 완료 후 다음 URL에서 API 문서에 접근할 수 있습니다:

https://crowrish.github.io/neople-openapi-types/

설정 방법:

1. GitHub 저장소 → Settings → Pages
2. Source: "Deploy from a branch"
3. Branch: main, Folder: /docs

🔧 새로운 개발 워크플로우

빌드 명령어

npm run build:full    # 전체 빌드 + API 추출
npm run docs:generate # API 문서 생성
npm run api-extract   # API Extractor만 실행

자동화된 검증

• 배포 전 API 호환성 검증 (prepublishOnly)
• Breaking change 자동 감지
• 통합 타입 파일 생성

🎁 개발자 경험 개선

✅ npm 사용자 (변화 없음)

• 패키지 크기 동일 (약 31.5 kB)
• 동일한 사용법
• dist/ 폴더만 포함 (문서 파일 제외)

✅ 프로젝트 기여자 (대폭 개선)

• 📊 API 변경사항 자동 추적
• 📖 전문적인 온라인 문서
• 🔍 통합 타입 선언 파일
• 🛡️ API 호환성 보장

🧪 테스트 완료

• ✅ 모든 기존 기능 정상 작동
• ✅ 새로운 빌드 파이프라인 검증
• ✅ API Extractor 경고 없음
• ✅ 문서 생성 성공

🎯 다음 단계

1. PR 병합 후 GitHub Pages 설정
2. 온라인 문서 확인 (https://crowrish.github.io/neople-openapi-types/)
3. v0.5.0 npm 배포

---

🤖 Generated with Claude Code