cos-design 3.6.0 → 3.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [3.7.0] - 2026-07-30
9
+
10
+ ### Added
11
+
12
+ - 文字动效新增 7 个零依赖组件:ShinyText、BlurText、CircularText、TrueFocus、FuzzyText、CurvedLoop、RotatingText
13
+ - 背景动效 Playground 支持可开关的「示例文案」叠加层(中文 Demo Content)
14
+
15
+ ### Changed
16
+
17
+ - BubbleField:移除底部提示文案,避免遮挡预览与示例文案开关
18
+ - 文字动效目录更新为 18 个组件;组件总数 71
19
+ - @cos-design/shiny-text: 新增 3.7.0
20
+ - @cos-design/blur-text: 新增 3.7.0
21
+ - @cos-design/circular-text: 新增 3.7.0
22
+ - @cos-design/true-focus: 新增 3.7.0
23
+ - @cos-design/fuzzy-text: 新增 3.7.0
24
+ - @cos-design/curved-loop: 新增 3.7.0
25
+ - @cos-design/rotating-text: 新增 3.7.0
26
+ - @cos-design/bubble-field: 3.6.0 → 3.7.0
27
+ - cos-design: 聚合包更新至 3.7.0
28
+
8
29
  ## [3.6.0] - 2026-07-27
9
30
 
10
31
  ### Changed
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # cos-design
4
4
 
5
- **56 个 React 视觉特效组件 · 活动页 / 品牌页 / 创意展示开箱即用**
5
+ **71 个 React 视觉特效组件 · 活动页 / 品牌页 / 创意展示开箱即用**
6
6
 
7
7
  [![CI](https://github.com/jiaxiantao/cos-design/actions/workflows/ci.yml/badge.svg)](https://github.com/jiaxiantao/cos-design/actions/workflows/ci.yml)
8
8
  [![npm version](https://img.shields.io/npm/v/cos-design.svg)](https://www.npmjs.com/package/cos-design)
@@ -18,18 +18,18 @@
18
18
 
19
19
  ## 这是什么?
20
20
 
21
- **cos-design** 是一个面向**视觉表达**的 React 组件库——不是 Ant Design 的替代品,而是给页面加氛围、加趣味、加记忆点的「特效层」。
21
+ **cos-design** 是一个面向**视觉表达**的 React 组件库——专注特效与氛围,给页面加趣味、加记忆点的「特效层」。
22
22
 
23
23
  适合用在:
24
24
 
25
- | 场景 | 你可以用它做什么 |
26
- | ------------ | ---------------------------------- |
27
- | 营销活动页 | 转盘抽奖、刮刮乐、红包雨、烟花庆祝 |
28
- | 品牌 Landing | 极光背景、霓虹标题、全息卡片 |
29
- | 数据大屏 | 翻牌器、仪表盘、液体进度环 |
30
- | 创意作品集 | 牛顿摆、DNA 螺旋、迷宫生成 |
25
+ | 场景 | 你可以用它做什么 |
26
+ | ------------ | --------------------------------------- |
27
+ | 营销活动页 | 转盘抽奖、刮刮乐、红包雨、烟花庆祝 |
28
+ | 品牌 Landing | 极光 / 深海气泡背景、霓虹标题、全息卡片 |
29
+ | 数据大屏 | 翻牌器、数字递增、仪表盘、关系网络图 |
30
+ | 创意作品集 | 牛顿摆、DNA 螺旋、迷宫生成、生命游戏 |
31
31
 
32
- > 15 个组件太单薄,56 个刚好组成一套完整的「视觉工具箱」。
32
+ > 从背景到物理、从文字到营销,71 个组件刚好组成一套完整的「视觉工具箱」。
33
33
 
34
34
  ---
35
35
 
@@ -84,22 +84,23 @@ export default function Page() {
84
84
 
85
85
  ---
86
86
 
87
- ## 组件一览(56 个 · 6 大分类)
87
+ ## 组件一览(71 个 · 8 大分类)
88
88
 
89
89
  <details open>
90
- <summary><strong>背景动效</strong> — 10 个 · 动态场景与粒子背景</summary>
90
+ <summary><strong>背景动效</strong> — 11 个 · 动态场景与粒子背景</summary>
91
91
 
92
92
  <br>
93
93
 
94
94
  | 组件 | 说明 |
95
95
  | ------------------- | ---------------------------------------------- |
96
96
  | `WeatherBackground` | 天气背景(15 种场景 · Open-Meteo 实况 · 日夜) |
97
- | `SmokeFog` | 烟雾雾气飘动 |
97
+ | `RippleWater` | WebGL 水面涟漪 |
98
+ | `SmokeFog` | 烟雾雾气飘动(支持点击驱散) |
99
+ | `BubbleField` | 深海气泡上升 · 自动融合 · 鼠标扰动水流 |
98
100
  | `MatrixRain` | 黑客帝国数字雨 |
99
101
  | `MeteorRain` | 流星雨穿越 |
100
102
  | `ParticleNetwork` | 粒子连线网络(支持触摸) |
101
103
  | `Aurora` | 极光渐变光带 |
102
- | `RippleWater` | 点击水波纹 |
103
104
  | `CyberGrid` | 赛博透视地面 |
104
105
  | `Snowfall` | 雪花 / 樱花飘落 |
105
106
  | `Starfield` | 3D 纵深星空 |
@@ -107,21 +108,30 @@ export default function Page() {
107
108
  </details>
108
109
 
109
110
  <details>
110
- <summary><strong>文字动效</strong> — 9 个 · 标题与 Banner 动画</summary>
111
+ <summary><strong>文字动效</strong> — 18 个 · 标题与 Banner 动画</summary>
111
112
 
112
113
  <br>
113
114
 
114
- | 组件 | 说明 |
115
- | -------------- | ------------ |
116
- | `Typewriter` | 终端打字机 |
117
- | `NeonText` | 霓虹发光字 |
118
- | `GlitchText` | 故障风闪烁 |
119
- | `ScrambleText` | 乱码解密文字 |
120
- | `SplitReveal` | 字母分裂入场 |
121
- | `WaveText` | 正弦波浪文字 |
122
- | `GradientFlow` | 流光渐变字 |
123
- | `BurnAway` | 燃烧消失 |
124
- | `BarcodeScan` | 扫描线覆盖 |
115
+ | 组件 | 说明 |
116
+ | -------------- | ------------------------- |
117
+ | `Typewriter` | 终端打字机 |
118
+ | `NeonText` | 霓虹发光字 |
119
+ | `GlitchText` | 故障风闪烁 |
120
+ | `ScrambleText` | 乱码解密文字 |
121
+ | `SplitReveal` | 字母分裂入场 |
122
+ | `WaveText` | 正弦波浪文字 |
123
+ | `GradientFlow` | 流光渐变字 |
124
+ | `BurnAway` | 燃烧消失 |
125
+ | `BarcodeScan` | 扫描线覆盖 |
126
+ | `TextMorph` | 文案柔和形变过渡 |
127
+ | `SplitText` | 拆字入场(fadeUp 等模式) |
128
+ | `ShinyText` | 金属扫光文字 |
129
+ | `BlurText` | 模糊到清晰入场 |
130
+ | `CircularText` | 环形旋转文字 |
131
+ | `TrueFocus` | 词级焦点聚焦 |
132
+ | `FuzzyText` | Canvas 抖动模糊字 |
133
+ | `CurvedLoop` | 曲线跑马灯 |
134
+ | `RotatingText` | 多文案字符翻转轮播 |
125
135
 
126
136
  </details>
127
137
 
@@ -162,43 +172,68 @@ export default function Page() {
162
172
  </details>
163
173
 
164
174
  <details>
165
- <summary><strong>数据装饰</strong> — 8 个 · 大屏与时间展示</summary>
175
+ <summary><strong>数据装饰</strong> — 10 个 · 大屏与时间展示</summary>
176
+
177
+ <br>
178
+
179
+ | 组件 | 说明 |
180
+ | ----------------- | --------------------------------------- |
181
+ | `CanvasClock` | Canvas 模拟时钟 |
182
+ | `FlipCounter` | 机械翻牌数字 |
183
+ | `Countdown` | 活动倒计时 |
184
+ | `CountUp` | 数字递增动画 |
185
+ | `LiquidProgress` | 液体进度环 |
186
+ | `AudioVisualizer` | 音频可视化 |
187
+ | `Speedometer` | 速度仪表盘 |
188
+ | `TimelinePulse` | 时间轴脉冲 |
189
+ | `OrbitalChart` | 轨道占比图 |
190
+ | `NetworkGraph` | 力导向关系网络图(拖拽 · 悬停高亮邻接) |
191
+
192
+ </details>
193
+
194
+ <details>
195
+ <summary><strong>物理模拟</strong> — 7 个 · 重力、弹簧与碰撞互动</summary>
196
+
197
+ <br>
198
+
199
+ | 组件 | 说明 |
200
+ | ---------------- | ------------ |
201
+ | `NewtonCradle` | 牛顿摆 |
202
+ | `GravityBalls` | 重力球池 |
203
+ | `SandFall` | 像素沙粒下落 |
204
+ | `SpringMass` | 弹簧质点网格 |
205
+ | `DoublePendulum` | 双摆混沌轨迹 |
206
+ | `MetaballPool` | 液态融合球 |
207
+ | `RopeChain` | 绳索链条摆动 |
208
+
209
+ </details>
210
+
211
+ <details>
212
+ <summary><strong>科学算法</strong> — 5 个 · 天文、混沌与算法可视化</summary>
166
213
 
167
214
  <br>
168
215
 
169
216
  | 组件 | 说明 |
170
217
  | ----------------- | --------------- |
171
- | `CanvasClock` | Canvas 模拟时钟 |
172
- | `FlipCounter` | 机械翻牌数字 |
173
- | `Countdown` | 活动倒计时 |
174
- | `LiquidProgress` | 液体进度环 |
175
- | `AudioVisualizer` | 音频可视化 |
176
- | `Speedometer` | 速度仪表盘 |
177
- | `TimelinePulse` | 时间轴脉冲 |
178
- | `OrbitalChart` | 轨道占比图 |
218
+ | `DnaHelix` | DNA 双螺旋 |
219
+ | `SolarSystem` | 太阳系公转 |
220
+ | `LorenzAttractor` | 洛伦兹吸引子 |
221
+ | `MazeGenerator` | 迷宫生成器 |
222
+ | `GameOfLife` | Conway 生命游戏 |
179
223
 
180
224
  </details>
181
225
 
182
226
  <details>
183
- <summary><strong>物理创意</strong> — 13 个 · 物理模拟与视觉实验</summary>
227
+ <summary><strong>视觉特效</strong> — 4 个 · 烟花、电弧与传送门</summary>
184
228
 
185
229
  <br>
186
230
 
187
- | 组件 | 说明 |
188
- | ----------------- | ------------ |
189
- | `Fireworks` | 烟花燃放 |
190
- | `ReturnCity` | 回城传送特效 |
191
- | `NewtonCradle` | 牛顿摆 |
192
- | `GravityBalls` | 重力球池 |
193
- | `DnaHelix` | DNA 双螺旋 |
194
- | `ElectricArc` | 电弧闪电 |
195
- | `MazeGenerator` | 迷宫生成器 |
196
- | `DoublePendulum` | 双摆混沌轨迹 |
197
- | `PlasmaBall` | 等离子静电球 |
198
- | `MetaballPool` | 液态融合球 |
199
- | `SolarSystem` | 太阳系公转 |
200
- | `LorenzAttractor` | 洛伦兹吸引子 |
201
- | `RopeChain` | 绳索链条摆动 |
231
+ | 组件 | 说明 |
232
+ | ------------- | ------------ |
233
+ | `Fireworks` | 烟花燃放 |
234
+ | `ReturnCity` | 回城传送特效 |
235
+ | `ElectricArc` | 电弧闪电 |
236
+ | `PlasmaBall` | 等离子静电球 |
202
237
 
203
238
  </details>
204
239
 
@@ -206,7 +241,7 @@ export default function Page() {
206
241
 
207
242
  ## 特性
208
243
 
209
- - **56 个组件**,覆盖背景、文字、交互、营销、数据、物理六大场景
244
+ - **71 个组件**,覆盖背景、文字、交互、营销、数据、物理、科学、特效八大场景
210
245
  - **React 19** + **Vite 8** + **TypeScript 5** 现代技术栈
211
246
  - **ESM / CJS** 双格式,完整 `.d.ts` 类型
212
247
  - **样式自动注入**,无需 `import 'cos-design/dist/index.css'`
@@ -227,7 +262,7 @@ npm run setup # 安装依赖(绕过 corepack 问题)
227
262
  npx --yes pnpm@9 dev # 启动 Playground
228
263
  ```
229
264
 
230
- 访问 **http://localhost:4000** — 按分类浏览全部 56 个组件,右侧可查看与复制示例代码。
265
+ 访问 **http://localhost:4000** — 按分类浏览全部 71 个组件,右侧可查看与复制示例代码。
231
266
 
232
267
  ---
233
268