use-scroll-animate 7.7.0 → 7.9.0

package/docs/ROADMAP.md

@@ -9,6 +9,6 @@
 - ✅ **v7.5** — 游戏化：成就解锁、经验条、宝箱开启、幸运转盘；新组件 排行榜、徽章墙、抽奖机。
 - ✅ **v7.6** — 地图与地理：路线绘制、旋转地球、标记脉冲、飞线；新组件 3D 地球、位置卡片。
 - ✅ **v7.7** — 表单动效：抖动校验、浮动标签、密码强度、成功勾选；新组件 动效输入框、验证码（OTP）输入、上传进度。
-- **v7.8** — AI 界面：流式文字、思考光晕、语音波形、生成骨架；新组件 对话输入框、建议标签（Chips）、语音按钮。
-- **v7.9** — 8.0 预备：8.0 弃用警告、`upgrading-8.md` 与 `usa-codemod-8`；新组件 命令面板（⌘K）、快捷键提示。
+- ✅ **v7.8** — AI 界面：流式文字、思考光晕、语音波形、生成骨架；新组件 对话输入框、建议标签（Chips）、语音按钮。
+- ✅ **v7.9** — 8.0 预备：8.0 弃用警告、`upgrading-8.md` 与 `usa-codemod-8`；新组件 命令面板（⌘K）、快捷键提示。
 - **v8.0** — 统一时间线引擎（所有组件与特效共享一个时钟）、SSR 水合动画、移除 7.9 弃用项；npm `latest`。

package/docs/components.md

@@ -895,6 +895,48 @@ row.value = 75; row.status = 'done';
 - `<usa-upload-progress name size value status message>`: `value`, `status`; `usa:done`, `usa:error`, `usa:retry`; `formatBytes(n)`.
 - Form: `field-shake` (`distance`, `color`) · `field-success` (`color`) · `label-float` (`stagger`) · `form-cascade` (`stagger`, `distance`); `shakeFrames(distance, steps)`.
 
+### v7.8 Widgets: chat composer, suggestion chips, voice button (`components/widgets`) + AI UI motion (`motionary/fx/ai`)
+
+```html
+<usa-chat-composer placeholder="Ask anything…"></usa-chat-composer>
+<usa-suggestion-chips items="Summarise|Translate|Explain like I'm 5" dismiss></usa-suggestion-chips>
+<usa-voice-button label="Talk to the assistant"></usa-voice-button>
+
+<usa-fx effect="stream-text" trigger="enter"><p>Here is a streamed answer…</p></usa-fx>
+<usa-fx effect="thinking-glow" trigger="loop"><div class="bubble">Thinking…</div></usa-fx>
+```
+```js
+import { defineWidgets } from 'motionary/components/widgets';
+import { registerAiPack } from 'motionary/fx/ai';
+defineWidgets(); registerAiPack();
+composer.addEventListener('usa:send', async (e) => { composer.busy = true; await ask(e.detail.text); composer.busy = false; });
+chips.addEventListener('usa:pick', (e) => composer.value = e.detail.text);
+vb.level = analyserLevel; // 0–1
+```
+- `<usa-chat-composer placeholder label rows busy value>`: `value`, `busy`, `send()`, `clear()`; `usa:send` { text } (cancelable), `usa:stop`.
+- `<usa-suggestion-chips items label dismiss>`: `items`, `setItems(list)`; `usa:pick` { text, index }; `parseChips(s)`.
+- `<usa-voice-button label bars listening>`: `listening`, `level`, `toggle(force?)`; `usa:start`, `usa:stop`; `waveBars(level, n, phase)`.
+- AI: `stream-text` (`speed`) · `thinking-glow` (`colors`) · `voice-wave` (`cycles`) · `gen-skeleton` (`hold`); `splitWords(text)`.
+
+### v7.9 Widgets: command palette, shortcut hints (`components/widgets`)
+
+```html
+<usa-command-palette placeholder="Type a command…">
+  <option value="new" data-group="File" data-keys="mod+n">New file</option>
+  <option value="theme" data-group="View" data-keys="mod+shift+l">Toggle dark theme</option>
+</usa-command-palette>
+<usa-shortcut keys="mod+k" label="Search"></usa-shortcut>
+```
+```js
+import { defineWidgets, fuzzyMatch, keyLabels } from 'motionary/components/widgets';
+defineWidgets();
+palette.addEventListener('usa:run', (e) => commands[e.detail.id]());
+palette.setCommands([{ id: 'zen', label: 'Zen mode', group: 'View', keys: 'mod+.' }]);
+```
+- `<usa-command-palette hotkey placeholder label>`: `commands`, `setCommands(list)`, `show()`, `close()`, `toggle()`, `opened`; `usa:run` { id, label }, `usa:open`, `usa:close`; `fuzzyMatch(query, text)`, `keyLabels(keys)`, `matchesKeys(event, keys)`.
+- `<usa-shortcut keys label for listen>`: `labels`, `press()`; `usa:trigger` { keys }.
+- Deprecated in 7.9 (removed in 8.0): `<usa-rating>` → `<usa-star-rating>` — see [upgrading-8.md](./upgrading-8.md) and `npx usa-codemod-8`.
+
 ## Frameworks
 
 Custom elements work in every framework. Register once (e.g. in your entry file), then use the tags.

package/docs/deprecations.md

@@ -1,5 +1,9 @@
 # Deprecations
 
+## Deprecated in 7.9, removed in 8.0
+
+See [upgrading-8.md](./upgrading-8.md) — `<usa-rating>` / `defineRating()` (use `<usa-star-rating>` / `defineStarRating()`; same `value`, `max`, `readonly`, `label`, `name`; `icon="♥"` → `icon="heart"`). Run `npx usa-codemod-8 --write src`.
+
 ## Deprecated in 6.9, removed in 7.0
 
 See [upgrading-7.md](./upgrading-7.md) — `registerFx2()` / `FX2_PACKS` (use `registerEffectPacks()` / `EFFECT_PACKS`), the 6.x pack registrars `registerGpuEffects`, `registerTextEffects3`, `registerLightEffects`, `register3dEffects`, `registerMorphEffects2`, `registerTransitionEffects2`, `registerWeatherEffects`, `registerPhysicsEffects2` (use the `register*Pack()` names), `<usa-tooltip>` (use `<usa-tip>`) and `<usa-toggle>` (use `<usa-switch>`). Run `npx usa-codemod-7 --write src`.

package/docs/upgrading-8.md

@@ -0,0 +1,34 @@
+# Upgrading to 8.0
+
+8.0 is the next major release. 7.9 **warns once in the console** for everything that 8.0 removes, and a codemod rewrites it:
+
+```sh
+npx usa-codemod-8 src            # dry run: lists every change (and what needs a manual edit)
+npx usa-codemod-8 --write src    # apply
+```
+
+## Removed in 8.0 (deprecated in 7.9)
+
+| 7.x | 8.0 | Codemod |
+|---|---|---|
+| `<usa-rating value max readonly label name>` | `<usa-star-rating …>` (6.4 — pointer-following fill, half stars, sparkle pop; form-associated since 7.9) | ✅ tags |
+| `<usa-rating icon="♥">` / `icon="★"` | `<usa-star-rating icon="heart">` / `icon="star"` | ✅ |
+| `--usa-rating-on` | `--usa-star-on` | ✅ |
+| `<usa-rating variant="…">` | (no variants — style with `--usa-star-on`, `--usa-star-off`, `--usa-star-size`) | ✅ dropped |
+| `defineRating()` | `defineStarRating()` from `motionary/components/widgets` | ⚠️ manual |
+
+`document.createElement('usa-rating')` and CSS selectors on `usa-rating` / `.usa-rating-star` are reported for a manual edit.
+
+## Coming in 8.0
+
+- **Unified timeline engine** — every component, effect and scroll animation is driven by one shared clock, so they can be paused, slowed down, scrubbed and sequenced together.
+- **SSR hydration animations** — server-rendered markup animates in on hydration without a flash of the final state.
+- `motionary` and the `use-scroll-animate` alias are both published with the npm `latest` tag.
+
+Nothing else changes: the 5.0 browser baseline, the `<usa-player>` JSON format (`use-scroll-animate/animation` v1) and every other 7.x widget / effect API stay the same.
+
+## New in 7.9 (before the break)
+
+- `<usa-command-palette>` (⌘K) and `<usa-shortcut>` keyboard hints; `<usa-star-rating>` is form-associated (`name`) and fires a native `change`.
+
+See the [CHANGELOG](../CHANGELOG.md) for the full list.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-scroll-animate",
-  "version": "7.7.0",
+  "version": "7.9.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",
@@ -268,6 +268,16 @@
         "default": "./dist/components/fx-form.cjs"
       }
     },
+    "./fx/ai": {
+      "import": {
+        "types": "./dist/components/fx-ai.d.ts",
+        "default": "./dist/components/fx-ai.js"
+      },
+      "require": {
+        "types": "./dist/components/fx-ai.d.cts",
+        "default": "./dist/components/fx-ai.cjs"
+      }
+    },
     "./components/reveal": {
       "import": {
         "types": "./dist/components/reveal.d.ts",
@@ -768,6 +778,16 @@
         "default": "./dist/components/fx-form.cjs"
       }
     },
+    "./components/fx-ai": {
+      "import": {
+        "types": "./dist/components/fx-ai.d.ts",
+        "default": "./dist/components/fx-ai.js"
+      },
+      "require": {
+        "types": "./dist/components/fx-ai.d.cts",
+        "default": "./dist/components/fx-ai.cjs"
+      }
+    },
     "./components/lite": {
       "import": {
         "types": "./dist/components/lite.d.ts",
@@ -900,6 +920,7 @@
   "bin": {
     "usa-codemod-5": "./bin/usa-codemod-5.mjs",
     "usa-codemod-6": "./bin/usa-codemod-6.mjs",
-    "usa-codemod-7": "./bin/usa-codemod-7.mjs"
+    "usa-codemod-7": "./bin/usa-codemod-7.mjs",
+    "usa-codemod-8": "./bin/usa-codemod-8.mjs"
   }
 }