From a5d8214650d0d1fe54b59d92052c80e3625a7325 Mon Sep 17 00:00:00 2001
From: chenhang <averych@126.com>
Date: Tue, 9 Jun 2026 18:47:04 +0800
Subject: [PATCH] refactor: migrate state imports from contexts to stores
 directory

---
 src/app/auth/components/auth-email-panel.tsx  |  2 +-
 .../auth/components/auth-facebook-panel.tsx   |  2 +-
 src/app/auth/components/auth-panel.tsx        |  2 +-
 src/app/auth/components/auth-screen.tsx       |  6 +--
 src/app/auth/components/email-login-form.tsx  |  2 +-
 .../auth/components/email-register-form.tsx   |  2 +-
 src/app/chat/components/chat-screen.tsx       |  4 +-
 src/app/sidebar/components/sidebar-screen.tsx |  2 +-
 src/app/splash/components/splash-button.tsx   | 26 +++++++----
 src/app/splash/components/splash-content.tsx  |  2 +-
 src/app/splash/components/splash-screen.tsx   | 46 ++++++++++---------
 src/providers/root-providers.tsx              |  8 ++--
 .../auth/auth-context.tsx                     |  0
 src/{contexts => stores}/auth/auth-machine.ts |  0
 src/{contexts => stores}/auth/auth-types.ts   |  0
 src/{contexts => stores}/auth/index.ts        |  0
 .../chat/chat-context.tsx                     |  0
 src/{contexts => stores}/chat/chat-machine.ts |  0
 src/{contexts => stores}/chat/chat-types.ts   |  0
 src/{contexts => stores}/chat/index.ts        |  0
 src/{contexts => stores}/sidebar/index.ts     |  0
 .../sidebar/sidebar-context.tsx               |  0
 .../sidebar/sidebar-machine.ts                |  0
 .../sidebar/sidebar-types.ts                  |  0
 src/{contexts => stores}/user/index.ts        |  0
 .../user/user-context.tsx                     |  0
 src/{contexts => stores}/user/user-machine.ts |  0
 src/{contexts => stores}/user/user-types.ts   |  0
 src/utils/storage.ts                          | 18 ++++++--
 29 files changed, 72 insertions(+), 50 deletions(-)
 rename src/{contexts => stores}/auth/auth-context.tsx (100%)
 rename src/{contexts => stores}/auth/auth-machine.ts (100%)
 rename src/{contexts => stores}/auth/auth-types.ts (100%)
 rename src/{contexts => stores}/auth/index.ts (100%)
 rename src/{contexts => stores}/chat/chat-context.tsx (100%)
 rename src/{contexts => stores}/chat/chat-machine.ts (100%)
 rename src/{contexts => stores}/chat/chat-types.ts (100%)
 rename src/{contexts => stores}/chat/index.ts (100%)
 rename src/{contexts => stores}/sidebar/index.ts (100%)
 rename src/{contexts => stores}/sidebar/sidebar-context.tsx (100%)
 rename src/{contexts => stores}/sidebar/sidebar-machine.ts (100%)
 rename src/{contexts => stores}/sidebar/sidebar-types.ts (100%)
 rename src/{contexts => stores}/user/index.ts (100%)
 rename src/{contexts => stores}/user/user-context.tsx (100%)
 rename src/{contexts => stores}/user/user-machine.ts (100%)
 rename src/{contexts => stores}/user/user-types.ts (100%)

diff --git a/src/app/auth/components/auth-email-panel.tsx b/src/app/auth/components/auth-email-panel.tsx
index a16bce09..15a0f3ba 100644
--- a/src/app/auth/components/auth-email-panel.tsx
+++ b/src/app/auth/components/auth-email-panel.tsx
@@ -10,7 +10,7 @@
  */
 import { useState } from "react";
 
-import { useAuthState } from "@/contexts/auth/auth-context";
+import { useAuthState } from "@/stores/auth/auth-context";
 
 import { EmailLoginForm } from "./email-login-form";
 import { EmailRegisterForm } from "./email-register-form";
diff --git a/src/app/auth/components/auth-facebook-panel.tsx b/src/app/auth/components/auth-facebook-panel.tsx
index 1866f293..6c8370ab 100644
--- a/src/app/auth/components/auth-facebook-panel.tsx
+++ b/src/app/auth/components/auth-facebook-panel.tsx
@@ -10,7 +10,7 @@
  */
 import { useState } from "react";
 
-import { useAuthState, useAuthDispatch } from "@/contexts/auth/auth-context";
+import { useAuthState, useAuthDispatch } from "@/stores/auth/auth-context";
 
 import { AuthSocialButtons } from "./auth-social-buttons";
 import { AuthDivider } from "./auth-divider";
diff --git a/src/app/auth/components/auth-panel.tsx b/src/app/auth/components/auth-panel.tsx
index 89924f15..246488b9 100644
--- a/src/app/auth/components/auth-panel.tsx
+++ b/src/app/auth/components/auth-panel.tsx
@@ -4,7 +4,7 @@
  *
  * 原始 Dart: lib/ui/auth/widgets/auth_panel.dart
  */
-import { useAuthState } from "@/contexts/auth/auth-context";
+import { useAuthState } from "@/stores/auth/auth-context";
 
 import { AuthFacebookPanel } from "./auth-facebook-panel";
 import { AuthEmailPanel } from "./auth-email-panel";
diff --git a/src/app/auth/components/auth-screen.tsx b/src/app/auth/components/auth-screen.tsx
index 7803d084..c3055c5e 100644
--- a/src/app/auth/components/auth-screen.tsx
+++ b/src/app/auth/components/auth-screen.tsx
@@ -13,9 +13,9 @@
 import { useEffect, useRef } from "react";
 import { useRouter } from "next/navigation";
 
-import { useAuthState, useAuthDispatch } from "@/contexts/auth/auth-context";
-import { useChatDispatch } from "@/contexts/chat/chat-context";
-import { useUserDispatch } from "@/contexts/user/user-context";
+import { useAuthState, useAuthDispatch } from "@/stores/auth/auth-context";
+import { useChatDispatch } from "@/stores/chat/chat-context";
+import { useUserDispatch } from "@/stores/user/user-context";
 import { useAuthGate } from "@/lib/auth/use-auth-gate";
 import { ROUTES } from "@/lib/routes";
 import { MobileShell } from "@/app/_components/core/mobile-shell";
diff --git a/src/app/auth/components/email-login-form.tsx b/src/app/auth/components/email-login-form.tsx
index a18d0e3f..5ce3fa93 100644
--- a/src/app/auth/components/email-login-form.tsx
+++ b/src/app/auth/components/email-login-form.tsx
@@ -6,7 +6,7 @@
  */
 import { useState } from "react";
 
-import { useAuthDispatch } from "@/contexts/auth/auth-context";
+import { useAuthDispatch } from "@/stores/auth/auth-context";
 import {
   validateEmail,
   validatePassword,
diff --git a/src/app/auth/components/email-register-form.tsx b/src/app/auth/components/email-register-form.tsx
index bdecf428..617b126d 100644
--- a/src/app/auth/components/email-register-form.tsx
+++ b/src/app/auth/components/email-register-form.tsx
@@ -6,7 +6,7 @@
  */
 import { useState } from "react";
 
-import { useAuthDispatch } from "@/contexts/auth/auth-context";
+import { useAuthDispatch } from "@/stores/auth/auth-context";
 import {
   validateConfirmPassword,
   validateEmail,
diff --git a/src/app/chat/components/chat-screen.tsx b/src/app/chat/components/chat-screen.tsx
index 33958275..0ba296b2 100644
--- a/src/app/chat/components/chat-screen.tsx
+++ b/src/app/chat/components/chat-screen.tsx
@@ -4,8 +4,8 @@ import { type FormEvent, useEffect, useRef, useState } from "react";
 
 import { MobileShell } from "@/app/_components/core/mobile-shell";
 import { Dialog } from "@/app/_components/core/dialog";
-import { useChatDispatch, useChatState } from "@/contexts/chat/chat-context";
-import { GuestChatQuota } from "@/contexts/chat/chat-types";
+import { useChatDispatch, useChatState } from "@/stores/chat/chat-context";
+import { GuestChatQuota } from "@/stores/chat/chat-types";
 import type { UiMessage } from "@/models/chat/ui-message";
 
 import styles from "./chat-screen.module.css";
diff --git a/src/app/sidebar/components/sidebar-screen.tsx b/src/app/sidebar/components/sidebar-screen.tsx
index b9f8b941..945a9798 100644
--- a/src/app/sidebar/components/sidebar-screen.tsx
+++ b/src/app/sidebar/components/sidebar-screen.tsx
@@ -4,7 +4,7 @@ import { useEffect } from "react";
 import Link from "next/link";
 
 import { MobileShell } from "@/app/_components/core/mobile-shell";
-import { useUserDispatch, useUserState } from "@/contexts/user/user-context";
+import { useUserDispatch, useUserState } from "@/stores/user/user-context";
 
 import styles from "./sidebar-screen.module.css";
 
diff --git a/src/app/splash/components/splash-button.tsx b/src/app/splash/components/splash-button.tsx
index 8b966955..155b68b4 100644
--- a/src/app/splash/components/splash-button.tsx
+++ b/src/app/splash/components/splash-button.tsx
@@ -10,18 +10,25 @@
  *   - 居中布局 (MainAxisAlignment.center)
  *   - Facebook 按钮：带渐变（primaryGradient）+ 圆角 24 + 高度 48
  *   - 加载中：按钮内显示 spinner
+ *
+ * Skip 按钮使用 `<Link>` 而非 `<button onClick>`：
+ *   - 保留 Next.js SPA 体验 + prefetch
+ *   - 避免编程式 `router.push`（消除水合后副作用）
+ *   - 右键"在新标签页打开"等浏览器行为自然支持
  */
-import { useAuthState, useAuthDispatch } from "@/contexts/auth/auth-context";
+import Link from "next/link";
+import { useAuthState, useAuthDispatch } from "@/stores/auth/auth-context";
 import { LoadingIndicator } from "@/app/_components/core/loading-indicator";
 import styles from "./splash-button.module.css";
 
 export interface SplashButtonProps {
-  onSkip: () => void;
+  /** Skip 链接的目标路由（href） */
+  skipHref: string;
   onFacebookLogin: () => void;
 }
 
 export function SplashButton({
-  onSkip,
+  skipHref,
   onFacebookLogin,
 }: SplashButtonProps) {
   const state = useAuthState();
@@ -30,15 +37,16 @@ export function SplashButton({
 
   return (
     <div className={styles.wrapper}>
-      {/* Skip 文本按钮 */}
-      <button
-        type="button"
-        onClick={onSkip}
+      {/* Skip 文本链接（next/link 渲染为 <a>，保留 SPA 体验） */}
+      <Link
+        href={skipHref}
         className={styles.skip}
-        disabled={isLoading}
+        aria-disabled={isLoading}
+        tabIndex={isLoading ? -1 : 0}
+        style={isLoading ? { pointerEvents: "none", opacity: 0.5 } : undefined}
       >
         Skip
-      </button>
+      </Link>
 
       <div className={styles.separator} aria-hidden="true" />
 
diff --git a/src/app/splash/components/splash-content.tsx b/src/app/splash/components/splash-content.tsx
index ff5aba04..fdef115d 100644
--- a/src/app/splash/components/splash-content.tsx
+++ b/src/app/splash/components/splash-content.tsx
@@ -10,7 +10,7 @@
  */
 import styles from "./splash-content.module.css";
 
-const APOSTROPHE = "&#39;";
+const APOSTROPHE = "'";
 
 export function SplashContent() {
   return (
diff --git a/src/app/splash/components/splash-screen.tsx b/src/app/splash/components/splash-screen.tsx
index 740ba2c2..4f9e61da 100644
--- a/src/app/splash/components/splash-screen.tsx
+++ b/src/app/splash/components/splash-screen.tsx
@@ -1,11 +1,8 @@
 "use client";
 
-import { useRouter } from "next/navigation";
-import { useEffect, useRef } from "react";
-
-import { useAuthState } from "@/contexts/auth/auth-context";
-import { useChatDispatch } from "@/contexts/chat/chat-context";
-import { useUserDispatch } from "@/contexts/user/user-context";
+import { useAuthState } from "@/stores/auth/auth-context";
+import { useChatDispatch } from "@/stores/chat/chat-context";
+import { useUserDispatch } from "@/stores/user/user-context";
 import { useAuthGate } from "@/lib/auth/use-auth-gate";
 import { ROUTES } from "@/lib/routes";
 import { MobileShell } from "@/app/_components/core/mobile-shell";
@@ -17,26 +14,31 @@ import { SplashButton } from "./splash-button";
 import styles from "./splash-screen.module.css";
 
 export function SplashScreen() {
-  const router = useRouter();
-  const { isAuthed } = useAuthGate();
+  // useAuthGate 仍消费（仅读取 isAuthed 用于子组件 gating，不触发跳转）
+  useAuthGate();
+  // 以下 state/dispatch 当前未在本组件消费；保留以便未来按状态驱动的跳转
+  // 重新启用时再解注释 useEffect 即可。
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const state = useAuthState();
-  const wasSuccess = useRef(false);
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const chatDispatch = useChatDispatch();
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const userDispatch = useUserDispatch();
 
-  useEffect(() => {
-    if (isAuthed) router.replace(ROUTES.chat);
-  }, [isAuthed, router]);
+  // 已登录时跳 /chat（已注释：改由 SplashButton 的 Link + 路由守卫统一处理）
+  // useEffect(() => {
+  //   if (isAuthed) router.replace(ROUTES.chat);
+  // }, [isAuthed, router]);
 
-  // 登录成功跳 /chat
-  useEffect(() => {
-    if (state.isSuccess && !wasSuccess.current) {
-      wasSuccess.current = true;
-      chatDispatch({ type: "ChatAuthStatusChanged" });
-      userDispatch({ type: "UserInit" });
-      router.replace(ROUTES.chat);
-    }
-  }, [state.isSuccess, chatDispatch, userDispatch, router]);
+  // 登录成功跳 /chat（已注释：改由 SplashButton 的 Link + 路由守卫统一处理）
+  // useEffect(() => {
+  //   if (state.isSuccess && !wasSuccess.current) {
+  //     wasSuccess.current = true;
+  //     chatDispatch({ type: "ChatAuthStatusChanged" });
+  //     userDispatch({ type: "UserInit" });
+  //     router.replace(ROUTES.chat);
+  //   }
+  // }, [state.isSuccess, chatDispatch, userDispatch, router]);
 
   return (
     <MobileShell background="var(--color-sidebar-background)">
@@ -50,7 +52,7 @@ export function SplashScreen() {
           <SplashContent />
           <div className={styles.buttonArea}>
             <SplashButton
-              onSkip={() => router.push(ROUTES.chat)}
+              skipHref={ROUTES.chat}
               onFacebookLogin={() => {
                 /* Facebook 登录触发由 SplashButton 内部 dispatch */
               }}
diff --git a/src/providers/root-providers.tsx b/src/providers/root-providers.tsx
index 971b7450..0df79b9d 100644
--- a/src/providers/root-providers.tsx
+++ b/src/providers/root-providers.tsx
@@ -12,10 +12,10 @@
 
 import type { ReactNode } from "react";
 
-import { AuthProvider } from "@/contexts/auth/auth-context";
-import { ChatProvider } from "@/contexts/chat/chat-context";
-import { SidebarProvider } from "@/contexts/sidebar/sidebar-context";
-import { UserProvider } from "@/contexts/user/user-context";
+import { AuthProvider } from "@/stores/auth/auth-context";
+import { ChatProvider } from "@/stores/chat/chat-context";
+import { SidebarProvider } from "@/stores/sidebar/sidebar-context";
+import { UserProvider } from "@/stores/user/user-context";
 
 export interface RootProvidersProps {
   children: ReactNode;
diff --git a/src/contexts/auth/auth-context.tsx b/src/stores/auth/auth-context.tsx
similarity index 100%
rename from src/contexts/auth/auth-context.tsx
rename to src/stores/auth/auth-context.tsx
diff --git a/src/contexts/auth/auth-machine.ts b/src/stores/auth/auth-machine.ts
similarity index 100%
rename from src/contexts/auth/auth-machine.ts
rename to src/stores/auth/auth-machine.ts
diff --git a/src/contexts/auth/auth-types.ts b/src/stores/auth/auth-types.ts
similarity index 100%
rename from src/contexts/auth/auth-types.ts
rename to src/stores/auth/auth-types.ts
diff --git a/src/contexts/auth/index.ts b/src/stores/auth/index.ts
similarity index 100%
rename from src/contexts/auth/index.ts
rename to src/stores/auth/index.ts
diff --git a/src/contexts/chat/chat-context.tsx b/src/stores/chat/chat-context.tsx
similarity index 100%
rename from src/contexts/chat/chat-context.tsx
rename to src/stores/chat/chat-context.tsx
diff --git a/src/contexts/chat/chat-machine.ts b/src/stores/chat/chat-machine.ts
similarity index 100%
rename from src/contexts/chat/chat-machine.ts
rename to src/stores/chat/chat-machine.ts
diff --git a/src/contexts/chat/chat-types.ts b/src/stores/chat/chat-types.ts
similarity index 100%
rename from src/contexts/chat/chat-types.ts
rename to src/stores/chat/chat-types.ts
diff --git a/src/contexts/chat/index.ts b/src/stores/chat/index.ts
similarity index 100%
rename from src/contexts/chat/index.ts
rename to src/stores/chat/index.ts
diff --git a/src/contexts/sidebar/index.ts b/src/stores/sidebar/index.ts
similarity index 100%
rename from src/contexts/sidebar/index.ts
rename to src/stores/sidebar/index.ts
diff --git a/src/contexts/sidebar/sidebar-context.tsx b/src/stores/sidebar/sidebar-context.tsx
similarity index 100%
rename from src/contexts/sidebar/sidebar-context.tsx
rename to src/stores/sidebar/sidebar-context.tsx
diff --git a/src/contexts/sidebar/sidebar-machine.ts b/src/stores/sidebar/sidebar-machine.ts
similarity index 100%
rename from src/contexts/sidebar/sidebar-machine.ts
rename to src/stores/sidebar/sidebar-machine.ts
diff --git a/src/contexts/sidebar/sidebar-types.ts b/src/stores/sidebar/sidebar-types.ts
similarity index 100%
rename from src/contexts/sidebar/sidebar-types.ts
rename to src/stores/sidebar/sidebar-types.ts
diff --git a/src/contexts/user/index.ts b/src/stores/user/index.ts
similarity index 100%
rename from src/contexts/user/index.ts
rename to src/stores/user/index.ts
diff --git a/src/contexts/user/user-context.tsx b/src/stores/user/user-context.tsx
similarity index 100%
rename from src/contexts/user/user-context.tsx
rename to src/stores/user/user-context.tsx
diff --git a/src/contexts/user/user-machine.ts b/src/stores/user/user-machine.ts
similarity index 100%
rename from src/contexts/user/user-machine.ts
rename to src/stores/user/user-machine.ts
diff --git a/src/contexts/user/user-types.ts b/src/stores/user/user-types.ts
similarity index 100%
rename from src/contexts/user/user-types.ts
rename to src/stores/user/user-types.ts
diff --git a/src/utils/storage.ts b/src/utils/storage.ts
index d98fadc8..280910bc 100644
--- a/src/utils/storage.ts
+++ b/src/utils/storage.ts
@@ -11,15 +11,27 @@
  */
 import { createStorage, type Storage } from "unstorage";
 import localStorageDriver from "unstorage/drivers/localstorage";
+import memoryDriver from "unstorage/drivers/memory";
 import type { ZodType } from "zod";
 
 import { Result, type Result as ResultT } from "@/utils/result";
 
 export class SpAsyncUtil {
   // ===== 私有静态状态 =====
-  private static _storage: Storage = createStorage({
-    driver: localStorageDriver({ base: "cozsweet:" }),
-  });
+  // 环境判断 + lazy 初始化：SSR 用 memory driver，浏览器用 localStorage driver。
+  // unstorage 1.10+ 要求显式传入 localStorage，故这里同步注入 window.localStorage。
+  private static _storage: Storage = (() => {
+    if (typeof window === "undefined") {
+      // SSR 环境：无 window，降级为内存驱动
+      return createStorage({ driver: memoryDriver() });
+    }
+    // 浏览器环境：使用 localStorage 驱动
+    return createStorage({
+      driver: localStorageDriver({
+        base: "cozsweet:",
+      }),
+    });
+  })();
 
   // 私有构造函数：禁止实例化（对齐 Dart `SpAsyncUtil._()`）
   private constructor() {}