use-scroll-animate 6.6.0 → 6.7.0

package/docs/ROADMAP.md

@@ -8,7 +8,7 @@
 - ✅ **v6.4** — 光影与材质 + 组件：动态光源、玻璃折射、金属拉丝、珠光 / 镭射、体积光、指针实时阴影；新组件 进度条 / 进度环、计数器 / 里程表、骨架屏闪光、评分星。
 - ✅ **v6.5** — 3D 场景卡片 + 组件：景深层叠卡、可旋转商品展示、立方体画廊、折纸展开、轨道相机叙事；新组件 时间轴、瀑布流（布局动画）、图片对比滑块。
 - ✅ **v6.6** — 形变与 SVG 2.0 + 组件：路径补间、液态 blob 按钮、描边绘制、SVG 滤镜转场、图标变形；新组件 Dock 栏（macOS 放大）、形变下划线导航、汉堡 → 关闭图标、提示 / 气泡。
-- **v6.7** — 转场大全 + 组件：涟漪溶解、碎片爆裂、马赛克翻牌、液体擦除、卷页、镜头推拉（View Transitions 优先，MPA 可用）；新组件 步骤条 / 向导、分页、分段控件、开关变体。
+- ✅ **v6.7** — 转场大全 + 组件：涟漪溶解、碎片爆裂、马赛克翻牌、液体擦除、卷页、镜头推拉（View Transitions 优先，MPA 可用）；新组件 步骤条 / 向导、分页、分段控件、开关变体。
 - **v6.8** — 天气与氛围 + 交互物理 2.0 + 组件：玻璃雨滴、积雪、安全闪电、雾、极光、昼夜光照；软体、布料、绳索、磁吸、弹球、重力翻转（Verlet）；新组件 看板 / 拖拽排序、滑动卡片、下拉刷新。
 - **v6.9** — 7.0 预备 + 组件：动画编辑器 2.0、效果市场清单格式、7.0 弃用警告、`upgrading-7.md` 与 `usa-codemod-7`；新组件 日期选择器、取色器、文件拖放区动画。
 - **v7.0** — 破坏性清理：移除 6.9 弃用的 API，效果包与组件按需拆分入口，WebGPU 渲染后端（WebGL2 回退），npm `latest`。

package/docs/components.md

@@ -639,6 +639,29 @@ defineWidgets(); defineFx(); registerMorphEffects2();
 - `<usa-tip text placement trigger="hover | click" delay>`: spring-out tooltip / popover with arrow, viewport flip + shift, Esc, rich `[slot="tip"]` content.
 - Morph & SVG 2.0: `path-morph` (loop) · `blob-button` (hover) · `stroke-draw` · `noise-reveal` (enter) · `icon-swap` (click); helpers `samplePath()`, `pointsToPath()`. Reduced motion: no magnification / stretch / morph loops; reveals and swaps fade.
 
+### v6.7 Widgets: stepper, pagination, segmented control, switch (`components/widgets`) + Transitions 2.0 (`components/fx-transitions`)
+
+```html
+<usa-stepper value="1"><span>Cart</span><span>Shipping</span><span>Payment</span></usa-stepper>
+<usa-pagination total="20" page="1" siblings="1"></usa-pagination>
+<usa-segmented variant="ios"><button>Day</button><button>Week</button><button>Month</button></usa-segmented>
+<usa-switch variant="daynight" name="dark" label="Dark mode"></usa-switch>
+
+<usa-fx effect="ripple-dissolve" trigger="click" options='{"mode":"in"}'><section>…</section></usa-fx>
+```
+```js
+import { defineWidgets } from 'motionary/components/widgets';
+import { registerTransitionEffects2, pageTransition, crossDocumentTransitions } from 'motionary/components/fx-transitions';
+defineWidgets(); registerTransitionEffects2();
+await pageTransition(() => renderNextView(), 'liquid-wipe');   // SPA: View Transitions API, fallback = update + effect
+crossDocumentTransitions('camera-dolly');                       // MPA: @view-transition { navigation: auto }
+```
+- `<usa-stepper value orientation clickable>`: `next()`, `prev()`, `value`; `usa:change`.
+- `<usa-pagination total page siblings>`: `page`; `usa:change` (`{ page }`); `pageWindow(page, total, siblings)`.
+- `<usa-segmented variant="ios | pill | outline" value>`: radio group; `usa:change` (`{ value, label }`).
+- `<usa-switch variant="ios | daynight | bounce | liquid" checked disabled name value>`: `checked`, `toggle()`; `usa:change`.
+- Transitions 2.0 (`mode: "in" | "out"`): `ripple-dissolve` (`x`, `y`, from the pointer on click) · `shatter` (`pieces`) · `mosaic-flip` (`cols`, `rows`) · `liquid-wipe` (`direction`, `waves`) · `page-curl` · `camera-dolly` (`scale`). Reduced motion: short fades.
+
 ## 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": "6.6.0",
+  "version": "6.7.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",
@@ -468,6 +468,16 @@
         "default": "./dist/components/fx-morph.cjs"
       }
     },
+    "./components/fx-transitions": {
+      "import": {
+        "types": "./dist/components/fx-transitions.d.ts",
+        "default": "./dist/components/fx-transitions.js"
+      },
+      "require": {
+        "types": "./dist/components/fx-transitions.d.cts",
+        "default": "./dist/components/fx-transitions.cjs"
+      }
+    },
     "./components/lite": {
       "import": {
         "types": "./dist/components/lite.d.ts",