brepjs 18.84.1 → 18.86.0

package/README.md

@@ -38,14 +38,14 @@ const step = unwrap(exportSTEP(part));
 
 brepjs grew out of the love and care I put into [gridfinitylayouttool.com](https://gridfinitylayouttool.com). I needed parametric CAD in the browser and I'm not a 3D modeler, but I know TypeScript. [OpenSCAD](https://openscad.org/) nailed code-first CAD but lives outside the JS ecosystem. [replicad](https://replicad.xyz/) proved OpenCascade works in JS but I kept hitting performance walls and fighting the API.
 
-Neither had the type safety I wanted, so brepjs leans hard on it: branded types, `Result<T,E>`, phantom types that prove invariants at compile time. If it compiles, the geometry is valid. Best for parts defined by parameters (enclosures, brackets, fixtures, gridfinity bins) rather than organic sculpting.
+Neither had the type safety I wanted, so brepjs leans hard on it: branded types, `Result<T,E>`, phantom types that prove invariants at compile time. If it compiles, the geometry is valid. It's strongest at exact, manufacturable geometry — precise booleans, fillets, chamfers and shells; real volumes, areas and clearances; watertight solids that round-trip through STEP — from a single part to a full assembly (enclosures, brackets, fixtures, gridfinity bins, machined and molded parts). It isn't built for organic sculpting or dense lattices; that's what field-based (implicit/voxel) modeling is for.
 
 ## Scope
 
 To set expectations, this project deliberately does not:
 
 - **Render or display geometry**: brepjs produces shape data; pass mesh output to Three.js, Babylon.js, or raw WebGL for rendering.
-- **Support organic or sculpting workflows**: the API is built for parametric parts (enclosures, brackets, fixtures); freeform sculpting is out of scope.
+- **Support organic or sculpting workflows**: brepjs models exact mechanical solids — parts and assemblies; freeform/organic sculpting and dense lattices are out of scope (that's field-based implicit/voxel territory).
 - **Output SVG or 2D files**: 2D drawing primitives exist solely as an intermediate step toward extruded 3D solids, not as a standalone 2D output format.
 - **Run server-side (SSR)**: WASM requires a browser or Node.js environment with WASM support; server-side rendering frameworks (Next.js, Nuxt, Remix) need a client-only import.
 - **Provide a GUI**: brepjs is a pure programmatic API; there is no visual editor, viewport, or file picker.
@@ -105,7 +105,7 @@ Imports flow downward only. Boundaries are enforced in CI.
 
 ## Authoring CAD with AI (brepjs-verify)
 
-[`brepjs-verify`](https://www.npmjs.com/package/brepjs-verify) helps an AI agent (or you) author parametric CAD in brepjs and **prove it is correct** before handing it off. An LLM can't see geometry, so it writes a `.brep.ts` part, runs it on a real kernel, and reads a deterministic report instead of guessing from how the code reads. It ships as two cooperating pieces: a **Claude Code skill** (the authoring loop) and a **verification CLI** (validity + measured dimensions + multi-view snapshots + STEP export).
+[`brepjs-verify`](https://www.npmjs.com/package/brepjs-verify) helps an AI agent (or you) author CAD in brepjs and **prove it is correct** before handing it off. An LLM can't see geometry, so it writes a `.brep.ts` part, runs it on a real kernel, and reads a deterministic report instead of guessing from how the code reads. It ships as two cooperating pieces: a **Claude Code skill** (the authoring loop) and a **verification CLI** (validity + measured dimensions + multi-view snapshots + STEP export).
 
 Install both; they ride on two rails:
 
@@ -141,6 +141,16 @@ The command exits non-zero unless the report is `ok` (valid **and** every declar
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
 
+## Acknowledgements
+
+brepjs.dev and the playground are hosted on [Vercel](https://vercel.com) through its Open Source Program.
+
+<div align="center">
+  <a href="https://vercel.com/open-source-program">
+    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
+  </a>
+</div>
+
 ## License
 
 [Apache-2.0](./LICENSE)

package/dist/brepjs.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-BhxAXpVE.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
 const require_shapeTypes = require("./shapeTypes-DwNTiXjG.cjs");
 const require_occtWasmAdapter = require("./occtWasmAdapter-Bv2OTOX9.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
@@ -20,7 +20,7 @@ const require_healingFns = require("./healingFns-B1axWCr3.cjs");
 const require_threadFns = require("./threadFns-BsRDNoSm.cjs");
 const require_blueprintSketcher = require("./blueprintSketcher-ChpPo7tq.cjs");
 const require_helpers = require("./helpers-Cvrmxw4s.cjs");
-const require_drawFns = require("./drawFns-DWHuHfHQ.cjs");
+const require_drawFns = require("./drawFns-C766Umy1.cjs");
 const require_measureFns = require("./measureFns-BtPAmRfH.cjs");
 const require_cornerFinder = require("./cornerFinder-DKyR_u8g.cjs");
 const require_boolean2D = require("./boolean2D-RC6jXv4x.cjs");
@@ -28,7 +28,7 @@ const require_blueprintFns = require("./blueprintFns-Dp0_BOuL.cjs");
 const require_importFns = require("./importFns-D09lb1dB.cjs");
 const require_loftFns = require("./loftFns-C664R57e.cjs");
 const require_cameraFns = require("./cameraFns-IL7qYFaG.cjs");
-const require_textMetrics = require("./textMetrics-SaXWFfLN.cjs");
+const require_textMetrics = require("./textMetrics-BYHtOFYW.cjs");
 const require_shapeRefFns = require("./shapeRefFns-BsX2j-n3.cjs");
 const require_workerHandler = require("./workerHandler-CdlOTwJg.cjs");
 const require_primitiveFns = require("./primitiveFns-Bdqm8wjI.cjs");
@@ -3354,6 +3354,20 @@ function cut(base, tool, options) {
 		unsafe: true
 	});
 }
+/** Fuse many 3D shapes (boolean union) in a single operation. */
+function fuseAll(shapes, options) {
+	return require_solidBuilders.fuseAll(shapes.map((s) => resolve(s)), {
+		...options,
+		unsafe: true
+	});
+}
+/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
+function cutAll(base, tools, options) {
+	return require_solidBuilders.cutAll(resolve(base), tools.map((s) => resolve(s)), {
+		...options,
+		unsafe: true
+	});
+}
 /** Compute the intersection of two shapes (boolean common). */
 function intersect(a, b, options) {
 	return require_solidBuilders.intersect(resolve(a), resolve(b), {
@@ -6594,7 +6608,7 @@ exports.curveStartPoint = require_curveFns.curveStartPoint;
 exports.curveTangentAt = require_curveFns.curveTangentAt;
 exports.cut = cut;
 exports.cut2D = require_boolean2D.cut2D;
-exports.cutAll = require_solidBuilders.cutAll;
+exports.cutAll = cutAll;
 exports.cutAllBisect = require_healingFns.cutAllBisect;
 exports.cutBlueprints = require_boolean2D.cutBlueprints;
 exports.cutWithEvolution = require_healingFns.cutWithEvolution;
@@ -6682,7 +6696,7 @@ exports.fromKernelVec = fromKernelVec;
 exports.fromNullable = require_errors.fromNullable;
 exports.fuse = fuse;
 exports.fuse2D = require_boolean2D.fuse2D;
-exports.fuseAll = require_solidBuilders.fuseAll;
+exports.fuseAll = fuseAll;
 exports.fuseAllBisect = require_healingFns.fuseAllBisect;
 exports.fuseBlueprints = require_boolean2D.fuseBlueprints;
 exports.fuseWithEvolution = require_healingFns.fuseWithEvolution;

package/dist/brepjs.js

@@ -13,21 +13,21 @@ import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as get
 import { a as meshEdges$1, c as createMeshCache, i as mesh$1, n as exportSTEP, o as meshMultiLOD, r as exportSTL, s as clearMeshCache, t as exportIGES } from "./meshFns-CtchqgDR.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 import { _ as makeThreePointArc, d as makeCircle, h as makeLine, l as makeBSplineInterpolation, n as fill, r as makeFace, s as assembleWire } from "./surfaceBuilders-BQx3TjMH.js";
-import { _ as section$1, b as split$1, d as booleanPipeline, f as cut$2, g as intersect$2, h as fuseAll, m as fuse$2, p as cutAll, r as makeCylinder, v as sectionToFace$1, y as slice$1 } from "./solidBuilders-Bb5_uC7F.js";
+import { _ as section$1, b as split$1, d as booleanPipeline, f as cut$2, g as intersect$2, h as fuseAll$2, m as fuse$2, p as cutAll$2, r as makeCylinder, v as sectionToFace$1, y as slice$1 } from "./solidBuilders-Bb5_uC7F.js";
 import { A as edgesOfFace, C as shellWithEvolution, D as getNurbsCurveData, E as fuseAllBisect, F as chamferDistAngle, I as toBufferGeometryData, L as toGroupedBufferGeometryData, M as sharedEdges, N as verticesOfEdge, O as getNurbsSurfaceData, P as wiresOfFace, R as toLODGeometryData, S as intersectWithEvolution, T as cutAllBisect, _ as positionOnCurve, a as healFace, b as filletWithEvolution, c as isValid$1, d as draft$1, f as fillet$1, g as variableFillet, h as thicken$1, i as heal$1, j as facesOfEdge, k as adjacentFaces, l as solidFromShell, m as shell$1, n as fixSelfIntersection, o as healSolid, p as offset$1, r as fixShape, s as healWire, t as autoHeal, u as chamfer$1, v as chamferWithEvolution, w as checkBoolean, x as fuseWithEvolution, y as cutWithEvolution, z as toLineGeometryData } from "./healingFns-Cxi24K_n.js";
 import { A as setJointValue, B as findNode, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as quatRotate, H as updateNode, I as addChild, J as createAssembly, K as linearPattern, L as collectShapes, M as sphericalJoint, N as quatFromAxisAngle, O as prismaticJoint, P as quatFromTo, R as countNodes, S as addJoint, T as jointTransform, U as walkAssembly, V as removeChild, W as circularPattern, _ as exportURDF, a as deserializeHistory, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, p as serializeHistory, q as exportAssemblySTEP, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as createAssemblyNode } from "./threadFns-BWAL8cAZ.js";
 import { n as BaseSketcher2d, r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-CxFmYBvh.js";
 import { a as createTypedFinder, i as wireFinder, n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-CKjmUSf0.js";
-import { A as sketchEllipse, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-DiiBS6r0.js";
+import { A as sketchEllipse, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-C63kOWvC.js";
 import { a as measureDistance, c as measureLinearProps, d as measureVolumeProps, i as measureCurvatureAtMid, l as measureSurfaceProps, n as measureArea, o as measureDistanceProps, r as measureCurvatureAt, s as measureLength, t as createDistanceQuery, u as measureVolume } from "./measureFns-D0e8tGSP.js";
 import { t as cornerFinder } from "./cornerFinder-7M1wdtcY.js";
 import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-CIohnI9l.js";
 import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, n as createCompoundBlueprint, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-DCA97w4C.js";
 import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-CDaNqu4H.js";
 import { a as revolve$1, c as multiSectionSweep, d as twistExtrude, i as extrudeAll, l as supportExtrude, n as loftAll, o as complexExtrude, r as extrude$1, s as guidedSweep, t as loft$1, u as sweep$1 } from "./loftFns-C8Ep9McS.js";
-import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, n as getFont, o as compoundSketchExtrude, p as sketchRevolve, r as loadFont, s as compoundSketchFace, t as textBlueprints, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-BK3idmq5.js";
+import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, n as getFont, o as compoundSketchExtrude, p as sketchRevolve, r as loadFont, s as compoundSketchFace, t as textBlueprints, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-CU7MHMR8.js";
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-BA7CVtWJ.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-DSYHxQ3W.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-BDTWvvyd.js";
 import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-C4JSc_jF.js";
 import { a as createTaskQueue, c as isEmpty$1, d as isDisposeRequest, f as isErrorResponse, h as isSuccessResponse, i as createWorkerClient, l as pendingCount, m as isOperationRequest, n as createWorkerHandler, o as dequeueTask, p as isInitRequest, r as registerHandler, s as enqueueTask, t as createOperationRegistry, u as rejectAll } from "./workerHandler-CFetYgIm.js";
 import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere$1, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus$1, x as subFace, y as solid } from "./primitiveFns-D7R24hoz.js";
@@ -3365,6 +3365,20 @@ function cut(base, tool, options) {
 		unsafe: true
 	});
 }
+/** Fuse many 3D shapes (boolean union) in a single operation. */
+function fuseAll(shapes, options) {
+	return fuseAll$2(shapes.map((s) => resolve(s)), {
+		...options,
+		unsafe: true
+	});
+}
+/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
+function cutAll(base, tools, options) {
+	return cutAll$2(resolve(base), tools.map((s) => resolve(s)), {
+		...options,
+		unsafe: true
+	});
+}
 /** Compute the intersection of two shapes (boolean common). */
 function intersect(a, b, options) {
 	return intersect$2(resolve(a), resolve(b), {
@@ -3755,7 +3769,7 @@ function rectangularPattern(shape, options) {
 		];
 		copies.push(translate$2(s, offset));
 	}
-	return fuseAll(copies, { unsafe: true });
+	return fuseAll$2(copies, { unsafe: true });
 }
 //#endregion
 //#region src/topology/wrapperFns.ts
@@ -3872,11 +3886,11 @@ function create3DBooleans(val) {
 			...opts,
 			unsafe: true
 		}))),
-		fuseAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(fuseAll([val, ...tools.map(resolve)], {
+		fuseAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(fuseAll$2([val, ...tools.map(resolve)], {
 			...opts,
 			unsafe: true
 		})))),
-		cutAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(cutAll(val, tools, {
+		cutAll: (tools, opts) => wrap3D(trustAsT(unwrapOrThrow(cutAll$2(val, tools, {
 			...opts,
 			unsafe: true
 		})))),
@@ -4664,10 +4678,10 @@ var booleans_exports = /* @__PURE__ */ __exportAll({
 	checkBoolean: () => checkBoolean,
 	convexHull: () => convexHull,
 	cut: () => cut,
-	cutAll: () => cutAll,
+	cutAll: () => cutAll$2,
 	cutAllBisect: () => cutAllBisect,
 	fuse: () => fuse,
-	fuseAll: () => fuseAll,
+	fuseAll: () => fuseAll$2,
 	fuseAllBisect: () => fuseAllBisect,
 	hull: () => hull,
 	intersect: () => intersect,
@@ -5487,7 +5501,7 @@ function evalFuseAll(node, ctx) {
 	if (non.length === 1 && non[0]) return ctx.evalNode(non[0]);
 	const resolved = resolveAll(ctx, non, "FuseAll.operand");
 	if (!resolved.ok) return resolved;
-	return fuseAll(resolved.value, boolOptions(node, ctx));
+	return fuseAll$2(resolved.value, boolOptions(node, ctx));
 }
 function evalCutAll(node, ctx) {
 	if (node.base.kind === "Empty") return emptyResult$1("CutAll");
@@ -5497,7 +5511,7 @@ function evalCutAll(node, ctx) {
 	if (!base.ok) return base;
 	const resolved = resolveAll(ctx, tools, "CutAll.tool");
 	if (!resolved.ok) return resolved;
-	return cutAll(base.value, resolved.value, boolOptions(node, ctx));
+	return cutAll$2(base.value, resolved.value, boolOptions(node, ctx));
 }
 //#endregion
 //#region src/csg/evaluators/transforms.ts

package/dist/{drawFns-DiiBS6r0.js → drawFns-C63kOWvC.js}

@@ -15,7 +15,7 @@ import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y
 import { _ as Curve2D, a as edgeToCurve, c as make2dCircle, d as make2dInerpolatedBSplineCurve, f as make2dSegmentCurve, g as approximateAsSvgCompatibleCurve, i as curvesAsEdgesOnPlane, l as make2dEllipse, o as make2dArcFromCenter, t as Blueprint, v as deserializeCurve2D, y as BoundingBox2d } from "./blueprint-BL2TdtBX.js";
 import { t as cornerFinder } from "./cornerFinder-7M1wdtcY.js";
 import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-CIohnI9l.js";
-import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-BK3idmq5.js";
+import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-CU7MHMR8.js";
 import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-BA7CVtWJ.js";
 //#region src/2d/lib/stitching.ts
 /**

package/dist/{drawFns-DWHuHfHQ.cjs → drawFns-C766Umy1.cjs}

@@ -1,4 +1,4 @@
-const require_textBlueprints = require("./textBlueprints-BhxAXpVE.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
 const require_shapeTypes = require("./shapeTypes-DwNTiXjG.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");

package/dist/index.d.ts

@@ -95,7 +95,7 @@ export { getSurfaceType, faceGeomType, faceOrientation, flipFaceOrientation, uvB
 export { exportSTEP, exportSTL, exportIGES, meshMultiLOD, type ShapeMesh, type EdgeMesh, type MeshOptions, type MultiLODMesh, } from './topology/meshFns.js';
 export { clearMeshCache, createMeshCache, type MeshCacheContext } from './topology/meshCache.js';
 export { toBufferGeometryData, toLineGeometryData, toGroupedBufferGeometryData, type BufferGeometryData, type LineGeometryData, type GroupedBufferGeometryData, type BufferGeometryGroup, toLODGeometryData, type LODGeometryData, } from './topology/threeHelpers.js';
-export { fuseAll, cutAll, booleanPipeline, type BooleanOptions, type BooleanPipelineStep, } from './topology/booleanFns.js';
+export { booleanPipeline, type BooleanOptions, type BooleanPipelineStep, } from './topology/booleanFns.js';
 export { fuseAllBisect, cutAllBisect, type BatchBisectResult, type BatchBisectTelemetry, } from './topology/booleanBatchFns.js';
 export { type PipelineOp } from './topology/booleanFns.js';
 export { checkBoolean } from './topology/booleanDiagnosticFns.js';
@@ -141,7 +141,7 @@ export type { Shapeable, WrappedMarker, FinderFn, FilletRadius, ChamferDistance,
 export { resolve, resolve3D } from './topology/apiTypes.js';
 export { box, cylinder, sphere, cone, torus, ellipsoid, line, circle, ellipse, helix, threePointArc, ellipseArc, bsplineApprox, bezier, tangentArc, wire, wireLoop, face, filledFace, subFace, polygon, vertex, compound, solid, offsetFace, sewShells, addHoles, type BoxOptions, type CylinderOptions, type SphereOptions, type ConeOptions, type TorusOptions, type EllipsoidOptions, type CircleOptions, type EllipseOptions, type HelixOptions, type EllipseArcOptions, } from './topology/primitiveFns.js';
 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 { translate, rotate, mirror, scale, clone, applyMatrix, composeTransforms, transformCopy, type TransformOp, type ComposedTransform, fuse, cut, fuseAll, cutAll, 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';

package/dist/sketching/compoundSketch.d.ts

@@ -49,6 +49,12 @@ export default class CompoundSketch implements SketchInterface {
     revolve(revolutionAxis?: PointInput, config?: {
         origin?: PointInput;
     }): Shape3D;
-    /** Loft between this compound sketch and another with matching sub-sketch counts. */
-    loftWith(otherCompound: this, loftConfig: LoftOptions): Shape3D;
+    /**
+     * Loft between this compound sketch and another with matching sub-sketch
+     * counts. The target must itself be a compound sketch — lofting a
+     * face-with-holes profile to a single-wire one has no defined meaning.
+     */
+    loftWith(otherCompound: SketchInterface | SketchInterface[], loftConfig?: LoftOptions): Shape3D;
+    /** Sweeping a face-with-holes profile has no single well-defined spine. */
+    sweepSketch(): Shape3D;
 }

package/dist/sketching/sketch.d.ts

@@ -41,7 +41,12 @@ export interface SketchInterface {
      *
      * Note that all sketches will be deleted by this operation
      */
-    loftWith(otherSketches: this | this[], loftConfig: LoftOptions, returnShell?: boolean): Shape3D;
+    loftWith(otherSketches: SketchInterface | SketchInterface[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
+    /**
+     * Sweep a profile sketch (built by the `sketchOnPlane` callback) along this
+     * sketch's wire path.
+     */
+    sweepSketch(sketchOnPlane: (plane: Plane, origin: Vec3) => SketchInterface, sweepConfig?: SweepOptions): Shape3D;
 }
 /**
  * Represent a closed or open wire profile with a default extrusion origin and direction.
@@ -137,7 +142,7 @@ export default class Sketch implements SketchInterface {
      * @remarks Consumes both this sketch and the one returned by `sketchOnPlane` —
      * calling either consumer twice throws on the second call.
      */
-    sweepSketch(sketchOnPlane: (plane: Plane, origin: Vec3) => this, sweepConfig?: SweepOptions): Shape3D;
+    sweepSketch(sketchOnPlane: (plane: Plane, origin: Vec3) => SketchInterface, sweepConfig?: SweepOptions): Shape3D;
     /** Loft between this sketch and another sketch (or an array of them)
      *
      * You can also define a `startPoint` for the loft (that will be placed
@@ -147,5 +152,5 @@ export default class Sketch implements SketchInterface {
      *
      * Note that all sketches will be deleted by this operation
      */
-    loftWith(otherSketches: this | this[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
+    loftWith(otherSketches: SketchInterface | SketchInterface[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
 }

package/dist/sketching/sketchFns.d.ts

@@ -5,12 +5,20 @@ import { LoftOptions } from '../operations/loftFns.js';
 import { OrientedFace, Shape3D, Wire } from '../core/shapeTypes.js';
 import { PlanarFace } from '../core/validityTypes.js';
 import { SketchData } from '../2d/blueprints/lib.js';
-import { default as Sketch } from './sketch.js';
+import { default as Sketch, SketchInterface } from './sketch.js';
 import { default as CompoundSketch } from './compoundSketch.js';
 /** Wrap SketchData into a Sketch instance. */
 export declare function wrapSketchData(data: SketchData): Sketch;
 /** Wrap an array of SketchData into a CompoundSketch. */
 export declare function wrapSketchDataArray(dataArr: SketchData[]): CompoundSketch;
+/**
+ * Collapse a sketch-like (the `SketchInterface | Sketches` union that
+ * `Drawing.sketchOnPlane` can return) to a single {@link Sketch} for use as a
+ * loft or sweep section. A single-wire profile passes through; a multi-piece
+ * profile keeps its first wire and disposes the rest, since loft/sweep sections
+ * are single wires.
+ */
+export declare function asSketch(sketchLike: SketchInterface): Sketch;
 /** Build a face from a sketch's closed planar wire. */
 export declare function sketchFace(sketch: Sketch): OrientedFace & PlanarFace;
 /** Return an independent clone of the sketch's wire. */
@@ -43,13 +51,13 @@ export declare function sketchExtrude(sketch: Sketch, extrusionDistance: number,
  * @remarks Consumes both this sketch and the one returned by `sketchOnPlane` —
  * calling either twice throws on the second call.
  */
-export declare function sketchSweep(sketch: Sketch, sketchOnPlane: (plane: Plane, origin: Vec3) => Sketch, sweepConfig?: SweepOptions): Shape3D;
+export declare function sketchSweep(sketch: Sketch, sketchOnPlane: (plane: Plane, origin: Vec3) => SketchInterface, sweepConfig?: SweepOptions): Shape3D;
 /**
  * Loft between this sketch and one or more other sketches.
  *
  * @remarks Consumes all input sketches — calling twice throws on the second call.
  */
-export declare function sketchLoft(sketch: Sketch, otherSketches: Sketch | Sketch[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
+export declare function sketchLoft(sketch: Sketch, otherSketches: SketchInterface | SketchInterface[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
 /** Build a face from a compound sketch (outer boundary with holes). */
 export declare function compoundSketchFace(sketch: CompoundSketch): OrientedFace & PlanarFace;
 /** Return all wires (outer + holes) combined into a compound shape. */
@@ -71,4 +79,4 @@ export declare function compoundSketchRevolve(sketch: CompoundSketch, revolution
     origin?: PointInput;
 }): Shape3D;
 /** Loft between two compound sketches with matching sub-sketch counts. */
-export declare function compoundSketchLoft(sketch: CompoundSketch, other: CompoundSketch, loftConfig: LoftOptions): Shape3D;
+export declare function compoundSketchLoft(sketch: CompoundSketch, other: CompoundSketch, loftConfig?: LoftOptions): Shape3D;

package/dist/sketching/sketches.d.ts

@@ -1,19 +1,38 @@
-import { PointInput } from '../core/types.js';
-import { ExtrusionProfile } from '../operations/extrudeUtils.js';
-import { Compound } from '../core/shapeTypes.js';
+import { PointInput, Vec3 } from '../core/types.js';
+import { ExtrusionProfile, SweepOptions } from '../operations/extrudeUtils.js';
+import { LoftOptions } from '../operations/loftFns.js';
+import { Plane } from '../core/planeTypes.js';
+import { Compound, Face, Shape3D } from '../core/shapeTypes.js';
 import { default as CompoundSketch } from './compoundSketch.js';
-import { default as Sketch } from './sketch.js';
+import { default as Sketch, SketchInterface } from './sketch.js';
 /**
  * Batch wrapper around multiple {@link Sketch} or {@link CompoundSketch} instances.
  *
  * Applies the same operation (extrude, revolve, etc.) to every contained sketch
  * and returns the results combined into a single compound shape.
  *
+ * Implements {@link SketchInterface} so it is interchangeable with a single
+ * {@link Sketch} in the chained `Drawing.sketchOnPlane(...).extrude()` style.
+ * Operations with no per-profile batch meaning (`face`, `loftWith`,
+ * `sweepSketch`) require a single contained profile and otherwise throw.
+ *
  * @category Sketching
  */
-export default class Sketches {
+export default class Sketches implements SketchInterface {
     sketches: Array<Sketch | CompoundSketch>;
     constructor(sketches: Array<Sketch | CompoundSketch>);
+    /**
+     * The sole contained {@link Sketch}, for operations that have no
+     * multi-profile meaning. Throws when there is more than one profile, or when
+     * the single profile is a compound (face-with-holes) sketch.
+     */
+    private soleSketch;
+    /** Build a face from the sole contained profile (see {@link Sketches.faces}). */
+    face(): Face;
+    /** Loft from the sole contained profile to one or more other sketches. */
+    loftWith(otherSketches: SketchInterface | SketchInterface[], loftConfig?: LoftOptions, returnShell?: boolean): Shape3D;
+    /** Sweep a profile along the sole contained sketch's wire. */
+    sweepSketch(sketchOnPlane: (plane: Plane, origin: Vec3) => SketchInterface, sweepConfig?: SweepOptions): Shape3D;
     /** Return all wires combined into a single compound shape. */
     wires(): Compound;
     /** Return all sketch faces combined into a single compound shape. */

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-BhxAXpVE.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
 const require_blueprintSketcher = require("./blueprintSketcher-ChpPo7tq.cjs");
-const require_drawFns = require("./drawFns-DWHuHfHQ.cjs");
+const require_drawFns = require("./drawFns-C766Umy1.cjs");
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/sketching.js

@@ -1,6 +1,6 @@
 import { n as BaseSketcher2d, t as BlueprintSketcher } from "./blueprintSketcher-CxFmYBvh.js";
-import { A as sketchEllipse, C as DrawingPen, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, T as Drawing, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-DiiBS6r0.js";
-import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, o as compoundSketchExtrude, p as sketchRevolve, s as compoundSketchFace, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-BK3idmq5.js";
+import { A as sketchEllipse, C as DrawingPen, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, T as Drawing, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-C63kOWvC.js";
+import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, o as compoundSketchExtrude, p as sketchRevolve, s as compoundSketchFace, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-CU7MHMR8.js";
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/text.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-BhxAXpVE.cjs");
-const require_textMetrics = require("./textMetrics-SaXWFfLN.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
+const require_textMetrics = require("./textMetrics-BYHtOFYW.cjs");
 exports.fontMetrics = require_textMetrics.fontMetrics;
 exports.getFont = require_textBlueprints.getFont;
 exports.loadFont = require_textBlueprints.loadFont;

package/dist/text.js

@@ -1,3 +1,3 @@
-import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-BK3idmq5.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-DSYHxQ3W.js";
+import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-CU7MHMR8.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-BDTWvvyd.js";
 export { fontMetrics, getFont, loadFont, sketchText, textBlueprints, textMetrics };

package/dist/{textBlueprints-BhxAXpVE.cjs → textBlueprints-CKFmYJHD.cjs}

@@ -58,7 +58,7 @@ opentype_js = __toESM(opentype_js, 1);
 * @see {@link Sketch} for single-wire profiles without holes.
 * @category Sketching
 */
-var CompoundSketch = class {
+var CompoundSketch = class CompoundSketch {
 	sketches;
 	constructor(sketches) {
 		if (sketches.length === 0) require_errors.bug("CompoundSketch", "Cannot create CompoundSketch with an empty array of sketches");
@@ -102,10 +102,19 @@ var CompoundSketch = class {
 	revolve(revolutionAxis, config = {}) {
 		return compoundSketchRevolve(this, revolutionAxis, config);
 	}
-	/** Loft between this compound sketch and another with matching sub-sketch counts. */
-	loftWith(otherCompound, loftConfig) {
+	/**
+	* Loft between this compound sketch and another with matching sub-sketch
+	* counts. The target must itself be a compound sketch — lofting a
+	* face-with-holes profile to a single-wire one has no defined meaning.
+	*/
+	loftWith(otherCompound, loftConfig = {}) {
+		if (Array.isArray(otherCompound) || !(otherCompound instanceof CompoundSketch)) return require_errors.bug("CompoundSketch.loftWith", "A compound (face-with-holes) sketch can only loft to another compound sketch with the same number of sub-sketches.");
 		return compoundSketchLoft(this, otherCompound, loftConfig);
 	}
+	/** Sweeping a face-with-holes profile has no single well-defined spine. */
+	sweepSketch() {
+		return require_errors.bug("CompoundSketch.sweepSketch", "Sweeping a compound (face-with-holes) profile is not supported — sweep its outer Sketch instead.");
+	}
 };
 //#endregion
 //#region src/sketching/sketchFns.ts
@@ -122,6 +131,25 @@ function wrapSketchData(data) {
 function wrapSketchDataArray(dataArr) {
 	return new CompoundSketch(dataArr.map(wrapSketchData));
 }
+/**
+* Collapse a sketch-like (the `SketchInterface | Sketches` union that
+* `Drawing.sketchOnPlane` can return) to a single {@link Sketch} for use as a
+* loft or sweep section. A single-wire profile passes through; a multi-piece
+* profile keeps its first wire and disposes the rest, since loft/sweep sections
+* are single wires.
+*/
+function asSketch(sketchLike) {
+	if (sketchLike instanceof Sketch) return sketchLike;
+	const pieces = sketchLike.sketches;
+	if (Array.isArray(pieces)) {
+		const [first, ...rest] = pieces;
+		if (first instanceof Sketch) {
+			for (const extra of rest) extra.delete();
+			return first;
+		}
+	}
+	require_errors.bug("asSketch", "Expected a single-wire profile to loft or sweep.");
+}
 /** Build a face from a sketch's closed planar wire. */
 function sketchFace(sketch) {
 	let face;
@@ -185,13 +213,7 @@ function sketchSweep(sketch, sketchOnPlane, sweepConfig = {}) {
 	const normal = require_vecOps.vecNormalize(require_vecOps.vecScale(require_curveFns.curveTangentAt(sketch.wire, 1e-9), -1));
 	const defaultDir = sketch.defaultDirection;
 	const xDir = require_vecOps.vecScale(require_vecOps.vecCross(normal, defaultDir), -1);
-	const result = sketchOnPlane(require_planeOps.createPlane([...startPoint], [...xDir], [...normal]), [...startPoint]);
-	let profile;
-	if ("sketches" in result && Array.isArray(result.sketches)) {
-		const pieces = result.sketches;
-		profile = pieces[0];
-		for (let i = 1; i < pieces.length; i++) pieces[i]?.delete();
-	} else profile = result;
+	const profile = asSketch(sketchOnPlane(require_planeOps.createPlane([...startPoint], [...xDir], [...normal]), [...startPoint]));
 	const config = {
 		forceProfileSpineOthogonality: true,
 		...sweepConfig
@@ -207,7 +229,7 @@ function sketchSweep(sketch, sketchOnPlane, sweepConfig = {}) {
 * @remarks Consumes all input sketches — calling twice throws on the second call.
 */
 function sketchLoft(sketch, otherSketches, loftConfig = {}, returnShell = false) {
-	const sketchArray = Array.isArray(otherSketches) ? [sketch, ...otherSketches] : [sketch, otherSketches];
+	const sketchArray = [sketch, ...(Array.isArray(otherSketches) ? otherSketches : [otherSketches]).map(asSketch)];
 	const shape = require_errors.unwrap(require_loftFns.loft(sketchArray.map((s) => s.wire), loftConfig, returnShell));
 	sketchArray.forEach((s) => {
 		s.delete();
@@ -268,7 +290,7 @@ function compoundSketchRevolve(sketch, revolutionAxis, { origin } = {}) {
 	return require_errors.unwrap(require_loftFns.revolve(compoundSketchFace(sketch), center, dir));
 }
 /** Loft between two compound sketches with matching sub-sketch counts. */
-function compoundSketchLoft(sketch, other, loftConfig) {
+function compoundSketchLoft(sketch, other, loftConfig = {}) {
 	if (sketch.sketches.length !== other.sketches.length) require_errors.bug("CompoundSketch.loftWith", "You need to loft with another compound with the same number of sketches");
 	const shells = sketch.sketches.map((base, cIndex) => {
 		const outer = require_arrayAccess.getAtOrThrow(other.sketches, cIndex);
@@ -436,6 +458,11 @@ var Sketch = class Sketch {
 * Applies the same operation (extrude, revolve, etc.) to every contained sketch
 * and returns the results combined into a single compound shape.
 *
+* Implements {@link SketchInterface} so it is interchangeable with a single
+* {@link Sketch} in the chained `Drawing.sketchOnPlane(...).extrude()` style.
+* Operations with no per-profile batch meaning (`face`, `loftWith`,
+* `sweepSketch`) require a single contained profile and otherwise throw.
+*
 * @category Sketching
 */
 var Sketches = class {
@@ -443,6 +470,30 @@ var Sketches = class {
 	constructor(sketches) {
 		this.sketches = sketches;
 	}
+	/**
+	* The sole contained {@link Sketch}, for operations that have no
+	* multi-profile meaning. Throws when there is more than one profile, or when
+	* the single profile is a compound (face-with-holes) sketch.
+	*/
+	soleSketch(op) {
+		if (this.sketches.length !== 1) require_errors.bug(`Sketches.${op}`, `Multiple profiles — ${op} each sub-sketch individually.`);
+		const only = require_arrayAccess.firstOrThrow(this.sketches);
+		if (!(only instanceof Sketch)) require_errors.bug(`Sketches.${op}`, `${op} is only supported on single-wire profiles.`);
+		return only;
+	}
+	/** Build a face from the sole contained profile (see {@link Sketches.faces}). */
+	face() {
+		if (this.sketches.length !== 1) require_errors.bug("Sketches.face", "Multiple profiles — use faces() to combine them.");
+		return require_arrayAccess.firstOrThrow(this.sketches).face();
+	}
+	/** Loft from the sole contained profile to one or more other sketches. */
+	loftWith(otherSketches, loftConfig, returnShell) {
+		return this.soleSketch("loftWith").loftWith(otherSketches, loftConfig, returnShell);
+	}
+	/** Sweep a profile along the sole contained sketch's wire. */
+	sweepSketch(sketchOnPlane, sweepConfig) {
+		return this.soleSketch("sweepSketch").sweepSketch(sketchOnPlane, sweepConfig);
+	}
 	/** Return all wires combined into a single compound shape. */
 	wires() {
 		return require_solidBuilders.makeCompound(this.sketches.map((s) => s instanceof Sketch ? s.wire : s.wires));

package/dist/{textBlueprints-BK3idmq5.js → textBlueprints-CU7MHMR8.js}

@@ -26,7 +26,7 @@ import opentype from "opentype.js";
 * @see {@link Sketch} for single-wire profiles without holes.
 * @category Sketching
 */
-var CompoundSketch = class {
+var CompoundSketch = class CompoundSketch {
 	sketches;
 	constructor(sketches) {
 		if (sketches.length === 0) bug("CompoundSketch", "Cannot create CompoundSketch with an empty array of sketches");
@@ -70,10 +70,19 @@ var CompoundSketch = class {
 	revolve(revolutionAxis, config = {}) {
 		return compoundSketchRevolve(this, revolutionAxis, config);
 	}
-	/** Loft between this compound sketch and another with matching sub-sketch counts. */
-	loftWith(otherCompound, loftConfig) {
+	/**
+	* Loft between this compound sketch and another with matching sub-sketch
+	* counts. The target must itself be a compound sketch — lofting a
+	* face-with-holes profile to a single-wire one has no defined meaning.
+	*/
+	loftWith(otherCompound, loftConfig = {}) {
+		if (Array.isArray(otherCompound) || !(otherCompound instanceof CompoundSketch)) return bug("CompoundSketch.loftWith", "A compound (face-with-holes) sketch can only loft to another compound sketch with the same number of sub-sketches.");
 		return compoundSketchLoft(this, otherCompound, loftConfig);
 	}
+	/** Sweeping a face-with-holes profile has no single well-defined spine. */
+	sweepSketch() {
+		return bug("CompoundSketch.sweepSketch", "Sweeping a compound (face-with-holes) profile is not supported — sweep its outer Sketch instead.");
+	}
 };
 //#endregion
 //#region src/sketching/sketchFns.ts
@@ -90,6 +99,25 @@ function wrapSketchData(data) {
 function wrapSketchDataArray(dataArr) {
 	return new CompoundSketch(dataArr.map(wrapSketchData));
 }
+/**
+* Collapse a sketch-like (the `SketchInterface | Sketches` union that
+* `Drawing.sketchOnPlane` can return) to a single {@link Sketch} for use as a
+* loft or sweep section. A single-wire profile passes through; a multi-piece
+* profile keeps its first wire and disposes the rest, since loft/sweep sections
+* are single wires.
+*/
+function asSketch(sketchLike) {
+	if (sketchLike instanceof Sketch) return sketchLike;
+	const pieces = sketchLike.sketches;
+	if (Array.isArray(pieces)) {
+		const [first, ...rest] = pieces;
+		if (first instanceof Sketch) {
+			for (const extra of rest) extra.delete();
+			return first;
+		}
+	}
+	bug("asSketch", "Expected a single-wire profile to loft or sweep.");
+}
 /** Build a face from a sketch's closed planar wire. */
 function sketchFace(sketch) {
 	let face;
@@ -153,13 +181,7 @@ function sketchSweep(sketch, sketchOnPlane, sweepConfig = {}) {
 	const normal = vecNormalize(vecScale(curveTangentAt(sketch.wire, 1e-9), -1));
 	const defaultDir = sketch.defaultDirection;
 	const xDir = vecScale(vecCross(normal, defaultDir), -1);
-	const result = sketchOnPlane(createPlane([...startPoint], [...xDir], [...normal]), [...startPoint]);
-	let profile;
-	if ("sketches" in result && Array.isArray(result.sketches)) {
-		const pieces = result.sketches;
-		profile = pieces[0];
-		for (let i = 1; i < pieces.length; i++) pieces[i]?.delete();
-	} else profile = result;
+	const profile = asSketch(sketchOnPlane(createPlane([...startPoint], [...xDir], [...normal]), [...startPoint]));
 	const config = {
 		forceProfileSpineOthogonality: true,
 		...sweepConfig
@@ -175,7 +197,7 @@ function sketchSweep(sketch, sketchOnPlane, sweepConfig = {}) {
 * @remarks Consumes all input sketches — calling twice throws on the second call.
 */
 function sketchLoft(sketch, otherSketches, loftConfig = {}, returnShell = false) {
-	const sketchArray = Array.isArray(otherSketches) ? [sketch, ...otherSketches] : [sketch, otherSketches];
+	const sketchArray = [sketch, ...(Array.isArray(otherSketches) ? otherSketches : [otherSketches]).map(asSketch)];
 	const shape = unwrap(loft(sketchArray.map((s) => s.wire), loftConfig, returnShell));
 	sketchArray.forEach((s) => {
 		s.delete();
@@ -236,7 +258,7 @@ function compoundSketchRevolve(sketch, revolutionAxis, { origin } = {}) {
 	return unwrap(revolve(compoundSketchFace(sketch), center, dir));
 }
 /** Loft between two compound sketches with matching sub-sketch counts. */
-function compoundSketchLoft(sketch, other, loftConfig) {
+function compoundSketchLoft(sketch, other, loftConfig = {}) {
 	if (sketch.sketches.length !== other.sketches.length) bug("CompoundSketch.loftWith", "You need to loft with another compound with the same number of sketches");
 	const shells = sketch.sketches.map((base, cIndex) => {
 		const outer = getAtOrThrow(other.sketches, cIndex);
@@ -404,6 +426,11 @@ var Sketch = class Sketch {
 * Applies the same operation (extrude, revolve, etc.) to every contained sketch
 * and returns the results combined into a single compound shape.
 *
+* Implements {@link SketchInterface} so it is interchangeable with a single
+* {@link Sketch} in the chained `Drawing.sketchOnPlane(...).extrude()` style.
+* Operations with no per-profile batch meaning (`face`, `loftWith`,
+* `sweepSketch`) require a single contained profile and otherwise throw.
+*
 * @category Sketching
 */
 var Sketches = class {
@@ -411,6 +438,30 @@ var Sketches = class {
 	constructor(sketches) {
 		this.sketches = sketches;
 	}
+	/**
+	* The sole contained {@link Sketch}, for operations that have no
+	* multi-profile meaning. Throws when there is more than one profile, or when
+	* the single profile is a compound (face-with-holes) sketch.
+	*/
+	soleSketch(op) {
+		if (this.sketches.length !== 1) bug(`Sketches.${op}`, `Multiple profiles — ${op} each sub-sketch individually.`);
+		const only = firstOrThrow(this.sketches);
+		if (!(only instanceof Sketch)) bug(`Sketches.${op}`, `${op} is only supported on single-wire profiles.`);
+		return only;
+	}
+	/** Build a face from the sole contained profile (see {@link Sketches.faces}). */
+	face() {
+		if (this.sketches.length !== 1) bug("Sketches.face", "Multiple profiles — use faces() to combine them.");
+		return firstOrThrow(this.sketches).face();
+	}
+	/** Loft from the sole contained profile to one or more other sketches. */
+	loftWith(otherSketches, loftConfig, returnShell) {
+		return this.soleSketch("loftWith").loftWith(otherSketches, loftConfig, returnShell);
+	}
+	/** Sweep a profile along the sole contained sketch's wire. */
+	sweepSketch(sketchOnPlane, sweepConfig) {
+		return this.soleSketch("sweepSketch").sweepSketch(sketchOnPlane, sweepConfig);
+	}
 	/** Return all wires combined into a single compound shape. */
 	wires() {
 		return makeCompound(this.sketches.map((s) => s instanceof Sketch ? s.wire : s.wires));

package/dist/{textMetrics-DSYHxQ3W.js → textMetrics-BDTWvvyd.js}

@@ -1,5 +1,5 @@
 import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
-import { g as wrapSketchData, i as Sketches, n as getFont, t as textBlueprints, v as CompoundSketch } from "./textBlueprints-BK3idmq5.js";
+import { g as wrapSketchData, i as Sketches, n as getFont, t as textBlueprints, v as CompoundSketch } from "./textBlueprints-CU7MHMR8.js";
 //#region src/text/sketchText.ts
 /**
 * Render text as 3D sketch outlines on a plane.

package/dist/{textMetrics-SaXWFfLN.cjs → textMetrics-BYHtOFYW.cjs}

@@ -1,4 +1,4 @@
-const require_textBlueprints = require("./textBlueprints-BhxAXpVE.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 //#region src/text/sketchText.ts
 /**

package/dist/topology/api.d.ts

@@ -56,6 +56,10 @@ export declare function transformCopy<T extends AnyShape<Dimension>>(shape: Shap
 export declare function fuse<T extends Shape3D>(a: Shapeable<T>, b: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
 /** Cut a tool from a base shape (boolean subtraction). */
 export declare function cut<T extends Shape3D>(base: Shapeable<T>, tool: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
+/** Fuse many 3D shapes (boolean union) in a single operation. */
+export declare function fuseAll<T extends Shape3D>(shapes: Shapeable<T>[], options?: booleans.BooleanOptions): Result<T>;
+/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
+export declare function cutAll<T extends Shape3D>(base: Shapeable<T>, tools: Shapeable<Shape3D>[], options?: booleans.BooleanOptions): Result<T>;
 /** Compute the intersection of two shapes (boolean common). */
 export declare function intersect<T extends Shape3D>(a: Shapeable<T>, b: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
 /** Section (cross-section) a shape with a plane. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.84.1",
+  "version": "18.86.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",
@@ -210,6 +210,7 @@
   ],
   "scripts": {
     "build": "vite build && node scripts/build-quick.js",
+    "build:site": "npm run build && npm run build --workspace=brepjs-bim && npm run build --workspace=brepjs-sheetmetal && npm run build --workspace=apps/playground && npm run build --workspace=apps/docs && mkdir -p apps/docs/.vitepress/dist/playground && cp -r apps/playground/dist/. apps/docs/.vitepress/dist/playground/",
     "dev": "vite build --watch",
     "prepublishOnly": "npm run build",
     "prepack": "bash scripts/validate-pack.sh",
@@ -243,7 +244,9 @@
     "docs:preview": "npm -C apps/docs run preview",
     "docs:extract-tests": "npx tsx scripts/extract-doc-tests.ts",
     "docs:render-images": "npx tsx scripts/render-doc-images.ts",
-    "gen:og": "bash scripts/gen-og.sh",
+    "docs:gen-hero": "npx tsx scripts/genHeroFrames.ts",
+    "docs:gen-images": "npx tsx scripts/genLandingImages.ts",
+    "gen:og": "node scripts/gen-og-docs.mjs && bash scripts/gen-og.sh",
     "test:docs": "npm run docs:extract-tests && vitest run --project occt-wasm tests/docs",
     "conformance:generate": "npx tsx scripts/generateConformance.ts",
     "sync:brepkit-types": "npx tsx scripts/sync-brepkit-types.ts",