@astryxdesign/core 0.7.5 → 0.7.6-canary.0ef60dd

package/src/gestures/GestureRecognizer.ts

@@ -142,9 +142,20 @@ export const MANIPULATION: NativeTouchBehavior = {
   doubleTapZoom: false,
 };
 
+/**
+ * What a recognizer is. The gesture code tells the family apart by it, never
+ * by `instanceof` (`architecture:react-component-runtime` INV13); a
+ * screen-edge pan is its own kind, though it is built on the pan.
+ */
+export type RecognizerKind =
+  'tap' | 'longPress' | 'pan' | 'screenEdgePan' | 'swipe' | 'pinch';
+
 let nextRecognizerId = 1;
 
 export abstract class GestureRecognizer {
+  /** What this recognizer is (see RecognizerKind). */
+  abstract get kind(): RecognizerKind;
+
   /** Stable id, for ordering and debugging. */
   readonly id = nextRecognizerId++;
   name: string;
@@ -568,12 +579,19 @@ export abstract class GestureRecognizer {
     }
   }
 
+  /** @internal The host's hook: listeners follow whether anything is enabled. */
+  onEnabledChange: (() => void) | null = null;
+
   /**
    * UIKit's `isEnabled` setter: turning a recognizer off mid-gesture cancels
    * the gesture (an active one) or fails it (a possible one).
    */
   setEnabled(value: boolean): void {
+    const changed = this.isEnabled !== value;
     this.isEnabled = value;
+    if (changed) {
+      this.onEnabledChange?.();
+    }
     if (!value && (this.state !== 'possible' || this.isInvolved())) {
       this.cancel();
     }

package/src/gestures/LongPressGestureRecognizer.ts

@@ -41,6 +41,10 @@ export interface LongPressGestureRecognizerOptions extends GestureRecognizerOpti
 }
 
 export class LongPressGestureRecognizer extends GestureRecognizer {
+  override get kind(): GestureRecognizer['kind'] {
+    return 'longPress';
+  }
+
   minimumPressDuration: number;
   allowableMovement: number;
   numberOfTapsRequired: number;

package/src/gestures/PanGestureRecognizer.ts

@@ -87,6 +87,10 @@ const DIRECTION_VECTORS: Partial<Record<PanDirection, Point>> = {
 };
 
 export class PanGestureRecognizer extends GestureRecognizer {
+  override get kind(): GestureRecognizer['kind'] {
+    return 'pan';
+  }
+
   minimumNumberOfTouches: number;
   maximumNumberOfTouches: number;
   hysteresis: number;

package/src/gestures/PinchGestureRecognizer.ts

@@ -0,0 +1,148 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file PinchGestureRecognizer.ts
+ * @input Touches from a GestureArena
+ * @output Exports PinchGestureRecognizer (UIPinchGestureRecognizer) and its
+ *   options
+ * @position Continuous two-finger recognizer of packages/core/src/gestures
+ *
+ * Tracks the first two fingers; more are ignored. Begins once the distance
+ * between them has changed by `hysteresis` px. As in UIKit, `scale` is then
+ * the current distance over the starting distance moved by the hysteresis
+ * toward the pinch, so it does not jump (settable to re-base it); `velocity`
+ * is scale per second. Lifting either finger ends an
+ * active pinch and fails a possible one.
+ *
+ * A host gives every element WITHOUT a pinch recognizer `pinch-zoom` in its
+ * `touch-action`, so the page stays zoomable (WCAG 1.4.4); attaching one
+ * takes the two-finger gesture for this element only.
+ */
+
+import {UIKIT_PINCH} from '../motion/uikit/gestures';
+import {centroid, distance} from './geometry';
+import {
+  GestureRecognizer,
+  isActive,
+  type GestureRecognizerOptions,
+  type NativeTouchBehavior,
+} from './GestureRecognizer';
+import type {GestureEventContext, GestureTouch, Point} from './types';
+import {VelocityTracker} from './VelocityTracker';
+
+export interface PinchGestureRecognizerOptions extends GestureRecognizerOptions<PinchGestureRecognizer> {
+  hysteresis?: number;
+}
+
+export class PinchGestureRecognizer extends GestureRecognizer {
+  override get kind(): GestureRecognizer['kind'] {
+    return 'pinch';
+  }
+
+  hysteresis: number;
+  private initialSpan = 0;
+  private scaleValue = 1;
+  private readonly tracker = new VelocityTracker();
+  private lastTime = 0;
+
+  constructor(options: PinchGestureRecognizerOptions = {}) {
+    super(options);
+    this.hysteresis = options.hysteresis ?? UIKIT_PINCH.hysteresis.value;
+  }
+
+  /** Current span over the span the fingers started at. */
+  get scale(): number {
+    return this.scaleValue;
+  }
+
+  /** Re-base: from now on the scale reads `value` at the current span. */
+  set scale(value: number) {
+    const span = this.span();
+    if (span > 0 && value > 0) {
+      this.initialSpan = span / value;
+      this.scaleValue = value;
+      // The velocity continues from the re-based value, without a jump.
+      this.tracker.reset();
+      this.tracker.add(value, 0, this.lastTime);
+    }
+  }
+
+  /** Scale per second (UIKit's filter; measured for pans, assumed here). */
+  get velocity(): number {
+    return this.tracker.velocity().x;
+  }
+
+  /** The midpoint between the two fingers. */
+  focalPoint(): Point {
+    return centroid(this.touches.values());
+  }
+
+  /** Two fingers on this view are this recognizer's, not the browser's zoom. */
+  override get nativeTouchBehavior(): NativeTouchBehavior {
+    return {panX: true, panY: true, pinchZoom: false, doubleTapZoom: false};
+  }
+
+  protected override acceptsTouch(touch: GestureTouch): boolean {
+    return this.numberOfTouches < 2 && super.acceptsTouch(touch);
+  }
+
+  protected override touchesBegan(
+    _touches: ReadonlyArray<GestureTouch>,
+    event: GestureEventContext,
+  ): void {
+    this.lastTime = event.time;
+    if (this.numberOfTouches === 2) {
+      this.initialSpan = this.span();
+      this.scaleValue = 1;
+      this.tracker.reset();
+      this.tracker.add(1, 0, event.time);
+    }
+  }
+
+  protected override touchesMoved(
+    _touches: ReadonlyArray<GestureTouch>,
+    event: GestureEventContext,
+  ): void {
+    if (this.numberOfTouches < 2 || this.initialSpan <= 0) {
+      return;
+    }
+    this.lastTime = event.time;
+    const span = this.span();
+    // Once recognized, a pinch waiting on a recognizer it requires to fail
+    // keeps its re-based start: its moves only follow the fingers.
+    if (this.state === 'possible' && this.pending == null) {
+      if (Math.abs(span - this.initialSpan) >= this.hysteresis) {
+        // UIKit measures from the start moved by the hysteresis, and its
+        // first velocity spans from the touch-down (scale 1) to here.
+        this.initialSpan +=
+          Math.sign(span - this.initialSpan) * this.hysteresis;
+        this.scaleValue = span / this.initialSpan;
+        this.tracker.add(this.scaleValue, 0, event.time);
+        this.setState('began');
+      }
+      return;
+    }
+    this.scaleValue = span / this.initialSpan;
+    // Every move of the fingers is a sample: a span that holds while they
+    // move reads as no change, so the velocity never goes stale.
+    this.tracker.add(this.scaleValue, 0, event.time, {isMotion: true});
+    if (isActive(this.state)) {
+      this.setState('changed');
+    }
+  }
+
+  protected override touchesEnded(): void {
+    this.setState(isActive(this.state) ? 'ended' : 'failed');
+  }
+
+  protected override reset(): void {
+    this.initialSpan = 0;
+    this.scaleValue = 1;
+    this.tracker.reset();
+  }
+
+  private span(): number {
+    const [a, b] = this.trackedTouches;
+    return a == null || b == null ? 0 : distance(a, b);
+  }
+}

package/src/gestures/ScreenEdgePanGestureRecognizer.ts

@@ -0,0 +1,256 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file ScreenEdgePanGestureRecognizer.ts
+ * @input Touches from a GestureArena; the viewport size and writing
+ *   direction from its environment
+ * @output Exports ScreenEdgePanGestureRecognizer
+ *   (UIScreenEdgePanGestureRecognizer), its options and edge type
+ * @position Continuous recognizer of packages/core/src/gestures, a pan that
+ *   only starts from a band at the edge of the viewport
+ *
+ * A touch that lands outside every requested band fails at once, so a
+ * recognizer that requires this one to fail is not held up by a touch in the
+ * middle of the screen. Inside a band, the pan begins on movement away from
+ * that edge. `leading` and `trailing` resolve against the view's writing
+ * direction: under RTL the leading edge is the right one, as the
+ * interactive pop gesture's is.
+ *
+ * Attach it to the edge zone: an element that lies within the band at its
+ * edge. There the pan takes the horizontal axis from the browser, which has
+ * nothing to scroll in so thin a band, so a touch in the band decides at
+ * UIKit's 15 px screen-edge hysteresis. On any other view, whose
+ * `touch-action` cannot claim per touch, it leaves the browser every touch
+ * behavior, so the author's scrolling there is untouched, and a touch in the
+ * band decides at FR19's 10 px like every other claim (spec:AST-094 FR18,
+ * DEC-22). The edges' physical sides and the edge zone are measured once,
+ * together, and serve both the element's `touch-action` and the touch-down
+ * decision; the host reports a layout change (layoutChanged), and a changed
+ * answer is announced (onTouchBehaviorChange) so `touch-action` follows it
+ * (FR19). The writing direction is read again at each touch-down: a view
+ * switched to RTL in place, with no resize, is measured again there and the
+ * change announced, so a `leading` back swipe follows the new leading edge
+ * (`design:bidirectionality` DR13). That touch landed under the touch-action
+ * from before, so it decides at FR19's 10 px unless that one claimed the
+ * axis.
+ */
+
+import {UIKIT_PAN, UIKIT_SCREEN_EDGE_PAN} from '../motion/uikit/gestures';
+import {ALL_NATIVE_TOUCH, type NativeTouchBehavior} from './GestureRecognizer';
+import {
+  PanGestureRecognizer,
+  type PanGestureRecognizerOptions,
+} from './PanGestureRecognizer';
+import type {GestureEventContext, GestureTouch} from './types';
+
+/**
+ * How far past `edgeRegion` a view still counts as the edge zone, px: layout
+ * snaps sizes to 1/64 px, so a strip authored at the region measures a hair
+ * wider; half a pixel takes that and nothing a pixel wider.
+ */
+const EDGE_ZONE_TOLERANCE = 0.5;
+
+/**
+ * An edge by writing direction: under RTL the leading edge is the right one.
+ * Top and bottom edges land with their first user.
+ */
+export type ScreenEdge = 'leading' | 'trailing';
+
+/** A physical horizontal edge of the viewport. */
+type PhysicalEdge = 'left' | 'right';
+
+/**
+ * What the pan measures of its view, once until a layout change: the
+ * writing direction it read, the physical sides its edges resolve to under
+ * that direction, and the sides whose band the view lies within.
+ */
+interface EdgeLayout {
+  readonly isRtl: boolean;
+  readonly watched: ReadonlyArray<PhysicalEdge>;
+  readonly zone: ReadonlySet<PhysicalEdge>;
+}
+
+/**
+ * A screen-edge pan is a finger's: it takes no `allowedPointerTypes`
+ * (`spec:AST-094` FR43).
+ */
+export interface ScreenEdgePanGestureRecognizerOptions extends Omit<
+  PanGestureRecognizerOptions,
+  'direction' | 'allowedPointerTypes'
+> {
+  /** The edges a touch may start from. @default ['leading'] */
+  edges?: ReadonlyArray<ScreenEdge>;
+  /** Width of the band at each edge, px. */
+  edgeRegion?: number;
+}
+
+export class ScreenEdgePanGestureRecognizer extends PanGestureRecognizer {
+  override get kind(): PanGestureRecognizer['kind'] {
+    return 'screenEdgePan';
+  }
+
+  edges: ReadonlyArray<ScreenEdge>;
+  edgeRegion: number;
+  /** The physical edge the current gesture started from. */
+  activeEdge: PhysicalEdge | null = null;
+  /**
+   * @internal Set by the host while attached: called when the edge-zone
+   * answer changes, so the element's `touch-action` follows it
+   * (spec:AST-094 FR19, DEC-22).
+   */
+  onTouchBehaviorChange: (() => void) | null = null;
+  /** The hysteresis where the pan takes its axis (UIKit's 15 px). */
+  private readonly edgeHysteresis: number;
+  /** What the pan measured of its view (see EdgeLayout), until a layout change. */
+  private layout: EdgeLayout | null = null;
+
+  constructor(options: ScreenEdgePanGestureRecognizerOptions = {}) {
+    super({
+      maximumNumberOfTouches: 1,
+      hysteresis: UIKIT_SCREEN_EDGE_PAN.hysteresis.value,
+      ...options,
+      // A finger's only: under a mouse, a trackpad or a pen the screen-edge
+      // pan stays off (`spec:AST-094` FR43), whatever a caller passes.
+      allowedPointerTypes: ['touch'],
+    });
+    this.edges = options.edges ?? ['leading'];
+    this.edgeRegion =
+      options.edgeRegion ?? UIKIT_SCREEN_EDGE_PAN.edgeRegion.value;
+    this.edgeHysteresis = this.hysteresis;
+  }
+
+  /**
+   * The pan takes the horizontal axis only in its edge zone, a view within
+   * the band of an edge it watches; elsewhere it leaves the browser every
+   * touch behavior, so the author's scrolling is untouched (spec:AST-094
+   * FR18), never claiming across a whole wider element.
+   */
+  override get nativeTouchBehavior(): NativeTouchBehavior {
+    const {watched, zone} = this.measured();
+    if (!watched.some(edge => zone.has(edge))) {
+      return ALL_NATIVE_TOUCH;
+    }
+    return {
+      panX: false,
+      panY: true,
+      pinchZoom: true,
+      doubleTapZoom: false,
+    };
+  }
+
+  /**
+   * @internal Whether the edge zone depends on the viewport's width: the pan
+   * watches the right side, whose band moves with the viewport, so the host
+   * reports a viewport resize to it as well as its own box's (FR19, FR24).
+   */
+  get watchesViewport(): boolean {
+    return this.measured().watched.includes('right');
+  }
+
+  /**
+   * @internal The view's box may have changed (a resize): its edges' sides
+   * and the edge zone are measured again, and a changed answer calls
+   * onTouchBehaviorChange.
+   */
+  layoutChanged(): void {
+    const before = this.layout;
+    this.layout = null;
+    const after = this.measured();
+    if (
+      before == null ||
+      before.watched.join() !== after.watched.join() ||
+      before.zone.size !== after.zone.size ||
+      [...after.zone].some(edge => !before.zone.has(edge))
+    ) {
+      this.onTouchBehaviorChange?.();
+    }
+  }
+
+  protected override touchesBegan(
+    touches: ReadonlyArray<GestureTouch>,
+    event: GestureEventContext,
+  ): void {
+    if (this.numberOfTouches === touches.length) {
+      // The touch-action the browser applies to this touch was derived from
+      // the layout in force as it landed: whether that claimed the axis.
+      const inForce = this.measured();
+      const claimedAxis = inForce.watched.some(side => inForce.zone.has(side));
+      // A direction switched in place (no resize) moves the leading edge:
+      // measure again, and announce it so touch-action follows for the next
+      // touch (DR13).
+      if (inForce.isRtl !== this.environment.isRtl(this.view)) {
+        this.layoutChanged();
+      }
+      const edge = this.edgeAt(touches[0]);
+      if (edge == null) {
+        this.setState('failed');
+        return;
+      }
+      this.activeEdge = edge;
+      // On an element within the band, which takes the axis across the edge,
+      // a touch decides at UIKit's 15 px; on any other, which leaves the
+      // browser that axis, at FR19's 10 px, before the browser commits to a
+      // scroll (spec:AST-094 FR18, DEC-22). The answer is the one this
+      // touch's touch-action was derived from: a touch that measured again
+      // decides at 10 px unless the layout in force claimed the axis.
+      const offZone = !claimedAxis || !this.measured().zone.has(edge);
+      this.hysteresis = offZone
+        ? Math.min(this.edgeHysteresis, UIKIT_PAN.hysteresis.value)
+        : this.edgeHysteresis;
+      this.direction = edge === 'left' ? 'right' : 'left';
+    }
+    super.touchesBegan(touches, event);
+  }
+
+  /**
+   * The physical sides the pan's edges resolve to under the view's writing
+   * direction, and the sides whose band the view lies within, measured
+   * together once until a layout change: the view starts at that side and
+   * reaches no farther than `edgeRegion` from it, within layout's rounding
+   * (a strip authored at the 40.2 px region lays out at 40.203 px, on
+   * 1/64 px). A view that cannot be measured lies within none.
+   */
+  private measured(): EdgeLayout {
+    if (this.layout != null) {
+      return this.layout;
+    }
+    const isRtl = this.environment.isRtl(this.view);
+    const watched = this.edges.map(edge =>
+      (edge === 'leading') !== isRtl ? 'left' : 'right',
+    );
+    const zone = new Set<PhysicalEdge>();
+    const rect = this.environment.viewRect?.(this.view);
+    if (rect != null && rect.width > 0) {
+      const {width} = this.environment.viewportSize();
+      const right = rect.left + rect.width;
+      const band = this.edgeRegion + EDGE_ZONE_TOLERANCE;
+      if (rect.left >= -EDGE_ZONE_TOLERANCE && right <= band) {
+        zone.add('left');
+      }
+      if (rect.left >= width - band && right <= width + EDGE_ZONE_TOLERANCE) {
+        zone.add('right');
+      }
+    }
+    this.layout = {isRtl, watched, zone};
+    return this.layout;
+  }
+
+  protected override reset(): void {
+    super.reset();
+    this.activeEdge = null;
+  }
+
+  private edgeAt(touch: GestureTouch): PhysicalEdge | null {
+    const {width} = this.environment.viewportSize();
+    for (const physical of this.measured().watched) {
+      const inBand =
+        physical === 'left'
+          ? touch.startX <= this.edgeRegion
+          : touch.startX >= width - this.edgeRegion;
+      if (inBand) {
+        return physical;
+      }
+    }
+    return null;
+  }
+}

package/src/gestures/SwipeGestureRecognizer.ts

@@ -0,0 +1,197 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file SwipeGestureRecognizer.ts
+ * @input Touches from a GestureArena
+ * @output Exports SwipeGestureRecognizer (UISwipeGestureRecognizer), its
+ *   options and direction type
+ * @position Discrete recognizer of packages/core/src/gestures
+ *
+ * Recognized WHILE the fingers move, as UIKit's is: as soon as the centroid
+ * has travelled `minimumDistance` along an allowed direction, within
+ * `maximumDuration` of touch-down, with off-axis travel no more than
+ * `maximumSecondaryMovement` px across it. Off-axis travel past that
+ * allowance, or the distance travelled the wrong way, rules a direction out;
+ * the swipe fails once every allowed direction is ruled out, as it does for
+ * too many fingers, the duration running out, and a lift before it was
+ * recognized.
+ */
+
+import {UIKIT_SWIPE} from '../motion/uikit/gestures';
+import {centroid} from './geometry';
+import {
+  GestureRecognizer,
+  type GestureRecognizerOptions,
+  type NativeTouchBehavior,
+} from './GestureRecognizer';
+import type {GestureEventContext, GestureTouch, Point} from './types';
+
+export type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+
+export interface SwipeGestureRecognizerOptions extends GestureRecognizerOptions<SwipeGestureRecognizer> {
+  /** @default ['right'] */
+  direction?: SwipeDirection | ReadonlyArray<SwipeDirection>;
+  /** @default 1 */
+  numberOfTouchesRequired?: number;
+  minimumDistance?: number;
+  maximumDuration?: number;
+  maximumSecondaryMovement?: number;
+}
+
+const SWIPE = UIKIT_SWIPE;
+
+export class SwipeGestureRecognizer extends GestureRecognizer {
+  override get kind(): GestureRecognizer['kind'] {
+    return 'swipe';
+  }
+
+  directions: ReadonlyArray<SwipeDirection>;
+  numberOfTouchesRequired: number;
+  minimumDistance: number;
+  maximumDuration: number;
+  maximumSecondaryMovement: number;
+  /** The direction of the recognized swipe. */
+  recognizedDirection: SwipeDirection | null = null;
+
+  private origin: Point = {x: 0, y: 0};
+  /** Directions this touch's path has ruled out. */
+  private readonly ruledOut = new Set<SwipeDirection>();
+  /** The centroid at the previous move. */
+  private last: Point | null = null;
+
+  constructor(options: SwipeGestureRecognizerOptions = {}) {
+    super(options);
+    const direction = options.direction ?? ['right'];
+    this.directions = typeof direction === 'string' ? [direction] : direction;
+    this.numberOfTouchesRequired = options.numberOfTouchesRequired ?? 1;
+    this.minimumDistance =
+      options.minimumDistance ?? SWIPE.minimumDistance.value;
+    this.maximumDuration =
+      options.maximumDuration ?? SWIPE.maximumDuration.value;
+    this.maximumSecondaryMovement =
+      options.maximumSecondaryMovement ?? SWIPE.maximumSecondaryMovement.value;
+  }
+
+  override get isDiscrete(): boolean {
+    return true;
+  }
+
+  override get nativeTouchBehavior(): NativeTouchBehavior {
+    const horizontal = this.directions.some(
+      direction => direction === 'left' || direction === 'right',
+    );
+    const vertical = this.directions.some(
+      direction => direction === 'up' || direction === 'down',
+    );
+    return {
+      panX: !horizontal,
+      panY: !vertical,
+      pinchZoom: true,
+      doubleTapZoom: false,
+    };
+  }
+
+  protected override touchesBegan(
+    touches: ReadonlyArray<GestureTouch>,
+    event: GestureEventContext,
+  ): void {
+    if (this.numberOfTouches > this.numberOfTouchesRequired) {
+      this.setState('failed');
+      return;
+    }
+    if (this.numberOfTouches === touches.length) {
+      this.setTimer(event.time + this.maximumDuration, () => {
+        // A swipe already recognized, waiting on a recognizer it requires to
+        // fail, holds its recognition (spec:AST-094 FR15).
+        if (this.pending == null) {
+          this.setState('failed');
+        }
+      });
+    }
+    // Measure from where every required finger is down.
+    this.origin = centroid(this.touches.values());
+    this.last = null;
+  }
+
+  protected override touchesMoved(): void {
+    if (
+      this.pending != null ||
+      this.numberOfTouches !== this.numberOfTouchesRequired
+    ) {
+      return;
+    }
+    const current = centroid(this.touches.values());
+    const from = this.last ?? this.origin;
+    this.last = current;
+    for (const direction of this.directions) {
+      if (this.ruledOut.has(direction)) {
+        continue;
+      }
+      // Along and across this direction at the start and the end of the
+      // move. The path between two events is read as a straight segment, so
+      // the verdict does not depend on how far apart the events were.
+      const [along0, across0] = this.project(direction, from);
+      const [along1, across1] = this.project(direction, current);
+      const reaches = segmentCrossing(along0, along1, this.minimumDistance);
+      const strays = Math.max(
+        segmentCrossing(across0, across1, this.maximumSecondaryMovement),
+        segmentCrossing(-across0, -across1, this.maximumSecondaryMovement),
+      );
+      const strayAt = strays < 0 ? Infinity : strays;
+      if (reaches >= 0 && reaches <= strayAt) {
+        this.recognizedDirection = direction;
+        this.setState('ended');
+        return;
+      }
+      // Off-axis travel past the allowance, or the distance the wrong way,
+      // rules a direction out for good.
+      if (strays >= 0 || along1 <= -this.minimumDistance) {
+        this.ruledOut.add(direction);
+      }
+    }
+    if (this.directions.every(direction => this.ruledOut.has(direction))) {
+      this.setState('failed');
+    }
+  }
+
+  /** Travel along and across `direction` from the origin to `point`. */
+  private project(direction: SwipeDirection, point: Point): [number, number] {
+    const dx = point.x - this.origin.x;
+    const dy = point.y - this.origin.y;
+    return direction === 'left'
+      ? [-dx, dy]
+      : direction === 'right'
+        ? [dx, dy]
+        : direction === 'up'
+          ? [-dy, dx]
+          : [dy, dx];
+  }
+
+  protected override touchesEnded(): void {
+    // Recognized and waiting, it holds past the lift (FR15).
+    if (this.pending == null) {
+      this.setState('failed');
+    }
+  }
+
+  protected override reset(): void {
+    this.recognizedDirection = null;
+    this.ruledOut.clear();
+    this.last = null;
+    this.origin = {x: 0, y: 0};
+  }
+}
+
+/**
+ * Where on the segment from `start` to `end` (0 to 1) the value first
+ * reaches `limit`; 0 when it starts there, -1 when it never does.
+ */
+function segmentCrossing(start: number, end: number, limit: number): number {
+  if (start >= limit) {
+    return 0;
+  }
+  if (end < limit) {
+    return -1;
+  }
+  return (limit - start) / (end - start);
+}

package/src/gestures/TapGestureRecognizer.ts

@@ -43,6 +43,10 @@ export interface TapGestureRecognizerOptions extends GestureRecognizerOptions<Ta
 const TAP = UIKIT_TAP;
 
 export class TapGestureRecognizer extends GestureRecognizer {
+  override get kind(): GestureRecognizer['kind'] {
+    return 'tap';
+  }
+
   numberOfTapsRequired: number;
   numberOfTouchesRequired: number;
   allowableMovement: number;