Function markPhaseAfterAnimationFrames

src/web-ui/src/shared/utils/startupTrace.ts:603–640

(
  trace: StartupTrace,
  phase: string,
  data?: TraceData,
  options: DeferredAnimationFrameTraceOptions = {}
)

}

export function markPhaseAfterAnimationFrames(
  trace: StartupTrace,
  phase: string,
  data?: TraceData,
  options: DeferredAnimationFrameTraceOptions = {}
): void {
  const frameCount = Math.max(1, Math.floor(options.frameCount ?? 2));
  const now = options.now ?? (() => globalThis.performance?.now?.() ?? Date.now());
  const requestFrame = options.requestAnimationFrame ?? globalThis.requestAnimationFrame?.bind(globalThis);
  const startedAt = now();

  if (!requestFrame) {
    trace.markPhase(phase, {
      ...(data ?? {}),
      frameCount: 0,
      durationMs: 0,
    });
    return;
  }

  let remainingFrames = frameCount;
  const scheduleNextFrame = () => {
    requestFrame(() => {
      remainingFrames -= 1;
      if (remainingFrames <= 0) {
        trace.markPhase(phase, {
          ...(data ?? {}),
          frameCount,
          durationMs: roundDurationMs(now() - startedAt),
        });
        return;
      }
      scheduleNextFrame();
    });
  };

  scheduleNextFrame();
}