hyprlang 0.5.0

A scripting language interpreter and parser for Hyprlang and Hyprland configuration files.
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

// Hyprlang Grammar for pest parser
// Main configuration file parsing

WHITESPACE = _{ " " | "\t" }
NEWLINE = _{ "\r\n" | "\n" | "\r" }

// Top-level grammar
file = { SOI ~ (NEWLINE* ~ statement ~ NEWLINE*)* ~ EOI }

statement = _{
    comment |
    directive |
    variable_def |
    special_category_block |
    category_block |
    assignment
}

// Comments (including hyprlang directives)
comment = @{ "#" ~ (!NEWLINE ~ ANY)* }

// Source directive: source = ./file.conf
directive = { "source" ~ "=" ~ value }

// Variables: $VAR = value
variable_def = { "$" ~ ident ~ "=" ~ value }

// Assignments: key = value (value can be empty)
assignment = { key_path ~ "=" ~ value? }

// Handler calls: keyword [flags] = value
handler_call = { ident ~ flags? ~ "=" ~ value }
flags = { ident }

// Categories: category { ... }
category_block = { ident ~ "{" ~ (NEWLINE* ~ statement ~ NEWLINE*)* ~ "}" }

// Special categories: category[key] { ... } or category { ... }
special_category_block = { ident ~ category_key? ~ "{" ~ (NEWLINE* ~ statement ~ NEWLINE*)* ~ "}" }
category_key = { "[" ~ ident ~ "]" }

// Key paths: a:b:c
key_path = { ident ~ (":" ~ ident)* }

// Values
value = { multiline_value | single_value }

multiline_value = { single_value ~ ("\\" ~ NEWLINE ~ single_value)+ }

single_value = {
    expression |
    string_value
}

// Expressions: {{expr}}
expression = { "{{" ~ expr ~ "}}" }

expr = { term ~ (expr_op ~ term)* }
term = { number | "(" ~ expr ~ ")" | ident }
expr_op = { "+" | "-" | "*" | "/" }

// Variable references: $VAR
variable_ref = { "$" ~ ident }

// Colors: rgba(...) or rgb(...) or hex
color = { rgba_func | rgb_func | hex_color }

rgba_func = {
    "rgba" ~ "(" ~ (
        (hex_digits ~ ")") |
        (number ~ "," ~ number ~ "," ~ number ~ "," ~ number ~ ")")
    )
}

rgb_func = {
    "rgb" ~ "(" ~ number ~ "," ~ number ~ "," ~ number ~ ")"
}

hex_color = @{ "0x" ~ hex_color_digits }
hex_color_digits = @{ ASCII_HEX_DIGIT{6,8} }
hex_digits = @{ (ASCII_HEX_DIGIT)+ }

// Vec2: x, y (with optional parentheses)
vec2 = { "(" ~ number ~ "," ~ number ~ ")" | number ~ "," ~ number }

// Numbers: int, float, hex
number = @{
    hex_int |
    float |
    int
}

hex_int = @{ "0x" ~ hex_digits }
float = @{ "-"? ~ ASCII_DIGIT+ ~ "." ~ ASCII_DIGIT+ }
int = @{ "-"? ~ ASCII_DIGIT+ }

// Boolean (must be followed by whitespace or end of line, not other characters)
boolean = @{ ("true" | "false" | "on" | "off" | "yes" | "no") ~ &(WHITESPACE | NEWLINE | "#" | EOI) }

// Strings
string_value = @{
    quoted_string |
    unquoted_string
}

quoted_string = @{ "\"" ~ (!("\"") ~ ANY)* ~ "\"" }
unquoted_string = @{ ("##" | !(NEWLINE | "#") ~ ANY)+ }

// Identifiers (allow dots for things like col.active_border)
ident = @{ (ASCII_ALPHANUMERIC | "_" | "-" | ".")+ }