brepjs 20.12.4 → 20.12.6

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-DJT3SnGK.cjs");
-const require_occtWasmAdapter = require("./occtWasmAdapter-CRd9RFEu.cjs");
+const require_shapeTypes = require("./shapeTypes-Dc7j-MYg.cjs");
+const require_occtWasmAdapter = require("./occtWasmAdapter-DVxLkjlJ.cjs");
 const require_bug = require("./bug-CBcpIPuf.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-xh11vEQw.cjs");
-const require_validityTypes = require("./validityTypes-CXkecqMw.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-5Frx8Y-0.cjs");
+const require_validityTypes = require("./validityTypes-C6rROGTP.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-BjmlYcc9.cjs");
-const require_originTrackingFns = require("./originTrackingFns-9gyCMFFQ.cjs");
-const require_solidBuilders = require("./solidBuilders-BWbqhbyv.cjs");
-const require_primitiveFns = require("./primitiveFns-BRXZ7jnP.cjs");
-const require_shapeFns = require("./shapeFns-BbXqiNqY.cjs");
-const require_curveFns = require("./curveFns-8lUhNquZ.cjs");
-const require_meshFns = require("./meshFns-nEvfwNRF.cjs");
+const require_faceFns = require("./faceFns-B7MiDYj1.cjs");
+const require_originTrackingFns = require("./originTrackingFns-CHymOLLm.cjs");
+const require_solidBuilders = require("./solidBuilders-iS5DDwg8.cjs");
+const require_primitiveFns = require("./primitiveFns-BVeBEaa4.cjs");
+const require_shapeFns = require("./shapeFns-C0w8vvfb.cjs");
+const require_curveFns = require("./curveFns-CyIvQNYT.cjs");
+const require_meshFns = require("./meshFns-Czlt-GBJ.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CwG_RPdZ.cjs");
-const require_healingFns = require("./healingFns-CYLIcIWv.cjs");
-const require_threadFns = require("./threadFns-B23RqugN.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-W9yON-UC.cjs");
-const require_helpers = require("./helpers-De0Z_6iV.cjs");
-const require_blueprint = require("./blueprint-D0VEeTzJ.cjs");
-const require_drawFns = require("./drawFns-C7zAvera.cjs");
-const require_measureFns = require("./measureFns-Ce01LVwq.cjs");
-const require_cornerFinder = require("./cornerFinder-B8PqO4um.cjs");
-const require_boolean2D = require("./boolean2D-C9VghXHG.cjs");
-const require_blueprintFns = require("./blueprintFns-Douf5ZdX.cjs");
-const require_importFns = require("./importFns-3IMBHQrQ.cjs");
-const require_textBlueprints = require("./textBlueprints-DHfYmLtP.cjs");
-const require_loftFns = require("./loftFns-DlG5oR0X.cjs");
-const require_refResolveFns = require("./refResolveFns-BZdUlv9f.cjs");
-const require_adjacencyFns = require("./adjacencyFns-C_Vb1AeW.cjs");
-const require_cameraFns = require("./cameraFns-x3L6dtA8.cjs");
-const require_textMetrics = require("./textMetrics-CwYDH9js.cjs");
-const require_principalBoxFns = require("./principalBoxFns-tIv-crMB.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-BvwSgD3C.cjs");
+const require_healingFns = require("./healingFns-DWljGTNR.cjs");
+const require_threadFns = require("./threadFns-CzXEnnmo.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-Di376t-0.cjs");
+const require_helpers = require("./helpers-DKEVm6Hu.cjs");
+const require_blueprint = require("./blueprint-D83DDDPb.cjs");
+const require_drawFns = require("./drawFns-71cOhWD-.cjs");
+const require_measureFns = require("./measureFns-CZHNWkiA.cjs");
+const require_cornerFinder = require("./cornerFinder-CdOe1Wrb.cjs");
+const require_boolean2D = require("./boolean2D-CNZFI_y8.cjs");
+const require_blueprintFns = require("./blueprintFns-C4TQn-x_.cjs");
+const require_importFns = require("./importFns-KEPAgbjj.cjs");
+const require_textBlueprints = require("./textBlueprints-CNPCPJix.cjs");
+const require_loftFns = require("./loftFns-D5AvfCGG.cjs");
+const require_refResolveFns = require("./refResolveFns-BAs4p9z7.cjs");
+const require_adjacencyFns = require("./adjacencyFns-BFJfaUwX.cjs");
+const require_cameraFns = require("./cameraFns-RqraCXIc.cjs");
+const require_textMetrics = require("./textMetrics-C71g4TmO.cjs");
+const require_principalBoxFns = require("./principalBoxFns-CG6kG7vT.cjs");
 const require_workerPool = require("./workerPool-D5tiNXrI.cjs");
 // src/kernel/types.ts
 /** Check if the kernel supports hidden-line-removal projection. */
@@ -5124,29 +5124,29 @@ function toKernelPnt(v) {
 function toKernelDir(v) {
 	return require_shapeTypes.getKernel().createDirection3d(v[0], v[1], v[2]);
 }
-/** Extract Vec3 from a kernel 3D vector */
-function fromKernelVec(ocVec) {
+function xyzOf(v) {
+	if (typeof v.X === "function") return [
+		v.X(),
+		v.Y(),
+		v.Z()
+	];
 	return [
-		ocVec.X(),
-		ocVec.Y(),
-		ocVec.Z()
+		v.x,
+		v.y,
+		v.z
 	];
 }
+/** Extract Vec3 from a kernel 3D vector */
+function fromKernelVec(ocVec) {
+	return xyzOf(ocVec);
+}
 /** Extract Vec3 from a kernel 3D point */
 function fromKernelPnt(ocPnt) {
-	return [
-		ocPnt.X(),
-		ocPnt.Y(),
-		ocPnt.Z()
-	];
+	return xyzOf(ocPnt);
 }
 /** Extract Vec3 from a kernel 3D direction */
 function fromKernelDir(ocDir) {
-	return [
-		ocDir.X(),
-		ocDir.Y(),
-		ocDir.Z()
-	];
+	return xyzOf(ocDir);
 }
 /** Execute fn with a temporary kernel 3D vector, auto-deleted after. */
 function withKernelVec(v, fn) {
@@ -7950,19 +7950,73 @@ function resolveTargetFace(shape, faceSpec) {
 	return require_errors.ok(faceSpec);
 }
 /**
-* Convert a DrawingLike or Wire to a ClosedWire & PlanarWire (profiles are always
-* closed and planar). `owned` is true when we materialised a fresh sketch wire
-* (the caller must dispose it); false when the caller's own Wire is passed through.
+* Build the profile's face in the XY plane. A Drawing's sketch is released once
+* its face exists; a caller's Wire is expected to be closed and planar.
 */
-function toWire(profile) {
-	if ("sketchOnPlane" in profile && typeof profile.sketchOnPlane === "function") return {
-		wire: profile.sketchOnPlane("XY").wire,
-		owned: true
-	};
-	return {
-		wire: profile,
-		owned: false
-	};
+function profileFace(profile) {
+	if ("sketchOnPlane" in profile && typeof profile.sketchOnPlane === "function") {
+		const sketch = profile.sketchOnPlane("XY");
+		try {
+			return require_errors.ok(sketch.face());
+		} catch (e) {
+			return require_errors.err(require_errors.validationError("COMPOUND_PROFILE_INVALID", `compoundOps: the profile does not make a single face: ${e instanceof Error ? e.message : String(e)}`));
+		} finally {
+			sketch.delete?.();
+		}
+	}
+	return require_surfaceBuilders.makeFace(profile);
+}
+/**
+* Move a face drawn in XY onto a target face: its origin to `center`, its Z axis
+* to `normal`. Faces parallel to XY keep the world X and Y axes; on any other
+* face local Y runs up the face (world +Z projected onto it) and local X is
+* Y x normal, which points right when the face is seen from outside.
+*/
+function placeOnFace(face, normal, center) {
+	const [nx, ny, nz] = normal;
+	if (Math.abs(nz) > 1 - 1e-9) return require_errors.ok(require_primitiveFns.translate(face, center));
+	const yDir = require_vecOps.vecNormalize([
+		-nx * nz,
+		-ny * nz,
+		1 - nz * nz
+	]);
+	const xDir = require_vecOps.vecCross(yDir, normal);
+	return require_primitiveFns.applyMatrix(face, {
+		linear: [
+			xDir[0],
+			yDir[0],
+			nx,
+			xDir[1],
+			yDir[1],
+			ny,
+			xDir[2],
+			yDir[2],
+			nz
+		],
+		translation: center
+	});
+}
+/** Extrude the profile, placed on the target face, by `distance` along the face normal. */
+function profileTool(shape, faceSpec, profile, distance) {
+	try {
+		var _usingCtx$3 = require_shapeTypes._usingCtx();
+		const targetResult = resolveTargetFace(shape, faceSpec);
+		if (require_errors.isErr(targetResult)) return targetResult;
+		const normal = require_vecOps.vecNormalize(require_faceFns.normalAt(targetResult.value));
+		const center = require_faceFns.faceCenter(targetResult.value);
+		const scope = _usingCtx$3.u(new require_shapeTypes.DisposalScope());
+		const flat = profileFace(profile);
+		if (require_errors.isErr(flat)) return flat;
+		scope.register(flat.value);
+		const placed = placeOnFace(flat.value, normal, center);
+		if (require_errors.isErr(placed)) return placed;
+		scope.register(placed.value);
+		return require_textBlueprints.extrude(placed.value, require_vecOps.vecScale(normal, distance));
+	} catch (_) {
+		_usingCtx$3.e = _;
+	} finally {
+		_usingCtx$3.d();
+	}
 }
 /**
 * Drill a hole through a 3D shape.
@@ -8068,31 +8122,18 @@ function drill(shape, options) {
 */
 function pocket(shape, options) {
 	try {
-		var _usingCtx$3 = require_shapeTypes._usingCtx();
+		var _usingCtx3 = require_shapeTypes._usingCtx();
 		const s = resolve(shape);
 		const { profile, depth } = options;
 		if (depth <= 0) return require_errors.err(require_errors.validationError("POCKET_INVALID_DEPTH", "Pocket depth must be positive"));
-		const targetResult = resolveTargetFace(s, options.face);
-		if (require_errors.isErr(targetResult)) return targetResult;
-		const targetFace = targetResult.value;
-		const normal = require_faceFns.normalAt(targetFace);
-		const center = require_faceFns.faceCenter(targetFace);
-		const scope = _usingCtx$3.u(new require_shapeTypes.DisposalScope());
-		const { wire: w, owned } = toWire(profile);
-		if (owned) scope.register(w);
-		const faceResult = require_surfaceBuilders.makeFace(w);
-		if (require_errors.isErr(faceResult)) return faceResult;
-		scope.register(faceResult.value);
-		const positioned = scope.register(require_primitiveFns.translate(faceResult.value, center));
-		const extDir = require_vecOps.vecScale(require_vecOps.vecNormalize(normal), -depth);
-		const toolResult = require_textBlueprints.extrude(positioned, extDir);
+		const toolResult = profileTool(s, options.face, profile, -depth);
 		if (require_errors.isErr(toolResult)) return toolResult;
-		scope.register(toolResult.value);
-		return require_solidBuilders.cut(s, toolResult.value, { unsafe: true });
+		const tool = _usingCtx3.u(toolResult.value);
+		return require_solidBuilders.cut(s, tool, { unsafe: true });
 	} catch (_) {
-		_usingCtx$3.e = _;
+		_usingCtx3.e = _;
 	} finally {
-		_usingCtx$3.d();
+		_usingCtx3.d();
 	}
 }
 /**
@@ -8103,31 +8144,18 @@ function pocket(shape, options) {
 */
 function boss(shape, options) {
 	try {
-		var _usingCtx3 = require_shapeTypes._usingCtx();
+		var _usingCtx4 = require_shapeTypes._usingCtx();
 		const s = resolve(shape);
 		const { profile, height } = options;
 		if (height <= 0) return require_errors.err(require_errors.validationError("BOSS_INVALID_HEIGHT", "Boss height must be positive"));
-		const targetResult = resolveTargetFace(s, options.face);
-		if (require_errors.isErr(targetResult)) return targetResult;
-		const targetFace = targetResult.value;
-		const normal = require_faceFns.normalAt(targetFace);
-		const center = require_faceFns.faceCenter(targetFace);
-		const scope = _usingCtx3.u(new require_shapeTypes.DisposalScope());
-		const { wire: w, owned } = toWire(profile);
-		if (owned) scope.register(w);
-		const faceResult = require_surfaceBuilders.makeFace(w);
-		if (require_errors.isErr(faceResult)) return faceResult;
-		scope.register(faceResult.value);
-		const positioned = scope.register(require_primitiveFns.translate(faceResult.value, center));
-		const extDir = require_vecOps.vecScale(require_vecOps.vecNormalize(normal), height);
-		const toolResult = require_textBlueprints.extrude(positioned, extDir);
+		const toolResult = profileTool(s, options.face, profile, height);
 		if (require_errors.isErr(toolResult)) return toolResult;
-		scope.register(toolResult.value);
-		return require_solidBuilders.fuse(s, toolResult.value, { unsafe: true });
+		const tool = _usingCtx4.u(toolResult.value);
+		return require_solidBuilders.fuse(s, tool, { unsafe: true });
 	} catch (_) {
-		_usingCtx3.e = _;
+		_usingCtx4.e = _;
 	} finally {
-		_usingCtx3.d();
+		_usingCtx4.d();
 	}
 }
 /**
@@ -8137,7 +8165,7 @@ function boss(shape, options) {
 */
 function mirrorJoin(shape, options) {
 	try {
-		var _usingCtx4 = require_shapeTypes._usingCtx();
+		var _usingCtx5 = require_shapeTypes._usingCtx();
 		const s = resolve(shape);
 		const normal = options?.normal ?? [
 			1,
@@ -8146,12 +8174,12 @@ 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 = _usingCtx4.u(require_primitiveFns.mirror(s, normal, planeOrigin));
+		const mirrored = _usingCtx5.u(require_primitiveFns.mirror(s, normal, planeOrigin));
 		return require_solidBuilders.fuse(s, mirrored, { unsafe: true });
 	} catch (_) {
-		_usingCtx4.e = _;
+		_usingCtx5.e = _;
 	} finally {
-		_usingCtx4.d();
+		_usingCtx5.d();
 	}
 }
 /**
@@ -8166,7 +8194,7 @@ function rectangularPattern(shape, options) {
 	if (xCount < 1 || yCount < 1) return require_errors.err(require_errors.validationError("PATTERN_INVALID_COUNT", "Pattern counts must be at least 1"));
 	if (require_vecOps.vecIsZero(xDir)) return require_errors.err(require_errors.validationError("PATTERN_ZERO_DIRECTION", "X direction cannot be zero"));
 	if (require_vecOps.vecIsZero(yDir)) return require_errors.err(require_errors.validationError("PATTERN_ZERO_DIRECTION", "Y direction cannot be zero"));
-	if (xCount === 1 && yCount === 1) return require_errors.ok(s);
+	if (xCount === 1 && yCount === 1) return require_shapeFns.clone(s);
 	const xNorm = require_vecOps.vecNormalize(xDir);
 	const yNorm = require_vecOps.vecNormalize(yDir);
 	const copies = [s];