svg_conform 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccf420a3e00222240dcc3f07c6af8ca2433e1e355fc2d14a3f250c81dc8accf0
-  data.tar.gz: 1adfc48ed569e13d1d4f0929e22558bde3abb8239cd19f4f95f7a5e86321db7a
+  metadata.gz: c862af872ab16b243d9f6ffaedb7c5a37e8c470a5280915cc96bc33a3572c8e5
+  data.tar.gz: 3b5fbeebd207eb29ac9685a8913799cc8239704566d9efd8b18fa663bf55a8d0
 SHA512:
-  metadata.gz: 7c71c121b3e79519ab5453152b86a21e2dba29cf4c43a6f62521796b474571ec9808b1b522f606df4c70dd8e3ddc4d02467bf693f2578731b832084dfb70f630
-  data.tar.gz: f95e84b684c86fdc2235c39b86283bde8de5aaa565c6a454bb6181cae1549a2ea1d5e5ca20840902bdb3660fe2eaf0c151368a9c329655059343acbe0a9e2801
+  metadata.gz: d5808529cca60d31e717f907c5fa9cf11753fb7de4bb65416f7a796f007b4a0157f35c28a7c40f7d58a089eb83738ffc16237e60856b6dd54e475db12132ea91
+  data.tar.gz: e597d1400a180a30a44ce26437f84bdc4fc8d51d6c7e0e7aa5afdf2adefa8c1c7ad1bd749c613fb9c7635d1fa462993d345866f17775671e5b2b687042778196

data/.rubocop_todo.yml

@@ -1,26 +1,214 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-12 09:36:25 UTC using RuboCop version 1.81.1.
+# on 2025-11-19 09:35:14 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
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
+# Offense count: 19
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'compare_dom_sax.rb'
+    - 'lib/svg_conform/requirements/font_family_requirement.rb'
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+    - 'lib/svg_conform/sax_validation_handler.rb'
+    - 'spec/support/shared_examples_for_validation_modes.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_element, with_fixed_indentation
+Layout/ArrayAlignment:
+  Exclude:
+    - 'lib/svg_conform/requirements/color_restrictions_requirement.rb'
+    - 'lib/svg_conform/requirements/id_reference_requirement.rb'
+    - 'lib/svg_conform/requirements/invalid_id_references_requirement.rb'
+
+# Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleAlignWith.
 # SupportedStylesAlignWith: either, start_of_block, start_of_line
 Layout/BlockAlignment:
   Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'check_position_collisions.rb'
+    - 'check_unique_positions.rb'
+    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
     - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
-# Offense count: 513
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'check_duplicates.rb'
+    - 'check_position_collisions.rb'
+    - 'check_unique_positions.rb'
+    - 'compare_errors.rb'
+    - 'find_missing_errors.rb'
+    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment.
+Layout/CommentIndentation:
+  Exclude:
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+    - 'lib/svg_conform/validation_context.rb'
+
+# Offense count: 2
+# 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: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, DefLikeMacros, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
+Layout/EmptyLineBetweenDefs:
+  Exclude:
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLinesAroundMethodBody:
+  Exclude:
+    - 'lib/svg_conform/fast_document_analyzer.rb'
+
+# Offense count: 2
+# 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: 22
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - '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: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'final_demo.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Layout/HeredocIndentation:
+  Exclude:
+    - 'test_sax_basic.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: normal, indented_internal_methods
+Layout/IndentationConsistency:
+  Exclude:
+    - 'check_duplicates.rb'
+    - 'compare_dom_sax.rb'
+    - 'compare_errors.rb'
+    - 'find_missing_errors.rb'
+    - 'lib/svg_conform/validation_context.rb'
+
+# Offense count: 13
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, AllowedPatterns.
+Layout/IndentationWidth:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'check_position_collisions.rb'
+    - 'check_unique_positions.rb'
+    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+
+# Offense count: 640
 # 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: 3
+# This cop supports safe autocorrection (--autocorrect).
+Layout/MultilineBlockLayout:
+  Exclude:
+    - 'check_duplicates.rb'
+    - 'compare_errors.rb'
+    - 'find_missing_errors.rb'
+
+# 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: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: final_newline, final_blank_line
+Layout/TrailingEmptyLines:
+  Exclude:
+    - 'spec/support/shared_examples_for_validation_modes.rb'
+
+# Offense count: 67
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Enabled: false
+
 # Offense count: 2
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -28,7 +216,7 @@ Lint/ConstantDefinitionInBlock:
   Exclude:
     - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
-# Offense count: 18
+# Offense count: 19
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
@@ -38,51 +226,94 @@ Lint/DuplicateBranch:
     - 'lib/svg_conform/semantic_comparator.rb'
     - 'lib/svg_conform/validation_context.rb'
     - 'lib/svg_conform/validation_result.rb'
+    - 'lib/svg_conform/validator.rb'
 
 # Offense count: 2
 Lint/DuplicateCaseCondition:
   Exclude:
     - 'lib/svg_conform/semantic_comparator.rb'
 
-# Offense count: 1
+# Offense count: 2
 Lint/DuplicateMethods:
   Exclude:
+    - 'lib/svg_conform/sax_validation_handler.rb'
     - 'lib/svg_conform/validation_context.rb'
 
-# Offense count: 3
+# 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:
   Exclude:
     - 'lib/svg_conform/compatibility/pattern_discovery.rb'
     - 'lib/svg_conform/compatibility/validity_analysis.rb'
+    - 'lib/svg_conform/sax_validation_handler.rb'
+
+# Offense count: 3
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: AllowedMethods, InferNonNilReceiver, AdditionalNilMethods.
+# AllowedMethods: instance_of?, kind_of?, is_a?, eql?, respond_to?, equal?
+# AdditionalNilMethods: present?, blank?, try, try!
+Lint/RedundantSafeNavigation:
+  Exclude:
+    - 'count_elements.rb'
+    - 'lib/svg_conform/fast_document_analyzer.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Lint/RedundantStringCoercion:
+  Exclude:
+    - 'analyze_error_nodes.rb'
 
 # Offense count: 1
 Lint/UnreachableCode:
   Exclude:
     - 'lib/svg_conform/commands/check.rb'
 
-# Offense count: 126
+# Offense count: 4
+# 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'
+
+# Offense count: 147
 # 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:
   Max: 253
 
-# Offense count: 3
+# Offense count: 8
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 105
+# Offense count: 126
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 220
+# Offense count: 258
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 154
@@ -92,11 +323,18 @@ Metrics/MethodLength:
 Metrics/ParameterLists:
   Max: 9
 
-# Offense count: 83
+# Offense count: 101
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
 
+# Offense count: 4
+# Configuration parameters: EnforcedStyle, AllowedIdentifiers, AllowedPatterns, ForbiddenIdentifiers, ForbiddenPatterns.
+# SupportedStyles: snake_case, camelCase
+Naming/VariableName:
+  Exclude:
+    - 'check_clippath_font.rb'
+
 # Offense count: 2
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
@@ -104,6 +342,12 @@ 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:
@@ -122,7 +366,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
@@ -137,7 +381,7 @@ RSpec/MultipleDescribes:
   Exclude:
     - 'spec/svg_conform/batch_report_spec.rb'
 
-# Offense count: 71
+# Offense count: 73
 RSpec/MultipleExpectations:
   Max: 6
 
@@ -146,6 +390,31 @@ Rake/MethodDefinitionInTask:
   Exclude:
     - 'lib/tasks/svgcheck.rake'
 
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'check_duplicates.rb'
+    - 'check_position_collisions.rb'
+    - 'check_unique_positions.rb'
+    - 'compare_errors.rb'
+    - 'find_missing_errors.rb'
+    - 'lib/svg_conform/requirements/allowed_elements_requirement.rb'
+
+# 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.
@@ -167,6 +436,42 @@ Style/MissingRespondToMissing:
   Exclude:
     - 'lib/svg_conform/cli.rb'
 
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'lib/svg_conform/sax_validation_handler.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineTernaryOperator:
+  Exclude:
+    - 'lib/svg_conform/requirements/namespace_attributes_requirement.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: literals, strict
+Style/MutableConstant:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'test_sax_on_slow_files.rb'
+
+# Offense count: 8
+# 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'
+    - 'compare_dom_sax.rb'
+    - 'lib/svg_conform/validation_context.rb'
+    - 'test_remediation.rb'
+    - 'test_sax_basic.rb'
+
 # Offense count: 4
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: respond_to_missing?
@@ -174,6 +479,12 @@ 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.
@@ -181,3 +492,115 @@ Style/OptionalBooleanParameter:
 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: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantParentheses:
+  Exclude:
+    - 'compare_dom_sax.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: 7
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: Mode.
+Style/StringConcatenation:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'benchmark_sax.rb'
+    - 'benchmark_validation.rb'
+    - 'final_demo.rb'
+    - 'test_remediation.rb'
+
+# Offense count: 105
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Enabled: false
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiteralsInInterpolation:
+  Exclude:
+    - 'benchmark_bsi_samples.rb'
+    - 'benchmark_sax.rb'
+    - 'benchmark_validation.rb'
+    - 'final_demo.rb'
+    - 'test_remediation.rb'
+
+# Offense count: 34
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  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: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArrayLiteral:
+  Exclude:
+    - 'test_sax_on_slow_files.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'

data/README.adoc

@@ -212,7 +212,7 @@ Details and examples of Ruby API usage can be found in
 require 'svg_conform'
 
 # Load a profile and validate
-profile = SvgConform::Profile.load_from_file("config/profiles/svg_1_2_rfc.yml")
+profile = SvgConform::Profiles.get(:svg_1_2_rfc)
 document = SvgConform::Document.new(svg_content)
 result = profile.validate(document)
 
@@ -221,11 +221,10 @@ puts "Errors: #{result.errors.count}"
 puts "Warnings: #{result.warnings.count}"
 
 # Apply remediations to fix issues
-if !result.valid? && profile.has_remediations?
-  engine = SvgConform::RemediationEngine.new(profile)
-  remediation_results = engine.apply_remediations(document, result)
+if !result.valid? && profile.remediation_count > 0
+  changes = profile.apply_remediations(document)
 
-  puts "Applied #{remediation_results.length} remediations"
+  puts "Applied #{changes.length} remediations"
   puts "Fixed SVG:"
   puts document.to_xml
 end
@@ -1026,9 +1025,9 @@ document = SvgConform::Document.new(svg_content)
 result = profile.validate(document)
 
 # Apply remediations if needed
-if !result.valid? && profile.has_remediations?
-  engine = SvgConform::RemediationEngine.new(profile)
-  remediation_results = engine.apply_remediations(document, result)
+if !result.valid? && profile.remediation_count > 0
+  changes = profile.apply_remediations(document)
+  puts "Applied #{changes.length} remediations"
 end
 ----
 
@@ -1365,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: