plotboilerplate 1.27.1 → 1.28.0

package/src/_esm/src/ts/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/src/ts/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/src/ts/utils/parsers/OBJParser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A simple wavefront OBJ parser.
+ *
+ * Inspired by
+ *    https://webglfundamentals.org/webgl/lessons/webgl-load-obj.html
+ *
+ * @param {*} handleVert
+ * @param {*} handleFace
+ *
+ * @author Ikaros Kappler
+ * @date 2021-04-21
+ * @version 0.0.1
+ */
+type VertHandler = (x: number, y: number, z: number) => void;
+type FaceHandler = (a: number, b: number, c: number) => void;
+export declare class OBJParser {
+    private handleVert;
+    private handleFace;
+    constructor(handleVert: VertHandler, handleFace: FaceHandler);
+    private _seekEOL;
+    private _handleLine;
+    parse(arrayBuffer: ArrayBuffer): void;
+}
+export {};

package/src/_esm/src/ts/utils/parsers/OBJParser.js

@@ -0,0 +1,72 @@
+/**
+ * A simple wavefront OBJ parser.
+ *
+ * Inspired by
+ *    https://webglfundamentals.org/webgl/lessons/webgl-load-obj.html
+ *
+ * @param {*} handleVert
+ * @param {*} handleFace
+ *
+ * @author Ikaros Kappler
+ * @date 2021-04-21
+ * @version 0.0.1
+ */
+export class OBJParser {
+    constructor(handleVert, handleFace) {
+        this.handleVert = handleVert;
+        this.handleFace = handleFace;
+    }
+    _seekEOL(byteView, curPosition) {
+        // Seek line break character (13)
+        while (curPosition < byteView.length && byteView[curPosition] !== 13 && byteView[curPosition] !== 10) {
+            curPosition++;
+        }
+        return curPosition;
+    }
+    _handleLine(line, lineNo) {
+        if (line === "" || line.startsWith("#")) {
+            return;
+        }
+        var split = line.split(/\s+/g);
+        if (split[0] === "v") {
+            // Parse string of form
+            // 'v x y z'
+            if (split.length < 4) {
+                console.warn("Parse error in line " + lineNo + ": too few arguments", line);
+                return;
+            }
+            // Assume all params are proper numbers.
+            this.handleVert(Number(split[1]), Number(split[2]), Number(split[3]));
+        }
+        else if (split[0] === "f") {
+            // Parse string of form
+            // 'f vA vB vC' or 'f vA/tA vB/tB vC/tC' or 'f vA/tA/nA vB/tB/nB vC/tC/nC'
+            if (split.length < 4) {
+                console.warn("Parse error in line " + lineNo + ": too few arguments", line);
+                return;
+            }
+            // Split each face argument into parts (vert-index/texture-coordindate/normal)
+            var faceParams = [];
+            for (var i = 1; i < 4; i++) {
+                var faceSplit = split[i].split("/");
+                faceParams.push(Number(faceSplit[0]));
+            }
+            this.handleFace(faceParams[0], faceParams[1], faceParams[2]);
+        }
+    }
+    parse(arrayBuffer) {
+        const byteView = new Int8Array(arrayBuffer);
+        var curStart = 0;
+        var curEnd = 0;
+        var lineNo = 0;
+        do {
+            curEnd = this._seekEOL(byteView, curStart);
+            var lineBuffer = byteView.slice(curStart, curEnd); // .toString();
+            var line = String.fromCharCode.apply(null, lineBuffer);
+            this._handleLine(line.trim(), lineNo);
+            curStart = curEnd + 1;
+            lineNo++;
+        } while (curEnd < arrayBuffer.byteLength);
+    }
+}
+//# sourceMappingURL=OBJParser.js.map

package/src/_esm/src/ts/utils/parsers/OBJParser.js.map

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

package/src/_esm/src/ts/utils/parsers/STLParser.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Refactored 3daddict's js-stl-parser.
+ *
+ * Found at
+ *   https://github.com/3daddict/js-stl-parser/blob/master/index.js
+ *
+ * Refactored by Ikaros Kappler
+ *
+ * @date     2021-04-16
+ * @modified 2024-03-09 Added type checks for Typescript 5 compatibility.
+ * @version  0.0.2
+ */
+/**
+ * Process a facet. Normals are not guaranteed to be present (binary yes, ascii no).
+ */
+type FacetHandler = (v1: Vertex, v2: Vertex, v3: Vertex, normal?: Vertex) => void;
+declare class Vertex {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+}
+/**
+ * @classdesc STLParser
+ */
+export declare class STLParser {
+    private handleFacet;
+    /**
+     * Create a new STLParser with the given callback fuction for facets.
+     *
+     * @param {function} handleFacet function(x,y,z)
+     * @constructor
+     * */
+    constructor(handleFacet: FacetHandler);
+    /**
+     * Parse an stl string (ASCII).
+     * @name _parseSTLString
+     * @method _parseSTLString
+     * @memberof STLParser
+     * @param {string} stl
+     * @private
+     */
+    private _parseSTLString;
+    /**
+     * Parse binary STL data.
+     * @param {ArrayBuffer} buf
+     */
+    private _parseSTLBinary;
+    /**
+     * Parse any, binary or ascii, STL data.
+     *
+     * @name parse
+     * @method parse
+     * @member
+     * @memberof STLParser
+     * @param {ArrayBstringuffer} binaryOrAsciiString
+     * @returns
+     */
+    parse(binaryOrAsciiString: string): void;
+}
+export {};

package/src/_esm/src/ts/utils/parsers/STLParser.js

@@ -0,0 +1,175 @@
+/**
+ * Refactored 3daddict's js-stl-parser.
+ *
+ * Found at
+ *   https://github.com/3daddict/js-stl-parser/blob/master/index.js
+ *
+ * Refactored by Ikaros Kappler
+ *
+ * @date     2021-04-16
+ * @modified 2024-03-09 Added type checks for Typescript 5 compatibility.
+ * @version  0.0.2
+ */
+class Vertex {
+    constructor(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+}
+// Vertex Holder
+class VertexHolder {
+    constructor(vertex1, vertex2, vertex3) {
+        this.vert1 = vertex1;
+        this.vert2 = vertex2;
+        this.vert3 = vertex3;
+    }
+}
+// transforming a Node.js Buffer into a V8 array buffer
+const _toArrayBuffer = (buffer) => {
+    const ab = new ArrayBuffer(buffer.length);
+    const view = new Uint8Array(ab);
+    for (var i = 0; i < buffer.length; ++i) {
+        view[i] = buffer.charCodeAt(i);
+    }
+    return ab;
+};
+/**
+ * @classdesc STLParser
+ */
+export class STLParser {
+    /**
+     * Create a new STLParser with the given callback fuction for facets.
+     *
+     * @param {function} handleFacet function(x,y,z)
+     * @constructor
+     * */
+    constructor(handleFacet) {
+        this.handleFacet = handleFacet;
+    }
+    /**
+     * Parse an stl string (ASCII).
+     * @name _parseSTLString
+     * @method _parseSTLString
+     * @memberof STLParser
+     * @param {string} stl
+     * @private
+     */
+    _parseSTLString(stl) {
+        // yes, this is the regular expression, matching the vertexes
+        // it was kind of tricky but it is fast and does the job
+        const vertexes = stl.match(/facet\s+normal\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+outer\s+loop\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+endloop\s+endfacet/g);
+        if (!vertexes) {
+            throw "[STLParser] Failed to parse STL input; regex could not match.";
+        }
+        ;
+        const _handleFacet = this.handleFacet;
+        vertexes.forEach((vert) => {
+            const preVertexHolder = new VertexHolder();
+            const vertValues = vert
+                .match(/vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s/g);
+            if (!vertValues) {
+                console.warn("[STLParser] Could not parse vertex values.", vertValues);
+            }
+            else {
+                vertValues.forEach((vertex, i) => {
+                    const tempVertex = vertex.replace("vertex", "").match(/[-+]?[0-9]*\.?[0-9]+/g);
+                    if (!tempVertex) {
+                        console.warn("[STLParser] Failed to parse vertex value.", tempVertex);
+                    }
+                    else {
+                        const preVertex = new Vertex(Number(tempVertex[0]), Number(tempVertex[1]), Number(tempVertex[2]));
+                        // preVertexHolder["vert" + (i + 1)] = preVertex;
+                        switch (i) {
+                            case 0:
+                                preVertexHolder.vert1 = preVertex;
+                                break;
+                            case 1:
+                                preVertexHolder.vert2 = preVertex;
+                                break;
+                            case 2:
+                                preVertexHolder.vert3 = preVertex;
+                                break;
+                            default: console.warn("[STLParse] Warning, vertex component index unexpeced.", i);
+                        }
+                    }
+                });
+            }
+            if (preVertexHolder.vert1 && preVertexHolder.vert2 && preVertexHolder.vert3) {
+                _handleFacet(preVertexHolder.vert1, preVertexHolder.vert2, preVertexHolder.vert3);
+            }
+            else {
+                console.warn("[STLParse] Warning, cannot add vertex to mesh. vertex not fully defined.");
+            }
+        });
+    }
+    /**
+     * Parse binary STL data.
+     * @param {ArrayBuffer} buf
+     */
+    _parseSTLBinary(buf) {
+        // parsing an STL Binary File
+        // (borrowed some code from here: https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/STLLoader.js)
+        const headerLength = 80;
+        const dataOffset = 84;
+        const faceLength = 12 * 4 + 2;
+        const le = true; // is little-endian
+        const dvTriangleCount = new DataView(buf, headerLength, 4);
+        const numTriangles = dvTriangleCount.getUint32(0, le);
+        for (var i = 0; i < numTriangles; i++) {
+            const dv = new DataView(buf, dataOffset + i * faceLength, faceLength);
+            const normal = new Vertex(dv.getFloat32(0, le), dv.getFloat32(4, le), dv.getFloat32(8, le));
+            const vertHolder = new VertexHolder();
+            for (var v = 3; v < 12; v += 3) {
+                var vert = new Vertex(dv.getFloat32(v * 4, le), dv.getFloat32((v + 1) * 4, le), dv.getFloat32((v + 2) * 4, le));
+                // vertHolder["vert" + v / 3] = vert;
+                const vIndex = v / 3;
+                switch (vIndex) {
+                    case 1:
+                        vertHolder.vert1 = vert;
+                        break;
+                    case 2:
+                        vertHolder.vert2 = vert;
+                        break;
+                    case 3:
+                        vertHolder.vert3 = vert;
+                        break;
+                    default: console.warn("[STLParser] Warning, binary vertex component index unexpeced.", vIndex);
+                }
+            }
+            if (vertHolder.vert1 && vertHolder.vert2 && vertHolder.vert3) {
+                this.handleFacet(vertHolder.vert1, vertHolder.vert2, vertHolder.vert3, normal);
+            }
+            else {
+                console.warn("[STLParser] Warning, cannot add binary vertex to mesh. vertex not fully defined.");
+            }
+        }
+    }
+    /**
+     * Parse any, binary or ascii, STL data.
+     *
+     * @name parse
+     * @method parse
+     * @member
+     * @memberof STLParser
+     * @param {ArrayBstringuffer} binaryOrAsciiString
+     * @returns
+     */
+    parse(binaryOrAsciiString) {
+        var isAscii = true;
+        for (var i = 0, len = binaryOrAsciiString.length; i < len && isAscii; i++) {
+            if (binaryOrAsciiString.charCodeAt(i) > 127) {
+                isAscii = false;
+                break;
+            }
+        }
+        if (isAscii) {
+            this._parseSTLString(binaryOrAsciiString.toString());
+        }
+        else {
+            const buffer = _toArrayBuffer(binaryOrAsciiString);
+            this._parseSTLBinary(buffer);
+        }
+    }
+}
+//# sourceMappingURL=STLParser.js.map

package/src/_esm/src/ts/utils/parsers/STLParser.js.map

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

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

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ * @modified 2023-01-17 Handling multiple parameter sets now.
+ * @version 0.0.2-alpha
+ **/
+import { CubicBezierCurve } from "../../../CubicBezierCurve";
+import { Line } from "../../../Line";
+/**
+ * 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 declare const parseSVGPathData: (dataString: string) => Array<Line | CubicBezierCurve> | null;