🚀 BN Script

An automation-first programming language that compiles to JavaScript.

BN Script is a programming language designed to make automation scripts easier to write, read, and maintain while still generating clean JavaScript that runs on Node.js.

It combines a real compiler architecture with a beginner-friendly syntax inspired by Bangla-transliterated keywords.

---

✨ Current Status

Version: v0.1.0-alpha.0

Implemented

✅ Lexer ✅ Parser ✅ Abstract Syntax Tree (AST) ✅ Semantic Analyzer ✅ JavaScript Generator ✅ Runtime System ✅ CLI Tool ✅ Function Support ✅ 103+ Automated Tests

---

🔥 Why BN Script?

Modern automation often requires repetitive JavaScript boilerplate for:

• File operations
• API requests
• Environment variables
• Task automation
• Future AI workflows

BN Script aims to make these workflows simpler while still compiling into readable JavaScript.

Instead of replacing JavaScript, BN Script sits on top of it.

Write BN Script.

Compile to JavaScript.

Run anywhere Node.js runs.

---

🏗 Architecture

BN Script follows a real compiler pipeline:

BN Script Source
        ↓
      Lexer
        ↓
      Parser
        ↓
 Semantic Analyzer
        ↓
 JavaScript Generator
        ↓
      Runtime
        ↓
        CLI

Unlike simple text replacement tools, BN Script performs proper parsing, semantic analysis, and code generation.

---

🚀 Quick Example

BN Script

kaj greet(name) {
  ferot "Hello " + name
}

dekhi greet("Risat")

Generated JavaScript

function greet(name) {
  return "Hello " + name;
}

console.log(greet("Risat"));

Output

Hello Risat

---

✨ Features

Variables

dhori name = "Risat"

Constants

sthir version = 0.1

Output

dekhi "Hello World"

Conditionals

jodi score >= 90 {
  dekhi "Excellent"
} nahole {
  dekhi "Keep Going"
}

Functions

kaj greet(name) {
  ferot "Hello " + name
}

dekhi greet("Risat")

Literals

sotti
mittha
khali

Operators

+
-
*
/
%
**
==
!=
>
<
>=
<=
ebong
othoba
na

---

📦 Installation

Requirements:

• Node.js 18+

Clone the repository:

git clone https://github.com/sayedrisat/bnscript.git
cd bnscript
npm install

Run tests:

npm test

Windows PowerShell:

npm.cmd test

---

🖥 CLI Usage

Check a BN Script file:

node src/cli.js check examples/hello.bn

Build JavaScript:

node src/cli.js build examples/hello.bn

Run directly:

node src/cli.js run examples/hello.bn

Future installed usage:

bn check file.bn
bn build file.bn
bn run file.bn

---

📚 Supported In Alpha

Declarations

• dhori
• sthir

Output

• dekhi

Conditions

• jodi
• nahole

Functions

• kaj
• ferot
• Parameters
• Function Calls

Expressions

• Identifiers
• Number Literals
• String Literals
• Boolean Literals
• Null Literals
• Unary Operators
• Binary Operators
• Parenthesized Expressions

Values

sotti
mittha
khali

---

⚠ Current Limitations

Not implemented yet:

• Assignment Expressions
• While Loops
• For Loops
• Arrays
• Objects
• Imports / Exports
• Async / Await
• AI Runtime Helpers
• Package Manager
• REPL
• LSP
• VS Code Extension

This project is currently in Alpha and focused on compiler stability.

---

🗺 Roadmap

v0.2

• Assignment Expressions
• Variable Reassignment
• Compound Assignment Operators

v0.3

• While Loops
• For Loops

v0.4

• Arrays
• Objects

v0.5

• Imports / Exports
• Modules

Future

• AI Runtime Helpers
• REPL
• Language Server Protocol (LSP)
• VS Code Extension
• Package Ecosystem

---

🧪 Testing

Current test coverage includes:

• Lexer Tests
• Parser Tests
• Semantic Analyzer Tests
• Generator Tests
• Runtime Tests
• CLI Tests
• Integration Tests

103+ tests passing

---

🤝 Contributing

Contributions are welcome.

Good first contributions:

• Compiler improvements
• Parser edge cases
• Better diagnostics
• Documentation
• Examples
• Tests

Before submitting a PR:

1. Run tests
2. Add/update tests
3. Keep changes focused
4. Document limitations

---

📖 Documentation

• Getting Started
• CLI Reference
• Language Specification
• Compiler Architecture
• Runtime Design

See the docs/ directory.

---

⭐ Support The Project

If you find BN Script interesting:

• Star the repository
• Report bugs
• Open feature requests
• Share the project

Repository:

https://github.com/sayedrisat/bnscript

---

📄 License

Released under the MIT License.

See LICENSE for details.