@emasoft/svg-matrix 1.0.28 → 1.0.30

package/src/index.js

@@ -5,13 +5,19 @@
  * SVG path conversion, and 2D/3D affine transformations using Decimal.js.
  *
  * @module @emasoft/svg-matrix
- * @version 1.0.28
+ * @version 1.0.30
  * @license MIT
  *
  * @example
- * // ES Module import
+ * // ES Module import - Core functionality
  * import { Decimal, Matrix, Vector, Transforms2D, GeometryToPath } from '@emasoft/svg-matrix';
  *
+ * // SVG2 Polyfills - Detect and inject polyfills for mesh gradients and hatches
+ * import { detectSVG2Features, injectPolyfills } from '@emasoft/svg-matrix';
+ *
+ * // Inkscape Support - Extract layers and preserve Inkscape metadata
+ * import { findLayers, extractLayer, extractAllLayers } from '@emasoft/svg-matrix';
+ *
  * // Precision is already set to 80 by default (max is 1e9)
  * // You can increase it further if needed:
  * // Decimal.set({ precision: 200 });
@@ -28,55 +34,97 @@
  * const path = GeometryToPath.circleToPathData(100, 100, 50, 15);
  */
 
-import Decimal from 'decimal.js';
-import { Matrix } from './matrix.js';
-import { Vector } from './vector.js';
-import * as Transforms2D from './transforms2d.js';
-import * as Transforms3D from './transforms3d.js';
-import * as GeometryToPath from './geometry-to-path.js';
-import * as PolygonClip from './polygon-clip.js';
-import * as SVGFlatten from './svg-flatten.js';
-import * as BrowserVerify from './browser-verify.js';
-import * as ClipPathResolver from './clip-path-resolver.js';
-import * as MaskResolver from './mask-resolver.js';
-import * as PatternResolver from './pattern-resolver.js';
-import * as UseSymbolResolver from './use-symbol-resolver.js';
-import * as MarkerResolver from './marker-resolver.js';
-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';
+import Decimal from "decimal.js";
+import { Matrix } from "./matrix.js";
+import { Vector } from "./vector.js";
+import * as Transforms2D from "./transforms2d.js";
+import * as Transforms3D from "./transforms3d.js";
+import * as GeometryToPath from "./geometry-to-path.js";
+import * as PolygonClip from "./polygon-clip.js";
+import * as SVGFlatten from "./svg-flatten.js";
+import * as BrowserVerify from "./browser-verify.js";
+import * as ClipPathResolver from "./clip-path-resolver.js";
+import * as MaskResolver from "./mask-resolver.js";
+import * as PatternResolver from "./pattern-resolver.js";
+import * as UseSymbolResolver from "./use-symbol-resolver.js";
+import * as MarkerResolver from "./marker-resolver.js";
+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 {
+  INKSCAPE_NS,
+  SODIPODI_NS,
+  INKSCAPE_PREFIXES,
+  isInkscapeLayer,
+  getLayerLabel,
+  findLayers,
+  getNamedViewSettings,
+  findGuides,
+  getArcParameters,
+  getNodeTypes,
+  getExportSettings,
+  isTiledClone,
+  getTiledCloneSource,
+  hasInkscapeNamespaces,
+  ensureInkscapeNamespaces,
+  findReferencedIds,
+  buildDefsMapFromDefs,
+  resolveDefsDependencies,
+  cloneElement,
+  extractLayer,
+  extractAllLayers,
+  analyzeLayerDependencies,
+} from "./inkscape-support.js";
+
+import * as SVG2Polyfills from "./svg2-polyfills.js";
+import {
+  setPolyfillMinification,
+  SVG2_FEATURES,
+  detectSVG2Features,
+  needsPolyfills,
+  generatePolyfillScript,
+  injectPolyfills,
+  removePolyfills,
+} from "./svg2-polyfills.js";
+
+import {
+  Logger,
+  LogLevel,
+  setLogLevel,
+  getLogLevel as _getLoggerLevel,
+  enableFileLogging,
+  disableFileLogging,
+} from "./logger.js";
 
 // SVGO-inspired precision modules
-import * as PathSimplification from './path-simplification.js';
-import * as TransformDecomposition from './transform-decomposition.js';
-import * as GJKCollision from './gjk-collision.js';
-import * as PathOptimization from './path-optimization.js';
-import * as TransformOptimization from './transform-optimization.js';
-import * as OffCanvasDetection from './off-canvas-detection.js';
-import * as CSSSpecificity from './css-specificity.js';
+import * as PathSimplification from "./path-simplification.js";
+import * as TransformDecomposition from "./transform-decomposition.js";
+import * as GJKCollision from "./gjk-collision.js";
+import * as PathOptimization from "./path-optimization.js";
+import * as TransformOptimization from "./transform-optimization.js";
+import * as OffCanvasDetection from "./off-canvas-detection.js";
+import * as CSSSpecificity from "./css-specificity.js";
 
 // Animation-aware reference tracking (FIXES SVGO's animation destruction bug)
-import * as AnimationReferences from './animation-references.js';
+import * as AnimationReferences from "./animation-references.js";
 
 // SVG Toolbox - SVGO-equivalent functions with simple API
-import * as SVGToolbox from './svg-toolbox.js';
+import * as SVGToolbox from "./svg-toolbox.js";
 
 // Bezier Curve Analysis - svgpathtools-equivalent with 80-digit arbitrary precision
 // These modules provide superior precision compared to Python's float64 svgpathtools
-import * as BezierAnalysis from './bezier-analysis.js';
-import * as ArcLength from './arc-length.js';
-import * as PathAnalysis from './path-analysis.js';
-import * as BezierIntersections from './bezier-intersections.js';
+import * as BezierAnalysis from "./bezier-analysis.js";
+import * as ArcLength from "./arc-length.js";
+import * as PathAnalysis from "./path-analysis.js";
+import * as BezierIntersections from "./bezier-intersections.js";
 
 // SVG Boolean Operations - fill-rule and stroke-aware geometric operations
-import * as SVGBooleanOps from './svg-boolean-ops.js';
+import * as SVGBooleanOps from "./svg-boolean-ops.js";
 
 // SVG Rendering Context - tracks ALL SVG properties affecting rendered geometry
-import * as SVGRenderingContext from './svg-rendering-context.js';
+import * as SVGRenderingContext from "./svg-rendering-context.js";
 
 // Set high-precision default (80 significant digits) on module load
 // This is the same precision used internally by all svg-matrix modules
@@ -87,7 +135,7 @@ Decimal.set({ precision: 80 });
  * Library version
  * @constant {string}
  */
-export const VERSION = '1.0.28';
+export const VERSION = '1.0.30';
 
 /**
  * Default precision for path output (decimal places)
@@ -223,8 +271,8 @@ export {
   removeAttrs,
   removeElementsByAttr,
   // Presets
-  preset_default,
-  preset_none,
+  presetDefault,
+  presetNone,
   applyPreset,
   optimize,
   createConfig,
@@ -238,14 +286,55 @@ export {
   imageToPath,
   detectCollisions,
   measureDistance,
+  validateXML,
   validateSVG,
-  validateSvg,
-  fixInvalidSvg,
+  fixInvalidSVG,
   ValidationSeverity,
   flattenAll,
   simplifyPath,
+  optimizeAnimationTiming,
+  optimizePaths,
+  simplifyPaths,
   decomposeTransform,
-} from './svg-toolbox.js';
+  embedExternalDependencies,
+} from "./svg-toolbox.js";
+
+// Re-export all svg2-polyfills functions for direct access
+export {
+  setPolyfillMinification,
+  SVG2_FEATURES,
+  detectSVG2Features,
+  needsPolyfills,
+  generatePolyfillScript,
+  injectPolyfills,
+  removePolyfills,
+} from "./svg2-polyfills.js";
+
+// Re-export all inkscape-support functions for direct access
+export {
+  INKSCAPE_NS,
+  SODIPODI_NS,
+  INKSCAPE_PREFIXES,
+  isInkscapeLayer,
+  getLayerLabel,
+  findLayers,
+  getNamedViewSettings,
+  findGuides,
+  getArcParameters,
+  getNodeTypes,
+  getExportSettings,
+  isTiledClone,
+  getTiledCloneSource,
+  hasInkscapeNamespaces,
+  ensureInkscapeNamespaces,
+  findReferencedIds,
+  buildDefsMapFromDefs,
+  resolveDefsDependencies,
+  cloneElement,
+  extractLayer,
+  extractAllLayers,
+  analyzeLayerDependencies,
+} from "./inkscape-support.js";
 
 // ============================================================================
 // LOGGING: Configurable logging control
@@ -375,8 +464,25 @@ export function ellipseToPath(cx, cy, rx, ry, precision = DEFAULT_PRECISION) {
  * @param {number} [precision=6] - Number of decimal places in output
  * @returns {string} SVG path data string
  */
-export function rectToPath(x, y, width, height, rx = 0, ry = null, precision = DEFAULT_PRECISION) {
-  return GeometryToPath.rectToPathData(x, y, width, height, rx, ry, false, precision);
+export function rectToPath(
+  x,
+  y,
+  width,
+  height,
+  rx = 0,
+  ry = null,
+  precision = DEFAULT_PRECISION,
+) {
+  return GeometryToPath.rectToPathData(
+    x,
+    y,
+    width,
+    height,
+    rx,
+    ry,
+    false,
+    precision,
+  );
 }
 
 /**
@@ -583,6 +689,39 @@ export default {
   InkscapeSupport,
   SVG2Polyfills,
 
+  // SVG2 Polyfills - individual exports
+  setPolyfillMinification,
+  SVG2_FEATURES,
+  detectSVG2Features,
+  needsPolyfills,
+  generatePolyfillScript,
+  injectPolyfills,
+  removePolyfills,
+
+  // Inkscape Support - individual exports
+  INKSCAPE_NS,
+  SODIPODI_NS,
+  INKSCAPE_PREFIXES,
+  isInkscapeLayer,
+  getLayerLabel,
+  findLayers,
+  getNamedViewSettings,
+  findGuides,
+  getArcParameters,
+  getNodeTypes,
+  getExportSettings,
+  isTiledClone,
+  getTiledCloneSource,
+  hasInkscapeNamespaces,
+  ensureInkscapeNamespaces,
+  findReferencedIds,
+  buildDefsMapFromDefs,
+  resolveDefsDependencies,
+  cloneElement,
+  extractLayer,
+  extractAllLayers,
+  analyzeLayerDependencies,
+
   // Logging
   Logger,
   LogLevel,
@@ -611,6 +750,12 @@ export default {
   PathAnalysis,
   BezierIntersections,
 
+  // SVG Boolean Operations (fill-rule and stroke-aware)
+  SVGBooleanOps,
+
+  // SVG Rendering Context (tracks all SVG properties affecting geometry)
+  SVGRenderingContext,
+
   // Convenience functions
   translate2D,
   rotate2D,

package/src/inkscape-support.js

@@ -25,6 +25,8 @@ export const INKSCAPE_PREFIXES = ['inkscape', 'sodipodi'];
  */
 export function isInkscapeLayer(element) {
   if (!element || element.tagName !== 'g') return false;
+  // Safety check: ensure getAttribute method exists before calling it
+  if (typeof element.getAttribute !== 'function') return false;
   return element.getAttribute('inkscape:groupmode') === 'layer';
 }
 
@@ -223,7 +225,9 @@ export function getTiledCloneSource(element) {
  * @returns {boolean} True if Inkscape namespaces are present
  */
 export function hasInkscapeNamespaces(doc) {
+  if (!doc) return false;
   const svg = doc.documentElement || doc;
+  if (!svg || typeof svg.getAttribute !== 'function') return false;
   const hasInkscape = svg.getAttribute('xmlns:inkscape') === INKSCAPE_NS;
   const hasSodipodi = svg.getAttribute('xmlns:sodipodi') === SODIPODI_NS;
   return hasInkscape || hasSodipodi;
@@ -239,6 +243,11 @@ export function hasInkscapeNamespaces(doc) {
 export function ensureInkscapeNamespaces(doc) {
   const svg = doc.documentElement || doc;
 
+  // Safety check: ensure getAttribute and setAttribute methods exist
+  if (typeof svg.getAttribute !== 'function' || typeof svg.setAttribute !== 'function') {
+    return doc;
+  }
+
   if (!svg.getAttribute('xmlns:inkscape')) {
     svg.setAttribute('xmlns:inkscape', INKSCAPE_NS);
   }
@@ -332,7 +341,7 @@ export function findReferencedIds(element) {
  * @param {Object} doc - Parsed SVG document
  * @returns {Map<string, Object>} Map of ID to element
  */
-export function buildDefsMap(doc) {
+export function buildDefsMapFromDefs(doc) {
   const defsMap = new Map();
 
   const walk = (el) => {
@@ -462,8 +471,8 @@ export function extractLayer(doc, layerOrId, options = {}) {
   if (typeof layerOrId === 'string') {
     const layers = findLayers(doc);
     const found = layers.find(l => l.id === layerOrId || l.label === layerOrId);
-    if (!found) {
-      throw new Error(`Layer not found: ${layerOrId}`);
+    if (!found || !found.element) {
+      throw new Error(`Layer not found or invalid: ${layerOrId}`);
     }
     layer = found.element;
   } else {
@@ -478,7 +487,7 @@ export function extractLayer(doc, layerOrId, options = {}) {
   const svgRoot = doc.documentElement || doc;
 
   // Build defs map from source document
-  const defsMap = buildDefsMap(doc);
+  const defsMap = buildDefsMapFromDefs(doc);
 
   // Find all IDs referenced by this layer
   const referencedIds = findReferencedIds(layer);
@@ -508,8 +517,10 @@ export function extractLayer(doc, layerOrId, options = {}) {
         defsChildren.push(cloneElement(defElement));
       }
     }
-    const newDefs = new SVGElement('defs', {}, defsChildren, null);
-    svgChildren.push(newDefs);
+    if (defsChildren.length > 0) {
+      const newDefs = new SVGElement('defs', {}, defsChildren, null);
+      svgChildren.push(newDefs);
+    }
   }
 
   // Clone the layer
@@ -586,7 +597,7 @@ export function extractAllLayers(doc, options = {}) {
  */
 export function analyzeLayerDependencies(doc) {
   const layers = findLayers(doc);
-  const defsMap = buildDefsMap(doc);
+  const defsMap = buildDefsMapFromDefs(doc);
   const layerRefs = new Map(); // layer ID -> Set of referenced def IDs
   const defUsage = new Map();  // def ID -> Set of layer IDs that use it