Options
PromptBar is controlled — the parent ownsvalue, attachments, and the transcription feed — and derives its mode from them. It supports an attachment row, a voice-transcription entry point, and a customizable disclaimer line.
With Text
Once there’s text, the editor rises to its own row above the controls, and the primary action switches from disabled to send.Attachments
Attachments render as thumbnail tiles in a row above the editor; adding one expands the row and reflows the bar. A tile without athumbnailUrl falls back to showing the file name.
Transcribing
transcription.active switches the bar into a distinct mode: the attach and mic controls are replaced by a Cancel button, an animated waveform, and a Done primary action. Prefer wiring real audio into transcription.source (a MediaStream, an AnalyserNode, or a computed amplitude); fall back to a named preset (ambient / speaking / thinking) only when none is available. Setting transcription.error instead swaps in an error layout — an error icon, the message, and Done dismisses the error and exits.
Disclaimer
A disclaimer line sits below the bar, with a “Learn more” link out to more information.Disabled
disabled dims the whole bar and blocks the editor, attachments, and every action.