svg-toolbox 1.1.11 → 1.2.0

package/es/analyze/paths.js

@@ -0,0 +1,92 @@
+/**
+ * SVG path analysis utilities
+ */
+import { JSDOM } from 'jsdom';
+import { serializeSVG } from '../core/element';
+import { isValidSvgString } from '../utils/validation';
+/**
+ * Maximum allowed path data length to prevent ReDoS attacks
+ */
+const MAX_PATH_DATA_LENGTH = 100000; // 100KB should be sufficient for most SVG paths
+/**
+ * Parses the 'd' attribute of a path element into command objects
+ */
+export 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 ${MAX_PATH_DATA_LENGTH} characters`);
+    }
+    const commands = [];
+    // Split by path commands (M, L, H, V, C, S, Q, T, A, Z)
+    const commandRegex = /([MmLlHhVvCcSsQqTtAaZz])((?:\s*-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\s*,?\s*)*)/g;
+    let match;
+    let iterations = 0;
+    const 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.');
+        }
+        const type = match[1];
+        const paramsStr = match[2].trim();
+        if (type.toLowerCase() === 'z') {
+            commands.push({ type, params: [] });
+        }
+        else if (paramsStr) {
+            const params = paramsStr
+                .split(/[\s,]+/)
+                .filter(p => p.trim() !== '')
+                .map(Number)
+                .filter(n => !isNaN(n));
+            commands.push({ type, params });
+        }
+    }
+    return commands;
+}
+/**
+ * Analyzes all paths in an SVG and returns their command structures
+ */
+export function analyzePaths(svgContent) {
+    const svgString = isValidSvgString(svgContent)
+        ? svgContent
+        : serializeSVG(svgContent);
+    const dom = new JSDOM(svgString, {
+        contentType: 'image/svg+xml'
+    });
+    const document = dom.window.document;
+    const svgElement = document.querySelector('svg');
+    if (!svgElement) {
+        throw new Error('No SVG element found in the provided content.');
+    }
+    const paths = svgElement.querySelectorAll('path');
+    const pathAnalysis = new Map();
+    Array.from(paths).forEach((path, index) => {
+        const d = path.getAttribute('d');
+        if (d) {
+            const id = path.getAttribute('id') || `path-${index}`;
+            pathAnalysis.set(id, parsePathData(d));
+        }
+    });
+    return pathAnalysis;
+}
+/**
+ * Gets statistics about paths in an SVG
+ */
+export function getPathStatistics(svgContent) {
+    const pathAnalysis = analyzePaths(svgContent);
+    let totalCommands = 0;
+    const commandTypes = {};
+    pathAnalysis.forEach(commands => {
+        totalCommands += commands.length;
+        commands.forEach(cmd => {
+            const type = cmd.type.toUpperCase();
+            commandTypes[type] = (commandTypes[type] || 0) + 1;
+        });
+    });
+    return {
+        totalPaths: pathAnalysis.size,
+        totalCommands,
+        commandTypes
+    };
+}
+//# sourceMappingURL=paths.js.map

package/es/analyze/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/analyze/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAG1E;;GAEG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC,CAAC,gDAAgD;AAErF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,iDAAiD;IACjD,IAAI,QAAQ,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,sDAAsD,oBAAoB,aAAa,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,wDAAwD;IACxD,MAAM,YAAY,GAAG,6EAA6E,CAAC;IACnG,IAAI,KAAK,CAAC;IACV,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,yBAAyB;IAEvD,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtD,UAAU,EAAE,CAAC;QACb,IAAI,UAAU,GAAG,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,SAAS;iBACrB,KAAK,CAAC,QAAQ,CAAC;iBACf,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;iBAC5B,GAAG,CAAC,MAAM,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAA4B;IACvD,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC;QAC5C,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAE7B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE;QAC/B,WAAW,EAAE,eAAe;KAC7B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjD,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,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,EAAE,CAAC;YACtD,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA4B;IAK5D,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,YAAY,GAA2B,EAAE,CAAC;IAEhD,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC9B,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACrB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,YAAY,CAAC,IAAI;QAC7B,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1,64 @@
+import { diffImages } from '../diff';
+import fs from 'fs';
+import path from 'path';
+describe('Image Diff', () => {
+    const fixturesDir = path.join(__dirname, '../../../test-fixtures');
+    const test1Path = path.join(fixturesDir, 'test1.svg');
+    const test2Path = path.join(fixturesDir, 'test2.svg');
+    const outputDir = path.join(fixturesDir, 'diff-output');
+    const diffImagePath = path.join(outputDir, 'diff-test1-test2.png');
+    beforeAll(() => {
+        // Ensure output directory exists
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        // 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', async () => {
+        // Verify test fixtures exist
+        expect(fs.existsSync(test1Path)).toBe(true);
+        expect(fs.existsSync(test2Path)).toBe(true);
+        // Generate diff image
+        const result = await diffImages(test1Path, test2Path, diffImagePath, 0.1);
+        // Verify diff image was created
+        expect(fs.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);
+        // Verify the saved file matches the buffer
+        const savedFile = fs.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: ${diffImagePath}`);
+        console.log(`Number of different pixels: ${result.numDiffPixels}`);
+    });
+    it('should handle identical SVGs (no differences)', async () => {
+        const identicalDiffPath = path.join(outputDir, 'diff-identical.png');
+        // Compare test1 with itself
+        const result = await diffImages(test1Path, test1Path, identicalDiffPath, 0.1);
+        // Should have no differences
+        expect(result.numDiffPixels).toBe(0);
+        expect(fs.existsSync(identicalDiffPath)).toBe(true);
+        console.log(`Identical comparison diff saved to: ${identicalDiffPath}`);
+        console.log(`Number of different pixels: ${result.numDiffPixels}`);
+    });
+    it('should generate diff without saving to file', async () => {
+        const result = await diffImages(test1Path, test2Path, undefined, 0.1);
+        // Should still return result even without file path
+        expect(result).toHaveProperty('diffPngBuffer');
+        expect(result).toHaveProperty('numDiffPixels');
+        expect(result.numDiffPixels).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=diff.test.js.map

package/es/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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAEnE,SAAS,CAAC,GAAG,EAAE;QACb,iCAAiC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,EAAE;QACZ,yDAAyD;QACzD,mEAAmE;QACnE,sCAAsC;QACtC,kCAAkC;QAClC,IAAI;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,6BAA6B;QAC7B,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAE1E,gCAAgC;QAChC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhD,6CAA6C;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnD,iEAAiE;QACjE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAEhD,2CAA2C;QAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,6CAA6C;QAC7C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAE5C,OAAO,CAAC,GAAG,CAAC,wBAAwB,aAAa,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAErE,4BAA4B;QAC5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAE9E,6BAA6B;QAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,uCAAuC,iBAAiB,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAEtE,oDAAoD;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/es/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/es/compare/diff.js

@@ -0,0 +1,70 @@
+/**
+ * Image comparison and diff utilities
+ */
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import { PNG } from 'pngjs';
+import pixelmatch from 'pixelmatch';
+import { validateReadPath, validateWritePath } from '../utils/path-validation';
+/**
+ * Compares two PNG images at the pixel level and generates a diff image
+ */
+export function pixelLevelDiff(pngA, pngB, threshold = 0.1) {
+    const img1 = PNG.sync.read(pngA);
+    const img2 = PNG.sync.read(pngB);
+    const { width, height } = img1;
+    if (img2.width !== width || img2.height !== height) {
+        throw new Error('Images must have the same dimensions');
+    }
+    const diff = new PNG({ width, height });
+    const numDiffPixels = pixelmatch(img1.data, img2.data, diff.data, width, height, { threshold });
+    const diffPngBuffer = PNG.sync.write(diff);
+    return {
+        diffPngBuffer,
+        numDiffPixels
+    };
+}
+/**
+ * Compares two image files (SVG or PNG) and generates a diff image
+ */
+export async function diffImages(pathA, pathB, diffFilePath, threshold = 0.1) {
+    // Validate and normalize file paths to prevent path traversal
+    const validatedPathA = validateReadPath(pathA, ['.svg', '.png', '.jpg', '.jpeg', '.webp']);
+    const validatedPathB = validateReadPath(pathB, ['.svg', '.png', '.jpg', '.jpeg', '.webp']);
+    if (!fs.existsSync(validatedPathA)) {
+        throw new Error(`File not found: ${validatedPathA}`);
+    }
+    if (!fs.existsSync(validatedPathB)) {
+        throw new Error(`File not found: ${validatedPathB}`);
+    }
+    // Convert both images to PNG buffers
+    const pngA = await sharp(validatedPathA).png().toBuffer();
+    const pngB = await sharp(validatedPathB).png().toBuffer();
+    const result = pixelLevelDiff(pngA, pngB, threshold);
+    if (diffFilePath) {
+        const ext = path.extname(diffFilePath);
+        if (!ext) {
+            throw new Error('Diff file path must have a file extension');
+        }
+        // Validate write path to prevent path traversal
+        const validatedWritePath = validateWritePath(diffFilePath, ['.png']);
+        fs.writeFileSync(validatedWritePath, result.diffPngBuffer);
+    }
+    return result;
+}
+/**
+ * Legacy function name for diffImages
+ *
+ * @deprecated Use diffImages instead
+ */
+export async function diffSvg(pathA, pathB, diffFilePath) {
+    try {
+        return await diffImages(pathA, pathB, diffFilePath);
+    }
+    catch (error) {
+        console.error(`Error comparing images: ${error instanceof Error ? error.message : String(error)}`);
+        return;
+    }
+}
+//# sourceMappingURL=diff.js.map

package/es/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/es/convert/__tests__/base64.test.d.ts

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

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

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

package/es/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/es/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/es/convert/base64.js

@@ -0,0 +1,38 @@
+/**
+ * Base64 encoding/decoding utilities for SVG
+ */
+import { serializeSVG } from '../core/element';
+/**
+ * Converts an SVG element or SVG string to a Base64-encoded data URI
+ */
+export function convertSVGToBase64(svgContent) {
+    const svgString = serializeSVG(svgContent);
+    return `data:image/svg+xml;base64,${Buffer.from(svgString).toString('base64')}`;
+}
+/**
+ * Converts a Base64-encoded data URI back to an SVG string
+ */
+export function convertBase64ToSVG(base64String) {
+    try {
+        const 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.');
+        }
+        const 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/es/convert/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/convert/base64.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA4B;IAC7D,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,MAAM,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,MAAM,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/es/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>;

package/es/convert/image.js

@@ -0,0 +1,63 @@
+/**
+ * SVG to image format conversion utilities
+ */
+import fs from 'fs';
+import sharp from 'sharp';
+import { getSVGDimensions } from '../core/dimensions';
+import { validateReadPath, validateWritePath } from '../utils/path-validation';
+/**
+ * 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 async function svgToImage(svgPath, options = {}) {
+    const { scale = 2, format = 'png', quality = 90 } = options;
+    // Validate and normalize the file path to prevent path traversal
+    const validatedPath = validateReadPath(svgPath, ['.svg']);
+    if (!fs.existsSync(validatedPath)) {
+        throw new Error(`SVG file not found: ${validatedPath}`);
+    }
+    const svgContent = fs.readFileSync(validatedPath, 'utf8');
+    const dimensions = getSVGDimensions(svgContent);
+    if (!dimensions.width || !dimensions.height) {
+        throw new Error('SVG must have width and height or viewBox');
+    }
+    const width = scale * dimensions.width;
+    const height = scale * dimensions.height;
+    let sharpInstance = sharp(validatedPath).resize(width, height);
+    switch (format) {
+        case 'jpg':
+        case 'jpeg':
+            sharpInstance = sharpInstance.jpeg({ quality });
+            break;
+        case 'webp':
+            sharpInstance = sharpInstance.webp({ quality });
+            break;
+        case 'png':
+        default:
+            sharpInstance = sharpInstance.png();
+            break;
+    }
+    return sharpInstance.toBuffer();
+}
+/**
+ * Converts an SVG file to PNG format (legacy function name)
+ *
+ * @deprecated Use svgToImage instead
+ */
+export async function svg2Png(svgPath, pngPath, scale) {
+    if (!svgPath) {
+        throw new Error('SVG file path is required');
+    }
+    const buffer = await svgToImage(svgPath, { scale: scale ?? 2, format: 'png' });
+    if (pngPath) {
+        // Validate write path to prevent path traversal
+        const validatedWritePath = validateWritePath(pngPath, ['.png']);
+        fs.writeFileSync(validatedWritePath, buffer);
+        return;
+    }
+    return buffer;
+}
+//# sourceMappingURL=image.js.map

package/es/convert/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/convert/image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE5D,iEAAiE;IACjE,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,uBAAuB,aAAa,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAEzC,IAAI,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM;QACR,KAAK,MAAM;YACT,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM;QACR,KAAK,KAAK,CAAC;QACX;YACE,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM;IACV,CAAC;IAED,OAAO,aAAa,CAAC,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,OAAgB,EAChB,KAAc;IAEd,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/E,IAAI,OAAO,EAAE,CAAC;QACZ,gDAAgD;QAChD,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/es/core/__tests__/dimensions.test.d.ts

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

package/es/core/__tests__/dimensions.test.js

@@ -0,0 +1,40 @@
+import { getSVGDimensions } from '../dimensions';
+import { createSVGElement } from '../element';
+describe('SVG Dimensions', () => {
+    describe('getSVGDimensions', () => {
+        it('should extract dimensions from viewBox', () => {
+            const svgString = '<svg viewBox="0 0 100 200"></svg>';
+            const dimensions = getSVGDimensions(svgString);
+            expect(dimensions.width).toBe(100);
+            expect(dimensions.height).toBe(200);
+            expect(dimensions.viewBox).toEqual({ x: 0, y: 0, width: 100, height: 200 });
+        });
+        it('should extract dimensions from width and height attributes', () => {
+            const svgString = '<svg width="150" height="250"></svg>';
+            const dimensions = getSVGDimensions(svgString);
+            expect(dimensions.width).toBe(150);
+            expect(dimensions.height).toBe(250);
+        });
+        it('should prioritize viewBox over width/height', () => {
+            const svgString = '<svg viewBox="0 0 100 200" width="150" height="250"></svg>';
+            const dimensions = getSVGDimensions(svgString);
+            expect(dimensions.width).toBe(100);
+            expect(dimensions.height).toBe(200);
+            expect(dimensions.viewBox).toEqual({ x: 0, y: 0, width: 100, height: 200 });
+        });
+        it('should work with SVG element input', () => {
+            const svgString = '<svg viewBox="0 0 50 75"></svg>';
+            const element = createSVGElement(svgString);
+            const dimensions = getSVGDimensions(element);
+            expect(dimensions.width).toBe(50);
+            expect(dimensions.height).toBe(75);
+        });
+        it('should handle decimal values', () => {
+            const svgString = '<svg viewBox="0 0 100.5 200.75"></svg>';
+            const dimensions = getSVGDimensions(svgString);
+            expect(dimensions.width).toBe(100.5);
+            expect(dimensions.height).toBe(200.75);
+        });
+    });
+});
+//# sourceMappingURL=dimensions.test.js.map

package/es/core/__tests__/dimensions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.test.js","sourceRoot":"","sources":["../../../src/core/__tests__/dimensions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,SAAS,GAAG,mCAAmC,CAAC;YACtD,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,MAAM,SAAS,GAAG,sCAAsC,CAAC;YACzD,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,SAAS,GAAG,4DAA4D,CAAC;YAC/E,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,SAAS,GAAG,iCAAiC,CAAC;YACpD,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,SAAS,GAAG,wCAAwC,CAAC;YAC3D,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/es/core/__tests__/element.test.d.ts

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

package/es/core/__tests__/element.test.js

@@ -0,0 +1,79 @@
+import { createSVGElement, cloneSVGElement, mergeSVGElements, serializeSVG } from '../element';
+import { JSDOM } from 'jsdom';
+describe('Element Manipulation', () => {
+    const dom = new JSDOM(`<!DOCTYPE html><html><body></body></html>`);
+    const { document } = dom.window;
+    describe('createSVGElement', () => {
+        it('should create an SVG element from a string', () => {
+            const svgString = '<svg><circle cx="50" cy="50" r="40" /></svg>';
+            const element = createSVGElement(svgString);
+            expect(element.tagName.toLowerCase()).toBe('svg');
+            expect(element.querySelector('circle')).toBeTruthy();
+        });
+        it('should handle complex SVG content', () => {
+            const svgString = '<svg viewBox="0 0 100 100"><path d="M10 10 L90 90" /></svg>';
+            const element = createSVGElement(svgString);
+            expect(element.getAttribute('viewBox')).toBe('0 0 100 100');
+            expect(element.querySelector('path')).toBeTruthy();
+        });
+    });
+    describe('cloneSVGElement', () => {
+        it('should create a deep clone of an SVG element', () => {
+            const svgString = '<svg><circle cx="50" cy="50" r="40" /></svg>';
+            const original = createSVGElement(svgString);
+            const cloned = cloneSVGElement(original);
+            expect(cloned.tagName.toLowerCase()).toBe('svg');
+            expect(cloned.querySelector('circle')).toBeTruthy();
+            expect(cloned).not.toBe(original);
+        });
+        it('should preserve all attributes when cloning', () => {
+            const svgString = '<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg"><rect x="10" y="10" width="80" height="80" /></svg>';
+            const original = createSVGElement(svgString);
+            const cloned = cloneSVGElement(original);
+            expect(cloned.getAttribute('viewBox')).toBe('0 0 100 100');
+            expect(cloned.querySelector('rect')).toBeTruthy();
+        });
+    });
+    describe('mergeSVGElements', () => {
+        it('should merge multiple SVG elements into one', () => {
+            const circle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            circle.setAttribute('cx', '50');
+            circle.setAttribute('cy', '50');
+            circle.setAttribute('r', '40');
+            const rect = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
+            rect.setAttribute('x', '10');
+            rect.setAttribute('y', '10');
+            rect.setAttribute('width', '80');
+            rect.setAttribute('height', '80');
+            const merged = mergeSVGElements([circle, rect]);
+            expect(merged.tagName.toLowerCase()).toBe('svg');
+            expect(merged.querySelector('circle')).toBeTruthy();
+            expect(merged.querySelector('rect')).toBeTruthy();
+        });
+        it('should handle empty array', () => {
+            const merged = mergeSVGElements([]);
+            expect(merged.tagName.toLowerCase()).toBe('svg');
+            expect(merged.children.length).toBe(0);
+        });
+    });
+    describe('serializeSVG', () => {
+        it('should serialize an SVG element to string', () => {
+            const svgString = '<svg><circle cx="50" cy="50" r="40" /></svg>';
+            const element = createSVGElement(svgString);
+            const serialized = serializeSVG(element);
+            expect(typeof serialized).toBe('string');
+            expect(serialized).toContain('svg');
+            expect(serialized).toContain('circle');
+        });
+        it('should return string as-is if input is already a string', () => {
+            const svgString = '<svg><rect /></svg>';
+            const serialized = serializeSVG(svgString);
+            expect(serialized).toBe(svgString);
+        });
+        it('should throw error for invalid input', () => {
+            expect(() => serializeSVG(null)).toThrow();
+            expect(() => serializeSVG(123)).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=element.test.js.map

package/es/core/__tests__/element.test.js.map

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

package/es/core/dimensions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SVG dimensions and viewBox utilities
+ */
+import { SVGDimensions } from '../types';
+/**
+ * Extracts dimensions from an SVG element or string
+ */
+export declare function getSVGDimensions(svgContent: Element | string): SVGDimensions;