From 5fee014186a30e73bb311bc56fdcb55ebc50c1c4 Mon Sep 17 00:00:00 2001
From: webadderall <131426131+webadderall@users.noreply.github.com>
Date: Tue, 2 Jun 2026 19:35:12 +1000
Subject: [PATCH] docs(webcam): document sync helpers

---
 src/components/video-editor/videoPlayback/webcamSync.ts | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/components/video-editor/videoPlayback/webcamSync.ts b/src/components/video-editor/videoPlayback/webcamSync.ts
index 27d310a5..f7cfbfb4 100644
--- a/src/components/video-editor/videoPlayback/webcamSync.ts
+++ b/src/components/video-editor/videoPlayback/webcamSync.ts
@@ -1,5 +1,9 @@
 import { clampMediaTimeToDuration } from "@/lib/mediaTiming";
 
+/**
+ * Maps the editor timeline time to the corresponding webcam media timestamp,
+ * accounting for any recorded webcam start offset and media duration clamps.
+ */
 export function getWebcamMediaTargetTimeSeconds({
 	currentTime,
 	webcamDuration,
@@ -16,6 +20,10 @@ export function getWebcamMediaTargetTimeSeconds({
 
 export const getWebcamPreviewTargetTimeSeconds = getWebcamMediaTargetTimeSeconds;
 
+/**
+ * Decides whether the webcam media element needs a corrective seek for the
+ * current preview frame, while avoiding repeated seeks during active media seeks.
+ */
 export function shouldSeekWebcamMedia({
 	desiredTime,
 	isPlaying,