feat: 初始化 Astryx React 应用模板HEADmain

基于 Vite 8、React 19、TypeScript 6、React Router 7 和 Astryx 0.7.2
搭建完整的中文应用起始模板，包含可直接运行的应用外壳与示例页面。

主要变更：
- 使用 Astryx 构建 AppShell、顶部导航、可折叠侧边栏和响应式移动端抽屉。
- 接入 Astryx neutral 主题与中文语言包，支持明暗主题切换并持久化偏好。
- 新增概览、组件、图标、关于和 404 页面，统一使用共享页面框架。
- 将页面路由、侧边栏名称、图标和active状态合并到 app-routes.tsx，
  路由与导航由同一份配置生成，避免重复维护。
- 新增根目录 app.config.ts，可在 browser/history 与 hash 路由模式之间切换；
  当前保留 hash 模式配置。
- 组件页提供 14 个可交互组合场景，覆盖全部 173 个 Astryx 组件，
  包含按钮、表单、表格、导航、聊天、对话框、菜单、命令面板和 Toast 等。
- 新增图标页面，支持浏览 29 个 Astryx 语义图标和 1903 个 Lucide 图标，
  提供搜索、分页、图标集切换和点击复制用法。
- 对组件页和图标页实施路由级懒加载，并按 React、React Router 拆分 vendor
  chunk，降低首屏入口体积并改善长期缓存。
- 接入 React Router 的 LinkProvider，保证 Astryx 链接、导航和按钮在两种
  路由模式下均使用客户端导航。
- 配置 pnpm 供应链策略例外与依赖构建许可，锁定可以正常安装的依赖版本。
- 补充 README，记录项目结构、脚本、组件展厅、图标页、路由模式与构建策略。

验证结果：
- pnpm build 通过
- pnpm lint 0 warnings
- browser 与 hash 两种路由模式的页面和侧边栏导航均已验证

3 files changed, 77 insertions, 0 deletions

diff --git a/src/theme/ThemeMode.tsx b/src/theme/ThemeMode.tsx
new file mode 100644
index 0000000..cd91d5d
--- /dev/null
+++ b/src/theme/ThemeMode.tsx
@@ -0,0 +1,55 @@
+import { useEffect, useMemo, useState, type ReactNode } from 'react'
+import { Theme } from '@astryxdesign/core/theme'
+import { defaultThemeSlug, themes } from '../astryx-themes'
+import {
+  ThemeModeContext,
+  type ColorMode,
+  type ThemeModeValue,
+} from './themeModeContext'
+
+const STORAGE_KEY = 'astryx-starter-mode'
+
+function getInitialMode(): ColorMode {
+  if (typeof window === 'undefined') return 'light'
+
+  try {
+    const stored = window.localStorage.getItem(STORAGE_KEY)
+    if (stored === 'light' || stored === 'dark') return stored
+  } catch {
+    // Storage can be unavailable in private browsing or embedded contexts.
+  }
+
+  return window.matchMedia('(prefers-color-scheme: dark)').matches
+    ? 'dark'
+    : 'light'
+}
+
+export function ThemeModeProvider({ children }: { children: ReactNode }) {
+  const [mode, setMode] = useState<ColorMode>(getInitialMode)
+
+  useEffect(() => {
+    try {
+      window.localStorage.setItem(STORAGE_KEY, mode)
+    } catch {
+      // The theme still switches for this session if persistence is blocked.
+    }
+  }, [mode])
+
+  const value = useMemo<ThemeModeValue>(
+    () => ({
+      mode,
+      toggleMode: () => {
+        setMode((current) => (current === 'light' ? 'dark' : 'light'))
+      },
+    }),
+    [mode],
+  )
+
+  return (
+    <Theme theme={themes[defaultThemeSlug]} mode={mode}>
+      <ThemeModeContext.Provider value={value}>
+        {children}
+      </ThemeModeContext.Provider>
+    </Theme>
+  )
+}
diff --git a/src/theme/themeModeContext.ts b/src/theme/themeModeContext.ts
new file mode 100644
index 0000000..5bbf8ba
--- /dev/null
+++ b/src/theme/themeModeContext.ts
@@ -0,0 +1,10 @@
+import { createContext } from 'react'
+
+export type ColorMode = 'light' | 'dark'
+
+export interface ThemeModeValue {
+  mode: ColorMode
+  toggleMode: () => void
+}
+
+export const ThemeModeContext = createContext<ThemeModeValue | null>(null)
diff --git a/src/theme/useThemeMode.ts b/src/theme/useThemeMode.ts
new file mode 100644
index 0000000..9769684
--- /dev/null
+++ b/src/theme/useThemeMode.ts
@@ -0,0 +1,12 @@
+import { useContext } from 'react'
+import { ThemeModeContext, type ThemeModeValue } from './themeModeContext'
+
+export function useThemeMode(): ThemeModeValue {
+  const context = useContext(ThemeModeContext)
+
+  if (context === null) {
+    throw new Error('useThemeMode must be used inside ThemeModeProvider')
+  }
+
+  return context
+}