brepjs 18.77.0 → 18.78.0

package/dist/{primitiveFns-DWIzRvTY.js → healingFns-DS_nK9KF.js}

@@ -1,13 +1,11 @@
-import { Z 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-CyTY0prh.js";
-import { A as ok, T as isOk, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, v as andThen, w as isErr } from "./errors-DNWJsfVU.js";
+import { Z as getKernel, _ as isSolid, h as isShape3D, p as isFace, r as castShapeWithKnownType, t as castShape, y as isWire } from "./shapeTypes-CyTY0prh.js";
+import { A as ok, T as isOk, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, w as isErr } from "./errors-DNWJsfVU.js";
 import { c as getFaces, i as getCachedIsValid, l as getOrCreateCache, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-BomrmBie.js";
-import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-ITRzCnCp.js";
+import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { v as downcast } from "./faceFns-BJ2hzXJp.js";
-import { _ as propagateAllMetadata, g as collectInputFaceHashes, h as translate } from "./shapeFns-DZ6poxP7.js";
+import { _ as propagateAllMetadata, g as collectInputFaceHashes } from "./shapeFns-DZ6poxP7.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { _ as makeThreePointArc, a as makeNonPlanarFace, c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, g as makeTangentArc, h as makeLine, i as makeNewFaceWithinFace, m as makeHelix, o as makePolygon, p as makeEllipseArc, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeBezierCurve } from "./surfaceBuilders-Do0rypyD.js";
-import { a as fuseAll, i as fuse, n as cut, r as cutAll } from "./booleanFns-D7Xgt-Og.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-BtEFUFQ9.js";
+import { A as cutAll, M as fuseAll, j as fuse, k as cut } from "./primitiveFns-BxH5omw3.js";
 //#region src/topology/threeHelpers.ts
 /**
 * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.
@@ -1355,297 +1353,4 @@ function fixSelfIntersection(wire) {
 	}
 }
 //#endregion
-//#region src/topology/primitiveFns.ts
-/**
-* Create a box with the given dimensions.
-*
-* @param width  - Size along X.
-* @param depth  - Size along Y.
-* @param height - Size along Z.
-*/
-function box(width, depth, height, options) {
-	const solid = createSolid(getKernel().makeBox(width, depth, height));
-	const center = options?.at ?? (options?.centered ? [
-		0,
-		0,
-		0
-	] : void 0);
-	if (center) return translate(solid, [
-		center[0] - width / 2,
-		center[1] - depth / 2,
-		center[2] - height / 2
-	]);
-	return solid;
-}
-/**
-* Create a cylinder with the given radius and height.
-*/
-function cylinder(radius, height, options) {
-	const at = options?.at ?? [
-		0,
-		0,
-		0
-	];
-	const axis = options?.axis ?? [
-		0,
-		0,
-		1
-	];
-	let solid = makeCylinder(radius, height, at, axis);
-	if (options?.centered) {
-		const halfShift = [
-			-axis[0] * height * .5,
-			-axis[1] * height * .5,
-			-axis[2] * height * .5
-		];
-		solid = translate(solid, halfShift);
-	}
-	return solid;
-}
-/**
-* Create a sphere with the given radius.
-*/
-function sphere(radius, options) {
-	let solid = makeSphere(radius);
-	if (options?.at) solid = translate(solid, options.at);
-	return solid;
-}
-/**
-* Create a cone (or frustum) with the given radii and height.
-*
-* @param bottomRadius - Radius at the base.
-* @param topRadius    - Radius at the top (0 for a full cone).
-* @param height       - Height of the cone.
-*/
-function cone(bottomRadius, topRadius, height, options) {
-	const at = options?.at ?? [
-		0,
-		0,
-		0
-	];
-	const axis = options?.axis ?? [
-		0,
-		0,
-		1
-	];
-	let solid = makeCone(bottomRadius, topRadius, height, at, axis);
-	if (options?.centered) {
-		const halfShift = [
-			-axis[0] * height * .5,
-			-axis[1] * height * .5,
-			-axis[2] * height * .5
-		];
-		solid = translate(solid, halfShift);
-	}
-	return solid;
-}
-/**
-* Create a torus with the given major and minor radii.
-*/
-function torus(majorRadius, minorRadius, options) {
-	return makeTorus(majorRadius, minorRadius, options?.at ?? [
-		0,
-		0,
-		0
-	], options?.axis ?? [
-		0,
-		0,
-		1
-	]);
-}
-/**
-* Create an ellipsoid with the given axis half-lengths.
-*
-* @param rx - Half-length along X.
-* @param ry - Half-length along Y.
-* @param rz - Half-length along Z.
-*/
-function ellipsoid(rx, ry, rz, options) {
-	let solid = makeEllipsoid(rx, ry, rz);
-	if (options?.at) solid = translate(solid, options.at);
-	return solid;
-}
-/** Create a straight edge between two 3D points. */
-function line(from, to) {
-	return makeLine(from, to);
-}
-/** Create a circular edge with the given radius. */
-function circle(radius, options) {
-	const axisDir = options?.axis ?? [
-		0,
-		0,
-		1
-	];
-	return makeCircle(radius, options?.at ?? [
-		0,
-		0,
-		0
-	], axisDir);
-}
-/**
-* Create an elliptical edge.
-*
-* @returns An error if `minorRadius` exceeds `majorRadius`.
-*/
-function ellipse(majorRadius, minorRadius, options) {
-	const axisDir = options?.axis ?? [
-		0,
-		0,
-		1
-	];
-	return makeEllipse(majorRadius, minorRadius, options?.at ?? [
-		0,
-		0,
-		0
-	], axisDir, options?.xDir);
-}
-/**
-* Create a helical wire.
-*
-* @param pitch  - Vertical distance per full turn.
-* @param height - Total height.
-* @param radius - Helix radius.
-*/
-function helix(pitch, height, radius, options) {
-	return makeHelix(pitch, height, radius, options?.at ?? [
-		0,
-		0,
-		0
-	], options?.axis ?? [
-		0,
-		0,
-		1
-	], options?.lefthand ?? false);
-}
-/** Create a circular arc edge passing through three points. */
-function threePointArc(p1, p2, p3) {
-	return makeThreePointArc(p1, p2, p3);
-}
-/**
-* Create an elliptical arc edge between two angles.
-*
-* All angles are in **degrees** (unlike the legacy `makeEllipseArc` which used radians).
-*
-* @param startAngle - Start angle in degrees.
-* @param endAngle   - End angle in degrees.
-*/
-function ellipseArc(majorRadius, minorRadius, startAngle, endAngle, options) {
-	const axisDir = options?.axis ?? [
-		0,
-		0,
-		1
-	];
-	return makeEllipseArc(majorRadius, minorRadius, startAngle * DEG2RAD, endAngle * DEG2RAD, options?.at ?? [
-		0,
-		0,
-		0
-	], axisDir, options?.xDir);
-}
-/**
-* Create a B-spline edge that approximates a set of 3D points.
-*
-* @returns An error if the approximation algorithm fails.
-*/
-function bsplineApprox(points, config) {
-	return makeBSplineApproximation(points, config);
-}
-/**
-* Create a Bezier curve edge from control points.
-*
-* @param points - Two or more control points.
-*/
-function bezier(points) {
-	return makeBezierCurve(points);
-}
-/**
-* Create a circular arc edge tangent to a direction at the start point.
-*/
-function tangentArc(startPoint, startTgt, endPoint) {
-	return makeTangentArc(startPoint, startTgt, endPoint);
-}
-/**
-* Assemble edges and/or wires into a single connected wire.
-*/
-function wire(listOfEdges) {
-	return assembleWire(listOfEdges);
-}
-/**
-* Assemble edges into a wire and verify it forms a closed loop.
-*
-* Combines {@link wire} + the `closedWire` smart constructor in a single step.
-* Returns an error if the edges cannot be assembled or the wire is not closed.
-*
-* @example
-* ```ts
-* const cw = unwrap(wireLoop([e1, e2, e3, e4]));
-* const f = unwrap(face(cw)); // ClosedWire accepted directly
-* ```
-*/
-function wireLoop(listOfEdges) {
-	return andThen(assembleWire(listOfEdges), (w) => {
-		if (isClosedWire(w)) return ok(w);
-		return err(validationError("WIRE_NOT_CLOSED", "Assembled wire is not closed: start and end points do not coincide"));
-	});
-}
-/**
-* Create a planar face from a closed wire, optionally with holes.
-* The resulting face is always oriented (consistent normal direction).
-*/
-function face(w, holes) {
-	return makeFace(w, holes);
-}
-/**
-* Create a non-planar face from a wire using surface filling.
-* The resulting face is always oriented.
-*/
-function filledFace(w) {
-	return makeNonPlanarFace(w);
-}
-/**
-* Create a face bounded by a wire on an existing face's surface.
-* The resulting face inherits orientation from the origin face.
-*/
-function subFace(originFace, w) {
-	return makeNewFaceWithinFace(originFace, w);
-}
-/**
-* Create a polygonal face from three or more coplanar points.
-* The resulting face is always oriented.
-*/
-function polygon(points) {
-	return makePolygon(points);
-}
-/** Create a vertex at a 3D point. */
-function vertex(point) {
-	return makeVertex(point);
-}
-/**
-* Build a compound from multiple shapes.
-*/
-function compound(shapeArray) {
-	return makeCompound(shapeArray);
-}
-/**
-* Weld faces and shells into a single solid.
-* The resulting solid is always validated.
-*/
-function solid(facesOrShells) {
-	return makeSolid(facesOrShells);
-}
-/**
-* Create an offset shape from a face.
-*/
-function offsetFace(f, distance, tolerance) {
-	return makeOffset(f, distance, tolerance);
-}
-/**
-* Weld faces and shells into a single shell.
-*/
-function sewShells(facesOrShells, ignoreType) {
-	return weldShellsAndFaces(facesOrShells, ignoreType);
-}
-function addHoles(f, holes) {
-	return addHolesInFace(f, holes);
-}
-//#endregion
-export { fuseAllBisect 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, cutAllBisect 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, sharedEdges as at, sphere as b, cylinder as c, chamferDistAngle as ct, ellipsoid as d, toLODGeometryData as dt, getNurbsCurveData as et, face as f, toLineGeometryData as ft, offsetFace as g, line as h, bsplineApprox as i, facesOfEdge as it, heal as j, fixSelfIntersection as k, ellipse as l, toBufferGeometryData as lt, helix as m, bezier as n, adjacentFaces as nt, compound as o, verticesOfEdge as ot, filledFace as p, filletWithEvolution as q, box as r, edgesOfFace as rt, cone as s, wiresOfFace as st, addHoles as t, getNurbsSurfaceData as tt, ellipseArc as u, toGroupedBufferGeometryData as ut, sewShells as v, torus as w, subFace as x, solid as y, fillet as z };
+export { edgesOfFace as A, shellWithEvolution as C, getNurbsCurveData as D, fuseAllBisect as E, chamferDistAngle as F, toBufferGeometryData as I, toGroupedBufferGeometryData as L, sharedEdges as M, verticesOfEdge as N, getNurbsSurfaceData as O, wiresOfFace as P, toLODGeometryData as R, intersectWithEvolution as S, cutAllBisect as T, positionOnCurve as _, healFace as a, filletWithEvolution as b, isValid as c, draft as d, fillet as f, variableFillet as g, thicken as h, heal as i, facesOfEdge as j, adjacentFaces as k, solidFromShell as l, shell as m, fixSelfIntersection as n, healSolid as o, offset as p, fixShape as r, healWire as s, autoHeal as t, chamfer as u, chamferWithEvolution as v, checkBoolean as w, fuseWithEvolution as x, cutWithEvolution as y, toLineGeometryData as z };

package/dist/index.d.ts

@@ -141,6 +141,7 @@ export { fill } from './topology/surfaceBuilders.js';
 export { translate, rotate, mirror, scale, clone, applyMatrix, composeTransforms, transformCopy, type TransformOp, type ComposedTransform, fuse, cut, intersect, section, sectionToFace, split, slice, fillet, chamfer, shell, offset, thicken, draft, heal, simplify, mesh, meshEdges, describe, toBREP, fromBREP, isValid, isEmpty, type RotateOptions, type MirrorOptions, type ScaleOptions, } from './topology/api.js';
 export { extrude, revolve, loft, type RevolveOptions, type LoftOptions as CleanLoftOptions, type SweepOptions as CleanSweepOptions, } from './operations/api.js';
 export { loftAll, type LoftAllEntry } from './operations/loftFns.js';
+export { thread, type ThreadOptions } from './operations/threadFns.js';
 export { drill, pocket, boss, mirrorJoin, rectangularPattern, } from './operations/compoundOpsFns.js';
 export { shape, BrepWrapperError, type Wrapped, type Wrapped3D, type WrappedCurve, type WrappedFace, } from './topology/wrapperFns.js';
 export { type ExternalGearParams, type InternalGearParams, type PlanetaryGearParams, type GearResult, type PlanetaryGearAssembly, type GearDiagnostic, type GearDiagnosticCode, type GearDiagnosticSeverity, type GearGeometry, type PlanetPlacement, type PlanetPlacementParams, makeExternalGear, makeInternalGear, makePlanetaryGear, gearGeometry, validatePlanetary, planetPlacements, } from './gear/index.js';

package/dist/{extrudeFns-CSWqlW-n.js → loftFns-DuxEscJB.js}

@@ -1,5 +1,6 @@
 import { Z as getKernel, c as createSolid, h as isShape3D, t as castShape, y as isWire } from "./shapeTypes-CyTY0prh.js";
 import { A as ok, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, w as isErr } from "./errors-DNWJsfVU.js";
+import { r as toVec3 } from "./types-D24Y27N0.js";
 import { c as vecLength, d as vecNormalize, t as vecAdd } from "./vecOps-SKPRvPH-.js";
 //#region src/operations/extrudeUtils.ts
 /**
@@ -370,4 +371,94 @@ function extrudeAll(entries) {
 	}
 }
 //#endregion
-export { guidedSweep as a, sweep as c, complexExtrude as i, twistExtrude as l, extrudeAll as n, multiSectionSweep as o, revolve as r, supportExtrude as s, extrude as t };
+//#region src/operations/loftFns.ts
+/**
+* Functional loft operation using branded shape types.
+*/
+/**
+* Loft through a set of wire profiles to create a 3D shape.
+*
+* Builds a `BRepOffsetAPI_ThruSections` surface through the given wires,
+* optionally starting and/or ending at point vertices. Produces a solid
+* by default, or a shell when `returnShell` is `true`.
+*
+* @param wires - Ordered wire profiles to loft through.
+* @param config - Loft configuration (ruled interpolation, start/end points).
+* @param returnShell - When `true`, return a shell instead of a solid.
+* @returns `Result` containing the lofted 3D shape, or an error on failure.
+*
+* @example
+* ```ts
+* const result = loft([bottomWire, topWire], { ruled: false });
+* ```
+*
+* @see {@link loft!loft | loft} for the OOP API equivalent.
+*/
+function loft(wires, { ruled = true, startPoint, endPoint, tolerance = 1e-6 } = {}, returnShell = false) {
+	if (wires.length === 0 && !startPoint && !endPoint) return err(validationError("LOFT_EMPTY", "Loft requires at least one wire or start/end point"));
+	const kernel = getKernel();
+	const startVertex = startPoint ? kernel.makeVertex(...toVec3(startPoint)) : void 0;
+	const endVertex = endPoint ? kernel.makeVertex(...toVec3(endPoint)) : void 0;
+	try {
+		const result = castShape(kernel.loftAdvanced(wires.map((w) => w.wrapped), {
+			solid: !returnShell,
+			ruled,
+			tolerance,
+			...startVertex ? { startVertex } : {},
+			...endVertex ? { endVertex } : {}
+		}));
+		if (!isShape3D(result)) return err(typeCastError("LOFT_NOT_3D", "Loft did not produce a 3D shape"));
+		return ok(result);
+	} catch (e) {
+		return err(kernelError("LOFT_FAILED", "Loft operation failed", e, void 0, "Common causes: wire profiles with different edge counts, self-intersecting result, or profiles too far apart. Ensure profiles are compatible and ordered."));
+	}
+}
+/**
+* Batch loft: build N independent lofts in a single kernel call.
+*
+* Uses the C++ LoftBatch extractor when available (single WASM call),
+* falling back to N individual loft operations otherwise.
+*
+* @returns Array of 3D shapes, one per entry.
+*/
+function loftAll(entries) {
+	if (entries.length === 0) return ok([]);
+	const kernel = getKernel();
+	const verticesToDelete = [];
+	const kernelEntries = entries.map((e) => {
+		const startVertex = e.startPoint ? kernel.makeVertex(...toVec3(e.startPoint)) : void 0;
+		const endVertex = e.endPoint ? kernel.makeVertex(...toVec3(e.endPoint)) : void 0;
+		if (startVertex) verticesToDelete.push(startVertex);
+		if (endVertex) verticesToDelete.push(endVertex);
+		return {
+			wires: e.wires.map((w) => w.wrapped),
+			solid: true,
+			ruled: e.ruled ?? true,
+			tolerance: e.tolerance ?? 1e-6,
+			startVertex,
+			endVertex
+		};
+	});
+	try {
+		const shapes = kernel.loftBatch?.(kernelEntries) ?? kernelEntries.map((e) => kernel.loftAdvanced(e.wires, {
+			solid: e.solid,
+			ruled: e.ruled,
+			tolerance: e.tolerance,
+			startVertex: e.startVertex,
+			endVertex: e.endVertex
+		}));
+		const results = [];
+		for (const shape of shapes) {
+			const cast = castShape(shape);
+			if (!isShape3D(cast)) return err(typeCastError("LOFT_ALL_NOT_3D", "Batch loft entry did not produce a 3D shape"));
+			results.push(cast);
+		}
+		return ok(results);
+	} catch (e) {
+		return err(kernelError("LOFT_ALL_FAILED", "Batch loft operation failed", e));
+	} finally {
+		for (const v of verticesToDelete) kernel.dispose(v);
+	}
+}
+//#endregion
+export { revolve as a, multiSectionSweep as c, twistExtrude as d, extrudeAll as i, supportExtrude as l, loftAll as n, complexExtrude as o, extrude as r, guidedSweep as s, loft as t, sweep as u };

package/dist/{extrudeFns-BJSW3EaV.cjs → loftFns-DycLH1Pq.cjs}

@@ -1,5 +1,6 @@
 const require_shapeTypes = require("./shapeTypes-CxSqNvHA.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
+const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 //#region src/operations/extrudeUtils.ts
 /**
@@ -370,6 +371,96 @@ function extrudeAll(entries) {
 	}
 }
 //#endregion
+//#region src/operations/loftFns.ts
+/**
+* Functional loft operation using branded shape types.
+*/
+/**
+* Loft through a set of wire profiles to create a 3D shape.
+*
+* Builds a `BRepOffsetAPI_ThruSections` surface through the given wires,
+* optionally starting and/or ending at point vertices. Produces a solid
+* by default, or a shell when `returnShell` is `true`.
+*
+* @param wires - Ordered wire profiles to loft through.
+* @param config - Loft configuration (ruled interpolation, start/end points).
+* @param returnShell - When `true`, return a shell instead of a solid.
+* @returns `Result` containing the lofted 3D shape, or an error on failure.
+*
+* @example
+* ```ts
+* const result = loft([bottomWire, topWire], { ruled: false });
+* ```
+*
+* @see {@link loft!loft | loft} for the OOP API equivalent.
+*/
+function loft(wires, { ruled = true, startPoint, endPoint, tolerance = 1e-6 } = {}, returnShell = false) {
+	if (wires.length === 0 && !startPoint && !endPoint) return require_errors.err(require_errors.validationError("LOFT_EMPTY", "Loft requires at least one wire or start/end point"));
+	const kernel = require_shapeTypes.getKernel();
+	const startVertex = startPoint ? kernel.makeVertex(...require_types.toVec3(startPoint)) : void 0;
+	const endVertex = endPoint ? kernel.makeVertex(...require_types.toVec3(endPoint)) : void 0;
+	try {
+		const result = require_shapeTypes.castShape(kernel.loftAdvanced(wires.map((w) => w.wrapped), {
+			solid: !returnShell,
+			ruled,
+			tolerance,
+			...startVertex ? { startVertex } : {},
+			...endVertex ? { endVertex } : {}
+		}));
+		if (!require_shapeTypes.isShape3D(result)) return require_errors.err(require_errors.typeCastError("LOFT_NOT_3D", "Loft did not produce a 3D shape"));
+		return require_errors.ok(result);
+	} catch (e) {
+		return require_errors.err(require_errors.kernelError("LOFT_FAILED", "Loft operation failed", e, void 0, "Common causes: wire profiles with different edge counts, self-intersecting result, or profiles too far apart. Ensure profiles are compatible and ordered."));
+	}
+}
+/**
+* Batch loft: build N independent lofts in a single kernel call.
+*
+* Uses the C++ LoftBatch extractor when available (single WASM call),
+* falling back to N individual loft operations otherwise.
+*
+* @returns Array of 3D shapes, one per entry.
+*/
+function loftAll(entries) {
+	if (entries.length === 0) return require_errors.ok([]);
+	const kernel = require_shapeTypes.getKernel();
+	const verticesToDelete = [];
+	const kernelEntries = entries.map((e) => {
+		const startVertex = e.startPoint ? kernel.makeVertex(...require_types.toVec3(e.startPoint)) : void 0;
+		const endVertex = e.endPoint ? kernel.makeVertex(...require_types.toVec3(e.endPoint)) : void 0;
+		if (startVertex) verticesToDelete.push(startVertex);
+		if (endVertex) verticesToDelete.push(endVertex);
+		return {
+			wires: e.wires.map((w) => w.wrapped),
+			solid: true,
+			ruled: e.ruled ?? true,
+			tolerance: e.tolerance ?? 1e-6,
+			startVertex,
+			endVertex
+		};
+	});
+	try {
+		const shapes = kernel.loftBatch?.(kernelEntries) ?? kernelEntries.map((e) => kernel.loftAdvanced(e.wires, {
+			solid: e.solid,
+			ruled: e.ruled,
+			tolerance: e.tolerance,
+			startVertex: e.startVertex,
+			endVertex: e.endVertex
+		}));
+		const results = [];
+		for (const shape of shapes) {
+			const cast = require_shapeTypes.castShape(shape);
+			if (!require_shapeTypes.isShape3D(cast)) return require_errors.err(require_errors.typeCastError("LOFT_ALL_NOT_3D", "Batch loft entry did not produce a 3D shape"));
+			results.push(cast);
+		}
+		return require_errors.ok(results);
+	} catch (e) {
+		return require_errors.err(require_errors.kernelError("LOFT_ALL_FAILED", "Batch loft operation failed", e));
+	} finally {
+		for (const v of verticesToDelete) kernel.dispose(v);
+	}
+}
+//#endregion
 Object.defineProperty(exports, "complexExtrude", {
 	enumerable: true,
 	get: function() {
@@ -394,6 +485,18 @@ Object.defineProperty(exports, "guidedSweep", {
 		return guidedSweep;
 	}
 });
+Object.defineProperty(exports, "loft", {
+	enumerable: true,
+	get: function() {
+		return loft;
+	}
+});
+Object.defineProperty(exports, "loftAll", {
+	enumerable: true,
+	get: function() {
+		return loftAll;
+	}
+});
 Object.defineProperty(exports, "multiSectionSweep", {
 	enumerable: true,
 	get: function() {

package/dist/operations/threadFns.d.ts

@@ -0,0 +1,39 @@
+import { Shape3D } from '../core/shapeTypes.js';
+import { Result } from '../core/result.js';
+/** Configuration for {@link thread}. Units are mm; angles derive from pitch. */
+export interface ThreadOptions {
+    /** Core radius (external) or nominal hole radius (internal), at the thread root. */
+    radius: number;
+    /** Axial distance per full turn. */
+    pitch: number;
+    /** Total thread length along the axis. Turn count = `height / pitch`. */
+    height: number;
+    /** Radial thread height (crest minus root). Defaults to `0.6 * pitch` (≈ISO 60° V). */
+    depth?: number;
+    /** Axial half-width of the V tooth. Defaults to `0.42 * pitch`. */
+    toothHalfWidth?: number;
+    /** Loft sections per turn — higher is smoother but slower. Defaults to `20`. */
+    sectionsPerTurn?: number;
+    /** Left-handed thread. Defaults to `false` (right-handed). */
+    lefthand?: boolean;
+    /** Point the tooth toward the axis (for an internal thread to `cut` from a bore). */
+    inward?: boolean;
+}
+/**
+ * Build a helical screw-thread ridge by lofting rotated tooth sections.
+ *
+ * @param options - {@link ThreadOptions}.
+ * @returns `Result` with the thread-ridge solid, or an error.
+ *
+ * @example External thread (Ø12 rod, 2.5 mm pitch):
+ * ```ts
+ * const ridge = thread({ radius: 6, pitch: 2.5, height: 7.5 });
+ * const rod = fuse(cylinder(6.15, 7.5), unwrap(ridge));
+ * ```
+ * @example Internal thread (tapped Ø6 hole):
+ * ```ts
+ * const ridge = thread({ radius: 3, pitch: 1, height: 6, inward: true });
+ * const nut = cut(boredBlock, unwrap(ridge));
+ * ```
+ */
+export declare function thread(options: ThreadOptions): Result<Shape3D>;

package/dist/operations.cjs

@@ -1,33 +1,34 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_historyFns = require("./historyFns-4ggYGJB2.cjs");
-const require_extrudeFns = require("./extrudeFns-BJSW3EaV.cjs");
-exports.addChild = require_historyFns.addChild;
-exports.addStep = require_historyFns.addStep;
-exports.circularPattern = require_historyFns.circularPattern;
-exports.collectShapes = require_historyFns.collectShapes;
-exports.complexExtrude = require_extrudeFns.complexExtrude;
-exports.countNodes = require_historyFns.countNodes;
-exports.createAssembly = require_historyFns.createAssembly;
-exports.createAssemblyNode = require_historyFns.createAssemblyNode;
-exports.createHistory = require_historyFns.createHistory;
-exports.createRegistry = require_historyFns.createRegistry;
-exports.exportAssemblySTEP = require_historyFns.exportAssemblySTEP;
-exports.findNode = require_historyFns.findNode;
-exports.findStep = require_historyFns.findStep;
-exports.getHistoryShape = require_historyFns.getShape;
-exports.gridPattern = require_historyFns.gridPattern;
-exports.linearPattern = require_historyFns.linearPattern;
-exports.modifyStep = require_historyFns.modifyStep;
-exports.registerOperation = require_historyFns.registerOperation;
-exports.registerShape = require_historyFns.registerShape;
-exports.removeChild = require_historyFns.removeChild;
-exports.replayFrom = require_historyFns.replayFrom;
-exports.replayHistory = require_historyFns.replayHistory;
-exports.stepCount = require_historyFns.stepCount;
-exports.stepsFrom = require_historyFns.stepsFrom;
-exports.supportExtrude = require_extrudeFns.supportExtrude;
-exports.sweep = require_extrudeFns.sweep;
-exports.twistExtrude = require_extrudeFns.twistExtrude;
-exports.undoLast = require_historyFns.undoLast;
-exports.updateNode = require_historyFns.updateNode;
-exports.walkAssembly = require_historyFns.walkAssembly;
+const require_threadFns = require("./threadFns-aWgxzqmT.cjs");
+const require_loftFns = require("./loftFns-DycLH1Pq.cjs");
+exports.addChild = require_threadFns.addChild;
+exports.addStep = require_threadFns.addStep;
+exports.circularPattern = require_threadFns.circularPattern;
+exports.collectShapes = require_threadFns.collectShapes;
+exports.complexExtrude = require_loftFns.complexExtrude;
+exports.countNodes = require_threadFns.countNodes;
+exports.createAssembly = require_threadFns.createAssembly;
+exports.createAssemblyNode = require_threadFns.createAssemblyNode;
+exports.createHistory = require_threadFns.createHistory;
+exports.createRegistry = require_threadFns.createRegistry;
+exports.exportAssemblySTEP = require_threadFns.exportAssemblySTEP;
+exports.findNode = require_threadFns.findNode;
+exports.findStep = require_threadFns.findStep;
+exports.getHistoryShape = require_threadFns.getShape;
+exports.gridPattern = require_threadFns.gridPattern;
+exports.linearPattern = require_threadFns.linearPattern;
+exports.modifyStep = require_threadFns.modifyStep;
+exports.registerOperation = require_threadFns.registerOperation;
+exports.registerShape = require_threadFns.registerShape;
+exports.removeChild = require_threadFns.removeChild;
+exports.replayFrom = require_threadFns.replayFrom;
+exports.replayHistory = require_threadFns.replayHistory;
+exports.stepCount = require_threadFns.stepCount;
+exports.stepsFrom = require_threadFns.stepsFrom;
+exports.supportExtrude = require_loftFns.supportExtrude;
+exports.sweep = require_loftFns.sweep;
+exports.thread = require_threadFns.thread;
+exports.twistExtrude = require_loftFns.twistExtrude;
+exports.undoLast = require_threadFns.undoLast;
+exports.updateNode = require_threadFns.updateNode;
+exports.walkAssembly = require_threadFns.walkAssembly;

package/dist/operations.d.ts

@@ -7,6 +7,7 @@
  * ```
  */
 export { sweep, supportExtrude, complexExtrude, twistExtrude, type SweepOptions, type ExtrusionProfile, } from './operations/extrudeFns.js';
+export { thread, type ThreadOptions } from './operations/threadFns.js';
 export { linearPattern, circularPattern, gridPattern } from './operations/patternFns.js';
 export { createAssemblyNode, addChild, removeChild, updateNode, findNode, walkAssembly, countNodes, collectShapes, type AssemblyNode, type AssemblyNodeOptions, } from './operations/assemblyFns.js';
 export { exportAssemblySTEP, type ShapeOptions, type SupportedUnit, } from './operations/exporterFns.js';