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/LayoutDemo.tsx | 52 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 src/demos/LayoutDemo.tsx

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

diff --git a/src/demos/LayoutDemo.tsx b/src/demos/LayoutDemo.tsx
new file mode 100644
index 0000000..53da1bd
--- /dev/null
+++ b/src/demos/LayoutDemo.tsx
@@ -0,0 +1,52 @@
+import { useState } from 'react'
+import { Collapsible, CollapsibleGroup } from '@astryxdesign/core/Collapsible'
+import { Grid } from '@astryxdesign/core/Grid'
+import { Heading } from '@astryxdesign/core/Heading'
+import { SelectableCard } from '@astryxdesign/core/SelectableCard'
+import { Text } from '@astryxdesign/core/Text'
+import { VStack } from '@astryxdesign/core/VStack'
+
+const PLANS = [
+  { id: 'basic', name: '基础版', price: '¥9/月', desc: '适合个人项目' },
+  { id: 'pro', name: '专业版', price: '¥29/月', desc: '适合小型团队' },
+  { id: 'team', name: '团队版', price: '¥99/月', desc: '适合协作组织' },
+]
+
+export function LayoutDemo() {
+  const [selected, setSelected] = useState('pro')
+
+  return (
+    <VStack gap={4}>
+      <Grid columns={{ minWidth: 140, max: 3 }} gap={3}>
+        {PLANS.map((plan) => (
+          <SelectableCard
+            key={plan.id}
+            label={plan.name}
+            isSelected={selected === plan.id}
+            onChange={() => setSelected(plan.id)}>
+            <VStack gap={1}>
+              <Heading level={4}>{plan.name}</Heading>
+              <Text type="large" weight="bold">
+                {plan.price}
+              </Text>
+              <Text type="supporting" size="sm">
+                {plan.desc}
+              </Text>
+            </VStack>
+          </SelectableCard>
+        ))}
+      </Grid>
+
+      <CollapsibleGroup type="single" defaultValue="layout">
+        <Collapsible
+          value="layout"
+          trigger={<Text type="label">这个布局是如何组织的？</Text>}>
+          <Text type="body" color="secondary" as="p">
+            外层使用 Grid 负责响应式列数，SelectableCard 负责可选中的卡片语义，Collapsible
+            负责按需展开说明。所有间距都来自同一套 token。
+          </Text>
+        </Collapsible>
+      </CollapsibleGroup>
+    </VStack>
+  )
+}
-- 
cgit v1.2.3