@emasoft/svg-matrix 1.0.26 → 1.0.28

package/README.md

@@ -255,6 +255,36 @@ svgm --show-plugins
 
 Run `svgm --help` for all options.
 
+### Namespace Preservation
+
+Preserve vendor-specific namespaces during optimization:
+
+```bash
+# Preserve Inkscape/Sodipodi namespaces (layers, guides, document settings)
+svgm --preserve-ns inkscape input.svg -o output.svg
+
+# Preserve multiple vendor namespaces
+svgm --preserve-ns inkscape,illustrator input.svg -o output.svg
+
+# Available namespaces: inkscape, sodipodi, illustrator, sketch, ai, serif, vectornator, figma
+```
+
+### SVG 2.0 Polyfills
+
+Enable browser compatibility for SVG 2.0 features:
+
+```bash
+# Add polyfills for mesh gradients and hatches
+svgm --svg2-polyfills input.svg -o output.svg
+
+# Combine with namespace preservation
+svgm --preserve-ns inkscape --svg2-polyfills input.svg -o output.svg
+```
+
+Supported SVG 2.0 features:
+- **Mesh gradients** (`<meshGradient>`) - Rendered via canvas fallback
+- **Hatches** (`<hatch>`) - Converted to SVG 1.1 patterns
+
 ---
 
 ### `svg-matrix` - Advanced SVG Processing
@@ -360,6 +390,33 @@ const fixed = await fixInvalidSvg('broken.svg');
 console.log(fixed.svg);       // Fixed SVG string
 ```
 
+### Inkscape Support Module
+
+```javascript
+import { InkscapeSupport } from '@emasoft/svg-matrix';
+
+// Check if element is an Inkscape layer
+InkscapeSupport.isInkscapeLayer(element);
+
+// Find all layers in document
+const layers = InkscapeSupport.findLayers(doc);
+
+// Get document settings from sodipodi:namedview
+const settings = InkscapeSupport.getNamedViewSettings(doc);
+```
+
+### SVG 2.0 Polyfills Module
+
+```javascript
+import { SVG2Polyfills } from '@emasoft/svg-matrix';
+
+// Detect SVG 2.0 features in document
+const features = SVG2Polyfills.detectSVG2Features(doc);
+
+// Inject polyfills into document
+SVG2Polyfills.injectPolyfills(doc);
+```
+
 ### Exclusive Features (Not in SVGO)
 
 | Function | Description |

package/bin/svg-matrix.js

@@ -91,6 +91,7 @@ let currentOutputFile = null; // Track for cleanup on interrupt
  * @property {boolean} resolveMarkers - Expand marker references
  * @property {boolean} resolvePatterns - Expand pattern fills
  * @property {boolean} bakeGradients - Bake gradientTransform into coordinates
+ * @property {string[]} preserveNamespaces - Array of namespace prefixes to preserve
  */
 
 const DEFAULT_CONFIG = {
@@ -120,6 +121,7 @@ const DEFAULT_CONFIG = {
   bezierArcs: 8,              // Bezier arcs for circles/ellipses (multiple of 4; 8=π/4 optimal)
   e2eTolerance: '1e-10',      // E2E verification tolerance (tighter with more segments)
   preserveVendor: false,      // If true, preserve vendor-prefixed properties and editor namespaces
+  preserveNamespaces: [],     // Array of namespace prefixes to preserve (e.g., ['inkscape', 'sodipodi'])
 };
 
 /** @type {CLIConfig} */
@@ -603,6 +605,8 @@ ${boxLine(`  ${colors.dim}--no-patterns${colors.reset}           Skip pattern ex
 ${boxLine(`  ${colors.dim}--no-gradients${colors.reset}          Skip gradient transform baking`, W)}
 ${boxLine(`  ${colors.dim}--preserve-vendor${colors.reset}       Keep vendor prefixes and editor namespaces`, W)}
 ${boxLine(`                          ${colors.dim}(inkscape, sodipodi, -webkit-*, etc.)${colors.reset}`, W)}
+${boxLine(`  ${colors.dim}--preserve-ns <list>${colors.reset}     Preserve specific namespaces (comma-separated)`, W)}
+${boxLine(`                          ${colors.dim}Example: --preserve-ns inkscape,sodipodi${colors.reset}`, W)}
 ${boxLine('', W)}
 ${boxDivider(W)}
 ${boxLine('', W)}
@@ -628,6 +632,7 @@ ${boxLine('', W)}
 ${boxLine(`  ${colors.green}svg-matrix flatten${colors.reset} input.svg -o output.svg`, W)}
 ${boxLine(`  ${colors.green}svg-matrix flatten${colors.reset} ./svgs/ -o ./out/ --transform-only`, W)}
 ${boxLine(`  ${colors.green}svg-matrix flatten${colors.reset} --list files.txt -o ./out/ --no-patterns`, W)}
+${boxLine(`  ${colors.green}svg-matrix flatten${colors.reset} input.svg -o out.svg --preserve-ns inkscape,sodipodi`, W)}
 ${boxLine(`  ${colors.green}svg-matrix convert${colors.reset} input.svg -o output.svg -p 10`, W)}
 ${boxLine(`  ${colors.green}svg-matrix info${colors.reset} input.svg`, W)}
 ${boxLine('', W)}
@@ -867,6 +872,7 @@ function processFlatten(inputPath, outputPath) {
       flattenTransforms: true, // Always flatten transforms
       bakeGradients: config.bakeGradients,
       removeUnusedDefs: true,
+      preserveNamespaces: config.preserveNamespaces, // Pass namespace preservation to pipeline
       // NOTE: Verification is ALWAYS enabled - precision is non-negotiable
     };
 
@@ -1221,8 +1227,8 @@ async function testToolboxFunction(fnName, originalContent, originalSize, output
 
     const startTime = Date.now();
     const doc = parseSVG(originalContent);
-    // Pass preserveVendor option from config to toolbox functions
-    await fn(doc, { preserveVendor: config.preserveVendor });
+    // Pass preserveVendor and preserveNamespaces options from config to toolbox functions
+    await fn(doc, { preserveVendor: config.preserveVendor, preserveNamespaces: config.preserveNamespaces });
     const output = serializeSVG(doc);
     const outputSize = Buffer.byteLength(output);
     result.timeMs = Date.now() - startTime;
@@ -1347,7 +1353,16 @@ function parseArgs(args) {
   let i = 0;
 
   while (i < args.length) {
-    const arg = args[i];
+    let arg = args[i];
+    let argValue = null;
+
+    // Handle --arg=value format
+    if (arg.includes('=') && arg.startsWith('--')) {
+      const eqIdx = arg.indexOf('=');
+      argValue = arg.substring(eqIdx + 1);
+      arg = arg.substring(0, eqIdx);
+    }
+
     switch (arg) {
       case '-o': case '--output': cfg.output = args[++i]; break;
       case '-l': case '--list': cfg.listFile = args[++i]; break;
@@ -1385,6 +1400,16 @@ function parseArgs(args) {
       case '--no-gradients': cfg.bakeGradients = false; break;
       // Vendor preservation option
       case '--preserve-vendor': cfg.preserveVendor = true; break;
+      // Namespace preservation option (comma-separated list)
+      case '--preserve-ns': {
+        const namespaces = argValue || args[++i];
+        if (!namespaces) {
+          logError('--preserve-ns requires a comma-separated list of namespaces');
+          process.exit(CONSTANTS.EXIT_ERROR);
+        }
+        cfg.preserveNamespaces = namespaces.split(',').map(ns => ns.trim()).filter(ns => ns.length > 0);
+        break;
+      }
       // E2E verification precision options
       case '--clip-segments': {
         const segs = parseInt(args[++i], 10);

package/bin/svgm.js

@@ -20,6 +20,7 @@ import { join, dirname, basename, extname, resolve, isAbsolute } from 'path';
 import { VERSION } from '../src/index.js';
 import * as SVGToolbox from '../src/svg-toolbox.js';
 import { parseSVG, serializeSVG } from '../src/svg-parser.js';
+import { injectPolyfills, detectSVG2Features } from '../src/svg2-polyfills.js';
 
 // ============================================================================
 // CONSTANTS
@@ -62,6 +63,8 @@ const DEFAULT_CONFIG = {
   exclude: [],
   quiet: false,
   datauri: null,
+  preserveNamespaces: [],
+  svg2Polyfills: false,
   showPlugins: false,
 };
 
@@ -217,12 +220,19 @@ async function optimizeSvg(content, options = {}) {
   const doc = parseSVG(content);
   const pipeline = DEFAULT_PIPELINE;
 
+  // Detect SVG 2 features BEFORE optimization pipeline removes them
+  // (removeUnknownsAndDefaults strips elements not in SVG 1.1 spec)
+  let svg2Features = null;
+  if (options.svg2Polyfills) {
+    svg2Features = detectSVG2Features(doc);
+  }
+
   // Run optimization pipeline
   for (const pluginName of pipeline) {
     const fn = SVGToolbox[pluginName];
     if (fn && typeof fn === 'function') {
       try {
-        await fn(doc, { precision: options.precision });
+        await fn(doc, { precision: options.precision, preserveNamespaces: options.preserveNamespaces });
       } catch (e) {
         // Skip failed optimizations silently
       }
@@ -235,7 +245,7 @@ async function optimizeSvg(content, options = {}) {
       const fn = SVGToolbox[pluginName];
       if (fn && typeof fn === 'function') {
         try {
-          await fn(doc, { precision: options.precision });
+          await fn(doc, { precision: options.precision, preserveNamespaces: options.preserveNamespaces });
         } catch (e) {
           // Skip failed optimizations silently
         }
@@ -243,6 +253,14 @@ async function optimizeSvg(content, options = {}) {
     }
   }
 
+  // Inject SVG 2 polyfills if requested (using pre-detected features)
+  if (options.svg2Polyfills && svg2Features) {
+    if (svg2Features.meshGradients.length > 0 || svg2Features.hatches.length > 0) {
+      // Pass pre-detected features since pipeline may have removed SVG2 elements
+      injectPolyfills(doc, { features: svg2Features });
+    }
+  }
+
   let result = serializeSVG(doc);
 
   // Pretty print if requested, otherwise minify (SVGO default behavior)
@@ -384,6 +402,10 @@ Options:
                              regular expression pattern.
   -q, --quiet                Only output error messages
   --show-plugins             Show available plugins and exit
+  --preserve-ns <NS,...>     Preserve vendor namespaces (inkscape, sodipodi,
+                             illustrator, figma, etc.). Comma-separated.
+  --svg2-polyfills           Inject JavaScript polyfills for SVG 2 features
+                             (mesh gradients, hatches) for browser support
   --no-color                 Output plain text without color
   -h, --help                 Display help for command
 
@@ -417,7 +439,15 @@ function parseArgs(args) {
   let i = 0;
 
   while (i < args.length) {
-    const arg = args[i];
+    let arg = args[i];
+    let argValue = null;
+
+    // Handle --arg=value format
+    if (arg.includes('=') && arg.startsWith('--')) {
+      const eqIdx = arg.indexOf('=');
+      argValue = arg.substring(eqIdx + 1);
+      arg = arg.substring(0, eqIdx);
+    }
 
     switch (arg) {
       case '-v':
@@ -517,6 +547,17 @@ function parseArgs(args) {
         cfg.showPlugins = true;
         break;
 
+      case '--preserve-ns':
+        {
+          const val = argValue || args[++i];
+          cfg.preserveNamespaces = val.split(',').map(s => s.trim().toLowerCase());
+        }
+        break;
+
+      case '--svg2-polyfills':
+        cfg.svg2Polyfills = true;
+        break;
+
       case '--no-color':
         // Already handled in colors initialization
         break;
@@ -561,6 +602,8 @@ async function main() {
     eol: config.eol,
     finalNewline: config.finalNewline,
     datauri: config.datauri,
+    preserveNamespaces: config.preserveNamespaces,
+    svg2Polyfills: config.svg2Polyfills,
   };
 
   // Handle string input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emasoft/svg-matrix",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "Arbitrary-precision matrix, vector and affine transformation library for JavaScript using decimal.js",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -5,7 +5,7 @@
  * SVG path conversion, and 2D/3D affine transformations using Decimal.js.
  *
  * @module @emasoft/svg-matrix
- * @version 1.0.26
+ * @version 1.0.28
  * @license MIT
  *
  * @example
@@ -46,6 +46,8 @@ import * as MeshGradient from './mesh-gradient.js';
 import * as SVGParser from './svg-parser.js';
 import * as FlattenPipeline from './flatten-pipeline.js';
 import * as Verification from './verification.js';
+import * as InkscapeSupport from './inkscape-support.js';
+import * as SVG2Polyfills from './svg2-polyfills.js';
 import { Logger, LogLevel, setLogLevel, getLogLevel as getLoggerLevel, enableFileLogging, disableFileLogging } from './logger.js';
 
 // SVGO-inspired precision modules
@@ -85,7 +87,7 @@ Decimal.set({ precision: 80 });
  * Library version
  * @constant {string}
  */
-export const VERSION = '1.0.26';
+export const VERSION = '1.0.28';
 
 /**
  * Default precision for path output (decimal places)
@@ -120,6 +122,7 @@ export { ClipPathResolver, MaskResolver, PatternResolver };
 export { UseSymbolResolver, MarkerResolver };
 export { MeshGradient };
 export { SVGParser, FlattenPipeline, Verification };
+export { InkscapeSupport, SVG2Polyfills };
 
 // ============================================================================
 // SVGO-INSPIRED PRECISION MODULES
@@ -577,6 +580,8 @@ export default {
   SVGParser,
   FlattenPipeline,
   Verification,
+  InkscapeSupport,
+  SVG2Polyfills,
 
   // Logging
   Logger,