@excom/gesture-handler 0.1.0

package/support/custom-elements.json

@@ -0,0 +1,989 @@
+{
+  "schemaVersion": "1.0.0",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "gesture-handler.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "GestureHandler",
+          "customElement": true,
+          "tagName": "gesture-handler",
+          "summary": "Swipe / pan / pinch / tap recognition as events + CSS variables.",
+          "description": "One gesture frame, written every frame as `--gesture-<kebab key>` on the element (`dx` → `--gesture-dx`). Everything derivable from these (`--gesture-distance`, `-angle`, `-progress-px`, `-x-ratio`, `-y-ratio`) is a CSS declaration, not a JS write.",
+          "attributes": [
+            {
+              "name": "gesture-types",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Gestures to recognize. `pan-x` / `pan-y` one axis (other stays native scroll); `pan` both; `pinch` / `rotate` need two fingers; `swipe` velocity on release; `tap` / `double-tap` / `long-press` fire events.",
+              "fieldName": "gestureTypes",
+              "default": "pan",
+              "values": [
+                "pan",
+                "pan-x",
+                "pan-y",
+                "pinch",
+                "rotate",
+                "swipe",
+                "tap",
+                "double-tap",
+                "long-press"
+              ]
+            },
+            {
+              "name": "from-ref",
+              "type": {
+                "text": "string"
+              },
+              "description": "Only start when pointerdown is inside this descendant (`:scope`-relative selector) — a drag handle, the sheet itself. Combined with `from-edge`, either qualifies.",
+              "fieldName": "fromRef",
+              "values": [
+                "<CSS Selector>"
+              ]
+            },
+            {
+              "name": "from-edge",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Only start within `edge-px` of these edges — edge swipes (back nav, pulling a closed sheet up).",
+              "fieldName": "fromEdge",
+              "values": [
+                "left",
+                "right",
+                "top",
+                "bottom"
+              ]
+            },
+            {
+              "name": "edge-px",
+              "type": {
+                "text": "number"
+              },
+              "description": "Width of `from-edge` start zone (px).",
+              "fieldName": "edgePx",
+              "default": 40
+            },
+            {
+              "name": "handoff-ref",
+              "type": {
+                "text": "string"
+              },
+              "description": "Scroll containers that hand overscroll to the gesture (`:scope`-relative selector, comma list matches several) — e.g. a sheet closed by pulling its own content down. Pointerdown inside one scrolls natively; gesture takes over only when first move runs along `progress-axis`, container is at that scroll limit, and `progress-offset` still has room that way. Additive to `from-ref` / `from-edge`.",
+              "fieldName": "handoffRef",
+              "values": [
+                "<CSS Selector>"
+              ]
+            },
+            {
+              "name": "pointer-types",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Pointer types that can start a gesture. Add `mouse` for desktop drag.",
+              "fieldName": "pointerTypes",
+              "default": "touch pen",
+              "values": [
+                "touch",
+                "pen",
+                "mouse"
+              ]
+            },
+            {
+              "name": "max-pointers",
+              "type": {
+                "text": "number"
+              },
+              "description": "Extra pointers beyond this many are ignored. Unset = `2` when `pinch` / `rotate` listed, else `1`.",
+              "fieldName": "maxPointers"
+            },
+            {
+              "name": "threshold-px",
+              "type": {
+                "text": "number"
+              },
+              "description": "Movement (px) before a pan is recognized. Taps / native scroll stay untouched below it.",
+              "fieldName": "thresholdPx",
+              "default": 8
+            },
+            {
+              "name": "lock-axis",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "A free `pan` locks to its dominant axis once recognized (`gesture-type` becomes `pan-x` / `pan-y`).",
+              "fieldName": "lockAxis"
+            },
+            {
+              "name": "arm-after",
+              "type": {
+                "text": "string"
+              },
+              "description": "Pans only arm after this gesture — `long-press` for hold-then-drag.",
+              "fieldName": "armAfter",
+              "values": [
+                "long-press"
+              ]
+            },
+            {
+              "name": "long-press-ms",
+              "type": {
+                "text": "number"
+              },
+              "description": "Hold time (ms) for `long-press`; also tap time limit.",
+              "fieldName": "longPressMs",
+              "default": 500
+            },
+            {
+              "name": "double-tap-ms",
+              "type": {
+                "text": "number"
+              },
+              "description": "Max gap (ms) between taps for `double-tap`.",
+              "fieldName": "doubleTapMs",
+              "default": 300
+            },
+            {
+              "name": "swipe-min-velocity",
+              "type": {
+                "text": "number"
+              },
+              "description": "Release velocity (px/ms) that counts as a swipe.",
+              "fieldName": "swipeMinVelocity",
+              "default": 0.5
+            },
+            {
+              "name": "swipe-directions",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Swipe directions to report. Unset = all four.",
+              "fieldName": "swipeDirections",
+              "values": [
+                "left",
+                "right",
+                "up",
+                "down"
+              ]
+            },
+            {
+              "name": "progress-axis",
+              "type": {
+                "text": "string"
+              },
+              "description": "Direction `--gesture-progress` grows. Unset = `down` for a `pan-y`-only element, else `right`.",
+              "fieldName": "progressAxis",
+              "values": [
+                "up",
+                "down",
+                "left",
+                "right"
+              ]
+            },
+            {
+              "name": "range-ref",
+              "type": {
+                "text": "string"
+              },
+              "description": "Element whose size along `progress-axis` is the range of `progress` `0`..`1` (`:scope`-relative, read once per gesture) — sheet being dragged, slide being swiped.",
+              "fieldName": "rangeRef",
+              "values": [
+                "<CSS Selector>"
+              ]
+            },
+            {
+              "name": "range-px",
+              "type": {
+                "text": "number"
+              },
+              "description": "Literal range (px) instead of `range-ref`.",
+              "fieldName": "rangePx"
+            },
+            {
+              "name": "progress-min",
+              "type": {
+                "text": "number"
+              },
+              "description": "Lower bound of `progress`.",
+              "fieldName": "progressMin",
+              "default": 0
+            },
+            {
+              "name": "progress-max",
+              "type": {
+                "text": "number"
+              },
+              "description": "Upper bound of `progress`.",
+              "fieldName": "progressMax",
+              "default": 1
+            },
+            {
+              "name": "progress-offset",
+              "type": {
+                "text": "number"
+              },
+              "description": "Progress the gesture starts from. Set from a rule that reads the driven element's state (`1` while a sheet is open) so dragging it closed starts full.",
+              "fieldName": "progressOffset",
+              "default": 0
+            },
+            {
+              "name": "overshoot-resistance",
+              "type": {
+                "text": "number"
+              },
+              "description": "Rubber-band past `progress-min` / `progress-max`: `0` clamps, `0.3` overshoots at a third of travel.",
+              "fieldName": "overshootResistance",
+              "default": 0
+            },
+            {
+              "name": "snap-points",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Progress values to settle on after release (`0 0.5 1`). Target picked from position, fling velocity and swipe direction, reported as `detail.snap` on `-end`, settled on by the default action (a CSS transition, `--gesture-snap-duration` / `--gesture-snap-ease`).",
+              "fieldName": "snapPoints",
+              "values": [
+                "<number>…"
+              ]
+            },
+            {
+              "name": "should-emit-move",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Fire `gesture-handler-move` every frame. Off by default; `--gesture-*` is enough for CSS.",
+              "fieldName": "shouldEmitMove"
+            },
+            {
+              "name": "is-disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Ignore new pointers; a gesture in progress is cancelled. State-driven veto.",
+              "fieldName": "isDisabled"
+            },
+            {
+              "name": "is-active",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "A pointer is down on the surface. Set from first pointer until release, so it also covers taps and pre-threshold phase.",
+              "fieldName": "isActive"
+            },
+            {
+              "name": "gesture-type",
+              "type": {
+                "text": "string"
+              },
+              "description": "Recognized gesture in progress, unset before recognition and after release.",
+              "fieldName": "gestureType",
+              "values": [
+                "pan",
+                "pan-x",
+                "pan-y",
+                "pinch",
+                "rotate"
+              ]
+            },
+            {
+              "name": "pointer-count",
+              "type": {
+                "text": "number"
+              },
+              "description": "Pointers currently down.",
+              "fieldName": "pointerCount"
+            },
+            {
+              "name": "gesture-direction",
+              "type": {
+                "text": "string"
+              },
+              "description": "Dominant travel direction of gesture in progress.",
+              "fieldName": "gestureDirection",
+              "values": [
+                "left",
+                "right",
+                "up",
+                "down"
+              ]
+            },
+            {
+              "name": "last-gesture",
+              "type": {
+                "text": "string"
+              },
+              "description": "What last gesture turned out to be — style a \"just swiped\" state from it.",
+              "fieldName": "lastGesture",
+              "values": [
+                "pan",
+                "pan-x",
+                "pan-y",
+                "pinch",
+                "rotate",
+                "swipe-left",
+                "swipe-right",
+                "swipe-up",
+                "swipe-down",
+                "tap",
+                "double-tap",
+                "long-press"
+              ]
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "gestureTypes",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Gestures to recognize. `pan-x` / `pan-y` one axis (other stays native scroll); `pan` both; `pinch` / `rotate` need two fingers; `swipe` velocity on release; `tap` / `double-tap` / `long-press` fire events.",
+              "default": "pan",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromRef",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Only start when pointerdown is inside this descendant (`:scope`-relative selector) — a drag handle, the sheet itself. Combined with `from-edge`, either qualifies.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromEdge",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Only start within `edge-px` of these edges — edge swipes (back nav, pulling a closed sheet up).",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "edgePx",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Width of `from-edge` start zone (px).",
+              "default": 40,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handoffRef",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Scroll containers that hand overscroll to the gesture (`:scope`-relative selector, comma list matches several) — e.g. a sheet closed by pulling its own content down. Pointerdown inside one scrolls natively; gesture takes over only when first move runs along `progress-axis`, container is at that scroll limit, and `progress-offset` still has room that way. Additive to `from-ref` / `from-edge`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pointerTypes",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Pointer types that can start a gesture. Add `mouse` for desktop drag.",
+              "default": "touch pen",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "maxPointers",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Extra pointers beyond this many are ignored. Unset = `2` when `pinch` / `rotate` listed, else `1`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "thresholdPx",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Movement (px) before a pan is recognized. Taps / native scroll stay untouched below it.",
+              "default": 8,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "lockAxis",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "A free `pan` locks to its dominant axis once recognized (`gesture-type` becomes `pan-x` / `pan-y`).",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "armAfter",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Pans only arm after this gesture — `long-press` for hold-then-drag.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "longPressMs",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Hold time (ms) for `long-press`; also tap time limit.",
+              "default": 500,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "doubleTapMs",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Max gap (ms) between taps for `double-tap`.",
+              "default": 300,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "swipeMinVelocity",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Release velocity (px/ms) that counts as a swipe.",
+              "default": 0.5,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "swipeDirections",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Swipe directions to report. Unset = all four.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "progressAxis",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Direction `--gesture-progress` grows. Unset = `down` for a `pan-y`-only element, else `right`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "rangeRef",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Element whose size along `progress-axis` is the range of `progress` `0`..`1` (`:scope`-relative, read once per gesture) — sheet being dragged, slide being swiped.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "rangePx",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Literal range (px) instead of `range-ref`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "progressMin",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Lower bound of `progress`.",
+              "default": 0,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "progressMax",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Upper bound of `progress`.",
+              "default": 1,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "progressOffset",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Progress the gesture starts from. Set from a rule that reads the driven element's state (`1` while a sheet is open) so dragging it closed starts full.",
+              "default": 0,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "overshootResistance",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Rubber-band past `progress-min` / `progress-max`: `0` clamps, `0.3` overshoots at a third of travel.",
+              "default": 0,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "snapPoints",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Progress values to settle on after release (`0 0.5 1`). Target picked from position, fling velocity and swipe direction, reported as `detail.snap` on `-end`, settled on by the default action (a CSS transition, `--gesture-snap-duration` / `--gesture-snap-ease`).",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "shouldEmitMove",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Fire `gesture-handler-move` every frame. Off by default; `--gesture-*` is enough for CSS.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Ignore new pointers; a gesture in progress is cancelled. State-driven veto.",
+              "_neutron": {
+                "surface": "hybrid"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "A pointer is down on the surface. Set from first pointer until release, so it also covers taps and pre-threshold phase.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "gestureType",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Recognized gesture in progress, unset before recognition and after release.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pointerCount",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Pointers currently down.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "gestureDirection",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Dominant travel direction of gesture in progress.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "lastGesture",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "What last gesture turned out to be — style a \"just swiped\" state from it.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "provision",
+              "type": {
+                "text": "GestureHandlerProvision",
+                "expanded": "{ x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Last `-start` / `-end` / `-cancel` snapshot (`type`, travel, velocity, progress, `snap`, `swipe`, …). Not an attribute; per-frame values live in `--gesture-*`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "gesture-handler-start",
+              "description": "Gesture recognized: pan passed `threshold-px` (after `arm-after` if set), or a second finger for `pinch` / `rotate`. After `gesture-type` + `provision` set. `detail` = provision. Not cancelable — gate with `is-disabled`.",
+              "type": {
+                "text": "GestureHandlerStartEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-start\"; detail: { x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-move",
+              "description": "Once per frame while a recognized gesture moves, only with `should-emit-move`. `detail` = provision. `--gesture-*` always updates, event or not.",
+              "type": {
+                "text": "GestureHandlerMoveEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-move\"; detail: { x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-end",
+              "description": "Last pointer up after a recognized gesture. After `is-active` unset, `last-gesture` + `provision` set, and after `gesture-handler-swipe` if one was recognized. `detail.snap` = `snap-points` target from position / velocity / swipe (`null` without `snap-points`); `detail.swipe` = swipe direction. Default action: write `--gesture-progress` = `detail.snap`, which settles with a CSS transition (`--gesture-snap-duration` / `--gesture-snap-ease`), then `gesture-handler-snap`. `preventDefault()` leaves values where the finger left them. Persist until next gesture.",
+              "type": {
+                "text": "GestureHandlerEndEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-end\"; detail: { x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-snap",
+              "description": "The settle transition reached the snap point (at once when there is nothing to animate; never when a new gesture interrupts it). `detail` = `{ value, index }` into `snap-points`. Commit here when consumer CSS follows `--gesture-progress` until the end.",
+              "type": {
+                "text": "GestureHandlerSnapEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-snap\"; detail: { value: number; index: number }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-cancel",
+              "description": "Recognized gesture cut short: browser took pointer (`pointercancel`, usually native scroll), `is-disabled` set, or element left the document. `detail` = provision. No `-end`, no glide.",
+              "type": {
+                "text": "GestureHandlerCancelEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-cancel\"; detail: { x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-swipe",
+              "description": "On release, velocity along dominant axis ≥ `swipe-min-velocity` and direction allowed by `swipe-directions`. `detail` = `{ direction, velocity }` (px/ms). Direction twin fires next (`gesture-handler-swipe-left` / `-right` / `-up` / `-down`).",
+              "type": {
+                "text": "GestureHandlerSwipeEvent",
+                "expanded": "CustomEvent & { type: \"gesture-handler-swipe\" | `gesture-handler-swipe-${\"left\" | \"right\" | \"up\" | \"down\"}`; detail: { direction: \"left\" | \"right\" | \"up\" | \"down\"; velocity: number }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-tap",
+              "description": "Down and up without moving past `threshold-px`, within `long-press-ms`. `detail` = `{ x, y }` relative to the element.",
+              "type": {
+                "text": "GestureHandlerPointEvent",
+                "expanded": "CustomEvent & { type: | \"gesture-handler-tap\" | \"gesture-handler-double-tap\" | \"gesture-handler-long-press\"; detail: { x: number; y: number }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-double-tap",
+              "description": "Second tap within `double-tap-ms` of the previous (after its `gesture-handler-tap`). `detail` = `{ x, y }`. Pair consumed; a third tap starts over.",
+              "type": {
+                "text": "GestureHandlerPointEvent",
+                "expanded": "CustomEvent & { type: | \"gesture-handler-tap\" | \"gesture-handler-double-tap\" | \"gesture-handler-long-press\"; detail: { x: number; y: number }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "gesture-handler-long-press",
+              "description": "Pointer stayed down without moving for `long-press-ms`. `detail` = `{ x, y }`.",
+              "type": {
+                "text": "GestureHandlerPointEvent",
+                "expanded": "CustomEvent & { type: | \"gesture-handler-tap\" | \"gesture-handler-double-tap\" | \"gesture-handler-long-press\"; detail: { x: number; y: number }; bubbles: true; cancelable: true; composed: true }"
+              }
+            }
+          ],
+          "_neutron": {
+            "provisions": [
+              {
+                "name": "provision",
+                "type": {
+                  "text": "GestureHandlerProvision",
+                  "expanded": "{ x: number; y: number; dx: number; dy: number; vx: number; vy: number; progress: number; scale: number; rotate: number; pointers: number; } & { type: | \"pan\" | \"pan-x\" | \"pan-y\" | \"pinch\" | \"rotate\" | \"swipe\" | \"tap\" | \"double-tap\" | \"long-press\" | null; pointerType: string; distance: number; rangePx: number; durationMs: number; snap: number | null; swipe: \"left\" | \"right\" | \"up\" | \"down\" | null; }"
+                },
+                "description": "Last `-start` / `-end` / `-cancel` snapshot (`type`, travel, velocity, progress, `snap`, `swipe`, …). Not an attribute; per-frame values live in `--gesture-*`.",
+                "fieldName": "provision"
+              }
+            ],
+            "cssAliases": [
+              {
+                "name": ":--gesture-handler",
+                "selectors": [
+                  "gesture-handler",
+                  ".tag-gesture-handler"
+                ],
+                "kind": "element"
+              },
+              {
+                "name": ":--gesture-handler--is-active",
+                "selectors": [
+                  "[is-active]",
+                  "[data-active]"
+                ],
+                "kind": "state"
+              }
+            ]
+          },
+          "cssProperties": [
+            {
+              "name": "--gesture-x",
+              "description": "Pointer centroid inside the element (px), horizontal — spotlight / parallax effects. Written every frame of a gesture; this is the resting value.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-y",
+              "description": "Pointer centroid inside the element (px), vertical.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-dx",
+              "description": "Horizontal travel since the gesture started (px) — drag-to-move, swipe-to-dismiss.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-dy",
+              "description": "Vertical travel since the gesture started (px).",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-vx",
+              "description": "Horizontal velocity over the last ~100 ms (px/ms).",
+              "syntax": "<number>",
+              "default": "0"
+            },
+            {
+              "name": "--gesture-vy",
+              "description": "Vertical velocity over the last ~100 ms (px/ms).",
+              "syntax": "<number>",
+              "default": "0"
+            },
+            {
+              "name": "--gesture-progress",
+              "description": "Travel along `progress-axis` as a fraction of the range, clamped to `progress-min`..`progress-max` — the value a scrubbable sheet, carousel or slider follows. Persists after release until the next gesture.",
+              "syntax": "<number>",
+              "default": "0"
+            },
+            {
+              "name": "--gesture-range-px",
+              "description": "The measured range (`range-ref` size along the axis, or `range-px`). Written once, when the gesture starts.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-width",
+              "description": "The element's own width, measured when the gesture starts.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-height",
+              "description": "The element's own height, measured when the gesture starts.",
+              "syntax": "<length>",
+              "default": "0px"
+            },
+            {
+              "name": "--gesture-scale",
+              "description": "Two-finger pinch ratio (`1` = unchanged) — pinch-to-zoom.",
+              "syntax": "<number>",
+              "default": "1"
+            },
+            {
+              "name": "--gesture-rotate",
+              "description": "Two-finger rotation — rotate-to-adjust.",
+              "syntax": "<angle>",
+              "default": "0deg"
+            },
+            {
+              "name": "--gesture-pointers",
+              "description": "Pointers currently down.",
+              "syntax": "<integer>",
+              "default": "0"
+            },
+            {
+              "name": "--gesture-distance",
+              "description": "Length of the travel (px). Computed from `--gesture-dx` / `--gesture-dy`.",
+              "syntax": "<length>",
+              "default": "hypot(var(--gesture-dx), var(--gesture-dy))"
+            },
+            {
+              "name": "--gesture-angle",
+              "description": "Direction of the travel: `0deg` right, `90deg` down. Computed from `--gesture-dx` / `--gesture-dy`.",
+              "syntax": "<angle>",
+              "default": "atan2(var(--gesture-dy), var(--gesture-dx))"
+            },
+            {
+              "name": "--gesture-progress-px",
+              "description": "`--gesture-progress` in px. Computed from `--gesture-progress` and `--gesture-range-px`.",
+              "syntax": "<length>",
+              "default": "calc(var(--gesture-progress) * var(--gesture-range-px))"
+            },
+            {
+              "name": "--gesture-x-ratio",
+              "description": "`--gesture-x` as a 0..1 fraction of the element's width. Computed from `--gesture-x` and `--gesture-width`.",
+              "syntax": "<number>",
+              "default": "tan(atan2(var(--gesture-x), var(--gesture-width)))"
+            },
+            {
+              "name": "--gesture-y-ratio",
+              "description": "`--gesture-y` as a 0..1 fraction of the element's height. Computed from `--gesture-y` and `--gesture-height`.",
+              "syntax": "<number>",
+              "default": "tan(atan2(var(--gesture-y), var(--gesture-height)))"
+            },
+            {
+              "name": "--gesture-snap-duration",
+              "description": "How long `--gesture-progress` takes to settle on its snap point after release.",
+              "syntax": "<time>",
+              "default": "200ms"
+            },
+            {
+              "name": "--gesture-snap-ease",
+              "description": "Easing of that settle.",
+              "syntax": "<easing-function>",
+              "default": "ease-out"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "GestureHandler",
+          "declaration": {
+            "name": "GestureHandler",
+            "module": "gesture-handler.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "gesture-handler",
+          "declaration": {
+            "name": "GestureHandler",
+            "module": "gesture-handler.ts"
+          }
+        }
+      ]
+    }
+  ]
+}