From 39f49de96d31fd713abe57427cb818d0e77f6009 Mon Sep 17 00:00:00 2001
From: Vanilagy <1696106+Vanilagy@users.noreply.github.com>
Date: Fri, 14 Aug 2026 11:15:25 +0200
Subject: [PATCH] Add explanatory doc comment

---
 src/input-track.ts | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/input-track.ts b/src/input-track.ts
index c941b58..2a6400d 100644
--- a/src/input-track.ts
+++ b/src/input-track.ts
@@ -51,7 +51,13 @@ export type FrameRateMetrics = {
 	 * frame-rate (VFR) video.
 	 */
 	underlyingFrameRate: number | null;
-	/** Mediabunny's best guess for the video's actual intended frame rate. */
+	/**
+	 * Mediabunny's best guess for the video's actual intended frame rate.
+	 *
+	 * This value is determined heuristically. If `underlyingFrameRate` exists, this field will be equal to it. If it
+	 * doesn't, Mediabunny will check if `medianFrameRate` is close to a "common" frame rate and if so, snap to it.
+	 * Otherwise, this field simply falls back to `medianFrameRate`.
+	 */
 	bestGuessFrameRate: number;
 	/**
 	 * The minimum frame rate of the video at any given point, based on the largest distance between two