plotboilerplate 1.23.2 → 1.24.0

package/src/cjs/utils/helpers/VEllipseHelper.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A helper for VEllipses.
+ *
+ * @author   Ikaros Kappler
+ * @date     2025-03-31
+ * @modified 2025-04-02 Adding `VEllipseHelper.drawHandleLines()`.
+ * @modified 2025-04-09 Adding `VEllipseHelper.destroy()`.
+ * @version  1.0.0
+ */
+import { VEllipse } from "../../VEllipse";
+import { Vertex } from "../../Vertex";
+import { DrawLib } from "../../interfaces";
+export declare class VEllipseHelper {
+    private readonly ellipse;
+    private readonly rotationControlPoint;
+    private _rotationControlLine;
+    private _centerPointHandler;
+    private _rotationPointHandler;
+    constructor(ellipse: VEllipse, rotationControlPoint: Vertex);
+    private _handleDragCenterPoint;
+    private _handleRotationCenterPoint;
+    /**
+     * Draw grey handle lines.
+     *
+     * @param {DrawLib<any>} draw - The draw library instance to use.
+     * @param {DrawLib<any>} fill - The fill library instance to use.
+     */
+    drawHandleLines(draw: DrawLib<any>, fill: DrawLib<any>): void;
+    detroy(): void;
+}

package/src/cjs/utils/helpers/VEllipseHelper.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * A helper for VEllipses.
+ *
+ * @author   Ikaros Kappler
+ * @date     2025-03-31
+ * @modified 2025-04-02 Adding `VEllipseHelper.drawHandleLines()`.
+ * @modified 2025-04-09 Adding `VEllipseHelper.destroy()`.
+ * @version  1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VEllipseHelper = void 0;
+var Line_1 = require("../../Line");
+var VEllipseHelper = /** @class */ (function () {
+    function VEllipseHelper(ellipse, rotationControlPoint) {
+        this.ellipse = ellipse;
+        this.rotationControlPoint = rotationControlPoint;
+        // const rotationControlLine: Line = new Line(ellipse.center, rotationControlPoint);
+        this._rotationControlLine = new Line_1.Line(ellipse.center, rotationControlPoint);
+        // +---------------------------------------------------------------------
+        // | Listen for the center to be moved.
+        // +-------------------------------------------
+        // ellipse.center.listeners.addDragListener((event: VertEvent) => {
+        //   rotationControlPoint.add(event.params.dragAmount);
+        // });
+        ellipse.center.listeners.addDragListener((this._centerPointHandler = this._handleDragCenterPoint()));
+        // +---------------------------------------------------------------------
+        // | Listen for rotation changes.
+        // +-------------------------------------------
+        // rotationControlPoint.listeners.addDragListener((_event: VertEvent) => {
+        //   var newRotation = rotationControlLine.angle();
+        //   var rDiff = newRotation - ellipse.rotation;
+        //   ellipse.rotation = newRotation;
+        //   ellipse.axis.rotate(rDiff, ellipse.center);
+        // });
+        rotationControlPoint.listeners.addDragListener((this._rotationPointHandler = this._handleRotationCenterPoint()));
+    }
+    VEllipseHelper.prototype._handleDragCenterPoint = function () {
+        var _self = this;
+        return function (event) {
+            _self.rotationControlPoint.add(event.params.dragAmount);
+        };
+    };
+    VEllipseHelper.prototype._handleRotationCenterPoint = function () {
+        var _self = this;
+        return function (_event) {
+            var newRotation = _self._rotationControlLine.angle();
+            var rDiff = newRotation - _self.ellipse.rotation;
+            _self.ellipse.rotation = newRotation;
+            _self.ellipse.axis.rotate(rDiff, _self.ellipse.center);
+        };
+    };
+    /**
+     * Draw grey handle lines.
+     *
+     * @param {DrawLib<any>} draw - The draw library instance to use.
+     * @param {DrawLib<any>} fill - The fill library instance to use.
+     */
+    VEllipseHelper.prototype.drawHandleLines = function (draw, fill) {
+        // Draw rotation handle line
+        draw.line(this.ellipse.center, this.rotationControlPoint, "rgba(192,64,128,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        // Draw helper box
+        draw.setCurrentId("".concat(this.ellipse.uid, "_e0"));
+        draw.setCurrentClassName("".concat(this.ellipse.className, "-v-line"));
+        draw.line(this.ellipse.center.clone().add(0, this.ellipse.signedRadiusV()).rotate(this.ellipse.rotation, this.ellipse.center), this.ellipse.axis, "rgba(64,128,192,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        draw.setCurrentId("".concat(this.ellipse.uid, "_e1"));
+        draw.setCurrentClassName("".concat(this.ellipse.className, "-h-line"));
+        draw.line(this.ellipse.center.clone().add(this.ellipse.signedRadiusH(), 0).rotate(this.ellipse.rotation, this.ellipse.center), this.ellipse.axis, "rgba(64,128,192,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+    };
+    VEllipseHelper.prototype.detroy = function () {
+        this.ellipse.center.listeners.removeDragListener(this._centerPointHandler);
+        this.rotationControlPoint.listeners.removeDragListener(this._rotationPointHandler);
+    };
+    return VEllipseHelper;
+}());
+exports.VEllipseHelper = VEllipseHelper;
+//# sourceMappingURL=VEllipseHelper.js.map

package/src/cjs/utils/helpers/VEllipseHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VEllipseHelper.js","sourceRoot":"","sources":["../../../ts/utils/helpers/VEllipseHelper.ts"],"names":[],"mappings":"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"}

package/src/cjs/utils/helpers/VEllipseSectorHelper.d.ts

@@ -1,12 +1,51 @@
 /**
  * A helper for VEllipseSectors.
  *
- * @author  Ikaros Kappler
- * @date    2021-03-24
- * @version 1.0.0
+ * @author   Ikaros Kappler
+ * @date     2021-03-24
+ * @modified 2025-04-02 Adding `VEllipseSectorHelper.drawHandleLines`.
+ * @modified 2025-04-07 Modifying the calculation of `startAngle` and `endAngle` from the rotation control point: wrapping result into [0,TWO_PI).
+ * @modified 2025-04-09 Adding the `VEllipseSectorHelper.destroy` method.
+ * @version  1.1.0
  */
 import { VEllipseSector } from "../../VEllipseSector";
 import { Vertex } from "../../Vertex";
+import { DrawLib } from "../../interfaces";
 export declare class VEllipseSectorHelper {
+    private sector;
+    private startAngleControlPoint;
+    private endAngleControlPoint;
+    private rotationControlPoint;
+    private _rotationControlLine;
+    private _startAngleControlLine;
+    private _endAngleControlLine;
+    private _centerHandler;
+    private _rotationHandler;
+    private _startAngleHandler;
+    private _endAngleHandler;
     constructor(sector: VEllipseSector, startAngleControlPoint: Vertex, endAngleControlPoint: Vertex, rotationControlPoint: Vertex);
+    /**
+     * Creates a new drag handler for the circle sector's start control point.
+     *
+     * @private
+     * @method _handleDragStartControlPoint
+     * @instance
+     * @memberof CircleSectorHelper
+     * @returns A new event handler.
+     */
+    private _handleDragCenterPoint;
+    private _handleDragRotationControlPoint;
+    private _handleDragStartAngleControlPoint;
+    private _handleDragEndAngleControlPoint;
+    /**
+     * Draw grey handle lines.
+     *
+     * @param {DrawLib<any>} draw - The draw library instance to use.
+     * @param {DrawLib<any>} fill - The fill library instance to use.
+     */
+    drawHandleLines(draw: DrawLib<any>, fill: DrawLib<any>): void;
+    /**
+     * Destroy this VEllipseHandler which means: all listeners are being removed.
+     */
+    destroy(): void;
 }

package/src/cjs/utils/helpers/VEllipseSectorHelper.js

@@ -2,50 +2,132 @@
 /**
  * A helper for VEllipseSectors.
  *
- * @author  Ikaros Kappler
- * @date    2021-03-24
- * @version 1.0.0
+ * @author   Ikaros Kappler
+ * @date     2021-03-24
+ * @modified 2025-04-02 Adding `VEllipseSectorHelper.drawHandleLines`.
+ * @modified 2025-04-07 Modifying the calculation of `startAngle` and `endAngle` from the rotation control point: wrapping result into [0,TWO_PI).
+ * @modified 2025-04-09 Adding the `VEllipseSectorHelper.destroy` method.
+ * @version  1.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VEllipseSectorHelper = void 0;
 var Line_1 = require("../../Line");
+var geomutils_1 = require("../../geomutils");
 var VEllipseSectorHelper = /** @class */ (function () {
     function VEllipseSectorHelper(sector, startAngleControlPoint, endAngleControlPoint, rotationControlPoint) {
-        var rotationControlLine = new Line_1.Line(sector.ellipse.center, rotationControlPoint);
-        var startAngleControlLine = new Line_1.Line(sector.ellipse.center, startAngleControlPoint);
-        var endAngleControlLine = new Line_1.Line(sector.ellipse.center, endAngleControlPoint);
+        this.sector = sector;
+        this.startAngleControlPoint = startAngleControlPoint;
+        this.endAngleControlPoint = endAngleControlPoint;
+        this.rotationControlPoint = rotationControlPoint;
+        // const rotationControlLine: Line = new Line(sector.ellipse.center, rotationControlPoint);
+        this._rotationControlLine = new Line_1.Line(sector.ellipse.center, rotationControlPoint);
+        // const startAngleControlLine: Line = new Line(sector.ellipse.center, startAngleControlPoint);
+        this._startAngleControlLine = new Line_1.Line(sector.ellipse.center, startAngleControlPoint);
+        // const endAngleControlLine: Line = new Line(sector.ellipse.center, endAngleControlPoint);
+        this._endAngleControlLine = new Line_1.Line(sector.ellipse.center, endAngleControlPoint);
         // +---------------------------------------------------------------------
         // | Listen for the center to be moved.
         // +-------------------------------------------
-        sector.ellipse.center.listeners.addDragListener(function (event) {
-            startAngleControlPoint.add(event.params.dragAmount);
-            endAngleControlPoint.add(event.params.dragAmount);
-            rotationControlPoint.add(event.params.dragAmount);
-        });
+        sector.ellipse.center.listeners.addDragListener((this._centerHandler = this._handleDragCenterPoint()));
         // +---------------------------------------------------------------------
         // | Listen for rotation changes.
         // +-------------------------------------------
-        rotationControlPoint.listeners.addDragListener(function (event) {
-            var newRotation = rotationControlLine.angle();
-            var rDiff = newRotation - sector.ellipse.rotation;
-            sector.ellipse.rotation = newRotation;
-            sector.ellipse.axis.rotate(rDiff, sector.ellipse.center);
-            startAngleControlPoint.rotate(rDiff, sector.ellipse.center);
-            endAngleControlPoint.rotate(rDiff, sector.ellipse.center);
-        });
+        rotationControlPoint.listeners.addDragListener((this._rotationHandler = this._handleDragRotationControlPoint()));
         // +---------------------------------------------------------------------
         // | Listen for start angle changes.
         // +-------------------------------------------
-        startAngleControlPoint.listeners.addDragListener(function (event) {
-            sector.startAngle = startAngleControlLine.angle() - sector.ellipse.rotation;
-        });
+        startAngleControlPoint.listeners.addDragListener((this._startAngleHandler = this._handleDragStartAngleControlPoint()));
         // +---------------------------------------------------------------------
         // | Listen for end angle changes.
         // +-------------------------------------------
-        endAngleControlPoint.listeners.addDragListener(function (event) {
-            sector.endAngle = endAngleControlLine.angle() - sector.ellipse.rotation;
-        });
+        endAngleControlPoint.listeners.addDragListener((this._endAngleHandler = this._handleDragEndAngleControlPoint()));
     }
+    /**
+     * Creates a new drag handler for the circle sector's start control point.
+     *
+     * @private
+     * @method _handleDragStartControlPoint
+     * @instance
+     * @memberof CircleSectorHelper
+     * @returns A new event handler.
+     */
+    VEllipseSectorHelper.prototype._handleDragCenterPoint = function () {
+        var _self = this;
+        return function (event) {
+            _self.startAngleControlPoint.add(event.params.dragAmount);
+            _self.endAngleControlPoint.add(event.params.dragAmount);
+            _self.rotationControlPoint.add(event.params.dragAmount);
+        };
+    };
+    VEllipseSectorHelper.prototype._handleDragRotationControlPoint = function () {
+        var _self = this;
+        return function (event) {
+            var newRotation = _self._rotationControlLine.angle();
+            var rDiff = newRotation - _self.sector.ellipse.rotation;
+            _self.sector.ellipse.rotation = newRotation;
+            _self.sector.ellipse.axis.rotate(rDiff, _self.sector.ellipse.center);
+            _self.startAngleControlPoint.rotate(rDiff, _self.sector.ellipse.center);
+            _self.endAngleControlPoint.rotate(rDiff, _self.sector.ellipse.center);
+        };
+    };
+    VEllipseSectorHelper.prototype._handleDragStartAngleControlPoint = function () {
+        var _self = this;
+        return function (_event) {
+            // sector.startAngle = startAngleControlLine.angle() - sector.ellipse.rotation;
+            _self.sector.startAngle = geomutils_1.geomutils.mapAngleTo2PI(_self._startAngleControlLine.angle() - _self.sector.ellipse.rotation);
+        };
+    };
+    VEllipseSectorHelper.prototype._handleDragEndAngleControlPoint = function () {
+        var _self = this;
+        return function (event) {
+            _self.sector.endAngle = geomutils_1.geomutils.mapAngleTo2PI(_self._endAngleControlLine.angle() - _self.sector.ellipse.rotation);
+        };
+    };
+    /**
+     * Draw grey handle lines.
+     *
+     * @param {DrawLib<any>} draw - The draw library instance to use.
+     * @param {DrawLib<any>} fill - The fill library instance to use.
+     */
+    VEllipseSectorHelper.prototype.drawHandleLines = function (draw, fill) {
+        draw.line(this.sector.ellipse.center, this.startAngleControlPoint, "rgba(64,192,128,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        draw.line(this.sector.ellipse.center, this.endAngleControlPoint, "rgba(64,192,128,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        // Draw rotation handle line
+        draw.line(this.sector.ellipse.center, this.rotationControlPoint, "rgba(192,64,128,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        // Draw helper box
+        draw.line(this.sector.ellipse.center
+            .clone()
+            .add(0, this.sector.ellipse.signedRadiusV())
+            .rotate(this.sector.ellipse.rotation, this.sector.ellipse.center), this.sector.ellipse.axis, "rgba(64,128,192,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+        draw.line(this.sector.ellipse.center
+            .clone()
+            .add(this.sector.ellipse.signedRadiusH(), 0)
+            .rotate(this.sector.ellipse.rotation, this.sector.ellipse.center), this.sector.ellipse.axis, "rgba(64,128,192,0.333)", 1.0, {
+            dashOffset: 0.0,
+            dashArray: [4, 2]
+        });
+    }; // END drawHandleLines
+    /**
+     * Destroy this VEllipseHandler which means: all listeners are being removed.
+     */
+    VEllipseSectorHelper.prototype.destroy = function () {
+        this.sector.ellipse.center.listeners.removeDragListener(this._centerHandler);
+        this.rotationControlPoint.listeners.removeDragListener(this._rotationHandler);
+        this.startAngleControlPoint.listeners.removeDragListener(this._startAngleHandler);
+        this.endAngleControlPoint.listeners.removeDragListener(this._endAngleHandler);
+    };
     return VEllipseSectorHelper;
 }());
 exports.VEllipseSectorHelper = VEllipseSectorHelper;

package/src/cjs/utils/helpers/VEllipseSectorHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"VEllipseSectorHelper.js","sourceRoot":"","sources":["../../../ts/utils/helpers/VEllipseSectorHelper.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,mCAAkC;AAKlC;IACE,8BACE,MAAsB,EACtB,sBAA8B,EAC9B,oBAA4B,EAC5B,oBAA4B;QAE5B,IAAM,mBAAmB,GAAS,IAAI,WAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACxF,IAAM,qBAAqB,GAAS,IAAI,WAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QAC5F,IAAM,mBAAmB,GAAS,IAAI,WAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAExF,yEAAyE;QACzE,uCAAuC;QACvC,+CAA+C;QAC/C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,UAAC,KAAgB;YAC/D,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACpD,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAClD,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,yEAAyE;QACzE,iCAAiC;QACjC,+CAA+C;QAC/C,oBAAoB,CAAC,SAAS,CAAC,eAAe,CAAC,UAAC,KAAgB;YAC9D,IAAI,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,CAAC;YAC9C,IAAI,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzD,sBAAsB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5D,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,yEAAyE;QACzE,oCAAoC;QACpC,+CAA+C;QAC/C,sBAAsB,CAAC,SAAS,CAAC,eAAe,CAAC,UAAC,KAAgB;YAChE,MAAM,CAAC,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,yEAAyE;QACzE,kCAAkC;QAClC,+CAA+C;QAC/C,oBAAoB,CAAC,SAAS,CAAC,eAAe,CAAC,UAAC,KAAgB;YAC9D,MAAM,CAAC,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IACH,2BAAC;AAAD,CAAC,AA9CD,IA8CC;AA9CY,oDAAoB"}
+{"version":3,"file":"VEllipseSectorHelper.js","sourceRoot":"","sources":["../../../ts/utils/helpers/VEllipseSectorHelper.ts"],"names":[],"mappings":"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"}

package/src/createDemoDrawables.js

@@ -235,7 +235,9 @@ function createDemoDrawables(pb, imagePath, drawCallback) {
   var addEllipticSectorHelper = function (ellipticSector) {
     var startControlPoint = ellipticSector.ellipse.vertAt(ellipticSector.startAngle);
     var endControlPoint = ellipticSector.ellipse.vertAt(ellipticSector.endAngle);
-    var rotationControlPoint = ellipticSector.ellipse.vertAt(ellipticSector.rotation).scale(1.2, ellipticSector.ellipse.center);
+    // var rotationControlPoint = ellipticSector.ellipse.vertAt(ellipticSector.rotation).scale(1.2, ellipticSector.ellipse.center);
+    var rotationControlPoint = ellipticSector.ellipse.vertAt(0).scale(1.2, ellipticSector.ellipse.center);
+
     new VEllipseSectorHelper(ellipticSector, startControlPoint, endControlPoint, rotationControlPoint);
     pb.add(startControlPoint);
     pb.add(endControlPoint);

package/src/esm/BezierPath.d.ts

@@ -25,15 +25,20 @@
  * @modified 2022-02-02 Cleared the `toSVGString` function (deprecated). Use `drawutilssvg` instead.
  * @modified 2023-10-06 Adding the `BezierPath.toPathPoints()` method.
  * @modified 2023-10-07 Adding the `BezierPath.fromCurve(CubicBezierCurve)` static function.
- * @version 2.6.0
+ * @modified 2025-04-09 Added the `BezierPath.move` method to match the convention – which just calls `translate`.
+ * @modified 2025-04-09 Modified the `BezierPath.translate` method: chaning parameter `Vertex` to more generalized `XYCoords`.
+ * @modified 2025-04-14 Class `BezierPath` is now implementing interface `Intersectable`.
+ * @version 2.7.0
  *
  * @file BezierPath
  * @public
  **/
 import { Bounds } from "./Bounds";
 import { CubicBezierCurve } from "./CubicBezierCurve";
+import { Vector } from "./Vector";
+import { VertTuple } from "./VertTuple";
 import { Vertex } from "./Vertex";
-import { XYCoords, SVGSerializable, UID } from "./interfaces";
+import { XYCoords, SVGSerializable, UID, Intersectable, IBounded } from "./interfaces";
 /**
  * @classdesc A BezierPath class.
  *
@@ -47,7 +52,7 @@ import { XYCoords, SVGSerializable, UID } from "./interfaces";
  * @requires UID
  * @requires UIDGenerator
  **/
-export declare class BezierPath implements SVGSerializable {
+export declare class BezierPath implements IBounded, Intersectable, SVGSerializable {
     /**
      * Required to generate proper CSS classes and other class related IDs.
      **/
@@ -218,13 +223,24 @@ export declare class BezierPath implements SVGSerializable {
      * Move the whole bezier path by the given (x,y)-amount.
      *
      * @method translate
-     * @param {Vertex} amount - The amount to be added (amount.x and amount.y)
+     * @param {XYCoords} amount - The amount to be added (amount.x and amount.y)
      *                          to each vertex of the curve.
      * @instance
      * @memberof BezierPath
      * @return {BezierPath} this for chaining
      **/
-    translate(amount: Vertex): BezierPath;
+    translate(amount: XYCoords): BezierPath;
+    /**
+     * Move the whole bezier path by the given (x,y)-amount.
+     *
+     * @method move
+     * @param {XYCoords} amount - The amount to be added (amount.x and amount.y)
+     *                          to each vertex of the curve.
+     * @instance
+     * @memberof BezierPath
+     * @return {BezierPath} this for chaining
+     **/
+    move(amount: XYCoords): BezierPath;
     /**
      * Scale the whole bezier path by the given uniform factor.
      *
@@ -333,6 +349,26 @@ export declare class BezierPath implements SVGSerializable {
      * @return {Vertex} The perpendicluar vector at the relative path position.
      **/
     getPerpendicular(u: number): Vertex;
+    /**
+     * Get all line intersections with this shape.
+     *
+     * This method returns all intersections (as vertices) with this shape. The returned array of vertices is in no specific order.
+     *
+     * @param {VertTuple} line - The line to find intersections with.
+     * @param {boolean} inVectorBoundsOnly - If set to true only intersecion points on the passed vector are returned (located strictly between start and end vertex).
+     * @returns {Array<Vertex>} - An array of all intersections with the shape's outline.
+     */
+    lineIntersections(line: VertTuple<any>, inVectorBoundsOnly?: boolean): Array<Vertex>;
+    /**
+     * Get all line intersections of this polygon and their tangents along the shape.
+     *
+     * This method returns all intersection tangents (as vectors) with this shape. The returned array of vectors is in no specific order.
+     *
+     * @param line
+     * @param lineIntersectionTangents
+     * @returns
+     */
+    lineIntersectionTangents(line: VertTuple<any>, inVectorBoundsOnly?: boolean): Array<Vector>;
     /**
      * This is a helper function to locate the curve index for a given
      * absolute path position u.

package/src/esm/BezierPath.js

@@ -25,7 +25,10 @@
  * @modified 2022-02-02 Cleared the `toSVGString` function (deprecated). Use `drawutilssvg` instead.
  * @modified 2023-10-06 Adding the `BezierPath.toPathPoints()` method.
  * @modified 2023-10-07 Adding the `BezierPath.fromCurve(CubicBezierCurve)` static function.
- * @version 2.6.0
+ * @modified 2025-04-09 Added the `BezierPath.move` method to match the convention – which just calls `translate`.
+ * @modified 2025-04-09 Modified the `BezierPath.translate` method: chaning parameter `Vertex` to more generalized `XYCoords`.
+ * @modified 2025-04-14 Class `BezierPath` is now implementing interface `Intersectable`.
+ * @version 2.7.0
  *
  * @file BezierPath
  * @public
@@ -234,7 +237,7 @@ export class BezierPath {
      * Move the whole bezier path by the given (x,y)-amount.
      *
      * @method translate
-     * @param {Vertex} amount - The amount to be added (amount.x and amount.y)
+     * @param {XYCoords} amount - The amount to be added (amount.x and amount.y)
      *                          to each vertex of the curve.
      * @instance
      * @memberof BezierPath
@@ -253,6 +256,19 @@ export class BezierPath {
         this.updateArcLengths();
         return this;
     }
+    /**
+     * Move the whole bezier path by the given (x,y)-amount.
+     *
+     * @method move
+     * @param {XYCoords} amount - The amount to be added (amount.x and amount.y)
+     *                          to each vertex of the curve.
+     * @instance
+     * @memberof BezierPath
+     * @return {BezierPath} this for chaining
+     **/
+    move(amount) {
+        return this.translate(amount);
+    }
     /**
      * Scale the whole bezier path by the given uniform factor.
      *
@@ -463,6 +479,36 @@ export class BezierPath {
         var relativeU = u - uResult.uPart;
         return bCurve.getPerpendicular(relativeU);
     }
+    //--- BEGIN --- Implement interface `Intersectable`
+    /**
+     * Get all line intersections with this shape.
+     *
+     * This method returns all intersections (as vertices) with this shape. The returned array of vertices is in no specific order.
+     *
+     * @param {VertTuple} line - The line to find intersections with.
+     * @param {boolean} inVectorBoundsOnly - If set to true only intersecion points on the passed vector are returned (located strictly between start and end vertex).
+     * @returns {Array<Vertex>} - An array of all intersections with the shape's outline.
+     */
+    lineIntersections(line, inVectorBoundsOnly = false) {
+        return this.bezierCurves.reduce((accu, curCurve) => {
+            return accu.concat(curCurve.lineIntersections(line, inVectorBoundsOnly));
+        }, []);
+    }
+    /**
+     * Get all line intersections of this polygon and their tangents along the shape.
+     *
+     * This method returns all intersection tangents (as vectors) with this shape. The returned array of vectors is in no specific order.
+     *
+     * @param line
+     * @param lineIntersectionTangents
+     * @returns
+     */
+    lineIntersectionTangents(line, inVectorBoundsOnly = false) {
+        return this.bezierCurves.reduce((accu, curCurve) => {
+            return accu.concat(curCurve.lineIntersectionTangents(line, inVectorBoundsOnly));
+        }, []);
+    }
+    //--- END --- Implement interface `Intersectable`
     /**
      * This is a helper function to locate the curve index for a given
      * absolute path position u.
@@ -676,6 +722,7 @@ export class BezierPath {
         }
         neighbourCurve.updateArcLengths();
     }
+    //--- BEGIN --- Implement interface `IBounded`
     /**
      * Get the bounds of this Bézier path.
      *
@@ -697,6 +744,7 @@ export class BezierPath {
         }
         return new Bounds(min, max);
     }
+    //--- END --- Implement interface `IBounded`
     /**
      * Get n 'equally' distributed vertices along this Bézier path.
      *