mant-ir 0.11.0

Normalized, source-neutral document intermediate representation for ManT
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! Shared access to fields carried by most renderer-neutral block variants.
//!
//! Exhaustive accessors keep producers and consumers aligned as block variants
//! evolve. Reparenting mutates only moved roots, never descendant coordinates.

use crate::{Block, LayoutHint, SourceSpan};

/// Return a block's layout hint when its representation carries one.
#[must_use]
pub const fn block_layout(block: &Block) -> Option<&LayoutHint> {
    match block {
        Block::Paragraph { layout, .. }
        | Block::Preformatted { layout, .. }
        | Block::List { layout, .. }
        | Block::DefinitionList { layout, .. }
        | Block::Table { layout, .. }
        | Block::Equation { layout, .. }
        | Block::Unsupported { layout, .. } => Some(layout),
        Block::VerticalSpace { .. } | Block::ThematicBreak { .. } => None,
    }
}

/// Return a mutable block layout hint when its representation carries one.
#[must_use]
pub const fn block_layout_mut(block: &mut Block) -> Option<&mut LayoutHint> {
    match block {
        Block::Paragraph { layout, .. }
        | Block::Preformatted { layout, .. }
        | Block::List { layout, .. }
        | Block::DefinitionList { layout, .. }
        | Block::Table { layout, .. }
        | Block::Equation { layout, .. }
        | Block::Unsupported { layout, .. } => Some(layout),
        Block::VerticalSpace { .. } | Block::ThematicBreak { .. } => None,
    }
}

/// Return the original source location attached to a block.
#[must_use]
pub const fn block_source(block: &Block) -> Option<SourceSpan> {
    match block {
        Block::Paragraph { source, .. }
        | Block::Preformatted { source, .. }
        | Block::List { source, .. }
        | Block::DefinitionList { source, .. }
        | Block::Table { source, .. }
        | Block::Equation { source, .. }
        | Block::VerticalSpace { source, .. }
        | Block::ThematicBreak { source }
        | Block::Unsupported { source, .. } => *source,
    }
}

/// Move already-relative roots between actual content origins. Descendants
/// remain relative to those roots and must never receive this translation.
/// Non-layout blocks, source spans, spacing and continuation offsets are unchanged.
/// Arithmetic saturates at the signed coordinate limits, without wrapping.
pub fn rebase_roots(blocks: &mut [Block], old_parent: i32, new_parent: i32) {
    for block in blocks {
        if let Some(layout) = block_layout_mut(block) {
            layout.indent_columns =
                super::rebase_origin(layout.indent_columns, old_parent, new_parent);
        }
    }
}

#[cfg(test)]
mod tests;