brepjs-cad 0.1.0

package/dist/snapshot/serve.js

@@ -0,0 +1,26 @@
+import { acquireServer } from "./registry.js";
+import { basename, dirname, resolve } from "node:path";
+//#region src/snapshot/serve.ts
+function viewerUrl(base, file) {
+	if (!file) return base;
+	const abs = resolve(file);
+	return `${base}/?dir=${encodeURIComponent(dirname(abs))}&file=${encodeURIComponent(basename(abs))}`;
+}
+/** Acquire (reuse or start) the persistent server and return its viewer URL. */
+async function serve(opts = {}) {
+	const server = await acquireServer(opts);
+	const url = viewerUrl(server.url, opts.file);
+	if (!server.reused) {
+		const onSig = () => void server.close().then(() => process.exit(0));
+		process.once("SIGINT", onSig);
+		process.once("SIGTERM", onSig);
+	}
+	return {
+		port: server.port,
+		url,
+		reused: server.reused,
+		close: () => server.close()
+	};
+}
+//#endregion
+export { serve };

package/dist/snapshot/shoot.cjs

@@ -0,0 +1,85 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_snapshot_registry = require("./registry.cjs");
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
+let puppeteer = require("puppeteer");
+puppeteer = __toESM(puppeteer, 1);
+//#region src/snapshot/shoot.ts
+var VIEWS = [
+	"iso",
+	"front",
+	"top",
+	"right"
+];
+var READY_TIMEOUT_MS = 9e4;
+async function shoot(opts) {
+	const absFile = (0, node_path.resolve)(opts.file);
+	const dir = (0, node_path.dirname)(absFile);
+	const rel = (0, node_path.basename)(absFile);
+	const views = opts.views ?? VIEWS;
+	await (0, node_fs_promises.mkdir)(opts.outDir, { recursive: true });
+	const server = await require_snapshot_registry.acquireServer(opts);
+	const browser = await puppeteer.default.launch({
+		headless: true,
+		args: [
+			"--no-sandbox",
+			"--use-gl=angle",
+			"--use-angle=swiftshader",
+			"--enable-unsafe-swiftshader"
+		]
+	});
+	const pngs = [];
+	try {
+		const page = await browser.newPage();
+		await page.setViewport({
+			width: 1200,
+			height: 900
+		});
+		const target = `${server.url}/?dir=${encodeURIComponent(dir)}&file=${encodeURIComponent(rel)}`;
+		await page.goto(target, {
+			waitUntil: "domcontentloaded",
+			timeout: 3e4
+		});
+		await page.waitForFunction("window.__ready === true", { timeout: READY_TIMEOUT_MS });
+		for (const view of views) {
+			await page.evaluate((v) => {
+				globalThis.__renderView(v);
+			}, view);
+			await new Promise((r) => setTimeout(r, opts.settleMs ?? 400));
+			const path = (0, node_path.resolve)(opts.outDir, `${view}.png`);
+			await page.screenshot({ path });
+			pngs.push(path);
+		}
+	} finally {
+		await browser.close();
+		await server.close();
+	}
+	return {
+		outDir: opts.outDir,
+		pngs
+	};
+}
+//#endregion
+exports.shoot = shoot;

package/dist/snapshot/shoot.d.ts

@@ -0,0 +1,14 @@
+import { AcquireOptions } from './registry.js';
+export type ViewName = 'iso' | 'front' | 'top' | 'right';
+export interface ShootOptions extends AcquireOptions {
+    file: string;
+    outDir: string;
+    views?: readonly ViewName[];
+    /** Wall-clock ms to let the camera settle before each capture (default 400; raise on slow CI). */
+    settleMs?: number;
+}
+export interface ShootResult {
+    outDir: string;
+    pngs: string[];
+}
+export declare function shoot(opts: ShootOptions): Promise<ShootResult>;

package/dist/snapshot/shoot.js

@@ -0,0 +1,61 @@
+import { acquireServer } from "./registry.js";
+import { basename, dirname, resolve } from "node:path";
+import { mkdir } from "node:fs/promises";
+import puppeteer from "puppeteer";
+//#region src/snapshot/shoot.ts
+var VIEWS = [
+	"iso",
+	"front",
+	"top",
+	"right"
+];
+var READY_TIMEOUT_MS = 9e4;
+async function shoot(opts) {
+	const absFile = resolve(opts.file);
+	const dir = dirname(absFile);
+	const rel = basename(absFile);
+	const views = opts.views ?? VIEWS;
+	await mkdir(opts.outDir, { recursive: true });
+	const server = await acquireServer(opts);
+	const browser = await puppeteer.launch({
+		headless: true,
+		args: [
+			"--no-sandbox",
+			"--use-gl=angle",
+			"--use-angle=swiftshader",
+			"--enable-unsafe-swiftshader"
+		]
+	});
+	const pngs = [];
+	try {
+		const page = await browser.newPage();
+		await page.setViewport({
+			width: 1200,
+			height: 900
+		});
+		const target = `${server.url}/?dir=${encodeURIComponent(dir)}&file=${encodeURIComponent(rel)}`;
+		await page.goto(target, {
+			waitUntil: "domcontentloaded",
+			timeout: 3e4
+		});
+		await page.waitForFunction("window.__ready === true", { timeout: READY_TIMEOUT_MS });
+		for (const view of views) {
+			await page.evaluate((v) => {
+				globalThis.__renderView(v);
+			}, view);
+			await new Promise((r) => setTimeout(r, opts.settleMs ?? 400));
+			const path = resolve(opts.outDir, `${view}.png`);
+			await page.screenshot({ path });
+			pngs.push(path);
+		}
+	} finally {
+		await browser.close();
+		await server.close();
+	}
+	return {
+		outDir: opts.outDir,
+		pngs
+	};
+}
+//#endregion
+export { shoot };

package/dist/snapshot/static.cjs

@@ -0,0 +1,99 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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
+var SERVER_API_VERSION = 1;
+var VIEWER_DIST = (0, node_path.resolve)((0, node_path.dirname)((0, node_url.fileURLToPath)({}.url)), "../../viewer/dist");
+var MIME = {
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".wasm": "application/wasm",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".step": "application/step",
+	".stp": "application/step",
+	".stl": "model/stl",
+	".obj": "text/plain; charset=utf-8"
+};
+var mimeFor = (p) => MIME[(0, node_path.extname)(p).toLowerCase()] ?? "application/octet-stream";
+async function sendFile(res, absPath) {
+	const info = await (0, node_fs_promises.stat)(absPath);
+	if (!info.isFile()) {
+		res.writeHead(404).end("not found");
+		return;
+	}
+	res.writeHead(200, {
+		"content-type": mimeFor(absPath),
+		"content-length": info.size
+	});
+	(0, node_fs.createReadStream)(absPath).pipe(res);
+}
+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;
+}
+async function handle(req, res, port) {
+	const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);
+	if (url.pathname === "/__cad/server") {
+		const d = {
+			app: "brepjs-cad-viewer",
+			port,
+			dynamicRoot: true,
+			serverApiVersion: 1
+		};
+		res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+		res.end(JSON.stringify(d));
+		return;
+	}
+	if (url.pathname.startsWith("/__model/")) {
+		const root = url.searchParams.get("dir");
+		if (!root) {
+			res.writeHead(400).end("missing dir");
+			return;
+		}
+		const abs = safeJoin((0, node_path.resolve)(root), url.pathname.slice(8));
+		if (!abs) {
+			res.writeHead(403).end("forbidden");
+			return;
+		}
+		await sendFile(res, abs).catch(() => res.writeHead(404).end("not found"));
+		return;
+	}
+	if (url.searchParams.has("dir") && url.pathname !== "/") {
+		res.writeHead(403).end("forbidden");
+		return;
+	}
+	const abs = safeJoin(VIEWER_DIST, url.pathname === "/" ? "index.html" : url.pathname);
+	if (!abs) {
+		res.writeHead(403).end("forbidden");
+		return;
+	}
+	await sendFile(res, abs).catch(() => sendFile(res, (0, node_path.join)(VIEWER_DIST, "index.html")).catch(() => res.writeHead(404).end("not found")));
+}
+function startStaticServer(opts = {}) {
+	return new Promise((resolvePromise, reject) => {
+		const server = (0, node_http.createServer)((req, res) => {
+			handle(req, res, server.address().port);
+		});
+		server.on("error", reject);
+		server.listen(opts.port ?? 0, "127.0.0.1", () => {
+			const port = server.address().port;
+			resolvePromise({
+				port,
+				url: `http://127.0.0.1:${port}`,
+				close: () => new Promise((done, fail) => server.close((e) => e ? fail(e) : done()))
+			});
+		});
+	});
+}
+//#endregion
+exports.SERVER_API_VERSION = SERVER_API_VERSION;
+exports.startStaticServer = startStaticServer;

package/dist/snapshot/static.d.ts

@@ -0,0 +1,16 @@
+export declare const SERVER_API_VERSION = 1;
+export interface StaticServerOptions {
+    port?: number;
+}
+export interface StaticServer {
+    port: number;
+    url: string;
+    close(): Promise<void>;
+}
+export interface ServerDescriptor {
+    app: 'brepjs-cad-viewer';
+    port: number;
+    dynamicRoot: true;
+    serverApiVersion: number;
+}
+export declare function startStaticServer(opts?: StaticServerOptions): Promise<StaticServer>;

package/dist/snapshot/static.js

@@ -0,0 +1,97 @@
+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
+var SERVER_API_VERSION = 1;
+var VIEWER_DIST = resolve(dirname(fileURLToPath(import.meta.url)), "../../viewer/dist");
+var MIME = {
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".wasm": "application/wasm",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".step": "application/step",
+	".stp": "application/step",
+	".stl": "model/stl",
+	".obj": "text/plain; charset=utf-8"
+};
+var mimeFor = (p) => MIME[extname(p).toLowerCase()] ?? "application/octet-stream";
+async function sendFile(res, absPath) {
+	const info = await stat(absPath);
+	if (!info.isFile()) {
+		res.writeHead(404).end("not found");
+		return;
+	}
+	res.writeHead(200, {
+		"content-type": mimeFor(absPath),
+		"content-length": info.size
+	});
+	createReadStream(absPath).pipe(res);
+}
+function safeJoin(root, rel) {
+	const abs = resolve(root, normalize(decodeURIComponent(rel.replace(/^\/+/, ""))));
+	return abs !== root && !abs.startsWith(root + sep) ? null : abs;
+}
+async function handle(req, res, port) {
+	const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);
+	if (url.pathname === "/__cad/server") {
+		const d = {
+			app: "brepjs-cad-viewer",
+			port,
+			dynamicRoot: true,
+			serverApiVersion: 1
+		};
+		res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+		res.end(JSON.stringify(d));
+		return;
+	}
+	if (url.pathname.startsWith("/__model/")) {
+		const root = url.searchParams.get("dir");
+		if (!root) {
+			res.writeHead(400).end("missing dir");
+			return;
+		}
+		const abs = safeJoin(resolve(root), url.pathname.slice(8));
+		if (!abs) {
+			res.writeHead(403).end("forbidden");
+			return;
+		}
+		await sendFile(res, abs).catch(() => res.writeHead(404).end("not found"));
+		return;
+	}
+	if (url.searchParams.has("dir") && url.pathname !== "/") {
+		res.writeHead(403).end("forbidden");
+		return;
+	}
+	const abs = safeJoin(VIEWER_DIST, url.pathname === "/" ? "index.html" : url.pathname);
+	if (!abs) {
+		res.writeHead(403).end("forbidden");
+		return;
+	}
+	await sendFile(res, abs).catch(() => sendFile(res, join(VIEWER_DIST, "index.html")).catch(() => res.writeHead(404).end("not found")));
+}
+function startStaticServer(opts = {}) {
+	return new Promise((resolvePromise, reject) => {
+		const server = createServer((req, res) => {
+			handle(req, res, server.address().port);
+		});
+		server.on("error", reject);
+		server.listen(opts.port ?? 0, "127.0.0.1", () => {
+			const port = server.address().port;
+			resolvePromise({
+				port,
+				url: `http://127.0.0.1:${port}`,
+				close: () => new Promise((done, fail) => server.close((e) => e ? fail(e) : done()))
+			});
+		});
+	});
+}
+//#endregion
+export { SERVER_API_VERSION, startStaticServer };

package/dist/verify/checks.d.ts

@@ -0,0 +1,3 @@
+import { AnyShape } from 'brepjs';
+import { VerifyReport } from './report.js';
+export declare function runChecks(shape: AnyShape): VerifyReport;

package/dist/verify/diff.d.ts

@@ -0,0 +1,2 @@
+import { DiffReport } from './report.js';
+export declare function runDiff(aPath: string, bPath: string): Promise<DiffReport>;

package/dist/verify/measure.d.ts

@@ -0,0 +1,6 @@
+export interface MeasureReport {
+    length?: number;
+    distance?: number;
+    errors: string[];
+}
+export declare function runMeasure(aPath: string, bPath?: string): Promise<MeasureReport>;

package/dist/verify/report.d.ts

@@ -0,0 +1,63 @@
+export interface VerifyCheck {
+    name: string;
+    passed: boolean;
+    detail?: string;
+}
+export interface VerifyMeasurements {
+    volume?: number;
+    area?: number;
+    bounds?: {
+        xMin: number;
+        xMax: number;
+        yMin: number;
+        yMax: number;
+        zMin: number;
+        zMax: number;
+    };
+}
+/** A failure captured with whatever structured context it carried (a `BrepError` code/suggestion). */
+export interface ErrorInfo {
+    message: string;
+    code?: string | undefined;
+    suggestion?: string | undefined;
+}
+export interface VerifyHint {
+    code: string;
+    message: string;
+    fix: string;
+    nextStep: string;
+}
+export interface VerifyReport {
+    shapeType: string | null;
+    checks: VerifyCheck[];
+    measurements: VerifyMeasurements;
+    errors: string[];
+    /** Structured copies of `errors`, carrying any `BrepError` code/suggestion. Drives `hints`. */
+    errorInfos: ErrorInfo[];
+    /** Actionable, code-keyed guidance derived from `errorInfos`. */
+    hints: VerifyHint[];
+}
+export interface BoundsDelta {
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+    zMin: number;
+    zMax: number;
+}
+export interface DiffReport {
+    volumeDelta: number;
+    areaDelta: number;
+    bboxDelta: BoundsDelta;
+    symmetricDifferenceVolume: number;
+    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). */
+export declare const VALIDITY_FAILURE_CODE = "VALIDATION_FAILED";
+export declare function hintFor(info: ErrorInfo): VerifyHint | null;
+export declare function buildHints(r: VerifyReport): VerifyHint[];
+export declare function serializeReport(r: VerifyReport): string;

package/dist/verify/runPart.d.ts

@@ -0,0 +1,18 @@
+import { AnyShape } from 'brepjs';
+import { VerifyReport } from './report.js';
+export interface RunPartOptions {
+    step?: boolean;
+    glb?: boolean;
+}
+export interface RunPartResult {
+    /**
+     * The built shape, or null on failure. This is a LIVE WASM-backed kernel handle: the CLI exits
+     * right after use, but long-running programmatic callers own its lifetime and should release it
+     * (e.g. `using s = result.shape` or a `DisposalScope`) once done, or WASM memory accumulates.
+     */
+    shape: AnyShape | null;
+    report: VerifyReport;
+    step?: ArrayBuffer | undefined;
+    glb?: ArrayBuffer | undefined;
+}
+export declare function runPart(modulePath: string, opts?: RunPartOptions): Promise<RunPartResult>;

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "brepjs-cad",
+  "version": "0.1.0",
+  "description": "Agent skill + verify/preview tooling for authoring parametric brepjs CAD code",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andymai/brepjs",
+    "directory": "packages/brepjs-cad"
+  },
+  "main": "./dist/brepjs-cad.cjs",
+  "module": "./dist/brepjs-cad.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/brepjs-cad.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/brepjs-cad.cjs"
+      }
+    }
+  },
+  "bin": {
+    "brepjs": "./dist/cli/main.js",
+    "brepjs-agent-verify": "./dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "viewer/dist",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build && vite build --config viewer/vite.config.ts",
+    "typecheck": "tsc --noEmit && tsc -p viewer/tsconfig.json --noEmit && tsc -p bench/tsconfig.json",
+    "lint": "eslint src tests viewer bench",
+    "test": "vitest run",
+    "eval": "tsx bench/run.ts",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "brepjs": ">=18.0.0",
+    "occt-wasm": ">=3.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "optionalDependencies": {
+    "puppeteer": "^25.0.4"
+  },
+  "devDependencies": {
+    "@react-three/drei": "^10.7.7",
+    "@react-three/fiber": "^9.6.1",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "@types/three": "^0.184.1",
+    "@vitejs/plugin-react": "^6.0.2",
+    "brepjs-viewer": "^0.1.0",
+    "eslint": "^10.4.0",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "three": "^0.184.0",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.0",
+    "vite-plugin-dts": "^5.0.1",
+    "vitest": "^4.0.0"
+  }
+}