AutoMovie API
    Preparing search index...

    Function locateOnBeat

    • Stamp beat-scoped feedback onto the screenplay graph: every violation produced while working beatId gains node, the id of the beat node that claims it, so scriptAncestors can cascade it up the refinement chain.

      When the tree is absent or no beat node claims beatId, the result is a shallow copy of the input list with no stamp. Otherwise each violation is copied with node set, replacing any node it already carried. The input list and its violations are never mutated.

      Parameters

      • violations: readonly IAutoMovieConstraintViolation[]

        Feedback produced while working the beat.

      • tree: readonly IAutoMovieScriptNode[] | null | undefined

        The script's refinement tree, or nothing when it has none.

      • beatId: string

        Flat script beat id the feedback belongs to.

      Returns IAutoMovieConstraintViolation[]

      A new list of the same length and order.