wat2ts

Convert WebAssembly into importable TypeScript

import { compile } from 'wat2ts';
const wat_src = fs.readFileSync('example.wat');
const ts_src = compile(wat_src);
fs.writeFileSync('example.ts', ts_src);

The compile function parses the WebAssembly text format input, produces a binary module, encodes the binary as text, and then produces TypeScript source which embeds the encoded module, decodes it, and exports a type declaration for the module's imports and exports objects and a function which can be used to instantiate the module and return its exports.

The interface of generated modules which require no imports is as follows:

export type ModuleExports = { /* whatever the exported fields are */ };
export default async function(): Promise<ModuleExports>;

The interface of generated modules which do require imports is as follows:

export type ModuleImports = { [module: string]: { /* whatever the imported fields are */ }; };
export type ModuleExports = { /* whatever the exported fields are */ };
export default async function(imports: ModuleImports): Promise<ModuleExports>;

The package also exports compile_wat (an alias for the basic compile function) and compile_wasm(bin: Uint8Array): string, which performs the same function with a binary-formatted WASM files rather than text-formatted WAT files.

This package also installs a command line tool wat2ts which takes list of names of files or directories, compiles any .wat or '.wasm' files that it finds, and saves corresponding .ts files with the same names.

Currently function parameter names are not preserved, as type information is extracted from the compiled binary module. This could be fixed with an appropriate WAT parser.

TODO

• Preserve function parameter names when compiling from text format.