brepjs-cad 0.176.0 → 0.178.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.178.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.177.0...brepjs-cad-v0.178.0) (2026-08-29)
+
+
+### Bug Fixes
+
+* **brepjs-cad:** ship the Z-up preview camera in the bundled viewer ([#2265](https://github.com/andymai/brepjs/issues/2265)) ([9993376](https://github.com/andymai/brepjs/commit/9993376b323ff47ee67583a57d88f82f0d343fc2)), closes [#2264](https://github.com/andymai/brepjs/issues/2264)
+
+## [0.177.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.176.0...brepjs-cad-v0.177.0) (2026-08-26)
+
+
+### Features
+
+* **brepjs-cad:** brep export --3dm — element-aware Rhino export ([#2236](https://github.com/andymai/brepjs/issues/2236)) ([91b0235](https://github.com/andymai/brepjs/commit/91b02355d9ba005f69dd4c72002a946600179398))
+
+
+### Bug Fixes
+
+* **brepjs-cad:** quality pass over the preview/loader/3dm/scaffold delta ([#2243](https://github.com/andymai/brepjs/issues/2243)) ([b6ae66e](https://github.com/andymai/brepjs/commit/b6ae66e6a1c4175bfd13846b382972e1d7356adc))
+
 ## [0.176.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.175.0...brepjs-cad-v0.176.0) (2026-08-26)
 
 

package/README.md

@@ -53,7 +53,7 @@ npx -y -p brepjs-cad brep part.brep.ts --serve                               # p
 npx -y -p brepjs-cad brep part.brep.ts --serve --no-open                     # preview server; just print the URL (no browser)
 ```
 
-`--snapshot`/`--serve` use the bundled viewer (shipped under `viewer/dist`, including the OCCT WASM). The `--serve` link is interactive: a toolbar offers view presets + fit, solid/wireframe/x-ray modes, edge/grid toggles, a turntable, click-to-inspect face picking, a section/clipping plane, a measurements panel, and an in-browser PNG screenshot. `--snapshot` loads the same page with `ui=0` to suppress the toolbar, and burns the bounding-box size into each PNG (`dims=1`) so the agent can read scale from the image.
+`--snapshot`/`--serve` use the bundled viewer (shipped under `viewer/dist`, including the OCCT WASM). It renders in brepjs's native Z-up coordinates: Z is up, the XY plane is horizontal, and models are never rotated to fit the renderer's convention. The `--serve` link is interactive: a toolbar offers view presets + fit, solid/wireframe/x-ray modes, edge/grid toggles, a turntable, click-to-inspect face picking, a section/clipping plane, a measurements panel, and an in-browser PNG screenshot. `--snapshot` loads the same page with `ui=0` to suppress the toolbar, and burns the bounding-box size into each PNG (`dims=1`) so the agent can read scale from the image.
 
 `--serve` prints the viewer URL and, in an interactive terminal, opens it in your default browser. Auto-open is skipped when it would be unwanted: when the server is reused (a tab is already open), under CI, when output is piped (non-TTY, e.g. agent runs), or on Linux with no display server. Pass `--no-open` to always suppress it.
 
@@ -66,7 +66,8 @@ The `brep` bin is a multi-command CLI. `verify` is the default command, so `brep
 | `brep verify <files...>` | Default command. Loads the part, runs deterministic checks, prints the JSON report. Flags: `--check`, `--json <out\|->`, `--step <out>`, `--glb <out>`, `--snapshot <dir>`, `--serve`, `--no-open`, `--expect-code <CODE>` / `--expect-invalid` (assert a known-bad part fails the right way — for fixtures/eval). Multiple files or a quoted glob → a validity-only JSON array. Exits non-zero when not `ok` (unless `--serve`). |
 | `brep init <name>`       | Scaffolds a parameterized `<name>.brep.ts` + `tsconfig.json` + `README.md` into `./<name>` (or `--out <dir>`). Never overwrites existing files.                                                                                                                                                                                                                                                                                   |
 | `brep watch <file>`      | Re-verifies on every save until Ctrl-C (debounced; watches the parent dir to survive editor rename-on-save).                                                                                                                                                                                                                                                                                                                      |
-| `brep export <file>`     | Batch artifacts behind a validity gate: `--step`, `--glb`, `--stl`, or `--all`; `--out <dir>` (default `.`). Exits non-zero on failure.                                                                                                                                                                                                                                                                                           |
+| `brep preview <file>`    | Element-aware live viewer for a model module (families element tree, resolved tree, or plain shape): key-path picking, failed elements listed, real edges. `--watch` re-evaluates on save and pushes to the open tab; `--write-only` (CI), `--glb <out>`, `--json <out>`, `--port <n>`, `--no-open`.                                                                                                                              |
+| `brep export <file>`     | Batch artifacts behind a validity gate: `--step`, `--glb`, `--stl`, or `--all`; `--3dm` writes an element-aware Rhino file (one named object per element, layered; needs the optional `rhino3dm` install; not combinable with the other formats); `--out <dir>` (default `.`). Exits non-zero on failure.                                                                                                                         |
 | `brep measure <a> [b]`   | Measurements for one part; with a second module, the distance between the two parts.                                                                                                                                                                                                                                                                                                                                              |
 | `brep diff <a> <b>`      | Compares the measurements of a baseline and a comparison module.                                                                                                                                                                                                                                                                                                                                                                  |
 | `brep snapshot <file>`   | Standalone multi-view PNG capture (no report assertions): `--out <dir>`, `--label <tag>` (subfolder, for pre/post A/B pairing). Renders on a private ephemeral server so parallel snapshots don't contend. Requires the optional `puppeteer`/Chrome dependency; degrades with a clear message when absent. (Also available inline via `verify --snapshot <dir>`.)                                                                 |

package/dist/brepjs-cad.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_usingCtx = require("./usingCtx-DNbyRoEg.cjs");
-const require_diff = require("./diff-CmIV_qOi.cjs");
+const require_usingCtx = require("./usingCtx-LY0tPCbQ.cjs");
+const require_diff = require("./diff-CBp5KDNZ.cjs");
 exports.DEFAULT_TOLERANCE_PCT = require_usingCtx.DEFAULT_TOLERANCE_PCT;
 exports.TYPECHECK_CODE = require_usingCtx.TYPECHECK_CODE;
 exports.emptyReport = require_usingCtx.emptyReport;

package/dist/brepjs-cad.js

@@ -1,3 +1,3 @@
-import { c as evaluateExpected, d as runChecks, f as emptyReport, h as serializeReport, i as TYPECHECK_CODE, l as isExpectedDims, o as typecheckPart, r as runPart, s as DEFAULT_TOLERANCE_PCT, u as pctDelta } from "./usingCtx-DOzK2eJh.js";
-import { n as runMeasure, t as runDiff } from "./diff-C2vDUt9F.js";
+import { c as DEFAULT_TOLERANCE_PCT, d as pctDelta, f as runChecks, g as serializeReport, i as TYPECHECK_CODE, l as evaluateExpected, p as emptyReport, r as runPart, s as typecheckPart, u as isExpectedDims } from "./usingCtx-BDYtpr4t.js";
+import { n as runMeasure, t as runDiff } from "./diff-DmFtXXiX.js";
 export { DEFAULT_TOLERANCE_PCT, TYPECHECK_CODE, emptyReport, evaluateExpected, isExpectedDims, pctDelta, runChecks, runDiff, runMeasure, runPart, serializeReport, typecheckPart };

package/dist/cli/exportPart.d.ts

@@ -10,4 +10,5 @@ export interface ExportResult {
     written: string[];
     errors: string[];
 }
+export declare function stem(file: string): string;
 export declare function exportPart(modulePath: string, formats: ExportFormats, outDir: string): Promise<ExportResult>;

package/dist/cli/main.cjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_usingCtx = require("../usingCtx-DNbyRoEg.cjs");
-const require_diff = require("../diff-CmIV_qOi.cjs");
-const require_openBrowser = require("../openBrowser-C1AiX6cC.cjs");
+const require_usingCtx = require("../usingCtx-LY0tPCbQ.cjs");
+const require_diff = require("../diff-CBp5KDNZ.cjs");
+const require_openBrowser = require("../openBrowser-Bip99cQv.cjs");
+const require_disposeShape = require("../disposeShape-Bui9k40G.cjs");
 let node_url = require("node:url");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
@@ -101,7 +102,7 @@ function scaffoldPart(name, dir) {
 //#endregion
 //#region src/cli/exportPart.ts
 function stem(file) {
-	return (0, node_path.basename)(file).replace(/\.brep\.ts$/, "").replace(/\.ts$/, "");
+	return (0, node_path.basename)(file).replace(/\.brep\.ts$/, "").replace(/\.(?:m?ts|tsx)$/, "");
 }
 async function exportPart(modulePath, formats, outDir) {
 	const { shape, report, step, glb } = await require_usingCtx.runPart(modulePath, {
@@ -111,7 +112,7 @@ async function exportPart(modulePath, formats, outDir) {
 	const errors = [];
 	const written = [];
 	if (!(require_usingCtx.reportOk(report) && shape !== null)) {
-		require_openBrowser.disposeShape(shape);
+		require_disposeShape.disposeShape(shape);
 		const failures = report.errorInfos.map((e) => e.message);
 		return {
 			ok: false,
@@ -147,7 +148,7 @@ async function exportPart(modulePath, formats, outDir) {
 			} else errors.push(`STL export: ${r.error.message}`);
 		}
 	} finally {
-		require_openBrowser.disposeShape(shape);
+		require_disposeShape.disposeShape(shape);
 	}
 	return {
 		ok: errors.length === 0,
@@ -246,7 +247,7 @@ program.command("verify", { isDefault: true }).argument("<files...>", "path(s) o
 				check: Boolean(opts.check),
 				metrics: Boolean(opts.metrics)
 			});
-			require_openBrowser.disposeShape(shape);
+			require_disposeShape.disposeShape(shape);
 			results.push({
 				file: f,
 				ok: require_usingCtx.reportOk(report),
@@ -291,7 +292,7 @@ program.command("verify", { isDefault: true }).argument("<files...>", "path(s) o
 	} catch (e) {
 		require_usingCtx.pushError(report, { message: `artifact write failed: ${e.message}` });
 	} finally {
-		require_openBrowser.disposeShape(shape);
+		require_disposeShape.disposeShape(shape);
 	}
 	const json = require_usingCtx.serializeReport(report);
 	if (opts.json && opts.json !== "-") (0, node_fs.writeFileSync)(opts.json, json);
@@ -361,7 +362,7 @@ program.command("snapshot").argument("<file>", "path to a .brep.ts module; rende
 		});
 		for (const p of pngs) process.stdout.write(`${p}\n`);
 	} finally {
-		require_openBrowser.disposeShape(shape);
+		require_disposeShape.disposeShape(shape);
 	}
 });
 program.command("init").argument("<name>", "part name; scaffolds <name>.brep.ts + tsconfig.json + README.md").option("--out <dir>", "target directory (defaults to ./<name>)").action((name, opts) => {
@@ -380,7 +381,7 @@ program.command("watch").argument("<file>", "path to a .brep.ts module; re-verif
 			try {
 				process.stdout.write(require_usingCtx.serializeReport(report) + "\n");
 			} finally {
-				require_openBrowser.disposeShape(shape);
+				require_disposeShape.disposeShape(shape);
 			}
 		} catch (e) {
 			process.stderr.write(`watch run failed: ${e.message}\n`);
@@ -400,7 +401,7 @@ program.command("watch").argument("<file>", "path to a .brep.ts module; re-verif
 	process.on("SIGINT", stop);
 	process.on("SIGTERM", stop);
 });
-program.command("preview").argument("<file>", "path to a model module (.ts/.tsx); a families element tree renders per element").option("--watch", "re-evaluate on save and push updates to the open viewer tab").option("--write-only", "write artifacts and exit without starting the viewer server").option("--glb <out>", "write a merged GLB of the whole model").option("--json <out>", "write the JSON summary to this path").option("--port <n>", "viewer server port (default: OS-assigned)", (v) => parseInt(v, 10)).option("--no-open", "do not auto-open the browser").action(async (file, opts) => {
+program.command("preview").argument("<file>", "path to a model module (.ts/.tsx); a families element tree renders per element").option("--watch", "re-evaluate on save and push updates to the open viewer tab").option("--write-only", "write artifacts without starting the viewer server (exits unless --watch)").option("--glb <out>", "write a merged GLB of the whole model").option("--json <out>", "write the JSON summary to this path").option("--port <n>", "viewer server port (default: OS-assigned)", (v) => parseInt(v, 10)).option("--no-open", "do not auto-open the browser").action(async (file, opts) => {
 	const { runPreview } = await Promise.resolve().then(() => require("../preview/preview.cjs"));
 	try {
 		await runPreview((0, node_path.resolve)(file), opts);
@@ -409,7 +410,39 @@ program.command("preview").argument("<file>", "path to a model module (.ts/.tsx)
 		process.exitCode = 1;
 	}
 });
-program.command("export").argument("<file>", "path to a .brep.ts module").option("--step", "write a STEP artifact").option("--glb", "write a GLB artifact").option("--stl", "write an STL artifact").option("--all", "write STEP + GLB + STL").option("--out <dir>", "output directory", ".").action(async (file, opts) => {
+program.command("export").argument("<file>", "path to a part (.brep.ts) module; --3dm also accepts a model (.ts/.tsx) default-exporting a families element tree").option("--step", "write a STEP artifact").option("--glb", "write a GLB artifact").option("--stl", "write an STL artifact").option("--all", "write STEP + GLB + STL").option("--3dm", "write a Rhino .3dm (element-aware: one named object per element, layered)").option("--out <dir>", "output directory", ".").action(async (file, opts) => {
+	const path = (0, node_path.resolve)(file);
+	if (opts["3dm"] && (opts.step || opts.glb || opts.stl || opts.all)) {
+		process.stderr.write("--3dm cannot be combined with --step/--glb/--stl/--all\n");
+		process.exitCode = 1;
+		return;
+	}
+	if (opts["3dm"]) {
+		let run;
+		try {
+			({export3dm: run} = await Promise.resolve().then(() => require("../export3dm/export3dm.cjs")));
+		} catch {
+			process.stderr.write(".3dm export needs rhino3dm — run: npm i rhino3dm\n");
+			process.exitCode = 1;
+			return;
+		}
+		const outPath = (0, node_path.join)((0, node_path.resolve)(opts.out), stem(path) + ".3dm");
+		try {
+			const r = await run(path, outPath);
+			process.stderr.write(`wrote: ${outPath}\n`);
+			process.stdout.write(JSON.stringify({
+				ok: r.failed.length === 0,
+				written: [outPath],
+				elements: r.elements,
+				failed: r.failed
+			}, null, 2) + "\n");
+			if (r.failed.length > 0) process.exitCode = 1;
+		} catch (e) {
+			process.stderr.write(`3dm export failed: ${e.message}\n`);
+			process.exitCode = 1;
+		}
+		return;
+	}
 	const formats = opts.all ? {
 		step: true,
 		glb: true,
@@ -420,11 +453,11 @@ program.command("export").argument("<file>", "path to a .brep.ts module").option
 		stl: Boolean(opts.stl)
 	};
 	if (!formats.step && !formats.glb && !formats.stl) {
-		process.stderr.write("no formats requested — pass --step/--glb/--stl or --all\n");
+		process.stderr.write("no formats requested — pass --step/--glb/--stl/--3dm or --all\n");
 		process.exitCode = 1;
 		return;
 	}
-	const result = await exportPart((0, node_path.resolve)(file), formats, (0, node_path.resolve)(opts.out));
+	const result = await exportPart(path, formats, (0, node_path.resolve)(opts.out));
 	for (const p of result.written) process.stderr.write(`wrote: ${p}\n`);
 	for (const e of result.errors) process.stderr.write(`error: ${e}\n`);
 	process.stdout.write(JSON.stringify({

package/dist/cli/main.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { _ as loadBrep, h as serializeReport, m as reportOk, p as pushError, r as runPart } from "../usingCtx-DOzK2eJh.js";
-import { n as runMeasure, t as runDiff } from "../diff-C2vDUt9F.js";
-import { a as debounce, c as watchTree, i as createSerialRunner, n as shouldAutoOpen, o as isWatchRelevant, r as disposeShape, s as watchRootFor, t as openBrowser } from "../openBrowser-BBYw6VVb.js";
+import { g as serializeReport, h as reportOk, m as pushError, r as runPart, v as loadBrep } from "../usingCtx-BDYtpr4t.js";
+import { n as runMeasure, t as runDiff } from "../diff-DmFtXXiX.js";
+import { a as isWatchRelevant, i as debounce, n as shouldAutoOpen, o as watchRootFor, r as createSerialRunner, s as watchTree, t as openBrowser } from "../openBrowser-Dg9oDOte.js";
+import { t as disposeShape } from "../disposeShape-B4lsczOO.js";
 import { fileURLToPath } from "node:url";
 import { existsSync, globSync, mkdirSync, realpathSync, writeFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
@@ -100,7 +101,7 @@ function scaffoldPart(name, dir) {
 //#endregion
 //#region src/cli/exportPart.ts
 function stem(file) {
-	return basename(file).replace(/\.brep\.ts$/, "").replace(/\.ts$/, "");
+	return basename(file).replace(/\.brep\.ts$/, "").replace(/\.(?:m?ts|tsx)$/, "");
 }
 async function exportPart(modulePath, formats, outDir) {
 	const { shape, report, step, glb } = await runPart(modulePath, {
@@ -399,7 +400,7 @@ program.command("watch").argument("<file>", "path to a .brep.ts module; re-verif
 	process.on("SIGINT", stop);
 	process.on("SIGTERM", stop);
 });
-program.command("preview").argument("<file>", "path to a model module (.ts/.tsx); a families element tree renders per element").option("--watch", "re-evaluate on save and push updates to the open viewer tab").option("--write-only", "write artifacts and exit without starting the viewer server").option("--glb <out>", "write a merged GLB of the whole model").option("--json <out>", "write the JSON summary to this path").option("--port <n>", "viewer server port (default: OS-assigned)", (v) => parseInt(v, 10)).option("--no-open", "do not auto-open the browser").action(async (file, opts) => {
+program.command("preview").argument("<file>", "path to a model module (.ts/.tsx); a families element tree renders per element").option("--watch", "re-evaluate on save and push updates to the open viewer tab").option("--write-only", "write artifacts without starting the viewer server (exits unless --watch)").option("--glb <out>", "write a merged GLB of the whole model").option("--json <out>", "write the JSON summary to this path").option("--port <n>", "viewer server port (default: OS-assigned)", (v) => parseInt(v, 10)).option("--no-open", "do not auto-open the browser").action(async (file, opts) => {
 	const { runPreview } = await import("../preview/preview.js");
 	try {
 		await runPreview(resolve(file), opts);
@@ -408,7 +409,39 @@ program.command("preview").argument("<file>", "path to a model module (.ts/.tsx)
 		process.exitCode = 1;
 	}
 });
-program.command("export").argument("<file>", "path to a .brep.ts module").option("--step", "write a STEP artifact").option("--glb", "write a GLB artifact").option("--stl", "write an STL artifact").option("--all", "write STEP + GLB + STL").option("--out <dir>", "output directory", ".").action(async (file, opts) => {
+program.command("export").argument("<file>", "path to a part (.brep.ts) module; --3dm also accepts a model (.ts/.tsx) default-exporting a families element tree").option("--step", "write a STEP artifact").option("--glb", "write a GLB artifact").option("--stl", "write an STL artifact").option("--all", "write STEP + GLB + STL").option("--3dm", "write a Rhino .3dm (element-aware: one named object per element, layered)").option("--out <dir>", "output directory", ".").action(async (file, opts) => {
+	const path = resolve(file);
+	if (opts["3dm"] && (opts.step || opts.glb || opts.stl || opts.all)) {
+		process.stderr.write("--3dm cannot be combined with --step/--glb/--stl/--all\n");
+		process.exitCode = 1;
+		return;
+	}
+	if (opts["3dm"]) {
+		let run;
+		try {
+			({export3dm: run} = await import("../export3dm/export3dm.js"));
+		} catch {
+			process.stderr.write(".3dm export needs rhino3dm — run: npm i rhino3dm\n");
+			process.exitCode = 1;
+			return;
+		}
+		const outPath = join(resolve(opts.out), stem(path) + ".3dm");
+		try {
+			const r = await run(path, outPath);
+			process.stderr.write(`wrote: ${outPath}\n`);
+			process.stdout.write(JSON.stringify({
+				ok: r.failed.length === 0,
+				written: [outPath],
+				elements: r.elements,
+				failed: r.failed
+			}, null, 2) + "\n");
+			if (r.failed.length > 0) process.exitCode = 1;
+		} catch (e) {
+			process.stderr.write(`3dm export failed: ${e.message}\n`);
+			process.exitCode = 1;
+		}
+		return;
+	}
 	const formats = opts.all ? {
 		step: true,
 		glb: true,
@@ -419,11 +452,11 @@ program.command("export").argument("<file>", "path to a .brep.ts module").option
 		stl: Boolean(opts.stl)
 	};
 	if (!formats.step && !formats.glb && !formats.stl) {
-		process.stderr.write("no formats requested — pass --step/--glb/--stl or --all\n");
+		process.stderr.write("no formats requested — pass --step/--glb/--stl/--3dm or --all\n");
 		process.exitCode = 1;
 		return;
 	}
-	const result = await exportPart(resolve(file), formats, resolve(opts.out));
+	const result = await exportPart(path, formats, resolve(opts.out));
 	for (const p of result.written) process.stderr.write(`wrote: ${p}\n`);
 	for (const e of result.errors) process.stderr.write(`error: ${e}\n`);
 	process.stdout.write(JSON.stringify({

package/dist/cli/watch.d.ts

@@ -10,7 +10,7 @@ export declare function isWatchRelevant(filename: string | Buffer | null | undef
  * and `../` imports live one level up. Nearest package.json or tsconfig.json walking up
  * wins; entries with no project marker fall back to their own directory.
  */
-export declare function watchRootFor(entryPath: string): string;
+export declare function watchRootFor(entryPath: string, stopDir?: string): string;
 /**
  * Watch a directory tree with one non-recursive `fs.watch` per directory, skipping
  * node_modules/dist/.git and never following symlinks. `fs.watch({recursive})` has no

package/dist/{diff-CmIV_qOi.cjs → diff-CBp5KDNZ.cjs}

@@ -1,4 +1,4 @@
-const require_usingCtx = require("./usingCtx-DNbyRoEg.cjs");
+const require_usingCtx = require("./usingCtx-LY0tPCbQ.cjs");
 //#region src/verify/measure.ts
 async function runMeasure(aPath, bPath) {
 	try {

package/dist/{diff-C2vDUt9F.js → diff-DmFtXXiX.js}

@@ -1,4 +1,4 @@
-import { _ as loadBrep, r as runPart, t as _usingCtx } from "./usingCtx-DOzK2eJh.js";
+import { r as runPart, t as _usingCtx, v as loadBrep } from "./usingCtx-BDYtpr4t.js";
 //#region src/verify/measure.ts
 async function runMeasure(aPath, bPath) {
 	try {

package/dist/disposeShape-B4lsczOO.js

@@ -0,0 +1,7 @@
+//#region src/disposeShape.ts
+function disposeShape(shape) {
+	const disposer = shape?.[Symbol.dispose];
+	if (typeof disposer === "function") disposer.call(shape);
+}
+//#endregion
+export { disposeShape as t };

package/dist/disposeShape-Bui9k40G.cjs

@@ -0,0 +1,12 @@
+//#region src/disposeShape.ts
+function disposeShape(shape) {
+	const disposer = shape?.[Symbol.dispose];
+	if (typeof disposer === "function") disposer.call(shape);
+}
+//#endregion
+Object.defineProperty(exports, "disposeShape", {
+	enumerable: true,
+	get: function() {
+		return disposeShape;
+	}
+});