brepjs 18.35.6 → 18.37.0

package/dist/brepjs.cjs

@@ -119,6 +119,151 @@ function vertexFinder() {
 	return buildVertexFinder([]);
 }
 //#endregion
+//#region src/voxel/registry.ts
+var _engines = /* @__PURE__ */ new Map();
+var _defaultId = null;
+var _cached = null;
+function registerVoxel(id, engine) {
+	_engines.set(id, engine);
+	if (!_defaultId) _defaultId = id;
+	if (id === _defaultId) _cached = engine;
+}
+/**
+* Return a voxel engine by id, or the default engine if no id is given.
+*
+* @throws If no engine has been registered via {@link initVoxel} or
+* {@link registerVoxel}.
+*/
+function getVoxel(id) {
+	if (!id && _cached) return _cached;
+	const targetId = id ?? _defaultId;
+	if (!targetId) throw new Error("brepjs voxel engine not initialized. Call initVoxel() (or registerVoxel()) before using voxel operations.");
+	const engine = _engines.get(targetId);
+	if (!engine) throw new Error(`brepjs: voxel engine '${targetId}' is not registered.`);
+	return engine;
+}
+/** Return the id of the active default engine, or `null` if none is registered. */
+function getActiveVoxelId() {
+	return _defaultId;
+}
+/**
+* Register a loaded voxel engine and make it the default.
+*
+* Mirrors {@link initFromOC} for the kernel: the loader package
+* (`brepjs-voxel`) instantiates the wasm, then hands the engine here.
+*/
+function initVoxel(engine, id = "voxel") {
+	registerVoxel(id, engine);
+	_defaultId = id;
+	_cached = engine;
+}
+//#endregion
+//#region src/voxel/signFns.ts
+/**
+* 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;
+	for (let i = 0; i < mesh.triangles.length; i++) {
+		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));
+	} catch (cause) {
+		return require_errors.err(require_errors.moduleInitError("VOXEL_NOT_INITIALIZED", cause instanceof Error ? cause.message : "voxel engine not initialized", cause));
+	}
+}
+/**
+* Generalized winding number at each query point against a triangle-soup mesh.
+*
+* `queries` is flat xyz (length 3·Q); the result has length Q. ~1 inside, ~0
+* outside for a closed mesh; degrades gracefully on holes (the keystone that
+* makes non-watertight repair possible — ADR-0013 §11).
+*/
+function windingNumbers(mesh, queries, id) {
+	const invalid = validateInputs(mesh, queries);
+	if (invalid) return require_errors.err(invalid);
+	const engine = resolveEngine(id);
+	if (require_errors.isErr(engine)) return engine;
+	return require_errors.ok(engine.value.winding_numbers(mesh.vertices, mesh.triangles, queries));
+}
+/**
+* Inside/outside classification (winding number > 0.5) at each query point.
+*
+* `queries` is flat xyz (length 3·Q); the result has length Q.
+*/
+function pointsInside(mesh, queries, id) {
+	const invalid = validateInputs(mesh, queries);
+	if (invalid) return require_errors.err(invalid);
+	const engine = resolveEngine(id);
+	if (require_errors.isErr(engine)) return engine;
+	const flags = engine.value.points_inside(mesh.vertices, mesh.triangles, queries);
+	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) {
@@ -5364,6 +5509,7 @@ exports.fuseAllBisect = require_primitiveFns.fuseAllBisect;
 exports.fuseBlueprints = require_boolean2D.fuseBlueprints;
 exports.fuseWithEvolution = require_primitiveFns.fuseWithEvolution;
 exports.gearGeometry = gearGeometry;
+exports.getActiveVoxelId = getActiveVoxelId;
 exports.getBounds = require_topologyQueryFns.getBounds;
 exports.getBounds2D = require_blueprintFns.getBounds2D;
 exports.getCompSolids = require_topologyQueryFns.getCompSolids;
@@ -5391,6 +5537,7 @@ exports.getSolids = require_topologyQueryFns.getSolids;
 exports.getSurfaceType = require_faceFns.getSurfaceType;
 exports.getTagMetadata = require_shapeFns.getTagMetadata;
 exports.getVertices = require_topologyQueryFns.getVertices;
+exports.getVoxel = getVoxel;
 exports.getWires = require_topologyQueryFns.getWires;
 exports.guidedSweep = require_extrudeFns.guidedSweep;
 exports.heal = heal;
@@ -5411,6 +5558,7 @@ exports.importThreeMF = importThreeMF;
 exports.init = require_shapeTypes.init;
 exports.initFromManifold = require_shapeTypes.initFromManifold;
 exports.initFromOC = require_shapeTypes.initFromOC;
+exports.initVoxel = initVoxel;
 exports.innerWires = require_faceFns.innerWires;
 exports.interpolateCurve = require_curveFns.interpolateCurve;
 exports.intersect = intersect;
@@ -5546,6 +5694,7 @@ exports.planarWire = require_shapeTypes.planarWire;
 exports.planetPlacements = planetPlacements;
 exports.pocket = pocket;
 exports.pointOnSurface = require_faceFns.pointOnSurface;
+exports.pointsInside = pointsInside;
 exports.polygon = require_primitiveFns.polygon;
 exports.polyhedron = polyhedron;
 exports.polysideInnerRadius = require_drawFns.polysideInnerRadius;
@@ -5572,9 +5721,11 @@ exports.registerHandler = require_workerHandler.registerHandler;
 exports.registerKernel = require_shapeTypes.registerKernel;
 exports.registerOperation = require_historyFns.registerOperation;
 exports.registerShape = require_historyFns.registerShape;
+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;
@@ -5709,6 +5860,7 @@ exports.vertexFinder = vertexFinder;
 exports.vertexPosition = require_topologyQueryFns.vertexPosition;
 exports.verticesOfEdge = require_primitiveFns.verticesOfEdge;
 exports.walkAssembly = require_historyFns.walkAssembly;
+exports.windingNumbers = windingNumbers;
 exports.wire = require_primitiveFns.wire;
 exports.wireFinder = require_helpers.wireFinder;
 exports.wireLoop = require_primitiveFns.wireLoop;

package/dist/brepjs.js

@@ -130,6 +130,151 @@ function vertexFinder() {
 	return buildVertexFinder([]);
 }
 //#endregion
+//#region src/voxel/registry.ts
+var _engines = /* @__PURE__ */ new Map();
+var _defaultId = null;
+var _cached = null;
+function registerVoxel(id, engine) {
+	_engines.set(id, engine);
+	if (!_defaultId) _defaultId = id;
+	if (id === _defaultId) _cached = engine;
+}
+/**
+* Return a voxel engine by id, or the default engine if no id is given.
+*
+* @throws If no engine has been registered via {@link initVoxel} or
+* {@link registerVoxel}.
+*/
+function getVoxel(id) {
+	if (!id && _cached) return _cached;
+	const targetId = id ?? _defaultId;
+	if (!targetId) throw new Error("brepjs voxel engine not initialized. Call initVoxel() (or registerVoxel()) before using voxel operations.");
+	const engine = _engines.get(targetId);
+	if (!engine) throw new Error(`brepjs: voxel engine '${targetId}' is not registered.`);
+	return engine;
+}
+/** Return the id of the active default engine, or `null` if none is registered. */
+function getActiveVoxelId() {
+	return _defaultId;
+}
+/**
+* Register a loaded voxel engine and make it the default.
+*
+* Mirrors {@link initFromOC} for the kernel: the loader package
+* (`brepjs-voxel`) instantiates the wasm, then hands the engine here.
+*/
+function initVoxel(engine, id = "voxel") {
+	registerVoxel(id, engine);
+	_defaultId = id;
+	_cached = engine;
+}
+//#endregion
+//#region src/voxel/signFns.ts
+/**
+* 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;
+	for (let i = 0; i < mesh.triangles.length; i++) {
+		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));
+	} catch (cause) {
+		return err(moduleInitError("VOXEL_NOT_INITIALIZED", cause instanceof Error ? cause.message : "voxel engine not initialized", cause));
+	}
+}
+/**
+* Generalized winding number at each query point against a triangle-soup mesh.
+*
+* `queries` is flat xyz (length 3·Q); the result has length Q. ~1 inside, ~0
+* outside for a closed mesh; degrades gracefully on holes (the keystone that
+* makes non-watertight repair possible — ADR-0013 §11).
+*/
+function windingNumbers(mesh, queries, id) {
+	const invalid = validateInputs(mesh, queries);
+	if (invalid) return err(invalid);
+	const engine = resolveEngine(id);
+	if (isErr(engine)) return engine;
+	return ok(engine.value.winding_numbers(mesh.vertices, mesh.triangles, queries));
+}
+/**
+* Inside/outside classification (winding number > 0.5) at each query point.
+*
+* `queries` is flat xyz (length 3·Q); the result has length Q.
+*/
+function pointsInside(mesh, queries, id) {
+	const invalid = validateInputs(mesh, queries);
+	if (invalid) return err(invalid);
+	const engine = resolveEngine(id);
+	if (isErr(engine)) return engine;
+	const flags = engine.value.points_inside(mesh.vertices, mesh.triangles, queries);
+	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) {
@@ -5148,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, 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, getWires, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, init, initFromManifold, initFromOC, 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, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerOperation, registerShape, 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, 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,6 +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, 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

@@ -0,0 +1,31 @@
+/**
+ * The wasm surface the voxel domain depends on — structurally satisfied by the
+ * loaded `brepjs-voxel-wasm` module. Kept snake_case to match the wasm-bindgen
+ * exports exactly, so the raw module is a zero-adapter `VoxelEngine`.
+ *
+ * All buffers are flat (no zero-copy across the wasm boundary, per ADR-0013):
+ * `verts` is xyz·V, `tris` is index·T, `queries` is xyz·Q.
+ */
+export interface VoxelEngine {
+    /** Generalized winding number per query point (~1 inside, ~0 outside). */
+    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

@@ -0,0 +1,13 @@
+/**
+ * Voxel / SDF geometry domain (ADR-0013).
+ *
+ * A parallel domain to the B-rep kernel: its own engine registry and functional
+ * API. v1 surfaces the repair-slice keystone (Generalized Winding Number sign);
+ * grid / contour / bridge seams land behind the same registry.
+ */
+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/registry.d.ts

@@ -0,0 +1,18 @@
+import { VoxelEngine } from './engine.js';
+export declare function registerVoxel(id: string, engine: VoxelEngine): void;
+/**
+ * Return a voxel engine by id, or the default engine if no id is given.
+ *
+ * @throws If no engine has been registered via {@link initVoxel} or
+ * {@link registerVoxel}.
+ */
+export declare function getVoxel(id?: string): VoxelEngine;
+/** Return the id of the active default engine, or `null` if none is registered. */
+export declare function getActiveVoxelId(): string | null;
+/**
+ * Register a loaded voxel engine and make it the default.
+ *
+ * Mirrors {@link initFromOC} for the kernel: the loader package
+ * (`brepjs-voxel`) instantiates the wasm, then hands the engine here.
+ */
+export declare function initVoxel(engine: VoxelEngine, id?: string): void;

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

@@ -0,0 +1,34 @@
+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).
+ */
+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.
+ *
+ * `queries` is flat xyz (length 3·Q); the result has length Q. ~1 inside, ~0
+ * outside for a closed mesh; degrades gracefully on holes (the keystone that
+ * makes non-watertight repair possible — ADR-0013 §11).
+ */
+export declare function windingNumbers(mesh: VoxelMeshInput, queries: Float32Array, id?: string): Result<Float32Array>;
+/**
+ * Inside/outside classification (winding number > 0.5) at each query point.
+ *
+ * `queries` is flat xyz (length 3·Q); the result has length Q.
+ */
+export declare function pointsInside(mesh: VoxelMeshInput, queries: Float32Array, id?: string): Result<boolean[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.35.6",
+  "version": "18.37.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",
@@ -25,6 +25,8 @@
     "packages/brepjs-opencascade",
     "packages/brepjs-bim",
     "packages/brepjs-manifold",
+    "packages/brepjs-voxel-wasm",
+    "packages/brepjs-voxel",
     "packages/brepjs-agent",
     "packages/brepjs-viewer",
     "apps/playground",