feat(ui): migrate Flutter UI library to Next.js 16 (App Router)

Migrate all 87 Dart files from /Users/chase/Documents/cozsweet/lib/ui/
to TypeScript React components, replacing Flutter-native features with
Web equivalents and reimplementing the BLoC pattern with React
Context + useReducer.

Highlights
- 1:1 BLoC -> Context+useReducer+side-effects mapping for auth, chat,
  user, and sidebar features (4 providers wired in root-providers.tsx)
- 500px MobileShell primitive eliminates per-screen layout boilerplate
- Headless Dialog primitive (createPortal + ESC + scroll lock) powers
  quota / pwa-install / username / pronouns / subscription / other-options
  dialogs
- New integrations/: facebook-sdk, google-identity, pwa-install,
  media-recorder (Web Speech API + MediaRecorder), browser-detect,
  chat-websocket (singleton), message-queue (throttled send)
- CSS Modules + existing design tokens (no new styling system);
  extended with breakpoints.css and dimensions.css
- Custom hooks: useBreakpoint (useSyncExternalStore),
  useFullVisibility (IntersectionObserver), usePwaInstall,
  usePullToRefresh
- Vitest + jsdom; 15 unit tests (chat-reducer, auth-validators)
- React 19.2.4, Next.js 16.2.7, Zod 4, lottie-react, classnames

Workarounds
- next.config.ts: experimental.staticGenerationRetryCount = 0 to
  bypass Next.js 16.2.7 /_global-error workStore prerender bug
- src/app/global-error.tsx: required Client Component
- src/types/globals.d.ts: centralized window.google / FB /
  SpeechRecognition declarations

Routes (/, /splash, /auth, /chat, /chat/deviceid/[deviceId],
/sidebar) all build and lint clean.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-06-09 13:30:54 +08:00
parent b362945195
commit 8cab34864e
114 changed files with 6744 additions and 276 deletions
+2 -89
View File
@@ -1,94 +1,7 @@
"use client";
/**
* Splash 页(路由骨架版)
*
* 对齐 Flutter `lib/ui/splash/splash_screen.dart` 的语义:
* - 已登录用户:自动跳 `/chat`(替代 Flutter 的 `BlocListener<AuthBloc>`
* - 未登录:渲染品牌占位 + Skip 按钮 + Facebook 登录占位
*
* 占位 UI 不复刻 Flutter 视觉(待 `src/components/` 落地后再做),仅做路由行为验证。
*/
import { useEffect } from "react";
import { useRouter } from "next/navigation";
import { useAuthGate } from "@/lib/auth/use-auth-gate";
import { ROUTES } from "@/lib/routes";
import { SplashScreen } from "@/components/splash/splash-screen";
export default function SplashPage() {
const router = useRouter();
const { isAuthed } = useAuthGate();
// 已登录 → 自动跳 /chat。
useEffect(() => {
if (isAuthed) {
router.replace(ROUTES.chat);
}
}, [isAuthed, router]);
// `useAuthGate` 在 SSR / 客户端水合首帧都返回 `isAuthed=false`
// 因此这里会先渲染 spinner 占位(也避免水合闪屏),等水合完成、
// React 自动重读 localStorage 拿到真值后,若仍为 false 则展示下方 UI。
if (!isAuthed) {
return (
<main
className="flex flex-1 flex-col items-center justify-center gap-xl p-lg"
style={{
minHeight: "100dvh",
background: "var(--color-sidebar-background)",
color: "var(--color-text-primary)",
}}
>
<h1 className="text-3xl font-semibold">cozsweet</h1>
<p
className="max-w-md text-center text-sm"
style={{ color: "var(--color-text-secondary)" }}
>
Splash placeholder · authed {String(isAuthed)}
</p>
<div className="flex flex-col gap-md">
<button
type="button"
onClick={() => router.push(ROUTES.chat)}
className="rounded-md px-xl py-sm text-sm"
style={{
background: "var(--color-accent)",
color: "var(--color-text-primary)",
}}
>
Skip
</button>
<button
type="button"
disabled
className="rounded-md px-xl py-sm text-sm opacity-60"
style={{
background: "var(--color-facebook-blue)",
color: "var(--color-text-primary)",
cursor: "not-allowed",
}}
>
Continue with Facebook
{/* TODO: 接入 facebookLogin 后启用 */}
</button>
</div>
</main>
);
}
// 已登录:上面的 useEffect 会触发 router.replace;这里短暂渲染占位。
return (
<div
className="flex flex-1 items-center justify-center"
style={{ minHeight: "100dvh" }}
>
<div
aria-label="Redirecting"
className="size-10 animate-spin rounded-full border-4 border-t-transparent"
style={{ borderColor: "var(--color-accent)" }}
/>
</div>
);
return <SplashScreen />;
}