react-native-gtkx 0.2.0-alpha.2 → 0.3.0-alpha.1

package/dist/gesture-handler-compat/builder.js

@@ -0,0 +1,513 @@
+// Spelling one: `Gesture.Pan()` / `.Tap()` / `.LongPress()`, the chainable
+// builders.
+//
+// Deprecated upstream since 3.1.0 — every one of the twelve `Gesture.*`
+// statics carries an `@deprecated` tag pointing at a hook — and it is still
+// what every shipped consumer calls, which is why it is the spelling that had
+// to work first. It is a facade: each method writes one value into a
+// `RecognizerConfig` and returns `this`, and the object it builds is a
+// `GestureSpec` and nothing more.
+//
+// The class split mirrors upstream's. `BaseGestureBuilder` is its
+// `BaseGesture` — everything the three kinds share — and `onUpdate`/`onChange`
+// live on `PanGestureBuilder` alone because upstream puts them on
+// `ContinousBaseGesture`, which `TapGesture` and `LongPressGesture` do not
+// extend. A discrete gesture has no travel to report.
+//
+// The callback renames are where the two spellings genuinely differ.
+// `onStart` and `onEnd` here are `onActivate` and `onDeactivate` internally,
+// `onTouchesCancelled` is `onTouchesCancel`, and `onChange` — which the hook
+// spelling dropped — is an ordinary callback over the same payload, because
+// the payload already carries `changeX`/`changeY`.
+import { exclusiveGestures, raceGestures, simultaneousGestures, } from "./composition";
+/**
+ * Everything upstream's `BaseGesture` has, which is everything the three
+ * implemented kinds share. Not a port of it: it holds no handler tag and no
+ * worklet machinery, because on this platform there is one runtime and a
+ * handler tag identifies a MOUNTED gesture rather than a built one. The
+ * relations it does hold are lists of references and nothing else — the maps
+ * that read them live in ./relations, and the loop that acts on them in
+ * ./orchestrator.
+ *
+ * `onUpdate` and `onChange` are deliberately NOT here. Upstream puts them on
+ * `ContinousBaseGesture`, which `Tap` and `LongPress` do not extend — they are
+ * discrete, they have no travel to report, and offering the methods would
+ * invite a callback that never fires.
+ */
+class BaseGestureBuilder {
+    config = {};
+    // --- common configuration ---
+    enabled(value) {
+        this.config.enabled = value;
+        return this;
+    }
+    shouldCancelWhenOutside(value) {
+        this.config.shouldCancelWhenOutside = value;
+        return this;
+    }
+    hitSlop(value) {
+        this.config.hitSlop = value;
+        return this;
+    }
+    manualActivation(value) {
+        this.config.manualActivation = value;
+        return this;
+    }
+    // --- callbacks ---
+    onBegin(callback) {
+        this.config.onBegin = callback;
+        return this;
+    }
+    onStart(callback) {
+        this.config.onActivate = callback;
+        return this;
+    }
+    onEnd(callback) {
+        this.config.onDeactivate = callback;
+        return this;
+    }
+    onFinalize(callback) {
+        this.config.onFinalize = callback;
+        return this;
+    }
+    onTouchesDown(callback) {
+        this.config.onTouchesDown = callback;
+        return this;
+    }
+    onTouchesMove(callback) {
+        this.config.onTouchesMove = callback;
+        return this;
+    }
+    onTouchesUp(callback) {
+        this.config.onTouchesUp = callback;
+        return this;
+    }
+    onTouchesCancelled(callback) {
+        this.config.onTouchesCancel = callback;
+        return this;
+    }
+    /**
+     * Recorded and not acted on, exactly as upstream does not act on it off its
+     * worklet platforms: gesture callbacks are worklets by default there and
+     * this asks for the JS runtime instead. There is one runtime here, so every
+     * callback already runs where this is asking it to. `@gorhom/bottom-sheet`
+     * sets it twice; making it throw would refuse code that is already correct.
+     *
+     * Recorded rather than discarded so the config still describes what the app
+     * asked for — the orchestrator and any devtools read this object.
+     */
+    runOnJS(value) {
+        this.config.runOnJS = value;
+        return this;
+    }
+    /**
+     * Platform-specific upstream and inert here, which is upstream's own
+     * treatment of them off their platforms: `averageTouches` is Android-only,
+     * `enableTrackpadTwoFingerGesture` and `cancelsTouchesInView` are iOS-only,
+     * `activeCursor` and `mouseButton` are Web-only. Accepting them keeps
+     * portable source portable; docs/api.md records that they do nothing.
+     */
+    averageTouches(value) {
+        this.config.averageTouches = value;
+        return this;
+    }
+    enableTrackpadTwoFingerGesture(value) {
+        this.config.enableTrackpadTwoFingerGesture = value;
+        return this;
+    }
+    cancelsTouchesInView(value) {
+        this.config.cancelsTouchesInView = value;
+        return this;
+    }
+    activeCursor(value) {
+        this.config.activeCursor = value;
+        return this;
+    }
+    mouseButton(value) {
+        this.config.mouseButton = value;
+        return this;
+    }
+    /** Upstream stores a ref for the relation APIs; harmless to honour early. */
+    withRef(ref) {
+        ref.current = this;
+        return this;
+    }
+    withTestId(id) {
+        this.config.testId = id;
+        return this;
+    }
+    /** Upstream's flattening hook for composed gestures; a lone gesture is a list of one. */
+    toGestureArray() {
+        return [this];
+    }
+    // --- the relations ---
+    //
+    // Three methods, three lists, one place they are read: the maps in
+    // ./relations. Each of them writes a list of REFERENCES rather than tags —
+    // an app names another gesture with the gesture object it built, and the
+    // tag that identifies a mounted one does not exist until a detector mounts
+    // it. `withRef()` and a raw tag are accepted in the same position, as
+    // upstream's `GestureRef` is.
+    //
+    // Appending rather than replacing: `.simultaneousWithExternalGesture(a)`
+    // followed by `.simultaneousWithExternalGesture(b)` means both, which is
+    // what chaining reads like. The builder is rebuilt every render by every
+    // app that follows upstream's own advice, so nothing accumulates across
+    // renders — and composition computes rather than writes back here, so it
+    // cannot accumulate either.
+    simultaneousWithExternalGesture(...gestures) {
+        this.config.simultaneousHandlers = [
+            ...(this.config.simultaneousHandlers ?? []),
+            ...gestures,
+        ];
+        return this;
+    }
+    requireExternalGestureToFail(...gestures) {
+        this.config.waitFor = [...(this.config.waitFor ?? []), ...gestures];
+        return this;
+    }
+    blocksExternalGesture(...gestures) {
+        this.config.blocksHandlers = [
+            ...(this.config.blocksHandlers ?? []),
+            ...gestures,
+        ];
+        return this;
+    }
+}
+/** `Gesture.Pan()`, and the only one of the three that reports travel. */
+export class PanGestureBuilder extends BaseGestureBuilder {
+    kind = "pan";
+    // --- activation and failure bounds ---
+    activeOffsetX(offset) {
+        this.config.activeOffsetX = offset;
+        return this;
+    }
+    activeOffsetY(offset) {
+        this.config.activeOffsetY = offset;
+        return this;
+    }
+    failOffsetX(offset) {
+        this.config.failOffsetX = offset;
+        return this;
+    }
+    failOffsetY(offset) {
+        this.config.failOffsetY = offset;
+        return this;
+    }
+    minDistance(distance) {
+        this.config.minDistance = distance;
+        return this;
+    }
+    minVelocity(velocity) {
+        this.config.minVelocity = velocity;
+        return this;
+    }
+    minVelocityX(velocity) {
+        this.config.minVelocityX = velocity;
+        return this;
+    }
+    minVelocityY(velocity) {
+        this.config.minVelocityY = velocity;
+        return this;
+    }
+    minPointers(count) {
+        this.config.minPointers = count;
+        return this;
+    }
+    maxPointers(count) {
+        this.config.maxPointers = count;
+        return this;
+    }
+    activateAfterLongPress(duration) {
+        this.config.activateAfterLongPress = duration;
+        return this;
+    }
+    // --- the continuous callbacks, which only a continuous gesture has ---
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture.Tap()`.
+ *
+ * `shouldCancelWhenOutside` is on by default, set from the constructor exactly
+ * as upstream's `TapGesture` does — a press that wanders off the view is not a
+ * tap on it, and the native `TapGestureHandler` config says the same.
+ */
+export class TapGestureBuilder extends BaseGestureBuilder {
+    kind = "tap";
+    constructor() {
+        super();
+        this.shouldCancelWhenOutside(true);
+    }
+    numberOfTaps(count) {
+        this.config.numberOfTaps = count;
+        return this;
+    }
+    maxDuration(duration) {
+        this.config.maxDuration = duration;
+        return this;
+    }
+    maxDelay(delay) {
+        this.config.maxDelay = delay;
+        return this;
+    }
+    maxDistance(distance) {
+        this.config.maxDistance = distance;
+        return this;
+    }
+    maxDeltaX(delta) {
+        this.config.maxDeltaX = delta;
+        return this;
+    }
+    maxDeltaY(delta) {
+        this.config.maxDeltaY = delta;
+        return this;
+    }
+    minPointers(count) {
+        this.config.minPointers = count;
+        return this;
+    }
+}
+/** `Gesture.LongPress()`, with upstream's default of `shouldCancelWhenOutside`. */
+export class LongPressGestureBuilder extends BaseGestureBuilder {
+    kind = "longPress";
+    constructor() {
+        super();
+        this.shouldCancelWhenOutside(true);
+    }
+    minDuration(duration) {
+        this.config.minDuration = duration;
+        return this;
+    }
+    maxDistance(distance) {
+        this.config.maxDistance = distance;
+        return this;
+    }
+    numberOfPointers(count) {
+        this.config.numberOfPointers = count;
+        return this;
+    }
+}
+/**
+ * `Gesture.Native()` — the widget underneath, put into the arbitration.
+ *
+ * `shouldCancelWhenOutside` defaults to true from the constructor, which is
+ * where upstream's `NativeViewGestureHandler.init` sets it rather than its
+ * builder. See ./native for what the recognizer does and, more to the point,
+ * what it deliberately does not do: it never takes the responder, because
+ * taking it is what switches the native scroller off.
+ */
+export class NativeGestureBuilder extends BaseGestureBuilder {
+    kind = "native";
+    constructor() {
+        super();
+        this.shouldCancelWhenOutside(true);
+    }
+    shouldActivateOnStart(value) {
+        this.config.shouldActivateOnStart = value;
+        return this;
+    }
+    disallowInterruption(value) {
+        this.config.disallowInterruption = value;
+        return this;
+    }
+    yieldsToContinuousGestures(value) {
+        this.config.yieldsToContinuousGestures = value;
+        return this;
+    }
+    /**
+     * A native view is CONTINUOUS upstream (`isContinuous = true`), so it
+     * reports travel like `Pan` does and unlike `Tap`. These are here rather
+     * than on the base class for the same reason they are on
+     * `PanGestureBuilder`: upstream puts them on `ContinousBaseGesture`.
+     */
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture.Pinch()` and `Gesture.Rotation()`, which have no configuration of
+ * their own at all — verified against 3.1.0, where `PinchGesture` and
+ * `RotationGesture` add zero builder methods over `ContinousBaseGesture`, and
+ * where v3's `PinchGestureNativeProperties` is literally
+ * `Record<string, never>`. Both are CONTINUOUS, so `onUpdate`/`onChange` are
+ * here for the same reason they are on `PanGestureBuilder`.
+ *
+ * `shouldCancelWhenOutside` is off, set from the constructor because upstream
+ * sets it from `PinchGestureHandler.init`/`RotationGestureHandler.init` — a
+ * pinch whose focal point wanders off the view keeps running, unlike a tap.
+ *
+ * What they do NOT have is a pointer: see ./touchpad. Their numbers come from
+ * `GtkGestureZoom`/`GtkGestureRotate`, and everything else about them — the
+ * states, the callbacks, the arbitration — is the machine every other kind
+ * runs on.
+ */
+export class PinchGestureBuilder extends BaseGestureBuilder {
+    kind = "pinch";
+    constructor() {
+        super();
+        this.shouldCancelWhenOutside(false);
+    }
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/** `Gesture.Rotation()`. Same shape as `Pinch`, same reasons. */
+export class RotationGestureBuilder extends BaseGestureBuilder {
+    kind = "rotation";
+    constructor() {
+        super();
+        this.shouldCancelWhenOutside(false);
+    }
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture.Fling()` — a directional swipe, and the one DISCRETE gesture with a
+ * velocity criterion.
+ *
+ * No `onUpdate`/`onChange`, and that is upstream's shape rather than an
+ * omission: `FlingGesture` extends `BaseGesture` and not
+ * `ContinousBaseGesture`, because a fling activates and ends in the same
+ * breath (see ./fling) and there is never an update to report between them.
+ * Offering the methods would invite a callback that cannot fire.
+ */
+export class FlingGestureBuilder extends BaseGestureBuilder {
+    kind = "fling";
+    /** A BITMASK of `Directions`; several are one value, OR'd together. */
+    direction(direction) {
+        this.config.direction = direction;
+        return this;
+    }
+    numberOfPointers(count) {
+        this.config.numberOfPointers = count;
+        return this;
+    }
+}
+/**
+ * `Gesture.Manual()` — no configuration at all, because there is nothing to
+ * configure: the app drives the state machine through the manager handed to
+ * the `onTouches*` callbacks.
+ *
+ * Verified against 3.1.0, where `ManualGesture` adds zero builder methods over
+ * `ContinousBaseGesture` and v3's `ManualGestureProperties` is
+ * `Record<string, never>`. Continuous, so `onUpdate`/`onChange` are here.
+ */
+export class ManualGestureBuilder extends BaseGestureBuilder {
+    kind = "manual";
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture.Hover()` — the pointer being over the view, with no button down.
+ *
+ * `effect()` is upstream's one knob and it is iOS-only there; it is recorded
+ * and inert here, exactly as it is inert in upstream's own web handler, which
+ * never branches on it either. Continuous, so it reports travel.
+ */
+export class HoverGestureBuilder extends BaseGestureBuilder {
+    kind = "hover";
+    effect(effect) {
+        this.config.hoverEffect = effect;
+        return this;
+    }
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture.ForceTouch()` — pressure, and the one recognizer in this module
+ * whose input the test rig cannot fully produce. See ./force-touch, which
+ * says so at length, and docs/api.md, which says it where an app will read it.
+ *
+ * Continuous, matching upstream's `ContinousBaseGesture`.
+ */
+export class ForceTouchGestureBuilder extends BaseGestureBuilder {
+    kind = "forceTouch";
+    minForce(force) {
+        this.config.minForce = force;
+        return this;
+    }
+    maxForce(force) {
+        this.config.maxForce = force;
+        return this;
+    }
+    /** Haptics. Recorded and inert: there is no haptic device on this platform. */
+    feedbackOnActivation(value) {
+        this.config.feedbackOnActivation = value;
+        return this;
+    }
+    onUpdate(callback) {
+        this.config.onUpdate = callback;
+        return this;
+    }
+    onChange(callback) {
+        this.config.onChange = callback;
+        return this;
+    }
+}
+/**
+ * `Gesture`, the namespace of statics — all ten of them, and the three
+ * composers.
+ *
+ * Nothing here throws any more. The four that used to (`Fling`, `Hover`,
+ * `Manual`, `ForceTouch`) are the last of upstream's surface and the reasons
+ * they were refused have been re-examined one at a time rather than inherited:
+ * `Fling` and `Manual` were always reachable and merely unwritten, `Hover` was
+ * refused on a judgement about the rig that was simply wrong (a mouse hovers,
+ * and the virtual pointer moves a mouse), and `ForceTouch` is the one that
+ * needs hardware — it ships with upstream's documented semantics and an
+ * explicit note about what is unverified, rather than a refusal that says
+ * nothing.
+ */
+export const Gesture = {
+    Pan: () => new PanGestureBuilder(),
+    Tap: () => new TapGestureBuilder(),
+    LongPress: () => new LongPressGestureBuilder(),
+    Native: () => new NativeGestureBuilder(),
+    // List-builders over the same three maps the relation methods write, with
+    // no mechanism of their own — see ./composition.
+    Race: (...gestures) => raceGestures(...gestures),
+    Simultaneous: (...gestures) => simultaneousGestures(...gestures),
+    Exclusive: (...gestures) => exclusiveGestures(...gestures),
+    Pinch: () => new PinchGestureBuilder(),
+    Rotation: () => new RotationGestureBuilder(),
+    Fling: () => new FlingGestureBuilder(),
+    Hover: () => new HoverGestureBuilder(),
+    Manual: () => new ManualGestureBuilder(),
+    ForceTouch: () => new ForceTouchGestureBuilder(),
+};
+//# sourceMappingURL=builder.js.map

package/dist/gesture-handler-compat/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/gesture-handler-compat/builder.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,YAAY;AACZ,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,8EAA8E;AAC9E,qEAAqE;AACrE,uEAAuE;AACvE,kCAAkC;AAClC,EAAE;AACF,kEAAkE;AAClE,+EAA+E;AAC/E,kEAAkE;AAClE,2EAA2E;AAC3E,sDAAsD;AACtD,EAAE;AACF,qEAAqE;AACrE,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAA;AAoBtB;;;;;;;;;;;;;GAaG;AACH,MAAe,kBAAkB;IAEtB,MAAM,GAAqB,EAAE,CAAA;IAEtC,+BAA+B;IAC/B,OAAO,CAAC,KAAc;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,uBAAuB,CAAC,KAAc;QACpC,IAAI,CAAC,MAAM,CAAC,uBAAuB,GAAG,KAAK,CAAA;QAC3C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,CAAC,KAAqB;QAC3B,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,gBAAgB,CAAC,KAAc;QAC7B,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB;IACpB,OAAO,CAAC,QAA8C;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAA;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,CAAC,QAA8C;QACpD,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CACH,QAAgE;QAEhE,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,UAAU,CACR,QAAgE;QAEhE,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,aAAa,CAAC,QAAsB;QAClC,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,aAAa,CAAC,QAAsB;QAClC,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAsB;QAChC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,kBAAkB,CAAC,QAAsB;QACvC,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAA;QACtC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAc;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,KAAc;QAC3B,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,KAAK,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,8BAA8B,CAAC,KAAc;QAC3C,IAAI,CAAC,MAAM,CAAC,8BAA8B,GAAG,KAAK,CAAA;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,oBAAoB,CAAC,KAAc;QACjC,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,6EAA6E;IAC7E,OAAO,CAAC,GAAyB;QAC/B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,yFAAyF;IACzF,cAAc;QACZ,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;IAED,wBAAwB;IACxB,EAAE;IACF,mEAAmE;IACnE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,sEAAsE;IACtE,8BAA8B;IAC9B,EAAE;IACF,yEAAyE;IACzE,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,yEAAyE;IACzE,4BAA4B;IAC5B,+BAA+B,CAAC,GAAG,QAAsB;QACvD,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG;YACjC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;YAC3C,GAAG,QAAQ;SACZ,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,4BAA4B,CAAC,GAAG,QAAsB;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAA;QACnE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,qBAAqB,CAAC,GAAG,QAAsB;QAC7C,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG;YAC3B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;YACrC,GAAG,QAAQ;SACZ,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,iBAAkB,SAAQ,kBAAkB;IAC9C,IAAI,GAAG,KAAc,CAAA;IAE9B,wCAAwC;IACxC,aAAa,CAAC,MAAmB;QAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,aAAa,CAAC,MAAmB;QAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,MAAmB;QAC7B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,MAAmB;QAC7B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,sBAAsB,CAAC,QAAgB;QACrC,IAAI,CAAC,MAAM,CAAC,sBAAsB,GAAG,QAAQ,CAAA;QAC7C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wEAAwE;IACxE,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,kBAAkB;IAC9C,IAAI,GAAG,KAAc,CAAA;IAE9B;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,OAAO,uBAAwB,SAAQ,kBAAkB;IACpD,IAAI,GAAG,WAAoB,CAAA;IAEpC;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,gBAAgB,CAAC,KAAa;QAC5B,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IACjD,IAAI,GAAG,QAAiB,CAAA;IAEjC;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,qBAAqB,CAAC,KAAc;QAClC,IAAI,CAAC,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,oBAAoB,CAAC,KAAc;QACjC,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,0BAA0B,CAAC,KAAc;QACvC,IAAI,CAAC,MAAM,CAAC,0BAA0B,GAAG,KAAK,CAAA;QAC9C,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAChD,IAAI,GAAG,OAAgB,CAAA;IAEhC;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IACnD,IAAI,GAAG,UAAmB,CAAA;IAEnC;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAChD,IAAI,GAAG,OAAgB,CAAA;IAEhC,uEAAuE;IACvE,SAAS,CAAC,SAAiB;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,gBAAgB,CAAC,KAAa;QAC5B,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IACjD,IAAI,GAAG,QAAiB,CAAA;IAEjC,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAChD,IAAI,GAAG,OAAgB,CAAA;IAEhC,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IACrD,IAAI,GAAG,YAAqB,CAAA;IAErC,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,+EAA+E;IAC/E,oBAAoB,CAAC,KAAc;QACjC,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,GAAsB,EAAE,CAAC,IAAI,iBAAiB,EAAE;IACrD,GAAG,EAAE,GAAsB,EAAE,CAAC,IAAI,iBAAiB,EAAE;IACrD,SAAS,EAAE,GAA4B,EAAE,CAAC,IAAI,uBAAuB,EAAE;IACvE,MAAM,EAAE,GAAyB,EAAE,CAAC,IAAI,oBAAoB,EAAE;IAC9D,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,EAAE,CAAC,GAAG,QAA0B,EAAuB,EAAE,CAC3D,YAAY,CAAC,GAAG,QAAQ,CAAC;IAC3B,YAAY,EAAE,CAAC,GAAG,QAA0B,EAAuB,EAAE,CACnE,oBAAoB,CAAC,GAAG,QAAQ,CAAC;IACnC,SAAS,EAAE,CAAC,GAAG,QAA0B,EAAuB,EAAE,CAChE,iBAAiB,CAAC,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,GAAwB,EAAE,CAAC,IAAI,mBAAmB,EAAE;IAC3D,QAAQ,EAAE,GAA2B,EAAE,CAAC,IAAI,sBAAsB,EAAE;IACpE,KAAK,EAAE,GAAwB,EAAE,CAAC,IAAI,mBAAmB,EAAE;IAC3D,KAAK,EAAE,GAAwB,EAAE,CAAC,IAAI,mBAAmB,EAAE;IAC3D,MAAM,EAAE,GAAyB,EAAE,CAAC,IAAI,oBAAoB,EAAE;IAC9D,UAAU,EAAE,GAA6B,EAAE,CAAC,IAAI,wBAAwB,EAAE;CAC3E,CAAA","sourcesContent":["// Spelling one: `Gesture.Pan()` / `.Tap()` / `.LongPress()`, the chainable\n// builders.\n//\n// Deprecated upstream since 3.1.0 — every one of the twelve `Gesture.*`\n// statics carries an `@deprecated` tag pointing at a hook — and it is still\n// what every shipped consumer calls, which is why it is the spelling that had\n// to work first. It is a facade: each method writes one value into a\n// `RecognizerConfig` and returns `this`, and the object it builds is a\n// `GestureSpec` and nothing more.\n//\n// The class split mirrors upstream's. `BaseGestureBuilder` is its\n// `BaseGesture` — everything the three kinds share — and `onUpdate`/`onChange`\n// live on `PanGestureBuilder` alone because upstream puts them on\n// `ContinousBaseGesture`, which `TapGesture` and `LongPressGesture` do not\n// extend. A discrete gesture has no travel to report.\n//\n// The callback renames are where the two spellings genuinely differ.\n// `onStart` and `onEnd` here are `onActivate` and `onDeactivate` internally,\n// `onTouchesCancelled` is `onTouchesCancel`, and `onChange` — which the hook\n// spelling dropped — is an ordinary callback over the same payload, because\n// the payload already carries `changeX`/`changeY`.\nimport {\n  exclusiveGestures,\n  raceGestures,\n  simultaneousGestures,\n} from \"./composition\"\nimport type {\n  AnyGestureSpec,\n  ComposedGestureSpec,\n  GestureEventPayload,\n  GestureHitSlop,\n  GestureKind,\n  GestureRef,\n  GestureSpec,\n  GestureStateManagerApi,\n  GestureTouchEvent,\n  OffsetBound,\n  RecognizerConfig,\n} from \"./types\"\n\ntype TouchHandler = (\n  event: GestureTouchEvent,\n  manager: GestureStateManagerApi,\n) => void\n\n/**\n * Everything upstream's `BaseGesture` has, which is everything the three\n * implemented kinds share. Not a port of it: it holds no handler tag and no\n * worklet machinery, because on this platform there is one runtime and a\n * handler tag identifies a MOUNTED gesture rather than a built one. The\n * relations it does hold are lists of references and nothing else — the maps\n * that read them live in ./relations, and the loop that acts on them in\n * ./orchestrator.\n *\n * `onUpdate` and `onChange` are deliberately NOT here. Upstream puts them on\n * `ContinousBaseGesture`, which `Tap` and `LongPress` do not extend — they are\n * discrete, they have no travel to report, and offering the methods would\n * invite a callback that never fires.\n */\nabstract class BaseGestureBuilder implements GestureSpec {\n  abstract readonly kind: GestureKind\n  readonly config: RecognizerConfig = {}\n\n  // --- common configuration ---\n  enabled(value: boolean): this {\n    this.config.enabled = value\n    return this\n  }\n  shouldCancelWhenOutside(value: boolean): this {\n    this.config.shouldCancelWhenOutside = value\n    return this\n  }\n  hitSlop(value: GestureHitSlop): this {\n    this.config.hitSlop = value\n    return this\n  }\n  manualActivation(value: boolean): this {\n    this.config.manualActivation = value\n    return this\n  }\n\n  // --- callbacks ---\n  onBegin(callback: (event: GestureEventPayload) => void): this {\n    this.config.onBegin = callback\n    return this\n  }\n  onStart(callback: (event: GestureEventPayload) => void): this {\n    this.config.onActivate = callback\n    return this\n  }\n  onEnd(\n    callback: (event: GestureEventPayload, success: boolean) => void,\n  ): this {\n    this.config.onDeactivate = callback\n    return this\n  }\n  onFinalize(\n    callback: (event: GestureEventPayload, success: boolean) => void,\n  ): this {\n    this.config.onFinalize = callback\n    return this\n  }\n  onTouchesDown(callback: TouchHandler): this {\n    this.config.onTouchesDown = callback\n    return this\n  }\n  onTouchesMove(callback: TouchHandler): this {\n    this.config.onTouchesMove = callback\n    return this\n  }\n  onTouchesUp(callback: TouchHandler): this {\n    this.config.onTouchesUp = callback\n    return this\n  }\n  onTouchesCancelled(callback: TouchHandler): this {\n    this.config.onTouchesCancel = callback\n    return this\n  }\n\n  /**\n   * Recorded and not acted on, exactly as upstream does not act on it off its\n   * worklet platforms: gesture callbacks are worklets by default there and\n   * this asks for the JS runtime instead. There is one runtime here, so every\n   * callback already runs where this is asking it to. `@gorhom/bottom-sheet`\n   * sets it twice; making it throw would refuse code that is already correct.\n   *\n   * Recorded rather than discarded so the config still describes what the app\n   * asked for — the orchestrator and any devtools read this object.\n   */\n  runOnJS(value: boolean): this {\n    this.config.runOnJS = value\n    return this\n  }\n\n  /**\n   * Platform-specific upstream and inert here, which is upstream's own\n   * treatment of them off their platforms: `averageTouches` is Android-only,\n   * `enableTrackpadTwoFingerGesture` and `cancelsTouchesInView` are iOS-only,\n   * `activeCursor` and `mouseButton` are Web-only. Accepting them keeps\n   * portable source portable; docs/api.md records that they do nothing.\n   */\n  averageTouches(value: boolean): this {\n    this.config.averageTouches = value\n    return this\n  }\n  enableTrackpadTwoFingerGesture(value: boolean): this {\n    this.config.enableTrackpadTwoFingerGesture = value\n    return this\n  }\n  cancelsTouchesInView(value: boolean): this {\n    this.config.cancelsTouchesInView = value\n    return this\n  }\n  activeCursor(value: string): this {\n    this.config.activeCursor = value\n    return this\n  }\n  mouseButton(value: number): this {\n    this.config.mouseButton = value\n    return this\n  }\n\n  /** Upstream stores a ref for the relation APIs; harmless to honour early. */\n  withRef(ref: { current: unknown }): this {\n    ref.current = this\n    return this\n  }\n  withTestId(id: string): this {\n    this.config.testId = id\n    return this\n  }\n\n  /** Upstream's flattening hook for composed gestures; a lone gesture is a list of one. */\n  toGestureArray(): BaseGestureBuilder[] {\n    return [this]\n  }\n\n  // --- the relations ---\n  //\n  // Three methods, three lists, one place they are read: the maps in\n  // ./relations. Each of them writes a list of REFERENCES rather than tags —\n  // an app names another gesture with the gesture object it built, and the\n  // tag that identifies a mounted one does not exist until a detector mounts\n  // it. `withRef()` and a raw tag are accepted in the same position, as\n  // upstream's `GestureRef` is.\n  //\n  // Appending rather than replacing: `.simultaneousWithExternalGesture(a)`\n  // followed by `.simultaneousWithExternalGesture(b)` means both, which is\n  // what chaining reads like. The builder is rebuilt every render by every\n  // app that follows upstream's own advice, so nothing accumulates across\n  // renders — and composition computes rather than writes back here, so it\n  // cannot accumulate either.\n  simultaneousWithExternalGesture(...gestures: GestureRef[]): this {\n    this.config.simultaneousHandlers = [\n      ...(this.config.simultaneousHandlers ?? []),\n      ...gestures,\n    ]\n    return this\n  }\n  requireExternalGestureToFail(...gestures: GestureRef[]): this {\n    this.config.waitFor = [...(this.config.waitFor ?? []), ...gestures]\n    return this\n  }\n  blocksExternalGesture(...gestures: GestureRef[]): this {\n    this.config.blocksHandlers = [\n      ...(this.config.blocksHandlers ?? []),\n      ...gestures,\n    ]\n    return this\n  }\n}\n\n/** `Gesture.Pan()`, and the only one of the three that reports travel. */\nexport class PanGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"pan\" as const\n\n  // --- activation and failure bounds ---\n  activeOffsetX(offset: OffsetBound): this {\n    this.config.activeOffsetX = offset\n    return this\n  }\n  activeOffsetY(offset: OffsetBound): this {\n    this.config.activeOffsetY = offset\n    return this\n  }\n  failOffsetX(offset: OffsetBound): this {\n    this.config.failOffsetX = offset\n    return this\n  }\n  failOffsetY(offset: OffsetBound): this {\n    this.config.failOffsetY = offset\n    return this\n  }\n  minDistance(distance: number): this {\n    this.config.minDistance = distance\n    return this\n  }\n  minVelocity(velocity: number): this {\n    this.config.minVelocity = velocity\n    return this\n  }\n  minVelocityX(velocity: number): this {\n    this.config.minVelocityX = velocity\n    return this\n  }\n  minVelocityY(velocity: number): this {\n    this.config.minVelocityY = velocity\n    return this\n  }\n  minPointers(count: number): this {\n    this.config.minPointers = count\n    return this\n  }\n  maxPointers(count: number): this {\n    this.config.maxPointers = count\n    return this\n  }\n  activateAfterLongPress(duration: number): this {\n    this.config.activateAfterLongPress = duration\n    return this\n  }\n\n  // --- the continuous callbacks, which only a continuous gesture has ---\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture.Tap()`.\n *\n * `shouldCancelWhenOutside` is on by default, set from the constructor exactly\n * as upstream's `TapGesture` does — a press that wanders off the view is not a\n * tap on it, and the native `TapGestureHandler` config says the same.\n */\nexport class TapGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"tap\" as const\n\n  constructor() {\n    super()\n    this.shouldCancelWhenOutside(true)\n  }\n\n  numberOfTaps(count: number): this {\n    this.config.numberOfTaps = count\n    return this\n  }\n  maxDuration(duration: number): this {\n    this.config.maxDuration = duration\n    return this\n  }\n  maxDelay(delay: number): this {\n    this.config.maxDelay = delay\n    return this\n  }\n  maxDistance(distance: number): this {\n    this.config.maxDistance = distance\n    return this\n  }\n  maxDeltaX(delta: number): this {\n    this.config.maxDeltaX = delta\n    return this\n  }\n  maxDeltaY(delta: number): this {\n    this.config.maxDeltaY = delta\n    return this\n  }\n  minPointers(count: number): this {\n    this.config.minPointers = count\n    return this\n  }\n}\n\n/** `Gesture.LongPress()`, with upstream's default of `shouldCancelWhenOutside`. */\nexport class LongPressGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"longPress\" as const\n\n  constructor() {\n    super()\n    this.shouldCancelWhenOutside(true)\n  }\n\n  minDuration(duration: number): this {\n    this.config.minDuration = duration\n    return this\n  }\n  maxDistance(distance: number): this {\n    this.config.maxDistance = distance\n    return this\n  }\n  numberOfPointers(count: number): this {\n    this.config.numberOfPointers = count\n    return this\n  }\n}\n\n/**\n * `Gesture.Native()` — the widget underneath, put into the arbitration.\n *\n * `shouldCancelWhenOutside` defaults to true from the constructor, which is\n * where upstream's `NativeViewGestureHandler.init` sets it rather than its\n * builder. See ./native for what the recognizer does and, more to the point,\n * what it deliberately does not do: it never takes the responder, because\n * taking it is what switches the native scroller off.\n */\nexport class NativeGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"native\" as const\n\n  constructor() {\n    super()\n    this.shouldCancelWhenOutside(true)\n  }\n\n  shouldActivateOnStart(value: boolean): this {\n    this.config.shouldActivateOnStart = value\n    return this\n  }\n  disallowInterruption(value: boolean): this {\n    this.config.disallowInterruption = value\n    return this\n  }\n  yieldsToContinuousGestures(value: boolean): this {\n    this.config.yieldsToContinuousGestures = value\n    return this\n  }\n\n  /**\n   * A native view is CONTINUOUS upstream (`isContinuous = true`), so it\n   * reports travel like `Pan` does and unlike `Tap`. These are here rather\n   * than on the base class for the same reason they are on\n   * `PanGestureBuilder`: upstream puts them on `ContinousBaseGesture`.\n   */\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture.Pinch()` and `Gesture.Rotation()`, which have no configuration of\n * their own at all — verified against 3.1.0, where `PinchGesture` and\n * `RotationGesture` add zero builder methods over `ContinousBaseGesture`, and\n * where v3's `PinchGestureNativeProperties` is literally\n * `Record<string, never>`. Both are CONTINUOUS, so `onUpdate`/`onChange` are\n * here for the same reason they are on `PanGestureBuilder`.\n *\n * `shouldCancelWhenOutside` is off, set from the constructor because upstream\n * sets it from `PinchGestureHandler.init`/`RotationGestureHandler.init` — a\n * pinch whose focal point wanders off the view keeps running, unlike a tap.\n *\n * What they do NOT have is a pointer: see ./touchpad. Their numbers come from\n * `GtkGestureZoom`/`GtkGestureRotate`, and everything else about them — the\n * states, the callbacks, the arbitration — is the machine every other kind\n * runs on.\n */\nexport class PinchGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"pinch\" as const\n\n  constructor() {\n    super()\n    this.shouldCancelWhenOutside(false)\n  }\n\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/** `Gesture.Rotation()`. Same shape as `Pinch`, same reasons. */\nexport class RotationGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"rotation\" as const\n\n  constructor() {\n    super()\n    this.shouldCancelWhenOutside(false)\n  }\n\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture.Fling()` — a directional swipe, and the one DISCRETE gesture with a\n * velocity criterion.\n *\n * No `onUpdate`/`onChange`, and that is upstream's shape rather than an\n * omission: `FlingGesture` extends `BaseGesture` and not\n * `ContinousBaseGesture`, because a fling activates and ends in the same\n * breath (see ./fling) and there is never an update to report between them.\n * Offering the methods would invite a callback that cannot fire.\n */\nexport class FlingGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"fling\" as const\n\n  /** A BITMASK of `Directions`; several are one value, OR'd together. */\n  direction(direction: number): this {\n    this.config.direction = direction\n    return this\n  }\n  numberOfPointers(count: number): this {\n    this.config.numberOfPointers = count\n    return this\n  }\n}\n\n/**\n * `Gesture.Manual()` — no configuration at all, because there is nothing to\n * configure: the app drives the state machine through the manager handed to\n * the `onTouches*` callbacks.\n *\n * Verified against 3.1.0, where `ManualGesture` adds zero builder methods over\n * `ContinousBaseGesture` and v3's `ManualGestureProperties` is\n * `Record<string, never>`. Continuous, so `onUpdate`/`onChange` are here.\n */\nexport class ManualGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"manual\" as const\n\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture.Hover()` — the pointer being over the view, with no button down.\n *\n * `effect()` is upstream's one knob and it is iOS-only there; it is recorded\n * and inert here, exactly as it is inert in upstream's own web handler, which\n * never branches on it either. Continuous, so it reports travel.\n */\nexport class HoverGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"hover\" as const\n\n  effect(effect: number): this {\n    this.config.hoverEffect = effect\n    return this\n  }\n\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture.ForceTouch()` — pressure, and the one recognizer in this module\n * whose input the test rig cannot fully produce. See ./force-touch, which\n * says so at length, and docs/api.md, which says it where an app will read it.\n *\n * Continuous, matching upstream's `ContinousBaseGesture`.\n */\nexport class ForceTouchGestureBuilder extends BaseGestureBuilder {\n  readonly kind = \"forceTouch\" as const\n\n  minForce(force: number): this {\n    this.config.minForce = force\n    return this\n  }\n  maxForce(force: number): this {\n    this.config.maxForce = force\n    return this\n  }\n  /** Haptics. Recorded and inert: there is no haptic device on this platform. */\n  feedbackOnActivation(value: boolean): this {\n    this.config.feedbackOnActivation = value\n    return this\n  }\n\n  onUpdate(callback: (event: GestureEventPayload) => void): this {\n    this.config.onUpdate = callback\n    return this\n  }\n  onChange(callback: (event: GestureEventPayload) => void): this {\n    this.config.onChange = callback\n    return this\n  }\n}\n\n/**\n * `Gesture`, the namespace of statics — all ten of them, and the three\n * composers.\n *\n * Nothing here throws any more. The four that used to (`Fling`, `Hover`,\n * `Manual`, `ForceTouch`) are the last of upstream's surface and the reasons\n * they were refused have been re-examined one at a time rather than inherited:\n * `Fling` and `Manual` were always reachable and merely unwritten, `Hover` was\n * refused on a judgement about the rig that was simply wrong (a mouse hovers,\n * and the virtual pointer moves a mouse), and `ForceTouch` is the one that\n * needs hardware — it ships with upstream's documented semantics and an\n * explicit note about what is unverified, rather than a refusal that says\n * nothing.\n */\nexport const Gesture = {\n  Pan: (): PanGestureBuilder => new PanGestureBuilder(),\n  Tap: (): TapGestureBuilder => new TapGestureBuilder(),\n  LongPress: (): LongPressGestureBuilder => new LongPressGestureBuilder(),\n  Native: (): NativeGestureBuilder => new NativeGestureBuilder(),\n  // List-builders over the same three maps the relation methods write, with\n  // no mechanism of their own — see ./composition.\n  Race: (...gestures: AnyGestureSpec[]): ComposedGestureSpec =>\n    raceGestures(...gestures),\n  Simultaneous: (...gestures: AnyGestureSpec[]): ComposedGestureSpec =>\n    simultaneousGestures(...gestures),\n  Exclusive: (...gestures: AnyGestureSpec[]): ComposedGestureSpec =>\n    exclusiveGestures(...gestures),\n  Pinch: (): PinchGestureBuilder => new PinchGestureBuilder(),\n  Rotation: (): RotationGestureBuilder => new RotationGestureBuilder(),\n  Fling: (): FlingGestureBuilder => new FlingGestureBuilder(),\n  Hover: (): HoverGestureBuilder => new HoverGestureBuilder(),\n  Manual: (): ManualGestureBuilder => new ManualGestureBuilder(),\n  ForceTouch: (): ForceTouchGestureBuilder => new ForceTouchGestureBuilder(),\n}\n"]}

package/dist/gesture-handler-compat/composition.d.ts

@@ -0,0 +1,23 @@
+import { type AnyGestureSpec, type ComposedGestureSpec, type GestureRelations, type GestureSpec } from "./types";
+/** One recognizer, with the relations it ends up with once composed. */
+export type PreparedGesture = {
+    spec: GestureSpec;
+    relations: GestureRelations;
+};
+/**
+ * Flattens a gesture or a composition into the recognizers a detector has to
+ * mount, each with the relations composition gave it.
+ */
+export declare const prepareGestures: (gesture: AnyGestureSpec) => PreparedGesture[];
+/**
+ * `Gesture.Race()` — the default, spelled out.
+ *
+ * Upstream's hook spelling calls this `useCompetingGestures`, which is the
+ * better name for it: the gestures compete, the first to activate cancels the
+ * rest, and that would have happened anyway.
+ */
+export declare const raceGestures: (...gestures: AnyGestureSpec[]) => ComposedGestureSpec;
+/** `Gesture.Simultaneous()` — a pairwise fill of `simultaneousHandlers`. */
+export declare const simultaneousGestures: (...gestures: AnyGestureSpec[]) => ComposedGestureSpec;
+/** `Gesture.Exclusive()` — a chain fill of `waitFor`. */
+export declare const exclusiveGestures: (...gestures: AnyGestureSpec[]) => ComposedGestureSpec;