aver-lang 0.8.2

Interpreter and transpiler for Aver, a statically-typed language designed for AI-assisted development
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

/// Option namespace — combinators for Option<T>.
///
/// Methods:
///   Option.withDefault(option, default) → T              — unwrap Some or return default
///   Option.toResult(option, err)        → Result<T, E>   — convert Option to Result
///
/// Constructors (Some, None) are registered separately in interpreter/core.rs.
/// No effects required.
use std::collections::HashMap;

use crate::nan_value::{Arena, NanValue};
use crate::value::{RuntimeError, Value};

pub fn register(global: &mut HashMap<String, Value>) {
    // Option namespace already exists (created in interpreter/core.rs for Some/None).
    // We merge our members into it via a separate step in core.rs.
    let _ = global;
}

/// Members to merge into the existing Option namespace.
pub fn extra_members() -> Vec<(&'static str, String)> {
    vec![
        ("withDefault", "Option.withDefault".to_string()),
        ("toResult", "Option.toResult".to_string()),
    ]
}

pub fn effects(_name: &str) -> &'static [&'static str] {
    &[]
}

pub fn call(name: &str, args: &[Value]) -> Option<Result<Value, RuntimeError>> {
    match name {
        "Option.withDefault" => Some(with_default(args)),
        "Option.toResult" => Some(to_result(args)),
        _ => None,
    }
}

// ─── Implementations ────────────────────────────────────────────────────────

fn with_default(args: &[Value]) -> Result<Value, RuntimeError> {
    if args.len() != 2 {
        return Err(RuntimeError::Error(format!(
            "Option.withDefault() takes 2 arguments (option, default), got {}",
            args.len()
        )));
    }
    match &args[0] {
        Value::Some(v) => Ok(*v.clone()),
        Value::None => Ok(args[1].clone()),
        _ => Err(RuntimeError::Error(
            "Option.withDefault: first argument must be an Option".to_string(),
        )),
    }
}

fn to_result(args: &[Value]) -> Result<Value, RuntimeError> {
    if args.len() != 2 {
        return Err(RuntimeError::Error(format!(
            "Option.toResult() takes 2 arguments (option, err), got {}",
            args.len()
        )));
    }
    match &args[0] {
        Value::Some(v) => Ok(Value::Ok(v.clone())),
        Value::None => Ok(Value::Err(Box::new(args[1].clone()))),
        _ => Err(RuntimeError::Error(
            "Option.toResult: first argument must be an Option".to_string(),
        )),
    }
}

// ─── NanValue-native API ─────────────────────────────────────────────────────

pub fn call_nv(
    name: &str,
    args: &[NanValue],
    arena: &mut Arena,
) -> Option<Result<NanValue, RuntimeError>> {
    match name {
        "Option.withDefault" => Some(with_default_nv(args, arena)),
        "Option.toResult" => Some(to_result_nv(args, arena)),
        _ => None,
    }
}

fn with_default_nv(args: &[NanValue], arena: &mut Arena) -> Result<NanValue, RuntimeError> {
    if args.len() != 2 {
        return Err(RuntimeError::Error(format!(
            "Option.withDefault() takes 2 arguments (option, default), got {}",
            args.len()
        )));
    }
    let v = args[0];
    if v.is_some() {
        Ok(v.wrapper_inner(arena))
    } else if v.is_none() {
        Ok(args[1])
    } else {
        Err(RuntimeError::Error(
            "Option.withDefault: first argument must be an Option".to_string(),
        ))
    }
}

fn to_result_nv(args: &[NanValue], arena: &mut Arena) -> Result<NanValue, RuntimeError> {
    if args.len() != 2 {
        return Err(RuntimeError::Error(format!(
            "Option.toResult() takes 2 arguments (option, err), got {}",
            args.len()
        )));
    }
    let v = args[0];
    if v.is_some() {
        let inner = v.wrapper_inner(arena);
        Ok(NanValue::new_ok_value(inner, arena))
    } else if v.is_none() {
        Ok(NanValue::new_err_value(args[1], arena))
    } else {
        Err(RuntimeError::Error(
            "Option.toResult: first argument must be an Option".to_string(),
        ))
    }
}