formalang 0.0.5-beta

FormaLang compiler frontend: lexer, parser, semantic analyzer, and IR lowering.
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

//! Struct/enum field error renderers: missing/unknown field,
//! immutable-binding assignment, positional arg in struct, enum-variant
//! data shape.

use super::super::ReportBuilder;
use super::{label, report};
use crate::location::Span;
use ariadne::{Color, Fmt};

pub(in crate::reporting) fn missing_field<'a>(
    filename: &'a str,
    span: Span,
    field: &'a str,
    type_name: &'a str,
) -> ReportBuilder<'a> {
    report(filename, span, "E064")
        .with_message(format!("Missing field '{field}'"))
        .with_label(label(filename, span).with_message(format!(
            "'{}' requires field '{}'",
            type_name,
            field.fg(Color::Red)
        )))
        .with_help(format!("Add '{field}: ...' to the expression"))
}

pub(in crate::reporting) fn unknown_field<'a>(
    filename: &'a str,
    span: Span,
    field: &'a str,
    type_name: &'a str,
) -> ReportBuilder<'a> {
    report(filename, span, "E065")
        .with_message(format!("Unknown field '{field}'"))
        .with_label(label(filename, span).with_message(format!(
            "'{}' has no field '{}'",
            type_name,
            field.fg(Color::Red)
        )))
}

pub(in crate::reporting) fn assignment_to_immutable(
    filename: &str,
    span: Span,
) -> ReportBuilder<'_> {
    report(filename, span, "E066")
        .with_message("Cannot assign to immutable binding")
        .with_label(label(filename, span).with_message("this binding is not mutable"))
        .with_help("Declare the binding with 'let mut' to allow assignment")
}

pub(in crate::reporting) fn positional_arg_in_struct<'a>(
    filename: &'a str,
    span: Span,
    struct_name: &'a str,
    position: usize,
) -> ReportBuilder<'a> {
    report(filename, span, "E067")
        .with_message("Positional argument in struct instantiation")
        .with_label(label(filename, span).with_message(format!(
            "argument {} is positional, but '{}' requires named arguments",
            position,
            struct_name.fg(Color::Red)
        )))
        .with_help("Use 'field: value' syntax for all arguments")
}

pub(in crate::reporting) fn enum_variant_without_data<'a>(
    filename: &'a str,
    span: Span,
    variant: &'a str,
    enum_name: &'a str,
) -> ReportBuilder<'a> {
    report(filename, span, "E068")
        .with_message(format!("Enum variant '{variant}' has no data"))
        .with_label(label(filename, span).with_message(format!(
            "'{}.{}' has no associated data — use '.{}' without parentheses",
            enum_name,
            variant.fg(Color::Red),
            variant
        )))
}

pub(in crate::reporting) fn enum_variant_requires_data<'a>(
    filename: &'a str,
    span: Span,
    variant: &'a str,
    enum_name: &'a str,
) -> ReportBuilder<'a> {
    report(filename, span, "E069")
        .with_message(format!("Enum variant '{variant}' requires data"))
        .with_label(label(filename, span).with_message(format!(
            "'{}.{}' must be instantiated with its associated fields",
            enum_name,
            variant.fg(Color::Red)
        )))
        .with_help(format!("Use {enum_name}.{variant}(field: value, ...)"))
}