Skip to content

Generate typescript bindings for Embind projects

Notifications You must be signed in to change notification settings

ted537/tsembind

Repository files navigation

Typescript for Emscripten (TSEMBIND)

Generate .d.ts files using your existing Emscripten projects. Re-compiling is not necessary!

image

Installation:

npm i -g tsembind

Usage:

tsembind my-embind-lib.js

How it works

Embind registers functions,classes, etc. at runtime, by calling JS functions like __embind_register_function() from WASM. These functions can be replaced by replacing WebAssembly.instantiate() with a wrapper. Similarly, __embind_register_function() can be wrapped to compile the type information.

Limitations

Embind only knows the order and type of parameters at runtime. As such, declarations will refer to parameters as arg0, arg1, etc

Compatibility

Known to work with the following EMSDK config.

releases-upstream-c2ac7520fad29a7937ed60ab6a95b08eb374c7ba-64bit
node-14.15.5-64bit

Development

Install EMSDK, make sure everything is on the path, and then run npm build

To debug, run npm link followed by tsembind lib/examplelib.js

To run the automatic tests, run npm test

About

Generate typescript bindings for Embind projects

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published