# 技术库雷达

> 四档定义见 [README.md](README.md)。只收录已经做过档案、有明确结论的库；未定级的放"候选清单"。

## 总表

| 库 | 分类 | 档位 | 体积（gzip） | 一句话结论 | 档案 |
|---|---|---|---|---|---|
| Swiper | animation / 滑动 | **采纳** | 41.9 KB（整包）；模块化可显著降低 | 滑动生态最全，thumbs 联动开箱即用；**必须用模块化引入** | [swiper.md](libs/animation/swiper.md) |
| Lenis | animation / 滚动 | **采纳** | 约 3 KB（gzip，估算） | 平滑滚动体验好、API 小；不提供 pin，需与动画库配合 | [lenis.md](libs/animation/lenis.md) |
| Anime.js v4 | animation | **评估** | 约 18 KB（按需模块，min） | 模块化、体积小、Scope API 天生适配作用域；**硬缺口是没有 pin** | [animejs.md](libs/animation/animejs.md) |
| Alpine.js | state-dom | **评估** | 约 15 KB | 声明式状态最适合服务端渲染页面与动态插入的区块；与命令式库需桥接 | [alpinejs.md](libs/state-dom/alpinejs.md) |
| GSAP + ScrollTrigger | animation | **暂缓** | 34 KB 左右（两者合计口径） | 能力最全（pin / batch / snap），但体积最大；仅在必须 pin 时考虑 | 待立档 |

> 体积为档案内记录值；标注"估算"的尚未实测。索引展示见 [index.html](index.html)。

## 候选清单（未定级）

按分类列出待研究对象，不代表推荐：

- **animation**：Motion One、Embla Carousel、Splide、Rive
- **state-dom**：petite-vue、htmx、Preact Signals
- **data-fetch**：ky、ofetch、TanStack Query、SWR
- **validation**：Zod、Valibot、TypeBox
- **realtime**：Socket.IO、ws、Server-Sent Events
- **storage**：Dexie、idb-keyval
- **backend**：Hono、Fastify、Drizzle、Prisma
- **build**：Vite、esbuild、Biome
- **testing**：Vitest、Playwright、MSW

## 定级变更记录

| 日期 | 库 | 变更 | 原因 |
|---|---|---|---|
| 2026-11-17 | Swiper | 新增 → 采纳 | 多模块实测稳定（轮播 / 缩略图 / 横幅 / 色板），thumbs 联动可靠 |
| 2026-11-17 | Anime.js v4 | 新增 → 评估 | 体积优势明显，但无 pin，需 PoC 验证 sticky 替代方案 |
| 2026-11-17 | Alpine.js | 新增 → 评估 | 适配 SSR / 动态插入区块，待与 Swiper 桥接验证 |
