Skip to content

openbim-ifc-wasm ​

WebAssembly bindings for openbim-ifc: read, edit and write IFC STEP files from JavaScript.

StatusImplemented
Latest release0.16.0 (2026-11-09)
Registriesnpm @openbim/ifc
API documentationrustdoc
Sourcecrates/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 ​

FeatureDefaultEnables
authoryesopenbim-ifc-binding-core/author
classificationyesopenbim-ifc-binding-core/classification
costyesopenbim-ifc-binding-core/cost
georefyesopenbim-ifc-binding-core/georef
graphopenbim-ifc-binding-core/graph
ifc2x3yesopenbim-ifc-binding-core/ifc2x3
ifc4yesopenbim-ifc-binding-core/ifc4
ifc4x1yesopenbim-ifc-binding-core/ifc4x1
ifc4x2yesopenbim-ifc-binding-core/ifc4x2
ifc4x3yesopenbim-ifc-binding-core/ifc4x3
ifcxmlyesopenbim-ifc-binding-core/ifcxml
materialyesopenbim-ifc-binding-core/material
meshopenbim-ifc-binding-core/mesh
placementsyesopenbim-ifc-binding-core/placements
propertiesyesopenbim-ifc-binding-core/properties
properties-writeyesopenbim-ifc-binding-core/properties-write
property-catalogopenbim-ifc-binding-core/property-catalog
property-catalog-runtimeyesopenbim-ifc-binding-core/property-catalog-runtime
sheet-xlsxopenbim-ifc-binding-core/sheet-xlsx
spatialyesopenbim-ifc-binding-core/spatial
systemsyesopenbim-ifc-binding-core/systems
unreachableyesopenbim-ifc-binding-core/unreachable
validateyesopenbim-ifc-binding-core/validate
validate-expressyesopenbim-ifc-binding-core/validate-express
zipyesopenbim-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 on axiolid-model 0.3.17 or older refuses 1.5.

Added (#603) ​

  • SurfaceColour.source can be "materialSet": sourceEntity is the set (IfcMaterialLayerSet, IfcMaterialProfileSet, IfcMaterialConstituentSet or IfcMaterialList, or a usage of one (IfcMaterialLayerSetUsage, IfcMaterialProfileSetUsage and its Tapering)) whose materials all state the colour, and the new sourceMaterials lists 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) ​

  • representation accepts "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

Dual-licensed under AGPL-3.0-or-later or a commercial licence. ISO and CEN standards material is not redistributed.