Function makeDebouncer

src/artifacts/live-server.ts:79–87

(fn: () => void, ms: number)

/** A trailing debouncer: N rapid calls collapse into one invocation after `ms` of quiet.
 *  Returned function exposes `.cancel()` to clear a pending call (used on close). */
export function makeDebouncer(fn: () => void, ms: number): (() => void) & { cancel: () => void } {
  let timer: ReturnType<typeof setTimeout> | null = null;
  const debounced = () => {
    if (timer) clearTimeout(timer);
    timer = setTimeout(() => { timer = null; fn(); }, ms);
  };
  debounced.cancel = () => { if (timer) { clearTimeout(timer); timer = null; } };
  return debounced;
}

/** Build the page served for GET / : current version → preview HTML → live-reload injected.
 *  Any failure becomes a valid error-overlay page (still hashable, still self-recovering). */