Refresh paused previews after zoom edits

src/components/video-editor/AnnotationOverlay.tsx

@@ -40,6 +40,7 @@ function clampPercent(value: number) {
 	return Math.min(100, Math.max(0, value));
 }
 
+/** Render an annotation in preview space with editor drag and resize controls. */
 export function AnnotationOverlay({
 	annotation,
 	isSelected,

src/components/video-editor/VideoPlayback.tsx

@@ -1252,6 +1252,9 @@ const VideoPlayback = forwardRef<VideoPlaybackRef, VideoPlaybackProps>(
 
 		useEffect(() => {
 			zoomRegionsRef.current = zoomRegions;
+			if (!isPlayingRef.current) {
+				shouldSnapPausedFrameRef.current = true;
+			}
 		}, [zoomRegions]);
 
 		useEffect(() => {

src/components/video-editor/videoPlayback/videoEventHandlers.ts

@@ -27,6 +27,10 @@ interface VideoEventHandlersParams {
 	speedRegionsRef: React.MutableRefObject<SpeedRegion[]>;
 }
 
+/**
+ * Bind media events to the preview's presented-frame clock while honoring trim
+ * and speed regions.
+ */
 export function createVideoEventHandlers(params: VideoEventHandlersParams) {
 	const {
 		video,

src/lib/exporter/captionRenderer.ts

@@ -15,6 +15,7 @@ import {
 } from "@/components/video-editor/types";
 import { drawSquircleOnCanvas } from "@/lib/geometry/squircle";
 
+/** Draw the active caption using the same typography and timing as preview. */
 export function renderCaptions(
 	ctx: CanvasRenderingContext2D,
 	cues: CaptionCue[],

src/lib/exporter/frameRenderer.ts

@@ -1661,6 +1661,7 @@ export class FrameRenderer {
 		};
 	}
 
+	/** Advance the export camera from the shared scene target at this media time. */
 	private updateAnimationState(timeMs: number): number {
 		if (!this.cameraContainer || !this.layoutCache) return 0;
 

src/lib/exporter/modernFrameRenderer.ts

@@ -3343,6 +3343,7 @@ export class FrameRenderer {
 		}
 	}
 
+	/** Advance the export camera from the shared scene target at this media time. */
 	private updateAnimationState(timeMs: number): number {
 		if (!this.cameraContainer || !this.layoutCache) {
 			return 0;

src/lib/exporter/modernVideoExporter.ts

@@ -2096,6 +2096,7 @@ export class ModernVideoExporter {
 		);
 	}
 
+	/** Build deterministic per-frame camera transforms for native compositors. */
 	private getNativeStaticLayoutZoomTelemetry(
 		layout: ReturnType<typeof computePaddedLayout>,
 		totalFrames: number,