AutoMovie API
    Preparing search index...

    Interface IAutoMovieBeatPayload

    The script tree's authored beat leaf holds direction, dialogue and caption and joins the flat beat list one to one by beat id. performShot defaults compiled identity to shot: plus that beat, while an explicit caller shotId may differ.

    validateScriptTree refuses a beat that names no script beat or one another beat node already claims, a dialogue anchor that is negative or not finite, and, when a tree is present, a script beat no beat node refines. Project validation also requires a non-empty direction and, when present, a non-blank caption.

    interface IAutoMovieBeatPayload {
        beat: string;
        caption: string | null;
        dialogue: IAutoMovieDialogueLine[];
        direction: string;
    }
    Index
    beat: string

    Id of the flat IAutoMovieScript.beats entry this node refines.

    caption: string | null

    How this shot should read, for the human reviewer and the diffusion pass, or null for no caption. planCaptionSidecar exports it through beatCaptions, and renderScreenplay prints it as a [Shot: ...] line.

    Spoken lines in order, possibly empty.

    direction: string

    Stage direction: what happens, in non-empty prose. renderScreenplay prints it under the beat heading.