Enum Item 

pub enum Item {
    Heading {
        level: u8,
        inlines: Vec<Inline>,
        label: Option<String>,
        label_span: Option<SourceSpan>,
        span: SourceSpan,
    },
    Paragraph {
        inlines: Vec<Inline>,
        label: Option<String>,
        label_span: Option<SourceSpan>,
        span: SourceSpan,
    },
    Set {
        kind: DirectiveKind,
        name: String,
        args: Vec<SetArg>,
        span: SourceSpan,
    },
    RawBlock {
        kind: RawBlockKind,
        args: Vec<SetArg>,
        text: String,
        label: Option<String>,
        label_span: Option<SourceSpan>,
        span: SourceSpan,
    },
    List {
        ordered: bool,
        items: Vec<ListItem>,
        span: SourceSpan,
    },
}

Top-level construct in a .mos file.

Variants

Heading

= Title, == Subtitle, === Subsubtitle. A trailing <label> token after the title attaches to this heading.

Fields

level: u8

inlines: Vec<Inline>

label: Option<String>

label_span: Option<SourceSpan>

span: SourceSpan

Paragraph

One or more consecutive non-blank lines that are not a heading and not a #set block. A leading <label> token (possibly preceded by ASCII whitespace) attaches to this paragraph.

Fields

inlines: Vec<Inline>

label: Option<String>

label_span: Option<SourceSpan>

span: SourceSpan

Set

#set name(...), #image(...), #figure(...). The body is lexed into typed (key, value) args; semantic validation (known target/key, type coercion, sanity floors) happens in the lowerer. kind distinguishes the #set-style configuration directive from standalone calls like #image and #figure, which the lowerer dispatches to dedicated paths.

Fields

kind: DirectiveKind

name: String

args: Vec<SetArg>

span: SourceSpan

RawBlock

Raw preformatted text or code block. Both forms preserve their long-bracket body as text; the kind leaves room for later styling or language-aware code rendering.

Fields

kind: RawBlockKind

args: Vec<SetArg>

text: String

label: Option<String>

label_span: Option<SourceSpan>

span: SourceSpan

List

A bullet (- ) or numbered (\d+\. ) list. Sibling items at the same indent are grouped under one list; deeper indents become nested lists hanging off the most recent item. Numbered lists always renumber from 1 in MVP: explicit start: N is deferred.

Fields

ordered: bool

items: Vec<ListItem>

span: SourceSpan

Implementations

impl Item

pub fn as_heading(&self) -> Option<(u8, &[Inline], &SourceSpan)>

Borrow the heading payload if self is Item::Heading.

pub fn as_paragraph(&self) -> Option<(&[Inline], &SourceSpan)>

Borrow the paragraph payload if self is Item::Paragraph.

pub fn as_set(&self) -> Option<(&str, &[SetArg], &SourceSpan)>

Borrow the directive payload if self is Item::Set.

The returned tuple is (name, args, span); the caller can also reach DirectiveKind via Self::directive_kind. The accessor name is retained for back-compat; every existing caller pre-dates the #image/#figure directives and only looks at name/args/span.

pub fn as_raw_block(&self) -> Option<RawBlockView<'_>>

Borrow the raw block payload if self is Item::RawBlock.

pub fn directive_kind(&self) -> Option<DirectiveKind>

Borrow the DirectiveKind tag if self is Item::Set.

pub fn as_list(&self) -> Option<(bool, &[ListItem], &SourceSpan)>

Borrow the list payload if self is Item::List. The returned tuple is (ordered, items, span).

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

Borrow the explicit <label> attached to this block, if any. Returns None for Item::Set and Item::List (label syntax is not yet defined on those blocks).

pub fn label_span(&self) -> Option<&SourceSpan>

Borrow the source span covering only the label token text, if any. The delimiters (<, >, or directive string quotes) are excluded so a structured suggestion can replace just the label bytes.

Trait Implementations

impl Clone for Item

fn clone(&self) -> Item

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Item

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

Formats the value using the given formatter.