windjammer 0.48.0

A simple language inspired by Go, Ruby, and Elixir that transpiles to Rust - 80% of Rust's power with 20% of the complexity
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
127
128
129

//! Shader AST - Abstract Syntax Tree for .wjsl shader modules

use std::fmt;

/// A complete shader module (one .wjsl file)
#[derive(Debug, Clone, PartialEq)]
pub struct ShaderModule {
    pub name: String,
    pub uniforms: Vec<UniformDecl>,
    pub storage: Vec<StorageDecl>,
    pub functions: Vec<Function>,
}

/// Uniform buffer declaration
#[derive(Debug, Clone, PartialEq)]
pub struct UniformDecl {
    pub name: String,
    pub ty: Type,
    pub binding: u32,
}

/// Storage buffer declaration
#[derive(Debug, Clone, PartialEq)]
pub struct StorageDecl {
    pub name: String,
    pub ty: Type,
    pub binding: u32,
    pub access: AccessMode,
}

/// Storage buffer access mode
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum AccessMode {
    Read,
    Write,
    #[default]
    ReadWrite,
}

/// Shader function (compute, vertex, fragment)
#[derive(Debug, Clone, PartialEq)]
pub struct Function {
    pub name: String,
    pub stage: ShaderStage,
    pub workgroup_size: Option<(u32, u32, u32)>,
    pub body: String, // Raw body for now; can be expanded to full AST later
}

/// Shader execution stage
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ShaderStage {
    Compute,
    Vertex,
    Fragment,
}

/// Shader type system
#[derive(Debug, Clone, PartialEq)]
pub enum Type {
    Scalar(ScalarType),
    Vec2(ScalarType),
    Vec3(ScalarType),
    Vec4(ScalarType),
    Mat4,
    Array(Box<Type>),
    Struct(String),
}

/// Scalar element type
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ScalarType {
    F32,
    F64,
    U32,
    I32,
    Bool,
}

impl fmt::Display for ScalarType {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            ScalarType::F32 => write!(f, "f32"),
            ScalarType::F64 => write!(f, "f64"),
            ScalarType::U32 => write!(f, "u32"),
            ScalarType::I32 => write!(f, "i32"),
            ScalarType::Bool => write!(f, "bool"),
        }
    }
}

impl fmt::Display for Type {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Type::Scalar(s) => write!(f, "{}", s),
            Type::Vec2(s) => write!(f, "Vec2<{}>", s),
            Type::Vec3(s) => write!(f, "Vec3<{}>", s),
            Type::Vec4(s) => write!(f, "Vec4<{}>", s),
            Type::Mat4 => write!(f, "Mat4"),
            Type::Array(inner) => write!(f, "array<{}>", inner),
            Type::Struct(name) => write!(f, "{}", name),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_scalar_type_display() {
        assert_eq!(format!("{}", ScalarType::F32), "f32");
        assert_eq!(format!("{}", ScalarType::U32), "u32");
    }

    #[test]
    fn test_type_display() {
        assert_eq!(format!("{}", Type::Vec2(ScalarType::F32)), "Vec2<f32>");
        assert_eq!(
            format!("{}", Type::Array(Box::new(Type::Vec4(ScalarType::F32)))),
            "array<Vec4<f32>>"
        );
    }

    #[test]
    fn test_type_equality() {
        assert_eq!(Type::Vec2(ScalarType::F32), Type::Vec2(ScalarType::F32));
        assert_ne!(Type::Vec2(ScalarType::F32), Type::Vec2(ScalarType::F64));
    }
}