@mui/x-internal-gestures/testing/gestures/PinchUserGesture.types.d.ts

The core engine of GestureEvents, a modern and robust multi-pointer gesture detection library for JavaScript.

import { Pointers } from "../types/Pointers.js";
export type PinchUserGestureOptions = {
  /**
   * The target element to start the pinch on.
   */
  target: Element;
  /**
   * The pointers configuration to be used.
   *
   * It can be an object with the amount and distance properties, or an array of pointers.
   *
   * @default
   * { amount: 2, distance: 50 }
   */
  pointers?: Pointers;
  /**
   * The distance to pinch by in pixels.
   *
   * ```ts
   *   0 // No pinch
   *  50 // Pinch out
   * -50 // Pinch in
   * ```
   */
  distance: number;
  /**
   * The duration of the pinch in milliseconds.
   *
   * @default 500
   */
  duration?: number;
  /**
   * The amount of steps to be performed.
   *
   * @default 10
   */
  steps?: number;
  /**
   * The angle of the pinch in degrees.
   *
   * ```ts
   * 0 // Horizontal pinch
   * 90 // Vertical pinch
   * 45 // Diagonal pinch
   * ```
   *
   * @default 0
   */
  angle?: number;
  /**
   * Defines if the pointers should be released after the pinch gesture.
   *
   * If set to true, all pointers will be released.
   * If set to an array of ids, only the pointers with the given ids will be released.
   * If set to false, no pointers will be released.
   *
   * Useful for running expects while the pointers are still pressed.
   * Or to test partially releasing pointers.
   *
   * @default true
   */
  releasePointers?: boolean | number[];
};
export type PinchUserGestureRoot = {
  /**
   * Sets up the pinch gesture with the given options.
   *
   * @param {PinchUserGestureOptions} options - Configuration for the pinch gesture
   * @returns {Promise<void>} A promise that resolves when the gesture is complete
   */
  pinch: (options: PinchUserGestureOptions) => Promise<void>;
};