plotboilerplate 1.19.0 → 1.20.0

package/src/ts/utils/parsers/svg/parseSVGPathData.ts

@@ -0,0 +1,572 @@
+/**
+ * Parse SVG path data strings and convert to PlotBoilerplate path objects.
+ *
+ * As this parser function does not detect all possible path data strings it should cover the most daily use-cases.
+ *
+ * For more insight see
+ *    https://www.w3.org/TR/SVG/paths.html
+ *
+ * @author  Ikaros Kappler
+ * @date    2022-11-06
+ * @modified 2022-12-21 (winter solstice) Porting this to Typescript.
+ * @version 0.0.1-alpha
+ **/
+
+import { CubicBezierCurve } from "../../../CubicBezierCurve";
+import { XYCoords } from "../../../interfaces/core";
+import { Line } from "../../../Line";
+import { VEllipseSector } from "../../../VEllipseSector";
+import { Vertex } from "../../../Vertex";
+import { splitSVGPathData } from "./splitSVGPathData";
+import {
+  SVGPathArcToCommand,
+  SVGPathCloseCommand,
+  SVGPathCommand,
+  SVGPathCubicCurveToCommand,
+  SVGPathHorizontalLineToCommand,
+  SVGPathLineToCommand,
+  SVGPathMoveToCommand,
+  SVGPathQuadraticCurveToCommand,
+  SVGPathShorthandCubicCurveToCommand,
+  SVGPathShorthandQuadraticCurveToCommand,
+  SVGPathVerticalLineToCommand
+} from "./types";
+
+const DEG_TO_RAD = Math.PI / 180;
+
+/**
+ * Transform the given path data (translate and scale. rotating is not intended here).
+ *
+ * @date 2022-11-06
+ *
+ * @name parseSVGPathData
+ * @static
+ * @param {string} data - The data to parse.
+ * @return An array of straight line segments (Line) or curve segments (CubicBezierCurve) representing the path.
+ */
+export const parseSVGPathData = (dataString: string): Array<Line | CubicBezierCurve> | null => {
+  const dataElements: Array<SVGPathCommand> | null = splitSVGPathData(dataString);
+
+  if (!dataElements) {
+    return null;
+  }
+
+  // Array<PathSegments>
+  const result: Array<Line | CubicBezierCurve> = [];
+
+  var i = 0;
+  const firstPoint = { x: NaN, y: NaN };
+  const lastPoint = { x: NaN, y: NaN };
+  const lastControlPoint = { x: NaN, y: NaN };
+
+  while (i < dataElements.length) {
+    // Could this also be SVGPathShorthandQuadraticCurveToCommand?
+    const data: SVGPathCommand = dataElements[i];
+    const cmd = data[0];
+    // console.log("cmd", cmd, "data", data);
+    switch (data[0]) {
+      case "M":
+        // MoveTo: M|m x y
+        _handleMove(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "m":
+        // MoveTo: M|m x y
+        _handleMove(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "L":
+        // LineTo L|l x y
+        _handleLineTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "l":
+        // LineTo L|l x y
+        _handleLineTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "H":
+        // HorizontalLineTo: H|h x
+        _handleHorizontalLineTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "h":
+        // HorizontalLineTo: H|h x
+        _handleHorizontalLineTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "V":
+        // VerticalLineTo: V|v y
+        _handleVerticalLineTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "v":
+        // VerticalLineTo: V|v y
+        _handleVerticalLineTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "C":
+        // CurveTo: C|c x1 y1 x2 y2 x y
+        _handleCubicBezierTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "c":
+        // CurveTo: C|c x1 y1 x2 y2 x y
+        _handleCubicBezierTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "S":
+        _handleShorthandCubicCurveTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "s":
+        _handleShorthandCubicCurveTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "Q":
+        // QuadraticCurveTo: Q|q x1 y1 x y
+        _handleQuadraticCurveTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "q":
+        // QuadraticCurveTo: Q|q x1 y1 x y
+        _handleQuadraticCurveTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "A":
+        // EllipticalArcTo: A|a rx ry x-axis-rotation large-arc-flag sweep-flag x y
+        _handleArcTo(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "a":
+        // EllipticalArcTo: A|a rx ry x-axis-rotation large-arc-flag sweep-flag x y
+        _handleArcTo(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "z":
+        _handleClosePath(data, false, firstPoint, lastPoint, lastControlPoint, result);
+        break;
+      case "Z":
+        // ClosePath: Z|z (no arguments)
+        _handleClosePath(data, true, firstPoint, lastPoint, lastControlPoint, result);
+        // i++;
+        break;
+      default:
+        if ((cmd as string) === "T") {
+          throw "T command only allowed after q command.";
+        }
+        if ((cmd as string) === "t") {
+          throw "t command only allowed after q command.";
+        }
+        throw "Unknown SVG path command found: " + cmd + ".";
+    }
+    // Safepoint: continue reading token by token until something is recognized again
+    i++;
+  } // END while
+
+  return result;
+}; // END parseSVGPathData
+
+// Just update the current position
+const _handleMove = (
+  data: SVGPathMoveToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  _result: Array<Line | CubicBezierCurve>
+) => {
+  if (data.length < 3) {
+    throw "Unsufficient params for MOVE";
+  }
+  // result.push( new)
+  if (isRelative && !isNaN(lastPoint.x) && !isNaN(lastPoint.y)) {
+    lastPoint.x += Number(data[1]);
+    lastPoint.y += Number(data[2]);
+    lastControlPoint.x = lastPoint.x;
+    lastControlPoint.y = lastPoint.y;
+  } else {
+    lastPoint.x = Number(data[1]);
+    lastPoint.y = Number(data[2]);
+    lastControlPoint.x = lastPoint.x;
+    lastControlPoint.y = lastPoint.y;
+  }
+  // console.log("AFTER MOVE", lastPoint);
+  if (isNaN(firstPoint.y)) {
+    firstPoint.x = lastPoint.x;
+    firstPoint.y = lastPoint.y;
+  }
+};
+
+// Draw a line segment from the current position
+const _handleLineTo = (
+  data: SVGPathLineToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle LINETO", data);
+  if (data.length < 3) {
+    throw "Unsufficient params for LINETO";
+  }
+  // console.log("Y: ", Number(data[2]), "lastPoint", lastPoint);
+  // result.push( new)
+  const line = new Line(new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    line.b.x += Number(data[1]);
+    line.b.y += Number(data[2]);
+  } else {
+    line.b.x = Number(data[1]);
+    line.b.y = Number(data[2]);
+  }
+  result.push(line);
+  lastPoint.x = line.b.x;
+  lastPoint.y = line.b.y;
+  lastControlPoint.x = line.b.x;
+  lastControlPoint.y = line.b.y;
+  if (isNaN(firstPoint.y)) {
+    firstPoint.x = line.a.x;
+    firstPoint.y = line.a.y;
+  }
+};
+
+const _handleHorizontalLineTo = (
+  data: SVGPathHorizontalLineToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle HORIZONTALLINETO", data);
+  if (data.length < 2) {
+    throw "Unsufficient params for HORIZONTALLINETO";
+  }
+  // console.log("Y: ", Number(data[2]), "lastPoint", lastPoint);
+  // result.push( new)
+  const line = new Line(new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    line.b.x += Number(data[1]);
+    // line.b.y += Number(data[2]);
+  } else {
+    line.b.x = Number(data[1]);
+    // line.b.y = Number(data[2]);
+  }
+  result.push(line);
+  lastPoint.x = line.b.x;
+  // lastPoint.y = line.b.y;
+  lastControlPoint.x = line.b.x;
+  if (isNaN(firstPoint.y)) {
+    firstPoint.x = line.a.x;
+    firstPoint.y = line.a.y;
+  }
+};
+
+const _handleVerticalLineTo = (
+  data: SVGPathVerticalLineToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle VERTICALLINETO", data);
+  if (data.length < 2) {
+    throw "Unsufficient params for VERTICALLINETO";
+  }
+  // console.log("Y: ", Number(data[2]), "lastPoint", lastPoint);
+  // result.push( new)
+  const line = new Line(new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    // line.b.x += Number(data[1]);
+    line.b.y += Number(data[1]);
+  } else {
+    // line.b.x = Number(data[1]);
+    line.b.y = Number(data[1]);
+  }
+  result.push(line);
+  // lastPoint.x = line.b.x;
+  lastPoint.y = line.b.y;
+  lastControlPoint.y = line.b.y;
+  if (isNaN(firstPoint.y)) {
+    firstPoint.x = line.a.x;
+    firstPoint.y = line.a.y;
+  }
+};
+
+// CurveTo: C|c x1 y1 x2 y2 x y
+const _handleCubicBezierTo = (
+  data: SVGPathCubicCurveToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle CUBICBEZIERTO", data);
+  if (data.length < 7) {
+    throw "Unsufficient params for CUBICBEZIERTO";
+  }
+  // console.log("Y: ", Number(data[2]), "lastPoint", lastPoint);
+  // result.push( new)
+  const curve = new CubicBezierCurve(new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    curve.startControlPoint.x += Number(data[1]);
+    curve.startControlPoint.y += Number(data[2]);
+    curve.endControlPoint.x += Number(data[3]);
+    curve.endControlPoint.y += Number(data[4]);
+    curve.endPoint.x += Number(data[5]);
+    curve.endPoint.y += Number(data[6]);
+  } else {
+    curve.startControlPoint.x = Number(data[1]);
+    curve.startControlPoint.y = Number(data[2]);
+    curve.endControlPoint.x = Number(data[3]);
+    curve.endControlPoint.y = Number(data[4]);
+    curve.endPoint.x = Number(data[5]);
+    curve.endPoint.y = Number(data[6]);
+  }
+  result.push(curve);
+  lastPoint.x = curve.endPoint.x;
+  lastPoint.y = curve.endPoint.y;
+  lastControlPoint.x = curve.endControlPoint.x;
+  lastControlPoint.y = curve.endControlPoint.y;
+  if (isNaN(firstPoint.x)) {
+    firstPoint.x = curve.startPoint.x;
+    firstPoint.y = curve.startPoint.y;
+  }
+};
+
+// QuadraticCurveTo: Q|q x1 y1 x y
+const _handleQuadraticCurveTo = (
+  data: SVGPathQuadraticCurveToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle QUADRATICBEZIERTO", data);
+  if (data.length < 5) {
+    throw "Unsufficient params for QUADRATICBEZIERTO";
+  }
+  // console.log("Y: ", Number(data[2]), "lastPoint", lastPoint);
+  // result.push( new)
+  const curve = new CubicBezierCurve(new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    curve.startControlPoint.x += curve.startPoint.x + (Number(data[1]) - curve.startControlPoint.x); // * 0.666;
+    curve.startControlPoint.y += curve.startPoint.y + (Number(data[2]) - curve.startControlPoint.y); // * 0.666;
+    curve.endPoint.x += Number(data[3]);
+    curve.endPoint.y += Number(data[4]);
+    curve.endControlPoint.x = curve.startControlPoint.x;
+    curve.endControlPoint.y = curve.startControlPoint.y;
+  } else {
+    curve.startControlPoint.x = curve.startPoint.x + (Number(data[1]) - curve.startControlPoint.x); // * 0.666;
+    curve.startControlPoint.y = curve.startPoint.y + (Number(data[2]) - curve.startControlPoint.y); // * 0.666;
+    curve.endPoint.x = Number(data[3]);
+    curve.endPoint.y = Number(data[4]);
+    curve.endControlPoint.x = curve.startControlPoint.x;
+    curve.endControlPoint.y = curve.startControlPoint.y;
+  }
+  // var lastQuadraticControlPoint = { x: Number(data[1]), y: Number(data[2]) };
+  const lastQuadraticControlPoint = { x: curve.endControlPoint.x, y: curve.endControlPoint.y };
+  // Convert quadratic curve to cubic curve
+  curve.startControlPoint.x = curve.startPoint.x + (curve.startControlPoint.x - curve.startPoint.x) * 0.666;
+  curve.startControlPoint.y = curve.startPoint.y + (curve.startControlPoint.y - curve.startPoint.y) * 0.666;
+  curve.endControlPoint.x = curve.endPoint.x + (curve.endControlPoint.x - curve.endPoint.x) * 0.666;
+  curve.endControlPoint.y = curve.endPoint.y + (curve.endControlPoint.y - curve.endPoint.y) * 0.666;
+
+  result.push(curve);
+  lastPoint.x = curve.endPoint.x;
+  lastPoint.y = curve.endPoint.y;
+  lastControlPoint.x = curve.endControlPoint.x;
+  lastControlPoint.y = curve.endControlPoint.y;
+  if (isNaN(firstPoint.x)) {
+    firstPoint.x = curve.startPoint.x;
+    firstPoint.y = curve.startPoint.y;
+  }
+
+  // 'T' or 't' command may follow
+  if (data.length >= 8) {
+    // TODO: think about this type cast!
+    const subData: SVGPathShorthandQuadraticCurveToCommand = data.slice(5) as SVGPathShorthandQuadraticCurveToCommand;
+    // var lastQuadraticControlPoint = { x: Number(data[1]), y: Number(data[2]) };
+    if (subData[0] === "T") {
+      // _handleShorthandQuadraticCurveTo(subData, false, firstPoint, lastPoint, lastControlPoint, result);
+      _handleShorthandQuadraticCurveTo(subData, false, firstPoint, lastPoint, lastQuadraticControlPoint, result);
+    } else if (subData[0] === "t") {
+      // _handleShorthandQuadraticCurveTo(subData, true, firstPoint, lastPoint, lastControlPoint, result);
+      _handleShorthandQuadraticCurveTo(subData, true, firstPoint, lastPoint, lastQuadraticControlPoint, result);
+    }
+  }
+};
+
+// This is a helper function and works only in combination with Quadratic Bézier Curves
+// T|t x y
+const _handleShorthandQuadraticCurveTo = (
+  data: SVGPathShorthandQuadraticCurveToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle SHORTHANDQUADRATICCURVETO", data);
+  if (data.length < 3) {
+    throw "Unsufficient params for SHORTHANDQUADRATICCURVETO";
+  }
+  const curve = new CubicBezierCurve(new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint));
+  if (isRelative) {
+    curve.endPoint.x += Number(data[1]);
+    curve.endPoint.y += Number(data[2]);
+    curve.startControlPoint.x += curve.startPoint.x - (lastControlPoint.x - lastPoint.x);
+    curve.startControlPoint.y += curve.startPoint.y - (lastControlPoint.y - lastPoint.y);
+  } else {
+    curve.endPoint.x = Number(data[1]);
+    curve.endPoint.y = Number(data[2]);
+    curve.startControlPoint.x = curve.startPoint.x - (lastControlPoint.x - lastPoint.x);
+    curve.startControlPoint.y = curve.startPoint.y - (lastControlPoint.y - lastPoint.y);
+  }
+  // First handle as symmetrical cubic curve
+  curve.endControlPoint.x = curve.startControlPoint.x;
+  curve.endControlPoint.y = curve.startControlPoint.y;
+
+  // Convert quadratic curve to cubic curve
+  curve.startControlPoint.x = curve.startPoint.x + (curve.startControlPoint.x - curve.startPoint.x) * 0.666;
+  curve.startControlPoint.y = curve.startPoint.y + (curve.startControlPoint.y - curve.startPoint.y) * 0.666;
+  curve.endControlPoint.x = curve.endPoint.x + (curve.endControlPoint.x - curve.endPoint.x) * 0.666;
+  curve.endControlPoint.y = curve.endPoint.y + (curve.endControlPoint.y - curve.endPoint.y) * 0.666;
+
+  //   console.log("ADDING T CURVE", curve);
+  result.push(curve);
+  lastPoint.x = curve.endPoint.x;
+  lastPoint.y = curve.endPoint.y;
+  lastControlPoint.x = curve.endControlPoint.x;
+  lastControlPoint.y = curve.endControlPoint.y;
+  if (isNaN(firstPoint.x)) {
+    firstPoint.x = curve.startPoint.x;
+    firstPoint.y = curve.startPoint.y;
+  }
+};
+
+// The S|s x2 y2 x y
+const _handleShorthandCubicCurveTo = (
+  data: SVGPathShorthandCubicCurveToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle SHORTHANDCUBICBEZIERTO", data);
+  if (data.length < 5) {
+    throw "Unsufficient params for SHORTHANDCUBICBEZIERTO";
+  }
+  const curve = new CubicBezierCurve(new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint), new Vertex(lastPoint));
+
+  if (isRelative) {
+    curve.startControlPoint.x = lastPoint.x - (lastControlPoint.x - lastPoint.x);
+    curve.startControlPoint.y = lastPoint.y - (lastControlPoint.y - lastPoint.y);
+    curve.endControlPoint.x += Number(data[1]);
+    curve.endControlPoint.y += Number(data[2]);
+    curve.endPoint.x += Number(data[3]);
+    curve.endPoint.y += Number(data[4]);
+  } else {
+    curve.startControlPoint.x = lastPoint.x - (lastControlPoint.x - lastPoint.x);
+    curve.startControlPoint.y = lastPoint.y - (lastControlPoint.y - lastPoint.y);
+    curve.endControlPoint.x = Number(data[1]);
+    curve.endControlPoint.y = Number(data[2]);
+    curve.endPoint.x = Number(data[3]);
+    curve.endPoint.y = Number(data[4]);
+  }
+
+  result.push(curve);
+
+  lastPoint.x = curve.endPoint.x;
+  lastPoint.y = curve.endPoint.y;
+  lastControlPoint.x = curve.endControlPoint.x;
+  lastControlPoint.y = curve.endControlPoint.y;
+  if (isNaN(firstPoint.x)) {
+    firstPoint.x = curve.startPoint.x;
+    firstPoint.y = curve.startPoint.y;
+  }
+};
+
+// EllipticalArcTo: A|a rx ry x-axis-rotation large-arc-flag sweep-flag x y
+const _handleArcTo = (
+  data: SVGPathArcToCommand,
+  isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle ARCTO", data);
+  if (data.length < 8) {
+    throw "Unsufficient params for ARCTO";
+  }
+
+  const arcEndPoint = { x: Number(data[6]), y: Number(data[7]) };
+  if (isRelative) {
+    arcEndPoint.x += lastPoint.x;
+    arcEndPoint.y += lastPoint.y;
+  }
+
+  // console.log(
+  //   "lastPoint.x",
+  //   lastPoint.x, // x1
+  //   "lastPoint.y",
+  //   lastPoint.y, // y1
+  //   "data[1]",
+  //   Number(data[1]), // rx
+  //   "data[2]",
+  //   Number(data[2]), // ry
+  //   "data[3]",
+  //   Number(data[3]), // phi: number,
+  //   "data[4]",
+  //   Boolean(data[4]), // fa: boolean,
+  //   "data[5]",
+  //   Boolean(data[5]), // fs: boolean,
+  //   "data[6]",
+  //   arcEndPoint.x, // Number(data[6]), // x2: number,
+  //   "data[7]",
+  //   arcEndPoint.y // Number(data[7]) // y2: number
+  // );
+  // A 5 4 0 1 1 -10 -5
+  // TODO: respect relative/absolute here
+  const ellipseSector = VEllipseSector.ellipseSectorUtils.endpointToCenterParameters(
+    lastPoint.x,
+    lastPoint.y,
+    Number(data[1]),
+    Number(data[2]),
+    Number(data[3]) * DEG_TO_RAD,
+    Boolean(data[4]),
+    Boolean(data[5]),
+    arcEndPoint.x,
+    arcEndPoint.y // Number(data[7]) // y2: number
+  );
+
+  //   console.log("ellipseSector", ellipseSector);
+  const curves = ellipseSector.toCubicBezier(4); // 4 segments already seems to be a good approximation
+  for (var i = 0; i < curves.length; i++) {
+    result.push(curves[i]); // Destruct!
+  }
+  // result.push(ellipseSector.ellipse);
+  if (curves.length > 0) {
+    // console.log("curves", curves);
+    const lastCurve = curves[curves.length - 1];
+    lastPoint.x = lastCurve.endPoint.x;
+    lastPoint.y = lastCurve.endPoint.y;
+    lastControlPoint.x = lastCurve.endControlPoint.x;
+    lastControlPoint.y = lastCurve.endControlPoint.y;
+    if (isNaN(firstPoint.x)) {
+      firstPoint.x = curves[0].startPoint.x;
+      firstPoint.y = curves[0].startPoint.y;
+    }
+  }
+
+  // TODO: track first/last/control point
+};
+
+const _handleClosePath = (
+  _data: SVGPathCloseCommand,
+  _isRelative: boolean,
+  firstPoint: XYCoords,
+  lastPoint: XYCoords,
+  lastControlPoint: XYCoords,
+  result: Array<Line | CubicBezierCurve>
+) => {
+  //   console.log("Handle CLOSEPATH", "lastPoint", lastPoint, "firstPoint", firstPoint);
+  const line = new Line(new Vertex(lastPoint), new Vertex(firstPoint));
+  result.push(line);
+
+  lastPoint.x = line.b.x;
+  lastPoint.y = line.b.y;
+  lastControlPoint.x = line.b.x;
+  lastControlPoint.y = line.b.y;
+};

package/src/ts/utils/parsers/svg/splitSVGPathData.ts

@@ -0,0 +1,50 @@
+/**
+ * Split SVG path data `d` strings.
+ *
+ * As this helper function does not detect all possible path data strings it should cover the most daily use-cases.
+ *
+ * For more insight see
+ *    https://www.w3.org/TR/SVG/paths.html
+ *
+ * @author   Ikaros Kappler
+ * @date     2022-11-22
+ * @modified 2022-12-21 Ported to Typescript
+ * @version  0.0.1-alpha
+ */
+
+import { SVGPathCommand } from "./types";
+
+/**
+ * @name splitSVGPathData
+ * @static
+ * @param {string} dataString - The SVG path data to split. This should be some string
+ **/
+export const splitSVGPathData = (dataString: string): Array<SVGPathCommand> | null => {
+  // Source
+  //    https://javascript.plainenglish.io/june-3-parsing-and-validating-svg-paths-with-regex-7bd0e245115
+  const validCommand =
+    /([ml](\s?-?((\d+(\.\d+)?)|(\.\d+)))[,\s]?(-?((\d+(\.\d+)?)|(\.\d+))))|([hv](\s?-?((\d+(\.\d+)?)|(\.\d+))))|(c(\s?-?((\d+(\.\d+)?)|(\.\d+)))([,\s]?(-?((\d+(\.\d+)?)|(\.\d+)))){5})|(q(\s?-?((\d+(\.\d+)?)|(\.\d+)))([,\s]?(-?((\d+(\.\d+)?)|(\.\d+)))){3}(\s?t?(\s?-?((\d+(\.\d+)?)|(\.\d+)))[,\s]?(-?((\d+(\.\d+)?)|(\.\d+))))*)|(a(\s?-?((\d+(\.\d+)?)|(\.\d+)))([,\s]?(-?((\d+(\.\d+)?)|(\.\d+)))){2}[,\s]?[01][,\s]+[01][,\s]+([,\s]?(-?((\d+(\.\d+)?)|(\.\d+)))){2})|(s(\s?-?((\d+(\.\d+)?)|(\.\d+)))([,\s]?(-?((\d+(\.\d+)?)|(\.\d+)))){3})|z/gi;
+
+  const dataElements = dataString.match(validCommand);
+  // console.log("Splitted: ", dataElements);
+  if (!dataElements) {
+    return null;
+  }
+
+  const result: Array<SVGPathCommand> = [];
+
+  var i = 0;
+  while (i < dataElements.length) {
+    const token = dataElements[i];
+    // Ctwheels comment was really useful here
+    //    https://stackoverflow.com/questions/47801455/what-is-the-regex-that-properly-splits-svg-d-attributes-into-tokens
+    const dataRaw = token.match(/-?(?:\d*\.)?\d+|[a-z]/gi);
+    if (dataRaw) {
+      result.push(dataRaw as SVGPathCommand);
+    } else {
+      // throw Error?
+    }
+    i++;
+  }
+  return result;
+}; // END splitSVGPathData

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

@@ -0,0 +1,70 @@
+/**
+ * Defining some basic SVG command types.
+ *
+ * As these types do not define all very possible path data strings they should cover the most daily use-cases.
+ *
+ * For more insight see
+ *    https://www.w3.org/TR/SVG/paths.html
+ *
+ *
+ * @author  Ikaros Kappler
+ * @date    2022-12-21 (winter solstice night – yes the days & nights are dark and I have nothing else to do)
+ * @version 0.0.1-alpha
+ */
+
+export type NumericString = `${number}`;
+export type BooleanString = "0" | "1" | `${boolean}`;
+
+// Example: 'M', -10, -7.5,
+export type SVGPathMoveToCommand = ["M" | "m", NumericString, NumericString];
+// Example: 'L', 0, -10,
+export type SVGPathLineToCommand = ["L" | "l", NumericString, NumericString];
+// Example: 'V', -10,
+export type SVGPathVerticalLineToCommand = ["V" | "v", NumericString];
+// Example: 'H', 10,
+export type SVGPathHorizontalLineToCommand = ["H" | "h", NumericString];
+// Example: 'Q', 5, 5, 0, 0,
+// Example2: 'Q', 5, 5, 0, 0, 'T', -10, 0,
+export type SVGPathQuadraticCurveToCommand =
+  | ["Q" | "q", NumericString, NumericString, NumericString, NumericString]
+  | ["Q" | "q", NumericString, NumericString, NumericString, NumericString, "T" | "t", NumericString, NumericString];
+// Example: 'C', -5, -15, 10, -15, 5, -10,
+export type SVGPathCubicCurveToCommand = [
+  "C" | "c",
+  NumericString,
+  NumericString,
+  NumericString,
+  NumericString,
+  NumericString,
+  NumericString
+];
+// Example: 'S', 15, 0, 10, 0,
+export type SVGPathShorthandCubicCurveToCommand = ["S" | "s", NumericString, NumericString, NumericString, NumericString];
+// Example: 'A', 5, 4, 0, 1, 1, -10, -5,
+export type SVGPathArcToCommand = [
+  "A" | "a",
+  NumericString,
+  NumericString,
+  NumericString,
+  BooleanString,
+  BooleanString,
+  NumericString,
+  NumericString
+];
+// Example: 'Z'
+export type SVGPathCloseCommand = ["Z" | "z"];
+
+// NOTE: this is not a standalone command. It is only valid in combination with the Q|q command!
+// Example2: 'T', -10, 0,
+export type SVGPathShorthandQuadraticCurveToCommand = ["T" | "t", NumericString, NumericString];
+
+export type SVGPathCommand =
+  | SVGPathMoveToCommand
+  | SVGPathLineToCommand
+  | SVGPathVerticalLineToCommand
+  | SVGPathHorizontalLineToCommand
+  | SVGPathQuadraticCurveToCommand
+  | SVGPathCubicCurveToCommand
+  | SVGPathShorthandCubicCurveToCommand
+  | SVGPathArcToCommand
+  | SVGPathCloseCommand;