Builtins Reference

print("Hello, World!")

let name = prompt("What is your name? ")
print("Hello, " + name)

clear()  // Clear the screen

print(colorRed("Error: Something went wrong"))
print(colorGreen("Success!"))
print(colorBold(colorYellow("Warning: Proceed with caution")))

print(type(42))        // "int"
print(type("hello"))   // "string"
print(type([1,2,3]))   // "array"

print(toStr(len("hello")))   // 5
print(toStr(len([1,2,3])))   // 3

// Write and read files with error handling
let writeRes = fileWrite("data.txt", "Hello, World!")
if !writeRes.ok {
    print("Write failed: " + writeRes.error)
}

let readRes = fileRead("data.txt")
if readRes.ok {
    print(readRes.value)  // Hello, World!
} else {
    print("Read failed: " + readRes.error)
}

// Append to file
fileAppend("log.txt", "Log entry\n")

// Check existence (returns bool directly)
if fileExists("config.json") {
    let config = fileRead("config.json")
    if config.ok {
        print(config.value)
    }
}

// Directory operations
fileMkdir("output/reports")
let dirRes = fileReadDir(".")
if dirRes.ok {
    for file in dirRes.value {
        print(file)
    }
}

// Glob pattern matching
let globRes = fileGlob("*.lgs")
if globRes.ok {
    for script in globRes.value {
        print("Found: " + script)
    }
}

print(upper("hello"))           // HELLO
print(lower("WORLD"))           // world
print(trim("  spaces  "))       // "spaces"

let words = split("a,b,c", ",")
print(join(words, "-"))         // a-b-c

print(toStr(contains("hello", "ell")))  // true
print(toStr(startsWith("hello", "he"))) // true

print(repeat("ab", 3))          // ababab
print(slice("hello", 1, 4))     // ell

print(format("Hello, {}!", "World"))  // Hello, World!

let num = toInt("42")
let pi = toFloat("3.14")
let flag = toBool("true")
let text = toStr(123)

print(type(num))   // int
print(type(pi))    // float
print(type(flag))  // bool
print(type(text))  // string

let nums = [1, 2, 3]

nums = push(nums, 4)        // [1, 2, 3, 4]
nums = prepend(nums, 0)     // [0, 1, 2, 3, 4]

print(toStr(first(nums)))   // 0
print(toStr(last(nums)))    // 4

let rest = tail(nums)       // [1, 2, 3, 4]
let rev = reverse(nums)     // [4, 3, 2, 1, 0]

let unsorted = [3, 1, 4, 1, 5]
let sorted = sort(unsorted) // [1, 1, 3, 4, 5]

let user = table{
    "name": "Alice",
    "age": 30,
    "role": "admin"
}

let k = keys(user)      // ["name", "age", "role"]
let v = values(user)    // ["Alice", 30, "admin"]

print(toStr(has(user, "name")))  // true
print(toStr(has(user, "email"))) // false

let updated = tableDelete(user, "age")
let merged = merge(user, table{ "email": "alice@example.com" })

let jsonStr = '{"name": "Bob", "scores": [95, 87, 92]}'
let data = parseJson(jsonStr)

print(data["name"])              // Bob
print(toStr(data["scores"][0]))  // 95

let obj = table{ "status": "ok", "count": 42 }
let json = toJson(obj)
print(json)  // {"count":42,"status":"ok"}

print(toStr(mathAbs(-42)))       // 42
print(toStr(mathPow(2, 10)))     // 1024
print(toStr(mathSqrt(16)))       // 4

print(toStr(mathFloor(3.7)))     // 3
print(toStr(mathCeil(3.2)))      // 4
print(toStr(mathRound(3.5)))     // 4

print(toStr(mathMin(5, 3)))      // 3
print(toStr(mathMax(5, 3)))      // 5

let dice = mathRandomInt(1, 6)
print("Rolled: " + toStr(dice))

print(toStr(mathPi()))           // 3.141592653589793

print(pwd())                    // /home/user/project
cd("/tmp")

let home = env("HOME")
setenv("MY_VAR", "hello")

let cliArgs = args()
for arg in cliArgs {
    print(arg)
}

print(osname())                 // linux

// Run commands
let output = run("ls", "-la")
print(output)

let result = shell("echo $HOME && pwd")
print(result)

sleep(1000)  // Wait 1 second
exit(0)

print(toStr(timeNow()))    // 1709395200
print(toStr(timeMs()))     // 1709395200123

print(timeStr())           // 14:30:00
print(dateStr())           // 2024-03-02
print(dateTimeStr())       // 2024-03-02 14:30:00

// Custom formatting (Go time layout)
let ts = timeNow()
print(timeFormat(ts, "Jan 2, 2006"))  // Mar 2, 2024

// Result structure:
{
    ok: true/false,
    value: { body: "...", status: 200 },
    error: ""
}

// GET request with error handling
let res = httpGet("https://api.example.com/users")

if res.ok {
    let users = parseJson(res.value.body)
    for user in users {
        print(user["name"])
    }
    print("Status: " + toStr(res.value.status))
} else {
    print("Request failed: " + res.error)
}

// POST with JSON body
let payload = toJson(table{
    "name": "Alice",
    "email": "alice@example.com"
})
let postRes = httpPost("https://api.example.com/users", payload)

if postRes.ok {
    print("Created! Status: " + toStr(postRes.value.status))
}

// PATCH request
let update = toJson(table{ "name": "Alice Smith" })
let patchRes = httpPatch("https://api.example.com/users/1", update)

// DELETE request
let delRes = httpDelete("https://api.example.com/users/1")
if delRes.ok {
    print("Deleted successfully")
}