From f6f18b4789da93a9479595a64b376c4e5258795e Mon Sep 17 00:00:00 2001
From: hyper <hx.hyper@qq.com>
Date: Sun, 12 Apr 2026 18:02:10 +0800
Subject: [PATCH] fix: wait for fade scene init

---
 packages/framework/src/scenes/FadeScene.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/scenes/FadeScene.ts b/packages/framework/src/scenes/FadeScene.ts
index 4f567b3..e886699 100644
--- a/packages/framework/src/scenes/FadeScene.ts
+++ b/packages/framework/src/scenes/FadeScene.ts
@@ -57,6 +57,12 @@ export class FadeScene extends ReactiveScene<FadeSceneData> {
      * 淡入淡出到指定透明度
      */
     private fadeTo(targetAlpha: number, duration: number): Promise<void> {
+        // 如果 overlay 还未初始化，直接返回 resolved promise
+        if (!this.overlay) {
+            console.warn('FadeScene: overlay 未初始化，跳过过渡动画');
+            return Promise.resolve();
+        }
+
         if (this.isFading) {
             console.warn('FadeScene: 正在进行过渡动画');
         }