svg_conform 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43ff84b9d1f47a6a2bd92624483c0445bd3f77d29f0fc36f2c02116a40111bc2
-  data.tar.gz: be072c8772885cd746ee623e028e00517dfcac93250a00f4015cb7122d94739a
+  metadata.gz: 24fb1d016b5e3ed96b2da518c95884fac16a47b18cd8566e129d81b49791fb32
+  data.tar.gz: ad67c207d5f1489855772d6c8931ea4dd8277b041a2a791ceebb6fe2af63ff36
 SHA512:
-  metadata.gz: 0ee8ad3bfab5a2aec10b32caa23141967aa25112e0393ed39242ab83a5f123bb317190392df347f7f4a8665af61bf7de4b09eb3283c4c140e372af1177ba924b
-  data.tar.gz: 20d1871024c131298aa2462bd849e07dfb16b73f2f61913da8f9c2d21b43e87fcfe5ae6ed298971091c0f85734efe8a36790432ccdb18c8878dafc25d238a348
+  metadata.gz: fa0cdaf7dcd0ed01c23d334ed2d92e1674954a9fce8aed9aad85fd884a2949a6da81cec006607005971d61093384076d2797f72204a7362bad94a8fb882712e2
+  data.tar.gz: c6e9af1cba1fb25edbf89ed1ddc77261b4c8a3d068f79d1b56553d5636114f8a493b48dcbaa8a125c99319a043cbfbc5737be77dbe6054f9145a02ddeb94e37a

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-11-18 13:36:55 UTC using RuboCop version 1.81.1.
+# on 2025-11-19 10:52:11 UTC using RuboCop version 1.81.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -16,61 +16,10 @@ Layout/BlockAlignment:
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment.
-Layout/CommentIndentation:
-  Exclude:
-    - 'lib/svg_conform/validation_context.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ElseAlignment:
-  Exclude:
-    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
-
-# Offense count: 17
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLineAfterGuardClause:
-  Exclude:
-    - 'analyze_error_nodes.rb'
-    - 'check_duplicates.rb'
-    - 'check_position_collisions.rb'
-    - 'check_unique_positions.rb'
-    - 'compare_errors.rb'
-    - 'debug_object_ids.rb'
-    - 'debug_utf8.rb'
-    - 'find_all_elements.rb'
-    - 'find_missing_errors.rb'
-    - 'lib/svg_conform/fast_document_analyzer.rb'
-    - 'lib/svg_conform/node_index_builder.rb'
-    - 'lib/svg_conform/requirements/id_reference_requirement.rb'
-    - 'lib/svg_conform/sax_validation_handler.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith, Severity.
-# SupportedStylesAlignWith: keyword, variable, start_of_line
-Layout/EndAlignment:
-  Exclude:
-    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
-
-# Offense count: 21
-# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
 Layout/ExtraSpacing:
   Exclude:
-    - 'find_missing_errors.rb'
-    - 'lib/svg_conform/element_proxy.rb'
-    - 'lib/svg_conform/requirements/id_reference_requirement.rb'
-    - 'lib/svg_conform/requirements/invalid_id_references_requirement.rb'
-    - 'lib/svg_conform/sax_validation_handler.rb'
-    - 'lib/svg_conform/validation_context.rb'
-    - 'lib/svg_conform/validator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/HeredocIndentation:
-  Exclude:
-    - 'test_sax_basic.rb'
+    - 'lib/svg_conform/requirements/no_external_css_requirement.rb'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
@@ -78,52 +27,15 @@ Layout/HeredocIndentation:
 # SupportedStyles: normal, indented_internal_methods
 Layout/IndentationConsistency:
   Exclude:
-    - 'lib/svg_conform/validation_context.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, AllowedPatterns.
-Layout/IndentationWidth:
-  Exclude:
-    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+    - 'lib/svg_conform/profile.rb'
 
-# Offense count: 604
+# Offense count: 616
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 28
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment, EnforcedStyleForExponentOperator, EnforcedStyleForRationalLiterals.
-# SupportedStylesForExponentOperator: space, no_space
-# SupportedStylesForRationalLiterals: space, no_space
-Layout/SpaceAroundOperators:
-  Exclude:
-    - 'benchmark_sax.rb'
-    - 'benchmark_validation.rb'
-    - 'check_clippath_font.rb'
-    - 'check_unique_positions.rb'
-    - 'count_elements.rb'
-    - 'final_demo.rb'
-    - 'test_remediation.rb'
-
-# Offense count: 32
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowInHeredoc.
-Layout/TrailingWhitespace:
-  Exclude:
-    - 'analyze_error_nodes.rb'
-    - 'check_clippath_font.rb'
-    - 'debug_positions.rb'
-    - 'debug_utf8.rb'
-    - 'final_demo.rb'
-    - 'find_missing_errors.rb'
-    - 'lib/svg_conform/fast_document_analyzer.rb'
-    - 'lib/svg_conform/sax_document.rb'
-    - 'test_sax_basic.rb'
-
 # Offense count: 2
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -131,10 +43,11 @@ Lint/ConstantDefinitionInBlock:
   Exclude:
     - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
-# Offense count: 19
+# Offense count: 22
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
+    - 'lib/svg_conform/profile.rb'
     - 'lib/svg_conform/remediations/font_embedding_remediation.rb'
     - 'lib/svg_conform/remediations/image_embedding_remediation.rb'
     - 'lib/svg_conform/report_comparator.rb'
@@ -154,12 +67,6 @@ Lint/DuplicateMethods:
     - 'lib/svg_conform/sax_validation_handler.rb'
     - 'lib/svg_conform/validation_context.rb'
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Lint/IdentityComparison:
-  Exclude:
-    - 'lib/svg_conform/fast_document_analyzer.rb'
-
 # Offense count: 4
 # Configuration parameters: AllowedParentClasses.
 Lint/MissingSuper:
@@ -168,43 +75,25 @@ Lint/MissingSuper:
     - 'lib/svg_conform/compatibility/validity_analysis.rb'
     - 'lib/svg_conform/sax_validation_handler.rb'
 
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-Lint/ScriptPermission:
-  Exclude:
-    - 'benchmark_validation.rb'
-    - 'final_demo.rb'
-    - 'test_remediation.rb'
-
 # Offense count: 1
 Lint/UnreachableCode:
   Exclude:
     - 'lib/svg_conform/commands/check.rb'
 
-# Offense count: 4
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
 Lint/UnusedMethodArgument:
   Exclude:
-    - 'lib/svg_conform/element_proxy.rb'
-    - 'lib/svg_conform/requirements/id_reference_requirement.rb'
-    - 'lib/svg_conform/requirements/invalid_id_references_requirement.rb'
-    - 'lib/svg_conform/sax_validation_handler.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: ContextCreatingMethods, MethodCreatingMethods.
-Lint/UselessAccessModifier:
-  Exclude:
-    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+    - 'lib/svg_conform/requirements/no_external_css_requirement.rb'
 
-# Offense count: 147
+# Offense count: 148
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 21
+# Offense count: 22
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
@@ -215,12 +104,12 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 125
+# Offense count: 126
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 257
+# Offense count: 261
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 154
@@ -249,12 +138,6 @@ Performance/CollectionLiteralInLoop:
     - 'lib/svg_conform/batch_report.rb'
     - 'lib/svg_conform/compatibility/pattern_discovery.rb'
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Performance/UnfreezeString:
-  Exclude:
-    - 'lib/svg_conform/element_proxy.rb'
-
 # Offense count: 8
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
@@ -273,7 +156,7 @@ RSpec/DescribeClass:
     - 'spec/svg_conform/profiles/svg_1_2_rfc_with_rdf_profile_spec.rb'
     - 'spec/svgcheck_compatibility_spec.rb'
 
-# Offense count: 106
+# Offense count: 109
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 53
@@ -288,7 +171,7 @@ RSpec/MultipleDescribes:
   Exclude:
     - 'spec/svg_conform/batch_report_spec.rb'
 
-# Offense count: 71
+# Offense count: 73
 RSpec/MultipleExpectations:
   Max: 6
 
@@ -297,14 +180,6 @@ Rake/MethodDefinitionInTask:
   Exclude:
     - 'lib/tasks/svgcheck.rake'
 
-# Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/CombinableLoops:
-  Exclude:
-    - 'check_duplicates.rb'
-    - 'compare_errors.rb'
-    - 'find_missing_errors.rb'
-
 # Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, AllowComments.
@@ -326,19 +201,6 @@ Style/MissingRespondToMissing:
   Exclude:
     - 'lib/svg_conform/cli.rb'
 
-# Offense count: 6
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
-# SupportedStyles: predicate, comparison
-Style/NumericPredicate:
-  Exclude:
-    - 'spec/**/*'
-    - 'benchmark_validation.rb'
-    - 'check_unique_positions.rb'
-    - 'lib/svg_conform/validation_context.rb'
-    - 'test_remediation.rb'
-    - 'test_sax_basic.rb'
-
 # Offense count: 4
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: respond_to_missing?
@@ -346,12 +208,6 @@ Style/OptionalBooleanParameter:
   Exclude:
     - 'lib/svg_conform/semantic_comparator.rb'
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/RedundantAssignment:
-  Exclude:
-    - 'lib/svg_conform/fast_document_analyzer.rb'
-
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowedMethods.
@@ -360,87 +216,9 @@ Style/RedundantCondition:
   Exclude:
     - 'lib/svg_conform/external_checkers/svgcheck/parser.rb'
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/RedundantInterpolation:
-  Exclude:
-    - 'analyze_error_nodes.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: implicit, explicit
-Style/RescueStandardError:
-  Exclude:
-    - 'debug_node_coverage.rb'
-    - 'test_sax_basic.rb'
-
 # Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: ConvertCodeThatCanStartToReturnNil, AllowedMethods, MaxChainLength.
-# AllowedMethods: present?, blank?, presence, try, try!
-Style/SafeNavigation:
-  Exclude:
-    - 'count_elements.rb'
-    - 'lib/svg_conform/fast_document_analyzer.rb'
-
-# Offense count: 4
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: Mode.
-Style/StringConcatenation:
-  Exclude:
-    - 'benchmark_sax.rb'
-    - 'benchmark_validation.rb'
-    - 'final_demo.rb'
-    - 'test_remediation.rb'
-
-# Offense count: 78
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
-  Enabled: false
-
-# Offense count: 34
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInArguments:
+# Configuration parameters: AllowMultipleReturnValues.
+Style/RedundantReturn:
   Exclude:
-    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
-    - 'lib/svg_conform/requirements/color_restrictions_requirement.rb'
-    - 'lib/svg_conform/requirements/font_family_requirement.rb'
-    - 'lib/svg_conform/requirements/forbidden_content_requirement.rb'
-    - 'lib/svg_conform/requirements/id_reference_requirement.rb'
-    - 'lib/svg_conform/requirements/invalid_id_references_requirement.rb'
-    - 'lib/svg_conform/requirements/link_validation_requirement.rb'
-    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
-    - 'lib/svg_conform/requirements/namespace_requirement.rb'
-    - 'lib/svg_conform/requirements/no_external_css_requirement.rb'
-    - 'lib/svg_conform/requirements/no_external_fonts_requirement.rb'
-    - 'lib/svg_conform/requirements/no_external_images_requirement.rb'
-    - 'lib/svg_conform/requirements/viewbox_required_requirement.rb'
-    - 'lib/svg_conform/sax_validation_handler.rb'
-    - 'lib/svg_conform/validator.rb'
-
-# Offense count: 12
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInHashLiteral:
-  Exclude:
-    - 'debug_positions.rb'
-    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
-    - 'lib/svg_conform/requirements/color_restrictions_requirement.rb'
-    - 'lib/svg_conform/requirements/namespace_requirement.rb'
-    - 'lib/svg_conform/requirements/viewbox_required_requirement.rb'
-    - 'lib/svg_conform/validator.rb'
-
-# Offense count: 4
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/ZeroLengthPredicate:
-  Exclude:
-    - 'benchmark_validation.rb'
-    - 'lib/svg_conform/validation_context.rb'
-    - 'test_remediation.rb'
-    - 'test_sax_basic.rb'
+    - 'lib/svg_conform/profile.rb'

data/README.adoc

@@ -1364,6 +1364,61 @@ $ svg_conform svgcheck compare diagram.svg --svgcheck-report diagram.svg.svgchec
 ====
 
 
+
+== Performance
+
+=== SAX streaming validation
+
+SvgConform implements SAX (Simple API for XML) streaming validation for
+high-performance processing of large SVG files.
+
+Performance characteristics:
+
+* Small files (<1 MB): ~0.5s validation time
+* Medium files (1-5 MB): ~1s validation time (vs 60-80s with DOM)
+* Large files (>5 MB): ~2s validation time (vs minutes-hours with DOM)
+
+Real-world samples results:
+
+* 5.93 MB file: >` 60s → 1.89s (30x faster)
+* 4.57 MB file: >60s → 1.37s (40x faster)
+* 3.44 MB file: >60s → 0.29s (200x faster)
+
+How it works:
+
+SAX streaming validation processes XML events without building a full DOM tree
+in memory. This provides:
+
+* Forward-only processing: Single pass through XML stream
+* Constant memory: No full DOM tree in memory
+* Predictable performance: O(n) complexity guaranteed
+* No object identity issues: Path-based node identification
+
+Mode selection:
+
+By default, SAX mode is used for all validation operations. DOM mode is
+automatically used when remediation is requested (`fix: true`).
+
+[source,ruby]
+----
+# Default: SAX mode (best performance)
+validator = SvgConform::Validator.new
+result = validator.validate_file('large.svg', profile: :metanorma)
+
+# Explicit mode selection
+validator_sax = SvgConform::Validator.new(mode: :sax)  # Force SAX
+validator_dom = SvgConform::Validator.new(mode: :dom)  # Force DOM
+validator_auto = SvgConform::Validator.new(mode: :auto)  # File size based (>1MB uses SAX)
+----
+
+Validation parity:
+
+SAX mode produces identical validation results to DOM mode on 18/19 test files
+(94.7% parity). The one exception is `full-tiny.svg`, a comprehensive test file
+with known architectural differences.
+
+
+
 == Testing
 
 Run the test suite:

data/lib/svg_conform/element_proxy.rb

@@ -11,7 +11,7 @@ module SvgConform
     end
 
     def namespace
-      nil  # Simplified for now
+      nil # DOM handles namespaces via XPath; SAX checks attribute names directly
     end
   end
 
@@ -24,12 +24,12 @@ module SvgConform
 
     def initialize(name:, attributes:, position:, path:, parent:)
       @name = name
-      @raw_attributes = attributes  # Hash of attribute name => value
+      @raw_attributes = attributes # Hash of attribute name => value
       @position = position
-      @path = path  # Array of parent path parts
+      @path = path # Array of parent path parts
       @parent = parent
-      @text_content = String.new  # Mutable string
-      @child_counters = {}  # Track child element positions
+      @text_content = +"" # Mutable string
+      @child_counters = {} # Track child element positions
     end
 
     # Build full path ID for this element
@@ -61,7 +61,7 @@ module SvgConform
 
     # Get namespace from attributes or parent
     def namespace
-      @raw_attributes['xmlns'] || @parent&.namespace
+      @raw_attributes["xmlns"] || @parent&.namespace
     end
 
     # Check if this is a text node (always false for ElementProxy)
@@ -70,10 +70,10 @@ module SvgConform
     end
 
     # Support dynamic attribute access
-    def method_missing(method, *args)
-      if method.to_s.end_with?('?')
+    def method_missing(method, *_args)
+      if method.to_s.end_with?("?")
         # Boolean check
-        has_attribute?(method.to_s.chomp('?'))
+        has_attribute?(method.to_s.chomp("?"))
       else
         # Attribute access
         @attributes[method.to_s] || @attributes[method.to_sym]
@@ -86,7 +86,7 @@ module SvgConform
 
     # For compatibility with validation context
     def line
-      nil  # SAX doesn't provide line numbers easily
+      nil # SAX doesn't provide line numbers easily
     end
 
     def column

data/lib/svg_conform/fast_document_analyzer.rb

@@ -3,79 +3,79 @@
 module SvgConform
   # Fast document analyzer that pre-computes node relationships and IDs
   # in a single pass to avoid repeated expensive traversals
-  # 
+  #
   # IMPORTANT: Stores paths indexed by the path itself (not object_id)
   # since node object_ids change between traversals
   class FastDocumentAnalyzer
     attr_reader :path_cache
-    
+
     def initialize(document)
       @document = document
       @path_cache = {}
-      
+
       analyze_document
     end
-    
+
     # Get cached path-based ID for a node by computing its path once
     def get_node_id(node)
       return nil unless node.respond_to?(:name) && node.name
-      
+
       # Compute path for this node (fast with forward traversal counting)
-      path = compute_path_forward(node)
-      path
+      compute_path_forward(node)
     end
-    
+
     private
-    
+
     def analyze_document
       # Pre-populate cache is not needed since we compute on demand
       # The optimization comes from forward-counting siblings instead of backward
     end
-    
+
     def compute_path_forward(node)
       path_parts = []
       current = node
-      
+
       while current
         if current.respond_to?(:name) && current.name
           # Count position among siblings by iterating forward from parent
           position = calculate_position_fast(current)
           path_parts.unshift("#{current.name}[#{position}]")
         end
-        
+
         break unless current.respond_to?(:parent)
-        
+
         begin
           current = current.parent
         rescue NoMethodError
           break
         end
-        
+
         break unless current
       end
-      
+
       "/#{path_parts.join('/')}"
     end
-    
+
     def calculate_position_fast(node)
       return 1 unless node.respond_to?(:parent)
-      
+
       parent = begin
         node.parent
       rescue NoMethodError
         nil
       end
-      
-      return 1 unless parent && parent.respond_to?(:children)
-      
+
+      return 1 unless parent.respond_to?(:children)
+
       # Count this node's position among siblings with same name
       position = 0
       parent.children.each do |child|
         next unless child.respond_to?(:name) && child.name == node.name
+
         position += 1
-        break if child.object_id == node.object_id
+        break if child.equal?(node)
       end
-      
+
       position
     end
   end

data/lib/svg_conform/node_index_builder.rb

@@ -39,6 +39,7 @@ module SvgConform
         node.children.each do |child|
           # Only process nodes with name (skip text nodes, etc.)
           next unless child.respond_to?(:name) && child.name
+
           build_index(child, child_counter)
         end
       end

data/lib/svg_conform/profile.rb

@@ -114,19 +114,34 @@ module SvgConform
     end
 
     def validate(document)
-      context = ValidationContext.new(document, self)
+      # Use SAX mode for validation performance
+      # Convert document to content string if it's a DOM document
+      if document.is_a?(Document)
+        content = document.to_xml
+        sax_doc = SaxDocument.from_content(content)
+       return sax_doc.validate_with_profile(self)
+      elsif document.respond_to?(:to_xml)
+        # Handle any document-like object
+        content = document.to_xml
+        sax_doc = SaxDocument.from_content(content)
+        return sax_doc.validate_with_profile(self)
+      else
+        # Fallback to DOM mode for backward compatibility
+        context = ValidationContext.new(document, self)
+
+        # Validate using requirements system
+        requirements&.each do |requirement|
+          requirement.validate_document(document, context)
+        end
 
-      # Validate using requirements system
-      requirements&.each do |requirement|
-        requirement.validate_document(document, context)
+        return ValidationResult.new(document, self, context)
       end
-
-      ValidationResult.new(document, self, context)
     end
 
     def validate_file(file_path)
-      document = Document.from_file(file_path)
-      validate(document)
+      # Use SAX mode directly
+      sax_doc = SaxDocument.from_file(file_path)
+      sax_doc.validate_with_profile(self)
     end
 
     # Apply remediations to a document after validation