Add cos and sin built-in functions

Author: vascocosta

docs/reference.md

@@ -79,9 +79,11 @@ Explore the standard library functions.
 
 [fn abs(number: Int | Float): Int | Float](#fn-absnumber-int--float-int--float)<br>
 [fn ceil(number: Float): Float](#fn-ceilnumber-float-float)<br>
+[fn cos(number: Int | Float): Float](#fn-cosnumber-int--float-float)<br>
 [fn clamp(value: Int | Float, min: Int | Float, max: Int | Float): Int | Float](#fn-clampvalue-int--float-min-int--float-max-int--float-int--float)<br>
 [fn floor(number: Float): Float](#fn-floornumber-float-float)<br>
-[fn round(number: Float): Float](#fn-roundnumber-float-float)
+[fn round(number: Float): Float](#fn-roundnumber-float-float)<br>
+[fn sin(number: Int | Float): Float](#fn-sinnumber-int--float-float)
 
 ---
 
@@ -271,6 +273,14 @@ Returns the smallest integer value greater than or equal to the given floating-p
 
 ---
 
+## `fn cos(number: Int | Float): Float`
+
+Returns the cosine of the given angle, expressed in radians.
+
+If the input is an integer, it is converted to a floating-point number before the calculation is performed.
+
+---
+
 ## `fn clamp(value: Int | Float, min: Int | Float, max: Int | Float): Int | Float`
 
 Restricts the given value to be within the inclusive range defined by `min` and `max`.
@@ -295,6 +305,14 @@ Returns the nearest integer value to the given floating-point number, as a float
 
 ---
 
+## `fn sin(number: Int | Float): Float`
+
+Returns the sine of the given angle, expressed in radians.
+
+If the input is an integer, it is converted to a floating-point number before the calculation is performed.
+
+---
+
 ## Module: `strings`
 
 ## `fn contains(string: String, substr: String): Bool`

src/builtin/math.rs

@@ -7,9 +7,11 @@ pub fn module() -> Result<Value, RuntimeError> {
 
     map.insert("abs".to_string(), Value::BuiltinFunction(abs));
     map.insert("ceil".to_string(), Value::BuiltinFunction(ceil));
+    map.insert("cos".to_string(), Value::BuiltinFunction(cos));
     map.insert("clamp".to_string(), Value::BuiltinFunction(clamp));
     map.insert("floor".to_string(), Value::BuiltinFunction(floor));
     map.insert("round".to_string(), Value::BuiltinFunction(round));
+    map.insert("sin".to_string(), Value::BuiltinFunction(sin));
 
     Ok(Value::Record(map))
 }
@@ -61,6 +63,30 @@ pub fn ceil(args: Vec<Value>) -> Result<Value, RuntimeError> {
     }
 }
 
+pub fn cos(args: Vec<Value>) -> Result<Value, RuntimeError> {
+    if args.len() != 1 {
+        return Err(RuntimeError::Arity {
+            expected: 1,
+            got: args.len(),
+        });
+    }
+
+    match args.first() {
+        Some(Value::Float(number)) => Ok(Value::Float(number.cos())),
+        Some(Value::Int(number)) => Ok(Value::Float((*number as f64).cos())),
+
+        None => Err(RuntimeError::Arity {
+            expected: 1,
+            got: 0,
+        }),
+
+        other => Err(RuntimeError::TypeError {
+            expected: "float/int",
+            got: format!("{:?}", other),
+        }),
+    }
+}
+
 pub fn clamp(args: Vec<Value>) -> Result<Value, RuntimeError> {
     if args.len() != 3 {
         return Err(RuntimeError::Arity {
@@ -211,3 +237,27 @@ pub fn round(args: Vec<Value>) -> Result<Value, RuntimeError> {
         }),
     }
 }
+
+pub fn sin(args: Vec<Value>) -> Result<Value, RuntimeError> {
+    if args.len() != 1 {
+        return Err(RuntimeError::Arity {
+            expected: 1,
+            got: args.len(),
+        });
+    }
+
+    match args.first() {
+        Some(Value::Float(number)) => Ok(Value::Float(number.sin())),
+        Some(Value::Int(number)) => Ok(Value::Float((*number as f64).sin())),
+
+        None => Err(RuntimeError::Arity {
+            expected: 1,
+            got: 0,
+        }),
+
+        other => Err(RuntimeError::TypeError {
+            expected: "float/int",
+            got: format!("{:?}", other),
+        }),
+    }
+}