geolibre-wasm

A pure-Rust geospatial toolkit compiled to WebAssembly, runnable entirely in the browser, Node, Deno, or any bundler. No server, no Python, no native install.

It is a superset of whitebox-wasm: everything that package offers, plus new GeoLibre tools. Built on opengeos/whitebox-wasm, the WASM-ready fork of whitebox_next_gen.

Source repo: opengeos/geolibre-rust.

Two layers, two entry points:

• geolibre-wasm (the . export) -- a wasm-bindgen browser library with typed in-memory APIs for GeoTIFF/COG read+write, projections, vector, and LiDAR.
• geolibre-wasm/tools (the ./tools export) -- a WASI tool runner exposing the whitebox tool suite plus GeoLibre's own tools.

Install

npm install geolibre-wasm

geolibre-wasm/tools uses @bjorn3/browser_wasi_shim (a runtime dependency) to run the WASI binary over an in-memory filesystem.

Library usage (.)

import init, { GeoTiffReader, CogBuilder, geotiff_info, version } from "geolibre-wasm";

await init(); // load the wasm-bindgen module (browsers/bundlers)

const r = new GeoTiffReader(tiffBytes); // Uint8Array
console.log(r.width, r.height, r.bands, r.epsg);
const band0 = r.read_band_f64(0);        // Float64Array

// header-only metadata (works on multi-GB files)
const meta = JSON.parse(geotiff_info(tiffBytes));

Classes include GeoTiffReader (parse once, read many), CogBuilder (encode Cloud Optimized GeoTIFFs), and CogStream (range-request tiled COG reading).

Tools usage (./tools)

import { runTool, listTools, listManifests } from "geolibre-wasm/tools";

// every available tool id
const tools = await listTools();

// run a tool: inputs go into an in-memory /work dir; new files come back out
const { exitCode, stdout, files } = await runTool("slope", {
  args: ["--input=/work/dem.tif", "--output=/work/slope.tif", "--units=degrees"],
  input: { "dem.tif": demBytes }, // Uint8Array
});
const slopeCog = files["slope.tif"]; // Uint8Array (Cloud Optimized GeoTIFF)

Inputs are placed under /work (keyed by filename); any file a tool writes is returned in files. Raster outputs are Cloud Optimized GeoTIFFs; vector outputs are GeoJSON.

API

| Export | Description | |---|---| | initTools(source?) | Compile the WASI runner once. Omit source in browsers/bundlers; pass wasm bytes or a URL/Response in Node. | | listTools(): Promise<string[]> | Every available tool id. | | listManifests(): Promise<ToolManifest[]> | All tool manifests (parameter schemas), for building UIs offline. | | runTool(tool, { args?, input? }): Promise<ToolResult> | Run one tool over the in-memory filesystem. |

ToolResult is { exitCode: number, stdout: string[], files: Record<string, Uint8Array> }.

Notes

• Bundler users (Vite, etc.): exclude this package from dependency pre-bundling so the new URL("./geolibre-cli.wasm", import.meta.url) reference is preserved (e.g. Vite's optimizeDeps.exclude).
• Bounded by WebAssembly's ~4 GiB memory and single-threaded execution; use a server-side path for very large data.

License

MIT