Imported from bauripalash/pankti (AGENTS.md). Install upstream with npx skills add bauripalash/pankti. Copyright stays with the author.

AGENTS.md - Pankti Programming Language

Project Overview

Pankti (পঙক্তি) is a dynamically typed programming language designed for programming in Bengali, English, Bengali phonetic and combinations for them. It is implemented primarily in C.

Pankti Language Syntax Guide

Pankti supports three syntax modes that can be mixed freely.

1. Bengali: Native Bengali Script
2. Phonetic Bengali: Bengali words written in Latin script.
3. English: Standard English keywords

Keywords

Operators

Arithmetic

Comparison

Logical

Built-in Functions

Data Types

Numbers

Pankti Supports Bengali and Arabic numerals and mixture of them both.

১২৩৪৫
12345
৩.১৪
9৯.৯9

Strings

"পলাশ বাউরি"
"Hello world"

Booleans

সত্যি, true, sotti
মিথ্যা, false, mittha

Arrays

["পলাশ", "বাউরি", 3.14, সত্যি]

Nil

nil
নিল

Maps/Hash tables

{
    "নাম" : "পলাশ",
    "পদবী" : "বাউরি"
    "সময়" : ১২.১২
}

Variable Declaration

// Bengali
ধরি নাম = "পলাশ"

// Phonetic
dhori nam = "Palash"

// English
let name = "Palash"

Functions

// Bengali
কাজ যোগ(ক, খ)
    ফেরাও ক + খ
শেষ

// Phonetic
kaj jog(a, b)
    ferao a + b
sesh

// English
func add(a, b)
     return a + b
end

Function Call

add(5, 5)
যোগ(৫, ৫)

If-Then-Else Conditional

// Bengali
যদি <শর্ত> তাহলে
    # কিছু কাজ
নাহলে
    # কিছু কাজ
শেষ

// Phonetic
jodi <condition> tahole
     # some work
nahole
    # some work
end

// English
if <condition> then
   # some work
else
    # some work
end

While Loop

// Bengali
যতক্ষণ <শর্ত> করো
    # কিছু কাজ
শেষ

// Phonetic
jotokhon <condition> koro
    # some work
sesh

// English
while <condition> do
    # some work
end

Subscripting

ধরি তালিকা = [১,২,৩]
ধরি তথ্য = { "নাম" : "পলাশ", ১ : ২  }

তালিকা[০] //১
তথ্য["নাম"] // পলাশ

Comments

// Single line comment

File Extension

Pankti source files use .pn extension. .pank are also valid for legacy purpose.

Architecture Overview

Source Tree Structure

src/              
    alloc.h             # Memory Allocation Utilities
    argparse.h          # Argument Parsing System
    ast.h               # Abstract Syntax Tree definitions
    bengali.h           # Bengali characters handling
    builtins.h          # Built-in Functions
    compiler.h          # Bytecode Compiler
    core.h              # Core runtime
    defaults.h          # Default values used across the project
    diagonctx.h         # Parsing, Compiling, Runtime Diagnostics handling
    flags.h             # Feature flags for runtime
    gc.h                # Garbage Collector
    gfx.h           # Pankti to Graphics backend connector (Drawing, Text
    Shaping, Input Handling)
    gfx_constants.h     # Graphics related constants (Color names, Key names)
    keywords.h          # Keyword definitions (Bengali, English, Phonetic)
    lexer.h             # Lexer interface
    object.h            # Object System (Values, Strings, Functions etc.)
    opcode.h            # Bytecode Opcodes
    panktiterms.h       # Terminology used throught the project
    parser.h            # Parser
    printer.h           # Writing to output device interface
    pstdlib.h           # Pankti Standard Library definitions
    ptypes.h            # Type definitions (u8, u16, u32, u64)
    strescape.h         # Helper to escape characters like \n, \t \xHH, \uHHHH etc in strings
    strpool.h           # String Interning handler
    symtable.h          # Symbol Table for Compiler/VM
    system.h            # OS Detection and Other OS related utilities
    terminal.h          # Terminal related utilities
    token.h             # Token definitions
    unicode.h           # Unicode and Grapheme related utilities
    ustring.h           # Codepoint Iterator interface
    utils.h             # Utilities
    version.h           # Version definition
    vm.h                # Virtual Machine   

Compilation Pipeline

1. Lexer (src/lexer.c): Token source code.
2. Parser (src/parser.c): Build Abstract Syntax Tree from tokens.
3. Compiler (src/compiler.c): Generate Bytecode from AST
4. Virtual Machine (src/vm.c): Stack-based virtual machine executing bytecode.

Graphics Backend

For Standard Library's Graphics module pankti current uses Tigr library (https://github.com/erkkah/tigr).

Build System

CMake (Primary)

# Configure Debug Build
cmake -B build -DCMAKE_BUILD_TYPE=Debug

# Configure Release Build
cmake -B build -DCMAKE_BUILD_TYPE=Release

# Build Pankti Binary
cmake --build build --target pankti

Build Options

C Language Standard

• C11 is required
• GNU extensions enabled for GCC builds

Naming Conventions