use-scroll-animate 4.7.0 → 4.8.0

package/docs/ROADMAP.md

@@ -9,6 +9,6 @@
 - ✅ **v4.5** — 性能与体积：按需加载 CSS、共享 rAF 调度器、动画数量自动降级，组件整体 gzip 目标 ≤ 70KB。
 - ✅ **v4.6** — 实验室 2.0：时间线可视化编辑（关键帧轨道）、保存 / 分享预设，并可导出为 `<usa-timeline>` 标记。
 - ✅ **v4.7** — 原生壳集成：WinUI 3、.NET MAUI、Flutter 的官方桥接示例包，支持系统“减少动态效果”与主题自动同步。
-- **v4.8** — 3D 与 WebGL 扩展：基于 `glQuad()` 的粒子 / 后处理小型预设库，统一 WebGL 回退与电量 / 帧率自适应。
+- ✅ **v4.8** — 3D 与 WebGL 扩展：基于 `glQuad()` 的粒子 / 后处理小型预设库，统一 WebGL 回退与电量 / 帧率自适应。
 - **v4.9** — 5.0 预备：标记计划移除或重命名的 API 并输出一次性弃用警告，发布 `upgrading-5.md` 与自动迁移脚本（codemod）。
 - **v5.0** — 下一代主版本：仅支持现代浏览器（原生 View Transitions / Scroll Timeline 基线），移除 4.9 弃用的 API，统一的插件式效果注册机制。

package/docs/components.md

@@ -315,6 +315,13 @@ Hybrid / desktop hosts (MAUI, Flutter WebView, Electron, Tauri): [hybrid-apps.md
 
 **Deprecated in 3.9, removed in 4.0.0:** `sequence()`, `connectedAnimation()`, `<usa-flip-list>` — see [upgrading-4.md](./upgrading-4.md).
 
+### v4.8 GPU particles, post-processing & adaptive quality (`components/webgl`)
+
+- **Particle presets** for `<usa-shader preset="…">`: `snow`, `fireflies`, `stars` (warp starfield), `bokeh`, `rain` — procedural in the fragment shader, no buffers or per-particle JS.
+- **`<usa-post-fx>`** (`definePostFx()`), e.g. `<usa-post-fx effects="vignette grain" intensity="0.6"><img …></usa-post-fx>` — chained passes `vignette` · `grain` · `chromatic` · `scanlines` · `crt` · `bloom` · `pixelate` · `duotone` · `glitch`; `postFxShader(list)` builds the same shader for your own `glQuad()`.
+- **Unified fallback** — without WebGL every preset shows a still CSS rendering (`GL_FALLBACKS`, `glFallbackCss()`); post-fx images get an approximate CSS filter.
+- **Adaptive quality** — every GL element measures its frame rate: after two slow seconds (< 40 fps) the drawing buffer drops to 50 % then 35 % resolution and climbs back after five good seconds; on battery saver (Battery Status API ≤ 20 % and not charging, or Save-Data) it renders at ≤ 30 fps and ≤ 60 % resolution. `quality="high"` opts out; `data-quality` shows the current scale. `glGovernor()` / `watchPowerSaver()` for your own loops; `glQuad().render({ extra })` sets any float uniform, `resize(scale)` scales the buffer.
+
 ## Frameworks
 
 Custom elements work in every framework. Register once (e.g. in your entry file), then use the tags.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-scroll-animate",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "description": "A lightweight, high-performance, dependency-free scroll animation library and animated UI components (Web Components) for the web and Windows web-view apps.",
   "type": "module",
   "main": "./dist/index.cjs",