Screenplay revisions

A React block (a whole screen) in Beamline's CMS & media app.

A screenplay under revision for a production. The script in screenplay form (scene headings, action, character, parenthetical, dialogue, transitions) with its revision colour and date, each changed line starred in the margin in that colour and omitted lines kept; scenes listed with how many of their changes aren't in the breakdown yet, and the total said with a way into the review. A sync review scene by scene: each change added, changed or removed with its words before and after, what it does to the breakdown (elements added or removed, shots, page length), taken in or kept back one by one, the tally, and a sync that takes in the accepted changes and says what stayed back.

Use it for

Bringing a new script revision into a production's breakdown change by change.
Any source document whose changes feed a downstream plan and need review before they flow.

Not for

Tagging script text into elements or shots (signature words-to-structure).
A general document diff (versioned-document).

Anatomy

bar: revision colour, name, date, after which; Script and Sync review
script: changes not in the breakdown with Review the sync; scenes with not-synced counts; the page with starred changed lines and omitted lines
sync review: per scene each change's kind, before and after, effects, Take in or Keep back; tally and Sync

States

not synced
all synced
taken in
kept back
synced

Keyboard

Tab through scenes, decisions and Sync

Props

Prop	Type	Default	Description
`scenes` (required)	`ScriptScene[]`	—
`lines` (required)	`ScriptLine[]`	—
`changes` (required)	`ScriptChange[]`	—
`revision` (required)	`ScriptRevision`	—
`previous`	`string`	—	The revision before this one, by colour name.
`synced`	`string[]`	—	Changes already in the breakdown.
`defaultSynced`	`string[]`	—
`onSyncedChange`	`((ids: string[]) => void)`	—
`defaultDecisions`	`Record<string, ChangeDecision>`	—
`defaultScene`	`string`	—
`defaultTab`	`"script" \| "sync"`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`style`	`CSSProperties`	—	Inline styles on the documented visual root; no overrides by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

tabs
badge
segmented-control
button

Dependencies

lucide-react

Import

import { ScreenplayRevisions } from "@beamline/screenplay-revisions";

Get it

Screenplay revisions is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent