@emasoft/svg-matrix 1.3.4 → 1.3.6

package/src/svg-matrix-lib.js

@@ -5,7 +5,7 @@
  * Works in both Node.js and browser environments.
  *
  * @module svg-matrix-lib
- * @version 1.3.4
+ * @version 1.3.6
  * @license MIT
  *
  * @example Browser usage:
@@ -32,7 +32,7 @@ Decimal.set({ precision: 80 });
 /**
  * Library version
  */
-export const VERSION = "1.3.4";
+export const VERSION = "1.3.6";
 
 // Export core classes
 export { Decimal, Matrix, Vector };

package/src/svg-toolbox-lib.js

@@ -5,7 +5,7 @@
  * Provides 69+ operations for cleaning, optimizing, and transforming SVG files.
  *
  * @module svg-toolbox-lib
- * @version 1.3.4
+ * @version 1.3.6
  * @license MIT
  *
  * @example Browser usage:
@@ -34,7 +34,7 @@ import * as SVGToolboxModule from "./svg-toolbox.js";
 /**
  * Library version
  */
-export const VERSION = "1.3.4";
+export const VERSION = "1.3.6";
 
 /**
  * Default export for browser global (window.SVGToolbox)

package/src/svg-toolbox.js

@@ -56,6 +56,14 @@ import {
   findElementsWithAttribute,
 } from "./svg-parser.js";
 import { flattenSVG } from "./flatten-pipeline.js";
+import {
+  validateInkscapeDocument,
+  detectInkscapeDocument,
+  getPolyfillRequirements,
+  InkscapeValidationSeverity,
+  INKSCAPE_ATTRIBUTES,
+  SODIPODI_ATTRIBUTES,
+} from "./inkscape-support.js";
 import {
   referencesProps as _referencesProps,
   inheritableAttrs,
@@ -266,6 +274,7 @@ const SVG11_ATTRIBUTES = new Set([
   "filter",
   "filterRes",
   "filterUnits",
+  "filterPrimitiveUnits",
   "flood-color",
   "flood-opacity",
   "font-family",
@@ -2845,6 +2854,175 @@ export const removeEmptyAttrs = createOperation((doc, _options = {}) => {
   return doc;
 });
 
+/**
+ * Convert Inkscape SVG to plain/standard SVG.
+ *
+ * This function removes all Inkscape-specific and Sodipodi-specific content
+ * from an SVG file, producing a clean SVG that conforms to SVG 1.1 or 2.0 specs.
+ *
+ * What gets removed:
+ * - All sodipodi:* elements (namedview, guide)
+ * - All inkscape:* elements (path-effect, perspective, page, grid, clipboard, box3dside)
+ * - All sodipodi:* attributes (nodetypes, type, cx, cy, rx, ry, start, end, etc.)
+ * - All inkscape:* attributes (groupmode, label, version, collect, etc.)
+ * - Inkscape/Sodipodi namespace declarations (xmlns:inkscape, xmlns:sodipodi)
+ * - SVG 1.2 flowText elements (flowRoot, flowPara, flowRegion, etc.) - Inkscape-specific
+ *
+ * What is preserved:
+ * - All standard SVG elements and attributes
+ * - Visual appearance (the SVG renders identically)
+ * - IDs, classes, and CSS styles
+ * - Standard namespaces (svg, xlink, xml)
+ *
+ * @param {Object} options - Conversion options
+ * @param {boolean} [options.removeFlowText=true] - Remove SVG 1.2 flowText elements (not browser-supported)
+ * @param {boolean} [options.removeEmptyDefs=true] - Remove empty <defs> elements after cleanup
+ * @param {boolean} [options.removeEmptyGroups=false] - Remove groups that become empty after stripping
+ * @returns {Object} The cleaned SVG document
+ *
+ * @example
+ * // Convert Inkscape SVG to plain SVG
+ * const plainSVG = convertToPlainSVG(doc);
+ *
+ * @example
+ * // Keep flowText elements (for manual conversion later)
+ * const plainSVG = convertToPlainSVG(doc, { removeFlowText: false });
+ */
+export const convertToPlainSVG = createOperation((doc, options = {}) => {
+  const {
+    removeFlowText = true,
+    removeEmptyDefs = true,
+    removeEmptyGroups = false,
+  } = options;
+
+  // Inkscape/Sodipodi namespace prefixes to remove
+  const inkscapePrefixes = ["inkscape", "sodipodi"];
+
+  // SVG 1.2 flowText elements (Inkscape-specific, not browser-supported)
+  const flowTextElements = [
+    "flowRoot",
+    "flowPara",
+    "flowRegion",
+    "flowSpan",
+    "flowDiv",
+    "flowLine",
+  ];
+
+  // STEP 1: Remove all Inkscape/Sodipodi namespaced elements
+  // Why: These elements are Inkscape UI data and not part of standard SVG
+  // Use [...el.children] to create a copy of the array before iterating (avoids live collection issues)
+  const removeInkscapeElements = (el) => {
+    for (const child of [...el.children]) {
+      if (isElement(child)) {
+        const tagColonIdx = child.tagName.indexOf(":");
+        if (tagColonIdx > 0) {
+          const prefix = child.tagName.substring(0, tagColonIdx);
+          if (inkscapePrefixes.includes(prefix)) {
+            el.removeChild(child);
+            continue;
+          }
+        }
+        // Recurse into non-inkscape children
+        removeInkscapeElements(child);
+      }
+    }
+  };
+  removeInkscapeElements(doc);
+
+  // STEP 2: Remove SVG 1.2 flowText elements if requested
+  // Why: flowText is from SVG 1.2 draft, only Inkscape supports it, no browsers do
+  if (removeFlowText) {
+    const removeFlowTextElements = (el) => {
+      for (const child of [...el.children]) {
+        if (isElement(child)) {
+          if (flowTextElements.includes(child.tagName)) {
+            el.removeChild(child);
+            continue;
+          }
+          removeFlowTextElements(child);
+        }
+      }
+    };
+    removeFlowTextElements(doc);
+  }
+
+  // STEP 3: Remove all Inkscape/Sodipodi namespaced attributes
+  // Why: These attributes store Inkscape editor state, not visual data
+  const removeInkscapeAttributes = (el) => {
+    for (const attrName of [...el.getAttributeNames()]) {
+      // Skip namespace declarations (handled in step 4)
+      if (attrName.startsWith("xmlns:")) continue;
+
+      const colonIdx = attrName.indexOf(":");
+      if (colonIdx > 0) {
+        const prefix = attrName.substring(0, colonIdx);
+        if (inkscapePrefixes.includes(prefix)) {
+          el.removeAttribute(attrName);
+        }
+      }
+    }
+
+    // Recurse into children
+    for (const child of el.children) {
+      if (isElement(child)) removeInkscapeAttributes(child);
+    }
+  };
+  removeInkscapeAttributes(doc);
+
+  // STEP 4: Remove Inkscape/Sodipodi namespace declarations from root SVG
+  // Why: After removing all prefixed elements/attributes, declarations are orphaned
+  for (const prefix of inkscapePrefixes) {
+    doc.removeAttribute(`xmlns:${prefix}`);
+  }
+
+  // STEP 5: Remove empty <defs> elements if requested
+  // Why: Inkscape often puts items in defs that are now removed
+  if (removeEmptyDefs) {
+    const removeEmptyDefsElements = (el) => {
+      for (const child of [...el.children]) {
+        if (isElement(child)) {
+          if (child.tagName === "defs" && child.children.length === 0) {
+            el.removeChild(child);
+          } else {
+            removeEmptyDefsElements(child);
+          }
+        }
+      }
+    };
+    removeEmptyDefsElements(doc);
+  }
+
+  // STEP 6: Remove empty groups if requested
+  // Why: Groups that only contained Inkscape elements may now be empty
+  if (removeEmptyGroups) {
+    const removeEmptyGroupElements = (el) => {
+      let changed = true;
+      // Iterate until no more changes (handles nested empty groups)
+      while (changed) {
+        changed = false;
+        for (const child of [...el.children]) {
+          if (isElement(child)) {
+            if (child.tagName === "g" && child.children.length === 0) {
+              // Only remove if no attributes that might matter (like id for references)
+              const hasId = child.hasAttribute("id");
+              const hasClass = child.hasAttribute("class");
+              if (!hasId && !hasClass) {
+                el.removeChild(child);
+                changed = true;
+              }
+            } else {
+              removeEmptyGroupElements(child);
+            }
+          }
+        }
+      }
+    };
+    removeEmptyGroupElements(doc);
+  }
+
+  return doc;
+});
+
 /**
  * Remove viewBox if matches dimensions
  */
@@ -13805,6 +13983,28 @@ export const fixInvalidSVG = createOperation((doc, options = {}) => {
               reason: `Element <${tagName}> is missing required attribute '${attr}' (or 'xlink:href')`,
             });
           }
+        } else if (tagName === "stop" && attr === "offset") {
+          // SVG 2 CR 2016 §13.8: Mesh gradient stops use 'path' attribute, NOT 'offset'
+          // Reference: https://www.w3.org/TR/2016/CR-SVG2-20160915/pservers.html
+          // Linear/radial gradient stops require 'offset', mesh stops use 'path' instead
+          let parent = el.parentNode;
+          let isMeshStop = false;
+          while (parent && parent.tagName) {
+            const parentTag = parent.tagName.toLowerCase();
+            if (parentTag === "meshpatch" || parentTag === "meshgradient") {
+              isMeshStop = true;
+              break;
+            }
+            parent = parent.parentNode;
+          }
+          if (!isMeshStop && !el.hasAttribute(attr)) {
+            fixes.push({
+              type: "missing_required_attribute",
+              element: tagName,
+              attr: attr,
+              reason: `Element <${tagName}> is missing required attribute '${attr}'`,
+            });
+          }
         } else {
           if (!el.hasAttribute(attr)) {
             fixes.push({
@@ -14171,6 +14371,7 @@ export const fixInvalidSVG = createOperation((doc, options = {}) => {
     maskUnits: ["userSpaceOnUse", "objectBoundingBox"],
     maskContentUnits: ["userSpaceOnUse", "objectBoundingBox"],
     filterUnits: ["userSpaceOnUse", "objectBoundingBox"],
+    filterPrimitiveUnits: ["userSpaceOnUse", "objectBoundingBox"],
     primitiveUnits: ["userSpaceOnUse", "objectBoundingBox"],
     markerUnits: ["strokeWidth", "userSpaceOnUse"],
     // Other
@@ -15392,6 +15593,8 @@ export async function validateSVGAsync(input, options = {}) {
   const outputFile = options.outputFile || null;
   const outputFormat = (options.outputFormat || "json").toLowerCase();
   const includeSource = options.includeSource === true;
+  const validateInkscape = options.validateInkscape === true;
+  const inkscapeStrict = options.inkscapeStrict === true;
 
   // Validate outputFormat
   const validFormats = ["text", "json", "xml", "yaml"];
@@ -16143,11 +16346,20 @@ export async function validateSVGAsync(input, options = {}) {
     // - title/desc (text content for accessibility - not SVG structure)
     // - metadata (can contain arbitrary XML metadata like Dublin Core, RDF)
     // - Namespaced elements (e.g., d:testDescription, rdf:RDF)
+    // - Elements in non-SVG namespaces (e.g., <foo xmlns="http://example.org/foo">)
     const isNamespacedElement = tagName.includes(":");
+    const isNonSvgNamespace =
+      el.namespaceURI && el.namespaceURI !== "http://www.w3.org/2000/svg";
+    // Check for explicit xmlns attribute declaring a non-SVG namespace
+    const xmlns = el.getAttribute ? el.getAttribute("xmlns") : null;
+    const hasNonSvgXmlns =
+      xmlns && xmlns !== "http://www.w3.org/2000/svg";
     const inNonSvgContext =
       insideNonSvgContext ||
       NON_SVG_CONTEXT_ELEMENTS.has(tagLower) ||
-      isNamespacedElement;
+      isNamespacedElement ||
+      isNonSvgNamespace ||
+      hasNonSvgXmlns;
 
     // Skip validation entirely if we're in non-SVG context
     if (!inNonSvgContext) {
@@ -16206,11 +16418,20 @@ export async function validateSVGAsync(input, options = {}) {
     // - title/desc (text content elements)
     // - metadata (arbitrary XML metadata content)
     // - Namespaced elements (e.g., d:testDescription, rdf:RDF)
+    // - Elements in non-SVG namespaces (e.g., <foo xmlns="http://example.org/foo">)
     const isNamespacedElement = el.tagName.includes(":");
+    const isNonSvgNamespace =
+      el.namespaceURI && el.namespaceURI !== "http://www.w3.org/2000/svg";
+    // Check for explicit xmlns attribute declaring a non-SVG namespace
+    const xmlns = el.getAttribute ? el.getAttribute("xmlns") : null;
+    const hasNonSvgXmlns =
+      xmlns && xmlns !== "http://www.w3.org/2000/svg";
     const inNonSvgContext =
       insideNonSvgContext ||
       NON_SVG_CONTEXT_ELEMENTS.has(tagName) ||
-      isNamespacedElement;
+      isNamespacedElement ||
+      isNonSvgNamespace ||
+      hasNonSvgXmlns;
 
     // Skip attribute validation entirely if we're in non-SVG context
     if (!inNonSvgContext) {
@@ -16336,6 +16557,26 @@ export async function validateSVGAsync(input, options = {}) {
         }
       } else {
         for (const attr of required) {
+          // SVG 2 CR 2016 §13.8: Mesh gradient stops use 'path' attribute, NOT 'offset'
+          // Reference: https://www.w3.org/TR/2016/CR-SVG2-20160915/pservers.html
+          // Quote: "offset - does not apply to mesh gradients"
+          //        "path - applies only to mesh gradients"
+          // The 'path' attribute contains a single c/C/l/L bezier command defining one edge
+          // of the Coons patch. Linear/radial gradient stops still require 'offset'.
+          if (tagName === "stop" && attr === "offset") {
+            // Check if this stop is inside a mesh gradient structure by walking up the tree
+            let parent = el.parentNode;
+            let isMeshStop = false;
+            while (parent && parent.tagName) {
+              const parentTag = parent.tagName.toLowerCase();
+              if (parentTag === "meshpatch" || parentTag === "meshgradient") {
+                isMeshStop = true;
+                break;
+              }
+              parent = parent.parentNode;
+            }
+            if (isMeshStop) continue; // Skip offset requirement - mesh stops use 'path' instead
+          }
           if (!el.hasAttribute(attr)) {
             issues.push(
               createIssue(
@@ -16446,6 +16687,7 @@ export async function validateSVGAsync(input, options = {}) {
     maskUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
     maskContentUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
     filterUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
+    filterPrimitiveUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
     primitiveUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
     patternUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
     patternContentUnits: new Set(["userSpaceOnUse", "objectBoundingBox"]),
@@ -17617,6 +17859,37 @@ export async function validateSVGAsync(input, options = {}) {
   detectEventHandlers(doc);
   detectAccessibilityIssues();
 
+  // Inkscape namespace validation (if enabled)
+  // Always use strict mode - a file either conforms to the spec or it doesn't
+  let inkscapeValidation = null;
+  if (validateInkscape && doc) {
+    inkscapeValidation = validateInkscapeDocument(doc, {
+      strict: true, // Always strict - unknown attributes are errors
+      warnFlowText: true,
+      checkPolyfillNeeds: true,
+    });
+    // Add Inkscape validation issues to the main issues array
+    for (const inkIssue of inkscapeValidation.issues) {
+      // Map Inkscape severity to ValidationSeverity
+      let severity = ValidationSeverity.INFO;
+      if (inkIssue.severity === InkscapeValidationSeverity.ERROR) {
+        severity = ValidationSeverity.ERROR;
+      } else if (inkIssue.severity === InkscapeValidationSeverity.WARNING) {
+        severity = ValidationSeverity.WARNING;
+      }
+      issues.push({
+        type: `inkscape-${inkIssue.type}`,
+        reason: inkIssue.message,
+        severity,
+        line: inkIssue.line || 1,
+        column: inkIssue.column || 1,
+        element: inkIssue.element || null,
+        attribute: inkIssue.attribute || null,
+        context: inkIssue.context || null,
+      });
+    }
+  }
+
   // Sort issues by line, then by column (for consistent, predictable output)
   issues.sort((a, b) => {
     if (a.line !== b.line) return a.line - b.line;
@@ -17657,6 +17930,19 @@ export async function validateSVGAsync(input, options = {}) {
     summary,
   };
 
+  // Add Inkscape-specific info if validation was performed
+  if (inkscapeValidation) {
+    result.inkscape = {
+      isInkscapeDocument: inkscapeValidation.isInkscape,
+      inkscapeVersion: inkscapeValidation.version || null,
+      polyfillsNeeded: inkscapeValidation.polyfillsNeeded || [],
+      hasFlowText: inkscapeValidation.hasFlowText || false,
+      inkscapeIssueCount: inkscapeValidation.issues.length,
+      inkscapeErrorCount: inkscapeValidation.summary.errors,
+      inkscapeWarningCount: inkscapeValidation.summary.warnings,
+    };
+  }
+
   // Export to file if requested
   if (outputFile) {
     try {
@@ -20349,7 +20635,7 @@ export default {
   removeEmptyText,
   removeEmptyContainers,
 
-  // Category 2: Removal (12)
+  // Category 2: Removal (13)
   removeDoctype,
   removeXMLProcInst,
   removeComments,
@@ -20362,6 +20648,7 @@ export default {
   removeXMLNS,
   removeRasterImages,
   removeScriptElement,
+  convertToPlainSVG,  // Converts Inkscape SVG to plain/standard SVG
 
   // Category 3: Conversion (10)
   convertShapesToPath,

package/src/svg-validation-data.js

@@ -151,6 +151,7 @@ export const SVG11_ATTRIBUTES = new Set([
   "filter",
   "filterres",
   "filterunits",
+  "filterprimitiveunits",
   "flood-color",
   "flood-opacity",
   "font-family",

package/src/svgm-lib.js

@@ -5,7 +5,7 @@
  * comprehensive SVG manipulation (SVGToolbox). Works in Node.js and browser.
  *
  * @module svgm-lib
- * @version 1.3.4
+ * @version 1.3.6
  * @license MIT
  *
  * @example Browser usage:
@@ -49,7 +49,7 @@ Decimal.set({ precision: 80 });
 /**
  * Library version
  */
-export const VERSION = "1.3.4";
+export const VERSION = "1.3.6";
 
 // Export math classes
 export { Decimal, Matrix, Vector };