@hpcc-js/wasm - Version 2

@hpcc-js/wasm is now an ESM by default package - this is a good thing, but does require some breaking changes.

This repository contains a collection of useful c++ libraries compiled to WASM for (re)use in Node JS, Web Browsers and JavaScript Libraries:

• base91 - v0.6.0
• expat - v2.5.0
• graphviz - v7.0.4
• zstd - v1.5.2
• ...more to follow...

Built with:

• emsdk - v3.1.27

Homepage and Documents

• Homepage
  • Base91
  • Expat
  • Graphviz
  • Zstd

Quick Migration Example

v1.x.x

1import { graphviz, wasmFolder } from "@hpcc-js/wasm";
2
3wasmFolder("https://cdn.jsdelivr.net/npm/@hpcc-js/wasm/dist");
4
5const dot = "digraph G { Hello -> World }";
6
7graphviz.dot(dot).then(svg => {
8    const div = document.getElementById("placeholder");
9    div.innerHTML = svg;    
10});
11
12graphvizVersion.then(version => console.log(version));

v2.x.x

1import { Graphviz } from "@hpcc-js/wasm/graphviz";
2
3const graphviz = await Graphviz.load();
4
5const dot = "digraph G { Hello -> World }";
6const svg = graphviz.dot(dot);
7console.log(graphviz.version());

Notes:

• Import must specify which wasm library your using
• wasmFolder is no longer needed
• All wasm libraries have the same asynchronous load pattern
  • const instance = await Wasm.load();

⚠⚠⚠ TypeScript Notes ⚠⚠⚠

When importing an ESM package AND referencing explicit exports (like @hpcc-js/wasm/graphviz or @hpcc-js/wasm/expat), you should change the following tsconfig.json setting:

• moduleResolution: Node16

This will ensure the correct "types" are auto discovered.