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 两种路由模式的页面和侧边栏导航均已验证

1 files changed, 56 insertions, 0 deletions

diff --git a/src/app-routes.tsx b/src/app-routes.tsx
new file mode 100644
index 0000000..58747bb
--- /dev/null
+++ b/src/app-routes.tsx
@@ -0,0 +1,56 @@
+import type { ReactNode } from 'react'
+import type { LucideIcon } from 'lucide-react'
+import { Blocks, House, Info, Shapes } from 'lucide-react'
+import { ComponentsRoute } from './components/ComponentsRoute'
+import { IconsRoute } from './components/IconsRoute'
+import { AboutPage } from './pages/AboutPage'
+import { HomePage } from './pages/HomePage'
+
+export interface AppRoute {
+  path: string
+  label: string
+  icon: LucideIcon
+  element: ReactNode
+  showInNav?: boolean
+}
+
+/**
+ * 页面、路由和侧边栏的唯一数据源。
+ * 新增页面时只在这里增加一项，路由与菜单会同步更新。
+ */
+export const appRoutes: AppRoute[] = [
+  {
+    path: '/',
+    label: '概览',
+    icon: House,
+    element: <HomePage />,
+  },
+  {
+    path: '/components',
+    label: '组件',
+    icon: Blocks,
+    element: <ComponentsRoute />,
+  },
+  {
+    path: '/icons',
+    label: '图标',
+    icon: Shapes,
+    element: <IconsRoute />,
+  },
+  {
+    path: '/about',
+    label: '关于',
+    icon: Info,
+    element: <AboutPage />,
+  },
+]
+
+export const navRoutes = appRoutes.filter(
+  (route) => route.showInNav !== false,
+)
+
+export function isRouteActive(routePath: string, pathname: string) {
+  return routePath === '/'
+    ? pathname === '/'
+    : pathname === routePath || pathname.startsWith(`${routePath}/`)
+}