From bfe5541e56f68b74fd41974c804f8e7ac1ff9f2a Mon Sep 17 00:00:00 2001
From: shu <nvcsadjkojf@outlook.com>
Date: Thu, 22 Oct 2026 13:03:06 +0800
Subject: feat: 初始化 Astryx React 应用模板
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

基于 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 两种路由模式的页面和侧边栏导航均已验证
---
 src/demos/MenusDemo.tsx | 97 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 src/demos/MenusDemo.tsx

(limited to 'src/demos/MenusDemo.tsx')

diff --git a/src/demos/MenusDemo.tsx b/src/demos/MenusDemo.tsx
new file mode 100644
index 0000000..c928e6f
--- /dev/null
+++ b/src/demos/MenusDemo.tsx
@@ -0,0 +1,97 @@
+import { useState } from 'react'
+import { Avatar } from '@astryxdesign/core/Avatar'
+import { Button } from '@astryxdesign/core/Button'
+import { Card } from '@astryxdesign/core/Card'
+import { ContextMenu } from '@astryxdesign/core/ContextMenu'
+import { DropdownMenu } from '@astryxdesign/core/DropdownMenu'
+import { HStack } from '@astryxdesign/core/HStack'
+import { Heading } from '@astryxdesign/core/Heading'
+import { HoverCard } from '@astryxdesign/core/HoverCard'
+import { MoreMenu } from '@astryxdesign/core/MoreMenu'
+import { Popover } from '@astryxdesign/core/Popover'
+import { Text } from '@astryxdesign/core/Text'
+import { Tooltip } from '@astryxdesign/core/Tooltip'
+import { VStack } from '@astryxdesign/core/VStack'
+
+export function MenusDemo() {
+  const [popoverOpen, setPopoverOpen] = useState(false)
+
+  return (
+    <VStack gap={4}>
+      <HStack gap={2} wrap="wrap" vAlign="center">
+        <DropdownMenu
+          button={{ label: '操作菜单' }}
+          items={[
+            { label: '编辑', onClick: () => {} },
+            { label: '复制', onClick: () => {} },
+            { label: '删除', onClick: () => {} },
+          ]}
+        />
+        <MoreMenu
+          items={[
+            { label: '导出', onClick: () => {} },
+            { label: '分享', onClick: () => {} },
+            { label: '归档', onClick: () => {} },
+          ]}
+        />
+        <Tooltip content="这是一段提示文字" placement="above">
+          <Button label="悬停查看提示" variant="secondary" />
+        </Tooltip>
+        <Popover
+          isOpen={popoverOpen}
+          onOpenChange={setPopoverOpen}
+          hasAutoFocus={false}
+          placement="below"
+          label="设置"
+          width={260}
+          content={
+            <VStack gap={2}>
+              <Heading level={4}>快捷设置</Heading>
+              <Text type="body" color="secondary" as="p">
+                弹层可以承载简短设置、筛选或上下文信息。
+              </Text>
+            </VStack>
+          }>
+          <Button label="打开浮层" variant="secondary" />
+        </Popover>
+        <HoverCard
+          placement="above"
+          content={
+            <VStack gap={2} width={220}>
+              <HStack gap={2} vAlign="center">
+                <Avatar name="林晓" size="md" />
+                <VStack gap={0}>
+                  <Heading level={5}>林晓</Heading>
+                  <Text type="supporting" size="sm">
+                    产品设计
+                  </Text>
+                </VStack>
+              </HStack>
+              <Text type="body" color="secondary" as="p">
+                专注于设计系统与复杂交互体验。
+              </Text>
+            </VStack>
+          }>
+          <Button label="悬停查看资料" variant="ghost" />
+        </HoverCard>
+      </HStack>
+
+      <ContextMenu
+        presentation="adaptive"
+        items={[
+          { label: '剪切', onClick: () => {} },
+          { label: '复制', onClick: () => {} },
+          { label: '粘贴', onClick: () => {} },
+        ]}>
+        <Card padding={4}>
+          <VStack gap={1} hAlign="center">
+            <Text type="label">右键或长按此区域</Text>
+            <Text type="supporting" size="sm">
+              打开上下文菜单
+            </Text>
+          </VStack>
+        </Card>
+      </ContextMenu>
+    </VStack>
+  )
+}
-- 
cgit v1.2.3