brepjs-bim 0.20.0 → 0.22.0

package/dist/brepjs-bim.cjs

@@ -6320,15 +6320,17 @@ var BimModel = class {
 	#projectId = null;
 	#modelScope = "";
 	#usedStableKeys = /* @__PURE__ */ new Set();
-	init(spec) {
+	init(spec, options) {
 		if (this.#projectId !== null) return (0, brepjs.err)(specError("DUPLICATE_PROJECT", "BimModel.init() called twice — only one project per model"));
 		this.#modelScope = spec.projectId ?? `${spec.name}::${spec.description ?? ""}`;
-		const id = this.#makeElement("PROJECT", spec, null);
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		const id = this.#makeElement("PROJECT", spec, null, options?.stableKey);
 		this.#projectId = id;
 		return (0, brepjs.ok)(id);
 	}
 	[Symbol.dispose]() {
-		for (const el of this.#elements.values()) if (el.category === "WALL" || el.category === "SLAB" || el.category === "BEAM" || el.category === "COLUMN" || el.category === "PROXY" || el.category === "SPACE" || el.category === "ROOF" || el.category === "FOOTING" || el.category === "PILE" || el.category === "RAILING" || el.category === "COVERING") el.geometry[Symbol.dispose]();
+		for (const el of this.#elements.values()) if (el.category === "WALL" || el.category === "SLAB" || el.category === "BEAM" || el.category === "COLUMN" || el.category === "PROXY" || el.category === "EARTHWORKS_FILL" || el.category === "SPACE" || el.category === "ROOF" || el.category === "FOOTING" || el.category === "PILE" || el.category === "RAILING" || el.category === "COVERING") el.geometry[Symbol.dispose]();
 		else if (el.category === "CURTAIN_WALL") {
 			for (const panel of el.geometry.panels) panel.solid[Symbol.dispose]();
 			for (const mullion of el.geometry.mullions) mullion.solid[Symbol.dispose]();
@@ -6339,6 +6341,26 @@ var BimModel = class {
 		if (!keyCheck.ok) return keyCheck;
 		return (0, brepjs.ok)(this.#makeElement("SITE", spec, null, options?.stableKey));
 	}
+	addBridge(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("BRIDGE", spec, null, options?.stableKey));
+	}
+	addBridgePart(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("BRIDGE_PART", spec, null, options?.stableKey));
+	}
+	/** Adds a typed IfcEarthworksFill body. Ownership of `spec.solid` transfers
+	* to the model only when this call succeeds. */
+	addEarthworksFill(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		if (spec.solid === null || spec.solid === void 0) return (0, brepjs.err)(specError("EARTHWORKS_FILL_NO_GEOMETRY", "EarthworksFillSpec.solid is required"));
+		const id = this.#makeElement("EARTHWORKS_FILL", spec, spec.solid, options?.stableKey);
+		this.#associateMaterial(id, spec);
+		return (0, brepjs.ok)(id);
+	}
 	addBuilding(spec, options) {
 		const keyCheck = this.#checkStableKey(options);
 		if (!keyCheck.ok) return keyCheck;
@@ -6958,6 +6980,21 @@ var BimModel = class {
 		for (const el of this.#elements.values()) if (el.category === "BEAM") beams.push(el);
 		return beams;
 	}
+	getBridges() {
+		const bridges = [];
+		for (const el of this.#elements.values()) if (el.category === "BRIDGE") bridges.push(el);
+		return bridges;
+	}
+	getBridgeParts() {
+		const parts = [];
+		for (const el of this.#elements.values()) if (el.category === "BRIDGE_PART") parts.push(el);
+		return parts;
+	}
+	getEarthworksFills() {
+		const fills = [];
+		for (const el of this.#elements.values()) if (el.category === "EARTHWORKS_FILL") fills.push(el);
+		return fills;
+	}
 	getColumns() {
 		const columns = [];
 		for (const el of this.#elements.values()) if (el.category === "COLUMN") columns.push(el);
@@ -7382,23 +7419,38 @@ function place(solid, frame) {
 function disposeAll(solids) {
 	for (const s of solids) s[Symbol.dispose]();
 }
+function placeWithinParent(solid, localFrame, parentFrame) {
+	try {
+		var _usingCtx$3 = _usingCtx();
+		const local = place(solid, localFrame);
+		if (!local.ok || parentFrame === void 0) return local;
+		return place(_usingCtx$3.u(local.value), parentFrame);
+	} catch (_) {
+		_usingCtx$3.e = _;
+	} finally {
+		_usingCtx$3.d();
+	}
+}
 /**
-* Returns each element's geometry transformed to its world placement, as fresh
-* caller-owned solids, wrapped in a `Result` (Layer-2 code prefers `Result` over
-* throwing). **Dispose the returned solids** (e.g. via `using` / `[Symbol.dispose]`)
-* when you own their lifetime — they are independent of the model
+* Returns each element's geometry transformed to its element-local placement,
+* and optionally through the cumulative frame of its containing spatial
+* structure, as fresh caller-owned solids. Pass `parentFrame` to obtain world
+* coordinates for elements beneath a placed Site, Bridge, Bridge Part, or
+* other spatial structure. **Dispose the returned solids** (e.g. via `using` /
+* `[Symbol.dispose]`) when you own their lifetime — they are independent of the model
 * (`BimModel[Symbol.dispose]` frees only the stored, unplaced `.geometry`). On any
 * failure the solids already built for this call are disposed before the error is
 * returned, so no partial array is leaked.
 *
 * Stairs and ramps carry no element solid (`.geometry` is null), so flight
 * solids are built from `spec.flights` and placed per flight. Curtain walls
-* return placed panels + mullions. Proxies are authored in world coordinates
-* (no placement frame), so their solid is returned as a fresh identity-placed
-* copy. Elements with no solid geometry (doors/windows/groups/spatial) return
-* an empty array.
+* return placed panels + mullions. Proxy and Earthworks Fill bodies are stored
+* relative to their containing spatial structure, so their body is copied and
+* then transformed by `parentFrame` when supplied. Elements with no solid geometry
+* (doors/windows/groups/spatial) return an empty array.
 */
-function placedSolids(el) {
+function placedSolids(el, options = {}) {
+	const parentFrame = options.parentFrame;
 	switch (el.category) {
 		case "WALL":
 		case "SLAB":
@@ -7410,56 +7462,57 @@ function placedSolids(el) {
 		case "PILE":
 		case "COVERING":
 		case "RAILING": {
-			const placed = place(el.geometry, el.spec);
+			const placed = placeWithinParent(el.geometry, el.spec, parentFrame);
 			if (!placed.ok) return placed;
 			return (0, brepjs.ok)([placed.value]);
 		}
 		case "STAIR": {
 			const out = [];
 			for (const flight of el.spec.flights) try {
-				var _usingCtx$3 = _usingCtx();
+				var _usingCtx3 = _usingCtx();
 				const built = stairFlightToSolid(flight);
 				if (!built.ok) {
 					disposeAll(out);
 					return (0, brepjs.err)(built.error);
 				}
-				const placed = place(_usingCtx$3.u(built.value.solid), flight);
+				const placed = placeWithinParent(_usingCtx3.u(built.value.solid), flight, parentFrame);
 				if (!placed.ok) {
 					disposeAll(out);
 					return placed;
 				}
 				out.push(placed.value);
 			} catch (_) {
-				_usingCtx$3.e = _;
+				_usingCtx3.e = _;
 			} finally {
-				_usingCtx$3.d();
+				_usingCtx3.d();
 			}
 			return (0, brepjs.ok)(out);
 		}
 		case "RAMP": {
 			const out = [];
 			for (const flight of el.spec.flights) try {
-				var _usingCtx3 = _usingCtx();
+				var _usingCtx4 = _usingCtx();
 				const built = rampFlightToSolid(flight);
 				if (!built.ok) {
 					disposeAll(out);
 					return (0, brepjs.err)(built.error);
 				}
-				const placed = place(_usingCtx3.u(built.value.solid), flight);
+				const placed = placeWithinParent(_usingCtx4.u(built.value.solid), flight, parentFrame);
 				if (!placed.ok) {
 					disposeAll(out);
 					return placed;
 				}
 				out.push(placed.value);
 			} catch (_) {
-				_usingCtx3.e = _;
+				_usingCtx4.e = _;
 			} finally {
-				_usingCtx3.d();
+				_usingCtx4.d();
 			}
 			return (0, brepjs.ok)(out);
 		}
-		case "PROXY": {
-			const placed = place(el.geometry, {
+		case "PROXY":
+		case "EARTHWORKS_FILL": {
+			const placed = placeWithinParent(el.geometry, {
 				origin: [
 					0,
 					0,
@@ -7475,14 +7528,14 @@ function placedSolids(el) {
 					0,
 					1
 				]
-			});
+			}, parentFrame);
 			if (!placed.ok) return placed;
 			return (0, brepjs.ok)([placed.value]);
 		}
 		case "CURTAIN_WALL": {
 			const out = [];
 			for (const c of [...el.geometry.panels, ...el.geometry.mullions]) try {
-				var _usingCtx4 = _usingCtx();
+				var _usingCtx5 = _usingCtx();
 				const componentLocal = place(c.solid, {
 					origin: c.origin,
 					axisX: [
@@ -7500,16 +7553,16 @@ function placedSolids(el) {
 					disposeAll(out);
 					return componentLocal;
 				}
-				const placed = place(_usingCtx4.u(componentLocal.value), el.spec);
+				const placed = placeWithinParent(_usingCtx5.u(componentLocal.value), el.spec, parentFrame);
 				if (!placed.ok) {
 					disposeAll(out);
 					return placed;
 				}
 				out.push(placed.value);
 			} catch (_) {
-				_usingCtx4.e = _;
+				_usingCtx5.e = _;
 			} finally {
-				_usingCtx4.d();
+				_usingCtx5.d();
 			}
 			return (0, brepjs.ok)(out);
 		}
@@ -7564,6 +7617,8 @@ var IFC4X3_ONLY_ENTITIES = /* @__PURE__ */ new Set([
 	"IfcRoad",
 	"IfcRailway",
 	"IfcBridge",
+	"IfcBridgePart",
+	"IfcEarthworksFill",
 	"IfcMarineFacility"
 ]);
 /**
@@ -8022,34 +8077,23 @@ function writeProject$1(w, guid, name, ownerHistoryId, unitAssignmentId, geomCon
 	});
 	return id;
 }
-function writeSite(w, guid, name, ownerHistoryId) {
-	const placement3DId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	]);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: web_ifc.IFCLOCALPLACEMENT,
-		PlacementRelTo: null,
-		RelativePlacement: w.ref(placement3DId)
-	});
+function writeSite(w, guid, spec, ownerHistoryId, parentPlacementId = null) {
+	const localPlacementId = writeSpatialLocalPlacement(w, spec, parentPlacementId);
 	const entityId = w.nextId();
 	w.writeLine({
 		expressID: entityId,
 		type: web_ifc.IFCSITE,
 		GlobalId: w.mkType(web_ifc.IFCGLOBALLYUNIQUEID, guid),
 		OwnerHistory: w.ref(ownerHistoryId),
-		Name: w.mkType(web_ifc.IFCLABEL, name),
-		Description: null,
+		Name: w.mkType(web_ifc.IFCLABEL, spec.name),
+		Description: spec.description ? w.mkType(web_ifc.IFCTEXT, spec.description) : null,
 		ObjectType: null,
 		ObjectPlacement: w.ref(localPlacementId),
 		Representation: null,
 		LongName: null,
 		CompositionType: {
 			type: 3,
-			value: "ELEMENT"
+			value: spec.compositionType ?? "ELEMENT"
 		},
 		RefLatitude: null,
 		RefLongitude: null,
@@ -8062,6 +8106,34 @@ function writeSite(w, guid, name, ownerHistoryId) {
 		placementId: localPlacementId
 	};
 }
+function writeSpatialLocalPlacement(w, spec, parentPlacementId) {
+	const toMetres = (value) => [
+		toIfcLengthM(value[0]),
+		toIfcLengthM(value[1]),
+		toIfcLengthM(value[2])
+	];
+	const placement3DId = writeAxis2Placement3D(w, toMetres(spec.origin ?? [
+		0,
+		0,
+		0
+	]), spec.axisZ ?? [
+		0,
+		0,
+		1
+	], spec.axisX ?? [
+		1,
+		0,
+		0
+	]);
+	const localPlacementId = w.nextId();
+	w.writeLine({
+		expressID: localPlacementId,
+		type: web_ifc.IFCLOCALPLACEMENT,
+		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
+		RelativePlacement: w.ref(placement3DId)
+	});
+	return localPlacementId;
+}
 function writeBuilding(w, guid, name, ownerHistoryId, parentPlacementId) {
 	const placement3DId = writeAxis2Placement3D(w, [
 		0,
@@ -10181,6 +10253,111 @@ function writeRelNests(w, guid, ownerHistoryId, relatingObjectId, relatedObjectI
 	});
 }
 //#endregion
+//#region src/ifc-writer/infrastructureWriter.ts
+function writeBridge(w, guid, spec, ownerHistoryId, parentPlacementId) {
+	const placementId = writeSpatialLocalPlacement(w, spec, parentPlacementId);
+	const entityId = w.nextId();
+	w.writeLine({
+		expressID: entityId,
+		type: web_ifc.IFCBRIDGE,
+		GlobalId: w.mkType(web_ifc.IFCGLOBALLYUNIQUEID, guid),
+		OwnerHistory: w.ref(ownerHistoryId),
+		Name: w.mkType(web_ifc.IFCLABEL, spec.name),
+		Description: spec.description ? w.mkType(web_ifc.IFCTEXT, spec.description) : null,
+		ObjectType: null,
+		ObjectPlacement: w.ref(placementId),
+		Representation: null,
+		LongName: null,
+		CompositionType: {
+			type: 3,
+			value: spec.compositionType ?? "ELEMENT"
+		},
+		PredefinedType: {
+			type: 3,
+			value: spec.predefinedType ?? "NOTDEFINED"
+		}
+	});
+	return {
+		entityId,
+		placementId
+	};
+}
+function writeBridgePart(w, guid, spec, ownerHistoryId, parentPlacementId) {
+	const placementId = writeSpatialLocalPlacement(w, spec, parentPlacementId);
+	const entityId = w.nextId();
+	w.writeLine({
+		expressID: entityId,
+		type: web_ifc.IFCBRIDGEPART,
+		GlobalId: w.mkType(web_ifc.IFCGLOBALLYUNIQUEID, guid),
+		OwnerHistory: w.ref(ownerHistoryId),
+		Name: w.mkType(web_ifc.IFCLABEL, spec.name),
+		Description: spec.description ? w.mkType(web_ifc.IFCTEXT, spec.description) : null,
+		ObjectType: null,
+		ObjectPlacement: w.ref(placementId),
+		Representation: null,
+		LongName: null,
+		CompositionType: {
+			type: 3,
+			value: spec.compositionType ?? "ELEMENT"
+		},
+		UsageType: {
+			type: 3,
+			value: spec.usageType
+		},
+		PredefinedType: {
+			type: 3,
+			value: spec.predefinedType ?? "NOTDEFINED"
+		}
+	});
+	return {
+		entityId,
+		placementId
+	};
+}
+function writeEarthworksFillEntity(w, guid, spec, ownerHistoryId, localPlacementId, productDefinitionShapeId) {
+	const entityId = w.nextId();
+	w.writeLine({
+		expressID: entityId,
+		type: web_ifc.IFCEARTHWORKSFILL,
+		GlobalId: w.mkType(web_ifc.IFCGLOBALLYUNIQUEID, guid),
+		OwnerHistory: w.ref(ownerHistoryId),
+		Name: w.mkType(web_ifc.IFCLABEL, spec.name),
+		Description: null,
+		ObjectType: null,
+		ObjectPlacement: w.ref(localPlacementId),
+		Representation: w.ref(productDefinitionShapeId),
+		Tag: null,
+		PredefinedType: {
+			type: 3,
+			value: spec.predefinedType ?? "NOTDEFINED"
+		}
+	});
+	return entityId;
+}
+//#endregion
+//#region src/ifc-writer/tessellatedProductWriter.ts
+/** Write a tessellated body in the coordinate frame supplied by the caller. */
+function writeTessellatedProductGeometry(w, solid, geomSubContextId, parentPlacementId) {
+	const placement3DId = writeAxis2Placement3D(w, [
+		0,
+		0,
+		0
+	]);
+	const localPlacementId = w.nextId();
+	w.writeLine({
+		expressID: localPlacementId,
+		type: web_ifc.IFCLOCALPLACEMENT,
+		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
+		RelativePlacement: w.ref(placement3DId)
+	});
+	const tessellation = writeTessellation(w, solid, geomSubContextId, localPlacementId);
+	return {
+		localPlacementId,
+		productDefinitionShapeId: tessellation.productDefinitionShapeId,
+		tessellation
+	};
+}
+//#endregion
 //#region src/ifc-writer/groupWriter.ts
 /**
 * Emits an IfcZone grouping object. `longName` (a descriptive label such as
@@ -11659,29 +11836,12 @@ function writeWindowCommonPset(w, ownerHistoryId, windowEntityId, spec) {
 //#region src/ifc-writer/proxyWriter.ts
 /**
 * Writes the IfcLocalPlacement (at origin, relative to parentPlacementId) and a
-* tessellated body (IfcTriangulatedFaceSet) for a proxy's solid. The solid is
-* exported in its authored coordinate frame; placement is identity because proxy
-* solids carry their own world positions in the brepjs geometry.
+* tessellated body (IfcTriangulatedFaceSet) for a proxy's solid. Solid
+* coordinates are emitted as supplied; the caller is responsible for matching
+* them to the containing spatial structure's frame.
 */
 function writeProxyGeometry(w, spec, geomSubContextId, parentPlacementId) {
-	const placement3DId = writeAxis2Placement3D(w, [
-		0,
-		0,
-		0
-	]);
-	const localPlacementId = w.nextId();
-	w.writeLine({
-		expressID: localPlacementId,
-		type: web_ifc.IFCLOCALPLACEMENT,
-		PlacementRelTo: parentPlacementId !== null ? w.ref(parentPlacementId) : null,
-		RelativePlacement: w.ref(placement3DId)
-	});
-	const tessellation = writeTessellation(w, spec.solid, geomSubContextId, localPlacementId);
-	return {
-		localPlacementId,
-		productDefinitionShapeId: tessellation.productDefinitionShapeId,
-		tessellation
-	};
+	return writeTessellatedProductGeometry(w, spec.solid, geomSubContextId, parentPlacementId);
 }
 function writeProxyEntity(w, guid, name, predefinedType, ownerHistoryId, localPlacementId, productDefinitionShapeId) {
 	const id = w.nextId();
@@ -11932,6 +12092,7 @@ var CONTAINABLE_CATEGORIES = /* @__PURE__ */ new Set([
 	"SLAB",
 	"BEAM",
 	"COLUMN",
+	"EARTHWORKS_FILL",
 	"DOOR",
 	"WINDOW"
 ]);
@@ -12051,7 +12212,9 @@ function hasSpatialStructure(api, modelId) {
 	return [
 		web_ifc.IFCSITE,
 		web_ifc.IFCBUILDING,
-		web_ifc.IFCBUILDINGSTOREY
+		web_ifc.IFCBUILDINGSTOREY,
+		web_ifc.IFCBRIDGE,
+		web_ifc.IFCBRIDGEPART
 	].some((t) => api.GetLineIDsWithType(modelId, t).size() > 0);
 }
 function checkGlobalIds(api, modelId, lineIds, lineCount) {
@@ -12095,6 +12258,7 @@ var KEY_ENTITY_NAMES = [
 	"IfcSlab",
 	"IfcBeam",
 	"IfcColumn",
+	"IfcEarthworksFill",
 	"IfcRelContainedInSpatialStructure",
 	"IfcRelAggregates",
 	"IfcPropertySet"
@@ -12105,6 +12269,7 @@ var KEY_ENTITY_TYPES = [
 	["IfcSlab", web_ifc.IFCSLAB],
 	["IfcBeam", web_ifc.IFCBEAM],
 	["IfcColumn", web_ifc.IFCCOLUMN],
+	["IfcEarthworksFill", web_ifc.IFCEARTHWORKSFILL],
 	["IfcRelContainedInSpatialStructure", web_ifc.IFCRELCONTAINEDINSPATIALSTRUCTURE],
 	["IfcRelAggregates", web_ifc.IFCRELAGGREGATES],
 	["IfcPropertySet", web_ifc.IFCPROPERTYSET]
@@ -13097,7 +13262,7 @@ function checkQuantitySets(reader) {
 	return issues;
 }
 function checkGeoreferencing(reader) {
-	if (!(reader.getLinesOfType(web_ifc.IFCBUILDING).length > 0)) return [];
+	if (!(reader.getLinesOfType(web_ifc.IFCBUILDING).length > 0 || reader.getLinesOfType(web_ifc.IFCBRIDGE).length > 0)) return [];
 	if (reader.getLinesOfType(web_ifc.IFCPROJECTEDCRS).length > 0 || reader.getLinesOfType(web_ifc.IFCGEOGRAPHICCRS).length > 0) return [];
 	return [issue("warning", "NO_GEOREFERENCING", "Model contains a facility but no IfcProjectedCRS/IfcGeographicCRS (GRF003) — set ProjectSpec.crs")];
 }
@@ -13106,6 +13271,7 @@ function checkGeoreferencing(reader) {
 async function toIfc(model, meta) {
 	const project = model.getProject();
 	if (!project) return (0, brepjs.err)(ifcError("NO_PROJECT", "BimModel has no project — call model.init() first"));
+	if ((model.getBridges().length > 0 || model.getBridgeParts().length > 0 || model.getEarthworksFills().length > 0) && (meta.ifcSchema ?? "IFC4") !== "IFC4X3") return (0, brepjs.err)(ifcError("IFC4X3_REQUIRED", "Bridge, Bridge Part, and Earthworks Fill entities require IFC4X3 serialization"));
 	const authorName = [meta.author?.givenName, meta.author?.familyName].filter((p) => Boolean(p)).join(" ");
 	const writerResult = await IfcWriter.create(meta.mvdViewDefinition, meta.ifcSchema, {
 		author: authorName,
@@ -13119,6 +13285,9 @@ async function toIfc(model, meta) {
 	const walls = model.getWalls();
 	const slabs = model.getSlabs();
 	const beams = model.getBeams();
+	const bridges = model.getBridges();
+	const bridgeParts = model.getBridgeParts();
+	const earthworksFills = model.getEarthworksFills();
 	const columns = model.getColumns();
 	const doors = model.getDoors();
 	const windows = model.getWindows();
@@ -13144,10 +13313,33 @@ async function toIfc(model, meta) {
 	idMap.set(project.localId, projectExpressId);
 	for (const el of elements) {
 		if (el.category !== "SITE") continue;
-		const { entityId, placementId } = writeSite(w, el.guid, el.spec.name, ownerHistoryId);
+		const parentId = findParentOf(el.localId, relationships);
+		const parentPlacementId = parentId !== null ? placementMap.get(parentId) ?? null : null;
+		const { entityId, placementId } = writeSite(w, el.guid, el.spec, ownerHistoryId, parentPlacementId);
 		idMap.set(el.localId, entityId);
 		placementMap.set(el.localId, placementId);
 	}
+	for (const bridge of bridges) {
+		const parentId = findParentOf(bridge.localId, relationships);
+		const parentPlacementId = parentId !== null ? placementMap.get(parentId) ?? null : null;
+		const { entityId, placementId } = writeBridge(w, bridge.guid, bridge.spec, ownerHistoryId, parentPlacementId);
+		idMap.set(bridge.localId, entityId);
+		placementMap.set(bridge.localId, placementId);
+	}
+	const pendingParts = [...bridgeParts];
+	while (pendingParts.length > 0) {
+		const readyIndex = pendingParts.findIndex((candidate) => {
+			const candidateParentId = findParentOf(candidate.localId, relationships);
+			return candidateParentId === null || placementMap.has(candidateParentId);
+		});
+		const [part] = pendingParts.splice(readyIndex === -1 ? 0 : readyIndex, 1);
+		if (part === void 0) break;
+		const parentId = findParentOf(part.localId, relationships);
+		const parentPlacementId = parentId !== null ? placementMap.get(parentId) ?? null : null;
+		const { entityId, placementId } = writeBridgePart(w, part.guid, part.spec, ownerHistoryId, parentPlacementId);
+		idMap.set(part.localId, entityId);
+		placementMap.set(part.localId, placementId);
+	}
 	for (const el of elements) {
 		if (el.category !== "BUILDING") continue;
 		const parentSiteId = findParentOf(el.localId, relationships);
@@ -13241,6 +13433,15 @@ async function toIfc(model, meta) {
 		placementMap.set(proxy.localId, localPlacementId);
 		if (proxy.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, proxyExpressId, proxy.spec.customProperties);
 	}
+	for (const fill of earthworksFills) {
+		const containingId = findContainerOf(fill.localId, relationships);
+		const parentPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
+		const { localPlacementId, productDefinitionShapeId } = writeTessellatedProductGeometry(w, fill.geometry, geomSubContextId, parentPlacementId);
+		const expressId = writeEarthworksFillEntity(w, fill.guid, fill.spec, ownerHistoryId, localPlacementId, productDefinitionShapeId);
+		idMap.set(fill.localId, expressId);
+		placementMap.set(fill.localId, localPlacementId);
+		if (fill.spec.customProperties !== void 0) writeCustomPsets(w, ownerHistoryId, expressId, fill.spec.customProperties);
+	}
 	for (const [i, space] of spaces.entries()) {
 		const containingId = findContainerOf(space.localId, relationships);
 		const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
@@ -13663,6 +13864,7 @@ function collectGeometryIssues(model) {
 		["Beam", model.getBeams()],
 		["Column", model.getColumns()],
 		["Proxy", model.getProxies()],
+		["Earthworks Fill", model.getEarthworksFills()],
 		["Space", model.getSpaces()],
 		["Roof", model.getRoofs()],
 		["Footing", model.getFootings()],
@@ -13733,7 +13935,9 @@ var CATEGORY_BY_TYPE = /* @__PURE__ */ new Map([
 	[web_ifc.IFCPROJECT, "PROJECT"],
 	[web_ifc.IFCSITE, "SITE"],
 	[web_ifc.IFCBUILDING, "BUILDING"],
-	[web_ifc.IFCBUILDINGSTOREY, "STOREY"]
+	[web_ifc.IFCBUILDINGSTOREY, "STOREY"],
+	[web_ifc.IFCBRIDGE, "BRIDGE"],
+	[web_ifc.IFCBRIDGEPART, "BRIDGE_PART"]
 ]);
 function refId$1(ref) {
 	const v = ref?.value;
@@ -14816,6 +15020,7 @@ var ELEMENT_TYPES = [
 	[web_ifc.IFCRAILING, "RAILING"],
 	[web_ifc.IFCCOVERING, "COVERING"],
 	[web_ifc.IFCELEMENTASSEMBLY, "ELEMENT_ASSEMBLY"],
+	[web_ifc.IFCEARTHWORKSFILL, "EARTHWORKS_FILL"],
 	[web_ifc.IFCBUILDINGELEMENTPROXY, "PROXY"]
 ];
 /**
@@ -14893,14 +15098,17 @@ function readElement(reader, expressId, category, scale, containment, typeEnums,
 		const psets = readPsets(reader, expressId).map(toImportedPset);
 		const material = readMaterial(reader, expressId, scale);
 		const classification = readClassification(reader, expressId);
-		const storeyExpressId = containment.get(expressId);
+		const spatialStructureExpressId = containment.get(expressId);
 		return {
 			expressId,
 			guid,
 			name,
 			category,
 			...predefinedType !== void 0 ? { predefinedType } : {},
-			...storeyExpressId !== void 0 ? { storeyExpressId } : {},
+			...spatialStructureExpressId !== void 0 ? {
+				spatialStructureExpressId,
+				storeyExpressId: spatialStructureExpressId
+			} : {},
 			geometry,
 			psets,
 			material,
@@ -15900,6 +16108,115 @@ function parseSlabOpeningInput(input) {
 	return (0, brepjs.ok)(result.data);
 }
 //#endregion
+//#region src/specs/spatialSpec.ts
+var unitVector = tuple([
+	number(),
+	number(),
+	number()
+]).refine((value) => Math.abs(value[0] ** 2 + value[1] ** 2 + value[2] ** 2 - 1) < 1e-6, { error: "must be a unit vector" });
+var spatialPlacementFields = {
+	origin: tuple([
+		number(),
+		number(),
+		number()
+	]).optional(),
+	axisX: unitVector.optional(),
+	axisZ: unitVector.optional()
+};
+function validateSpatialAxes(data, ctx) {
+	const axisX = data.axisX ?? [
+		1,
+		0,
+		0
+	];
+	const axisZ = data.axisZ ?? [
+		0,
+		0,
+		1
+	];
+	const dot = axisX[0] * axisZ[0] + axisX[1] * axisZ[1] + axisX[2] * axisZ[2];
+	if (Math.abs(dot) > 1e-6) ctx.addIssue({
+		code: "custom",
+		message: "axisX and axisZ must be orthogonal",
+		path: ["axisZ"]
+	});
+}
+var SiteSpecSchema = object({
+	name: string().min(1),
+	description: string().optional(),
+	...spatialPlacementFields,
+	compositionType: _enum([
+		"COMPLEX",
+		"ELEMENT",
+		"PARTIAL"
+	]).optional()
+}).superRefine(validateSpatialAxes);
+function parseSiteSpec(input) {
+	const result = SiteSpecSchema.safeParse(input);
+	return result.success ? (0, brepjs.ok)(result.data) : (0, brepjs.err)(specError("INVALID_SITE_SPEC", result.error.message, result.error));
+}
+//#endregion
+//#region src/specs/infrastructureSpec.ts
+var composition = _enum([
+	"COMPLEX",
+	"ELEMENT",
+	"PARTIAL"
+]).optional();
+var BridgeSpecSchema = object({
+	name: string().min(1),
+	description: string().optional(),
+	...spatialPlacementFields,
+	compositionType: composition,
+	predefinedType: _enum([
+		"ARCHED",
+		"CABLE_STAYED",
+		"CANTILEVER",
+		"CULVERT",
+		"FRAMEWORK",
+		"GIRDER",
+		"SUSPENSION",
+		"TRUSS",
+		"USERDEFINED",
+		"NOTDEFINED"
+	]).optional()
+}).superRefine(validateSpatialAxes);
+var BridgePartSpecSchema = object({
+	name: string().min(1),
+	description: string().optional(),
+	...spatialPlacementFields,
+	compositionType: composition,
+	usageType: _enum([
+		"LATERAL",
+		"LONGITUDINAL",
+		"REGION",
+		"VERTICAL",
+		"USERDEFINED",
+		"NOTDEFINED"
+	]),
+	predefinedType: _enum([
+		"ABUTMENT",
+		"DECK",
+		"DECK_SEGMENT",
+		"FOUNDATION",
+		"PIER",
+		"PIER_SEGMENT",
+		"PYLON",
+		"SUBSTRUCTURE",
+		"SUPERSTRUCTURE",
+		"SURFACESTRUCTURE",
+		"USERDEFINED",
+		"NOTDEFINED"
+	]).optional()
+}).superRefine(validateSpatialAxes);
+function parseBridgeSpec(input) {
+	const result = BridgeSpecSchema.safeParse(input);
+	return result.success ? (0, brepjs.ok)(result.data) : (0, brepjs.err)(specError("INVALID_BRIDGE_SPEC", result.error.message, result.error));
+}
+function parseBridgePartSpec(input) {
+	const result = BridgePartSpecSchema.safeParse(input);
+	return result.success ? (0, brepjs.ok)(result.data) : (0, brepjs.err)(specError("INVALID_BRIDGE_PART_SPEC", result.error.message, result.error));
+}
+//#endregion
 //#region src/cobie/cobieExport.ts
 /**
 * Physical-element categories that become COBie Component rows. Spatial
@@ -15921,7 +16238,8 @@ var COMPONENT_CATEGORIES = /* @__PURE__ */ new Set([
 	"STAIR",
 	"RAMP",
 	"RAILING",
-	"COVERING"
+	"COVERING",
+	"EARTHWORKS_FILL"
 ]);
 /**
 * Title-cased label used as the COBie Type/Component name prefix for a category,
@@ -15943,7 +16261,8 @@ var CATEGORY_LABEL = {
 	STAIR: "Stair",
 	RAMP: "Ramp",
 	RAILING: "Railing",
-	COVERING: "Covering"
+	COVERING: "Covering",
+	EARTHWORKS_FILL: "EarthworksFill"
 };
 function categoryLabel(category) {
 	return CATEGORY_LABEL[category] ?? category;
@@ -27620,8 +27939,11 @@ function assignNum(target, key, value) {
 * while the IR path serves the viewport and dedup. GlobalIds derive from
 * families key paths (stable under reordering), not insertion order.
 *
-* Scope: Storey containers, Wall/Slab/Column/Beam/Roof/Stair elements, and wall openings — a
-* fill-role void (Door/Window family) maps onto addDoor/addWindow, which cut
+* Scope: building Storey containers; civil Site/Bridge/recursive Bridge Part
+* structure and Earthworks Fill bodies; Wall/Slab/Column/Beam/Roof/Stair,
+* Footing/Pile, Railing/Ramp, Covering/CurtainWall, and Space elements; and
+* wall openings — a fill-role void (Door/Window family) maps onto
+* addDoor/addWindow, which cut
 * the wall and wire IfcRelVoidsElement + IfcRelFillsElement; the opening and
 * filler GlobalIds derive from the synthesized key paths. Anonymous (non-fill)
 * voids are rejected: they cut only the IR/viewport geometry, and exporting
@@ -27675,12 +27997,71 @@ var SPEC_ROUTES = {
 	stair: {
 		parse: parseStairSpec,
 		add: (m, spec, key) => m.addStair(spec, { stableKey: key }),
-		input: stairSpecInput
+		input: flightsSpecInput
+	},
+	footing: {
+		parse: parseFootingSpec,
+		add: (m, spec, key) => m.addFooting(spec, { stableKey: key })
+	},
+	pile: {
+		parse: parsePileSpec,
+		add: (m, spec, key) => m.addPile(spec, { stableKey: key })
+	},
+	railing: {
+		parse: parseRailingSpec,
+		add: (m, spec, key) => m.addRailing(spec, { stableKey: key })
+	},
+	ramp: {
+		parse: parseRampSpec,
+		add: (m, spec, key) => m.addRamp(spec, { stableKey: key }),
+		input: flightsSpecInput
+	},
+	covering: {
+		parse: parseCoveringSpec,
+		add: (m, spec, key) => m.addCovering(spec, void 0, { stableKey: key })
+	},
+	curtainWall: {
+		parse: parseCurtainWallSpec,
+		add: (m, spec, key) => m.addCurtainWall(spec, { stableKey: key })
+	},
+	space: {
+		parse: parseSpaceSpec,
+		add: (m, spec, key) => m.addSpace(spec, { stableKey: key })
+	}
+};
+var CIVIL_PRODUCT_ROUTES = {
+	beam: {
+		archetype: "beam",
+		roles: [
+			"beam",
+			"cross-girder",
+			"girder"
+		]
+	},
+	column: {
+		archetype: "column",
+		roles: ["pier-stem"]
+	},
+	footing: {
+		archetype: "footing",
+		roles: ["pad"]
+	},
+	railing: {
+		archetype: "railing",
+		roles: ["guardrail"]
+	},
+	slab: {
+		archetype: "slab",
+		roles: ["deck"]
+	},
+	wall: {
+		archetype: "wall",
+		roles: ["wall"]
 	}
 };
-/** StairSpec has no top-level origin — placement lives per flight — so the
-*  element's folded translate lands on every flight's origin instead. */
-function stairSpecInput(el) {
+/** Stair and ramp specs have no top-level origin — placement lives per flight —
+*  so the element's folded translate lands on every flight's origin instead. */
+function flightsSpecInput(el) {
 	const base = specInput(el);
 	const fold = base["origin"] ?? [
 		0,
@@ -27722,14 +28103,145 @@ var NAME_ARCHETYPES = {
 	Roof: "roof",
 	Stair: "stair",
 	Door: "door",
-	Window: "window"
+	Window: "window",
+	Footing: "footing",
+	Pile: "pile",
+	Railing: "railing",
+	Ramp: "ramp",
+	Covering: "covering",
+	CurtainWall: "curtainWall",
+	Space: "space"
 };
 function archetypeFor(el) {
-	return el.archetype ?? NAME_ARCHETYPES[el.type];
+	return el.archetype ?? lookup(NAME_ARCHETYPES, el.type);
 }
 function specRoute(archetype) {
 	return archetype !== void 0 && Object.hasOwn(SPEC_ROUTES, archetype) ? SPEC_ROUTES[archetype] : void 0;
 }
+/** Own-property lookup: semantics categories and roles are free-form author
+*  strings, so Object.prototype keys must never resolve to a route. */
+function lookup(map, key) {
+	return Object.hasOwn(map, key) ? map[key] : void 0;
+}
+function civilProductArchetype(el) {
+	if (el.semantics?.kind !== "product") return void 0;
+	const definition = lookup(CIVIL_PRODUCT_ROUTES, el.semantics.category);
+	if (definition === void 0 || !definition.roles.includes(el.semantics.role)) return void 0;
+	return definition.archetype;
+}
+function semanticDimension(el, ...names) {
+	if (el.semantics?.kind !== "product") return void 0;
+	for (const name of names) {
+		const value = el.semantics.dimensionsMm[name];
+		if (value !== void 0) return value;
+	}
+}
+/** Beam/column solids centre their cross-section on the placement axis, while
+*  the semantics envelope sits corner-anchored at the folded IR origin — shift
+*  the origin to the envelope centre so the exported body occupies the same
+*  space as the viewport body. */
+function centreOrigin(base, shift) {
+	const origin = base["origin"] ?? [
+		0,
+		0,
+		0
+	];
+	return [
+		origin[0] + shift[0],
+		origin[1] + shift[1],
+		origin[2] + shift[2]
+	];
+}
+/**
+* Adapts target-independent civil envelope dimensions onto existing typed BIM
+* spec inputs. Reference infrastructure Families intentionally author domain
+* props such as `depth`, `capOffset`, and compound railing profiles rather than
+* BIM `profile`/`thickness` fields; semantics is the stable projection seam.
+*/
+function civilProductSpecInput(el) {
+	const base = specInput(el);
+	if (el.semantics?.kind !== "product") return base;
+	const length = semanticDimension(el, "length");
+	const width = semanticDimension(el, "width");
+	const height = semanticDimension(el, "height");
+	switch (el.semantics.category) {
+		case "beam": {
+			const synthesized = base["profile"] === void 0 && width !== void 0 && height !== void 0 ? {
+				profile: {
+					kind: "RECTANGULAR",
+					width,
+					height
+				},
+				shift: [
+					0,
+					width / 2,
+					height / 2
+				]
+			} : void 0;
+			return {
+				...base,
+				...synthesized !== void 0 ? {
+					origin: centreOrigin(base, synthesized.shift),
+					profile: synthesized.profile
+				} : {},
+				length: length ?? base["length"],
+				predefinedType: base["predefinedType"] ?? "BEAM"
+			};
+		}
+		case "column": {
+			const synthesized = base["profile"] === void 0 && length !== void 0 && width !== void 0 ? {
+				profile: {
+					kind: "RECTANGULAR",
+					width: length,
+					height: width
+				},
+				shift: [
+					length / 2,
+					width / 2,
+					0
+				]
+			} : void 0;
+			return {
+				...base,
+				...synthesized !== void 0 ? {
+					origin: centreOrigin(base, synthesized.shift),
+					profile: synthesized.profile
+				} : {},
+				height: height ?? base["height"],
+				predefinedType: base["predefinedType"] ?? "COLUMN"
+			};
+		}
+		case "footing": return {
+			...base,
+			length: length ?? base["length"],
+			width: width ?? base["width"],
+			thickness: height ?? base["thickness"],
+			predefinedType: base["predefinedType"] ?? "PAD_FOOTING"
+		};
+		case "railing": return {
+			...base,
+			length: length ?? base["length"],
+			thickness: width ?? base["thickness"],
+			height: height ?? base["height"],
+			predefinedType: base["predefinedType"] ?? "GUARDRAIL"
+		};
+		case "slab": return {
+			...base,
+			length: length ?? base["length"],
+			width: width ?? base["width"],
+			thickness: height ?? base["thickness"],
+			predefinedType: base["predefinedType"] ?? "FLOOR"
+		};
+		case "wall": return {
+			...base,
+			length: length ?? base["length"],
+			thickness: width ?? base["thickness"],
+			height: height ?? base["height"],
+			predefinedType: base["predefinedType"] ?? "NOTDEFINED"
+		};
+		default: return base;
+	}
+}
 /** Total of the resolved geometry's OUTER literal translate chain. The
 *  transform vocabulary is translate-only, so frame differences are exact
 *  subtractions. Parameter-driven translations stop the peel. */
@@ -27755,15 +28267,14 @@ function peelTranslates(node) {
 		moved
 	};
 }
-/** True when the element's transform PROP carries a rotation. The spec path
+/** True when the element's rendered local transform carries a rotation. The spec path
 *  folds only translations into IfcLocalPlacement (walls orient via `axisX`),
 *  so a tRotate placement would export un-rotated while the viewport shows it
 *  rotated — reject instead of diverging. Rotations a family render bakes
 *  into its own body geometry (e.g. a circular beam oriented along axisX) are
 *  fine: the spec rebuilds that body parametrically from props. */
 function hasRotateOp(el) {
-	const ops = el.props["transform"];
-	return Array.isArray(ops) && ops.some((op) => typeof op === "object" && op !== null && op.op === "rotate");
+	return el.localTransforms.some((op) => op.op === "rotate");
 }
 /** Fold the resolved geometry's outer translate chain into the spec placement
 *  origin, so IfcLocalPlacement matches the IR world frame no matter where the
@@ -27809,10 +28320,14 @@ var COMMON_PSET_FIELDS = {
 function collectSpecProps(el) {
 	const out = {};
 	const material = el.attributes["material"];
-	if (typeof material === "string" && el.props["materialName"] === void 0) out["materialName"] = material;
+	const semanticsMaterial = el.semantics?.kind === "product" ? el.semantics.material : void 0;
+	if (el.props["materialName"] === void 0) {
+		if (typeof material === "string") out["materialName"] = material;
+		else if (semanticsMaterial !== void 0) out["materialName"] = semanticsMaterial;
+	}
 	const psets = el.attributes["psets"];
+	const custom = {};
 	if (psets && typeof psets === "object") {
-		const custom = {};
 		const ownCommonPset = `Pset_${el.type}Common`;
 		for (const [psetName, fields] of Object.entries(psets)) {
 			if (!fields || typeof fields !== "object") continue;
@@ -27825,14 +28340,15 @@ function collectSpecProps(el) {
 				if (Object.keys(values).length > 0) custom[psetName] = values;
 			}
 		}
-		if (Object.keys(custom).length > 0) {
-			const declared = el.props["customProperties"];
-			out["customProperties"] = declared && typeof declared === "object" ? {
-				...custom,
-				...declared
-			} : custom;
-		}
 	}
+	const declared = el.props["customProperties"];
+	if (declared && typeof declared === "object" && !Array.isArray(declared)) for (const [psetName, fields] of Object.entries(declared)) {
+		if (!fields || typeof fields !== "object" || Array.isArray(fields)) continue;
+		const values = {};
+		for (const [field, value] of Object.entries(fields)) if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") values[field] = value;
+		if (Object.keys(values).length > 0) custom[psetName] = values;
+	}
+	if (Object.keys(custom).length > 0) out["customProperties"] = custom;
 	return out;
 }
 function addFill(model, fill, input, identity) {
@@ -27849,35 +28365,49 @@ function addFill(model, fill, input, identity) {
 	}
 	return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_FILL", `familiesToBim: no fill mapping for element type '${fill.type}' at '${fill.keyPath}' (archetype: ${archetype ?? "none"}) — a filler needs archetype: 'door' or 'window'`));
 }
-/** Materialize an unrouted element's IR and add it as a proxy. The body is
-*  authoritative for a proxy (no parametric spec to diverge from), so baked
-*  transforms — rotations included — are fine here. */
-function addProxyElement(model, el, evaluator) {
+function materializeOwnedSolid(el, evaluator, errors) {
 	const evaluated = evaluator.evaluate(el.geometry);
-	if (!evaluated.ok) return (0, brepjs.err)(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' failed to materialize for the proxy route: ${evaluated.error.message}`, evaluated.error));
+	if (!evaluated.ok) return (0, brepjs.err)(specError(errors.evalCode, `familiesToBim: '${el.keyPath}' failed to materialize for the ${errors.routeName} route: ${evaluated.error.message}`, evaluated.error));
 	let source = evaluated.value;
 	if (!(0, brepjs.isSolid)(source)) {
 		const solids = (0, brepjs.getSolids)(source);
 		const only = solids.length === 1 ? solids[0] : void 0;
-		if (only === void 0) return (0, brepjs.err)(specError("FAMILIES_PROXY_NOT_SOLID", `familiesToBim: '${el.keyPath}' materialized to ${solids.length} solids — a proxy body must be exactly one`));
+		if (only === void 0) return (0, brepjs.err)(specError(errors.notSolidCode, `familiesToBim: '${el.keyPath}' materialized to ${solids.length} solids — the ${errors.routeName} body must be exactly one`));
 		source = only;
 	}
 	const copy = (0, brepjs.clone)(source);
-	if (!copy.ok) return (0, brepjs.err)(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' could not copy the materialized body`, copy.error));
+	if (!copy.ok) return (0, brepjs.err)(specError(errors.evalCode, `familiesToBim: '${el.keyPath}' could not copy the materialized body`, copy.error));
 	const valid = (0, brepjs.validSolid)(copy.value);
 	if (!valid.ok) {
 		copy.value[Symbol.dispose]();
-		return (0, brepjs.err)(specError("FAMILIES_PROXY_INVALID", `familiesToBim: '${el.keyPath}' materialized to an invalid solid: ${valid.error}`));
+		return (0, brepjs.err)(specError(errors.invalidCode, `familiesToBim: '${el.keyPath}' materialized to an invalid solid: ${valid.error}`));
 	}
+	return (0, brepjs.ok)(valid.value);
+}
+/** Materialize an unrouted element's IR and add it as a proxy. The body is
+*  authoritative for a proxy (no parametric spec to diverge from), so baked
+*  transforms — rotations included — are fine here. */
+function addProxyElement(model, el, evaluator, projectedSpatialTranslation) {
+	const body = materializeOwnedSolid(el, evaluator, {
+		evalCode: "FAMILIES_PROXY_EVAL_FAILED",
+		notSolidCode: "FAMILIES_PROXY_NOT_SOLID",
+		invalidCode: "FAMILIES_PROXY_INVALID",
+		routeName: "proxy"
+	});
+	if (!body.ok) return body;
+	const localized = localizeOwnedSolid(el, body.value, projectedSpatialTranslation, "FAMILIES_PROXY_LOCALIZE_FAILED", "spatial parent");
+	if (!localized.ok) return localized;
 	const nameAttr = el.attributes["name"];
 	const materialProp = el.props["materialName"];
 	const specProps = collectSpecProps(el);
-	return model.addProxy({
+	const added = model.addProxy({
 		name: typeof nameAttr === "string" ? nameAttr : el.type,
-		solid: valid.value,
+		solid: localized.value,
 		materialName: typeof materialProp === "string" ? materialProp : specProps["materialName"],
 		customProperties: specProps["customProperties"]
 	}, { stableKey: el.keyPath });
+	if (!added.ok) localized.value[Symbol.dispose]();
+	return added;
 }
 /** Map a wall's synthesized Opening children onto addDoor/addWindow. The
 *  wall-relative offsets come from the void geometry's frame minus the host's:
@@ -27927,38 +28457,296 @@ function requireKeyed(el) {
 	if (el.keyed) return (0, brepjs.ok)(void 0);
 	return (0, brepjs.err)(specError("FAMILIES_UNKEYED_ELEMENT", `familiesToBim: '${el.keyPath}' has no explicit key — IFC identity needs order-independent key paths (add a key to the element)`));
 }
+var BRIDGE_ROLE = {
+	arched: "ARCHED",
+	"cable-stayed": "CABLE_STAYED",
+	cantilever: "CANTILEVER",
+	culvert: "CULVERT",
+	framework: "FRAMEWORK",
+	girder: "GIRDER",
+	suspension: "SUSPENSION",
+	truss: "TRUSS"
+};
+var BRIDGE_PART_ROLE = {
+	abutment: "ABUTMENT",
+	deck: "DECK",
+	"deck-segment": "DECK_SEGMENT",
+	foundation: "FOUNDATION",
+	pier: "PIER",
+	"pier-segment": "PIER_SEGMENT",
+	pylon: "PYLON",
+	substructure: "SUBSTRUCTURE",
+	superstructure: "SUPERSTRUCTURE",
+	"surface-structure": "SURFACESTRUCTURE"
+};
+var CIVIL_COMPOSITION = {
+	collection: "COMPLEX",
+	element: "ELEMENT",
+	partial: "PARTIAL"
+};
+var CIVIL_USAGE = {
+	lateral: "LATERAL",
+	longitudinal: "LONGITUDINAL",
+	regional: "REGION",
+	vertical: "VERTICAL"
+};
+var EARTHWORKS_FILL_ROLE = {
+	backfill: "BACKFILL",
+	counterweight: "COUNTERWEIGHT",
+	embankment: "EMBANKMENT",
+	"slope-fill": "SLOPEFILL",
+	subgrade: "SUBGRADE",
+	"subgrade-bed": "SUBGRADEBED",
+	"transition-section": "TRANSITIONSECTION"
+};
+function unsupportedCivilRole(el, entity) {
+	return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_CIVIL_SEMANTICS", `familiesToBim: unsupported ${entity} role '${el.semantics?.role ?? ""}' at '${el.keyPath}'`));
+}
+function civilSpatialKind(el) {
+	const semantics = el.semantics;
+	if (semantics?.kind === "site" && semantics.category === "site") return "site";
+	if (semantics?.kind === "facility" && semantics.category === "bridge") return "bridge";
+	if (semantics?.kind === "spatial-part" && semantics.category === "bridge-part") return "bridge-part";
+}
+function isCivilSpatialIntent(el) {
+	return el.semantics?.kind === "site" || el.semantics?.kind === "facility" || el.semantics?.kind === "spatial-part";
+}
+function hasCivilSpatialIntent(el) {
+	return isCivilSpatialIntent(el) || el.children.some(hasCivilSpatialIntent);
+}
+function isEarthworksFillOccurrence(el) {
+	return el.semantics?.kind === "product" && el.semantics.category === "earthworks-fill";
+}
+function semanticName(el) {
+	const name = el.attributes["name"];
+	if (typeof name === "string" && name.trim().length > 0) return name;
+	const semanticNameValue = el.semantics?.properties?.["name"];
+	return typeof semanticNameValue === "string" && semanticNameValue.trim().length > 0 ? semanticNameValue : el.keyPath;
+}
+var ZERO_TRANSLATION = [
+	0,
+	0,
+	0
+];
+function addTranslation(a, b) {
+	return [
+		a[0] + b[0],
+		a[1] + b[1],
+		a[2] + b[2]
+	];
+}
+function subtractTranslation(a, b) {
+	return [
+		a[0] - b[0],
+		a[1] - b[1],
+		a[2] - b[2]
+	];
+}
+function hasTranslation(value) {
+	return value[0] !== 0 || value[1] !== 0 || value[2] !== 0;
+}
+var DEFAULT_AXIS_X = [
+	1,
+	0,
+	0
+];
+var DEFAULT_AXIS_Z = [
+	0,
+	0,
+	1
+];
+function axisEquals(value, axis) {
+	return Array.isArray(value) && value.length === 3 && value.every((component, i) => typeof component === "number" && component === axis[i]);
+}
+/** Civil descendant relativization is translation-only, so a civil frame with
+*  non-default axes would rotate the exported hierarchy away from the IR. */
+function hasRotatedAxes(el) {
+	const axisX = el.props["axisX"];
+	const axisZ = el.props["axisZ"];
+	return axisX !== void 0 && !axisEquals(axisX, DEFAULT_AXIS_X) || axisZ !== void 0 && !axisEquals(axisZ, DEFAULT_AXIS_Z);
+}
+function authoredSpecOrigin(el) {
+	const origin = el.props["origin"];
+	return Array.isArray(origin) && origin.length === 3 && origin.every((c) => typeof c === "number") ? origin : ZERO_TRANSLATION;
+}
+function localizeOwnedSolid(el, body, projectedSpatialTranslation, errorCode, frameName) {
+	if (!hasTranslation(projectedSpatialTranslation)) return (0, brepjs.ok)(body);
+	try {
+		const localized = (0, brepjs.translate)(body, [
+			-projectedSpatialTranslation[0],
+			-projectedSpatialTranslation[1],
+			-projectedSpatialTranslation[2]
+		]);
+		body[Symbol.dispose]();
+		return (0, brepjs.ok)(localized);
+	} catch (cause) {
+		body[Symbol.dispose]();
+		return (0, brepjs.err)(specError(errorCode, `familiesToBim: '${el.keyPath}' could not move its body into the ${frameName} frame`, cause));
+	}
+}
+function authoredTranslation(el) {
+	const total = [
+		0,
+		0,
+		0
+	];
+	for (const op of el.localTransforms) {
+		if (op.op !== "translate") continue;
+		total[0] += op.v[0];
+		total[1] += op.v[1];
+		total[2] += op.v[2];
+	}
+	return total;
+}
+function civilSpatialInput(el, localTranslation) {
+	const semantics = el.semantics;
+	const composition = semantics !== void 0 && "composition" in semantics ? CIVIL_COMPOSITION[semantics.composition] : void 0;
+	const origin = addTranslation(el.props["origin"] ?? ZERO_TRANSLATION, localTranslation);
+	return {
+		name: semanticName(el),
+		...el.props["origin"] !== void 0 || hasTranslation(localTranslation) ? { origin } : {},
+		...el.props["axisX"] !== void 0 ? { axisX: el.props["axisX"] } : {},
+		...el.props["axisZ"] !== void 0 ? { axisZ: el.props["axisZ"] } : {},
+		...composition !== void 0 ? { compositionType: composition } : {}
+	};
+}
+function civilParentAccepts(kind, parent) {
+	if (kind === "site") return parent === "project";
+	if (kind === "bridge") return parent === "site";
+	return parent === "bridge" || parent === "bridge-part";
+}
+function addCivilSpatialOccurrence(model, el, kind, localTranslation) {
+	if (kind === "site") {
+		if (el.semantics?.role !== "transport-site") return unsupportedCivilRole(el, "Site");
+		const parsed = parseSiteSpec(civilSpatialInput(el, localTranslation));
+		return parsed.ok ? model.addSite(parsed.value, { stableKey: el.keyPath }) : parsed;
+	}
+	if (kind === "bridge") {
+		const predefinedType = lookup(BRIDGE_ROLE, el.semantics?.role ?? "");
+		if (predefinedType === void 0) return unsupportedCivilRole(el, "Bridge");
+		const parsed = parseBridgeSpec({
+			...civilSpatialInput(el, localTranslation),
+			predefinedType
+		});
+		return parsed.ok ? model.addBridge(parsed.value, { stableKey: el.keyPath }) : parsed;
+	}
+	const subdivision = el.semantics?.kind === "spatial-part" ? el.semantics.subdivision : void 0;
+	const predefinedType = lookup(BRIDGE_PART_ROLE, el.semantics?.role ?? "");
+	if (predefinedType === void 0) return unsupportedCivilRole(el, "Bridge Part");
+	const parsed = parseBridgePartSpec({
+		...civilSpatialInput(el, localTranslation),
+		predefinedType,
+		usageType: subdivision !== void 0 ? CIVIL_USAGE[subdivision] : "NOTDEFINED"
+	});
+	return parsed.ok ? model.addBridgePart(parsed.value, { stableKey: el.keyPath }) : parsed;
+}
+function relativeSpecInput(input, projectedSpatialTranslation) {
+	const relativeOrigin = (origin) => Array.isArray(origin) && origin.length === 3 && origin.every((value) => typeof value === "number") ? subtractTranslation(origin, projectedSpatialTranslation) : origin;
+	if (Array.isArray(input["flights"])) {
+		const flights = input["flights"];
+		return {
+			...input,
+			flights: flights.map((flight) => {
+				if (typeof flight !== "object" || flight === null) return flight;
+				const flightInput = flight;
+				return {
+					...flightInput,
+					origin: relativeOrigin(flightInput["origin"])
+				};
+			})
+		};
+	}
+	return {
+		...input,
+		origin: relativeOrigin(input["origin"])
+	};
+}
+function addEarthworksFillElement(model, el, evaluator, projectedSpatialTranslation) {
+	if (el.semantics?.kind !== "product") return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_CIVIL_SEMANTICS", `familiesToBim: '${el.keyPath}' is not authored as a civil Product`));
+	const predefinedType = lookup(EARTHWORKS_FILL_ROLE, el.semantics.role);
+	if (predefinedType === void 0) return unsupportedCivilRole(el, "Earthworks Fill");
+	const body = materializeOwnedSolid(el, evaluator, {
+		evalCode: "FAMILIES_EARTHWORKS_EVAL_FAILED",
+		notSolidCode: "FAMILIES_EARTHWORKS_NOT_SOLID",
+		invalidCode: "FAMILIES_EARTHWORKS_INVALID",
+		routeName: "Earthworks Fill"
+	});
+	if (!body.ok) return body;
+	const localized = localizeOwnedSolid(el, body.value, projectedSpatialTranslation, "FAMILIES_EARTHWORKS_LOCALIZE_FAILED", "Bridge Part");
+	if (!localized.ok) return localized;
+	const specProps = collectSpecProps(el);
+	const authoredMaterial = el.props["materialName"];
+	const added = model.addEarthworksFill({
+		name: semanticName(el),
+		solid: localized.value,
+		materialName: typeof authoredMaterial === "string" ? authoredMaterial : specProps["materialName"] ?? el.semantics.material,
+		predefinedType,
+		customProperties: specProps["customProperties"]
+	}, { stableKey: el.keyPath });
+	if (!added.ok) localized.value[Symbol.dispose]();
+	return added;
+}
 /**
 * Project a resolved families tree into an eager BimModel. The caller owns
 * the returned model (`using`); families stays domain-neutral — this adapter
 * is where families types meet the IFC vocabulary.
 */
 function familiesToBim(root, options) {
+	const usesAuthoredCivilHierarchy = hasCivilSpatialIntent(root);
+	if (usesAuthoredCivilHierarchy) {
+		const keyed = requireKeyed(root);
+		if (!keyed.ok) return keyed;
+	}
 	const model = new BimModel();
-	const initResult = model.init(options.project);
+	const initResult = model.init(options.project, usesAuthoredCivilHierarchy ? { stableKey: civilSpatialKind(root) !== void 0 ? `${root.keyPath}#project` : root.keyPath } : void 0);
 	if (!initResult.ok) return initResult;
-	const siteResult = model.addSite({ name: options.siteName ?? "Site" });
-	if (!siteResult.ok) {
-		model[Symbol.dispose]();
-		return siteResult;
-	}
-	const buildingResult = model.addBuilding({ name: options.buildingName ?? "Building" });
-	if (!buildingResult.ok) {
-		model[Symbol.dispose]();
-		return buildingResult;
-	}
-	const buildingId = buildingResult.value;
-	const project = model.getProject();
-	if (project !== null) model.aggregate(project.localId, siteResult.value);
-	model.aggregate(siteResult.value, buildingId);
-	const idByKeyPath = /* @__PURE__ */ new Map();
+	const projectId = initResult.value;
+	let buildingId = null;
+	if (!usesAuthoredCivilHierarchy) {
+		const siteResult = model.addSite({ name: options.siteName ?? "Site" });
+		if (!siteResult.ok) {
+			model[Symbol.dispose]();
+			return siteResult;
+		}
+		const buildingResult = model.addBuilding({ name: options.buildingName ?? "Building" });
+		if (!buildingResult.ok) {
+			model[Symbol.dispose]();
+			return buildingResult;
+		}
+		buildingId = buildingResult.value;
+		model.aggregate(projectId, siteResult.value);
+		model.aggregate(siteResult.value, buildingId);
+	}
+	const idByKeyPath = new Map(usesAuthoredCivilHierarchy ? [[root.keyPath, projectId]] : []);
 	const proxied = [];
-	const walk = (el, storeyId, rotated) => {
-		const rotatedHere = rotated || hasRotateOp(el);
+	const walk = (el, state) => {
+		const rotatedHere = state.rotated || hasRotateOp(el);
+		const cumulativeTranslationHere = addTranslation(state.cumulativeTranslation, authoredTranslation(el));
 		let proxiedHere = false;
-		let containerId = storeyId;
+		let nextSpatialStructureId = state.spatialStructureId;
+		let nextCivilParent = state.civilParent;
+		let nextProjectedSpatialTranslation = state.projectedSpatialTranslation;
 		const archetype = archetypeFor(el);
-		const route = specRoute(archetype);
-		if (archetype === "storey") {
+		const effectiveArchetype = el.semantics?.kind === "product" ? civilProductArchetype(el) : archetype;
+		const route = specRoute(effectiveArchetype);
+		const civilKind = civilSpatialKind(el);
+		if (civilKind !== void 0) {
+			if (!usesAuthoredCivilHierarchy || !civilParentAccepts(civilKind, state.civilParent) || state.spatialStructureId === null) return (0, brepjs.err)(specError("FAMILIES_INVALID_CIVIL_HIERARCHY", `familiesToBim: civil '${civilKind}' at '${el.keyPath}' cannot occur under '${state.civilParent}'`));
+			const keyed = requireKeyed(el);
+			if (!keyed.ok) return keyed;
+			if (rotatedHere || hasRotatedAxes(el)) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_TRANSFORM", `familiesToBim: civil spatial element '${el.keyPath}' carries a rotated frame — descendants are relativized by translation only, so bake the orientation into child geometry`));
+			if (el.geometry.kind !== "Empty") return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_CIVIL_SEMANTICS", `familiesToBim: civil spatial element '${el.keyPath}' carries its own geometry — Site/Bridge/Bridge Part export no body, so author it as a child Product (e.g. Earthworks Fill)`));
+			const localTranslation = subtractTranslation(cumulativeTranslationHere, state.projectedSpatialTranslation);
+			const added = addCivilSpatialOccurrence(model, el, civilKind, localTranslation);
+			if (!added.ok) return added;
+			model.aggregate(state.spatialStructureId, added.value);
+			idByKeyPath.set(el.keyPath, added.value);
+			nextSpatialStructureId = added.value;
+			nextCivilParent = civilKind;
+			nextProjectedSpatialTranslation = addTranslation(cumulativeTranslationHere, authoredSpecOrigin(el));
+		} else if (isCivilSpatialIntent(el)) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_CIVIL_SEMANTICS", `familiesToBim: unsupported civil '${el.semantics?.kind ?? "unknown"}' category '${el.semantics?.category ?? ""}' at '${el.keyPath}'`));
+		else if (archetype === "storey") {
+			if (buildingId === null) return (0, brepjs.err)(specError("FAMILIES_INVALID_CIVIL_HIERARCHY", `familiesToBim: Storey '${el.keyPath}' is not part of the civil Bridge hierarchy`));
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
 			const storeyResult = model.addStorey({
@@ -27968,7 +28756,17 @@ function familiesToBim(root, options) {
 			if (!storeyResult.ok) return storeyResult;
 			model.aggregate(buildingId, storeyResult.value);
 			idByKeyPath.set(el.keyPath, storeyResult.value);
-			containerId = storeyResult.value;
+			nextSpatialStructureId = storeyResult.value;
+		} else if (isEarthworksFillOccurrence(el)) {
+			if (!usesAuthoredCivilHierarchy || nextSpatialStructureId === null || state.civilParent !== "bridge-part") return (0, brepjs.err)(specError("FAMILIES_INVALID_CIVIL_HIERARCHY", `familiesToBim: Earthworks Fill '${el.keyPath}' needs a Bridge Part ancestor`));
+			const bodyEvaluator = options.bodyEvaluator ?? options.proxyEvaluator;
+			if (bodyEvaluator === void 0) return (0, brepjs.err)(specError("FAMILIES_EARTHWORKS_EVALUATOR_REQUIRED", `familiesToBim: Earthworks Fill '${el.keyPath}' needs bodyEvaluator to materialize its exact Product Body`));
+			const keyed = requireKeyed(el);
+			if (!keyed.ok) return keyed;
+			const added = addEarthworksFillElement(model, el, bodyEvaluator, state.projectedSpatialTranslation);
+			if (!added.ok) return added;
+			model.placeIn(added.value, nextSpatialStructureId);
+			idByKeyPath.set(el.keyPath, added.value);
 		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
@@ -27978,26 +28776,27 @@ function familiesToBim(root, options) {
 				const openings = el.children.filter((c) => c.type === "Opening").length;
 				if (voids.length > openings) return (0, brepjs.err)(specError("FAMILIES_ANONYMOUS_VOID", `familiesToBim: '${el.keyPath}' has ${voids.length - openings} anonymous void(s) the IFC body cannot carry — use a fill-role family (Door/Window) for each void`));
 			}
-			const parsed = route.parse(("input" in route ? route.input : specInput)(el));
+			const routedInput = el.semantics?.kind === "product" ? civilProductSpecInput(el) : ("input" in route ? route.input : specInput)(el);
+			const parsed = route.parse(usesAuthoredCivilHierarchy ? relativeSpecInput(routedInput, state.projectedSpatialTranslation) : routedInput);
 			if (!parsed.ok) return parsed;
 			const added = route.add(model, parsed.value, el.keyPath);
 			if (!added.ok) return added;
 			idByKeyPath.set(el.keyPath, added.value);
-			if (containerId === null) return (0, brepjs.err)(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
-			model.placeIn(added.value, containerId);
-			if (archetype === "wall") {
-				const opened = addOpenings(model, el, added.value, containerId, idByKeyPath);
+			if (nextSpatialStructureId === null || usesAuthoredCivilHierarchy && state.civilParent !== "bridge-part") return (0, brepjs.err)(specError(usesAuthoredCivilHierarchy ? "FAMILIES_INVALID_CIVIL_HIERARCHY" : "FAMILIES_NO_STOREY", usesAuthoredCivilHierarchy ? `familiesToBim: physical product '${el.keyPath}' needs a Bridge Part ancestor` : `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
+			model.placeIn(added.value, nextSpatialStructureId);
+			if (effectiveArchetype === "wall") {
+				const opened = addOpenings(model, el, added.value, nextSpatialStructureId, idByKeyPath);
 				if (!opened.ok) return opened;
 			}
 		} else if (el.type === "Opening") return (0, brepjs.err)(specError("FAMILIES_OPENING_OUTSIDE_WALL", `familiesToBim: opening '${el.keyPath}' is not hosted by a Wall — only wall openings are mapped`));
 		else if (el.type !== "Group" && el.geometry.kind !== "Empty") {
-			if (options.proxyEvaluator === void 0) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}' (archetype: ${el.archetype ?? "none"}) — routing is by archetype, so declare one on the family, add a spec route, or pass proxyEvaluator to export it as an IfcBuildingElementProxy`));
+			if (options.proxyEvaluator === void 0) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no supported spec mapping for element type '${el.type}' at '${el.keyPath}' (archetype: ${el.archetype ?? "none"}) — declare a recognized archetype or civil Product category/role, add a spec route, or pass proxyEvaluator to export it as an IfcBuildingElementProxy`));
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
-			if (containerId === null) return (0, brepjs.err)(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
-			const added = addProxyElement(model, el, options.proxyEvaluator);
+			if (nextSpatialStructureId === null || usesAuthoredCivilHierarchy && state.civilParent !== "bridge-part") return (0, brepjs.err)(specError(usesAuthoredCivilHierarchy ? "FAMILIES_INVALID_CIVIL_HIERARCHY" : "FAMILIES_NO_STOREY", usesAuthoredCivilHierarchy ? `familiesToBim: physical product '${el.keyPath}' needs a Bridge Part ancestor` : `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
+			const added = addProxyElement(model, el, options.proxyEvaluator, state.projectedSpatialTranslation);
 			if (!added.ok) return added;
-			model.placeIn(added.value, containerId);
+			model.placeIn(added.value, nextSpatialStructureId);
 			idByKeyPath.set(el.keyPath, added.value);
 			proxied.push({
 				keyPath: el.keyPath,
@@ -28007,13 +28806,25 @@ function familiesToBim(root, options) {
 			proxiedHere = true;
 		}
 		for (const child of el.children) {
-			if ((archetype === "wall" || proxiedHere) && child.type === "Opening") continue;
-			const r = walk(child, containerId, rotatedHere);
+			if ((effectiveArchetype === "wall" || proxiedHere) && child.type === "Opening") continue;
+			const r = walk(child, {
+				spatialStructureId: nextSpatialStructureId,
+				civilParent: nextCivilParent,
+				rotated: rotatedHere,
+				cumulativeTranslation: cumulativeTranslationHere,
+				projectedSpatialTranslation: nextProjectedSpatialTranslation
+			});
 			if (!r.ok) return r;
 		}
 		return (0, brepjs.ok)(void 0);
 	};
-	const walked = walk(root, null, false);
+	const walked = walk(root, {
+		spatialStructureId: usesAuthoredCivilHierarchy ? projectId : null,
+		civilParent: "project",
+		rotated: false,
+		cumulativeTranslation: ZERO_TRANSLATION,
+		projectedSpatialTranslation: ZERO_TRANSLATION
+	});
 	if (!walked.ok) {
 		model[Symbol.dispose]();
 		return walked;
@@ -28069,6 +28880,8 @@ exports.measureTypeFor = measureTypeFor;
 exports.newIfcGuid = newIfcGuid;
 exports.parseBcfFiles = parseBcfFiles;
 exports.parseBeamSpec = parseBeamSpec;
+exports.parseBridgePartSpec = parseBridgePartSpec;
+exports.parseBridgeSpec = parseBridgeSpec;
 exports.parseColumnSpec = parseColumnSpec;
 exports.parseCoveringSpec = parseCoveringSpec;
 exports.parseCurtainWallSpec = parseCurtainWallSpec;