brepjs 18.82.4 → 18.82.5

package/dist/primitiveFns-BPfYb_t5.cjs

@@ -0,0 +1,461 @@
+const require_shapeTypes = require("./shapeTypes-D1eUDuzl.cjs");
+const require_errors = require("./errors-CXJtc4I7.cjs");
+const require_constants = require("./constants-BOVyEYGH.cjs");
+const require_shapeFns = require("./shapeFns-sF0x5Zhj.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-R4DKNFkI.cjs");
+const require_solidBuilders = require("./solidBuilders-lDXPwoCz.cjs");
+//#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 = require_shapeTypes.createSolid(require_shapeTypes.getKernel().makeBox(width, depth, height));
+	const center = options?.at ?? (options?.centered ? [
+		0,
+		0,
+		0
+	] : void 0);
+	if (center) return require_shapeFns.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 = require_solidBuilders.makeCylinder(radius, height, at, axis);
+	if (options?.centered) {
+		const halfShift = [
+			-axis[0] * height * .5,
+			-axis[1] * height * .5,
+			-axis[2] * height * .5
+		];
+		solid = require_shapeFns.translate(solid, halfShift);
+	}
+	return solid;
+}
+/**
+* Create a sphere with the given radius.
+*/
+function sphere(radius, options) {
+	let solid = require_solidBuilders.makeSphere(radius);
+	if (options?.at) solid = require_shapeFns.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 = require_solidBuilders.makeCone(bottomRadius, topRadius, height, at, axis);
+	if (options?.centered) {
+		const halfShift = [
+			-axis[0] * height * .5,
+			-axis[1] * height * .5,
+			-axis[2] * height * .5
+		];
+		solid = require_shapeFns.translate(solid, halfShift);
+	}
+	return solid;
+}
+/**
+* Create a torus with the given major and minor radii.
+*/
+function torus(majorRadius, minorRadius, options) {
+	return require_solidBuilders.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 = require_solidBuilders.makeEllipsoid(rx, ry, rz);
+	if (options?.at) solid = require_shapeFns.translate(solid, options.at);
+	return solid;
+}
+/** Create a straight edge between two 3D points. */
+function line(from, to) {
+	return require_surfaceBuilders.makeLine(from, to);
+}
+/** Create a circular edge with the given radius. */
+function circle(radius, options) {
+	const axisDir = options?.axis ?? [
+		0,
+		0,
+		1
+	];
+	return require_surfaceBuilders.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 require_surfaceBuilders.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 require_surfaceBuilders.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 require_surfaceBuilders.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 require_surfaceBuilders.makeEllipseArc(majorRadius, minorRadius, startAngle * require_constants.DEG2RAD, endAngle * require_constants.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 require_surfaceBuilders.makeBSplineApproximation(points, config);
+}
+/**
+* Create a Bezier curve edge from control points.
+*
+* @param points - Two or more control points.
+*/
+function bezier(points) {
+	return require_surfaceBuilders.makeBezierCurve(points);
+}
+/**
+* Create a circular arc edge tangent to a direction at the start point.
+*/
+function tangentArc(startPoint, startTgt, endPoint) {
+	return require_surfaceBuilders.makeTangentArc(startPoint, startTgt, endPoint);
+}
+/**
+* Assemble edges and/or wires into a single connected wire.
+*/
+function wire(listOfEdges) {
+	return require_surfaceBuilders.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 require_errors.andThen(require_surfaceBuilders.assembleWire(listOfEdges), (w) => {
+		if (require_shapeTypes.isClosedWire(w)) return require_errors.ok(w);
+		return require_errors.err(require_errors.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 require_surfaceBuilders.makeFace(w, holes);
+}
+/**
+* Create a non-planar face from a wire using surface filling.
+* The resulting face is always oriented.
+*/
+function filledFace(w) {
+	return require_surfaceBuilders.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 require_surfaceBuilders.makeNewFaceWithinFace(originFace, w);
+}
+/**
+* Create a polygonal face from three or more coplanar points.
+* The resulting face is always oriented.
+*/
+function polygon(points) {
+	return require_surfaceBuilders.makePolygon(points);
+}
+/** Create a vertex at a 3D point. */
+function vertex(point) {
+	return require_solidBuilders.makeVertex(point);
+}
+/**
+* Build a compound from multiple shapes.
+*/
+function compound(shapeArray) {
+	return require_solidBuilders.makeCompound(shapeArray);
+}
+/**
+* Weld faces and shells into a single solid.
+* The resulting solid is always validated.
+*/
+function solid(facesOrShells) {
+	return require_solidBuilders.makeSolid(facesOrShells);
+}
+/**
+* Create an offset shape from a face.
+*/
+function offsetFace(f, distance, tolerance) {
+	return require_solidBuilders.makeOffset(f, distance, tolerance);
+}
+/**
+* Weld faces and shells into a single shell.
+*/
+function sewShells(facesOrShells, ignoreType) {
+	return require_solidBuilders.weldShellsAndFaces(facesOrShells, ignoreType);
+}
+function addHoles(f, holes) {
+	return require_surfaceBuilders.addHolesInFace(f, holes);
+}
+//#endregion
+Object.defineProperty(exports, "addHoles", {
+	enumerable: true,
+	get: function() {
+		return addHoles;
+	}
+});
+Object.defineProperty(exports, "bezier", {
+	enumerable: true,
+	get: function() {
+		return bezier;
+	}
+});
+Object.defineProperty(exports, "box", {
+	enumerable: true,
+	get: function() {
+		return box;
+	}
+});
+Object.defineProperty(exports, "bsplineApprox", {
+	enumerable: true,
+	get: function() {
+		return bsplineApprox;
+	}
+});
+Object.defineProperty(exports, "circle", {
+	enumerable: true,
+	get: function() {
+		return circle;
+	}
+});
+Object.defineProperty(exports, "compound", {
+	enumerable: true,
+	get: function() {
+		return compound;
+	}
+});
+Object.defineProperty(exports, "cone", {
+	enumerable: true,
+	get: function() {
+		return cone;
+	}
+});
+Object.defineProperty(exports, "cylinder", {
+	enumerable: true,
+	get: function() {
+		return cylinder;
+	}
+});
+Object.defineProperty(exports, "ellipse", {
+	enumerable: true,
+	get: function() {
+		return ellipse;
+	}
+});
+Object.defineProperty(exports, "ellipseArc", {
+	enumerable: true,
+	get: function() {
+		return ellipseArc;
+	}
+});
+Object.defineProperty(exports, "ellipsoid", {
+	enumerable: true,
+	get: function() {
+		return ellipsoid;
+	}
+});
+Object.defineProperty(exports, "face", {
+	enumerable: true,
+	get: function() {
+		return face;
+	}
+});
+Object.defineProperty(exports, "filledFace", {
+	enumerable: true,
+	get: function() {
+		return filledFace;
+	}
+});
+Object.defineProperty(exports, "helix", {
+	enumerable: true,
+	get: function() {
+		return helix;
+	}
+});
+Object.defineProperty(exports, "line", {
+	enumerable: true,
+	get: function() {
+		return line;
+	}
+});
+Object.defineProperty(exports, "offsetFace", {
+	enumerable: true,
+	get: function() {
+		return offsetFace;
+	}
+});
+Object.defineProperty(exports, "polygon", {
+	enumerable: true,
+	get: function() {
+		return polygon;
+	}
+});
+Object.defineProperty(exports, "sewShells", {
+	enumerable: true,
+	get: function() {
+		return sewShells;
+	}
+});
+Object.defineProperty(exports, "solid", {
+	enumerable: true,
+	get: function() {
+		return solid;
+	}
+});
+Object.defineProperty(exports, "sphere", {
+	enumerable: true,
+	get: function() {
+		return sphere;
+	}
+});
+Object.defineProperty(exports, "subFace", {
+	enumerable: true,
+	get: function() {
+		return subFace;
+	}
+});
+Object.defineProperty(exports, "tangentArc", {
+	enumerable: true,
+	get: function() {
+		return tangentArc;
+	}
+});
+Object.defineProperty(exports, "threePointArc", {
+	enumerable: true,
+	get: function() {
+		return threePointArc;
+	}
+});
+Object.defineProperty(exports, "torus", {
+	enumerable: true,
+	get: function() {
+		return torus;
+	}
+});
+Object.defineProperty(exports, "vertex", {
+	enumerable: true,
+	get: function() {
+		return vertex;
+	}
+});
+Object.defineProperty(exports, "wire", {
+	enumerable: true,
+	get: function() {
+		return wire;
+	}
+});
+Object.defineProperty(exports, "wireLoop", {
+	enumerable: true,
+	get: function() {
+		return wireLoop;
+	}
+});