Ishvara

Compile JavaScript to WASM and Fasm.

Install

npm i ishvara -g

Usage Example

Let's suppose you have JavaScript:

function add() {
    const eax = 1;
    const ebx = 2;
    
    return eax + ebx;
}

You can compile it to fasm to wasm.

Fasm

Let's compile javascript with:

ishvara --target fasm example/fn.ts -o code

To intermediate representation:

__ishvara_add: {
    mov(eax, 0x1);
    mov(ebx, 0x2);
    add(eax, ebx);
    ret;
}

Also we can compile it with:

ishvara -t fasm example/fn.ts -o code

to assembly representation with:

__ishvara_add:
mov eax, 0x1
mov ebx, 0x2
add eax, ebx
ret

Also we can compile it to binary representation with ishvara fasm example/fn.ts:

$ hexdump example/fn.bin

0000000 b866 0001 0000 bb66 0002 0000 0166 c3d8
0000010

Example

Let's suppose we have absolutely valid JavaScript file with types, which we can run with node v24.

import {create} from '#ishvara';

export const stack = [];

export const imports = [
    ['console', 'log', function log() {
        return i32;
    }],
];

const {
    i32,
    local,
    call,
} = create({
    stack,
    imports,
});

export function x(a: i32, b: i32): i32 {
    i32.add(local.get(a), local.get(b));
    call('log');
}

Compiled with ishvara 1.wast.ts to 1.wast:

(module
    (import "console" "log" (func $log (param $message i32) (result i32)))
    (func $x (export "x") (param $a i32) (param $b i32) (result i32)
        (i32.add (local.get $a) (local.get $b))
        (call $log)
    )
)

With:

import {compile} from 'ishvara';

const wast = compile(wastts);
const binary = await translate(wast);

const {x} = run(binary, {
    console: {
        log: (a) => {
            console.log(a);
            return a;
        },
    },
});

x(1, 2);
// outputs
3;

License

MIT