Function runDirectPressSeries

src/core/dispatch-interactions.ts:498–538

(
  interactor: Interactor,
  x: number,
  y: number,
  series: PressSeriesOptions,
)

}

async function runDirectPressSeries(
  interactor: Interactor,
  x: number,
  y: number,
  series: PressSeriesOptions,
): Promise<Record<string, unknown>> {
  let interactionResult: Record<string, unknown> | undefined;
  await runRepeatedSeries(series.count, series.intervalMs, async (index) => {
    const [dx, dy] = computeDeterministicJitter(index, series.jitterPx);
    const targetX = x + dx;
    const targetY = y + dy;
    // `??=` must not guard the awaited call itself: that would short-circuit
    // every press after the first. Only the first result is kept.
    if (series.doubleTap) {
      const result = await interactor.doubleTap(targetX, targetY);
      interactionResult ??= result ?? undefined;
      return;
    }
    if (series.holdMs > 0) {
      const result = await interactor.longPress(targetX, targetY, series.holdMs);
      interactionResult ??= result ?? undefined;
    } else {
      const result = await interactor.tap(targetX, targetY);
      interactionResult ??= result ?? undefined;
    }
  });

  return withSuccessText(
    {
      x,
      y,
      count: series.count,
      intervalMs: series.intervalMs,
      holdMs: series.holdMs,
      jitterPx: series.jitterPx,
      doubleTap: series.doubleTap,
      ...interactionResult,
    },
    formatPressMessage({ x, y }),
  );
}

function runnerOptionsFromContext(context: DispatchContext | undefined): RunnerCallOptions {
  return {