use-scroll-animate 3.0.0 → 3.2.0

package/docs/components.md

@@ -231,6 +231,23 @@ Every component reads these CSS custom properties (set them on `:root`, any ance
 
 See [frameworks-ssr.md](./frameworks-ssr.md) and [accessibility.md](./accessibility.md).
 
+### v3.1 Timeline & choreography (`components/timeline`)
+
+| Element / API | What it does | Key options |
+|---|---|---|
+| `timeline(opts)` | One playhead for many animations | `.to(target, frames \| preset, { at, duration, easing, stagger })`, `.label()`, `.call()`, `play()`, `reverse()`, `seek()`, `progress()`, `scrub(el, { smooth })` |
+| `<usa-timeline>` | `data-tl` children become steps | `trigger` (`view` · `click` · `manual`), `scrub`, `overlap`, `duration`, `stagger`, `repeat`; child `data-at`, `data-duration`, `data-label` |
+
+Positions: `'>'` chain (default) · `'<'` with previous · `'-=200'` overlap · `'+=100'` gap · `'<+=50'` · `'label+=100'` · ms.
+
+### v3.2 Gestures (`components/gesture`)
+
+| Element / API | What it does | Key options |
+|---|---|---|
+| `gesture(el, handlers, opts)` | Pan · swipe · pinch · long-press · tap · double-tap | `onPan({ dx, dy, vx, vy, first, last })`, `onSwipe({ direction, velocity })`, `onPinch({ scale })`, `onLongPress`, `onTap`, `onDoubleTap`; `axis`, `threshold`, `swipeDistance`, `swipeVelocity`, `longPress`, `wheelPinch` |
+| `<usa-swipeable>` | Swipe to dismiss, spring home | `axis`, `distance` (120), `preset`, `dismiss`; `usa:swipe`, `usa:dismiss`; `swipe(dir)`, `reset()` |
+| `<usa-pinch-zoom>` | Pinch / Ctrl+wheel zoom + pan | `min` (1), `max` (4), `double-tap` (2), `preset`; `zoomTo(k)`, `usa:zoom` |
+
 ## 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": "3.0.0",
+  "version": "3.2.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",
@@ -188,6 +188,26 @@
         "default": "./dist/components/page.cjs"
       }
     },
+    "./components/timeline": {
+      "import": {
+        "types": "./dist/components/timeline.d.ts",
+        "default": "./dist/components/timeline.js"
+      },
+      "require": {
+        "types": "./dist/components/timeline.d.cts",
+        "default": "./dist/components/timeline.cjs"
+      }
+    },
+    "./components/gesture": {
+      "import": {
+        "types": "./dist/components/gesture.d.ts",
+        "default": "./dist/components/gesture.js"
+      },
+      "require": {
+        "types": "./dist/components/gesture.d.cts",
+        "default": "./dist/components/gesture.cjs"
+      }
+    },
     "./components/react": {
       "import": {
         "types": "./dist/components/react.d.ts",
@@ -240,6 +260,8 @@
     "./components/click.css": "./dist/components/click.css",
     "./components/ui.css": "./dist/components/ui.css",
     "./components/page.css": "./dist/components/page.css",
+    "./components/timeline.css": "./dist/components/timeline.css",
+    "./components/gesture.css": "./dist/components/gesture.css",
     "./package.json": "./package.json"
   },
   "files": [
@@ -260,7 +282,7 @@
     "typecheck": "tsc --noEmit -p .",
     "test": "vitest run",
     "check:exports": "node scripts/check-exports.mjs",
-    "lint:package": "publint && attw --pack . --profile node16 --exclude-entrypoints ./components.css ./components/reveal.css ./components/text.css ./components/interaction.css ./components/feedback.css ./components/background.css ./components/transitions.css ./components/physics.css ./components/cards.css ./components/click.css ./components/ui.css ./components/page.css",
+    "lint:package": "publint && attw --pack . --profile node16 --exclude-entrypoints ./components.css ./components/reveal.css ./components/text.css ./components/interaction.css ./components/feedback.css ./components/background.css ./components/transitions.css ./components/physics.css ./components/cards.css ./components/click.css ./components/ui.css ./components/page.css ./components/timeline.css ./components/gesture.css",
     "size": "node scripts/size.mjs",
     "prepublishOnly": "npm run typecheck && npm test && npm run build && npm run check:exports",
     "size:check": "node scripts/size.mjs --check",