moveCursorTo function exported

export function moveCursorTo(
  target: string | Element,
  durationMs = 400,
): Promise<void> {
  return new Promise((resolve) => {
    if (!cursorEl) {
      resolve();
      return;
    }

    const el =
      typeof target === "string" ? document.querySelector(target) : target;

    if (!el) {
      log.warn("Cursor target not found:", target);
      resolve();
      return;
    }

    const rect = el.getBoundingClientRect();
    const targetX = rect.left + rect.width / 2 - CURSOR_SIZE / 2;
    const targetY = rect.top + rect.height / 2 - CURSOR_SIZE / 2;

    // First call: teleport instantly so cursor appears at the correct position
    // rather than animating from (0, 0) top-left corner.
    const moveDuration = isPositioned ? durationMs : 0;
    isPositioned = true;

    cursorEl.style.transitionDuration = `${moveDuration}ms`;
    cursorEl.style.transform = `translate(${targetX}px, ${targetY}px)`;

    currentX = targetX;
    currentY = targetY;

    // If teleporting (duration=0) resolve immediately after next frame;
    // otherwise wait for the CSS transition to finish.
    if (moveDuration === 0) {
      requestAnimationFrame(() => resolve());
      return;
    }

    const onEnd = () => {
      cursorEl?.removeEventListener("transitionend", onEnd);
      resolve();
    };
    cursorEl.addEventListener("transitionend", onEnd);

    // Safety timeout in case transitionend doesn't fire
    setTimeout(resolve, durationMs + 50);
  });
}