@faicad/faijs 0.13.0

package/dist/vendored/brepjs/2d/blueprints/blueprintSketcher.d.ts

@@ -0,0 +1,30 @@
+import type { Curve2D, Point2D } from '../../2d/lib/index.js';
+import Blueprint from './blueprint.js';
+import { BaseSketcher2d } from './baseSketcher2d.js';
+import type { GenericSketcher } from './genericSketcher.js';
+/**
+ * Draw 2D curves and produce a {@link Blueprint} (pure-2D shape, no kernel wire).
+ *
+ * Use this when you need a reusable 2D profile that can later be sketched onto
+ * different planes or faces.
+ *
+ * @category Sketching
+ */
+export declare class BlueprintSketcher extends BaseSketcher2d implements GenericSketcher<Blueprint> {
+    constructor(origin?: Point2D);
+    /** Finish drawing and return the resulting {@link Blueprint} (does not close the path). */
+    done(): Blueprint;
+    /** Close the path with a straight line to the start point and return the Blueprint. */
+    close(): Blueprint;
+    /** Close the path by mirroring all curves about the line from first to last point. */
+    closeWithMirror(): Blueprint;
+    /**
+     * Close the path and apply a custom corner treatment between the last and first segments.
+     *
+     * @param radius - Fillet/chamfer radius.
+     * @param mode - Corner treatment type.
+     * @returns The closed {@link Blueprint}.
+     */
+    closeWithCustomCorner(radius: number | ((f: Curve2D, s: Curve2D) => Curve2D[]), mode?: 'fillet' | 'chamfer' | 'dogbone'): Blueprint;
+}
+//# sourceMappingURL=blueprintSketcher.d.ts.map

package/dist/vendored/brepjs/2d/blueprints/blueprintSketcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprintSketcher.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/blueprintSketcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,cAAe,YAAW,eAAe,CAAC,SAAS,CAAC;gBAC7E,MAAM,GAAE,OAAgB;IAQpC,2FAA2F;IAC3F,IAAI,IAAI,SAAS;IAIjB,uFAAuF;IACvF,KAAK,IAAI,SAAS;IAKlB,sFAAsF;IACtF,eAAe,IAAI,SAAS;IAK5B;;;;;;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,SAAS;CAMb"}

package/dist/vendored/brepjs/2d/blueprints/blueprintSketcher.js

@@ -0,0 +1,45 @@
+import Blueprint from './blueprint.js';
+import { BaseSketcher2d } from './baseSketcher2d.js';
+/**
+ * Draw 2D curves and produce a {@link Blueprint} (pure-2D shape, no kernel wire).
+ *
+ * Use this when you need a reusable 2D profile that can later be sketched onto
+ * different planes or faces.
+ *
+ * @category Sketching
+ */
+export class BlueprintSketcher extends BaseSketcher2d {
+    constructor(origin = [0, 0]) {
+        super();
+        this.pointer = origin;
+        this.firstPoint = origin;
+        this.pendingCurves = [];
+    }
+    /** Finish drawing and return the resulting {@link Blueprint} (does not close the path). */
+    done() {
+        return new Blueprint(this.pendingCurves);
+    }
+    /** Close the path with a straight line to the start point and return the Blueprint. */
+    close() {
+        this._closeSketch();
+        return this.done();
+    }
+    /** Close the path by mirroring all curves about the line from first to last point. */
+    closeWithMirror() {
+        this._closeWithMirror();
+        return this.close();
+    }
+    /**
+     * Close the path and apply a custom corner treatment between the last and first segments.
+     *
+     * @param radius - Fillet/chamfer radius.
+     * @param mode - Corner treatment type.
+     * @returns The closed {@link Blueprint}.
+     */
+    closeWithCustomCorner(radius, mode = 'fillet') {
+        this._closeSketch();
+        this._customCornerLastWithFirst(radius, mode);
+        return this.done();
+    }
+}
+//# sourceMappingURL=blueprintSketcher.js.map

package/dist/vendored/brepjs/2d/blueprints/blueprintSketcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprintSketcher.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/blueprintSketcher.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,SAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QAEzB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,2FAA2F;IAC3F,IAAI;QACF,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,uFAAuF;IACvF,KAAK;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,sFAAsF;IACtF,eAAe;QACb,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACnB,MAAwD,EACxD,OAAyC,QAAQ;QAEjD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF","sourcesContent":["import type { Curve2D, Point2D } from '../../2d/lib/index.js';\nimport Blueprint from './blueprint.js';\nimport { BaseSketcher2d } from './baseSketcher2d.js';\nimport type { GenericSketcher } from './genericSketcher.js';\n\n/**\n * Draw 2D curves and produce a {@link Blueprint} (pure-2D shape, no kernel wire).\n *\n * Use this when you need a reusable 2D profile that can later be sketched onto\n * different planes or faces.\n *\n * @category Sketching\n */\nexport class BlueprintSketcher extends BaseSketcher2d implements GenericSketcher<Blueprint> {\n  constructor(origin: Point2D = [0, 0]) {\n    super();\n    this.pointer = origin;\n    this.firstPoint = origin;\n\n    this.pendingCurves = [];\n  }\n\n  /** Finish drawing and return the resulting {@link Blueprint} (does not close the path). */\n  done(): Blueprint {\n    return new Blueprint(this.pendingCurves);\n  }\n\n  /** Close the path with a straight line to the start point and return the Blueprint. */\n  close(): Blueprint {\n    this._closeSketch();\n    return this.done();\n  }\n\n  /** Close the path by mirroring all curves about the line from first to last point. */\n  closeWithMirror(): Blueprint {\n    this._closeWithMirror();\n    return this.close();\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.\n   * @param mode - Corner treatment type.\n   * @returns The closed {@link Blueprint}.\n   */\n  closeWithCustomCorner(\n    radius: number | ((f: Curve2D, s: Curve2D) => Curve2D[]),\n    mode: 'fillet' | 'chamfer' | 'dogbone' = 'fillet'\n  ): Blueprint {\n    this._closeSketch();\n    this._customCornerLastWithFirst(radius, mode);\n\n    return this.done();\n  }\n}\n"]}

package/dist/vendored/brepjs/2d/blueprints/blueprints.d.ts

@@ -0,0 +1,68 @@
+import type { Point2D } from '../../2d/lib/index.js';
+import { BoundingBox2d } from '../../2d/lib/index.js';
+import Blueprint from './blueprint.js';
+import type CompoundBlueprint from './compoundBlueprint.js';
+import type { DrawingInterface, SketchData } from './lib.js';
+import type { AnyShape, Dimension, Face } from '../../core/shapeTypes.js';
+import type { Plane, PlaneName } from '../../core/planeTypes.js';
+import type { PointInput } from '../../core/types.js';
+import type { ScaleMode } from '../../2d/curves.js';
+import type { SingleFace } from '../../query/helpers.js';
+/**
+ * Hold a collection of disjoint 2D profiles (simple or compound).
+ *
+ * Unlike {@link CompoundBlueprint}, the child blueprints here are independent
+ * shapes -- none is treated as a hole in another. `Blueprints` is the typical
+ * result of boolean operations that produce multiple disconnected regions.
+ *
+ * @see {@link Blueprint} for a single contiguous profile.
+ * @see {@link CompoundBlueprint} for a profile with holes.
+ */
+export default class Blueprints implements DrawingInterface {
+    /** The independent profiles in this collection. */
+    blueprints: Array<Blueprint | CompoundBlueprint>;
+    protected _boundingBox: BoundingBox2d | null;
+    /** Create a collection from an array of blueprints and/or compound blueprints. */
+    constructor(blueprints: Array<Blueprint | CompoundBlueprint>);
+    /** Release the resources held by every child blueprint and the cached bounding box. */
+    delete(): void;
+    [Symbol.dispose](): void;
+    /** Return a multi-line debug representation of every child blueprint. */
+    get repr(): string;
+    /** Return a deep copy of this collection and all its children. */
+    clone(): Blueprints;
+    /** Compute (and cache) the combined bounding box of all child blueprints. */
+    get boundingBox(): BoundingBox2d;
+    /** Stretch all child blueprints along a direction by a given ratio. */
+    stretch(ratio: number, direction: Point2D, origin: Point2D): Blueprints;
+    /** Rotate all child blueprints by an angle in degrees. */
+    rotate(angle: number, center?: Point2D): Blueprints;
+    /** Uniformly scale all child blueprints around a center point. */
+    scale(scaleFactor: number, center?: Point2D): Blueprints;
+    /** Translate all child blueprints by separate x/y distances or a vector. */
+    translate(xDist: number, yDist: number): Blueprints;
+    translate(translationVector: Point2D): Blueprints;
+    /** Mirror all child blueprints across a point or plane. */
+    mirror(centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Blueprints;
+    /** Project all child blueprints onto a 3D plane. */
+    sketchOnPlane(plane?: PlaneName | Plane, origin?: PointInput | number): (SketchData | SketchData[])[];
+    /** Map all child blueprints onto a 3D face's UV surface. */
+    sketchOnFace(face: Face, scaleMode?: ScaleMode): (SketchData | SketchData[])[];
+    /**
+     * Punch holes through a solid for each child blueprint in sequence.
+     *
+     * @returns The shape with all holes applied.
+     */
+    punchHole(shape: AnyShape<Dimension>, face: SingleFace, options?: {
+        height?: number;
+        origin?: PointInput;
+        draftAngle?: number;
+    }): AnyShape<Dimension>;
+    /** Compute the SVG `viewBox` attribute for this collection. */
+    toSVGViewBox(margin?: number): string;
+    /** Return nested SVG path `d` string arrays -- one sub-array per child. */
+    toSVGPaths(): string[][];
+    /** Render a complete SVG document string for all child blueprints. */
+    toSVG(margin?: number): string;
+}
+//# sourceMappingURL=blueprints.d.ts.map

package/dist/vendored/brepjs/2d/blueprints/blueprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprints.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/blueprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,gBAAgB;IACzD,mDAAmD;IACnD,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC,CAAC;IACjD,SAAS,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IAE7C,kFAAkF;gBACtE,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAK5D,uFAAuF;IACvF,MAAM,IAAI,IAAI;IAUd,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB,yEAAyE;IACzE,IAAI,IAAI,WAEP;IAED,kEAAkE;IAClE,KAAK,IAAI,UAAU;IAInB,6EAA6E;IAC7E,IAAI,WAAW,IAAI,aAAa,CAS/B;IAED,uEAAuE;IACvE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU;IAIvE,0DAA0D;IAC1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU;IAInD,kEAAkE;IAClE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU;IAKxD,4EAA4E;IAC5E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;IACnD,SAAS,CAAC,iBAAiB,EAAE,OAAO,GAAG,UAAU;IAWjD,2DAA2D;IAC3D,MAAM,CAAC,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU;IAI3F,oDAAoD;IACpD,aAAa,CACX,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,EACzB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAC3B,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,EAAE;IAIhC,4DAA4D;IAC5D,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,EAAE;IAI9E;;;;OAIG;IACH,SAAS,CACP,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;IASR,+DAA+D;IAC/D,YAAY,CAAC,MAAM,SAAI;IAIvB,2EAA2E;IAC3E,UAAU;IAIV,sEAAsE;IACtE,KAAK,CAAC,MAAM,SAAI;CAQjB"}

package/dist/vendored/brepjs/2d/blueprints/blueprints.js

@@ -0,0 +1,116 @@
+import { BoundingBox2d } from '../../2d/lib/index.js';
+import Blueprint from './blueprint.js';
+import { asSVG, viewbox } from './svg.js';
+/**
+ * Hold a collection of disjoint 2D profiles (simple or compound).
+ *
+ * Unlike {@link CompoundBlueprint}, the child blueprints here are independent
+ * shapes -- none is treated as a hole in another. `Blueprints` is the typical
+ * result of boolean operations that produce multiple disconnected regions.
+ *
+ * @see {@link Blueprint} for a single contiguous profile.
+ * @see {@link CompoundBlueprint} for a profile with holes.
+ */
+export default class Blueprints {
+    /** The independent profiles in this collection. */
+    blueprints;
+    _boundingBox;
+    /** Create a collection from an array of blueprints and/or compound blueprints. */
+    constructor(blueprints) {
+        this.blueprints = blueprints;
+        this._boundingBox = null;
+    }
+    /** Release the resources held by every child blueprint and the cached bounding box. */
+    delete() {
+        this.blueprints.forEach((bp) => {
+            bp.delete();
+        });
+        if (this._boundingBox) {
+            this._boundingBox.delete();
+            this._boundingBox = null;
+        }
+    }
+    [Symbol.dispose]() {
+        this.delete();
+    }
+    /** Return a multi-line debug representation of every child blueprint. */
+    get repr() {
+        return ['Blueprints', ...this.blueprints.map((b) => b.repr)].join('\n');
+    }
+    /** Return a deep copy of this collection and all its children. */
+    clone() {
+        return new Blueprints(this.blueprints.map((bp) => bp.clone()));
+    }
+    /** Compute (and cache) the combined bounding box of all child blueprints. */
+    get boundingBox() {
+        if (!this._boundingBox) {
+            const box = new BoundingBox2d();
+            this.blueprints.forEach((b) => {
+                box.add(b.boundingBox);
+            });
+            this._boundingBox = box;
+        }
+        return this._boundingBox;
+    }
+    /** Stretch all child blueprints along a direction by a given ratio. */
+    stretch(ratio, direction, origin) {
+        return new Blueprints(this.blueprints.map((bp) => bp.stretch(ratio, direction, origin)));
+    }
+    /** Rotate all child blueprints by an angle in degrees. */
+    rotate(angle, center) {
+        return new Blueprints(this.blueprints.map((bp) => bp.rotate(angle, center)));
+    }
+    /** Uniformly scale all child blueprints around a center point. */
+    scale(scaleFactor, center) {
+        const centerPoint = center || this.boundingBox.center;
+        return new Blueprints(this.blueprints.map((bp) => bp.scale(scaleFactor, centerPoint)));
+    }
+    translate(xDistOrPoint, yDist = 0) {
+        return new Blueprints(this.blueprints.map((bp) => typeof xDistOrPoint === 'number'
+            ? bp.translate(xDistOrPoint, yDist)
+            : bp.translate(xDistOrPoint)));
+    }
+    /** Mirror all child blueprints across a point or plane. */
+    mirror(centerOrDirection, origin, mode) {
+        return new Blueprints(this.blueprints.map((bp) => bp.mirror(centerOrDirection, origin, mode)));
+    }
+    /** Project all child blueprints onto a 3D plane. */
+    sketchOnPlane(plane, origin) {
+        return this.blueprints.map((bp) => bp.sketchOnPlane(plane, origin));
+    }
+    /** Map all child blueprints onto a 3D face's UV surface. */
+    sketchOnFace(face, scaleMode) {
+        return this.blueprints.map((bp) => bp.sketchOnFace(face, scaleMode));
+    }
+    /**
+     * Punch holes through a solid for each child blueprint in sequence.
+     *
+     * @returns The shape with all holes applied.
+     */
+    punchHole(shape, face, options = {}) {
+        let outShape = shape;
+        this.blueprints.forEach((b) => {
+            outShape = b.punchHole(outShape, face, options);
+        });
+        return outShape;
+    }
+    /** Compute the SVG `viewBox` attribute for this collection. */
+    toSVGViewBox(margin = 1) {
+        return viewbox(this.boundingBox, margin);
+    }
+    /** Return nested SVG path `d` string arrays -- one sub-array per child. */
+    toSVGPaths() {
+        return this.blueprints.map((bp) => bp.toSVGPaths());
+    }
+    /** Render a complete SVG document string for all child blueprints. */
+    toSVG(margin = 1) {
+        const elements = this.blueprints.map((bp) => {
+            if (bp instanceof Blueprint)
+                return bp.toSVGPath();
+            else
+                return bp.toSVGGroup();
+        });
+        return asSVG(elements.join('\n    '), this.boundingBox, margin);
+    }
+}
+//# sourceMappingURL=blueprints.js.map

package/dist/vendored/brepjs/2d/blueprints/blueprints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprints.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/blueprints.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Point2D } from '../../2d/lib/index.js';\nimport { BoundingBox2d } from '../../2d/lib/index.js';\nimport Blueprint from './blueprint.js';\nimport type CompoundBlueprint from './compoundBlueprint.js';\nimport type { DrawingInterface, SketchData } from './lib.js';\nimport { asSVG, viewbox } from './svg.js';\n\nimport type { AnyShape, Dimension, Face } from '../../core/shapeTypes.js';\n\nimport type { Plane, PlaneName } from '../../core/planeTypes.js';\nimport type { PointInput } from '../../core/types.js';\n\nimport type { ScaleMode } from '../../2d/curves.js';\nimport type { SingleFace } from '../../query/helpers.js';\n\n/**\n * Hold a collection of disjoint 2D profiles (simple or compound).\n *\n * Unlike {@link CompoundBlueprint}, the child blueprints here are independent\n * shapes -- none is treated as a hole in another. `Blueprints` is the typical\n * result of boolean operations that produce multiple disconnected regions.\n *\n * @see {@link Blueprint} for a single contiguous profile.\n * @see {@link CompoundBlueprint} for a profile with holes.\n */\nexport default class Blueprints implements DrawingInterface {\n  /** The independent profiles in this collection. */\n  blueprints: Array<Blueprint | CompoundBlueprint>;\n  protected _boundingBox: BoundingBox2d | null;\n\n  /** Create a collection from an array of blueprints and/or compound blueprints. */\n  constructor(blueprints: Array<Blueprint | CompoundBlueprint>) {\n    this.blueprints = blueprints;\n    this._boundingBox = null;\n  }\n\n  /** Release the resources held by every child blueprint and the cached bounding box. */\n  delete(): void {\n    this.blueprints.forEach((bp) => {\n      bp.delete();\n    });\n    if (this._boundingBox) {\n      this._boundingBox.delete();\n      this._boundingBox = null;\n    }\n  }\n\n  [Symbol.dispose](): void {\n    this.delete();\n  }\n\n  /** Return a multi-line debug representation of every child blueprint. */\n  get repr() {\n    return ['Blueprints', ...this.blueprints.map((b) => b.repr)].join('\\n');\n  }\n\n  /** Return a deep copy of this collection and all its children. */\n  clone(): Blueprints {\n    return new Blueprints(this.blueprints.map((bp) => bp.clone()));\n  }\n\n  /** Compute (and cache) the combined bounding box of all child blueprints. */\n  get boundingBox(): BoundingBox2d {\n    if (!this._boundingBox) {\n      const box = new BoundingBox2d();\n      this.blueprints.forEach((b) => {\n        box.add(b.boundingBox);\n      });\n      this._boundingBox = box;\n    }\n    return this._boundingBox;\n  }\n\n  /** Stretch all child blueprints along a direction by a given ratio. */\n  stretch(ratio: number, direction: Point2D, origin: Point2D): Blueprints {\n    return new Blueprints(this.blueprints.map((bp) => bp.stretch(ratio, direction, origin)));\n  }\n\n  /** Rotate all child blueprints by an angle in degrees. */\n  rotate(angle: number, center?: Point2D): Blueprints {\n    return new Blueprints(this.blueprints.map((bp) => bp.rotate(angle, center)));\n  }\n\n  /** Uniformly scale all child blueprints around a center point. */\n  scale(scaleFactor: number, center?: Point2D): Blueprints {\n    const centerPoint = center || this.boundingBox.center;\n    return new Blueprints(this.blueprints.map((bp) => bp.scale(scaleFactor, centerPoint)));\n  }\n\n  /** Translate all child blueprints by separate x/y distances or a vector. */\n  translate(xDist: number, yDist: number): Blueprints;\n  translate(translationVector: Point2D): Blueprints;\n  translate(xDistOrPoint: number | Point2D, yDist = 0): Blueprints {\n    return new Blueprints(\n      this.blueprints.map((bp) =>\n        typeof xDistOrPoint === 'number'\n          ? bp.translate(xDistOrPoint, yDist)\n          : bp.translate(xDistOrPoint)\n      )\n    );\n  }\n\n  /** Mirror all child blueprints across a point or plane. */\n  mirror(centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Blueprints {\n    return new Blueprints(this.blueprints.map((bp) => bp.mirror(centerOrDirection, origin, mode)));\n  }\n\n  /** Project all child blueprints onto a 3D plane. */\n  sketchOnPlane(\n    plane?: PlaneName | Plane,\n    origin?: PointInput | number\n  ): (SketchData | SketchData[])[] {\n    return this.blueprints.map((bp) => bp.sketchOnPlane(plane, origin));\n  }\n\n  /** Map all child blueprints onto a 3D face's UV surface. */\n  sketchOnFace(face: Face, scaleMode?: ScaleMode): (SketchData | SketchData[])[] {\n    return this.blueprints.map((bp) => bp.sketchOnFace(face, scaleMode));\n  }\n\n  /**\n   * Punch holes through a solid for each child blueprint in sequence.\n   *\n   * @returns The shape with all holes applied.\n   */\n  punchHole(\n    shape: AnyShape<Dimension>,\n    face: SingleFace,\n    options: {\n      height?: number;\n      origin?: PointInput;\n      draftAngle?: number;\n    } = {}\n  ) {\n    let outShape = shape;\n    this.blueprints.forEach((b) => {\n      outShape = b.punchHole(outShape, face, options);\n    });\n    return outShape;\n  }\n\n  /** Compute the SVG `viewBox` attribute for this collection. */\n  toSVGViewBox(margin = 1) {\n    return viewbox(this.boundingBox, margin);\n  }\n\n  /** Return nested SVG path `d` string arrays -- one sub-array per child. */\n  toSVGPaths() {\n    return this.blueprints.map((bp) => bp.toSVGPaths());\n  }\n\n  /** Render a complete SVG document string for all child blueprints. */\n  toSVG(margin = 1) {\n    const elements = this.blueprints.map((bp) => {\n      if (bp instanceof Blueprint) return bp.toSVGPath();\n      else return bp.toSVGGroup();\n    });\n\n    return asSVG(elements.join('\\n    '), this.boundingBox, margin);\n  }\n}\n"]}

package/dist/vendored/brepjs/2d/blueprints/boolean2D.d.ts

@@ -0,0 +1,68 @@
+import Blueprint from './blueprint.js';
+import Blueprints from './blueprints.js';
+import CompoundBlueprint from './compoundBlueprint.js';
+/**
+ * Union type for all 2D shape representations, including `null` for empty results.
+ *
+ * Used throughout the 2D boolean API as both input and output of operations.
+ */
+export type Shape2D = Blueprint | Blueprints | CompoundBlueprint | null;
+/**
+ * Compute the boolean union of two 2D shapes.
+ *
+ * Handles all combinations of {@link Blueprint}, {@link CompoundBlueprint},
+ * {@link Blueprints}, and `null`. When both inputs are simple blueprints the
+ * operation delegates to {@link fuseBlueprints}; compound and multi-blueprint
+ * cases are decomposed recursively.
+ *
+ * @param first - First operand (or `null` for empty).
+ * @param second - Second operand (or `null` for empty).
+ * @returns The fused shape, or `null` if both operands are empty.
+ *
+ * @example
+ * ```ts
+ * const union = fuse2D(circleBlueprint, squareBlueprint);
+ * ```
+ *
+ * @see {@link fuse2D} for the functional API.
+ */
+export declare const fuse2D: (first: Shape2D, second: Shape2D) => Blueprint | Blueprints | CompoundBlueprint | null;
+/**
+ * Compute the boolean difference of two 2D shapes (first minus second).
+ *
+ * Removes the region covered by `second` from `first`. When the tool is fully
+ * inside the base, the result is a {@link CompoundBlueprint} (base with a
+ * hole).
+ *
+ * @param first - Base shape to cut from.
+ * @param second - Tool shape to subtract.
+ * @returns The remaining shape, or `null` if nothing remains.
+ *
+ * @example
+ * ```ts
+ * const withHole = cut2D(outerRect, innerCircle);
+ * ```
+ *
+ * @see {@link cut2D} for the functional API.
+ */
+export declare const cut2D: (first: Shape2D, second: Shape2D) => Blueprint | Blueprints | CompoundBlueprint | null;
+/**
+ * Compute the boolean intersection of two 2D shapes.
+ *
+ * Returns only the region common to both shapes. Compound and multi-blueprint
+ * operands are decomposed recursively, with holes handled via complementary
+ * cut operations.
+ *
+ * @param first - First operand.
+ * @param second - Second operand.
+ * @returns The intersection shape, or `null` if the shapes do not overlap.
+ *
+ * @example
+ * ```ts
+ * const overlap = intersect2D(circle, rectangle);
+ * ```
+ *
+ * @see {@link intersect2D} for the functional API.
+ */
+export declare function intersect2D(first: Shape2D, second: Shape2D): Blueprint | Blueprints | CompoundBlueprint | null;
+//# sourceMappingURL=boolean2D.d.ts.map

package/dist/vendored/brepjs/2d/blueprints/boolean2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean2D.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/boolean2D.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AAMvD;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAAC;AAyLxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,GACjB,OAAO,OAAO,EACd,QAAQ,OAAO,KACd,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,IAmD/C,CAAC;AAaF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,GAChB,OAAO,OAAO,EACd,QAAQ,OAAO,KACd,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,IAiD/C,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GACd,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAoDnD"}