brepjs-bim 0.18.0 → 0.20.0

package/dist/brepjs-bim.cjs

@@ -535,7 +535,7 @@ var propertyKeyTypes = /* @__PURE__*/ new Set([
 function escapeRegex(str) {
 	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function clone(inst, def, params) {
+function clone$1(inst, def, params) {
 	const cl = new inst._zod.constr(def ?? inst._zod.def);
 	if (!def || params?.parent) cl._zod.parent = inst;
 	return cl;
@@ -571,7 +571,7 @@ function pick(schema, mask) {
 	const currDef = schema._zod.def;
 	const checks = currDef.checks;
 	if (checks && checks.length > 0) throw new Error(".pick() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const newShape = {};
 			for (const key in mask) {
@@ -589,7 +589,7 @@ function omit(schema, mask) {
 	const currDef = schema._zod.def;
 	const checks = currDef.checks;
 	if (checks && checks.length > 0) throw new Error(".omit() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const newShape = { ...schema._zod.def.shape };
 			for (const key in mask) {
@@ -610,7 +610,7 @@ function extend(schema, shape) {
 		const existingShape = schema._zod.def.shape;
 		for (const key in shape) if (Object.getOwnPropertyDescriptor(existingShape, key) !== void 0) throw new Error("Cannot overwrite keys on object schemas containing refinements. Use `.safeExtend()` instead.");
 	}
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const _shape = {
 			...schema._zod.def.shape,
 			...shape
@@ -621,7 +621,7 @@ function extend(schema, shape) {
 }
 function safeExtend(schema, shape) {
 	if (!isPlainObject(shape)) throw new Error("Invalid input to safeExtend: expected a plain object");
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const _shape = {
 			...schema._zod.def.shape,
 			...shape
@@ -632,7 +632,7 @@ function safeExtend(schema, shape) {
 }
 function merge(a, b) {
 	if (a._zod.def.checks?.length) throw new Error(".merge() cannot be used on object schemas containing refinements. Use .safeExtend() instead.");
-	return clone(a, mergeDefs(a._zod.def, {
+	return clone$1(a, mergeDefs(a._zod.def, {
 		get shape() {
 			const _shape = {
 				...a._zod.def.shape,
@@ -650,7 +650,7 @@ function merge(a, b) {
 function partial(Class, schema, mask) {
 	const checks = schema._zod.def.checks;
 	if (checks && checks.length > 0) throw new Error(".partial() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const oldShape = schema._zod.def.shape;
 			const shape = { ...oldShape };
@@ -673,7 +673,7 @@ function partial(Class, schema, mask) {
 	}));
 }
 function required(Class, schema, mask) {
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const oldShape = schema._zod.def.shape;
 		const shape = { ...oldShape };
 		if (mask) for (const key in mask) {
@@ -4042,7 +4042,7 @@ var ZodType = /*@__PURE__*/ $constructor("ZodType", (inst, def) => {
 			return this.check(...chks);
 		},
 		clone(def, params) {
-			return clone(this, def, params);
+			return clone$1(this, def, params);
 		},
 		brand() {
 			return this;
@@ -27652,27 +27652,27 @@ var GEOMETRY_PROPS = /* @__PURE__ */ new Set([
 	"psets"
 ]);
 var SPEC_ROUTES = {
-	Wall: {
+	wall: {
 		parse: parseWallSpec,
 		add: (m, spec, key) => m.addWall(spec, { stableKey: key })
 	},
-	Slab: {
+	slab: {
 		parse: parseSlabSpec,
 		add: (m, spec, key) => m.addSlab(spec, { stableKey: key })
 	},
-	Column: {
+	column: {
 		parse: parseColumnSpec,
 		add: (m, spec, key) => m.addColumn(spec, { stableKey: key })
 	},
-	Beam: {
+	beam: {
 		parse: parseBeamSpec,
 		add: (m, spec, key) => m.addBeam(spec, { stableKey: key })
 	},
-	Roof: {
+	roof: {
 		parse: parseRoofSpec,
 		add: (m, spec, key) => m.addRoof(spec, { stableKey: key })
 	},
-	Stair: {
+	stair: {
 		parse: parseStairSpec,
 		add: (m, spec, key) => m.addStair(spec, { stableKey: key }),
 		input: stairSpecInput
@@ -27707,8 +27707,28 @@ function stairSpecInput(el) {
 		})
 	};
 }
-function specRoute(type) {
-	return Object.hasOwn(SPEC_ROUTES, type) ? SPEC_ROUTES[type] : void 0;
+/**
+* Families predating `archetype` are routed by their display name. Keeping
+* this fallback makes the declaration purely additive, at the cost of the
+* original trap surviving for undeclared families: rename one and it stops
+* routing.
+*/
+var NAME_ARCHETYPES = {
+	Storey: "storey",
+	Wall: "wall",
+	Slab: "slab",
+	Column: "column",
+	Beam: "beam",
+	Roof: "roof",
+	Stair: "stair",
+	Door: "door",
+	Window: "window"
+};
+function archetypeFor(el) {
+	return el.archetype ?? NAME_ARCHETYPES[el.type];
+}
+function specRoute(archetype) {
+	return archetype !== void 0 && Object.hasOwn(SPEC_ROUTES, archetype) ? SPEC_ROUTES[archetype] : void 0;
 }
 /** Total of the resolved geometry's OUTER literal translate chain. The
 *  transform vocabulary is translate-only, so frame differences are exact
@@ -27816,17 +27836,48 @@ function collectSpecProps(el) {
 	return out;
 }
 function addFill(model, fill, input, identity) {
-	if (fill.type === "Door") {
+	const archetype = archetypeFor(fill);
+	if (archetype === "door") {
 		const parsed = parseDoorSpec(input);
 		if (!parsed.ok) return parsed;
 		return model.addDoor(parsed.value, identity);
 	}
-	if (fill.type === "Window") {
+	if (archetype === "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}'`));
+	return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_FILL", `familiesToBim: no fill mapping for element type '${fill.type}' at '${fill.keyPath}' (archetype: ${archetype ?? "none"}) — a filler needs archetype: 'door' or 'window'`));
+}
+/** Materialize an unrouted element's IR and add it as a proxy. The body is
+*  authoritative for a proxy (no parametric spec to diverge from), so baked
+*  transforms — rotations included — are fine here. */
+function addProxyElement(model, el, evaluator) {
+	const evaluated = evaluator.evaluate(el.geometry);
+	if (!evaluated.ok) return (0, brepjs.err)(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' failed to materialize for the proxy route: ${evaluated.error.message}`, evaluated.error));
+	let source = evaluated.value;
+	if (!(0, brepjs.isSolid)(source)) {
+		const solids = (0, brepjs.getSolids)(source);
+		const only = solids.length === 1 ? solids[0] : void 0;
+		if (only === void 0) return (0, brepjs.err)(specError("FAMILIES_PROXY_NOT_SOLID", `familiesToBim: '${el.keyPath}' materialized to ${solids.length} solids — a proxy body must be exactly one`));
+		source = only;
+	}
+	const copy = (0, brepjs.clone)(source);
+	if (!copy.ok) return (0, brepjs.err)(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' could not copy the materialized body`, copy.error));
+	const valid = (0, brepjs.validSolid)(copy.value);
+	if (!valid.ok) {
+		copy.value[Symbol.dispose]();
+		return (0, brepjs.err)(specError("FAMILIES_PROXY_INVALID", `familiesToBim: '${el.keyPath}' materialized to an invalid solid: ${valid.error}`));
+	}
+	const nameAttr = el.attributes["name"];
+	const materialProp = el.props["materialName"];
+	const specProps = collectSpecProps(el);
+	return model.addProxy({
+		name: typeof nameAttr === "string" ? nameAttr : el.type,
+		solid: valid.value,
+		materialName: typeof materialProp === "string" ? materialProp : specProps["materialName"],
+		customProperties: specProps["customProperties"]
+	}, { stableKey: el.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:
@@ -27900,11 +27951,14 @@ function familiesToBim(root, options) {
 	if (project !== null) model.aggregate(project.localId, siteResult.value);
 	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
+	const proxied = [];
 	const walk = (el, storeyId, rotated) => {
 		const rotatedHere = rotated || hasRotateOp(el);
+		let proxiedHere = false;
 		let containerId = storeyId;
-		const route = specRoute(el.type);
-		if (el.type === "Storey") {
+		const archetype = archetypeFor(el);
+		const route = specRoute(archetype);
+		if (archetype === "storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
 			const storeyResult = model.addStorey({
@@ -27929,16 +27983,31 @@ function familiesToBim(root, options) {
 			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`));
+			if (containerId === null) return (0, brepjs.err)(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
 			model.placeIn(added.value, containerId);
-			if (el.type === "Wall") {
+			if (archetype === "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}'`));
+		else if (el.type !== "Group" && el.geometry.kind !== "Empty") {
+			if (options.proxyEvaluator === void 0) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}' (archetype: ${el.archetype ?? "none"}) — routing is by archetype, so declare one on the family, add a spec route, or pass proxyEvaluator to export it as an IfcBuildingElementProxy`));
+			const keyed = requireKeyed(el);
+			if (!keyed.ok) return keyed;
+			if (containerId === null) return (0, brepjs.err)(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
+			const added = addProxyElement(model, el, options.proxyEvaluator);
+			if (!added.ok) return added;
+			model.placeIn(added.value, containerId);
+			idByKeyPath.set(el.keyPath, added.value);
+			proxied.push({
+				keyPath: el.keyPath,
+				type: el.type,
+				archetype: el.archetype
+			});
+			proxiedHere = true;
+		}
 		for (const child of el.children) {
-			if (el.type === "Wall" && child.type === "Opening") continue;
+			if ((archetype === "wall" || proxiedHere) && child.type === "Opening") continue;
 			const r = walk(child, containerId, rotatedHere);
 			if (!r.ok) return r;
 		}
@@ -27951,7 +28020,8 @@ function familiesToBim(root, options) {
 	}
 	return (0, brepjs.ok)({
 		model,
-		idByKeyPath
+		idByKeyPath,
+		proxied
 	});
 }
 //#endregion

package/dist/brepjs-bim.js

@@ -1,4 +1,4 @@
-import { addHoles, applyMatrix, autoHeal, box, castShape, convexHull, cut, err, extrude, fuse, getKernel, isClosedWire, isOk, isPlanarWire, isSolid, isValid, isValidSolid, measureVolume, mesh, ok, outerWire, polygon, revolve, rotate, validSolid } from "brepjs";
+import { addHoles, applyMatrix, autoHeal, box, castShape, clone, convexHull, cut, err, extrude, fuse, getKernel, getSolids, isClosedWire, isOk, isPlanarWire, isSolid, isValid, isValidSolid, measureVolume, mesh, ok, outerWire, polygon, revolve, rotate, validSolid } from "brepjs";
 import * as WebIFC from "web-ifc";
 import { Handle, IfcAPI } from "web-ifc";
 //#region src/identity/ifcGuid.ts
@@ -512,7 +512,7 @@ var propertyKeyTypes = /* @__PURE__*/ new Set([
 function escapeRegex(str) {
 	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function clone(inst, def, params) {
+function clone$1(inst, def, params) {
 	const cl = new inst._zod.constr(def ?? inst._zod.def);
 	if (!def || params?.parent) cl._zod.parent = inst;
 	return cl;
@@ -548,7 +548,7 @@ function pick(schema, mask) {
 	const currDef = schema._zod.def;
 	const checks = currDef.checks;
 	if (checks && checks.length > 0) throw new Error(".pick() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const newShape = {};
 			for (const key in mask) {
@@ -566,7 +566,7 @@ function omit(schema, mask) {
 	const currDef = schema._zod.def;
 	const checks = currDef.checks;
 	if (checks && checks.length > 0) throw new Error(".omit() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const newShape = { ...schema._zod.def.shape };
 			for (const key in mask) {
@@ -587,7 +587,7 @@ function extend(schema, shape) {
 		const existingShape = schema._zod.def.shape;
 		for (const key in shape) if (Object.getOwnPropertyDescriptor(existingShape, key) !== void 0) throw new Error("Cannot overwrite keys on object schemas containing refinements. Use `.safeExtend()` instead.");
 	}
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const _shape = {
 			...schema._zod.def.shape,
 			...shape
@@ -598,7 +598,7 @@ function extend(schema, shape) {
 }
 function safeExtend(schema, shape) {
 	if (!isPlainObject(shape)) throw new Error("Invalid input to safeExtend: expected a plain object");
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const _shape = {
 			...schema._zod.def.shape,
 			...shape
@@ -609,7 +609,7 @@ function safeExtend(schema, shape) {
 }
 function merge(a, b) {
 	if (a._zod.def.checks?.length) throw new Error(".merge() cannot be used on object schemas containing refinements. Use .safeExtend() instead.");
-	return clone(a, mergeDefs(a._zod.def, {
+	return clone$1(a, mergeDefs(a._zod.def, {
 		get shape() {
 			const _shape = {
 				...a._zod.def.shape,
@@ -627,7 +627,7 @@ function merge(a, b) {
 function partial(Class, schema, mask) {
 	const checks = schema._zod.def.checks;
 	if (checks && checks.length > 0) throw new Error(".partial() cannot be used on object schemas containing refinements");
-	return clone(schema, mergeDefs(schema._zod.def, {
+	return clone$1(schema, mergeDefs(schema._zod.def, {
 		get shape() {
 			const oldShape = schema._zod.def.shape;
 			const shape = { ...oldShape };
@@ -650,7 +650,7 @@ function partial(Class, schema, mask) {
 	}));
 }
 function required(Class, schema, mask) {
-	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
+	return clone$1(schema, mergeDefs(schema._zod.def, { get shape() {
 		const oldShape = schema._zod.def.shape;
 		const shape = { ...oldShape };
 		if (mask) for (const key in mask) {
@@ -4019,7 +4019,7 @@ var ZodType = /*@__PURE__*/ $constructor("ZodType", (inst, def) => {
 			return this.check(...chks);
 		},
 		clone(def, params) {
-			return clone(this, def, params);
+			return clone$1(this, def, params);
 		},
 		brand() {
 			return this;
@@ -27629,27 +27629,27 @@ var GEOMETRY_PROPS = /* @__PURE__ */ new Set([
 	"psets"
 ]);
 var SPEC_ROUTES = {
-	Wall: {
+	wall: {
 		parse: parseWallSpec,
 		add: (m, spec, key) => m.addWall(spec, { stableKey: key })
 	},
-	Slab: {
+	slab: {
 		parse: parseSlabSpec,
 		add: (m, spec, key) => m.addSlab(spec, { stableKey: key })
 	},
-	Column: {
+	column: {
 		parse: parseColumnSpec,
 		add: (m, spec, key) => m.addColumn(spec, { stableKey: key })
 	},
-	Beam: {
+	beam: {
 		parse: parseBeamSpec,
 		add: (m, spec, key) => m.addBeam(spec, { stableKey: key })
 	},
-	Roof: {
+	roof: {
 		parse: parseRoofSpec,
 		add: (m, spec, key) => m.addRoof(spec, { stableKey: key })
 	},
-	Stair: {
+	stair: {
 		parse: parseStairSpec,
 		add: (m, spec, key) => m.addStair(spec, { stableKey: key }),
 		input: stairSpecInput
@@ -27684,8 +27684,28 @@ function stairSpecInput(el) {
 		})
 	};
 }
-function specRoute(type) {
-	return Object.hasOwn(SPEC_ROUTES, type) ? SPEC_ROUTES[type] : void 0;
+/**
+* Families predating `archetype` are routed by their display name. Keeping
+* this fallback makes the declaration purely additive, at the cost of the
+* original trap surviving for undeclared families: rename one and it stops
+* routing.
+*/
+var NAME_ARCHETYPES = {
+	Storey: "storey",
+	Wall: "wall",
+	Slab: "slab",
+	Column: "column",
+	Beam: "beam",
+	Roof: "roof",
+	Stair: "stair",
+	Door: "door",
+	Window: "window"
+};
+function archetypeFor(el) {
+	return el.archetype ?? NAME_ARCHETYPES[el.type];
+}
+function specRoute(archetype) {
+	return archetype !== void 0 && Object.hasOwn(SPEC_ROUTES, archetype) ? SPEC_ROUTES[archetype] : void 0;
 }
 /** Total of the resolved geometry's OUTER literal translate chain. The
 *  transform vocabulary is translate-only, so frame differences are exact
@@ -27793,17 +27813,48 @@ function collectSpecProps(el) {
 	return out;
 }
 function addFill(model, fill, input, identity) {
-	if (fill.type === "Door") {
+	const archetype = archetypeFor(fill);
+	if (archetype === "door") {
 		const parsed = parseDoorSpec(input);
 		if (!parsed.ok) return parsed;
 		return model.addDoor(parsed.value, identity);
 	}
-	if (fill.type === "Window") {
+	if (archetype === "window") {
 		const parsed = parseWindowSpec(input);
 		if (!parsed.ok) return parsed;
 		return model.addWindow(parsed.value, identity);
 	}
-	return err(specError("FAMILIES_UNSUPPORTED_FILL", `familiesToBim: no fill mapping for element type '${fill.type}' at '${fill.keyPath}'`));
+	return err(specError("FAMILIES_UNSUPPORTED_FILL", `familiesToBim: no fill mapping for element type '${fill.type}' at '${fill.keyPath}' (archetype: ${archetype ?? "none"}) — a filler needs archetype: 'door' or 'window'`));
+}
+/** Materialize an unrouted element's IR and add it as a proxy. The body is
+*  authoritative for a proxy (no parametric spec to diverge from), so baked
+*  transforms — rotations included — are fine here. */
+function addProxyElement(model, el, evaluator) {
+	const evaluated = evaluator.evaluate(el.geometry);
+	if (!evaluated.ok) return err(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' failed to materialize for the proxy route: ${evaluated.error.message}`, evaluated.error));
+	let source = evaluated.value;
+	if (!isSolid(source)) {
+		const solids = getSolids(source);
+		const only = solids.length === 1 ? solids[0] : void 0;
+		if (only === void 0) return err(specError("FAMILIES_PROXY_NOT_SOLID", `familiesToBim: '${el.keyPath}' materialized to ${solids.length} solids — a proxy body must be exactly one`));
+		source = only;
+	}
+	const copy = clone(source);
+	if (!copy.ok) return err(specError("FAMILIES_PROXY_EVAL_FAILED", `familiesToBim: '${el.keyPath}' could not copy the materialized body`, copy.error));
+	const valid = validSolid(copy.value);
+	if (!valid.ok) {
+		copy.value[Symbol.dispose]();
+		return err(specError("FAMILIES_PROXY_INVALID", `familiesToBim: '${el.keyPath}' materialized to an invalid solid: ${valid.error}`));
+	}
+	const nameAttr = el.attributes["name"];
+	const materialProp = el.props["materialName"];
+	const specProps = collectSpecProps(el);
+	return model.addProxy({
+		name: typeof nameAttr === "string" ? nameAttr : el.type,
+		solid: valid.value,
+		materialName: typeof materialProp === "string" ? materialProp : specProps["materialName"],
+		customProperties: specProps["customProperties"]
+	}, { stableKey: el.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:
@@ -27877,11 +27928,14 @@ function familiesToBim(root, options) {
 	if (project !== null) model.aggregate(project.localId, siteResult.value);
 	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
+	const proxied = [];
 	const walk = (el, storeyId, rotated) => {
 		const rotatedHere = rotated || hasRotateOp(el);
+		let proxiedHere = false;
 		let containerId = storeyId;
-		const route = specRoute(el.type);
-		if (el.type === "Storey") {
+		const archetype = archetypeFor(el);
+		const route = specRoute(archetype);
+		if (archetype === "storey") {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
 			const storeyResult = model.addStorey({
@@ -27906,16 +27960,31 @@ function familiesToBim(root, options) {
 			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`));
+			if (containerId === null) return err(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
 			model.placeIn(added.value, containerId);
-			if (el.type === "Wall") {
+			if (archetype === "wall") {
 				const opened = addOpenings(model, el, added.value, containerId, idByKeyPath);
 				if (!opened.ok) return opened;
 			}
 		} else if (el.type === "Opening") return err(specError("FAMILIES_OPENING_OUTSIDE_WALL", `familiesToBim: opening '${el.keyPath}' is not hosted by a Wall — only wall openings are mapped`));
-		else if (el.type !== "Group" && el.geometry.kind !== "Empty") return err(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}'`));
+		else if (el.type !== "Group" && el.geometry.kind !== "Empty") {
+			if (options.proxyEvaluator === void 0) return err(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}' (archetype: ${el.archetype ?? "none"}) — routing is by archetype, so declare one on the family, add a spec route, or pass proxyEvaluator to export it as an IfcBuildingElementProxy`));
+			const keyed = requireKeyed(el);
+			if (!keyed.ok) return keyed;
+			if (containerId === null) return err(specError("FAMILIES_NO_STOREY", `familiesToBim: '${el.keyPath}' has no Storey ancestor — IFC elements need spatial containment; a container family needs archetype: 'storey' to be recognised under any name`));
+			const added = addProxyElement(model, el, options.proxyEvaluator);
+			if (!added.ok) return added;
+			model.placeIn(added.value, containerId);
+			idByKeyPath.set(el.keyPath, added.value);
+			proxied.push({
+				keyPath: el.keyPath,
+				type: el.type,
+				archetype: el.archetype
+			});
+			proxiedHere = true;
+		}
 		for (const child of el.children) {
-			if (el.type === "Wall" && child.type === "Opening") continue;
+			if ((archetype === "wall" || proxiedHere) && child.type === "Opening") continue;
 			const r = walk(child, containerId, rotatedHere);
 			if (!r.ok) return r;
 		}
@@ -27928,7 +27997,8 @@ function familiesToBim(root, options) {
 	}
 	return ok({
 		model,
-		idByKeyPath
+		idByKeyPath,
+		proxied
 	});
 }
 //#endregion

package/dist/familiesAdapter.d.ts

@@ -1,4 +1,4 @@
-import { Result } from 'brepjs';
+import { Result, csg } from 'brepjs';
 import { ResolvedElement } from 'brepjs-families';
 import { BimModel } from './model/bimModel.js';
 import { LocalId } from './identity/localId.js';
@@ -8,11 +8,34 @@ export interface FamiliesToBimOptions {
     readonly project: ProjectSpec;
     readonly siteName?: string | undefined;
     readonly buildingName?: string | undefined;
+    /**
+     * Enables the proxy route: an unrouted geometry-bearing element is
+     * materialized through this evaluator and exported as an
+     * IfcBuildingElementProxy (tessellated, world-frame body). Without it,
+     * unrouted types stay a hard FAMILIES_UNSUPPORTED_TYPE error. The
+     * evaluator's handles stay borrowed; the adapter clones what it hands the
+     * model.
+     */
+    readonly proxyEvaluator?: csg.Evaluator | undefined;
+}
+export interface ProxiedElement {
+    readonly keyPath: string;
+    /** The family's display name, as resolved. */
+    readonly type: string;
+    readonly archetype: string | undefined;
 }
 export interface FamiliesBimResult {
     readonly model: BimModel;
     /** LocalId per geometry-bearing families key path. */
     readonly idByKeyPath: ReadonlyMap<string, LocalId>;
+    /**
+     * Elements exported as IfcBuildingElementProxy because no spec route
+     * matched, in walk order. Only ever non-empty when `proxyEvaluator` is set:
+     * without it an unrouted element is a hard error instead. A renamed family
+     * that has lost its routing lands here rather than in the file as the type
+     * you meant, so check this before trusting an export.
+     */
+    readonly proxied: readonly ProxiedElement[];
 }
 /**
  * Project a resolved families tree into an eager BimModel. The caller owns

package/dist/index.d.ts

@@ -97,4 +97,4 @@ export type { IdsDocument, IdsSpecification, IdsFacet, IdsRestriction, IdsCardin
 export { serializeBcfFiles, parseBcfFiles } from './bcf/index.js';
 export type { BcfColoring, BcfComment, BcfComponent, BcfComponents, BcfContainerData, BcfFiles, BcfProject, BcfTopic, BcfVersion, BcfViewpoint, BcfVisibility, } from './bcf/index.js';
 export { bcfError, idsError } from './errors/bimError.js';
-export { familiesToBim, type FamiliesToBimOptions, type FamiliesBimResult, } from './familiesAdapter.js';
+export { familiesToBim, type FamiliesToBimOptions, type FamiliesBimResult, type ProxiedElement, } from './familiesAdapter.js';

package/package.json

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