openbim-ifc-wasm
WebAssembly bindings for openbim-ifc: read, edit and write IFC STEP files from JavaScript.
| Status | Implemented |
| Latest release | 0.16.0 (2026-11-09) |
| Registries | npm @openbim/ifc |
| API documentation | rustdoc |
| Source | crates/openbim-ifc-wasm/ |
Overview
WebAssembly bindings for the IFC facade (ADR 0013, #34).
Reads, edits and writes IFC STEP files from JavaScript. The surface is the record model: an IfcModel holds entities, each a type name plus positional attributes. Attribute values cross the boundary in the lossless tagged encoding of openbim_ifc_binding_core::value, so a file read and written back through JavaScript is unchanged.
Every operation lives in openbim-ifc-binding-core, shared with the C and Python bindings. This crate converts JS arguments and results only, and is empty outside wasm32.
A test of anything that does not need a JS host belongs in openbim-ifc-binding-core, where cargo test runs it natively; the Node suites here cover only the JS conversion itself.
Features
| Feature | Default | Enables |
|---|---|---|
author | yes | openbim-ifc-binding-core/author |
classification | yes | openbim-ifc-binding-core/classification |
cost | yes | openbim-ifc-binding-core/cost |
georef | yes | openbim-ifc-binding-core/georef |
graph | openbim-ifc-binding-core/graph | |
ifc2x3 | yes | openbim-ifc-binding-core/ifc2x3 |
ifc4 | yes | openbim-ifc-binding-core/ifc4 |
ifc4x1 | yes | openbim-ifc-binding-core/ifc4x1 |
ifc4x2 | yes | openbim-ifc-binding-core/ifc4x2 |
ifc4x3 | yes | openbim-ifc-binding-core/ifc4x3 |
ifcxml | yes | openbim-ifc-binding-core/ifcxml |
material | yes | openbim-ifc-binding-core/material |
mesh | openbim-ifc-binding-core/mesh | |
placements | yes | openbim-ifc-binding-core/placements |
properties | yes | openbim-ifc-binding-core/properties |
properties-write | yes | openbim-ifc-binding-core/properties-write |
property-catalog | openbim-ifc-binding-core/property-catalog | |
property-catalog-runtime | yes | openbim-ifc-binding-core/property-catalog-runtime |
sheet-xlsx | openbim-ifc-binding-core/sheet-xlsx | |
spatial | yes | openbim-ifc-binding-core/spatial |
systems | yes | openbim-ifc-binding-core/systems |
unreachable | yes | openbim-ifc-binding-core/unreachable |
validate | yes | openbim-ifc-binding-core/validate |
validate-express | yes | openbim-ifc-binding-core/validate-express |
zip | yes | openbim-ifc-binding-core/zip |
Depends on
Changes
Latest release, 0.16.0 (2026-11-09):
Changed (wire format 1.5)
- The geometry graph payload (#367) may be Axiolid's wire format 1.5, written only when a graph holds a ruled surface (axiolid/kernel#402); every other graph keeps its version. The newest version the build advertises (
GEOMETRY_FORMAT_VERSION) is"1.5". A reader onaxiolid-model0.3.17 or older refuses1.5.
Added (#603)
SurfaceColour.sourcecan be"materialSet":sourceEntityis the set (IfcMaterialLayerSet,IfcMaterialProfileSet,IfcMaterialConstituentSetorIfcMaterialList, or a usage of one (IfcMaterialLayerSetUsage,IfcMaterialProfileSetUsageand itsTapering)) whose materials all state the colour, and the newsourceMaterialslists the materials of the set that colour the item: every one, or the constituents its shape aspects name (ascending id, distinct); empty for other sources.
Semver: minor (pre-1.0 breaking: a record field is added).
Changed (#651)
representationaccepts"Reference", the void geometry of an IFC4 Reference View opening.
Semver: patch (additive).
Changed (#614)
- A diagnostic string with a position reads "warning at line L, column C (bytes a..b): ...".
Semver: patch (Display text changes)
Fixed (#617)
- The first id handed out after a read is above every declared and referenced id, so a new entity never takes the id of a dangling reference or a skipped record.
Semver: patch
Full history: crates/openbim-ifc-wasm/CHANGELOG.md