emscripten-library-decorator

This package provides decorators for writing Emscripten libraries.

function _print(message: string) {
    console.log(message);
}
 
@exportLibrary
class test {
    @dep(_print)
    static hello() {
        _print('Hello, World!!');
    }
 
    static foobar = 42;
};

The class decorator @exportLibrary exports the static members of the class as an Emscripten library. Place it with no arguments just before the class.

The property decorator @dep is for listing dependencies. It ensures that when an exported function is used in the C or C++ code, other required functions are also included in the compiled Emscripten output after dead code elimination. Place it just before a function with any number of parameters listing the other required functions.

The dependencies should be global functions and their name should begin with an underscore. Otherwise Emscripten's name mangling will change their name in the output making any calls to them fail.

There is a longer article with more information.

API

Docs generated using docts

Function defineHidden

@_defineHidden decorator.
Assign to a local variable called _defineHidden before using.
Apply to a property to protect it from modifications and hide it.
Source code: <>

defineHidden( ) ^{⇒ (target: Object, key: string) => void} <>
 ▫ value_? ^any

Function dep

@dep decorator.
Apply to a function, to list other required variables needing protection
from dead code removal.
Arguments can be functions or names of global variables.
Source code: <>

dep( ) ^{⇒ (target: Object, functionName: string) => void} <>
 ▪ depList ^{((...args: any[]) => any | string)[]}

Function exportLibrary

@exportLibrary decorator.
Apply to a class with static methods, to export them as functions.
Source code: <>

exportLibrary( ) ^{⇒ void} <>
 ▪ target ^any

Function prepareNamespace

@prepareNamespace decorator.
Apply to an empty, named dummy class defined at the end of the namespace
block, to prepare its contents for export in an Emscripten library.
Namespaces with matching names in different files are merged together.
All code in the block is separated because Emscripten only outputs global
functions, not methods.
Source code: <>

prepareNamespace( ) ^{⇒ (target: any) => void} <>
 ▪ name ^string

Function publishNamespace

Call once per namespace at the global level, after all files with contents
in that namespace have been imported. Clears the namespace and exports a
"postset" function to populate it using its original code.
Source code: <>

publishNamespace( ) ^{⇒ void} <>
 ▪ name ^string

Function setEvil

Allow decorators to call eval() in the context that called them.
This is needed for various transformations.
Source code: <>

setEvil( ) ^{⇒ void} <>
 ▪ otherEval ^{(code: string) => any} must be this function: (code: string) => eval(code)

License

The MIT License

Copyright (c) 2015-2017 BusFaster Ltd