use-scroll-animate 9.5.0 → 9.6.0

package/docs/ROADMAP.md

@@ -7,7 +7,7 @@
 - ✅ **v9.3** — 生成艺术 2.0：风格化着色器；新组件 背景生成器。
 - ✅ **v9.4** — 视频动效：滚动驱动视频、帧序列；新组件 视频卡片、英雄视频。
 - ✅ **v9.5** — 无障碍动效 2.0：更细的动效偏好分级；新组件 动效偏好面板。
-- **v9.6** — 性能 3.0：OffscreenCanvas、Worker 渲染；新组件 性能监视器。
+- ✅ **v9.6** — 性能 3.0：OffscreenCanvas、Worker 渲染；新组件 性能监视器。
 - **v9.7** — 设计工具集成：Figma 插件脚手架、Framer 导出。
 - **v9.8** — 原生 2.0：React Native / Flutter 组件示例。
 - **v9.9** — 10.0 预备：10.0 弃用警告、`upgrading-10.md` 与 `usa-codemod-10`。

package/docs/components.md

@@ -1256,6 +1256,22 @@ console.assert(isFlashSafe(frames, 600, Infinity));
 - `<usa-pause-all label resume-label scope>`: `paused`, `toggle()`; `usa:pause-all` { paused }.
 - Safe: `safe-fade` · `focus-glow` · `color-pulse` (`color`) · `underline-sweep`; `vestibularSafe`, `flashCount`, `isFlashSafe`, `applyMotionPreferences`, `loadMotionPreferences`.
 
+### v9.6 Performance 3.0: `<usa-perf-monitor>`, `<usa-worker-canvas>` + perf pack (`motionary/fx/perf`)
+
+```html
+<usa-perf-monitor corner="bottom-right"></usa-perf-monitor>
+<usa-worker-canvas scene="starfield" style="height:240px"></usa-worker-canvas>
+```
+```js
+import { offscreenRender, runInWorker, fpsMeter } from 'motionary/fx/perf';
+const r = offscreenRender(canvas, (ctx, t, w, h) => { ctx.clearRect(0, 0, w, h); ctx.fillRect((t / 5) % w, h / 2, 8, 8); });
+console.log(r.backend); // 'worker' when OffscreenCanvas is available
+const primes = await runInWorker((n) => { /* heavy */ return n * 2; }, 21);
+```
+- `<usa-perf-monitor corner collapsed warn>`: `stats`; `usa:jank` { fps }.
+- `<usa-worker-canvas scene label>`: `program`, `backend`; `usa:backend`.
+- Perf: `offscreenRender`, `runInWorker`, `fpsMeter`; effects `idle-reveal` (`timeout`), `gpu-lift` (`lift`).
+
 ## 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": "9.5.0",
+  "version": "9.6.0",
   "description": "Compatibility alias of motionary (same build). The project was renamed to Motionary — install `motionary` instead. Motionary (formerly use-scroll-animate): dependency-free scroll animations + 94 animated Web Components — 214 scroll-reveal presets, card/click/button morphs, physics, page transitions, generative & sound-reactive backgrounds, cursor/gesture effects, themes, micro-interactions, <usa-player>, WebGL. React, Vue, Svelte, Solid, Angular or plain HTML.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -438,6 +438,16 @@
         "default": "./dist/components/fx-safe.cjs"
       }
     },
+    "./fx/perf": {
+      "import": {
+        "types": "./dist/components/fx-perf.d.ts",
+        "default": "./dist/components/fx-perf.js"
+      },
+      "require": {
+        "types": "./dist/components/fx-perf.d.cts",
+        "default": "./dist/components/fx-perf.cjs"
+      }
+    },
     "./components/reveal": {
       "import": {
         "types": "./dist/components/reveal.d.ts",
@@ -1098,6 +1108,16 @@
         "default": "./dist/components/fx-safe.cjs"
       }
     },
+    "./components/fx-perf": {
+      "import": {
+        "types": "./dist/components/fx-perf.d.ts",
+        "default": "./dist/components/fx-perf.js"
+      },
+      "require": {
+        "types": "./dist/components/fx-perf.d.cts",
+        "default": "./dist/components/fx-perf.cjs"
+      }
+    },
     "./components/lite": {
       "import": {
         "types": "./dist/components/lite.d.ts",