brepjs-cad 0.173.0 → 0.175.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.175.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.174.0...brepjs-cad-v0.175.0) (2026-08-26)
+
+
+### Features
+
+* **brepjs-cad:** transpiling loader for multi-file TS/TSX projects + working watch ([#2228](https://github.com/andymai/brepjs/issues/2228)) ([980ead6](https://github.com/andymai/brepjs/commit/980ead6508867c31fcec1fd06a683f03bacb1e6f))
+
+## [0.174.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.173.0...brepjs-cad-v0.174.0) (2026-08-22)
+
+
+### Features
+
+* **families:** route BIM export on a declared archetype, not the family name ([#2222](https://github.com/andymai/brepjs/issues/2222)) ([53c90ae](https://github.com/andymai/brepjs/commit/53c90aef092ad24d11483fc2fbbff99b0e8eb285))
+
 ## [0.173.0](https://github.com/andymai/brepjs/compare/brepjs-cad-v0.172.0...brepjs-cad-v0.173.0) (2026-08-21)
 
 

package/dist/brepjs-cad.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_diff = require("./diff-DDu3OLyd.cjs");
+const require_diff = require("./diff-DX9zgrss.cjs");
 exports.DEFAULT_TOLERANCE_PCT = require_diff.DEFAULT_TOLERANCE_PCT;
 exports.TYPECHECK_CODE = require_diff.TYPECHECK_CODE;
 exports.emptyReport = require_diff.emptyReport;

package/dist/brepjs-cad.js

@@ -1,2 +1,2 @@
-import { a as typecheckPart, c as isExpectedDims, d as emptyReport, i as TYPECHECK_CODE, l as pctDelta, m as serializeReport, n as runMeasure, o as DEFAULT_TOLERANCE_PCT, r as runPart, s as evaluateExpected, t as runDiff, u as runChecks } from "./diff-CRu6Pqyr.js";
+import { a as typecheckPart, c as isExpectedDims, d as emptyReport, i as TYPECHECK_CODE, l as pctDelta, m as serializeReport, n as runMeasure, o as DEFAULT_TOLERANCE_PCT, r as runPart, s as evaluateExpected, t as runDiff, u as runChecks } from "./diff-B1sSWjLa.js";
 export { DEFAULT_TOLERANCE_PCT, TYPECHECK_CODE, emptyReport, evaluateExpected, isExpectedDims, pctDelta, runChecks, runDiff, runMeasure, runPart, serializeReport, typecheckPart };

package/dist/cli/main.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_diff = require("../diff-DDu3OLyd.cjs");
+const require_diff = require("../diff-DX9zgrss.cjs");
 let node_url = require("node:url");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
@@ -117,6 +117,74 @@ function debounce(fn, delayMs = 150) {
 		cancel
 	};
 }
+var SOURCE_FILE_RE = /\.(?:m?[jt]s|[jt]sx)$/;
+function isWatchRelevant(filename) {
+	if (filename === void 0 || filename === null) return true;
+	const name = filename.toString();
+	if (/(?:^|[\\/])tsconfig(?:\..+)?\.json$/.test(name)) return true;
+	return SOURCE_FILE_RE.test(name);
+}
+/**
+* Root the watcher at the project, not the entry's own directory: with the common
+* `src/main.ts` layout, tsconfig.json (whose JSX options change how sources transpile)
+* 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.
+*/
+function watchRootFor(entryPath) {
+	const start = (0, node_path.dirname)(entryPath);
+	let dir = start;
+	for (;;) {
+		if ((0, node_fs.existsSync)((0, node_path.join)(dir, "package.json")) || (0, node_fs.existsSync)((0, node_path.join)(dir, "tsconfig.json"))) return dir;
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) return start;
+		dir = parent;
+	}
+}
+var IGNORED_DIR_NAMES = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	".git"
+]);
+/**
+* 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
+* exclusion API, so on a real project it would descend into node_modules — tens of
+* thousands of inotify watches. Whenever an event fires in a directory it is re-scanned,
+* which picks up newly created subdirectories. Returns a stop function.
+*/
+function watchTree(root, onEvent) {
+	const watchers = /* @__PURE__ */ new Map();
+	const add = (dir) => {
+		if (watchers.has(dir)) return;
+		try {
+			watchers.set(dir, (0, node_fs.watch)(dir, (_event, filename) => {
+				scan(dir);
+				onEvent(filename);
+			}));
+		} catch {}
+	};
+	const scan = (dir) => {
+		let entries;
+		try {
+			entries = (0, node_fs.readdirSync)(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (!entry.isDirectory() || IGNORED_DIR_NAMES.has(entry.name)) continue;
+			const child = (0, node_path.join)(dir, entry.name);
+			if (watchers.has(child)) continue;
+			add(child);
+			scan(child);
+		}
+	};
+	add(root);
+	scan(root);
+	return () => {
+		for (const watcher of watchers.values()) watcher.close();
+		watchers.clear();
+	};
+}
 //#endregion
 //#region src/disposeShape.ts
 function disposeShape(shape) {
@@ -436,9 +504,9 @@ program.command("init").argument("<name>", "part name; scaffolds <name>.brep.ts
 });
 program.command("watch").argument("<file>", "path to a .brep.ts module; re-verifies on each save until Ctrl-C").action((file) => {
 	const path = (0, node_path.resolve)(file);
-	const run = async () => {
+	const run = async (fresh) => {
 		try {
-			const { report, shape } = await require_diff.runPart(path);
+			const { report, shape } = await require_diff.runPart(path, { freshImport: fresh });
 			try {
 				process.stdout.write(require_diff.serializeReport(report) + "\n");
 			} finally {
@@ -448,18 +516,33 @@ program.command("watch").argument("<file>", "path to a .brep.ts module; re-verif
 			process.stderr.write(`watch run failed: ${e.message}\n`);
 		}
 	};
-	const { trigger } = debounce(run, 150);
-	process.stderr.write(`watching ${path} (Ctrl-C to stop)\n`);
-	run();
-	const watcher = (0, node_fs.watch)((0, node_path.dirname)(path), (_event, filename) => {
-		if (filename === void 0 || filename === null) {
-			trigger();
+	let inFlight = false;
+	let rerunQueued = false;
+	const start = (fresh) => {
+		inFlight = true;
+		run(fresh).finally(() => {
+			inFlight = false;
+			if (rerunQueued) {
+				rerunQueued = false;
+				start(true);
+			}
+		});
+	};
+	const schedule = () => {
+		if (inFlight) {
+			rerunQueued = true;
 			return;
 		}
-		if ((0, node_path.basename)(path) === filename.toString()) trigger();
+		start(true);
+	};
+	const { trigger } = debounce(schedule, 150);
+	process.stderr.write(`watching ${path} (Ctrl-C to stop)\n`);
+	start(false);
+	const stopWatching = watchTree(watchRootFor(path), (filename) => {
+		if (isWatchRelevant(filename)) trigger();
 	});
 	const stop = () => {
-		watcher.close();
+		stopWatching();
 		process.exit(0);
 	};
 	process.on("SIGINT", stop);

package/dist/cli/main.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { f as pushError, h as loadBrep, m as serializeReport, n as runMeasure, p as reportOk, r as runPart, t as runDiff } from "../diff-CRu6Pqyr.js";
+import { f as pushError, h as loadBrep, m as serializeReport, n as runMeasure, p as reportOk, r as runPart, t as runDiff } from "../diff-B1sSWjLa.js";
 import { fileURLToPath } from "node:url";
-import { existsSync, globSync, mkdirSync, realpathSync, watch, writeFileSync } from "node:fs";
+import { existsSync, globSync, mkdirSync, readdirSync, realpathSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { Command } from "commander";
 import { tmpdir } from "node:os";
@@ -116,6 +116,74 @@ function debounce(fn, delayMs = 150) {
 		cancel
 	};
 }
+var SOURCE_FILE_RE = /\.(?:m?[jt]s|[jt]sx)$/;
+function isWatchRelevant(filename) {
+	if (filename === void 0 || filename === null) return true;
+	const name = filename.toString();
+	if (/(?:^|[\\/])tsconfig(?:\..+)?\.json$/.test(name)) return true;
+	return SOURCE_FILE_RE.test(name);
+}
+/**
+* Root the watcher at the project, not the entry's own directory: with the common
+* `src/main.ts` layout, tsconfig.json (whose JSX options change how sources transpile)
+* 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.
+*/
+function watchRootFor(entryPath) {
+	const start = dirname(entryPath);
+	let dir = start;
+	for (;;) {
+		if (existsSync(join(dir, "package.json")) || existsSync(join(dir, "tsconfig.json"))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return start;
+		dir = parent;
+	}
+}
+var IGNORED_DIR_NAMES = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	".git"
+]);
+/**
+* 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
+* exclusion API, so on a real project it would descend into node_modules — tens of
+* thousands of inotify watches. Whenever an event fires in a directory it is re-scanned,
+* which picks up newly created subdirectories. Returns a stop function.
+*/
+function watchTree(root, onEvent) {
+	const watchers = /* @__PURE__ */ new Map();
+	const add = (dir) => {
+		if (watchers.has(dir)) return;
+		try {
+			watchers.set(dir, watch(dir, (_event, filename) => {
+				scan(dir);
+				onEvent(filename);
+			}));
+		} catch {}
+	};
+	const scan = (dir) => {
+		let entries;
+		try {
+			entries = readdirSync(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (!entry.isDirectory() || IGNORED_DIR_NAMES.has(entry.name)) continue;
+			const child = join(dir, entry.name);
+			if (watchers.has(child)) continue;
+			add(child);
+			scan(child);
+		}
+	};
+	add(root);
+	scan(root);
+	return () => {
+		for (const watcher of watchers.values()) watcher.close();
+		watchers.clear();
+	};
+}
 //#endregion
 //#region src/disposeShape.ts
 function disposeShape(shape) {
@@ -435,9 +503,9 @@ program.command("init").argument("<name>", "part name; scaffolds <name>.brep.ts
 });
 program.command("watch").argument("<file>", "path to a .brep.ts module; re-verifies on each save until Ctrl-C").action((file) => {
 	const path = resolve(file);
-	const run = async () => {
+	const run = async (fresh) => {
 		try {
-			const { report, shape } = await runPart(path);
+			const { report, shape } = await runPart(path, { freshImport: fresh });
 			try {
 				process.stdout.write(serializeReport(report) + "\n");
 			} finally {
@@ -447,18 +515,33 @@ program.command("watch").argument("<file>", "path to a .brep.ts module; re-verif
 			process.stderr.write(`watch run failed: ${e.message}\n`);
 		}
 	};
-	const { trigger } = debounce(run, 150);
-	process.stderr.write(`watching ${path} (Ctrl-C to stop)\n`);
-	run();
-	const watcher = watch(dirname(path), (_event, filename) => {
-		if (filename === void 0 || filename === null) {
-			trigger();
+	let inFlight = false;
+	let rerunQueued = false;
+	const start = (fresh) => {
+		inFlight = true;
+		run(fresh).finally(() => {
+			inFlight = false;
+			if (rerunQueued) {
+				rerunQueued = false;
+				start(true);
+			}
+		});
+	};
+	const schedule = () => {
+		if (inFlight) {
+			rerunQueued = true;
 			return;
 		}
-		if (basename(path) === filename.toString()) trigger();
+		start(true);
+	};
+	const { trigger } = debounce(schedule, 150);
+	process.stderr.write(`watching ${path} (Ctrl-C to stop)\n`);
+	start(false);
+	const stopWatching = watchTree(watchRootFor(path), (filename) => {
+		if (isWatchRelevant(filename)) trigger();
 	});
 	const stop = () => {
-		watcher.close();
+		stopWatching();
 		process.exit(0);
 	};
 	process.on("SIGINT", stop);

package/dist/cli/watch.d.ts

@@ -3,3 +3,19 @@ export declare function debounce(fn: () => void | Promise<void>, delayMs?: numbe
     trigger: () => void;
     cancel: () => void;
 };
+export declare function isWatchRelevant(filename: string | Buffer | null | undefined): boolean;
+/**
+ * Root the watcher at the project, not the entry's own directory: with the common
+ * `src/main.ts` layout, tsconfig.json (whose JSX options change how sources transpile)
+ * 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;
+/**
+ * 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
+ * exclusion API, so on a real project it would descend into node_modules — tens of
+ * thousands of inotify watches. Whenever an event fires in a directory it is re-scanned,
+ * which picks up newly created subdirectories. Returns a stop function.
+ */
+export declare function watchTree(root: string, onEvent: (filename: string | Buffer | null | undefined) => void): () => void;

package/dist/{diff-CRu6Pqyr.js → diff-B1sSWjLa.js}

@@ -19,8 +19,9 @@ function toolDir() {
 	}
 }
 function loaderUrl(dir) {
-	const built = resolve(dir, "dist", "loader", "brepjsResolve.mjs");
 	const source = resolve(dir, "src", "loader", "brepjsResolve.mjs");
+	const built = resolve(dir, "dist", "loader", "brepjsResolve.mjs");
+	if (import.meta.url.startsWith(pathToFileURL(resolve(dir, "src") + "/").href)) return pathToFileURL(source).href;
 	return pathToFileURL(existsSync(built) ? built : source).href;
 }
 function registerHook() {
@@ -696,6 +697,33 @@ function packageRootOf(startDir, name) {
 		dir = dirname(dir);
 	}
 }
+/**
+* JSX options for a part come from the nearest tsconfig.json — the same source the
+* runtime load hook reads — so `--check` and execution agree on the dialect
+* (families projects set `jsx: react-jsx` + `jsxImportSource: brepjs-families`).
+* A `.tsx` part with nothing configured defaults to the automatic runtime.
+*/
+function jsxCompilerOptions(partPath) {
+	const out = {};
+	const configPath = ts.findConfigFile(dirname(partPath), (f) => ts.sys.fileExists(f));
+	if (configPath) {
+		const host = {
+			...ts.sys,
+			onUnRecoverableConfigFileDiagnostic: () => {}
+		};
+		const parsed = ts.getParsedCommandLineOfConfigFile(configPath, void 0, host);
+		if (parsed) {
+			for (const key of [
+				"jsx",
+				"jsxImportSource",
+				"jsxFactory",
+				"jsxFragmentFactory"
+			]) if (parsed.options[key] !== void 0) out[key] = parsed.options[key];
+		}
+	}
+	if (partPath.endsWith(".tsx") && out.jsx === void 0) out.jsx = ts.JsxEmit.ReactJSX;
+	return out;
+}
 var COMPILER_OPTIONS = {
 	target: ts.ScriptTarget.ES2022,
 	module: ts.ModuleKind.ESNext,
@@ -747,7 +775,10 @@ function diagnosticToErrorInfo(d) {
 */
 function typecheckPart(partPath, toolDir) {
 	const dts = resolveBrepjsTypes(partPath, toolDir);
-	const options = { ...COMPILER_OPTIONS };
+	const options = {
+		...COMPILER_OPTIONS,
+		...jsxCompilerOptions(partPath)
+	};
 	if (dts) options.paths = { brepjs: [dts] };
 	const typesRoot = nodeTypesRoot(partPath, toolDir);
 	if (typesRoot) {
@@ -800,12 +831,15 @@ function buildMaterialMap(m, spec) {
 	}
 	return map.size > 0 ? { map } : {};
 }
-async function loadPart(modulePath) {
+var importGeneration = 0;
+async function loadPart(modulePath, fresh = false) {
+	const url = new URL(pathToFileURL(modulePath).href);
+	if (fresh) url.searchParams.set("v", String(++importGeneration));
 	try {
-		return await import(pathToFileURL(modulePath).href);
+		return await import(url.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 });
+		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). (${msg})`, { cause: e });
 		throw e;
 	}
 }
@@ -865,7 +899,7 @@ async function runPart(modulePath, opts = {}) {
 	const { isOk, mesh, exportGlb, exportSTEP } = brep;
 	let mod;
 	try {
-		mod = await loadPart(modulePath);
+		mod = await loadPart(modulePath, opts.freshImport);
 	} catch (e) {
 		pushError(report, toErrorInfo("import failed", e));
 		return finalize({

package/dist/{diff-DDu3OLyd.cjs → diff-DX9zgrss.cjs}

@@ -21,8 +21,9 @@ function toolDir() {
 	}
 }
 function loaderUrl(dir) {
-	const built = (0, node_path.resolve)(dir, "dist", "loader", "brepjsResolve.mjs");
 	const source = (0, node_path.resolve)(dir, "src", "loader", "brepjsResolve.mjs");
+	const built = (0, node_path.resolve)(dir, "dist", "loader", "brepjsResolve.mjs");
+	if ({}.url.startsWith((0, node_url.pathToFileURL)((0, node_path.resolve)(dir, "src") + "/").href)) return (0, node_url.pathToFileURL)(source).href;
 	return (0, node_url.pathToFileURL)((0, node_fs.existsSync)(built) ? built : source).href;
 }
 function registerHook() {
@@ -698,6 +699,33 @@ function packageRootOf(startDir, name) {
 		dir = (0, node_path.dirname)(dir);
 	}
 }
+/**
+* JSX options for a part come from the nearest tsconfig.json — the same source the
+* runtime load hook reads — so `--check` and execution agree on the dialect
+* (families projects set `jsx: react-jsx` + `jsxImportSource: brepjs-families`).
+* A `.tsx` part with nothing configured defaults to the automatic runtime.
+*/
+function jsxCompilerOptions(partPath) {
+	const out = {};
+	const configPath = typescript.default.findConfigFile((0, node_path.dirname)(partPath), (f) => typescript.default.sys.fileExists(f));
+	if (configPath) {
+		const host = {
+			...typescript.default.sys,
+			onUnRecoverableConfigFileDiagnostic: () => {}
+		};
+		const parsed = typescript.default.getParsedCommandLineOfConfigFile(configPath, void 0, host);
+		if (parsed) {
+			for (const key of [
+				"jsx",
+				"jsxImportSource",
+				"jsxFactory",
+				"jsxFragmentFactory"
+			]) if (parsed.options[key] !== void 0) out[key] = parsed.options[key];
+		}
+	}
+	if (partPath.endsWith(".tsx") && out.jsx === void 0) out.jsx = typescript.default.JsxEmit.ReactJSX;
+	return out;
+}
 var COMPILER_OPTIONS = {
 	target: typescript.default.ScriptTarget.ES2022,
 	module: typescript.default.ModuleKind.ESNext,
@@ -749,7 +777,10 @@ function diagnosticToErrorInfo(d) {
 */
 function typecheckPart(partPath, toolDir) {
 	const dts = resolveBrepjsTypes(partPath, toolDir);
-	const options = { ...COMPILER_OPTIONS };
+	const options = {
+		...COMPILER_OPTIONS,
+		...jsxCompilerOptions(partPath)
+	};
 	if (dts) options.paths = { brepjs: [dts] };
 	const typesRoot = nodeTypesRoot(partPath, toolDir);
 	if (typesRoot) {
@@ -802,12 +833,15 @@ function buildMaterialMap(m, spec) {
 	}
 	return map.size > 0 ? { map } : {};
 }
-async function loadPart(modulePath) {
+var importGeneration = 0;
+async function loadPart(modulePath, fresh = false) {
+	const url = new URL((0, node_url.pathToFileURL)(modulePath).href);
+	if (fresh) url.searchParams.set("v", String(++importGeneration));
 	try {
-		return await import((0, node_url.pathToFileURL)(modulePath).href);
+		return await import(url.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 });
+		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). (${msg})`, { cause: e });
 		throw e;
 	}
 }
@@ -867,7 +901,7 @@ async function runPart(modulePath, opts = {}) {
 	const { isOk, mesh, exportGlb, exportSTEP } = brep;
 	let mod;
 	try {
-		mod = await loadPart(modulePath);
+		mod = await loadPart(modulePath, opts.freshImport);
 	} catch (e) {
 		pushError(report, toErrorInfo("import failed", e));
 		return finalize({