v1.1.1

🎯 Highlights

• 회전 정책 격리 — 별도 UIWindow 를 만들지 않고 호스트 앱 keyWindow 에 라벨 view 만 직접 주입합니다. iOS multi-window 회전 결정에 라이브러리가 일절 관여하지 않아, portrait 잠금 화면이 풀리거나 수동 전체화면이 안 먹는 회귀를 근본 차단합니다.
• install API + enabled 파라미터 — 1회 셋업 모델 명확화. 디버그 오버레이 on/off 를 사용자 설정 토글에 연결하면 재시작 시 새 값이 적용됩니다.
• 셀 임베드 SwiftUI host 가 라벨을 가로채는 회귀 픽스 — 셀이 UIHostingController 를 contentView 에만 add 한 경우 라벨이 SwiftUI rootView 이름으로 바뀌어버리던 문제를 차단합니다.

⚠️ Breaking changes

• ScreenNameViewer.start(_:) → ScreenNameViewer.install(enabled:_:) 로 이름 변경
• ScreenNameViewer.stop() public API 제거 — 1회 설치 모델이라 런타임 종료 API 불필요

마이그레이션

// Before
ScreenNameViewer.start { config in
    config.verticalPosition = .top
}

// After
ScreenNameViewer.install { config in
    config.verticalPosition = .top
}

// 사용자 설정 토글과 연결
ScreenNameViewer.install(
    enabled: UserDefaults.standard.bool(forKey: "debug_overlay_enabled")
) { config in
    // ...
}

enabled: false 면 swizzling 자체가 일어나지 않습니다. 토글 변경 후 앱 재시작 시 새 값이 적용됩니다(재시작은 적용 앱이 처리).

🐛 Bug fixes

• 셀 contentView 에만 add 된 UIHostingController 가 화면 단위 VC 로 잘못 판정되어 라벨이 SwiftUI rootView 이름으로 바뀌는 회귀 차단 (isScreenLevel 가드 강화)
• 호스트 앱이 portrait 로 잠근 화면에서 라이브러리 적용 시 디바이스가 회전해버리는 회귀 차단
• 호스트 앱 플레이어의 수동 전체화면 전환 / 전체화면에서 뒤로가기 시 portrait 복귀가 막히는 회귀 차단

🛠 Internal / Refactor

• OverlayWindow + OverlayViewController 제거 → OverlayView (UIView) 한 클래스로 통합
• SceneOverlay 가 host keyWindow 를 추적하고 keyWindow 교체 시 자동 이동 (UIWindow.didBecomeKeyNotification)
• 모달/시트 z-order 는 매 render 사이클마다 bringSubviewToFront 로 유지
• 라벨 영역 외 모든 터치는 point(inside:with:) → false 로 통과 — 호스트 제스처 영향 0

✅ Tests

68 tests passing. 신규 회귀 테스트 2건 추가:

• testParentlessAppleHostIsNotScreenLevel — 셀 임베드 host 가 push 되지 않음을 회귀 방지
• testTouchPassthrough — 라벨 view 가 호스트 터치를 가로채지 않음을 회귀 방지

📋 RELEASE 빌드 격리

• 모든 라이브러리 코드(swizzling, UIView 생성, NotificationCenter 구독, Tracker 인스턴스화)는 #if DEBUG 보호
• public API 본문 모두 #if DEBUG 안 → RELEASE 빌드에선 빈 함수로 컴파일되어 런타임 비용 0