# v0.1.249 — QA-009 hud-root Space 가드 확장

- 버전: v0.1.249
- 분류: 48th stable seal (v0.1.366) 일괄 봉인 사이클
- 다운로드: [factory00-windows-x64-v0.1.249.zip](../../downloads/archive/factory00-windows-x64-v0.1.249.zip) (archive 보존)
- 캡처: [qa-screenshots/v0.1.249/](../../qa-screenshots/v0.1.249/)

---

## 협업자 PM 회신
QA-009 [P0] — 좌측 패널 내부창 전체 공백 (간헐). v0.1.240 재발 확인 (2026-05-20).
PM 보고: Space 키 트리거 + F11 복구. 가설: UI Button focus 보유 시 Space=click 발화.

## v0.1.244 fix 한계 진단
v0.1.244에서 ribbon 한정 KeyDown Space 가드 + Click 후 Blur. PM은 v0.1.240 기준 검증 -> v0.1.244 fix 후 재검증 없음.
추가 잔존 가능성:
- 좌측 패널 안 햄버거 ≡ 외 버튼 (검색 X clear / 부품 트리 row Activate 등)이 Ribbon 외부 -> v0.1.244 가드 미적용- 부품 트리 ListView focus + Space -> row activate -> 패널 hiding 가능성
## v0.1.249 fix — hud-root 전체 확장
`csharpvar hudRootKey = root.Q("hud-root") ?? root;hudRootKey.RegisterCallback(evt => {    if (evt.keyCode == KeyCode.Space && evt.target is Button) {
        evt.StopPropagation();
        evt.PreventDefault();
    }
}, TrickleDown.TrickleDown);
foreach (var btn in hudRootKey.Query().ToList())    btn.clicked += () => btn.Blur();
`- TrickleDown으로 Button focus 보유 시 Space click 발화 차단- evt.target Button 한정 — ContextMenu Enter activate 등 다른 키 영향 없음- 모든 Button click 후 Blur — focus 누적 차단- Space=카메라 상승키는 Input.GetKey 폴링 (별도 path) — 영향 0
## 영향 범위
- Ribbon Button (이미 v0.1.244 처리) — 동등 효과로 통합- 좌측 패널 ≡ 햄버거·검색 X·동작 버튼·Inspector edit 버튼 등 모든 Button cascade- ListView row Activate (Space) 영향 없음 (target이 ListView, Button 아님)- ContextMenu Enter activate 영향 없음 (KeyCode.Enter는 가드 외)
## 변경 파일
- Assets/Scripts/Game/Factory00Bootstrap.cs (~12라인 -> 확장된 ~20라인) — ribbon -> hud-root 확장- ProjectSettings/ProjectSettings.asset (0.1.248 -> 0.1.249)
## 검증 시나리오
1. 좌측 패널 ≡ click -> 패널 펼침 -> Space -> 패널 그대로 (이전: 접힘 회귀 가능)
2. 부품 트리 row click -> Space (카메라 상승) -> 패널 변화 0 + 카메라 상승 정상
3. Inspector 버튼 click -> Space -> 버튼 재발화 0

## 다음 사이클
- v0.1.250 — 38th stable seal 봉인 검토 (v0.1.241~249 9 사이클)- v0.1.251 — QA-014 Persp/Ortho 회귀 (PM 회신 받으면)- v0.1.252 — QA-040 Signal Simulator UX 개편 (스펙 확정)협업자 git origin/main = local. QA-014 PM 회신 계속 대기.


---

## 봉인 참조

본 사이클은 **48th stable seal (v0.1.366, 2026-05-24)** 일괄 봉인에 포함됨.

- journal: [2026-05-24-v0.1.298-366-48th-stable-seal.md](../../journal/2026-05-24-v0.1.298-366-48th-stable-seal.md)
- alias zip: [factory00-windows-x64-v0.1.366-stable.zip](../../downloads/factory00-windows-x64-v0.1.366-stable.zip) (170 MB)