AutoMovie API
    Preparing search index...

    Build a playback layout and the shot index its frame and event consumers share.

    The sequence must have passed cutSequence: trims and overlaps already fit their source spans. This preparation still refuses empty cuts, duplicate supplied shot ids, missing referenced shots and a first-entry transition. Extra supplied shots are indexed but do not add playback entries.

    type IResult = {
        shotById: ReadonlyMap<string, { index: number; shot: IAutoMovieShot }>;
        timeline: IAutoMoviePlaybackTimeline;
    }
    Index
    shotById: ReadonlyMap<string, { index: number; shot: IAutoMovieShot }>

    New index of every supplied shot, including unused shots. Map values are new wrappers but shot references are borrowed; keep shots stable while consuming the prepared layout.

    New mutable playback entries and total runtime in output seconds. Entry starts subtract incoming transition duration from the prior cursor, so transition spans overlap.