plotboilerplate 1.23.2 → 1.23.3

package/src/cjs/utils/algorithms/PolygonInset.js

@@ -0,0 +1,431 @@
+"use strict";
+/**
+ * Calculate the inset of any non-self-overlapping polygon.
+ *
+ * The polygon may be
+ *  - convex or non-convex
+ *  - self-intersecting
+ *
+ * The algorithms will
+ *  - first construct a general offset polygon which may be corrupt due to ouf-of-bounds or in illegal-area problems.
+ *  - then dissect the possibly self-intersecting inset polygon into separate simple polygons.
+ *  - then detect for each if it's out of bounds or in some illegal area.
+ *  - keeping only the valid ones.
+ *
+ * @required sutherlandHodgman
+ * @required splitPolygonToNonIntersecting
+ *
+ * @author   Ikaros Kappler
+ * @date     2024-11-04 Ported the script to a class.
+ * @modified 2024-12-02 Ported to Typescript.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolygonInset = void 0;
+var Line_1 = require("../../Line");
+var Polygon_1 = require("../../Polygon");
+var Vector_1 = require("../../Vector");
+var splitPolygonToNonIntersecting_1 = require("./splitPolygonToNonIntersecting");
+var sutherlandHodgman_1 = require("./sutherlandHodgman");
+var PolygonInset = /** @class */ (function () {
+    /**
+     * Constructs a new PolygonInset instance with the underlying given polygon to work with.
+     *
+     * Please note that the algorithm will reverse the vertex order if the given polygon
+     * is not clockwise.
+     *
+     * @param {Polygon} polygon - The polygon to calculate the offset for.
+     */
+    function PolygonInset(polygon) {
+        /**
+         * The original polygon as a sequence of line objects. This is easier to use than a list of points.
+         */
+        this.originalPolygonLines = [];
+        /**
+         * The simple inset lines, directly generated by offsetting the original polygon lines by the given amount.
+         */
+        this.insetLines = [];
+        /**
+         * The cropped inset lines that makes up the first direct iteration of the inset polygon.
+         * This one will probably be self-intersecting.
+         */
+        this.insetPolygonLines = [];
+        /**
+         * The inset polygon split up into simple non-self-intersecting polygons.
+         * Represented as a list of vertex-lists. Each sub-list represents a single polygon.
+         */
+        this.splitPolygons = [];
+        this.polygon = polygon;
+    }
+    /**
+     * This is the main method.
+     *
+     * Call this with the required option params to compute your desired offset polygon(s).
+     *
+     * @param {number} options.innerPolygonOffset - The offset to use. Should be a positive number. Correct result for negative numbers are not guaranteed.
+     * @param {number?} options.maxPolygonSplitDepth - (default is the number of polygon.vertices) The maximum amount of recursive stepts to simplify the complex first iteration of the offset polygon.
+     * @param {number?} options.intersectionEpsilon - (default is 1.0) The epsilon to use for detecting overlapping polygons. This indicates a tolerance value, because directly adjecent polygons may have a little arithmetic intersection area.
+     * @returns {Array<Array<Vertex>>} A list of vertex-lists, each one representing a simple polygon from the offset-polygons.
+     */
+    PolygonInset.prototype.computeOutputPolygons = function (options) {
+        var _a;
+        // No offset implies: no change.
+        if (options.innerPolygonOffset === 0) {
+            return [this.polygon.vertices]; // No change
+        }
+        // This algorithm only works with polygon in clockwise vertex order.
+        // If the polygon is not clockwise: revert.
+        PolygonInset._assertPolygonIsClockwise(this.polygon.vertices);
+        // The potential result polygons might overlap with other parts. These are not part of the desired
+        // result set and need to be filtered out.
+        // Define an intersection-epsilon: minimal critical overlaps might result of rounding errors and
+        // don't represent real overlaps.
+        var intersectionEpsilon = options.intersectionEpsilon;
+        // This will create a deep clone
+        this.optimizedPolygon = this.polygon.clone();
+        // In case the potential result polygons are self intersecting we need to split them apart later.
+        // Using the initial vertex number as the upper split limit should be safe here.
+        var maxPolygonSplitDepth = (_a = options === null || options === void 0 ? void 0 : options.maxPolygonSplitDepth) !== null && _a !== void 0 ? _a : this.optimizedPolygon.vertices.length;
+        // For calculations of initial inset rectagles we need the original polygon's lines.
+        this.originalPolygonLines = this.optimizedPolygon.getEdges();
+        this._collectInsetLines(this.originalPolygonLines, options.innerPolygonOffset);
+        this._collectInsetPolygonLines(this.insetLines);
+        this.insetRectanglePolygons = this._collectRectangularPolygonInsets(this.originalPolygonLines, this.insetLines);
+        // Optimize inset polygon AND the insetRectanglePolygons?
+        if (options.removeEars) {
+            // console.log("Remove ears");
+            // This will modify both params!
+            PolygonInset._optimizeInsetPolygon(this.optimizedPolygon, this.insetRectanglePolygons);
+        }
+        // Create a naive first inset polygon for later optimization.
+        this.insetPolygon = PolygonInset.convertToBasicInsetPolygon(this.insetPolygonLines);
+        // // Optimize inset polygon AND the insetRectanglePolygons!
+        // if (options.removeEars) {
+        //   // This will modify both params!
+        //   PolygonInset._optimizeInsetPolygon(this.insetPolygon, this.insetRectanglePolygons);
+        // }
+        // The resulting polygon will likely intersect itself multiple times.
+        // For further calculations split apart into non-self-intersecting.
+        this.splitPolygons = (0, splitPolygonToNonIntersecting_1.splitPolygonToNonIntersecting)(this.insetPolygon.vertices, maxPolygonSplitDepth, true); // insideBoundsOnly
+        // This method was initially meant to calculate inset-polygons only.
+        // But with a simple filter we COULD also create outer offset-polygons.
+        // Maybe this is a task for the future
+        // console.log("DEBUG", DEBUG);
+        // DEBUG("TEST");
+        if (options.innerPolygonOffset < 0) {
+            // return [this.polygon.vertices]; // No change
+        }
+        // console.log("splitPolygons.length", this.splitPolygons.length);
+        // Assert all polygons are clockwise!
+        PolygonInset._assertAllPolygonsAreClockwise(this.splitPolygons);
+        this.filteredSplitPolygons = PolygonInset._filterInnerSplitPolygonsByCoverage(this.splitPolygons, this.insetRectanglePolygons, intersectionEpsilon);
+        // console.log("[0] filteredSplitPolygons.length", this.filteredSplitPolygons.length);
+        this.filteredSplitPolygons = PolygonInset._filterInnerSplitPolygonsByOriginalBounds(this.filteredSplitPolygons, this.polygon);
+        // console.log("[1] filteredSplitPolygons.length", this.filteredSplitPolygons.length);
+        return this.filteredSplitPolygons;
+    };
+    /**
+     * This method transforms each polygon line into a new line
+     * by moving it to the inside direction of the polygon (by the given `insetAmount`).
+     *
+     * @param {Array<Line>} polygonLines
+     * @param {number} insetAmount
+     * @return {Array<Line>} The transformed lines. The result array has the same length and order as the input array.
+     */
+    PolygonInset.prototype._collectInsetLines = function (polygonLines, insetAmount) {
+        var insetLines = []; // Array<Line>
+        for (var i = 0; i < polygonLines.length; i++) {
+            var line = polygonLines[i];
+            var perp = new Vector_1.Vector(line.a, line.b).perp();
+            var t = insetAmount / perp.length();
+            var offsetOnPerp = perp.vertAt(t);
+            var diff = line.a.difference(offsetOnPerp);
+            // Polygon is is clockwise order.
+            // Move line inside polygon
+            var movedLine = line.clone();
+            movedLine.a.add(diff);
+            movedLine.b.add(diff);
+            insetLines.push(movedLine);
+        }
+        this.insetLines = insetLines;
+        return insetLines;
+    };
+    /**
+     * For a sequence of inset polygon lines get the inset polygon by detecting
+     * useful intersections (by cropping or extending them).
+     *
+     * The returned lines resemble a new polygon.
+     *
+     * Please note that the returned polygon can be self-intersecting!
+     *
+     * @param {Array<Line>} insetLines
+     * @returns {Array<Line>} The cropped or exented inset polygon lines.
+     */
+    PolygonInset.prototype._collectInsetPolygonLines = function (insetLines) {
+        if (insetLines.length <= 1) {
+            return [];
+        }
+        var insetPolygonLines = [];
+        // Collect first intersection at beginning :)
+        var lastInsetLine = insetLines[insetLines.length - 1];
+        var firstInsetLine = insetLines[0];
+        var lastIntersectionPoint = lastInsetLine.intersection(firstInsetLine); // Must not be null
+        for (var i = 0; i < insetLines.length; i++) {
+            var insetLine = insetLines[i];
+            var nextInsetLine = insetLines[(i + 1) % insetLines.length];
+            // Find desired intersection
+            var intersection = insetLine.intersection(nextInsetLine);
+            if (intersection == null) {
+                console.warn("[collectInsetPolygon] WARN intersection line must not be null", i, nextInsetLine);
+            }
+            else {
+                // By construction they MUST have any non-null intersection!
+                if (lastIntersectionPoint != null) {
+                    var resultLine = new Line_1.Line(lastIntersectionPoint, intersection);
+                    insetPolygonLines.push(resultLine);
+                }
+            }
+            lastIntersectionPoint = intersection;
+        }
+        // Store intermediate result for later retrieval.
+        this.insetPolygonLines = insetPolygonLines;
+        return insetPolygonLines;
+    };
+    /**
+     * Converts two lists (same length) of original polygon lines and inset lines (interpreted as
+     * pairs) to a list of rectangular polyons.
+     *
+     * @static
+     * @param {Array<Line>} originalPolygonLines
+     * @param {Array<Line>} insetLines
+     * @returns {Array<Polygon>} A list of rectangular polygons; each returned polyon has exactly four vertices.
+     */
+    PolygonInset.prototype._collectRectangularPolygonInsets = function (originalPolygonLines, insetLines) {
+        // Convert to rectangle polygon
+        var insetRectanglePolygons = originalPolygonLines.map(function (polygonLine, index) {
+            var rectPolygon = new Polygon_1.Polygon([], false);
+            // Add in original order
+            rectPolygon.vertices.push(polygonLine.a.clone());
+            rectPolygon.vertices.push(polygonLine.b.clone());
+            // Add in reverse order
+            var insetLine = insetLines[index];
+            rectPolygon.vertices.push(insetLine.b.clone());
+            rectPolygon.vertices.push(insetLine.a.clone());
+            return rectPolygon;
+        });
+        return insetRectanglePolygons;
+    };
+    /**
+     * Converts a sequence of (hopefully adjacent) lines to a polygon by using all second line vertices `b`.
+     *
+     * @static
+     * @param insetPolygonLines
+     * @returns
+     */
+    PolygonInset.convertToBasicInsetPolygon = function (insetPolygonLines) {
+        var insetPolygon = new Polygon_1.Polygon([], false);
+        insetPolygonLines.forEach(function (insetLine) {
+            insetPolygon.vertices.push(insetLine.a);
+        });
+        return insetPolygon;
+    };
+    /**
+     * Filter split polygons: only keep those whose vertices are all contained inside the original polygon.
+     * Reason: scaling too much will result in excessive translation beyond the opposite bounds of the polygon (like more than 200% of possible insetting).
+     *
+     * @param {Array<Array<Vertex>>} splitPolygonsVertices
+     * @param {Polygon} originalPolygon
+     * @return {Array<Array<Vertex>>} The filtered polygon list.
+     */
+    PolygonInset._filterInnerSplitPolygonsByOriginalBounds = function (splitPolygonsVertices, originalPolygon) {
+        return splitPolygonsVertices.filter(function (splitPolyVerts, _splitPolyIndex) {
+            return splitPolyVerts.every(function (splitPVert) {
+                return originalPolygon.containsVert(splitPVert);
+            });
+        });
+    };
+    /**
+     * Filter split polygons: only keep those that do not (signifiantly) interset with any rectangles.
+     *
+     * @static
+     * @param {Array<Array<Vertex>>} splitPolygonsVertices
+     * @param {Array<Polygon>} insetRectanglePolygons
+     * @param {number?=1.0} intersectionEpsilon - (optional, default is 1.0) A epsislon to define a tolerance for checking if two polygons intersect.
+     */
+    PolygonInset._filterInnerSplitPolygonsByCoverage = function (splitPolygonsVertices, insetRectanglePolygons, intersectionEpsilon) {
+        // TEST: Add some jitter
+        // splitPolygonsVertices.forEach(split => {
+        //   split.forEach(vert => {
+        //     vert.x += (0.5 - Math.random()) * 0.01;
+        //     vert.y += (0.5 - Math.random()) * 0.01;
+        //   });
+        // });
+        splitPolygonsVertices.forEach(function (split, index) {
+            var isCW = Polygon_1.Polygon.utils.isClockwise(split);
+            if (!isCW) {
+                console.warn("------ split is not isClockwise!", index, isCW);
+            }
+        });
+        insetRectanglePolygons.forEach(function (rect, index) {
+            var isCW = rect.isClockwise();
+            if (!isCW) {
+                console.warn("------ rect is not isClockwise!", index, isCW);
+            }
+        });
+        var eps = intersectionEpsilon === undefined || typeof intersectionEpsilon === "undefined" ? 1.0 : intersectionEpsilon;
+        return splitPolygonsVertices.filter(function (splitPolyVerts, _splitPolyIndex) {
+            var intersectionTestCallback = PolygonInset._hasIntersectionCallback(splitPolyVerts, eps, _splitPolyIndex);
+            var intersectsWithAnyRect = insetRectanglePolygons.some(intersectionTestCallback);
+            return !intersectsWithAnyRect;
+        });
+    };
+    /**
+     * This private method will reverse each polygon's vertex order that's not clockwise.
+     *
+     * @param {Array<Vertex[]>} polygons
+     */
+    PolygonInset._assertAllPolygonsAreClockwise = function (polygons) {
+        polygons.forEach(function (polygonVerts, _polyIndex) {
+            // if (!Polygon.utils.isClockwise(polygonVerts)) {
+            //   polygonVerts.reverse(); // Attention: this happens in-place (Array.reverse is destructive!)
+            // }
+            PolygonInset._assertPolygonIsClockwise(polygonVerts);
+        });
+    };
+    /**
+     * This private method will revert the vertex order if the polygon is not clockwise.
+     *
+     * @param {Vertex[]} polygonVerts
+     */
+    PolygonInset._assertPolygonIsClockwise = function (polygonVerts) {
+        if (!Polygon_1.Polygon.utils.isClockwise(polygonVerts)) {
+            polygonVerts.reverse(); // Attention: this happens in-place (Array.reverse is destructive!)
+        }
+    };
+    /**
+     * Optimize the inset polygon by removing critical `ear` edges.
+     * Such an is identified by: the edge itself is completely located inside its neighbours inset rectangle.
+     *
+     * In this process multiple edges from the ear might be dropped and two adjacent edges get a new
+     * common intersection point.
+     *
+     * Note: this method is not working as expected in all cases and quite experimental.
+     *
+     * @param insetPolygon
+     * @param insetRectangles
+     */
+    PolygonInset._optimizeInsetPolygon = function (insetPolygon, insetRectangles) {
+        // Locate edge that can be removed:
+        var earEdgeIndex = -1;
+        var maxLimit = insetPolygon.vertices.length;
+        var i = 0;
+        while (i++ < maxLimit &&
+            insetPolygon.vertices.length > 3 &&
+            (earEdgeIndex = PolygonInset._locateExcessiveEarEdge(insetPolygon, insetRectangles)) != -1) {
+            // console.log("REMOVE EAR EDGE", earEdgeIndex);
+            // As this is an ear edge: don't just remove the vertex.
+            //   i) Remove the vertex and calculate the new intersection point of neighbour edges.
+            //  ii) Update neightbour rectangles
+            var leftEdge = insetPolygon.getEdgeAt(earEdgeIndex - 2);
+            var rightEdge = insetPolygon.getEdgeAt(earEdgeIndex + 1);
+            var newIntersection = leftEdge.intersection(rightEdge);
+            newIntersection && rightEdge.a.set(newIntersection);
+            // Update rectangles
+            // ...
+            insetPolygon.vertices.splice(earEdgeIndex, 1);
+            insetRectangles.splice(earEdgeIndex, 1);
+        }
+        // TODO remove if not -1
+    };
+    PolygonInset._locateExcessiveEarEdge = function (insetPolygon, insetRectangles) {
+        for (var i = 0; i < insetPolygon.vertices.length; i++) {
+            var thisEdge = insetPolygon.getEdgeAt(i);
+            var leftIndex = i == 0 ? insetPolygon.vertices.length - 1 : i - 1;
+            // const rightIndex = i + 1 >= insetPolygon.vertices.length ? 0 : i + 1;
+            var leftRect = insetRectangles[leftIndex];
+            // const rightRect = insetRectangles[rightIndex];
+            var leftRectContainsThisEdge = PolygonInset._rectangleFullyContainsLine(leftRect, thisEdge);
+            if (leftRectContainsThisEdge) {
+                return i;
+            }
+            var leftEdge = insetPolygon.getEdgeAt(leftIndex);
+            var thisRect = insetRectangles[i];
+            var thisRectContainsLeftEdge = PolygonInset._rectangleFullyContainsLine(thisRect, leftEdge);
+            if (thisRectContainsLeftEdge) {
+                return i; // leftIndex;
+            }
+        }
+        return -1;
+    };
+    // Pre: rectangle.vertices.length === 4
+    PolygonInset._rectangleFullyContainsLine = function (rectangle, edge) {
+        var rectWidth = rectangle.getEdgeAt(0).length();
+        var rectHeight = rectangle.getEdgeAt(1).length();
+        // Both line corners must be at least 1% within the rectangle limits.
+        var eps = Math.min(rectWidth, rectHeight) / 100;
+        var edgeLen = edge.length();
+        var epsPointA = edge.vertAt(0.01); // edgeLen * eps);
+        var epsPointB = edge.vertAt(0.99); // 1.0 - edgeLen * eps);
+        var centerPoint = edge.vertAt(0.5);
+        return rectangle.containsVerts([epsPointA, epsPointB, centerPoint]);
+    };
+    /**
+     * For simplification I'm using a callback generator function here.
+     *
+     * @param splitPolyVerts
+     * @param eps
+     * @param _splitPolyIndex
+     * @returns {Function} The callback for an `Array.some` parameter.
+     */
+    PolygonInset._hasIntersectionCallback = function (splitPolyVerts, eps, _splitPolyIndex) {
+        return function (rectanglePoly, _rectanglePolyIndex) {
+            // const intersectionVerts: XYCoords[] = sutherlandHodgman(splitPolyVerts, rectanglePoly.vertices);
+            var intersectionVerts = (0, sutherlandHodgman_1.sutherlandHodgman)(rectanglePoly.vertices, splitPolyVerts);
+            // var intersection = GreinerHorman.intersection(sourcePolygon.vertices, clipPolygon.vertices);
+            // const uniqueIntersectionVerts = clearDuplicateVertices(intersectionVerts);
+            var intersectionAreaSize = Polygon_1.Polygon.utils.area(intersectionVerts);
+            if (intersectionAreaSize < 0) {
+                console.warn("%cFound a polygon split with negative area. Counterclockwise against all odds?", "color: red; background: black;", //  font-size: 30px",
+                "intersectionAreaSize", intersectionAreaSize, "_splitPolyIndex", _splitPolyIndex, "_rectanglePolyIndex", _rectanglePolyIndex, "intersectionVerts", intersectionVerts
+                // "uniqueIntersectionVerts",
+                // uniqueIntersectionVerts
+                );
+            }
+            // if (intersectionAreaSize >= eps) {
+            //   console.log(
+            //     "%cFound a polygon split for removal",
+            //     "color: orange; background: grey;", //  font-size: 30px",
+            //     "intersectionAreaSize",
+            //     intersectionAreaSize,
+            //     "_splitPolyIndex",
+            //     _splitPolyIndex,
+            //     "_rectanglePolyIndex",
+            //     _rectanglePolyIndex,
+            //     "intersectionVerts",
+            //     intersectionVerts
+            //     // "uniqueIntersectionVerts",
+            //     // uniqueIntersectionVerts
+            //   );
+            // }
+            // if (intersectionAreaSize < eps) {
+            //   // console.log("%cHello", "color: green; background: yellow; font-size: 30px");
+            //   console.log(
+            //     "Polygon split can be kept. Area is position but below epsilon.",
+            //     "intersectionAreaSize",
+            //     intersectionAreaSize,
+            //     "_splitPolyIndex",
+            //     _splitPolyIndex,
+            //     "_rectanglePolyIndex",
+            //     _rectanglePolyIndex,
+            //     "intersectionVerts",
+            //     intersectionVerts
+            //     // "uniqueIntersectionVerts",
+            //     // uniqueIntersectionVerts
+            //   );
+            // }
+            return intersectionAreaSize >= eps;
+        };
+    };
+    return PolygonInset;
+}());
+exports.PolygonInset = PolygonInset;
+//# sourceMappingURL=PolygonInset.js.map

package/src/cjs/utils/algorithms/PolygonInset.js.map

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

package/src/cjs/utils/algorithms/clearDuplicateVertices.d.ts

@@ -6,16 +6,17 @@
  * @author   Ikaros Kappler
  * @date     2021-07-13
  * @modified 2023-10-28 Refactored and ported to Typescript.
- * @version  1.0.0
+ * @modified 2024-12-17 Simplified this method to work with generic sub types of XYCoords as well.
+ * @version  1.0.1
  */
-import { Vertex } from "../../Vertex";
+import { XYCoords } from "../../interfaces";
 /**
  * Filter the array and clear all duplicates.
  *
  * The original array is left unchanged. The vertices in the array are not cloned.
  *
- * @param {Vertex[]} vertices
+ * @param {XYCoords[]} vertices
  * @param {number=EPS} epsilon
  * @return {Vertex[]}
  */
-export declare const clearDuplicateVertices: (vertices: Vertex[], epsilon?: number) => Vertex[];
+export declare const clearDuplicateVertices: <T extends XYCoords>(vertices: T[], epsilon?: number) => T[];

package/src/cjs/utils/algorithms/clearDuplicateVertices.js

@@ -7,17 +7,19 @@
  * @author   Ikaros Kappler
  * @date     2021-07-13
  * @modified 2023-10-28 Refactored and ported to Typescript.
- * @version  1.0.0
+ * @modified 2024-12-17 Simplified this method to work with generic sub types of XYCoords as well.
+ * @version  1.0.1
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clearDuplicateVertices = void 0;
+var geomutils_1 = require("../../geomutils");
 var EPS = 0.000001;
 /**
  * Filter the array and clear all duplicates.
  *
  * The original array is left unchanged. The vertices in the array are not cloned.
  *
- * @param {Vertex[]} vertices
+ * @param {XYCoords[]} vertices
  * @param {number=EPS} epsilon
  * @return {Vertex[]}
  */
@@ -35,7 +37,8 @@ var clearDuplicateVertices = function (vertices, epsilon) {
 };
 exports.clearDuplicateVertices = clearDuplicateVertices;
 var isCloseTo = function (vertA, vertB, eps) {
-    return vertA.distance(vertB) < eps;
+    // return vertA.distance(vertB) < eps;
+    return geomutils_1.geomutils.dist4(vertA.x, vertA.y, vertB.x, vertB.y) < eps;
 };
 var containsElementFrom = function (vertices, vertex, fromIndex, epsilon) {
     for (var i = fromIndex; i < vertices.length; i++) {

package/src/cjs/utils/algorithms/clearDuplicateVertices.js.map

@@ -1 +1 @@
-{"version":3,"file":"clearDuplicateVertices.js","sourceRoot":"","sources":["../../../ts/utils/algorithms/clearDuplicateVertices.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAIH,IAAM,GAAG,GAAW,QAAQ,CAAC;AAE7B;;;;;;;;GAQG;AACI,IAAM,sBAAsB,GAAG,UAAC,QAAkB,EAAE,OAAgB;IACzE,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,GAAG,GAAG,CAAC;IAChB,CAAC;IACD,IAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAXW,QAAA,sBAAsB,0BAWjC;AAEF,IAAM,SAAS,GAAG,UAAC,KAAa,EAAE,KAAa,EAAE,GAAW;IAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC,CAAC;AAEF,IAAM,mBAAmB,GAAG,UAAC,QAAuB,EAAE,MAAc,EAAE,SAAiB,EAAE,OAAe;IACtG,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"clearDuplicateVertices.js","sourceRoot":"","sources":["../../../ts/utils/algorithms/clearDuplicateVertices.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6CAA4C;AAG5C,IAAM,GAAG,GAAW,QAAQ,CAAC;AAE7B;;;;;;;;GAQG;AACI,IAAM,sBAAsB,GAAG,UAAqB,QAAa,EAAE,OAAgB;IACxF,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,GAAG,GAAG,CAAC;IAChB,CAAC;IACD,IAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAXW,QAAA,sBAAsB,0BAWjC;AAEF,IAAM,SAAS,GAAG,UAAqB,KAAQ,EAAE,KAAQ,EAAE,GAAW;IACpE,sCAAsC;IACtC,OAAO,qBAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AACnE,CAAC,CAAC;AAEF,IAAM,mBAAmB,GAAG,UAAqB,QAAkB,EAAE,MAAS,EAAE,SAAiB,EAAE,OAAe;IAChH,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/src/cjs/utils/algorithms/findPolygonSelfIntersections.d.ts

@@ -5,6 +5,7 @@
  * @author   Ikaros Kappler
  * @date     2020-12-04
  * @modified 2020-12-09 Ported from vanilla JS to Typescript.
+ * @modified 2024-11-22 Fixed a type error in line 41.
  */
 import { Vertex } from "../../Vertex";
 import { XYCoords } from "../../interfaces";
@@ -15,6 +16,6 @@ import { XYCoords } from "../../interfaces";
  *
  * @name findPolygonSelfIntersections
  * @param {Array<Vertex>} vertices - The vertices that form the polygon.
- * @return Array<Vertex>
+ * @return {Array<Vertex>}
  */
 export declare const findPolygonSelfIntersections: (vertices: Array<XYCoords>) => Array<Vertex>;

package/src/cjs/utils/algorithms/findPolygonSelfIntersections.js

@@ -6,6 +6,7 @@
  * @author   Ikaros Kappler
  * @date     2020-12-04
  * @modified 2020-12-09 Ported from vanilla JS to Typescript.
+ * @modified 2024-11-22 Fixed a type error in line 41.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findPolygonSelfIntersections = void 0;
@@ -18,7 +19,7 @@ var Vertex_1 = require("../../Vertex");
  *
  * @name findPolygonSelfIntersections
  * @param {Array<Vertex>} vertices - The vertices that form the polygon.
- * @return Array<Vertex>
+ * @return {Array<Vertex>}
  */
 var findPolygonSelfIntersections = function (vertices) {
     var pointList = [];
@@ -39,8 +40,7 @@ var findPolygonSelfIntersections = function (vertices) {
             // The point is undefined if and only if both line are parallel (co-linear).
             var intersectionPoint = lineA.intersection(lineB);
             // Check if the intersection point is on both (finite) edges of the polygon.
-            if (intersectionPoint
-                && lineA.hasPoint(intersectionPoint) && lineB.hasPoint(intersectionPoint)) {
+            if (intersectionPoint && lineA.hasPoint(intersectionPoint) && lineB.hasPoint(intersectionPoint)) {
                 pointList.push(intersectionPoint);
             }
         }

package/src/cjs/utils/algorithms/findPolygonSelfIntersections.js.map

@@ -1 +1 @@
-{"version":3,"file":"findPolygonSelfIntersections.js","sourceRoot":"","sources":["../../../ts/utils/algorithms/findPolygonSelfIntersections.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,mCAAkC;AAClC,uCAAsC;AAGtC;;;;;;;;GAQG;AACI,IAAM,4BAA4B,GAAG,UAAE,QAAwB;IAClE,IAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,IAAM,KAAK,GAAU,IAAI,WAAI,CAAE,IAAI,eAAM,EAAE,EAAE,IAAI,eAAM,EAAE,CAAE,CAAC;IAC5D,IAAM,KAAK,GAAU,IAAI,WAAI,CAAE,IAAI,eAAM,EAAE,EAAE,IAAI,eAAM,EAAE,CAAE,CAAC;IAC5D,IAAM,CAAC,GAAY,QAAQ,CAAC,MAAM,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAG,CAAC;QACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAE,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAE,QAAQ,CAAC,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,CAAC,CAAC,CAAE,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAG,CAAC;YAC1B,wDAAwD;YACxD,aAAa;YACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAC,CAAC,IAAI,CAAC,CAAC,IAAE,CAAC,IAAE,CAAC,GAAC,CAAC,IAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAE,CAAC,IAAE,CAAC,GAAC,CAAC,IAAE,CAAC,CAAC;gBACzE,SAAS;YACN,KAAK,CAAC,CAAC,CAAC,GAAG,CAAE,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAC;YAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAE,QAAQ,CAAC,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,CAAC,CAAC,CAAE,CAAC;YAEjC,2DAA2D;YAC3D,4EAA4E;YAC5E,IAAM,iBAAiB,GAAsB,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAEvE,4EAA4E;YAC5E,IAAI,iBAAiB;mBACrB,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAG,CAAC;gBAC7E,SAAS,CAAC,IAAI,CAAE,iBAAiB,CAAE,CAAC;YACjC,CAAC;QACL,CAAC;IACE,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AA5BW,QAAA,4BAA4B,gCA4BvC"}
+{"version":3,"file":"findPolygonSelfIntersections.js","sourceRoot":"","sources":["../../../ts/utils/algorithms/findPolygonSelfIntersections.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mCAAkC;AAClC,uCAAsC;AAGtC;;;;;;;;GAQG;AACI,IAAM,4BAA4B,GAAG,UAAC,QAAyB;IACpE,IAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,IAAM,KAAK,GAAS,IAAI,WAAI,CAAC,IAAI,eAAM,EAAE,EAAE,IAAI,eAAM,EAAE,CAAC,CAAC;IACzD,IAAM,KAAK,GAAS,IAAI,WAAI,CAAC,IAAI,eAAM,EAAE,EAAE,IAAI,eAAM,EAAE,CAAC,CAAC;IACzD,IAAM,CAAC,GAAW,QAAQ,CAAC,MAAM,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,wDAAwD;YACxD,aAAa;YACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAAE,SAAS;YACrG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAEnC,2DAA2D;YAC3D,4EAA4E;YAC5E,IAAM,iBAAiB,GAAkB,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAEnE,4EAA4E;YAC5E,IAAI,iBAAiB,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAChG,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AA1BW,QAAA,4BAA4B,gCA0BvC"}

package/src/cjs/utils/algorithms/splitPolygonToNonIntersecting.d.ts

@@ -5,7 +5,8 @@
  * @author   Ikaros Kappler
  * @date     2020-12-04
  * @modified 2020-12-07 Ported from vanilla JS to typescript.
- * @version  1.0.1
+ * @modified 2024-11-22 Added the `insideBoundsOnly` param to the `splitPolygonToNonIntersecting` algorithm.
+ * @version  1.1.0
  */
 import { Vertex } from "../../Vertex";
 /**
@@ -24,4 +25,4 @@ import { Vertex } from "../../Vertex";
  * @param {number=10} maxDepth - Number of max recursive steps (default is 10).
  * @return {Array<Array<Vertex>>} A sequence of non-self-intersecting sub polygons.
  */
-export declare const splitPolygonToNonIntersecting: (vertices: Array<Vertex>, maxDepth?: number) => Array<Array<Vertex>>;
+export declare const splitPolygonToNonIntersecting: (vertices: Array<Vertex>, maxDepth?: number, insideBoundsOnly?: boolean) => Array<Array<Vertex>>;

package/src/cjs/utils/algorithms/splitPolygonToNonIntersecting.js

@@ -6,7 +6,8 @@
  * @author   Ikaros Kappler
  * @date     2020-12-04
  * @modified 2020-12-07 Ported from vanilla JS to typescript.
- * @version  1.0.1
+ * @modified 2024-11-22 Added the `insideBoundsOnly` param to the `splitPolygonToNonIntersecting` algorithm.
+ * @version  1.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitPolygonToNonIntersecting = void 0;
@@ -33,12 +34,12 @@ exports.splitPolygonToNonIntersecting = (function () {
      * @param {Array<Vertex>} vertices
      * @param {number=10} maxDepth
      */
-    var splitPolygonToNonIntersecting = function (vertices, maxDepth) {
+    var splitPolygonToNonIntersecting = function (vertices, maxDepth, insideBoundsOnly) {
         if (typeof maxDepth === "undefined")
             maxDepth = 10;
-        return _splitPolygonToNonIntersecting(vertices, maxDepth);
+        return _splitPolygonToNonIntersecting(vertices, maxDepth, insideBoundsOnly);
     };
-    var _splitPolygonToNonIntersecting = function (vertices, maxDepth) {
+    var _splitPolygonToNonIntersecting = function (vertices, maxDepth, insideBoundsOnly) {
         if (maxDepth <= 0) {
             // aborting at max depth
             return [vertices];
@@ -56,18 +57,19 @@ exports.splitPolygonToNonIntersecting = (function () {
             for (var b = 0; b < vertices.length; b++) {
                 // Equal edges or neighbour edges intersect by definition.
                 // We ignore them.
-                if (a == b || a + 1 == b || a == b + 1
-                    || (a == 0 && b + 1 == vertices.length) || (b == 0 && a + 1 == vertices.length))
+                if (a == b || a + 1 == b || a == b + 1 || (a == 0 && b + 1 == vertices.length) || (b == 0 && a + 1 == vertices.length))
                     continue;
                 lineB.a.set(vertices[b]);
                 lineB.b.set(vertices[(b + 1) % n]);
                 var intersectionPoint = lineA.intersection(lineB);
-                if (intersectionPoint && lineA.hasPoint(intersectionPoint) && lineB.hasPoint(intersectionPoint)) {
+                if (intersectionPoint &&
+                    lineA.hasPoint(intersectionPoint, insideBoundsOnly) &&
+                    lineB.hasPoint(intersectionPoint, insideBoundsOnly)) {
                     // Cut polygon into two here
                     var split = splitPolygonAt(vertices, a, b, intersectionPoint);
                     // Split has 2 elements.
-                    var leftCleaned = _splitPolygonToNonIntersecting(split[0], maxDepth - 1);
-                    var rightCleaned = _splitPolygonToNonIntersecting(split[1], maxDepth - 1);
+                    var leftCleaned = _splitPolygonToNonIntersecting(split[0], maxDepth - 1, insideBoundsOnly);
+                    var rightCleaned = _splitPolygonToNonIntersecting(split[1], maxDepth - 1, insideBoundsOnly);
                     return leftCleaned.concat(rightCleaned);
                 }
             }