svg-toolbox 1.1.6 → 1.1.8

package/es/applyRemoveNanCoordinates.js

@@ -6,6 +6,8 @@
  * @author pipi
  */
 import { JSDOM } from 'jsdom';
+// Define the types of path commands that do not have parameters
+const ignoreTypes = ['z', 'Z'];
 /**
  * Parses and normalizes the 'd' attribute of all path elements in an SVG content.
  * @param {*} svgContent
@@ -41,11 +43,13 @@ export default function (svgContent) {
             // Split each command into type and parameters
             const type = command[0];
             // If the command is not 'z' or 'Z', then it has parameters.
-            if (type !== 'Z' && type !== 'z') {
+            const ignoreType = ignoreTypes.includes(type);
+            if (!ignoreType) {
                 // Split parameters by spaces or commas, filter out empty values, and convert to numbers
                 const params = command.slice(1).split(/[\s,]+/);
                 // Filter out non-numeric values
-                if (params.every(Number)) {
+                const pickCommand = params.every(Number);
+                if (pickCommand) {
                     return { type, params };
                 }
             }
@@ -57,7 +61,7 @@ export default function (svgContent) {
             .filter((item) => item !== void 0)
             // Filter out commands with no parameters, or commands with only 'z' or 'Z'. 'Zz' means close the path. 
             // -> https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/d#closepath
-            .filter((command) => (command.type === 'Z' || command.type === 'z' || command.params.length > 0));
+            .filter((command) => (ignoreTypes.includes(command.type) || command.params.length > 0));
         // Reconstruct the 'd' attribute
         const modifiedD = commands.map((command) => {
             return command.type + command.params.join(' ');

package/es/applyRemoveNanCoordinates.js.map

@@ -1 +1 @@
-{"version":3,"file":"applyRemoveNanCoordinates.js","sourceRoot":"","sources":["../src/applyRemoveNanCoordinates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,OAAO,WAAW,UAAkB;IACzC,oCAAoC;IACpC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE;QAChC,WAAW,EAAE,eAAe,CAAC,0BAA0B;KACxD,CAAC,CAAC;IACH,mCAAmC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrC,sBAAsB;IACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjD,oCAAoC;IACpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClD,iCAAiC;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;QAC1D,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,uDAAuD;QACvD,MAAM,QAAQ,GAAG,CAAC;YAChB,iCAAiC;aAChC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;YAC1B,wGAAwG;YACxG,gFAAgF;aAC/E,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACnD,8CAA8C;YAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,4DAA4D;YAC5D,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjC,wFAAwF;gBACxF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC/C,gCAAgC;gBAChC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAC1B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;YACF,8BAA8B;aAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;YAClC,wGAAwG;YACxG,4EAA4E;aAC3E,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACpG,gCAAgC;QAChC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACzC,OAAO,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,iCAAiC;IACtE,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"applyRemoveNanCoordinates.js","sourceRoot":"","sources":["../src/applyRemoveNanCoordinates.ts"],"names":[],"mappings":"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"}

package/es/common.d.ts

@@ -64,12 +64,12 @@ export declare function cloneSVGElement(element: Element): Element;
  */
 export declare function mergeSVGElements(elements: Element[]): Element;
 /**
- * Converts an SVG element to a Base64-encoded string.
+ * Converts an SVG element or SVG string to a Base64-encoded string.
  *
- * This function serializes the SVG element to a string and then encodes it to Base64.
+ * This function serializes the SVG element or SVG string to a string and then encodes it to Base64.
  * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
  *
- * @param {Element} svgElement - The SVG element to convert.
+ * @param {Element | string} svgContent - The SVG element or SVG string to convert.
  * @returns {string} - The Base64-encoded string representation of the SVG element.
  *
  * @example
@@ -80,7 +80,7 @@ export declare function mergeSVGElements(elements: Element[]): Element;
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
-export declare function convertSVGToBase64(svgElement: Element): string;
+export declare function convertSVGToBase64(svgContent: Element | string): string;
 /**
  * Converts a Base64-encoded string to an SVG string.
  *

package/es/common.js

@@ -6,9 +6,11 @@
  * @author pipi
  */
 import { JSDOM } from 'jsdom';
+import { isValidSvgElement, isValidSvgString } from './validate';
 // Create a virtual DOM environment
 const dom = new JSDOM(`<!DOCTYPE html><html><body></body></html>`);
-const { document } = dom.window;
+const fakeWindow = dom.window;
+const { document } = fakeWindow;
 /**
  * Creates an SVG element from a given element.
  *
@@ -30,7 +32,7 @@ const { document } = dom.window;
  * @returns
  */
 export function createSVGElement(svgContent) {
-    const svgElement = new dom.window.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
+    const svgElement = new fakeWindow.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
     return svgElement;
 }
 /**
@@ -51,9 +53,9 @@ export function createSVGElement(svgContent) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  */
 export function cloneSVGElement(element) {
-    const serializer = new dom.window.XMLSerializer();
+    const serializer = new fakeWindow.XMLSerializer();
     const sourceCode = serializer.serializeToString(element);
-    const parser = new dom.window.DOMParser();
+    const parser = new fakeWindow.DOMParser();
     const doc = parser.parseFromString(sourceCode, 'image/svg+xml');
     return doc.documentElement;
 }
@@ -83,12 +85,12 @@ export function mergeSVGElements(elements) {
     return mergedSVG;
 }
 /**
- * Converts an SVG element to a Base64-encoded string.
+ * Converts an SVG element or SVG string to a Base64-encoded string.
  *
- * This function serializes the SVG element to a string and then encodes it to Base64.
+ * This function serializes the SVG element or SVG string to a string and then encodes it to Base64.
  * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
  *
- * @param {Element} svgElement - The SVG element to convert.
+ * @param {Element | string} svgContent - The SVG element or SVG string to convert.
  * @returns {string} - The Base64-encoded string representation of the SVG element.
  *
  * @example
@@ -99,9 +101,18 @@ export function mergeSVGElements(elements) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
-export function convertSVGToBase64(svgElement) {
-    const serializer = new dom.window.XMLSerializer();
-    const svgString = serializer.serializeToString(svgElement);
+export function convertSVGToBase64(svgContent) {
+    let svgString;
+    if (isValidSvgString(svgContent)) {
+        svgString = svgContent;
+    }
+    else if (isValidSvgElement(svgContent)) {
+        const serializer = new fakeWindow.XMLSerializer();
+        svgString = serializer.serializeToString(svgContent);
+    }
+    else {
+        throw new Error('The provided content is not a valid SVG string or SVG element.');
+    }
     return `data:image/svg+xml;base64,${Buffer.from(svgString).toString('base64')}`;
 }
 /**
@@ -122,7 +133,12 @@ export function convertSVGToBase64(svgElement) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
 export function convertBase64ToSVG(base64String) {
-    const svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
-    return svgString;
+    try {
+        const svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
+        return svgString;
+    }
+    catch (error) {
+        throw new Error('Invalid Base64 string.');
+    }
 }
 //# sourceMappingURL=common.js.map

package/es/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,mCAAmC;AACnC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAmB;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,mCAAmC;AACnC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AACnE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;AAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAmB;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA4B;IAC7D,IAAI,SAAiB,CAAC;IACtB,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,SAAS,GAAG,UAAoB,CAAC;IACnC,CAAC;SAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;QAClD,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAqB,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/es/validate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file validate.ts
+ * @description This module provides functions to validate SVG content.
+ * @module validate
+ * @author pipi
+ */
+/**
+ * Validates whether the provided content is a valid SVG string.
+ *
+ * @param content - The content to be validated (could be a string or another type).
+ * @returns True if the content is a valid SVG string, false otherwise.
+ */
+export declare function isValidSvgString(content: any): boolean;
+/**
+ * Validates whether the provided content is a valid SVG element.
+ *
+ * @param content - The content to be validated (could be an Element or another type).
+ * @returns True if the content is a valid SVG element, false otherwise.
+ */
+export declare function isValidSvgElement(content: any): boolean;

package/es/validate.js

@@ -0,0 +1,38 @@
+/**
+ * @file validate.ts
+ * @description This module provides functions to validate SVG content.
+ * @module validate
+ * @author pipi
+ */
+/**
+ * Validates whether the provided content is a valid SVG string.
+ *
+ * @param content - The content to be validated (could be a string or another type).
+ * @returns True if the content is a valid SVG string, false otherwise.
+ */
+export function isValidSvgString(content) {
+    // Check if the content is of type string. If not, it cannot be a valid SVG string.
+    if (typeof content !== 'string') {
+        return false;
+    }
+    // Regular expression to find the <svg> opening tag in the string.
+    const svgRegExp = /<svg(\s+[^>]*)?>/i;
+    const startTag = content.match(svgRegExp);
+    // Check if a matching <svg> tag was found and it's in lowercase (case-insensitive check).
+    return !!(startTag && startTag[0].toLowerCase().includes('<svg'));
+}
+/**
+ * Validates whether the provided content is a valid SVG element.
+ *
+ * @param content - The content to be validated (could be an Element or another type).
+ * @returns True if the content is a valid SVG element, false otherwise.
+ */
+export function isValidSvgElement(content) {
+    // Check if the content is an instance of Element and its tag name is 'svg'
+    return (content &&
+        typeof content === 'object' &&
+        content.tagName.toLowerCase() === 'svg' &&
+        content.namespaceURI === 'http://www.w3.org/2000/svg' // SVG namespace URI
+    );
+}
+//# sourceMappingURL=validate.js.map

package/es/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAY;IAC3C,mFAAmF;IACnF,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kEAAkE;IAClE,MAAM,SAAS,GAAG,mBAAmB,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE1C,0FAA0F;IAC1F,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAY;IAC5C,2EAA2E;IAC3E,OAAO,CACL,OAAO;QACP,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,KAAK;QACvC,OAAO,CAAC,YAAY,KAAK,4BAA4B,CAAC,oBAAoB;KAC3E,CAAC;AACJ,CAAC"}

package/lib/applyRemoveNanCoordinates.js

@@ -9,6 +9,8 @@ exports.default = default_1;
  * @author pipi
  */
 var jsdom_1 = require("jsdom");
+// Define the types of path commands that do not have parameters
+var ignoreTypes = ['z', 'Z'];
 /**
  * Parses and normalizes the 'd' attribute of all path elements in an SVG content.
  * @param {*} svgContent
@@ -44,11 +46,13 @@ function default_1(svgContent) {
             // Split each command into type and parameters
             var type = command[0];
             // If the command is not 'z' or 'Z', then it has parameters.
-            if (type !== 'Z' && type !== 'z') {
+            var ignoreType = ignoreTypes.includes(type);
+            if (!ignoreType) {
                 // Split parameters by spaces or commas, filter out empty values, and convert to numbers
                 var params = command.slice(1).split(/[\s,]+/);
                 // Filter out non-numeric values
-                if (params.every(Number)) {
+                var pickCommand = params.every(Number);
+                if (pickCommand) {
                     return { type: type, params: params };
                 }
             }
@@ -60,7 +64,7 @@ function default_1(svgContent) {
             .filter(function (item) { return item !== void 0; })
             // Filter out commands with no parameters, or commands with only 'z' or 'Z'. 'Zz' means close the path. 
             // -> https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/d#closepath
-            .filter(function (command) { return (command.type === 'Z' || command.type === 'z' || command.params.length > 0); });
+            .filter(function (command) { return (ignoreTypes.includes(command.type) || command.params.length > 0); });
         // Reconstruct the 'd' attribute
         var modifiedD = commands.map(function (command) {
             return command.type + command.params.join(' ');

package/lib/applyRemoveNanCoordinates.js.map

@@ -1 +1 @@
-{"version":3,"file":"applyRemoveNanCoordinates.js","sourceRoot":"","sources":["../src/applyRemoveNanCoordinates.ts"],"names":[],"mappings":";;AAcA,4BA0DC;AAxED;;;;;;GAMG;AACH,+BAA8B;AAE9B;;;;GAIG;AACH,mBAAyB,UAAkB;IACzC,oCAAoC;IACpC,IAAM,GAAG,GAAG,IAAI,aAAK,CAAC,UAAU,EAAE;QAChC,WAAW,EAAE,eAAe,CAAC,0BAA0B;KACxD,CAAC,CAAC;IACH,mCAAmC;IACnC,IAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrC,sBAAsB;IACtB,IAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjD,oCAAoC;IACpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClD,iCAAiC;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAC,IAAI;QAC7B,IAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;QAC1D,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,uDAAuD;QACvD,IAAM,QAAQ,GAAG,CAAC;YAChB,iCAAiC;aAChC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;YAC1B,wGAAwG;YACxG,gFAAgF;aAC/E,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,UAAC,OAAO;YAC/C,8CAA8C;YAC9C,IAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,4DAA4D;YAC5D,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjC,wFAAwF;gBACxF,IAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC/C,gCAAgC;gBAChC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,OAAO,EAAE,IAAI,MAAA,EAAE,MAAM,QAAA,EAAE,CAAC;gBAC1B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,IAAI,MAAA,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;YACF,8BAA8B;aAC7B,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,KAAK,KAAK,CAAC,EAAf,CAAe,CAAC;YAClC,wGAAwG;YACxG,4EAA4E;aAC3E,MAAM,CAAC,UAAC,OAAO,IAAK,OAAA,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAA3E,CAA2E,CAAC,CAAC;QACpG,gCAAgC;QAChC,IAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAC,OAAO;YACrC,OAAO,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,iCAAiC;IACtE,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,IAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"applyRemoveNanCoordinates.js","sourceRoot":"","sources":["../src/applyRemoveNanCoordinates.ts"],"names":[],"mappings":"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"}

package/lib/common.d.ts

@@ -64,12 +64,12 @@ export declare function cloneSVGElement(element: Element): Element;
  */
 export declare function mergeSVGElements(elements: Element[]): Element;
 /**
- * Converts an SVG element to a Base64-encoded string.
+ * Converts an SVG element or SVG string to a Base64-encoded string.
  *
- * This function serializes the SVG element to a string and then encodes it to Base64.
+ * This function serializes the SVG element or SVG string to a string and then encodes it to Base64.
  * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
  *
- * @param {Element} svgElement - The SVG element to convert.
+ * @param {Element | string} svgContent - The SVG element or SVG string to convert.
  * @returns {string} - The Base64-encoded string representation of the SVG element.
  *
  * @example
@@ -80,7 +80,7 @@ export declare function mergeSVGElements(elements: Element[]): Element;
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
-export declare function convertSVGToBase64(svgElement: Element): string;
+export declare function convertSVGToBase64(svgContent: Element | string): string;
 /**
  * Converts a Base64-encoded string to an SVG string.
  *

package/lib/common.js

@@ -13,9 +13,11 @@ exports.mergeSVGElements = mergeSVGElements;
 exports.convertSVGToBase64 = convertSVGToBase64;
 exports.convertBase64ToSVG = convertBase64ToSVG;
 var jsdom_1 = require("jsdom");
+var validate_1 = require("./validate");
 // Create a virtual DOM environment
 var dom = new jsdom_1.JSDOM("<!DOCTYPE html><html><body></body></html>");
-var document = dom.window.document;
+var fakeWindow = dom.window;
+var document = fakeWindow.document;
 /**
  * Creates an SVG element from a given element.
  *
@@ -37,7 +39,7 @@ var document = dom.window.document;
  * @returns
  */
 function createSVGElement(svgContent) {
-    var svgElement = new dom.window.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
+    var svgElement = new fakeWindow.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
     return svgElement;
 }
 /**
@@ -58,9 +60,9 @@ function createSVGElement(svgContent) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  */
 function cloneSVGElement(element) {
-    var serializer = new dom.window.XMLSerializer();
+    var serializer = new fakeWindow.XMLSerializer();
     var sourceCode = serializer.serializeToString(element);
-    var parser = new dom.window.DOMParser();
+    var parser = new fakeWindow.DOMParser();
     var doc = parser.parseFromString(sourceCode, 'image/svg+xml');
     return doc.documentElement;
 }
@@ -90,12 +92,12 @@ function mergeSVGElements(elements) {
     return mergedSVG;
 }
 /**
- * Converts an SVG element to a Base64-encoded string.
+ * Converts an SVG element or SVG string to a Base64-encoded string.
  *
- * This function serializes the SVG element to a string and then encodes it to Base64.
+ * This function serializes the SVG element or SVG string to a string and then encodes it to Base64.
  * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
  *
- * @param {Element} svgElement - The SVG element to convert.
+ * @param {Element | string} svgContent - The SVG element or SVG string to convert.
  * @returns {string} - The Base64-encoded string representation of the SVG element.
  *
  * @example
@@ -106,9 +108,18 @@ function mergeSVGElements(elements) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
-function convertSVGToBase64(svgElement) {
-    var serializer = new dom.window.XMLSerializer();
-    var svgString = serializer.serializeToString(svgElement);
+function convertSVGToBase64(svgContent) {
+    var svgString;
+    if ((0, validate_1.isValidSvgString)(svgContent)) {
+        svgString = svgContent;
+    }
+    else if ((0, validate_1.isValidSvgElement)(svgContent)) {
+        var serializer = new fakeWindow.XMLSerializer();
+        svgString = serializer.serializeToString(svgContent);
+    }
+    else {
+        throw new Error('The provided content is not a valid SVG string or SVG element.');
+    }
     return "data:image/svg+xml;base64,".concat(Buffer.from(svgString).toString('base64'));
 }
 /**
@@ -129,7 +140,12 @@ function convertSVGToBase64(svgElement) {
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
  */
 function convertBase64ToSVG(base64String) {
-    var svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
-    return svgString;
+    try {
+        var svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
+        return svgString;
+    }
+    catch (error) {
+        throw new Error('Invalid Base64 string.');
+    }
 }
 //# sourceMappingURL=common.js.map

package/lib/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA4BH,4CAGC;AAmBD,0CAMC;AAoBD,4CAMC;AAmBD,gDAIC;AAmBD,gDAGC;AA7HD,+BAA8B;AAE9B,mCAAmC;AACnC,IAAM,GAAG,GAAG,IAAI,aAAK,CAAC,2CAA2C,CAAC,CAAC;AAC3D,IAAA,QAAQ,GAAK,GAAG,CAAC,MAAM,SAAf,CAAgB;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,IAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1C,IAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,gBAAgB,CAAC,QAAmB;IAClD,IAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,UAAC,OAAO;QACvB,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,UAAmB;IACpD,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,IAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,oCAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,IAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA8BH,4CAGC;AAmBD,0CAMC;AAoBD,4CAMC;AAmBD,gDAWC;AAmBD,gDAOC;AA1ID,+BAA8B;AAC9B,uCAAiE;AAEjE,mCAAmC;AACnC,IAAM,GAAG,GAAG,IAAI,aAAK,CAAC,2CAA2C,CAAC,CAAC;AACnE,IAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;AACtB,IAAA,QAAQ,GAAK,UAAU,SAAf,CAAgB;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,IAAM,UAAU,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,IAAM,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;IAClD,IAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;IAC1C,IAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,gBAAgB,CAAC,QAAmB;IAClD,IAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,UAAC,OAAO;QACvB,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,UAA4B;IAC7D,IAAI,SAAiB,CAAC;IACtB,IAAI,IAAA,2BAAgB,EAAC,UAAU,CAAC,EAAE,CAAC;QACjC,SAAS,GAAG,UAAoB,CAAC;IACnC,CAAC;SAAM,IAAI,IAAA,4BAAiB,EAAC,UAAU,CAAC,EAAE,CAAC;QACzC,IAAM,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;QAClD,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAqB,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,oCAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,IAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/lib/validate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file validate.ts
+ * @description This module provides functions to validate SVG content.
+ * @module validate
+ * @author pipi
+ */
+/**
+ * Validates whether the provided content is a valid SVG string.
+ *
+ * @param content - The content to be validated (could be a string or another type).
+ * @returns True if the content is a valid SVG string, false otherwise.
+ */
+export declare function isValidSvgString(content: any): boolean;
+/**
+ * Validates whether the provided content is a valid SVG element.
+ *
+ * @param content - The content to be validated (could be an Element or another type).
+ * @returns True if the content is a valid SVG element, false otherwise.
+ */
+export declare function isValidSvgElement(content: any): boolean;

package/lib/validate.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * @file validate.ts
+ * @description This module provides functions to validate SVG content.
+ * @module validate
+ * @author pipi
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSvgString = isValidSvgString;
+exports.isValidSvgElement = isValidSvgElement;
+/**
+ * Validates whether the provided content is a valid SVG string.
+ *
+ * @param content - The content to be validated (could be a string or another type).
+ * @returns True if the content is a valid SVG string, false otherwise.
+ */
+function isValidSvgString(content) {
+    // Check if the content is of type string. If not, it cannot be a valid SVG string.
+    if (typeof content !== 'string') {
+        return false;
+    }
+    // Regular expression to find the <svg> opening tag in the string.
+    var svgRegExp = /<svg(\s+[^>]*)?>/i;
+    var startTag = content.match(svgRegExp);
+    // Check if a matching <svg> tag was found and it's in lowercase (case-insensitive check).
+    return !!(startTag && startTag[0].toLowerCase().includes('<svg'));
+}
+/**
+ * Validates whether the provided content is a valid SVG element.
+ *
+ * @param content - The content to be validated (could be an Element or another type).
+ * @returns True if the content is a valid SVG element, false otherwise.
+ */
+function isValidSvgElement(content) {
+    // Check if the content is an instance of Element and its tag name is 'svg'
+    return (content &&
+        typeof content === 'object' &&
+        content.tagName.toLowerCase() === 'svg' &&
+        content.namespaceURI === 'http://www.w3.org/2000/svg' // SVG namespace URI
+    );
+}
+//# sourceMappingURL=validate.js.map

package/lib/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAQH,4CAYC;AAQD,8CAQC;AAlCD;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAAY;IAC3C,mFAAmF;IACnF,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kEAAkE;IAClE,IAAM,SAAS,GAAG,mBAAmB,CAAC;IACtC,IAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE1C,0FAA0F;IAC1F,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,OAAY;IAC5C,2EAA2E;IAC3E,OAAO,CACL,OAAO;QACP,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,KAAK;QACvC,OAAO,CAAC,YAAY,KAAK,4BAA4B,CAAC,oBAAoB;KAC3E,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svg-toolbox",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "This library provides some SVG-related tools",
   "main": "lib/index.js",
   "module": "es/index.js",

package/es/utils.d.ts

@@ -1,103 +0,0 @@
-/**
- * @file utils.ts
- * @description This module provides utility functions for working with SVG elements.
- * @module utils
- * @requires jsdom - A JavaScript implementation of the WHATWG DOM and HTML standards.
- * @author pipi
- */
-/**
- * Creates an SVG element from a given element.
- *
- * This function serializes the given element to a string, then parses it back to create an SVG element.
- * This approach ensures that the element is correctly parsed as an SVG element.
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('URL_ADDRESS * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = createSVGElement(svgElement);
- * @param svgContent
- * @returns
- */
-export declare function createSVGElement(svgContent: string): Element;
-/**
- * Clones an SVG element deeply.
- *
- * This function serializes the given SVG element to a string, then parses it back to create a deep clone.
- * This approach ensures that all attributes and child nodes are duplicated.
- *
- * @param {Element} element - The SVG element to clone.
- * @returns {Element} - The cloned SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const clonedElement = cloneSVGElement(svgElement);
- * console.log(clonedElement);
- *
- * @see https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-6ED8C4D5 - DOM Level 2 Core specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- */
-export declare function cloneSVGElement(element: Element): Element;
-/**
- * Merges multiple SVG elements into a single SVG element.
- *
- * This function creates a new SVG element and appends clones of the provided elements to it.
- * The SVG namespace is specified as 'http://www.w3.org/2000/svg'.
- *
- * @param {Element[]} elements - An array of SVG elements to merge.
- * @returns {Element} - The merged SVG element.
- *
- * @example
- * const svgElement1 = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
- * const mergedElement = mergeSVGElements([svgElement1, svgElement2]);
- * console.log(mergedElement);
- *
- * @see https://www.w3.org/TR/SVG/ - SVG specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS - createElementNS documentation
- */
-export declare function mergeSVGElements(elements: Element[]): Element;
-/**
- * Converts an SVG element to a Base64-encoded string.
- *
- * This function serializes the SVG element to a string and then encodes it to Base64.
- * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
- *
- * @param {Element} svgElement - The SVG element to convert.
- * @returns {string} - The Base64-encoded string representation of the SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const base64String = convertSVGToBase64(svgElement);
- * console.log(base64String);
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
- */
-export declare function convertSVGToBase64(svgElement: Element): string;
-/**
- * Converts a Base64-encoded string to an SVG string.
- *
- * This function decodes the Base64-encoded string and then converts it to an SVG string.
- * The resulting string can be used to create an SVG element using the `createSVGElement` function.
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- * const base64String = 'data:image/svg+xml;base64, * const base64String = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3
- * const svgString = convertBase64ToSVG(base64String);
- * console.log(svgString);
- */
-export declare function convertBase64ToSVG(base64String: string): string;

package/es/utils.js

@@ -1,130 +0,0 @@
-/**
- * @file utils.ts
- * @description This module provides utility functions for working with SVG elements.
- * @module utils
- * @requires jsdom - A JavaScript implementation of the WHATWG DOM and HTML standards.
- * @author pipi
- */
-import { JSDOM } from 'jsdom';
-// Create a virtual DOM environment
-const dom = new JSDOM(`<!DOCTYPE html><html><body></body></html>`);
-const { document } = dom.window;
-/**
- * Creates an SVG element from a given element.
- *
- * This function serializes the given element to a string, then parses it back to create an SVG element.
- * This approach ensures that the element is correctly parsed as an SVG element.
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('URL_ADDRESS * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = createSVGElement(svgElement);
- * @param svgContent
- * @returns
- */
-export function createSVGElement(svgContent) {
-    const svgElement = new dom.window.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
-    return svgElement;
-}
-/**
- * Clones an SVG element deeply.
- *
- * This function serializes the given SVG element to a string, then parses it back to create a deep clone.
- * This approach ensures that all attributes and child nodes are duplicated.
- *
- * @param {Element} element - The SVG element to clone.
- * @returns {Element} - The cloned SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const clonedElement = cloneSVGElement(svgElement);
- * console.log(clonedElement);
- *
- * @see https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-6ED8C4D5 - DOM Level 2 Core specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- */
-export function cloneSVGElement(element) {
-    const serializer = new dom.window.XMLSerializer();
-    const sourceCode = serializer.serializeToString(element);
-    const parser = new dom.window.DOMParser();
-    const doc = parser.parseFromString(sourceCode, 'image/svg+xml');
-    return doc.documentElement;
-}
-/**
- * Merges multiple SVG elements into a single SVG element.
- *
- * This function creates a new SVG element and appends clones of the provided elements to it.
- * The SVG namespace is specified as 'http://www.w3.org/2000/svg'.
- *
- * @param {Element[]} elements - An array of SVG elements to merge.
- * @returns {Element} - The merged SVG element.
- *
- * @example
- * const svgElement1 = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
- * const mergedElement = mergeSVGElements([svgElement1, svgElement2]);
- * console.log(mergedElement);
- *
- * @see https://www.w3.org/TR/SVG/ - SVG specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS - createElementNS documentation
- */
-export function mergeSVGElements(elements) {
-    const mergedSVG = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
-    elements.forEach((element) => {
-        mergedSVG.appendChild(cloneSVGElement(element));
-    });
-    return mergedSVG;
-}
-/**
- * Converts an SVG element to a Base64-encoded string.
- *
- * This function serializes the SVG element to a string and then encodes it to Base64.
- * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
- *
- * @param {Element} svgElement - The SVG element to convert.
- * @returns {string} - The Base64-encoded string representation of the SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const base64String = convertSVGToBase64(svgElement);
- * console.log(base64String);
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
- */
-export function convertSVGToBase64(svgElement) {
-    const serializer = new dom.window.XMLSerializer();
-    const svgString = serializer.serializeToString(svgElement);
-    return `data:image/svg+xml;base64,${Buffer.from(svgString).toString('base64')}`;
-}
-/**
- * Converts a Base64-encoded string to an SVG string.
- *
- * This function decodes the Base64-encoded string and then converts it to an SVG string.
- * The resulting string can be used to create an SVG element using the `createSVGElement` function.
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- * const base64String = 'data:image/svg+xml;base64, * const base64String = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3
- * const svgString = convertBase64ToSVG(base64String);
- * console.log(svgString);
- */
-export function convertBase64ToSVG(base64String) {
-    const svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
-    return svgString;
-}
-//# sourceMappingURL=utils.js.map

package/es/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,mCAAmC;AACnC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAmB;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/utils.d.ts

@@ -1,103 +0,0 @@
-/**
- * @file utils.ts
- * @description This module provides utility functions for working with SVG elements.
- * @module utils
- * @requires jsdom - A JavaScript implementation of the WHATWG DOM and HTML standards.
- * @author pipi
- */
-/**
- * Creates an SVG element from a given element.
- *
- * This function serializes the given element to a string, then parses it back to create an SVG element.
- * This approach ensures that the element is correctly parsed as an SVG element.
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('URL_ADDRESS * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = createSVGElement(svgElement);
- * @param svgContent
- * @returns
- */
-export declare function createSVGElement(svgContent: string): Element;
-/**
- * Clones an SVG element deeply.
- *
- * This function serializes the given SVG element to a string, then parses it back to create a deep clone.
- * This approach ensures that all attributes and child nodes are duplicated.
- *
- * @param {Element} element - The SVG element to clone.
- * @returns {Element} - The cloned SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const clonedElement = cloneSVGElement(svgElement);
- * console.log(clonedElement);
- *
- * @see https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-6ED8C4D5 - DOM Level 2 Core specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- */
-export declare function cloneSVGElement(element: Element): Element;
-/**
- * Merges multiple SVG elements into a single SVG element.
- *
- * This function creates a new SVG element and appends clones of the provided elements to it.
- * The SVG namespace is specified as 'http://www.w3.org/2000/svg'.
- *
- * @param {Element[]} elements - An array of SVG elements to merge.
- * @returns {Element} - The merged SVG element.
- *
- * @example
- * const svgElement1 = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
- * const mergedElement = mergeSVGElements([svgElement1, svgElement2]);
- * console.log(mergedElement);
- *
- * @see https://www.w3.org/TR/SVG/ - SVG specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS - createElementNS documentation
- */
-export declare function mergeSVGElements(elements: Element[]): Element;
-/**
- * Converts an SVG element to a Base64-encoded string.
- *
- * This function serializes the SVG element to a string and then encodes it to Base64.
- * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
- *
- * @param {Element} svgElement - The SVG element to convert.
- * @returns {string} - The Base64-encoded string representation of the SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const base64String = convertSVGToBase64(svgElement);
- * console.log(base64String);
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
- */
-export declare function convertSVGToBase64(svgElement: Element): string;
-/**
- * Converts a Base64-encoded string to an SVG string.
- *
- * This function decodes the Base64-encoded string and then converts it to an SVG string.
- * The resulting string can be used to create an SVG element using the `createSVGElement` function.
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- * const base64String = 'data:image/svg+xml;base64, * const base64String = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3
- * const svgString = convertBase64ToSVG(base64String);
- * console.log(svgString);
- */
-export declare function convertBase64ToSVG(base64String: string): string;

package/lib/utils.js

@@ -1,137 +0,0 @@
-"use strict";
-/**
- * @file utils.ts
- * @description This module provides utility functions for working with SVG elements.
- * @module utils
- * @requires jsdom - A JavaScript implementation of the WHATWG DOM and HTML standards.
- * @author pipi
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSVGElement = createSVGElement;
-exports.cloneSVGElement = cloneSVGElement;
-exports.mergeSVGElements = mergeSVGElements;
-exports.convertSVGToBase64 = convertSVGToBase64;
-exports.convertBase64ToSVG = convertBase64ToSVG;
-var jsdom_1 = require("jsdom");
-// Create a virtual DOM environment
-var dom = new jsdom_1.JSDOM("<!DOCTYPE html><html><body></body></html>");
-var document = dom.window.document;
-/**
- * Creates an SVG element from a given element.
- *
- * This function serializes the given element to a string, then parses it back to create an SVG element.
- * This approach ensures that the element is correctly parsed as an SVG element.
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- *
- * @param {Element} element - The element to create an SVG element from.
- * @returns {Element} - The created SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('URL_ADDRESS * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = createSVGElement(svgElement);
- * @param svgContent
- * @returns
- */
-function createSVGElement(svgContent) {
-    var svgElement = new dom.window.DOMParser().parseFromString(svgContent, 'image/svg+xml').documentElement;
-    return svgElement;
-}
-/**
- * Clones an SVG element deeply.
- *
- * This function serializes the given SVG element to a string, then parses it back to create a deep clone.
- * This approach ensures that all attributes and child nodes are duplicated.
- *
- * @param {Element} element - The SVG element to clone.
- * @returns {Element} - The cloned SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const clonedElement = cloneSVGElement(svgElement);
- * console.log(clonedElement);
- *
- * @see https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-6ED8C4D5 - DOM Level 2 Core specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- */
-function cloneSVGElement(element) {
-    var serializer = new dom.window.XMLSerializer();
-    var sourceCode = serializer.serializeToString(element);
-    var parser = new dom.window.DOMParser();
-    var doc = parser.parseFromString(sourceCode, 'image/svg+xml');
-    return doc.documentElement;
-}
-/**
- * Merges multiple SVG elements into a single SVG element.
- *
- * This function creates a new SVG element and appends clones of the provided elements to it.
- * The SVG namespace is specified as 'http://www.w3.org/2000/svg'.
- *
- * @param {Element[]} elements - An array of SVG elements to merge.
- * @returns {Element} - The merged SVG element.
- *
- * @example
- * const svgElement1 = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const svgElement2 = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
- * const mergedElement = mergeSVGElements([svgElement1, svgElement2]);
- * console.log(mergedElement);
- *
- * @see https://www.w3.org/TR/SVG/ - SVG specification
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS - createElementNS documentation
- */
-function mergeSVGElements(elements) {
-    var mergedSVG = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
-    elements.forEach(function (element) {
-        mergedSVG.appendChild(cloneSVGElement(element));
-    });
-    return mergedSVG;
-}
-/**
- * Converts an SVG element to a Base64-encoded string.
- *
- * This function serializes the SVG element to a string and then encodes it to Base64.
- * The resulting string can be used as a data URI for embedding SVG content in HTML or CSS.
- *
- * @param {Element} svgElement - The SVG element to convert.
- * @returns {string} - The Base64-encoded string representation of the SVG element.
- *
- * @example
- * const svgElement = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
- * const base64String = convertSVGToBase64(svgElement);
- * console.log(base64String);
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer - XMLSerializer documentation
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Buffer - Buffer documentation
- */
-function convertSVGToBase64(svgElement) {
-    var serializer = new dom.window.XMLSerializer();
-    var svgString = serializer.serializeToString(svgElement);
-    return "data:image/svg+xml;base64,".concat(Buffer.from(svgString).toString('base64'));
-}
-/**
- * Converts a Base64-encoded string to an SVG string.
- *
- * This function decodes the Base64-encoded string and then converts it to an SVG string.
- * The resulting string can be used to create an SVG element using the `createSVGElement` function.
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- *
- * @param {string} base64String - The Base64-encoded string to convert.
- * @returns {string} - The SVG string representation of the Base64-encoded string.
- *
- * @example
- * const base64String = 'data:image/svg+xml;base64, * const base64String = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3
- * const svgString = convertBase64ToSVG(base64String);
- * console.log(svgString);
- */
-function convertBase64ToSVG(base64String) {
-    var svgString = Buffer.from(base64String.split(',')[1], 'base64').toString('utf-8');
-    return svgString;
-}
-//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA4BH,4CAGC;AAmBD,0CAMC;AAoBD,4CAMC;AAmBD,gDAIC;AAqBD,gDAGC;AA/HD,+BAA8B;AAE9B,mCAAmC;AACnC,IAAM,GAAG,GAAG,IAAI,aAAK,CAAC,2CAA2C,CAAC,CAAC;AAC3D,IAAA,QAAQ,GAAK,GAAG,CAAC,MAAM,SAAf,CAAgB;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,eAAe,CAAC;IAC3G,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,IAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1C,IAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,eAAgB,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,gBAAgB,CAAC,QAAmB;IAClD,IAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,CAAC,UAAC,OAAO;QACvB,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,UAAmB;IACpD,IAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAClD,IAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,oCAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,IAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC"}