svg_conform 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccf420a3e00222240dcc3f07c6af8ca2433e1e355fc2d14a3f250c81dc8accf0
-  data.tar.gz: 1adfc48ed569e13d1d4f0929e22558bde3abb8239cd19f4f95f7a5e86321db7a
+  metadata.gz: 43ff84b9d1f47a6a2bd92624483c0445bd3f77d29f0fc36f2c02116a40111bc2
+  data.tar.gz: be072c8772885cd746ee623e028e00517dfcac93250a00f4015cb7122d94739a
 SHA512:
-  metadata.gz: 7c71c121b3e79519ab5453152b86a21e2dba29cf4c43a6f62521796b474571ec9808b1b522f606df4c70dd8e3ddc4d02467bf693f2578731b832084dfb70f630
-  data.tar.gz: f95e84b684c86fdc2235c39b86283bde8de5aaa565c6a454bb6181cae1549a2ea1d5e5ca20840902bdb3660fe2eaf0c151368a9c329655059343acbe0a9e2801
+  metadata.gz: 0ee8ad3bfab5a2aec10b32caa23141967aa25112e0393ed39242ab83a5f123bb317190392df347f7f4a8665af61bf7de4b09eb3283c4c140e372af1177ba924b
+  data.tar.gz: 20d1871024c131298aa2462bd849e07dfb16b73f2f61913da8f9c2d21b43e87fcfe5ae6ed298971091c0f85734efe8a36790432ccdb18c8878dafc25d238a348

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # 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-18 13:36:55 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
@@ -14,13 +14,116 @@ Layout/BlockAlignment:
   Exclude:
     - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
-# Offense count: 513
+# 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'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# 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'
+
+# Offense count: 604
 # 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
@@ -28,7 +131,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,30 +141,65 @@ 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 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: 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
@@ -72,17 +210,17 @@ Metrics/AbcSize:
 Metrics/BlockLength:
   Max: 253
 
-# Offense count: 3
+# Offense count: 8
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 105
+# Offense count: 125
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 220
+# Offense count: 257
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 154
@@ -92,11 +230,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 +249,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:
@@ -146,6 +297,14 @@ 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.
@@ -167,6 +326,19 @@ 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?
@@ -174,6 +346,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 +359,88 @@ 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: 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:
+  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'

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
 ----
 

data/examples/readme_usage.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Working example based on README.adoc Ruby API usage section
+require_relative "../lib/svg_conform"
+
+puts "=" * 60
+puts "README Ruby API Usage Example"
+puts "=" * 60
+puts
+
+# Sample SVG content with some issues
+svg_content = <<~SVG
+  <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+    <rect fill="red" width="50" height="50"/>
+    <circle fill="blue" cx="75" cy="75" r="20"/>
+  </svg>
+SVG
+
+puts "Test SVG content:"
+puts svg_content
+puts
+
+# Load a profile and validate
+profile = SvgConform::Profiles.get(:svg_1_2_rfc)
+document = SvgConform::Document.new(svg_content)
+result = profile.validate(document)
+
+puts "Validation Results:"
+puts "Valid: #{result.valid?}"
+puts "Errors: #{result.errors.count}"
+puts "Warnings: #{result.warnings.count}"
+puts
+
+if result.errors.any?
+  puts "Error details:"
+  result.errors.each_with_index do |error, i|
+    puts "  #{i + 1}. [#{error.requirement_id}] #{error.message}"
+  end
+  puts
+end
+
+# Apply remediations to fix issues
+if !result.valid? && profile.remediation_count.positive?
+  puts "Applying remediations (profile has #{profile.remediation_count} remediations)..."
+  changes = profile.apply_remediations(document)
+
+  puts "Applied #{changes.length} remediations"
+  puts
+
+  puts "Fixed SVG:"
+  puts document.to_xml
+  puts
+
+  # Re-validate to confirm fixes
+  result_after = profile.validate(document)
+  puts "Re-validation after fixes:"
+  puts "Valid: #{result_after.valid?}"
+  puts "Errors: #{result_after.errors.count}"
+else
+  puts "Document is already valid or no remediations available"
+end
+
+puts
+puts "=" * 60
+puts "Example complete!"
+puts "=" * 60

data/examples/requirements_demo.rb

@@ -30,7 +30,7 @@ class RequirementsDemo
 
     begin
       # Load IETF profile from YAML
-      svg_1_2_rfc_profile = SvgConform::ProfileRegistry.load_profile("svg_1_2_rfc")
+      svg_1_2_rfc_profile = SvgConform::Profiles.get(:svg_1_2_rfc)
       puts "✓ Loaded IETF profile: #{svg_1_2_rfc_profile.name}"
       puts "  Description: #{svg_1_2_rfc_profile.description}"
       puts "  Requirements: #{svg_1_2_rfc_profile.requirement_count}"
@@ -38,7 +38,7 @@ class RequirementsDemo
       puts
 
       # Load Lucid fix profile
-      lucid_profile = SvgConform::ProfileRegistry.load_profile("lucid_fix")
+      lucid_profile = SvgConform::Profiles.get(:lucid_fix)
       puts "✓ Loaded Lucid Fix profile: #{lucid_profile.name}"
       puts "  Description: #{lucid_profile.description}"
       puts "  Requirements: #{lucid_profile.requirement_count}"
@@ -46,7 +46,7 @@ class RequirementsDemo
       puts
 
       # List available profiles
-      available = SvgConform::ProfileRegistry.available_profiles
+      available = SvgConform::Profiles.available_profiles
       puts "Available profiles: #{available.join(', ')}"
       puts
     rescue StandardError => e
@@ -204,7 +204,7 @@ class RequirementsDemo
 
     begin
       # Load the Lucid fix profile
-      profile = SvgConform::ProfileRegistry.load_profile("lucid_fix")
+      profile = SvgConform::Profiles.get(:lucid_fix)
 
       # Process the SVG
       document = SvgConform::Document.new(lucid_svg)

data/lib/svg_conform/document.rb

@@ -16,6 +16,7 @@ module SvgConform
         @content = content_or_path
       end
 
+      @xpath_cache = {}
       parse_document
     end
 
@@ -36,7 +37,8 @@ module SvgConform
     end
 
     def xpath(path, namespaces = {})
-      @moxml_document.xpath(path, namespaces)
+      cache_key = [path, namespaces].hash
+      @xpath_cache[cache_key] ||= @moxml_document.xpath(path, namespaces)
     end
 
     def traverse(&)
@@ -60,6 +62,10 @@ module SvgConform
       Document.from_content(to_xml)
     end
 
+    def clear_cache
+      @xpath_cache.clear
+    end
+
     def valid_xml?
       !@moxml_document.nil?
     rescue StandardError

data/lib/svg_conform/element_proxy.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module SvgConform
+  # Lightweight attribute representation for SAX parsing
+  class SaxAttribute
+    attr_reader :name, :value
+
+    def initialize(name, value)
+      @name = name
+      @value = value
+    end
+
+    def namespace
+      nil  # Simplified for now
+    end
+  end
+
+  # Lightweight element representation during SAX parsing
+  # Provides a node-like interface for validation requirements
+  # without the overhead of full DOM tree
+  class ElementProxy
+    attr_reader :name, :position, :path, :parent, :raw_attributes
+    attr_accessor :text_content, :child_counters
+
+    def initialize(name:, attributes:, position:, path:, parent:)
+      @name = name
+      @raw_attributes = attributes  # Hash of attribute name => value
+      @position = position
+      @path = path  # Array of parent path parts
+      @parent = parent
+      @text_content = String.new  # Mutable string
+      @child_counters = {}  # Track child element positions
+    end
+
+    # Build full path ID for this element
+    def path_id
+      parts = @path + ["#{@name}[#{@position}]"]
+      "/#{parts.join('/')}"
+    end
+
+    # Return attributes as array of SaxAttribute objects (for compatibility)
+    def attributes
+      @raw_attributes.map { |name, value| SaxAttribute.new(name, value) }
+    end
+
+    # Check if this element has a specific attribute
+    def attribute(name)
+      value = @raw_attributes[name] || @raw_attributes[name.to_s]
+      value ? SaxAttribute.new(name, value) : nil
+    end
+
+    # Get attribute value (alias for compatibility)
+    def [](name)
+      @raw_attributes[name] || @raw_attributes[name.to_s]
+    end
+
+    # Check if attribute exists
+    def has_attribute?(name)
+      @raw_attributes.key?(name) || @raw_attributes.key?(name.to_s)
+    end
+
+    # Get namespace from attributes or parent
+    def namespace
+      @raw_attributes['xmlns'] || @parent&.namespace
+    end
+
+    # Check if this is a text node (always false for ElementProxy)
+    def text?
+      false
+    end
+
+    # Support dynamic attribute access
+    def method_missing(method, *args)
+      if method.to_s.end_with?('?')
+        # Boolean check
+        has_attribute?(method.to_s.chomp('?'))
+      else
+        # Attribute access
+        @attributes[method.to_s] || @attributes[method.to_sym]
+      end
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      @raw_attributes.key?(method.to_s) || @raw_attributes.key?(method.to_sym) || super
+    end
+
+    # For compatibility with validation context
+    def line
+      nil  # SAX doesn't provide line numbers easily
+    end
+
+    def column
+      nil
+    end
+
+    # Provide a stable identifier for this element
+    def element_id
+      path_id
+    end
+  end
+end