Function scrollLinux

src/platforms/linux/input-actions.ts:178–226

(
  direction: ScrollDirection,
  options?: { amount?: number; pixels?: number; durationMs?: number },
)

const DEFAULT_SCROLL_CLICKS = 5;

export async function scrollLinux(
  direction: ScrollDirection,
  options?: { amount?: number; pixels?: number; durationMs?: number },
): Promise<Record<string, unknown>> {
  const provider = resolveLinuxInputProvider();
  if (provider) {
    await provider.scroll(direction, options);
    return scrollDurationResult(options);
  }

  const { tool } = await ensureInputTool();

  // Translate amount/pixels into a discrete click count.
  // xdotool button clicks scroll ~15px each (3 lines × 5px).
  // ydotool wheel units are ~40px each.
  let scrollCount = DEFAULT_SCROLL_CLICKS;
  if (options?.pixels != null) {
    scrollCount =
      tool === 'xdotool'
        ? Math.max(1, Math.round(options.pixels / 15))
        : Math.max(1, Math.round(options.pixels / 40));
  } else if (options?.amount != null) {
    // amount is a fraction (0–1+) of the viewport; scale relative to default
    scrollCount = Math.max(1, Math.round(DEFAULT_SCROLL_CLICKS * (options.amount / 0.6)));
  }

  // xdotool: button 4=up, 5=down, 6=left, 7=right
  if (tool === 'xdotool') {
    const button =
      direction === 'up' ? '4' : direction === 'down' ? '5' : direction === 'left' ? '6' : '7';
    await runPacedScrollSteps(scrollCount, options?.durationMs, async (stepCount) => {
      await xdotool('click', '--repeat', String(stepCount), button);
    });
  } else {
    // ydotool: wheel events use positive/negative values
    if (direction === 'up' || direction === 'down') {
      await runPacedScrollSteps(scrollCount, options?.durationMs, async (stepCount) => {
        const stepValue = direction === 'up' ? String(-stepCount) : String(stepCount);
        await ydotool('mousemove', '--wheel', '-y', stepValue);
      });
    } else {
      await runPacedScrollSteps(scrollCount, options?.durationMs, async (stepCount) => {
        const stepValue = direction === 'left' ? String(-stepCount) : String(stepCount);
        await ydotool('mousemove', '--wheel', '-x', stepValue);
      });
    }
  }
  return scrollDurationResult(options);
}

async function runPacedScrollSteps(
  totalCount: number,