svg-toolbox 1.1.11 → 1.2.0

package/lib/optimize/__tests__/cleanup.test.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var cleanup_1 = require("../cleanup");
+var element_1 = require("../../core/element");
+describe('SVG Cleanup', function () {
+    describe('removeEmptyAttributes', function () {
+        it('should remove empty attributes', function () {
+            var svgContent = '<svg><circle cx="50" cy="50" r="" fill="red" stroke="" /></svg>';
+            var result = (0, cleanup_1.removeEmptyAttributes)(svgContent);
+            expect(result).toContain('cx="50"');
+            expect(result).toContain('fill="red"');
+            expect(result).not.toContain('r=""');
+            expect(result).not.toContain('stroke=""');
+        });
+        it('should work with SVG element input', function () {
+            var svgContent = '<svg><rect x="10" y="" width="100" height="50" /></svg>';
+            var element = (0, element_1.createSVGElement)(svgContent);
+            var result = (0, cleanup_1.removeEmptyAttributes)(element);
+            expect(result).toContain('x="10"');
+            expect(result).not.toContain('y=""');
+        });
+    });
+    describe('removeComments', function () {
+        it('should remove HTML comments', function () {
+            var svgContent = '<svg><!-- This is a comment --><circle cx="50" cy="50" r="40" /></svg>';
+            var result = (0, cleanup_1.removeComments)(svgContent);
+            expect(result).not.toContain('<!--');
+            expect(result).not.toContain('-->');
+            expect(result).toContain('circle');
+        });
+        it('should handle multiple comments', function () {
+            var svgContent = '<svg><!-- Comment 1 --><circle /><!-- Comment 2 --></svg>';
+            var result = (0, cleanup_1.removeComments)(svgContent);
+            expect(result).not.toContain('Comment');
+        });
+        it('should handle nested comments correctly', function () {
+            // This tests the incomplete sanitization fix
+            // Input: "<!--<!-- comment -->-->" should become "" not "<!-- comment -->"
+            var svgContent = '<svg><!--<!-- nested comment -->--><circle /></svg>';
+            var result = (0, cleanup_1.removeComments)(svgContent);
+            expect(result).not.toContain('<!--');
+            expect(result).not.toContain('-->');
+            expect(result).not.toContain('nested comment');
+            expect(result).toContain('circle');
+        });
+        it('should handle deeply nested comments', function () {
+            var svgContent = '<svg><!--<!--<!-- triple nested -->-->--><circle /></svg>';
+            var result = (0, cleanup_1.removeComments)(svgContent);
+            expect(result).not.toContain('<!--');
+            expect(result).not.toContain('-->');
+            expect(result).toContain('circle');
+        });
+        it('should throw error for content exceeding maximum length', function () {
+            var largeContent = '<!--' + 'x'.repeat(10000001) + '-->';
+            expect(function () { return (0, cleanup_1.removeComments)(largeContent); }).toThrow('exceeds maximum allowed length');
+        });
+        it('should handle comments with newlines', function () {
+            var svgContent = '<svg><!--\nMulti-line\ncomment\n--><circle /></svg>';
+            var result = (0, cleanup_1.removeComments)(svgContent);
+            expect(result).not.toContain('<!--');
+            expect(result).not.toContain('-->');
+            expect(result).not.toContain('Multi-line');
+            expect(result).toContain('circle');
+        });
+    });
+    describe('normalizeWhitespace', function () {
+        it('should normalize whitespace', function () {
+            var svgContent = '<svg>   <circle   cx="50"   cy="50"   />   </svg>';
+            var result = (0, cleanup_1.normalizeWhitespace)(svgContent);
+            expect(result).toContain('<circle');
+            expect(result).not.toMatch(/\s{2,}/);
+        });
+        it('should remove whitespace between tags', function () {
+            var svgContent = '<svg>\n  <circle />\n  <rect />\n</svg>';
+            var result = (0, cleanup_1.normalizeWhitespace)(svgContent);
+            expect(result).toMatch(/><circle/);
+            expect(result).toMatch(/><rect/);
+        });
+    });
+    describe('optimizeSVG', function () {
+        it('should apply all optimizations', function () {
+            var svgContent = '<svg><!-- Comment --><circle cx="50" cy="" r="40" fill="red" />   </svg>';
+            var result = (0, cleanup_1.optimizeSVG)(svgContent);
+            expect(result).not.toContain('<!--');
+            expect(result).not.toContain('cy=""');
+            expect(result).toContain('circle');
+            expect(result).toContain('fill="red"');
+        });
+        it('should work with SVG element input', function () {
+            var svgContent = '<svg><rect x="10" y="20" width="100" /></svg>';
+            var element = (0, element_1.createSVGElement)(svgContent);
+            var result = (0, cleanup_1.optimizeSVG)(element);
+            expect(result).toContain('rect');
+        });
+    });
+});
+//# sourceMappingURL=cleanup.test.js.map

package/lib/optimize/__tests__/cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.test.js","sourceRoot":"","sources":["../../../src/optimize/__tests__/cleanup.test.ts"],"names":[],"mappings":";;AAAA,sCAAqG;AACrG,8CAAsD;AAEtD,QAAQ,CAAC,aAAa,EAAE;IACtB,QAAQ,CAAC,uBAAuB,EAAE;QAChC,EAAE,CAAC,gCAAgC,EAAE;YACnC,IAAM,UAAU,GAAG,iEAAiE,CAAC;YACrF,IAAM,MAAM,GAAG,IAAA,+BAAqB,EAAC,UAAU,CAAC,CAAC;YAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE;YACvC,IAAM,UAAU,GAAG,yDAAyD,CAAC;YAC7E,IAAM,OAAO,GAAG,IAAA,0BAAgB,EAAC,UAAU,CAAC,CAAC;YAC7C,IAAM,MAAM,GAAG,IAAA,+BAAqB,EAAC,OAAO,CAAC,CAAC;YAE9C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE;QACzB,EAAE,CAAC,6BAA6B,EAAE;YAChC,IAAM,UAAU,GAAG,wEAAwE,CAAC;YAC5F,IAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,UAAU,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE;YACpC,IAAM,UAAU,GAAG,2DAA2D,CAAC;YAC/E,IAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,UAAU,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE;YAC5C,6CAA6C;YAC7C,2EAA2E;YAC3E,IAAM,UAAU,GAAG,qDAAqD,CAAC;YACzE,IAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,UAAU,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE;YACzC,IAAM,UAAU,GAAG,2DAA2D,CAAC;YAC/E,IAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,UAAU,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE;YAC5D,IAAM,YAAY,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YAC3D,MAAM,CAAC,cAAM,OAAA,IAAA,wBAAc,EAAC,YAAY,CAAC,EAA5B,CAA4B,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE;YACzC,IAAM,UAAU,GAAG,qDAAqD,CAAC;YACzE,IAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,UAAU,CAAC,CAAC;YAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE;QAC9B,EAAE,CAAC,6BAA6B,EAAE;YAChC,IAAM,UAAU,GAAG,mDAAmD,CAAC;YACvE,IAAM,MAAM,GAAG,IAAA,6BAAmB,EAAC,UAAU,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE;YAC1C,IAAM,UAAU,GAAG,yCAAyC,CAAC;YAC7D,IAAM,MAAM,GAAG,IAAA,6BAAmB,EAAC,UAAU,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE;QACtB,EAAE,CAAC,gCAAgC,EAAE;YACnC,IAAM,UAAU,GAAG,0EAA0E,CAAC;YAC9F,IAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,UAAU,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE;YACvC,IAAM,UAAU,GAAG,+CAA+C,CAAC;YACnE,IAAM,OAAO,GAAG,IAAA,0BAAgB,EAAC,UAAU,CAAC,CAAC;YAC7C,IAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,OAAO,CAAC,CAAC;YAEpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/optimize/__tests__/path.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/optimize/__tests__/path.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var path_1 = require("../path");
+describe('Path Optimization', function () {
+    describe('removeNanCoordinates', function () {
+        it('should remove NaN values from path data', function () {
+            var svgContent = '<svg><path d="M 10,20 nan L 30,40 -nan Z" /></svg>';
+            var result = (0, path_1.removeNanCoordinates)(svgContent);
+            expect(result).not.toContain('nan');
+            expect(result).not.toContain('-nan');
+            expect(result).toContain('path');
+        });
+        it('should preserve valid path commands', function () {
+            var svgContent = '<svg><path d="M 10,20 L 30,40 Z" /></svg>';
+            var result = (0, path_1.removeNanCoordinates)(svgContent);
+            expect(result).toContain('M10');
+            expect(result).toContain('20');
+            expect(result).toContain('L30');
+            expect(result).toContain('40');
+            expect(result).toContain('Z');
+        });
+        it('should handle multiple paths', function () {
+            var svgContent = '<svg><path d="M 10,20 nan L 30,40" /><path d="M 50,60 L 70,80" /></svg>';
+            var result = (0, path_1.removeNanCoordinates)(svgContent);
+            expect(result).not.toContain('nan');
+            expect(result.split('path').length - 1).toBe(2);
+        });
+        it('should handle paths without d attribute', function () {
+            var svgContent = '<svg><path /><path d="M 10,20 L 30,40" /></svg>';
+            var result = (0, path_1.removeNanCoordinates)(svgContent);
+            expect(result).toContain('path');
+        });
+        it('should throw error if no SVG element found', function () {
+            expect(function () { return (0, path_1.removeNanCoordinates)('<div></div>'); }).toThrow('No SVG element found');
+        });
+        it('should handle case-insensitive NaN', function () {
+            var svgContent = '<svg><path d="M 10,20 NaN L 30,40 NAN Z" /></svg>';
+            var result = (0, path_1.removeNanCoordinates)(svgContent);
+            expect(result.toLowerCase()).not.toContain('nan');
+        });
+    });
+});
+//# sourceMappingURL=path.test.js.map

package/lib/optimize/__tests__/path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.test.js","sourceRoot":"","sources":["../../../src/optimize/__tests__/path.test.ts"],"names":[],"mappings":";;AAAA,gCAA+C;AAE/C,QAAQ,CAAC,mBAAmB,EAAE;IAC5B,QAAQ,CAAC,sBAAsB,EAAE;QAC/B,EAAE,CAAC,yCAAyC,EAAE;YAC5C,IAAM,UAAU,GAAG,oDAAoD,CAAC;YACxE,IAAM,MAAM,GAAG,IAAA,2BAAoB,EAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE;YACxC,IAAM,UAAU,GAAG,2CAA2C,CAAC;YAC/D,IAAM,MAAM,GAAG,IAAA,2BAAoB,EAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE;YACjC,IAAM,UAAU,GAAG,yEAAyE,CAAC;YAC7F,IAAM,MAAM,GAAG,IAAA,2BAAoB,EAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE;YAC5C,IAAM,UAAU,GAAG,iDAAiD,CAAC;YACrE,IAAM,MAAM,GAAG,IAAA,2BAAoB,EAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE;YAC/C,MAAM,CAAC,cAAM,OAAA,IAAA,2BAAoB,EAAC,aAAa,CAAC,EAAnC,CAAmC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE;YACvC,IAAM,UAAU,GAAG,mDAAmD,CAAC;YACvE,IAAM,MAAM,GAAG,IAAA,2BAAoB,EAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/optimize/cleanup.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SVG cleanup and optimization utilities
+ */
+/**
+ * Removes empty attributes from SVG elements
+ */
+export declare function removeEmptyAttributes(svgContent: Element | string): string;
+/**
+ * Removes comments from SVG content
+ *
+ * This function uses iterative replacement to handle nested comments correctly
+ * and includes input length validation to prevent ReDoS attacks.
+ *
+ * The function handles cases like:
+ * - Simple comments: <!-- comment -->
+ * - Nested comments: <!--<!-- inner -->-->
+ * - Multiple comments: <!-- one --><!-- two -->
+ */
+export declare function removeComments(svgContent: string): string;
+/**
+ * Normalizes whitespace in SVG content
+ */
+export declare function normalizeWhitespace(svgContent: string): string;
+/**
+ * Optimizes SVG by removing empty attributes, comments, and normalizing whitespace
+ */
+export declare function optimizeSVG(svgContent: Element | string): string;

package/lib/optimize/cleanup.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * SVG cleanup and optimization utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeEmptyAttributes = removeEmptyAttributes;
+exports.removeComments = removeComments;
+exports.normalizeWhitespace = normalizeWhitespace;
+exports.optimizeSVG = optimizeSVG;
+var jsdom_1 = require("jsdom");
+var element_1 = require("../core/element");
+var validation_1 = require("../utils/validation");
+/**
+ * Removes empty attributes from SVG elements
+ */
+function removeEmptyAttributes(svgContent) {
+    var svgString = (0, validation_1.isValidSvgString)(svgContent)
+        ? svgContent
+        : (0, element_1.serializeSVG)(svgContent);
+    var dom = new jsdom_1.JSDOM(svgString, {
+        contentType: 'image/svg+xml'
+    });
+    var document = dom.window.document;
+    var svgElement = document.querySelector('svg');
+    if (!svgElement) {
+        throw new Error('No SVG element found in the provided content.');
+    }
+    function removeEmptyAttrs(element) {
+        var attrs = Array.from(element.attributes);
+        attrs.forEach(function (attr) {
+            if (!attr.value || attr.value.trim() === '') {
+                element.removeAttribute(attr.name);
+            }
+        });
+        Array.from(element.children).forEach(function (child) {
+            removeEmptyAttrs(child);
+        });
+    }
+    removeEmptyAttrs(svgElement);
+    return svgElement.outerHTML.trim();
+}
+/**
+ * Maximum allowed SVG content length to prevent ReDoS attacks
+ */
+var MAX_SVG_CONTENT_LENGTH = 10000000; // 10MB should be sufficient for most SVG files
+/**
+ * Removes comments from SVG content
+ *
+ * This function uses iterative replacement to handle nested comments correctly
+ * and includes input length validation to prevent ReDoS attacks.
+ *
+ * The function handles cases like:
+ * - Simple comments: <!-- comment -->
+ * - Nested comments: <!--<!-- inner -->-->
+ * - Multiple comments: <!-- one --><!-- two -->
+ */
+function removeComments(svgContent) {
+    // Validate input length to prevent ReDoS attacks
+    if (svgContent.length > MAX_SVG_CONTENT_LENGTH) {
+        throw new Error("SVG content length exceeds maximum allowed length of ".concat(MAX_SVG_CONTENT_LENGTH, " characters"));
+    }
+    // Use iterative replacement to handle nested comments
+    // This prevents incomplete sanitization where nested comments could reappear
+    // Example: "<!--<!-- comment -->-->" should become "" not "<!-- comment -->"
+    var previous;
+    var result = svgContent;
+    var iterations = 0;
+    var MAX_ITERATIONS = 1000; // Prevent infinite loops
+    do {
+        previous = result;
+        // Match HTML comments and standalone delimiters:
+        // - Full comments: <!-- ... --> or <!-- ... --!>
+        // - Orphaned starts: <!--
+        // - Orphaned ends: --> or --!>
+        // The regex uses non-greedy matching (*?) to match the shortest possible comment
+        // and is applied iteratively until no further matches remain.
+        result = result.replace(/<!--[\s\S]*?--!?>|<!--|--!?>(?=[^>]|$)/g, '');
+        iterations++;
+        if (iterations > MAX_ITERATIONS) {
+            throw new Error('Comment removal exceeded maximum iterations. SVG content may be malformed.');
+        }
+    } while (result !== previous);
+    return result;
+}
+/**
+ * Normalizes whitespace in SVG content
+ */
+function normalizeWhitespace(svgContent) {
+    return svgContent
+        .replace(/\s+/g, ' ')
+        .replace(/>\s+</g, '><')
+        .trim();
+}
+/**
+ * Optimizes SVG by removing empty attributes, comments, and normalizing whitespace
+ */
+function optimizeSVG(svgContent) {
+    var svgString = (0, validation_1.isValidSvgString)(svgContent)
+        ? svgContent
+        : (0, element_1.serializeSVG)(svgContent);
+    svgString = removeComments(svgString);
+    svgString = removeEmptyAttributes(svgString);
+    svgString = normalizeWhitespace(svgString);
+    return svgString;
+}
+//# sourceMappingURL=cleanup.js.map

package/lib/optimize/cleanup.js.map

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

package/lib/optimize/path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SVG path optimization utilities
+ */
+/**
+ * Removes NaN and invalid coordinates from SVG path elements
+ */
+export declare function removeNanCoordinates(svgContent: string): string;

package/lib/optimize/path.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * SVG path optimization utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeNanCoordinates = removeNanCoordinates;
+var jsdom_1 = require("jsdom");
+var PATH_COMMANDS_WITHOUT_PARAMS = ['z', 'Z'];
+/**
+ * Removes NaN and invalid coordinates from SVG path elements
+ */
+function removeNanCoordinates(svgContent) {
+    var dom = new jsdom_1.JSDOM(svgContent, {
+        contentType: 'image/svg+xml'
+    });
+    var document = dom.window.document;
+    var svgElement = document.querySelector('svg');
+    if (!svgElement) {
+        throw new Error('No SVG element found in the provided content.');
+    }
+    var paths = svgElement.querySelectorAll('path');
+    Array.from(paths).forEach(function (path) {
+        var d = path.getAttribute('d');
+        if (d === null) {
+            return;
+        }
+        // Remove NaN values and split into commands
+        var commands = d
+            .replace(/nan|-nan/gi, ' ')
+            .split(/(?=[MmLlHhVvCcSsQqTtAaZz])/)
+            .map(function (command) {
+            var type = command[0];
+            var isCommandWithoutParams = PATH_COMMANDS_WITHOUT_PARAMS.includes(type);
+            if (!isCommandWithoutParams) {
+                var params = command
+                    .slice(1)
+                    .split(/[\s,]+/)
+                    .filter(function (param) { return param.trim() !== ''; })
+                    .map(Number);
+                // Check if all parameters are valid numbers
+                var allValid = params.every(function (param) { return !isNaN(param) && isFinite(param); });
+                if (allValid && params.length > 0) {
+                    return { type: type, params: params };
+                }
+            }
+            else {
+                return { type: type, params: [] };
+            }
+            return null;
+        })
+            .filter(function (item) { return item !== null; })
+            .filter(function (command) {
+            return PATH_COMMANDS_WITHOUT_PARAMS.includes(command.type) || command.params.length > 0;
+        });
+        // Reconstruct the 'd' attribute
+        var modifiedD = commands
+            .map(function (command) { return command.type + command.params.join(' '); })
+            .join('');
+        path.setAttribute('d', modifiedD);
+    });
+    return svgElement.outerHTML.trim();
+}
+//# sourceMappingURL=path.js.map

package/lib/optimize/path.js.map

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

package/lib/types/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type definitions for SVG Toolbox
+ */
+export interface SVGDimensions {
+    width: number;
+    height: number;
+    viewBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface DiffResult {
+    diffPngBuffer: Buffer;
+    numDiffPixels: number;
+}
+export interface ConversionOptions {
+    scale?: number;
+    format?: 'png' | 'jpg' | 'jpeg' | 'webp';
+    quality?: number;
+}
+export interface PathCommand {
+    type: string;
+    params: number[];
+}
+export interface SVGColor {
+    fill?: string;
+    stroke?: string;
+    opacity?: number;
+}

package/lib/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for SVG Toolbox
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/lib/utils/__tests__/path-validation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/__tests__/path-validation.test.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var path_validation_1 = require("../path-validation");
+var path_1 = __importDefault(require("path"));
+var fs_1 = __importDefault(require("fs"));
+var os_1 = __importDefault(require("os"));
+describe('Path Validation', function () {
+    var tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'svg-toolbox-test-'));
+    afterAll(function () {
+        fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe('validateFilePath', function () {
+        it('should normalize valid paths', function () {
+            var result = (0, path_validation_1.validateFilePath)('./test.svg');
+            expect(path_1.default.isAbsolute(result)).toBe(true);
+        });
+        it('should reject paths with .. traversal', function () {
+            expect(function () { return (0, path_validation_1.validateFilePath)('../etc/passwd'); }).toThrow('Path traversal detected');
+            expect(function () { return (0, path_validation_1.validateFilePath)('../../secret'); }).toThrow('Path traversal detected');
+        });
+        it('should reject empty paths', function () {
+            expect(function () { return (0, path_validation_1.validateFilePath)(''); }).toThrow('File path must be a non-empty string');
+            expect(function () { return (0, path_validation_1.validateFilePath)(null); }).toThrow('File path must be a non-empty string');
+        });
+        it('should restrict paths to base directory when provided', function () {
+            var baseDir = tempDir;
+            var validPath = path_1.default.join(baseDir, 'test.svg');
+            expect(function () { return (0, path_validation_1.validateFilePath)(validPath, baseDir); }).not.toThrow();
+            expect(function () { return (0, path_validation_1.validateFilePath)('/etc/passwd', baseDir); }).toThrow('Path is outside the allowed directory');
+        });
+    });
+    describe('validateReadPath', function () {
+        it('should validate file extensions', function () {
+            expect(function () { return (0, path_validation_1.validateReadPath)('test.svg', ['.svg']); }).not.toThrow();
+            expect(function () { return (0, path_validation_1.validateReadPath)('test.png', ['.svg']); }).toThrow('File extension .png is not allowed');
+        });
+        it('should accept multiple allowed extensions', function () {
+            expect(function () { return (0, path_validation_1.validateReadPath)('test.svg', ['.svg', '.png']); }).not.toThrow();
+            expect(function () { return (0, path_validation_1.validateReadPath)('test.png', ['.svg', '.png']); }).not.toThrow();
+        });
+        it('should be case-insensitive for extensions', function () {
+            expect(function () { return (0, path_validation_1.validateReadPath)('test.SVG', ['.svg']); }).not.toThrow();
+        });
+    });
+    describe('validateWritePath', function () {
+        it('should validate file extensions', function () {
+            var writePath = path_1.default.join(tempDir, 'test.png');
+            expect(function () { return (0, path_validation_1.validateWritePath)(writePath, ['.png']); }).not.toThrow();
+            expect(function () { return (0, path_validation_1.validateWritePath)(writePath, ['.svg']); }).toThrow('File extension .png is not allowed');
+        });
+        it('should create directory if it does not exist', function () {
+            var newDir = path_1.default.join(tempDir, 'new-dir');
+            var writePath = path_1.default.join(newDir, 'test.png');
+            expect(fs_1.default.existsSync(newDir)).toBe(false);
+            (0, path_validation_1.validateWritePath)(writePath, ['.png']);
+            expect(fs_1.default.existsSync(newDir)).toBe(true);
+        });
+        it('should restrict writes to base directory when provided', function () {
+            var baseDir = tempDir;
+            var validPath = path_1.default.join(baseDir, 'test.png');
+            expect(function () { return (0, path_validation_1.validateWritePath)(validPath, ['.png'], baseDir); }).not.toThrow();
+            expect(function () { return (0, path_validation_1.validateWritePath)('/tmp/test.png', ['.png'], baseDir); }).toThrow('Path is outside the allowed directory');
+        });
+    });
+});
+//# sourceMappingURL=path-validation.test.js.map

package/lib/utils/__tests__/path-validation.test.js.map

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

package/lib/utils/__tests__/validation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/__tests__/validation.test.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var validation_1 = require("../validation");
+var element_1 = require("../../core/element");
+describe('Validation', function () {
+    describe('isValidSvgString', function () {
+        it('should return true for valid SVG string', function () {
+            var svgString = '<svg><circle cx="50" cy="50" r="40" /></svg>';
+            expect((0, validation_1.isValidSvgString)(svgString)).toBe(true);
+        });
+        it('should return false for non-string input', function () {
+            expect((0, validation_1.isValidSvgString)(null)).toBe(false);
+            expect((0, validation_1.isValidSvgString)(123)).toBe(false);
+            expect((0, validation_1.isValidSvgString)({})).toBe(false);
+        });
+        it('should return false for invalid SVG string', function () {
+            expect((0, validation_1.isValidSvgString)('<div></div>')).toBe(false);
+            expect((0, validation_1.isValidSvgString)('not svg')).toBe(false);
+            expect((0, validation_1.isValidSvgString)('')).toBe(false);
+        });
+        it('should handle malformed XML', function () {
+            expect((0, validation_1.isValidSvgString)('<svg><unclosed></svg>')).toBe(false);
+        });
+    });
+    describe('isValidSvgElement', function () {
+        it('should return true for valid SVG element', function () {
+            var svgString = '<svg><circle /></svg>';
+            var element = (0, element_1.createSVGElement)(svgString);
+            expect((0, validation_1.isValidSvgElement)(element)).toBe(true);
+        });
+        it('should return false for non-element input', function () {
+            expect((0, validation_1.isValidSvgElement)(null)).toBe(false);
+            expect((0, validation_1.isValidSvgElement)('string')).toBe(false);
+            expect((0, validation_1.isValidSvgElement)({})).toBe(false);
+        });
+        it('should return false for non-SVG element', function () {
+            var JSDOM = require('jsdom').JSDOM;
+            var dom = new JSDOM("<!DOCTYPE html><html><body><div></div></body></html>");
+            var div = dom.window.document.querySelector('div');
+            expect((0, validation_1.isValidSvgElement)(div)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/lib/utils/__tests__/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/validation.test.ts"],"names":[],"mappings":";;AAAA,4CAAoE;AACpE,8CAAsD;AAEtD,QAAQ,CAAC,YAAY,EAAE;IACrB,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,EAAE,CAAC,yCAAyC,EAAE;YAC5C,IAAM,SAAS,GAAG,8CAA8C,CAAC;YACjE,MAAM,CAAC,IAAA,6BAAgB,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE;YAC7C,MAAM,CAAC,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAA,6BAAgB,EAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAA,6BAAgB,EAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE;YAC/C,MAAM,CAAC,IAAA,6BAAgB,EAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,MAAM,CAAC,IAAA,6BAAgB,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,CAAC,IAAA,6BAAgB,EAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE;YAChC,MAAM,CAAC,IAAA,6BAAgB,EAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE;QAC5B,EAAE,CAAC,0CAA0C,EAAE;YAC7C,IAAM,SAAS,GAAG,uBAAuB,CAAC;YAC1C,IAAM,OAAO,GAAG,IAAA,0BAAgB,EAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE;YAC9C,MAAM,CAAC,IAAA,8BAAiB,EAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAA,8BAAiB,EAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,CAAC,IAAA,8BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE;YACpC,IAAA,KAAK,GAAK,OAAO,CAAC,OAAO,CAAC,MAArB,CAAsB;YACnC,IAAM,GAAG,GAAG,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC9E,IAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAErD,MAAM,CAAC,IAAA,8BAAiB,EAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/utils/dom.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DOM utility functions for SVG manipulation
+ */
+export declare const document: Document;
+export declare const DOMParser: {
+    new (): DOMParser;
+    prototype: DOMParser;
+}, XMLSerializer: {
+    new (): XMLSerializer;
+    prototype: XMLSerializer;
+};
+/**
+ * Creates a new DOM parser instance
+ */
+export declare function createDOMParser(): DOMParser;
+/**
+ * Creates a new XML serializer instance
+ */
+export declare function createXMLSerializer(): XMLSerializer;
+/**
+ * Gets the SVG namespace URI
+ */
+export declare const SVG_NAMESPACE = "http://www.w3.org/2000/svg";

package/lib/utils/dom.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * DOM utility functions for SVG manipulation
+ */
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SVG_NAMESPACE = exports.XMLSerializer = exports.DOMParser = exports.document = void 0;
+exports.createDOMParser = createDOMParser;
+exports.createXMLSerializer = createXMLSerializer;
+var jsdom_1 = require("jsdom");
+// Create a singleton virtual DOM environment
+var dom = new jsdom_1.JSDOM("<!DOCTYPE html><html><body></body></html>");
+exports.document = dom.window.document;
+exports.DOMParser = (_a = dom.window, _a.DOMParser), exports.XMLSerializer = _a.XMLSerializer;
+/**
+ * Creates a new DOM parser instance
+ */
+function createDOMParser() {
+    return new dom.window.DOMParser();
+}
+/**
+ * Creates a new XML serializer instance
+ */
+function createXMLSerializer() {
+    return new dom.window.XMLSerializer();
+}
+/**
+ * Gets the SVG namespace URI
+ */
+exports.SVG_NAMESPACE = 'http://www.w3.org/2000/svg';
+//# sourceMappingURL=dom.js.map

package/lib/utils/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;AAYH,0CAEC;AAKD,kDAEC;AAnBD,+BAA8B;AAE9B,6CAA6C;AAC7C,IAAM,GAAG,GAAG,IAAI,aAAK,CAAC,2CAA2C,CAAC,CAAC;AACpD,QAAA,QAAQ,GAAK,GAAG,CAAC,MAAM,UAAC;AACxB,QAAA,SAAS,IAAX,KAA+B,GAAG,CAAC,MAAM,iBAA5B,QAAA,aAAa,oBAAgB;AAEvD;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACU,QAAA,aAAa,GAAG,4BAA4B,CAAC"}