polystrata-3d

Interactive 3D Planar B-Rep Lab • Live 3D Benchmark Suite • npm • crates.io • docs.rs

polystrata-3d is a high-performance, topologically robust 3D Planar Boundary-Representation (B-Rep) Boolean & Healing kernel implemented in Rust and compiled to WebAssembly.

Unlike triangle-mesh CSG libraries (manifold-3d, three-bvh-csg), polystrata-3d operates directly on exact planar polygon faces with interior holes in IEEE-754 f64 precision, unifying coplanar regions, resolving 3D T-junctions conformally, and stripping non-manifold dangling fins to guarantee closed, watertight 2-manifold (∂₁ · ∂₂ = 0) output.

• Zero dependencies, self-contained dual ESM + CommonJS build (including embedded WASM) and native Rust crate (polystrata-3d on crates.io).
• Faster than manifold-3d (v3.5.4 C++/WASM) on 7 of 10 3D CAD, bicylinder, and glancing workloads (1.04×–2.17× faster), while emitting 3×–4× fewer polygonal faces and 10⁸× lower volume error (~10⁻¹³ vs. ~10⁻⁵).
• 100% watertight 2-manifold pass rate (24/24) across the 3D adversarial glancing & degeneracy stress suite (manifold-3d: 23/24 with 1 crash on non-manifold input; three-bvh-csg: 3/24; @jscad/modeling: 4/24).
• Looking for 2D polygon clipping? See polystrata.

Installation

JavaScript / TypeScript (npm):

npm install polystrata-3d

Rust (crates.io / docs.rs):

cargo add polystrata-3d

Quick Start (TypeScript / JavaScript)

import {
  union,
  intersect,
  difference,
  xor,
  heal,
  createBox,
  extrudePolygon,
  transformSolid,
  initPolystrata3D,
} from "polystrata-3d";

// Optional on Node.js / Bun / Deno / Web Workers; recommended once at startup on browser main threads:
await initPolystrata3D();

const boxA = createBox([-5, -5, -5], [5, 5, 5]);
const boxB = createBox([0, 0, 0], [8, 8, 8]);

const diff = difference(boxA, boxB);
console.log(diff.solid.faces);          // Exact unified planar faces ({ outer, holes, normal })
console.log(diff.triangles);            // Ready-to-render 3D surface triangles
console.log(diff.totalVolume);          // 875.0
console.log(diff.unmatchedHalfEdgeCount); // 0 (watertight 2-manifold)

Quick Start (Rust)

use polystrata_3d::{union, intersect, difference, xor, heal, KernelOptions, Point3D, Face3D, Solid3D};

let opts = KernelOptions::default();
let res = difference(&solid_a, &solid_b, opts);
assert_eq!(res.unmatched_half_edge_count, 0);

Benchmarks vs. manifold-3d, three-bvh-csg, and @jscad/modeling

Run the 3D benchmark suite locally with npm run bench:

License

MIT