brepjs 13.1.0 → 13.4.0

package/dist/operations.js

@@ -1,3 +1,3 @@
-import { C as walkAssembly, D as exportAssemblySTEP, E as linearPattern, O as createAssembly, S as updateNode, T as gridPattern, _ as collectShapes, a as findStep, b as findNode, c as registerOperation, d as replayHistory, g as addChild, h as undoLast, l as registerShape, m as stepsFrom, n as createHistory, o as getShape, p as stepCount, r as createRegistry, s as modifyStep, t as addStep, u as replayFrom, v as countNodes, w as circularPattern, x as removeChild, y as createAssemblyNode } from "./historyFns-r1owwcvA.js";
-import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./extrudeFns-CDWViQSe.js";
+import { C as walkAssembly, D as exportAssemblySTEP, E as linearPattern, O as createAssembly, S as updateNode, T as gridPattern, _ as collectShapes, a as findStep, b as findNode, c as registerOperation, d as replayHistory, g as addChild, h as undoLast, l as registerShape, m as stepsFrom, n as createHistory, o as getShape, p as stepCount, r as createRegistry, s as modifyStep, t as addStep, u as replayFrom, v as countNodes, w as circularPattern, x as removeChild, y as createAssemblyNode } from "./historyFns-BFwp8NLX.js";
+import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./extrudeFns-b0uLn4E4.js";
 export { addChild, addStep, circularPattern, collectShapes, complexExtrude, countNodes, createAssembly, createAssemblyNode, createHistory, createRegistry, exportAssemblySTEP, findNode, findStep, getShape as getHistoryShape, gridPattern, linearPattern, modifyStep, registerOperation, registerShape, removeChild, replayFrom, replayHistory, stepCount, stepsFrom, supportExtrude, sweep, twistExtrude, undoLast, updateNode, walkAssembly };

package/dist/{planeOps-DA5DmML2.cjs → planeOps-BqLav0Ir.cjs}

@@ -1,6 +1,6 @@
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_types = require("./types-BD-VVaWB.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_types = require("./types-BjDcsS7l.cjs");
 //#region src/core/planeOps.ts
 /**
 * Create a {@link Plane} from an origin, optional X direction, and a normal.

package/dist/{planeOps-D4THn1al.js → planeOps-D88tfyJs.js}

@@ -1,6 +1,6 @@
-import { L as unwrap, d as validationError, k as ok, y as err } from "./errors-D7ZQfeqv.js";
-import { _ as DEG2RAD, d as vecNormalize, h as vecScale, m as vecRotate, r as vecCross, s as vecIsZero, t as vecAdd } from "./vecOps-B9-MTeC8.js";
-import { r as toVec3 } from "./types-Bb4KK_iG.js";
+import { L as unwrap, d as validationError, k as ok, y as err } from "./errors-BVOlxlIA.js";
+import { _ as DEG2RAD, d as vecNormalize, h as vecScale, m as vecRotate, r as vecCross, s as vecIsZero, t as vecAdd } from "./vecOps-DFfUfsmc.js";
+import { r as toVec3 } from "./types-BWBlwp6w.js";
 //#region src/core/planeOps.ts
 /**
 * Create a {@link Plane} from an origin, optional X direction, and a normal.

package/dist/{primitiveFns-DtAy6t6n.cjs → primitiveFns-BGh9A9jR.cjs}

@@ -1,10 +1,10 @@
-const require_shapeTypes = require("./shapeTypes-Du2qyM2n.cjs");
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_faceFns = require("./faceFns-DSUZvptN.cjs");
-const require_arrayAccess = require("./arrayAccess-FwdVX3Nh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BCiMuuGV.cjs");
-const require_solidBuilders = require("./solidBuilders-BePRwqfJ.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_faceFns = require("./faceFns-BywUjlJ7.cjs");
+const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-CZzipftq.cjs");
+const require_solidBuilders = require("./solidBuilders-D9KYP9sL.cjs");
 //#region src/topology/threeHelpers.ts
 /**
 * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.
@@ -294,6 +294,48 @@ function sharedEdges(face1, face2) {
 	return wrapAll(shared, "edge");
 }
 //#endregion
+//#region src/topology/nurbsFns.ts
+/**
+* Extract NURBS data from a BSpline or Bezier edge.
+* Returns null if the edge is not a NURBS curve (e.g., line, circle).
+*/
+function getNurbsCurveData(edge) {
+	const kernel = require_shapeTypes.getKernel();
+	if (!kernel.getNurbsCurveData) return null;
+	return kernel.getNurbsCurveData(edge.wrapped);
+}
+/**
+* Extract NURBS data from a BSpline face.
+* Returns null if the face is not a BSpline surface (e.g., plane, cylinder).
+*/
+function getNurbsSurfaceData(face) {
+	const kernel = require_shapeTypes.getKernel();
+	if (!kernel.getNurbsSurfaceData) return null;
+	return kernel.getNurbsSurfaceData(face.wrapped);
+}
+//#endregion
+//#region src/topology/booleanDiagnosticFns.ts
+/**
+* Boolean pre-validation diagnostics.
+*/
+/**
+* Pre-validate operands before a boolean operation.
+*
+* Checks that both shapes are non-null and topologically valid.
+* Returns a structured report of any issues found.
+*
+* @example
+* ```typescript
+* const check = checkBoolean(base, tool, 'fuse');
+* if (!check.valid) {
+*   console.warn('Boolean will likely fail:', check.issues);
+* }
+* ```
+*/
+function checkBoolean(base, tool, op) {
+	return require_shapeTypes.getKernel().checkBoolean(base.wrapped, tool.wrapped, op);
+}
+//#endregion
 //#region src/topology/evolutionFns.ts
 /**
 * Evolution-tracking variants of boolean and modifier operations.
@@ -1481,6 +1523,12 @@ Object.defineProperty(exports, "chamferWithEvolution", {
 		return chamferWithEvolution;
 	}
 });
+Object.defineProperty(exports, "checkBoolean", {
+	enumerable: true,
+	get: function() {
+		return checkBoolean;
+	}
+});
 Object.defineProperty(exports, "circle", {
 	enumerable: true,
 	get: function() {
@@ -1589,6 +1637,18 @@ Object.defineProperty(exports, "fuseWithEvolution", {
 		return fuseWithEvolution;
 	}
 });
+Object.defineProperty(exports, "getNurbsCurveData", {
+	enumerable: true,
+	get: function() {
+		return getNurbsCurveData;
+	}
+});
+Object.defineProperty(exports, "getNurbsSurfaceData", {
+	enumerable: true,
+	get: function() {
+		return getNurbsSurfaceData;
+	}
+});
 Object.defineProperty(exports, "heal", {
 	enumerable: true,
 	get: function() {

package/dist/{primitiveFns-CfCgkRwY.js → primitiveFns-CnZkW6Bi.js}

@@ -1,10 +1,10 @@
-import { Y as getKernel, _ as isSolid, c as createSolid, h as isShape3D, p as isFace, r as castShapeWithKnownType, t as castShape, x as isClosedWire, y as isWire } from "./shapeTypes-Beo7ikOL.js";
-import { C as isErr, _ as andThen, d as validationError, i as kernelError, k as ok, l as typeCastError, t as BrepErrorCode, w as isOk, y as err } from "./errors-D7ZQfeqv.js";
-import { _ as DEG2RAD, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
-import { _ as downcast } from "./faceFns-6mY9O_5h.js";
-import { F as getEdges, I as getFaces, L as getOrCreateCache, b as propagateAllMetadata, v as translate, y as collectInputFaceHashes, z as getWires } from "./arrayAccess-Bz2OkAF_.js";
-import { a as makeNonPlanarFace, c as makeBSplineApproximation, d as makeEllipse, f as makeEllipseArc, g as makeThreePointArc, h as makeTangentArc, i as makeNewFaceWithinFace, l as makeBezierCurve, m as makeLine, o as makePolygon, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-BC0MvMK1.js";
-import { a as makeOffset, c as makeTorus, i as makeEllipsoid, l as makeVertex, n as makeCone, o as makeSolid, r as makeCylinder, s as makeSphere, t as makeCompound, u as weldShellsAndFaces } from "./solidBuilders-8CBjeBfT.js";
+import { Y as getKernel, _ as isSolid, c as createSolid, h as isShape3D, p as isFace, r as castShapeWithKnownType, t as castShape, x as isClosedWire, y as isWire } from "./shapeTypes-Di6GlhPk.js";
+import { C as isErr, _ as andThen, d as validationError, i as kernelError, k as ok, l as typeCastError, t as BrepErrorCode, w as isOk, y as err } from "./errors-BVOlxlIA.js";
+import { _ as DEG2RAD, v as HASH_CODE_MAX } from "./vecOps-DFfUfsmc.js";
+import { _ as downcast } from "./faceFns-Cat-4X74.js";
+import { F as getEdges, I as getFaces, L as getOrCreateCache, b as propagateAllMetadata, v as translate, y as collectInputFaceHashes, z as getWires } from "./arrayAccess-B5LgmXBo.js";
+import { a as makeNonPlanarFace, c as makeBSplineApproximation, d as makeEllipse, f as makeEllipseArc, g as makeThreePointArc, h as makeTangentArc, i as makeNewFaceWithinFace, l as makeBezierCurve, m as makeLine, o as makePolygon, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-BaqeZa0x.js";
+import { a as makeOffset, c as makeTorus, i as makeEllipsoid, l as makeVertex, n as makeCone, o as makeSolid, r as makeCylinder, s as makeSphere, t as makeCompound, u as weldShellsAndFaces } from "./solidBuilders-ctO_wFrm.js";
 //#region src/topology/threeHelpers.ts
 /**
 * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.
@@ -294,6 +294,48 @@ function sharedEdges(face1, face2) {
 	return wrapAll(shared, "edge");
 }
 //#endregion
+//#region src/topology/nurbsFns.ts
+/**
+* Extract NURBS data from a BSpline or Bezier edge.
+* Returns null if the edge is not a NURBS curve (e.g., line, circle).
+*/
+function getNurbsCurveData(edge) {
+	const kernel = getKernel();
+	if (!kernel.getNurbsCurveData) return null;
+	return kernel.getNurbsCurveData(edge.wrapped);
+}
+/**
+* Extract NURBS data from a BSpline face.
+* Returns null if the face is not a BSpline surface (e.g., plane, cylinder).
+*/
+function getNurbsSurfaceData(face) {
+	const kernel = getKernel();
+	if (!kernel.getNurbsSurfaceData) return null;
+	return kernel.getNurbsSurfaceData(face.wrapped);
+}
+//#endregion
+//#region src/topology/booleanDiagnosticFns.ts
+/**
+* Boolean pre-validation diagnostics.
+*/
+/**
+* Pre-validate operands before a boolean operation.
+*
+* Checks that both shapes are non-null and topologically valid.
+* Returns a structured report of any issues found.
+*
+* @example
+* ```typescript
+* const check = checkBoolean(base, tool, 'fuse');
+* if (!check.valid) {
+*   console.warn('Boolean will likely fail:', check.issues);
+* }
+* ```
+*/
+function checkBoolean(base, tool, op) {
+	return getKernel().checkBoolean(base.wrapped, tool.wrapped, op);
+}
+//#endregion
 //#region src/topology/evolutionFns.ts
 /**
 * Evolution-tracking variants of boolean and modifier operations.
@@ -1427,4 +1469,4 @@ function addHoles(f, holes) {
 	return addHolesInFace(f, holes);
 }
 //#endregion
-export { facesOfEdge as $, fixShape as A, offset as B, threePointArc as C, wireLoop as D, wire as E, isValid as F, chamferWithEvolution as G, thicken as H, solidFromShell as I, fuseWithEvolution as J, cutWithEvolution as K, chamfer as L, healFace as M, healSolid as N, autoHeal as O, healWire as P, edgesOfFace as Q, draft as R, tangentArc as S, vertex as T, variableFillet as U, shell as V, positionOnCurve as W, shellWithEvolution as X, intersectWithEvolution as Y, adjacentFaces as Z, polygon as _, circle as a, toGroupedBufferGeometryData as at, sphere as b, cylinder as c, ellipsoid as d, sharedEdges as et, face as f, offsetFace as g, line as h, bsplineApprox as i, toBufferGeometryData as it, heal as j, fixSelfIntersection as k, ellipse as l, helix as m, bezier as n, wiresOfFace as nt, compound as o, toLineGeometryData as ot, filledFace as p, filletWithEvolution as q, box as r, chamferDistAngle as rt, cone as s, addHoles as t, verticesOfEdge as tt, ellipseArc as u, sewShells as v, torus as w, subFace as x, solid as y, fillet as z };
+export { getNurbsSurfaceData as $, fixShape as A, offset as B, threePointArc as C, wireLoop as D, wire as E, isValid as F, chamferWithEvolution as G, thicken as H, solidFromShell as I, fuseWithEvolution as J, cutWithEvolution as K, chamfer as L, healFace as M, healSolid as N, autoHeal as O, healWire as P, getNurbsCurveData as Q, draft as R, tangentArc as S, vertex as T, variableFillet as U, shell as V, positionOnCurve as W, shellWithEvolution as X, intersectWithEvolution as Y, checkBoolean as Z, polygon as _, circle as a, wiresOfFace as at, sphere as b, cylinder as c, toGroupedBufferGeometryData as ct, ellipsoid as d, adjacentFaces as et, face as f, offsetFace as g, line as h, bsplineApprox as i, verticesOfEdge as it, heal as j, fixSelfIntersection as k, ellipse as l, toLineGeometryData as lt, helix as m, bezier as n, facesOfEdge as nt, compound as o, chamferDistAngle as ot, filledFace as p, filletWithEvolution as q, box as r, sharedEdges as rt, cone as s, toBufferGeometryData as st, addHoles as t, edgesOfFace as tt, ellipseArc as u, sewShells as v, torus as w, subFace as x, solid as y, fillet as z };

package/dist/query.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_helpers = require("./helpers-BWZ7h12W.cjs");
-const require_cornerFinder = require("./cornerFinder-E2w1gRI3.cjs");
+const require_helpers = require("./helpers-1iCCEElA.cjs");
+const require_cornerFinder = require("./cornerFinder-BszIcLqj.cjs");
 exports.cornerFinder = require_cornerFinder.cornerFinder;
 exports.edgeFinder = require_helpers.edgeFinder;
 exports.faceFinder = require_helpers.faceFinder;

package/dist/query.js

@@ -1,3 +1,3 @@
-import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-C9PtrI6D.js";
-import { t as cornerFinder } from "./cornerFinder-nn_mma6p.js";
+import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-DgX1UucG.js";
+import { t as cornerFinder } from "./cornerFinder-aBLykolI.js";
 export { cornerFinder, edgeFinder, faceFinder, getSingleFace };

package/dist/result.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors = require("./errors-BDTFTJ22.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
 exports.BrepBugError = require_errors.BrepBugError;
 exports.BrepErrorCode = require_errors.BrepErrorCode;
 exports.OK = require_errors.OK;

package/dist/result.js

@@ -1,2 +1,2 @@
-import { B as unwrapOrElse, C as isErr, D as mapErr, F as tryCatch, I as tryCatchAsync, L as unwrap, M as pipeline, O as match, R as unwrapErr, T as map, _ as andThen, a as moduleInitError, b as flatMap, c as sketcherStateError, d as validationError, h as OK, i as kernelError, k as ok, l as typeCastError, m as bug, n as computationError, o as queryError, p as BrepBugError, r as ioError, t as BrepErrorCode, v as collect, w as isOk, y as err, z as unwrapOr } from "./errors-D7ZQfeqv.js";
+import { B as unwrapOrElse, C as isErr, D as mapErr, F as tryCatch, I as tryCatchAsync, L as unwrap, M as pipeline, O as match, R as unwrapErr, T as map, _ as andThen, a as moduleInitError, b as flatMap, c as sketcherStateError, d as validationError, h as OK, i as kernelError, k as ok, l as typeCastError, m as bug, n as computationError, o as queryError, p as BrepBugError, r as ioError, t as BrepErrorCode, v as collect, w as isOk, y as err, z as unwrapOr } from "./errors-BVOlxlIA.js";
 export { BrepBugError, BrepErrorCode, OK, andThen, bug, collect, computationError, err, flatMap, ioError, isErr, isOk, kernelError, map, mapErr, match, moduleInitError, ok, pipeline, queryError, sketcherStateError, tryCatch, tryCatchAsync, typeCastError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, validationError };

package/dist/{shapeTypes-Du2qyM2n.cjs → shapeTypes-8eK48l-X.cjs}

@@ -1,4 +1,4 @@
-const require_errors = require("./errors-BDTFTJ22.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
 //#region src/kernel/kernel2dTypes.ts
 /** Check if the kernel supports 2D geometry operations. */
 function supportsKernel2D(kernel) {
@@ -709,6 +709,42 @@ function cutAll$1(oc, shape, tools, options = {}) {
 	toolCompound.delete();
 	return result;
 }
+/**
+* Pre-validate operands before a boolean operation.
+*
+* Checks that both shapes are non-null and topologically valid.
+*/
+function checkBoolean$1(_oc, shape, tool, _op, isValid) {
+	const issues = [];
+	if (shape.IsNull()) issues.push({
+		operand: "base",
+		issue: "null-shape",
+		message: "Base shape is null"
+	});
+	if (tool.IsNull()) issues.push({
+		operand: "tool",
+		issue: "null-shape",
+		message: "Tool shape is null"
+	});
+	if (issues.length > 0) return {
+		valid: false,
+		issues
+	};
+	if (!isValid(shape)) issues.push({
+		operand: "base",
+		issue: "not-valid",
+		message: "Base shape fails BRepCheck validation. Try autoHeal() first."
+	});
+	if (!isValid(tool)) issues.push({
+		operand: "tool",
+		issue: "not-valid",
+		message: "Tool shape fails BRepCheck validation. Try autoHeal() first."
+	});
+	return {
+		valid: issues.length === 0,
+		issues
+	};
+}
 //#endregion
 //#region src/kernel/occt/meshOps.ts
 /** Slice a Float32Array from the WASM heap, or return empty if size is 0. */
@@ -2183,6 +2219,138 @@ function reverseSurfaceU(_oc, surface) {
 	return surface.get().UReversed();
 }
 //#endregion
+//#region src/kernel/occt/nurbsQueryOps.ts
+/**
+* Extract NURBS curve data from a BSpline or Bezier edge.
+* Returns null for non-BSpline curve types (line, circle, etc.).
+*/
+function getNurbsCurveData(oc, edge) {
+	const adaptor = new oc.BRepAdaptor_Curve_2(edge);
+	try {
+		const curveTypeVal = adaptor.GetType();
+		const curveIdx = typeof curveTypeVal === "number" ? curveTypeVal : Number(curveTypeVal?.value ?? curveTypeVal);
+		const ct = oc.GeomAbs_CurveType;
+		const bsplineCurveIdx = typeof ct.GeomAbs_BSplineCurve === "number" ? ct.GeomAbs_BSplineCurve : Number(ct.GeomAbs_BSplineCurve?.value ?? ct.GeomAbs_BSplineCurve);
+		const bezierCurveIdx = typeof ct.GeomAbs_BezierCurve === "number" ? ct.GeomAbs_BezierCurve : Number(ct.GeomAbs_BezierCurve?.value ?? ct.GeomAbs_BezierCurve);
+		if (curveIdx !== bsplineCurveIdx && curveIdx !== bezierCurveIdx) return null;
+		const bsplineHandle = adaptor.BSpline();
+		const bspline = bsplineHandle.get();
+		const degree = bspline.Degree();
+		const nbPoles = bspline.NbPoles();
+		const nbKnots = bspline.NbKnots();
+		const isPeriodic = bspline.IsPeriodic();
+		const isRational = bspline.IsRational();
+		const poles = [];
+		for (let i = 1; i <= nbPoles; i++) {
+			const pnt = bspline.Pole(i);
+			poles.push([
+				pnt.X(),
+				pnt.Y(),
+				pnt.Z()
+			]);
+			pnt.delete();
+		}
+		const weights = [];
+		for (let i = 1; i <= nbPoles; i++) weights.push(bspline.Weight(i));
+		const knots = [];
+		const multiplicities = [];
+		for (let i = 1; i <= nbKnots; i++) {
+			knots.push(bspline.Knot(i));
+			multiplicities.push(bspline.Multiplicity(i));
+		}
+		const result = {
+			degree,
+			poles,
+			weights,
+			knots,
+			multiplicities,
+			isPeriodic,
+			isRational
+		};
+		bsplineHandle.delete();
+		return result;
+	} catch {
+		return null;
+	} finally {
+		adaptor.delete();
+	}
+}
+/**
+* Extract NURBS surface data from a BSpline face.
+* Returns null for non-BSpline surface types (plane, cylinder, Bezier, etc.).
+*/
+function getNurbsSurfaceData(oc, face) {
+	const adaptor = new oc.BRepAdaptor_Surface_2(face, false);
+	try {
+		const surfTypeVal = adaptor.GetType();
+		const surfIdx = typeof surfTypeVal === "number" ? surfTypeVal : Number(surfTypeVal?.value ?? surfTypeVal);
+		const st = oc.GeomAbs_SurfaceType;
+		if (surfIdx !== (typeof st.GeomAbs_BSplineSurface === "number" ? st.GeomAbs_BSplineSurface : Number(st.GeomAbs_BSplineSurface?.value ?? st.GeomAbs_BSplineSurface))) return null;
+		const bsplineHandle = adaptor.BSpline();
+		const bspline = bsplineHandle.get();
+		const degreeU = bspline.UDegree();
+		const degreeV = bspline.VDegree();
+		const nbPolesU = bspline.NbUPoles();
+		const nbPolesV = bspline.NbVPoles();
+		const isPeriodicU = bspline.IsUPeriodic();
+		const isPeriodicV = bspline.IsVPeriodic();
+		const isRational = bspline.IsURational() || bspline.IsVRational();
+		const poles = [];
+		const weights = [];
+		for (let u = 1; u <= nbPolesU; u++) {
+			const poleRow = [];
+			const weightRow = [];
+			for (let v = 1; v <= nbPolesV; v++) {
+				const pnt = bspline.Pole(u, v);
+				poleRow.push([
+					pnt.X(),
+					pnt.Y(),
+					pnt.Z()
+				]);
+				pnt.delete();
+				weightRow.push(bspline.Weight(u, v));
+			}
+			poles.push(poleRow);
+			weights.push(weightRow);
+		}
+		const nbUKnots = bspline.NbUKnots();
+		const knotsU = [];
+		const multiplicitiesU = [];
+		for (let i = 1; i <= nbUKnots; i++) {
+			knotsU.push(bspline.UKnot(i));
+			multiplicitiesU.push(bspline.UMultiplicity(i));
+		}
+		const nbVKnots = bspline.NbVKnots();
+		const knotsV = [];
+		const multiplicitiesV = [];
+		for (let i = 1; i <= nbVKnots; i++) {
+			knotsV.push(bspline.VKnot(i));
+			multiplicitiesV.push(bspline.VMultiplicity(i));
+		}
+		const result = {
+			degreeU,
+			degreeV,
+			nbPolesU,
+			nbPolesV,
+			poles,
+			weights,
+			knotsU,
+			knotsV,
+			multiplicitiesU,
+			multiplicitiesV,
+			isPeriodicU,
+			isPeriodicV,
+			isRational
+		};
+		bsplineHandle.delete();
+		return result;
+	} catch {
+		return null;
+	} finally {
+		adaptor.delete();
+	}
+}
+//#endregion
 //#region src/kernel/occt/exportOps.ts
 /** Wrap a JS string as an OCCT TCollection_ExtendedString. */
 function wrapString(oc, str) {
@@ -3436,11 +3604,16 @@ function transformWithEvolution(oc, shape, trsf, inputFaceHashes, hashUpperBound
 /**
 * Wrap a boolean operation with shape evolution tracking.
 */
-function booleanWithEvolution(oc, boolOp, inputShapes, inputFaceHashes, hashUpperBound, simplify) {
+function booleanWithEvolution(oc, boolOp, inputShapes, inputFaceHashes, hashUpperBound, simplify, diagnostics) {
 	if (simplify) boolOp.SimplifyResult(true, true, .001);
 	return {
 		shape: boolOp.Shape(),
-		evolution: buildEvolution(oc, boolOp, inputShapes, inputFaceHashes, hashUpperBound)
+		evolution: buildEvolution(oc, boolOp, inputShapes, inputFaceHashes, hashUpperBound),
+		diagnostics: diagnostics ?? {
+			hasErrors: false,
+			hasWarnings: false,
+			messages: []
+		}
 	};
 }
 /**
@@ -4246,13 +4419,21 @@ function generalTransformWithHistory(oc, shape, linear, translation, _isOrthogon
 	trsf.delete();
 	return result;
 }
+function extractDiagnostics(op) {
+	return {
+		hasErrors: op.HasErrors(),
+		hasWarnings: op.HasWarnings(),
+		messages: []
+	};
+}
 function fuseWithHistory(oc, shape, tool, inputFaceHashes, hashUpperBound, options = {}) {
 	const progress = new oc.Message_ProgressRange_1();
 	const fuseOp = new oc.BRepAlgoAPI_Fuse_3(shape, tool, progress);
 	applyGlue(oc, fuseOp, options.optimisation);
 	applyBooleanDefaults(fuseOp, options.fuzzyValue);
 	fuseOp.Build(progress);
-	const result = booleanWithEvolution(oc, fuseOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false);
+	const diagnostics = extractDiagnostics(fuseOp);
+	const result = booleanWithEvolution(oc, fuseOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false, diagnostics);
 	fuseOp.delete();
 	progress.delete();
 	return result;
@@ -4263,7 +4444,8 @@ function cutWithHistory(oc, shape, tool, inputFaceHashes, hashUpperBound, option
 	applyGlue(oc, cutOp, options.optimisation);
 	applyBooleanDefaults(cutOp, options.fuzzyValue);
 	cutOp.Build(progress);
-	const result = booleanWithEvolution(oc, cutOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false);
+	const diagnostics = extractDiagnostics(cutOp);
+	const result = booleanWithEvolution(oc, cutOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false, diagnostics);
 	cutOp.delete();
 	progress.delete();
 	return result;
@@ -4274,7 +4456,8 @@ function intersectWithHistory(oc, shape, tool, inputFaceHashes, hashUpperBound,
 	applyGlue(oc, intOp, options.optimisation);
 	applyBooleanDefaults(intOp, options.fuzzyValue);
 	intOp.Build(progress);
-	const result = booleanWithEvolution(oc, intOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false);
+	const diagnostics = extractDiagnostics(intOp);
+	const result = booleanWithEvolution(oc, intOp, [shape, tool], inputFaceHashes, hashUpperBound, options.simplify ?? false, diagnostics);
 	intOp.delete();
 	progress.delete();
 	return result;
@@ -4408,6 +4591,9 @@ var DefaultAdapter = class {
 	cutAll(shape, tools, options = {}) {
 		return cutAll$1(this.oc, shape, tools, options);
 	}
+	checkBoolean(shape, tool, op) {
+		return checkBoolean$1(this.oc, shape, tool, op, (s) => this.isValid(s));
+	}
 	hull(shapes, tolerance) {
 		return hull$1(this.oc, shapes, tolerance);
 	}
@@ -4727,6 +4913,12 @@ var DefaultAdapter = class {
 	reverseSurfaceU(surface) {
 		return reverseSurfaceU(this.oc, surface);
 	}
+	getNurbsCurveData(edge) {
+		return getNurbsCurveData(this.oc, edge);
+	}
+	getNurbsSurfaceData(face) {
+		return getNurbsSurfaceData(this.oc, face);
+	}
 	simplify(shape) {
 		return simplify(this.oc, shape);
 	}
@@ -6258,6 +6450,42 @@ function meshBoolean(bk, positionsA, indicesA, positionsB, indicesB, op, toleran
 		}]
 	};
 }
+/**
+* Pre-validate operands before a boolean operation.
+*
+* Checks that both shapes are non-null and topologically valid.
+*/
+function checkBoolean(_bk, shape, tool, _op, isValid) {
+	const issues = [];
+	if (!isBrepkitHandle$1(shape) || shape.IsNull()) issues.push({
+		operand: "base",
+		issue: "null-shape",
+		message: "Base shape is null"
+	});
+	if (!isBrepkitHandle$1(tool) || tool.IsNull()) issues.push({
+		operand: "tool",
+		issue: "null-shape",
+		message: "Tool shape is null"
+	});
+	if (issues.length > 0) return {
+		valid: false,
+		issues
+	};
+	if (!isValid(shape)) issues.push({
+		operand: "base",
+		issue: "not-valid",
+		message: "Base shape fails BRepCheck validation. Try autoHeal() first."
+	});
+	if (!isValid(tool)) issues.push({
+		operand: "tool",
+		issue: "not-valid",
+		message: "Tool shape fails BRepCheck validation. Try autoHeal() first."
+	});
+	return {
+		valid: issues.length === 0,
+		issues
+	};
+}
 function hull(bk, shapes, _tolerance) {
 	const coords = [];
 	for (const shape of shapes) {
@@ -8237,6 +8465,9 @@ var BrepkitAdapter = class BrepkitAdapter {
 	split(shape, tools) {
 		return split(this.bk, shape, tools);
 	}
+	checkBoolean(shape, tool, op) {
+		return checkBoolean(this.bk, shape, tool, op, (s) => this.isValid(s));
+	}
 	hull(shapes, _tolerance) {
 		return hull(this.bk, shapes, _tolerance);
 	}
@@ -8649,12 +8880,20 @@ var BrepkitAdapter = class BrepkitAdapter {
 		return this.buildEvolution(this.generalTransform(shape, linear, translation, isOrthogonal), inputFaceHashes, hashUpperBound, true);
 	}
 	booleanWithHistoryImpl(shape, tool, inputFaceHashes, hashUpperBound, options, nativeFn, fallbackFn, _label) {
+		const noDiagnostics = {
+			hasErrors: false,
+			hasWarnings: false,
+			messages: []
+		};
 		const sh = shape;
 		const th = tool;
 		if (inputFaceHashes.length > 0 && sh.type === "solid") {
 			if (th.type === "solid") {
 				const json = nativeFn(sh.id, th.id);
-				return this.parseNativeEvolution(json, hashUpperBound);
+				return {
+					...this.parseNativeEvolution(json, hashUpperBound),
+					diagnostics: noDiagnostics
+				};
 			}
 			if (th.type === "compound") {
 				const childSolidIds = toArray(this.bk.getCompoundSolids(th.id));
@@ -8685,12 +8924,16 @@ var BrepkitAdapter = class BrepkitAdapter {
 						modified: combinedModified,
 						generated: combinedGenerated,
 						deleted: combinedDeleted
-					}
+					},
+					diagnostics: noDiagnostics
 				};
 			}
 		}
 		const fallbackResult = fallbackFn(shape, tool, options);
-		return this.buildEvolution(fallbackResult, inputFaceHashes, hashUpperBound, false, shape);
+		return {
+			...this.buildEvolution(fallbackResult, inputFaceHashes, hashUpperBound, false, shape),
+			diagnostics: noDiagnostics
+		};
 	}
 	fuseWithHistory(shape, tool, inputFaceHashes, hashUpperBound, options) {
 		return this.booleanWithHistoryImpl(shape, tool, inputFaceHashes, hashUpperBound, options, (a, b) => this.bk.fuseWithEvolution(a, b), (s, t, o) => this.fuse(s, t, o), "fuseWithHistory");
@@ -9840,6 +10083,12 @@ var BrepkitAdapter = class BrepkitAdapter {
 	reverseSurfaceU(surface) {
 		return surface;
 	}
+	getNurbsCurveData(_edge) {
+		return null;
+	}
+	getNurbsSurfaceData(_face) {
+		return null;
+	}
 	createPoint3d(x, y, z) {
 		return {
 			x,