brepjs 20.11.3 → 20.12.1

package/README.md

@@ -2,7 +2,7 @@
 
 # brepjs
 
-CAD modeling for JavaScript.
+Exact B-Rep CAD in TypeScript, built so AI agents can write parts and check them.
 
 [![npm](https://img.shields.io/npm/v/brepjs)](https://www.npmjs.com/package/brepjs)
 [![CI](https://github.com/andymai/brepjs/actions/workflows/ci.yml/badge.svg)](https://github.com/andymai/brepjs/actions/workflows/ci.yml)
@@ -10,13 +10,26 @@ CAD modeling for JavaScript.
 [![Commit activity](https://img.shields.io/github/commit-activity/m/andymai/brepjs?label=commits%2Fmonth)](https://github.com/andymai/brepjs/commits/main)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
 
-**[▶ Try the live playground](https://brepjs.dev/playground)**: write code, watch the solid render, and export STEP, all in your browser.
+https://github.com/user-attachments/assets/a8dce262-2a86-4db2-8956-9d8ca8adcae4
 
-**[Getting Started](./docs/getting-started.md)** · **[Cheat Sheet](./docs/cheat-sheet.md)** · **[Docs](https://brepjs.dev/)**
+</div>
 
-[![brepjs playground: write TypeScript on the left, see the exact solid render on the right](https://raw.githubusercontent.com/andymai/brepjs/main/media/demo.webp)](https://brepjs.dev/playground)
+In this real session, a coding agent (Claude Code) reads the official Raspberry Pi 5 drawing, writes the case as a brepjs part, gets an error back from `brep verify`, fixes it, and adds a fan mount on request. The exported STEP opens in FreeCAD. [Watch the narrated version](https://youtu.be/n8Cbg345NRI).
 
-</div>
+Parts are plain TypeScript files and the checker is a CLI, so it isn't tied to one agent:
+
+```sh
+npm i -D brepjs brepjs-cad occt-wasm
+npx brep verify part.brep.ts
+```
+
+MCP clients can use the `brep-mcp` server instead, and Claude Code users can install the authoring skills as a plugin: `/plugin marketplace add andymai/brepjs`, then `/plugin install brepjs@brepjs`.
+
+An agent rebuilt the 46 parts in our example gallery from their descriptions, and all 46 passed verify. [How we measured it](https://brepjs.dev/agent/eval).
+
+## Or write it yourself
+
+**[▶ Try the live playground](https://brepjs.dev/playground)** · **[Getting Started](./docs/getting-started.md)** · **[Cheat Sheet](./docs/cheat-sheet.md)** · **[Docs](https://brepjs.dev/)**
 
 Shapes are exact mathematical boundaries (not triangle meshes), so booleans are precise, measurements are real, and you can export to STEP. TypeScript types prove the geometry is valid at compile time.
 
@@ -40,20 +53,6 @@ brepjs grew out of the love and care I put into [gridfinitylayouttool.com](https
 
 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**: 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.
-
-## Status
-
-[occt-wasm](https://github.com/andymai/occt-wasm) (OpenCascade compiled to WebAssembly) is the default kernel. [brepkit](https://github.com/andymai/brepkit), a Rust-based kernel, is in active development as a faster replacement but not yet ready for production use. The kernel abstraction layer means switching is a one-line change. See [benchmarks](./benchmarks/results/latest.md) for performance comparisons.
-
 ## Install
 
 ```bash
@@ -106,6 +105,20 @@ Layer 0  kernel/, utils/                  WASM bindings
 
 Imports flow downward only. Boundaries are enforced in CI.
 
+## 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**: 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.
+
+## Status
+
+[occt-wasm](https://github.com/andymai/occt-wasm) (OpenCascade compiled to WebAssembly) is the default kernel. [brepkit](https://github.com/andymai/brepkit), a Rust-based kernel, is in active development as a faster replacement but not yet ready for production use. The kernel abstraction layer means switching is a one-line change. See [benchmarks](./benchmarks/results/latest.md) for performance comparisons.
+
 ## Authoring CAD with AI (brepjs-cad)
 
 [`brepjs-cad`](https://www.npmjs.com/package/brepjs-cad) 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).

package/dist/brepjs.cjs

@@ -24,18 +24,18 @@ const require_threadFns = require("./threadFns-BzxB-0i5.cjs");
 const require_blueprintSketcher = require("./blueprintSketcher-CG4H8A6M.cjs");
 const require_helpers = require("./helpers-GZyqAK5c.cjs");
 const require_blueprint = require("./blueprint-CHBjfXQO.cjs");
-const require_drawFns = require("./drawFns-CccVnQU5.cjs");
+const require_drawFns = require("./drawFns-C_YnK4Ar.cjs");
 const require_measureFns = require("./measureFns-Cyjpl2Kl.cjs");
 const require_cornerFinder = require("./cornerFinder-Bg67ivza.cjs");
 const require_boolean2D = require("./boolean2D-DjJogOY-.cjs");
 const require_blueprintFns = require("./blueprintFns-DOdzDcPX.cjs");
 const require_importFns = require("./importFns-C3LbWc6X.cjs");
-const require_textBlueprints = require("./textBlueprints-BRr35eaP.cjs");
+const require_textBlueprints = require("./textBlueprints-C38JfUeN.cjs");
 const require_loftFns = require("./loftFns-BsFinbgs.cjs");
 const require_refResolveFns = require("./refResolveFns-awGNYa3x.cjs");
 const require_adjacencyFns = require("./adjacencyFns-Cibtcqdl.cjs");
 const require_cameraFns = require("./cameraFns-CUX8VNKT.cjs");
-const require_textMetrics = require("./textMetrics-DwMUM6GY.cjs");
+const require_textMetrics = require("./textMetrics-r9ldmBb5.cjs");
 const require_principalBoxFns = require("./principalBoxFns-uZrBoGLA.cjs");
 const require_workerPool = require("./workerPool-D5tiNXrI.cjs");
 // src/kernel/types.ts
@@ -9831,6 +9831,7 @@ exports.sdfTorus = torus;
 exports.section = section;
 exports.sectionToFace = sectionToFace;
 exports.serializeHistory = require_threadFns.serializeHistory;
+exports.setFallbackFont = require_textBlueprints.setFallbackFont;
 exports.setJointValue = require_threadFns.setJointValue;
 exports.setJointValues = require_threadFns.setJointValues;
 exports.setShapeOrigin = require_originTrackingFns.setShapeOrigin;

package/dist/brepjs.js

@@ -22,18 +22,18 @@ import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as plan
 import { n as BaseSketcher2d, r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-CQPC4SEF.js";
 import { a as createTypedFinder, i as wireFinder, n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-CBXclBes.js";
 import { _ as approximateAsSvgCompatibleCurve, o as ellipseArcFlags } from "./blueprint-CN5dNZ1h.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-OR6Hjs8g.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-D6YK0JbH.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-DukwjzUl.js";
 import { t as cornerFinder } from "./cornerFinder-utEooGH7.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-tR_2N_Vy.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--26Mr3Lm.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-CcPhunG6.js";
-import { a as Sketch, b as extrudeAll, 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, x as revolve$2, y as extrude$2 } from "./textBlueprints-BxoVq7Fr.js";
+import { S as revolve$2, a as Sketches, b as extrude$2, c as compoundSketchFace, d as sketchExtrude, f as sketchFace, g as sketchWires, h as sketchSweep, i as setFallbackFont, l as compoundSketchLoft, m as sketchRevolve, n as getFont, o as Sketch, p as sketchLoft, r as loadFont, s as compoundSketchExtrude, t as textBlueprints, u as compoundSketchRevolve, x as extrudeAll, y as CompoundSketch } from "./textBlueprints-TLU7rjuN.js";
 import { a as multiSectionSweep, c as twistExtrude, i as guidedSweep, n as loftAll, o as supportExtrude, r as complexExtrude, s as sweep$1, t as loft$2 } from "./loftFns-pMh0ET-J.js";
 import { _ as createRef, a as isVertexRef, b as defaultScorer, c as resolveRefParams, d as createVertexRef, f as resolveVertexRef, g as captureHint, h as assignRoles, i as isLineageRef, l as createDerivedFaceRef, m as resolveEdgeRef, n as isEdgeRef, o as resolveLineageRef, p as createEdgeRef, r as isFaceRef, s as resolveRefIn, t as isDerivedFaceRef, u as resolveDerivedFaceRef, v as resolveRef, y as updateRoles } from "./refResolveFns-BvQkLKLw.js";
 import { a as facesOfVertex, c as verticesOfFace, i as facesOfEdge, l as wiresOfFace, n as adjacentFaces, o as sharedEdges, r as edgesOfFace, s as verticesOfEdge } from "./adjacencyFns-C0YD3Zrp.js";
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-xUCRxpsa.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-DaNriztv.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-CEnX8GBe.js";
 import { t as principalBoundingBox } from "./principalBoxFns-ClynMQMo.js";
 import { _ as isSuccessResponse, a as createWorkerClient, c as enqueueTask, d as rejectAll, f as isBatchRequest, g as isOperationRequest, h as isInitRequest, i as registerHandler, l as isEmpty$1, m as isErrorResponse, n as createOperationRegistry, o as createTaskQueue, p as isDisposeRequest, r as createWorkerHandler, s as dequeueTask, t as createWorkerPool, u as pendingCount } from "./workerPool-Bc5hmJc4.js";
 // \0rolldown/runtime.js
@@ -9303,4 +9303,4 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	zShapeProfile: () => zShapeProfile
 });
 /* v8 ignore file */
-export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, GeometryCleanupError, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToContour, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDerivedFaceRef, createDistanceQuery, createEdge, createEdgeRef, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createVertexRef, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, facesOfVertex, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDerivedFaceRef, isDisposeRequest, isEdge, isEdgeRef, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFaceRef, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLineageRef, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isVertexRef, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, locate, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshLODsProgressive, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, principalBoundingBox, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeFaces, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDerivedFaceRef, resolveDirection, resolveEdgeRef, resolveLineageRef, resolvePlane, resolveRef, resolveRefIn, resolveRefParams, resolveVertexRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, verticesOfFace, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };
+export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, GeometryCleanupError, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToContour, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDerivedFaceRef, createDistanceQuery, createEdge, createEdgeRef, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createVertexRef, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, facesOfVertex, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDerivedFaceRef, isDisposeRequest, isEdge, isEdgeRef, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFaceRef, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLineageRef, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isVertexRef, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, locate, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshLODsProgressive, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, principalBoundingBox, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeFaces, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDerivedFaceRef, resolveDirection, resolveEdgeRef, resolveLineageRef, resolvePlane, resolveRef, resolveRefIn, resolveRefParams, resolveVertexRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setFallbackFont, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, verticesOfFace, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };

package/dist/{drawFns-CccVnQU5.cjs → drawFns-C_YnK4Ar.cjs}

@@ -15,7 +15,7 @@ const require_helpers = require("./helpers-GZyqAK5c.cjs");
 const require_blueprint = require("./blueprint-CHBjfXQO.cjs");
 const require_cornerFinder = require("./cornerFinder-Bg67ivza.cjs");
 const require_boolean2D = require("./boolean2D-DjJogOY-.cjs");
-const require_textBlueprints = require("./textBlueprints-BRr35eaP.cjs");
+const require_textBlueprints = require("./textBlueprints-C38JfUeN.cjs");
 const require_cameraFns = require("./cameraFns-CUX8VNKT.cjs");
 // src/2d/lib/stitching.ts
 /**

package/dist/{drawFns-OR6Hjs8g.js → drawFns-D6YK0JbH.js}

@@ -15,7 +15,7 @@ import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoin
 import { _ as approximateAsSvgCompatibleCurve, a as edgeToCurve, f as make2dInerpolatedBSplineCurve, i as curvesAsEdgesOnPlane, l as make2dCircle, p as make2dSegmentCurve, s as make2dArcFromCenter, t as Blueprint, u as make2dEllipse, v as Curve2D, x as BoundingBox2d, y as deserializeCurve2D } from "./blueprint-CN5dNZ1h.js";
 import { t as cornerFinder } from "./cornerFinder-utEooGH7.js";
 import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-tR_2N_Vy.js";
-import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-BxoVq7Fr.js";
+import { _ as wrapSketchData, a as Sketches, o as Sketch, t as textBlueprints, v as wrapSketchDataArray } from "./textBlueprints-TLU7rjuN.js";
 import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-xUCRxpsa.js";
 // src/2d/lib/stitching.ts
 /**

package/dist/index.d.ts

@@ -66,7 +66,7 @@ export { drawProjection, drawFaceOutline } from './sketching/draw3d.js';
 export type { DrawingInterface, SketchData } from './2d/blueprints/lib.js';
 export { sketchExtrude, sketchRevolve, sketchLoft, sketchSweep, sketchFace, sketchWires, compoundSketchExtrude, compoundSketchRevolve, compoundSketchFace, compoundSketchLoft, } from './sketching/sketchFns.js';
 export { drawingToSketchOnPlane, drawingFuse, drawingCut, drawingIntersect, drawingFillet, drawingChamfer, translateDrawing, rotateDrawing, scaleDrawing, mirrorDrawing, } from './sketching/drawFns.js';
-export { loadFont, getFont } from './text/fontRegistry.js';
+export { loadFont, getFont, setFallbackFont } from './text/fontRegistry.js';
 export { textBlueprints } from './text/textBlueprints.js';
 export { sketchText } from './text/sketchText.js';
 export { textMetrics, fontMetrics, type TextMetricsResult, type FontMetricsResult, } from './text/textMetrics.js';

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_blueprintSketcher = require("./blueprintSketcher-CG4H8A6M.cjs");
-const require_drawFns = require("./drawFns-CccVnQU5.cjs");
-const require_textBlueprints = require("./textBlueprints-BRr35eaP.cjs");
+const require_drawFns = require("./drawFns-C_YnK4Ar.cjs");
+const require_textBlueprints = require("./textBlueprints-C38JfUeN.cjs");
 // 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-CQPC4SEF.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-OR6Hjs8g.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-BxoVq7Fr.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-D6YK0JbH.js";
+import { a as Sketches, c as compoundSketchFace, d as sketchExtrude, f as sketchFace, g as sketchWires, h as sketchSweep, l as compoundSketchLoft, m as sketchRevolve, o as Sketch, p as sketchLoft, s as compoundSketchExtrude, u as compoundSketchRevolve, y as CompoundSketch } from "./textBlueprints-TLU7rjuN.js";
 // src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/text/fontRegistry.d.ts

@@ -13,10 +13,21 @@ import { OpenTypeFont } from '../kernel/occt/wasmTypes/externals.js';
  * @returns The parsed opentype.js Font object.
  */
 export declare function loadFont(fontPath: string | ArrayBuffer, fontFamily?: string, force?: boolean): Promise<Result<OpenTypeFont>>;
+/**
+ * Register a font that text functions use when no font has been loaded.
+ *
+ * Unlike {@link loadFont}, this does not occupy the `'default'` family: once any font is
+ * loaded, it takes precedence over the fallback.
+ *
+ * @param fontData - Raw OpenType/TrueType font bytes.
+ * @returns The parsed opentype.js Font object.
+ */
+export declare function setFallbackFont(fontData: ArrayBuffer): Result<OpenTypeFont>;
 /**
  * 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.
+ * @returns The opentype.js Font object, or `undefined` if not loaded. `'default'` resolves
+ * to the fallback font when no font has been loaded.
  */
 export declare const getFont: (fontFamily?: string) => OpenTypeFont | undefined;

package/dist/text.cjs

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-BRr35eaP.cjs");
-const require_textMetrics = require("./textMetrics-DwMUM6GY.cjs");
+const require_textBlueprints = require("./textBlueprints-C38JfUeN.cjs");
+const require_textMetrics = require("./textMetrics-r9ldmBb5.cjs");
 exports.fontMetrics = require_textMetrics.fontMetrics;
 exports.getFont = require_textBlueprints.getFont;
 exports.loadFont = require_textBlueprints.loadFont;
+exports.setFallbackFont = require_textBlueprints.setFallbackFont;
 exports.sketchText = require_textMetrics.sketchText;
 exports.textBlueprints = require_textBlueprints.textBlueprints;
 exports.textMetrics = require_textMetrics.textMetrics;

package/dist/text.d.ts

@@ -6,7 +6,7 @@
  * import { loadFont, sketchText } from 'brepjs/text';
  * ```
  */
-export { loadFont, getFont } from './text/fontRegistry.js';
+export { loadFont, getFont, setFallbackFont } from './text/fontRegistry.js';
 export { textBlueprints } from './text/textBlueprints.js';
 export { sketchText } from './text/sketchText.js';
 export { textMetrics, fontMetrics, type TextMetricsResult, type FontMetricsResult, } from './text/textMetrics.js';

package/dist/text.js

@@ -1,3 +1,3 @@
-import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-BxoVq7Fr.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-DaNriztv.js";
-export { fontMetrics, getFont, loadFont, sketchText, textBlueprints, textMetrics };
+import { i as setFallbackFont, n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-TLU7rjuN.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-CEnX8GBe.js";
+export { fontMetrics, getFont, loadFont, setFallbackFont, sketchText, textBlueprints, textMetrics };

package/dist/{textBlueprints-BRr35eaP.cjs → textBlueprints-C38JfUeN.cjs}

@@ -824,25 +824,43 @@ async function loadFont(fontPath, fontFamily = "default", force = false) {
 		if (!response.ok) return require_errors.err(require_errors.ioError(require_errors.BrepErrorCode.FONT_FETCH_FAILED, `Failed to fetch font from ${fontPath}: HTTP ${response.status} ${response.statusText}`));
 		fontData = await response.arrayBuffer();
 	} else fontData = fontPath;
-	let font;
+	const parsed = parseFont(fontData);
+	if (!parsed.ok) return parsed;
+	FONT_REGISTER[fontFamily] = parsed.value;
+	if (!FONT_REGISTER["default"]) FONT_REGISTER["default"] = parsed.value;
+	return parsed;
+}
+function parseFont(fontData) {
 	try {
-		font = opentype_js.default.parse(fontData);
+		return require_errors.ok(opentype_js.default.parse(fontData));
 	} catch (e) {
 		return require_errors.err(require_errors.ioError(require_errors.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 require_errors.ok(typedFont);
+}
+var fallbackFont;
+/**
+* Register a font that text functions use when no font has been loaded.
+*
+* Unlike {@link loadFont}, this does not occupy the `'default'` family: once any font is
+* loaded, it takes precedence over the fallback.
+*
+* @param fontData - Raw OpenType/TrueType font bytes.
+* @returns The parsed opentype.js Font object.
+*/
+function setFallbackFont(fontData) {
+	const parsed = parseFont(fontData);
+	if (parsed.ok) fallbackFont = parsed.value;
+	return parsed;
 }
 /**
 * 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.
+* @returns The opentype.js Font object, or `undefined` if not loaded. `'default'` resolves
+* to the fallback font when no font has been loaded.
 */
 var getFont = (fontFamily = "default") => {
-	return FONT_REGISTER[fontFamily];
+	return FONT_REGISTER[fontFamily] ?? (fontFamily === "default" ? fallbackFont : void 0);
 };
 // src/text/textBlueprints.ts
 var sketchFontCommands = function* (commands) {
@@ -960,6 +978,12 @@ Object.defineProperty(exports, "revolve", {
 		return revolve;
 	}
 });
+Object.defineProperty(exports, "setFallbackFont", {
+	enumerable: true,
+	get: function() {
+		return setFallbackFont;
+	}
+});
 Object.defineProperty(exports, "sketchExtrude", {
 	enumerable: true,
 	get: function() {

package/dist/{textBlueprints-BxoVq7Fr.js → textBlueprints-TLU7rjuN.js}

@@ -822,25 +822,43 @@ async function loadFont(fontPath, fontFamily = "default", force = false) {
 		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;
+	const parsed = parseFont(fontData);
+	if (!parsed.ok) return parsed;
+	FONT_REGISTER[fontFamily] = parsed.value;
+	if (!FONT_REGISTER["default"]) FONT_REGISTER["default"] = parsed.value;
+	return parsed;
+}
+function parseFont(fontData) {
 	try {
-		font = opentype.parse(fontData);
+		return ok(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);
+}
+var fallbackFont;
+/**
+* Register a font that text functions use when no font has been loaded.
+*
+* Unlike {@link loadFont}, this does not occupy the `'default'` family: once any font is
+* loaded, it takes precedence over the fallback.
+*
+* @param fontData - Raw OpenType/TrueType font bytes.
+* @returns The parsed opentype.js Font object.
+*/
+function setFallbackFont(fontData) {
+	const parsed = parseFont(fontData);
+	if (parsed.ok) fallbackFont = parsed.value;
+	return parsed;
 }
 /**
 * 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.
+* @returns The opentype.js Font object, or `undefined` if not loaded. `'default'` resolves
+* to the fallback font when no font has been loaded.
 */
 var getFont = (fontFamily = "default") => {
-	return FONT_REGISTER[fontFamily];
+	return FONT_REGISTER[fontFamily] ?? (fontFamily === "default" ? fallbackFont : void 0);
 };
 // src/text/textBlueprints.ts
 var sketchFontCommands = function* (commands) {
@@ -886,4 +904,4 @@ function textBlueprints(text, { startX = 0, startY = 0, fontSize = 16, fontFamil
 	const blueprints = Array.from(sketchFontCommands(writtenText.commands));
 	return organiseBlueprints(blueprints).mirror([0, 0]);
 }
-export { wrapSketchDataArray as _, Sketch as a, extrudeAll as b, compoundSketchLoft as c, sketchFace as d, sketchLoft as f, wrapSketchData as g, sketchWires as h, Sketches as i, compoundSketchRevolve as l, sketchSweep as m, getFont as n, compoundSketchExtrude as o, sketchRevolve as p, loadFont as r, compoundSketchFace as s, textBlueprints as t, sketchExtrude as u, CompoundSketch as v, revolve as x, extrude as y };
+export { revolve as S, wrapSketchData as _, Sketches as a, extrude as b, compoundSketchFace as c, sketchExtrude as d, sketchFace as f, sketchWires as g, sketchSweep as h, setFallbackFont as i, compoundSketchLoft as l, sketchRevolve as m, getFont as n, Sketch as o, sketchLoft as p, loadFont as r, compoundSketchExtrude as s, textBlueprints as t, compoundSketchRevolve as u, wrapSketchDataArray as v, extrudeAll as x, CompoundSketch as y };

package/dist/{textMetrics-DaNriztv.js → textMetrics-CEnX8GBe.js}

@@ -1,5 +1,5 @@
 import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-BTccWbtE.js";
-import { g as wrapSketchData, i as Sketches, n as getFont, t as textBlueprints, v as CompoundSketch } from "./textBlueprints-BxoVq7Fr.js";
+import { _ as wrapSketchData, a as Sketches, n as getFont, t as textBlueprints, y as CompoundSketch } from "./textBlueprints-TLU7rjuN.js";
 // src/text/sketchText.ts
 /**
 * Render text as 3D sketch outlines on a plane.

package/dist/{textMetrics-DwMUM6GY.cjs → textMetrics-r9ldmBb5.cjs}

@@ -1,5 +1,5 @@
 const require_errors = require("./errors-O_blYTWT.cjs");
-const require_textBlueprints = require("./textBlueprints-BRr35eaP.cjs");
+const require_textBlueprints = require("./textBlueprints-C38JfUeN.cjs");
 // src/text/sketchText.ts
 /**
 * Render text as 3D sketch outlines on a plane.

package/dist/topology/apiTypes.d.ts

@@ -1,6 +1,6 @@
 import { Vec2, Vec3 } from '../core/types.js';
 import { AnyShape, Dimension, Edge, Face, Wire, Shape3D } from '../core/shapeTypes.js';
-import { ShapeFinder } from '../query/finderFns.js';
+import { EdgeFinderFn, FaceFinderFn, ShapeFinder } from '../query/finderFns.js';
 /**
  * Structural type matching a Drawing's wire-producing interface.
  * Used in place of importing the actual Drawing class to avoid
@@ -11,8 +11,9 @@ export interface DrawingLike {
         wire: Wire;
     };
 }
+type FinderFor<T extends AnyShape<Dimension>> = T extends Edge ? EdgeFinderFn : T extends Face ? FaceFinderFn : ShapeFinder<T>;
 /** Callback that configures a shape finder for inline use in modifiers. */
-export type FinderFn<T extends AnyShape<Dimension>> = (finder: ShapeFinder<T>) => ShapeFinder<T>;
+export type FinderFn<T extends AnyShape<Dimension>> = (finder: FinderFor<T>) => ShapeFinder<T>;
 /**
  * Fillet radius specification.
  *
@@ -126,3 +127,4 @@ export type Shapeable<T extends AnyShape<Dimension>> = T | WrappedMarker<T>;
 export declare function resolve<T extends AnyShape<Dimension>>(s: Shapeable<T>): T;
 /** Extract the raw branded 3D shape from a Shapeable<Shape3D>. */
 export declare function resolve3D(s: Shapeable<Shape3D>): Shape3D;
+export {};

package/dist/topology.d.ts

@@ -3,7 +3,7 @@
  *
  * @example
  * ```typescript
- * import { box, fuse, fillet, mesh } from 'brepjs/topology';
+ * import { box, fuseAll, variableFillet } from 'brepjs/topology';
  * ```
  */
 export { getHashCode, isSameShape, isEqualShape, getEdges, getFaces, getWires, getVertices, iterEdges, iterFaces, iterWires, iterVertices, getBounds, vertexPosition, invalidateShapeCache, type Bounds3D, type ShapeDescription, } from './topology/shapeFns.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "brepjs",
-  "version": "20.11.3",
-  "description": "Web CAD library with pluggable geometry kernel",
+  "version": "20.12.1",
+  "description": "Exact B-Rep CAD in TypeScript on OpenCascade WebAssembly, with a pluggable geometry kernel",
   "keywords": [
     "cad",
     "geometry-kernel",