brepjs 18.84.0 → 18.85.0

package/dist/{shapeTypes-BHoIVN7I.cjs → shapeTypes-DwNTiXjG.cjs}

@@ -8545,11 +8545,16 @@ function makeEllipse2d(cx, cy, major, minor, xDirX, xDirY, sense) {
 	return require_occtWasmAdapter.makeEllipse2d(cx, cy, major, minor, xDirX, xDirY, sense);
 }
 function makeEllipseArc2d(cx, cy, major, minor, start, end, xDirX, xDirY, sense) {
+	const ellipse = require_occtWasmAdapter.makeEllipse2d(cx, cy, major, minor, xDirX, xDirY, sense);
+	const ccw = sense !== false;
+	const tStart = ccw ? start : -start;
+	let tEnd = ccw ? end : -end;
+	if (tEnd < tStart - 1e-9) tEnd += 2 * Math.PI;
 	return {
 		__bk2d: "trimmed",
-		basis: require_occtWasmAdapter.makeEllipse2d(cx, cy, major, minor, xDirX, xDirY, sense),
-		tStart: start,
-		tEnd: end
+		basis: ellipse,
+		tStart,
+		tEnd
 	};
 }
 function makeBezier2d(points) {
@@ -8601,6 +8606,45 @@ function trimCurve2d(curve, start, end) {
 		tEnd: end
 	};
 }
+function reverseCurve2d(curve) {
+	const c = curve;
+	switch (c.__bk2d) {
+		case "line": {
+			const m = c;
+			m.ox += m.dx * m.len;
+			m.oy += m.dy * m.len;
+			m.dx = -m.dx;
+			m.dy = -m.dy;
+			break;
+		}
+		case "circle":
+		case "ellipse": {
+			const m = c;
+			m.sense = !m.sense;
+			break;
+		}
+		case "trimmed": {
+			const m = c;
+			[m.tStart, m.tEnd] = [m.tEnd, m.tStart];
+			break;
+		}
+		case "bezier": {
+			const m = c;
+			m.poles = [...m.poles].reverse();
+			break;
+		}
+		case "bspline": {
+			const m = c;
+			m.poles = [...m.poles].reverse();
+			const lo = m.knots[0];
+			const hi = m.knots[m.knots.length - 1];
+			if (lo !== void 0 && hi !== void 0) m.knots = m.knots.map((k) => lo + hi - k).reverse();
+			if (Array.isArray(m.weights)) m.weights = [...m.weights].reverse();
+			break;
+		}
+		default: break;
+	}
+}
 function copyCurve2d(curve) {
 	return JSON.parse(JSON.stringify(curve));
 }
@@ -9272,7 +9316,9 @@ function makeKernel2dOps(bk) {
 		getCurve2dBounds: (curve) => getCurve2dBounds(curve),
 		getCurve2dType: (curve) => getCurve2dType(curve),
 		trimCurve2d: (curve, start, end) => trimCurve2d(curve, start, end),
-		reverseCurve2d: (curve) => {},
+		reverseCurve2d: (curve) => {
+			reverseCurve2d(curve);
+		},
 		copyCurve2d: (curve) => copyCurve2d(curve),
 		offsetCurve2d: (curve, off) => offsetCurve2d(curve, off),
 		translateCurve2d: (curve, dx, dy) => translateCurve2d(curve, dx, dy),

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-FGsoRUZ4.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BgQ4HUQS.cjs");
-const require_drawFns = require("./drawFns-DwxukBbB.cjs");
+const require_textBlueprints = require("./textBlueprints-CKFmYJHD.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-ChpPo7tq.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-BgJ92ofq.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-NN_2dIb7.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-Dvp_j93V.js";
+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-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/{solidBuilders-C73RAr6j.cjs → solidBuilders-B_5FgvuK.cjs}

@@ -1,13 +1,13 @@
-const require_shapeTypes = require("./shapeTypes-BHoIVN7I.cjs");
+const require_shapeTypes = require("./shapeTypes-DwNTiXjG.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CJYc4A0j.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-a2i0YhGF.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-CEhhzLpI.cjs");
-const require_shapeFns = require("./shapeFns-C00nTg4m.cjs");
+const require_faceFns = require("./faceFns-DSdVqqVP.cjs");
+const require_shapeFns = require("./shapeFns-CeSEceUG.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-7QLWQwje.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-DvpxHHIm.cjs");
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.

package/dist/{solidBuilders-Bp_Gf3y_.js → solidBuilders-Bb5_uC7F.js}

@@ -1,13 +1,13 @@
-import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex, t as castShape } from "./shapeTypes-CL5wYLDw.js";
+import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex, t as castShape } from "./shapeTypes-BIcALNFv.js";
 import { A as ok, R as unwrap, 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 { f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-BtyNquQX.js";
+import { f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-0BIOC7YH.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { h as vecScale, t as vecAdd } from "./vecOps-SKPRvPH-.js";
 import { o as resolvePlane } from "./planeOps-DSjjtrjg.js";
-import { _ as cast, v as downcast } from "./faceFns-CfCwtCKM.js";
-import { _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-C0K2yQlH.js";
+import { _ as cast, v as downcast } from "./faceFns-CmhEEB-L.js";
+import { _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-B0lN3o3r.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { r as makeFace } from "./surfaceBuilders-DObQZa60.js";
+import { r as makeFace } from "./surfaceBuilders-BQx3TjMH.js";
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.

package/dist/{surfaceBuilders-DObQZa60.js → surfaceBuilders-BQx3TjMH.js}

@@ -1,6 +1,6 @@
-import { Z as getKernel, a as createEdge, o as createFace, p as isFace, u as createWire, w as isPlanarFace } from "./shapeTypes-CL5wYLDw.js";
+import { Z as getKernel, a as createEdge, o as createFace, p as isFace, u as createWire, w as isPlanarFace } from "./shapeTypes-BIcALNFv.js";
 import { A as ok, b as err, d as validationError, i as kernelError, v as andThen } from "./errors-DNWJsfVU.js";
-import { _ as cast, u as outerWire } from "./faceFns-CfCwtCKM.js";
+import { _ as cast, u as outerWire } from "./faceFns-CmhEEB-L.js";
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/{surfaceBuilders-7QLWQwje.cjs → surfaceBuilders-DvpxHHIm.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BHoIVN7I.cjs");
+const require_shapeTypes = require("./shapeTypes-DwNTiXjG.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_faceFns = require("./faceFns-CEhhzLpI.cjs");
+const require_faceFns = require("./faceFns-DSdVqqVP.cjs");
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/text.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-FGsoRUZ4.cjs");
-const require_textMetrics = require("./textMetrics-BZbM75gl.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-Dvp_j93V.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-rFF3uFYC.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-FGsoRUZ4.cjs → textBlueprints-CKFmYJHD.cjs}

@@ -29,18 +29,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_shapeTypes = require("./shapeTypes-BHoIVN7I.cjs");
+const require_shapeTypes = require("./shapeTypes-DwNTiXjG.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-CEhhzLpI.cjs");
-const require_curveFns = require("./curveFns-ZfGUUd8h.cjs");
+const require_faceFns = require("./faceFns-DSdVqqVP.cjs");
+const require_curveFns = require("./curveFns-D3k8aHIE.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-7QLWQwje.cjs");
-const require_solidBuilders = require("./solidBuilders-C73RAr6j.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BgQ4HUQS.cjs");
-const require_loftFns = require("./loftFns-D4xbMwPh.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-DvpxHHIm.cjs");
+const require_solidBuilders = require("./solidBuilders-B_5FgvuK.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-ChpPo7tq.cjs");
+const require_loftFns = require("./loftFns-C664R57e.cjs");
 let opentype_js = require("opentype.js");
 opentype_js = __toESM(opentype_js, 1);
 //#region src/sketching/compoundSketch.ts
@@ -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-Dvp_j93V.js → textBlueprints-CU7MHMR8.js}

@@ -1,15 +1,15 @@
-import { o as createFace, u as createWire } from "./shapeTypes-CL5wYLDw.js";
+import { o as createFace, u as createWire } from "./shapeTypes-BIcALNFv.js";
 import { A as ok, R as unwrap, b as err, h as bug, r as ioError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { d as vecNormalize, h as vecScale, r as vecCross } from "./vecOps-SKPRvPH-.js";
 import { n as createPlane } from "./planeOps-DSjjtrjg.js";
-import { v as downcast } from "./faceFns-CfCwtCKM.js";
-import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-BMvOjgAe.js";
+import { v as downcast } from "./faceFns-CmhEEB-L.js";
+import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-DT1yMgBI.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-DObQZa60.js";
-import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-Bp_Gf3y_.js";
-import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-BgJ92ofq.js";
-import { a as revolve, d as twistExtrude, o as complexExtrude, r as extrude, t as loft, u as sweep } from "./loftFns-BLwuVjwA.js";
+import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-BQx3TjMH.js";
+import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-Bb5_uC7F.js";
+import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-CxFmYBvh.js";
+import { a as revolve, d as twistExtrude, o as complexExtrude, r as extrude, t as loft, u as sweep } from "./loftFns-C8Ep9McS.js";
 import opentype from "opentype.js";
 //#region src/sketching/compoundSketch.ts
 /**
@@ -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-rFF3uFYC.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-Dvp_j93V.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-BZbM75gl.cjs → textMetrics-BYHtOFYW.cjs}

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