brepjs-cad 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -1 +1,24 @@
 # Changelog
+
+## [0.2.1](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.2.0...brepjs-cad-v0.2.1) (2026-06-04)
+
+
+### Bug Fixes
+
+* **brepjs-cad:** load .ts parts via native type-stripping ([#1207](https://github.com/andymai/brepjs/issues/1207)) ([198078b](https://github.com/andymai/brepjs/commit/198078becf570614c0cbf61537714fc94c2de43a))
+
+## [0.2.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.1.0...brepjs-cad-v0.2.0) (2026-06-04)
+
+
+### Features
+
+* **brepjs-cad:** CLI subcommands + verify hints + gridfinity examples + eval harness ([#1204](https://github.com/andymai/brepjs/issues/1204)) ([4d57198](https://github.com/andymai/brepjs/commit/4d5719874b5f5e685a4f909fd2d2363c0331770b))
+* **brepjs-cad:** rename from brepjs-agent + make npm-publishable (publish held) ([#1201](https://github.com/andymai/brepjs/issues/1201)) ([630bbba](https://github.com/andymai/brepjs/commit/630bbbab4885604bd4d5fb2148584a6572c8d99c))
+
+
+### Bug Fixes
+
+* **brepjs-cad:** run CLI via bin symlink + quality pass ([#1206](https://github.com/andymai/brepjs/issues/1206)) ([ac5b1fe](https://github.com/andymai/brepjs/commit/ac5b1feee3c5b424c37716ca06c397f7898838f1))
+* **opencascade:** prevent LTO stripping of custom bindings ([#666](https://github.com/andymai/brepjs/issues/666)) ([977dd75](https://github.com/andymai/brepjs/commit/977dd757e162d6fa47152b14aa31bac4edd9ae82))
+
+## Changelog

package/dist/brepjs-cad.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_diff = require("./diff-4UNdqx4k.cjs");
+const require_diff = require("./diff-DJSNDa-j.cjs");
 exports.emptyReport = require_diff.emptyReport;
 exports.runChecks = require_diff.runChecks;
 exports.runDiff = require_diff.runDiff;

package/dist/brepjs-cad.js

@@ -1,2 +1,2 @@
-import { a as emptyReport, i as runChecks, n as runMeasure, r as runPart, s as serializeReport, t as runDiff } from "./diff-ByiVwVrr.js";
+import { a as emptyReport, c as serializeReport, i as runChecks, n as runMeasure, r as runPart, t as runDiff } from "./diff-Bi3sMI-Z.js";
 export { emptyReport, runChecks, runDiff, runMeasure, runPart, serializeReport };

package/dist/cli/main.cjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_diff = require("../diff-4UNdqx4k.cjs");
+const require_diff = require("../diff-DJSNDa-j.cjs");
 let brepjs = require("brepjs");
+let node_url = require("node:url");
 let commander = require("commander");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_os = require("node:os");
-let node_url = require("node:url");
 //#region src/cli/scaffold.ts
 function partTemplate(name) {
 	return `import { box, cut, unwrap } from 'brepjs';
@@ -97,11 +97,6 @@ function scaffoldPart(name, dir) {
 		files
 	};
 }
-/**
-* Wraps a handler so bursts of rapid calls collapse into a single trailing
-* invocation after `delayMs` of quiet — fs.watch fires twice per save on many
-* platforms, so the model is re-run once rather than per raw event.
-*/
 function debounce(fn, delayMs = 150) {
 	let timer;
 	const cancel = () => {
@@ -124,11 +119,6 @@ function debounce(fn, delayMs = 150) {
 }
 //#endregion
 //#region src/disposeShape.ts
-/**
-* Release a live WASM-backed kernel shape handle returned by `runPart`.
-* No-op for null/undefined or shapes without a disposer, so callers can pass
-* `result.shape` unconditionally. WASM memory accumulates without this.
-*/
 function disposeShape(shape) {
 	const disposer = shape?.[Symbol.dispose];
 	if (typeof disposer === "function") disposer.call(shape);
@@ -139,7 +129,6 @@ function stem(file) {
 	return (0, node_path.basename)(file).replace(/\.brep\.ts$/, "").replace(/\.ts$/, "");
 }
 async function exportPart(modulePath, formats, outDir) {
-	const wantStl = Boolean(formats.stl);
 	const { shape, report, step, glb } = await require_diff.runPart(modulePath, {
 		step: Boolean(formats.step),
 		glb: Boolean(formats.glb)
@@ -148,34 +137,38 @@ async function exportPart(modulePath, formats, outDir) {
 	const written = [];
 	if (!(require_diff.reportOk(report) && shape !== null)) {
 		disposeShape(shape);
+		const failures = report.errorInfos.map((e) => e.message);
 		return {
 			ok: false,
 			report,
 			written,
-			errors: report.errors
+			errors: failures.length > 0 ? failures : report.errors
 		};
 	}
-	if (!(0, node_fs.existsSync)(outDir)) (0, node_fs.mkdirSync)(outDir, { recursive: true });
-	const base = stem(modulePath);
-	if (formats.step) if (step) {
-		const p = (0, node_path.join)(outDir, `${base}.step`);
-		(0, node_fs.writeFileSync)(p, Buffer.from(step));
-		written.push(p);
-	} else errors.push("STEP export produced no data");
-	if (formats.glb) if (glb) {
-		const p = (0, node_path.join)(outDir, `${base}.glb`);
-		(0, node_fs.writeFileSync)(p, Buffer.from(glb));
-		written.push(p);
-	} else errors.push("GLB export produced no data");
-	if (wantStl) {
-		const r = (0, brepjs.exportSTL)(shape);
-		if ((0, brepjs.isOk)(r)) {
-			const p = (0, node_path.join)(outDir, `${base}.stl`);
-			(0, node_fs.writeFileSync)(p, Buffer.from(await r.value.arrayBuffer()));
+	try {
+		if (!(0, node_fs.existsSync)(outDir)) (0, node_fs.mkdirSync)(outDir, { recursive: true });
+		const base = stem(modulePath);
+		if (formats.step) if (step) {
+			const p = (0, node_path.join)(outDir, `${base}.step`);
+			(0, node_fs.writeFileSync)(p, Buffer.from(step));
 			written.push(p);
-		} else errors.push(`STL export: ${r.error.message}`);
+		} else errors.push("STEP export produced no data");
+		if (formats.glb) if (glb) {
+			const p = (0, node_path.join)(outDir, `${base}.glb`);
+			(0, node_fs.writeFileSync)(p, Buffer.from(glb));
+			written.push(p);
+		} else errors.push("GLB export produced no data");
+		if (formats.stl) {
+			const r = (0, brepjs.exportSTL)(shape);
+			if ((0, brepjs.isOk)(r)) {
+				const p = (0, node_path.join)(outDir, `${base}.stl`);
+				(0, node_fs.writeFileSync)(p, Buffer.from(await r.value.arrayBuffer()));
+				written.push(p);
+			} else errors.push(`STL export: ${r.error.message}`);
+		}
+	} finally {
+		disposeShape(shape);
 	}
-	disposeShape(shape);
 	return {
 		ok: errors.length === 0,
 		report,
@@ -201,32 +194,37 @@ var program = new commander.Command();
 program.name("brepjs");
 program.command("verify", { isDefault: true }).argument("<file>", "path to a .brep.ts module with a default-exported part function").option("--step <out>", "write the primary STEP artifact to this path").option("--glb <out>", "write a derived GLB preview to this path").option("--json <out>", "write the JSON report to this path").option("--snapshot <dir>", "render iso/front/top/right PNGs to this dir (requires built viewer)").option("--serve", "after verifying, start a preview server and print a ?dir=&file= deep link (stays running)").action(async (file, opts) => {
 	const wantStep = Boolean(opts.step) || Boolean(opts.snapshot) || Boolean(opts.serve);
-	const { report, step, glb } = await require_diff.runPart((0, node_path.resolve)(file), {
+	const { report, step, glb, shape } = await require_diff.runPart((0, node_path.resolve)(file), {
 		step: wantStep,
 		glb: Boolean(opts.glb)
 	});
-	const json = require_diff.serializeReport(report);
-	if (opts.json) (0, node_fs.writeFileSync)(opts.json, json);
-	if (opts.glb && glb) (0, node_fs.writeFileSync)(opts.glb, Buffer.from(glb));
 	let stepPath = opts.step;
-	if (wantStep && step) {
-		stepPath = opts.step ?? (0, node_path.join)((0, node_os.tmpdir)(), `brepjs-cad-${(0, node_path.basename)(file)}.step`);
-		(0, node_fs.writeFileSync)(stepPath, Buffer.from(step));
-	}
-	if (opts.snapshot && stepPath) {
-		const shoot = await loadSnapshotShoot();
-		if (shoot) {
-			const { pngs } = await shoot({
-				file: stepPath,
-				outDir: opts.snapshot
-			});
-			for (const p of pngs) process.stderr.write(`snapshot: ${p}\n`);
+	try {
+		if (opts.glb && glb) (0, node_fs.writeFileSync)(opts.glb, Buffer.from(glb));
+		if (wantStep && step) {
+			stepPath = opts.step ?? (0, node_path.join)((0, node_os.tmpdir)(), `brepjs-cad-${(0, node_path.basename)(file)}.step`);
+			(0, node_fs.writeFileSync)(stepPath, Buffer.from(step));
 		}
+		if (opts.snapshot && stepPath) {
+			const shoot = await loadSnapshotShoot();
+			if (shoot) {
+				const { pngs } = await shoot({
+					file: stepPath,
+					outDir: opts.snapshot
+				});
+				for (const p of pngs) process.stderr.write(`snapshot: ${p}\n`);
+			}
+		} else if (opts.snapshot) process.stderr.write("snapshot skipped: STEP export produced no artifact\n");
+	} catch (e) {
+		require_diff.pushError(report, { message: `artifact write failed: ${e.message}` });
+	} finally {
+		disposeShape(shape);
 	}
+	const json = require_diff.serializeReport(report);
+	if (opts.json) (0, node_fs.writeFileSync)(opts.json, json);
 	process.stdout.write(json + "\n");
-	const parsed = JSON.parse(json);
-	if (!opts.serve && parsed.ok !== true) process.exitCode = 1;
-	if (opts.serve && stepPath) {
+	if (!require_diff.reportOk(report)) process.exitCode = 1;
+	if (Boolean(opts.serve) && stepPath !== void 0 && require_diff.reportOk(report) && stepPath) {
 		const { serve } = await Promise.resolve().then(() => require("../snapshot/serve.cjs"));
 		const { url } = await serve({ file: stepPath });
 		process.stderr.write(`viewer: ${url}\n`);
@@ -312,6 +310,15 @@ program.command("export").argument("<file>", "path to a .brep.ts module").option
 	}, null, 2) + "\n");
 	if (!result.ok) process.exitCode = 1;
 });
-if (process.argv[1] && {}.url === (0, node_url.pathToFileURL)(process.argv[1]).href) program.parseAsync();
+function isEntrypoint(argv1, moduleUrl) {
+	if (!argv1) return false;
+	try {
+		return (0, node_fs.realpathSync)(argv1) === (0, node_fs.realpathSync)((0, node_url.fileURLToPath)(moduleUrl));
+	} catch {
+		return false;
+	}
+}
+if (isEntrypoint(process.argv[1], {}.url)) program.parseAsync();
 //#endregion
+exports.isEntrypoint = isEntrypoint;
 exports.loadSnapshotShoot = loadSnapshotShoot;

package/dist/cli/main.d.ts

@@ -1,2 +1,3 @@
 import { shoot as ShootFn } from '../snapshot/shoot.js';
 export declare function loadSnapshotShoot(): Promise<typeof ShootFn | undefined>;
+export declare function isEntrypoint(argv1: string | undefined, moduleUrl: string): boolean;

package/dist/cli/main.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { n as runMeasure, o as reportOk, r as runPart, s as serializeReport, t as runDiff } from "../diff-ByiVwVrr.js";
+import { c as serializeReport, n as runMeasure, o as pushError, r as runPart, s as reportOk, t as runDiff } from "../diff-Bi3sMI-Z.js";
 import { exportSTL, isOk } from "brepjs";
+import { fileURLToPath } from "node:url";
 import { Command } from "commander";
-import { existsSync, mkdirSync, watch, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, realpathSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { tmpdir } from "node:os";
-import { pathToFileURL } from "node:url";
 //#region src/cli/scaffold.ts
 function partTemplate(name) {
 	return `import { box, cut, unwrap } from 'brepjs';
@@ -96,11 +96,6 @@ function scaffoldPart(name, dir) {
 		files
 	};
 }
-/**
-* Wraps a handler so bursts of rapid calls collapse into a single trailing
-* invocation after `delayMs` of quiet — fs.watch fires twice per save on many
-* platforms, so the model is re-run once rather than per raw event.
-*/
 function debounce(fn, delayMs = 150) {
 	let timer;
 	const cancel = () => {
@@ -123,11 +118,6 @@ function debounce(fn, delayMs = 150) {
 }
 //#endregion
 //#region src/disposeShape.ts
-/**
-* Release a live WASM-backed kernel shape handle returned by `runPart`.
-* No-op for null/undefined or shapes without a disposer, so callers can pass
-* `result.shape` unconditionally. WASM memory accumulates without this.
-*/
 function disposeShape(shape) {
 	const disposer = shape?.[Symbol.dispose];
 	if (typeof disposer === "function") disposer.call(shape);
@@ -138,7 +128,6 @@ function stem(file) {
 	return basename(file).replace(/\.brep\.ts$/, "").replace(/\.ts$/, "");
 }
 async function exportPart(modulePath, formats, outDir) {
-	const wantStl = Boolean(formats.stl);
 	const { shape, report, step, glb } = await runPart(modulePath, {
 		step: Boolean(formats.step),
 		glb: Boolean(formats.glb)
@@ -147,34 +136,38 @@ async function exportPart(modulePath, formats, outDir) {
 	const written = [];
 	if (!(reportOk(report) && shape !== null)) {
 		disposeShape(shape);
+		const failures = report.errorInfos.map((e) => e.message);
 		return {
 			ok: false,
 			report,
 			written,
-			errors: report.errors
+			errors: failures.length > 0 ? failures : report.errors
 		};
 	}
-	if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
-	const base = stem(modulePath);
-	if (formats.step) if (step) {
-		const p = join(outDir, `${base}.step`);
-		writeFileSync(p, Buffer.from(step));
-		written.push(p);
-	} else errors.push("STEP export produced no data");
-	if (formats.glb) if (glb) {
-		const p = join(outDir, `${base}.glb`);
-		writeFileSync(p, Buffer.from(glb));
-		written.push(p);
-	} else errors.push("GLB export produced no data");
-	if (wantStl) {
-		const r = exportSTL(shape);
-		if (isOk(r)) {
-			const p = join(outDir, `${base}.stl`);
-			writeFileSync(p, Buffer.from(await r.value.arrayBuffer()));
+	try {
+		if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
+		const base = stem(modulePath);
+		if (formats.step) if (step) {
+			const p = join(outDir, `${base}.step`);
+			writeFileSync(p, Buffer.from(step));
+			written.push(p);
+		} else errors.push("STEP export produced no data");
+		if (formats.glb) if (glb) {
+			const p = join(outDir, `${base}.glb`);
+			writeFileSync(p, Buffer.from(glb));
 			written.push(p);
-		} else errors.push(`STL export: ${r.error.message}`);
+		} else errors.push("GLB export produced no data");
+		if (formats.stl) {
+			const r = exportSTL(shape);
+			if (isOk(r)) {
+				const p = join(outDir, `${base}.stl`);
+				writeFileSync(p, Buffer.from(await r.value.arrayBuffer()));
+				written.push(p);
+			} else errors.push(`STL export: ${r.error.message}`);
+		}
+	} finally {
+		disposeShape(shape);
 	}
-	disposeShape(shape);
 	return {
 		ok: errors.length === 0,
 		report,
@@ -200,32 +193,37 @@ var program = new Command();
 program.name("brepjs");
 program.command("verify", { isDefault: true }).argument("<file>", "path to a .brep.ts module with a default-exported part function").option("--step <out>", "write the primary STEP artifact to this path").option("--glb <out>", "write a derived GLB preview to this path").option("--json <out>", "write the JSON report to this path").option("--snapshot <dir>", "render iso/front/top/right PNGs to this dir (requires built viewer)").option("--serve", "after verifying, start a preview server and print a ?dir=&file= deep link (stays running)").action(async (file, opts) => {
 	const wantStep = Boolean(opts.step) || Boolean(opts.snapshot) || Boolean(opts.serve);
-	const { report, step, glb } = await runPart(resolve(file), {
+	const { report, step, glb, shape } = await runPart(resolve(file), {
 		step: wantStep,
 		glb: Boolean(opts.glb)
 	});
-	const json = serializeReport(report);
-	if (opts.json) writeFileSync(opts.json, json);
-	if (opts.glb && glb) writeFileSync(opts.glb, Buffer.from(glb));
 	let stepPath = opts.step;
-	if (wantStep && step) {
-		stepPath = opts.step ?? join(tmpdir(), `brepjs-cad-${basename(file)}.step`);
-		writeFileSync(stepPath, Buffer.from(step));
-	}
-	if (opts.snapshot && stepPath) {
-		const shoot = await loadSnapshotShoot();
-		if (shoot) {
-			const { pngs } = await shoot({
-				file: stepPath,
-				outDir: opts.snapshot
-			});
-			for (const p of pngs) process.stderr.write(`snapshot: ${p}\n`);
+	try {
+		if (opts.glb && glb) writeFileSync(opts.glb, Buffer.from(glb));
+		if (wantStep && step) {
+			stepPath = opts.step ?? join(tmpdir(), `brepjs-cad-${basename(file)}.step`);
+			writeFileSync(stepPath, Buffer.from(step));
 		}
+		if (opts.snapshot && stepPath) {
+			const shoot = await loadSnapshotShoot();
+			if (shoot) {
+				const { pngs } = await shoot({
+					file: stepPath,
+					outDir: opts.snapshot
+				});
+				for (const p of pngs) process.stderr.write(`snapshot: ${p}\n`);
+			}
+		} else if (opts.snapshot) process.stderr.write("snapshot skipped: STEP export produced no artifact\n");
+	} catch (e) {
+		pushError(report, { message: `artifact write failed: ${e.message}` });
+	} finally {
+		disposeShape(shape);
 	}
+	const json = serializeReport(report);
+	if (opts.json) writeFileSync(opts.json, json);
 	process.stdout.write(json + "\n");
-	const parsed = JSON.parse(json);
-	if (!opts.serve && parsed.ok !== true) process.exitCode = 1;
-	if (opts.serve && stepPath) {
+	if (!reportOk(report)) process.exitCode = 1;
+	if (Boolean(opts.serve) && stepPath !== void 0 && reportOk(report) && stepPath) {
 		const { serve } = await import("../snapshot/serve.js");
 		const { url } = await serve({ file: stepPath });
 		process.stderr.write(`viewer: ${url}\n`);
@@ -311,6 +309,14 @@ program.command("export").argument("<file>", "path to a .brep.ts module").option
 	}, null, 2) + "\n");
 	if (!result.ok) process.exitCode = 1;
 });
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) program.parseAsync();
+function isEntrypoint(argv1, moduleUrl) {
+	if (!argv1) return false;
+	try {
+		return realpathSync(argv1) === realpathSync(fileURLToPath(moduleUrl));
+	} catch {
+		return false;
+	}
+}
+if (isEntrypoint(process.argv[1], import.meta.url)) program.parseAsync();
 //#endregion
-export { loadSnapshotShoot };
+export { isEntrypoint, loadSnapshotShoot };

package/dist/cli/watch.d.ts

@@ -1,9 +1,4 @@
 export declare const DEFAULT_DEBOUNCE_MS = 150;
-/**
- * Wraps a handler so bursts of rapid calls collapse into a single trailing
- * invocation after `delayMs` of quiet — fs.watch fires twice per save on many
- * platforms, so the model is re-run once rather than per raw event.
- */
 export declare function debounce(fn: () => void | Promise<void>, delayMs?: number): {
     trigger: () => void;
     cancel: () => void;

package/dist/{diff-ByiVwVrr.js → diff-Bi3sMI-Z.js}

@@ -1,4 +1,5 @@
 import { cut, exportGlb, exportSTEP, getBounds, init, isCompSolid, isCompound, isEdge, isFace, isOk, isShape3D, isShell, isSolid, isVertex, isWire, measureArea, measureDistance, measureLength, measureVolume, mesh, validSolid } from "brepjs";
+import { pathToFileURL } from "node:url";
 //#region src/verify/report.ts
 function emptyReport() {
 	return {
@@ -10,7 +11,6 @@ function emptyReport() {
 		hints: []
 	};
 }
-/** Record a failure on the report, keeping the flat `errors` string list and structured `errorInfos` in sync. */
 function pushError(r, info) {
 	r.errors.push(info.message);
 	r.errorInfos.push(info);
@@ -238,6 +238,15 @@ function runChecks(shape) {
 }
 //#endregion
 //#region src/verify/runPart.ts
+async function loadPart(modulePath) {
+	try {
+		return await import(pathToFileURL(modulePath).href);
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		if (/\.[mc]?tsx?$/.test(modulePath) && /import statement|file extension/i.test(msg)) throw new Error(`cannot load TypeScript part "${modulePath}": author parts in an ESM project (set "type": "module" in package.json) or rename the file to .mts. (${msg})`, { cause: e });
+		throw e;
+	}
+}
 function isResult(v) {
 	return typeof v === "object" && v !== null && "ok" in v && typeof v.ok === "boolean";
 }
@@ -246,7 +255,6 @@ function isBrepError(v) {
 	const rec = v;
 	return typeof rec["code"] === "string" && typeof rec["message"] === "string";
 }
-/** Pull structured `{ message, code, suggestion }` out of a `BrepError`, a thrown `Error`, or anything. */
 function toErrorInfo(prefix, e) {
 	if (isBrepError(e)) return {
 		message: `${prefix}: ${e.message}`,
@@ -261,11 +269,19 @@ function finalize(result) {
 	return result;
 }
 async function runPart(modulePath, opts = {}) {
-	await init();
 	const report = emptyReport();
+	try {
+		await init();
+	} catch (e) {
+		pushError(report, toErrorInfo("kernel init failed", e));
+		return finalize({
+			shape: null,
+			report
+		});
+	}
 	let mod;
 	try {
-		mod = await import(modulePath);
+		mod = await loadPart(modulePath);
 	} catch (e) {
 		pushError(report, toErrorInfo("import failed", e));
 		return finalize({
@@ -291,15 +307,16 @@ async function runPart(modulePath, opts = {}) {
 		});
 	}
 	let shape;
-	if (isResult(out)) if (isOk(out)) shape = out.value;
-	else {
-		pushError(report, toErrorInfo("part returned Err", out.error));
-		return finalize({
-			shape: null,
-			report
-		});
-	}
-	else shape = out;
+	if (isResult(out)) {
+		if (!isOk(out)) {
+			pushError(report, toErrorInfo("part returned Err", out.error));
+			return finalize({
+				shape: null,
+				report
+			});
+		}
+		shape = out.value;
+	} else shape = out;
 	if (!shape) {
 		pushError(report, { message: "part produced no shape" });
 		return finalize({
@@ -449,6 +466,30 @@ function areaOf(shape, errors) {
 	errors.push(`measureArea: ${a.error.message}`);
 	return 0;
 }
+function boundsDelta(a, b, errors) {
+	try {
+		const ba = getBounds(a);
+		const bb = getBounds(b);
+		return {
+			xMin: bb.xMin - ba.xMin,
+			xMax: bb.xMax - ba.xMax,
+			yMin: bb.yMin - ba.yMin,
+			yMax: bb.yMax - ba.yMax,
+			zMin: bb.zMin - ba.zMin,
+			zMax: bb.zMax - ba.zMax
+		};
+	} catch (e) {
+		errors.push(`getBounds: ${e.message}`);
+		return {
+			xMin: 0,
+			xMax: 0,
+			yMin: 0,
+			yMax: 0,
+			zMin: 0,
+			zMax: 0
+		};
+	}
+}
 function cutVolume(x, y, errors) {
 	try {
 		var _usingCtx$1 = _usingCtx();
@@ -470,21 +511,13 @@ async function runDiff(aPath, bPath) {
 		const errors = [];
 		const a = await runPart(aPath);
 		errors.push(...a.report.errors);
+		if (!a.shape) return emptyDiff(errors);
+		const sa = _usingCtx3.u(a.shape);
 		const b = await runPart(bPath);
 		errors.push(...b.report.errors);
-		if (!a.shape || !b.shape) return emptyDiff(errors);
-		const sa = _usingCtx3.u(a.shape);
+		if (!b.shape) return emptyDiff(errors);
 		const sb = _usingCtx3.u(b.shape);
-		const ba = getBounds(sa);
-		const bb = getBounds(sb);
-		const bboxDelta = {
-			xMin: bb.xMin - ba.xMin,
-			xMax: bb.xMax - ba.xMax,
-			yMin: bb.yMin - ba.yMin,
-			yMax: bb.yMax - ba.yMax,
-			zMin: bb.zMin - ba.zMin,
-			zMax: bb.zMax - ba.zMax
-		};
+		const bboxDelta = boundsDelta(sa, sb, errors);
 		const areaDelta = areaOf(sb, errors) - areaOf(sa, errors);
 		let volumeDelta = 0;
 		let symmetricDifferenceVolume = 0;
@@ -506,4 +539,4 @@ async function runDiff(aPath, bPath) {
 	}
 }
 //#endregion
-export { emptyReport as a, runChecks as i, runMeasure as n, reportOk as o, runPart as r, serializeReport as s, runDiff as t };
+export { emptyReport as a, serializeReport as c, runChecks as i, runMeasure as n, pushError as o, runPart as r, reportOk as s, runDiff as t };

package/dist/disposeShape.d.ts

@@ -1,6 +1 @@
-/**
- * Release a live WASM-backed kernel shape handle returned by `runPart`.
- * No-op for null/undefined or shapes without a disposer, so callers can pass
- * `result.shape` unconditionally. WASM memory accumulates without this.
- */
 export declare function disposeShape(shape: unknown): void;

package/dist/snapshot/registry.cjs

@@ -31,7 +31,7 @@ async function acquireServer(opts = {}) {
 		server = await require_snapshot_static.startStaticServer({ port });
 		break;
 	} catch {}
-	if (!server) throw new Error(`no free port in ${ports[0]}..${ports[ports.length - 1]}`);
+	if (!server) throw new Error(`no free port in ${ports[0]}..${ports.at(-1)}`);
 	const timer = setTimeout(() => void server?.close(), opts.shutdownAfterMs ?? 432e5);
 	timer.unref();
 	const started = server;

package/dist/snapshot/registry.js

@@ -30,7 +30,7 @@ async function acquireServer(opts = {}) {
 		server = await startStaticServer({ port });
 		break;
 	} catch {}
-	if (!server) throw new Error(`no free port in ${ports[0]}..${ports[ports.length - 1]}`);
+	if (!server) throw new Error(`no free port in ${ports[0]}..${ports.at(-1)}`);
 	const timer = setTimeout(() => void server?.close(), opts.shutdownAfterMs ?? 432e5);
 	timer.unref();
 	const started = server;

package/dist/snapshot/static.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_url = require("node:url");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
-let node_url = require("node:url");
 let node_http = require("node:http");
 let node_fs_promises = require("node:fs/promises");
 //#region src/snapshot/static.ts
@@ -38,7 +38,8 @@ async function sendFile(res, absPath) {
 }
 function safeJoin(root, rel) {
 	const abs = (0, node_path.resolve)(root, (0, node_path.normalize)(decodeURIComponent(rel.replace(/^\/+/, ""))));
-	return abs !== root && !abs.startsWith(root + node_path.sep) ? null : abs;
+	if (abs !== root && !abs.startsWith(root + node_path.sep)) return null;
+	return abs;
 }
 async function handle(req, res, port) {
 	const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);

package/dist/snapshot/static.js

@@ -1,6 +1,6 @@
+import { fileURLToPath } from "node:url";
 import { createReadStream } from "node:fs";
 import { dirname, extname, join, normalize, resolve, sep } from "node:path";
-import { fileURLToPath } from "node:url";
 import { createServer } from "node:http";
 import { stat } from "node:fs/promises";
 //#region src/snapshot/static.ts
@@ -37,7 +37,8 @@ async function sendFile(res, absPath) {
 }
 function safeJoin(root, rel) {
 	const abs = resolve(root, normalize(decodeURIComponent(rel.replace(/^\/+/, ""))));
-	return abs !== root && !abs.startsWith(root + sep) ? null : abs;
+	if (abs !== root && !abs.startsWith(root + sep)) return null;
+	return abs;
 }
 async function handle(req, res, port) {
 	const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);

package/dist/verify/report.d.ts

@@ -53,7 +53,6 @@ export interface DiffReport {
     errors: string[];
 }
 export declare function emptyReport(): VerifyReport;
-/** Record a failure on the report, keeping the flat `errors` string list and structured `errorInfos` in sync. */
 export declare function pushError(r: VerifyReport, info: ErrorInfo): void;
 export declare function reportOk(r: VerifyReport): boolean;
 /** Synthetic code attached to validity-check failures (validSolid returns a plain string error). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-cad",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Agent skill + verify/preview tooling for authoring parametric brepjs CAD code",
   "license": "Apache-2.0",
   "type": "module",
@@ -45,6 +45,7 @@
     "lint": "eslint src tests viewer bench",
     "test": "vitest run",
     "eval": "tsx bench/run.ts",
+    "smoke": "node dist/cli/main.js verify tests/fixtures/validBox.brep.ts | node -e \"const r=JSON.parse(require('fs').readFileSync(0,'utf8'));if(r.ok!==true||!(r.measurements.volume>0))process.exit(1)\"",
     "prepack": "npm run build"
   },
   "peerDependencies": {