brepjs-bim 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,10 @@
 # brepjs-bim
 
-> Experimental, unpublished satellite package.
+> Experimental satellite package, published to npm. Early-stage — the API may change.
+
+```bash
+npm install brepjs-bim
+```
 
 A BIM (Building Information Modeling) layer for [brepjs](https://github.com/andymai/brepjs). It
 authors IFC4-aligned parametric building elements (walls, slabs, beams, columns, roofs, curtain
@@ -37,6 +41,18 @@ coordinates — placement (`origin` / `axisX` / `axisZ`) is applied by the IFC l
 | 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                                        |
 
+### Independent validation
+
+The exported IFC is validated by **IfcOpenShell** (a separate implementation from the
+web-ifc parser used internally), not just self-checked. The committed sample
+(`examples/sample-building.ifc`) passes IfcOpenShell's EXPRESS schema + where-rule
+validator and generates geometry for every product. See [VALIDATION.md](./VALIDATION.md)
+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.
+
 ## Usage
 
 Author a small model and export IFC:

package/dist/brepjs-bim.cjs

@@ -24,8 +24,37 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 let brepjs = require("brepjs");
 let web_ifc = require("web-ifc");
 web_ifc = __toESM(web_ifc, 1);
+//#region src/identity/ifcGuid.ts
+var IFC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
+function newIfcGuid() {
+	const bytes = crypto.getRandomValues(new Uint8Array(16));
+	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
+	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+	return encodeIfcGuid(bytes);
+}
+function isValidIfcGuid(s) {
+	if (s.length !== 22) return false;
+	if (!"0123".includes(s[0] ?? "")) return false;
+	for (const ch of s) if (!IFC_CHARS.includes(ch)) return false;
+	return true;
+}
+function encodeIfcGuid(bytes) {
+	let result = "";
+	let acc = 0;
+	let bits = 4;
+	for (const byte of bytes) {
+		acc = acc << 8 | byte;
+		bits += 8;
+		while (bits >= 6) {
+			bits -= 6;
+			result += IFC_CHARS[acc >> bits & 63] ?? "";
+		}
+	}
+	if (bits > 0) result += IFC_CHARS[acc << 6 - bits & 63] ?? "";
+	return result;
+}
+//#endregion
 //#region src/identity/guidDerivation.ts
-var IFC_CHARS$1 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
 var NAMESPACE = "brepjs-bim:v1";
 var FNV_OFFSET = 2166136261;
 var FNV_PRIME = 16777619;
@@ -59,7 +88,7 @@ function digest16(stableKey) {
 * keys yield distinct, format-valid (22-char) GlobalIds.
 */
 function deriveIfcGuidSync(stableKey) {
-	return encodeIfcGuid$1(digest16(stableKey));
+	return encodeIfcGuid(digest16(stableKey));
 }
 /**
 * Async wrapper over {@link deriveIfcGuidSync} for callers that prefer a Promise
@@ -86,21 +115,6 @@ function makeRelKey(modelScope, kind, localId) {
 function makeLineKey(modelScope, expressId) {
 	return `line:${modelScope}:${expressId}`;
 }
-function encodeIfcGuid$1(bytes) {
-	let result = "";
-	let acc = 0;
-	let bits = 0;
-	for (const byte of bytes) {
-		acc = acc << 8 | byte;
-		bits += 8;
-		while (bits >= 6) {
-			bits -= 6;
-			result += IFC_CHARS$1[acc >> bits & 63] ?? "";
-		}
-	}
-	if (bits > 0) result += IFC_CHARS$1[acc << 6 - bits & 63] ?? "";
-	return result;
-}
 //#endregion
 //#region src/identity/localId.ts
 function makeLocalIdCounter(start = 1) {
@@ -5093,7 +5107,8 @@ var CoreProfileSchema = discriminatedUnion("kind", [
 		overallWidth: number().positive(),
 		overallDepth: number().positive(),
 		flangeThickness: number().positive(),
-		webThickness: number().positive()
+		webThickness: number().positive(),
+		filletRadius: number().positive().optional()
 	})
 ]);
 var Pt2Schema = tuple([number(), number()]);
@@ -5225,6 +5240,11 @@ function parseProfile(input) {
 	if (profile.kind === "I_BEAM") {
 		if (2 * profile.flangeThickness >= profile.overallDepth) return (0, brepjs.err)(specError("INVALID_PROFILE", "I-beam flangeThickness × 2 must be less than overallDepth"));
 		if (profile.webThickness >= profile.overallWidth) return (0, brepjs.err)(specError("INVALID_PROFILE", "I-beam webThickness must be less than overallWidth"));
+		if (profile.filletRadius !== void 0) {
+			const clearHeight = profile.overallDepth / 2 - profile.flangeThickness;
+			const clearSpan = (profile.overallWidth - profile.webThickness) / 2;
+			if (profile.filletRadius >= clearHeight || profile.filletRadius >= clearSpan) return (0, brepjs.err)(specError("INVALID_PROFILE", "I-beam filletRadius must be smaller than the clear web height and the clear span beside the web"));
+		}
 	}
 	return (0, brepjs.ok)(profile);
 }
@@ -5235,8 +5255,42 @@ function profileCrossSectionArea(profile) {
 	switch (profile.kind) {
 		case "RECTANGULAR": return profile.width * profile.height;
 		case "CIRCULAR": return Math.PI * profile.radius * profile.radius;
-		case "I_BEAM": return 2 * profile.overallWidth * profile.flangeThickness + (profile.overallDepth - 2 * profile.flangeThickness) * profile.webThickness;
+		case "I_BEAM": {
+			const flangeArea = 2 * profile.overallWidth * profile.flangeThickness;
+			const webArea = (profile.overallDepth - 2 * profile.flangeThickness) * profile.webThickness;
+			const r = profile.filletRadius ?? 0;
+			const filletArea = 4 * r * r * (1 - Math.PI / 4);
+			return flangeArea + webArea + filletArea;
+		}
+	}
+}
+var FILLET_SEGMENTS = 8;
+var FILLET_MIN_ANGLE = .001;
+function filletArc(prev, v, next, r) {
+	const aLen = Math.hypot(prev[0] - v[0], prev[1] - v[1]);
+	const bLen = Math.hypot(next[0] - v[0], next[1] - v[1]);
+	const a = [(prev[0] - v[0]) / aLen, (prev[1] - v[1]) / aLen];
+	const b = [(next[0] - v[0]) / bLen, (next[1] - v[1]) / bLen];
+	const alpha = Math.acos(Math.max(-1, Math.min(1, a[0] * b[0] + a[1] * b[1])));
+	if (alpha < FILLET_MIN_ANGLE || alpha > Math.PI - FILLET_MIN_ANGLE) return [[v[0], v[1]]];
+	const setback = r / Math.tan(alpha / 2);
+	const center = r / Math.sin(alpha / 2);
+	const bisLen = Math.hypot(a[0] + b[0], a[1] + b[1]);
+	const bis = [(a[0] + b[0]) / bisLen, (a[1] + b[1]) / bisLen];
+	const cx = v[0] + bis[0] * center;
+	const cy = v[1] + bis[1] * center;
+	const p1 = [v[0] + a[0] * setback, v[1] + a[1] * setback];
+	const p2 = [v[0] + b[0] * setback, v[1] + b[1] * setback];
+	const a1 = Math.atan2(p1[1] - cy, p1[0] - cx);
+	let delta = Math.atan2(p2[1] - cy, p2[0] - cx) - a1;
+	while (delta <= -Math.PI) delta += 2 * Math.PI;
+	while (delta > Math.PI) delta -= 2 * Math.PI;
+	const out = [];
+	for (let i = 0; i <= FILLET_SEGMENTS; i++) {
+		const ang = a1 + delta * i / FILLET_SEGMENTS;
+		out.push([cx + r * Math.cos(ang), cy + r * Math.sin(ang)]);
 	}
+	return out;
 }
 function profileToPolygon(profile, circleSegments = 32) {
 	if (isExtendedProfile(profile)) return (0, brepjs.err)(specError("EXTENDED_PROFILE_NO_POLYGON", `profileToPolygon: extended profile kind '${profile.kind}' has no single-polygon outline; use extendedProfileToFace()`));
@@ -5285,68 +5339,50 @@ function profileToPolygon(profile, circleSegments = 32) {
 			const halfD = profile.overallDepth / 2;
 			const halfWeb = profile.webThickness / 2;
 			const flangeInnerY = halfD - profile.flangeThickness;
-			return (0, brepjs.ok)([
-				[
-					-halfW,
-					-halfD,
-					0
-				],
-				[
-					halfW,
-					-halfD,
-					0
-				],
-				[
-					halfW,
-					-flangeInnerY,
-					0
-				],
-				[
-					halfWeb,
-					-flangeInnerY,
-					0
-				],
-				[
-					halfWeb,
-					flangeInnerY,
-					0
-				],
-				[
-					halfW,
-					flangeInnerY,
-					0
-				],
-				[
-					halfW,
-					halfD,
-					0
-				],
-				[
-					-halfW,
-					halfD,
-					0
-				],
-				[
-					-halfW,
-					flangeInnerY,
-					0
-				],
-				[
-					-halfWeb,
-					flangeInnerY,
-					0
-				],
-				[
-					-halfWeb,
-					-flangeInnerY,
-					0
-				],
-				[
-					-halfW,
-					-flangeInnerY,
-					0
-				]
+			const v = [
+				[-halfW, -halfD],
+				[halfW, -halfD],
+				[halfW, -flangeInnerY],
+				[halfWeb, -flangeInnerY],
+				[halfWeb, flangeInnerY],
+				[halfW, flangeInnerY],
+				[halfW, halfD],
+				[-halfW, halfD],
+				[-halfW, flangeInnerY],
+				[-halfWeb, flangeInnerY],
+				[-halfWeb, -flangeInnerY],
+				[-halfW, -flangeInnerY]
+			];
+			const r = profile.filletRadius ?? 0;
+			const rootCorners = new Set([
+				3,
+				4,
+				9,
+				10
 			]);
+			const pts = [];
+			for (let i = 0; i < v.length; i++) {
+				const cur = v[i];
+				if (cur === void 0) continue;
+				if (r > 0 && rootCorners.has(i)) {
+					const prev = v[(i - 1 + v.length) % v.length];
+					const next = v[(i + 1) % v.length];
+					if (prev !== void 0 && next !== void 0) {
+						for (const [ax, ay] of filletArc(prev, cur, next, r)) pts.push([
+							ax,
+							ay,
+							0
+						]);
+						continue;
+					}
+				}
+				pts.push([
+					cur[0],
+					cur[1],
+					0
+				]);
+			}
+			return (0, brepjs.ok)(pts);
 		}
 	}
 }
@@ -6530,6 +6566,50 @@ var BimModel = class {
 	getElement(id) {
 		return this.#elements.get(id) ?? null;
 	}
+	/**
+	* A serializable summary of the model's structure, rooted at the project and
+	* walking the IFC spatial hierarchy (AGGREGATES: project → site → building →
+	* storey) plus the elements contained in each storey (placeIn). Useful for a
+	* read-only tree view of the model across a worker boundary.
+	*/
+	toTreeSummary() {
+		const aggregated = /* @__PURE__ */ new Map();
+		const contained = /* @__PURE__ */ new Map();
+		for (const rel of this.#relationships.values()) if (rel.kind === "AGGREGATES") {
+			const list = aggregated.get(rel.relatingObject) ?? [];
+			list.push(...rel.relatedObjects);
+			aggregated.set(rel.relatingObject, list);
+		} else if (rel.kind === "CONTAINED_IN") {
+			const list = contained.get(rel.relatingStructure) ?? [];
+			list.push(...rel.relatedElements);
+			contained.set(rel.relatingStructure, list);
+		}
+		const labelFor = (el) => {
+			const spec = el.spec;
+			const base = typeof spec.name === "string" && spec.name.length > 0 ? spec.name : el.category;
+			return el.category === "STOREY" && typeof spec.elevation === "number" ? `${base} (+${spec.elevation} mm)` : base;
+		};
+		const seen = /* @__PURE__ */ new Set();
+		const build = (id) => {
+			if (seen.has(id)) return null;
+			seen.add(id);
+			const el = this.#elements.get(id);
+			if (el === void 0) return null;
+			const children = [...aggregated.get(id) ?? [], ...contained.get(id) ?? []].map(build).filter((n) => n !== null);
+			return {
+				id,
+				label: labelFor(el),
+				category: el.category,
+				children
+			};
+		};
+		const root = this.#projectId !== null ? build(this.#projectId) : null;
+		const countNodes = (node) => 1 + node.children.reduce((sum, c) => sum + countNodes(c), 0);
+		return {
+			root,
+			elementCount: root ? countNodes(root) : 0
+		};
+	}
 	getWalls() {
 		const walls = [];
 		for (const el of this.#elements.values()) if (el.category === "WALL") walls.push(el);
@@ -6707,27 +6787,62 @@ function schemaSupports(schema, entityName) {
 	return true;
 }
 //#endregion
+//#region src/ifcRuntime.ts
+var wasmLocateFile;
+/**
+* Override how web-ifc finds its `.wasm` file. Applied by every web-ifc entry
+* point in this package — IFC export ({@link toIfc}), import ({@link fromIfc})
+* and validation. Required when brepjs-bim is bundled into a worker that serves
+* the wasm itself; not needed in Node.
+*/
+function setIfcWasmLocateFile(locate) {
+	wasmLocateFile = locate;
+}
+/**
+* Initialize a web-ifc API instance the way this package always wants it: with
+* the host-provided wasm locator and forced single-threaded.
+*
+* Single-threaded matters in a cross-origin-isolated context (e.g. a page that
+* sets COOP/COEP for another WASM kernel): web-ifc would otherwise load its
+* pthread build and spawn a sub-Worker, which fails when brepjs-bim is itself
+* bundled inside a Web Worker. In Node the flag is a no-op (web-ifc is already
+* single-threaded there), and multithreading only speeds up parsing/geometry,
+* not the one-shot serialize/read this package does.
+*/
+async function initIfcApi(api) {
+	await api.Init(wasmLocateFile, true);
+}
+//#endregion
 //#region src/ifc-writer/ifcWriter.ts
 /** Default MVD ViewDefinition declared in the STEP FILE_DESCRIPTION header. */
 var DEFAULT_MVD_VIEW_DEFINITION = "ReferenceView_v1.2";
 var VIEW_DEFINITION_RE = /ViewDefinition \[[^\]]*\]/;
+var FILE_NAME_RE = /(FILE_NAME\('[^']*','[^']*',)(?:\$|\(\$\)),(?:\$|\(\$\)),('[^']*','[^']*'),\$\)/;
+/** STEP single-quoted string literal with embedded quotes doubled per ISO 10303-21. */
+function stepString(value) {
+	return `'${value.replace(/'/g, "''")}'`;
+}
 var IfcWriter = class IfcWriter {
 	#api;
 	#modelId;
 	#mvdViewDefinition;
+	#author;
+	#organization;
 	#nextExpressId = 1;
 	#closed = false;
 	#modelScope = "";
-	constructor(api, modelId, mvdViewDefinition) {
+	constructor(api, modelId, mvdViewDefinition, header) {
 		this.#api = api;
 		this.#modelId = modelId;
 		this.#mvdViewDefinition = mvdViewDefinition;
+		this.#author = header.author ?? "";
+		this.#organization = header.organization ?? "";
 	}
-	static async create(mvdViewDefinition = DEFAULT_MVD_VIEW_DEFINITION, ifcSchema = DEFAULT_IFC_SCHEMA) {
+	static async create(mvdViewDefinition = DEFAULT_MVD_VIEW_DEFINITION, ifcSchema = DEFAULT_IFC_SCHEMA, header = {}) {
 		try {
 			const api = new web_ifc.IfcAPI();
-			await api.Init();
-			return (0, brepjs.ok)(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition));
+			await initIfcApi(api);
+			return (0, brepjs.ok)(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition, header));
 		} catch (e) {
 			return (0, brepjs.err)(ifcError("IFC_INIT_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -6761,7 +6876,7 @@ var IfcWriter = class IfcWriter {
 		if (this.#closed) return (0, brepjs.err)(ifcError("IFC_ALREADY_SAVED", "Model has already been saved and closed"));
 		try {
 			const bytes = this.#api.SaveModel(this.#modelId);
-			return (0, brepjs.ok)(this.#patchMvd(bytes));
+			return (0, brepjs.ok)(this.#patchHeader(bytes));
 		} catch (e) {
 			return (0, brepjs.err)(ifcError("IFC_SAVE_FAILED", "Failed to serialize IFC model", e));
 		} finally {
@@ -6770,21 +6885,20 @@ var IfcWriter = class IfcWriter {
 		}
 	}
 	/**
-	* Injects the declared MVD into the STEP FILE_DESCRIPTION header. web-ifc does
-	* not expose the header's ViewDefinition for configuration, so we rewrite the
-	* empty default in the ASCII header region. If the expected pattern is absent
-	* (e.g. a future web-ifc default change) the bytes are returned unchanged.
+	* Rewrites the STEP header in the ASCII region web-ifc emits: declares the MVD
+	* in FILE_DESCRIPTION and makes FILE_NAME's author/organization/authorization
+	* spec-conformant (web-ifc leaves them as bare `$`). web-ifc exposes neither
+	* for configuration. If an expected pattern is absent (e.g. a future web-ifc
+	* default change) that part is skipped and the bytes returned unchanged.
 	*/
-	#patchMvd(bytes) {
-		if (this.#mvdViewDefinition.length === 0) return bytes;
+	#patchHeader(bytes) {
 		const HEADER_SCAN = Math.min(bytes.byteLength, 2048);
-		const head = new TextDecoder().decode(bytes.subarray(0, HEADER_SCAN));
-		if (!VIEW_DEFINITION_RE.test(head)) {
-			console.warn(`IfcWriter: FILE_DESCRIPTION ViewDefinition not found; MVD "${this.#mvdViewDefinition}" not declared`);
-			return bytes;
-		}
-		const patchedHead = head.replace(VIEW_DEFINITION_RE, `ViewDefinition [${this.#mvdViewDefinition}]`);
-		const patchedHeadBytes = new TextEncoder().encode(patchedHead);
+		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`);
+		const patchedHeadBytes = new TextEncoder().encode(head);
 		const tail = bytes.subarray(HEADER_SCAN);
 		const out = new Uint8Array(patchedHeadBytes.byteLength + tail.byteLength);
 		out.set(patchedHeadBytes, 0);
@@ -8022,7 +8136,7 @@ function writeProfile(w, profile) {
 				OverallDepth: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.overallDepth)),
 				WebThickness: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.webThickness)),
 				FlangeThickness: w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.flangeThickness)),
-				FilletRadius: null,
+				FilletRadius: profile.filletRadius === void 0 ? null : w.mkType(web_ifc.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.filletRadius)),
 				FlangeEdgeRadius: null,
 				FlangeSlope: null
 			});
@@ -11152,35 +11266,6 @@ function checkOpeningExists(issues, elementsById, openingId, code) {
 	if (opening.category !== "OPENING") issues.push(issue("error", code === "VOID_OPENING_MISSING" ? "VOID_OPENING_WRONG_CATEGORY" : "FILL_OPENING_WRONG_CATEGORY", `References opening localId ${openingId}, expected OPENING but found ${opening.category}`, openingId, { actual: opening.category }));
 }
 //#endregion
-//#region src/identity/ifcGuid.ts
-var IFC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
-function newIfcGuid() {
-	const bytes = crypto.getRandomValues(new Uint8Array(16));
-	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
-	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
-	return encodeIfcGuid(bytes);
-}
-function isValidIfcGuid(s) {
-	if (s.length !== 22) return false;
-	for (const ch of s) if (!IFC_CHARS.includes(ch)) return false;
-	return true;
-}
-function encodeIfcGuid(bytes) {
-	let result = "";
-	let acc = 0;
-	let bits = 0;
-	for (const byte of bytes) {
-		acc = acc << 8 | byte;
-		bits += 8;
-		while (bits >= 6) {
-			bits -= 6;
-			result += IFC_CHARS[acc >> bits & 63] ?? "";
-		}
-	}
-	if (bits > 0) result += IFC_CHARS[acc << 6 - bits & 63] ?? "";
-	return result;
-}
-//#endregion
 //#region src/validation/schemaCheck.ts
 /**
 * EXPRESS/STEP self-validation gate.
@@ -11197,7 +11282,7 @@ function encodeIfcGuid(bytes) {
 async function checkSchema(bytes) {
 	if (bytes.byteLength === 0) return appendIssue(emptyReport(), issue("error", "EMPTY_MODEL", "IFC byte buffer is empty; nothing to validate"));
 	const api = new web_ifc.IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	let modelId;
 	try {
 		modelId = api.OpenModel(bytes);
@@ -11291,7 +11376,7 @@ var KEY_ENTITY_TYPES = [
 */
 async function firstPassCounts(bytes) {
 	const api = new web_ifc.IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	const modelId = api.OpenModel(bytes);
 	try {
 		return collectCounts(api, modelId);
@@ -11305,7 +11390,7 @@ async function firstPassCounts(bytes) {
 */
 async function secondPassCounts(bytes) {
 	const api = new web_ifc.IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	const sourceModelId = api.OpenModel(bytes);
 	let resaved;
 	try {
@@ -11369,7 +11454,11 @@ async function checkRoundTrip(bytes) {
 async function toIfc(model, meta) {
 	const project = model.getProject();
 	if (!project) return (0, brepjs.err)(ifcError("NO_PROJECT", "BimModel has no project — call model.init() first"));
-	const writerResult = await IfcWriter.create(meta.mvdViewDefinition, meta.ifcSchema);
+	const authorName = [meta.author?.givenName, meta.author?.familyName].filter((p) => Boolean(p)).join(" ");
+	const writerResult = await IfcWriter.create(meta.mvdViewDefinition, meta.ifcSchema, {
+		author: authorName,
+		organization: meta.organizationName
+	});
 	if (!writerResult.ok) return writerResult;
 	const w = writerResult.value;
 	w.setModelScope(project.guid);
@@ -12014,7 +12103,7 @@ var SpfReader = class SpfReader {
 		let api;
 		try {
 			api = new web_ifc.IfcAPI();
-			await api.Init();
+			await initIfcApi(api);
 		} catch (e) {
 			return (0, brepjs.err)(importError("OPEN_MODEL_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -15911,6 +16000,7 @@ exports.schemaSupports = schemaSupports;
 exports.serializeBcfFiles = serializeBcfFiles;
 exports.serializeCobieToCsv = serializeCobieToCsv;
 exports.serializeCobieToJson = serializeCobieToJson;
+exports.setIfcWasmLocateFile = setIfcWasmLocateFile;
 exports.specError = specError;
 exports.templateFor = templateFor;
 exports.toIfc = toIfc;

package/dist/brepjs-bim.js

@@ -1,8 +1,37 @@
 import { addHoles, applyMatrix, autoHeal, castShape, cut, err, extrude, getKernel, 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
+var IFC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
+function newIfcGuid() {
+	const bytes = crypto.getRandomValues(new Uint8Array(16));
+	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
+	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+	return encodeIfcGuid(bytes);
+}
+function isValidIfcGuid(s) {
+	if (s.length !== 22) return false;
+	if (!"0123".includes(s[0] ?? "")) return false;
+	for (const ch of s) if (!IFC_CHARS.includes(ch)) return false;
+	return true;
+}
+function encodeIfcGuid(bytes) {
+	let result = "";
+	let acc = 0;
+	let bits = 4;
+	for (const byte of bytes) {
+		acc = acc << 8 | byte;
+		bits += 8;
+		while (bits >= 6) {
+			bits -= 6;
+			result += IFC_CHARS[acc >> bits & 63] ?? "";
+		}
+	}
+	if (bits > 0) result += IFC_CHARS[acc << 6 - bits & 63] ?? "";
+	return result;
+}
+//#endregion
 //#region src/identity/guidDerivation.ts
-var IFC_CHARS$1 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
 var NAMESPACE = "brepjs-bim:v1";
 var FNV_OFFSET = 2166136261;
 var FNV_PRIME = 16777619;
@@ -36,7 +65,7 @@ function digest16(stableKey) {
 * keys yield distinct, format-valid (22-char) GlobalIds.
 */
 function deriveIfcGuidSync(stableKey) {
-	return encodeIfcGuid$1(digest16(stableKey));
+	return encodeIfcGuid(digest16(stableKey));
 }
 /**
 * Async wrapper over {@link deriveIfcGuidSync} for callers that prefer a Promise
@@ -63,21 +92,6 @@ function makeRelKey(modelScope, kind, localId) {
 function makeLineKey(modelScope, expressId) {
 	return `line:${modelScope}:${expressId}`;
 }
-function encodeIfcGuid$1(bytes) {
-	let result = "";
-	let acc = 0;
-	let bits = 0;
-	for (const byte of bytes) {
-		acc = acc << 8 | byte;
-		bits += 8;
-		while (bits >= 6) {
-			bits -= 6;
-			result += IFC_CHARS$1[acc >> bits & 63] ?? "";
-		}
-	}
-	if (bits > 0) result += IFC_CHARS$1[acc << 6 - bits & 63] ?? "";
-	return result;
-}
 //#endregion
 //#region src/identity/localId.ts
 function makeLocalIdCounter(start = 1) {
@@ -5070,7 +5084,8 @@ var CoreProfileSchema = discriminatedUnion("kind", [
 		overallWidth: number().positive(),
 		overallDepth: number().positive(),
 		flangeThickness: number().positive(),
-		webThickness: number().positive()
+		webThickness: number().positive(),
+		filletRadius: number().positive().optional()
 	})
 ]);
 var Pt2Schema = tuple([number(), number()]);
@@ -5202,6 +5217,11 @@ function parseProfile(input) {
 	if (profile.kind === "I_BEAM") {
 		if (2 * profile.flangeThickness >= profile.overallDepth) return err(specError("INVALID_PROFILE", "I-beam flangeThickness × 2 must be less than overallDepth"));
 		if (profile.webThickness >= profile.overallWidth) return err(specError("INVALID_PROFILE", "I-beam webThickness must be less than overallWidth"));
+		if (profile.filletRadius !== void 0) {
+			const clearHeight = profile.overallDepth / 2 - profile.flangeThickness;
+			const clearSpan = (profile.overallWidth - profile.webThickness) / 2;
+			if (profile.filletRadius >= clearHeight || profile.filletRadius >= clearSpan) return err(specError("INVALID_PROFILE", "I-beam filletRadius must be smaller than the clear web height and the clear span beside the web"));
+		}
 	}
 	return ok(profile);
 }
@@ -5212,8 +5232,42 @@ function profileCrossSectionArea(profile) {
 	switch (profile.kind) {
 		case "RECTANGULAR": return profile.width * profile.height;
 		case "CIRCULAR": return Math.PI * profile.radius * profile.radius;
-		case "I_BEAM": return 2 * profile.overallWidth * profile.flangeThickness + (profile.overallDepth - 2 * profile.flangeThickness) * profile.webThickness;
+		case "I_BEAM": {
+			const flangeArea = 2 * profile.overallWidth * profile.flangeThickness;
+			const webArea = (profile.overallDepth - 2 * profile.flangeThickness) * profile.webThickness;
+			const r = profile.filletRadius ?? 0;
+			const filletArea = 4 * r * r * (1 - Math.PI / 4);
+			return flangeArea + webArea + filletArea;
+		}
+	}
+}
+var FILLET_SEGMENTS = 8;
+var FILLET_MIN_ANGLE = .001;
+function filletArc(prev, v, next, r) {
+	const aLen = Math.hypot(prev[0] - v[0], prev[1] - v[1]);
+	const bLen = Math.hypot(next[0] - v[0], next[1] - v[1]);
+	const a = [(prev[0] - v[0]) / aLen, (prev[1] - v[1]) / aLen];
+	const b = [(next[0] - v[0]) / bLen, (next[1] - v[1]) / bLen];
+	const alpha = Math.acos(Math.max(-1, Math.min(1, a[0] * b[0] + a[1] * b[1])));
+	if (alpha < FILLET_MIN_ANGLE || alpha > Math.PI - FILLET_MIN_ANGLE) return [[v[0], v[1]]];
+	const setback = r / Math.tan(alpha / 2);
+	const center = r / Math.sin(alpha / 2);
+	const bisLen = Math.hypot(a[0] + b[0], a[1] + b[1]);
+	const bis = [(a[0] + b[0]) / bisLen, (a[1] + b[1]) / bisLen];
+	const cx = v[0] + bis[0] * center;
+	const cy = v[1] + bis[1] * center;
+	const p1 = [v[0] + a[0] * setback, v[1] + a[1] * setback];
+	const p2 = [v[0] + b[0] * setback, v[1] + b[1] * setback];
+	const a1 = Math.atan2(p1[1] - cy, p1[0] - cx);
+	let delta = Math.atan2(p2[1] - cy, p2[0] - cx) - a1;
+	while (delta <= -Math.PI) delta += 2 * Math.PI;
+	while (delta > Math.PI) delta -= 2 * Math.PI;
+	const out = [];
+	for (let i = 0; i <= FILLET_SEGMENTS; i++) {
+		const ang = a1 + delta * i / FILLET_SEGMENTS;
+		out.push([cx + r * Math.cos(ang), cy + r * Math.sin(ang)]);
 	}
+	return out;
 }
 function profileToPolygon(profile, circleSegments = 32) {
 	if (isExtendedProfile(profile)) return err(specError("EXTENDED_PROFILE_NO_POLYGON", `profileToPolygon: extended profile kind '${profile.kind}' has no single-polygon outline; use extendedProfileToFace()`));
@@ -5262,68 +5316,50 @@ function profileToPolygon(profile, circleSegments = 32) {
 			const halfD = profile.overallDepth / 2;
 			const halfWeb = profile.webThickness / 2;
 			const flangeInnerY = halfD - profile.flangeThickness;
-			return ok([
-				[
-					-halfW,
-					-halfD,
-					0
-				],
-				[
-					halfW,
-					-halfD,
-					0
-				],
-				[
-					halfW,
-					-flangeInnerY,
-					0
-				],
-				[
-					halfWeb,
-					-flangeInnerY,
-					0
-				],
-				[
-					halfWeb,
-					flangeInnerY,
-					0
-				],
-				[
-					halfW,
-					flangeInnerY,
-					0
-				],
-				[
-					halfW,
-					halfD,
-					0
-				],
-				[
-					-halfW,
-					halfD,
-					0
-				],
-				[
-					-halfW,
-					flangeInnerY,
-					0
-				],
-				[
-					-halfWeb,
-					flangeInnerY,
-					0
-				],
-				[
-					-halfWeb,
-					-flangeInnerY,
-					0
-				],
-				[
-					-halfW,
-					-flangeInnerY,
-					0
-				]
+			const v = [
+				[-halfW, -halfD],
+				[halfW, -halfD],
+				[halfW, -flangeInnerY],
+				[halfWeb, -flangeInnerY],
+				[halfWeb, flangeInnerY],
+				[halfW, flangeInnerY],
+				[halfW, halfD],
+				[-halfW, halfD],
+				[-halfW, flangeInnerY],
+				[-halfWeb, flangeInnerY],
+				[-halfWeb, -flangeInnerY],
+				[-halfW, -flangeInnerY]
+			];
+			const r = profile.filletRadius ?? 0;
+			const rootCorners = new Set([
+				3,
+				4,
+				9,
+				10
 			]);
+			const pts = [];
+			for (let i = 0; i < v.length; i++) {
+				const cur = v[i];
+				if (cur === void 0) continue;
+				if (r > 0 && rootCorners.has(i)) {
+					const prev = v[(i - 1 + v.length) % v.length];
+					const next = v[(i + 1) % v.length];
+					if (prev !== void 0 && next !== void 0) {
+						for (const [ax, ay] of filletArc(prev, cur, next, r)) pts.push([
+							ax,
+							ay,
+							0
+						]);
+						continue;
+					}
+				}
+				pts.push([
+					cur[0],
+					cur[1],
+					0
+				]);
+			}
+			return ok(pts);
 		}
 	}
 }
@@ -6507,6 +6543,50 @@ var BimModel = class {
 	getElement(id) {
 		return this.#elements.get(id) ?? null;
 	}
+	/**
+	* A serializable summary of the model's structure, rooted at the project and
+	* walking the IFC spatial hierarchy (AGGREGATES: project → site → building →
+	* storey) plus the elements contained in each storey (placeIn). Useful for a
+	* read-only tree view of the model across a worker boundary.
+	*/
+	toTreeSummary() {
+		const aggregated = /* @__PURE__ */ new Map();
+		const contained = /* @__PURE__ */ new Map();
+		for (const rel of this.#relationships.values()) if (rel.kind === "AGGREGATES") {
+			const list = aggregated.get(rel.relatingObject) ?? [];
+			list.push(...rel.relatedObjects);
+			aggregated.set(rel.relatingObject, list);
+		} else if (rel.kind === "CONTAINED_IN") {
+			const list = contained.get(rel.relatingStructure) ?? [];
+			list.push(...rel.relatedElements);
+			contained.set(rel.relatingStructure, list);
+		}
+		const labelFor = (el) => {
+			const spec = el.spec;
+			const base = typeof spec.name === "string" && spec.name.length > 0 ? spec.name : el.category;
+			return el.category === "STOREY" && typeof spec.elevation === "number" ? `${base} (+${spec.elevation} mm)` : base;
+		};
+		const seen = /* @__PURE__ */ new Set();
+		const build = (id) => {
+			if (seen.has(id)) return null;
+			seen.add(id);
+			const el = this.#elements.get(id);
+			if (el === void 0) return null;
+			const children = [...aggregated.get(id) ?? [], ...contained.get(id) ?? []].map(build).filter((n) => n !== null);
+			return {
+				id,
+				label: labelFor(el),
+				category: el.category,
+				children
+			};
+		};
+		const root = this.#projectId !== null ? build(this.#projectId) : null;
+		const countNodes = (node) => 1 + node.children.reduce((sum, c) => sum + countNodes(c), 0);
+		return {
+			root,
+			elementCount: root ? countNodes(root) : 0
+		};
+	}
 	getWalls() {
 		const walls = [];
 		for (const el of this.#elements.values()) if (el.category === "WALL") walls.push(el);
@@ -6684,27 +6764,62 @@ function schemaSupports(schema, entityName) {
 	return true;
 }
 //#endregion
+//#region src/ifcRuntime.ts
+var wasmLocateFile;
+/**
+* Override how web-ifc finds its `.wasm` file. Applied by every web-ifc entry
+* point in this package — IFC export ({@link toIfc}), import ({@link fromIfc})
+* and validation. Required when brepjs-bim is bundled into a worker that serves
+* the wasm itself; not needed in Node.
+*/
+function setIfcWasmLocateFile(locate) {
+	wasmLocateFile = locate;
+}
+/**
+* Initialize a web-ifc API instance the way this package always wants it: with
+* the host-provided wasm locator and forced single-threaded.
+*
+* Single-threaded matters in a cross-origin-isolated context (e.g. a page that
+* sets COOP/COEP for another WASM kernel): web-ifc would otherwise load its
+* pthread build and spawn a sub-Worker, which fails when brepjs-bim is itself
+* bundled inside a Web Worker. In Node the flag is a no-op (web-ifc is already
+* single-threaded there), and multithreading only speeds up parsing/geometry,
+* not the one-shot serialize/read this package does.
+*/
+async function initIfcApi(api) {
+	await api.Init(wasmLocateFile, true);
+}
+//#endregion
 //#region src/ifc-writer/ifcWriter.ts
 /** Default MVD ViewDefinition declared in the STEP FILE_DESCRIPTION header. */
 var DEFAULT_MVD_VIEW_DEFINITION = "ReferenceView_v1.2";
 var VIEW_DEFINITION_RE = /ViewDefinition \[[^\]]*\]/;
+var FILE_NAME_RE = /(FILE_NAME\('[^']*','[^']*',)(?:\$|\(\$\)),(?:\$|\(\$\)),('[^']*','[^']*'),\$\)/;
+/** STEP single-quoted string literal with embedded quotes doubled per ISO 10303-21. */
+function stepString(value) {
+	return `'${value.replace(/'/g, "''")}'`;
+}
 var IfcWriter = class IfcWriter {
 	#api;
 	#modelId;
 	#mvdViewDefinition;
+	#author;
+	#organization;
 	#nextExpressId = 1;
 	#closed = false;
 	#modelScope = "";
-	constructor(api, modelId, mvdViewDefinition) {
+	constructor(api, modelId, mvdViewDefinition, header) {
 		this.#api = api;
 		this.#modelId = modelId;
 		this.#mvdViewDefinition = mvdViewDefinition;
+		this.#author = header.author ?? "";
+		this.#organization = header.organization ?? "";
 	}
-	static async create(mvdViewDefinition = DEFAULT_MVD_VIEW_DEFINITION, ifcSchema = DEFAULT_IFC_SCHEMA) {
+	static async create(mvdViewDefinition = DEFAULT_MVD_VIEW_DEFINITION, ifcSchema = DEFAULT_IFC_SCHEMA, header = {}) {
 		try {
 			const api = new IfcAPI();
-			await api.Init();
-			return ok(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition));
+			await initIfcApi(api);
+			return ok(new IfcWriter(api, api.CreateModel({ schema: fileSchemaString(ifcSchema) }), mvdViewDefinition, header));
 		} catch (e) {
 			return err(ifcError("IFC_INIT_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -6738,7 +6853,7 @@ var IfcWriter = class IfcWriter {
 		if (this.#closed) return err(ifcError("IFC_ALREADY_SAVED", "Model has already been saved and closed"));
 		try {
 			const bytes = this.#api.SaveModel(this.#modelId);
-			return ok(this.#patchMvd(bytes));
+			return ok(this.#patchHeader(bytes));
 		} catch (e) {
 			return err(ifcError("IFC_SAVE_FAILED", "Failed to serialize IFC model", e));
 		} finally {
@@ -6747,21 +6862,20 @@ var IfcWriter = class IfcWriter {
 		}
 	}
 	/**
-	* Injects the declared MVD into the STEP FILE_DESCRIPTION header. web-ifc does
-	* not expose the header's ViewDefinition for configuration, so we rewrite the
-	* empty default in the ASCII header region. If the expected pattern is absent
-	* (e.g. a future web-ifc default change) the bytes are returned unchanged.
+	* Rewrites the STEP header in the ASCII region web-ifc emits: declares the MVD
+	* in FILE_DESCRIPTION and makes FILE_NAME's author/organization/authorization
+	* spec-conformant (web-ifc leaves them as bare `$`). web-ifc exposes neither
+	* for configuration. If an expected pattern is absent (e.g. a future web-ifc
+	* default change) that part is skipped and the bytes returned unchanged.
 	*/
-	#patchMvd(bytes) {
-		if (this.#mvdViewDefinition.length === 0) return bytes;
+	#patchHeader(bytes) {
 		const HEADER_SCAN = Math.min(bytes.byteLength, 2048);
-		const head = new TextDecoder().decode(bytes.subarray(0, HEADER_SCAN));
-		if (!VIEW_DEFINITION_RE.test(head)) {
-			console.warn(`IfcWriter: FILE_DESCRIPTION ViewDefinition not found; MVD "${this.#mvdViewDefinition}" not declared`);
-			return bytes;
-		}
-		const patchedHead = head.replace(VIEW_DEFINITION_RE, `ViewDefinition [${this.#mvdViewDefinition}]`);
-		const patchedHeadBytes = new TextEncoder().encode(patchedHead);
+		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`);
+		const patchedHeadBytes = new TextEncoder().encode(head);
 		const tail = bytes.subarray(HEADER_SCAN);
 		const out = new Uint8Array(patchedHeadBytes.byteLength + tail.byteLength);
 		out.set(patchedHeadBytes, 0);
@@ -7999,7 +8113,7 @@ function writeProfile(w, profile) {
 				OverallDepth: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.overallDepth)),
 				WebThickness: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.webThickness)),
 				FlangeThickness: w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.flangeThickness)),
-				FilletRadius: null,
+				FilletRadius: profile.filletRadius === void 0 ? null : w.mkType(WebIFC.IFCPOSITIVELENGTHMEASURE, toIfcLengthM(profile.filletRadius)),
 				FlangeEdgeRadius: null,
 				FlangeSlope: null
 			});
@@ -11129,35 +11243,6 @@ function checkOpeningExists(issues, elementsById, openingId, code) {
 	if (opening.category !== "OPENING") issues.push(issue("error", code === "VOID_OPENING_MISSING" ? "VOID_OPENING_WRONG_CATEGORY" : "FILL_OPENING_WRONG_CATEGORY", `References opening localId ${openingId}, expected OPENING but found ${opening.category}`, openingId, { actual: opening.category }));
 }
 //#endregion
-//#region src/identity/ifcGuid.ts
-var IFC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
-function newIfcGuid() {
-	const bytes = crypto.getRandomValues(new Uint8Array(16));
-	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
-	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
-	return encodeIfcGuid(bytes);
-}
-function isValidIfcGuid(s) {
-	if (s.length !== 22) return false;
-	for (const ch of s) if (!IFC_CHARS.includes(ch)) return false;
-	return true;
-}
-function encodeIfcGuid(bytes) {
-	let result = "";
-	let acc = 0;
-	let bits = 0;
-	for (const byte of bytes) {
-		acc = acc << 8 | byte;
-		bits += 8;
-		while (bits >= 6) {
-			bits -= 6;
-			result += IFC_CHARS[acc >> bits & 63] ?? "";
-		}
-	}
-	if (bits > 0) result += IFC_CHARS[acc << 6 - bits & 63] ?? "";
-	return result;
-}
-//#endregion
 //#region src/validation/schemaCheck.ts
 /**
 * EXPRESS/STEP self-validation gate.
@@ -11174,7 +11259,7 @@ function encodeIfcGuid(bytes) {
 async function checkSchema(bytes) {
 	if (bytes.byteLength === 0) return appendIssue(emptyReport(), issue("error", "EMPTY_MODEL", "IFC byte buffer is empty; nothing to validate"));
 	const api = new WebIFC.IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	let modelId;
 	try {
 		modelId = api.OpenModel(bytes);
@@ -11268,7 +11353,7 @@ var KEY_ENTITY_TYPES = [
 */
 async function firstPassCounts(bytes) {
 	const api = new IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	const modelId = api.OpenModel(bytes);
 	try {
 		return collectCounts(api, modelId);
@@ -11282,7 +11367,7 @@ async function firstPassCounts(bytes) {
 */
 async function secondPassCounts(bytes) {
 	const api = new IfcAPI();
-	await api.Init();
+	await initIfcApi(api);
 	const sourceModelId = api.OpenModel(bytes);
 	let resaved;
 	try {
@@ -11346,7 +11431,11 @@ async function checkRoundTrip(bytes) {
 async function toIfc(model, meta) {
 	const project = model.getProject();
 	if (!project) return err(ifcError("NO_PROJECT", "BimModel has no project — call model.init() first"));
-	const writerResult = await IfcWriter.create(meta.mvdViewDefinition, meta.ifcSchema);
+	const authorName = [meta.author?.givenName, meta.author?.familyName].filter((p) => Boolean(p)).join(" ");
+	const writerResult = await IfcWriter.create(meta.mvdViewDefinition, meta.ifcSchema, {
+		author: authorName,
+		organization: meta.organizationName
+	});
 	if (!writerResult.ok) return writerResult;
 	const w = writerResult.value;
 	w.setModelScope(project.guid);
@@ -11991,7 +12080,7 @@ var SpfReader = class SpfReader {
 		let api;
 		try {
 			api = new IfcAPI();
-			await api.Init();
+			await initIfcApi(api);
 		} catch (e) {
 			return err(importError("OPEN_MODEL_FAILED", "Failed to initialize web-ifc", e));
 		}
@@ -15819,4 +15908,4 @@ function assignNum(target, key, value) {
 	if (value !== void 0) target[key] = Number(value);
 }
 //#endregion
-export { BimModel, DEFAULT_IFC_SCHEMA, DEFAULT_UNITS, IFC_SCHEMAS, PSET_PROPERTY_TYPE_TABLE, PSET_TEMPLATES, SpfReader, bcfError, checkGeometryValidity, checkModelAgainstIds as checkIds, checkModelAgainstIds, checkReferentialIntegrity, checkRoundTrip, checkSchema, countBySeverity, deriveCobieModel, deriveCobieModel as exportCobie, deriveIfcGuid, deriveIfcGuidSync, disposeImportedModel, emptyReport, extendedProfileArea, extendedProfileToFace, fileSchemaString, fromBrepError, fromIfc, geometryError, hasErrors, idsError, ifcError, importError, isExtendedProfile, isIfcSchema, isSlabOpening, isValidIfcGuid, isWallOpening, issue, makeLocalIdCounter, measureTypeFor, newIfcGuid, parseBcfFiles, parseBeamSpec, parseColumnSpec, parseCoveringSpec, parseCurtainWallSpec, parseDoorSpec, parseElementAssemblySpec, parseFootingSpec, parseIdsXml, parsePileSpec, parseProfile, parseRailingSpec, parseRampFlightSpec, parseRampSpec, parseRoofSpec, parseSlabOpeningInput, parseSlabSpec, parseSpaceSpec, parseStairFlightSpec, parseStairSpec, parseSurfaceStyleSpec, parseSystemSpec, parseWallSpec, parseWindowSpec, parseZoneSpec, schemaSupports, serializeBcfFiles, serializeCobieToCsv, serializeCobieToJson, specError, templateFor, toIfc, toIfcLengthM, toIfcValidated, toLengthMm, writeClassificationRefs, writeElementAssemblyEntity, writeIfcType, writeMaterialLayerSet, writeMaterialProfileSet, writeMaterialSimple, writePresentationLayer, writeRelAggregatesElements, writeRelAssignsToGroup, writeRelConnectsElements, writeRelConnectsPathElements, writeRelNests, writeStyledItem, writeSurfaceStyle, writeSystemEntity, writeZoneEntity };
+export { BimModel, DEFAULT_IFC_SCHEMA, DEFAULT_UNITS, IFC_SCHEMAS, PSET_PROPERTY_TYPE_TABLE, PSET_TEMPLATES, SpfReader, bcfError, checkGeometryValidity, checkModelAgainstIds as checkIds, checkModelAgainstIds, checkReferentialIntegrity, checkRoundTrip, checkSchema, countBySeverity, deriveCobieModel, deriveCobieModel as exportCobie, deriveIfcGuid, deriveIfcGuidSync, disposeImportedModel, emptyReport, extendedProfileArea, extendedProfileToFace, fileSchemaString, fromBrepError, fromIfc, geometryError, hasErrors, idsError, ifcError, importError, isExtendedProfile, isIfcSchema, isSlabOpening, isValidIfcGuid, isWallOpening, issue, makeLocalIdCounter, measureTypeFor, newIfcGuid, parseBcfFiles, parseBeamSpec, parseColumnSpec, parseCoveringSpec, parseCurtainWallSpec, parseDoorSpec, parseElementAssemblySpec, parseFootingSpec, parseIdsXml, parsePileSpec, parseProfile, parseRailingSpec, parseRampFlightSpec, parseRampSpec, parseRoofSpec, parseSlabOpeningInput, parseSlabSpec, parseSpaceSpec, parseStairFlightSpec, parseStairSpec, parseSurfaceStyleSpec, parseSystemSpec, parseWallSpec, parseWindowSpec, parseZoneSpec, schemaSupports, serializeBcfFiles, serializeCobieToCsv, serializeCobieToJson, setIfcWasmLocateFile, specError, templateFor, toIfc, toIfcLengthM, toIfcValidated, toLengthMm, writeClassificationRefs, writeElementAssemblyEntity, writeIfcType, writeMaterialLayerSet, writeMaterialProfileSet, writeMaterialSimple, writePresentationLayer, writeRelAggregatesElements, writeRelAssignsToGroup, writeRelConnectsElements, writeRelConnectsPathElements, writeRelNests, writeStyledItem, writeSurfaceStyle, writeSystemEntity, writeZoneEntity };

package/dist/identity/ifcGuid.d.ts

@@ -4,4 +4,5 @@ export type IfcGuid = string & {
 };
 export declare function newIfcGuid(): IfcGuid;
 export declare function isValidIfcGuid(s: string): s is IfcGuid;
+export declare function encodeIfcGuid(bytes: Uint8Array): IfcGuid;
 export {};

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

@@ -5,10 +5,14 @@ import { IfcSchema } from './schemaVersion.js';
 import { Result } from 'brepjs';
 /** Default MVD ViewDefinition declared in the STEP FILE_DESCRIPTION header. */
 export declare const DEFAULT_MVD_VIEW_DEFINITION = "ReferenceView_v1.2";
+export interface IfcHeaderMeta {
+    readonly author?: string | undefined;
+    readonly organization?: string | undefined;
+}
 export declare class IfcWriter {
     #private;
     private constructor();
-    static create(mvdViewDefinition?: string, ifcSchema?: IfcSchema): Promise<Result<IfcWriter, BimError>>;
+    static create(mvdViewDefinition?: string, ifcSchema?: IfcSchema, header?: IfcHeaderMeta): Promise<Result<IfcWriter, BimError>>;
     nextId(): number;
     /**
      * Deterministic GlobalId for a writer-minted line, keyed on its express ID.

package/dist/ifcRuntime.d.ts

@@ -0,0 +1,20 @@
+import { IfcAPI } from 'web-ifc';
+/**
+ * Override how web-ifc finds its `.wasm` file. Applied by every web-ifc entry
+ * point in this package — IFC export ({@link toIfc}), import ({@link fromIfc})
+ * and validation. Required when brepjs-bim is bundled into a worker that serves
+ * the wasm itself; not needed in Node.
+ */
+export declare function setIfcWasmLocateFile(locate: ((path: string, prefix: string) => string) | undefined): void;
+/**
+ * Initialize a web-ifc API instance the way this package always wants it: with
+ * the host-provided wasm locator and forced single-threaded.
+ *
+ * Single-threaded matters in a cross-origin-isolated context (e.g. a page that
+ * sets COOP/COEP for another WASM kernel): web-ifc would otherwise load its
+ * pthread build and spawn a sub-Worker, which fails when brepjs-bim is itself
+ * bundled inside a Web Worker. In Node the flag is a no-op (web-ifc is already
+ * single-threaded there), and multithreading only speeds up parsing/geometry,
+ * not the one-shot serialize/read this package does.
+ */
+export declare function initIfcApi(api: IfcAPI): Promise<void>;

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { BimModel } from './model/bimModel.js';
+export type { BimTreeNode, BimTreeSummary } from './model/treeSummary.js';
 export { toIfc, toIfcValidated } from './serialize/toIfc.js';
 export type { ValidatedIfcResult } from './serialize/toIfc.js';
+export { setIfcWasmLocateFile } from './ifcRuntime.js';
 export { fromIfc } from './import/fromIfc.js';
 export { disposeImportedModel } from './import/importedModel.js';
 export type { FromIfcOptions } from './import/fromIfc.js';

package/dist/model/bimModel.d.ts

@@ -2,6 +2,7 @@ import { Result } from 'brepjs';
 import { LocalId } from '../identity/localId.js';
 import { BimError } from '../errors/bimError.js';
 import { AnyBimElement, BimElement } from '../types/bimTypes.js';
+import { BimTreeSummary } from './treeSummary.js';
 import { BimRelationship } from '../types/relationships.js';
 import { ClassificationRef } from '../types/classificationTypes.js';
 import { WallSpec } from '../specs/wallSpec.js';
@@ -129,6 +130,13 @@ export declare class BimModel {
     placeIn(elementId: LocalId, containerId: LocalId): void;
     getProject(): BimElement<'PROJECT'> | null;
     getElement(id: LocalId): AnyBimElement | null;
+    /**
+     * A serializable summary of the model's structure, rooted at the project and
+     * walking the IFC spatial hierarchy (AGGREGATES: project → site → building →
+     * storey) plus the elements contained in each storey (placeIn). Useful for a
+     * read-only tree view of the model across a worker boundary.
+     */
+    toTreeSummary(): BimTreeSummary;
     getWalls(): BimElement<'WALL'>[];
     getSlabs(): BimElement<'SLAB'>[];
     getBeams(): BimElement<'BEAM'>[];

package/dist/model/treeSummary.d.ts

@@ -0,0 +1,21 @@
+import { BimCategory } from '../types/bimTypes.js';
+/**
+ * A node in a {@link BimModel}'s spatial/decomposition tree. Fully serializable
+ * (plain numbers/strings) so it can be posted across a worker boundary.
+ */
+export interface BimTreeNode {
+    /** The element's local id. */
+    readonly id: number;
+    /** Display label — the element's name, or its category when unnamed. */
+    readonly label: string;
+    /** The element's IFC category. */
+    readonly category: BimCategory;
+    readonly children: readonly BimTreeNode[];
+}
+/** A serializable summary of a model's structure, rooted at the project. */
+export interface BimTreeSummary {
+    /** The project node and its nested spatial structure + contained elements. */
+    readonly root: BimTreeNode | null;
+    /** Number of nodes in the tree (the project and everything reachable from it). */
+    readonly elementCount: number;
+}

package/dist/specs/profile.d.ts

@@ -17,6 +17,7 @@ export type IShapeProfile = {
     readonly overallDepth: number;
     readonly flangeThickness: number;
     readonly webThickness: number;
+    readonly filletRadius?: number | undefined;
 };
 export type CoreProfile = RectangularProfile | CircularProfile | IShapeProfile;
 export type Profile = CoreProfile | ExtendedProfile;
@@ -35,6 +36,7 @@ export declare const ProfileSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion
     overallDepth: z.ZodNumber;
     flangeThickness: z.ZodNumber;
     webThickness: z.ZodNumber;
+    filletRadius: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "kind">, z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"L_SHAPE">;
     depth: z.ZodNumber;

package/package.json

@@ -1,23 +1,40 @@
 {
   "name": "brepjs-bim",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
-  "keywords": ["bim", "ifc", "cad", "brep"],
+  "keywords": [
+    "bim",
+    "ifc",
+    "cad",
+    "brep"
+  ],
   "author": "Andy Aragon",
   "license": "Apache-2.0",
+  "repository": { "type": "git", "url": "https://github.com/andymai/brepjs", "directory": "packages/brepjs-bim" },
   "type": "module",
   "sideEffects": false,
-  "engines": { "node": ">=24" },
+  "engines": {
+    "node": ">=24"
+  },
   "main": "./dist/brepjs-bim.cjs",
   "module": "./dist/brepjs-bim.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": { "types": "./dist/index.d.ts", "default": "./dist/brepjs-bim.js" },
-      "require": { "types": "./dist/index.d.ts", "default": "./dist/brepjs-bim.cjs" }
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/brepjs-bim.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/brepjs-bim.cjs"
+      }
     }
   },
-  "files": ["dist", "LICENSE"],
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "vite build",
     "typecheck": "tsc --noEmit",