brepjs-bim 0.3.1 → 0.5.0

package/dist/brepjs-bim.js

@@ -4,7 +4,7 @@ import { Handle, IfcAPI } from "web-ifc";
 //#region src/identity/ifcGuid.ts
 var IFC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
 function newIfcGuid() {
-	const bytes = crypto.getRandomValues(new Uint8Array(16));
+	const bytes = crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
 	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
 	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
 	return encodeIfcGuid(bytes);
@@ -46,7 +46,7 @@ function fnv1a(text) {
 }
 function digest16(stableKey) {
 	const seed = `${NAMESPACE}::${stableKey}`;
-	const bytes = new Uint8Array(16);
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
 	for (let block = 0; block < 4; block++) {
 		const h = fnv1a(`b${block}:${seed}`);
 		bytes[block * 4 + 0] = h >>> 24 & 255;
@@ -183,7 +183,7 @@ function fromBrepError(inner, code, message) {
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.133.0/helpers/esm/usingCtx.js
+//#region \0@oxc-project+runtime@0.143.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -270,7 +270,8 @@ function wallToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "WALL_PROFILE_FAILED", "Failed to create wall profile"));
-		const solidResult = extrude(_usingCtx$19.u(profileResult.value), [
+		const profile = _usingCtx$19.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			length,
 			0,
 			0
@@ -320,7 +321,8 @@ function slabToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "SLAB_PROFILE_FAILED", "Failed to create slab profile"));
-		const solidResult = extrude(_usingCtx$18.u(profileResult.value), [
+		const profile = _usingCtx$18.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			thickness
@@ -414,7 +416,6 @@ function cached(getter) {
 			Object.defineProperty(this, "value", { value });
 			return value;
 		}
-		throw new Error("cached value already set");
 	} };
 }
 function nullish(input) {
@@ -460,7 +461,10 @@ function assignProp(target, prop, value) {
 }
 function mergeDefs(...defs) {
 	const mergedDescriptors = {};
-	for (const def of defs) Object.assign(mergedDescriptors, Object.getOwnPropertyDescriptors(def));
+	for (const def of defs) {
+		const descriptors = Object.getOwnPropertyDescriptors(def);
+		Object.assign(mergedDescriptors, descriptors);
+	}
 	return Object.defineProperties({}, mergedDescriptors);
 }
 function esc(str) {
@@ -782,7 +786,7 @@ var _parse = (_Err) => (schema, value, _ctx, _params) => {
 	}, ctx);
 	if (result instanceof Promise) throw new $ZodAsyncError();
 	if (result.issues.length) {
-		const e = new (_params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((_params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, _params?.callee);
 		throw e;
 	}
@@ -799,7 +803,7 @@ var _parseAsync = (_Err) => async (schema, value, _ctx, params) => {
 	}, ctx);
 	if (result instanceof Promise) result = await result;
 	if (result.issues.length) {
-		const e = new (params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, params?.callee);
 		throw e;
 	}
@@ -966,8 +970,10 @@ var $ZodCheckLessThan = /*@__PURE__*/ $constructor("$ZodCheckLessThan", (inst, d
 	inst._zod.onattach.push((inst) => {
 		const bag = inst._zod.bag;
 		const curr = (def.inclusive ? bag.maximum : bag.exclusiveMaximum) ?? Number.POSITIVE_INFINITY;
-		if (def.value < curr) if (def.inclusive) bag.maximum = def.value;
-		else bag.exclusiveMaximum = def.value;
+		if (def.value < curr) {
+			if (def.inclusive) bag.maximum = def.value;
+			else bag.exclusiveMaximum = def.value;
+		}
 	});
 	inst._zod.check = (payload) => {
 		if (def.inclusive ? payload.value <= def.value : payload.value < def.value) return;
@@ -988,8 +994,10 @@ var $ZodCheckGreaterThan = /*@__PURE__*/ $constructor("$ZodCheckGreaterThan", (i
 	inst._zod.onattach.push((inst) => {
 		const bag = inst._zod.bag;
 		const curr = (def.inclusive ? bag.minimum : bag.exclusiveMinimum) ?? Number.NEGATIVE_INFINITY;
-		if (def.value > curr) if (def.inclusive) bag.minimum = def.value;
-		else bag.exclusiveMinimum = def.value;
+		if (def.value > curr) {
+			if (def.inclusive) bag.minimum = def.value;
+			else bag.exclusiveMinimum = def.value;
+		}
 	});
 	inst._zod.check = (payload) => {
 		if (def.inclusive ? payload.value >= def.value : payload.value > def.value) return;
@@ -2522,7 +2530,7 @@ var $ZodOptional = /*@__PURE__*/ $constructor("$ZodOptional", (inst, def) => {
 	inst._zod.optin = "optional";
 	inst._zod.optout = "optional";
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, void 0]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, void 0]) : void 0;
 	});
 	defineLazy(inst._zod, "pattern", () => {
 		const pattern = def.innerType._zod.pattern;
@@ -2556,7 +2564,7 @@ var $ZodNullable = /*@__PURE__*/ $constructor("$ZodNullable", (inst, def) => {
 		return pattern ? new RegExp(`^(${cleanRegex(pattern.source)}|null)$`) : void 0;
 	});
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, null]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, null]) : void 0;
 	});
 	inst._zod.parse = (payload, ctx) => {
 		if (payload.value === null) return payload;
@@ -3490,8 +3498,10 @@ function finalize$1(ctx, schema) {
 			defs[seen.defId] = seen.def;
 		}
 	}
-	if (ctx.external) {} else if (Object.keys(defs).length > 0) if (ctx.target === "draft-2020-12") result.$defs = defs;
-	else result.definitions = defs;
+	if (ctx.external) {} else if (Object.keys(defs).length > 0) {
+		if (ctx.target === "draft-2020-12") result.$defs = defs;
+		else result.definitions = defs;
+	}
 	try {
 		const finalized = JSON.parse(JSON.stringify(result));
 		Object.defineProperty(finalized, "~standard", {
@@ -3604,16 +3614,18 @@ var numberProcessor = (schema, ctx, _json, _params) => {
 	const exMin = typeof exclusiveMinimum === "number" && exclusiveMinimum >= (minimum ?? Number.NEGATIVE_INFINITY);
 	const exMax = typeof exclusiveMaximum === "number" && exclusiveMaximum <= (maximum ?? Number.POSITIVE_INFINITY);
 	const legacy = ctx.target === "draft-04" || ctx.target === "openapi-3.0";
-	if (exMin) if (legacy) {
-		json.minimum = exclusiveMinimum;
-		json.exclusiveMinimum = true;
-	} else json.exclusiveMinimum = exclusiveMinimum;
-	else if (typeof minimum === "number") json.minimum = minimum;
-	if (exMax) if (legacy) {
-		json.maximum = exclusiveMaximum;
-		json.exclusiveMaximum = true;
-	} else json.exclusiveMaximum = exclusiveMaximum;
-	else if (typeof maximum === "number") json.maximum = maximum;
+	if (exMin) {
+		if (legacy) {
+			json.minimum = exclusiveMinimum;
+			json.exclusiveMinimum = true;
+		} else json.exclusiveMinimum = exclusiveMinimum;
+	} else if (typeof minimum === "number") json.minimum = minimum;
+	if (exMax) {
+		if (legacy) {
+			json.maximum = exclusiveMaximum;
+			json.exclusiveMaximum = true;
+		} else json.exclusiveMaximum = exclusiveMaximum;
+	} else if (typeof maximum === "number") json.maximum = maximum;
 	if (typeof multipleOf === "number") json.multipleOf = multipleOf;
 };
 var booleanProcessor = (_schema, _ctx, json, _params) => {
@@ -3634,9 +3646,10 @@ var literalProcessor = (schema, ctx, json, _params) => {
 	const vals = [];
 	for (const val of def.values) if (val === void 0) {
 		if (ctx.unrepresentable === "throw") throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-	} else if (typeof val === "bigint") if (ctx.unrepresentable === "throw") throw new Error("BigInt literals cannot be represented in JSON Schema");
-	else vals.push(Number(val));
-	else vals.push(val);
+	} else if (typeof val === "bigint") {
+		if (ctx.unrepresentable === "throw") throw new Error("BigInt literals cannot be represented in JSON Schema");
+		else vals.push(Number(val));
+	} else vals.push(val);
 	if (vals.length === 0) {} else if (vals.length === 1) {
 		const val = vals[0];
 		json.type = val === null ? "null" : typeof val;
@@ -5051,7 +5064,7 @@ function extendedProfileToFace(profile) {
 }
 //#endregion
 //#region src/specs/profile.ts
-var EXTENDED_PROFILE_KIND_SET = new Set([
+var EXTENDED_PROFILE_KIND_SET = /* @__PURE__ */ new Set([
 	"L_SHAPE",
 	"T_SHAPE",
 	"U_SHAPE",
@@ -5275,7 +5288,7 @@ function profileToPolygon(profile, circleSegments = 32) {
 		case "RECTANGULAR": {
 			const halfW = profile.width / 2;
 			const halfH = profile.height / 2;
-			return ok([
+			const pts = [
 				[
 					-halfW,
 					-halfH,
@@ -5296,7 +5309,8 @@ function profileToPolygon(profile, circleSegments = 32) {
 					halfH,
 					0
 				]
-			]);
+			];
+			return ok(pts);
 		}
 		case "CIRCULAR": {
 			if (circleSegments < 3) return err(specError("PROFILE_CIRCLE_SEGMENTS", `profileToPolygon: circleSegments must be >= 3, got ${circleSegments}`));
@@ -5331,7 +5345,7 @@ function profileToPolygon(profile, circleSegments = 32) {
 				[-halfW, -flangeInnerY]
 			];
 			const r = profile.filletRadius ?? 0;
-			const rootCorners = new Set([
+			const rootCorners = /* @__PURE__ */ new Set([
 				3,
 				4,
 				9,
@@ -5373,13 +5387,15 @@ function beamToSolid(spec) {
 			var _usingCtx3 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return err(faceResult.error);
-			const prismResult = extrude(_usingCtx3.u(faceResult.value), [
+			const face = _usingCtx3.u(faceResult.value);
+			const prismResult = extrude(face, [
 				0,
 				0,
 				spec.length
 			]);
 			if (!prismResult.ok) return err(fromBrepError(prismResult.error, "BEAM_EXTRUDE_FAILED", "Failed to extrude beam profile"));
-			const solid = rotate(_usingCtx3.u(prismResult.value), 90, { axis: [
+			const prism = _usingCtx3.u(prismResult.value);
+			const solid = rotate(prism, 90, { axis: [
 				0,
 				1,
 				0
@@ -5396,13 +5412,15 @@ function beamToSolid(spec) {
 		}
 		const profilePtsResult = profileToPolygon(spec.profile);
 		if (!profilePtsResult.ok) return err(profilePtsResult.error);
-		const profileResult = polygon(profilePtsResult.value.map(([px, py]) => [
+		const profilePts = profilePtsResult.value.map(([px, py]) => [
 			0,
 			px,
 			py
-		]));
+		]);
+		const profileResult = polygon(profilePts);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "BEAM_PROFILE_FAILED", "Failed to create beam profile"));
-		const solidResult = extrude(_usingCtx$16.u(profileResult.value), [
+		const profile = _usingCtx$16.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			spec.length,
 			0,
 			0
@@ -5430,7 +5448,8 @@ function columnToSolid(spec) {
 			var _usingCtx3 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return err(faceResult.error);
-			const extResult = extrude(_usingCtx3.u(faceResult.value), [
+			const face = _usingCtx3.u(faceResult.value);
+			const extResult = extrude(face, [
 				0,
 				0,
 				spec.height
@@ -5452,7 +5471,8 @@ function columnToSolid(spec) {
 		const profilePts = profilePtsResult.value;
 		const profileResult = polygon(profilePts);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "COLUMN_PROFILE_FAILED", "Failed to create column profile"));
-		const solidResult = extrude(_usingCtx$15.u(profileResult.value), [
+		const profile = _usingCtx$15.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			spec.height
@@ -5472,7 +5492,7 @@ function columnToSolid(spec) {
 }
 //#endregion
 //#region src/elementFns/openingFns.ts
-var EPSILON_MM$1 = 1;
+var EPSILON_MM = 1;
 function openingToSolid(spec, wallThickness) {
 	try {
 		var _usingCtx$14 = _usingCtx();
@@ -5481,7 +5501,7 @@ function openingToSolid(spec, wallThickness) {
 		if (wallThickness <= 0) return err(specError("OPENING_ZERO_WALL_THICKNESS", "Wall thickness must be positive"));
 		const x0 = spec.offsetAlongWall;
 		const yLow = -1;
-		const yHigh = wallThickness + EPSILON_MM$1;
+		const yHigh = wallThickness + EPSILON_MM;
 		const zLow = spec.offsetFromFloor;
 		const zHigh = spec.offsetFromFloor + spec.height;
 		const profileResult = polygon([
@@ -5507,7 +5527,8 @@ function openingToSolid(spec, wallThickness) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "OPENING_PROFILE_FAILED", "Failed to create opening profile"));
-		const solidResult = extrude(_usingCtx$14.u(profileResult.value), [
+		const profile = _usingCtx$14.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			spec.width,
 			0,
 			0
@@ -5527,7 +5548,6 @@ function openingToSolid(spec, wallThickness) {
 }
 //#endregion
 //#region src/elementFns/slabOpeningFns.ts
-var EPSILON_MM = 1;
 function slabOpeningToSolid(spec, slabThickness) {
 	try {
 		var _usingCtx$13 = _usingCtx();
@@ -5562,10 +5582,11 @@ function slabOpeningToSolid(spec, slabThickness) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "SLAB_OPENING_PROFILE_FAILED", "Failed to create slab opening profile"));
-		const solidResult = extrude(_usingCtx$13.u(profileResult.value), [
+		const profile = _usingCtx$13.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
-			slabThickness + 2 * EPSILON_MM
+			slabThickness + 2
 		]);
 		if (!solidResult.ok) return err(fromBrepError(solidResult.error, "SLAB_OPENING_EXTRUDE_FAILED", "Failed to extrude slab opening profile"));
 		const solid = solidResult.value;
@@ -5612,7 +5633,8 @@ function spaceToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "SPACE_PROFILE_FAILED", "Failed to create space footprint"));
-		const solidResult = extrude(_usingCtx$12.u(profileResult.value), [
+		const profile = _usingCtx$12.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			height
@@ -5667,7 +5689,8 @@ function flatRoof(spec) {
 			]
 		]);
 		if (!face.ok) return err(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create roof profile"));
-		const solid = extrude(_usingCtx$11.u(face.value), [
+		const profile = _usingCtx$11.u(face.value);
+		const solid = extrude(profile, [
 			0,
 			0,
 			thickness
@@ -5708,7 +5731,8 @@ function shedRoof(spec, pitch) {
 			]
 		]);
 		if (!face.ok) return err(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create shed profile"));
-		const solid = extrude(_usingCtx3.u(face.value), [
+		const profile = _usingCtx3.u(face.value);
+		const solid = extrude(profile, [
 			length,
 			0,
 			0
@@ -5754,7 +5778,8 @@ function gableRoof(spec, pitch) {
 			]
 		]);
 		if (!face.ok) return err(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create gable profile"));
-		const solid = extrude(_usingCtx4.u(face.value), [
+		const profile = _usingCtx4.u(face.value);
+		const solid = extrude(profile, [
 			length,
 			0,
 			0
@@ -5895,7 +5920,8 @@ function boxSolid(sizeX, sizeY, sizeZ) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "CURTAIN_WALL_PROFILE_FAILED", "Failed to create component profile"));
-		const solidResult = extrude(_usingCtx$10.u(profileResult.value), [
+		const profile = _usingCtx$10.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			sizeZ
@@ -6037,7 +6063,8 @@ function footingToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "FOOTING_PROFILE_FAILED", "Failed to create footing profile"));
-		const solidResult = extrude(_usingCtx$9.u(profileResult.value), [
+		const profile = _usingCtx$9.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			thickness
@@ -6063,7 +6090,8 @@ function pileToSolid(spec) {
 			var _usingCtx4 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return err(faceResult.error);
-			const extResult = extrude(_usingCtx4.u(faceResult.value), [
+			const face = _usingCtx4.u(faceResult.value);
+			const extResult = extrude(face, [
 				0,
 				0,
 				spec.length
@@ -6085,7 +6113,8 @@ function pileToSolid(spec) {
 		const profilePts = profilePtsResult.value;
 		const profileResult = polygon(profilePts);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "PILE_PROFILE_FAILED", "Failed to create pile profile"));
-		const solidResult = extrude(_usingCtx3.u(profileResult.value), [
+		const profile = _usingCtx3.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			spec.length
@@ -6132,7 +6161,8 @@ function panelRailing(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "RAILING_PROFILE_FAILED", "Failed to create railing profile"));
-		const solidResult = extrude(_usingCtx$8.u(profileResult.value), [
+		const profile = _usingCtx$8.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			length,
 			0,
 			0
@@ -6238,7 +6268,8 @@ function coveringToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "COVERING_PROFILE_FAILED", "Failed to create covering profile"));
-		const solidResult = extrude(_usingCtx$7.u(profileResult.value), [
+		const profile = _usingCtx$7.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			0,
 			thickness
@@ -6265,6 +6296,7 @@ var BimModel = class {
 	#counter = makeLocalIdCounter();
 	#projectId = null;
 	#modelScope = "";
+	#usedStableKeys = /* @__PURE__ */ new Set();
 	init(spec) {
 		if (this.#projectId !== null) return err(specError("DUPLICATE_PROJECT", "BimModel.init() called twice — only one project per model"));
 		this.#modelScope = spec.projectId ?? `${spec.name}::${spec.description ?? ""}`;
@@ -6282,24 +6314,43 @@ var BimModel = class {
 	addSite(spec) {
 		return this.#makeElement("SITE", spec, null);
 	}
-	addBuilding(spec) {
-		return this.#makeElement("BUILDING", spec, null);
-	}
-	addStorey(spec) {
-		return this.#makeElement("STOREY", spec, null);
-	}
-	addWall(spec) {
+	addBuilding(spec, options) {
+		return this.#makeElement("BUILDING", spec, null, options?.stableKey);
+	}
+	addStorey(spec, options) {
+		return this.#makeElement("STOREY", spec, null, options?.stableKey);
+	}
+	/** Reject a duplicate stableKey BEFORE any geometry is built, so the
+	*  Result-returning adders never allocate a solid they cannot store. */
+	#checkStableKey(options) {
+		const key = options?.stableKey;
+		if (key !== void 0 && this.#usedStableKeys.has(key)) return err(specError("DUPLICATE_STABLE_KEY", `BimModel: duplicate stableKey '${key}'`));
+		return ok(void 0);
+	}
+	#checkOpeningKeys(options) {
+		const filler = this.#checkStableKey(options);
+		if (!filler.ok) return filler;
+		const opening = this.#checkStableKey({ stableKey: options?.openingStableKey });
+		if (!opening.ok) return opening;
+		if (options?.stableKey !== void 0 && options.stableKey === options.openingStableKey) return err(specError("DUPLICATE_STABLE_KEY", `BimModel: stableKey and openingStableKey are both '${options.stableKey}'`));
+		return ok(void 0);
+	}
+	addWall(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = wallToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("WALL", spec, geomResult.value);
+		const id = this.#makeElement("WALL", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addSlab(spec) {
+	addSlab(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = slabToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("SLAB", spec, geomResult.value);
+		const id = this.#makeElement("SLAB", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6575,7 +6626,9 @@ var BimModel = class {
 		});
 		return ok(id);
 	}
-	addDoor(spec) {
+	addDoor(spec, options) {
+		const keyCheck = this.#checkOpeningKeys(options);
+		if (!keyCheck.ok) return keyCheck;
 		const wall = this.#elements.get(spec.wallLocalId);
 		if (wall === void 0 || wall.category !== "WALL") return err(specError("DOOR_WALL_NOT_FOUND", `No wall found for localId ${spec.wallLocalId}`));
 		if (spec.offsetAlongWall + spec.width > wall.spec.length) return err(specError("DOOR_EXCEEDS_WALL_BOUNDS", "Door (offsetAlongWall + width) exceeds wall length"));
@@ -6590,13 +6643,13 @@ var BimModel = class {
 		const cutResult = this.#cutWallGeometry(wall, openingSpec);
 		if (!cutResult.ok) return err(cutResult.error);
 		this.#replaceWallGeometry(wall, cutResult.value);
-		const openingId = this.#makeElement("OPENING", openingSpec, null);
+		const openingId = this.#makeElement("OPENING", openingSpec, null, options?.openingStableKey);
 		this.#makeRel({
 			kind: "VOIDS_WALL",
 			wallLocalId: spec.wallLocalId,
 			openingLocalId: openingId
 		});
-		const doorId = this.#makeElement("DOOR", spec, null);
+		const doorId = this.#makeElement("DOOR", spec, null, options?.stableKey);
 		this.#makeRel({
 			kind: "FILLS_OPENING",
 			openingLocalId: openingId,
@@ -6609,7 +6662,9 @@ var BimModel = class {
 		});
 		return ok(doorId);
 	}
-	addWindow(spec) {
+	addWindow(spec, options) {
+		const keyCheck = this.#checkOpeningKeys(options);
+		if (!keyCheck.ok) return keyCheck;
 		const wall = this.#elements.get(spec.wallLocalId);
 		if (wall === void 0 || wall.category !== "WALL") return err(specError("WINDOW_WALL_NOT_FOUND", `No wall found for localId ${spec.wallLocalId}`));
 		if (spec.offsetAlongWall + spec.width > wall.spec.length) return err(specError("WINDOW_EXCEEDS_WALL_BOUNDS", "Window (offsetAlongWall + width) exceeds wall length"));
@@ -6624,13 +6679,13 @@ var BimModel = class {
 		const cutResult = this.#cutWallGeometry(wall, openingSpec);
 		if (!cutResult.ok) return err(cutResult.error);
 		this.#replaceWallGeometry(wall, cutResult.value);
-		const openingId = this.#makeElement("OPENING", openingSpec, null);
+		const openingId = this.#makeElement("OPENING", openingSpec, null, options?.openingStableKey);
 		this.#makeRel({
 			kind: "VOIDS_WALL",
 			wallLocalId: spec.wallLocalId,
 			openingLocalId: openingId
 		});
-		const windowId = this.#makeElement("WINDOW", spec, null);
+		const windowId = this.#makeElement("WINDOW", spec, null, options?.stableKey);
 		this.#makeRel({
 			kind: "FILLS_OPENING",
 			openingLocalId: openingId,
@@ -6643,7 +6698,9 @@ var BimModel = class {
 		});
 		return ok(windowId);
 	}
-	addSlabOpening(input) {
+	addSlabOpening(input, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const slab = this.#elements.get(input.slabLocalId);
 		if (slab === void 0 || slab.category !== "SLAB") return err(specError("SLAB_OPENING_SLAB_NOT_FOUND", `No slab found for localId ${input.slabLocalId}`));
 		if (input.offsetX + input.sizeX > slab.spec.length) return err(specError("SLAB_OPENING_EXCEEDS_SLAB_BOUNDS", "Opening (offsetX + sizeX) exceeds slab length"));
@@ -6673,7 +6730,7 @@ var BimModel = class {
 		const cutResult = this.#cutSlabGeometry(slab, openingSpec);
 		if (!cutResult.ok) return err(cutResult.error);
 		this.#replaceSlabGeometry(slab, cutResult.value);
-		const openingId = this.#makeElement("OPENING", openingSpec, null);
+		const openingId = this.#makeElement("OPENING", openingSpec, null, options?.stableKey);
 		this.#makeRel({
 			kind: "VOIDS_SLAB",
 			slabLocalId: input.slabLocalId,
@@ -6918,10 +6975,14 @@ var BimModel = class {
 	getAllRelationships() {
 		return [...this.#relationships.values()];
 	}
-	#makeElement(category, spec, geometry) {
+	#makeElement(category, spec, geometry, stableKey) {
 		const localId = this.#counter.next();
+		if (stableKey !== void 0) {
+			if (this.#usedStableKeys.has(stableKey)) throw new Error(`BimModel: duplicate stableKey '${stableKey}'`);
+			this.#usedStableKeys.add(stableKey);
+		}
 		const el = {
-			guid: deriveIfcGuidSync(makeElementKey(this.#modelScope, category, localId)),
+			guid: deriveIfcGuidSync(stableKey !== void 0 ? `elem:${this.#modelScope}:${stableKey}` : makeElementKey(this.#modelScope, category, localId)),
 			localId,
 			category,
 			spec,
@@ -7168,9 +7229,11 @@ function stairFlightToSolid(spec) {
 		if (spec.riserHeight <= 0) return err(specError("STAIR_FLIGHT_ZERO_RISER", "Stair flight riserHeight must be positive"));
 		if (spec.treadLength <= 0) return err(specError("STAIR_FLIGHT_ZERO_TREAD", "Stair flight treadLength must be positive"));
 		if (!Number.isInteger(spec.numberOfRisers) || spec.numberOfRisers < 1) return err(specError("STAIR_FLIGHT_BAD_RISERS", "Stair flight numberOfRisers must be a positive integer"));
-		const profileResult = polygon(buildSilhouette$1(spec.numberOfRisers, spec.riserHeight, spec.treadLength));
+		const silhouette = buildSilhouette$1(spec.numberOfRisers, spec.riserHeight, spec.treadLength);
+		const profileResult = polygon(silhouette);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "STAIR_FLIGHT_PROFILE_FAILED", "Failed to create stair flight silhouette profile"));
-		const solidResult = extrude(_usingCtx$5.u(profileResult.value), [
+		const profile = _usingCtx$5.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			spec.width,
 			0
@@ -7326,7 +7389,7 @@ function isIfcSchema(value) {
 * linear-infrastructure entities). Entities absent from every per-schema set are
 * treated as schema-agnostic and supported everywhere (open-world default).
 */
-var IFC4X3_ONLY_ENTITIES = new Set([
+var IFC4X3_ONLY_ENTITIES = /* @__PURE__ */ new Set([
 	"IfcAlignment",
 	"IfcAlignmentHorizontal",
 	"IfcAlignmentVertical",
@@ -7406,7 +7469,8 @@ var IfcWriter = class IfcWriter {
 		try {
 			const api = new IfcAPI();
 			await initIfcApi(api);
-			return ok(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition, header));
+			const modelId = api.CreateModel({ schema: fileSchemaString(ifcSchema) });
+			return ok(new IfcWriter(api, modelId, mvdViewDefinition, header));
 		} catch (e) {
 			return err(ifcError("IFC_INIT_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -7460,8 +7524,10 @@ var IfcWriter = class IfcWriter {
 		let head = new TextDecoder().decode(bytes.subarray(0, HEADER_SCAN));
 		if (FILE_NAME_RE.test(head)) head = head.replace(FILE_NAME_RE, (_m, prefix, systems) => `${prefix}(${stepString(this.#author)}),(${stepString(this.#organization)}),${systems},${stepString("")})`);
 		else console.warn("IfcWriter: FILE_NAME null-field pattern not found; author/organization/authorization left unpatched");
-		if (this.#mvdViewDefinition.length > 0) if (VIEW_DEFINITION_RE.test(head)) head = head.replace(VIEW_DEFINITION_RE, `ViewDefinition [${this.#mvdViewDefinition}]`);
-		else console.warn(`IfcWriter: FILE_DESCRIPTION ViewDefinition not found; MVD "${this.#mvdViewDefinition}" not declared`);
+		if (this.#mvdViewDefinition.length > 0) {
+			if (VIEW_DEFINITION_RE.test(head)) head = head.replace(VIEW_DEFINITION_RE, `ViewDefinition [${this.#mvdViewDefinition}]`);
+			else console.warn(`IfcWriter: FILE_DESCRIPTION ViewDefinition not found; MVD "${this.#mvdViewDefinition}" not declared`);
+		}
 		const patchedHeadBytes = new TextEncoder().encode(head);
 		const tail = bytes.subarray(HEADER_SCAN);
 		const out = new Uint8Array(patchedHeadBytes.byteLength + tail.byteLength);
@@ -9380,9 +9446,11 @@ function rampFlightToSolid(spec) {
 		if (spec.slope <= 0) return err(specError("RAMP_FLIGHT_ZERO_SLOPE", "Ramp flight slope must be positive"));
 		if (spec.thickness <= 0) return err(specError("RAMP_FLIGHT_ZERO_THICKNESS", "Ramp flight thickness must be positive"));
 		const rise = spec.length * spec.slope;
-		const profileResult = polygon(buildSilhouette(spec.length, rise, spec.thickness));
+		const silhouette = buildSilhouette(spec.length, rise, spec.thickness);
+		const profileResult = polygon(silhouette);
 		if (!profileResult.ok) return err(fromBrepError(profileResult.error, "RAMP_FLIGHT_PROFILE_FAILED", "Failed to create ramp flight silhouette profile"));
-		const solidResult = extrude(_usingCtx$3.u(profileResult.value), [
+		const profile = _usingCtx$3.u(profileResult.value);
+		const solidResult = extrude(profile, [
 			0,
 			spec.width,
 			0
@@ -11708,7 +11776,7 @@ function isSlabOpening(spec) {
 * instead, and OPENINGs are tied to their host through VOIDS rels — neither
 * participates in containment, so excluding them here avoids false orphans.
 */
-var CONTAINABLE_CATEGORIES = new Set([
+var CONTAINABLE_CATEGORIES = /* @__PURE__ */ new Set([
 	"WALL",
 	"SLAB",
 	"BEAM",
@@ -12505,14 +12573,15 @@ async function toIfcValidated(model, meta) {
 	const geometry = collectGeometryIssues(model);
 	const schema = await checkSchema(bytes);
 	const roundTrip = await checkRoundTrip(bytes);
+	const report = { issues: [
+		...integrity.issues,
+		...geometry.issues,
+		...schema.issues,
+		...roundTrip.issues
+	] };
 	return ok({
 		bytes,
-		report: { issues: [
-			...integrity.issues,
-			...geometry.issues,
-			...schema.issues,
-			...roundTrip.issues
-		] }
+		report
 	});
 }
 /**
@@ -12733,7 +12802,7 @@ var SpfReader = class SpfReader {
 };
 //#endregion
 //#region src/import/spatialTree.ts
-var CATEGORY_BY_TYPE = new Map([
+var CATEGORY_BY_TYPE = /* @__PURE__ */ new Map([
 	[WebIFC.IFCPROJECT, "PROJECT"],
 	[WebIFC.IFCSITE, "SITE"],
 	[WebIFC.IFCBUILDING, "BUILDING"],
@@ -12915,7 +12984,8 @@ function reconstructExtrusion(reader, extrusionId, scale, worldTransform, diagno
 	const solidResult = (() => {
 		try {
 			var _usingCtx$1 = _usingCtx();
-			return extrude(_usingCtx$1.u(faceResult.value), extrudeVec);
+			const face = _usingCtx$1.u(faceResult.value);
+			return extrude(face, extrudeVec);
 		} catch (_) {
 			_usingCtx$1.e = _;
 		} finally {
@@ -12968,10 +13038,12 @@ function reconstructRevolution(reader, revolutionId, scale, worldTransform, diag
 	const revolved = (() => {
 		try {
 			var _usingCtx3 = _usingCtx();
-			return revolve(_usingCtx3.u(faceResult.value), {
+			const face = _usingCtx3.u(faceResult.value);
+			const angleDeg = angleRaw * readPlaneAngleScale(reader) * (180 / Math.PI);
+			return revolve(face, {
 				at: center,
 				axis: direction,
-				angle: angleRaw * readPlaneAngleScale(reader) * (180 / Math.PI)
+				angle: angleDeg
 			});
 		} catch (_) {
 			_usingCtx3.e = _;
@@ -13086,7 +13158,7 @@ function packBinaryStl(vertices, indices, scaleToMm) {
 	}
 	return new Uint8Array(buffer);
 }
-var PARAMETRIC_PROFILE_BUILDERS = new Map([
+var PARAMETRIC_PROFILE_BUILDERS = /* @__PURE__ */ new Map([
 	[WebIFC.IFCRECTANGLEPROFILEDEF, (f) => ({
 		kind: "RECTANGULAR",
 		width: f("XDim"),
@@ -13854,14 +13926,15 @@ async function fromIfc(bytes, options = {}) {
 		}
 		const report = appendIssues(emptyReport(), diagnostics);
 		const applicationName = readApplicationName(reader);
-		return ok({
+		const model = {
 			schema: reader.schema,
 			spatialTree: spatialRoot === null ? null : mapSpatialNode(spatialRoot),
 			elements,
 			byExpressId,
 			diagnostics: report,
 			...applicationName !== void 0 ? { applicationName } : {}
-		});
+		};
+		return ok(model);
 	} catch (e) {
 		return err(importError("IMPORT_FAILED", "Unexpected failure during IFC import", e));
 	} finally {
@@ -14888,7 +14961,7 @@ function parseSlabOpeningInput(input) {
 * containers (PROJECT/SITE/BUILDING/STOREY), abstract groupings, and the SPACE
 * category (which maps to the Space sheet, not Component) are excluded.
 */
-var COMPONENT_CATEGORIES = new Set([
+var COMPONENT_CATEGORIES = /* @__PURE__ */ new Set([
 	"WALL",
 	"SLAB",
 	"BEAM",
@@ -15513,9 +15586,10 @@ function parseIdsXml(xml) {
 	const title = info ? firstChild(info, "title")?.text ?? "" : "";
 	const specsContainer = firstChild(root, "specifications");
 	if (specsContainer === void 0) return err(idsError("IDS_INVALID_SCHEMA", "IDS document has no <specifications> element"));
+	const specifications = childrenNamed(specsContainer, "specification").map(parseSpecification);
 	return ok({
 		title,
-		specifications: childrenNamed(specsContainer, "specification").map(parseSpecification)
+		specifications
 	});
 }
 function parseSpecification(el) {
@@ -15872,10 +15946,7 @@ function restrictionsOf(facet) {
 			push(facet.system);
 			push(facet.value);
 			break;
-		case "Material":
-			push(facet.value);
-			break;
-		case "PartOf": break;
+		case "Material": push(facet.value);
 	}
 	return out;
 }
@@ -16275,7 +16346,8 @@ function parseBcfFiles(files) {
 			topics
 		});
 	} catch (cause) {
-		return err(bcfError("BCF_PARSE_FAILED", `Failed to parse BCF container: ${cause instanceof Error ? cause.message : String(cause)}`, cause));
+		const message = cause instanceof Error ? cause.message : String(cause);
+		return err(bcfError("BCF_PARSE_FAILED", `Failed to parse BCF container: ${message}`, cause));
 	}
 }
 function parseVersion(xml) {
@@ -16390,4 +16462,208 @@ function assignNum(target, key, value) {
 	if (value !== void 0) target[key] = Number(value);
 }
 //#endregion
-export { BimModel, DEFAULT_IFC_SCHEMA, DEFAULT_UNITS, IFC_SCHEMAS, PSET_PROPERTY_TYPE_TABLE, PSET_TEMPLATES, SpfReader, bcfError, checkGeometryValidity, checkModelAgainstIds as checkIds, checkModelAgainstIds, checkReferentialIntegrity, checkRoundTrip, checkSchema, countBySeverity, deriveCobieModel, deriveCobieModel as exportCobie, deriveIfcGuid, deriveIfcGuidSync, disposeImportedModel, emptyReport, extendedProfileArea, extendedProfileToFace, fileSchemaString, fromBrepError, fromIfc, geometryError, hasErrors, idsError, ifcError, importError, isExtendedProfile, isIfcSchema, isSlabOpening, isValidIfcGuid, isWallOpening, issue, makeLocalIdCounter, measureTypeFor, newIfcGuid, parseBcfFiles, parseBeamSpec, parseColumnSpec, parseCoveringSpec, parseCurtainWallSpec, parseDoorSpec, parseElementAssemblySpec, parseFootingSpec, parseIdsXml, parsePileSpec, parseProfile, parseRailingSpec, parseRampFlightSpec, parseRampSpec, parseRoofSpec, parseSlabOpeningInput, parseSlabSpec, parseSpaceSpec, parseStairFlightSpec, parseStairSpec, parseSurfaceStyleSpec, parseSystemSpec, parseWallSpec, parseWindowSpec, parseZoneSpec, placedSolids, schemaSupports, serializeBcfFiles, serializeCobieToCsv, serializeCobieToJson, setIfcWasmLocateFile, specError, templateFor, toIfc, toIfcLengthM, toIfcValidated, toLengthMm, writeClassificationRefs, writeElementAssemblyEntity, writeIfcType, writeMaterialLayerSet, writeMaterialProfileSet, writeMaterialSimple, writePresentationLayer, writeRelAggregatesElements, writeRelAssignsToGroup, writeRelConnectsElements, writeRelConnectsPathElements, writeRelNests, writeStyledItem, writeSurfaceStyle, writeSystemEntity, writeZoneEntity };
+//#region src/familiesAdapter.ts
+/**
+* brepjs-families -> BimModel adapter. Consumes a resolved element tree and
+* feeds each element's PRE-DESUGARED props into the parametric specs — the
+* spec path stays authoritative for IFC (IfcExtrudedAreaSolid + placement),
+* 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 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 stay IR-only and never reach the spec path.
+*/
+var SPEC_DEFAULTS = {
+	origin: [
+		0,
+		0,
+		0
+	],
+	axisX: [
+		1,
+		0,
+		0
+	],
+	axisZ: [
+		0,
+		0,
+		1
+	],
+	materialName: "Default"
+};
+var GEOMETRY_PROPS = /* @__PURE__ */ new Set([
+	"voids",
+	"fuse",
+	"transform",
+	"psets"
+]);
+/** 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. */
+function peelTranslates(node) {
+	const total = [
+		0,
+		0,
+		0
+	];
+	let moved = false;
+	let cur = node;
+	while (cur.kind === "Translate") {
+		const v = cur.vector;
+		if (v.kind !== "Vec3Lit") break;
+		total[0] += v.value[0];
+		total[1] += v.value[1];
+		total[2] += v.value[2];
+		moved = true;
+		cur = cur.target;
+	}
+	return {
+		total,
+		moved
+	};
+}
+/** Fold the resolved geometry's outer translate chain into the spec placement
+*  origin, so IfcLocalPlacement matches the IR world frame no matter where the
+*  transform came from (family-internal or prop-level). */
+function composedOrigin(el) {
+	const base = el.props["origin"] ?? [
+		0,
+		0,
+		0
+	];
+	const { total, moved } = peelTranslates(el.geometry);
+	if (!moved && el.props["origin"] === void 0) return void 0;
+	return [
+		base[0] + total[0],
+		base[1] + total[1],
+		base[2] + total[2]
+	];
+}
+function stripGeometryProps(props) {
+	const out = {};
+	for (const [k, v] of Object.entries(props)) if (!GEOMETRY_PROPS.has(k)) out[k] = v;
+	return out;
+}
+function specInput(el) {
+	const origin = composedOrigin(el);
+	return {
+		...SPEC_DEFAULTS,
+		...stripGeometryProps(el.props),
+		...origin ? { origin } : {},
+		...collectSpecProps(el)
+	};
+}
+function collectSpecProps(el) {
+	const psets = el.attributes["psets"];
+	const out = {};
+	if (psets && typeof psets === "object") {
+		const common = psets["Pset_WallCommon"];
+		if (common && typeof common === "object") {
+			const c = common;
+			if (typeof c["IsExternal"] === "boolean") out["isExternal"] = c["IsExternal"];
+			if (typeof c["FireRating"] === "string") out["fireRating"] = c["FireRating"];
+		}
+	}
+	delete out["psets"];
+	return out;
+}
+function addFill(model, fill, input, identity) {
+	if (fill.type === "Door") {
+		const parsed = parseDoorSpec(input);
+		if (!parsed.ok) return parsed;
+		return model.addDoor(parsed.value, identity);
+	}
+	if (fill.type === "Window") {
+		const parsed = parseWindowSpec(input);
+		if (!parsed.ok) return parsed;
+		return model.addWindow(parsed.value, identity);
+	}
+	return err(specError("FAMILIES_UNSUPPORTED_FILL", `familiesToBim: no fill mapping for element type '${fill.type}' at '${fill.keyPath}'`));
+}
+/** 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:
+*  exact because both carry the same outer host transform. */
+function addOpenings(model, host, wallId, containerId, idByKeyPath) {
+	const hostT = peelTranslates(host.geometry).total;
+	for (const opening of host.children) {
+		if (opening.type !== "Opening") continue;
+		const fill = opening.children[0];
+		if (fill === void 0) return err(specError("FAMILIES_OPENING_NO_FILL", `familiesToBim: opening '${opening.keyPath}' has no fill element`));
+		const fillT = peelTranslates(opening.geometry).total;
+		const added = addFill(model, fill, {
+			materialName: SPEC_DEFAULTS.materialName,
+			...stripGeometryProps(fill.props),
+			wallLocalId: wallId,
+			offsetAlongWall: fillT[0] - hostT[0],
+			offsetFromFloor: fillT[2] - hostT[2]
+		}, {
+			stableKey: fill.keyPath,
+			openingStableKey: opening.keyPath
+		});
+		if (!added.ok) return added;
+		model.placeIn(added.value, containerId);
+		idByKeyPath.set(fill.keyPath, added.value);
+		const fillsRel = model.getAllRelationships().find((r) => r.kind === "FILLS_OPENING" && r.fillerLocalId === added.value);
+		if (fillsRel !== void 0) idByKeyPath.set(opening.keyPath, fillsRel.openingLocalId);
+	}
+	return ok(void 0);
+}
+/**
+* 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 model = new BimModel();
+	const initResult = model.init(options.project);
+	if (!initResult.ok) return initResult;
+	const siteId = model.addSite({ name: options.siteName ?? "Site" });
+	const buildingId = model.addBuilding({ name: options.buildingName ?? "Building" });
+	model.aggregate(siteId, buildingId);
+	const idByKeyPath = /* @__PURE__ */ new Map();
+	const walk = (el, storeyId) => {
+		let containerId = storeyId;
+		if (el.type === "Storey") {
+			const id = model.addStorey({
+				name: el.attributes["name"] ?? el.keyPath,
+				elevation: el.props["elevation"] ?? 0
+			}, { stableKey: el.keyPath });
+			model.aggregate(buildingId, id);
+			idByKeyPath.set(el.keyPath, id);
+			containerId = id;
+		} else if (el.type === "Wall" || el.type === "Slab") {
+			const parsed = el.type === "Wall" ? parseWallSpec(specInput(el)) : parseSlabSpec(specInput(el));
+			if (!parsed.ok) return parsed;
+			const added = el.type === "Wall" ? model.addWall(parsed.value, { stableKey: el.keyPath }) : model.addSlab(parsed.value, { stableKey: el.keyPath });
+			if (!added.ok) return added;
+			idByKeyPath.set(el.keyPath, added.value);
+			if (containerId === null) return err(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment`));
+			model.placeIn(added.value, containerId);
+			if (el.type === "Wall") {
+				const opened = addOpenings(model, el, added.value, containerId, idByKeyPath);
+				if (!opened.ok) return opened;
+			}
+		} else if (el.type === "Opening") return 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") return err(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}'`));
+		for (const child of el.children) {
+			if (el.type === "Wall" && child.type === "Opening") continue;
+			const r = walk(child, containerId);
+			if (!r.ok) return r;
+		}
+		return ok(void 0);
+	};
+	const walked = walk(root, null);
+	if (!walked.ok) {
+		model[Symbol.dispose]();
+		return walked;
+	}
+	return ok({
+		model,
+		idByKeyPath
+	});
+}
+//#endregion
+export { BimModel, DEFAULT_IFC_SCHEMA, DEFAULT_UNITS, IFC_SCHEMAS, PSET_PROPERTY_TYPE_TABLE, PSET_TEMPLATES, SpfReader, bcfError, checkGeometryValidity, checkModelAgainstIds as checkIds, checkModelAgainstIds, checkReferentialIntegrity, checkRoundTrip, checkSchema, countBySeverity, deriveCobieModel, deriveCobieModel as exportCobie, deriveIfcGuid, deriveIfcGuidSync, disposeImportedModel, emptyReport, extendedProfileArea, extendedProfileToFace, familiesToBim, fileSchemaString, fromBrepError, fromIfc, geometryError, hasErrors, idsError, ifcError, importError, isExtendedProfile, isIfcSchema, isSlabOpening, isValidIfcGuid, isWallOpening, issue, makeLocalIdCounter, measureTypeFor, newIfcGuid, parseBcfFiles, parseBeamSpec, parseColumnSpec, parseCoveringSpec, parseCurtainWallSpec, parseDoorSpec, parseElementAssemblySpec, parseFootingSpec, parseIdsXml, parsePileSpec, parseProfile, parseRailingSpec, parseRampFlightSpec, parseRampSpec, parseRoofSpec, parseSlabOpeningInput, parseSlabSpec, parseSpaceSpec, parseStairFlightSpec, parseStairSpec, parseSurfaceStyleSpec, parseSystemSpec, parseWallSpec, parseWindowSpec, parseZoneSpec, placedSolids, schemaSupports, serializeBcfFiles, serializeCobieToCsv, serializeCobieToJson, setIfcWasmLocateFile, specError, templateFor, toIfc, toIfcLengthM, toIfcValidated, toLengthMm, writeClassificationRefs, writeElementAssemblyEntity, writeIfcType, writeMaterialLayerSet, writeMaterialProfileSet, writeMaterialSimple, writePresentationLayer, writeRelAggregatesElements, writeRelAssignsToGroup, writeRelConnectsElements, writeRelConnectsPathElements, writeRelNests, writeStyledItem, writeSurfaceStyle, writeSystemEntity, writeZoneEntity };