Function whenLayoutStable

web/components/HashScroller.tsx:146–183

* 等待 main 容器的 scrollHeight 稳定（连续 N 帧不变），表示 React 渲染 + layout 完成； * 然后回调。避免在元素 *出现* 但页面 *还在长高* 时计算错位置。 * * 兜底：超过 maxFrames 仍未稳定 → 仍调 callback 但通过 onTimeout 通知调用方 * （让 debug 模式能 warn"layout 未稳定但已尝试滚动"，方便排查异步图片 * 加载导致的位置漂移）。

(
  probeEl: HTMLElement,
  callback: () => void,
  onTimeout?: () => void,
)

 * 加载导致的位置漂移）。
 */
function whenLayoutStable(
  probeEl: HTMLElement,
  callback: () => void,
  onTimeout?: () => void,
) {
  const ancestor = findScrollableAncestor(probeEl);
  const measure = () =>
    ancestor instanceof Window
      ? document.documentElement.scrollHeight
      : ancestor.scrollHeight;

  let last = -1;
  let stableFrames = 0;
  let totalFrames = 0;
  const maxFrames = 40; // 约 650ms 兜底

  const tick = () => {
    totalFrames += 1;
    if (totalFrames > maxFrames) {
      onTimeout?.();
      callback();
      return;
    }
    const h = measure();
    if (h === last) {
      stableFrames += 1;
      if (stableFrames >= 3) {
        callback();
        return;
      }
    } else {
      last = h;
      stableFrames = 0;
    }
    requestAnimationFrame(tick);
  };
  requestAnimationFrame(tick);
}

// 调试开关：把 ?hashdebug=1 加到 URL 上启用
function isDebug(): boolean {