brepjs-bim 0.10.0 → 0.12.0

package/dist/brepjs-bim.cjs

@@ -6378,10 +6378,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addBeam(spec) {
+	addBeam(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = beamToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("BEAM", spec, geomResult.value);
+		const id = this.#makeElement("BEAM", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6404,10 +6406,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addRoof(spec) {
+	addRoof(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = roofToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("ROOF", spec, geomResult.value);
+		const id = this.#makeElement("ROOF", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6441,8 +6445,10 @@ var BimModel = class {
 	* the IFC layer from `spec.flights`; the STAIR element itself carries no solid
 	* (the assembly container's Representation is null, valid per IFC4).
 	*/
-	addStair(spec) {
-		const id = this.#makeElement("STAIR", spec, null);
+	addStair(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		const id = this.#makeElement("STAIR", spec, null, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6451,8 +6457,10 @@ var BimModel = class {
 	* Adds an IfcRamp assembly. Geometry for each flight is built and written by the
 	* IFC layer from `spec.flights`; the RAMP element carries no solid of its own.
 	*/
-	addRamp(spec) {
-		const id = this.#makeElement("RAMP", spec, null);
+	addRamp(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		const id = this.#makeElement("RAMP", spec, null, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -9628,13 +9636,15 @@ function writeRampEntity(w, guid, name, predefinedType, ownerHistoryId, localPla
 * per `spec.flights[i]` (each with a tessellated stepped-solid body), and a single
 * IfcRelAggregates linking the flights to the stair. Flight placements are
 * relative to the stair placement, which is relative to `parentPlacementId`
-* (typically the storey). GUIDs are deterministic, keyed on `stairKey`/index so
+* (typically the storey). The assembly's GlobalId is the element's stored guid
+* (stableKey-derived when the caller provided one); flight, type, and
+* relationship GUIDs are deterministic, keyed on `stairKey`/index so
 * re-serializing an identical model is byte-stable.
 *
 * Returns a BimError if any flight solid cannot be built. Stair flights are real
 * stepped solids; tessellation failure is flagged via `geometrySimplified`.
 */
-function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId, parentPlacementId) {
+function writeStairAssembly(w, spec, stairKey, assemblyGuid, ownerHistoryId, geomSubContextId, parentPlacementId) {
 	const predefinedType = spec.predefinedType ?? "NOTDEFINED";
 	const stairName = spec.name ?? "Stair";
 	if (spec.flights[0] === void 0) return {
@@ -9654,7 +9664,7 @@ function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId,
 		0,
 		0
 	], parentPlacementId);
-	const assemblyExpressId = writeStairEntity(w, deriveIfcGuidSync(`elem:STAIR:${stairKey}`), stairName, predefinedType, ownerHistoryId, stairPlacementId);
+	const assemblyExpressId = writeStairEntity(w, assemblyGuid, stairName, predefinedType, ownerHistoryId, stairPlacementId);
 	const flightExpressIds = [];
 	let geometrySimplified = false;
 	for (const [i, flight] of spec.flights.entries()) try {
@@ -9694,7 +9704,7 @@ function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId,
 * inclined-slab solids, so `geometrySimplified` is always true. GUIDs are
 * deterministic keyed on `rampKey`.
 */
-function writeRampAssembly(w, spec, rampKey, ownerHistoryId, geomSubContextId, parentPlacementId) {
+function writeRampAssembly(w, spec, rampKey, assemblyGuid, ownerHistoryId, geomSubContextId, parentPlacementId) {
 	const predefinedType = spec.predefinedType ?? "NOTDEFINED";
 	const rampName = spec.name ?? "Ramp";
 	if (spec.flights[0] === void 0) return {
@@ -9714,7 +9724,7 @@ function writeRampAssembly(w, spec, rampKey, ownerHistoryId, geomSubContextId, p
 		0,
 		0
 	], parentPlacementId);
-	const assemblyExpressId = writeRampEntity(w, deriveIfcGuidSync(`elem:RAMP:${rampKey}`), rampName, predefinedType, ownerHistoryId, rampPlacementId);
+	const assemblyExpressId = writeRampEntity(w, assemblyGuid, rampName, predefinedType, ownerHistoryId, rampPlacementId);
 	const flightExpressIds = [];
 	const geometrySimplified = true;
 	for (const [i, flight] of spec.flights.entries()) try {
@@ -12273,7 +12283,7 @@ async function toIfc(model, meta) {
 	for (const stair of stairs) {
 		const containingId = findContainerOf(stair.localId, relationships);
 		const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-		const result = writeStairAssembly(w, stair.spec, `${stair.localId}`, ownerHistoryId, geomSubContextId, storeyPlacementId);
+		const result = writeStairAssembly(w, stair.spec, `${stair.localId}`, stair.guid, ownerHistoryId, geomSubContextId, storeyPlacementId);
 		if (!result.ok) return (0, brepjs.err)(result.error);
 		idMap.set(stair.localId, result.value.assemblyExpressId);
 		writeStairCommonPset(w, ownerHistoryId, result.value.assemblyExpressId, stair.spec);
@@ -12281,7 +12291,7 @@ async function toIfc(model, meta) {
 	for (const ramp of ramps) {
 		const containingId = findContainerOf(ramp.localId, relationships);
 		const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-		const result = writeRampAssembly(w, ramp.spec, `${ramp.localId}`, ownerHistoryId, geomSubContextId, storeyPlacementId);
+		const result = writeRampAssembly(w, ramp.spec, `${ramp.localId}`, ramp.guid, ownerHistoryId, geomSubContextId, storeyPlacementId);
 		if (!result.ok) return (0, brepjs.err)(result.error);
 		idMap.set(ramp.localId, result.value.assemblyExpressId);
 		writeRampCommonPset(w, ownerHistoryId, result.value.assemblyExpressId, ramp.spec);
@@ -16495,7 +16505,7 @@ 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 elements, and wall openings — a
+* 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
 * the wall and wire IfcRelVoidsElement + IfcRelFillsElement; the opening and
 * filler GlobalIds derive from the synthesized key paths. Anonymous (non-fill)
@@ -16525,6 +16535,65 @@ var GEOMETRY_PROPS = /* @__PURE__ */ new Set([
 	"transform",
 	"psets"
 ]);
+var SPEC_ROUTES = {
+	Wall: {
+		parse: parseWallSpec,
+		add: (m, spec, key) => m.addWall(spec, { stableKey: key })
+	},
+	Slab: {
+		parse: parseSlabSpec,
+		add: (m, spec, key) => m.addSlab(spec, { stableKey: key })
+	},
+	Column: {
+		parse: parseColumnSpec,
+		add: (m, spec, key) => m.addColumn(spec, { stableKey: key })
+	},
+	Beam: {
+		parse: parseBeamSpec,
+		add: (m, spec, key) => m.addBeam(spec, { stableKey: key })
+	},
+	Roof: {
+		parse: parseRoofSpec,
+		add: (m, spec, key) => m.addRoof(spec, { stableKey: key })
+	},
+	Stair: {
+		parse: parseStairSpec,
+		add: (m, spec, key) => m.addStair(spec, { stableKey: key }),
+		input: stairSpecInput
+	}
+};
+/** 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) {
+	const base = specInput(el);
+	const fold = base["origin"] ?? [
+		0,
+		0,
+		0
+	];
+	const flights = Array.isArray(base["flights"]) ? base["flights"] : [];
+	return {
+		...base,
+		flights: flights.map((f) => {
+			const fo = f["origin"] ?? [
+				0,
+				0,
+				0
+			];
+			return {
+				...f,
+				origin: [
+					fo[0] + fold[0],
+					fo[1] + fold[1],
+					fo[2] + fold[2]
+				]
+			};
+		})
+	};
+}
+function specRoute(type) {
+	return Object.hasOwn(SPEC_ROUTES, type) ? SPEC_ROUTES[type] : void 0;
+}
 /** 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. */
@@ -16670,6 +16739,7 @@ function familiesToBim(root, options) {
 	const idByKeyPath = /* @__PURE__ */ new Map();
 	const walk = (el, storeyId) => {
 		let containerId = storeyId;
+		const route = specRoute(el.type);
 		if (el.type === "Storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
@@ -16680,12 +16750,12 @@ function familiesToBim(root, options) {
 			model.aggregate(buildingId, id);
 			idByKeyPath.set(el.keyPath, id);
 			containerId = id;
-		} else if (el.type === "Wall" || el.type === "Slab" || el.type === "Column") {
+		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
-			const parsed = el.type === "Wall" ? parseWallSpec(specInput(el)) : el.type === "Slab" ? parseSlabSpec(specInput(el)) : parseColumnSpec(specInput(el));
+			const parsed = route.parse(("input" in route ? route.input : specInput)(el));
 			if (!parsed.ok) return parsed;
-			const added = el.type === "Wall" ? model.addWall(parsed.value, { stableKey: el.keyPath }) : el.type === "Slab" ? model.addSlab(parsed.value, { stableKey: el.keyPath }) : model.addColumn(parsed.value, { stableKey: el.keyPath });
+			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`));

package/dist/brepjs-bim.js

@@ -6355,10 +6355,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addBeam(spec) {
+	addBeam(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = beamToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("BEAM", spec, geomResult.value);
+		const id = this.#makeElement("BEAM", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6381,10 +6383,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addRoof(spec) {
+	addRoof(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = roofToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("ROOF", spec, geomResult.value);
+		const id = this.#makeElement("ROOF", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6418,8 +6422,10 @@ var BimModel = class {
 	* the IFC layer from `spec.flights`; the STAIR element itself carries no solid
 	* (the assembly container's Representation is null, valid per IFC4).
 	*/
-	addStair(spec) {
-		const id = this.#makeElement("STAIR", spec, null);
+	addStair(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		const id = this.#makeElement("STAIR", spec, null, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6428,8 +6434,10 @@ var BimModel = class {
 	* Adds an IfcRamp assembly. Geometry for each flight is built and written by the
 	* IFC layer from `spec.flights`; the RAMP element carries no solid of its own.
 	*/
-	addRamp(spec) {
-		const id = this.#makeElement("RAMP", spec, null);
+	addRamp(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		const id = this.#makeElement("RAMP", spec, null, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -9605,13 +9613,15 @@ function writeRampEntity(w, guid, name, predefinedType, ownerHistoryId, localPla
 * per `spec.flights[i]` (each with a tessellated stepped-solid body), and a single
 * IfcRelAggregates linking the flights to the stair. Flight placements are
 * relative to the stair placement, which is relative to `parentPlacementId`
-* (typically the storey). GUIDs are deterministic, keyed on `stairKey`/index so
+* (typically the storey). The assembly's GlobalId is the element's stored guid
+* (stableKey-derived when the caller provided one); flight, type, and
+* relationship GUIDs are deterministic, keyed on `stairKey`/index so
 * re-serializing an identical model is byte-stable.
 *
 * Returns a BimError if any flight solid cannot be built. Stair flights are real
 * stepped solids; tessellation failure is flagged via `geometrySimplified`.
 */
-function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId, parentPlacementId) {
+function writeStairAssembly(w, spec, stairKey, assemblyGuid, ownerHistoryId, geomSubContextId, parentPlacementId) {
 	const predefinedType = spec.predefinedType ?? "NOTDEFINED";
 	const stairName = spec.name ?? "Stair";
 	if (spec.flights[0] === void 0) return {
@@ -9631,7 +9641,7 @@ function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId,
 		0,
 		0
 	], parentPlacementId);
-	const assemblyExpressId = writeStairEntity(w, deriveIfcGuidSync(`elem:STAIR:${stairKey}`), stairName, predefinedType, ownerHistoryId, stairPlacementId);
+	const assemblyExpressId = writeStairEntity(w, assemblyGuid, stairName, predefinedType, ownerHistoryId, stairPlacementId);
 	const flightExpressIds = [];
 	let geometrySimplified = false;
 	for (const [i, flight] of spec.flights.entries()) try {
@@ -9671,7 +9681,7 @@ function writeStairAssembly(w, spec, stairKey, ownerHistoryId, geomSubContextId,
 * inclined-slab solids, so `geometrySimplified` is always true. GUIDs are
 * deterministic keyed on `rampKey`.
 */
-function writeRampAssembly(w, spec, rampKey, ownerHistoryId, geomSubContextId, parentPlacementId) {
+function writeRampAssembly(w, spec, rampKey, assemblyGuid, ownerHistoryId, geomSubContextId, parentPlacementId) {
 	const predefinedType = spec.predefinedType ?? "NOTDEFINED";
 	const rampName = spec.name ?? "Ramp";
 	if (spec.flights[0] === void 0) return {
@@ -9691,7 +9701,7 @@ function writeRampAssembly(w, spec, rampKey, ownerHistoryId, geomSubContextId, p
 		0,
 		0
 	], parentPlacementId);
-	const assemblyExpressId = writeRampEntity(w, deriveIfcGuidSync(`elem:RAMP:${rampKey}`), rampName, predefinedType, ownerHistoryId, rampPlacementId);
+	const assemblyExpressId = writeRampEntity(w, assemblyGuid, rampName, predefinedType, ownerHistoryId, rampPlacementId);
 	const flightExpressIds = [];
 	const geometrySimplified = true;
 	for (const [i, flight] of spec.flights.entries()) try {
@@ -12250,7 +12260,7 @@ async function toIfc(model, meta) {
 	for (const stair of stairs) {
 		const containingId = findContainerOf(stair.localId, relationships);
 		const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-		const result = writeStairAssembly(w, stair.spec, `${stair.localId}`, ownerHistoryId, geomSubContextId, storeyPlacementId);
+		const result = writeStairAssembly(w, stair.spec, `${stair.localId}`, stair.guid, ownerHistoryId, geomSubContextId, storeyPlacementId);
 		if (!result.ok) return err(result.error);
 		idMap.set(stair.localId, result.value.assemblyExpressId);
 		writeStairCommonPset(w, ownerHistoryId, result.value.assemblyExpressId, stair.spec);
@@ -12258,7 +12268,7 @@ async function toIfc(model, meta) {
 	for (const ramp of ramps) {
 		const containingId = findContainerOf(ramp.localId, relationships);
 		const storeyPlacementId = containingId !== null ? placementMap.get(containingId) ?? null : null;
-		const result = writeRampAssembly(w, ramp.spec, `${ramp.localId}`, ownerHistoryId, geomSubContextId, storeyPlacementId);
+		const result = writeRampAssembly(w, ramp.spec, `${ramp.localId}`, ramp.guid, ownerHistoryId, geomSubContextId, storeyPlacementId);
 		if (!result.ok) return err(result.error);
 		idMap.set(ramp.localId, result.value.assemblyExpressId);
 		writeRampCommonPset(w, ownerHistoryId, result.value.assemblyExpressId, ramp.spec);
@@ -16472,7 +16482,7 @@ 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 elements, and wall openings — a
+* 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
 * the wall and wire IfcRelVoidsElement + IfcRelFillsElement; the opening and
 * filler GlobalIds derive from the synthesized key paths. Anonymous (non-fill)
@@ -16502,6 +16512,65 @@ var GEOMETRY_PROPS = /* @__PURE__ */ new Set([
 	"transform",
 	"psets"
 ]);
+var SPEC_ROUTES = {
+	Wall: {
+		parse: parseWallSpec,
+		add: (m, spec, key) => m.addWall(spec, { stableKey: key })
+	},
+	Slab: {
+		parse: parseSlabSpec,
+		add: (m, spec, key) => m.addSlab(spec, { stableKey: key })
+	},
+	Column: {
+		parse: parseColumnSpec,
+		add: (m, spec, key) => m.addColumn(spec, { stableKey: key })
+	},
+	Beam: {
+		parse: parseBeamSpec,
+		add: (m, spec, key) => m.addBeam(spec, { stableKey: key })
+	},
+	Roof: {
+		parse: parseRoofSpec,
+		add: (m, spec, key) => m.addRoof(spec, { stableKey: key })
+	},
+	Stair: {
+		parse: parseStairSpec,
+		add: (m, spec, key) => m.addStair(spec, { stableKey: key }),
+		input: stairSpecInput
+	}
+};
+/** 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) {
+	const base = specInput(el);
+	const fold = base["origin"] ?? [
+		0,
+		0,
+		0
+	];
+	const flights = Array.isArray(base["flights"]) ? base["flights"] : [];
+	return {
+		...base,
+		flights: flights.map((f) => {
+			const fo = f["origin"] ?? [
+				0,
+				0,
+				0
+			];
+			return {
+				...f,
+				origin: [
+					fo[0] + fold[0],
+					fo[1] + fold[1],
+					fo[2] + fold[2]
+				]
+			};
+		})
+	};
+}
+function specRoute(type) {
+	return Object.hasOwn(SPEC_ROUTES, type) ? SPEC_ROUTES[type] : void 0;
+}
 /** 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. */
@@ -16647,6 +16716,7 @@ function familiesToBim(root, options) {
 	const idByKeyPath = /* @__PURE__ */ new Map();
 	const walk = (el, storeyId) => {
 		let containerId = storeyId;
+		const route = specRoute(el.type);
 		if (el.type === "Storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
@@ -16657,12 +16727,12 @@ function familiesToBim(root, options) {
 			model.aggregate(buildingId, id);
 			idByKeyPath.set(el.keyPath, id);
 			containerId = id;
-		} else if (el.type === "Wall" || el.type === "Slab" || el.type === "Column") {
+		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
-			const parsed = el.type === "Wall" ? parseWallSpec(specInput(el)) : el.type === "Slab" ? parseSlabSpec(specInput(el)) : parseColumnSpec(specInput(el));
+			const parsed = route.parse(("input" in route ? route.input : specInput)(el));
 			if (!parsed.ok) return parsed;
-			const added = el.type === "Wall" ? model.addWall(parsed.value, { stableKey: el.keyPath }) : el.type === "Slab" ? model.addSlab(parsed.value, { stableKey: el.keyPath }) : model.addColumn(parsed.value, { stableKey: el.keyPath });
+			const added = route.add(model, parsed.value, 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`));

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

@@ -20,13 +20,15 @@ export interface AssemblyWriteResult {
  * per `spec.flights[i]` (each with a tessellated stepped-solid body), and a single
  * IfcRelAggregates linking the flights to the stair. Flight placements are
  * relative to the stair placement, which is relative to `parentPlacementId`
- * (typically the storey). GUIDs are deterministic, keyed on `stairKey`/index so
+ * (typically the storey). The assembly's GlobalId is the element's stored guid
+ * (stableKey-derived when the caller provided one); flight, type, and
+ * relationship GUIDs are deterministic, keyed on `stairKey`/index so
  * re-serializing an identical model is byte-stable.
  *
  * Returns a BimError if any flight solid cannot be built. Stair flights are real
  * stepped solids; tessellation failure is flagged via `geometrySimplified`.
  */
-export declare function writeStairAssembly(w: IfcWriter, spec: StairSpec, stairKey: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
+export declare function writeStairAssembly(w: IfcWriter, spec: StairSpec, stairKey: string, assemblyGuid: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
     ok: true;
     value: AssemblyWriteResult;
 } | {
@@ -40,7 +42,7 @@ export declare function writeStairAssembly(w: IfcWriter, spec: StairSpec, stairK
  * inclined-slab solids, so `geometrySimplified` is always true. GUIDs are
  * deterministic keyed on `rampKey`.
  */
-export declare function writeRampAssembly(w: IfcWriter, spec: RampSpec, rampKey: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
+export declare function writeRampAssembly(w: IfcWriter, spec: RampSpec, rampKey: string, assemblyGuid: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
     ok: true;
     value: AssemblyWriteResult;
 } | {

package/dist/model/bimModel.d.ts

@@ -42,10 +42,10 @@ export declare class BimModel {
     addStorey(spec: StoreySpec, options?: ElementIdentityOptions): LocalId;
     addWall(spec: WallSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addSlab(spec: SlabSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
-    addBeam(spec: BeamSpec): Result<LocalId, BimError>;
+    addBeam(spec: BeamSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addColumn(spec: ColumnSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addSpace(spec: SpaceSpec): Result<LocalId, BimError>;
-    addRoof(spec: RoofSpec): Result<LocalId, BimError>;
+    addRoof(spec: RoofSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addCurtainWall(spec: CurtainWallSpec): Result<LocalId, BimError>;
     addFooting(spec: FootingSpec): Result<LocalId, BimError>;
     addPile(spec: PileSpec): Result<LocalId, BimError>;
@@ -54,12 +54,12 @@ export declare class BimModel {
      * the IFC layer from `spec.flights`; the STAIR element itself carries no solid
      * (the assembly container's Representation is null, valid per IFC4).
      */
-    addStair(spec: StairSpec): Result<LocalId, BimError>;
+    addStair(spec: StairSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcRamp assembly. Geometry for each flight is built and written by the
      * IFC layer from `spec.flights`; the RAMP element carries no solid of its own.
      */
-    addRamp(spec: RampSpec): Result<LocalId, BimError>;
+    addRamp(spec: RampSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addRailing(spec: RailingSpec): Result<LocalId, BimError>;
     /**
      * Adds an IfcCovering. When `hostLocalId` is supplied, an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",
@@ -43,6 +43,7 @@
     "build": "vite build",
     "typecheck": "tsgo --noEmit",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "lint": "eslint src tests"
   },
   "peerDependencies": {