plotboilerplate 1.29.0 → 1.31.0

package/src/esm/utils/datastructures/PointSet.js

@@ -0,0 +1,115 @@
+/**
+ * A mutable point set datastructure for holding a finite but variable set of vertices.
+ *
+ * @date    2026-09-12
+ * @author  Ikaros Kappler
+ * @version 1.0.0
+ */
+export class PointSet {
+    constructor(pb) {
+        this.dragListeners = [];
+        this.pb = pb;
+        this.points = [];
+    }
+    fireDragEvent() {
+        this.dragListeners.forEach(listener => {
+            listener();
+        });
+    }
+    /**
+     * Adds a random point to the point list.
+     *
+     * @name addRandomPoint
+     * @instance
+     * @override
+     * @memberof PointSet
+     * @return {void}
+     */
+    addRandomPoint(horizontalSafeArea = 0, verticalSafeArea = 0) {
+        // this.addVertex(Vertex.randomVertex(this.pb.viewport()).scale(0.5));
+        this.addVertex(this.pb.viewport().randomPoint(horizontalSafeArea, verticalSafeArea));
+    }
+    /**
+     * Adds the given point/vertex to the point list.
+     *
+     * @name addVertex
+     * @instance
+     * @override
+     * @memberof PointSet
+     * @param {Vertex} vert - The vertex to add.
+     * @return {void}
+     */
+    addVertex(vert) {
+        this.points.push(vert);
+        this.pb.add(vert, false); // redraw=false
+        var _self = this;
+        vert.listeners.addDragListener(function () {
+            _self.fireDragEvent();
+        });
+        // vert.listeners.addDragListener(_self.fireDragEvent);
+    }
+    /**
+     * Remove all vertices from this set and from the plotboilerplate instance.
+     *
+     * @name clear
+     * @instance
+     * @override
+     * @memberof PointSet
+     * @return {void}
+     */
+    clear() {
+        for (var i = 0; i < this.points.length; i++) {
+            this.pb.remove(this.points[i], false);
+            // TODO: How to remove drag listener?
+            //   this.points[i].listeners.removeDragListener(this.fireDragEvent);
+        }
+        this.points = [];
+    }
+    /**
+     * Add or remove n random points; depends on the config settings.
+     *
+     * I have no idea how tired I was when I wrote this function but it seems working pretty well.
+     */
+    randomPoints(pointCount, horizontalSafeArea = 0, verticalSafeArea = 0) {
+        // Generate random points.
+        for (var i = this.points.length; i < pointCount; i++) {
+            this.addRandomPoint(horizontalSafeArea, verticalSafeArea);
+        }
+    }
+    /**
+     * Add random points and be sure they cover the whole viewport.
+     *
+     * I have no idea how tired I was when I wrote this function but it seems working pretty well.
+     */
+    randomFullCover(pointCount) {
+        this.clear();
+        this.randomPoints(pointCount - 4, 0.0, 0.0); //, true, true);
+        // Add 4 more points in the corners.
+        var viewport = this.pb.viewport();
+        this.addVertex(viewport.getNorthWestPoint());
+        this.addVertex(viewport.getNorthEastPoint());
+        this.addVertex(viewport.getSouthWestPoint());
+        this.addVertex(viewport.getSouthEastPoint());
+    }
+    /**
+     * Call when the desired number of points changes.
+     **/
+    updatePointCount(newPointCount, horizontalSafeArea = 0, verticalSafeArea = 0) {
+        if (newPointCount > this.points.length) {
+            this.randomPoints(newPointCount, horizontalSafeArea, verticalSafeArea);
+        }
+        // Do not clear ; no full cover ; do rebuild
+        else if (newPointCount < this.points.length) {
+            // Remove n-m points
+            for (var i = newPointCount; i < this.points.length; i++) {
+                this.pb.remove(this.points[i]);
+            }
+            // TODO: MOVE THIS TO THE PointSet class.
+            this.points = this.points.slice(0, newPointCount);
+            // TODO: also remove listeners?
+            //   updateAnimator();
+            //   rebuild();
+        }
+    }
+}
+//# sourceMappingURL=PointSet.js.map

package/src/esm/utils/datastructures/PointSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointSet.js","sourceRoot":"","sources":["../../../ts/utils/datastructures/PointSet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,OAAO,QAAQ;IAKnB,YAAY,EAAmB;QAFtB,kBAAa,GAAoB,EAAE,CAAC;QAG3C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACpC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,qBAA6B,CAAC,EAAE,mBAA2B,CAAC;QACzE,sEAAsE;QACtE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,eAAe;QACzC,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;YAC7B,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,uDAAuD;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACtC,qCAAqC;YACrC,qEAAqE;QACvE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,UAAkB,EAAE,qBAA6B,CAAC,EAAE,mBAA2B,CAAC;QAC3F,0BAA0B;QAC1B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,UAAkB;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB;QAC7D,oCAAoC;QACpC,IAAI,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;QAEI;IACJ,gBAAgB,CAAC,aAAqB,EAAE,qBAA6B,CAAC,EAAE,mBAA2B,CAAC;QAClG,IAAI,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QACzE,CAAC;QACD,4CAA4C;aACvC,IAAI,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5C,oBAAoB;YACpB,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;YACD,yCAAyC;YACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAClD,+BAA+B;YAC/B,sBAAsB;YACtB,eAAe;QACjB,CAAC;IACH,CAAC;CAQF"}

package/src/esm/utils/datastructures/VoronoiCell.d.ts

@@ -16,7 +16,8 @@
  * @modified 2020-08-12 Ported this class from vanilla JS to TypeScript.
  * @modified 2020-08-17 Added some missing type declarations.
  * @modified 2021-01-20 Members `triangles` and `sharedVertex` are now public.
- * @version  1.1.3
+ * @modified 2026-09-15 Added the `VoronoiCell.sharedVertexIndex` attribute.
+ * @version  1.2.0
  *
  * @file VoronoiCell
  * @public
@@ -39,6 +40,10 @@ export declare class VoronoiCell {
      * @instance
      */
     sharedVertex: Vertex;
+    /**
+     *
+     */
+    sharedVertexIndex: number;
     /**
      * The constructor.
      *
@@ -49,7 +54,7 @@ export declare class VoronoiCell {
      * @param {Vertex}     sharedVertex This is the 'center' of the voronoi cell; all triangles must share
      *                                  that vertex.
      **/
-    constructor(triangles: Array<Triangle>, sharedVertex: Vertex);
+    constructor(triangles: Array<Triangle>, sharedVertex: Vertex, sharedVertexIndex: number);
     /**
      * Check if the first and the last triangle in the path are NOT connected.
      *
@@ -71,6 +76,18 @@ export declare class VoronoiCell {
      * @return {Polygon}
      **/
     toPolygon(): Polygon;
+    /**
+     * Get all 'umbrella' triangles for this Voronoi cell.
+     *
+     * The 'umbrella' is that sequence of triangles that covers the whole Voronoi cell and
+     * meet in the cell's centroid.
+     *
+     * @method getUmbrellaTriangles
+     * @instance
+     * @memberof VoronoiCell
+     * @return {Array<Triangle>}
+     **/
+    getUmbrellaTriangles(): Array<Triangle>;
     /**
      * Convert the voronoi cell path data to an SVG polygon data string.
      *

package/src/esm/utils/datastructures/VoronoiCell.js

@@ -16,13 +16,15 @@
  * @modified 2020-08-12 Ported this class from vanilla JS to TypeScript.
  * @modified 2020-08-17 Added some missing type declarations.
  * @modified 2021-01-20 Members `triangles` and `sharedVertex` are now public.
- * @version  1.1.3
+ * @modified 2026-09-15 Added the `VoronoiCell.sharedVertexIndex` attribute.
+ * @version  1.2.0
  *
  * @file VoronoiCell
  * @public
  **/
 import { Line } from "../../Line";
 import { Polygon } from "../../Polygon";
+import { Triangle } from "../../Triangle";
 import { Vertex } from "../../Vertex";
 export class VoronoiCell {
     /**
@@ -35,15 +37,15 @@ export class VoronoiCell {
      * @param {Vertex}     sharedVertex This is the 'center' of the voronoi cell; all triangles must share
      *                                  that vertex.
      **/
-    constructor(triangles, sharedVertex) {
-        if (typeof triangles === 'undefined')
+    constructor(triangles, sharedVertex, sharedVertexIndex) {
+        if (typeof triangles === "undefined")
             triangles = [];
-        if (typeof sharedVertex === 'undefined')
+        if (typeof sharedVertex === "undefined")
             sharedVertex = new Vertex(0, 0);
         this.triangles = triangles;
         this.sharedVertex = sharedVertex;
+        this.sharedVertexIndex = sharedVertexIndex;
     }
-    ;
     /**
      * Check if the first and the last triangle in the path are NOT connected.
      *
@@ -56,7 +58,6 @@ export class VoronoiCell {
         // There must be at least three triangles
         return this.triangles.length < 3 || !this.triangles[0].isAdjacent(this.triangles[this.triangles.length - 1]);
     }
-    ;
     /**
      * Convert this Voronoi cell to a path polygon, consisting of all Voronoi cell corner points.
      *
@@ -71,7 +72,32 @@ export class VoronoiCell {
     toPolygon() {
         return new Polygon(this.toPathArray(), this.isOpen());
     }
-    ;
+    /**
+     * Get all 'umbrella' triangles for this Voronoi cell.
+     *
+     * The 'umbrella' is that sequence of triangles that covers the whole Voronoi cell and
+     * meet in the cell's centroid.
+     *
+     * @method getUmbrellaTriangles
+     * @instance
+     * @memberof VoronoiCell
+     * @return {Array<Triangle>}
+     **/
+    getUmbrellaTriangles() {
+        var tris = [];
+        // for (var i = 0; i < this.triangles.length; i++) {
+        //   var delaunayTri = this.triangles[i];
+        //   var tri = new Triangle(this.sharedVertex, delaunayTri.b, delaunayTri.c);
+        //   tris.push(tri);
+        // }
+        var vertices = this.toPathArray();
+        var n = vertices.length;
+        for (var i = 0; i < n; i++) {
+            var tri = new Triangle(this.sharedVertex, vertices[i], vertices[(i + 1) % n]);
+            tris.push(tri);
+        }
+        return tris;
+    }
     /**
      * Convert the voronoi cell path data to an SVG polygon data string.
      *
@@ -86,9 +112,12 @@ export class VoronoiCell {
         if (this.triangles.length == 0)
             return "";
         const arr = this.toPathArray();
-        return arr.map((vert) => { return '' + vert.x + ',' + vert.y; }).join(' ');
+        return arr
+            .map((vert) => {
+            return "" + vert.x + "," + vert.y;
+        })
+            .join(" ");
     }
-    ;
     /**
      * Convert the voronoi cell path data to an array.
      *
@@ -143,7 +172,6 @@ export class VoronoiCell {
         const openEdgePoint = new Vertex(perpendicular.x + (center.x - perpendicular.x) * 1000, perpendicular.y + (center.y - perpendicular.y) * 1000);
         return openEdgePoint;
     }
-    ;
     /**
      * A helper function.
      *
@@ -167,12 +195,11 @@ export class VoronoiCell {
                 return tri.a;
         }
         // Here:
-        //    tri.c.equals(sharedVertex) 
+        //    tri.c.equals(sharedVertex)
         if (neighbour.a.equals(tri.a) || neighbour.b.equals(tri.a) || neighbour.c.equals(tri.a))
             return tri.b;
         else
             return tri.a;
     }
-    ;
 }
 //# sourceMappingURL=VoronoiCell.js.map

package/src/esm/utils/datastructures/VoronoiCell.js.map

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

package/src/esm/utils/renderers/VoronoiRenderer.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Refactored all Voronoi helper functions for drawing the diagram (demo 07) into this class.
+ *
+ * @author   Ikaros Kappler
+ * @date     2026-09-13
+ * @modified 2026-09-15 Ported to Typescript.
+ * @version  1.0.1
+ */
+import { Polygon } from "../../Polygon";
+import { Triangle } from "../../Triangle";
+import { DrawLib } from "../../interfaces";
+import { PointSet } from "../datastructures/PointSet";
+import { VoronoiCell } from "../datastructures/VoronoiCell";
+export interface IVoronoiConfig {
+    makeVoronoiDiagram: boolean;
+    drawPoints: boolean;
+    drawTriangles: boolean;
+    drawCircumCircles: boolean;
+    drawCubicCurves: boolean;
+    fillVoronoiCells: boolean;
+    voronoiOutlineColor: string;
+    voronoiCellColor: string;
+    voronoiCubicThreshold: number;
+    voronoiCellScale: number;
+    clipVoronoiCells: boolean;
+    drawClipBox: boolean;
+    drawUnclippedVoronoiCells: boolean;
+    drawVoronoiIncircles: boolean;
+    drawVoronoiOutlines: boolean;
+    pointCount: number;
+    horizontalSafeArea: number;
+    verticalSafeArea: number;
+    voronoiCellLineWidth: number;
+}
+export interface IVoronoiContext {
+    pointSet: PointSet;
+    triangles: Array<Triangle>;
+    voronoiCells: Array<VoronoiCell>;
+    config: IVoronoiConfig;
+}
+export declare class VoronoiRenderer {
+    voronoiContext: IVoronoiContext;
+    constructor(voronoiContext: IVoronoiContext);
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @name draw
+     * @instance
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Triangle} t
+     * @param {string} color
+     * @return {void}
+     */
+    draw(draw: DrawLib<any>, fill: DrawLib<any>): void;
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @name _drawCell
+     * @instance
+     * @private
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Polygon} clipBoxPolygon
+     * @param {VoronoiCell} cell
+     * @return {void}
+     */
+    private _drawCell;
+    /**
+     * A function for drawing the triangles.
+     *
+     * @static
+     */
+    drawTriangles(draw: DrawLib<any>): void;
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @static
+     * @name drawTriangle
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Triangle} tri
+     * @param {string} color
+     * @return {void}
+     */
+    static drawTriangle(draw: DrawLib<any>, tri: Triangle, color: string): void;
+    /**
+     * Draw the circumcircles of all triangles.
+     */
+    static drawCircumCircles(draw: DrawLib<any>, triangles: Array<Triangle>): void;
+    /**
+     * Clip the convex (!) cell polygon by the convex (!) clipping polygon.
+     *
+     * @param cellPolygon
+     * @param clipBoxPolygon
+     * @returns
+     */
+    static clipVoronoiPolygon(cellPolygon: Polygon, clipBoxPolygon: Polygon): Polygon;
+}

package/src/esm/utils/renderers/VoronoiRenderer.js

@@ -0,0 +1,142 @@
+/**
+ * Refactored all Voronoi helper functions for drawing the diagram (demo 07) into this class.
+ *
+ * @author   Ikaros Kappler
+ * @date     2026-09-13
+ * @modified 2026-09-15 Ported to Typescript.
+ * @version  1.0.1
+ */
+import { Bounds } from "../../Bounds";
+import { Polygon } from "../../Polygon";
+import { convexPolygonIncircle } from "../algorithms/convexPolygonIncircle";
+import { sutherlandHodgman } from "../algorithms/sutherlandHodgman";
+import { cloneVertexArray } from "../cloneVertexArray";
+export class VoronoiRenderer {
+    constructor(voronoiContext) {
+        this.voronoiContext = voronoiContext;
+    }
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @name draw
+     * @instance
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Triangle} t
+     * @param {string} color
+     * @return {void}
+     */
+    draw(draw, fill) {
+        // Draw circumcircles
+        if (this.voronoiContext.config.drawCircumCircles) {
+            VoronoiRenderer.drawCircumCircles(draw, this.voronoiContext.triangles);
+        }
+        // An array of VoronoiCells.
+        var clipBoxPolygon = Bounds.computeFromVertices(this.voronoiContext.pointSet.points).toPolygon();
+        if (this.voronoiContext.config.drawClipBox) {
+            draw.polygon(clipBoxPolygon, "rgba(192,192,192,0.25)");
+        }
+        for (var v in this.voronoiContext.voronoiCells) {
+            var cell = this.voronoiContext.voronoiCells[v];
+            this._drawCell(draw, fill, clipBoxPolygon, cell);
+        }
+    }
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @name _drawCell
+     * @instance
+     * @private
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Polygon} clipBoxPolygon
+     * @param {VoronoiCell} cell
+     * @return {void}
+     */
+    _drawCell(draw, fill, clipBoxPolygon, cell) {
+        var _a, _b;
+        var cellPolygon = cell.toPolygon();
+        cellPolygon.scale(this.voronoiContext.config.voronoiCellScale, cell.sharedVertex);
+        // Draw large (unclipped) Voronoi cell
+        if (this.voronoiContext.config.drawVoronoiOutlines &&
+            (!this.voronoiContext.config.clipVoronoiCells || this.voronoiContext.config.drawUnclippedVoronoiCells)) {
+            draw.polyline(cellPolygon.vertices, false, this.voronoiContext.config.clipVoronoiCells ? "rgba(128,128,128,0.333)" : this.voronoiContext.config.voronoiOutlineColor, (_a = this.voronoiContext.config.voronoiCellLineWidth) !== null && _a !== void 0 ? _a : 2.0);
+        }
+        // Apply clipping?
+        if (this.voronoiContext.config.clipVoronoiCells) {
+            // Clone the array here: convert Array<XYCoords> to Array<Vertex>
+            // polygon = new Polygon(cloneVertexArray(sutherlandHodgman(polygon.vertices, clipBoxPolygon.vertices)), false);
+            cellPolygon = VoronoiRenderer.clipVoronoiPolygon(cellPolygon, clipBoxPolygon);
+        }
+        if (this.voronoiContext.config.drawVoronoiOutlines && this.voronoiContext.config.clipVoronoiCells) {
+            draw.polygon(cellPolygon, this.voronoiContext.config.voronoiOutlineColor, (_b = this.voronoiContext.config.voronoiCellLineWidth) !== null && _b !== void 0 ? _b : 2.0);
+        }
+        if ((!cell.isOpen() || this.voronoiContext.config.clipVoronoiCells) && cell.triangles.length >= 3) {
+            if (this.voronoiContext.config.drawCubicCurves) {
+                var cbezier = cellPolygon.toCubicBezierData(this.voronoiContext.config.voronoiCubicThreshold);
+                if (this.voronoiContext.config.fillVoronoiCells) {
+                    fill.cubicBezierPath(cbezier, this.voronoiContext.config.voronoiCellColor);
+                }
+                else {
+                    draw.cubicBezierPath(cbezier, this.voronoiContext.config.voronoiCellColor);
+                }
+            }
+            if (this.voronoiContext.config.drawVoronoiIncircles) {
+                var result = convexPolygonIncircle(cellPolygon);
+                var circle = result.circle;
+                // var triangle = result.triangle;
+                // Here we should have found the best inlying circle (and the corresponding triangle)
+                // inside the Voronoi cell.
+                draw.circle(circle.center, circle.radius, "rgba(255,192,0,1.0)", 2);
+            }
+        } // END cell is not open
+    }
+    /**
+     * A function for drawing the triangles.
+     *
+     * @static
+     */
+    drawTriangles(draw) {
+        for (var i in this.voronoiContext.triangles) {
+            var t = this.voronoiContext.triangles[i];
+            VoronoiRenderer.drawTriangle(draw, t, this.voronoiContext.config.makeVoronoiDiagram ? "rgba(0,128,224,0.33)" : "#0088d8");
+        }
+    }
+    /**
+     * Draw the given triangle with the specified (CSS-) color.
+     *
+     * @static
+     * @name drawTriangle
+     * @memberof VoronoiRenderer
+     * @param {DrawLib} draw
+     * @param {Triangle} tri
+     * @param {string} color
+     * @return {void}
+     */
+    static drawTriangle(draw, tri, color) {
+        // draw.line(t.a, t.b, color);
+        // draw.line(t.b, t.c, color);
+        // draw.line(t.c, t.a, color);
+        draw.polyline([tri.a, tri.b, tri.c], false, color);
+    }
+    /**
+     * Draw the circumcircles of all triangles.
+     */
+    static drawCircumCircles(draw, triangles) {
+        for (var t in triangles) {
+            var cc = triangles[t].getCircumcircle();
+            draw.circle(cc.center, cc.radius, "#e86800");
+        }
+    }
+    /**
+     * Clip the convex (!) cell polygon by the convex (!) clipping polygon.
+     *
+     * @param cellPolygon
+     * @param clipBoxPolygon
+     * @returns
+     */
+    static clipVoronoiPolygon(cellPolygon, clipBoxPolygon) {
+        return new Polygon(cloneVertexArray(sutherlandHodgman(cellPolygon.vertices, clipBoxPolygon.vertices)), false);
+    }
+}
+//# sourceMappingURL=VoronoiRenderer.js.map

package/src/esm/utils/renderers/VoronoiRenderer.js.map

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

package/src/index-gl.js

@@ -16,7 +16,6 @@
   // Fetch the GET params
   let GUP = gup();
   var isDarkmode = detectDarkMode(GUP);
-  var isDarkmode = detectDarkMode(GUP);
 
   window.addEventListener("load", function () {
     // All config params are optional.
@@ -91,7 +90,7 @@
     });
 
     // Use a helper function to build all demo-drawables.
-    var drawables = createDemoDrawables(pb.canvasSize, "example-image.png", function () {
+    var drawables = createDemoDrawables(pb, "example-image.png", function () {
       pb.redraw();
     });
     pb.add(drawables);

package/src/ts/Circle.ts

@@ -22,7 +22,8 @@
  * @modified 2026-07-08 Adding the `Circle.setRadius` method (for chaining).
  * @mofified 2026-07-31 Adding the `radicalAxis(Circle)` method. Added the `Circle.circleUtils.createRadicalAxisHelperCircle` and `.circleDistance` helper methods.
  * @modified 2026-08-03 Adding `Circle.tangentsFromPoint`.
- * @version  1.7.0
+ * @modified 2026-08-16 Adding the `Circle.sectorAngleByArcLength` method and the `Circle.circleUtils.sectorAngleByArcLength` helper method.
+ * @version  1.8.0
  **/
 
 import { Bounds } from "./Bounds";
@@ -474,6 +475,16 @@ export class Circle implements IBounded, ICircle, Intersectable, SVGSerializable
     return [new Vector(intersection.a, vert), new Vector(intersection.b, vert)];
   }
 
+  /**
+   * Calculate inner sector angle for this circle and a given circle arc length.
+   *
+   * @param {number} sectorArcLength - The desired arc length (in units).
+   * @returns The sector's inner angle (in radians).
+   */
+  sectorAngleByArcLength(sectorArcLength: number) {
+    return Circle.circleUtils.sectorAngleByArcLength(sectorArcLength, this.radius);
+  }
+
   /**
    * Create a deep copy of this circle.
    *
@@ -558,6 +569,17 @@ export class Circle implements IBounded, ICircle, Intersectable, SVGSerializable
      */
     circleDistance: (circleA: Circle, circleB: Circle): number => {
       return circleA.center.distance(circleB.center) - circleA.radius - circleB.radius;
+    },
+
+    /**
+     * Calculate the inner sector angle for a given circle arc length and radius.
+     *
+     * @param {number} sectorArcLength - The desired arc length.
+     * @param {number} circleRadius - The circle's radius.
+     * @returns The sector angle in radians.
+     */
+    sectorAngleByArcLength: (sectorArcLength: number, circleRadius: number) => {
+      return sectorArcLength / circleRadius;
     }
   };
 } // END class