@faicad/faijs 0.13.0

package/dist/vendored/brepjs/sketching/sketchFns.js

@@ -0,0 +1,266 @@
+/**
+ * Standalone functions for Sketch and CompoundSketch operations.
+ *
+ * These functions hold the canonical implementations; the matching class
+ * methods (`Sketch.extrude`, `CompoundSketch.face`, etc.) delegate here.
+ */
+import { createPlane } from '../core/planeOps.js';
+import { addHolesInFace, makeCompound, makeFace, makeNewFaceWithinFace, makeSolid, } from '../topology/shapeHelpers.js';
+import { unwrap } from '../core/result.js';
+import { copyShape } from '../topology/cast.js';
+import { cutAll } from '../topology/booleanFns.js';
+import { toVec3 } from '../core/types.js';
+import { vecScale, vecNormalize, vecCross } from '../core/vecOps.js';
+import { extrude, revolve } from '../operations/extrudeFns.js';
+import { sweep, complexExtrude, twistExtrude } from '../operations/sweepFns.js';
+import { firstOrThrow, getAtOrThrow } from '../utils/arrayAccess.js';
+import { bug } from '../core/errors.js';
+import { loft } from '../operations/loftFns.js';
+import { createFace, createWire } from '../core/shapeTypes.js';
+import { curveStartPoint, curveTangentAt } from '../topology/curveFns.js';
+import Sketch from './sketch.js';
+import CompoundSketch from './compoundSketch.js';
+// ---------------------------------------------------------------------------
+// SketchData wrappers
+// ---------------------------------------------------------------------------
+/** Wrap SketchData into a Sketch instance. */
+export function wrapSketchData(data) {
+    const opts = {};
+    if (data.defaultOrigin)
+        opts.defaultOrigin = data.defaultOrigin;
+    if (data.defaultDirection)
+        opts.defaultDirection = data.defaultDirection;
+    // SketchData.wire is produced by Drawing.sketchOnPlane on a closed planar profile.
+    const sketch = new Sketch(data.wire, opts);
+    if (data.baseFace)
+        sketch.baseFace = data.baseFace;
+    return sketch;
+}
+/** Wrap an array of SketchData into a CompoundSketch. */
+export 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.
+ */
+export 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.');
+}
+// ---------------------------------------------------------------------------
+// Sketch operations (canonical implementations)
+// ---------------------------------------------------------------------------
+/** Build a face from a sketch's closed planar wire. */
+export function sketchFace(sketch) {
+    let face;
+    if (!sketch.baseFace) {
+        face = unwrap(makeFace(sketch.wire));
+    }
+    else {
+        face = makeNewFaceWithinFace(sketch.baseFace, sketch.wire);
+    }
+    return face;
+}
+/** Return an independent clone of the sketch's wire. */
+export function sketchWires(sketch) {
+    return createWire(unwrap(copyShape(sketch.wire.wrapped)));
+}
+/**
+ * Revolve a sketch around an axis to produce a solid of revolution.
+ *
+ * @remarks Consumes the sketch — calling twice throws on the second call.
+ */
+export function sketchRevolve(sketch, revolutionAxis, { origin } = {}) {
+    const face = unwrap(makeFace(sketch.wire));
+    const center = origin ? toVec3(origin) : sketch.defaultOrigin;
+    const dir = revolutionAxis ? toVec3(revolutionAxis) : [0, 0, 1];
+    const solid = unwrap(revolve(face, center, dir));
+    face[Symbol.dispose](); // `.delete()` is a no-op on arena kernels; dispose the face
+    sketch.delete();
+    return solid;
+}
+/**
+ * Extrude a sketch to a given distance.
+ *
+ * Supports profile (taper) extrusion via `extrusionProfile`, twist extrusion
+ * via `twistAngle`, and direction/origin overrides.
+ *
+ * @remarks Consumes the sketch — calling twice throws on the second call.
+ */
+export function sketchExtrude(sketch, extrusionDistance, { extrusionDirection, extrusionProfile, twistAngle, origin, } = {}) {
+    const direction = extrusionDirection ? toVec3(extrusionDirection) : sketch.defaultDirection;
+    const extrusionVec = vecScale(vecNormalize(direction), extrusionDistance);
+    const originVec = origin ? toVec3(origin) : sketch.defaultOrigin;
+    if (extrusionProfile && !twistAngle) {
+        const solid = unwrap(complexExtrude(sketch.wire, [...originVec], [...extrusionVec], extrusionProfile));
+        sketch.delete();
+        return solid;
+    }
+    if (twistAngle) {
+        const solid = unwrap(twistExtrude(sketch.wire, twistAngle, [...originVec], [...extrusionVec], extrusionProfile));
+        sketch.delete();
+        return solid;
+    }
+    const face = unwrap(makeFace(sketch.wire));
+    const solid = unwrap(extrude(face, [...extrusionVec]));
+    face[Symbol.dispose](); // extrude shares the face's TShape; release the intermediate
+    sketch.delete();
+    return solid;
+}
+/**
+ * Sweep a profile sketch (built by `sketchOnPlane`) along this sketch's wire path.
+ *
+ * @remarks Consumes both this sketch and the one returned by `sketchOnPlane` —
+ * calling either twice throws on the second call.
+ */
+export function sketchSweep(sketch, sketchOnPlane, sweepConfig = {}) {
+    const startPoint = curveStartPoint(sketch.wire);
+    const tangent = curveTangentAt(sketch.wire, 1e-9);
+    const normal = vecNormalize(vecScale(tangent, -1));
+    const defaultDir = sketch.defaultDirection;
+    const xDir = vecScale(vecCross(normal, defaultDir), -1);
+    // The callback may return a Sketches (plural) when the Drawing used a 2D
+    // boolean that split the profile into multiple pieces; asSketch extracts the
+    // first wire and disposes the rest to prevent WASM leaks.
+    const profile = asSketch(sketchOnPlane(createPlane([...startPoint], [...xDir], [...normal]), [...startPoint]));
+    const config = {
+        forceProfileSpineOthogonality: true,
+        ...sweepConfig,
+    };
+    if (sketch.baseFace) {
+        config.support = sketch.baseFace.wrapped;
+    }
+    const shape = unwrap(sweep(profile.wire, sketch.wire, config));
+    sketch.delete();
+    return shape;
+}
+/**
+ * Loft between this sketch and one or more other sketches.
+ *
+ * @remarks Consumes all input sketches — calling twice throws on the second call.
+ */
+export function sketchLoft(sketch, otherSketches, loftConfig = {}, returnShell = false) {
+    const others = (Array.isArray(otherSketches) ? otherSketches : [otherSketches]).map(asSketch);
+    const sketchArray = [sketch, ...others];
+    const shape = unwrap(loft(sketchArray.map((s) => s.wire), loftConfig, returnShell));
+    sketchArray.forEach((s) => {
+        s.delete();
+    });
+    return shape;
+}
+// ---------------------------------------------------------------------------
+// CompoundSketch operations (canonical implementations)
+// ---------------------------------------------------------------------------
+/**
+ * Build a holed twist/profile-extruded solid by extruding the outer boundary
+ * and each hole wire as independent solids, then boolean-subtracting the holes.
+ *
+ * A single-wire twist/profile sweep already yields a valid, consistently-
+ * oriented solid. The previous approach assembled the per-wire lateral *shells*
+ * plus shared caps into one solid, which produced an inconsistently-oriented
+ * (invalid) result whose signed volume even flipped sign between occt-wasm
+ * versions — the cause of the #1366 twist/profile compound-extrude failure
+ * under occt-wasm 3.3.0. Subtracting valid solids is robust to kernel
+ * orientation conventions.
+ */
+const holedSweptSolid = (sketches, solidGenerator) => {
+    const outer = unwrap(solidGenerator(firstOrThrow(sketches)));
+    const holes = sketches.slice(1).map((s) => unwrap(solidGenerator(s)));
+    if (holes.length === 0)
+        return outer;
+    try {
+        return unwrap(cutAll(outer, holes, { unsafe: true }));
+    }
+    finally {
+        // cutAll is immutable and doesn't consume its inputs, so the per-wire
+        // intermediates must be disposed or each hole leaks a WASM solid per call.
+        outer.delete();
+        for (const h of holes)
+            h.delete();
+    }
+};
+/** Build a face from a compound sketch (outer boundary with holes). */
+export function compoundSketchFace(sketch) {
+    const baseFace = sketch.outerSketch.face();
+    const newFace = addHolesInFace(baseFace, sketch.innerSketches.map((s) => s.wire));
+    // addHolesInFace returns a fresh face sharing baseFace's TShape — release the
+    // orphaned base (its slot would otherwise leak on arena kernels).
+    baseFace[Symbol.dispose]();
+    return newFace;
+}
+/** Return all wires (outer + holes) combined into a compound shape. */
+export function compoundSketchWires(sketch) {
+    const wires = sketch.sketches.map((s) => s.wire);
+    return makeCompound(wires);
+}
+/**
+ * Extrude a compound sketch (outer + 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.
+ */
+export function compoundSketchExtrude(sketch, extrusionDistance, { extrusionDirection, extrusionProfile, twistAngle, origin, } = {}) {
+    const rawVec = extrusionDirection
+        ? toVec3(extrusionDirection)
+        : sketch.outerSketch.defaultDirection;
+    const normVec = vecNormalize(rawVec);
+    const extrusionVec = vecScale(normVec, extrusionDistance);
+    if (extrusionProfile && !twistAngle) {
+        return holedSweptSolid(sketch.sketches, (s) => complexExtrude(s.wire, origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin, extrusionVec, extrusionProfile) // solid mode (shellMode omitted)
+        );
+    }
+    if (twistAngle) {
+        return holedSweptSolid(sketch.sketches, (s) => twistExtrude(s.wire, twistAngle, origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin, extrusionVec, extrusionProfile) // solid mode (shellMode omitted)
+        );
+    }
+    const face = compoundSketchFace(sketch);
+    const solid = unwrap(extrude(face, extrusionVec));
+    face[Symbol.dispose](); // extrude shares the face's TShape; release the intermediate
+    return solid;
+}
+/** Revolve a compound sketch (outer + holes) around an axis. */
+export function compoundSketchRevolve(sketch, revolutionAxis, { origin } = {}) {
+    const center = origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin;
+    const dir = revolutionAxis ? toVec3(revolutionAxis) : [0, 0, 1];
+    const face = compoundSketchFace(sketch);
+    const solid = unwrap(revolve(face, center, dir));
+    face[Symbol.dispose](); // `.delete()` no-op on arena kernels; dispose the face
+    return solid;
+}
+/** Loft between two compound sketches with matching sub-sketch counts. */
+export 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);
+        const loftOpts = {};
+        if (loftConfig.ruled !== undefined)
+            loftOpts.ruled = loftConfig.ruled;
+        return base.clone().loftWith(outer.clone(), loftOpts, true);
+    });
+    const baseFaceRaw = compoundSketchFace(sketch);
+    const baseFace = createFace(unwrap(copyShape(baseFaceRaw.wrapped)));
+    baseFaceRaw[Symbol.dispose](); // orphaned once copied
+    shells.push(baseFace, compoundSketchFace(other));
+    const solid = unwrap(makeSolid(shells));
+    // makeSolid sews the shells/caps into a closed solid (shared refcounted
+    // TShapes); release the intermediates once it has consumed them.
+    for (const sh of shells)
+        sh[Symbol.dispose]();
+    return solid;
+}
+//# sourceMappingURL=sketchFns.js.map

package/dist/vendored/brepjs/sketching/sketchFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketchFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/sketchFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Standalone functions for Sketch and CompoundSketch operations.\n *\n * These functions hold the canonical implementations; the matching class\n * methods (`Sketch.extrude`, `CompoundSketch.face`, etc.) delegate here.\n */\n\nimport type { Plane } from '../core/planeTypes.js';\nimport { createPlane } from '../core/planeOps.js';\nimport {\n  addHolesInFace,\n  makeCompound,\n  makeFace,\n  makeNewFaceWithinFace,\n  makeSolid,\n} from '../topology/shapeHelpers.js';\nimport { type Result, unwrap } from '../core/result.js';\nimport { copyShape } from '../topology/cast.js';\nimport { cutAll } from '../topology/booleanFns.js';\nimport { toVec3, type Vec3, type PointInput } from '../core/types.js';\nimport { vecScale, vecNormalize, vecCross } from '../core/vecOps.js';\nimport { extrude, revolve } from '../operations/extrudeFns.js';\nimport { sweep, complexExtrude, twistExtrude } from '../operations/sweepFns.js';\nimport { firstOrThrow, getAtOrThrow } from '../utils/arrayAccess.js';\nimport { bug } from '../core/errors.js';\nimport type { ExtrusionProfile, SweepOptions } from '../operations/extrudeUtils.js';\nimport { loft } from '../operations/loftFns.js';\nimport type { LoftOptions } from '../operations/loftFns.js';\nimport type {\n  ClosedWire,\n  Face,\n  OrientedFace,\n  Shape3D,\n  Shell,\n  Wire,\n  PlanarWire,\n} from '../core/shapeTypes.js';\nimport { createFace, createWire } from '../core/shapeTypes.js';\nimport type { PlanarFace } from '../core/validityTypes.js';\nimport type { SketchData } from '../2d/blueprints/lib.js';\nimport { curveStartPoint, curveTangentAt } from '../topology/curveFns.js';\nimport Sketch, { type SketchInterface } from './sketch.js';\nimport CompoundSketch from './compoundSketch.js';\n\n// ---------------------------------------------------------------------------\n// SketchData wrappers\n// ---------------------------------------------------------------------------\n\n/** Wrap SketchData into a Sketch instance. */\nexport function wrapSketchData(data: SketchData): Sketch {\n  const opts: { defaultOrigin?: PointInput; defaultDirection?: PointInput } = {};\n  if (data.defaultOrigin) opts.defaultOrigin = data.defaultOrigin;\n  if (data.defaultDirection) opts.defaultDirection = data.defaultDirection;\n  // SketchData.wire is produced by Drawing.sketchOnPlane on a closed planar profile.\n  const sketch = new Sketch(data.wire as ClosedWire & PlanarWire, opts);\n  if (data.baseFace) sketch.baseFace = data.baseFace;\n  return sketch;\n}\n\n/** Wrap an array of SketchData into a CompoundSketch. */\nexport function wrapSketchDataArray(dataArr: SketchData[]): CompoundSketch {\n  return new CompoundSketch(dataArr.map(wrapSketchData));\n}\n\n/**\n * Collapse a sketch-like (the `SketchInterface | Sketches` union that\n * `Drawing.sketchOnPlane` can return) to a single {@link Sketch} for use as a\n * loft or sweep section. A single-wire profile passes through; a multi-piece\n * profile keeps its first wire and disposes the rest, since loft/sweep sections\n * are single wires.\n */\nexport function asSketch(sketchLike: SketchInterface): Sketch {\n  if (sketchLike instanceof Sketch) return sketchLike;\n  const pieces = (sketchLike as { sketches?: unknown }).sketches;\n  if (Array.isArray(pieces)) {\n    const [first, ...rest] = pieces as Array<Sketch | CompoundSketch>;\n    if (first instanceof Sketch) {\n      for (const extra of rest) extra.delete();\n      return first;\n    }\n  }\n  bug('asSketch', 'Expected a single-wire profile to loft or sweep.');\n}\n\n// ---------------------------------------------------------------------------\n// Sketch operations (canonical implementations)\n// ---------------------------------------------------------------------------\n\n/** Build a face from a sketch's closed planar wire. */\nexport function sketchFace(sketch: Sketch): OrientedFace & PlanarFace {\n  let face: Face;\n  if (!sketch.baseFace) {\n    face = unwrap(makeFace(sketch.wire));\n  } else {\n    face = makeNewFaceWithinFace(sketch.baseFace, sketch.wire);\n  }\n  return face as OrientedFace & PlanarFace;\n}\n\n/** Return an independent clone of the sketch's wire. */\nexport function sketchWires(sketch: Sketch): Wire {\n  return createWire(unwrap(copyShape(sketch.wire.wrapped)));\n}\n\n/**\n * Revolve a sketch around an axis to produce a solid of revolution.\n *\n * @remarks Consumes the sketch — calling twice throws on the second call.\n */\nexport function sketchRevolve(\n  sketch: Sketch,\n  revolutionAxis?: PointInput,\n  { origin }: { origin?: PointInput } = {}\n): Shape3D {\n  const face = unwrap(makeFace(sketch.wire));\n  const center: Vec3 = origin ? toVec3(origin) : sketch.defaultOrigin;\n  const dir: Vec3 = revolutionAxis ? toVec3(revolutionAxis) : [0, 0, 1];\n  const solid = unwrap(revolve(face, center, dir));\n  face[Symbol.dispose](); // `.delete()` is a no-op on arena kernels; dispose the face\n  sketch.delete();\n  return solid;\n}\n\n/**\n * Extrude a sketch to a given distance.\n *\n * Supports profile (taper) extrusion via `extrusionProfile`, twist extrusion\n * via `twistAngle`, and direction/origin overrides.\n *\n * @remarks Consumes the sketch — calling twice throws on the second call.\n */\nexport function sketchExtrude(\n  sketch: Sketch,\n  extrusionDistance: number,\n  {\n    extrusionDirection,\n    extrusionProfile,\n    twistAngle,\n    origin,\n  }: {\n    extrusionDirection?: PointInput;\n    extrusionProfile?: ExtrusionProfile;\n    twistAngle?: number;\n    origin?: PointInput;\n  } = {}\n): Shape3D {\n  const direction: Vec3 = extrusionDirection ? toVec3(extrusionDirection) : sketch.defaultDirection;\n  const extrusionVec = vecScale(vecNormalize(direction), extrusionDistance);\n  const originVec: Vec3 = origin ? toVec3(origin) : sketch.defaultOrigin;\n\n  if (extrusionProfile && !twistAngle) {\n    const solid = unwrap(\n      complexExtrude(sketch.wire, [...originVec], [...extrusionVec], extrusionProfile)\n    );\n    sketch.delete();\n    return solid as Shape3D;\n  }\n\n  if (twistAngle) {\n    const solid = unwrap(\n      twistExtrude(sketch.wire, twistAngle, [...originVec], [...extrusionVec], extrusionProfile)\n    );\n    sketch.delete();\n    return solid as Shape3D;\n  }\n\n  const face = unwrap(makeFace(sketch.wire));\n  const solid = unwrap(extrude(face, [...extrusionVec]));\n  face[Symbol.dispose](); // extrude shares the face's TShape; release the intermediate\n  sketch.delete();\n  return solid;\n}\n\n/**\n * Sweep a profile sketch (built by `sketchOnPlane`) along this sketch's wire path.\n *\n * @remarks Consumes both this sketch and the one returned by `sketchOnPlane` —\n * calling either twice throws on the second call.\n */\nexport function sketchSweep(\n  sketch: Sketch,\n  sketchOnPlane: (plane: Plane, origin: Vec3) => SketchInterface,\n  sweepConfig: SweepOptions = {}\n): Shape3D {\n  const startPoint = curveStartPoint(sketch.wire);\n  const tangent = curveTangentAt(sketch.wire, 1e-9);\n  const normal = vecNormalize(vecScale(tangent, -1));\n  const defaultDir: Vec3 = sketch.defaultDirection;\n  const xDir = vecScale(vecCross(normal, defaultDir), -1);\n\n  // The callback may return a Sketches (plural) when the Drawing used a 2D\n  // boolean that split the profile into multiple pieces; asSketch extracts the\n  // first wire and disposes the rest to prevent WASM leaks.\n  const profile = asSketch(\n    sketchOnPlane(createPlane([...startPoint], [...xDir], [...normal]), [...startPoint])\n  );\n\n  const config: SweepOptions = {\n    forceProfileSpineOthogonality: true,\n    ...sweepConfig,\n  };\n  if (sketch.baseFace) {\n    config.support = sketch.baseFace.wrapped;\n  }\n  const shape = unwrap(sweep(profile.wire, sketch.wire, config)) as Shape3D;\n  sketch.delete();\n\n  return shape;\n}\n\n/**\n * Loft between this sketch and one or more other sketches.\n *\n * @remarks Consumes all input sketches — calling twice throws on the second call.\n */\nexport function sketchLoft(\n  sketch: Sketch,\n  otherSketches: SketchInterface | SketchInterface[],\n  loftConfig: LoftOptions = {},\n  returnShell = false\n): Shape3D {\n  const others = (Array.isArray(otherSketches) ? otherSketches : [otherSketches]).map(asSketch);\n  const sketchArray = [sketch, ...others];\n  const shape = unwrap(\n    loft(\n      sketchArray.map((s) => s.wire),\n      loftConfig,\n      returnShell\n    )\n  );\n\n  sketchArray.forEach((s) => {\n    s.delete();\n  });\n  return shape;\n}\n\n// ---------------------------------------------------------------------------\n// CompoundSketch operations (canonical implementations)\n// ---------------------------------------------------------------------------\n\n/**\n * Build a holed twist/profile-extruded solid by extruding the outer boundary\n * and each hole wire as independent solids, then boolean-subtracting the holes.\n *\n * A single-wire twist/profile sweep already yields a valid, consistently-\n * oriented solid. The previous approach assembled the per-wire lateral *shells*\n * plus shared caps into one solid, which produced an inconsistently-oriented\n * (invalid) result whose signed volume even flipped sign between occt-wasm\n * versions — the cause of the #1366 twist/profile compound-extrude failure\n * under occt-wasm 3.3.0. Subtracting valid solids is robust to kernel\n * orientation conventions.\n */\nconst holedSweptSolid = (\n  sketches: Sketch[],\n  solidGenerator: (sketch: Sketch) => Result<Shape3D>\n): Shape3D => {\n  const outer = unwrap(solidGenerator(firstOrThrow(sketches)));\n  const holes = sketches.slice(1).map((s) => unwrap(solidGenerator(s)));\n  if (holes.length === 0) return outer;\n  try {\n    return unwrap(cutAll(outer, holes, { unsafe: true }));\n  } finally {\n    // cutAll is immutable and doesn't consume its inputs, so the per-wire\n    // intermediates must be disposed or each hole leaks a WASM solid per call.\n    outer.delete();\n    for (const h of holes) h.delete();\n  }\n};\n\n/** Build a face from a compound sketch (outer boundary with holes). */\nexport function compoundSketchFace(sketch: CompoundSketch): OrientedFace & PlanarFace {\n  const baseFace = sketch.outerSketch.face();\n  const newFace = addHolesInFace(\n    baseFace,\n    sketch.innerSketches.map((s) => s.wire)\n  );\n  // addHolesInFace returns a fresh face sharing baseFace's TShape — release the\n  // orphaned base (its slot would otherwise leak on arena kernels).\n  baseFace[Symbol.dispose]();\n  return newFace as OrientedFace & PlanarFace;\n}\n\n/** Return all wires (outer + holes) combined into a compound shape. */\nexport function compoundSketchWires(sketch: CompoundSketch) {\n  const wires = sketch.sketches.map((s) => s.wire);\n  return makeCompound(wires);\n}\n\n/**\n * Extrude a compound sketch (outer + holes) along the default or given direction.\n *\n * Supports twist and profile extrusions. For twist/profile modes each\n * sub-sketch is extruded as a shell, then capped into a solid.\n */\nexport function compoundSketchExtrude(\n  sketch: CompoundSketch,\n  extrusionDistance: number,\n  {\n    extrusionDirection,\n    extrusionProfile,\n    twistAngle,\n    origin,\n  }: {\n    extrusionDirection?: PointInput;\n    extrusionProfile?: ExtrusionProfile;\n    twistAngle?: number;\n    origin?: PointInput;\n  } = {}\n): Shape3D {\n  const rawVec: Vec3 = extrusionDirection\n    ? toVec3(extrusionDirection)\n    : sketch.outerSketch.defaultDirection;\n  const normVec = vecNormalize(rawVec);\n  const extrusionVec = vecScale(normVec, extrusionDistance);\n\n  if (extrusionProfile && !twistAngle) {\n    return holedSweptSolid(\n      sketch.sketches,\n      (s: Sketch) =>\n        complexExtrude(\n          s.wire,\n          origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin,\n          extrusionVec,\n          extrusionProfile\n        ) as Result<Shape3D> // solid mode (shellMode omitted)\n    );\n  }\n  if (twistAngle) {\n    return holedSweptSolid(\n      sketch.sketches,\n      (s: Sketch) =>\n        twistExtrude(\n          s.wire,\n          twistAngle,\n          origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin,\n          extrusionVec,\n          extrusionProfile\n        ) as Result<Shape3D> // solid mode (shellMode omitted)\n    );\n  }\n  const face = compoundSketchFace(sketch);\n  const solid = unwrap(extrude(face, extrusionVec));\n  face[Symbol.dispose](); // extrude shares the face's TShape; release the intermediate\n  return solid;\n}\n\n/** Revolve a compound sketch (outer + holes) around an axis. */\nexport function compoundSketchRevolve(\n  sketch: CompoundSketch,\n  revolutionAxis?: PointInput,\n  { origin }: { origin?: PointInput } = {}\n): Shape3D {\n  const center = origin ? toVec3(origin) : sketch.outerSketch.defaultOrigin;\n  const dir = revolutionAxis ? toVec3(revolutionAxis) : ([0, 0, 1] as Vec3);\n  const face = compoundSketchFace(sketch);\n  const solid = unwrap(revolve(face, center, dir));\n  face[Symbol.dispose](); // `.delete()` no-op on arena kernels; dispose the face\n  return solid;\n}\n\n/** Loft between two compound sketches with matching sub-sketch counts. */\nexport function compoundSketchLoft(\n  sketch: CompoundSketch,\n  other: CompoundSketch,\n  loftConfig: LoftOptions = {}\n): Shape3D {\n  if (sketch.sketches.length !== other.sketches.length)\n    bug(\n      'CompoundSketch.loftWith',\n      'You need to loft with another compound with the same number of sketches'\n    );\n\n  const shells: Array<Shell | Face> = sketch.sketches.map((base, cIndex) => {\n    const outer = getAtOrThrow(other.sketches, cIndex);\n    const loftOpts: LoftOptions = {};\n    if (loftConfig.ruled !== undefined) loftOpts.ruled = loftConfig.ruled;\n    return base.clone().loftWith(outer.clone(), loftOpts, true) as Shell;\n  });\n\n  const baseFaceRaw = compoundSketchFace(sketch);\n  const baseFace = createFace(unwrap(copyShape(baseFaceRaw.wrapped)));\n  baseFaceRaw[Symbol.dispose](); // orphaned once copied\n  shells.push(baseFace, compoundSketchFace(other));\n\n  const solid = unwrap(makeSolid(shells));\n  // makeSolid sews the shells/caps into a closed solid (shared refcounted\n  // TShapes); release the intermediates once it has consumed them.\n  for (const sh of shells) sh[Symbol.dispose]();\n  return solid;\n}\n"]}

package/dist/vendored/brepjs/sketching/sketcher.d.ts

@@ -0,0 +1,70 @@
+import type { Plane, PlaneName } from '../core/planeTypes.js';
+import { type Point2D } from '../2d/lib/index.js';
+import type { GenericSketcher } from '../2d/blueprints/genericSketcher.js';
+import type { Wire } from '../core/shapeTypes.js';
+import type { PointInput } from '../core/types.js';
+import type { Curve2D } from '../2d/lib/index.js';
+import Sketch from './sketch.js';
+import { BaseSketcher2d } from '../2d/blueprints/baseSketcher2d.js';
+/**
+ * Build 2D wire profiles on a 3D plane using a builder-pen API.
+ *
+ * The Sketcher accumulates 2D curves in the local coordinate system of the
+ * chosen plane, then lifts them to 3D edges at finalization.
+ *
+ * @example
+ * ```ts
+ * const sketch = new Sketcher("XZ", 5)
+ *   .hLine(20)
+ *   .vLine(10)
+ *   .hLine(-20)
+ *   .close();
+ * const solid = sketch.extrude(8);
+ * ```
+ *
+ * @see {@link FaceSketcher} for sketching on non-planar surfaces.
+ * @see {@link DrawingPen} for the pure-2D equivalent.
+ * @category Sketching
+ */
+export default class Sketcher extends BaseSketcher2d implements GenericSketcher<Sketch> {
+    protected plane: Plane;
+    /**
+     * The sketcher can be defined by a plane, or a simple plane definition,
+     * with either a point of origin, or the position on the normal axis from
+     * the coordinates origin
+     */
+    constructor(plane: Plane);
+    constructor(plane?: PlaneName, origin?: PointInput | number);
+    /** Release resources held by this sketcher (lightweight — no kernel handles during drawing). */
+    delete(): void;
+    /**
+     * Override to preserve the original Sketcher's sagitta direction convention.
+     *
+     * BaseSketcher2d computes the perpendicular as `[-dy, dx]` (counter-clockwise rotation),
+     * but the original Sketcher used `cross(diff, plane.zDir)` which produces `[dy, -dx]`
+     * (clockwise rotation) for standard planes. Negating the sagitta compensates for this,
+     * ensuring all sagitta/bulge arcs curve the same way as the original 3D implementation.
+     */
+    sagittaArcTo(end: Point2D, sagitta: number): this;
+    protected buildWire(): Wire;
+    /** Finish drawing and return the open-wire Sketch (does not close the path). */
+    done(): Sketch;
+    /** Close the path with a straight line to the start point and return the Sketch. */
+    close(): Sketch;
+    /**
+     * Close the path by mirroring all edges about the line from first to last point.
+     *
+     * Mirrors in 3D after assembling the partial wire to ensure exact endpoint
+     * matching across kernels.
+     */
+    closeWithMirror(): Sketch;
+    /**
+     * 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: number | ((f: Curve2D, s: Curve2D) => Curve2D[]), mode?: 'fillet' | 'chamfer' | 'dogbone'): Sketch;
+}
+//# sourceMappingURL=sketcher.d.ts.map

package/dist/vendored/brepjs/sketching/sketcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketcher.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/sketcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAc,MAAM,uBAAuB,CAAC;AAQ1E,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAA0B,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,cAAe,YAAW,eAAe,CAAC,MAAM,CAAC;IACrF,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IAEvB;;;;OAIG;gBACS,KAAK,EAAE,KAAK;gBACZ,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM;IAS3D,gGAAgG;IAChG,MAAM,IAAI,IAAI;IAId;;;;;;;OAOG;IACM,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1D,SAAS,CAAC,SAAS,IAAI,IAAI;IAU3B,gFAAgF;IAChF,IAAI,IAAI,MAAM;IASd,oFAAoF;IACpF,KAAK,IAAI,MAAM;IAKf;;;;;OAKG;IACH,eAAe,IAAI,MAAM;IA4BzB;;;;;;OAMG;IACH,qBAAqB,CACnB,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC,EACxD,IAAI,GAAE,QAAQ,GAAG,SAAS,GAAG,SAAoB,GAChD,MAAM;CAKV"}

package/dist/vendored/brepjs/sketching/sketcher.js

@@ -0,0 +1,181 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { resolvePlane } from '../core/planeOps.js';
+import { unwrap } from '../core/result.js';
+import { bug } from '../core/errors.js';
+import { DisposalScope } from '../core/disposal.js';
+import { vecSub, vecNormalize, vecCross } from '../core/vecOps.js';
+import { assembleWire } from '../topology/shapeHelpers.js';
+import { curvesAsEdgesOnPlane } from '../2d/curves.js';
+import { samePoint } from '../2d/lib/index.js';
+import { createWire } from '../core/shapeTypes.js';
+import { downcast } from '../topology/cast.js';
+import { getKernel } from '../kernel/index.js';
+import { toVec3 } from '../core/types.js';
+import { planeToWorld } from '../core/planeOps.js';
+import Sketch from './sketch.js';
+import { BaseSketcher2d } from '../2d/blueprints/baseSketcher2d.js';
+/**
+ * Build 2D wire profiles on a 3D plane using a builder-pen API.
+ *
+ * The Sketcher accumulates 2D curves in the local coordinate system of the
+ * chosen plane, then lifts them to 3D edges at finalization.
+ *
+ * @example
+ * ```ts
+ * const sketch = new Sketcher("XZ", 5)
+ *   .hLine(20)
+ *   .vLine(10)
+ *   .hLine(-20)
+ *   .close();
+ * const solid = sketch.extrude(8);
+ * ```
+ *
+ * @see {@link FaceSketcher} for sketching on non-planar surfaces.
+ * @see {@link DrawingPen} for the pure-2D equivalent.
+ * @category Sketching
+ */
+export default class Sketcher extends BaseSketcher2d {
+    plane;
+    constructor(plane, origin) {
+        super();
+        this.plane =
+            plane && typeof plane !== 'string'
+                ? { ...plane }
+                : unwrap(resolvePlane(plane ?? 'XY', origin));
+    }
+    /** Release resources held by this sketcher (lightweight — no kernel handles during drawing). */
+    delete() {
+        this.pendingCurves = [];
+    }
+    /**
+     * Override to preserve the original Sketcher's sagitta direction convention.
+     *
+     * BaseSketcher2d computes the perpendicular as `[-dy, dx]` (counter-clockwise rotation),
+     * but the original Sketcher used `cross(diff, plane.zDir)` which produces `[dy, -dx]`
+     * (clockwise rotation) for standard planes. Negating the sagitta compensates for this,
+     * ensuring all sagitta/bulge arcs curve the same way as the original 3D implementation.
+     */
+    sagittaArcTo(end, sagitta) {
+        return super.sagittaArcTo(end, -sagitta);
+    }
+    buildWire() {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            if (!this.pendingCurves.length)
+                bug('Sketcher.buildWire', 'No lines to convert into a wire');
+            const scope = __addDisposableResource(env_1, new DisposalScope(), false);
+            const edges = curvesAsEdgesOnPlane(this.pendingCurves, this.plane).map((e) => scope.register(e));
+            return unwrap(assembleWire(edges));
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            __disposeResources(env_1);
+        }
+    }
+    /** Finish drawing and return the open-wire Sketch (does not close the path). */
+    done() {
+        // The wire's closure is the user's contract — done() doesn't enforce it.
+        // Sketcher operates on a plane → planar by construction.
+        return new Sketch(this.buildWire(), {
+            defaultOrigin: this.plane.origin,
+            defaultDirection: this.plane.zDir,
+        });
+    }
+    /** 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 edges about the line from first to last point.
+     *
+     * Mirrors in 3D after assembling the partial wire to ensure exact endpoint
+     * matching across kernels.
+     */
+    closeWithMirror() {
+        if (samePoint(this.pointer, this.firstPoint))
+            bug('Sketcher.closeWithMirror', 'Cannot close with a mirror when the sketch is already closed');
+        const wire = this.buildWire();
+        const pointer3d = planeToWorld(this.plane, this.pointer);
+        const firstPoint3d = planeToWorld(this.plane, this.firstPoint);
+        const diff = vecSub(pointer3d, firstPoint3d);
+        const startToEndVector = vecNormalize(diff);
+        const normal = vecCross(startToEndVector, this.plane.zDir);
+        const clonedWrapped = unwrap(downcast(wire.wrapped));
+        const mirroredRaw = getKernel().mirror(clonedWrapped, toVec3(pointer3d), toVec3(normal));
+        const mirroredWrapped = unwrap(downcast(mirroredRaw));
+        const mirroredWire = createWire(mirroredWrapped);
+        const combinedWire = unwrap(assembleWire([wire, mirroredWire]));
+        return new Sketch(combinedWire, {
+            defaultOrigin: this.plane.origin,
+            defaultDirection: this.plane.zDir,
+        });
+    }
+    /**
+     * 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();
+    }
+}
+//# sourceMappingURL=sketcher.js.map

package/dist/vendored/brepjs/sketching/sketcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketcher.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/sketcher.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Plane, PlaneName, PlaneInput } from '../core/planeTypes.js';\nimport { resolvePlane } from '../core/planeOps.js';\nimport { unwrap } from '../core/result.js';\nimport { bug } from '../core/errors.js';\nimport { DisposalScope } from '../core/disposal.js';\nimport { vecSub, vecNormalize, vecCross } from '../core/vecOps.js';\nimport { assembleWire } from '../topology/shapeHelpers.js';\nimport { curvesAsEdgesOnPlane } from '../2d/curves.js';\nimport { samePoint, type Point2D } from '../2d/lib/index.js';\nimport type { GenericSketcher } from '../2d/blueprints/genericSketcher.js';\nimport type { ClosedWire, PlanarWire, Wire } from '../core/shapeTypes.js';\nimport { createWire } from '../core/shapeTypes.js';\nimport type { PointInput } from '../core/types.js';\nimport type { Curve2D } from '../2d/lib/index.js';\nimport { downcast } from '../topology/cast.js';\nimport { getKernel } from '../kernel/index.js';\nimport { toVec3 } from '../core/types.js';\nimport { planeToWorld } from '../core/planeOps.js';\nimport Sketch from './sketch.js';\nimport { BaseSketcher2d } from '../2d/blueprints/baseSketcher2d.js';\n\n/**\n * Build 2D wire profiles on a 3D plane using a builder-pen API.\n *\n * The Sketcher accumulates 2D curves in the local coordinate system of the\n * chosen plane, then lifts them to 3D edges at finalization.\n *\n * @example\n * ```ts\n * const sketch = new Sketcher(\"XZ\", 5)\n *   .hLine(20)\n *   .vLine(10)\n *   .hLine(-20)\n *   .close();\n * const solid = sketch.extrude(8);\n * ```\n *\n * @see {@link FaceSketcher} for sketching on non-planar surfaces.\n * @see {@link DrawingPen} for the pure-2D equivalent.\n * @category Sketching\n */\nexport default class Sketcher extends BaseSketcher2d implements GenericSketcher<Sketch> {\n  protected plane: Plane;\n\n  /**\n   * The sketcher can be defined by a plane, or a simple plane definition,\n   * with either a point of origin, or the position on the normal axis from\n   * the coordinates origin\n   */\n  constructor(plane: Plane);\n  constructor(plane?: PlaneName, origin?: PointInput | number);\n  constructor(plane?: PlaneInput, origin?: PointInput | number) {\n    super();\n    this.plane =\n      plane && typeof plane !== 'string'\n        ? { ...plane }\n        : unwrap(resolvePlane(plane ?? 'XY', origin));\n  }\n\n  /** Release resources held by this sketcher (lightweight — no kernel handles during drawing). */\n  delete(): void {\n    this.pendingCurves = [];\n  }\n\n  /**\n   * Override to preserve the original Sketcher's sagitta direction convention.\n   *\n   * BaseSketcher2d computes the perpendicular as `[-dy, dx]` (counter-clockwise rotation),\n   * but the original Sketcher used `cross(diff, plane.zDir)` which produces `[dy, -dx]`\n   * (clockwise rotation) for standard planes. Negating the sagitta compensates for this,\n   * ensuring all sagitta/bulge arcs curve the same way as the original 3D implementation.\n   */\n  override sagittaArcTo(end: Point2D, sagitta: number): this {\n    return super.sagittaArcTo(end, -sagitta);\n  }\n\n  protected buildWire(): Wire {\n    if (!this.pendingCurves.length) bug('Sketcher.buildWire', 'No lines to convert into a wire');\n\n    using scope = new DisposalScope();\n    const edges = curvesAsEdgesOnPlane(this.pendingCurves, this.plane).map((e) =>\n      scope.register(e)\n    );\n    return unwrap(assembleWire(edges));\n  }\n\n  /** Finish drawing and return the open-wire Sketch (does not close the path). */\n  done(): Sketch {\n    // The wire's closure is the user's contract — done() doesn't enforce it.\n    // Sketcher operates on a plane → planar by construction.\n    return new Sketch(this.buildWire() as ClosedWire & PlanarWire, {\n      defaultOrigin: this.plane.origin,\n      defaultDirection: this.plane.zDir,\n    });\n  }\n\n  /** Close the path with a straight line to the start point and return the Sketch. */\n  close(): Sketch {\n    this._closeSketch();\n    return this.done();\n  }\n\n  /**\n   * Close the path by mirroring all edges about the line from first to last point.\n   *\n   * Mirrors in 3D after assembling the partial wire to ensure exact endpoint\n   * matching across kernels.\n   */\n  closeWithMirror(): Sketch {\n    if (samePoint(this.pointer, this.firstPoint))\n      bug(\n        'Sketcher.closeWithMirror',\n        'Cannot close with a mirror when the sketch is already closed'\n      );\n\n    const wire = this.buildWire();\n\n    const pointer3d = planeToWorld(this.plane, this.pointer);\n    const firstPoint3d = planeToWorld(this.plane, this.firstPoint);\n    const diff = vecSub(pointer3d, firstPoint3d);\n    const startToEndVector = vecNormalize(diff);\n    const normal = vecCross(startToEndVector, this.plane.zDir);\n\n    const clonedWrapped = unwrap(downcast(wire.wrapped));\n    const mirroredRaw = getKernel().mirror(clonedWrapped, toVec3(pointer3d), toVec3(normal));\n    const mirroredWrapped = unwrap(downcast(mirroredRaw));\n    const mirroredWire = createWire(mirroredWrapped);\n\n    const combinedWire = unwrap(assembleWire([wire, mirroredWire]));\n\n    return new Sketch(combinedWire as ClosedWire & PlanarWire, {\n      defaultOrigin: this.plane.origin,\n      defaultDirection: this.plane.zDir,\n    });\n  }\n\n  /**\n   * Close the path and apply a custom corner treatment between the last and first segments.\n   *\n   * @param radius - Fillet/chamfer radius, or a custom corner function.\n   * @param mode - Corner treatment type.\n   * @returns The closed {@link Sketch}.\n   */\n  closeWithCustomCorner(\n    radius: number | ((f: Curve2D, s: Curve2D) => Curve2D[]),\n    mode: 'fillet' | 'chamfer' | 'dogbone' = 'fillet'\n  ): Sketch {\n    this._closeSketch();\n    this._customCornerLastWithFirst(radius, mode);\n    return this.done();\n  }\n}\n"]}