brepjs-bim 0.17.2 → 0.18.0

package/README.md

@@ -14,6 +14,13 @@ and serializes the result to a valid **IFC-SPF** file — with a matching import
 Pipeline: **author spec → `BimModel` (typed element + brepjs geometry) → spatial structure +
 property sets + classification → export IFC / COBie, validate, round-trip.**
 
+The declarative entry point is
+[`brepjs-families`](https://www.npmjs.com/package/brepjs-families): author the building as a tree of
+prop-driven components, then `familiesToBim(tree, { project })` projects it onto a `BimModel` with
+stable GlobalIds derived from component key paths. Hand-authoring specs against `BimModel` remains
+the low-level path (and covers elements the declarative route doesn't yet). See the
+[Declarative Models guide](https://brepjs.dev/families/overview).
+
 ## Scope
 
 Parametric authoring of the common IFC4 building elements plus the data layers that make a model

package/dist/brepjs-bim.cjs

@@ -27735,6 +27735,16 @@ function peelTranslates(node) {
 		moved
 	};
 }
+/** True when the element's transform PROP carries a rotation. The spec path
+*  folds only translations into IfcLocalPlacement (walls orient via `axisX`),
+*  so a tRotate placement would export un-rotated while the viewport shows it
+*  rotated — reject instead of diverging. Rotations a family render bakes
+*  into its own body geometry (e.g. a circular beam oriented along axisX) are
+*  fine: the spec rebuilds that body parametrically from props. */
+function hasRotateOp(el) {
+	const ops = el.props["transform"];
+	return Array.isArray(ops) && ops.some((op) => typeof op === "object" && op !== null && op.op === "rotate");
+}
 /** 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). */
@@ -27890,7 +27900,8 @@ function familiesToBim(root, options) {
 	if (project !== null) model.aggregate(project.localId, siteResult.value);
 	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
-	const walk = (el, storeyId) => {
+	const walk = (el, storeyId, rotated) => {
+		const rotatedHere = rotated || hasRotateOp(el);
 		let containerId = storeyId;
 		const route = specRoute(el.type);
 		if (el.type === "Storey") {
@@ -27907,6 +27918,7 @@ function familiesToBim(root, options) {
 		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
+			if (rotatedHere) return (0, brepjs.err)(specError("FAMILIES_UNSUPPORTED_TRANSFORM", `familiesToBim: '${el.keyPath}' carries a rotated placement — the spec path folds only translations into IfcLocalPlacement; orient walls via axisX instead of tRotate`));
 			const voids = el.props["voids"];
 			if (Array.isArray(voids)) {
 				const openings = el.children.filter((c) => c.type === "Opening").length;
@@ -27927,12 +27939,12 @@ function familiesToBim(root, options) {
 		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);
+			const r = walk(child, containerId, rotatedHere);
 			if (!r.ok) return r;
 		}
 		return (0, brepjs.ok)(void 0);
 	};
-	const walked = walk(root, null);
+	const walked = walk(root, null, false);
 	if (!walked.ok) {
 		model[Symbol.dispose]();
 		return walked;

package/dist/brepjs-bim.js

@@ -27712,6 +27712,16 @@ function peelTranslates(node) {
 		moved
 	};
 }
+/** True when the element's transform PROP carries a rotation. The spec path
+*  folds only translations into IfcLocalPlacement (walls orient via `axisX`),
+*  so a tRotate placement would export un-rotated while the viewport shows it
+*  rotated — reject instead of diverging. Rotations a family render bakes
+*  into its own body geometry (e.g. a circular beam oriented along axisX) are
+*  fine: the spec rebuilds that body parametrically from props. */
+function hasRotateOp(el) {
+	const ops = el.props["transform"];
+	return Array.isArray(ops) && ops.some((op) => typeof op === "object" && op !== null && op.op === "rotate");
+}
 /** 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). */
@@ -27867,7 +27877,8 @@ function familiesToBim(root, options) {
 	if (project !== null) model.aggregate(project.localId, siteResult.value);
 	model.aggregate(siteResult.value, buildingId);
 	const idByKeyPath = /* @__PURE__ */ new Map();
-	const walk = (el, storeyId) => {
+	const walk = (el, storeyId, rotated) => {
+		const rotatedHere = rotated || hasRotateOp(el);
 		let containerId = storeyId;
 		const route = specRoute(el.type);
 		if (el.type === "Storey") {
@@ -27884,6 +27895,7 @@ function familiesToBim(root, options) {
 		} else if (route !== void 0) {
 			const keyed = requireKeyed(el);
 			if (!keyed.ok) return keyed;
+			if (rotatedHere) return err(specError("FAMILIES_UNSUPPORTED_TRANSFORM", `familiesToBim: '${el.keyPath}' carries a rotated placement — the spec path folds only translations into IfcLocalPlacement; orient walls via axisX instead of tRotate`));
 			const voids = el.props["voids"];
 			if (Array.isArray(voids)) {
 				const openings = el.children.filter((c) => c.type === "Opening").length;
@@ -27904,12 +27916,12 @@ function familiesToBim(root, options) {
 		else if (el.type !== "Group" && el.geometry.kind !== "Empty") return err(specError("FAMILIES_UNSUPPORTED_TYPE", `familiesToBim: no spec mapping for element type '${el.type}' at '${el.keyPath}'`));
 		for (const child of el.children) {
 			if (el.type === "Wall" && child.type === "Opening") continue;
-			const r = walk(child, containerId);
+			const r = walk(child, containerId, rotatedHere);
 			if (!r.ok) return r;
 		}
 		return ok(void 0);
 	};
-	const walked = walk(root, null);
+	const walked = walk(root, null, false);
 	if (!walked.ok) {
 		model[Symbol.dispose]();
 		return walked;

package/package.json

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