Struct Component 

pub struct Component {
    pub name: String,
    pub attrs: HashMap<String, String>,
    pub open_start: usize,
    pub open_end: usize,
    pub close_start: usize,
    pub close_end: usize,
}

A parsed component in a document.

Components are bounded regions marked by <!-- agent:name -->...<!-- /agent:name -->. Opening tags may contain inline attributes: <!-- agent:name key=value -->.

Fields

name: String

attrs: HashMap<String, String>

Inline attributes parsed from the opening tag (e.g., patch=append).

open_start: usize

Byte offset of < in opening marker.

open_end: usize

Byte offset past > in opening marker (includes trailing newline if present).

close_start: usize

Byte offset of < in closing marker.

close_end: usize

Byte offset past > in closing marker (includes trailing newline if present).

Implementations

impl Component

pub fn content<'a>(&self, doc: &'a str) -> &'a str

Extract the content between the opening and closing markers.

pub fn patch_mode(&self) -> Option<&str>

Get the patch mode from inline attributes.

Checks patch= first, falls back to mode= for backward compatibility.

pub fn replace_content(&self, doc: &str, new_content: &str) -> String

Replace the content between markers, returning the new document. The markers themselves are preserved.

pub fn append_with_caret( &self, doc: &str, content: &str, caret_offset: Option<usize>, ) -> String

Append content into this component, inserting before the caret position if the caret is inside the component. Falls back to normal append if the caret is outside the component.

caret_offset: byte offset of the caret in the document. Pass None for normal append behavior.

pub fn append_with_boundary( &self, doc: &str, content: &str, boundary_id: &str, ) -> String

Append content into this component at the boundary marker position.

Finds <!-- agent:boundary:ID --> inside the component. If found, inserts content at the line start of the boundary marker (replacing the marker). Falls back to normal append if the boundary is not found.

Trait Implementations

impl Clone for Component

fn clone(&self) -> Component

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Component

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Component

fn eq(&self, other: &Component) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Component

impl StructuralPartialEq for Component