motionary 0.0.0-stage → 6.2.0

package/dist/components/gesture.cjs

@@ -0,0 +1,209 @@
+'use strict';
+
+var base = require('../chunks/base-BaQV-2ha.cjs');
+var spring = require('../chunks/spring-Dgx187Vh.cjs');
+var core = require('../chunks/core-zq17EeCI.cjs');
+
+var css = "usa-swipeable{display:block;touch-action:pan-y;user-select:none;-webkit-user-select:none}usa-swipeable[axis=\"y\"]{touch-action:pan-x}usa-swipeable>*{transform:translate3d(var(--usa-swipe,0px),0,0);opacity:calc(1 - var(--usa-swipe-p,0) * 0.5)}usa-swipeable[axis=\"y\"]>*{transform:translate3d(0,var(--usa-swipe,0px),0)}usa-swipeable:focus-visible{outline:2px solid currentColor;outline-offset:2px}usa-pinch-zoom{display:block;overflow:hidden;touch-action:none;position:relative}usa-pinch-zoom>*{transform:translate3d(var(--usa-zoom-x,0px),var(--usa-zoom-y,0px),0) scale(var(--usa-zoom,1));transform-origin:50% 50%}usa-pinch-zoom[data-zoomed]{cursor:grab}usa-pinch-zoom:focus-visible{outline:2px solid currentColor;outline-offset:2px}";
+
+function defineSwipeable(tag = 'usa-swipeable') {
+    return base.defineElement(tag, (Base) => class UsaSwipeable extends Base {
+        constructor() {
+            super(...arguments);
+            this._off = 0;
+        }
+        static get observedAttributes() {
+            return ['axis', 'disabled'];
+        }
+        get offset() {
+            return this._off;
+        }
+        put(v) {
+            this._off = v;
+            this.style.setProperty('--usa-swipe', `${v}px`);
+            this.style.setProperty('--usa-swipe-p', String(Math.min(1, Math.abs(v) / this.num('distance', 120))));
+        }
+        swipe(direction) {
+            if (!this.emit('swipe', { direction }))
+                return this.reset();
+            const sign = direction === 'left' || direction === 'up' ? -1 : 1;
+            const far = sign * ((this.str('axis', 'x') === 'y' ? this.offsetHeight : this.offsetWidth) + 80 || 600);
+            const done = () => {
+                this.emit('dismiss', { direction });
+                if (this.flag('dismiss'))
+                    this.remove();
+            };
+            if (this.reduced) {
+                this.put(0);
+                return done();
+            }
+            this.setAttribute('data-gone', '');
+            this._s = spring.createSpring({ spring: 'stiff', value: this._off, onUpdate: (v) => this.put(v), onRest: done });
+            this._s.set(far, sign * 1500);
+        }
+        reset() {
+            this.removeAttribute('data-gone');
+            if (this.reduced)
+                return this.put(0);
+            this._s.set(0);
+        }
+        mount() {
+            this._s = spring.createSpring({ spring: this.str('preset', 'default'), onUpdate: (v) => this.put(v) });
+            if (!this.hasAttribute('tabindex'))
+                this.tabIndex = 0;
+            const y = this.str('axis', 'x') === 'y';
+            const max = () => this.num('distance', 120);
+            this.onCleanup(core.gesture(this, {
+                onPan: ({ dx, dy, vx, vy, last }) => {
+                    if (this.flag('disabled'))
+                        return;
+                    const d = y ? dy : dx;
+                    if (!last) {
+                        this._s.stop();
+                        if (!this.reduced)
+                            this.put(Math.abs(d) > max() ? Math.sign(d) * (max() + (Math.abs(d) - max()) * 0.35) : d);
+                        return;
+                    }
+                    if (Math.abs(d) > max())
+                        this.swipe(y ? (d > 0 ? 'down' : 'up') : d > 0 ? 'right' : 'left');
+                    else if (!this.hasAttribute('data-gone')) {
+                        if (this.reduced)
+                            this.put(0);
+                        else
+                            this._s.set(0, y ? vy : vx);
+                    }
+                },
+                onSwipe: ({ direction }) => {
+                    if (this.flag('disabled') || this.hasAttribute('data-gone'))
+                        return;
+                    if (y === (direction === 'up' || direction === 'down'))
+                        this.swipe(direction);
+                },
+            }, { axis: y ? 'y' : 'x' }));
+            this.listen(this, 'keydown', (e) => {
+                if (this.flag('disabled'))
+                    return;
+                const map = y ? { ArrowUp: 'up', ArrowDown: 'down' } : { ArrowLeft: 'left', ArrowRight: 'right' };
+                if (e.key === 'Delete' || e.key === 'Backspace')
+                    this.swipe(y ? 'up' : 'left');
+                else if (map[e.key])
+                    this.swipe(map[e.key]);
+                else
+                    return;
+                e.preventDefault();
+            });
+        }
+        unmount() {
+            this._s?.stop();
+        }
+    }, { id: 'gesture', text: css });
+}
+
+function definePinchZoom(tag = 'usa-pinch-zoom') {
+    return base.defineElement(tag, (Base) => class UsaPinchZoom extends Base {
+        constructor() {
+            super(...arguments);
+            this._v = { k: 1, x: 0, y: 0 };
+        }
+        get scale() {
+            return this._v.k;
+        }
+        paint() {
+            const { k, x, y } = this._v;
+            this.style.setProperty('--usa-zoom', String(k));
+            this.style.setProperty('--usa-zoom-x', `${x}px`);
+            this.style.setProperty('--usa-zoom-y', `${y}px`);
+            this.toggleAttribute('data-zoomed', k > 1.01);
+        }
+        bound(k, x, y) {
+            const w = (this.clientWidth * (k - 1)) / 2;
+            const h = (this.clientHeight * (k - 1)) / 2;
+            return { x: base.clamp(x, -w, w), y: base.clamp(y, -h, h) };
+        }
+        zoomTo(scale) {
+            const k = base.clamp(scale, this.num('min', 1), this.num('max', 4));
+            const b = this.bound(k, this._v.x, this._v.y);
+            if (this.reduced) {
+                this._v = { k, ...b };
+                this.paint();
+            }
+            else {
+                this._k.set(k);
+                this._x.set(b.x);
+                this._y.set(b.y);
+            }
+            this.emit('zoom', { scale: k });
+        }
+        mount() {
+            const preset = this.str('preset', 'gentle');
+            this._k = spring.createSpring({ spring: preset, value: this._v.k, onUpdate: (v) => ((this._v.k = v), this.paint()) });
+            this._x = spring.createSpring({ spring: preset, value: this._v.x, onUpdate: (v) => ((this._v.x = v), this.paint()) });
+            this._y = spring.createSpring({ spring: preset, value: this._v.y, onUpdate: (v) => ((this._v.y = v), this.paint()) });
+            if (!this.hasAttribute('tabindex'))
+                this.tabIndex = 0;
+            let base$1 = 1;
+            let ox = 0;
+            let oy = 0;
+            this.onCleanup(core.gesture(this, {
+                onPinch: ({ scale, first, last }) => {
+                    if (first)
+                        base$1 = this._v.k;
+                    const k = base.clamp(base$1 * scale, this.num('min', 1) * 0.7, this.num('max', 4) * 1.3);
+                    if (last)
+                        return this.zoomTo(k);
+                    this._k.jump(k);
+                },
+                onPan: ({ dx, dy, vx, vy, first, last }) => {
+                    if (this._v.k <= 1.01)
+                        return;
+                    if (first)
+                        ((ox = this._v.x), (oy = this._v.y));
+                    if (!last) {
+                        this._x.jump(ox + dx);
+                        this._y.jump(oy + dy);
+                        return;
+                    }
+                    const b = this.bound(this._v.k, ox + dx + vx * 0.15, oy + dy + vy * 0.15);
+                    this._x.set(b.x, vx);
+                    this._y.set(b.y, vy);
+                },
+                onDoubleTap: () => this.zoomTo(this._v.k > 1.01 ? 1 : this.num('double-tap', 2)),
+            }));
+            this.listen(this, 'keydown', (e) => {
+                if (e.key === '+' || e.key === '=')
+                    this.zoomTo(this._v.k * 1.25);
+                else if (e.key === '-')
+                    this.zoomTo(this._v.k / 1.25);
+                else if (e.key === '0')
+                    this.zoomTo(1);
+                else
+                    return;
+                e.preventDefault();
+            });
+            this.paint();
+        }
+        unmount() {
+            [this._k, this._x, this._y].forEach((s) => s?.stop());
+        }
+    }, { id: 'gesture', text: css });
+}
+
+/**
+ * motionary/components/gesture — unified gestures (v3.2).
+ * `gesture()` recognises pan, swipe, pinch, long-press, tap and double-tap
+ * with release velocities for springs; `<usa-swipeable>` (swipe-to-dismiss)
+ * and `<usa-pinch-zoom>` are built on it.
+ */
+/** Register every component of this category under its default tag. */
+function defineGestureComponents() {
+    defineSwipeable();
+    definePinchZoom();
+}
+
+exports.gesture = core.gesture;
+exports.pinchScale = core.pinchScale;
+exports.swipeDirection = core.swipeDirection;
+exports.defineGestureComponents = defineGestureComponents;
+exports.definePinchZoom = definePinchZoom;
+exports.defineSwipeable = defineSwipeable;
+//# sourceMappingURL=gesture.cjs.map

package/dist/components/gesture.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.cjs","sources":["../../src/components/gesture/swipeable.ts","../../src/components/gesture/pinch-zoom.ts","../../src/components/gesture/index.ts"],"sourcesContent":["import { defineElement, type UsaElement } from '../base';\nimport { createSpring, type SpringValue } from '../physics/spring';\nimport { gesture, type SwipeDirection } from './core';\nimport css from './gesture.css?raw';\n\n/**\n * `<usa-swipeable>` — swipe-to-dismiss / swipe actions. The content follows\n * the finger (rubber-banded past `distance`), flies out on a swipe or a drag\n * past `distance`, otherwise springs home with the release velocity.\n *\n * Attributes: `axis` (`x` default · `y`), `distance` (px, 120), `preset`\n * (spring), `dismiss` (remove the element after flying out), `disabled`.\n * Keyboard: Delete/Backspace dismisses, ←/→ swipe. Events `usa:swipe`\n * (`{ direction }`, cancelable), `usa:dismiss`. Methods `swipe(dir)`, `reset()`.\n * Reduced motion: no follow / fly-out animation, events still fire.\n */\nexport interface UsaSwipeableElement extends UsaElement {\n  swipe(direction: SwipeDirection): void;\n  reset(): void;\n  readonly offset: number;\n}\n\nexport function defineSwipeable(tag = 'usa-swipeable'): CustomElementConstructor | undefined {\n  return defineElement(\n    tag,\n    (Base) =>\n      class UsaSwipeable extends Base {\n        static get observedAttributes(): string[] {\n          return ['axis', 'disabled'];\n        }\n        private _s!: SpringValue;\n        private _off = 0;\n\n        get offset(): number {\n          return this._off;\n        }\n\n        private put(v: number): void {\n          this._off = v;\n          this.style.setProperty('--usa-swipe', `${v}px`);\n          this.style.setProperty('--usa-swipe-p', String(Math.min(1, Math.abs(v) / this.num('distance', 120))));\n        }\n\n        swipe(direction: SwipeDirection): void {\n          if (!this.emit('swipe', { direction })) return this.reset();\n          const sign = direction === 'left' || direction === 'up' ? -1 : 1;\n          const far = sign * ((this.str('axis', 'x') === 'y' ? this.offsetHeight : this.offsetWidth) + 80 || 600);\n          const done = () => {\n            this.emit('dismiss', { direction });\n            if (this.flag('dismiss')) this.remove();\n          };\n          if (this.reduced) {\n            this.put(0);\n            return done();\n          }\n          this.setAttribute('data-gone', '');\n          this._s = createSpring({ spring: 'stiff', value: this._off, onUpdate: (v) => this.put(v), onRest: done });\n          this._s.set(far, sign * 1500);\n        }\n\n        reset(): void {\n          this.removeAttribute('data-gone');\n          if (this.reduced) return this.put(0);\n          this._s.set(0);\n        }\n\n        mount(): void {\n          this._s = createSpring({ spring: this.str('preset', 'default'), onUpdate: (v) => this.put(v) });\n          if (!this.hasAttribute('tabindex')) this.tabIndex = 0;\n          const y = this.str('axis', 'x') === 'y';\n          const max = () => this.num('distance', 120);\n          this.onCleanup(\n            gesture(this, {\n              onPan: ({ dx, dy, vx, vy, last }) => {\n                if (this.flag('disabled')) return;\n                const d = y ? dy : dx;\n                if (!last) {\n                  this._s.stop();\n                  if (!this.reduced) this.put(Math.abs(d) > max() ? Math.sign(d) * (max() + (Math.abs(d) - max()) * 0.35) : d);\n                  return;\n                }\n                if (Math.abs(d) > max()) this.swipe(y ? (d > 0 ? 'down' : 'up') : d > 0 ? 'right' : 'left');\n                else if (!this.hasAttribute('data-gone')) {\n                  if (this.reduced) this.put(0);\n                  else this._s.set(0, y ? vy : vx);\n                }\n              },\n              onSwipe: ({ direction }) => {\n                if (this.flag('disabled') || this.hasAttribute('data-gone')) return;\n                if (y === (direction === 'up' || direction === 'down')) this.swipe(direction);\n              },\n            }, { axis: y ? 'y' : 'x' })\n          );\n          this.listen(this, 'keydown', (e: KeyboardEvent) => {\n            if (this.flag('disabled')) return;\n            const map: Record<string, SwipeDirection> = y ? { ArrowUp: 'up', ArrowDown: 'down' } : { ArrowLeft: 'left', ArrowRight: 'right' };\n            if (e.key === 'Delete' || e.key === 'Backspace') this.swipe(y ? 'up' : 'left');\n            else if (map[e.key]) this.swipe(map[e.key]);\n            else return;\n            e.preventDefault();\n          });\n        }\n\n        unmount(): void {\n          this._s?.stop();\n        }\n      },\n    { id: 'gesture', text: css }\n  );\n}\n","import { defineElement, clamp, type UsaElement } from '../base';\nimport { createSpring, type SpringValue } from '../physics/spring';\nimport { gesture } from './core';\nimport css from './gesture.css?raw';\n\n/**\n * `<usa-pinch-zoom>` — pinch (two fingers or Ctrl/⌘ + wheel / trackpad\n * pinch) to zoom its content, pan while zoomed, double-tap to toggle zoom;\n * scale and position spring back inside the bounds on release.\n *\n * Attributes: `min` (1), `max` (4), `double-tap` (zoom level, 2), `preset`.\n * Keyboard: `+` / `-` / `0`. Property `scale`, method `zoomTo(scale)`.\n * Event `usa:zoom` (`{ scale }`). Reduced motion: zoom changes instantly.\n */\nexport interface UsaPinchZoomElement extends UsaElement {\n  readonly scale: number;\n  zoomTo(scale: number): void;\n}\n\nexport function definePinchZoom(tag = 'usa-pinch-zoom'): CustomElementConstructor | undefined {\n  return defineElement(\n    tag,\n    (Base) =>\n      class UsaPinchZoom extends Base {\n        private _k!: SpringValue;\n        private _x!: SpringValue;\n        private _y!: SpringValue;\n        private _v = { k: 1, x: 0, y: 0 };\n\n        get scale(): number {\n          return this._v.k;\n        }\n\n        private paint(): void {\n          const { k, x, y } = this._v;\n          this.style.setProperty('--usa-zoom', String(k));\n          this.style.setProperty('--usa-zoom-x', `${x}px`);\n          this.style.setProperty('--usa-zoom-y', `${y}px`);\n          this.toggleAttribute('data-zoomed', k > 1.01);\n        }\n\n        private bound(k: number, x: number, y: number) {\n          const w = (this.clientWidth * (k - 1)) / 2;\n          const h = (this.clientHeight * (k - 1)) / 2;\n          return { x: clamp(x, -w, w), y: clamp(y, -h, h) };\n        }\n\n        zoomTo(scale: number): void {\n          const k = clamp(scale, this.num('min', 1), this.num('max', 4));\n          const b = this.bound(k, this._v.x, this._v.y);\n          if (this.reduced) {\n            this._v = { k, ...b };\n            this.paint();\n          } else {\n            this._k.set(k);\n            this._x.set(b.x);\n            this._y.set(b.y);\n          }\n          this.emit('zoom', { scale: k });\n        }\n\n        mount(): void {\n          const preset = this.str('preset', 'gentle');\n          this._k = createSpring({ spring: preset, value: this._v.k, onUpdate: (v) => ((this._v.k = v), this.paint()) });\n          this._x = createSpring({ spring: preset, value: this._v.x, onUpdate: (v) => ((this._v.x = v), this.paint()) });\n          this._y = createSpring({ spring: preset, value: this._v.y, onUpdate: (v) => ((this._v.y = v), this.paint()) });\n          if (!this.hasAttribute('tabindex')) this.tabIndex = 0;\n          let base = 1;\n          let ox = 0;\n          let oy = 0;\n          this.onCleanup(\n            gesture(this, {\n              onPinch: ({ scale, first, last }) => {\n                if (first) base = this._v.k;\n                const k = clamp(base * scale, this.num('min', 1) * 0.7, this.num('max', 4) * 1.3);\n                if (last) return this.zoomTo(k);\n                this._k.jump(k);\n              },\n              onPan: ({ dx, dy, vx, vy, first, last }) => {\n                if (this._v.k <= 1.01) return;\n                if (first) ((ox = this._v.x), (oy = this._v.y));\n                if (!last) {\n                  this._x.jump(ox + dx);\n                  this._y.jump(oy + dy);\n                  return;\n                }\n                const b = this.bound(this._v.k, ox + dx + vx * 0.15, oy + dy + vy * 0.15);\n                this._x.set(b.x, vx);\n                this._y.set(b.y, vy);\n              },\n              onDoubleTap: () => this.zoomTo(this._v.k > 1.01 ? 1 : this.num('double-tap', 2)),\n            })\n          );\n          this.listen(this, 'keydown', (e: KeyboardEvent) => {\n            if (e.key === '+' || e.key === '=') this.zoomTo(this._v.k * 1.25);\n            else if (e.key === '-') this.zoomTo(this._v.k / 1.25);\n            else if (e.key === '0') this.zoomTo(1);\n            else return;\n            e.preventDefault();\n          });\n          this.paint();\n        }\n\n        unmount(): void {\n          [this._k, this._x, this._y].forEach((s) => s?.stop());\n        }\n      },\n    { id: 'gesture', text: css }\n  );\n}\n","/**\n * motionary/components/gesture — unified gestures (v3.2).\n * `gesture()` recognises pan, swipe, pinch, long-press, tap and double-tap\n * with release velocities for springs; `<usa-swipeable>` (swipe-to-dismiss)\n * and `<usa-pinch-zoom>` are built on it.\n */\nimport { defineSwipeable, type UsaSwipeableElement } from './swipeable';\nimport { definePinchZoom, type UsaPinchZoomElement } from './pinch-zoom';\n\nexport { defineSwipeable, definePinchZoom };\nexport { gesture, swipeDirection, pinchScale } from './core';\nexport type { GestureHandlers, GestureOptions, PanState, SwipeState, SwipeDirection, PinchState, PressState } from './core';\nexport type { UsaSwipeableElement, UsaPinchZoomElement };\n\n/** Register every component of this category under its default tag. */\nexport function defineGestureComponents(): void {\n  defineSwipeable();\n  definePinchZoom();\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'usa-swipeable': UsaSwipeableElement;\n    'usa-pinch-zoom': UsaPinchZoomElement;\n  }\n}\n"],"names":["defineElement","createSpring","gesture","clamp","base"],"mappings":"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"}

package/dist/components/gesture.css

@@ -0,0 +1,3 @@
+/* motionary/components/gesture */
+.usa-sr{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;border:0}
+usa-swipeable{display:block;touch-action:pan-y;user-select:none;-webkit-user-select:none}usa-swipeable[axis="y"]{touch-action:pan-x}usa-swipeable>*{transform:translate3d(var(--usa-swipe,0px),0,0);opacity:calc(1 - var(--usa-swipe-p,0) * 0.5)}usa-swipeable[axis="y"]>*{transform:translate3d(0,var(--usa-swipe,0px),0)}usa-swipeable:focus-visible{outline:2px solid currentColor;outline-offset:2px}usa-pinch-zoom{display:block;overflow:hidden;touch-action:none;position:relative}usa-pinch-zoom>*{transform:translate3d(var(--usa-zoom-x,0px),var(--usa-zoom-y,0px),0) scale(var(--usa-zoom,1));transform-origin:50% 50%}usa-pinch-zoom[data-zoomed]{cursor:grab}usa-pinch-zoom:focus-visible{outline:2px solid currentColor;outline-offset:2px}

package/dist/components/gesture.d.cts

@@ -0,0 +1,134 @@
+/**
+ * Members shared by every `<usa-*>` element. Attribute helpers, a cleanup
+ * bag that is emptied on disconnect, and motion helpers that degrade to the
+ * final state without WAAPI or under reduced motion.
+ */
+interface UsaElement extends HTMLElement {
+    /** `true` while reduced motion applies to this element. */
+    readonly reduced: boolean;
+}
+
+interface PanState {
+    /** Offset from the gesture start (px). */
+    dx: number;
+    dy: number;
+    /** Velocity (px/s). */
+    vx: number;
+    vy: number;
+    first: boolean;
+    last: boolean;
+    event: Event;
+}
+type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+interface SwipeState {
+    direction: SwipeDirection;
+    velocity: number;
+    dx: number;
+    dy: number;
+}
+interface PinchState {
+    scale: number; /** Midpoint of the two pointers (client px). */
+    x: number;
+    y: number;
+    first: boolean;
+    last: boolean;
+}
+interface PressState {
+    x: number;
+    y: number;
+}
+interface GestureHandlers {
+    onPan?: (s: PanState) => void;
+    onSwipe?: (s: SwipeState) => void;
+    onPinch?: (s: PinchState) => void;
+    onLongPress?: (s: PressState) => void;
+    onTap?: (s: PressState) => void;
+    onDoubleTap?: (s: PressState) => void;
+}
+interface GestureOptions {
+    /** Restrict panning to an axis. */
+    axis?: 'x' | 'y';
+    /** Movement (px) before a pan starts (default 4). */
+    threshold?: number;
+    /** Minimum distance (px, default 40) and speed (px/s, default 300) for a swipe. */
+    swipeDistance?: number;
+    swipeVelocity?: number;
+    /** Long-press delay (ms, default 500). */
+    longPress?: number;
+    /** Ctrl/⌘ + wheel (trackpad pinch) counts as pinch (default true). */
+    wheelPinch?: boolean;
+}
+/** The swipe a pointer release represents, or `null` (pure). */
+declare function swipeDirection(dx: number, dy: number, vx: number, vy: number, o?: {
+    distance?: number;
+    velocity?: number;
+    axis?: 'x' | 'y';
+}): SwipeState | null;
+/** Scale between two pointer distances, clamped to [min, max] (pure). */
+declare function pinchScale(startDistance: number, distance: number, base?: number, min?: number, max?: number): number;
+/**
+ * One recognizer for pan, swipe, pinch (two pointers or Ctrl + wheel),
+ * long-press, tap and double-tap, with velocities ready to hand to a spring
+ * (`createSpring().set(target, velocity)`). Works with mouse, touch and pen
+ * through Pointer Events. Returns a cleanup function.
+ *
+ * @example
+ * const x = createSpring({ onUpdate: (v) => (card.style.translate = `${v}px`) });
+ * gesture(card, {
+ *   onPan: ({ dx, last, vx }) => (last ? x.set(0, vx) : x.jump(dx)),
+ *   onSwipe: ({ direction }) => dismiss(direction),
+ * }, { axis: 'x' });
+ */
+declare function gesture(el: HTMLElement, h: GestureHandlers, o?: GestureOptions): () => void;
+
+/**
+ * `<usa-swipeable>` — swipe-to-dismiss / swipe actions. The content follows
+ * the finger (rubber-banded past `distance`), flies out on a swipe or a drag
+ * past `distance`, otherwise springs home with the release velocity.
+ *
+ * Attributes: `axis` (`x` default · `y`), `distance` (px, 120), `preset`
+ * (spring), `dismiss` (remove the element after flying out), `disabled`.
+ * Keyboard: Delete/Backspace dismisses, ←/→ swipe. Events `usa:swipe`
+ * (`{ direction }`, cancelable), `usa:dismiss`. Methods `swipe(dir)`, `reset()`.
+ * Reduced motion: no follow / fly-out animation, events still fire.
+ */
+interface UsaSwipeableElement extends UsaElement {
+    swipe(direction: SwipeDirection): void;
+    reset(): void;
+    readonly offset: number;
+}
+declare function defineSwipeable(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-pinch-zoom>` — pinch (two fingers or Ctrl/⌘ + wheel / trackpad
+ * pinch) to zoom its content, pan while zoomed, double-tap to toggle zoom;
+ * scale and position spring back inside the bounds on release.
+ *
+ * Attributes: `min` (1), `max` (4), `double-tap` (zoom level, 2), `preset`.
+ * Keyboard: `+` / `-` / `0`. Property `scale`, method `zoomTo(scale)`.
+ * Event `usa:zoom` (`{ scale }`). Reduced motion: zoom changes instantly.
+ */
+interface UsaPinchZoomElement extends UsaElement {
+    readonly scale: number;
+    zoomTo(scale: number): void;
+}
+declare function definePinchZoom(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * motionary/components/gesture — unified gestures (v3.2).
+ * `gesture()` recognises pan, swipe, pinch, long-press, tap and double-tap
+ * with release velocities for springs; `<usa-swipeable>` (swipe-to-dismiss)
+ * and `<usa-pinch-zoom>` are built on it.
+ */
+
+/** Register every component of this category under its default tag. */
+declare function defineGestureComponents(): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'usa-swipeable': UsaSwipeableElement;
+        'usa-pinch-zoom': UsaPinchZoomElement;
+    }
+}
+
+export { defineGestureComponents, definePinchZoom, defineSwipeable, gesture, pinchScale, swipeDirection };
+export type { GestureHandlers, GestureOptions, PanState, PinchState, PressState, SwipeDirection, SwipeState, UsaPinchZoomElement, UsaSwipeableElement };

package/dist/components/gesture.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Members shared by every `<usa-*>` element. Attribute helpers, a cleanup
+ * bag that is emptied on disconnect, and motion helpers that degrade to the
+ * final state without WAAPI or under reduced motion.
+ */
+interface UsaElement extends HTMLElement {
+    /** `true` while reduced motion applies to this element. */
+    readonly reduced: boolean;
+}
+
+interface PanState {
+    /** Offset from the gesture start (px). */
+    dx: number;
+    dy: number;
+    /** Velocity (px/s). */
+    vx: number;
+    vy: number;
+    first: boolean;
+    last: boolean;
+    event: Event;
+}
+type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+interface SwipeState {
+    direction: SwipeDirection;
+    velocity: number;
+    dx: number;
+    dy: number;
+}
+interface PinchState {
+    scale: number; /** Midpoint of the two pointers (client px). */
+    x: number;
+    y: number;
+    first: boolean;
+    last: boolean;
+}
+interface PressState {
+    x: number;
+    y: number;
+}
+interface GestureHandlers {
+    onPan?: (s: PanState) => void;
+    onSwipe?: (s: SwipeState) => void;
+    onPinch?: (s: PinchState) => void;
+    onLongPress?: (s: PressState) => void;
+    onTap?: (s: PressState) => void;
+    onDoubleTap?: (s: PressState) => void;
+}
+interface GestureOptions {
+    /** Restrict panning to an axis. */
+    axis?: 'x' | 'y';
+    /** Movement (px) before a pan starts (default 4). */
+    threshold?: number;
+    /** Minimum distance (px, default 40) and speed (px/s, default 300) for a swipe. */
+    swipeDistance?: number;
+    swipeVelocity?: number;
+    /** Long-press delay (ms, default 500). */
+    longPress?: number;
+    /** Ctrl/⌘ + wheel (trackpad pinch) counts as pinch (default true). */
+    wheelPinch?: boolean;
+}
+/** The swipe a pointer release represents, or `null` (pure). */
+declare function swipeDirection(dx: number, dy: number, vx: number, vy: number, o?: {
+    distance?: number;
+    velocity?: number;
+    axis?: 'x' | 'y';
+}): SwipeState | null;
+/** Scale between two pointer distances, clamped to [min, max] (pure). */
+declare function pinchScale(startDistance: number, distance: number, base?: number, min?: number, max?: number): number;
+/**
+ * One recognizer for pan, swipe, pinch (two pointers or Ctrl + wheel),
+ * long-press, tap and double-tap, with velocities ready to hand to a spring
+ * (`createSpring().set(target, velocity)`). Works with mouse, touch and pen
+ * through Pointer Events. Returns a cleanup function.
+ *
+ * @example
+ * const x = createSpring({ onUpdate: (v) => (card.style.translate = `${v}px`) });
+ * gesture(card, {
+ *   onPan: ({ dx, last, vx }) => (last ? x.set(0, vx) : x.jump(dx)),
+ *   onSwipe: ({ direction }) => dismiss(direction),
+ * }, { axis: 'x' });
+ */
+declare function gesture(el: HTMLElement, h: GestureHandlers, o?: GestureOptions): () => void;
+
+/**
+ * `<usa-swipeable>` — swipe-to-dismiss / swipe actions. The content follows
+ * the finger (rubber-banded past `distance`), flies out on a swipe or a drag
+ * past `distance`, otherwise springs home with the release velocity.
+ *
+ * Attributes: `axis` (`x` default · `y`), `distance` (px, 120), `preset`
+ * (spring), `dismiss` (remove the element after flying out), `disabled`.
+ * Keyboard: Delete/Backspace dismisses, ←/→ swipe. Events `usa:swipe`
+ * (`{ direction }`, cancelable), `usa:dismiss`. Methods `swipe(dir)`, `reset()`.
+ * Reduced motion: no follow / fly-out animation, events still fire.
+ */
+interface UsaSwipeableElement extends UsaElement {
+    swipe(direction: SwipeDirection): void;
+    reset(): void;
+    readonly offset: number;
+}
+declare function defineSwipeable(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-pinch-zoom>` — pinch (two fingers or Ctrl/⌘ + wheel / trackpad
+ * pinch) to zoom its content, pan while zoomed, double-tap to toggle zoom;
+ * scale and position spring back inside the bounds on release.
+ *
+ * Attributes: `min` (1), `max` (4), `double-tap` (zoom level, 2), `preset`.
+ * Keyboard: `+` / `-` / `0`. Property `scale`, method `zoomTo(scale)`.
+ * Event `usa:zoom` (`{ scale }`). Reduced motion: zoom changes instantly.
+ */
+interface UsaPinchZoomElement extends UsaElement {
+    readonly scale: number;
+    zoomTo(scale: number): void;
+}
+declare function definePinchZoom(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * motionary/components/gesture — unified gestures (v3.2).
+ * `gesture()` recognises pan, swipe, pinch, long-press, tap and double-tap
+ * with release velocities for springs; `<usa-swipeable>` (swipe-to-dismiss)
+ * and `<usa-pinch-zoom>` are built on it.
+ */
+
+/** Register every component of this category under its default tag. */
+declare function defineGestureComponents(): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'usa-swipeable': UsaSwipeableElement;
+        'usa-pinch-zoom': UsaPinchZoomElement;
+    }
+}
+
+export { defineGestureComponents, definePinchZoom, defineSwipeable, gesture, pinchScale, swipeDirection };
+export type { GestureHandlers, GestureOptions, PanState, PinchState, PressState, SwipeDirection, SwipeState, UsaPinchZoomElement, UsaSwipeableElement };