svg-toolbox 1.1.11 → 1.2.0

package/lib/analyze/paths.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * SVG path analysis utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePathData = parsePathData;
+exports.analyzePaths = analyzePaths;
+exports.getPathStatistics = getPathStatistics;
+var jsdom_1 = require("jsdom");
+var element_1 = require("../core/element");
+var validation_1 = require("../utils/validation");
+/**
+ * Maximum allowed path data length to prevent ReDoS attacks
+ */
+var MAX_PATH_DATA_LENGTH = 100000; // 100KB should be sufficient for most SVG paths
+/**
+ * Parses the 'd' attribute of a path element into command objects
+ */
+function parsePathData(pathData) {
+    // Validate input length to prevent ReDoS attacks
+    if (pathData.length > MAX_PATH_DATA_LENGTH) {
+        throw new Error("Path data length exceeds maximum allowed length of ".concat(MAX_PATH_DATA_LENGTH, " characters"));
+    }
+    var commands = [];
+    // Split by path commands (M, L, H, V, C, S, Q, T, A, Z)
+    var commandRegex = /([MmLlHhVvCcSsQqTtAaZz])((?:\s*-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\s*,?\s*)*)/g;
+    var match;
+    var iterations = 0;
+    var MAX_ITERATIONS = 10000; // Prevent infinite loops
+    while ((match = commandRegex.exec(pathData)) !== null) {
+        iterations++;
+        if (iterations > MAX_ITERATIONS) {
+            throw new Error('Path parsing exceeded maximum iterations. Path data may be malformed.');
+        }
+        var type = match[1];
+        var paramsStr = match[2].trim();
+        if (type.toLowerCase() === 'z') {
+            commands.push({ type: type, params: [] });
+        }
+        else if (paramsStr) {
+            var params = paramsStr
+                .split(/[\s,]+/)
+                .filter(function (p) { return p.trim() !== ''; })
+                .map(Number)
+                .filter(function (n) { return !isNaN(n); });
+            commands.push({ type: type, params: params });
+        }
+    }
+    return commands;
+}
+/**
+ * Analyzes all paths in an SVG and returns their command structures
+ */
+function analyzePaths(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.');
+    }
+    var paths = svgElement.querySelectorAll('path');
+    var pathAnalysis = new Map();
+    Array.from(paths).forEach(function (path, index) {
+        var d = path.getAttribute('d');
+        if (d) {
+            var id = path.getAttribute('id') || "path-".concat(index);
+            pathAnalysis.set(id, parsePathData(d));
+        }
+    });
+    return pathAnalysis;
+}
+/**
+ * Gets statistics about paths in an SVG
+ */
+function getPathStatistics(svgContent) {
+    var pathAnalysis = analyzePaths(svgContent);
+    var totalCommands = 0;
+    var commandTypes = {};
+    pathAnalysis.forEach(function (commands) {
+        totalCommands += commands.length;
+        commands.forEach(function (cmd) {
+            var type = cmd.type.toUpperCase();
+            commandTypes[type] = (commandTypes[type] || 0) + 1;
+        });
+    });
+    return {
+        totalPaths: pathAnalysis.size,
+        totalCommands: totalCommands,
+        commandTypes: commandTypes
+    };
+}
+//# sourceMappingURL=paths.js.map

package/lib/analyze/paths.js.map

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

package/lib/compare/__tests__/diff.test.d.ts

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

package/lib/compare/__tests__/diff.test.js

@@ -0,0 +1,128 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var diff_1 = require("../diff");
+var fs_1 = __importDefault(require("fs"));
+var path_1 = __importDefault(require("path"));
+describe('Image Diff', function () {
+    var fixturesDir = path_1.default.join(__dirname, '../../../test-fixtures');
+    var test1Path = path_1.default.join(fixturesDir, 'test1.svg');
+    var test2Path = path_1.default.join(fixturesDir, 'test2.svg');
+    var outputDir = path_1.default.join(fixturesDir, 'diff-output');
+    var diffImagePath = path_1.default.join(outputDir, 'diff-test1-test2.png');
+    beforeAll(function () {
+        // Ensure output directory exists
+        if (!fs_1.default.existsSync(outputDir)) {
+            fs_1.default.mkdirSync(outputDir, { recursive: true });
+        }
+    });
+    afterAll(function () {
+        // Clean up: optionally remove the diff image after tests
+        // Uncomment the following line if you want to clean up after tests
+        // if (fs.existsSync(diffImagePath)) {
+        //   fs.unlinkSync(diffImagePath);
+        // }
+    });
+    it('should generate diff image between two similar but different SVGs', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var result, savedFile;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    // Verify test fixtures exist
+                    expect(fs_1.default.existsSync(test1Path)).toBe(true);
+                    expect(fs_1.default.existsSync(test2Path)).toBe(true);
+                    return [4 /*yield*/, (0, diff_1.diffImages)(test1Path, test2Path, diffImagePath, 0.1)];
+                case 1:
+                    result = _a.sent();
+                    // Verify diff image was created
+                    expect(fs_1.default.existsSync(diffImagePath)).toBe(true);
+                    // Verify result contains expected properties
+                    expect(result).toHaveProperty('diffPngBuffer');
+                    expect(result).toHaveProperty('numDiffPixels');
+                    expect(result.diffPngBuffer).toBeInstanceOf(Buffer);
+                    expect(typeof result.numDiffPixels).toBe('number');
+                    // Since the SVGs are different, there should be some differences
+                    expect(result.numDiffPixels).toBeGreaterThan(0);
+                    savedFile = fs_1.default.readFileSync(diffImagePath);
+                    expect(savedFile.equals(result.diffPngBuffer)).toBe(true);
+                    // Verify file size is reasonable (not empty)
+                    expect(savedFile.length).toBeGreaterThan(0);
+                    console.log("Diff image saved to: ".concat(diffImagePath));
+                    console.log("Number of different pixels: ".concat(result.numDiffPixels));
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should handle identical SVGs (no differences)', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var identicalDiffPath, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    identicalDiffPath = path_1.default.join(outputDir, 'diff-identical.png');
+                    return [4 /*yield*/, (0, diff_1.diffImages)(test1Path, test1Path, identicalDiffPath, 0.1)];
+                case 1:
+                    result = _a.sent();
+                    // Should have no differences
+                    expect(result.numDiffPixels).toBe(0);
+                    expect(fs_1.default.existsSync(identicalDiffPath)).toBe(true);
+                    console.log("Identical comparison diff saved to: ".concat(identicalDiffPath));
+                    console.log("Number of different pixels: ".concat(result.numDiffPixels));
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('should generate diff without saving to file', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, diff_1.diffImages)(test1Path, test2Path, undefined, 0.1)];
+                case 1:
+                    result = _a.sent();
+                    // Should still return result even without file path
+                    expect(result).toHaveProperty('diffPngBuffer');
+                    expect(result).toHaveProperty('numDiffPixels');
+                    expect(result.numDiffPixels).toBeGreaterThan(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=diff.test.js.map

package/lib/compare/__tests__/diff.test.js.map

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

package/lib/compare/diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Image comparison and diff utilities
+ */
+import { DiffResult } from '../types';
+/**
+ * Compares two PNG images at the pixel level and generates a diff image
+ */
+export declare function pixelLevelDiff(pngA: Buffer, pngB: Buffer, threshold?: number): DiffResult;
+/**
+ * Compares two image files (SVG or PNG) and generates a diff image
+ */
+export declare function diffImages(pathA: string, pathB: string, diffFilePath?: string, threshold?: number): Promise<DiffResult>;
+/**
+ * Legacy function name for diffImages
+ *
+ * @deprecated Use diffImages instead
+ */
+export declare function diffSvg(pathA: string, pathB: string, diffFilePath: string): Promise<DiffResult | void>;

package/lib/compare/diff.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Image comparison and diff utilities
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pixelLevelDiff = pixelLevelDiff;
+exports.diffImages = diffImages;
+exports.diffSvg = diffSvg;
+var fs_1 = __importDefault(require("fs"));
+var path_1 = __importDefault(require("path"));
+var sharp_1 = __importDefault(require("sharp"));
+var pngjs_1 = require("pngjs");
+var pixelmatch_1 = __importDefault(require("pixelmatch"));
+var path_validation_1 = require("../utils/path-validation");
+/**
+ * Compares two PNG images at the pixel level and generates a diff image
+ */
+function pixelLevelDiff(pngA, pngB, threshold) {
+    if (threshold === void 0) { threshold = 0.1; }
+    var img1 = pngjs_1.PNG.sync.read(pngA);
+    var img2 = pngjs_1.PNG.sync.read(pngB);
+    var width = img1.width, height = img1.height;
+    if (img2.width !== width || img2.height !== height) {
+        throw new Error('Images must have the same dimensions');
+    }
+    var diff = new pngjs_1.PNG({ width: width, height: height });
+    var numDiffPixels = (0, pixelmatch_1.default)(img1.data, img2.data, diff.data, width, height, { threshold: threshold });
+    var diffPngBuffer = pngjs_1.PNG.sync.write(diff);
+    return {
+        diffPngBuffer: diffPngBuffer,
+        numDiffPixels: numDiffPixels
+    };
+}
+/**
+ * Compares two image files (SVG or PNG) and generates a diff image
+ */
+function diffImages(pathA_1, pathB_1, diffFilePath_1) {
+    return __awaiter(this, arguments, void 0, function (pathA, pathB, diffFilePath, threshold) {
+        var validatedPathA, validatedPathB, pngA, pngB, result, ext, validatedWritePath;
+        if (threshold === void 0) { threshold = 0.1; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    validatedPathA = (0, path_validation_1.validateReadPath)(pathA, ['.svg', '.png', '.jpg', '.jpeg', '.webp']);
+                    validatedPathB = (0, path_validation_1.validateReadPath)(pathB, ['.svg', '.png', '.jpg', '.jpeg', '.webp']);
+                    if (!fs_1.default.existsSync(validatedPathA)) {
+                        throw new Error("File not found: ".concat(validatedPathA));
+                    }
+                    if (!fs_1.default.existsSync(validatedPathB)) {
+                        throw new Error("File not found: ".concat(validatedPathB));
+                    }
+                    return [4 /*yield*/, (0, sharp_1.default)(validatedPathA).png().toBuffer()];
+                case 1:
+                    pngA = _a.sent();
+                    return [4 /*yield*/, (0, sharp_1.default)(validatedPathB).png().toBuffer()];
+                case 2:
+                    pngB = _a.sent();
+                    result = pixelLevelDiff(pngA, pngB, threshold);
+                    if (diffFilePath) {
+                        ext = path_1.default.extname(diffFilePath);
+                        if (!ext) {
+                            throw new Error('Diff file path must have a file extension');
+                        }
+                        validatedWritePath = (0, path_validation_1.validateWritePath)(diffFilePath, ['.png']);
+                        fs_1.default.writeFileSync(validatedWritePath, result.diffPngBuffer);
+                    }
+                    return [2 /*return*/, result];
+            }
+        });
+    });
+}
+/**
+ * Legacy function name for diffImages
+ *
+ * @deprecated Use diffImages instead
+ */
+function diffSvg(pathA, pathB, diffFilePath) {
+    return __awaiter(this, void 0, void 0, function () {
+        var error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, diffImages(pathA, pathB, diffFilePath)];
+                case 1: return [2 /*return*/, _a.sent()];
+                case 2:
+                    error_1 = _a.sent();
+                    console.error("Error comparing images: ".concat(error_1 instanceof Error ? error_1.message : String(error_1)));
+                    return [2 /*return*/];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+//# sourceMappingURL=diff.js.map

package/lib/compare/diff.js.map

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

package/lib/convert/__tests__/base64.test.d.ts

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

package/lib/convert/__tests__/base64.test.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var base64_3 = require("../base64");
+var element_1 = require("../../core/element");
+describe('Base64 Conversion', function () {
+    var testSvg = '<svg viewBox="0 0 100 100"><circle cx="50" cy="50" r="40" /></svg>';
+    describe('convertSVGToBase64', function () {
+        it('should convert SVG string to base64 data URI', function () {
+            var base64 = (0, base64_3.convertSVGToBase64)(testSvg);
+            expect(base64).toMatch(/^data:image\/svg\+xml;base64,/);
+            expect(base64.length).toBeGreaterThan(50);
+        });
+        it('should convert SVG element to base64 data URI', function () {
+            var element = (0, element_1.createSVGElement)(testSvg);
+            var base64 = (0, base64_3.convertSVGToBase64)(element);
+            expect(base64).toMatch(/^data:image\/svg\+xml;base64,/);
+        });
+        it('should produce consistent results for same input', function () {
+            var base64_1 = (0, base64_3.convertSVGToBase64)(testSvg);
+            var base64_2 = (0, base64_3.convertSVGToBase64)(testSvg);
+            expect(base64_1).toBe(base64_2);
+        });
+    });
+    describe('convertBase64ToSVG', function () {
+        it('should convert base64 data URI back to SVG string', function () {
+            var base64 = (0, base64_3.convertSVGToBase64)(testSvg);
+            var svgString = (0, base64_3.convertBase64ToSVG)(base64);
+            expect(svgString).toContain('<svg');
+            expect(svgString).toContain('circle');
+        });
+        it('should handle base64 string without data URI prefix', function () {
+            var base64 = (0, base64_3.convertSVGToBase64)(testSvg);
+            var base64Only = base64.split(',')[1];
+            var svgString = (0, base64_3.convertBase64ToSVG)(base64Only);
+            expect(svgString).toContain('<svg');
+        });
+        it('should throw error for invalid base64 string', function () {
+            expect(function () { return (0, base64_3.convertBase64ToSVG)('invalid-base64!!!'); }).toThrow('Invalid Base64 string');
+        });
+        it('should round-trip correctly', function () {
+            var original = testSvg;
+            var base64 = (0, base64_3.convertSVGToBase64)(original);
+            var converted = (0, base64_3.convertBase64ToSVG)(base64);
+            // Remove whitespace differences for comparison
+            var normalize = function (s) { return s.replace(/\s+/g, ' ').trim(); };
+            expect(normalize(converted)).toContain('<svg');
+            expect(normalize(converted)).toContain('circle');
+        });
+    });
+});
+//# sourceMappingURL=base64.test.js.map

package/lib/convert/__tests__/base64.test.js.map

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

package/lib/convert/base64.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Base64 encoding/decoding utilities for SVG
+ */
+/**
+ * Converts an SVG element or SVG string to a Base64-encoded data URI
+ */
+export declare function convertSVGToBase64(svgContent: Element | string): string;
+/**
+ * Converts a Base64-encoded data URI back to an SVG string
+ */
+export declare function convertBase64ToSVG(base64String: string): string;

package/lib/convert/base64.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Base64 encoding/decoding utilities for SVG
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertSVGToBase64 = convertSVGToBase64;
+exports.convertBase64ToSVG = convertBase64ToSVG;
+var element_1 = require("../core/element");
+/**
+ * Converts an SVG element or SVG string to a Base64-encoded data URI
+ */
+function convertSVGToBase64(svgContent) {
+    var svgString = (0, element_1.serializeSVG)(svgContent);
+    return "data:image/svg+xml;base64,".concat(Buffer.from(svgString).toString('base64'));
+}
+/**
+ * Converts a Base64-encoded data URI back to an SVG string
+ */
+function convertBase64ToSVG(base64String) {
+    try {
+        var base64Data = base64String.includes(',')
+            ? base64String.split(',')[1]
+            : base64String;
+        // Validate base64 string format
+        if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64Data)) {
+            throw new Error('Invalid Base64 string.');
+        }
+        var svgString = Buffer.from(base64Data, 'base64').toString('utf-8');
+        // Basic validation that result looks like SVG
+        if (!svgString.includes('<svg') && !svgString.includes('<SVG')) {
+            throw new Error('Invalid Base64 string.');
+        }
+        return svgString;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === 'Invalid Base64 string.') {
+            throw error;
+        }
+        throw new Error('Invalid Base64 string.');
+    }
+}
+//# sourceMappingURL=base64.js.map

package/lib/convert/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/convert/base64.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,gDAGC;AAKD,gDAyBC;AAtCD,2CAA+C;AAE/C;;GAEG;AACH,SAAgB,kBAAkB,CAAC,UAA4B;IAC7D,IAAM,SAAS,GAAG,IAAA,sBAAY,EAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,oCAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAE,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,IAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC3C,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC,CAAC,YAAY,CAAC;QAEjB,gCAAgC;QAChC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,IAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEtE,8CAA8C;QAC9C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,wBAAwB,EAAE,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/lib/convert/image.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SVG to image format conversion utilities
+ */
+import { ConversionOptions } from '../types';
+/**
+ * Converts an SVG file to PNG format
+ *
+ * @param svgPath - Path to the SVG file
+ * @param options - Conversion options including scale, format, and quality
+ * @returns Promise resolving to a Buffer containing the converted image
+ */
+export declare function svgToImage(svgPath: string, options?: ConversionOptions): Promise<Buffer>;
+/**
+ * Converts an SVG file to PNG format (legacy function name)
+ *
+ * @deprecated Use svgToImage instead
+ */
+export declare function svg2Png(svgPath: string, pngPath?: string, scale?: number): Promise<void | Buffer>;