Ripple Cursor

/**
 * Ripple Cursor — Click-triggered expanding ripple rings.
 * Category: interactive | Animate: true | Interactive: true | Complexity: low
 */
export default function rippleCursor(ctx, state) {
  const MAX_RADIUS = 80;
  const SPEED = 2.5;
  const COLOR = '99, 102, 241'; // indigo
  // Auto-demo: spawn ripples at these relative positions when user hasn't interacted
  const DEMO_POINTS = [
    [0.25, 0.4],
    [0.75, 0.6],
    [0.5, 0.3],
    [0.3, 0.65],
    [0.7, 0.35],
  ];

  const ripples = [];
  let lastDown = false;
  let hasInteracted = false;
  let demoIndex = 0;
  let lastDemoTime = 0;

  return {
    frame({ width, height, pointer, reducedMotion, time }) {
      // Real click — spawn at pointer position
      if (pointer.down && !lastDown && pointer.inside) {
        hasInteracted = true;
        ripples.push({ x: pointer.x, y: pointer.y, r: 0, alpha: 0.7 });
      }
      lastDown = pointer.down;
      if (pointer.inside) hasInteracted = true;

      // Auto-demo when no real interaction yet
      if (!hasInteracted && !reducedMotion && time - lastDemoTime > 0.9) {
        const [rx, ry] = DEMO_POINTS[demoIndex % DEMO_POINTS.length];
        ripples.push({ x: rx * width, y: ry * height, r: 0, alpha: 0.7 });
        demoIndex++;
        lastDemoTime = time;
      }

      if (reducedMotion) return;

      for (let i = ripples.length - 1; i >= 0; i--) {
        const rp = ripples[i];
        rp.r += SPEED;
        rp.alpha = 0.7 * (1 - rp.r / MAX_RADIUS);

        ctx.beginPath();
        ctx.arc(rp.x, rp.y, rp.r, 0, Math.PI * 2);
        ctx.strokeStyle = `rgba(${COLOR}, ${rp.alpha})`;
        ctx.lineWidth = 2;
        ctx.stroke();

        if (rp.r >= MAX_RADIUS) ripples.splice(i, 1);
      }
    },

    destroy() {
      ripples.length = 0;
    },
  };
}

<canvas id="canvas-effect" style="width:100%;height:400px;display:block" aria-hidden="true"></canvas>
<script>
/**
 * mountCanvas — Minimal runtime for Canvas effects.
 *
 * Handles HiDPI scaling, ResizeObserver, RAF loop, pointer tracking,
 * reduced-motion, and cleanup. The effect only implements draw logic.
 *
 * @param {HTMLCanvasElement} canvas
 * @param {(ctx: CanvasRenderingContext2D, state: object) => object} createEffect
 * @param {object} [options]
 * @returns {() => void} destroy function
 */
function mountCanvas(canvas, createEffect, options = {}) {
  const ctx = canvas.getContext('2d', { alpha: true });
  if (!ctx) throw new Error('2D context not available');

  const opts = {
    animate: true,
    clear: true,
    maxDpr: 2,
    pauseWhenHidden: true,
    respectReducedMotion: true,
    ...options,
  };

  const reducedMotion =
    opts.respectReducedMotion && window.matchMedia('(prefers-reduced-motion: reduce)').matches;

  const state = {
    canvas,
    ctx,
    width: 0,
    height: 0,
    pixelWidth: 0,
    pixelHeight: 0,
    dpr: 1,
    time: 0,
    delta: 0,
    frame: 0,
    playing: false,
    reducedMotion,
    pointer: { x: 0, y: 0, inside: false, down: false },
  };

  let rafId = 0;
  let lastTime = 0;
  let disposed = false;

  function measure() {
    const rect = canvas.getBoundingClientRect();
    const w = Math.max(1, rect.width);
    const h = Math.max(1, rect.height);
    const dpr = Math.min(window.devicePixelRatio || 1, opts.maxDpr);
    const pw = Math.round(w * dpr);
    const ph = Math.round(h * dpr);

    if (canvas.width !== pw || canvas.height !== ph) {
      canvas.width = pw;
      canvas.height = ph;
    }

    state.width = w;
    state.height = h;
    state.pixelWidth = pw;
    state.pixelHeight = ph;
    state.dpr = dpr;
    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
  }

  function clear() {
    ctx.clearRect(0, 0, state.width, state.height);
  }

  const effect = createEffect(ctx, state) || {};

  function onResize() {
    measure();
    effect.resize?.(state);
    if (!opts.animate || reducedMotion) {
      if (opts.clear) clear();
      effect.frame?.(state);
    }
  }

  function loop(now) {
    if (disposed) return;
    if (opts.pauseWhenHidden && document.hidden) {
      rafId = requestAnimationFrame(loop);
      return;
    }

    state.delta = lastTime ? (now - lastTime) / 1000 : 0;
    state.time = now / 1000;
    state.frame += 1;
    lastTime = now;

    if (opts.clear) clear();
    effect.frame?.(state);

    rafId = requestAnimationFrame(loop);
  }

  function onPointerMove(e) {
    const rect = canvas.getBoundingClientRect();
    state.pointer.x = e.clientX - rect.left;
    state.pointer.y = e.clientY - rect.top;
    if (!opts.animate || reducedMotion) {
      if (opts.clear) clear();
      effect.frame?.(state);
    }
  }
  function onPointerEnter() {
    state.pointer.inside = true;
  }
  function onPointerLeave() {
    state.pointer.inside = false;
    state.pointer.down = false;
  }
  function onPointerDown() {
    state.pointer.down = true;
  }
  function onPointerUp() {
    state.pointer.down = false;
  }

  const ro = new ResizeObserver(onResize);
  ro.observe(canvas);

  canvas.addEventListener('pointermove', onPointerMove);
  canvas.addEventListener('pointerenter', onPointerEnter);
  canvas.addEventListener('pointerleave', onPointerLeave);
  canvas.addEventListener('pointerdown', onPointerDown);
  window.addEventListener('pointerup', onPointerUp);

  measure();

  if (opts.animate && !reducedMotion) {
    state.playing = true;
    rafId = requestAnimationFrame(loop);
  } else {
    effect.frame?.(state);
  }

  return function destroy() {
    disposed = true;
    state.playing = false;
    cancelAnimationFrame(rafId);
    ro.disconnect();
    canvas.removeEventListener('pointermove', onPointerMove);
    canvas.removeEventListener('pointerenter', onPointerEnter);
    canvas.removeEventListener('pointerleave', onPointerLeave);
    canvas.removeEventListener('pointerdown', onPointerDown);
    window.removeEventListener('pointerup', onPointerUp);
    effect.destroy?.(state);
  };
}

/**
 * Ripple Cursor — Click-triggered expanding ripple rings.
 * Category: interactive | Animate: true | Interactive: true | Complexity: low
 */
const __effect = function rippleCursor(ctx, state) {
  const MAX_RADIUS = 80;
  const SPEED = 2.5;
  const COLOR = '99, 102, 241'; // indigo
  // Auto-demo: spawn ripples at these relative positions when user hasn't interacted
  const DEMO_POINTS = [
    [0.25, 0.4],
    [0.75, 0.6],
    [0.5, 0.3],
    [0.3, 0.65],
    [0.7, 0.35],
  ];

  const ripples = [];
  let lastDown = false;
  let hasInteracted = false;
  let demoIndex = 0;
  let lastDemoTime = 0;

  return {
    frame({ width, height, pointer, reducedMotion, time }) {
      // Real click — spawn at pointer position
      if (pointer.down && !lastDown && pointer.inside) {
        hasInteracted = true;
        ripples.push({ x: pointer.x, y: pointer.y, r: 0, alpha: 0.7 });
      }
      lastDown = pointer.down;
      if (pointer.inside) hasInteracted = true;

      // Auto-demo when no real interaction yet
      if (!hasInteracted && !reducedMotion && time - lastDemoTime > 0.9) {
        const [rx, ry] = DEMO_POINTS[demoIndex % DEMO_POINTS.length];
        ripples.push({ x: rx * width, y: ry * height, r: 0, alpha: 0.7 });
        demoIndex++;
        lastDemoTime = time;
      }

      if (reducedMotion) return;

      for (let i = ripples.length - 1; i >= 0; i--) {
        const rp = ripples[i];
        rp.r += SPEED;
        rp.alpha = 0.7 * (1 - rp.r / MAX_RADIUS);

        ctx.beginPath();
        ctx.arc(rp.x, rp.y, rp.r, 0, Math.PI * 2);
        ctx.strokeStyle = `rgba(${COLOR}, ${rp.alpha})`;
        ctx.lineWidth = 2;
        ctx.stroke();

        if (rp.r >= MAX_RADIUS) ripples.splice(i, 1);
      }
    },

    destroy() {
      ripples.length = 0;
    },
  };
}

const canvas = document.getElementById('canvas-effect');
mountCanvas(canvas, __effect, { animate: true, clear: true });
</script>