Struct IrWalker 

struct IrWalker<'c, 'src> {
    cursor: SentinelCursor<'c, 'src>,
    top: Vec<IrBlock>,
    open: Vec<OpenContainer>,
}

Tree builder that consumes comrak nodes plus a sentinel cursor and emits IrBlocks into a stack-balanced container hierarchy.

The state mirrors crate::post_process’s SpliceState for the HTML side: same cursor, same balanced-container model, same orphan-close drain at end-of-document. They differ only in the emit target (string buffer vs. tree of Vec<IrBlock>).

Lifetimes:

• 'c is the lifetime of the registry slice the walker borrows (typically a local Vec<NodeRef<'src>> materialised at the call site).
• 'src is the arena/source lifetime that every borrowed [AozoraNode] payload references.

Fields

cursor: SentinelCursor<'c, 'src>

top: Vec<IrBlock>

Document-level blocks gathered so far. When a container is open, new blocks go onto its top-of-stack children instead.

open: Vec<OpenContainer>

Stack of currently-open paired containers. Each frame owns the blocks gathered between its open and (eventual) close marker.

Implementations

impl<'c, 'src> IrWalker<'c, 'src>

fn new(nodes: &'c [NodeRef<'src>]) -> Self

fn with_cursor_idx(nodes: &'c [NodeRef<'src>], idx: usize) -> Self

Construct a walker that resumes from a given cursor index in nodes. Used by StreamingIrBuilder to thread cursor state across per-block walks.

fn finish(self) -> Vec<IrBlock>

Consume the walker, draining any unclosed containers (mirror of the HTML splicer’s end-of-document orphan-close pass).

fn walk_root<'a>(&mut self, root: &'a AstNode<'a>)

fn walk_top<'a>(&mut self, node: &'a AstNode<'a>)

fn classify_paragraph<'a>( &self, node: &'a AstNode<'a>, ) -> Option<ParagraphAction<'src>>

Run a single descent over node’s text descendants, returning the most specific paragraph action (sole block sentinel or heading hint promotion) supported by the registry lookahead.

fn dispatch_paragraph( &mut self, action: ParagraphAction<'src>, source_line: u32, )

fn handle_block_sentinel(&mut self, kind: BlockSentinelKind, source_line: u32)

fn handle_heading_hint( &mut self, hint: &'src HeadingHint<'src>, sentinels_to_consume: usize, source_line: u32, )

fn walk_block<'a>( &mut self, node: &'a AstNode<'a>, top_level: bool, ) -> Option<IrBlock>

fn walk_table<'a>(&mut self, node: &'a AstNode<'a>, meta: TableMeta) -> IrBlock

fn collect_blocks<'a>(&mut self, node: &'a AstNode<'a>) -> Vec<IrBlock>

fn collect_list_items<'a>(&mut self, node: &'a AstNode<'a>) -> Vec<IrListItem>

fn collect_table_row<'a>(&mut self, row: &'a AstNode<'a>) -> IrTableRow

fn collect_inlines<'a>(&mut self, node: &'a AstNode<'a>) -> Vec<IrInline>

fn emit_inline<'a>(&mut self, node: &'a AstNode<'a>, out: &mut Vec<IrInline>)

fn project_text_with_sentinels( &mut self, text: &str, range: Option<Range>, out: &mut Vec<IrInline>, )