@faicad/faijs 0.13.0

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

@@ -0,0 +1,129 @@
+/**
+ * Standalone functions for Drawing operations.
+ * Wraps Drawing class methods as pure functions.
+ */
+/**
+ * Sketch a drawing onto a 3D plane, producing a Sketch or Sketches.
+ *
+ * @param drawing - The 2D drawing to project.
+ * @param inputPlane - Named plane or Plane object.
+ * @param origin - Origin offset on the plane.
+ * @returns A Sketch (single profile) or Sketches (multiple profiles).
+ *
+ * @see {@link Drawing.sketchOnPlane} for the OOP equivalent.
+ */
+export function drawingToSketchOnPlane(drawing, inputPlane, origin) {
+    if (origin !== undefined) {
+        return drawing.sketchOnPlane(inputPlane, origin);
+    }
+    if (typeof inputPlane === 'object') {
+        return drawing.sketchOnPlane(inputPlane);
+    }
+    return drawing.sketchOnPlane(inputPlane);
+}
+/**
+ * Fuse two drawings with a Boolean union.
+ *
+ * @param a - First drawing.
+ * @param b - Second drawing to merge.
+ * @returns A new Drawing containing the fused shape.
+ *
+ * @see {@link Drawing.fuse} for the OOP equivalent.
+ */
+export function drawingFuse(a, b) {
+    return a.fuse(b);
+}
+/**
+ * Cut one drawing from another with a Boolean subtraction.
+ *
+ * @param a - Base drawing.
+ * @param b - Drawing to subtract.
+ * @returns A new Drawing with `b` removed from `a`.
+ *
+ * @see {@link Drawing.cut} for the OOP equivalent.
+ */
+export function drawingCut(a, b) {
+    return a.cut(b);
+}
+/**
+ * Intersect two drawings with a Boolean intersection.
+ *
+ * @param a - First drawing.
+ * @param b - Second drawing.
+ * @returns A new Drawing containing only the overlapping region.
+ *
+ * @see {@link Drawing.intersect} for the OOP equivalent.
+ */
+export function drawingIntersect(a, b) {
+    return a.intersect(b);
+}
+/**
+ * Fillet corners of a drawing.
+ *
+ * @param drawing - The drawing to modify.
+ * @param radius - Fillet radius.
+ * @param filter - Optional corner filter to select which corners to fillet.
+ * @returns A new Drawing with filleted corners.
+ *
+ * @see {@link Drawing.fillet} for the OOP equivalent.
+ */
+export function drawingFillet(drawing, radius, filter) {
+    return drawing.fillet(radius, filter);
+}
+/**
+ * Chamfer corners of a drawing.
+ *
+ * @param drawing - The drawing to modify.
+ * @param radius - Chamfer distance.
+ * @param filter - Optional corner filter to select which corners to chamfer.
+ * @returns A new Drawing with chamfered corners.
+ *
+ * @see {@link Drawing.chamfer} for the OOP equivalent.
+ */
+export function drawingChamfer(drawing, radius, filter) {
+    return drawing.chamfer(radius, filter);
+}
+export function translateDrawing(drawing, dxOrVec, dy = 0) {
+    return typeof dxOrVec === 'number' ? drawing.translate(dxOrVec, dy) : drawing.translate(dxOrVec);
+}
+/**
+ * Rotate a drawing by an angle (in degrees) around an optional center point.
+ *
+ * @param drawing - The drawing to rotate.
+ * @param angle - Rotation angle in degrees.
+ * @param center - Optional center of rotation (defaults to origin).
+ * @returns A new rotated Drawing.
+ *
+ * @see {@link Drawing.rotate} for the OOP equivalent.
+ */
+export function rotateDrawing(drawing, angle, center) {
+    return drawing.rotate(angle, center);
+}
+/**
+ * Uniformly scale a drawing by a factor around an optional center point.
+ *
+ * @param drawing - The drawing to scale.
+ * @param factor - Scale factor.
+ * @param center - Optional center of scaling (defaults to origin).
+ * @returns A new scaled Drawing.
+ *
+ * @see {@link Drawing.scale} for the OOP equivalent.
+ */
+export function scaleDrawing(drawing, factor, center) {
+    return drawing.scale(factor, center);
+}
+/**
+ * Mirror a drawing about a point or a line defined by direction and origin.
+ *
+ * @param drawing - The drawing to mirror.
+ * @param centerOrDirection - Mirror center point or line direction.
+ * @param origin - Origin point when mirroring about a line.
+ * @param mode - `'center'` for point mirror, `'plane'` for line mirror.
+ * @returns A new mirrored Drawing.
+ *
+ * @see {@link Drawing.mirror} for the OOP equivalent.
+ */
+export function mirrorDrawing(drawing, centerOrDirection, origin, mode) {
+    return drawing.mirror(centerOrDirection, origin, mode);
+}
+//# sourceMappingURL=drawFns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drawFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/drawFns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,UAA8B,EAC9B,MAA4B;IAE5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,aAAa,CAAC,UAAuB,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,CAAU;IAChD,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,CAAU;IAC/C,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAU,EAAE,CAAU;IACrD,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAAc,EACd,MAA8C;IAE9C,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,MAAc,EACd,MAA8C;IAE9C,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAeD,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,OAAyB,EAAE,EAAE,GAAG,CAAC;IAClF,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACnG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,KAAa,EAAE,MAAgB;IAC7E,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,MAAc,EAAE,MAAgB;IAC7E,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,iBAA0B,EAC1B,MAAgB,EAChB,IAAyB;IAEzB,OAAO,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC","sourcesContent":["/**\n * Standalone functions for Drawing operations.\n * Wraps Drawing class methods as pure functions.\n */\n\nimport type { Point2D } from '../2d/lib/definitions.js';\nimport type { Drawing } from './drawing.js';\nimport type Sketches from './sketches.js';\nimport type { SketchInterface } from './sketch.js';\nimport type { CornerFinderFn } from '../query/finderFns.js';\nimport type { PointInput } from '../core/types.js';\nimport type { Plane, PlaneName } from '../core/planeTypes.js';\n\n/**\n * Sketch a drawing onto a 3D plane, producing a Sketch or Sketches.\n *\n * @param drawing - The 2D drawing to project.\n * @param inputPlane - Named plane or Plane object.\n * @param origin - Origin offset on the plane.\n * @returns A Sketch (single profile) or Sketches (multiple profiles).\n *\n * @see {@link Drawing.sketchOnPlane} for the OOP equivalent.\n */\nexport function drawingToSketchOnPlane(\n  drawing: Drawing,\n  inputPlane?: PlaneName | Plane,\n  origin?: PointInput | number\n): SketchInterface | Sketches {\n  if (origin !== undefined) {\n    return drawing.sketchOnPlane(inputPlane as PlaneName, origin);\n  }\n  if (typeof inputPlane === 'object') {\n    return drawing.sketchOnPlane(inputPlane);\n  }\n  return drawing.sketchOnPlane(inputPlane);\n}\n\n/**\n * Fuse two drawings with a Boolean union.\n *\n * @param a - First drawing.\n * @param b - Second drawing to merge.\n * @returns A new Drawing containing the fused shape.\n *\n * @see {@link Drawing.fuse} for the OOP equivalent.\n */\nexport function drawingFuse(a: Drawing, b: Drawing): Drawing {\n  return a.fuse(b);\n}\n\n/**\n * Cut one drawing from another with a Boolean subtraction.\n *\n * @param a - Base drawing.\n * @param b - Drawing to subtract.\n * @returns A new Drawing with `b` removed from `a`.\n *\n * @see {@link Drawing.cut} for the OOP equivalent.\n */\nexport function drawingCut(a: Drawing, b: Drawing): Drawing {\n  return a.cut(b);\n}\n\n/**\n * Intersect two drawings with a Boolean intersection.\n *\n * @param a - First drawing.\n * @param b - Second drawing.\n * @returns A new Drawing containing only the overlapping region.\n *\n * @see {@link Drawing.intersect} for the OOP equivalent.\n */\nexport function drawingIntersect(a: Drawing, b: Drawing): Drawing {\n  return a.intersect(b);\n}\n\n/**\n * Fillet corners of a drawing.\n *\n * @param drawing - The drawing to modify.\n * @param radius - Fillet radius.\n * @param filter - Optional corner filter to select which corners to fillet.\n * @returns A new Drawing with filleted corners.\n *\n * @see {@link Drawing.fillet} for the OOP equivalent.\n */\nexport function drawingFillet(\n  drawing: Drawing,\n  radius: number,\n  filter?: (c: CornerFinderFn) => CornerFinderFn\n): Drawing {\n  return drawing.fillet(radius, filter);\n}\n\n/**\n * Chamfer corners of a drawing.\n *\n * @param drawing - The drawing to modify.\n * @param radius - Chamfer distance.\n * @param filter - Optional corner filter to select which corners to chamfer.\n * @returns A new Drawing with chamfered corners.\n *\n * @see {@link Drawing.chamfer} for the OOP equivalent.\n */\nexport function drawingChamfer(\n  drawing: Drawing,\n  radius: number,\n  filter?: (c: CornerFinderFn) => CornerFinderFn\n): Drawing {\n  return drawing.chamfer(radius, filter);\n}\n\n/**\n * Translate a drawing by horizontal and vertical distances.\n *\n * @param drawing - The drawing to translate.\n * @param dx - Horizontal distance.\n * @param dy - Vertical distance.\n * @returns A new translated Drawing.\n *\n * @see {@link Drawing.translate} for the OOP equivalent.\n */\nexport function translateDrawing(drawing: Drawing, dx: number, dy: number): Drawing;\n/** Translate a drawing by a 2D vector. */\nexport function translateDrawing(drawing: Drawing, vector: Point2D): Drawing;\nexport function translateDrawing(drawing: Drawing, dxOrVec: number | Point2D, dy = 0): Drawing {\n  return typeof dxOrVec === 'number' ? drawing.translate(dxOrVec, dy) : drawing.translate(dxOrVec);\n}\n\n/**\n * Rotate a drawing by an angle (in degrees) around an optional center point.\n *\n * @param drawing - The drawing to rotate.\n * @param angle - Rotation angle in degrees.\n * @param center - Optional center of rotation (defaults to origin).\n * @returns A new rotated Drawing.\n *\n * @see {@link Drawing.rotate} for the OOP equivalent.\n */\nexport function rotateDrawing(drawing: Drawing, angle: number, center?: Point2D): Drawing {\n  return drawing.rotate(angle, center);\n}\n\n/**\n * Uniformly scale a drawing by a factor around an optional center point.\n *\n * @param drawing - The drawing to scale.\n * @param factor - Scale factor.\n * @param center - Optional center of scaling (defaults to origin).\n * @returns A new scaled Drawing.\n *\n * @see {@link Drawing.scale} for the OOP equivalent.\n */\nexport function scaleDrawing(drawing: Drawing, factor: number, center?: Point2D): Drawing {\n  return drawing.scale(factor, center);\n}\n\n/**\n * Mirror a drawing about a point or a line defined by direction and origin.\n *\n * @param drawing - The drawing to mirror.\n * @param centerOrDirection - Mirror center point or line direction.\n * @param origin - Origin point when mirroring about a line.\n * @param mode - `'center'` for point mirror, `'plane'` for line mirror.\n * @returns A new mirrored Drawing.\n *\n * @see {@link Drawing.mirror} for the OOP equivalent.\n */\nexport function mirrorDrawing(\n  drawing: Drawing,\n  centerOrDirection: Point2D,\n  origin?: Point2D,\n  mode?: 'center' | 'plane'\n): Drawing {\n  return drawing.mirror(centerOrDirection, origin, mode);\n}\n"]}

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

@@ -0,0 +1,128 @@
+import type { ApproximationOptions } from '../2d/lib/index.js';
+import { BoundingBox2d, type Point2D } from '../2d/lib/index.js';
+import { Blueprint, type ScaleMode, type Shape2D } from '../2d/blueprints/index.js';
+import type { Plane, PlaneName } from '../core/planeTypes.js';
+import type { PointInput } from '../core/types.js';
+import type { AnyShape, Dimension, Face } from '../core/shapeTypes.js';
+import type { SketchInterface } from './sketch.js';
+import Sketches from './sketches.js';
+import { type Offset2DConfig } from '../2d/blueprints/blueprintOffset.js';
+import { type CornerFinderFn } from '../query/finderFns.js';
+import type { SingleFace } from '../query/helpers.js';
+/**
+ * @categoryDescription Drawing
+ *
+ * Drawing are shapes in the 2D space. You can either use a "builder pen" to
+ * draw a shape, or use some of the canned shapes like circles or rectangles.
+ */
+/**
+ * Immutable wrapper around a 2D shape ({@link Blueprint}, {@link CompoundBlueprint}, or {@link Blueprints}).
+ *
+ * A Drawing can be transformed (translate, rotate, scale, mirror), combined
+ * with Boolean operations (cut, fuse, intersect), filleted/chamfered,
+ * serialized, and ultimately projected onto a 3D plane via `sketchOnPlane`.
+ *
+ * @example
+ * ```ts
+ * const profile = drawRectangle(40, 20)
+ *   .fillet(3)
+ *   .cut(drawCircle(5).translate(10, 0));
+ * const sketch = profile.sketchOnPlane("XY");
+ * ```
+ *
+ * @category Drawing
+ */
+export declare class Drawing {
+    private readonly innerShape;
+    private _emptyBoundingBox;
+    constructor(innerShape?: Shape2D);
+    /** Release the resources held by the underlying 2D shape and its bounding boxes. */
+    delete(): void;
+    [Symbol.dispose](): void;
+    /** Create an independent deep copy of this drawing. */
+    clone(): Drawing;
+    /** Serialize the drawing to a JSON string for persistence or transfer. */
+    serialize(): string;
+    /**
+     * Get the axis-aligned 2D bounding box of this drawing.
+     *
+     * @remarks The box is borrowed from the drawing and is disposed with it.
+     */
+    get boundingBox(): BoundingBox2d;
+    /** Stretch the drawing by a ratio along a direction from an origin point. */
+    stretch(ratio: number, direction: Point2D, origin: Point2D): Drawing;
+    /** Return a human-readable string representation of the drawing. */
+    get repr(): string;
+    /** Rotate the drawing by an angle (in degrees) around an optional center point. */
+    rotate(angle: number, center?: Point2D): Drawing;
+    /** Translate the drawing by horizontal and vertical distances. */
+    translate(xDist: number, yDist: number): Drawing;
+    /** Translate the drawing by a 2D vector. */
+    translate(translationVector: Point2D): Drawing;
+    /** Uniformly scale the drawing by a factor around an optional center point. */
+    scale(scaleFactor: number, center?: Point2D): Drawing;
+    /** Mirror the drawing about a point or a line defined by direction and origin. */
+    mirror(centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Drawing;
+    /**
+     * Builds a new drawing by cutting another drawing into this one
+     *
+     * @category Drawing Modifications
+     */
+    cut(other: Drawing): Drawing;
+    /**
+     * Builds a new drawing by merging another drawing into this one
+     *
+     * @category Drawing Modifications
+     */
+    fuse(other: Drawing): Drawing;
+    /**
+     * Builds a new drawing by intersection this drawing with another
+     *
+     * @category Drawing Modifications
+     */
+    intersect(other: Drawing): Drawing;
+    /**
+     * Creates a new drawing with some corners filleted, as specified by the
+     * radius and the corner finder function
+     *
+     * @category Drawing Modifications
+     */
+    fillet(radius: number, filter?: (c: CornerFinderFn) => CornerFinderFn): Drawing;
+    /**
+     * Creates a new drawing with some corners chamfered, as specified by the
+     * radius and the corner finder function
+     *
+     * @category Drawing Modifications
+     */
+    chamfer(radius: number, filter?: (c: CornerFinderFn) => CornerFinderFn): Drawing;
+    /** Project this drawing onto a 3D plane, producing a Sketch or Sketches. */
+    sketchOnPlane(inputPlane: Plane): SketchInterface | Sketches;
+    /** Project this drawing onto a named plane at an optional origin. */
+    sketchOnPlane(inputPlane?: PlaneName, origin?: PointInput | number): SketchInterface | Sketches;
+    /** Project this drawing onto a 3D face surface with the given scale mode. */
+    sketchOnFace(face: Face, scaleMode: ScaleMode): SketchInterface | Sketches;
+    /** Punch the drawing's profile as a hole through a 3D shape on the given face. */
+    punchHole(shape: AnyShape<Dimension>, faceFinder: SingleFace, options?: {
+        height?: number;
+        origin?: PointInput;
+        draftAngle?: number;
+    }): AnyShape<Dimension>;
+    /** Export the drawing as a complete SVG string. */
+    toSVG(margin?: number): string;
+    /** Return the SVG `viewBox` attribute string for this drawing. */
+    toSVGViewBox(margin?: number): string;
+    /** Return the SVG `<path>` `d` attribute strings for this drawing. */
+    toSVGPaths(): string[] | string[][];
+    /** Offset the drawing contour by a signed distance (positive = outward). */
+    offset(distance: number, offsetConfig?: Offset2DConfig): Drawing;
+    /** Approximate the drawing curves for a target format (currently only `'svg'`). */
+    approximate(target: 'svg' | 'arcs', options?: ApproximationOptions): Drawing;
+    /** Access the underlying {@link Blueprint}, throwing if the drawing is compound. */
+    get blueprint(): Blueprint;
+}
+/**
+ * Deserializes a drawing from a string. String is expected to be in the format
+ * generated by `Drawing.serialize()`.
+ */
+export declare function deserializeDrawing(data: string): Drawing;
+//# sourceMappingURL=drawing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/drawing.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,275 @@
+import { bug } from '../core/errors.js';
+import { BoundingBox2d, deserializeCurve2D } from '../2d/lib/index.js';
+import { Blueprint, cut2D, intersect2D, fuse2D, Blueprints, CompoundBlueprint, } from '../2d/blueprints/index.js';
+import Sketches from './sketches.js';
+import offsetFn from '../2d/blueprints/blueprintOffset.js';
+import { cornerFinder } from '../query/finderFns.js';
+import { fillet2D, chamfer2D } from '../2d/blueprints/blueprintCustomCorners.js';
+import { approximateForSVG } from '../2d/blueprints/blueprintApproximations.js';
+import { wrapSketchData, wrapSketchDataArray } from './sketchFns.js';
+function wrapBlueprintResult(shape, result) {
+    if (shape instanceof Blueprint) {
+        return wrapSketchData(result);
+    }
+    else if (shape instanceof CompoundBlueprint) {
+        return wrapSketchDataArray(result);
+    }
+    else {
+        // Blueprints — array of (SketchData | SketchData[])
+        const items = result;
+        return new Sketches(items.map((item) => (Array.isArray(item) ? wrapSketchDataArray(item) : wrapSketchData(item))));
+    }
+}
+/**
+ * @categoryDescription Drawing
+ *
+ * Drawing are shapes in the 2D space. You can either use a "builder pen" to
+ * draw a shape, or use some of the canned shapes like circles or rectangles.
+ */
+/**
+ * Immutable wrapper around a 2D shape ({@link Blueprint}, {@link CompoundBlueprint}, or {@link Blueprints}).
+ *
+ * A Drawing can be transformed (translate, rotate, scale, mirror), combined
+ * with Boolean operations (cut, fuse, intersect), filleted/chamfered,
+ * serialized, and ultimately projected onto a 3D plane via `sketchOnPlane`.
+ *
+ * @example
+ * ```ts
+ * const profile = drawRectangle(40, 20)
+ *   .fillet(3)
+ *   .cut(drawCircle(5).translate(10, 0));
+ * const sketch = profile.sketchOnPlane("XY");
+ * ```
+ *
+ * @category Drawing
+ */
+export class Drawing {
+    innerShape;
+    _emptyBoundingBox = null;
+    constructor(innerShape = null) {
+        this.innerShape = innerShape;
+    }
+    /** Release the resources held by the underlying 2D shape and its bounding boxes. */
+    delete() {
+        this.innerShape?.delete();
+        if (this._emptyBoundingBox) {
+            this._emptyBoundingBox.delete();
+            this._emptyBoundingBox = null;
+        }
+    }
+    [Symbol.dispose]() {
+        this.delete();
+    }
+    /** Create an independent deep copy of this drawing. */
+    clone() {
+        return new Drawing(this.innerShape?.clone() || null);
+    }
+    /** Serialize the drawing to a JSON string for persistence or transfer. */
+    serialize() {
+        if (!this.innerShape) {
+            return JSON.stringify({ type: 'Empty' });
+        }
+        // walk the tree of blueprints
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- recursive serialization
+        function serializeHelper(shape) {
+            if (shape instanceof CompoundBlueprint) {
+                return {
+                    type: 'CompoundBlueprint',
+                    blueprints: shape.blueprints.map(serializeHelper),
+                };
+            }
+            else if (shape instanceof Blueprints) {
+                return {
+                    type: 'Blueprints',
+                    blueprints: shape.blueprints.map(serializeHelper),
+                };
+            }
+            else if (shape instanceof Blueprint) {
+                return {
+                    type: 'Blueprint',
+                    curves: shape.curves.map((c) => c.serialize()),
+                };
+            }
+            else {
+                bug('Drawing.serialize', 'Unknown shape type for serialization');
+            }
+        }
+        return JSON.stringify(serializeHelper(this.innerShape));
+    }
+    /**
+     * Get the axis-aligned 2D bounding box of this drawing.
+     *
+     * @remarks The box is borrowed from the drawing and is disposed with it.
+     */
+    get boundingBox() {
+        if (!this.innerShape) {
+            // Cached rather than minted per read, so delete() can free it
+            this._emptyBoundingBox ??= new BoundingBox2d();
+            return this._emptyBoundingBox;
+        }
+        return this.innerShape.boundingBox;
+    }
+    /** Stretch the drawing by a ratio along a direction from an origin point. */
+    stretch(ratio, direction, origin) {
+        if (!this.innerShape)
+            return new Drawing();
+        return new Drawing(this.innerShape.stretch(ratio, direction, origin));
+    }
+    /** Return a human-readable string representation of the drawing. */
+    get repr() {
+        if (this.innerShape === null)
+            return '=== empty shape';
+        return this.innerShape.repr;
+    }
+    /** Rotate the drawing by an angle (in degrees) around an optional center point. */
+    rotate(angle, center) {
+        if (!this.innerShape)
+            return new Drawing();
+        return new Drawing(this.innerShape.rotate(angle, center));
+    }
+    translate(xDistOrPoint, yDist = 0) {
+        if (!this.innerShape)
+            return new Drawing();
+        return new Drawing(typeof xDistOrPoint === 'number'
+            ? this.innerShape.translate(xDistOrPoint, yDist)
+            : this.innerShape.translate(xDistOrPoint));
+    }
+    /** Uniformly scale the drawing by a factor around an optional center point. */
+    scale(scaleFactor, center) {
+        if (!this.innerShape)
+            return new Drawing();
+        return new Drawing(this.innerShape.scale(scaleFactor, center));
+    }
+    /** Mirror the drawing about a point or a line defined by direction and origin. */
+    mirror(centerOrDirection, origin, mode) {
+        if (!this.innerShape)
+            return new Drawing();
+        return new Drawing(this.innerShape.mirror(centerOrDirection, origin, mode));
+    }
+    /**
+     * Builds a new drawing by cutting another drawing into this one
+     *
+     * @category Drawing Modifications
+     */
+    cut(other) {
+        return new Drawing(cut2D(this.innerShape, other.innerShape));
+    }
+    /**
+     * Builds a new drawing by merging another drawing into this one
+     *
+     * @category Drawing Modifications
+     */
+    fuse(other) {
+        return new Drawing(fuse2D(this.innerShape, other.innerShape));
+    }
+    /**
+     * Builds a new drawing by intersection this drawing with another
+     *
+     * @category Drawing Modifications
+     */
+    intersect(other) {
+        return new Drawing(intersect2D(this.innerShape, other.innerShape));
+    }
+    /**
+     * Creates a new drawing with some corners filleted, as specified by the
+     * radius and the corner finder function
+     *
+     * @category Drawing Modifications
+     */
+    fillet(radius, filter) {
+        const finder = filter && filter(cornerFinder());
+        return new Drawing(fillet2D(this.innerShape, radius, finder));
+    }
+    /**
+     * Creates a new drawing with some corners chamfered, as specified by the
+     * radius and the corner finder function
+     *
+     * @category Drawing Modifications
+     */
+    chamfer(radius, filter) {
+        const finder = filter && filter(cornerFinder());
+        return new Drawing(chamfer2D(this.innerShape, radius, finder));
+    }
+    sketchOnPlane(inputPlane, origin) {
+        if (!this.innerShape)
+            bug('Drawing', 'Trying to sketch an empty drawing');
+        const result = this.innerShape.sketchOnPlane(inputPlane, origin);
+        return wrapBlueprintResult(this.innerShape, result);
+    }
+    /** Project this drawing onto a 3D face surface with the given scale mode. */
+    sketchOnFace(face, scaleMode) {
+        if (!this.innerShape)
+            bug('Drawing', 'Trying to sketch an empty drawing');
+        const result = this.innerShape.sketchOnFace(face, scaleMode);
+        return wrapBlueprintResult(this.innerShape, result);
+    }
+    /** Punch the drawing's profile as a hole through a 3D shape on the given face. */
+    punchHole(shape, faceFinder, options = {}) {
+        if (!this.innerShape)
+            return shape;
+        return this.innerShape.punchHole(shape, faceFinder, options);
+    }
+    /** Export the drawing as a complete SVG string. */
+    toSVG(margin) {
+        return this.innerShape?.toSVG(margin) || '';
+    }
+    /** Return the SVG `viewBox` attribute string for this drawing. */
+    toSVGViewBox(margin = 1) {
+        return this.innerShape?.toSVGViewBox(margin) || '';
+    }
+    /** Return the SVG `<path>` `d` attribute strings for this drawing. */
+    toSVGPaths() {
+        return this.innerShape?.toSVGPaths() || [];
+    }
+    /** Offset the drawing contour by a signed distance (positive = outward). */
+    offset(distance, offsetConfig = {}) {
+        return new Drawing(offsetFn(this.innerShape, distance, offsetConfig));
+    }
+    /** Approximate the drawing curves for a target format (currently only `'svg'`). */
+    approximate(target, options = {}) {
+        if (target !== 'svg') {
+            bug('Drawing.approximate', "Only 'svg' is supported for now");
+        }
+        return new Drawing(approximateForSVG(this.innerShape, options));
+    }
+    /** Access the underlying {@link Blueprint}, throwing if the drawing is compound. */
+    get blueprint() {
+        if (!(this.innerShape instanceof Blueprint)) {
+            if (this.innerShape instanceof Blueprints &&
+                this.innerShape.blueprints.length === 1 &&
+                this.innerShape.blueprints[0] instanceof Blueprint) {
+                return this.innerShape.blueprints[0];
+            }
+            bug('Drawing.blueprint', 'This drawing is not a blueprint');
+        }
+        return this.innerShape;
+    }
+}
+/**
+ * Deserializes a drawing from a string. String is expected to be in the format
+ * generated by `Drawing.serialize()`.
+ */
+export function deserializeDrawing(data) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- recursive deserialization
+    function deserializeHelper(json) {
+        if (json['type'] === 'CompoundBlueprint') {
+            const blueprints = json['blueprints'].map(deserializeHelper);
+            return new CompoundBlueprint(blueprints);
+        }
+        else if (json['type'] === 'Blueprints') {
+            const blueprints = json['blueprints'].map(deserializeHelper);
+            return new Blueprints(blueprints);
+        }
+        else if (json['type'] === 'Blueprint') {
+            const curves = json['curves'].map((c) => deserializeCurve2D(c));
+            return new Blueprint(curves);
+        }
+        else {
+            bug('Drawing.deserialize', 'Unknown shape type for deserialization');
+        }
+    }
+    const json = JSON.parse(data);
+    const shape = deserializeHelper(json);
+    return new Drawing(shape);
+}
+//# sourceMappingURL=drawing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drawing.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/sketching/drawing.ts"],"names":[],"mappings":"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","sourcesContent":["import { bug } from '../core/errors.js';\nimport type { ApproximationOptions } from '../2d/lib/index.js';\nimport { BoundingBox2d, deserializeCurve2D, type Point2D } from '../2d/lib/index.js';\nimport {\n  Blueprint,\n  cut2D,\n  intersect2D,\n  fuse2D,\n  type ScaleMode,\n  type Shape2D,\n  Blueprints,\n  CompoundBlueprint,\n} from '../2d/blueprints/index.js';\nimport type { Plane, PlaneName } from '../core/planeTypes.js';\nimport type { PointInput } from '../core/types.js';\nimport type { AnyShape, Dimension, Face } from '../core/shapeTypes.js';\nimport type { SketchInterface } from './sketch.js';\nimport Sketches from './sketches.js';\nimport type { SketchData } from '../2d/blueprints/lib.js';\n\nimport offsetFn, { type Offset2DConfig } from '../2d/blueprints/blueprintOffset.js';\nimport { cornerFinder, type CornerFinderFn } from '../query/finderFns.js';\nimport { fillet2D, chamfer2D } from '../2d/blueprints/blueprintCustomCorners.js';\nimport { approximateForSVG } from '../2d/blueprints/blueprintApproximations.js';\nimport type { SingleFace } from '../query/helpers.js';\nimport { wrapSketchData, wrapSketchDataArray } from './sketchFns.js';\n\nfunction wrapBlueprintResult(\n  shape: Shape2D,\n  result: SketchData | SketchData[] | (SketchData | SketchData[])[]\n): SketchInterface | Sketches {\n  if (shape instanceof Blueprint) {\n    return wrapSketchData(result as SketchData);\n  } else if (shape instanceof CompoundBlueprint) {\n    return wrapSketchDataArray(result as SketchData[]);\n  } else {\n    // Blueprints — array of (SketchData | SketchData[])\n    const items = result as (SketchData | SketchData[])[];\n    return new Sketches(\n      items.map((item) => (Array.isArray(item) ? wrapSketchDataArray(item) : wrapSketchData(item)))\n    );\n  }\n}\n\n/**\n * @categoryDescription Drawing\n *\n * Drawing are shapes in the 2D space. You can either use a \"builder pen\" to\n * draw a shape, or use some of the canned shapes like circles or rectangles.\n */\n\n/**\n * Immutable wrapper around a 2D shape ({@link Blueprint}, {@link CompoundBlueprint}, or {@link Blueprints}).\n *\n * A Drawing can be transformed (translate, rotate, scale, mirror), combined\n * with Boolean operations (cut, fuse, intersect), filleted/chamfered,\n * serialized, and ultimately projected onto a 3D plane via `sketchOnPlane`.\n *\n * @example\n * ```ts\n * const profile = drawRectangle(40, 20)\n *   .fillet(3)\n *   .cut(drawCircle(5).translate(10, 0));\n * const sketch = profile.sketchOnPlane(\"XY\");\n * ```\n *\n * @category Drawing\n */\nexport class Drawing {\n  private readonly innerShape: Shape2D;\n  private _emptyBoundingBox: BoundingBox2d | null = null;\n\n  constructor(innerShape: Shape2D = null) {\n    this.innerShape = innerShape;\n  }\n\n  /** Release the resources held by the underlying 2D shape and its bounding boxes. */\n  delete(): void {\n    this.innerShape?.delete();\n    if (this._emptyBoundingBox) {\n      this._emptyBoundingBox.delete();\n      this._emptyBoundingBox = null;\n    }\n  }\n\n  [Symbol.dispose](): void {\n    this.delete();\n  }\n\n  /** Create an independent deep copy of this drawing. */\n  clone(): Drawing {\n    return new Drawing(this.innerShape?.clone() || null);\n  }\n\n  /** Serialize the drawing to a JSON string for persistence or transfer. */\n  serialize(): string {\n    if (!this.innerShape) {\n      return JSON.stringify({ type: 'Empty' });\n    }\n\n    // walk the tree of blueprints\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- recursive serialization\n    function serializeHelper(shape: Shape2D): any {\n      if (shape instanceof CompoundBlueprint) {\n        return {\n          type: 'CompoundBlueprint',\n          blueprints: shape.blueprints.map(serializeHelper),\n        };\n      } else if (shape instanceof Blueprints) {\n        return {\n          type: 'Blueprints',\n          blueprints: shape.blueprints.map(serializeHelper),\n        };\n      } else if (shape instanceof Blueprint) {\n        return {\n          type: 'Blueprint',\n          curves: shape.curves.map((c) => c.serialize()),\n        };\n      } else {\n        bug('Drawing.serialize', 'Unknown shape type for serialization');\n      }\n    }\n\n    return JSON.stringify(serializeHelper(this.innerShape));\n  }\n\n  /**\n   * Get the axis-aligned 2D bounding box of this drawing.\n   *\n   * @remarks The box is borrowed from the drawing and is disposed with it.\n   */\n  get boundingBox(): BoundingBox2d {\n    if (!this.innerShape) {\n      // Cached rather than minted per read, so delete() can free it\n      this._emptyBoundingBox ??= new BoundingBox2d();\n      return this._emptyBoundingBox;\n    }\n    return this.innerShape.boundingBox;\n  }\n\n  /** Stretch the drawing by a ratio along a direction from an origin point. */\n  stretch(ratio: number, direction: Point2D, origin: Point2D): Drawing {\n    if (!this.innerShape) return new Drawing();\n    return new Drawing(this.innerShape.stretch(ratio, direction, origin));\n  }\n\n  /** Return a human-readable string representation of the drawing. */\n  get repr(): string {\n    if (this.innerShape === null) return '=== empty shape';\n    return this.innerShape.repr;\n  }\n\n  /** Rotate the drawing by an angle (in degrees) around an optional center point. */\n  rotate(angle: number, center?: Point2D): Drawing {\n    if (!this.innerShape) return new Drawing();\n    return new Drawing(this.innerShape.rotate(angle, center));\n  }\n\n  /** Translate the drawing by horizontal and vertical distances. */\n  translate(xDist: number, yDist: number): Drawing;\n  /** Translate the drawing by a 2D vector. */\n  translate(translationVector: Point2D): Drawing;\n  translate(xDistOrPoint: number | Point2D, yDist = 0): Drawing {\n    if (!this.innerShape) return new Drawing();\n    return new Drawing(\n      typeof xDistOrPoint === 'number'\n        ? this.innerShape.translate(xDistOrPoint, yDist)\n        : this.innerShape.translate(xDistOrPoint)\n    );\n  }\n\n  /** Uniformly scale the drawing by a factor around an optional center point. */\n  scale(scaleFactor: number, center?: Point2D): Drawing {\n    if (!this.innerShape) return new Drawing();\n    return new Drawing(this.innerShape.scale(scaleFactor, center));\n  }\n\n  /** Mirror the drawing about a point or a line defined by direction and origin. */\n  mirror(centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Drawing {\n    if (!this.innerShape) return new Drawing();\n    return new Drawing(this.innerShape.mirror(centerOrDirection, origin, mode));\n  }\n\n  /**\n   * Builds a new drawing by cutting another drawing into this one\n   *\n   * @category Drawing Modifications\n   */\n  cut(other: Drawing): Drawing {\n    return new Drawing(cut2D(this.innerShape, other.innerShape));\n  }\n\n  /**\n   * Builds a new drawing by merging another drawing into this one\n   *\n   * @category Drawing Modifications\n   */\n  fuse(other: Drawing): Drawing {\n    return new Drawing(fuse2D(this.innerShape, other.innerShape));\n  }\n\n  /**\n   * Builds a new drawing by intersection this drawing with another\n   *\n   * @category Drawing Modifications\n   */\n  intersect(other: Drawing): Drawing {\n    return new Drawing(intersect2D(this.innerShape, other.innerShape));\n  }\n\n  /**\n   * Creates a new drawing with some corners filleted, as specified by the\n   * radius and the corner finder function\n   *\n   * @category Drawing Modifications\n   */\n  fillet(radius: number, filter?: (c: CornerFinderFn) => CornerFinderFn): Drawing {\n    const finder = filter && filter(cornerFinder());\n    return new Drawing(fillet2D(this.innerShape, radius, finder));\n  }\n\n  /**\n   * Creates a new drawing with some corners chamfered, as specified by the\n   * radius and the corner finder function\n   *\n   * @category Drawing Modifications\n   */\n  chamfer(radius: number, filter?: (c: CornerFinderFn) => CornerFinderFn): Drawing {\n    const finder = filter && filter(cornerFinder());\n    return new Drawing(chamfer2D(this.innerShape, radius, finder));\n  }\n\n  /** Project this drawing onto a 3D plane, producing a Sketch or Sketches. */\n  sketchOnPlane(inputPlane: Plane): SketchInterface | Sketches;\n  /** Project this drawing onto a named plane at an optional origin. */\n  sketchOnPlane(inputPlane?: PlaneName, origin?: PointInput | number): SketchInterface | Sketches;\n  sketchOnPlane(\n    inputPlane?: PlaneName | Plane,\n    origin?: PointInput | number\n  ): SketchInterface | Sketches {\n    if (!this.innerShape) bug('Drawing', 'Trying to sketch an empty drawing');\n    const result = this.innerShape.sketchOnPlane(inputPlane, origin);\n    return wrapBlueprintResult(this.innerShape, result);\n  }\n\n  /** Project this drawing onto a 3D face surface with the given scale mode. */\n  sketchOnFace(face: Face, scaleMode: ScaleMode): SketchInterface | Sketches {\n    if (!this.innerShape) bug('Drawing', 'Trying to sketch an empty drawing');\n    const result = this.innerShape.sketchOnFace(face, scaleMode);\n    return wrapBlueprintResult(this.innerShape, result);\n  }\n\n  /** Punch the drawing's profile as a hole through a 3D shape on the given face. */\n  punchHole(\n    shape: AnyShape<Dimension>,\n    faceFinder: SingleFace,\n    options: {\n      height?: number;\n      origin?: PointInput;\n      draftAngle?: number;\n    } = {}\n  ): AnyShape<Dimension> {\n    if (!this.innerShape) return shape;\n    return this.innerShape.punchHole(shape, faceFinder, options);\n  }\n\n  /** Export the drawing as a complete SVG string. */\n  toSVG(margin?: number): string {\n    return this.innerShape?.toSVG(margin) || '';\n  }\n\n  /** Return the SVG `viewBox` attribute string for this drawing. */\n  toSVGViewBox(margin = 1): string {\n    return this.innerShape?.toSVGViewBox(margin) || '';\n  }\n\n  /** Return the SVG `<path>` `d` attribute strings for this drawing. */\n  toSVGPaths(): string[] | string[][] {\n    return this.innerShape?.toSVGPaths() || [];\n  }\n\n  /** Offset the drawing contour by a signed distance (positive = outward). */\n  offset(distance: number, offsetConfig: Offset2DConfig = {}): Drawing {\n    return new Drawing(offsetFn(this.innerShape, distance, offsetConfig));\n  }\n\n  /** Approximate the drawing curves for a target format (currently only `'svg'`). */\n  approximate(target: 'svg' | 'arcs', options: ApproximationOptions = {}): Drawing {\n    if (target !== 'svg') {\n      bug('Drawing.approximate', \"Only 'svg' is supported for now\");\n    }\n    return new Drawing(approximateForSVG(this.innerShape, options));\n  }\n\n  /** Access the underlying {@link Blueprint}, throwing if the drawing is compound. */\n  get blueprint(): Blueprint {\n    if (!(this.innerShape instanceof Blueprint)) {\n      if (\n        this.innerShape instanceof Blueprints &&\n        this.innerShape.blueprints.length === 1 &&\n        this.innerShape.blueprints[0] instanceof Blueprint\n      ) {\n        return this.innerShape.blueprints[0];\n      }\n      bug('Drawing.blueprint', 'This drawing is not a blueprint');\n    }\n    return this.innerShape;\n  }\n}\n\n/**\n * Deserializes a drawing from a string. String is expected to be in the format\n * generated by `Drawing.serialize()`.\n */\nexport function deserializeDrawing(data: string): Drawing {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- recursive deserialization\n  function deserializeHelper(json: any): Shape2D {\n    if (json['type'] === 'CompoundBlueprint') {\n      const blueprints = json['blueprints'].map(deserializeHelper);\n      return new CompoundBlueprint(blueprints);\n    } else if (json['type'] === 'Blueprints') {\n      const blueprints = json['blueprints'].map(deserializeHelper);\n      return new Blueprints(blueprints);\n    } else if (json['type'] === 'Blueprint') {\n      const curves = json['curves'].map((c: string) => deserializeCurve2D(c));\n      return new Blueprint(curves);\n    } else {\n      bug('Drawing.deserialize', 'Unknown shape type for deserialization');\n    }\n  }\n\n  const json = JSON.parse(data);\n  const shape = deserializeHelper(json);\n  return new Drawing(shape);\n}\n"]}