# merge_all_references()

씬의 모든 레퍼런스를 일반 오브젝트로 변환하고 Fast Ref 트래킹 데이터를 전부 제거합니다. **되돌릴 수 없는 일방향 작업입니다.**

내부 처리 순서:
- Phase 0 — 전체 Space Activate 강제 ON
- Phase 1 — 순서대로 Space Activate OFF (.rN suffix 일관성 보장)
- Phase 2 — 역순으로 Merge (Unpack → Merge → 데이터 제거)
- Phase 3 — Suffix 정리 (옵션 기반)

### 시그니처
```python
api.merge_all_references(
    remove_node_suffix: bool = True,
    remove_layer_suffix: bool = False,
    remove_selectionset_suffix: bool = True,
) -> dict
```

### 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
| --- | --- | --- | --- |
| `remove_node_suffix` | `bool` | `True` | Merge 후 노드 이름의 `.rN` suffix 제거 |
| `remove_layer_suffix` | `bool` | `False` | 레이어 이름의 `.rN` suffix 제거 |
| `remove_selectionset_suffix` | `bool` | `True` | SelectionSet 이름의 `.rN` suffix 제거 |

### 반환값
```python
{
    "success": bool,
    "message": str,
    "merged_count": int,
    "failed_count": int,
}
```

### 예제
```python
from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
result = api.merge_all_references(
    remove_node_suffix=True,
    remove_layer_suffix=True,
    remove_selectionset_suffix=True,
)
print(result['message'])
# e.g. "Merge complete: 3 succeeded, 0 failed"
```
> **주의:** `remove_layer_suffix=True`는 동일한 기본 이름의 레이어들을 병합합니다. 의도적으로 같은 이름의 레이어를 사용하는 경우 주의가 필요합니다.

---