brepjs 18.36.0 → 18.38.0

package/dist/brepjs.cjs

@@ -159,7 +159,13 @@ function initVoxel(engine, id = "voxel") {
 }
 //#endregion
 //#region src/voxel/signFns.ts
-function validateInputs(mesh, queries) {
+/**
+* Validate a triangle-soup mesh before it crosses into wasm: flat-xyz vertices,
+* triangle-multiple indices, and every index in range. An out-of-range index
+* would otherwise panic in Rust and surface as a wasm trap, escaping the Result
+* contract — so it must be rejected here.
+*/
+function validateMesh(mesh) {
 	if (mesh.vertices.length % 3 !== 0) return require_errors.validationError("VOXEL_INVALID_MESH", "mesh.vertices length must be a multiple of 3 (flat xyz).");
 	if (mesh.triangles.length % 3 !== 0) return require_errors.validationError("VOXEL_INVALID_MESH", "mesh.triangles length must be a multiple of 3.");
 	const vertexCount = mesh.vertices.length / 3;
@@ -167,9 +173,15 @@ function validateInputs(mesh, queries) {
 		const idx = mesh.triangles[i];
 		if (idx === void 0 || idx >= vertexCount) return require_errors.validationError("VOXEL_INVALID_TRIANGLE_INDEX", `triangle index ${idx} at position ${i} is out of range for ${vertexCount} vertices.`);
 	}
+	return null;
+}
+function validateInputs(mesh, queries) {
+	const meshInvalid = validateMesh(mesh);
+	if (meshInvalid) return meshInvalid;
 	if (queries.length % 3 !== 0) return require_errors.validationError("VOXEL_INVALID_QUERIES", "queries length must be a multiple of 3 (flat xyz).");
 	return null;
 }
+/** Resolve a registered voxel engine, mapping an unregistered id to an error. */
 function resolveEngine(id) {
 	try {
 		return require_errors.ok(getVoxel(id));
@@ -205,6 +217,53 @@ function pointsInside(mesh, queries, id) {
 	return require_errors.ok(Array.from(flags, (flag) => flag === 1));
 }
 //#endregion
+//#region src/voxel/repairFns.ts
+var DEFAULT_RESOLUTION = 48;
+var DEFAULT_PADDING = 2;
+/**
+* Repair a (possibly non-watertight) triangle-soup mesh into a closed surface:
+* voxelize an FWN-signed SDF, then Surface-Nets contour it back to triangles.
+*
+* The FWN sign classifies inside/outside even on holey input, so a mesh with
+* missing faces still yields a watertight result (ADR-0013 §11). Returns a
+* {@link KernelMeshResult} in world coordinates (a single face group, no UVs).
+*/
+function repairMesh(mesh, opts, id) {
+	const invalid = validateMesh(mesh);
+	if (invalid) return require_errors.err(invalid);
+	if (mesh.vertices.length === 0 || mesh.triangles.length === 0) return require_errors.err(require_errors.validationError("VOXEL_EMPTY_MESH", "repairMesh requires a non-empty triangle mesh."));
+	const resolution = opts?.resolution ?? DEFAULT_RESOLUTION;
+	const padding = opts?.padding ?? DEFAULT_PADDING;
+	if (!Number.isInteger(resolution) || resolution < 1) return require_errors.err(require_errors.validationError("VOXEL_INVALID_RESOLUTION", "resolution must be an integer >= 1."));
+	if (!Number.isInteger(padding) || padding < 1) return require_errors.err(require_errors.validationError("VOXEL_INVALID_PADDING", "padding must be an integer >= 1."));
+	const engine = resolveEngine(id);
+	if (require_errors.isErr(engine)) return engine;
+	try {
+		try {
+			var _usingCtx$4 = require_shapeTypes._usingCtx();
+			const repaired = _usingCtx$4.u(engine.value.repair_mesh(mesh.vertices, mesh.triangles, resolution, padding));
+			const vertexCount = repaired.positions.length / 3;
+			return require_errors.ok({
+				vertices: repaired.positions,
+				normals: repaired.normals,
+				triangles: repaired.indices,
+				uvs: new Float32Array(vertexCount * 2),
+				faceGroups: [{
+					start: 0,
+					count: repaired.indices.length / 3,
+					faceHash: 0
+				}]
+			});
+		} catch (_) {
+			_usingCtx$4.e = _;
+		} finally {
+			_usingCtx$4.d();
+		}
+	} catch (cause) {
+		return require_errors.err(require_errors.computationError("VOXEL_REPAIR_FAILED", cause instanceof Error ? cause.message : "voxel repair failed (grid too large?).", cause));
+	}
+}
+//#endregion
 //#region src/core/kernelBoundary.ts
 /** Convert Vec3 to a kernel 3D vector. Caller must call .delete() when done. */
 function toKernelVec(v) {
@@ -5666,6 +5725,7 @@ exports.registerVoxel = registerVoxel;
 exports.rejectAll = require_workerHandler.rejectAll;
 exports.removeChild = require_historyFns.removeChild;
 exports.removeHolesFromFace = require_faceFns.removeHolesFromFace;
+exports.repairMesh = repairMesh;
 exports.replayFrom = require_historyFns.replayFrom;
 exports.replayHistory = require_historyFns.replayHistory;
 exports.resetDisposalStats = require_shapeTypes.resetDisposalStats;

package/dist/brepjs.js

@@ -170,7 +170,13 @@ function initVoxel(engine, id = "voxel") {
 }
 //#endregion
 //#region src/voxel/signFns.ts
-function validateInputs(mesh, queries) {
+/**
+* Validate a triangle-soup mesh before it crosses into wasm: flat-xyz vertices,
+* triangle-multiple indices, and every index in range. An out-of-range index
+* would otherwise panic in Rust and surface as a wasm trap, escaping the Result
+* contract — so it must be rejected here.
+*/
+function validateMesh(mesh) {
 	if (mesh.vertices.length % 3 !== 0) return validationError("VOXEL_INVALID_MESH", "mesh.vertices length must be a multiple of 3 (flat xyz).");
 	if (mesh.triangles.length % 3 !== 0) return validationError("VOXEL_INVALID_MESH", "mesh.triangles length must be a multiple of 3.");
 	const vertexCount = mesh.vertices.length / 3;
@@ -178,9 +184,15 @@ function validateInputs(mesh, queries) {
 		const idx = mesh.triangles[i];
 		if (idx === void 0 || idx >= vertexCount) return validationError("VOXEL_INVALID_TRIANGLE_INDEX", `triangle index ${idx} at position ${i} is out of range for ${vertexCount} vertices.`);
 	}
+	return null;
+}
+function validateInputs(mesh, queries) {
+	const meshInvalid = validateMesh(mesh);
+	if (meshInvalid) return meshInvalid;
 	if (queries.length % 3 !== 0) return validationError("VOXEL_INVALID_QUERIES", "queries length must be a multiple of 3 (flat xyz).");
 	return null;
 }
+/** Resolve a registered voxel engine, mapping an unregistered id to an error. */
 function resolveEngine(id) {
 	try {
 		return ok(getVoxel(id));
@@ -216,6 +228,53 @@ function pointsInside(mesh, queries, id) {
 	return ok(Array.from(flags, (flag) => flag === 1));
 }
 //#endregion
+//#region src/voxel/repairFns.ts
+var DEFAULT_RESOLUTION = 48;
+var DEFAULT_PADDING = 2;
+/**
+* Repair a (possibly non-watertight) triangle-soup mesh into a closed surface:
+* voxelize an FWN-signed SDF, then Surface-Nets contour it back to triangles.
+*
+* The FWN sign classifies inside/outside even on holey input, so a mesh with
+* missing faces still yields a watertight result (ADR-0013 §11). Returns a
+* {@link KernelMeshResult} in world coordinates (a single face group, no UVs).
+*/
+function repairMesh(mesh, opts, id) {
+	const invalid = validateMesh(mesh);
+	if (invalid) return err(invalid);
+	if (mesh.vertices.length === 0 || mesh.triangles.length === 0) return err(validationError("VOXEL_EMPTY_MESH", "repairMesh requires a non-empty triangle mesh."));
+	const resolution = opts?.resolution ?? DEFAULT_RESOLUTION;
+	const padding = opts?.padding ?? DEFAULT_PADDING;
+	if (!Number.isInteger(resolution) || resolution < 1) return err(validationError("VOXEL_INVALID_RESOLUTION", "resolution must be an integer >= 1."));
+	if (!Number.isInteger(padding) || padding < 1) return err(validationError("VOXEL_INVALID_PADDING", "padding must be an integer >= 1."));
+	const engine = resolveEngine(id);
+	if (isErr(engine)) return engine;
+	try {
+		try {
+			var _usingCtx$4 = _usingCtx();
+			const repaired = _usingCtx$4.u(engine.value.repair_mesh(mesh.vertices, mesh.triangles, resolution, padding));
+			const vertexCount = repaired.positions.length / 3;
+			return ok({
+				vertices: repaired.positions,
+				normals: repaired.normals,
+				triangles: repaired.indices,
+				uvs: new Float32Array(vertexCount * 2),
+				faceGroups: [{
+					start: 0,
+					count: repaired.indices.length / 3,
+					faceHash: 0
+				}]
+			});
+		} catch (_) {
+			_usingCtx$4.e = _;
+		} finally {
+			_usingCtx$4.d();
+		}
+	} catch (cause) {
+		return err(computationError("VOXEL_REPAIR_FAILED", cause instanceof Error ? cause.message : "voxel repair failed (grid too large?).", cause));
+	}
+}
+//#endregion
 //#region src/core/kernelBoundary.ts
 /** Convert Vec3 to a kernel 3D vector. Caller must call .delete() when done. */
 function toKernelVec(v) {
@@ -5234,4 +5293,4 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	withEvaluator: () => withEvaluator
 });
 //#endregion
-export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEG2RAD, DisposalScope, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, csg_exports as csg, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, extrude, extrudeAll, face, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, init, initFromManifold, initFromOC, initVoxel, innerWires, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, ioNs_exports as io, ioError, is2D, is3D, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mesh, meshEdges, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, section, sectionToFace, serializeHistory, setShapeOrigin, setTagMetadata, sewShells, shape, shapeType, sharedEdges, shell, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withScope, withScopeResult, withScopeResultAsync, zip as zipResults };
+export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEG2RAD, DisposalScope, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, csg_exports as csg, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, extrude, extrudeAll, face, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, init, initFromManifold, initFromOC, initVoxel, innerWires, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, ioNs_exports as io, ioError, is2D, is3D, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mesh, meshEdges, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, section, sectionToFace, serializeHistory, setShapeOrigin, setTagMetadata, sewShells, shape, shapeType, sharedEdges, shell, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withScope, withScopeResult, withScopeResultAsync, zip as zipResults };

package/dist/index.d.ts

@@ -34,8 +34,8 @@ export { exportDXF, blueprintToDXF, type DXFEntity, type DXFExportOptions, } fro
 export { exportThreeMF, type ThreeMFExportOptions, type ThreeMFMaterial, } from './io/threemfExportFns.js';
 export { importSVGPathD, importSVG, type SVGImportOptions } from './io/svgImportFns.js';
 export { exportSTEPConfigured, type StepExportOptions, type StepExportPart, } from './io/stepConfigFns.js';
-export { initVoxel, registerVoxel, getVoxel, getActiveVoxelId, windingNumbers, pointsInside, } from './voxel/index.js';
-export type { VoxelEngine, VoxelMeshInput } from './voxel/index.js';
+export { initVoxel, registerVoxel, getVoxel, getActiveVoxelId, windingNumbers, pointsInside, repairMesh, } from './voxel/index.js';
+export type { VoxelEngine, VoxelMeshInput, VoxelRepairResult, RepairOptions, } from './voxel/index.js';
 export { default as Sketcher } from './sketching/sketcher.js';
 export { default as FaceSketcher } from './sketching/faceSketcher.js';
 export { BaseSketcher2d } from './2d/blueprints/baseSketcher2d.js';

package/dist/voxel/engine.d.ts

@@ -11,6 +11,21 @@ export interface VoxelEngine {
     winding_numbers(verts: Float32Array, tris: Uint32Array, queries: Float32Array): Float32Array;
     /** Inside/outside classification per query point (1 = inside, 0 = outside). */
     points_inside(verts: Float32Array, tris: Uint32Array, queries: Float32Array): Uint8Array;
+    /** Voxelize-and-contour a mesh into a closed surface (FWN sign keystone). */
+    repair_mesh(verts: Float32Array, tris: Uint32Array, resolution: number, padding: number): VoxelRepairResult;
     /** Engine artifact version, for loader/artifact compatibility checks. */
     version(): string;
 }
+/**
+ * The repaired-mesh handle the wasm `repair_mesh` returns. Flat xyz
+ * `positions`/`normals` (length 3·V) and a triangle-list `indices` (3 per tri),
+ * in world space. Structurally satisfied by the generated `RepairResult` class.
+ */
+export interface VoxelRepairResult {
+    readonly positions: Float32Array;
+    readonly normals: Float32Array;
+    readonly indices: Uint32Array;
+    /** Release the backing WASM allocation (wasm-bindgen lifecycle). */
+    free(): void;
+    [Symbol.dispose](): void;
+}

package/dist/voxel/index.d.ts

@@ -5,7 +5,9 @@
  * API. v1 surfaces the repair-slice keystone (Generalized Winding Number sign);
  * grid / contour / bridge seams land behind the same registry.
  */
-export type { VoxelEngine } from './engine.js';
+export type { VoxelEngine, VoxelRepairResult } from './engine.js';
 export type { VoxelMeshInput } from './signFns.js';
+export type { RepairOptions } from './repairFns.js';
 export { registerVoxel, getVoxel, getActiveVoxelId, initVoxel } from './registry.js';
 export { windingNumbers, pointsInside } from './signFns.js';
+export { repairMesh } from './repairFns.js';

package/dist/voxel/repairFns.d.ts

@@ -0,0 +1,18 @@
+import { Result } from '../core/result.js';
+import { KernelMeshResult } from '../kernel/types.js';
+import { VoxelMeshInput } from './signFns.js';
+/** Voxel-repair tuning. `resolution` sizes the longest bbox axis in voxels;
+ *  `padding` is the positive air-margin ring (>= 1) Surface Nets needs. */
+export interface RepairOptions {
+    resolution?: number;
+    padding?: number;
+}
+/**
+ * Repair a (possibly non-watertight) triangle-soup mesh into a closed surface:
+ * voxelize an FWN-signed SDF, then Surface-Nets contour it back to triangles.
+ *
+ * The FWN sign classifies inside/outside even on holey input, so a mesh with
+ * missing faces still yields a watertight result (ADR-0013 §11). Returns a
+ * {@link KernelMeshResult} in world coordinates (a single face group, no UVs).
+ */
+export declare function repairMesh(mesh: VoxelMeshInput, opts?: RepairOptions, id?: string): Result<KernelMeshResult>;

package/dist/voxel/signFns.d.ts

@@ -1,4 +1,6 @@
 import { Result } from '../core/result.js';
+import { BrepError } from '../core/errors.js';
+import { VoxelEngine } from './engine.js';
 /**
  * Minimal triangle-soup input for sign queries. Structurally satisfied by a
  * {@link KernelMeshResult} (which also carries normals/uvs/faceGroups).
@@ -7,6 +9,15 @@ export interface VoxelMeshInput {
     vertices: Float32Array;
     triangles: Uint32Array;
 }
+/**
+ * Validate a triangle-soup mesh before it crosses into wasm: flat-xyz vertices,
+ * triangle-multiple indices, and every index in range. An out-of-range index
+ * would otherwise panic in Rust and surface as a wasm trap, escaping the Result
+ * contract — so it must be rejected here.
+ */
+export declare function validateMesh(mesh: VoxelMeshInput): BrepError | null;
+/** Resolve a registered voxel engine, mapping an unregistered id to an error. */
+export declare function resolveEngine(id: string | undefined): Result<VoxelEngine>;
 /**
  * Generalized winding number at each query point against a triangle-soup mesh.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.36.0",
+  "version": "18.38.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",
@@ -29,6 +29,7 @@
     "packages/brepjs-voxel",
     "packages/brepjs-agent",
     "packages/brepjs-viewer",
+    "packages/brepjs-vscode",
     "apps/playground",
     "apps/docs"
   ],