🚀 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 ✅ Assignment Expressions ✅ While Loops ✅ Array Literals ✅ Object Literals ✅ Member and Index Access ✅ Function Support ✅ 152 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"
}

Assignment

dhori count = 0
count = count + 1
count += 4

While Loops

dhori i = 0

jotokkhon i < 3 {
  dekhi i
  i = i + 1
}

Arrays

dhori names = ["Risat", "BN"]
dekhi names[0]
names[1] = "Script"

Objects

dhori user = {
  name: "Risat",
  profile: {
    city: "Dhaka"
  }
}

dekhi user.name
dekhi user.profile.city
user.name = "Sayed"

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

• dhori variable declarations
• sthir constant declarations
• dekhi print statements
• jodi and nahole conditionals
• jotokkhon while loops
• Assignment expressions
• Variable reassignment
• Compound assignment: +=, -=, *=, /=
• Array literals
• Object literals
• Member access
• Index access
• Assignment to member and index targets
• kaj function declarations
• ferot return statements inside functions
• Function parameters
• Function calls
• Block statements
• Expression statements
• Identifiers
• Number, string, boolean, and null literals
• Booleans: sotti, mittha
• Null: khali
• Unary operators: na, -
• Binary operators: +, -, *, /, %, **, ==, !=, >, <, >=, <=, ebong, othoba
• Grouped expressions with parentheses

---

⚠ Current Limitations

Not implemented yet:

• Counted bar Loops
• For-Each Loops
• 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

• Counted Loops
• For-Each Loops

v0.3

• Imports / Exports
• Modules

v0.4

• Async / Await
• File/API Automation Helpers

v0.5

• Runtime Helper Expansion
• Source Maps

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

152 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.