brepjs 20.12.7 → 20.12.9

package/dist/brepjs.cjs

@@ -1,42 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-BW-eSwOZ.cjs");
-const require_shapeTypes = require("./shapeTypes-MUEH4XuH.cjs");
-const require_occtWasmAdapter = require("./occtWasmAdapter-D3qerQTq.cjs");
+const require_shapeTypes = require("./shapeTypes--7XBFlOD.cjs");
+const require_occtWasmAdapter = require("./occtWasmAdapter-CZPZnpCe.cjs");
 const require_bug = require("./bug-CBcpIPuf.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-C_fXO6xL.cjs");
-const require_validityTypes = require("./validityTypes-CGX2ES81.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-NszVx8a0.cjs");
+const require_validityTypes = require("./validityTypes-Ds4zNICF.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
 const require_types = require("./types-CjF9Rofr.cjs");
 const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
 const require_planeOps = require("./planeOps-DZfLToKZ.cjs");
-const require_faceFns = require("./faceFns-C-2ttg8X.cjs");
-const require_originTrackingFns = require("./originTrackingFns-rEKOAP65.cjs");
-const require_solidBuilders = require("./solidBuilders-DdG4NPHM.cjs");
-const require_primitiveFns = require("./primitiveFns-CLGVLwG8.cjs");
-const require_shapeFns = require("./shapeFns-SgIrOjN4.cjs");
-const require_curveFns = require("./curveFns-BAM7QHrP.cjs");
-const require_meshFns = require("./meshFns-BeubBqEI.cjs");
+const require_faceFns = require("./faceFns-BDqVGEoB.cjs");
+const require_solidBuilders = require("./solidBuilders-D0bIZX9K.cjs");
+const require_booleanFns = require("./booleanFns-C640CeaY.cjs");
+const require_primitiveFns = require("./primitiveFns-Dg_XWYtp.cjs");
+const require_shapeFns = require("./shapeFns-DuxfaqTw.cjs");
+const require_curveFns = require("./curveFns-Cqgtmhr0.cjs");
+const require_meshFns = require("./meshFns-DDgZ3vpr.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-DOmDVuMs.cjs");
-const require_healingFns = require("./healingFns-DZkO5okn.cjs");
-const require_threadFns = require("./threadFns-1H60LrFX.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BG--DxWB.cjs");
-const require_helpers = require("./helpers-BdGGaLhF.cjs");
-const require_blueprint = require("./blueprint-17RUHsoP.cjs");
-const require_drawFns = require("./drawFns-d-RvC6u6.cjs");
-const require_measureFns = require("./measureFns-BdSjw5fr.cjs");
-const require_cornerFinder = require("./cornerFinder-e4Wc7_yp.cjs");
-const require_boolean2D = require("./boolean2D-7SQ3B0pC.cjs");
-const require_blueprintFns = require("./blueprintFns-Dw5_4_Bk.cjs");
-const require_importFns = require("./importFns-DLiP26NW.cjs");
-const require_textBlueprints = require("./textBlueprints-B7Vhr0xu.cjs");
-const require_loftFns = require("./loftFns-DGV1z2NJ.cjs");
-const require_refResolveFns = require("./refResolveFns-DNX0bCrP.cjs");
-const require_adjacencyFns = require("./adjacencyFns-mMmTBUBY.cjs");
-const require_cameraFns = require("./cameraFns-BAtzhCYM.cjs");
-const require_textMetrics = require("./textMetrics-C6_kSht6.cjs");
-const require_principalBoxFns = require("./principalBoxFns-CiXzjOkr.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-CPQHyL_5.cjs");
+const require_healingFns = require("./healingFns-Fu7Xl8fu.cjs");
+const require_threadFns = require("./threadFns-e8_26ZYw.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-B5CFmhjg.cjs");
+const require_helpers = require("./helpers-Wnq-YPWv.cjs");
+const require_blueprint = require("./blueprint-DbJVzU9F.cjs");
+const require_drawFns = require("./drawFns-GwVZX47o.cjs");
+const require_measureFns = require("./measureFns-DGm6ndQY.cjs");
+const require_cornerFinder = require("./cornerFinder-ByBGU0r7.cjs");
+const require_boolean2D = require("./boolean2D-CFKg1FJ_.cjs");
+const require_blueprintFns = require("./blueprintFns-DePTHG1I.cjs");
+const require_importFns = require("./importFns-tHr15Lhm.cjs");
+const require_textBlueprints = require("./textBlueprints-B4HzJzZM.cjs");
+const require_loftFns = require("./loftFns-T0GxcPlB.cjs");
+const require_refResolveFns = require("./refResolveFns-CFwsYCKA.cjs");
+const require_adjacencyFns = require("./adjacencyFns-CfhGIMeR.cjs");
+const require_cameraFns = require("./cameraFns-hXUKJkLg.cjs");
+const require_textMetrics = require("./textMetrics-CBwUIDI7.cjs");
+const require_principalBoxFns = require("./principalBoxFns-B5zdek3y.cjs");
 const require_workerPool = require("./workerPool-D5tiNXrI.cjs");
 // src/kernel/types.ts
 /** Check if the kernel supports hidden-line-removal projection. */
@@ -2023,7 +2023,7 @@ function shell$1(target, refs, thickness) {
 *  handle before coloring, so plain consumers of the same subtree stay
 *  metadata-free. */
 function color(target, input) {
-	const rgba = require_solidBuilders.parseColor(input).map((c) => Math.min(1, Math.max(0, c)));
+	const rgba = require_booleanFns.parseColor(input).map((c) => Math.min(1, Math.max(0, c)));
 	let h = mix(startHash("Color"), target);
 	for (const c of rgba) h = fnvMixNumber(h, c);
 	return {
@@ -2489,7 +2489,7 @@ function evalFuse(node, ctx) {
 	if (!a.ok) return a;
 	const b = resolveOperand(ctx, node.b, "Fuse.b");
 	if (!b.ok) return b;
-	return require_solidBuilders.fuse(a.value, b.value, boolOptions(node, ctx));
+	return require_booleanFns.fuse(a.value, b.value, boolOptions(node, ctx));
 }
 function evalCut(node, ctx) {
 	if (node.a.kind === "Empty") return emptyResult$1("Cut");
@@ -2498,7 +2498,7 @@ function evalCut(node, ctx) {
 	if (!a.ok) return a;
 	const b = resolveOperand(ctx, node.b, "Cut.b");
 	if (!b.ok) return b;
-	return require_solidBuilders.cut(a.value, b.value, boolOptions(node, ctx));
+	return require_booleanFns.cut(a.value, b.value, boolOptions(node, ctx));
 }
 function evalIntersect(node, ctx) {
 	if (node.a.kind === "Empty" || node.b.kind === "Empty") return emptyResult$1("Intersect");
@@ -2506,7 +2506,7 @@ function evalIntersect(node, ctx) {
 	if (!a.ok) return a;
 	const b = resolveOperand(ctx, node.b, "Intersect.b");
 	if (!b.ok) return b;
-	return require_solidBuilders.intersect(a.value, b.value, boolOptions(node, ctx));
+	return require_booleanFns.intersect(a.value, b.value, boolOptions(node, ctx));
 }
 function resolveAll(ctx, nodes, where) {
 	const out = [];
@@ -2523,7 +2523,7 @@ function evalFuseAll(node, ctx) {
 	if (non.length === 1 && non[0]) return ctx.evalNode(non[0]);
 	const resolved = resolveAll(ctx, non, "FuseAll.operand");
 	if (!resolved.ok) return resolved;
-	return require_solidBuilders.fuseAll(resolved.value, boolOptions(node, ctx));
+	return require_booleanFns.fuseAll(resolved.value, boolOptions(node, ctx));
 }
 function evalCutAll(node, ctx) {
 	if (node.base.kind === "Empty") return emptyResult$1("CutAll");
@@ -2533,7 +2533,7 @@ function evalCutAll(node, ctx) {
 	if (!base.ok) return base;
 	const resolved = resolveAll(ctx, tools, "CutAll.tool");
 	if (!resolved.ok) return resolved;
-	return require_solidBuilders.cutAll(base.value, resolved.value, boolOptions(node, ctx));
+	return require_booleanFns.cutAll(base.value, resolved.value, boolOptions(node, ctx));
 }
 // src/csg/evaluators/transforms.ts
 function emptyResult(kind) {
@@ -2566,7 +2566,7 @@ function relocate(shape, ops) {
 	} finally {
 		dispose();
 	}
-	if (require_solidBuilders.hasAnyMetadata(shape)) require_solidBuilders.propagateMetadataThroughRelocation(shape, moved);
+	if (require_booleanFns.hasAnyMetadata(shape)) require_booleanFns.propagateMetadataThroughRelocation(shape, moved);
 	return moved;
 }
 function evalTranslate(node, ctx) {
@@ -2772,7 +2772,7 @@ function combine(source, placements, fuse) {
 		}
 		copies.push(placed.value);
 	}
-	const result = fuse ? require_solidBuilders.fuseAll(copies, { unsafe: true }) : require_errors.ok(require_solidBuilders.makeCompound(copies));
+	const result = fuse ? require_booleanFns.fuseAll(copies, { unsafe: true }) : require_errors.ok(require_solidBuilders.makeCompound(copies));
 	for (const c of copies) if (!result.ok || c !== result.value) c[Symbol.dispose]();
 	return result;
 }
@@ -3122,8 +3122,8 @@ function evalColor(node, ctx) {
 	} finally {
 		dispose();
 	}
-	if (require_solidBuilders.hasAnyMetadata(t.value)) require_solidBuilders.propagateMetadataThroughRelocation(t.value, moved);
-	return require_errors.ok(require_solidBuilders.colorShape(moved, [...node.color]));
+	if (require_booleanFns.hasAnyMetadata(t.value)) require_booleanFns.propagateMetadataThroughRelocation(t.value, moved);
+	return require_errors.ok(require_booleanFns.colorShape(moved, [...node.color]));
 }
 // src/csg/evaluators/fillet.ts
 function evalFillet(node, ctx) {
@@ -7200,49 +7200,8 @@ async function importDXF(blob, options) {
 		for (const edge of edges) kernel.dispose(edge);
 	}
 }
-// src/io/ioUtils.ts
-/**
-* Shared mesh-to-solid sewing utilities for mesh importers.
-*
-* Builds triangular B-Rep faces from vertex/index data and sews them into
-* a solid, with a fallback to a shell when solidification fails.
-*/
-/**
-* Build triangular B-Rep faces from vertex data and sew them into a solid.
-*
-* For each triple of vertex coordinates, calls `kernel.buildTriFace` to create
-* a planar triangular face, then attempts `sewAndSolidify`. If solidification
-* fails, falls back to `sew` (returning a shell or compound).
-*
-* @param triangles - Array of vertex triples, each triple being three [x,y,z] tuples.
-* @param errorCode - The error code to use in any returned errors.
-* @param tolerance - Sewing tolerance (default 1e-6).
-* @returns A `Result` wrapping the sewn shape, or an error.
-*/
-function sewMeshToSolid(triangles, errorCode, tolerance = 1e-6) {
-	const kernel = require_shapeTypes.getKernel();
-	const triFaces = [];
-	for (const [va, vb, vc] of triangles) {
-		const triFace = kernel.buildTriFace(va, vb, vc);
-		if (triFace !== null) triFaces.push(triFace);
-	}
-	if (triFaces.length === 0) return require_errors.err(require_errors.ioError(errorCode, "No valid triangular faces could be built"));
-	try {
-		const solid = kernel.sewAndSolidify(triFaces, tolerance);
-		const cast = require_shapeTypes.castResultShape(solid);
-		for (const triFace of triFaces) kernel.dispose(triFace);
-		return require_errors.ok(cast);
-	} catch {
-		try {
-			return require_errors.ok(require_shapeTypes.castShape(kernel.sew(triFaces, tolerance)));
-		} catch (e) {
-			return require_errors.err(require_errors.ioError(errorCode, "Failed to sew triangular faces", e));
-		}
-	}
-}
 // src/io/objImportFns.ts
-function parseVertexLine(line) {
-	const parts = line.split(/\s+/);
+function parseVertex(parts) {
 	const x = parseFloat(parts[1] ?? "");
 	const y = parseFloat(parts[2] ?? "");
 	const z = parseFloat(parts[3] ?? "");
@@ -7253,8 +7212,18 @@ function parseVertexLine(line) {
 		z
 	];
 }
-function parseFaceIndices(line) {
-	return line.split(/\s+/).slice(1).map((p) => parseInt(p.split("/")[0] ?? "", 10)).filter((idx) => !isNaN(idx));
+/**
+* Face corners as 0-based vertex indices. A negative OBJ index counts back from
+* the vertices defined so far, so it resolves against `vertexCount` at this line.
+*/
+function parseFaceIndices(parts, vertexCount) {
+	const indices = [];
+	for (const part of parts.slice(1)) {
+		const raw = parseInt(part.split("/")[0] ?? "", 10);
+		if (isNaN(raw)) continue;
+		indices.push(raw > 0 ? raw - 1 : raw < 0 ? vertexCount + raw : -1);
+	}
+	return indices;
 }
 /**
 * Import a Wavefront OBJ file from a Blob.
@@ -7276,12 +7245,12 @@ async function importOBJ(blob) {
 	const vertices = [];
 	const faces = [];
 	for (const raw of lines) {
-		const line = raw.trim();
-		if (line.startsWith("v ")) {
-			const vertex = parseVertexLine(line);
+		const parts = raw.trim().split(/\s+/);
+		if (parts[0] === "v") {
+			const vertex = parseVertex(parts);
 			if (vertex) vertices.push(vertex);
-		} else if (line.startsWith("f ")) {
-			const indices = parseFaceIndices(line);
+		} else if (parts[0] === "f") {
+			const indices = parseFaceIndices(parts, vertices.length);
 			if (indices.length >= 3) faces.push(indices);
 		}
 	}
@@ -7296,15 +7265,9 @@ async function importOBJ(blob) {
 function buildSolidFromMesh$1(vertices, faces) {
 	const triangles = [];
 	for (const face of faces) for (let i = 1; i < face.length - 1; i++) {
-		const rawA = face[0] ?? 0;
-		const rawB = face[i] ?? 0;
-		const rawC = face[i + 1] ?? 0;
-		const ai = rawA > 0 ? rawA - 1 : vertices.length + rawA;
-		const bi = rawB > 0 ? rawB - 1 : vertices.length + rawB;
-		const ci = rawC > 0 ? rawC - 1 : vertices.length + rawC;
-		const va = vertices[ai];
-		const vb = vertices[bi];
-		const vc = vertices[ci];
+		const va = vertices[face[0] ?? -1];
+		const vb = vertices[face[i] ?? -1];
+		const vc = vertices[face[i + 1] ?? -1];
 		if (!va || !vb || !vc) continue;
 		triangles.push([
 			va,
@@ -7312,11 +7275,11 @@ function buildSolidFromMesh$1(vertices, faces) {
 			vc
 		]);
 	}
-	return sewMeshToSolid(triangles, require_errors.BrepErrorCode.OBJ_IMPORT_FAILED);
+	return require_importFns.sewMeshToSolid(triangles, require_errors.BrepErrorCode.OBJ_IMPORT_FAILED);
 }
 // src/io/threemfImportFns.ts
 /**
-* 3MF import — parses a 3MF ZIP archive and builds a solid via sewing.
+* 3MF import: parses a 3MF ZIP archive and builds one solid per placed object via sewing.
 */
 function extractFromZip(data, target) {
 	let eocdOffset = -1;
@@ -7348,6 +7311,26 @@ function extractFromZip(data, target) {
 	}
 	return null;
 }
+/** Millimeters per model unit, keyed by the values the 3MF `unit` attribute allows. */
+var MM_PER_UNIT = {
+	micron: .001,
+	millimeter: 1,
+	centimeter: 10,
+	inch: 25.4,
+	foot: 304.8,
+	meter: 1e3
+};
+/**
+* Components nest and repeat, so a few KB of XML can describe billions of
+* placements; stop expanding long before that exhausts memory.
+*/
+var MAX_PLACED_OBJECTS = 1e5;
+/** At roughly 2.5 s per 10,000 sewn triangles, more than this would take hours to build. */
+var MAX_PLACED_TRIANGLES = 2e6;
+/** Each placement copies its object's vertices; three per triangle fits any mesh under the triangle limit. */
+var MAX_PLACED_VERTICES = 3 * MAX_PLACED_TRIANGLES;
+/** Assemblies nest a few levels deep; a far deeper chain only serves to exhaust the stack. */
+var MAX_COMPONENT_DEPTH = 64;
 /** Check if a char code is a valid XML attribute name character [a-zA-Z0-9_]. */
 function isAttrChar(code) {
 	return code >= 97 && code <= 122 || code >= 65 && code <= 90 || code >= 48 && code <= 57 || code === 95;
@@ -7374,13 +7357,27 @@ function parseTagAttrs(tag) {
 	}
 	return attrs;
 }
+/** True when `<tagName` at `start` names that exact element (not a longer one like `<vertices`). */
+function isTagStart(xml, start, tagName) {
+	const next = xml.charCodeAt(start + tagName.length + 1);
+	return next === 32 || next === 9 || next === 10 || next === 13 || next === 47 || next === 62;
+}
+/** Index of the next `<tagName` start tag at or after `from`, or -1. */
+function indexOfTag(xml, tagName, from) {
+	const needle = `<${tagName}`;
+	let pos = from;
+	for (;;) {
+		const start = xml.indexOf(needle, pos);
+		if (start < 0 || isTagStart(xml, start, tagName)) return start;
+		pos = start + needle.length;
+	}
+}
 /** Collect all tags matching `<tagName ...>` using indexOf (O(n), no regex). */
 function findTags(xml, tagName) {
 	const tags = [];
-	const needle = `<${tagName} `;
 	let pos = 0;
 	while (pos < xml.length) {
-		const start = xml.indexOf(needle, pos);
+		const start = indexOfTag(xml, tagName, pos);
 		if (start < 0) break;
 		const end = xml.indexOf(">", start);
 		if (end < 0) break;
@@ -7390,15 +7387,36 @@ function findTags(xml, tagName) {
 	return tags;
 }
 /**
-* Extract a block `<tagName ...>...</tagName>` from xml.
-* Returns the full block string including open/close tags, or null if not found.
+* Collect every `<tagName ...>...</tagName>` element as its start tag plus inner
+* content. A self-closing `<tagName ... />` yields an empty body.
 */
-function findTagBlock(xml, tagName) {
-	const open = xml.indexOf(`<${tagName}`);
-	if (open < 0) return null;
-	const close = xml.indexOf(`</${tagName}>`, open);
-	if (close < 0) return null;
-	return xml.slice(open, close + tagName.length + 3);
+function findElements(xml, tagName) {
+	const elements = [];
+	const close = `</${tagName}>`;
+	let pos = 0;
+	while (pos < xml.length) {
+		const start = indexOfTag(xml, tagName, pos);
+		if (start < 0) break;
+		const tagEnd = xml.indexOf(">", start);
+		if (tagEnd < 0) break;
+		const tag = xml.slice(start, tagEnd + 1);
+		if (xml.charCodeAt(tagEnd - 1) === 47) {
+			elements.push({
+				tag,
+				body: ""
+			});
+			pos = tagEnd + 1;
+			continue;
+		}
+		const closeAt = xml.indexOf(close, tagEnd);
+		if (closeAt < 0) break;
+		elements.push({
+			tag,
+			body: xml.slice(tagEnd + 1, closeAt)
+		});
+		pos = closeAt + close.length;
+	}
+	return elements;
 }
 /** Parse a hex color string like #RRGGBB or #RRGGBBAA into [r,g,b,a] floats. */
 function parseHexColor(hex) {
@@ -7464,12 +7482,11 @@ function parseResourceColors(xml) {
 	}
 	return resources;
 }
-function parseModelXml(xml) {
+function parseMesh(body, objectAttrs, resourceColors) {
 	const vertices = [];
 	const triangles = [];
 	const triangleColors = [];
-	const resourceColors = parseResourceColors(xml);
-	for (const tag of findTags(xml, "vertex")) {
+	for (const tag of findTags(body, "vertex")) {
 		const a = parseTagAttrs(tag);
 		if (a["x"] !== void 0 && a["y"] !== void 0 && a["z"] !== void 0) vertices.push([
 			parseFloat(a["x"]),
@@ -7477,18 +7494,7 @@ function parseModelXml(xml) {
 			parseFloat(a["z"])
 		]);
 	}
-	let objectDefaultPid = null;
-	let objectDefaultPindex = null;
-	const objectBlock = findTagBlock(xml, "object");
-	if (objectBlock !== null) {
-		const objTagEnd = objectBlock.indexOf(">");
-		if (objTagEnd >= 0) {
-			const objAttrs = parseTagAttrs(objectBlock.slice(0, objTagEnd + 1));
-			if (objAttrs["pid"] !== void 0) objectDefaultPid = parseInt(objAttrs["pid"], 10);
-			if (objAttrs["pindex"] !== void 0) objectDefaultPindex = parseInt(objAttrs["pindex"], 10);
-		}
-	}
-	for (const tag of findTags(xml, "triangle")) {
+	for (const tag of findTags(body, "triangle")) {
 		const a = parseTagAttrs(tag);
 		if (a["v1"] !== void 0 && a["v2"] !== void 0 && a["v3"] !== void 0) {
 			triangles.push([
@@ -7497,8 +7503,8 @@ function parseModelXml(xml) {
 				parseInt(a["v3"], 10)
 			]);
 			let color = null;
-			const pidStr = a["pid"] ?? (objectDefaultPid !== null ? String(objectDefaultPid) : void 0);
-			const p1Str = a["p1"] ?? (objectDefaultPindex !== null ? String(objectDefaultPindex) : void 0);
+			const pidStr = a["pid"] ?? objectAttrs["pid"];
+			const p1Str = a["p1"] ?? objectAttrs["pindex"];
 			if (pidStr !== void 0 && p1Str !== void 0) {
 				const pid = parseInt(pidStr, 10);
 				const p1 = parseInt(p1Str, 10);
@@ -7514,6 +7520,135 @@ function parseModelXml(xml) {
 		triangleColors
 	};
 }
+function parseTransform(value) {
+	if (value === void 0) return null;
+	const m = value.trim().split(/\s+/).map(Number);
+	return m.length === 12 && m.every(Number.isFinite) ? m : null;
+}
+function parseObjectRefs(tags) {
+	const refs = [];
+	for (const tag of tags) {
+		const a = parseTagAttrs(tag);
+		const objectId = a["objectid"];
+		if (objectId !== void 0) refs.push({
+			objectId,
+			transform: parseTransform(a["transform"])
+		});
+	}
+	return refs;
+}
+/** `inner` then `outer`: with row vectors that is the matrix product inner × outer. */
+function composeTransforms$1(inner, outer) {
+	if (inner === null) return outer;
+	if (outer === null) return inner;
+	const out = [];
+	for (let row = 0; row < 4; row++) for (let col = 0; col < 3; col++) {
+		let sum = row === 3 ? outer[9 + col] ?? 0 : 0;
+		for (let k = 0; k < 3; k++) sum += (inner[row * 3 + k] ?? 0) * (outer[k * 3 + col] ?? 0);
+		out.push(sum);
+	}
+	return out;
+}
+function transformMesh(mesh, m) {
+	if (m === null) return mesh;
+	const [m0 = 0, m1 = 0, m2 = 0, m3 = 0, m4 = 0, m5 = 0, m6 = 0, m7 = 0, m8 = 0] = m;
+	const [m9 = 0, m10 = 0, m11 = 0] = m.slice(9);
+	return {
+		vertices: mesh.vertices.map(([x, y, z]) => [
+			x * m0 + y * m3 + z * m6 + m9,
+			x * m1 + y * m4 + z * m7 + m10,
+			x * m2 + y * m5 + z * m8 + m11
+		]),
+		triangles: m0 * (m4 * m8 - m5 * m7) - m1 * (m3 * m8 - m5 * m6) + m2 * (m3 * m7 - m4 * m6) < 0 ? mesh.triangles.map(([a, b, c]) => [
+			a,
+			c,
+			b
+		]) : mesh.triangles,
+		triangleColors: mesh.triangleColors
+	};
+}
+/** Place `ref` and its components into `out`; returns why it stopped early, or `null`. */
+function instantiate(objects, ref, outer, ancestors, out) {
+	const object = objects.get(ref.objectId);
+	if (object === void 0 || ancestors.has(ref.objectId)) return null;
+	if (ancestors.size > MAX_COMPONENT_DEPTH) return `components nest more than ${MAX_COMPONENT_DEPTH} levels deep`;
+	if (++out.objects > MAX_PLACED_OBJECTS) return `the build places more than ${MAX_PLACED_OBJECTS.toLocaleString("en-US")} objects`;
+	const transform = composeTransforms$1(ref.transform, outer);
+	if (object.mesh !== null && object.mesh.triangles.length > 0) {
+		out.triangles += object.mesh.triangles.length;
+		if (out.triangles > MAX_PLACED_TRIANGLES) return `the build places more than ${MAX_PLACED_TRIANGLES.toLocaleString("en-US")} triangles`;
+		out.vertices += object.mesh.vertices.length;
+		if (out.vertices > MAX_PLACED_VERTICES) return `the build places more than ${MAX_PLACED_VERTICES.toLocaleString("en-US")} vertices`;
+		out.meshes.push(transformMesh(object.mesh, transform));
+	}
+	ancestors.add(ref.objectId);
+	try {
+		for (const component of object.components) {
+			const stopped = instantiate(objects, component, transform, ancestors, out);
+			if (stopped !== null) return stopped;
+		}
+	} finally {
+		ancestors.delete(ref.objectId);
+	}
+	return null;
+}
+/**
+* Parse the model XML into one mesh per placed object, in millimeters.
+*
+* Each object keeps its own vertex list (triangle indices are per object), build
+* items and components contribute their transforms, and the model `unit` scales
+* coordinates to millimeters. Fails once the build expands past
+* {@link MAX_PLACED_OBJECTS} placements, {@link MAX_PLACED_TRIANGLES} triangles,
+* or {@link MAX_PLACED_VERTICES} vertices, or nests deeper than
+* {@link MAX_COMPONENT_DEPTH} levels.
+*/
+function parseModelXml(xml) {
+	const resourceColors = parseResourceColors(xml);
+	const modelTag = findTags(xml, "model")[0];
+	const mm = MM_PER_UNIT[(modelTag !== void 0 ? parseTagAttrs(modelTag)["unit"] : void 0) ?? "millimeter"] ?? 1;
+	const toMillimeters = mm === 1 ? null : [
+		mm,
+		0,
+		0,
+		0,
+		mm,
+		0,
+		0,
+		0,
+		mm,
+		0,
+		0,
+		0
+	];
+	const objects = /* @__PURE__ */ new Map();
+	for (const { tag, body } of findElements(xml, "object")) {
+		const attrs = parseTagAttrs(tag);
+		const id = attrs["id"];
+		if (id === void 0) continue;
+		const meshElement = findElements(body, "mesh")[0];
+		objects.set(id, {
+			mesh: meshElement ? parseMesh(meshElement.body, attrs, resourceColors) : null,
+			components: parseObjectRefs(findTags(body, "component"))
+		});
+	}
+	const build = findElements(xml, "build")[0];
+	let items = build ? parseObjectRefs(findTags(build.body, "item")) : [];
+	if (items.length === 0) items = [...objects].filter(([, object]) => object.mesh !== null).map(([objectId]) => ({
+		objectId,
+		transform: null
+	}));
+	const expansion = {
+		meshes: [],
+		objects: 0,
+		triangles: 0,
+		vertices: 0
+	};
+	for (const item of items) {
+		const stopped = instantiate(objects, item, toMillimeters, /* @__PURE__ */ new Set(), expansion);
+		if (stopped !== null) return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED, `3MF model is too large to import: ${stopped}`));
+	}
+	return require_errors.ok(expansion.meshes.filter((m) => m.vertices.length > 0 && m.triangles.length > 0));
+}
 /** Find the most common non-null color across all triangle colors. */
 function findDominantColor(triangleColors) {
 	const counts = /* @__PURE__ */ new Map();
@@ -7555,17 +7690,37 @@ function buildSolidFromMesh(mesh) {
 				vc
 			]);
 		}
-		return sewMeshToSolid(triangles, require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED);
+		return require_importFns.sewMeshToSolid(triangles, require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED);
 	}
 }
+/** One solid per mesh; several are grouped into a compound that takes ownership of them. */
+function buildShapeFromMeshes(meshes) {
+	const solids = [];
+	for (const mesh of meshes) {
+		const solid = buildSolidFromMesh(mesh);
+		if (!solid.ok) {
+			for (const built of solids) built[Symbol.dispose]();
+			return solid;
+		}
+		solids.push(solid.value);
+	}
+	const [first] = solids;
+	if (solids.length === 1 && first !== void 0) return require_errors.ok(first);
+	const compound = require_solidBuilders.makeCompound(solids);
+	for (const built of solids) built[Symbol.dispose]();
+	return require_errors.ok(compound);
+}
 /**
 * Import a 3MF file from a Blob.
 *
-* Extracts the model XML from the ZIP archive, parses vertices and triangles,
-* and builds a solid by sewing the resulting triangular faces.
+* Extracts the model XML from the ZIP archive and builds one solid per placed
+* object by sewing its triangles. Build-item and component transforms are
+* applied, and coordinates are scaled from the model `unit` to millimeters.
 *
 * @param blob - A Blob or File containing 3MF data (.3mf).
-* @returns A `Result` wrapping the imported solid, or an error if parsing fails.
+* @returns A `Result` wrapping the imported solid (a `Compound` of solids when the
+*   build places several objects), or an error if parsing fails or the build
+*   expands to more than 100,000 placed objects or 2,000,000 triangles.
 *
 * @example
 * ```ts
@@ -7579,13 +7734,15 @@ async function importThreeMF(blob) {
 		const modelData = extractFromZip(new Uint8Array(arrayBuf), "3D/3dmodel.model");
 		if (!modelData) return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED, "3MF archive does not contain 3D/3dmodel.model (or uses unsupported compression)"));
 		const parsed = parseModelXml(new TextDecoder().decode(modelData));
-		if (parsed.vertices.length === 0 || parsed.triangles.length === 0) return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED, "3MF model contains no valid geometry"));
-		const solid = buildSolidFromMesh(parsed);
-		if (solid.ok) {
-			const dominantColor = findDominantColor(parsed.triangleColors);
-			if (dominantColor !== null) require_solidBuilders.colorShape(solid.value, dominantColor);
+		if (!parsed.ok) return parsed;
+		const meshes = parsed.value;
+		if (meshes.length === 0) return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED, "3MF model contains no valid geometry"));
+		const shape = buildShapeFromMeshes(meshes);
+		if (shape.ok) {
+			const dominantColor = findDominantColor(meshes.flatMap((m) => m.triangleColors));
+			if (dominantColor !== null) require_booleanFns.colorShape(shape.value, dominantColor);
 		}
-		return solid;
+		return shape;
 	} catch (e) {
 		const msg = e instanceof Error ? e.message : String(e);
 		return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.THREEMF_IMPORT_FAILED, `3MF import failed: ${msg}`, e));
@@ -7690,54 +7847,54 @@ function locate(shape, placement) {
 }
 /** Fuse two 3D shapes (boolean union). */
 function fuse(a, b, options) {
-	return require_solidBuilders.fuse(resolve(a), resolve(b), {
+	return require_booleanFns.fuse(resolve(a), resolve(b), {
 		...options,
 		unsafe: true
 	});
 }
 /** Cut a tool from a base shape (boolean subtraction). */
 function cut(base, tool, options) {
-	return require_solidBuilders.cut(resolve(base), resolve(tool), {
+	return require_booleanFns.cut(resolve(base), resolve(tool), {
 		...options,
 		unsafe: true
 	});
 }
 /** Fuse many 3D shapes (boolean union) in a single operation. */
 function fuseAll(shapes, options) {
-	return require_solidBuilders.fuseAll(shapes.map((s) => resolve(s)), {
+	return require_booleanFns.fuseAll(shapes.map((s) => resolve(s)), {
 		...options,
 		unsafe: true
 	});
 }
 /** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
 function cutAll(base, tools, options) {
-	return require_solidBuilders.cutAll(resolve(base), tools.map((s) => resolve(s)), {
+	return require_booleanFns.cutAll(resolve(base), tools.map((s) => resolve(s)), {
 		...options,
 		unsafe: true
 	});
 }
 /** Compute the intersection of two shapes (boolean common). */
 function intersect(a, b, options) {
-	return require_solidBuilders.intersect(resolve(a), resolve(b), {
+	return require_booleanFns.intersect(resolve(a), resolve(b), {
 		...options,
 		unsafe: true
 	});
 }
 /** Section (cross-section) a shape with a plane. */
 function section(shape, plane, options) {
-	return require_solidBuilders.section(resolve(shape), plane, options);
+	return require_booleanFns.section(resolve(shape), plane, options);
 }
 /** Section a shape with a plane and return a filled Face. */
 function sectionToFace(shape, plane, options) {
-	return require_solidBuilders.sectionToFace(resolve(shape), plane, options);
+	return require_booleanFns.sectionToFace(resolve(shape), plane, options);
 }
 /** Split a shape with tool shapes. */
 function split(shape, tools) {
-	return require_solidBuilders.split(resolve(shape), tools);
+	return require_booleanFns.split(resolve(shape), tools);
 }
 /** Slice a shape with multiple planes. */
 function slice(shape, planes, options) {
-	return require_solidBuilders.slice(resolve(shape), planes, options);
+	return require_booleanFns.slice(resolve(shape), planes, options);
 }
 /**
 * Resolve a FinderFn callback or ShapeFinder into an array of elements.
@@ -8109,7 +8266,7 @@ function drill(shape, options) {
 		tool = require_solidBuilders.makeCylinder(radius, depth, startPos, dir);
 	}
 	try {
-		return require_solidBuilders.cut(s, tool, { unsafe: true });
+		return require_booleanFns.cut(s, tool, { unsafe: true });
 	} finally {
 		tool[Symbol.dispose]();
 	}
@@ -8129,7 +8286,7 @@ function pocket(shape, options) {
 		const toolResult = profileTool(s, options.face, profile, -depth);
 		if (require_errors.isErr(toolResult)) return toolResult;
 		const tool = _usingCtx3.u(toolResult.value);
-		return require_solidBuilders.cut(s, tool, { unsafe: true });
+		return require_booleanFns.cut(s, tool, { unsafe: true });
 	} catch (_) {
 		_usingCtx3.e = _;
 	} finally {
@@ -8151,7 +8308,7 @@ function boss(shape, options) {
 		const toolResult = profileTool(s, options.face, profile, height);
 		if (require_errors.isErr(toolResult)) return toolResult;
 		const tool = _usingCtx4.u(toolResult.value);
-		return require_solidBuilders.fuse(s, tool, { unsafe: true });
+		return require_booleanFns.fuse(s, tool, { unsafe: true });
 	} catch (_) {
 		_usingCtx4.e = _;
 	} finally {
@@ -8175,7 +8332,7 @@ function mirrorJoin(shape, options) {
 		const planeOrigin = options?.at;
 		if (require_vecOps.vecIsZero(normal)) return require_errors.err(require_errors.validationError("MIRROR_ZERO_NORMAL", "Mirror plane normal cannot be zero"));
 		const mirrored = _usingCtx5.u(require_primitiveFns.mirror(s, normal, planeOrigin));
-		return require_solidBuilders.fuse(s, mirrored, { unsafe: true });
+		return require_booleanFns.fuse(s, mirrored, { unsafe: true });
 	} catch (_) {
 		_usingCtx5.e = _;
 	} finally {
@@ -8211,7 +8368,7 @@ function rectangularPattern(shape, options) {
 		owned.push(c);
 	}
 	try {
-		return require_solidBuilders.fuseAll(copies, { unsafe: true });
+		return require_booleanFns.fuseAll(copies, { unsafe: true });
 	} finally {
 		for (const c of owned) c[Symbol.dispose]();
 	}
@@ -8330,11 +8487,11 @@ function create3DBooleans(val) {
 			...opts,
 			unsafe: true
 		}))),
-		fuseAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(require_solidBuilders.fuseAll([val, ...tools.map(resolve)], {
+		fuseAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(require_booleanFns.fuseAll([val, ...tools.map(resolve)], {
 			...opts,
 			unsafe: true
 		})))),
-		cutAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(require_solidBuilders.cutAll(val, tools, {
+		cutAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(require_booleanFns.cutAll(val, tools, {
 			...opts,
 			unsafe: true
 		})))),
@@ -8958,7 +9115,7 @@ function finalizeExternalSolid(wire, thickness, bore, geom, diagnostics) {
 			0,
 			-.5
 		]));
-		const cutResult = require_solidBuilders.cut(solidResult.value, boreSolid);
+		const cutResult = require_booleanFns.cut(solidResult.value, boreSolid);
 		if (require_errors.isErr(cutResult)) return cutResult;
 		return require_errors.ok(buildGearResult(cutResult.value, geom, diagnostics));
 	} catch (_) {
@@ -9135,10 +9292,10 @@ var booleans_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	checkBoolean: () => require_healingFns.checkBoolean,
 	convexHull: () => convexHull,
 	cut: () => cut,
-	cutAll: () => require_solidBuilders.cutAll,
+	cutAll: () => require_booleanFns.cutAll,
 	cutAllBisect: () => require_healingFns.cutAllBisect,
 	fuse: () => fuse,
-	fuseAll: () => require_solidBuilders.fuseAll,
+	fuseAll: () => require_booleanFns.fuseAll,
 	fuseAllBisect: () => require_healingFns.fuseAllBisect,
 	hull: () => hull,
 	intersect: () => intersect,
@@ -9362,7 +9519,7 @@ exports.autoHeal = require_healingFns.autoHeal;
 exports.bezier = require_primitiveFns.bezier;
 exports.blueprintToContour = blueprintToContour;
 exports.blueprintToDXF = require_importFns.blueprintToDXF;
-exports.booleanPipeline = require_solidBuilders.booleanPipeline;
+exports.booleanPipeline = require_booleanFns.booleanPipeline;
 Object.defineProperty(exports, "booleans", {
 	enumerable: true,
 	get: function() {
@@ -9393,8 +9550,8 @@ exports.clone = clone;
 exports.closedWire = require_validityTypes.closedWire;
 exports.collect = require_errors.collect;
 exports.collectShapes = require_threadFns.collectShapes;
-exports.colorFaces = require_solidBuilders.colorFaces;
-exports.colorShape = require_solidBuilders.colorShape;
+exports.colorFaces = require_booleanFns.colorFaces;
+exports.colorShape = require_booleanFns.colorShape;
 exports.complexExtrude = require_loftFns.complexExtrude;
 exports.composeTransforms = require_primitiveFns.composeTransforms;
 exports.compound = require_primitiveFns.compound;
@@ -9540,7 +9697,7 @@ exports.fill = require_surfaceBuilders.fill;
 exports.filledFace = require_primitiveFns.filledFace;
 exports.fillet = fillet;
 exports.filletWithEvolution = require_healingFns.filletWithEvolution;
-exports.findFacesByTag = require_solidBuilders.findFacesByTag;
+exports.findFacesByTag = require_booleanFns.findFacesByTag;
 exports.findNode = require_threadFns.findNode;
 exports.findStep = require_threadFns.findStep;
 exports.fixSelfIntersection = require_healingFns.fixSelfIntersection;
@@ -9570,9 +9727,9 @@ exports.getCompSolids = require_topologyQueryFns.getCompSolids;
 exports.getCurveType = require_curveFns.getCurveType;
 exports.getDisposalStats = require_shapeTypes.getDisposalStats;
 exports.getEdges = require_topologyQueryFns.getEdges;
-exports.getFaceColor = require_solidBuilders.getFaceColor;
-exports.getFaceOrigins = require_originTrackingFns.getFaceOrigins;
-exports.getFaceTags = require_solidBuilders.getFaceTags;
+exports.getFaceColor = require_booleanFns.getFaceColor;
+exports.getFaceOrigins = require_solidBuilders.getFaceOrigins;
+exports.getFaceTags = require_booleanFns.getFaceTags;
 exports.getFaces = require_topologyQueryFns.getFaces;
 exports.getFont = require_textBlueprints.getFont;
 exports.getHashCode = require_shapeFns.getHashCode;
@@ -9585,13 +9742,13 @@ exports.getNurbsSurfaceData = require_healingFns.getNurbsSurfaceData;
 exports.getOrientation = require_curveFns.getOrientation;
 exports.getOrientation2D = require_blueprintFns.getOrientation2D;
 exports.getPerformanceStats = require_shapeTypes.getPerformanceStats;
-exports.getShapeColor = require_solidBuilders.getShapeColor;
+exports.getShapeColor = require_booleanFns.getShapeColor;
 exports.getShapeKind = require_shapeTypes.getShapeKind;
 exports.getShells = require_topologyQueryFns.getShells;
 exports.getSingleFace = require_helpers.getSingleFace;
 exports.getSolids = require_topologyQueryFns.getSolids;
 exports.getSurfaceType = require_faceFns.getSurfaceType;
-exports.getTagMetadata = require_solidBuilders.getTagMetadata;
+exports.getTagMetadata = require_booleanFns.getTagMetadata;
 exports.getVertices = require_topologyQueryFns.getVertices;
 exports.getVoxel = getVoxel;
 exports.getWires = require_topologyQueryFns.getWires;
@@ -9862,8 +10019,8 @@ exports.serializeHistory = require_threadFns.serializeHistory;
 exports.setFallbackFont = require_textBlueprints.setFallbackFont;
 exports.setJointValue = require_threadFns.setJointValue;
 exports.setJointValues = require_threadFns.setJointValues;
-exports.setShapeOrigin = require_originTrackingFns.setShapeOrigin;
-exports.setTagMetadata = require_solidBuilders.setTagMetadata;
+exports.setShapeOrigin = require_solidBuilders.setShapeOrigin;
+exports.setTagMetadata = require_booleanFns.setTagMetadata;
 exports.sewShells = require_primitiveFns.sewShells;
 exports.shape = shape;
 exports.shapeToMeshInput = shapeToMeshInput;
@@ -9909,7 +10066,7 @@ exports.supportsProjection = supportsProjection;
 exports.surfaceFromGrid = surfaceFromGrid;
 exports.surfaceFromImage = surfaceFromImage;
 exports.sweep = require_loftFns.sweep;
-exports.tagFaces = require_solidBuilders.tagFaces;
+exports.tagFaces = require_booleanFns.tagFaces;
 exports.tangentArc = require_primitiveFns.tangentArc;
 exports.tap = require_errors.tap;
 exports.tapErr = require_errors.tapErr;