brepjs-bim 0.3.1 → 0.5.0

package/dist/brepjs-bim.cjs

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
@@ -27,7 +27,7 @@ web_ifc = __toESM(web_ifc, 1);
 //#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);
@@ -69,7 +69,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;
@@ -206,7 +206,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();
@@ -293,7 +293,8 @@ function wallToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "WALL_PROFILE_FAILED", "Failed to create wall profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$19.u(profileResult.value), [
+		const profile = _usingCtx$19.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			length,
 			0,
 			0
@@ -343,7 +344,8 @@ function slabToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "SLAB_PROFILE_FAILED", "Failed to create slab profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$18.u(profileResult.value), [
+		const profile = _usingCtx$18.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			thickness
@@ -437,7 +439,6 @@ function cached(getter) {
 			Object.defineProperty(this, "value", { value });
 			return value;
 		}
-		throw new Error("cached value already set");
 	} };
 }
 function nullish(input) {
@@ -483,7 +484,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) {
@@ -805,7 +809,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;
 	}
@@ -822,7 +826,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;
 	}
@@ -989,8 +993,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;
@@ -1011,8 +1017,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;
@@ -2545,7 +2553,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;
@@ -2579,7 +2587,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;
@@ -3513,8 +3521,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", {
@@ -3627,16 +3637,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) => {
@@ -3657,9 +3669,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;
@@ -5074,7 +5087,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",
@@ -5298,7 +5311,7 @@ function profileToPolygon(profile, circleSegments = 32) {
 		case "RECTANGULAR": {
 			const halfW = profile.width / 2;
 			const halfH = profile.height / 2;
-			return (0, brepjs.ok)([
+			const pts = [
 				[
 					-halfW,
 					-halfH,
@@ -5319,7 +5332,8 @@ function profileToPolygon(profile, circleSegments = 32) {
 					halfH,
 					0
 				]
-			]);
+			];
+			return (0, brepjs.ok)(pts);
 		}
 		case "CIRCULAR": {
 			if (circleSegments < 3) return (0, brepjs.err)(specError("PROFILE_CIRCLE_SEGMENTS", `profileToPolygon: circleSegments must be >= 3, got ${circleSegments}`));
@@ -5354,7 +5368,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,
@@ -5396,13 +5410,15 @@ function beamToSolid(spec) {
 			var _usingCtx3 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return (0, brepjs.err)(faceResult.error);
-			const prismResult = (0, brepjs.extrude)(_usingCtx3.u(faceResult.value), [
+			const face = _usingCtx3.u(faceResult.value);
+			const prismResult = (0, brepjs.extrude)(face, [
 				0,
 				0,
 				spec.length
 			]);
 			if (!prismResult.ok) return (0, brepjs.err)(fromBrepError(prismResult.error, "BEAM_EXTRUDE_FAILED", "Failed to extrude beam profile"));
-			const solid = (0, brepjs.rotate)(_usingCtx3.u(prismResult.value), 90, { axis: [
+			const prism = _usingCtx3.u(prismResult.value);
+			const solid = (0, brepjs.rotate)(prism, 90, { axis: [
 				0,
 				1,
 				0
@@ -5419,13 +5435,15 @@ function beamToSolid(spec) {
 		}
 		const profilePtsResult = profileToPolygon(spec.profile);
 		if (!profilePtsResult.ok) return (0, brepjs.err)(profilePtsResult.error);
-		const profileResult = (0, brepjs.polygon)(profilePtsResult.value.map(([px, py]) => [
+		const profilePts = profilePtsResult.value.map(([px, py]) => [
 			0,
 			px,
 			py
-		]));
+		]);
+		const profileResult = (0, brepjs.polygon)(profilePts);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "BEAM_PROFILE_FAILED", "Failed to create beam profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$16.u(profileResult.value), [
+		const profile = _usingCtx$16.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			spec.length,
 			0,
 			0
@@ -5453,7 +5471,8 @@ function columnToSolid(spec) {
 			var _usingCtx3 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return (0, brepjs.err)(faceResult.error);
-			const extResult = (0, brepjs.extrude)(_usingCtx3.u(faceResult.value), [
+			const face = _usingCtx3.u(faceResult.value);
+			const extResult = (0, brepjs.extrude)(face, [
 				0,
 				0,
 				spec.height
@@ -5475,7 +5494,8 @@ function columnToSolid(spec) {
 		const profilePts = profilePtsResult.value;
 		const profileResult = (0, brepjs.polygon)(profilePts);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "COLUMN_PROFILE_FAILED", "Failed to create column profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$15.u(profileResult.value), [
+		const profile = _usingCtx$15.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			spec.height
@@ -5495,7 +5515,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();
@@ -5504,7 +5524,7 @@ function openingToSolid(spec, wallThickness) {
 		if (wallThickness <= 0) return (0, brepjs.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 = (0, brepjs.polygon)([
@@ -5530,7 +5550,8 @@ function openingToSolid(spec, wallThickness) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "OPENING_PROFILE_FAILED", "Failed to create opening profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$14.u(profileResult.value), [
+		const profile = _usingCtx$14.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			spec.width,
 			0,
 			0
@@ -5550,7 +5571,6 @@ function openingToSolid(spec, wallThickness) {
 }
 //#endregion
 //#region src/elementFns/slabOpeningFns.ts
-var EPSILON_MM = 1;
 function slabOpeningToSolid(spec, slabThickness) {
 	try {
 		var _usingCtx$13 = _usingCtx();
@@ -5585,10 +5605,11 @@ function slabOpeningToSolid(spec, slabThickness) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "SLAB_OPENING_PROFILE_FAILED", "Failed to create slab opening profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$13.u(profileResult.value), [
+		const profile = _usingCtx$13.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
-			slabThickness + 2 * EPSILON_MM
+			slabThickness + 2
 		]);
 		if (!solidResult.ok) return (0, brepjs.err)(fromBrepError(solidResult.error, "SLAB_OPENING_EXTRUDE_FAILED", "Failed to extrude slab opening profile"));
 		const solid = solidResult.value;
@@ -5635,7 +5656,8 @@ function spaceToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "SPACE_PROFILE_FAILED", "Failed to create space footprint"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$12.u(profileResult.value), [
+		const profile = _usingCtx$12.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			height
@@ -5690,7 +5712,8 @@ function flatRoof(spec) {
 			]
 		]);
 		if (!face.ok) return (0, brepjs.err)(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create roof profile"));
-		const solid = (0, brepjs.extrude)(_usingCtx$11.u(face.value), [
+		const profile = _usingCtx$11.u(face.value);
+		const solid = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			thickness
@@ -5731,7 +5754,8 @@ function shedRoof(spec, pitch) {
 			]
 		]);
 		if (!face.ok) return (0, brepjs.err)(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create shed profile"));
-		const solid = (0, brepjs.extrude)(_usingCtx3.u(face.value), [
+		const profile = _usingCtx3.u(face.value);
+		const solid = (0, brepjs.extrude)(profile, [
 			length,
 			0,
 			0
@@ -5777,7 +5801,8 @@ function gableRoof(spec, pitch) {
 			]
 		]);
 		if (!face.ok) return (0, brepjs.err)(fromBrepError(face.error, "ROOF_PROFILE_FAILED", "Failed to create gable profile"));
-		const solid = (0, brepjs.extrude)(_usingCtx4.u(face.value), [
+		const profile = _usingCtx4.u(face.value);
+		const solid = (0, brepjs.extrude)(profile, [
 			length,
 			0,
 			0
@@ -5918,7 +5943,8 @@ function boxSolid(sizeX, sizeY, sizeZ) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "CURTAIN_WALL_PROFILE_FAILED", "Failed to create component profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$10.u(profileResult.value), [
+		const profile = _usingCtx$10.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			sizeZ
@@ -6060,7 +6086,8 @@ function footingToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "FOOTING_PROFILE_FAILED", "Failed to create footing profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$9.u(profileResult.value), [
+		const profile = _usingCtx$9.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			thickness
@@ -6086,7 +6113,8 @@ function pileToSolid(spec) {
 			var _usingCtx4 = _usingCtx();
 			const faceResult = extendedProfileToFace(spec.profile);
 			if (!faceResult.ok) return (0, brepjs.err)(faceResult.error);
-			const extResult = (0, brepjs.extrude)(_usingCtx4.u(faceResult.value), [
+			const face = _usingCtx4.u(faceResult.value);
+			const extResult = (0, brepjs.extrude)(face, [
 				0,
 				0,
 				spec.length
@@ -6108,7 +6136,8 @@ function pileToSolid(spec) {
 		const profilePts = profilePtsResult.value;
 		const profileResult = (0, brepjs.polygon)(profilePts);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "PILE_PROFILE_FAILED", "Failed to create pile profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx3.u(profileResult.value), [
+		const profile = _usingCtx3.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			spec.length
@@ -6155,7 +6184,8 @@ function panelRailing(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "RAILING_PROFILE_FAILED", "Failed to create railing profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$8.u(profileResult.value), [
+		const profile = _usingCtx$8.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			length,
 			0,
 			0
@@ -6261,7 +6291,8 @@ function coveringToSolid(spec) {
 			]
 		]);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "COVERING_PROFILE_FAILED", "Failed to create covering profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$7.u(profileResult.value), [
+		const profile = _usingCtx$7.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			0,
 			thickness
@@ -6288,6 +6319,7 @@ var BimModel = class {
 	#counter = makeLocalIdCounter();
 	#projectId = null;
 	#modelScope = "";
+	#usedStableKeys = /* @__PURE__ */ new Set();
 	init(spec) {
 		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 ?? ""}`;
@@ -6305,24 +6337,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 (0, brepjs.err)(specError("DUPLICATE_STABLE_KEY", `BimModel: duplicate stableKey '${key}'`));
+		return (0, brepjs.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 (0, brepjs.err)(specError("DUPLICATE_STABLE_KEY", `BimModel: stableKey and openingStableKey are both '${options.stableKey}'`));
+		return (0, brepjs.ok)(void 0);
+	}
+	addWall(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = wallToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.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 (0, brepjs.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 (0, brepjs.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 (0, brepjs.ok)(id);
@@ -6598,7 +6649,9 @@ var BimModel = class {
 		});
 		return (0, brepjs.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 (0, brepjs.err)(specError("DOOR_WALL_NOT_FOUND", `No wall found for localId ${spec.wallLocalId}`));
 		if (spec.offsetAlongWall + spec.width > wall.spec.length) return (0, brepjs.err)(specError("DOOR_EXCEEDS_WALL_BOUNDS", "Door (offsetAlongWall + width) exceeds wall length"));
@@ -6613,13 +6666,13 @@ var BimModel = class {
 		const cutResult = this.#cutWallGeometry(wall, openingSpec);
 		if (!cutResult.ok) return (0, brepjs.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,
@@ -6632,7 +6685,9 @@ var BimModel = class {
 		});
 		return (0, brepjs.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 (0, brepjs.err)(specError("WINDOW_WALL_NOT_FOUND", `No wall found for localId ${spec.wallLocalId}`));
 		if (spec.offsetAlongWall + spec.width > wall.spec.length) return (0, brepjs.err)(specError("WINDOW_EXCEEDS_WALL_BOUNDS", "Window (offsetAlongWall + width) exceeds wall length"));
@@ -6647,13 +6702,13 @@ var BimModel = class {
 		const cutResult = this.#cutWallGeometry(wall, openingSpec);
 		if (!cutResult.ok) return (0, brepjs.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,
@@ -6666,7 +6721,9 @@ var BimModel = class {
 		});
 		return (0, brepjs.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 (0, brepjs.err)(specError("SLAB_OPENING_SLAB_NOT_FOUND", `No slab found for localId ${input.slabLocalId}`));
 		if (input.offsetX + input.sizeX > slab.spec.length) return (0, brepjs.err)(specError("SLAB_OPENING_EXCEEDS_SLAB_BOUNDS", "Opening (offsetX + sizeX) exceeds slab length"));
@@ -6696,7 +6753,7 @@ var BimModel = class {
 		const cutResult = this.#cutSlabGeometry(slab, openingSpec);
 		if (!cutResult.ok) return (0, brepjs.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,
@@ -6941,10 +6998,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,
@@ -7191,9 +7252,11 @@ function stairFlightToSolid(spec) {
 		if (spec.riserHeight <= 0) return (0, brepjs.err)(specError("STAIR_FLIGHT_ZERO_RISER", "Stair flight riserHeight must be positive"));
 		if (spec.treadLength <= 0) return (0, brepjs.err)(specError("STAIR_FLIGHT_ZERO_TREAD", "Stair flight treadLength must be positive"));
 		if (!Number.isInteger(spec.numberOfRisers) || spec.numberOfRisers < 1) return (0, brepjs.err)(specError("STAIR_FLIGHT_BAD_RISERS", "Stair flight numberOfRisers must be a positive integer"));
-		const profileResult = (0, brepjs.polygon)(buildSilhouette$1(spec.numberOfRisers, spec.riserHeight, spec.treadLength));
+		const silhouette = buildSilhouette$1(spec.numberOfRisers, spec.riserHeight, spec.treadLength);
+		const profileResult = (0, brepjs.polygon)(silhouette);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "STAIR_FLIGHT_PROFILE_FAILED", "Failed to create stair flight silhouette profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$5.u(profileResult.value), [
+		const profile = _usingCtx$5.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			spec.width,
 			0
@@ -7349,7 +7412,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",
@@ -7429,7 +7492,8 @@ var IfcWriter = class IfcWriter {
 		try {
 			const api = new web_ifc.IfcAPI();
 			await initIfcApi(api);
-			return (0, brepjs.ok)(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition, header));
+			const modelId = api.CreateModel({ schema: fileSchemaString(ifcSchema) });
+			return (0, brepjs.ok)(new IfcWriter(api, modelId, mvdViewDefinition, header));
 		} catch (e) {
 			return (0, brepjs.err)(ifcError("IFC_INIT_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -7483,8 +7547,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);
@@ -9403,9 +9469,11 @@ function rampFlightToSolid(spec) {
 		if (spec.slope <= 0) return (0, brepjs.err)(specError("RAMP_FLIGHT_ZERO_SLOPE", "Ramp flight slope must be positive"));
 		if (spec.thickness <= 0) return (0, brepjs.err)(specError("RAMP_FLIGHT_ZERO_THICKNESS", "Ramp flight thickness must be positive"));
 		const rise = spec.length * spec.slope;
-		const profileResult = (0, brepjs.polygon)(buildSilhouette(spec.length, rise, spec.thickness));
+		const silhouette = buildSilhouette(spec.length, rise, spec.thickness);
+		const profileResult = (0, brepjs.polygon)(silhouette);
 		if (!profileResult.ok) return (0, brepjs.err)(fromBrepError(profileResult.error, "RAMP_FLIGHT_PROFILE_FAILED", "Failed to create ramp flight silhouette profile"));
-		const solidResult = (0, brepjs.extrude)(_usingCtx$3.u(profileResult.value), [
+		const profile = _usingCtx$3.u(profileResult.value);
+		const solidResult = (0, brepjs.extrude)(profile, [
 			0,
 			spec.width,
 			0
@@ -11731,7 +11799,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",
@@ -12528,14 +12596,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 (0, brepjs.ok)({
 		bytes,
-		report: { issues: [
-			...integrity.issues,
-			...geometry.issues,
-			...schema.issues,
-			...roundTrip.issues
-		] }
+		report
 	});
 }
 /**
@@ -12756,7 +12825,7 @@ var SpfReader = class SpfReader {
 };
 //#endregion
 //#region src/import/spatialTree.ts
-var CATEGORY_BY_TYPE = new Map([
+var CATEGORY_BY_TYPE = /* @__PURE__ */ new Map([
 	[web_ifc.IFCPROJECT, "PROJECT"],
 	[web_ifc.IFCSITE, "SITE"],
 	[web_ifc.IFCBUILDING, "BUILDING"],
@@ -12938,7 +13007,8 @@ function reconstructExtrusion(reader, extrusionId, scale, worldTransform, diagno
 	const solidResult = (() => {
 		try {
 			var _usingCtx$1 = _usingCtx();
-			return (0, brepjs.extrude)(_usingCtx$1.u(faceResult.value), extrudeVec);
+			const face = _usingCtx$1.u(faceResult.value);
+			return (0, brepjs.extrude)(face, extrudeVec);
 		} catch (_) {
 			_usingCtx$1.e = _;
 		} finally {
@@ -12991,10 +13061,12 @@ function reconstructRevolution(reader, revolutionId, scale, worldTransform, diag
 	const revolved = (() => {
 		try {
 			var _usingCtx3 = _usingCtx();
-			return (0, brepjs.revolve)(_usingCtx3.u(faceResult.value), {
+			const face = _usingCtx3.u(faceResult.value);
+			const angleDeg = angleRaw * readPlaneAngleScale(reader) * (180 / Math.PI);
+			return (0, brepjs.revolve)(face, {
 				at: center,
 				axis: direction,
-				angle: angleRaw * readPlaneAngleScale(reader) * (180 / Math.PI)
+				angle: angleDeg
 			});
 		} catch (_) {
 			_usingCtx3.e = _;
@@ -13109,7 +13181,7 @@ function packBinaryStl(vertices, indices, scaleToMm) {
 	}
 	return new Uint8Array(buffer);
 }
-var PARAMETRIC_PROFILE_BUILDERS = new Map([
+var PARAMETRIC_PROFILE_BUILDERS = /* @__PURE__ */ new Map([
 	[web_ifc.IFCRECTANGLEPROFILEDEF, (f) => ({
 		kind: "RECTANGULAR",
 		width: f("XDim"),
@@ -13877,14 +13949,15 @@ async function fromIfc(bytes, options = {}) {
 		}
 		const report = appendIssues(emptyReport(), diagnostics);
 		const applicationName = readApplicationName(reader);
-		return (0, brepjs.ok)({
+		const model = {
 			schema: reader.schema,
 			spatialTree: spatialRoot === null ? null : mapSpatialNode(spatialRoot),
 			elements,
 			byExpressId,
 			diagnostics: report,
 			...applicationName !== void 0 ? { applicationName } : {}
-		});
+		};
+		return (0, brepjs.ok)(model);
 	} catch (e) {
 		return (0, brepjs.err)(importError("IMPORT_FAILED", "Unexpected failure during IFC import", e));
 	} finally {
@@ -14911,7 +14984,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",
@@ -15536,9 +15609,10 @@ function parseIdsXml(xml) {
 	const title = info ? firstChild(info, "title")?.text ?? "" : "";
 	const specsContainer = firstChild(root, "specifications");
 	if (specsContainer === void 0) return (0, brepjs.err)(idsError("IDS_INVALID_SCHEMA", "IDS document has no <specifications> element"));
+	const specifications = childrenNamed(specsContainer, "specification").map(parseSpecification);
 	return (0, brepjs.ok)({
 		title,
-		specifications: childrenNamed(specsContainer, "specification").map(parseSpecification)
+		specifications
 	});
 }
 function parseSpecification(el) {
@@ -15895,10 +15969,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;
 }
@@ -16298,7 +16369,8 @@ function parseBcfFiles(files) {
 			topics
 		});
 	} catch (cause) {
-		return (0, brepjs.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 (0, brepjs.err)(bcfError("BCF_PARSE_FAILED", `Failed to parse BCF container: ${message}`, cause));
 	}
 }
 function parseVersion(xml) {
@@ -16413,6 +16485,210 @@ function assignNum(target, key, value) {
 	if (value !== void 0) target[key] = Number(value);
 }
 //#endregion
+//#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 (0, brepjs.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 (0, brepjs.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 (0, brepjs.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 (0, brepjs.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 (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") return (0, brepjs.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 (0, brepjs.ok)(void 0);
+	};
+	const walked = walk(root, null);
+	if (!walked.ok) {
+		model[Symbol.dispose]();
+		return walked;
+	}
+	return (0, brepjs.ok)({
+		model,
+		idByKeyPath
+	});
+}
+//#endregion
 exports.BimModel = BimModel;
 exports.DEFAULT_IFC_SCHEMA = DEFAULT_IFC_SCHEMA;
 exports.DEFAULT_UNITS = DEFAULT_UNITS;
@@ -16436,6 +16712,7 @@ exports.emptyReport = emptyReport;
 exports.exportCobie = deriveCobieModel;
 exports.extendedProfileArea = extendedProfileArea;
 exports.extendedProfileToFace = extendedProfileToFace;
+exports.familiesToBim = familiesToBim;
 exports.fileSchemaString = fileSchemaString;
 exports.fromBrepError = fromBrepError;
 exports.fromIfc = fromIfc;