docs: 패키지 README 추가 + CHANGELOG 병합 + oxfmt 범위 수정 (#148)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: zeakd

.husky/pre-commit

@@ -1,3 +1,3 @@
 pnpm exec oxlint --ignore-path .gitignore --ignore-pattern 'website/public/0.1.0/**' --ignore-pattern 'website/public/0.0.13/**'
-pnpm exec oxfmt --check --ignore-path .gitignore packages/ website/src/
+pnpm exec oxfmt --check --ignore-path .gitignore packages/react-naver-maps/src/ packages/astro-component-docs/src/ website/src/
 pnpm exec tsc -b

packages/react-naver-maps/CHANGELOG.md

@@ -13,3 +13,40 @@
   - useKVO, useControlledKVO: KVO 속성 감시 및 동기화
   - Suspense 지원: React 19 use()와 스크립트 로딩 통합
   - 성능 개선: KVO 구독 제거, 렌더 시점 dirty diff
+
+## 0.1.5
+
+### Patch Changes
+
+- 228aa73: Fix promise caching and error handling in loadNavermapsScript, replace deprecated lodash packages with lodash-es
+
+## 0.1.4
+
+### Patch Changes
+
+- b8ae0a7: 신규 client key 이름 ncpKeyId를 사용가능하도록 업데이트
+
+## 0.1.3
+
+### Patch Changes
+
+- 00ff206: update naver host openapi -> oapi
+
+## 0.1.2
+
+### Patch Changes
+
+- update package.json
+
+## 0.1.1
+
+### Patch Changes
+
+- deprecated alert을 위한 RenderAfterNavermapsLoaded 추가
+
+## 0.1.0
+
+### Major Changes
+
+- 50c7d39: release v0.1.0
+- 894ccb1: change react support version, use jsx-runtime

packages/react-naver-maps/README.md

@@ -0,0 +1,60 @@
+# react-naver-maps
+
+[Naver Maps JavaScript API v3](https://navermaps.github.io/maps.js.ncp/)의 Non-Official React 컴포넌트 라이브러리입니다.
+
+네이버맵의 기본 기능을 최대한 유지하면서, React에서 다루기 쉬운 인터페이스를 제공합니다.
+
+- React 19 전용, 런타임 의존성 없음 (peerDeps: react, react-dom)
+- TypeScript 지원 (`@types/navermaps` 기반)
+- Suspense 기반 스크립트 로딩
+
+## 설치
+
+```bash
+npm install react-naver-maps
+```
+
+React 19 이상이 필요합니다.
+
+## 사용법
+
+```tsx
+import {
+  NavermapsProvider,
+  Container,
+  NaverMap,
+  Marker,
+} from 'react-naver-maps';
+
+function App() {
+  return (
+    <NavermapsProvider ncpKeyId="YOUR_NCP_KEY_ID">
+      <Container style={{ width: '100%', height: '400px' }}>
+        <NaverMap
+          defaultCenter={{ lat: 37.5666, lng: 126.9784 }}
+          defaultZoom={16}
+        >
+          <Marker defaultPosition={{ lat: 37.5666, lng: 126.9784 }} />
+        </NaverMap>
+      </Container>
+    </NavermapsProvider>
+  );
+}
+```
+
+## 0.2의 새 기능
+
+- **오버레이 컴포넌트 11종**: NaverMap, Marker, InfoWindow, GroundOverlay, CustomOverlay, Circle, Rectangle, Ellipse, Polygon, Polyline, Container
+- **Layer 컴포넌트 3종**: CadastralLayer, StreetLayer, TrafficLayer
+- **useOverlay**: 바닐라 OverlayView 상속 객체를 React 생명주기에 연결. 네이버맵 공식 [CustomOverlay 패턴](https://navermaps.github.io/maps.js.ncp/docs/tutorial-6-CustomOverlay.html)을 그대로 사용 가능
+- **useListener**: 네이버맵 네이티브 이벤트 escape hatch. 인라인 함수를 전달해도 리스너 재구독 없음
+- **Suspense 지원**: 스크립트 로딩을 React 19 `use()`와 통합
+- **성능 개선**: KVO 구독 제거, 렌더 시점 dirty diff로 드래그 중 불필요한 리렌더 방지
+
+## 문서
+
+[zeakd.github.io/react-naver-maps](https://zeakd.github.io/react-naver-maps)
+
+## 라이선스
+
+MIT