brepjs 18.6.0 → 18.14.3

package/dist/{drawFns-lUXjhTYL.js → drawFns-BsarLfUN.js}

@@ -1,20 +1,22 @@
-import { R as DisposalScope, X as getKernel, Y as _usingCtx, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-CN0GUoHr.js";
-import { A as ok, R as unwrap, T as isOk, b as err, d as validationError, h as bug, r as ioError, s as safeIndex, t as BrepErrorCode } from "./errors-DboJwVCf.js";
-import { M as cast, N as downcast, b as getEdges, c as normalAt, l as outerWire, n as faceCenter } from "./faceFns-NbWd8-iR.js";
-import { t as DEG2RAD } from "./constants-csSEYddm.js";
-import { r as toVec3 } from "./types--GD-LVc6.js";
-import { c as vecLength, d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-B-PCHgyB.js";
-import { a as planeToWorld, o as resolvePlane } from "./planeOps-sTrM3dcQ.js";
-import { m as offsetWire2D } from "./curveFns-DhqUp0EI.js";
-import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-tCIbjLs5.js";
-import { c as makeBSplineApproximation, d as makeEllipse, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-BVH2SL-z.js";
-import { S as Flatbush, _ as Blueprints, b as make2dOffset, c as roundedRectangleBlueprint, f as Sketch, g as CompoundBlueprint, h as organiseBlueprints, l as BaseSketcher2d, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D, u as BlueprintSketcher, v as chamferCurves, x as intersectCurves, y as filletCurves } from "./boolean2D-JvgjbESt.js";
-import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-S_Ht6gwX.js";
-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-BCoJbaQN.js";
-import { o as makeSolid, t as makeCompound } from "./solidBuilders-BuS5ByIl.js";
-import { t as cornerFinder } from "./cornerFinder-Zg7pf2s0.js";
-import { i as complexExtrude, l as twistExtrude, r as revolve, t as extrude } from "./extrudeFns-B9bVCt3C.js";
-import opentype from "opentype.js";
+import { R as DisposalScope, X as getKernel, Y as _usingCtx, a as createEdge, o as createFace, u as createWire } from "./shapeTypes-C--1jaT1.js";
+import { n as wasmIndex } from "./vec3-BRj3eI54.js";
+import { R as unwrap, h as bug, s as safeIndex } from "./errors-0fYW_YnO.js";
+import { o as getEdges } from "./topologyQueryFns-Dhf85ZBK.js";
+import { t as DEG2RAD } from "./constants-Ci5CA3aZ.js";
+import { r as toVec3 } from "./types-BIdk_GJY.js";
+import { d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-DVROrqTV.js";
+import { a as planeToWorld, o as resolvePlane } from "./planeOps-4i2qEraD.js";
+import { _ as downcast, c as normalAt, l as outerWire, n as faceCenter, p as uvBounds, u as pointOnSurface } from "./faceFns-BFWz17_E.js";
+import { c as curveStartPoint, m as offsetWire2D, r as curveIsClosed } from "./curveFns-B4tWuinR.js";
+import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-C5IWcxs9.js";
+import { c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, m as makeHelix, r as makeFace, s as assembleWire } from "./surfaceBuilders-CinmHCbZ.js";
+import { a as Blueprints, c as make2dOffset, i as CompoundBlueprint, l as intersectCurves, n as BaseSketcher2d, o as chamferCurves, s as filletCurves, u as Flatbush } from "./blueprintSketcher-xDsl9GXO.js";
+import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-vV2ONZwD.js";
+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-Dv45Evnu.js";
+import { t as cornerFinder } from "./cornerFinder-Dix2ghke.js";
+import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-Z7P0c012.js";
+import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-Do6xNsLt.js";
+import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-CUzI5RKS.js";
 //#region src/2d/lib/stitching.ts
 /**
 * Group a flat list of curves into connected chains by matching endpoints.
@@ -45,11 +47,11 @@ var stitchCurves = (curves, precision = 1e-7) => {
 		let maxLoops = curves.length;
 		while (true) {
 			if (maxLoops-- < 0) bug("stitchCurves", "Infinite loop detected");
-			const [x, y] = connectedCurves[connectedCurves.length - 1].lastPoint;
+			const [x, y] = wasmIndex(connectedCurves, connectedCurves.length - 1).lastPoint;
 			const neighbors = startPoints.search(x - precision, y - precision, x + precision, y + precision);
 			const indexDistance = (otherIndex) => Math.abs((currentIndex - otherIndex) % curves.length);
 			const potentialNextCurves = neighbors.filter((neighborIndex) => !visited.has(neighborIndex)).map((neighborIndex) => [
-				curves[neighborIndex],
+				wasmIndex(curves, neighborIndex),
 				neighborIndex,
 				indexDistance(neighborIndex)
 			]).sort(([, , a], [, , b]) => a - b);
@@ -57,7 +59,7 @@ var stitchCurves = (curves, precision = 1e-7) => {
 				stitchedCurves.push(connectedCurves);
 				break;
 			}
-			const [nextCurve, nextCurveIndex] = potentialNextCurves[0];
+			const [nextCurve, nextCurveIndex] = wasmIndex(potentialNextCurves, 0);
 			connectedCurves.push(nextCurve);
 			visited.add(nextCurveIndex);
 			currentIndex = nextCurveIndex;
@@ -66,172 +68,6 @@ var stitchCurves = (curves, precision = 1e-7) => {
 	return stitchedCurves;
 };
 //#endregion
-//#region src/sketching/compoundSketch.ts
-var guessFaceFromWires = (wires) => {
-	const wireShapes = wires.map((w) => w.wrapped);
-	const newFace = unwrap(cast(getKernel().fillSurface(wireShapes)));
-	if (!isFace(newFace)) bug("guessFaceFromWires", "Failed to create a face");
-	return newFace;
-};
-var fixWire = (wire, baseFace) => {
-	return createWire(getKernel().fixWireOnFace(wire.wrapped, baseFace.wrapped, 1e-9));
-};
-var faceFromWires = (wires) => {
-	let baseFace;
-	let holeWires;
-	const faceResult = makeFace(firstOrThrow(wires));
-	if (isOk(faceResult)) {
-		baseFace = faceResult.value;
-		holeWires = wires.slice(1);
-	} else {
-		baseFace = guessFaceFromWires(wires);
-		holeWires = wires.slice(1).map((w) => fixWire(w, baseFace));
-	}
-	return addHolesInFace(baseFace, holeWires);
-};
-var solidFromShellGenerator = (sketches, shellGenerator) => {
-	const shells = [];
-	const startWires = [];
-	const endWires = [];
-	sketches.forEach((sketch) => {
-		const [shell, startWire, endWire] = unwrap(shellGenerator(sketch));
-		shells.push(shell);
-		startWires.push(startWire);
-		endWires.push(endWire);
-	});
-	const startFace = faceFromWires(startWires);
-	const endFace = faceFromWires(endWires);
-	return unwrap(makeSolid([
-		startFace,
-		...shells,
-		endFace
-	]));
-};
-/**
-* Represent a face with holes as a group of sketches (one outer + zero or more inner).
-*
-* All contained sketches must share the same base surface. The first sketch is
-* treated as the outer boundary; subsequent sketches define holes.
-*
-* Typically produced from a {@link CompoundBlueprint} via `sketchOnPlane`.
-*
-* @see {@link Sketch} for single-wire profiles without holes.
-* @category Sketching
-*/
-var CompoundSketch = class {
-	sketches;
-	constructor(sketches) {
-		if (sketches.length === 0) bug("CompoundSketch", "Cannot create CompoundSketch with an empty array of sketches");
-		this.sketches = sketches;
-	}
-	/** Release all kernel resources held by every sub-sketch. */
-	delete() {
-		this.sketches.forEach((sketch) => {
-			sketch.delete();
-		});
-	}
-	/** Get the outer boundary sketch (the first in the array). */
-	get outerSketch() {
-		return firstOrThrow(this.sketches);
-	}
-	/** Get the hole sketches (all but the first). */
-	get innerSketches() {
-		return this.sketches.slice(1);
-	}
-	/** Return all wires (outer + holes) combined into a compound shape. */
-	get wires() {
-		return makeCompound(this.sketches.map((s) => s.wire));
-	}
-	/** Build a face from the outer boundary with inner wires subtracted as holes. */
-	face() {
-		return addHolesInFace(this.outerSketch.face(), this.innerSketches.map((s) => s.wire));
-	}
-	/**
-	* Extrude the compound face (with holes) along the default or given direction.
-	*
-	* Supports twist and profile extrusions. For twist/profile modes each
-	* sub-sketch is extruded as a shell, then capped into a solid.
-	*/
-	extrude(extrusionDistance, { extrusionDirection, extrusionProfile, twistAngle, origin } = {}) {
-		const extrusionVec = vecScale(vecNormalize(extrusionDirection ? toVec3(extrusionDirection) : this.outerSketch.defaultDirection), extrusionDistance);
-		let result;
-		if (extrusionProfile && !twistAngle) result = solidFromShellGenerator(this.sketches, (sketch) => complexExtrude(sketch.wire, origin ? toVec3(origin) : this.outerSketch.defaultOrigin, extrusionVec, extrusionProfile, true));
-		else if (twistAngle) result = solidFromShellGenerator(this.sketches, (sketch) => twistExtrude(sketch.wire, twistAngle, origin ? toVec3(origin) : this.outerSketch.defaultOrigin, extrusionVec, extrusionProfile, true));
-		else result = unwrap(extrude(this.face(), extrusionVec));
-		return result;
-	}
-	/**
-	* Revolves the drawing on an axis (defined by its direction and an origin
-	* (defaults to the sketch origin)
-	*/
-	revolve(revolutionAxis, { origin } = {}) {
-		const center = origin ? toVec3(origin) : this.outerSketch.defaultOrigin;
-		const dir = revolutionAxis ? toVec3(revolutionAxis) : [
-			0,
-			0,
-			1
-		];
-		return unwrap(revolve(this.face(), center, dir));
-	}
-	/** Loft between this compound sketch and another with matching sub-sketch counts. */
-	loftWith(otherCompound, loftConfig) {
-		if (this.sketches.length !== otherCompound.sketches.length) bug("CompoundSketch.loftWith", "You need to loft with another compound with the same number of sketches");
-		const shells = this.sketches.map((base, cIndex) => {
-			const outer = getAtOrThrow(otherCompound.sketches, cIndex);
-			const loftOpts = {};
-			if (loftConfig.ruled !== void 0) loftOpts.ruled = loftConfig.ruled;
-			return base.clone().loftWith(outer.clone(), loftOpts, true);
-		});
-		const baseFace = createFace(unwrap(downcast(this.face().wrapped)));
-		shells.push(baseFace, otherCompound.face());
-		return unwrap(makeSolid(shells));
-	}
-};
-//#endregion
-//#region src/sketching/sketches.ts
-/**
-* 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.
-*
-* @category Sketching
-*/
-var Sketches = class {
-	sketches;
-	constructor(sketches) {
-		this.sketches = sketches;
-	}
-	/** Return all wires combined into a single compound shape. */
-	wires() {
-		return makeCompound(this.sketches.map((s) => s instanceof Sketch ? s.wire : s.wires));
-	}
-	/** Return all sketch faces combined into a single compound shape. */
-	faces() {
-		return makeCompound(this.sketches.map((s) => s.face()));
-	}
-	/** Extrudes the sketch to a certain distance (along the default direction
-	* and origin of the sketch).
-	*
-	* You can define another extrusion direction or origin,
-	*
-	* It is also possible to twist extrude with an angle (in degrees), or to
-	* give a profile to the extrusion (the endFactor will scale the face, and
-	* the profile will define how the scale is applied (either linearly or with
-	* a s-shape).
-	*/
-	extrude(extrusionDistance, extrusionConfig = {}) {
-		return makeCompound(this.sketches.map((s) => s.extrude(extrusionDistance, extrusionConfig)));
-	}
-	/**
-	* Revolves the drawing on an axis (defined by its direction and an origin
-	* (defaults to the sketch origin)
-	*/
-	revolve(revolutionAxis, config) {
-		return makeCompound(this.sketches.map((s) => s.revolve(revolutionAxis, config)));
-	}
-};
-//#endregion
 //#region src/sketching/sketcher.ts
 /**
 * Build 2D wire profiles on a 3D plane using a builder-pen API.
@@ -276,14 +112,14 @@ var Sketcher = class extends BaseSketcher2d {
 	}
 	buildWire() {
 		try {
-			var _usingCtx$3 = _usingCtx();
+			var _usingCtx$4 = _usingCtx();
 			if (!this.pendingCurves.length) bug("Sketcher.buildWire", "No lines to convert into a wire");
-			const scope = _usingCtx$3.u(new DisposalScope());
+			const scope = _usingCtx$4.u(new DisposalScope());
 			return unwrap(assembleWire(curvesAsEdgesOnPlane(this.pendingCurves, this.plane).map((e) => scope.register(e))));
 		} catch (_) {
-			_usingCtx$3.e = _;
+			_usingCtx$4.e = _;
 		} finally {
-			_usingCtx$3.d();
+			_usingCtx$4.d();
 		}
 	}
 	/** Finish drawing and return the open-wire Sketch (does not close the path). */
@@ -329,6 +165,122 @@ var Sketcher = class extends BaseSketcher2d {
 	}
 };
 //#endregion
+//#region src/sketching/faceSketcher.ts
+/**
+* The FaceSketcher allows you to sketch on a face that is not planar, for
+* instance the sides of a cylinder.
+*
+* The coordinates passed to the methods corresponds to normalised distances on
+* this surface, between 0 and 1 in both direction.
+*
+* Note that if you are drawing on a closed surface (typically a revolution
+* surface or a cylinder), the first parameters represents the angle and can be
+* smaller than 0 or bigger than 1.
+*
+* @category Sketching
+*/
+var FaceSketcher = class extends BaseSketcher2d {
+	face;
+	_bounds;
+	constructor(face, origin = [0, 0]) {
+		super(origin);
+		this.face = createFace(unwrap(downcast(face.wrapped)));
+		this._bounds = uvBounds(face);
+	}
+	_convertToUV([x, y]) {
+		const { uMin, uMax, vMin, vMax } = this._bounds;
+		return [uMin + x * (uMax - uMin), vMin + y * (vMax - vMin)];
+	}
+	_convertFromUV([u, v]) {
+		const { uMin, uMax, vMin, vMax } = this._bounds;
+		return [(u - uMin) / (uMax - uMin), (v - vMin) / (vMax - vMin)];
+	}
+	_adaptSurface() {
+		return getKernel().extractSurfaceFromFace(this.face.wrapped);
+	}
+	/**
+	* @ignore
+	*/
+	buildWire() {
+		const kernel = getKernel();
+		const geomSurf = this._adaptSurface();
+		const wire = unwrap(assembleWire(this.pendingCurves.map((curve) => {
+			return createEdge(kernel.buildEdgeOnSurface(curve.wrapped, geomSurf));
+		})));
+		kernel.buildCurves3d(wire.wrapped);
+		return wire;
+	}
+	/** Finish drawing and return the resulting {@link Sketch} (does not close the path). */
+	done() {
+		try {
+			var _usingCtx$3 = _usingCtx();
+			const scope = _usingCtx$3.u(new DisposalScope());
+			const wire = this.buildWire();
+			const sketch = new Sketch(wire);
+			if (curveIsClosed(wire)) {
+				const face = scope.register(sketch.clone().face());
+				const origin = pointOnSurface(face, .5, .5);
+				const direction = vecScale(normalAt(face), -1);
+				sketch.defaultOrigin = [
+					origin[0],
+					origin[1],
+					origin[2]
+				];
+				sketch.defaultDirection = [
+					direction[0],
+					direction[1],
+					direction[2]
+				];
+			} else {
+				const startPoint = curveStartPoint(wire);
+				const normal = normalAt(this.face, [
+					startPoint[0],
+					startPoint[1],
+					startPoint[2]
+				]);
+				sketch.defaultOrigin = [
+					startPoint[0],
+					startPoint[1],
+					startPoint[2]
+				];
+				sketch.defaultDirection = [
+					normal[0],
+					normal[1],
+					normal[2]
+				];
+			}
+			sketch.baseFace = this.face;
+			return sketch;
+		} catch (_) {
+			_usingCtx$3.e = _;
+		} finally {
+			_usingCtx$3.d();
+		}
+	}
+	/** Close the path with a straight line to the start point and return the Sketch. */
+	close() {
+		this._closeSketch();
+		return this.done();
+	}
+	/** Close the path by mirroring all curves about the line from first to last point. */
+	closeWithMirror() {
+		this._closeWithMirror();
+		return this.close();
+	}
+	/**
+	* Close the path and apply a custom corner treatment between the last and first segments.
+	*
+	* @param radius - Fillet/chamfer radius, or a custom corner function.
+	* @param mode - Corner treatment type.
+	* @returns The closed {@link Sketch}.
+	*/
+	closeWithCustomCorner(radius, mode = "fillet") {
+		this._closeSketch();
+		this._customCornerLastWithFirst(radius, mode);
+		return this.done();
+	}
+};
+//#endregion
 //#region src/sketching/cannedSketches.ts
 /**
 * Create a circular Sketch on a given plane.
@@ -778,7 +730,7 @@ function offsetBlueprint(blueprint, offset, offsetConfig = {}) {
 	const prunedCurves = splitCurves.filter((curve) => {
 		const [[xMin, yMin], [xMax, yMax]] = curve.boundingBox.bounds;
 		return !originalIndex.search(xMin - absOffset, yMin - absOffset, xMax + absOffset, yMax + absOffset).some((idx) => {
-			return blueprint.curves[idx].distanceFrom(curve) < absOffset - PRECISION_OFFSET;
+			return wasmIndex(blueprint.curves, idx).distanceFrom(curve) < absOffset - PRECISION_OFFSET;
 		});
 	});
 	if (!prunedCurves.length) return null;
@@ -903,174 +855,7 @@ function chamfer2D(shape, radius, finder) {
 	return modifyCorner2D(chamferCurves, shape, radius, finder);
 }
 //#endregion
-//#region src/sketching/sketchUtils.ts
-/** Wrap SketchData into a Sketch instance. */
-function wrapSketchData(data) {
-	const opts = {};
-	if (data.defaultOrigin) opts.defaultOrigin = data.defaultOrigin;
-	if (data.defaultDirection) opts.defaultDirection = data.defaultDirection;
-	const sketch = new Sketch(data.wire, opts);
-	if (data.baseFace) sketch.baseFace = data.baseFace;
-	return sketch;
-}
-/** Wrap an array of SketchData into a CompoundSketch. */
-function wrapSketchDataArray(dataArr) {
-	return new CompoundSketch(dataArr.map(wrapSketchData));
-}
-//#endregion
-//#region src/text/textBlueprints.ts
-var FONT_REGISTER = {};
-/**
-* Load and register an OpenType/TrueType font for use with text drawing functions.
-*
-* The font is fetched (if a URL string) or parsed (if an ArrayBuffer) and
-* stored in an internal registry keyed by `fontFamily`. The first font loaded
-* is also registered as `'default'`.
-*
-* @param fontPath - URL string or raw ArrayBuffer of the font file.
-* @param fontFamily - Registry key for later retrieval (defaults to `'default'`).
-* @param force - If true, overwrite a previously loaded font with the same key.
-* @returns The parsed opentype.js Font object.
-*/
-async function loadFont(fontPath, fontFamily = "default", force = false) {
-	if (!force && FONT_REGISTER[fontFamily]) return ok(FONT_REGISTER[fontFamily]);
-	let fontData;
-	if (typeof fontPath === "string") {
-		let response;
-		try {
-			response = await fetch(fontPath);
-		} catch (e) {
-			return err(ioError(BrepErrorCode.FONT_FETCH_FAILED, `Failed to fetch font from ${fontPath}: ${e instanceof Error ? e.message : String(e)}`, e));
-		}
-		if (!response.ok) return err(ioError(BrepErrorCode.FONT_FETCH_FAILED, `Failed to fetch font from ${fontPath}: HTTP ${response.status} ${response.statusText}`));
-		fontData = await response.arrayBuffer();
-	} else fontData = fontPath;
-	let font;
-	try {
-		font = opentype.parse(fontData);
-	} catch (e) {
-		return err(ioError(BrepErrorCode.FONT_PARSE_FAILED, `Failed to parse font data: ${e instanceof Error ? e.message : String(e)}`, e));
-	}
-	const typedFont = font;
-	FONT_REGISTER[fontFamily] = typedFont;
-	if (!FONT_REGISTER["default"]) FONT_REGISTER["default"] = typedFont;
-	return ok(typedFont);
-}
-/**
-* Retrieve a previously loaded font by family name.
-*
-* @param fontFamily - Registry key (defaults to `'default'`).
-* @returns The opentype.js Font object, or `undefined` if not loaded.
-*/
-var getFont = (fontFamily = "default") => {
-	return FONT_REGISTER[fontFamily];
-};
-var sketchFontCommands = function* (commands) {
-	let sk = null;
-	let lastPoint = null;
-	for (const command of commands) {
-		if (command.type === "Z") {
-			if (sk) yield sk.close();
-			sk = null;
-			continue;
-		}
-		const p = [-command.x, command.y];
-		if (command.type === "M") {
-			if (sk) yield sk.done();
-			sk = new BlueprintSketcher();
-			sk.movePointerTo(p);
-			lastPoint = p;
-			continue;
-		}
-		if (lastPoint && Math.abs(p[0] - lastPoint[0]) < 1e-9 && Math.abs(p[1] - lastPoint[1]) < 1e-9) continue;
-		if (command.type === "L") sk?.lineTo(p);
-		if (command.type === "C") sk?.cubicBezierCurveTo(p, [-command.x1, command.y1], [-command.x2, command.y2]);
-		if (command.type === "Q") sk?.quadraticBezierCurveTo(p, [-command.x1, command.y1]);
-		lastPoint = p;
-	}
-};
-/**
-* Convert a text string into 2D Blueprints using a loaded font.
-*
-* Each glyph outline is traced as a series of line/bezier curves, then
-* organised into a {@link Blueprints} collection (outer contours + holes).
-*
-* @param text - The string to render.
-* @returns A Blueprints instance representing the text outlines.
-*
-* @remarks Requires a font to be loaded via {@link loadFont} before use.
-*/
-function textBlueprints(text, { startX = 0, startY = 0, fontSize = 16, fontFamily = "default" } = {}) {
-	let font = getFont(fontFamily);
-	if (!font) font = getFont();
-	if (!font) bug("text", "No fonts loaded. Call loadFont() before using text functions.");
-	const writtenText = font.getPath(text, -startX, -startY, fontSize);
-	return organiseBlueprints(Array.from(sketchFontCommands(writtenText.commands))).mirror([0, 0]);
-}
-/**
-* Render text as 3D sketch outlines on a plane.
-*
-* Combines {@link textBlueprints} with `sketchOnPlane` to produce a
-* {@link Sketches} collection that can be extruded, revolved, etc.
-*
-* @param text - The string to render.
-* @param textConfig - Font size, family, and start position.
-* @param planeConfig - Plane name / origin to sketch on (defaults to XY at origin).
-* @returns A {@link Sketches} collection of the text outlines.
-*
-* @example
-* ```ts
-* await loadFont("/fonts/Roboto.ttf");
-* const textSketches = sketchText("Hello", { fontSize: 24 });
-* const solid = textSketches.extrude(2);
-* ```
-*/
-function sketchText(text, textConfig, planeConfig = {}) {
-	const textBp = textBlueprints(text, textConfig);
-	return new Sketches((typeof planeConfig.plane === "string" || planeConfig.plane === void 0 ? textBp.sketchOnPlane(planeConfig.plane, planeConfig.origin) : textBp.sketchOnPlane(planeConfig.plane)).map((item) => Array.isArray(item) ? new CompoundSketch(item.map(wrapSketchData)) : wrapSketchData(item)));
-}
-/**
-* Measure the dimensions of a text string without generating geometry.
-*
-* Requires a font to be loaded via {@link loadFont} first.
-*/
-function textMetrics(text, options) {
-	const fontSize = options?.fontSize ?? 1;
-	const font = getFont(options?.fontFamily);
-	if (!font) return err(validationError(BrepErrorCode.NO_FONT_LOADED, "No font loaded. Call loadFont() first.", void 0, void 0, "Load a font with loadFont() before calling textMetrics()"));
-	const width = font.getAdvanceWidth(text, fontSize);
-	const scale = fontSize / font.unitsPerEm;
-	const ascender = font.ascender * scale;
-	const descender = font.descender * scale;
-	return ok({
-		width,
-		height: ascender - descender,
-		ascender,
-		descender
-	});
-}
-/**
-* Retrieve font-level metrics without referencing specific text.
-*
-* Requires a font to be loaded via {@link loadFont} first.
-*/
-function fontMetrics(options) {
-	const fontSize = options?.fontSize ?? 1;
-	const font = getFont(options?.fontFamily);
-	if (!font) return err(validationError(BrepErrorCode.NO_FONT_LOADED, "No font loaded. Call loadFont() first.", void 0, void 0, "Load a font with loadFont() before calling fontMetrics()"));
-	const scale = fontSize / font.unitsPerEm;
-	const ascender = font.ascender * scale;
-	const descender = font.descender * scale;
-	const lineGap = (font.tables?.os2?.sTypoLineGap ?? 0) * scale;
-	return ok({
-		ascender,
-		descender,
-		unitsPerEm: font.unitsPerEm,
-		lineHeight: ascender - descender + lineGap
-	});
-}
-//#endregion
-//#region src/sketching/draw.ts
+//#region src/sketching/drawing.ts
 function wrapBlueprintResult(shape, result) {
 	if (shape instanceof Blueprint) return wrapSketchData(result);
 	else if (shape instanceof CompoundBlueprint) return wrapSketchDataArray(result);
@@ -1253,6 +1038,21 @@ var Drawing = class Drawing {
 	}
 };
 /**
+* Deserializes a drawing from a string. String is expected to be in the format
+* generated by `Drawing.serialize()`.
+*/
+function deserializeDrawing(data) {
+	function deserializeHelper(json) {
+		if (json["type"] === "CompoundBlueprint") return new CompoundBlueprint(json["blueprints"].map(deserializeHelper));
+		else if (json["type"] === "Blueprints") return new Blueprints(json["blueprints"].map(deserializeHelper));
+		else if (json["type"] === "Blueprint") return new Blueprint(json["curves"].map((c) => deserializeCurve2D(c)));
+		else bug("Drawing.deserialize", "Unknown shape type for deserialization");
+	}
+	return new Drawing(deserializeHelper(JSON.parse(data)));
+}
+//#endregion
+//#region src/sketching/drawingPen.ts
+/**
 * DrawingPen is a helper class to draw in 2D. It is used to create drawings
 * by exposing a builder interface. It is not a drawing itself, but it can be
 * used to create a drawing.
@@ -1294,19 +1094,6 @@ var DrawingPen = class extends BaseSketcher2d {
 	}
 };
 /**
-* Deserializes a drawing from a string. String is expected to be in the format
-* generated by `Drawing.serialize()`.
-*/
-function deserializeDrawing(data) {
-	function deserializeHelper(json) {
-		if (json["type"] === "CompoundBlueprint") return new CompoundBlueprint(json["blueprints"].map(deserializeHelper));
-		else if (json["type"] === "Blueprints") return new Blueprints(json["blueprints"].map(deserializeHelper));
-		else if (json["type"] === "Blueprint") return new Blueprint(json["curves"].map((c) => deserializeCurve2D(c)));
-		else bug("Drawing.deserialize", "Unknown shape type for deserialization");
-	}
-	return new Drawing(deserializeHelper(JSON.parse(data)));
-}
-/**
 * Creates a drawing pen to programatically draw in 2D.
 *
 * @category Drawing
@@ -1316,6 +1103,8 @@ function draw(initialPoint) {
 	if (initialPoint) pen.movePointerTo(initialPoint);
 	return pen;
 }
+//#endregion
+//#region src/sketching/drawingFactories.ts
 /**
 * Creates the `Drawing` of a rectangle with (optional) rounded corners.
 *
@@ -1425,275 +1214,6 @@ var drawParametricFunction = (func, { pointsCount = 400, start = 0, stop = 1, cl
 	}), approximationConfig, { closeShape });
 };
 //#endregion
-//#region src/projection/projectionPlanes.ts
-/** Lookup table mapping each {@link ProjectionPlane} to its camera configuration. */
-var PROJECTION_PLANES = {
-	XY: {
-		dir: [
-			0,
-			0,
-			1
-		],
-		xAxis: [
-			1,
-			0,
-			0
-		]
-	},
-	XZ: {
-		dir: [
-			0,
-			-1,
-			0
-		],
-		xAxis: [
-			1,
-			0,
-			0
-		]
-	},
-	YZ: {
-		dir: [
-			1,
-			0,
-			0
-		],
-		xAxis: [
-			0,
-			1,
-			0
-		]
-	},
-	YX: {
-		dir: [
-			0,
-			0,
-			-1
-		],
-		xAxis: [
-			0,
-			1,
-			0
-		]
-	},
-	ZX: {
-		dir: [
-			0,
-			1,
-			0
-		],
-		xAxis: [
-			0,
-			0,
-			1
-		]
-	},
-	ZY: {
-		dir: [
-			-1,
-			0,
-			0
-		],
-		xAxis: [
-			0,
-			0,
-			1
-		]
-	},
-	front: {
-		dir: [
-			0,
-			-1,
-			0
-		],
-		xAxis: [
-			1,
-			0,
-			0
-		]
-	},
-	back: {
-		dir: [
-			0,
-			1,
-			0
-		],
-		xAxis: [
-			-1,
-			0,
-			0
-		]
-	},
-	right: {
-		dir: [
-			-1,
-			0,
-			0
-		],
-		xAxis: [
-			0,
-			-1,
-			0
-		]
-	},
-	left: {
-		dir: [
-			1,
-			0,
-			0
-		],
-		xAxis: [
-			0,
-			1,
-			0
-		]
-	},
-	bottom: {
-		dir: [
-			0,
-			0,
-			1
-		],
-		xAxis: [
-			1,
-			0,
-			0
-		]
-	},
-	top: {
-		dir: [
-			0,
-			0,
-			-1
-		],
-		xAxis: [
-			1,
-			0,
-			0
-		]
-	}
-};
-/** Type guard — check if a value is a valid {@link ProjectionPlane} name. */
-function isProjectionPlane(plane) {
-	return typeof plane === "string" && plane in PROJECTION_PLANES;
-}
-//#endregion
-//#region src/projection/makeProjectedEdges.ts
-var getEdgesFromOc = (shape) => {
-	if (shape.IsNull()) return [];
-	return getEdges(castShape(shape));
-};
-/**
-* Project a 3D shape onto a 2D plane using hidden-line removal (HLR).
-*
-* @param camera - Camera defining the projection plane.
-* @param withHiddenLines - If `true`, also returns hidden (occluded) edges.
-* @returns Separate arrays of visible and hidden projected edges.
-*/
-function makeProjectedEdges(shape, camera, withHiddenLines = true) {
-	const projected = getKernel().projectEdges(shape.wrapped, [...camera.position], [...camera.direction], [...camera.xAxis]);
-	return {
-		visible: [
-			...getEdgesFromOc(projected.visible.sharp),
-			...getEdgesFromOc(projected.visible.smooth),
-			...getEdgesFromOc(projected.visible.outline)
-		],
-		hidden: withHiddenLines ? [
-			...getEdgesFromOc(projected.hidden.sharp),
-			...getEdgesFromOc(projected.hidden.smooth),
-			...getEdgesFromOc(projected.hidden.outline)
-		] : []
-	};
-}
-//#endregion
-//#region src/projection/cameraFns.ts
-/**
-* Create a camera from position, direction, and an optional X-axis.
-*
-* If `xAxis` is omitted, it is derived automatically from the direction.
-*
-* @param position - Camera position in world coordinates.
-* @param direction - View direction (camera looks along this vector).
-* @param xAxis - Optional horizontal axis; derived automatically if not provided.
-* @returns `Result<Camera>` -- an error if direction is zero-length.
-*/
-function createCamera(position = [
-	0,
-	0,
-	0
-], direction = [
-	0,
-	0,
-	1
-], xAxis) {
-	if (vecLength(direction) < 1e-12) return err(validationError("CAMERA_ZERO_DIRECTION", "Camera direction cannot be a zero-length vector"));
-	let resolvedXAxis;
-	if (xAxis) resolvedXAxis = vecNormalize(xAxis);
-	else {
-		let cross = vecCross([
-			0,
-			0,
-			1
-		], direction);
-		if (vecLength(cross) < 1e-12) cross = vecCross([
-			0,
-			1,
-			0
-		], direction);
-		if (vecLength(cross) < 1e-12) cross = vecCross([
-			1,
-			0,
-			0
-		], direction);
-		resolvedXAxis = vecNormalize(cross);
-	}
-	const yAxis = vecNormalize(vecCross(direction, resolvedXAxis));
-	return ok({
-		position,
-		direction: vecNormalize(direction),
-		xAxis: resolvedXAxis,
-		yAxis
-	});
-}
-/**
-* Create a new camera oriented to look at a target point from the current position.
-*
-* @param camera - Existing camera whose position is preserved.
-* @param target - World-space point to look at.
-* @returns `Result<Camera>` with updated direction and derived axes.
-*/
-function cameraLookAt(camera, target) {
-	const direction = vecNormalize(vecSub(camera.position, target));
-	return createCamera(camera.position, direction);
-}
-/**
-* Create a camera positioned at the origin, looking along a named projection plane.
-*
-* @param planeName - Named projection direction (e.g., `'front'`, `'top'`).
-* @returns `Result<Camera>` configured for that standard view.
-*/
-function cameraFromPlane(planeName) {
-	const config = PROJECTION_PLANES[planeName];
-	return createCamera([
-		0,
-		0,
-		0
-	], config.dir, config.xAxis);
-}
-/**
-* Project the edges of a 3D shape onto a 2D plane defined by a {@link Camera}.
-*
-* @param shape - The 3D shape to project.
-* @param camera - Camera defining the projection plane.
-* @param withHiddenLines - If true, compute hidden-line edges as well.
-* @returns Separate arrays of visible and hidden projected edges.
-*
-* @see {@link drawProjection} for the higher-level Drawing-based API.
-*/
-function projectEdges(shape, camera, withHiddenLines = true) {
-	return makeProjectedEdges(shape, camera, withHiddenLines);
-}
-//#endregion
 //#region src/sketching/draw3d.ts
 var edgesToDrawing = (edges) => {
 	try {
@@ -1749,133 +1269,6 @@ function drawFaceOutline(face) {
 	}
 }
 //#endregion
-//#region src/sketching/sketchFns.ts
-/**
-* Extrude a sketch to a given distance along its default (or overridden) direction.
-*
-* @param sketch - The sketch to extrude. Consumed (deleted) by this call.
-* @param height - Extrusion distance.
-* @param config - Optional direction, profile, twist angle, or origin overrides.
-* @returns The extruded 3D solid.
-*
-* @see {@link Sketch.extrude} for the OOP equivalent.
-*/
-function sketchExtrude(sketch, height, config) {
-	return sketch.extrude(height, config);
-}
-/**
-* Revolve a sketch around an axis to produce a solid of revolution.
-*
-* @param sketch - The sketch to revolve. Consumed (deleted) by this call.
-* @param revolutionAxis - Axis direction (defaults to sketch default direction).
-* @param options - Optional origin override.
-* @returns The revolved 3D solid.
-*
-* @see {@link Sketch.revolve} for the OOP equivalent.
-*/
-function sketchRevolve(sketch, revolutionAxis, options) {
-	return sketch.revolve(revolutionAxis, options);
-}
-/**
-* Loft between this sketch and one or more other sketches.
-*
-* @param sketch - The starting sketch. Consumed by this call.
-* @param otherSketches - Target sketch(es) to loft toward.
-* @param loftConfig - Loft options (ruled surface, start/end points, etc.).
-* @param returnShell - If true, return a shell instead of a solid.
-* @returns The lofted 3D shape.
-*
-* @see {@link Sketch.loftWith} for the OOP equivalent.
-*/
-function sketchLoft(sketch, otherSketches, loftConfig, returnShell) {
-	return sketch.loftWith(otherSketches, loftConfig, returnShell);
-}
-/**
-* Sweep a profile sketch along this sketch's wire path.
-*
-* @param sketch - The path sketch. Consumed by this call.
-* @param sketchOnPlane - Function that builds the profile sketch at the sweep start.
-* @param sweepConfig - Sweep options (auxiliary spine, orthogonality, etc.).
-* @returns The swept 3D shape.
-*
-* @see {@link Sketch.sweepSketch} for the OOP equivalent.
-*/
-function sketchSweep(sketch, sketchOnPlane, sweepConfig) {
-	return sketch.sweepSketch(sketchOnPlane, sweepConfig);
-}
-/**
-* Build a face from a sketch's closed wire.
-*
-* @param sketch - A sketch with a closed wire.
-* @returns The planar face.
-*
-* @see {@link Sketch.face} for the OOP equivalent.
-*/
-function sketchFace(sketch) {
-	return sketch.face();
-}
-/**
-* Get a clone of the wire from a sketch.
-*
-* @param sketch - The source sketch.
-* @returns A cloned wire.
-*
-* @see {@link Sketch.wires} for the OOP equivalent.
-*/
-function sketchWires(sketch) {
-	return sketch.wires();
-}
-/**
-* Extrude a compound sketch (outer + holes) to a given distance.
-*
-* @param sketch - The compound sketch to extrude.
-* @param height - Extrusion distance.
-* @param config - Optional direction, profile, twist angle, or origin overrides.
-* @returns The extruded 3D solid.
-*
-* @see {@link CompoundSketch.extrude} for the OOP equivalent.
-*/
-function compoundSketchExtrude(sketch, height, config) {
-	return sketch.extrude(height, config);
-}
-/**
-* Revolve a compound sketch around an axis to produce a solid of revolution.
-*
-* @param sketch - The compound sketch to revolve.
-* @param revolutionAxis - Axis direction.
-* @param options - Optional origin override.
-* @returns The revolved 3D solid.
-*
-* @see {@link CompoundSketch.revolve} for the OOP equivalent.
-*/
-function compoundSketchRevolve(sketch, revolutionAxis, options) {
-	return sketch.revolve(revolutionAxis, options);
-}
-/**
-* Build a face from a compound sketch (outer boundary with holes).
-*
-* @param sketch - The compound sketch.
-* @returns A face with inner wires subtracted as holes.
-*
-* @see {@link CompoundSketch.face} for the OOP equivalent.
-*/
-function compoundSketchFace(sketch) {
-	return sketch.face();
-}
-/**
-* Loft between two compound sketches that have the same number of sub-sketches.
-*
-* @param sketch - Starting compound sketch.
-* @param other - Target compound sketch.
-* @param loftConfig - Loft options (ruled surface, etc.).
-* @returns The lofted 3D solid.
-*
-* @see {@link CompoundSketch.loftWith} for the OOP equivalent.
-*/
-function compoundSketchLoft(sketch, other, loftConfig) {
-	return sketch.loftWith(other, loftConfig);
-}
-//#endregion
 //#region src/sketching/drawFns.ts
 /**
 * Sketch a drawing onto a 3D plane, producing a Sketch or Sketches.
@@ -1889,6 +1282,7 @@ function compoundSketchLoft(sketch, other, loftConfig) {
 */
 function drawingToSketchOnPlane(drawing, inputPlane, origin) {
 	if (origin !== void 0) return drawing.sketchOnPlane(inputPlane, origin);
+	if (typeof inputPlane === "object") return drawing.sketchOnPlane(inputPlane);
 	return drawing.sketchOnPlane(inputPlane);
 }
 /**
@@ -1997,4 +1391,4 @@ function mirrorDrawing(drawing, centerOrDirection, origin, mode) {
 	return drawing.mirror(centerOrDirection, origin, mode);
 }
 //#endregion
-export { sketchFaceOffset as $, DrawingPen as A, drawSingleCircle as B, cameraFromPlane as C, makeProjectedEdges as D, projectEdges as E, drawParametricFunction as F, loadFont as G, drawText as H, drawPointsInterpolation as I, textMetrics as J, sketchText as K, drawPolysides as L, draw as M, drawCircle as N, isProjectionPlane as O, drawEllipse as P, sketchEllipse as Q, drawRectangle as R, drawProjection as S, createCamera as T, fontMetrics as U, drawSingleEllipse as V, getFont as W, polysideInnerRadius as X, makeBaseBox as Y, sketchCircle as Z, sketchLoft as _, drawingIntersect as a, Sketcher as at, sketchWires as b, rotateDrawing as c, compoundSketchExtrude as d, sketchHelix as et, compoundSketchFace as f, sketchFace as g, sketchExtrude as h, drawingFuse as i, sketchRoundedRectangle as it, deserializeDrawing as j, Drawing as k, scaleDrawing as l, compoundSketchRevolve as m, drawingCut as n, sketchPolysides as nt, drawingToSketchOnPlane as o, Sketches as ot, compoundSketchLoft as p, textBlueprints as q, drawingFillet as r, sketchRectangle as rt, mirrorDrawing as s, CompoundSketch as st, drawingChamfer as t, sketchParametricFunction as tt, translateDrawing as u, sketchRevolve as v, cameraLookAt as w, drawFaceOutline as x, sketchSweep as y, drawRoundedRectangle as z };
+export { sketchEllipse as A, DrawingPen as C, makeBaseBox as D, deserializeDrawing as E, sketchRectangle as F, sketchRoundedRectangle as I, FaceSketcher as L, sketchHelix as M, sketchParametricFunction as N, polysideInnerRadius as O, sketchPolysides as P, Sketcher as R, drawText as S, Drawing as T, drawPolysides as _, drawingIntersect as a, drawSingleCircle as b, rotateDrawing as c, drawFaceOutline as d, drawProjection as f, drawPointsInterpolation as g, drawParametricFunction as h, drawingFuse as i, sketchFaceOffset as j, sketchCircle as k, scaleDrawing as l, drawEllipse as m, drawingCut as n, drawingToSketchOnPlane as o, drawCircle as p, drawingFillet as r, mirrorDrawing as s, drawingChamfer as t, translateDrawing as u, drawRectangle as v, draw as w, drawSingleEllipse as x, drawRoundedRectangle as y };