API reference / Common / Engine types / TextFragment

Interface: TextFragment

A sequence of story content to splice in — an ordered list of blocks whose boundary paragraphs fuse into the splice site.

A single-paragraph fragment inserts text with no break; an n-paragraph fragment introduces n − 1 paragraph breaks; the empty fragment is a pure delete. See TextStory::replace_range for the fusion contract.

Serialize/Deserialize make it a stable wire form so it can ride a TextCommand — a host issues a paste/insert as JSON — or a per-doc-type clipboard fragment.

Properties

Property	Description
blocks TextBlock[]	The blocks to splice in.