@emasoft/svg-matrix 1.3.4 → 1.3.6

package/README.md

@@ -333,6 +333,46 @@ svgm --export --export-prefix myapp_ input.svg -o output.svg --export-dir ./asse
 | `--export-dry-run` | Preview extraction without writing files |
 | `--export-ids <ids>` | Only export from specific element IDs |
 
+### Inkscape Conversion
+
+Convert Inkscape SVG files to plain/standard SVG by removing editor-specific metadata while preserving SVG 2 features:
+
+```bash
+# Using svgm
+svgm --to-plain-svg inkscape-drawing.svg -o plain.svg
+
+# Keep SVG 1.2 flowText elements (normally removed)
+svgm --to-plain-svg --keep-flow-text inkscape-drawing.svg -o plain.svg
+
+# Using svg-matrix CLI
+svg-matrix to-plain inkscape-drawing.svg -o plain.svg
+```
+
+**What gets removed:**
+- `sodipodi:*` elements and attributes (guide lines, named views)
+- `inkscape:*` elements and attributes (layers, path effects, version)
+- SVG 1.2 flowText elements (not browser-supported)
+- Namespace declarations (xmlns:inkscape, xmlns:sodipodi)
+
+**What gets preserved:**
+- Mesh gradients and hatches (SVG 2 features)
+- All standard SVG elements and attributes
+- Document structure and styling
+
+### Run Without Installing
+
+Use `bunx` or `npx` to run the CLI tools without installing the package:
+
+```bash
+# Using bunx (faster)
+bunx @emasoft/svg-matrix svgm input.svg -o output.svg
+bunx @emasoft/svg-matrix svg-matrix flatten input.svg -o output.svg
+
+# Using npx
+npx @emasoft/svg-matrix svgm input.svg -o output.svg
+npx @emasoft/svg-matrix svg-matrix to-plain inkscape.svg -o plain.svg
+```
+
 ### YAML Configuration
 
 Instead of CLI flags, you can use a YAML configuration file:
@@ -600,6 +640,22 @@ const layers = InkscapeSupport.findLayers(doc);
 const settings = InkscapeSupport.getNamedViewSettings(doc);
 ```
 
+### Plain SVG Conversion
+
+```javascript
+import { convertToPlainSVG } from '@emasoft/svg-matrix';
+
+// Convert Inkscape SVG to plain/standard SVG
+const plainSVG = await convertToPlainSVG(inkscapeSVG);
+
+// With options
+const plainSVG = await convertToPlainSVG(inkscapeSVG, {
+  removeFlowText: true,      // Remove SVG 1.2 flowText (default: true)
+  removeEmptyDefs: true,     // Clean up empty defs (default: true)
+  removeEmptyGroups: false,  // Keep empty groups with IDs (default: false)
+});
+```
+
 ### SVG 2.0 Polyfills Module
 
 ```javascript

package/bin/svg-matrix.js

@@ -881,6 +881,9 @@ ${boxLine(`              ${colors.dim}Ideal for animation and path morphing${col
 ${boxLine("", W)}
 ${boxLine(`  ${colors.green}info${colors.reset}        Show SVG file information and element counts`, W)}
 ${boxLine("", W)}
+${boxLine(`  ${colors.green}to-plain${colors.reset}    Convert Inkscape SVG to plain/standard SVG`, W)}
+${boxLine(`              ${colors.dim}Removes all sodipodi:* and inkscape:* data${colors.reset}`, W)}
+${boxLine("", W)}
 ${boxLine(`  ${colors.green}test-toolbox${colors.reset} Test all svg-toolbox functions on an SVG file`, W)}
 ${boxLine(`              ${colors.dim}Creates timestamped folder with all processed versions${colors.reset}`, W)}
 ${boxLine("", W)}
@@ -921,6 +924,14 @@ ${boxLine(`  ${colors.dim}--no-minify-polyfills${colors.reset}   Use full (non-m
 ${boxLine("", W)}
 ${boxDivider(W)}
 ${boxLine("", W)}
+${boxHeader("TO-PLAIN OPTIONS", W)}
+${boxLine("", W)}
+${boxLine(`  ${colors.yellow}${B.dot} Converts Inkscape SVG to plain/standard SVG${colors.reset}`, W)}
+${boxLine(`  ${colors.yellow}${B.dot} Removes: sodipodi:*, inkscape:*, SVG 1.2 flowText${colors.reset}`, W)}
+${boxLine(`  ${colors.yellow}${B.dot} Preserves: mesh gradients, hatches, standard SVG 2${colors.reset}`, W)}
+${boxLine("", W)}
+${boxDivider(W)}
+${boxLine("", W)}
 ${boxHeader("PRECISION OPTIONS", W)}
 ${boxLine("", W)}
 ${boxLine(`  ${colors.dim}--clip-segments <n>${colors.reset}     Polygon samples for clipping (default: 64)`, W)}
@@ -945,6 +956,7 @@ ${boxLine(`  ${colors.green}svg-matrix flatten${colors.reset} ./svgs/ -o ./out/
 ${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 to-plain${colors.reset} inkscape.svg -o plain.svg`, W)}
 ${boxLine(`  ${colors.green}svg-matrix info${colors.reset} input.svg`, W)}
 ${boxLine("", W)}
 ${boxDivider(W)}
@@ -1644,6 +1656,52 @@ function processNormalize(inputPath, outputPath) {
   }
 }
 
+/**
+ * Convert Inkscape SVG to plain/standard SVG.
+ * Removes all Inkscape-specific and Sodipodi-specific content while preserving
+ * standard SVG elements like mesh gradients, hatches, and other SVG 2 features.
+ *
+ * @param {string} inputPath - Input file path
+ * @param {string} outputPath - Output file path
+ * @returns {Promise<boolean>} True if successful
+ */
+async function processToPlain(inputPath, outputPath) {
+  // Why: Validate parameters to prevent crashes
+  if (!inputPath || typeof inputPath !== "string") {
+    logError("Invalid input path: must be a non-empty string");
+    return false;
+  }
+  if (!outputPath || typeof outputPath !== "string") {
+    logError("Invalid output path: must be a non-empty string");
+    return false;
+  }
+
+  try {
+    logDebug(`Converting to plain SVG: ${inputPath}`);
+    const content = readFileSync(inputPath, "utf8");
+
+    // Apply convertToPlainSVG function
+    // Why: This removes inkscape:* and sodipodi:* elements/attributes
+    // but preserves mesh gradients, hatches, and other standard SVG features
+    // Note: createOperation wrapper makes this async and handles parsing internally
+    const result = await SVGToolbox.convertToPlainSVG(content, {
+      removeFlowText: true,        // SVG 1.2 flowText is Inkscape-only
+      removeEmptyDefs: true,       // Clean up defs after removing Inkscape content
+      removeEmptyGroups: false,    // Keep groups even if empty (may have id refs)
+    });
+
+    if (!config.dryRun) {
+      ensureDir(dirname(outputPath));
+      writeFileSync(outputPath, result, "utf8");
+    }
+    logSuccess(`${basename(inputPath)} -> ${basename(outputPath)}`);
+    return true;
+  } catch (error) {
+    logError(`Failed: ${inputPath}: ${error.message}`);
+    return false;
+  }
+}
+
 /**
  * Display information about SVG file.
  * @param {string} inputPath - Input file path
@@ -2250,6 +2308,7 @@ function parseArgs(args) {
             "convert",
             "normalize",
             "info",
+            "to-plain",
             "test-toolbox",
             "help",
             "version",
@@ -2373,7 +2432,8 @@ async function main() {
       }
       case "flatten":
       case "convert":
-      case "normalize": {
+      case "normalize":
+      case "to-plain": {
         const files = gatherInputFiles();
         if (files.length === 0) {
           logError("No input files");
@@ -2407,9 +2467,13 @@ async function main() {
                 ? processFlatten
                 : config.command === "convert"
                   ? processConvert
-                  : processNormalize;
+                  : config.command === "to-plain"
+                    ? processToPlain
+                    : processNormalize;
 
-            if (fn(f, out)) {
+            // Why: processToPlain is async, so we need to await it
+            const fnResult = await fn(f, out);
+            if (fnResult) {
               // Verify write if not dry run
               if (!config.dryRun) {
                 // Why: Simple empty check instead of full verifyWriteSuccess because:

package/bin/svglinter.cjs

@@ -583,6 +583,73 @@ const RULES = {
     description: "Missing lang/xml:lang attribute on SVG with text content",
     fixable: false,
   },
+
+  // === INKSCAPE RULES (I###) ===
+  // Namespace errors (I001-I099)
+  I001: {
+    type: "inkscape-invalid_namespace_uri",
+    severity: "error",
+    description: "Invalid Inkscape or Sodipodi namespace URI",
+    fixable: false,
+  },
+  I002: {
+    type: "inkscape-unknown_inkscape_element",
+    severity: "error",
+    description: "Unknown inkscape: element (not in namespace schema)",
+    fixable: false,
+  },
+  I003: {
+    type: "inkscape-unknown_sodipodi_element",
+    severity: "error",
+    description: "Unknown sodipodi: element (not in namespace schema)",
+    fixable: false,
+  },
+
+  // Attribute errors (I100-I199)
+  I101: {
+    type: "inkscape-invalid_inkscape_attribute",
+    severity: "error",
+    description: "Invalid value for inkscape: attribute",
+    fixable: false,
+  },
+  I102: {
+    type: "inkscape-invalid_sodipodi_attribute",
+    severity: "error",
+    description: "Invalid value for sodipodi: attribute",
+    fixable: false,
+  },
+  I103: {
+    type: "inkscape-unknown_inkscape_attribute",
+    severity: "error",
+    description: "Unknown inkscape: attribute (not in namespace schema)",
+    fixable: false,
+  },
+  I104: {
+    type: "inkscape-unknown_sodipodi_attribute",
+    severity: "error",
+    description: "Unknown sodipodi: attribute (not in namespace schema)",
+    fixable: false,
+  },
+
+  // Compatibility warnings (I200-I299)
+  I201: {
+    type: "inkscape-flowtext_compatibility",
+    severity: "warning",
+    description: "flowRoot/flowPara elements require polyfill for browser rendering",
+    fixable: false,
+  },
+  I202: {
+    type: "inkscape-mesh_gradient",
+    severity: "warning",
+    description: "Mesh gradient requires polyfill for browser rendering",
+    fixable: false,
+  },
+  I203: {
+    type: "inkscape-hatch_paint",
+    severity: "warning",
+    description: "Hatch paint server requires polyfill for browser rendering",
+    fixable: false,
+  },
 };
 
 // Create reverse lookup: type -> code
@@ -1330,6 +1397,8 @@ function parseArgs(argv) {
     verbose: false, // Enable verbose debug output
     stdin: false, // Read from stdin instead of files
     severityOverrides: {}, // Map of rule code -> 'error'|'warning' for severity customization
+    validateInkscape: false, // Enable Inkscape namespace validation
+    inkscapeStrict: false, // Strict Inkscape validation (unknown attributes are errors)
   };
 
   let i = 2;
@@ -1752,6 +1821,9 @@ function parseArgs(argv) {
       args.verbose = true;
     } else if (arg === "--stdin" || arg === "-") {
       args.stdin = true;
+    } else if (arg === "--validate-inkscape" || arg === "--inkscape" || arg === "--inkscape-strict") {
+      // All Inkscape validation is now strict by default (spec compliance)
+      args.validateInkscape = true;
     } else if (!arg.startsWith("-")) {
       args.files.push(arg);
     } else {
@@ -1835,6 +1907,12 @@ ${c("bold", "FORMATS")}
     sarif           SARIF 2.1.0 for security tools (CodeQL, Snyk, etc.)
     github          GitHub Actions annotations (::error, ::warning)
 
+${c("bold", "INKSCAPE SUPPORT")}
+  ${c("cyan", "--validate-inkscape")}      Enable Inkscape namespace validation (strict mode)
+  ${c("cyan", "--inkscape")}               Alias for --validate-inkscape
+                          ${c("dim", "All unknown elements/attributes are errors (spec compliance)")}
+                          ${c("dim", "Polyfill requirements (flowText, mesh, hatch) are warnings")}
+
 ${c("bold", "CONFIGURATION")}
   ${c("cyan", "-c, --config")} <file>      Path to config file
   ${c("cyan", "--init")}[=format]          Create config file (json, yaml, toml; default: json)
@@ -4269,6 +4347,8 @@ async function main() {
       const result = await validateSVGAsync(content, {
         errorsOnly: args.errorsOnly,
         includeSource: true,
+        validateInkscape: args.validateInkscape,
+        inkscapeStrict: args.inkscapeStrict,
       });
 
       // Add invalid character issues
@@ -4426,6 +4506,8 @@ async function main() {
       const result = await validateSVGAsync(file, {
         errorsOnly: args.errorsOnly,
         includeSource: true,
+        validateInkscape: args.validateInkscape,
+        inkscapeStrict: args.inkscapeStrict,
       });
 
       // Add invalid character issues
@@ -4836,6 +4918,8 @@ async function lintFile(filePath, options = {}) {
   const result = await validateSVGAsync(filePath, {
     errorsOnly: options.errorsOnly || false,
     includeSource: options.includeSource !== false,
+    validateInkscape: options.validateInkscape || false,
+    inkscapeStrict: options.inkscapeStrict || false,
   });
 
   // Add invalid character issues

package/bin/svgm.js

@@ -109,6 +109,9 @@ const DEFAULT_CONFIG = {
   embedMaxRecursionDepth: 10,
   embedTimeout: 30000,
   embedOnMissingResource: "warn",
+  // Plain SVG conversion
+  toPlainSVG: false,
+  removeFlowText: true,
 };
 
 let config = { ...DEFAULT_CONFIG };
@@ -529,6 +532,20 @@ async function optimizeSvg(content, options = {}) {
     }
   }
 
+  // Convert to plain SVG if requested (remove all Inkscape/Sodipodi content)
+  // Why: This must run AFTER the optimization pipeline but BEFORE polyfills
+  if (options.toPlainSVG) {
+    try {
+      SVGToolbox.convertToPlainSVG(doc, {
+        removeFlowText: options.removeFlowText !== false,
+        removeEmptyDefs: true,
+        removeEmptyGroups: false,
+      });
+    } catch (err) {
+      logWarn(`convertToPlainSVG failed: ${err.message}`);
+    }
+  }
+
   // Inject SVG 2 polyfills if requested (using pre-detected features)
   if (options.svg2Polyfills && svg2Features) {
     if (
@@ -843,6 +860,12 @@ Embed Options:
   --embed-timeout <ms>       Timeout for external resources (default: 30000)
   --embed-on-missing <mode>  Handle missing resources: 'warn', 'fail', 'skip'
 
+Inkscape Conversion:
+  --to-plain-svg             Convert Inkscape SVG to plain/standard SVG
+                             (removes sodipodi:*, inkscape:* elements and attributes)
+  --keep-flow-text           Keep SVG 1.2 flowText elements when using --to-plain-svg
+                             (by default they are removed as browsers don't support them)
+
 Examples:
   svgm input.svg -o output.svg
   svgm -f ./icons/ -o ./optimized/
@@ -850,6 +873,7 @@ Examples:
   svgm -p 2 --multipass input.svg
   svgm input.svg --embed-all -o output.svg
   svgm input.svg --config svgm.yml -o output.svg
+  svgm inkscape.svg --to-plain-svg -o plain.svg
 
 Docs: https://github.com/Emasoft/SVG-MATRIX#readme`);
 }
@@ -1320,6 +1344,16 @@ function parseArgs(args) {
         i++;
         break;
 
+      case "--to-plain-svg":
+        // Why: Enable conversion from Inkscape SVG to plain/standard SVG
+        cfg.toPlainSVG = true;
+        break;
+
+      case "--keep-flow-text":
+        // Why: When using --to-plain-svg, keep SVG 1.2 flowText elements
+        cfg.removeFlowText = false;
+        break;
+
       default:
         if (arg.startsWith("-")) {
           logError(`Unknown option: ${arg}`);
@@ -1471,6 +1505,9 @@ async function main() {
     embedMaxRecursionDepth: config.embedMaxRecursionDepth,
     embedTimeout: config.embedTimeout,
     embedOnMissingResource: config.embedOnMissingResource,
+    // Plain SVG conversion options
+    toPlainSVG: config.toPlainSVG,
+    removeFlowText: config.removeFlowText,
   };
 
   // Handle string input