Skip to content

TimelineOffset

TimelineOffset = number | `${number}%` | string

Defined in: timelineOffset.ts:27

A position within the final video. Numbers are absolute milliseconds. Strings accept:

  • 'm:ss(.f)' timecode minutes:seconds, e.g. '0:05.51' (= 5.51s)
  • 'h:mm:ss(.f)' timecode hours:minutes:seconds, e.g. '1:02:03.5'
  • '<n>%' percentage of the total video, e.g. '56.1%'

The template-literal members give editor hints for the common forms; the trailing string keeps timecodes (which the type system cannot express) assignable. Validation happens at runtime in parseTimelineOffset.