luau-syntax 0.732.0

Luau lexer, parser, AST, CST, and source utilities
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

use super::Parser;
use super::model::{Comment, CommentKind, HotComment};
use crate::location::Location;

#[derive(Debug, Default)]
pub(super) struct CommentState {
    hotcomments: Vec<HotComment>,
    comment_locations: Vec<Comment>,
    hotcomment_header: bool,
}

impl CommentState {
    pub(super) fn new() -> Self {
        Self {
            hotcomment_header: true,
            ..Self::default()
        }
    }

    pub(super) fn into_parts(self) -> (Vec<HotComment>, Vec<Comment>) {
        (self.hotcomments, self.comment_locations)
    }

    pub(in crate::parser) fn capture_comment(
        &mut self,
        capture_comments: bool,
        kind: CommentKind,
        location: Location,
    ) {
        if capture_comments {
            self.comment_locations.push(Comment { kind, location });
        }
    }

    pub(in crate::parser) fn capture_hotcomment(&mut self, text: &[u8], location: Location) {
        let Some(content) = text.strip_prefix(b"!") else {
            return;
        };
        let content = content
            .strip_suffix(b"\r\n")
            .or_else(|| content.strip_suffix(b"\n"))
            .or_else(|| content.strip_suffix(b"\r"))
            .unwrap_or(content)
            .trim_ascii_end();

        self.hotcomments.push(HotComment {
            header: self.hotcomment_header,
            location,
            content: content.to_vec(),
        });
    }

    pub(in crate::parser) fn finish_header(&mut self) {
        self.hotcomment_header = false;
    }
}

impl Parser<'_, '_, '_, '_> {
    pub(in crate::parser) fn capture_comment(&mut self, kind: CommentKind, location: Location) {
        self.comments
            .capture_comment(self.options.capture_comments(), kind, location);
    }

    pub(in crate::parser) fn capture_hotcomment(&mut self, text: &[u8], location: Location) {
        self.comments.capture_hotcomment(text, location);
    }

    pub(in crate::parser) fn finish_hotcomment_header(&mut self) {
        self.comments.finish_header();
    }
}