brink-ir 0.0.3

Intermediate representations for inkle's ink narrative scripting language
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use brink_syntax::ast::{self, AstNode, SyntaxNodePtr};

use crate::{Block, DiagnosticCode, Sequence, SequenceType, Stmt};

use super::super::block::{lower_branch_body, wrap_content_as_block};
use super::super::context::{LowerScope, LowerSink, Lowered};
use super::LowerSequence;

// ── SequenceWithAnnotation (inline or block) ────────────────────────

impl LowerSequence for ast::SequenceWithAnnotation {
    fn lower_sequence(&self, scope: &LowerScope, sink: &mut impl LowerSink) -> Lowered<Sequence> {
        let kind = lower_sequence_type(self);

        let branches = if let Some(inline_branches) = self.inline_branches() {
            inline_branches
                .branches()
                .map(|b| wrap_content_as_block(b.syntax(), scope, sink))
                .collect()
        } else if let Some(ml_branches) = self.multiline_branches() {
            ml_branches
                .branches()
                .map(|b| {
                    b.body().map_or_else(Block::default, |body| {
                        lower_branch_body(body.syntax(), scope, sink)
                    })
                })
                .collect()
        } else {
            return Err(sink.diagnose(self.syntax().text_range(), DiagnosticCode::E021));
        };

        Ok(Sequence {
            ptr: SyntaxNodePtr::from_node(self.syntax()),
            kind,
            branches,
            container_id: None,
        })
    }
}

// ── ImplicitSequence ────────────────────────────────────────────────

impl LowerSequence for ast::ImplicitSequence {
    fn lower_sequence(&self, scope: &LowerScope, sink: &mut impl LowerSink) -> Lowered<Sequence> {
        let branches: Vec<Block> = self
            .branches()
            .map(|b| wrap_content_as_block(b.syntax(), scope, sink))
            .collect();
        Ok(Sequence {
            ptr: SyntaxNodePtr::from_node(self.syntax()),
            kind: SequenceType::STOPPING,
            branches,
            container_id: None,
        })
    }
}

// ─── Block-level sequence ───────────────────────────────────────────

/// Lower a `SequenceWithAnnotation` as a block-level sequence (leading
/// `EndOfLine` per branch). Used by multiline block promotion.
pub fn lower_block_sequence(
    seq: &ast::SequenceWithAnnotation,
    scope: &LowerScope,
    sink: &mut impl LowerSink,
) -> Sequence {
    let kind = lower_sequence_type(seq);
    let branches = seq.multiline_branches().map_or_else(Vec::new, |ml| {
        ml.branches()
            .map(|b| {
                let mut block = b.body().map_or_else(Block::default, |body| {
                    lower_branch_body(body.syntax(), scope, sink)
                });
                block.stmts.insert(0, Stmt::EndOfLine);
                block
            })
            .collect()
    });
    Sequence {
        ptr: SyntaxNodePtr::from_node(seq.syntax()),
        kind,
        branches,
        container_id: None,
    }
}

pub(super) fn lower_sequence_type(seq: &ast::SequenceWithAnnotation) -> SequenceType {
    let mut kind = SequenceType::empty();

    if let Some(sym) = seq.symbol_annotation() {
        if sym.amp_token().is_some() {
            kind |= SequenceType::CYCLE;
        }
        if sym.bang_token().is_some() {
            kind |= SequenceType::ONCE;
        }
        if sym.tilde_token().is_some() {
            kind |= SequenceType::SHUFFLE;
        }
        if sym.dollar_token().is_some() {
            kind |= SequenceType::STOPPING;
        }
    }

    if let Some(word) = seq.word_annotation() {
        if word.stopping_kw().is_some() {
            kind |= SequenceType::STOPPING;
        }
        if word.cycle_kw().is_some() {
            kind |= SequenceType::CYCLE;
        }
        if word.shuffle_kw().is_some() {
            kind |= SequenceType::SHUFFLE;
        }
        if word.once_kw().is_some() {
            kind |= SequenceType::ONCE;
        }
    }

    if kind.is_empty() {
        SequenceType::STOPPING
    } else {
        kind
    }
}