Struct Section 

pub struct Section {
    pub heading: Option<String>,
    pub depth: u8,
    pub text: String,
    pub byte_range: Range<usize>,
}

A hierarchical text region extracted from a source.

Produced by parsers in crate::md / crate::text and consumed by chunkers in crate::chunk. The byte_range always refers to offsets in the original source input (not the post-parse normalized text), so downstream stages can slice back into the raw document for diffing or provenance tracking.

Heading depth uses CommonMark’s 1-indexed convention (# H1 → 1). A depth of 0 indicates “no heading” (e.g. top-of-file prose before any heading, or the synthetic root produced by crate::text::parse_text).

Fields

heading: Option<String>

Heading text, without the leading # markers and trimmed.

depth: u8

Heading depth (1–6 for actual headings, 0 for headless prose).

text: String

Body text contained under this heading (code blocks are kept intact).

byte_range: Range<usize>

Byte range in the original source input.

Trait Implementations

impl Clone for Section

fn clone(&self) -> Section

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Section

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Section

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Section

fn eq(&self, other: &Section) -> 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 Serialize for Section

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Section

impl StructuralPartialEq for Section