plotboilerplate 1.23.3 → 1.24.0

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

@@ -1,47 +1,129 @@
 /**
  * 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 { Line } from "../../Line";
+import { geomutils } from "../../geomutils";
 export class VEllipseSectorHelper {
     constructor(sector, startAngleControlPoint, endAngleControlPoint, rotationControlPoint) {
-        const rotationControlLine = new Line(sector.ellipse.center, rotationControlPoint);
-        const startAngleControlLine = new Line(sector.ellipse.center, startAngleControlPoint);
-        const endAngleControlLine = new 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(sector.ellipse.center, rotationControlPoint);
+        // const startAngleControlLine: Line = new Line(sector.ellipse.center, startAngleControlPoint);
+        this._startAngleControlLine = new Line(sector.ellipse.center, startAngleControlPoint);
+        // const endAngleControlLine: Line = new Line(sector.ellipse.center, endAngleControlPoint);
+        this._endAngleControlLine = new Line(sector.ellipse.center, endAngleControlPoint);
         // +---------------------------------------------------------------------
         // | Listen for the center to be moved.
         // +-------------------------------------------
-        sector.ellipse.center.listeners.addDragListener((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((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((event) => {
-            sector.startAngle = startAngleControlLine.angle() - sector.ellipse.rotation;
-        });
+        startAngleControlPoint.listeners.addDragListener((this._startAngleHandler = this._handleDragStartAngleControlPoint()));
         // +---------------------------------------------------------------------
         // | Listen for end angle changes.
         // +-------------------------------------------
-        endAngleControlPoint.listeners.addDragListener((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.
+     */
+    _handleDragCenterPoint() {
+        const _self = this;
+        return (event) => {
+            _self.startAngleControlPoint.add(event.params.dragAmount);
+            _self.endAngleControlPoint.add(event.params.dragAmount);
+            _self.rotationControlPoint.add(event.params.dragAmount);
+        };
+    }
+    _handleDragRotationControlPoint() {
+        const _self = this;
+        return (event) => {
+            const newRotation = _self._rotationControlLine.angle();
+            const 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);
+        };
+    }
+    _handleDragStartAngleControlPoint() {
+        const _self = this;
+        return (_event) => {
+            // sector.startAngle = startAngleControlLine.angle() - sector.ellipse.rotation;
+            _self.sector.startAngle = geomutils.mapAngleTo2PI(_self._startAngleControlLine.angle() - _self.sector.ellipse.rotation);
+        };
+    }
+    _handleDragEndAngleControlPoint() {
+        const _self = this;
+        return (event) => {
+            _self.sector.endAngle = 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.
+     */
+    drawHandleLines(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.
+     */
+    destroy() {
+        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);
     }
 }
 //# sourceMappingURL=VEllipseSectorHelper.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"VEllipseSectorHelper.js","sourceRoot":"","sources":["../../../ts/utils/helpers/VEllipseSectorHelper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKlC,MAAM,OAAO,oBAAoB;IAC/B,YACE,MAAsB,EACtB,sBAA8B,EAC9B,oBAA4B,EAC5B,oBAA4B;QAE5B,MAAM,mBAAmB,GAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACxF,MAAM,qBAAqB,GAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QAC5F,MAAM,mBAAmB,GAAS,IAAI,IAAI,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,CAAC,KAAgB,EAAE,EAAE;YACnE,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,CAAC,KAAgB,EAAE,EAAE;YAClE,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,CAAC,KAAgB,EAAE,EAAE;YACpE,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,CAAC,KAAgB,EAAE,EAAE;YAClE,MAAM,CAAC,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"VEllipseSectorHelper.js","sourceRoot":"","sources":["../../../ts/utils/helpers/VEllipseSectorHelper.ts"],"names":[],"mappings":"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"}

package/src/ts/BezierPath.ts

@@ -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
@@ -34,8 +37,10 @@
 import { Bounds } from "./Bounds";
 import { CubicBezierCurve } from "./CubicBezierCurve";
 import { UIDGenerator } from "./UIDGenerator";
+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.
@@ -50,7 +55,7 @@ import { XYCoords, SVGSerializable, UID } from "./interfaces";
  * @requires UID
  * @requires UIDGenerator
  **/
-export class BezierPath implements SVGSerializable {
+export class BezierPath implements IBounded, Intersectable, SVGSerializable {
   /**
    * Required to generate proper CSS classes and other class related IDs.
    **/
@@ -309,13 +314,13 @@ export 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 {
     for (var i = 0; i < this.bezierCurves.length; i++) {
       var curve = this.bezierCurves[i];
       curve.getStartPoint().add(amount);
@@ -331,6 +336,20 @@ export class BezierPath implements SVGSerializable {
     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: XYCoords): BezierPath {
+    return this.translate(amount);
+  }
+
   /**
    * Scale the whole bezier path by the given uniform factor.
    *
@@ -559,6 +578,38 @@ export class BezierPath implements SVGSerializable {
     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: VertTuple<any>, inVectorBoundsOnly: boolean = false): Array<Vertex> {
+    return this.bezierCurves.reduce((accu: Array<Vertex>, curCurve: CubicBezierCurve) => {
+      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: VertTuple<any>, inVectorBoundsOnly: boolean = false): Array<Vector> {
+    return this.bezierCurves.reduce((accu: Array<Vector>, curCurve: CubicBezierCurve) => {
+      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.
@@ -816,6 +867,7 @@ export class BezierPath implements SVGSerializable {
     neighbourCurve.updateArcLengths();
   }
 
+  //--- BEGIN --- Implement interface `IBounded`
   /**
    * Get the bounds of this Bézier path.
    *
@@ -837,6 +889,7 @@ export class BezierPath implements SVGSerializable {
     }
     return new Bounds(min, max);
   }
+  //--- END --- Implement interface `IBounded`
 
   /**
    * Get n 'equally' distributed vertices along this Bézier path.

package/src/ts/Bounds.ts

@@ -9,13 +9,16 @@
  * @modified 2022-10-09 Added the `fromDimension` function.
  * @modified 2022-11-28 Added the `clone` method.
  * @modified 2023-09-29 Added the `randomPoint` method.
- * @version  1.7.0
+ * @modified 2025-03-23 Added the `getMinDimension` and `getMaxDimension` methods.
+ * @modified 2025-04-18 Change parameter type in `Bounds.computeFromVertices` from `Vertex` to more general `XYCoords`.
+ * @modified 2025-04-19 Added methods to `Bounds` class: `getNorthPoint`, `getSouthPoint`, `getEastPoint` and `getWestPoint`.
+ * @modified 2025-04-26 Added static method `Bounds.computeFromBoundsSet` to calculate containing bounds for a set of bounding boxes.
+ * @version  1.8.0
  **/
 
 import { Polygon } from "./Polygon";
 import { XYCoords, IBounds, XYDimension } from "./interfaces";
 import { Vertex } from "./Vertex";
-import { VertTuple } from "./VertTuple";
 
 /**
  * @classdesc A bounds class with min and max values. Implementing IBounds.
@@ -72,6 +75,55 @@ export class Bounds implements IBounds, XYDimension {
     this.height = max.y - min.y;
   }
 
+  /**
+   * Get the center point of the north bound.
+   * 
+   * @method getNorthPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "northmost" centered point of this bounding box.
+   */
+  getNorthPoint() : Vertex {
+    return new Vertex(this.min.x + this.width/2.0,  this.min.y );
+  };
+
+  /**
+   * Get the center point of the south bound.
+   * 
+   * @method getNorthPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "southhmost" centered point of this bounding box.
+   */
+  getSouthPoint() : Vertex {
+    return new Vertex( this.min.x + this.width/2.0, this.max.y );
+  };
+
+   /**
+   * Get the center point of the west bound.
+   * 
+   * @method getWestPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "westhmost" centered point of this bounding box.
+   */
+   getWestPoint() : Vertex {
+    return new Vertex( this.min.x, this.min.y + this.height/2.0 );
+  };
+
+   /**
+   * Get the center point of the east bound.
+   * 
+   * @method getEastPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "easthmost" centered point of this bounding box.
+   */
+   getEastPoint() : Vertex {
+    return new Vertex( this.max.x, this.min.y + this.height/2.0 );
+  };
+
+
   /**
    * Convert this rectangular bounding box to a polygon with four vertices.
    *
@@ -99,6 +151,24 @@ export class Bounds implements IBounds, XYDimension {
     return new Vertex(this.min.x + (this.max.x - this.min.x) / 2.0, this.min.y + (this.max.y - this.min.y) / 2);
   }
 
+  /**
+   * Get the minimum of `width` and `height`.
+   *
+   * @returns {number} The value of Math.min( this.width, this.height )
+   */
+  getMinDimension(): number {
+    return Math.min(this.width, this.height);
+  }
+
+  /**
+   * Get the minimum of `width` and `height`.
+   *
+   * @returns {number} The value of Math.min( this.width, this.height )
+   */
+  getMaxDimension(): number {
+    return Math.max(this.width, this.height);
+  }
+
   /**
    * Generate a random point inside this bounds object. Safe areas at the border to avoid
    * included.
@@ -156,18 +226,20 @@ export class Bounds implements IBounds, XYDimension {
    * @static
    * @method computeFromVertices
    * @memberof Bounds
-   * @param {Array<Vertex>} vertices - The set of vertices you want to get the bounding box for.
+   * @param {Array<XYCoords>} vertices - The set of vertices you want to get the bounding box for.
    * @return The minimal Bounds for the given vertices.
    **/
-  static computeFromVertices(vertices: Array<Vertex>): Bounds {
-    if (vertices.length == 0) return new Bounds(new Vertex(0, 0), new Vertex(0, 0));
+  static computeFromVertices(vertices: Array<XYCoords>): Bounds {
+    if (vertices.length == 0) { 
+      return new Bounds(new Vertex(0, 0), new Vertex(0, 0));
+    }
 
     let xMin = vertices[0].x;
     let xMax = vertices[0].x;
     let yMin = vertices[0].y;
     let yMax = vertices[0].y;
 
-    let vert: Vertex;
+    let vert: XYCoords;
     for (var i in vertices) {
       vert = vertices[i];
       xMin = Math.min(xMin, vert.x);
@@ -178,6 +250,38 @@ export class Bounds implements IBounds, XYDimension {
     return new Bounds(new Vertex(xMin, yMin), new Vertex(xMax, yMax));
   }
 
+   /**
+   * Compute the minimal bounding box for a given set of existing bounding boxes.
+   *
+   * An empty vertex array will return an empty bounding box located at (0,0).
+   *
+   * @static
+   * @method computeFromBoundsSet
+   * @memberof Bounds
+   * @param {Array<IBounds>} boundingBoxes - The set of existing bounding boxes to get the containing bounding box for.
+   * @return The minimal Bounds for the given bounds instances.
+   **/
+  static computeFromBoundsSet(boundingBoxes:Array<IBounds>) : Bounds {
+    if (boundingBoxes.length == 0) {
+      return new Bounds(new Vertex(0, 0), new Vertex(0, 0));
+    }
+
+    let xMin = boundingBoxes[0].min.x;
+    let xMax = boundingBoxes[0].max.x;
+    let yMin = boundingBoxes[0].min.y;
+    let yMax = boundingBoxes[0].min.y;
+
+    let bounds: IBounds;
+    for (var i in boundingBoxes) {
+      bounds = boundingBoxes[i];
+      xMin = Math.min(xMin, bounds.min.x);
+      xMax = Math.max(xMax, bounds.max.x);
+      yMin = Math.min(yMin, bounds.min.y);
+      yMax = Math.max(yMax, bounds.min.y);
+    }
+    return new Bounds(new Vertex(xMin, yMin), new Vertex(xMax, yMax));
+  }
+
   /**
    * Create a new `Bounds` instance just from `width` and `height`, located at (0,0) or the optionally given origin.
    *

package/src/ts/Circle.ts

@@ -12,15 +12,18 @@
  * @modified 2022-08-15 Added the `containsPoint` function.
  * @modified 2022-08-23 Added the `lineIntersection` function.
  * @modified 2022-08-23 Added the `closestPoint` function.
- * @version  1.4.0
+ * @modified 2025-04-09 Added the `Circle.move(amount: XYCoords)` method.
+ * @modified 2025-04-16 Class `Circle` now implements interface `Intersectable`.
+ * @version  1.5.0
  **/
 
+import { Bounds } from "./Bounds";
 import { Line } from "./Line";
 import { UIDGenerator } from "./UIDGenerator";
 import { Vector } from "./Vector";
 import { VertTuple } from "./VertTuple";
 import { Vertex } from "./Vertex";
-import { SVGSerializable, UID, XYCoords } from "./interfaces";
+import { IBounded, Intersectable, SVGSerializable, UID, XYCoords } from "./interfaces";
 
 /**
  * @classdesc A simple circle: center point and radius.
@@ -33,7 +36,7 @@ import { SVGSerializable, UID, XYCoords } from "./interfaces";
  * @requires UID
  * @requires UIDGenerator
  **/
-export class Circle implements SVGSerializable {
+export class Circle implements IBounded, Intersectable, SVGSerializable {
   /**
    * Required to generate proper CSS classes and other class related IDs.
    **/
@@ -85,6 +88,20 @@ export class Circle implements SVGSerializable {
     this.radius = radius;
   }
 
+  /**
+   * Move the circle by the given amount.
+   *
+   * @method move
+   * @param {XYCoords} amount - The amount to move.
+   * @instance
+   * @memberof Circle
+   * @return {Circle} this for chaining
+   **/
+  move(amount: XYCoords): Circle {
+    this.center.add(amount);
+    return this;
+  }
+
   /**
    * Check if the given circle is fully contained inside this circle.
    *
@@ -159,8 +176,26 @@ export class Circle implements SVGSerializable {
     const pointA: Vertex = Circle.circleUtils.vertAt(angle, this.radius);
     // Construct the perpendicular of the line in point a. Then move relative to center.
     return (new Vector(pointA, new Vertex(0, 0)).add(this.center) as Vector).perp() as Vector;
+    // return (new Vector(this.center.clone(), pointA).add(pointA) as Vector).perp() as Vector;
   }
 
+  //--- BEGIN --- Implement interface `Intersectable`
+  /**
+   * Get the bounding box (bounds) of this Circle.
+   *
+   * @method getBounds
+   * @instance
+   * @memberof Circle
+   * @return {Bounds} The rectangular bounds of this Circle.
+   **/
+  getBounds(): Bounds {
+    return new Bounds(
+      this.center.clone().subXY(Math.abs(this.radius), Math.abs(this.radius)),
+      this.center.clone().addXY(Math.abs(this.radius), Math.abs(this.radius))
+    );
+  }
+  //--- END --- Implement interface `Intersectable`
+
   /**
    * Calculate the intersection points (if exists) with the given circle.
    *
@@ -221,7 +256,7 @@ export class Circle implements SVGSerializable {
    * @instance
    * @memberof Circle
    * @param {Vertex} a- The first of the two points defining the line.
-   * @param {Vertex} b - The second of the two points defining the line.
+   * @param {XYCoords} b - The second of the two points defining the line.
    * @return {Line|null} The intersection points (as a line) or null if this circle does not intersect the line given.
    **/
   lineIntersection(a: Vertex, b: XYCoords): Line | null {
@@ -262,9 +297,56 @@ export class Circle implements SVGSerializable {
     interB.y = (-det * diff.x - Math.abs(diff.y) * sqrt) / distSquared;
 
     return new Line(interA.add(this.center), interB.add(this.center));
-    // return new Line(interA, interB);
   }
 
+  //--- BEGIN --- Implement interface `Intersectable`
+  /**
+   * Get all line intersections with this circle.
+   *
+   * 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 circle outline.
+   */
+  lineIntersections(line: VertTuple<any>, inVectorBoundsOnly: boolean = false): Array<Vertex> {
+    // Find the intersections of all lines inside the edge bounds
+    const intersectioLine: Line | null = this.lineIntersection(line.a, line.b);
+    if (!intersectioLine) {
+      return [];
+    }
+    if (inVectorBoundsOnly) {
+      // const maxDist = line.length();
+      return [intersectioLine.a, intersectioLine.b].filter((vert: Vertex) => line.hasPoint(vert, true));
+    } else {
+      return [intersectioLine.a, intersectioLine.b];
+    }
+  }
+
+  /**
+   * 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 = false): Array<Vector> {
+    // Find the intersections of all lines plus their tangents inside the circle bounds
+    const interSectionPoints: Array<Vertex> = this.lineIntersections(line, inVectorBoundsOnly);
+    return interSectionPoints.map((vert: Vertex) => {
+      // Calculate angle
+      const lineFromCenter = new Line(this.center, vert);
+      const angle: number = lineFromCenter.angle();
+      // console.log("angle", (angle / Math.PI) * 180.0);
+      // const angle = Math.random() * Math.PI * 2; // TODO
+      // Calculate tangent at angle
+      return this.tangentAt(angle);
+    });
+  }
+  //--- END --- Implement interface `Intersectable`
+
   /**
    * Calculate the closest point on the outline of this circle to the given point.
    *