chore: sync with main [skip ci] (#91)

Co-authored-by: NtskwK <natsukawa247@outlook.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

11 files changed, 436 insertions, 0 deletions

diff --git a/packages/docs/app/app.css b/packages/docs/app/app.css
new file mode 100644
index 0000000..50b3bc2
--- /dev/null
+++ b/packages/docs/app/app.css
@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
diff --git a/packages/docs/app/docs/page.tsx b/packages/docs/app/docs/page.tsx
new file mode 100644
index 0000000..a9e3433
--- /dev/null
+++ b/packages/docs/app/docs/page.tsx
@@ -0,0 +1,58 @@
+import type { Route } from './+types/page';
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { DocsPage, DocsBody, DocsDescription, DocsTitle } from 'fumadocs-ui/page';
+import { Card, Cards } from 'fumadocs-ui/components/card';
+import { source } from '@/lib/source';
+import { i18n } from '@/lib/i18n';
+import { baseOptions } from '@/lib/layout.shared';
+import { useFumadocsLoader } from 'fumadocs-core/source/client';
+import browserCollections from 'fumadocs-mdx:collections/browser';
+
+export async function loader({ params }: Route.LoaderArgs) {
+  // 从路由参数获取语言，如果没有则使用默认语言
+  // URL 格式: /docs/getting-started (默认语言 zh)
+  // URL 格式: /en/docs/getting-started (英语)
+  const lang = (params.lang && i18n.languages.includes(params.lang as any))
+    ? (params.lang as 'zh' | 'en')
+    : (i18n.defaultLanguage as 'zh' | 'en');
+  
+  // 获取文档路径 slugs
+  const slugs = params['*']?.split('/').filter((v) => v.length > 0) || [];
+  
+  const page = source.getPage(slugs, lang);
+  
+  if (!page) {
+    throw new Response('Not found', { status: 404 });
+  }
+
+  return {
+    path: page.path,
+    pageTree: await source.serializePageTree(source.getPageTree(lang)),
+    lang,
+  };
+}
+
+const clientLoader = browserCollections.docs.createClientLoader({
+  component({ toc, frontmatter, default: Mdx }) {
+    return (
+      <DocsPage toc={toc}>
+        <DocsTitle>{frontmatter.title}</DocsTitle>
+        <DocsDescription>{frontmatter.description}</DocsDescription>
+        <DocsBody>
+          <Mdx components={{ ...defaultMdxComponents, Card, Cards }} />
+        </DocsBody>
+      </DocsPage>
+    );
+  },
+});
+
+export default function Page({ loaderData, params }: Route.ComponentProps) {
+  const { pageTree, lang } = useFumadocsLoader(loaderData);
+
+  return (
+    <DocsLayout {...baseOptions(lang)} tree={pageTree}>
+      {clientLoader.useContent(loaderData.path)}
+    </DocsLayout>
+  );
+}
diff --git a/packages/docs/app/docs/search.ts b/packages/docs/app/docs/search.ts
new file mode 100644
index 0000000..a98edd5
--- /dev/null
+++ b/packages/docs/app/docs/search.ts
@@ -0,0 +1,15 @@
+import type { Route } from './+types/search';
+import { createFromSource } from 'fumadocs-core/search/server';
+import { source } from '@/lib/source';
+
+const server = createFromSource(source, {
+  localeMap: {
+    zh: {
+      language: 'english',
+    },
+  },
+});
+
+export async function loader({ request }: Route.LoaderArgs) {
+  return server.GET(request);
+}
diff --git a/packages/docs/app/lib/i18n.ts b/packages/docs/app/lib/i18n.ts
new file mode 100644
index 0000000..a9f18b1
--- /dev/null
+++ b/packages/docs/app/lib/i18n.ts
@@ -0,0 +1,8 @@
+import { defineI18n } from 'fumadocs-core/i18n';
+
+export const i18n = defineI18n({
+  defaultLanguage: 'zh',
+  languages: ['zh', 'en'],
+  hideLocale: 'default-locale',
+  parser: 'dir', // 使用目录结构 (content/zh/*, content/en/*)
+});
diff --git a/packages/docs/app/lib/layout.shared.tsx b/packages/docs/app/lib/layout.shared.tsx
new file mode 100644
index 0000000..6e90ba0
--- /dev/null
+++ b/packages/docs/app/lib/layout.shared.tsx
@@ -0,0 +1,24 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { i18n } from './i18n';
+
+export function baseOptions(locale: string): BaseLayoutProps {
+  // 默认语言（zh）不显示前缀，其他语言显示前缀
+  const isDefaultLocale = locale === i18n.defaultLanguage;
+  const localePrefix = isDefaultLocale ? '' : `/${locale}`;
+  
+  return {
+    i18n,
+    nav: {
+      title: 'DropOut',
+      url: localePrefix || '/',
+    },
+    githubUrl: 'https://github.com/HydroRoll-Team/DropOut',
+    links: [
+      {
+        type: 'main',
+        text: locale === 'zh' ? '文档' : 'Documentation',
+        url: `${localePrefix}/docs`,
+      },
+    ],
+  };
+}
diff --git a/packages/docs/app/lib/source.ts b/packages/docs/app/lib/source.ts
new file mode 100644
index 0000000..bce9bf9
--- /dev/null
+++ b/packages/docs/app/lib/source.ts
@@ -0,0 +1,12 @@
+import { loader } from 'fumadocs-core/source';
+import { docs } from 'fumadocs-mdx:collections/server';
+import { i18n } from './i18n';
+
+export const source = loader({
+  source: docs.toFumadocsSource(),
+  baseUrl: '/docs',
+  i18n,
+  // hideLocale: 'default-locale' 会自动生成正确的 URL:
+  // - 默认语言 (zh): /docs/getting-started
+  // - 其他语言 (en): /en/docs/getting-started
+});
diff --git a/packages/docs/app/root.tsx b/packages/docs/app/root.tsx
new file mode 100644
index 0000000..9032c80
--- /dev/null
+++ b/packages/docs/app/root.tsx
@@ -0,0 +1,104 @@
+import {
+  isRouteErrorResponse,
+  Link,
+  Links,
+  Meta,
+  Outlet,
+  Scripts,
+  ScrollRestoration,
+  useParams,
+} from 'react-router';
+import { RootProvider } from 'fumadocs-ui/provider/react-router';
+import type { Route } from './+types/root';
+import './app.css';
+import { defineI18nUI } from 'fumadocs-ui/i18n';
+import { i18n } from './lib/i18n';
+
+const { provider } = defineI18nUI(i18n, {
+  translations: {
+    en: {
+      displayName: 'English',
+    },
+    zh: {
+      displayName: '中文',
+      search: '查找文档',
+    },
+  },
+});
+export const links: Route.LinksFunction = () => [
+  { rel: 'preconnect', href: 'https://fonts.googleapis.com' },
+  {
+    rel: 'preconnect',
+    href: 'https://fonts.gstatic.com',
+    crossOrigin: 'anonymous',
+  },
+  {
+    rel: 'stylesheet',
+    href: 'https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap',
+  },
+];
+
+export function Layout({ children }: { children: React.ReactNode }) {
+  const { lang = i18n.defaultLanguage } = useParams();
+  
+  return (
+    <html lang={lang} suppressHydrationWarning>
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <Meta />
+        <Links />
+      </head>
+      <body className="flex flex-col min-h-screen">
+        <RootProvider i18n={provider(lang)}>{children}</RootProvider>
+        <ScrollRestoration />
+        <Scripts />
+      </body>
+    </html>
+  );
+}
+
+export default function App() {
+  return <Outlet />;
+}
+
+export function ErrorBoundary({ error }: Route.ErrorBoundaryProps) {
+  let message = 'Oops!';
+  let details = 'An unexpected error occurred.';
+  let stack: string | undefined;
+
+  if (isRouteErrorResponse(error)) {
+    message = error.status === 404 ? '404' : 'Error';
+    details =
+      error.status === 404 ? 'The requested page could not be found.' : error.statusText || details;
+  } else if (import.meta.env.DEV && error && error instanceof Error) {
+    details = error.message;
+    stack = error.stack;
+  }
+
+  return (
+    <main className="flex-1 flex flex-col items-center p-4 mt-40 text-center">
+      <h1 className="text-9xl font-black mb-4 bg-gradient-to-r from-blue-600 to-cyan-500 bg-clip-text text-transparent opacity-50">
+        {message}
+      </h1>
+      <p className="text-2xl font-semibold mb-2">{details}</p>
+      <p className="text-fd-muted-foreground mb-8 max-w-md">
+        Sorry, we couldn't find the page you're looking for. It might have been moved or deleted.
+      </p>
+      <Link
+        to="/"
+        className="bg-blue-600 hover:bg-blue-700 text-white font-bold rounded-full px-8 py-3 shadow-lg shadow-blue-500/30 transition-all hover:scale-105 active:scale-95"
+      >
+        Return Home / 返回首页
+      </Link>
+      {stack && (
+        <div className="mt-12 w-full max-w-2xl text-left">
+          <p className="text-xs font-mono text-fd-muted-foreground mb-2 uppercase tracking-widest">Error Stack</p>
+          <pre className="p-4 overflow-x-auto text-sm bg-fd-muted rounded-xl border border-fd-border font-mono whitespace-pre-wrap break-all shadow-inner">
+            <code>{stack}</code>
+          </pre>
+        </div>
+      )}
+    </main>
+  );
+}
diff --git a/packages/docs/app/routes.ts b/packages/docs/app/routes.ts
new file mode 100644
index 0000000..2997ecf
--- /dev/null
+++ b/packages/docs/app/routes.ts
@@ -0,0 +1,16 @@
+import { route, type RouteConfig } from '@react-router/dev/routes';
+
+export default [
+  // Home routes: / and /:lang
+  route(':lang?', 'routes/home.tsx', { id: 'home' }),
+
+  // Docs routes: /docs/* and /:lang/docs/*
+  route(':lang?/docs', 'routes/docs.tsx', { id: 'docs' }),
+  route(':lang?/docs/*', 'docs/page.tsx', { id: 'docs-page' }),
+
+  // API routes
+  route('api/search', 'docs/search.ts', { id: 'api-search' }),
+
+  // Catch-all 404
+  route('*', 'routes/not-found.tsx', { id: 'not-found' }),
+] satisfies RouteConfig;
diff --git a/packages/docs/app/routes/docs.tsx b/packages/docs/app/routes/docs.tsx
new file mode 100644
index 0000000..5154d27
--- /dev/null
+++ b/packages/docs/app/routes/docs.tsx
@@ -0,0 +1,16 @@
+import type { Route } from './+types/docs';
+import { redirect } from 'react-router';
+
+import { i18n } from '@/lib/i18n';
+
+export function loader({ params }: Route.LoaderArgs) {
+  const lang = params.lang as string | undefined;
+  
+  // 如果没有语言参数或是默认语言，重定向到 /docs/getting-started
+  if (!lang || lang === i18n.defaultLanguage) {
+    return redirect('/docs/getting-started');
+  }
+  
+  // 其他语言重定向到 /:lang/docs/getting-started
+  return redirect(`/${lang}/docs/getting-started`);
+}
diff --git a/packages/docs/app/routes/home.tsx b/packages/docs/app/routes/home.tsx
new file mode 100644
index 0000000..66b5333
--- /dev/null
+++ b/packages/docs/app/routes/home.tsx
@@ -0,0 +1,173 @@
+import type { Route } from './+types/home';
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+import { baseOptions } from '@/lib/layout.shared';
+import { i18n } from '@/lib/i18n';
+
+const texts = {
+  en: {
+    hero: {
+      title: 'DropOut Minecraft Launcher',
+      subtitle: 'Modern. Reproducible. Developer-Grade.',
+      description: 'Built with Tauri v2 and Rust for native performance and minimal resource usage',
+      start: 'Get Started',
+      features: 'Features',
+    },
+    features: {
+      items: [
+        { title: 'High Performance', desc: 'Built with Rust and Tauri for minimal resource usage and fast startup times' },
+        { title: 'Modern UI', desc: 'Clean, distraction-free interface with Svelte 5 and Tailwind CSS 4' },
+        { title: 'Secure Auth', desc: 'Microsoft OAuth 2.0 with device code flow and offline mode support' },
+        { title: 'Mod Loaders', desc: 'Built-in support for Fabric and Forge with automatic version management' },
+        { title: 'Java Management', desc: 'Auto-detection and integrated downloader for Adoptium JDK/JRE' },
+        { title: 'Instance System', desc: 'Isolated game environments with independent configs and mods' },
+      ]
+    },
+    why: {
+      title: 'Why DropOut?',
+      items: [
+        { q: 'Your instance worked yesterday but broke today?', a: '→ DropOut makes it traceable.' },
+        { q: 'Sharing a modpack means zipping gigabytes?', a: '→ DropOut shares exact dependency manifests.' },
+        { q: 'Java, loader, mods, configs drift out of sync?', a: '→ DropOut locks them together.' },
+      ]
+    },
+    cta: {
+      title: 'Ready to get started?',
+      desc: 'Check out the documentation to learn more about DropOut',
+      button: 'Read the Docs',
+    }
+  },
+  zh: {
+    hero: {
+      title: 'DropOut Minecraft 启动器',
+      subtitle: '现代、可复现、开发者级',
+      description: '基于 Tauri v2 和 Rust 构建，拥有原生性能和极低的资源占用',
+      start: '开始使用',
+      features: '功能特性',
+    },
+    features: {
+      items: [
+        { title: '高性能', desc: '使用 Rust 和 Tauri 构建，资源占用最小，启动速度极快' },
+        { title: '现代化界面', desc: '简洁、无干扰的界面，使用 Svelte 5 和 Tailwind CSS 4' },
+        { title: '安全认证', desc: '支持微软 OAuth 2.0 设备代码流和离线模式' },
+        { title: '模组支持', desc: '内置 Fabric 和 Forge 支持，自动管理版本' },
+        { title: 'Java 管理', desc: '自动检测并集成 Adoptium JDK/JRE 下载器' },
+        { title: '实例系统', desc: '独立的游戏环境，独立的配置和模组' },
+      ]
+    },
+    why: {
+      title: '为什么选择 DropOut？',
+      items: [
+        { q: '你的实例昨天还能用，今天就坏了？', a: '→ DropOut 让它可追溯。' },
+        { q: '分享模组包意味着打包数GB的文件？', a: '→ DropOut 分享精确的依赖清单。' },
+        { q: 'Java、加载器、模组、配置不同步？', a: '→ DropOut 将它们锁定在一起。' },
+      ]
+    },
+    cta: {
+      title: '准备好开始了？',
+      desc: '查看文档以了解更多关于 DropOut 的信息',
+      button: '阅读文档',
+    }
+  }
+};
+
+export function meta({ params }: Route.MetaArgs) {
+  return [
+    { title: 'DropOut - Modern Minecraft Launcher' },
+    { name: 'description', content: 'A modern, reproducible, and developer-grade Minecraft launcher built with Tauri v2 and Rust.' },
+  ];
+}
+
+export default function Home({ params }: Route.ComponentProps) {
+  const lang = (params.lang as 'en' | 'zh') || i18n.defaultLanguage;
+  const t = texts[lang];
+  
+  // 默认语言（zh）不显示前缀，其他语言显示前缀
+  const isDefaultLocale = lang === i18n.defaultLanguage;
+  const localePrefix = isDefaultLocale ? '' : `/${lang}`;
+
+  return (
+    <HomeLayout {...baseOptions(lang)}>
+      <div className="container max-w-6xl mx-auto px-4 py-16">
+        {/* Hero Section */}
+        <div className="text-center mb-16">
+          <h1 className="text-5xl font-bold mb-6 bg-gradient-to-r from-blue-600 to-cyan-500 bg-clip-text text-transparent">
+            {t.hero.title}
+          </h1>
+          <p className="text-xl text-fd-muted-foreground mb-2">
+            {t.hero.subtitle}
+          </p>
+          <p className="text-lg text-fd-muted-foreground max-w-2xl mx-auto mb-8">
+            {t.hero.description}
+          </p>
+          <div className="flex gap-4 justify-center mb-12">
+            <a
+              className="bg-blue-600 hover:bg-blue-700 text-white font-semibold rounded-lg px-6 py-3 transition-colors cursor-pointer"
+              href={`${localePrefix}/docs`}
+            >
+              {t.hero.start}
+            </a>
+            <a
+              className="bg-fd-secondary hover:bg-fd-secondary/80 text-fd-secondary-foreground font-semibold rounded-lg px-6 py-3 transition-colors cursor-pointer"
+              href={`${localePrefix}/docs/features`}
+            >
+               {t.hero.features}
+            </a>
+          </div>
+        </div>
+
+        {/* Launcher Showcase */}
+        <div className="mb-16">
+          <div className="rounded-xl overflow-hidden shadow-2xl border border-fd-border">
+            <img 
+              src="/image.png" 
+              alt="DropOut Launcher Interface" 
+              className="w-full h-auto"
+            />
+          </div>
+        </div>
+
+        {/* Features Grid */}
+        <div className="grid md:grid-cols-2 lg:grid-cols-3 gap-6 mb-16">
+          {t.features.items.map((item, i) => (
+             <div key={i} className="p-6 rounded-lg border border-fd-border bg-fd-card">
+              <h3 className="font-semibold text-lg mb-2">{item.title}</h3>
+              <p className="text-sm text-fd-muted-foreground">
+                {item.desc}
+              </p>
+            </div>
+          ))}
+        </div>
+
+        {/* Why DropOut Section */}
+        <div className="text-center mb-16">
+          <h2 className="text-3xl font-bold mb-6">{t.why.title}</h2>
+          <div className="max-w-3xl mx-auto space-y-4 text-left">
+            {t.why.items.map((item, i) => (
+              <div key={i} className="p-4 rounded-lg bg-fd-muted/50">
+                <p className="text-fd-foreground">
+                  <span className="font-semibold">{item.q}</span>
+                  <br />
+                  <span className="text-fd-muted-foreground">{item.a}</span>
+                </p>
+              </div>
+            ))}
+          </div>
+        </div>
+
+        {/* CTA Section */}
+        <div className="text-center py-12 px-6 rounded-xl bg-gradient-to-r from-blue-600/10 to-cyan-500/10 border border-blue-600/20">
+          <h2 className="text-3xl font-bold mb-4">{t.cta.title}</h2>
+          <p className="text-lg text-fd-muted-foreground mb-6">
+            {t.cta.desc}
+          </p>
+          <a
+            className="inline-block bg-blue-600 hover:bg-blue-700 text-white font-semibold rounded-lg px-8 py-3 transition-colors"
+            href={`${localePrefix}/docs/getting-started`}
+          >
+            {t.cta.button}
+          </a>
+        </div>
+      </div>
+    </HomeLayout>
+  );
+}
diff --git a/packages/docs/app/routes/not-found.tsx b/packages/docs/app/routes/not-found.tsx
new file mode 100644
index 0000000..1d9e041
--- /dev/null
+++ b/packages/docs/app/routes/not-found.tsx
@@ -0,0 +1,7 @@
+export function loader() {
+  throw new Response('Not Found', { status: 404 });
+}
+
+export default function NotFound() {
+  return null;
+}