README.md

BramandScript (bmd) ✦

A modern, high-performance general-purpose programming language built from scratch with a Stack-Based Bytecode Virtual Machine in pure Go standard library. Zero external dependencies. Completely offline buildable.

---

✦ Overview

BramandScript (bmd) is designed for modern developers and young learners alike. It combines the expressive simplicity of Python with the runtime predictability and efficiency of a stack-based Bytecode Virtual Machine, requiring zero third-party dependencies (0 external packages).

• Live Documentation: https://codeleafly.github.io/bramandScript/
• Host Runtime: Pure Go Standard Library (stdlib only)
• Target Environments: Android Termux (ARM64), Linux (x86_64/ARM64), macOS, and Windows

---

✦ Key Features

• Beginner-Friendly Ergonomics: Optional semicolons, optional if condition parentheses, natural mathematical operators (** for power, % for modulo).
• Full UTF-8 Unicode Lexer: Complete support for international identifiers across scripts (Devanagari, CJK, Greek, accented characters) and rune-accurate string operations and diagnostic pointers.
• Stack-Based Bytecode VM: Complete custom Pratt Parser, AST compiler, constant pools, instruction set (code/), and frame execution engine (vm/).
• Modern Collections & Dot Access:
  • Lists: let list = [10, 20, 30]; list[1] = 99
  • Hashes: let user = {"name": "Aryan", "role": "dev"}
  • Direct Dot Access: print(user.name); user.role = "lead"
  • Universal .length / .len properties across strings, arrays, and maps.
• For-In Iterators: Native for item in list, for idx, val in list, and string/hash iteration with break and continue.
• First-Class Functions & Mutable Closures: Lexical scoping, first-class fn objects, free-variable capture, and mutable state (OpClosure, OpGetFree, OpSetFree).
• Structs & Object-Oriented Methods:

  struct Point {
      x, y
      fn dist() {
          return (x * x + y * y) ** 0.5
      }
  }
  let p = Point(3, 4)
  print(p.dist()) // 5.0
  

• Pattern Matching & Destructuring:

  let [first, second, ...rest] = [10, 20, 30, 40]
  let { name, role } = { "name": "Bramand", "role": "Architect" }
  
  let msg = match statusCode {
      case 200 => { "OK" }
      case 400, 404 => { "Client Error" }
      default => { "Server Error" }
  }
  

• Pipeline Operator (|>): Fluent data-first chaining lowered directly to nested call chains at compile time with zero overhead:

  let result = 3 |> inc |> square // square(inc(3)) -> 16
  

• Comptime Metaprogramming Sandbox (comptime { ... }): Execute arbitrary code blocks during compilation in an isolated VM sandbox to inline precomputed constants and unroll lookup tables with zero runtime overhead:

  let factorials = comptime {
      let t = [];
      let val = 1;
      let i = 1;
      while i <= 6 {
          val = val * i;
          push(t, val);
          i = i + 1;
      }
      return t;
  }; // Inlined directly into bytecode constants: [1, 2, 6, 24, 120, 720]
  

• Native Reactive Event Streams with Backpressure (std/stream): Reactive push/pull pipelines with backpressure flow control signals (request(n), pause(), resume()), windowed operators (debounce, throttle, window, sample), and combinators (merge, zip, concat, switch_map):

  import "std/stream" as stream;
  let pipeline = stream.from_array([1, 2, 3, 4, 5, 6])
      .filter(fn(x) { return x % 2 == 0; })
      .map(fn(x) { return x * 10; })
      .window(2)
      .collect(); // [[20, 40], [60]]
  

• In-Memory Relational SQL Engine (std/sql): Full ANSI SQL parser, query planner, and execution engine supporting SELECT, FROM, INNER JOIN, LEFT JOIN, WHERE, GROUP BY, HAVING, ORDER BY, and LIMIT over arrays of hashes and DataFrames:

  import "std/sql" as sql;
  let res = sql.query("SELECT dept, COUNT(*) as cnt, AVG(salary) as avg_sal FROM employees GROUP BY dept HAVING cnt > 1 ORDER BY avg_sal DESC", tables);
  

• Columnar DataFrame Projection & Vectorized Aggregations (std/dataframe): Zero-copy columnar dictionaries, vectorized arithmetic filters (col.gt(10)), boolean mask slicing, and direct SQL integration (df.query(...)).
• Local AI Vector Similarity, Spatial Index & RAG Pipeline (std/ai): Pure Go stdlib hardware floating-point accelerated metrics (Cosine, Euclidean, Manhattan, Dot Product, Normalization), fast K-Nearest Neighbors (KNN) spatial index with JSON serialization, and sliding-window semantic text chunkers for local AI agent workflows.
• Built-in Benchmarking & Automated Fuzz Testing (bmd bench & bmd fuzz): Statistical nanoseconds/op, bytes/op, allocations tracking, and mutation-based edge-case discovery directly integrated into the language and CLI.
• Time-Travel Execution Recorder & Replay Debugger (bmd record & bmd replay): Step-by-step VM checkpoint capture enabling developers to step forward, step backward in time (step_back), inspect stack history, and jump to any historical execution point.
• Adaptive Numeric Core & Transparent BigInt: Standard integer arithmetic automatically promotes to arbitrary-precision BigInt upon 64-bit overflow (2 ** 70), eliminating silent overflow wrapping while maintaining unboxed int64 speed on small integers.
• Scientific Computing & Linear Algebra Suite:
  • std/math/decomp: LU decomposition with row pivoting, QR via Householder reflections, Cholesky factorization, linear solvers (A * x = b), and polynomial least-squares regression.
  • std/math/eigen: Spectral analysis, power iteration, and shifted QR eigenvalue algorithms.
  • std/math/sparse: Compressed Sparse Row (CSR) matrix representation and sparse matrix-vector multiplication.
  • std/math/calculus & std/math/opt & std/math/ode: Numerical differentiation, Simpson/Gauss quadrature integration, Brent-Dekker root finding, scalar minimization, and RK4 ODE integrators.
  • std/math/rational & std/math/decimal: Exact fractional arithmetic with automatic GCD reduction and fixed/arbitrary-scale financial decimals.
  • std/math/complex & std/math/ntheory: Complex Cartesian/polar numbers, Euler identity verification, deterministic Miller-Rabin primality, Pollard-rho, and modular inverse.
• Modern Cryptography & Binary Protocols:
  • std/crypto/advanced: Authenticated symmetric encryption (AES-256-GCM), Ed25519 digital signatures, and JSON Web Token (JWT) signing and verification.
  • std/binary/pack: Python-style binary struct packing (>hhi4s) and MessagePack binary serialization.
  • std/compress: Pure Go stdlib gzip, zlib, and POSIX tar archiving without external CLI tools.
• Terminal Visualizations (std/tui/plot): High-resolution 2x4 Braille dot-matrix mathematical function curves and Unicode box bar charts directly inside the terminal.
• 64-Bit Opcode Virtual Machine: Full 64-bit (uint64, 8-byte) operand encoding across constants (OpConstant), branch jumps (OpJump, OpJumpNotTruthy, OpJumpTruthy), globals (OpSetGlobal, OpGetGlobal), and closures (OpClosure), supporting unbounded programs with millions of instructions.
• Dynamic Stack & Configurable Call Frames: Frames and value stack dynamically expand to accommodate deep recursions, with user-configurable bounds (--max-frames <N>, --max-stack <N>).
• Capability-Based Permission Guards: Host environment security protecting subprocess execution (--allow-run), filesystem writes (--allow-write), and network listening (--allow-net), or complete capability access (--allow-all).
• Structured Exception Handling (try-catch-finally): First-class grammar statements for resilient error interception:

  try {
      let val = 100 / 0
  } catch err {
      println("Intercepted error:", err)
  } finally {
      println("Guaranteed cleanup")
  }
  

• Enterprise Language Operators & Syntax:
  • Null-Coalescing (??) & Nullish Assignment (??=):

    let port = config.port ?? 8080
    settings["timeout"] ??= 30
    

  • Optional Chaining (?.): Short-circuiting property, index, and method access on nullable targets:

    let name = user?.profile?.name
    let item = matrix?.[row]?.[col]
    let result = service?.compute?.(x, y)
    

  • Ternary Conditional Expression (?:):

    let status = active ? "online" : "offline"
    let grade = score >= 90 ? "A" : score >= 80 ? "B" : "C"
    

  • String Interpolation (f"..." & Template Literals):

    let greeting = f"Hello, {user.name}! Score is {score + 10}."
    let banner = `Server running on ${host}:${port}`
    

  • Enterprise Call Stack Trace Inspection:

    try {
        processOrder(orderId)
    } catch err {
        println("Error message:", err.message)
        println("Stack trace:\n", err.stack_trace)
        for frame in err.frames {
            println("  at", frame.fn, "line", frame.line)
        }
    }
    

  • Enterprise Standard Library Modules:
    • import "std/log" as log — Leveled structured logger with JSON and console text outputs
    • import "std/retry" as retry — Exponential backoff retry engine with jitter and error filters
    • import "std/config" as config — Environment variable loader, .env dotenv parser, and INI configuration parser
    • import "std/collections" as coll — partition, key_by, flat_map, compact, sum_by, min_by, max_by, frequencies, difference, intersection, union
  • LIFO defer Statement Runtime: Guaranteed LIFO-ordered cleanup executed upon normal function returns, early returns, and exception unwinding:

    fn processFile(path) {
        let file = open(path)
        defer file.close()
    
        let mu = mutex()
        mu.lock()
        defer mu.unlock()
    
        // processing logic...
    }
    

  • Default Parameter Values in Functions: Declarative default parameter expressions with preceding parameter reference capability:

    fn connect(host, port = 8080, timeout = 30) {
        return f"Connecting to {host}:{port} (timeout {timeout}s)"
    }
    connect("localhost") // port defaults to 8080, timeout to 30
    

  • Array & Hash Spread Expressions (...): In-line unpacking and deterministic dictionary merging with progressive overriding:

    let items = [1, ...numbers, 4]
    let config = { ...defaults, "port": 9000, "debug": true }
    

  • Enterprise Resiliency & Concurrency Standard Library:
    • import "std/uuid" as uuid — RFC 4122 v4 UUID generation, parsing, and format validation
    • import "std/semaphore" as semaphore — Counting semaphore concurrency limiter with with_permit()
    • import "std/circuitbreaker" as circuitbreaker — Fault-tolerant circuit breaker (Closed, Open, Half-Open) with automatic recovery timeouts and fallbacks
    • import "std/pool" as pool — High-throughput worker pool abstraction with order-preserving parallel map()
• AOT Constant Folding & Peephole Optimizer: Compiler optimization pass (bmd run -O script.bmd, bmd build -O app.bmd) pre-evaluating constant arithmetic expressions and compacting bytecode opcodes.
• Modular Standard Library (stdlib/):
  • Lean VM core with dedicated high-level standard library modules written in BramandScript:
  • import "std/math" as math (constants PI, E, clamp, gcd, lcm, min, max)
  • import "std/strings" as str (capitalize, pad_left, pad_right, slugify, reverse)
  • import "std/collections" as coll (map, filter, reduce, find, unique, chunk, group_by)
  • import "std/iter" as iter (resumable coroutine generators, yield, lazy stream evaluation)
  • import "std/io" as io (read_text, write_text, BufferReader, BufferWriter, pipe, read_all)
  • import "std/json" as json (parse, stringify, safe_parse)
  • import "std/testing" as t (assert_true, assert_false, assert_null)
  • import "std/net" as net (raw duplex TCP sockets, UDP datagrams, TLS dial/listen)
  • import "std/http" as http (100% pure BMD RFC 7230 server, client, router, middleware)
  • import "std/ws" as ws (100% pure BMD RFC 6455 WebSocket engine, client, server, broadcast)
  • import "std/dns" as dns (100% pure BMD RFC 1035 UDP DNS packet codec, resolver, TTL cache)
  • import "std/https" as https (100% pure BMD secure HTTPS client and server over TLS)
  • import "std/process" as process (ChildProcess, standard I/O streaming, Unix IPC pipelines)
  • import "std/os" as os (platform, architecture, CPU count, memory allocation, environment)
  • import "std/buffer" as buffer (Buffer class, Big-Endian / Little-Endian codecs, IEEE 754 floats)
• Decoupled Two-Tier Networking & System Architecture (Week 6):
  • Tier 1: Low-Level Host Primitives in Go (stdlib/go_std/):
    • Raw Duplex TCP Sockets: net.create_server, net.connect, sock.read_line, sock.write, sock.set_timeout, sock.close
    • Raw UDP Datagrams: net.create_udp_socket, sock.send_to, sock.recv_from
    • Encrypted TLS Sockets: net.dial_tls with SNI verification and net.listen_tls
    • Subprocess IPC: Low-level child process spawning, stdin/stdout/stderr streaming pipes, process wait/kill, and OS host metrics (os.platform, os.arch, os.cpus, os.memory)
    • Binary Memory Buffers: Low-level byte slice allocation, bulk memory copy (buf_copy), binary integer and IEEE 754 float read/write
  • Tier 2: 100% Pure BramandScript Application Protocols (stdlib/bmd_std/):
    • Pure BMD HTTP/1.1 Engine (std/http): RFC 7230 wire parser, server (http.create_server), client (http.get, http.post, http.put, http.delete_req), Radix-Trie Router (http.create_router), and middleware
    • Pure BMD RFC 6455 WebSocket Engine (std/ws): Complete handshake accept key derivation (SHA-1 & Base64), binary frame encoder/decoder, 4-byte client XOR masking, server, client (ws.connect), and multi-client broadcast
    • Pure BMD RFC 1035 UDP DNS Codec & Resolver (std/dns): Binary query encoder, response decoder with QNAME label compression pointers (0xC0), UDP resolver (dns.resolve), and in-memory TTL cache
    • Pure BMD HTTPS Engine (std/https): Secure TLS-encrypted HTTP client and server with SNI verification
    • ChildProcess Class & Unix Pipelines (std/process): Subprocess standard I/O streaming, Unix IPC pipeline coroutine (proc1.pipe(proc2)), and synchronous runner (process.exec)
    • Buffer Class & Stream Combinators (std/buffer & std/io): High-level Buffer struct, Big-Endian / Little-Endian numeric codecs, BufferReader, BufferWriter, and chunked stream piping (io.pipe) with 100% byte integrity
  • Core VM Truthiness Standardization:
    • Unified isTruthy semantics across the virtual machine and compiler.
    • Standardized Canonical Falsy Matrix: false, null, 0, 0.0, "" (empty string), and bytes(0) (empty buffer) evaluate cleanly to false across all VM opcodes (OpJumpNotTruthy, OpJumpTruthy, OpAnd, OpOr), logical NOT (!), ternary expressions, loops, and bool() coercion.
• Centralized Package & Module Architecture ($HOME/.bmd_libs/):
  • Zero node_modules Bloat: Shared system-wide store eliminating per-project disk waste.
  • 4-Stage Import Resolution Pipeline: Stage 1 (embed:stdlib/), Stage 2 (relative paths), Stage 3 (~/.bmd_libs/registry/), Stage 4 (immutable singleton exports with OpModule).
  • Three-Tier Fallback Engine: bmdpkg.json "entry" -> main.bmd -> index.bmd -> diagnostic failure.
  • SemVer Diamond Resolution: Unifies compatible dependency versions to highest SemVer with side-by-side major version isolation.
• Enterprise Concurrency, Actors & Monadic Safety (Week 5):
  • Date, Time & Calendar Suite (std/datetime): High-performance Date, Time, Duration, Timestamp, Unix milliseconds, ISO 8601 / RFC 3339 parsing and formatting, calendar arithmetic (add_days, add_hours, diff), timezone offsets, and leap year checks.
  • Enterprise File System & Path (std/fs & std/path): Recursive directory traversal (fs_walk), glob matching, temp file creation, and path manipulation (join, clean, base, dir, ext, abs, split).
  • Universal Data Encoding Suite (std/encoding): CSV parsing/formatting with headers and custom delimiters, Hex encoding/decoding, and URL query encoding/decoding.
  • Lightweight Actor Model & Supervision Trees (actor, std/actor): actor keyword, FIFO mailboxes, async act.send(msg), synchronous act.ask(msg, timeout_ms), global registry (actor_register, actor_whereis), and supervision trees (one_for_one, one_for_all, rest_for_one).
  • Monadic Safety (Result & Option): Ok(v), Err(e), Some(v), None() runtime object types with methods (.unwrap(), .unwrap_or(), .is_ok(), .is_err(), .map(), .flat_map()).
  • Try-Propagation Operator (?): Postfix ? unwraps Ok/Some or early-returns Err/None from enclosing functions.
  • Fixed Tuples & Destructuring: Immutable (a, b, c) tuple runtime object with literal syntax, OpTuple opcode, and multi-variable destructuring (let (x, y, z) = point).
  • Deep Pattern Matching with Guard Expressions: Extended match-case with nested tuple, array, and hash/struct destructuring and if <condition> guard clauses.
  • Uncolored Async/Await Coroutines: async fn and await compiling to suspendable VM call frames allowing any caller to await without function coloring.
  • Cooperative Scheduler & Structured Task Groups (task_group, std/concurrency): yield voluntary time-slicing and task_group() coordinator supporting parallel branch execution, wait_all(), wait_any(), and cascade cancellation on failure.
  • Supply-Chain Permission Contracts: Sandboxing declared host permissions (network, filesystem_read, filesystem_write, subprocess) with install-time security alerts.
  • Single-Binary Embedding (bmd build): Direct embedding of global dependencies into self-contained standalone binaries.
  • Offline-First Determinism: Complete offline operation via --offline flag and BMD_OFFLINE=1.
• Rust/Clang-Style 10-Line Diagnostic Engine: Exact column and line pointer (--> file:line:col), exactly 5 lines of contextual code above and 5 below, caret token underlining (^~~~), intelligent suggestions ([Hint: ...]), and zero ASCII box borders.
• In-Terminal Multi-Line Editor (:editor): Multi-line coding, running, and saving directly to disk from inside the interactive REPL.

---

✦ Quickstart & Installation

Option 1: Smart Universal One-Liner (Linux, macOS, Android Termux)

Auto-detects your platform (Linux, macOS Darwin, Android Termux) and CPU architecture (amd64, arm64, armv7), pulls the latest release, installs the standalone binary, and links bramand and bmd:

curl -fsSL https://raw.githubusercontent.com/Codeleafly/bramandScript/main/install.sh | bash

Option 2: Windows PowerShell One-Liner

Open PowerShell and run:

irm https://raw.githubusercontent.com/Codeleafly/bramandScript/main/install.ps1 | iex

Option 3: Compile from Source (Offline / Local Toolchain)

git clone https://github.com/Codeleafly/bramandScript.git
cd bramandScript
go build -ldflags="-s -w" -o bramand main.go

# Install to system PATH
cp bramand "${PREFIX:-/usr/local}/bin/bramand"
ln -sf "${PREFIX:-/usr/local}/bin/bramand" "${PREFIX:-/usr/local}/bin/bmd"

---

✦ Usage

1. Interactive REPL

bmd
# or
bramand repl

Commands inside the REPL:

• :editor — Enter multi-line code editor mode
• :editor <filename.bmd> — Code and save directly to file
• :clear — Clear terminal screen
• :reset — Reset runtime state and variables
• :help — Comprehensive documentation and syntax guide
• :exit — Quit REPL

2. Execute a Source File & Permission Options

# Standard execution
bmd run script.bmd

# Execute with explicit security permission flags
bmd run --allow-all script.bmd          # Allow all permissions
bmd run --allow-run script.bmd          # Allow exec()
bmd run --allow-write script.bmd        # Allow write_file(), delete_file()
bmd run --allow-net server.bmd          # Allow tcp_listen()

# Custom call stack depth limit
bmd run --max-frames 2048 deep.bmd

# Direct shortcut execution
bmd script.bmd

3. Centralized Package Manager (bmd pkg, bmd install, bmd get, bmd cache)

BramandScript provides a unified, offline-first package manager with centralized storage in $HOME/.bmd_libs/:

# Install package from GitHub (version tag or latest)
bmd install github.com/alice/json-tools
bmd install github.com/alice/json-tools 1.2.0

# Install from remote CDN archive URL
bmd install https://cdn.bmd.io/packages/matrix-math.tar.gz

# Link local development directory
bmd install ./libs/my_utils
bmd install local/my_utils@dev

# Synchronize project dependencies declared in bmdpkg.json
bmd get

# Offline dependency synchronization (strictly local/cache)
bmd get --offline

# Inspect centralized storage metrics and counts
bmd cache info

# Prune orphaned tarball archives while preserving registry trees
bmd cache prune

# Cryptographically verify all installed packages against integrity.db
bmd cache verify

# Initialize a new package with bmdpkg.json manifest and main.bmd
bmd pkg init my-library

# List project dependencies and globally available registry packages
bmd pkg list

# Compile standalone executable embedding global dependencies
bmd build app.bmd -o my_app

Package Manifest (bmdpkg.json)

{
  "name": "my-service",
  "version": "1.0.0",
  "description": "High-throughput microservice in BramandScript",
  "entry": "src/main.bmd",
  "license": "MIT",
  "authors": ["Codeleafly <ziprecovery2024@gmail.com>"],
  "permissions": {
    "network": true,
    "filesystem_read": true,
    "filesystem_write": false,
    "subprocess": false
  },
  "dependencies": {
    "github.com/alice/json-tools": "^1.2.0"
  },
  "compatibility": {
    "bmd_min": "0.1.0"
  }
}

CLI Command Cheat Sheet

Command	Arguments	Purpose & Functionality
bmd install	<target> [version] [--offline]	Installs package from GitHub, CDN, or local path into ~/.bmd_libs/registry/
bmd get	[dir] [--offline]	Resolves and downloads missing project dependencies from bmdpkg.json
bmd cache info	(none)	Displays disk usage, tarball archive count, and registry package count
bmd cache prune	(none)	Reclaims space by removing orphaned tarballs while preserving registry trees
bmd cache verify	(none)	Validates SHA-256 cryptographic checksums against locks/integrity.db
bmd pkg init	[name]	Scaffolds a new package directory with bmdpkg.json and main.bmd
bmd pkg list	(none)	Lists dependencies in current project and all globally installed packages
bmd build	<file.bmd> -o <exe>	Compiles self-contained executable embedding dependencies from ~/.bmd_libs/

4. Performance Benchmarks, Fuzz Testing & Time-Travel Debugging

# Run statistical performance micro-benchmarks
bmd bench benchmarks/matrix_bench.bmd

# Run automated mutation-based fuzz testing
bmd fuzz tests/fuzz_json.bmd

# Record program execution into time-travel trace
bmd record script.bmd -o trace.json

# Launch interactive time-travel replay debugger
bmd replay trace.json
# Commands: [s]tep, [b]ack/step_back, [p]rint/inspect, [h]istory, [g]oto <step>, [q]uit

5. Native Project Task & Roadmap CLI (bmd-task)

BramandScript includes a 100% self-hosted, native task and roadmap tracking engine written in pure .bmd (tools/task.bmd & std/tooling/task) with zero Node.js/npm dependencies:

# View active tasks and sprint progress
bmd-task list
# or
./bramand run tools/task.bmd list

# Filter tasks by day or week
bmd-task list Day 35
bmd-task list week 5

# View detailed task specification
bmd-task view 22

# Mark task as complete or pending
bmd-task check 22
bmd-task uncheck 22

# Add a new task (compulsory --desc of 15+ characters)
bmd-task add "Standard HTTP Router" --day=8 \
  --desc="Build high-performance multiplexer with route matching and middleware support" \
  --includes="Route tree, pattern matching, handler context"

6. Run All Automated Unit Tests

# Pure Go test suite
go test ./... -v

# BramandScript test suite
bmd test tests/

---

✦ Code Example

// Struct declaration with closure methods
struct Counter {
    val
    fn inc() {
        val += 1
        return val
    }
}

let c = Counter(10)
c.inc()
c.inc()
print("Counter value:", c.val)

// Pattern matching with guards & Destructuring
let (x, y) = (10, 20)
let coord_type = match (x, y) {
    case (0, 0) => { "origin" }
    case (a, b) if a == b => { "diagonal" }
    case (a, b) => { "point" }
    case _ => { "other" }
}
print("Coord type:", coord_type)

// Actor Model with request-reply
let counter = actor(fn(msg, state) {
    if msg["type"] == "inc" { return state + msg["value"] }
    if msg["type"] == "get" { return state }
    return state
}, 0)
counter.send({ "type": "inc", "value": 42 })
print("Actor count:", counter.ask({ "type": "get" }, 1000)) // 42
counter.stop()

// Monadic Result & Try-Propagation (?)
let divide = fn(a, b) {
    if b == 0 { return Err("division by zero") }
    return Ok(a / b)
}
let calc = fn(x, y) {
    let q = divide(x, y)? // Unwraps Ok, or early-returns Err!
    return Ok(q * 10)
}
let answer = calc(100, 5)
print("Monadic answer:", answer.unwrap()) // 200

// Uncolored Async/Await & Structured Task Groups
let fetch = async fn(url) {
    sleep(10)
    return "response from " + url
}
let resp = await fetch("api/data")
print("Fetched:", resp)

// Pipeline Operator (|>)
let inc = fn(x) { return x + 1; }
let sq = fn(x) { return x * x; }
let res = 3 |> inc |> sq
print("Pipeline (3 + 1)^2:", res) // 16

// For-in loop
let fruits = ["Apple", "Mango", "Banana"]
for i, item in fruits {
    print("Item", i, "is", item)
}

---

✦ Modular Documentation Portal

The documentation is organized into dedicated, fast-loading modular guides:

• Getting Started & Overview — Installation, CLI commands, permission flags, and REPL :editor mode.
• Language Fundamentals — Syntax, variables, operators (??, ?., ?:, ?), default parameters, fixed tuples (a, b), async fn, LIFO defer, and try-catch-finally exceptions.
• Data Structures & OOP — Arrays, hash maps, dot access, structs, fixed immutable tuples, hashable tuple keys, and deep pattern matching with guards (match-case ... if ...).
• Concurrency & System I/O — Lightweight actors & mailboxes, supervision trees (one_for_one, one_for_all, rest_for_one), uncolored async/await, continuation frames, cooperative multitasking (yield), structured task groups (task_group), channels, mutexes, semaphores, and worker pools.
• Modular Standard Library — 32+ embedded modules: std/net, std/http, std/ws, std/dns, std/https, std/process, std/buffer, std/io, std/os, std/datetime, std/fs, std/path, std/encoding, std/actor, std/concurrency, std/math, std/strings, std/collections, std/json, std/log, std/retry, std/config, std/uuid, std/semaphore, std/circuitbreaker, std/pool, BigInt/BigFloat, and 180+ builtins reference.
• Networking, Web & AI — HTTP server/client, WebSockets, TCP/UDP sockets, resilient network requests, AI streaming, and vector search.
• Developer Tooling — Centralized package manager (bmd install, bmd get, bmd cache), test runner (bmd test), formatter (bmd fmt), compiler (bmd build), disassembler, profiler, and permission flags.
• Architecture & Internals — 4-stage runtime import resolution pipeline, inter-process atomic locking, SemVer diamond dependency resolution, 64-bit opcode VM, dynamic stack frames, thread safety, embedded filesystem (embed.FS), diagnostics engine, and contributing guide.
• Runtime & Diagnostics Reference — Algebraic monads (Result: Ok/Err, Option: Some/None), try-propagation operator (?), visual diagnostic anatomy, and error catalog.

---

✦ Architecture Pipeline

Source Code (.bmd)
       │
       ▼
 1. Lexer (Tokens, Source Locations, String Escapes)
       │
       ▼
 2. Pratt Parser (Abstract Syntax Tree / AST Nodes)
       │
       ▼
 3. Bytecode Compiler (Symbol Table, Constants Pool, Opcodes)
       │
       ▼
 4. Bramand VM Engine (Stack Machine, Call Frames, Closures)

---

✦ Community & Stargazers

If you find BramandScript exciting or useful, please consider giving the repository a Star on GitHub. It directly supports development and helps other developers discover the language.

---

✦ Discoverability & Tags

#bramandscript #bmd #programming-language #compiler #virtual-machine #bytecode #stack-machine #golang #termux #zero-dependencies #pratt-parser #lexer #ast #developer-tools #cli #repl #opensource

---

✦ Contributing

Contributions are warmly welcomed! Please read CONTRIBUTING.md for details on code standards, our strict Zero External Dependencies rule, and our No Emojis Policy.

---

✦ License

This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2026 Codeleafly ziprecovery2024@gmail.com (https://github.com/Codeleafly). All rights reserved.