@hpcc-js/wasm

@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 - v9.0.0
• zstd - v1.5.5
• ...more to follow...

Built with:

• emsdk - v3.1.47

Homepage and Documents

• Homepage
  • Base91
  • Expat
  • Graphviz
  • Zstd

Quick Migration Example

v1.x.x

import { graphviz, wasmFolder } from "@hpcc-js/wasm";

wasmFolder("https://cdn.jsdelivr.net/npm/@hpcc-js/wasm/dist");

const dot = "digraph G { Hello -> World }";

graphviz.dot(dot).then(svg => {
    const div = document.getElementById("placeholder");
    div.innerHTML = svg;    
});

graphvizVersion.then(version => console.log(version));

v2.x.x

import { Graphviz } from "@hpcc-js/wasm/graphviz";

const graphviz = await Graphviz.load();

const dot = "digraph G { Hello -> World }";
const svg = graphviz.dot(dot);
console.log(graphviz.version());

Notes:

• Import must specify which wasm library you are 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.

Changelog

2.15.0 (2023-11-25)

Features

• Add nop and nop2 layout options (f71c4f1)

Bug Fixes

• Limit dependabot.yml to only bump security issues (b41a764)
• Site generation was failing (c64cd0f)