[mynetfocus]

Summary

LyricOverlay hardcoded its frame rate and its length, and had no way to play a soundtrack. That makes it hard to use for anything but the fixture it shipped with: a 25 fps song rendered at 30, and the composition's duration had to be edited in source.

This adds calculateLyricOverlayMetadata so fps and duration come from the props, an optional soundtrack, and a lyric band that holds up in portrait as well as landscape.

Related issue

None.

Changes

• calculateLyricOverlayMetadata derives durationInFrames and fps from the props, so the composition no longer fixes either in source.
• Optional soundtrack, with the video's own audio kept at a settable volume.
• Lyric band sizes and wraps from the frame's short side rather than a landscape assumption, so portrait renders no longer overflow.
• Soundtrack is exported from CinematicRenderer so compositions share one implementation instead of each growing their own.

Testing

• Rendered portrait (1080×1920) on the video's own audio and landscape (1920×1080) muted under a soundtrack; lyric lines land in the band in both, and the mid-fade frame is identical at 30 and 60 fps.
• A spec whose audio is entirely silent is refused before rendering rather than producing a silent video.
• tsc --noEmit clean on this branch against remotion-composer's own tsconfig (strict: true).

Checklist

• The change is focused on a single logical concern.
• I ran the relevant tests locally (make test-contracts / make test) where applicable. — those run pytest tests/, the Python side; this is TypeScript only, inside remotion-composer/, which those suites do not cover.
• I updated docs/README if behavior or usage changed. — props are additive and default to the previous behaviour.
• No unrelated files (build artifacts, local config) are included in the diff.

[calesthio]

Thanks for extending LyricOverlay with metadata-driven fps/duration, footage trimming and soundtrack reuse. Reviewed all three changed files against current main: defaults remain 30 fps/28 seconds, animation constants scale by fps, the composition registers calculateMetadata, and video/audio options pass through to the existing media components. The next-line clamp and portrait/landscape scaling are coherent. Static review only on this host: the Remotion node dependencies are absent, so I did not claim a TypeScript build or visual render. Please retain representative short/back-to-back lyric renders in the normal render validation.