Research synthesis

A React block (a whole screen) in Beamline's Research & design app.

A research study turned into evidence in one place. Transcripts: passages marked as accepted highlights or as the assistant's suggestions (dashed); suggestions to review with the passage, the assistant's reason (said to be a reason, not evidence) and tags; Accept puts exactly that passage into evidence and onto the canvas, Reject keeps the decision with its range, either can be undone; a suggestion made on an older transcript revision says the passage may not line up and can't be accepted. Measured silences as their own rows above a chosen threshold, with a note on the measured interval (a higher threshold hides the row but keeps the note and says so); no audio means silences can't be measured. Canvas: accepted highlights and sticky notes as cards dragged or moved with the arrow keys, selected and grouped; suggested groups dashed until kept or dismissed; deleting a group asks whether its cards stay, never touching interviews; a card whose interview was removed stays as an unavailable source; a collaborator's view can be followed; viewing only opens sources. Ask: an answer sentence by sentence with numbered sources that preview the exact words and open the transcript with the passage lit; an unsupported sentence says so; a source you can't open shows none of its words; no answer says so.

Use it for

A research repository where interviews become highlights, groups and answers that cite their passages.
Reviewing AI-suggested evidence without letting the suggestion stand in for the source.

Not for

Playing a recording with word-level timing (transcript-viewer).
A clinician's notes after a session (session-notes).

Anatomy

bar: the study, how many highlights are in evidence; Transcripts, Canvas or Ask
transcripts: interviews with pending counts; Mark silences and its threshold; the transcript (time, speaker, words with marks) with silence rows and their notes; suggestions to review and the reviewed ones
canvas: Suggest groups, the selection and Group selected, people here with Follow; the board with groups (kept or suggested) and cards (highlight, note or unavailable source), a followed person's view; the delete question
ask: the question, the answer's sentences with numbered sources or the unsupported mark, the source preview

States

suggestion: suggested, reason visible, accepted, rejected, source changed, read only
silence: detection off, measuring, silent interval, annotated, threshold changed (note kept), audio unavailable
canvas: empty, cards selected, group suggested, manual group, missing source, viewing only, following a collaborator
answer: answering, ready, citation focused, source unavailable, no supported answer
narrow room: columns stack

Keyboard

Tab reaches every interview, suggestion, card and source; Enter or Space picks; arrow keys move a focused card (Shift for larger steps)

Motion

Marks ease when a passage is lit; a dragged card lifts and follows the pointer, groups ease to fit their cards; answer sentences fade in as they arrive. Nothing runs at rest.

Props

Prop	Type	Default	Description
`study` (required)	`string`	—	The study's name.
`interviews` (required)	`Interview[]`	—
`suggestions`	`Suggestion[]`	—
`defaultSuggestions`	`Suggestion[]`	—
`onSuggestionsChange`	`((s: Suggestion[]) => void)`	—
`highlights`	`Highlight[]`	—
`defaultHighlights`	`Highlight[]`	—
`onHighlightsChange`	`((h: Highlight[]) => void)`	—
`notes`	`SilenceNote[]`	—
`defaultNotes`	`SilenceNote[]`	—
`onNotesChange`	`((n: SilenceNote[]) => void)`	—
`cards`	`CanvasCard[]`	—
`defaultCards`	`CanvasCard[]`	—
`onCardsChange`	`((c: CanvasCard[]) => void)`	—
`groups`	`CanvasGroup[]`	—
`defaultGroups`	`CanvasGroup[]`	—
`onGroupsChange`	`((g: CanvasGroup[]) => void)`	—
`collaborators`	`Collaborator[]`	—	People on the canvas with you.
`canEdit`	`boolean`	—	May review suggestions, annotate and arrange the canvas. Default true.
`onSuggestGroups`	`((cards: CanvasCard[]) => Promise<CanvasGroup[]>)`	—	Suggests groups for the canvas's cards.
`onAsk`	`AskInterviews`	—	Answers a question sentence by sentence, each with the excerpts behind it.
`defaultView`	`ResearchSynthesisView`	—
`defaultInterview`	`string`	—
`defaultSilences`	`boolean`	—
`defaultThreshold`	`number`	—
`defaultQuestion`	`string`	—
`defaultAnswer`	`AnswerSentence[]`	—
`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

segmented-control
switch
slider
textarea
button
avatar-group
hover-card
input
skeleton

Dependencies

lucide-react

Import

import { ResearchSynthesis } from "@beamline/research-synthesis";

Get it

Research synthesis 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