brepjs-bim 0.13.0 → 0.15.0

package/README.md

@@ -43,7 +43,7 @@ export.
 | Spatial structure | project → site → building → storey aggregation; `placeIn` to assign elements to a storey                 |
 | Property sets     | IFC pset templates + measure types; quantity sets for takeoff                                            |
 | Data layers       | materials (layer/profile/simple sets), classification refs, surface styles, zones/systems                |
-| IFC export        | `toIfc` → IFC-SPF (`Uint8Array`); IFC2X3 / IFC4 schema selection; owner history                          |
+| IFC export        | `toIfc` → IFC-SPF (`Uint8Array`); IFC4 / IFC4X3 schema selection; owner history                          |
 | IFC import        | `fromIfc` / `SpfReader` → `ImportedModel` (elements, geometry, psets, materials, spatial tree)           |
 | Validation        | referential integrity, schema check, geometry validity, IFC round-trip report                            |
 | Interop           | COBie 2.4 export (CSV/JSON), IDS 1.0 checking, BCF 3.0 read/write                                        |
@@ -57,8 +57,9 @@ validator and generates geometry for every product. See [VALIDATION.md](./VALIDA
 to reproduce, and `examples/sampleBuilding.mjs` for the model it validates.
 
 > **Not yet:** the official buildingSMART Validation Service and desktop-tool
-> interop (Revit / ArchiCAD / Solibri) are unverified. This is an early-stage
-> (`0.1.x`) experimental package and the API will change.
+> interop (Revit / Solibri) are unverified — the fixtures and per-tool
+> checklists are ready in [VALIDATION.md](./VALIDATION.md). This is an
+> experimental pre-1.0 package and the API may change.
 
 ## Usage
 
@@ -66,15 +67,16 @@ Author a small model and export IFC:
 
 ```ts
 import { BimModel, toIfc } from 'brepjs-bim';
+import { unwrap } from 'brepjs';
 
 const model = new BimModel();
 model.init({ name: 'Example' });
 
 // Spatial structure: project → site → building → storey.
 const project = model.getProject();
-const siteId = model.addSite({ name: 'Site' });
-const buildingId = model.addBuilding({ name: 'Building' });
-const storeyId = model.addStorey({ name: 'Level 1', elevation: 0 });
+const siteId = unwrap(model.addSite({ name: 'Site' }));
+const buildingId = unwrap(model.addBuilding({ name: 'Building' }));
+const storeyId = unwrap(model.addStorey({ name: 'Level 1', elevation: 0 }));
 if (project) model.aggregate(project.localId, siteId);
 model.aggregate(siteId, buildingId);
 model.aggregate(buildingId, storeyId);

package/dist/brepjs-bim.cjs

@@ -6334,14 +6334,20 @@ var BimModel = class {
 			for (const mullion of el.geometry.mullions) mullion.solid[Symbol.dispose]();
 		}
 	}
-	addSite(spec) {
-		return this.#makeElement("SITE", spec, null);
+	addSite(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("SITE", spec, null, options?.stableKey));
 	}
 	addBuilding(spec, options) {
-		return this.#makeElement("BUILDING", spec, null, options?.stableKey);
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("BUILDING", spec, null, options?.stableKey));
 	}
 	addStorey(spec, options) {
-		return this.#makeElement("STOREY", spec, null, options?.stableKey);
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(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. */
@@ -6398,10 +6404,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addSpace(spec) {
+	addSpace(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = spaceToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("SPACE", spec, geomResult.value);
+		const id = this.#makeElement("SPACE", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6416,26 +6424,32 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addCurtainWall(spec) {
+	addCurtainWall(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const gridResult = curtainWallToGrid(spec);
 		if (!gridResult.ok) return (0, brepjs.err)(gridResult.error);
-		const id = this.#makeElement("CURTAIN_WALL", spec, gridResult.value);
+		const id = this.#makeElement("CURTAIN_WALL", spec, gridResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addFooting(spec) {
+	addFooting(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = footingToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("FOOTING", spec, geomResult.value);
+		const id = this.#makeElement("FOOTING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addPile(spec) {
+	addPile(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = pileToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("PILE", spec, geomResult.value);
+		const id = this.#makeElement("PILE", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6465,10 +6479,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
 	}
-	addRailing(spec) {
+	addRailing(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = railingToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("RAILING", spec, geomResult.value);
+		const id = this.#makeElement("RAILING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return (0, brepjs.ok)(id);
@@ -6478,10 +6494,12 @@ var BimModel = class {
 	* IfcRelCoversBldgElements linking the covering to its host (e.g. a slab it
 	* finishes) is recorded for export.
 	*/
-	addCovering(spec, hostLocalId) {
+	addCovering(spec, hostLocalId, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = coveringToSolid(spec);
 		if (!geomResult.ok) return (0, brepjs.err)(geomResult.error);
-		const id = this.#makeElement("COVERING", spec, geomResult.value);
+		const id = this.#makeElement("COVERING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		if (hostLocalId !== void 0) this.#makeRel({
@@ -6496,24 +6514,30 @@ var BimModel = class {
 	* attach parts with {@link aggregate} (IfcRelAggregates) or {@link nest}
 	* (IfcRelNests, order-preserving). Returns the assembly's localId.
 	*/
-	addElementAssembly(spec) {
-		return this.#makeElement("ELEMENT_ASSEMBLY", spec, null);
+	addElementAssembly(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("ELEMENT_ASSEMBLY", spec, null, options?.stableKey));
 	}
 	/**
 	* Adds an IfcZone grouping object (a thermal/fire/occupancy zone). The zone
 	* carries no geometry; attach members (spaces or other elements) with
-	* {@link assignToGroup}. Returns the zone's localId.
+	* {@link assignToGroup}. Returns the zone's localId as a Result.
 	*/
-	addZone(spec) {
-		return this.#makeElement("ZONE", spec, null);
+	addZone(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("ZONE", spec, null, options?.stableKey));
 	}
 	/**
 	* Adds an IfcSystem grouping object (an HVAC/electrical/plumbing system). The
 	* system carries no geometry; attach members with {@link assignToGroup}.
-	* Returns the system's localId.
+	* Returns the system's localId as a Result.
 	*/
-	addSystem(spec) {
-		return this.#makeElement("SYSTEM", spec, null);
+	addSystem(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return (0, brepjs.ok)(this.#makeElement("SYSTEM", spec, null, options?.stableKey));
 	}
 	/**
 	* Assigns members to a zone or system via IfcRelAssignsToGroup. Repeated calls
@@ -6649,9 +6673,11 @@ var BimModel = class {
 	* and disposes it on model disposal; the caller must not dispose it (see
 	* {@link ProxySpec.solid}).
 	*/
-	addProxy(spec) {
+	addProxy(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		if (spec.solid === null || spec.solid === void 0) return (0, brepjs.err)(specError("PROXY_NO_GEOMETRY", "ProxySpec.solid is required"));
-		const id = this.#makeElement("PROXY", spec, spec.solid);
+		const id = this.#makeElement("PROXY", spec, spec.solid, options?.stableKey);
 		if (spec.materialName !== void 0) this.#makeRel({
 			kind: "ASSOCIATES_MATERIAL",
 			materialName: spec.materialName,
@@ -16733,9 +16759,18 @@ 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 siteResult = model.addSite({ name: options.siteName ?? "Site" });
+	if (!siteResult.ok) {
+		model[Symbol.dispose]();
+		return siteResult;
+	}
+	const buildingResult = model.addBuilding({ name: options.buildingName ?? "Building" });
+	if (!buildingResult.ok) {
+		model[Symbol.dispose]();
+		return buildingResult;
+	}
+	const buildingId = buildingResult.value;
+	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
 	const walk = (el, storeyId) => {
 		let containerId = storeyId;
@@ -16743,13 +16778,14 @@ function familiesToBim(root, options) {
 		if (el.type === "Storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
-			const id = model.addStorey({
+			const storeyResult = 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;
+			if (!storeyResult.ok) return storeyResult;
+			model.aggregate(buildingId, storeyResult.value);
+			idByKeyPath.set(el.keyPath, storeyResult.value);
+			containerId = storeyResult.value;
 		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;

package/dist/brepjs-bim.js

@@ -6311,14 +6311,20 @@ var BimModel = class {
 			for (const mullion of el.geometry.mullions) mullion.solid[Symbol.dispose]();
 		}
 	}
-	addSite(spec) {
-		return this.#makeElement("SITE", spec, null);
+	addSite(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(this.#makeElement("SITE", spec, null, options?.stableKey));
 	}
 	addBuilding(spec, options) {
-		return this.#makeElement("BUILDING", spec, null, options?.stableKey);
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(this.#makeElement("BUILDING", spec, null, options?.stableKey));
 	}
 	addStorey(spec, options) {
-		return this.#makeElement("STOREY", spec, null, options?.stableKey);
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(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. */
@@ -6375,10 +6381,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addSpace(spec) {
+	addSpace(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = spaceToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("SPACE", spec, geomResult.value);
+		const id = this.#makeElement("SPACE", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6393,26 +6401,32 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addCurtainWall(spec) {
+	addCurtainWall(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const gridResult = curtainWallToGrid(spec);
 		if (!gridResult.ok) return err(gridResult.error);
-		const id = this.#makeElement("CURTAIN_WALL", spec, gridResult.value);
+		const id = this.#makeElement("CURTAIN_WALL", spec, gridResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addFooting(spec) {
+	addFooting(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = footingToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("FOOTING", spec, geomResult.value);
+		const id = this.#makeElement("FOOTING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addPile(spec) {
+	addPile(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = pileToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("PILE", spec, geomResult.value);
+		const id = this.#makeElement("PILE", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6442,10 +6456,12 @@ var BimModel = class {
 		this.#associateClassification(id, spec);
 		return ok(id);
 	}
-	addRailing(spec) {
+	addRailing(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = railingToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("RAILING", spec, geomResult.value);
+		const id = this.#makeElement("RAILING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		return ok(id);
@@ -6455,10 +6471,12 @@ var BimModel = class {
 	* IfcRelCoversBldgElements linking the covering to its host (e.g. a slab it
 	* finishes) is recorded for export.
 	*/
-	addCovering(spec, hostLocalId) {
+	addCovering(spec, hostLocalId, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		const geomResult = coveringToSolid(spec);
 		if (!geomResult.ok) return err(geomResult.error);
-		const id = this.#makeElement("COVERING", spec, geomResult.value);
+		const id = this.#makeElement("COVERING", spec, geomResult.value, options?.stableKey);
 		this.#associateMaterial(id, spec);
 		this.#associateClassification(id, spec);
 		if (hostLocalId !== void 0) this.#makeRel({
@@ -6473,24 +6491,30 @@ var BimModel = class {
 	* attach parts with {@link aggregate} (IfcRelAggregates) or {@link nest}
 	* (IfcRelNests, order-preserving). Returns the assembly's localId.
 	*/
-	addElementAssembly(spec) {
-		return this.#makeElement("ELEMENT_ASSEMBLY", spec, null);
+	addElementAssembly(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(this.#makeElement("ELEMENT_ASSEMBLY", spec, null, options?.stableKey));
 	}
 	/**
 	* Adds an IfcZone grouping object (a thermal/fire/occupancy zone). The zone
 	* carries no geometry; attach members (spaces or other elements) with
-	* {@link assignToGroup}. Returns the zone's localId.
+	* {@link assignToGroup}. Returns the zone's localId as a Result.
 	*/
-	addZone(spec) {
-		return this.#makeElement("ZONE", spec, null);
+	addZone(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(this.#makeElement("ZONE", spec, null, options?.stableKey));
 	}
 	/**
 	* Adds an IfcSystem grouping object (an HVAC/electrical/plumbing system). The
 	* system carries no geometry; attach members with {@link assignToGroup}.
-	* Returns the system's localId.
+	* Returns the system's localId as a Result.
 	*/
-	addSystem(spec) {
-		return this.#makeElement("SYSTEM", spec, null);
+	addSystem(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
+		return ok(this.#makeElement("SYSTEM", spec, null, options?.stableKey));
 	}
 	/**
 	* Assigns members to a zone or system via IfcRelAssignsToGroup. Repeated calls
@@ -6626,9 +6650,11 @@ var BimModel = class {
 	* and disposes it on model disposal; the caller must not dispose it (see
 	* {@link ProxySpec.solid}).
 	*/
-	addProxy(spec) {
+	addProxy(spec, options) {
+		const keyCheck = this.#checkStableKey(options);
+		if (!keyCheck.ok) return keyCheck;
 		if (spec.solid === null || spec.solid === void 0) return err(specError("PROXY_NO_GEOMETRY", "ProxySpec.solid is required"));
-		const id = this.#makeElement("PROXY", spec, spec.solid);
+		const id = this.#makeElement("PROXY", spec, spec.solid, options?.stableKey);
 		if (spec.materialName !== void 0) this.#makeRel({
 			kind: "ASSOCIATES_MATERIAL",
 			materialName: spec.materialName,
@@ -16710,9 +16736,18 @@ 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 siteResult = model.addSite({ name: options.siteName ?? "Site" });
+	if (!siteResult.ok) {
+		model[Symbol.dispose]();
+		return siteResult;
+	}
+	const buildingResult = model.addBuilding({ name: options.buildingName ?? "Building" });
+	if (!buildingResult.ok) {
+		model[Symbol.dispose]();
+		return buildingResult;
+	}
+	const buildingId = buildingResult.value;
+	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
 	const walk = (el, storeyId) => {
 		let containerId = storeyId;
@@ -16720,13 +16755,14 @@ function familiesToBim(root, options) {
 		if (el.type === "Storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
-			const id = model.addStorey({
+			const storeyResult = 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;
+			if (!storeyResult.ok) return storeyResult;
+			model.aggregate(buildingId, storeyResult.value);
+			idByKeyPath.set(el.keyPath, storeyResult.value);
+			containerId = storeyResult.value;
 		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;

package/dist/model/bimModel.d.ts

@@ -37,18 +37,18 @@ export declare class BimModel {
     #private;
     init(spec: ProjectSpec): Result<LocalId, BimError>;
     [Symbol.dispose](): void;
-    addSite(spec: SiteSpec): LocalId;
-    addBuilding(spec: BuildingSpec, options?: ElementIdentityOptions): LocalId;
-    addStorey(spec: StoreySpec, options?: ElementIdentityOptions): LocalId;
+    addSite(spec: SiteSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addBuilding(spec: BuildingSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addStorey(spec: StoreySpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addWall(spec: WallSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addSlab(spec: SlabSpec, options?: ElementIdentityOptions): 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>;
+    addSpace(spec: SpaceSpec, options?: ElementIdentityOptions): 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>;
+    addCurtainWall(spec: CurtainWallSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addFooting(spec: FootingSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addPile(spec: PileSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcStair assembly. Geometry for each flight is built and written by
      * the IFC layer from `spec.flights`; the STAIR element itself carries no solid
@@ -60,31 +60,31 @@ export declare class BimModel {
      * IFC layer from `spec.flights`; the RAMP element carries no solid of its own.
      */
     addRamp(spec: RampSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
-    addRailing(spec: RailingSpec): Result<LocalId, BimError>;
+    addRailing(spec: RailingSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcCovering. When `hostLocalId` is supplied, an
      * IfcRelCoversBldgElements linking the covering to its host (e.g. a slab it
      * finishes) is recorded for export.
      */
-    addCovering(spec: CoveringSpec, hostLocalId?: LocalId): Result<LocalId, BimError>;
+    addCovering(spec: CoveringSpec, hostLocalId?: LocalId, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcElementAssembly grouping container. The assembly has no geometry;
      * attach parts with {@link aggregate} (IfcRelAggregates) or {@link nest}
      * (IfcRelNests, order-preserving). Returns the assembly's localId.
      */
-    addElementAssembly(spec: ElementAssemblySpec): LocalId;
+    addElementAssembly(spec: ElementAssemblySpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcZone grouping object (a thermal/fire/occupancy zone). The zone
      * carries no geometry; attach members (spaces or other elements) with
-     * {@link assignToGroup}. Returns the zone's localId.
+     * {@link assignToGroup}. Returns the zone's localId as a Result.
      */
-    addZone(spec: ZoneSpec): LocalId;
+    addZone(spec: ZoneSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Adds an IfcSystem grouping object (an HVAC/electrical/plumbing system). The
      * system carries no geometry; attach members with {@link assignToGroup}.
-     * Returns the system's localId.
+     * Returns the system's localId as a Result.
      */
-    addSystem(spec: SystemSpec): LocalId;
+    addSystem(spec: SystemSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     /**
      * Assigns members to a zone or system via IfcRelAssignsToGroup. Repeated calls
      * for the same group extend the single relationship in call order. Returns the
@@ -130,7 +130,7 @@ export declare class BimModel {
      * and disposes it on model disposal; the caller must not dispose it (see
      * {@link ProxySpec.solid}).
      */
-    addProxy(spec: ProxySpec): Result<LocalId, BimError>;
+    addProxy(spec: ProxySpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addDoor(spec: DoorSpec, options?: OpeningIdentityOptions): Result<LocalId, BimError>;
     addWindow(spec: WindowSpec, options?: OpeningIdentityOptions): Result<LocalId, BimError>;
     addSlabOpening(input: SlabOpeningInput, options?: ElementIdentityOptions): Result<LocalId, BimError>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",