brepjs-bim 0.24.5 → 0.25.0

package/README.md

@@ -210,3 +210,18 @@ If measurement or temporary cleanup fails, serialization omits optional Wall qua
 Opening reconstruction retains every surviving solid in source-item order, including split results. Complete removal produces no imported solids and null aggregate bounds and volume. The singleton `.solid` field remains a borrowed alias only for a complete one-solid result.
 
 Complete imported aggregates use shared occupied-material measurement and all-item bounds. Overlaps count once. Failed measurement leaves both aggregates unavailable with an import diagnostic. Later opening failures clean the current host list, including every earlier survivor, and never retry an uncertain release.
+
+### Retained Body IFC geometry
+
+Wall and Railing exports preflight and tessellate every retained item in order, preserving placement, styles, and metadata.
+
+Wall openings export as IFC `Reference` geometry because the retained Wall Body already
+contains its cuts. Void/fill relationships and opening placements remain intact. IFC4 defines
+Reference openings as non-subtractive; gross recipe exports such as Slab openings still use
+subtractive `Body` geometry. The importer keeps Reference opening records and relationships
+without treating their reference shape as a display Body or cutting tool.
+
+IfcOpenShell 0.8.5 still subtracts Reference openings in its default geometry engine, even with
+a separate Reference context. If a replacement Body adds material inside a retained opening's
+region, that engine can remove the added material. Schema validation and shape generation alone
+do not detect this difference; check the representation semantics and retained item geometry.

package/dist/brepjs-bim.cjs

@@ -1719,7 +1719,7 @@ var Doc = class {
 var version = {
 	major: 4,
 	minor: 6,
-	patch: 4
+	patch: 5
 };
 //#endregion
 //#region ../../node_modules/zod/v4/core/schemas.js
@@ -9765,11 +9765,21 @@ function writeHeader(w, meta) {
 		WorldCoordinateSystem: w.ref(writeAxis2Placement3D(w)),
 		TrueNorth: null
 	});
+	return {
+		ownerHistoryId,
+		geomContextId,
+		geomSubContextId: writeGeometricSubContext(w, geomContextId, "Body"),
+		unitAssignmentId,
+		lengthUnitId
+	};
+}
+/** Separates display Body geometry from non-subtractive Reference geometry. */
+function writeGeometricSubContext(w, geomContextId, identifier) {
 	const geomSubContextId = w.nextId();
 	w.writeLine({
 		expressID: geomSubContextId,
 		type: web_ifc.IFCGEOMETRICREPRESENTATIONSUBCONTEXT,
-		ContextIdentifier: w.mkType(web_ifc.IFCLABEL, "Body"),
+		ContextIdentifier: w.mkType(web_ifc.IFCLABEL, identifier),
 		ContextType: w.mkType(web_ifc.IFCLABEL, "Model"),
 		CoordinateSpaceDimension: null,
 		Precision: null,
@@ -9783,13 +9793,7 @@ function writeHeader(w, meta) {
 		},
 		UserDefinedTargetView: null
 	});
-	return {
-		ownerHistoryId,
-		geomContextId,
-		geomSubContextId,
-		unitAssignmentId,
-		lengthUnitId
-	};
+	return geomSubContextId;
 }
 /**
 * Writes IfcProjectedCRS + IfcMapConversion georeferencing the model context
@@ -10197,7 +10201,7 @@ function writePreparedTessellationBody(w, items, geomSubContextId) {
 		bodyItemIds
 	};
 }
-function writeExactBodyGeometry(w, placement, items, geomSubContextId, parentPlacementId) {
+function writeProductBodyGeometry(w, placement, items, geomSubContextId, parentPlacementId) {
 	const placement3DId = writeAxis2Placement3D(w, [
 		toIfcLengthM(placement.origin[0]),
 		toIfcLengthM(placement.origin[1]),
@@ -10243,47 +10247,6 @@ function writePreparedTessellationItem(w, prepared) {
 	});
 	return faceSetId;
 }
-/**
-* Builds a wall 'Axis' IfcShapeRepresentation: an IfcPolyline from (0,0) to
-* (lengthM, 0) in the wall's local XY plane, wrapped in an IfcShapeRepresentation
-* with RepresentationIdentifier='Axis', RepresentationType='Curve2D'. Returns
-* the IfcShapeRepresentation express ID so callers can add it alongside the Body
-* representation in an IfcProductDefinitionShape.
-*
-* wallLengthMm is the wall length in mm (brepjs native units); it is converted
-* to metres for IFC.
-*/
-function writeWallAxisRepresentation(w, wallLengthMm, geomSubContextId) {
-	const lengthM = toIfcLengthM(wallLengthMm);
-	const startId = w.nextId();
-	w.writeLine({
-		expressID: startId,
-		type: web_ifc.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(web_ifc.IFCLENGTHMEASURE, 0), w.mkType(web_ifc.IFCLENGTHMEASURE, 0)]
-	});
-	const endId = w.nextId();
-	w.writeLine({
-		expressID: endId,
-		type: web_ifc.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(web_ifc.IFCLENGTHMEASURE, lengthM), w.mkType(web_ifc.IFCLENGTHMEASURE, 0)]
-	});
-	const polylineId = w.nextId();
-	w.writeLine({
-		expressID: polylineId,
-		type: web_ifc.IFCPOLYLINE,
-		Points: [w.ref(startId), w.ref(endId)]
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: web_ifc.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(web_ifc.IFCLABEL, "Axis"),
-		RepresentationType: w.mkType(web_ifc.IFCLABEL, "Curve2D"),
-		Items: [w.ref(polylineId)]
-	});
-	return shapeRepId;
-}
 function writeFacetedBrepFallback(w, geomSubContextId, reason) {
 	const originId = w.nextId();
 	w.writeLine({
@@ -10614,81 +10577,6 @@ function writePolyline(w, points) {
 }
 //#endregion
 //#region src/ifc-writer/geometryWriter.ts
-function writeWallGeometry(w, spec, geomSubContextId, parentPlacementId) {
-	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: web_ifc.IFCLOCALPLACEMENT,
-		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
-		RelativePlacement: w.ref(placement3DId)
-	});
-	const thicknessM = toIfcLengthM(spec.thickness);
-	const heightM = toIfcLengthM(spec.height);
-	const lengthM = toIfcLengthM(spec.length);
-	const profileId = w.nextId();
-	w.writeLine({
-		expressID: profileId,
-		type: web_ifc.IFCRECTANGLEPROFILEDEF,
-		ProfileType: {
-			type: 3,
-			value: "AREA"
-		},
-		ProfileName: null,
-		Position: w.ref(writeAxis2Placement2D$1(w, [thicknessM / 2, heightM / 2])),
-		XDim: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, thicknessM),
-		YDim: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, heightM)
-	});
-	const extrusionPosId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	], [
-		1,
-		0,
-		0
-	], [
-		0,
-		1,
-		0
-	]);
-	const extrusionDirId = writeDirection(w, [
-		0,
-		0,
-		1
-	]);
-	const extrusionId = w.nextId();
-	w.writeLine({
-		expressID: extrusionId,
-		type: web_ifc.IFCEXTRUDEDAREASOLID,
-		SweptArea: w.ref(profileId),
-		Position: w.ref(extrusionPosId),
-		ExtrudedDirection: w.ref(extrusionDirId),
-		Depth: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, lengthM)
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: web_ifc.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(web_ifc.IFCLABEL, "Body"),
-		RepresentationType: w.mkType(web_ifc.IFCLABEL, "SweptSolid"),
-		Items: [w.ref(extrusionId)]
-	});
-	const axisRepId = writeWallAxisRepresentation(w, spec.length, geomSubContextId);
-	const productDefinitionShapeId = w.nextId();
-	w.writeLine({
-		expressID: productDefinitionShapeId,
-		type: web_ifc.IFCPRODUCTDEFINITIONSHAPE,
-		Name: null,
-		Description: null,
-		Representations: [w.ref(axisRepId), w.ref(shapeRepId)]
-	});
-	return {
-		localPlacementId,
-		productDefinitionShapeId
-	};
-}
 function writeSlabGeometry(w, spec, geomSubContextId, parentPlacementId) {
 	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
 	const localPlacementId = w.nextId();
@@ -11831,104 +11719,6 @@ function writeRampAssembly(w, spec, rampKey, assemblyGuid, ownerHistoryId, geomS
 }
 //#endregion
 //#region src/ifc-writer/railingWriter.ts
-function writeRailingGeometry(w, spec, solid, geomSubContextId, parentPlacementId) {
-	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: web_ifc.IFCLOCALPLACEMENT,
-		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
-		RelativePlacement: w.ref(placement3DId)
-	});
-	if (spec.infill === "POSTED") {
-		const tess = writeTessellation(w, solid, geomSubContextId, localPlacementId);
-		return {
-			localPlacementId,
-			productDefinitionShapeId: tess.productDefinitionShapeId,
-			bodyItemId: null,
-			usedFallback: tess.usedFallback
-		};
-	}
-	const thicknessM = toIfcLengthM(spec.thickness);
-	const heightM = toIfcLengthM(spec.height);
-	const lengthM = toIfcLengthM(spec.length);
-	const profileOriginId = w.nextId();
-	w.writeLine({
-		expressID: profileOriginId,
-		type: web_ifc.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(web_ifc.IFCLENGTHMEASURE, thicknessM / 2), w.mkType(web_ifc.IFCLENGTHMEASURE, heightM / 2)]
-	});
-	const profilePosId = w.nextId();
-	w.writeLine({
-		expressID: profilePosId,
-		type: web_ifc.IFCAXIS2PLACEMENT2D,
-		Location: w.ref(profileOriginId),
-		RefDirection: null
-	});
-	const profileId = w.nextId();
-	w.writeLine({
-		expressID: profileId,
-		type: web_ifc.IFCRECTANGLEPROFILEDEF,
-		ProfileType: {
-			type: 3,
-			value: "AREA"
-		},
-		ProfileName: null,
-		Position: w.ref(profilePosId),
-		XDim: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, thicknessM),
-		YDim: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, heightM)
-	});
-	const extrusionPosId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	], [
-		1,
-		0,
-		0
-	], [
-		0,
-		1,
-		0
-	]);
-	const extrusionDirId = writeDirection(w, [
-		0,
-		0,
-		1
-	]);
-	const extrusionId = w.nextId();
-	w.writeLine({
-		expressID: extrusionId,
-		type: web_ifc.IFCEXTRUDEDAREASOLID,
-		SweptArea: w.ref(profileId),
-		Position: w.ref(extrusionPosId),
-		ExtrudedDirection: w.ref(extrusionDirId),
-		Depth: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, lengthM)
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: web_ifc.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(web_ifc.IFCLABEL, "Body"),
-		RepresentationType: w.mkType(web_ifc.IFCLABEL, "SweptSolid"),
-		Items: [w.ref(extrusionId)]
-	});
-	const productDefinitionShapeId = w.nextId();
-	w.writeLine({
-		expressID: productDefinitionShapeId,
-		type: web_ifc.IFCPRODUCTDEFINITIONSHAPE,
-		Name: null,
-		Description: null,
-		Representations: [w.ref(shapeRepId)]
-	});
-	return {
-		localPlacementId,
-		productDefinitionShapeId,
-		bodyItemId: extrusionId,
-		usedFallback: false
-	};
-}
 function writeRailingEntity(w, guid, name, _predefinedType, ownerHistoryId, localPlacementId, productDefinitionShapeId) {
 	const id = w.nextId();
 	w.writeLine({
@@ -13367,7 +13157,7 @@ function writeAxis2Placement2D(w) {
 	});
 	return id;
 }
-function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, geomSubContextId, ownerHistoryId) {
+function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, geomSubContextId, ownerHistoryId, representationIdentifier) {
 	const widthM = toIfcLengthM(openingSpec.width);
 	const heightM = toIfcLengthM(openingSpec.height);
 	const offsetAlongWallM = toIfcLengthM(openingSpec.offsetAlongWall);
@@ -13430,7 +13220,7 @@ function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, g
 		expressID: shapeRepId,
 		type: web_ifc.IFCSHAPEREPRESENTATION,
 		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(web_ifc.IFCLABEL, "Body"),
+		RepresentationIdentifier: w.mkType(web_ifc.IFCLABEL, representationIdentifier),
 		RepresentationType: w.mkType(web_ifc.IFCLABEL, "SweptSolid"),
 		Items: [w.ref(extrusionId)]
 	});
@@ -15187,18 +14977,22 @@ function checkGeoreferencing(reader) {
 	return [issue("warning", "NO_GEOREFERENCING", "Model contains a facility but no IfcProjectedCRS/IfcGeographicCRS (GRF003) — set ProjectSpec.crs")];
 }
 //#endregion
-//#region src/serialize/exactBodyPreflight.ts
+//#region src/serialize/productBodyPreflight.ts
 var testItemPreparer = null;
-/** Prepares every exact Body item without writing IFC lines. Source solids remain borrowed. */
-function preflightExactBody(input) {
+/** Prepares every retained Body item without writing IFC lines. Source solids remain borrowed. */
+function preflightProductBody(input) {
 	const prepareItem = input.prepareItem ?? testItemPreparer ?? prepareTessellation;
+	const failed = (itemIndex, reason, cause) => (0, brepjs.err)(ifcError("BODY_TESSELLATION_FAILED", `Product Body item ${itemIndex} for ${input.localId} could not be tessellated: ${reason}`, cause, {
+		localId: input.localId,
+		itemIndex
+	}));
 	const prepareAt = (solid, itemIndex) => {
-		const item = prepareItem(solid);
-		if (!item.ok) return (0, brepjs.err)(ifcError("EXACT_BODY_TESSELLATION_FAILED", `Exact Product Body item ${itemIndex} for ${input.localId} could not be tessellated: ${item.reason}`, item.cause, {
-			localId: input.localId,
-			itemIndex
-		}));
-		return (0, brepjs.ok)(item.value);
+		try {
+			const item = prepareItem(solid);
+			return item.ok ? (0, brepjs.ok)(item.value) : failed(itemIndex, item.reason, item.cause);
+		} catch (cause) {
+			return failed(itemIndex, cause instanceof Error ? cause.message : String(cause), cause);
+		}
 	};
 	const [firstSolid, ...remainingSolids] = input.solids;
 	const first = prepareAt(firstSolid, 0);
@@ -15266,24 +15060,13 @@ function wallVolumeError(cause) {
 function preflightProductBodies(elements) {
 	const preflighted = [];
 	for (const element of elements) {
-		const body = element.geometry;
-		if (body.kind === "PARAMETRIC") {
-			preflighted.push({
-				kind: "PARAMETRIC",
-				element,
-				solid: body.solid
-			});
-			continue;
-		}
-		const prepared = preflightExactBody({
+		const prepared = preflightProductBody({
 			localId: element.localId,
-			solids: body.solids
+			solids: bodySolids(element.geometry)
 		});
 		if (!prepared.ok) return (0, brepjs.err)(prepared.error);
 		preflighted.push({
-			kind: "EXACT",
 			element,
-			solids: body.solids,
 			items: prepared.value
 		});
 	}
@@ -15418,13 +15201,14 @@ async function serializeIfc(model, meta) {
 				spec: wall.spec,
 				solids: bodySolids(wall.geometry)
 			});
-			const { localPlacementId, productDefinitionShapeId } = preflighted.kind === "EXACT" ? writeExactBodyGeometry(w, wall.spec, preflighted.items, geomSubContextId, storeyPlacementId) : writeWallGeometry(w, wall.spec, geomSubContextId, storeyPlacementId);
+			const { localPlacementId, productDefinitionShapeId, bodyItemIds } = writeProductBodyGeometry(w, wall.spec, preflighted.items, geomSubContextId, storeyPlacementId);
 			const wallExpressId = writeWallEntity(w, wall.guid, `Wall ${i + 1}`, ownerHistoryId, localPlacementId, productDefinitionShapeId);
 			idMap.set(wall.localId, wallExpressId);
 			placementMap.set(wall.localId, localPlacementId);
 			writeWallCommonPset(w, ownerHistoryId, wallExpressId, wall.spec);
 			writeManufacturerPset(w, ownerHistoryId, wallExpressId, wall.spec);
 			if (wall.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, wallExpressId, wall.spec.customProperties);
+			for (const itemId of bodyItemIds) applySurfaceStyle(w, model, wall.localId, itemId);
 			if (!bodyQuantities.ok) issues.push(issue("warning", "WALL_QUANTITY_OMITTED", "Wall quantities omitted because occupied material volume could not be measured", wall.localId, {
 				guid: wall.guid,
 				cause: bodyQuantities.error
@@ -15574,27 +15358,14 @@ async function serializeIfc(model, meta) {
 			const railing = preflighted.element;
 			const containingId = findContainerOf(railing.localId, relationships);
 			const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-			let representation;
-			let exactBodyItemIds = [];
-			if (preflighted.kind === "EXACT") {
-				const exact = writeExactBodyGeometry(w, railing.spec, preflighted.items, geomSubContextId, storeyPlacementId);
-				exactBodyItemIds = exact.bodyItemIds;
-				representation = {
-					...exact,
-					bodyItemId: null,
-					usedFallback: false
-				};
-			} else representation = writeRailingGeometry(w, railing.spec, preflighted.solid, geomSubContextId, storeyPlacementId);
-			const { localPlacementId, productDefinitionShapeId, bodyItemId, usedFallback } = representation;
-			if (usedFallback) console.warn(`Railing ${i + 1} tessellation failed; IFC body is a degenerate fallback.`);
+			const { localPlacementId, productDefinitionShapeId, bodyItemIds } = writeProductBodyGeometry(w, railing.spec, preflighted.items, geomSubContextId, storeyPlacementId);
 			const railingExpressId = writeRailingEntity(w, railing.guid, `Railing ${i + 1}`, railing.spec.predefinedType ?? "NOTDEFINED", ownerHistoryId, localPlacementId, productDefinitionShapeId);
 			idMap.set(railing.localId, railingExpressId);
 			placementMap.set(railing.localId, localPlacementId);
 			writeRailingCommonPset(w, ownerHistoryId, railingExpressId, railing.spec);
 			writeManufacturerPset(w, ownerHistoryId, railingExpressId, railing.spec);
 			if (railing.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, railingExpressId, railing.spec.customProperties);
-			if (preflighted.kind === "EXACT") for (const itemId of exactBodyItemIds) applySurfaceStyle(w, model, railing.localId, itemId);
-			else if (bodyItemId !== null) applySurfaceStyle(w, model, railing.localId, bodyItemId);
+			for (const itemId of bodyItemIds) applySurfaceStyle(w, model, railing.localId, itemId);
 		}
 		for (const [i, covering] of coverings.entries()) {
 			const containingId = findContainerOf(covering.localId, relationships);
@@ -15610,6 +15381,7 @@ async function serializeIfc(model, meta) {
 		}
 		const openingPlacementMap = /* @__PURE__ */ new Map();
 		const openingEntityMap = /* @__PURE__ */ new Map();
+		let referenceContextId;
 		for (const rel of relationships) {
 			if (rel.kind !== "VOIDS_WALL") continue;
 			const wallElement = elements.find((el) => el.category === "WALL" && el.localId === rel.wallLocalId);
@@ -15620,7 +15392,8 @@ async function serializeIfc(model, meta) {
 			const openingElement = elements.find((el) => el.localId === rel.openingLocalId);
 			if (openingElement === void 0 || openingElement.category !== "OPENING") continue;
 			if (!isWallOpening(openingElement.spec)) continue;
-			const { openingEntityId, openingPlacementId } = writeOpeningGeometry(w, openingElement.guid, openingElement.spec, wallElement.spec, wallPlacementId, geomSubContextId, ownerHistoryId);
+			referenceContextId ??= writeGeometricSubContext(w, geomContextId, "Reference");
+			const { openingEntityId, openingPlacementId } = writeOpeningGeometry(w, openingElement.guid, openingElement.spec, wallElement.spec, wallPlacementId, referenceContextId, ownerHistoryId, "Reference");
 			idMap.set(rel.openingLocalId, openingEntityId);
 			openingPlacementMap.set(rel.openingLocalId, openingPlacementId);
 			openingEntityMap.set(rel.openingLocalId, openingEntityId);

package/dist/brepjs-bim.js

@@ -1696,7 +1696,7 @@ var Doc = class {
 var version = {
 	major: 4,
 	minor: 6,
-	patch: 4
+	patch: 5
 };
 //#endregion
 //#region ../../node_modules/zod/v4/core/schemas.js
@@ -9742,11 +9742,21 @@ function writeHeader(w, meta) {
 		WorldCoordinateSystem: w.ref(writeAxis2Placement3D(w)),
 		TrueNorth: null
 	});
+	return {
+		ownerHistoryId,
+		geomContextId,
+		geomSubContextId: writeGeometricSubContext(w, geomContextId, "Body"),
+		unitAssignmentId,
+		lengthUnitId
+	};
+}
+/** Separates display Body geometry from non-subtractive Reference geometry. */
+function writeGeometricSubContext(w, geomContextId, identifier) {
 	const geomSubContextId = w.nextId();
 	w.writeLine({
 		expressID: geomSubContextId,
 		type: WebIFC.IFCGEOMETRICREPRESENTATIONSUBCONTEXT,
-		ContextIdentifier: w.mkType(WebIFC.IFCLABEL, "Body"),
+		ContextIdentifier: w.mkType(WebIFC.IFCLABEL, identifier),
 		ContextType: w.mkType(WebIFC.IFCLABEL, "Model"),
 		CoordinateSpaceDimension: null,
 		Precision: null,
@@ -9760,13 +9770,7 @@ function writeHeader(w, meta) {
 		},
 		UserDefinedTargetView: null
 	});
-	return {
-		ownerHistoryId,
-		geomContextId,
-		geomSubContextId,
-		unitAssignmentId,
-		lengthUnitId
-	};
+	return geomSubContextId;
 }
 /**
 * Writes IfcProjectedCRS + IfcMapConversion georeferencing the model context
@@ -10174,7 +10178,7 @@ function writePreparedTessellationBody(w, items, geomSubContextId) {
 		bodyItemIds
 	};
 }
-function writeExactBodyGeometry(w, placement, items, geomSubContextId, parentPlacementId) {
+function writeProductBodyGeometry(w, placement, items, geomSubContextId, parentPlacementId) {
 	const placement3DId = writeAxis2Placement3D(w, [
 		toIfcLengthM(placement.origin[0]),
 		toIfcLengthM(placement.origin[1]),
@@ -10220,47 +10224,6 @@ function writePreparedTessellationItem(w, prepared) {
 	});
 	return faceSetId;
 }
-/**
-* Builds a wall 'Axis' IfcShapeRepresentation: an IfcPolyline from (0,0) to
-* (lengthM, 0) in the wall's local XY plane, wrapped in an IfcShapeRepresentation
-* with RepresentationIdentifier='Axis', RepresentationType='Curve2D'. Returns
-* the IfcShapeRepresentation express ID so callers can add it alongside the Body
-* representation in an IfcProductDefinitionShape.
-*
-* wallLengthMm is the wall length in mm (brepjs native units); it is converted
-* to metres for IFC.
-*/
-function writeWallAxisRepresentation(w, wallLengthMm, geomSubContextId) {
-	const lengthM = toIfcLengthM(wallLengthMm);
-	const startId = w.nextId();
-	w.writeLine({
-		expressID: startId,
-		type: WebIFC.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(WebIFC.IFCLENGTHMEASURE, 0), w.mkType(WebIFC.IFCLENGTHMEASURE, 0)]
-	});
-	const endId = w.nextId();
-	w.writeLine({
-		expressID: endId,
-		type: WebIFC.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(WebIFC.IFCLENGTHMEASURE, lengthM), w.mkType(WebIFC.IFCLENGTHMEASURE, 0)]
-	});
-	const polylineId = w.nextId();
-	w.writeLine({
-		expressID: polylineId,
-		type: WebIFC.IFCPOLYLINE,
-		Points: [w.ref(startId), w.ref(endId)]
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: WebIFC.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(WebIFC.IFCLABEL, "Axis"),
-		RepresentationType: w.mkType(WebIFC.IFCLABEL, "Curve2D"),
-		Items: [w.ref(polylineId)]
-	});
-	return shapeRepId;
-}
 function writeFacetedBrepFallback(w, geomSubContextId, reason) {
 	const originId = w.nextId();
 	w.writeLine({
@@ -10591,81 +10554,6 @@ function writePolyline(w, points) {
 }
 //#endregion
 //#region src/ifc-writer/geometryWriter.ts
-function writeWallGeometry(w, spec, geomSubContextId, parentPlacementId) {
-	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: WebIFC.IFCLOCALPLACEMENT,
-		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
-		RelativePlacement: w.ref(placement3DId)
-	});
-	const thicknessM = toIfcLengthM(spec.thickness);
-	const heightM = toIfcLengthM(spec.height);
-	const lengthM = toIfcLengthM(spec.length);
-	const profileId = w.nextId();
-	w.writeLine({
-		expressID: profileId,
-		type: WebIFC.IFCRECTANGLEPROFILEDEF,
-		ProfileType: {
-			type: 3,
-			value: "AREA"
-		},
-		ProfileName: null,
-		Position: w.ref(writeAxis2Placement2D$1(w, [thicknessM / 2, heightM / 2])),
-		XDim: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, thicknessM),
-		YDim: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, heightM)
-	});
-	const extrusionPosId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	], [
-		1,
-		0,
-		0
-	], [
-		0,
-		1,
-		0
-	]);
-	const extrusionDirId = writeDirection(w, [
-		0,
-		0,
-		1
-	]);
-	const extrusionId = w.nextId();
-	w.writeLine({
-		expressID: extrusionId,
-		type: WebIFC.IFCEXTRUDEDAREASOLID,
-		SweptArea: w.ref(profileId),
-		Position: w.ref(extrusionPosId),
-		ExtrudedDirection: w.ref(extrusionDirId),
-		Depth: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, lengthM)
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: WebIFC.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(WebIFC.IFCLABEL, "Body"),
-		RepresentationType: w.mkType(WebIFC.IFCLABEL, "SweptSolid"),
-		Items: [w.ref(extrusionId)]
-	});
-	const axisRepId = writeWallAxisRepresentation(w, spec.length, geomSubContextId);
-	const productDefinitionShapeId = w.nextId();
-	w.writeLine({
-		expressID: productDefinitionShapeId,
-		type: WebIFC.IFCPRODUCTDEFINITIONSHAPE,
-		Name: null,
-		Description: null,
-		Representations: [w.ref(axisRepId), w.ref(shapeRepId)]
-	});
-	return {
-		localPlacementId,
-		productDefinitionShapeId
-	};
-}
 function writeSlabGeometry(w, spec, geomSubContextId, parentPlacementId) {
 	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
 	const localPlacementId = w.nextId();
@@ -11808,104 +11696,6 @@ function writeRampAssembly(w, spec, rampKey, assemblyGuid, ownerHistoryId, geomS
 }
 //#endregion
 //#region src/ifc-writer/railingWriter.ts
-function writeRailingGeometry(w, spec, solid, geomSubContextId, parentPlacementId) {
-	const placement3DId = writeAxis2Placement3D(w, spec.origin.map(toIfcLengthM), spec.axisZ, spec.axisX);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: WebIFC.IFCLOCALPLACEMENT,
-		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
-		RelativePlacement: w.ref(placement3DId)
-	});
-	if (spec.infill === "POSTED") {
-		const tess = writeTessellation(w, solid, geomSubContextId, localPlacementId);
-		return {
-			localPlacementId,
-			productDefinitionShapeId: tess.productDefinitionShapeId,
-			bodyItemId: null,
-			usedFallback: tess.usedFallback
-		};
-	}
-	const thicknessM = toIfcLengthM(spec.thickness);
-	const heightM = toIfcLengthM(spec.height);
-	const lengthM = toIfcLengthM(spec.length);
-	const profileOriginId = w.nextId();
-	w.writeLine({
-		expressID: profileOriginId,
-		type: WebIFC.IFCCARTESIANPOINT,
-		Coordinates: [w.mkType(WebIFC.IFCLENGTHMEASURE, thicknessM / 2), w.mkType(WebIFC.IFCLENGTHMEASURE, heightM / 2)]
-	});
-	const profilePosId = w.nextId();
-	w.writeLine({
-		expressID: profilePosId,
-		type: WebIFC.IFCAXIS2PLACEMENT2D,
-		Location: w.ref(profileOriginId),
-		RefDirection: null
-	});
-	const profileId = w.nextId();
-	w.writeLine({
-		expressID: profileId,
-		type: WebIFC.IFCRECTANGLEPROFILEDEF,
-		ProfileType: {
-			type: 3,
-			value: "AREA"
-		},
-		ProfileName: null,
-		Position: w.ref(profilePosId),
-		XDim: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, thicknessM),
-		YDim: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, heightM)
-	});
-	const extrusionPosId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	], [
-		1,
-		0,
-		0
-	], [
-		0,
-		1,
-		0
-	]);
-	const extrusionDirId = writeDirection(w, [
-		0,
-		0,
-		1
-	]);
-	const extrusionId = w.nextId();
-	w.writeLine({
-		expressID: extrusionId,
-		type: WebIFC.IFCEXTRUDEDAREASOLID,
-		SweptArea: w.ref(profileId),
-		Position: w.ref(extrusionPosId),
-		ExtrudedDirection: w.ref(extrusionDirId),
-		Depth: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, lengthM)
-	});
-	const shapeRepId = w.nextId();
-	w.writeLine({
-		expressID: shapeRepId,
-		type: WebIFC.IFCSHAPEREPRESENTATION,
-		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(WebIFC.IFCLABEL, "Body"),
-		RepresentationType: w.mkType(WebIFC.IFCLABEL, "SweptSolid"),
-		Items: [w.ref(extrusionId)]
-	});
-	const productDefinitionShapeId = w.nextId();
-	w.writeLine({
-		expressID: productDefinitionShapeId,
-		type: WebIFC.IFCPRODUCTDEFINITIONSHAPE,
-		Name: null,
-		Description: null,
-		Representations: [w.ref(shapeRepId)]
-	});
-	return {
-		localPlacementId,
-		productDefinitionShapeId,
-		bodyItemId: extrusionId,
-		usedFallback: false
-	};
-}
 function writeRailingEntity(w, guid, name, _predefinedType, ownerHistoryId, localPlacementId, productDefinitionShapeId) {
 	const id = w.nextId();
 	w.writeLine({
@@ -13344,7 +13134,7 @@ function writeAxis2Placement2D(w) {
 	});
 	return id;
 }
-function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, geomSubContextId, ownerHistoryId) {
+function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, geomSubContextId, ownerHistoryId, representationIdentifier) {
 	const widthM = toIfcLengthM(openingSpec.width);
 	const heightM = toIfcLengthM(openingSpec.height);
 	const offsetAlongWallM = toIfcLengthM(openingSpec.offsetAlongWall);
@@ -13407,7 +13197,7 @@ function writeOpeningGeometry(w, guid, openingSpec, wallSpec, wallPlacementId, g
 		expressID: shapeRepId,
 		type: WebIFC.IFCSHAPEREPRESENTATION,
 		ContextOfItems: w.ref(geomSubContextId),
-		RepresentationIdentifier: w.mkType(WebIFC.IFCLABEL, "Body"),
+		RepresentationIdentifier: w.mkType(WebIFC.IFCLABEL, representationIdentifier),
 		RepresentationType: w.mkType(WebIFC.IFCLABEL, "SweptSolid"),
 		Items: [w.ref(extrusionId)]
 	});
@@ -15164,18 +14954,22 @@ function checkGeoreferencing(reader) {
 	return [issue("warning", "NO_GEOREFERENCING", "Model contains a facility but no IfcProjectedCRS/IfcGeographicCRS (GRF003) — set ProjectSpec.crs")];
 }
 //#endregion
-//#region src/serialize/exactBodyPreflight.ts
+//#region src/serialize/productBodyPreflight.ts
 var testItemPreparer = null;
-/** Prepares every exact Body item without writing IFC lines. Source solids remain borrowed. */
-function preflightExactBody(input) {
+/** Prepares every retained Body item without writing IFC lines. Source solids remain borrowed. */
+function preflightProductBody(input) {
 	const prepareItem = input.prepareItem ?? testItemPreparer ?? prepareTessellation;
+	const failed = (itemIndex, reason, cause) => err(ifcError("BODY_TESSELLATION_FAILED", `Product Body item ${itemIndex} for ${input.localId} could not be tessellated: ${reason}`, cause, {
+		localId: input.localId,
+		itemIndex
+	}));
 	const prepareAt = (solid, itemIndex) => {
-		const item = prepareItem(solid);
-		if (!item.ok) return err(ifcError("EXACT_BODY_TESSELLATION_FAILED", `Exact Product Body item ${itemIndex} for ${input.localId} could not be tessellated: ${item.reason}`, item.cause, {
-			localId: input.localId,
-			itemIndex
-		}));
-		return ok(item.value);
+		try {
+			const item = prepareItem(solid);
+			return item.ok ? ok(item.value) : failed(itemIndex, item.reason, item.cause);
+		} catch (cause) {
+			return failed(itemIndex, cause instanceof Error ? cause.message : String(cause), cause);
+		}
 	};
 	const [firstSolid, ...remainingSolids] = input.solids;
 	const first = prepareAt(firstSolid, 0);
@@ -15243,24 +15037,13 @@ function wallVolumeError(cause) {
 function preflightProductBodies(elements) {
 	const preflighted = [];
 	for (const element of elements) {
-		const body = element.geometry;
-		if (body.kind === "PARAMETRIC") {
-			preflighted.push({
-				kind: "PARAMETRIC",
-				element,
-				solid: body.solid
-			});
-			continue;
-		}
-		const prepared = preflightExactBody({
+		const prepared = preflightProductBody({
 			localId: element.localId,
-			solids: body.solids
+			solids: bodySolids(element.geometry)
 		});
 		if (!prepared.ok) return err(prepared.error);
 		preflighted.push({
-			kind: "EXACT",
 			element,
-			solids: body.solids,
 			items: prepared.value
 		});
 	}
@@ -15395,13 +15178,14 @@ async function serializeIfc(model, meta) {
 				spec: wall.spec,
 				solids: bodySolids(wall.geometry)
 			});
-			const { localPlacementId, productDefinitionShapeId } = preflighted.kind === "EXACT" ? writeExactBodyGeometry(w, wall.spec, preflighted.items, geomSubContextId, storeyPlacementId) : writeWallGeometry(w, wall.spec, geomSubContextId, storeyPlacementId);
+			const { localPlacementId, productDefinitionShapeId, bodyItemIds } = writeProductBodyGeometry(w, wall.spec, preflighted.items, geomSubContextId, storeyPlacementId);
 			const wallExpressId = writeWallEntity(w, wall.guid, `Wall ${i + 1}`, ownerHistoryId, localPlacementId, productDefinitionShapeId);
 			idMap.set(wall.localId, wallExpressId);
 			placementMap.set(wall.localId, localPlacementId);
 			writeWallCommonPset(w, ownerHistoryId, wallExpressId, wall.spec);
 			writeManufacturerPset(w, ownerHistoryId, wallExpressId, wall.spec);
 			if (wall.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, wallExpressId, wall.spec.customProperties);
+			for (const itemId of bodyItemIds) applySurfaceStyle(w, model, wall.localId, itemId);
 			if (!bodyQuantities.ok) issues.push(issue("warning", "WALL_QUANTITY_OMITTED", "Wall quantities omitted because occupied material volume could not be measured", wall.localId, {
 				guid: wall.guid,
 				cause: bodyQuantities.error
@@ -15551,27 +15335,14 @@ async function serializeIfc(model, meta) {
 			const railing = preflighted.element;
 			const containingId = findContainerOf(railing.localId, relationships);
 			const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-			let representation;
-			let exactBodyItemIds = [];
-			if (preflighted.kind === "EXACT") {
-				const exact = writeExactBodyGeometry(w, railing.spec, preflighted.items, geomSubContextId, storeyPlacementId);
-				exactBodyItemIds = exact.bodyItemIds;
-				representation = {
-					...exact,
-					bodyItemId: null,
-					usedFallback: false
-				};
-			} else representation = writeRailingGeometry(w, railing.spec, preflighted.solid, geomSubContextId, storeyPlacementId);
-			const { localPlacementId, productDefinitionShapeId, bodyItemId, usedFallback } = representation;
-			if (usedFallback) console.warn(`Railing ${i + 1} tessellation failed; IFC body is a degenerate fallback.`);
+			const { localPlacementId, productDefinitionShapeId, bodyItemIds } = writeProductBodyGeometry(w, railing.spec, preflighted.items, geomSubContextId, storeyPlacementId);
 			const railingExpressId = writeRailingEntity(w, railing.guid, `Railing ${i + 1}`, railing.spec.predefinedType ?? "NOTDEFINED", ownerHistoryId, localPlacementId, productDefinitionShapeId);
 			idMap.set(railing.localId, railingExpressId);
 			placementMap.set(railing.localId, localPlacementId);
 			writeRailingCommonPset(w, ownerHistoryId, railingExpressId, railing.spec);
 			writeManufacturerPset(w, ownerHistoryId, railingExpressId, railing.spec);
 			if (railing.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, railingExpressId, railing.spec.customProperties);
-			if (preflighted.kind === "EXACT") for (const itemId of exactBodyItemIds) applySurfaceStyle(w, model, railing.localId, itemId);
-			else if (bodyItemId !== null) applySurfaceStyle(w, model, railing.localId, bodyItemId);
+			for (const itemId of bodyItemIds) applySurfaceStyle(w, model, railing.localId, itemId);
 		}
 		for (const [i, covering] of coverings.entries()) {
 			const containingId = findContainerOf(covering.localId, relationships);
@@ -15587,6 +15358,7 @@ async function serializeIfc(model, meta) {
 		}
 		const openingPlacementMap = /* @__PURE__ */ new Map();
 		const openingEntityMap = /* @__PURE__ */ new Map();
+		let referenceContextId;
 		for (const rel of relationships) {
 			if (rel.kind !== "VOIDS_WALL") continue;
 			const wallElement = elements.find((el) => el.category === "WALL" && el.localId === rel.wallLocalId);
@@ -15597,7 +15369,8 @@ async function serializeIfc(model, meta) {
 			const openingElement = elements.find((el) => el.localId === rel.openingLocalId);
 			if (openingElement === void 0 || openingElement.category !== "OPENING") continue;
 			if (!isWallOpening(openingElement.spec)) continue;
-			const { openingEntityId, openingPlacementId } = writeOpeningGeometry(w, openingElement.guid, openingElement.spec, wallElement.spec, wallPlacementId, geomSubContextId, ownerHistoryId);
+			referenceContextId ??= writeGeometricSubContext(w, geomContextId, "Reference");
+			const { openingEntityId, openingPlacementId } = writeOpeningGeometry(w, openingElement.guid, openingElement.spec, wallElement.spec, wallPlacementId, referenceContextId, ownerHistoryId, "Reference");
 			idMap.set(rel.openingLocalId, openingEntityId);
 			openingPlacementMap.set(rel.openingLocalId, openingPlacementId);
 			openingEntityMap.set(rel.openingLocalId, openingEntityId);

package/dist/ifc-writer/geometryWriter.d.ts

@@ -1,15 +1,10 @@
 import { ValidSolid } from 'brepjs';
 import { IfcWriter } from './ifcWriter.js';
-import { WallSpec } from '../specs/wallSpec.js';
 import { SlabSpec } from '../specs/slabSpec.js';
 import { BeamSpec } from '../specs/beamSpec.js';
 import { ColumnSpec } from '../specs/columnSpec.js';
 import { RoofSpec } from '../specs/roofSpec.js';
 import { Profile } from '../specs/profile.js';
-export interface WallRepresentationIds {
-    localPlacementId: number;
-    productDefinitionShapeId: number;
-}
 export interface SlabRepresentationIds {
     localPlacementId: number;
     productDefinitionShapeId: number;
@@ -18,7 +13,6 @@ export interface LinearElementRepresentationIds {
     localPlacementId: number;
     productDefinitionShapeId: number;
 }
-export declare function writeWallGeometry(w: IfcWriter, spec: WallSpec, geomSubContextId: number, parentPlacementId: number | null): WallRepresentationIds;
 export declare function writeSlabGeometry(w: IfcWriter, spec: SlabSpec, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds;
 export declare function writeRoofGeometry(w: IfcWriter, spec: RoofSpec, solid: ValidSolid, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds & {
     usedFallback: boolean;

package/dist/ifc-writer/headerWriter.d.ts

@@ -28,6 +28,8 @@ export interface BimModelMeta {
     ifcSchema?: IfcSchema | undefined;
 }
 export declare function writeHeader(w: IfcWriter, meta: BimModelMeta): HeaderIds;
+/** Separates display Body geometry from non-subtractive Reference geometry. */
+export declare function writeGeometricSubContext(w: IfcWriter, geomContextId: number, identifier: 'Body' | 'Reference'): number;
 /**
  * Writes IfcProjectedCRS + IfcMapConversion georeferencing the model context
  * (GRF003). Coordinates are metres; rotation defaults to identity.

package/dist/ifc-writer/openingWriter.d.ts

@@ -13,7 +13,7 @@ type OpeningPsetSpec = {
     readonly acousticRating?: string | undefined;
     readonly thermalTransmittance?: number | undefined;
 };
-export declare function writeOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: WallOpeningSpec, wallSpec: WallSpec, wallPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
+export declare function writeOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: WallOpeningSpec, wallSpec: WallSpec, wallPlacementId: number, geomSubContextId: number, ownerHistoryId: number, representationIdentifier: 'Body' | 'Reference'): OpeningIds;
 export declare function writeSlabOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: SlabOpeningSpec, slabSpec: SlabSpec, slabPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
 export declare function writeDoorEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;
 export declare function writeWindowEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;

package/dist/ifc-writer/tessellationWriter.d.ts

@@ -25,7 +25,7 @@ export type TessellationPreparation = {
     readonly reason: string;
     readonly cause?: unknown;
 };
-export interface ExactBodyRepresentationIds {
+export interface ProductBodyRepresentationIds {
     readonly localPlacementId: number;
     readonly productDefinitionShapeId: number;
     readonly bodyItemIds: readonly number[];
@@ -53,7 +53,7 @@ export declare function writePreparedTessellationBody(w: IfcWriter, items: NonEm
     readonly productDefinitionShapeId: number;
     readonly bodyItemIds: readonly number[];
 };
-export declare function writeExactBodyGeometry(w: IfcWriter, placement: FrameInput, items: NonEmpty<PreparedTessellation>, geomSubContextId: number, parentPlacementId: number | null): ExactBodyRepresentationIds;
+export declare function writeProductBodyGeometry(w: IfcWriter, placement: FrameInput, items: NonEmpty<PreparedTessellation>, geomSubContextId: number, parentPlacementId: number | null): ProductBodyRepresentationIds;
 export declare function writePreparedTessellationItem(w: IfcWriter, prepared: PreparedTessellation): number;
 /**
  * Builds a wall 'Axis' IfcShapeRepresentation: an IfcPolyline from (0,0) to

package/dist/serialize/productBodyPreflight.d.ts

@@ -0,0 +1,15 @@
+import { Result, ValidSolid } from 'brepjs';
+import { BimError } from '../errors/bimError.js';
+import { LocalId } from '../identity/localId.js';
+import { NonEmpty } from '../types/productBody.js';
+import { PreparedTessellation, TessellationPreparation } from '../ifc-writer/tessellationWriter.js';
+export type ProductBodyItemPreparer = (solid: ValidSolid) => TessellationPreparation;
+/** Package-internal deterministic failure seam for serialization cleanup tests. */
+export declare function setProductBodyItemPreparerForTesting(prepareItem: ProductBodyItemPreparer | null): void;
+export interface ProductBodyPreflightInput {
+    readonly localId: LocalId;
+    readonly solids: NonEmpty<ValidSolid>;
+    readonly prepareItem?: ProductBodyItemPreparer | undefined;
+}
+/** Prepares every retained Body item without writing IFC lines. Source solids remain borrowed. */
+export declare function preflightProductBody(input: ProductBodyPreflightInput): Result<NonEmpty<PreparedTessellation>, BimError>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.24.5",
+  "version": "0.25.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",
@@ -59,7 +59,7 @@
     "vite-plugin-dts": "^5.0.0",
     "vitest": "^5.0.0",
     "web-ifc": "^0.0.77",
-    "zod": "4.6.4"
+    "zod": "4.6.5"
   },
   "dependencies": {
     "brepjs-families": ">=0.1.0 <1.0.0"

package/dist/serialize/exactBodyPreflight.d.ts

@@ -1,15 +0,0 @@
-import { Result, ValidSolid } from 'brepjs';
-import { BimError } from '../errors/bimError.js';
-import { LocalId } from '../identity/localId.js';
-import { NonEmpty } from '../types/productBody.js';
-import { PreparedTessellation, TessellationPreparation } from '../ifc-writer/tessellationWriter.js';
-export type ExactBodyItemPreparer = (solid: ValidSolid) => TessellationPreparation;
-/** Package-internal deterministic failure seam for serialization cleanup tests. */
-export declare function setExactBodyItemPreparerForTesting(prepareItem: ExactBodyItemPreparer | null): void;
-export interface ExactBodyPreflightInput {
-    readonly localId: LocalId;
-    readonly solids: NonEmpty<ValidSolid>;
-    readonly prepareItem?: ExactBodyItemPreparer | undefined;
-}
-/** Prepares every exact Body item without writing IFC lines. Source solids remain borrowed. */
-export declare function preflightExactBody(input: ExactBodyPreflightInput): Result<NonEmpty<PreparedTessellation>, BimError>;