docs: presets.onSnapshot 및 customTabs.restore API 문서 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: lee-sihun

.claude/CLAUDE.md

@@ -0,0 +1,41 @@
+# 로컬 워크플로 규칙
+
+## 기본 워크플로
+
+모든 구현 작업은 다음 워크플로를 따릅니다.
+
+### 1. 계획 수립 (필수)
+사용자의 구현 요청이나 설계 논의가 있으면 `/plan` 스킬을 사용하여 Codex와 함께 계획을 수립합니다.
+- 단순 버그 수정이나 1~2줄 변경이 아닌 이상 항상 plan을 먼저 실행
+- Claude 선분석 → Codex 검증 → 최종 계획 확정
+
+### 2. 단계별 구현 + 코드 리뷰
+확정된 계획을 단계별로 나누어 구현하고, 각 단계마다 `/codex-review`로 코드 리뷰를 수행합니다.
+- 한 번에 모든 변경을 하지 않고, 논리적 단위로 분리
+- 각 단계 완료 후 Codex 리뷰 → 이슈 있으면 수정 → 리뷰 통과 확인
+
+### 3. 자동 커밋
+각 단계의 리뷰가 통과되면 해당 변경사항을 즉시 커밋합니다.
+- 커밋 메시지는 변경 내용에 맞게 작성
+- 단계별로 커밋하여 git 히스토리를 깔끔하게 유지
+
+### 워크플로 예시
+```
+사용자: "키보드 입력 시스템에 딜레이 옵션 추가해줘"
+
+1. /plan 실행 → Codex와 구현 계획 수립
+2. 단계 1: Rust 백엔드 커맨드 추가 → /codex-review → 커밋
+3. 단계 2: 프론트엔드 설정 UI 추가 → /codex-review → 커밋
+4. 단계 3: 오버레이 반영 로직 수정 → /codex-review → 커밋
+```
+
+### 4. 최종 보고
+모든 단계가 완료되면 작업 결과를 정리하여 보고합니다.
+- 변경된 파일 목록과 각 변경 요지
+- 커밋 히스토리 요약
+- Codex 리뷰에서 나온 주요 피드백과 반영 여부
+- 남은 리스크나 후속 작업이 있으면 명시
+
+## 예외
+- 1~2줄 수정, 오타 수정, 포맷팅 등 사소한 변경은 plan/review 없이 직접 처리
+- 긴급 핫픽스는 plan 없이 구현 후 review만 수행

AGENTS.md

@@ -124,6 +124,11 @@ src-tauri/src/
 - `useMemo` / `useCallback` 의존성 배열에서 배열/객체는 개별 요소 비교 고려
 - 린트 자동 수정이 의도적 패턴을 덮어쓸 수 있으므로 필요시 `eslint-disable` 주석 사용
 
+## API 문서 동기화
+
+- 프론트엔드 플러그인 API(`dmn.*`) 또는 Tauri 커맨드에 변경이 있으면 `docs/content/` 하위 관련 MDX 문서를 업데이트
+- 문서는 `en/`, `ko/` 두 언어로 관리되므로 양쪽 모두 반영
+
 ## 작업 마무리 체크리스트
 
 ### 프론트엔드 (TypeScript/React) 변경 시

CLAUDE.md

@@ -124,6 +124,11 @@ src-tauri/src/
 - `useMemo` / `useCallback` 의존성 배열에서 배열/객체는 개별 요소 비교 고려
 - 린트 자동 수정이 의도적 패턴을 덮어쓸 수 있으므로 필요시 `eslint-disable` 주석 사용
 
+## API 문서 동기화
+
+- 프론트엔드 플러그인 API(`dmn.*`) 또는 Tauri 커맨드에 변경이 있으면 `docs/content/` 하위 관련 MDX 문서를 업데이트
+- 문서는 `en/`, `ko/` 두 언어로 관리되므로 양쪽 모두 반영
+
 ## 작업 마무리 체크리스트
 
 ### 프론트엔드 (TypeScript/React) 변경 시

docs/content/en/api-reference/keys/page.mdx

@@ -145,6 +145,17 @@ const unsub = dmn.keys.registerCustomTab({
 });
 ```
 
+### `dmn.keys.customTabs.restore(customTabs, selectedKeyType): Promise<void>`
+
+Restores custom tabs and selected mode atomically. Syncs backend state, overlay, and main window.
+
+```javascript
+await dmn.keys.customTabs.restore(
+  [{ id: "custom-123", name: "My Keys", keys: ["KeyA", "KeyS"] }],
+  "custom-123",
+);
+```
+
 ---
 
 ## Stats API

docs/content/en/api-reference/presets/page.mdx

@@ -76,6 +76,36 @@ const unsub = dmn.presets.onChanged((presets) => {
 
 ---
 
+## Snapshot Event
+
+### `dmn.presets.onSnapshot(callback): Unsubscribe`
+
+Subscribes to preset load completions. Receives the full snapshot of applied data (key mappings, positions, tabs, mode, etc.) in a single event.
+
+```typescript
+interface PresetSnapshot {
+  keys: KeyMappings;
+  positions: KeyPositions;
+  statPositions: StatItemPositions;
+  graphPositions: GraphItemPositions;
+  customTabs: CustomTab[];
+  selectedKeyType: string;
+  tabNoteOverrides: TabNoteOverrides;
+}
+
+const unsub = dmn.presets.onSnapshot((snapshot) => {
+  console.log("Preset loaded:", snapshot.selectedKeyType);
+  console.log("Key mappings:", snapshot.keys);
+});
+```
+
+<Callout type="info">
+  Individual change events (`onChanged`, `onPositionsChanged`, etc.) are not emitted during preset load.
+  Use `onSnapshot` to detect preset loads.
+</Callout>
+
+---
+
 ## Example Usage
 
 ```javascript

docs/content/ko/api-reference/keys/page.mdx

@@ -272,6 +272,17 @@ const result = await dmn.keys.customTabs.delete("custom-123");
 await dmn.keys.customTabs.select("custom-123");
 ```
 
+### restore(customTabs, selectedKeyType)
+
+커스텀 탭 목록과 선택된 모드를 일괄 복원합니다. 백엔드 상태, 오버레이, 메인 윈도우가 모두 동기화됩니다.
+
+```javascript
+await dmn.keys.customTabs.restore(
+  [{ id: "custom-123", name: "My Keys", keys: ["KeyA", "KeyS"] }],
+  "custom-123",
+);
+```
+
 ### onChanged(listener)
 
 커스텀 탭 변경 이벤트를 구독합니다.

docs/content/ko/api-reference/presets/page.mdx

@@ -80,6 +80,36 @@ dmn.plugin.registerCleanup(() => {
 });
 ```
 
+## 이벤트 구독
+
+### onSnapshot(listener)
+
+프리셋 로드 완료 시 적용된 스냅샷 데이터를 수신합니다. 키 매핑, 위치, 탭, 모드 등이 한 번에 전달됩니다.
+
+```typescript
+interface PresetSnapshot {
+  keys: KeyMappings;
+  positions: KeyPositions;
+  statPositions: StatItemPositions;
+  graphPositions: GraphItemPositions;
+  customTabs: CustomTab[];
+  selectedKeyType: string;
+  tabNoteOverrides: TabNoteOverrides;
+}
+```
+
+```javascript
+const unsub = dmn.presets.onSnapshot((snapshot) => {
+  console.log("프리셋 로드됨:", snapshot.selectedKeyType);
+  console.log("키 매핑:", snapshot.keys);
+});
+```
+
+<Callout type="info">
+  프리셋 로드 시 개별 이벤트(`onChanged`, `onPositionsChanged` 등)는 발행되지 않습니다.
+  프리셋 로드를 감지하려면 `onSnapshot`을 사용하세요.
+</Callout>
+
 ## 프리셋에 포함되는 항목
 
 프리셋은 “전체 설정 덤프”가 아니라, 아래 항목들을 파일로 저장/복원합니다.