plotboilerplate 1.24.0 → 1.26.0

package/src/esm/utils/parsers/LinearColorGradientParser.js

@@ -0,0 +1,217 @@
+/**
+ * A CSS gradient string parser.
+ *
+ * Source:
+ *  https://stackoverflow.com/questions/20215440/parse-css-gradient-rule-with-javascript-regex
+ * Thanks to Dean Taylor
+ *
+ * @date           2025-09-04
+ * @OriginalAuthor Dean Taylor
+ * @RefactoredBy   Ikaros Kappler, ported to Typescript.
+ * @version        1.0.0
+ */
+import { Color } from "../datastructures/Color";
+import { ColorGradient } from "../datastructures/ColorGradient";
+/**
+ * The default implementation of `PositionToRatioConverter`.
+ * @param positionString
+ * @returns
+ */
+export const DefaultPositionConverter = (positionString) => {
+    if (typeof positionString === "undefined") {
+        throw new Error("Cannot parse positioning string `null`.");
+    }
+    const tmp = positionString.trim();
+    if (tmp.length === 0) {
+        throw new Error('Cannot parse empty positioning string "".');
+    }
+    if (!tmp.endsWith("%")) {
+        throw new Error(`Cannot parse positioning string, must end with '%': '${tmp}'`);
+    }
+    return Number.parseFloat(tmp) / 100.0;
+};
+/**
+ * Utility combine multiple regular expressions.
+ *
+ * Source:
+ *  https://stackoverflow.com/questions/20215440/parse-css-gradient-rule-with-javascript-regex
+ * Thanks to Dean Taylor
+ *
+ * @param {Array<RegExp | string>} regexpList List of regular expressions or strings.
+ * @param {string} flags Normal RegExp flags.
+ */
+const __combineRegExp = (regexpList, flags) => {
+    var source = "";
+    for (var i = 0; i < regexpList.length; i++) {
+        const regex = regexpList[i];
+        if (typeof regex === "string") {
+            source += regex;
+        }
+        else {
+            source += regex.source;
+        }
+    }
+    return new RegExp(source, flags);
+};
+/**
+ * Generate the required regular expressions once.
+ *
+ * Regular Expressions are easier to manage this way and can be well described.
+ *
+ * @result {object} Object containing regular expressions.
+ */
+const __generateDefaultRegExpLib = () => {
+    // Note any variables with "Capture" in name include capturing bracket set(s).
+    const searchFlags = "gi", // ignore case for angles, "rgb" etc
+    rAngle = /(?:[+-]?\d*\.?\d+)(?:deg|grad|rad|turn)/, // Angle +ive, -ive and angle types
+    rSideCornerCapture = /to\s+((?:(?:left|right)(?:\s+(?:top|bottom))?))/, // optional 2nd part
+    rComma = /\s*,\s*/, // Allow space around comma.
+    rColorHex = /\#(?:[a-f0-9]{6}|[a-f0-9]{3})/, // 3 or 6 character form
+    rDigits3 = /\(\s*(?:\d{1,3}\s*,\s*){2}\d{1,3}\s*\)/, // "(1, 2, 3)"
+    rDigits4 = /\(\s*(?:\d{1,3}\s*,\s*){2}\d{1,3}\s*,\s*\d*\.?\d+\)/, // "(1, 2, 3, 4)"
+    rValue = /(?:[+-]?\d*\.?\d+)(?:%|[a-z]+)?/, // ".9", "-5px", "100%".
+    rKeyword = /[_a-z-][_a-z0-9-]*/, // "red", "transparent", "border-collapse".
+    rColor = __combineRegExp(["(?:", rColorHex, "|", "(?:rgb|hsl)", rDigits3, "|", "(?:rgba|hsla)", rDigits4, "|", rKeyword, ")"], ""), rColorStop = __combineRegExp([rColor, "(?:\\s+", rValue, "(?:\\s+", rValue, ")?)?"], ""), // Single Color Stop, optional %, optional length.
+    rColorStopList = __combineRegExp(["(?:", rColorStop, rComma, ")*", rColorStop], ""), // List of color stops min 1.
+    rLineCapture = __combineRegExp(["(?:(", rAngle, ")|", rSideCornerCapture, ")"], ""), // Angle or SideCorner
+    rGradientSearch = __combineRegExp(["(?:(", rLineCapture, ")", rComma, ")?(", rColorStopList, ")"], searchFlags), // Capture 1:"line", 2:"angle" (optional), 3:"side corner" (optional) and 4:"stop list".
+    rColorStopSearch = __combineRegExp(["\\s*(", rColor, ")", "(?:\\s+", "(", rValue, "))?", "(?:", rComma, "\\s*)?"], searchFlags); // Capture 1:"color" and 2:"position" (optional).
+    return {
+        gradientSearch: rGradientSearch,
+        colorStopSearch: rColorStopSearch
+    };
+};
+/**
+ * Actually parse the input gradient parameters string into an object for reusability.
+ *
+ *
+ * @note Really this only supports the standard syntax not historical versions, see MDN for details
+ *       https://developer.mozilla.org/en-US/docs/Web/CSS/linear-gradient
+ *
+ * @param {ColorGradientParserRegExpLib} regExpLib
+ * @param {string} input Input string in the form "to right bottom, #FF0 0%, red 20px, rgb(0, 0, 255) 100%"
+ * @returns {object|undefined} Object containing break down of input string including array of stop points.
+ */
+export var __parseGradient = (regExpLib, input) => {
+    var result;
+    var matchGradient, matchColorStop, stopResult;
+    // reset search position, because we reuse regex.
+    regExpLib.gradientSearch.lastIndex = 0;
+    matchGradient = regExpLib.gradientSearch.exec(input);
+    if (matchGradient !== null) {
+        result = {
+            original: matchGradient[0],
+            colorStopList: [],
+            line: null,
+            angle: null,
+            sideCorner: null
+        };
+        // Line (Angle or Side-Corner).
+        if (!!matchGradient[1]) {
+            result.line = matchGradient[1];
+        }
+        // Angle or undefined if side-corner.
+        if (!!matchGradient[2]) {
+            result.angle = matchGradient[2];
+        }
+        // Side-corner or undefined if angle.
+        if (!!matchGradient[3]) {
+            result.sideCorner = matchGradient[3];
+        }
+        // reset search position, because we reuse regex.
+        regExpLib.colorStopSearch.lastIndex = 0;
+        // Loop though all the color-stops.
+        matchColorStop = regExpLib.colorStopSearch.exec(matchGradient[4]);
+        while (matchColorStop !== null) {
+            stopResult = {
+                color: matchColorStop[1],
+                position: null
+            };
+            // Position (optional).
+            if (!!matchColorStop[2]) {
+                stopResult.position = matchColorStop[2];
+            }
+            result.colorStopList.push(stopResult);
+            // Continue searching from previous position.
+            matchColorStop = regExpLib.colorStopSearch.exec(matchGradient[4]);
+        }
+    }
+    // Can be undefined if match not found.
+    return result;
+};
+/**
+ * The actual parser class.
+ */
+export class LinearColorGradientParser {
+    constructor(regExpLib) {
+        this.regExpLib = regExpLib || __generateDefaultRegExpLib();
+    }
+    parse(input, positionConverter) {
+        const result = this.parseRaw(input);
+        return LinearColorGradientParser.parseResultToColorGradient(result, positionConverter);
+    }
+    parseRaw(input) {
+        var result;
+        const rGradientEnclosedInBrackets = /.*gradient\s*\(((?:\([^\)]*\)|[^\)\(]*)*)\)/; // Captures inside brackets - max one additional inner set.
+        const match = rGradientEnclosedInBrackets.exec(input);
+        const bracketPos = input.indexOf("(");
+        const gradientType = bracketPos === -1 ? null : input.substring(0, bracketPos).toLowerCase();
+        if (match !== null) {
+            // Get the parameters for the gradient
+            result = __parseGradient(this.regExpLib, match[1]);
+            result.gradientType = gradientType;
+            if (result.original.trim() !== match[1].trim()) {
+                // Did not match the input exactly - possible parsing error.
+                result.parseWarning = true;
+            }
+        }
+        else {
+            //   result = new Error("Failed to find gradient");
+            throw new Error("Failed to find gradient");
+        }
+        return result;
+    }
+    static parseResultToColorGradient(result, positionConverter) {
+        if (!result.gradientType || result.gradientType.toLowerCase() != "linear-gradient") {
+            throw new Error(`Cannot create linear gradient from type '${result.gradientType}'.`);
+        }
+        if (!result.colorStopList || result.colorStopList.length <= 1) {
+            throw new Error(`Cannot create linear gradient from color stop list of length '${result.colorStopList.length}'. Too few elements.`);
+        }
+        const colorStops = [];
+        const converter = positionConverter !== null && positionConverter !== void 0 ? positionConverter : DefaultPositionConverter;
+        for (var i = 0; i < result.colorStopList.length; i++) {
+            const stopListItem = result.colorStopList[i];
+            console.log(stopListItem);
+            const color = Color.parse(stopListItem.color);
+            // var position: number = LinearColorGradientParser.parsePosition(stopListItem.position);
+            var ratio;
+            if (typeof stopListItem.position === "undefined") {
+                // Try to auto-fill undefined positions by their index in the list.
+                ratio = i / (result.colorStopList.length - 1);
+            }
+            else {
+                ratio = converter(stopListItem.position);
+            }
+            colorStops.push({ color: color, ratio: ratio });
+        }
+        return new ColorGradient(colorStops, result.line);
+    }
+} // END class
+// var test_this_one = function (regExpLib, input) {
+//   var result,
+//     rGradientEnclosedInBrackets = /.*gradient\s*\(((?:\([^\)]*\)|[^\)\(]*)*)\)/, // Captures inside brackets - max one additional inner set.
+//     match = rGradientEnclosedInBrackets.exec(input);
+//   if (match !== null) {
+//     // Get the parameters for the gradient
+//     result = parseGradient(regExpLib, match[1]);
+//     if (result.original.trim() !== match[1].trim()) {
+//       // Did not match the input exactly - possible parsing error.
+//       result.parseWarning = true;
+//     }
+//   } else {
+//     result = "Failed to find gradient";
+//   }
+//   return result;
+// };
+//# sourceMappingURL=LinearColorGradientParser.js.map

package/src/esm/utils/parsers/LinearColorGradientParser.js.map

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

package/src/esm/utils/parsers/svg/types.d.ts

@@ -14,7 +14,7 @@
  */
 export type NumericString = `${number}`;
 export type BooleanString = "0" | "1" | `${boolean}`;
-export type SVGPathMoveToCommand = ["M" | "m", NumericString, NumericString];
+export type SVGPathMoveToCommand = ["M" | "m", NumericString | number, NumericString | number];
 export type SVGPathLineToCommand = ["L" | "l", NumericString, NumericString, ...Array<NumericString>];
 export type SVGPathVerticalLineToCommand = ["V" | "v", NumericString];
 export type SVGPathHorizontalLineToCommand = ["H" | "h", NumericString];
@@ -31,13 +31,13 @@ export type SVGPathQuadraticCurveToCommand = ["Q" | "q", NumericString, NumericS
 ];
 export type SVGPathCubicCurveToCommand = [
     "C" | "c",
-    NumericString,
-    NumericString,
-    NumericString,
-    NumericString,
-    NumericString,
-    NumericString,
-    ...Array<NumericString>
+    NumericString | number,
+    NumericString | number,
+    NumericString | number,
+    NumericString | number,
+    NumericString | number,
+    NumericString | number,
+    ...Array<NumericString | number>
 ];
 export type SVGPathShorthandCubicCurveToCommand = [
     "S" | "s",

package/src/external.d.ts

@@ -0,0 +1,9 @@
+import { JsxElement } from "typescript";
+
+// external.d.ts
+declare module JSX {
+  type Element = JsxElement;
+  interface IntrinsicElements {
+    [elemName: string]: any;
+  }
+}

package/src/ts/Bounds.ts

@@ -13,7 +13,11 @@
  * @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
+ * @modified 2025-10-17 Added the methods `Bounds.getSouthWestPoint`, `getNorthWestPoint`, `getNorthEastPoint` and `getSouthEastPoint`.
+ * @modified 2025-10-18 Added method `Bounds.containsVert(XYCoords)`.
+ * @modified 2025-10-28 Added the `Bounds.getWidth()` and `Bounds.getHeight()`.
+ * @modified 2025-11-12 Added the `Bounds.getMoved()` method.
+ * @version  1.11.0
  **/
 
 import { Polygon } from "./Polygon";
@@ -75,54 +79,135 @@ export class Bounds implements IBounds, XYDimension {
     this.height = max.y - min.y;
   }
 
+  /**
+   * Check if the given vertex is inside this bounds.
+   *
+   * @method containsVert
+   * @param {XYCoords} vert - The vertex to check.
+   * @return {boolean} True if the passed vertex is inside this bounds.
+   * @instance
+   * @memberof Bounds
+   **/
+  containsVert(vert: XYCoords): boolean {
+    return this.min.x <= vert.x && vert.x < this.max.x && this.min.y <= vert.y && vert.y < this.max.y;
+  }
+
+  getWidth(): number {
+    return this.max.x - this.min.x;
+  }
+
+  getHeight(): number {
+    return this.max.y - this.min.y;
+  }
+
+  getScaled(scaleFactor: number): Bounds {
+    const center = this.getCenter();
+    const newMin = new Vertex(this.min).scale(scaleFactor, center);
+    const newMax = new Vertex(this.max).scale(scaleFactor, center);
+    return new Bounds(newMin, newMax);
+  }
+
+  getMoved(moveAmount: XYCoords): Bounds {
+    const newMin = new Vertex(this.min).move(moveAmount);
+    const newMax = new Vertex(this.max).move(moveAmount);
+    return new Bounds(newMin, newMax);
+  }
+
   /**
    * 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 );
-  };
+  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 );
-  };
+  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 );
-  };
+  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 );
-  };
+  getEastPoint(): Vertex {
+    return new Vertex(this.max.x, this.min.y + this.height / 2.0);
+  }
 
+  /**
+   * Get the upper left corner point these bounds box.
+   *
+   * @method getNorthWestPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "northwestmost" point of this bounding box.
+   */
+  getNorthWestPoint(): Vertex {
+    return new Vertex(this.min.x, this.min.y);
+  }
+
+  /**
+   * Get the upper right corner point these bounds box.
+   *
+   * @method getNorthEastPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "northeastmost" point of this bounding box.
+   */
+  getNorthEastPoint(): Vertex {
+    return new Vertex(this.max.x, this.min.y);
+  }
+
+  /**
+   * Get the lower right corner point these bounds box.
+   *
+   * @method getSouthEastPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "southeastmost" point of this bounding box.
+   */
+  getSouthEastPoint(): Vertex {
+    return new Vertex(this.max.x, this.max.y);
+  }
+
+  /**
+   * Get the lower left corner point these bounds box.
+   *
+   * @method getSouthWestPoint
+   * @instance
+   * @memberof Bounds
+   * @return {Vertex} The "southwestmost" point of this bounding box.
+   */
+  getSouthWestPoint(): Vertex {
+    return new Vertex(this.min.x, this.max.y);
+  }
 
   /**
    * Convert this rectangular bounding box to a polygon with four vertices.
@@ -230,7 +315,7 @@ export class Bounds implements IBounds, XYDimension {
    * @return The minimal Bounds for the given vertices.
    **/
   static computeFromVertices(vertices: Array<XYCoords>): Bounds {
-    if (vertices.length == 0) { 
+    if (vertices.length == 0) {
       return new Bounds(new Vertex(0, 0), new Vertex(0, 0));
     }
 
@@ -250,7 +335,7 @@ 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).
@@ -261,7 +346,7 @@ export class Bounds implements IBounds, XYDimension {
    * @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 {
+  static computeFromBoundsSet(boundingBoxes: Array<IBounds>): Bounds {
     if (boundingBoxes.length == 0) {
       return new Bounds(new Vertex(0, 0), new Vertex(0, 0));
     }

package/src/ts/CircleSector.ts

@@ -109,16 +109,16 @@ export class CircleSector implements IBounded, Intersectable, SVGSerializable {
    **/
   getBounds(): Bounds {
     const _self = this;
-    const circleBounds : Bounds = this.circle.getBounds();
+    const circleBounds: Bounds = this.circle.getBounds();
     // Calculage angles from east, west, north and south box points and check if they are inside
-    const candidates : Array<Vertex> = [
+    const candidates: Array<Vertex> = [
       circleBounds.getNorthPoint(),
       circleBounds.getSouthPoint(),
       circleBounds.getWestPoint(),
       circleBounds.getEastPoint()
-    ].filter( (point : Vertex) => {
+    ].filter((point: Vertex) => {
       // Check for each candidate points if they are contained in this sector. Drop if not.
-      const angle : number = new Line(_self.circle.center, point).angle();
+      const angle: number = new Line(_self.circle.center, point).angle();
       return _self.containsAngle(angle);
     });
     // Compute bounds and inlcude start end end point (they are definitely part of the bounds)
@@ -126,7 +126,6 @@ export class CircleSector implements IBounded, Intersectable, SVGSerializable {
   }
   //--- BEGIN --- Implement interface `IBounded`
 
-
   /**
    * Move the circle sector by the given amount.
    *
@@ -316,6 +315,38 @@ export class CircleSector implements IBounded, Intersectable, SVGSerializable {
   }
   //--- END --- Implement interface `Intersectable`
 
+  describeSVGPath(options?: { moveToStart: boolean }): SVGPathParams {
+    // const buffer: SVGPathParams = [];
+    // const start = this.getStartPoint();
+    // const end = this.getEndPoint();
+    // //   describeSVGArc
+    // //   x: number,
+    // //   y: number,
+    // //   radius: number,
+    // //   startAngle: number,
+    // //   endAngle: number,
+    // //   options?: { moveToStart: boolean }
+    // // ): SVGPathParams => {
+    // var arcRotation = 0.0;
+    // var largeArcFlag = 1;
+    // var sweepFlag = 0;
+    // if (options && options.moveToStart) {
+    //   buffer.push("M", start.x, start.y);
+    // }
+    // buffer.push("A", cSector.circle.radius, cSector.circle.radius, arcRotation, largeArcFlag, sweepFlag, end.x, end.y);
+    // return buffer;
+
+    const arc = CircleSector.circleSectorUtils.describeSVGArc(
+      this.circle.center.x, // end.x,
+      this.circle.center.y, // end.y,
+      this.circle.radius,
+      this.startAngle,
+      this.endAngle,
+      options // options?: { moveToStart: boolean }
+    );
+    return arc;
+  }
+
   /**
    * This function should invalidate any installed listeners and invalidate this object.
    * After calling this function the object might not hold valid data any more and
@@ -363,7 +394,9 @@ export class CircleSector implements IBounded, Intersectable, SVGSerializable {
       endAngle: number,
       options?: { moveToStart: boolean }
     ): SVGPathParams => {
-      if (typeof options === "undefined") options = { moveToStart: true };
+      if (typeof options === "undefined") {
+        options = { moveToStart: true };
+      }
 
       const end: XYCoords = CircleSector.circleSectorUtils.polarToCartesian(x, y, radius, endAngle);
       const start: XYCoords = CircleSector.circleSectorUtils.polarToCartesian(x, y, radius, startAngle);