hpcc-js-wasm

@hpcc-js/wasm

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
• duckdb - v1.5.5
• expat - v2.8.2
• graphviz - 16.1.0
• llama.cpp - b10437
• NeuralAmpModelerCore - v0.5.4
• zstd - v1.5.7
• ...more to follow...

Built with:

• emsdk - v6.0.9
• vcpkg - 2026.07.29

Homepage and Documents

• Homepage
  • Base91
  • DuckDB
  • Expat
  • Graphviz
  • Graphviz CLI
  • Llama
  • Llama CLI
  • NeuralAmpModelerCore
  • Zstd

AI Assistant / Copilot Instructions

This repository includes comprehensive instructions for AI assistants and GitHub Copilot:

• Main Instructions - Repository overview and architecture
• Development Workflow - Step-by-step development processes
• Package Patterns - Common patterns and quick reference
• Troubleshooting Guide - Debugging and problem resolution
• Package-specific guides in packages/*/ directories

Packages

This repository is a monorepo with the following packages:

• @hpcc-js/wasm-base91
• @hpcc-js/wasm-duckdb
• @hpcc-js/wasm-expat
• @hpcc-js/wasm-graphviz
• @hpcc-js/wasm-graphviz-cli
• @hpcc-js/wasm-llama
• @hpcc-js/wasm-llama-cli
• @hpcc-js/wasm-nam-core
• @hpcc-js/wasm-zstd
• @hpcc-js/wasm (meta package for backward compatibility)

Quick Start

…

Quick Migration from v1

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";

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

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

  console.log(graphviz.version());
});

Notes:

• wasmFolder is no longer needed
• All wasm libraries have the same asynchronous load pattern
  • const instance = await .load();

v3.x.x

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

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

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

  console.log(graphviz.version());
});

Build Instructions

The following instructions are for building the entire repository from scratch. In general the instructions assume you are running from within a bash terminal.

• Windows (With WSL2 and Git Bash installed)
• Linux (native or WSL2)
• MacOS
• Docker

Pre-requisites

To get an idea of what pre-requisites are required, please see the following files:

• Dockerfile
• GH Action Ubuntu
• Node.js (CI runs Node.js 22 and 24; docs deploy uses Node.js 20)

Steps (Docker)

git clone https://github.com/hpcc-systems/hpcc-js-wasm.git
cd hpcc-js-wasm
npm ci
npm run build-docker

Steps (Windows, Linux, MacOS)

git clone https://github.com/hpcc-systems/hpcc-js-wasm.git
cd hpcc-js-wasm
npm ci
npm run install-build-deps
npm run build