AY is a simple, custom programming language designed for experimentation and learning. This compiler translates AY programs into JavaScript, allowing you to run your AY code in any JavaScript environment.
Install the AY compiler globally using npm:
npm install -g ayscriptClone the repository:
git clone https://github.com/MikeyA-yo/ay-ts.gitNavigate to the project directory:
cd ay-tsInstall dependencies:
npm installBuild the project:
npx tscTo compile and run an AY program:
-
Write your AY code in a file with the
.ayextension (e.g.,myprogram.ay). -
Compile the program:
ayc myprogram.ay
-
The compiler will generate a JavaScript file (e.g.,
myprogram.js). -
Run the generated JavaScript file using Node.js:
node myprogram.js
-
Write your AY code in a file with the
.ayextension (e.g.,myprogram.ay). -
Compile the program:
node dist/index.js myprogram.ay
-
The compiler will generate a JavaScript file (e.g.,
myprogram.js). -
Run the generated JavaScript file using Node.js:
node myprogram.js
Variables are declared using the l keyword and are block-scoped:
l a = "hello";
l b = 42;
Functions are declared using the f keyword:
f add(a, b) {
l c = a + b;
return c;
}
The def keyword allows you to create aliases for language constructs, making your code more readable:
// Create aliases for common keywords
def var -> l
def fn -> f
def brk -> break
def cnt -> continue
// Now use your custom aliases
var userName = "Alice"
fn greet(name) {
return "Hello, " + name + "!"
}
var message = greet(userName)
print(message)
// Use in control flow
var counter = 0
while (counter < 10) {
if (counter == 5) {
brk // Using the alias for break
}
counter++
}
if (a == b) {
return true;
} else if (c == b) {
return "true";
} else {
return false;
}
While Loop:
l i = 0;
while (i < 5) {
print(i);
i++;
}
For Loop:
for (l i = 0; i < 8; i++) {
print(i);
}
Single-line comments:
// This is a single-line comment
Multi-line comments:
/*
This is a multi-line comment.
*/
The AY language includes a comprehensive standard library with the following functions:
print(...values)- Prints values to the consoleinput(prompt?)- Gets user input from terminal (synchronous, blocks execution)coolPrint(msg)- Prints message with "[COOL PRINT]" prefixfancyLog(msg)- Prints message with "✨ FANCY LOG:" prefixstylishWarn(msg)- Prints warning with "⚠️ STYLISH WARNING:" prefixerrorPop(msg)- Prints error with "❌ ERROR POP:" prefixerrorlog(...msg)- Prints error messages to consolerand(min?, max?)- Returns random number (0-1 if no params, or between min-max)randInt(min?, max?)- Returns random integer between min and maxround(num, precision?)- Rounds number to specified decimal places (default 0)
abs(x), floor(x), ceil(x), round(x), max(a, b), min(a, b)
sqrt(x), pow(x, y), log(x), exp(x)
sin(x), cos(x), tan(x), asin(x), acos(x), atan(x)
toRadians(x), toDegrees(x)
len(s), upper(s), lower(s), trim(s)
split(s, delimiter), join(arr, delimiter)
reverse(s), replace(s, old, new), includes(s, substr)
push(arr, ...values), pop(arr), shift(arr), unshift(arr, ...values)
sort(arr), reverse(arr), slice(arr, start, end)
includes(arr, value), indexOf(arr, value)
readFile(path), writeFile(path, content), appendFile(path, content)
httpGet(url), httpPost(url, data)
awaitPromise(promise, onSuccess, onError)
now(), sleep(ms)
// Math operations
l numbers = [5, 2, 8, 1, 9]
l maxNum = max(5, 10) // 10
l rounded = round(3.7, 1) // 3.7 (rounded to 1 decimal place)
// String operations
l text = "Hello World"
l upperText = upper(text) // "HELLO WORLD"
l textLength = len(text) // 11
l words = split(text, " ") // ["Hello", "World"]
l reversedText = reverse(text) // "dlroW olleH"
// User input (synchronous)
l userName = input("Enter your name: ")
print("Hello, " + userName + "!")
l age = input("Enter your age: ")
l ageNum = parseInt(age)
if (ageNum >= 18) {
print("You are an adult!")
} else {
print("You are a minor!")
}
// Array operations
l fruits = ["apple", "banana"]
l moreFruits = push(fruits, "orange", "grape") // ["apple", "banana", "orange", "grape"]
l sortedFruits = sort(moreFruits) // ["apple", "banana", "grape", "orange"]
l firstTwo = slice(sortedFruits, 0, 2) // ["apple", "banana"]
l hasApple = includes(sortedFruits, "apple") // true
// Using def with built-ins
def log -> print
def length -> len
def ask -> input
log("Array length: " + length(sortedFruits))
l hobby = ask("What's your hobby? ")
log("Cool! You enjoy " + hobby)
// Math with new functions
l angle = 45
l radians = toRadians(angle)
l sineValue = sin(radians)
l randomBetween = randInt(1, 100) // Random integer between 1-100
log("sin(45°) = " + sineValue)
log("Random number: " + randomBetween)
// Define custom aliases for better readability
def var -> l
def fn -> f
// Variables and basic operations
var message = "Welcome to AY Language!"
var numbers = [3, 1, 4, 1, 5, 9]
// String operations
var upperMessage = upper(message)
print(upperMessage)
// Array operations
var sortedNumbers = sort(numbers)
var arrayLength = len(sortedNumbers)
print("Sorted array: " + sortedNumbers)
print("Length: " + arrayLength)
// Math operations
var randomValue = round(rand() * 100)
var maxValue = max(randomValue, 50)
print("Random value: " + randomValue)
print("Max of random and 50: " + maxValue)
// Functions with multiple parameters
fn calculate(a, b, c, d) {
var sum = a + b + c + d
var average = sum / 4
return average
}
var result = calculate(10, 20, 30, 40) // 25
print("Average: " + result)
// Control flow
var counter = 0
while (counter < 5) {
if (counter == 3) {
print("Halfway there!")
}
print("Counter: " + counter)
counter++
}
// HTTP operations (async)
var promise = httpGet("https://api.github.com/users/octocat")
awaitPromise(promise, fn(data) {
print("GitHub user data received!")
}, fn(error) {
print("Error: " + error)
})
To add new features to the AY language:
- Modify the parser in
parser/to recognize new syntax. - Update the AST compiler in
parser/astcompiler.tsto handle new AST nodes. - (Optional) Add new functions to the standard library in
functions/.
This project is licensed under the MIT License.