moxml 0.1.23 → 0.1.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 747d843c7a968e3a25871ac9e5c67dead62e5a494a23eed41af6e157df9d66e4
-  data.tar.gz: a636fb5fc49e0c5ebcda6a16484e2685957d9e8666b0bf043d16e5f84bcb0e57
+  metadata.gz: ed30996109d8cfb8057f216677cba8ca3cd3856287c38b6a7edab3251ebb2064
+  data.tar.gz: f93d7c13863ef9d437e40403e4a48434ed1e1c5530ea2424cdeff710740243a0
 SHA512:
-  metadata.gz: 96248578b7b4294981437cd73baa349c99f9b01a259800c3ac48662e84fdfe4cc84fc34eef4f3d47e7f7be5517c3e4fa895e48021cd73166dcaf9867533a6461
-  data.tar.gz: 733f99bd21656a83e17b8b6d52d08d12a19c7425364d2c8266cc2033962a8f506f8f0f603e0cdf5f0e17843dbf8b6a785b1e4462aef82c7aa173f4a8dc3d0ea2
+  metadata.gz: 9b09c144a268507bb02a16a4c6ba7caf6d1a2fa003718a6fa0960a8b68ba03a09584a66fb9475b1c23cd2d79071f1cc8c313200749f997d317aa90e61fba3811
+  data.tar.gz: 6389858a232d82faad5f6bbfd22d4828801c7a6d45a55a2a0f08d28c44647a588b52d2106649d408777453b571815b40c191f48c374cc49b648c58ad2be1e835

data/.github/workflows/docs.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1

data/.github/workflows/opal.yml

@@ -21,16 +21,33 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: "3.4"
-          bundler-cache: true
+          # NOTE: bundler-cache is disabled because the path-source oga
+          # and ruby-ll forks need ragel + ruby-ll outputs generated
+          # (rake vendor:prepare) before their C extensions can compile.
+          bundler-cache: false
 
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "18"
 
+      - name: Install ragel
+        run: sudo apt-get update && sudo apt-get install -y ragel
+
+      - name: Install ruby-ll (for rake vendor:prepare)
+        run: gem install ruby-ll --no-document
+
+      - name: Generate ragel / ruby-ll outputs in vendored forks
+        # Run before `bundle install`: the path-source oga/ruby-ll forks
+        # gitignore their generated .rb/.c files (parser.rb, lexer.rb,
+        # ext/c/lexer.c). bundle install compiles the C extensions via
+        # each fork's extconf.rb, which requires ext/c/lexer.c to exist.
+        run: rake vendor:prepare
+
       - name: Install Opal dependencies
         run: |
           npm list -g opal-compiler || npm install -g opal-compiler
+          bundle install
           bundle exec rake opal:generate_entity_data
 
       - name: Run Opal tests

data/.github/workflows/rake.yml

@@ -13,14 +13,43 @@ jobs:
   rake:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+      - uses: actions/checkout@v6
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: "3.3"
-          bundler-cache: true
+          # bundler-cache is disabled because the path-source oga
+          # and ruby-ll forks need ragel + ruby-ll outputs generated
+          # (rake vendor:prepare) before their C extensions can compile.
+          bundler-cache: false
+
+      - name: Install ragel
+        run: sudo apt-get update && sudo apt-get install -y ragel
+
+      - name: Install ruby-ll (for rake vendor:prepare)
+        run: gem install ruby-ll --no-document
+
+      - name: Generate ragel / ruby-ll outputs in vendored forks
+        # Run before `bundle install`: the path-source oga/ruby-ll forks
+        # gitignore their generated .rb/.c files (parser.rb, lexer.rb,
+        # ext/c/lexer.c). bundle install compiles the C extensions via
+        # each fork's extconf.rb, which requires ext/c/lexer.c to exist.
+        run: rake vendor:prepare
+
       - name: Install dependencies
         run: bundle install
+
+      - name: Compile liboga / libll native extensions
+        # Bundler does not reliably build path-source gems' native
+        # extensions; compile them explicitly so `require "oga"` (which
+        # requires libll) resolves under CRuby.
+        run: rake vendor:compile
+
       - name: Run fast tests (unit + adapter + integration)
         run: bundle exec rake spec:fast
+
       - name: Run rubocop
         run: bundle exec rubocop

data/.github/workflows/round-trip.yml

@@ -19,11 +19,34 @@ jobs:
         ruby: [ "3.1", "3.2", "3.3", "3.4", "4.0" ]
         category: [ metanorma, rfcxml, niso-jats ]
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+      - uses: actions/checkout@v6
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
+          # bundler-cache is disabled because the path-source oga
+          # and ruby-ll forks need ragel + ruby-ll outputs generated
+          # (rake vendor:prepare) before their C extensions can compile.
+          bundler-cache: false
+
+      - name: Install ragel
+        run: sudo apt-get update && sudo apt-get install -y ragel
+
+      - name: Install ruby-ll (for rake vendor:prepare)
+        run: gem install ruby-ll --no-document
+
+      - name: Generate ragel / ruby-ll outputs in vendored forks
+        run: rake vendor:prepare
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Compile liboga / libll native extensions
+        run: rake vendor:compile
+
       - name: Run round-trip tests (${{ matrix.category }})
         run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
         env:
@@ -39,11 +62,31 @@ jobs:
         ruby: [ "3.3", "4.0" ]
         category: [ metanorma, rfcxml, niso-jats ]
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+      - uses: actions/checkout@v6
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
+          bundler-cache: false
+
+      - name: Install ragel
+        run: sudo apt-get update && sudo apt-get install -y ragel
+
+      - name: Install ruby-ll (for rake vendor:prepare)
+        run: gem install ruby-ll --no-document
+
+      - name: Generate ragel / ruby-ll outputs in vendored forks
+        run: rake vendor:prepare
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Compile liboga / libll native extensions
+        run: rake vendor:compile
+
       - name: Run Nokogiri × Ox round-trip tests (${{ matrix.category }})
         run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
         env:
@@ -61,11 +104,31 @@ jobs:
         ruby: [ "3.3", "4.0" ]
         category: [ metanorma, rfcxml, niso-jats ]
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+      - uses: actions/checkout@v6
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
+          bundler-cache: false
+
+      - name: Install ragel
+        run: sudo apt-get update && sudo apt-get install -y ragel
+
+      - name: Install ruby-ll (for rake vendor:prepare)
+        run: gem install ruby-ll --no-document
+
+      - name: Generate ragel / ruby-ll outputs in vendored forks
+        run: rake vendor:prepare
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Compile liboga / libll native extensions
+        run: rake vendor:compile
+
       - name: Run Nokogiri × REXML round-trip tests (${{ matrix.category }})
         run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
         env:

data/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "opal-oga"]
+	path = vendor/opal-oga
+	url = git@github.com:lutaml/opal-oga.git
+[submodule "opal-ruby-ll"]
+	path = vendor/opal-ruby-ll
+	url = git@github.com:lutaml/opal-ruby-ll.git

data/.rubocop_todo.yml

@@ -675,6 +675,8 @@ RSpec/SpecFilePathFormat:
     - '**/spec/routing/**/*'
     - 'spec/moxml/node_type_map_spec.rb'
     - 'spec/moxml/opal_rexml_adapter_spec.rb'
+    - 'spec/moxml/opal_oga_adapter_spec.rb'
+    - 'spec/moxml/adapter/platform_spec.rb'
     - 'spec/moxml/xpath/ast/node_spec.rb'
     - 'spec/moxml/xpath/cache_spec.rb'
     - 'spec/moxml/xpath/compiler_spec.rb'

data/Gemfile

@@ -11,11 +11,19 @@ gem "benchmark-ips"
 gem "get_process_mem"
 gem "libxml-ruby", "~> 5.0"
 gem "nokogiri", "~> 1.18"
-gem "oga", "~> 3.4"
 gem "openssl", "~> 3.0"
 gem "ox", "~> 2.14"
 gem "rake"
 gem "rexml"
+
+# Opal-compatible forks of oga and ruby-ll. The forks add pure-Ruby lexer
+# and driver fallbacks (under ext/pureruby/) plus an Opal-aware conditional
+# in lib/oga.rb / lib/ll/setup.rb that selects the pure-Ruby implementation
+# when RUBY_PLATFORM == 'opal'. Under CRuby/JRuby the forks behave
+# identically to upstream (the conditional falls through to liboga/libll).
+gem "oga", path: "vendor/opal-oga"
+gem "ruby-ll", path: "vendor/opal-ruby-ll"
+
 gem "rspec"
 gem "rubocop"
 gem "rubocop-performance"

data/README.adoc

@@ -889,6 +889,130 @@ performance optimization, and testing strategies, see
 link:docs/_pages/best-practices.adoc[Best Practices Guide].
 
 
+== Running under Opal (JavaScript)
+
+Opal compiles Ruby to JavaScript and cannot load C extensions. To run
+Moxml on Opal you need three things: an adapter with no native code, a
+XML library fork that exposes pure-Ruby fallbacks for its lexer and
+parser driver, and an Opal build that puts those pure-Ruby
+implementations on the load path.
+
+=== Default adapter under Opal
+
+Under `RUBY_ENGINE == "opal"`, Moxml's default adapter is `:oga` (see
+<<Default adapter selection>>). Oga is a pure-Ruby XML parser; under
+standard CRuby its lexer and parsers are accelerated by the `liboga`
+and `libll` C extensions. Those extensions cannot be compiled into
+JavaScript, so on Opal they are replaced by the pure-Ruby fallbacks
+shipped in `ext/pureruby/` of the Opal-compatible forks below.
+
+The REXML adapter is also available on Opal (`Moxml.new(:rexml)`) but
+relies on a number of compatibility shims because REXML uses Ruby
+regular-expression features (the `/n` flag, `\u{...}` codepoint
+escapes, inline flag groups) and String APIs that do not all transpile
+to JavaScript today. `:oga` is the recommended path for new Opal
+projects.
+
+=== Required XML library forks
+
+Upstream https://github.com/yorickpeterse/oga[oga] and
+https://github.com/yorickpeterse/ruby-ll[ruby-ll] do not currently
+ship Opal-compatible fallbacks. Moxml vendors the following forks:
+
+* https://github.com/lutaml/opal-oga[lutaml/opal-oga] — oga with an
+  `ext/pureruby/oga/native/lexer.rb` fallback that fires when
+  `RUBY_PLATFORM == 'opal'`. Under CRuby/JRuby the fork behaves
+  identically to upstream oga.
+* https://github.com/lutaml/opal-ruby-ll[lutaml/opal-ruby-ll] —
+  ruby-ll with `ext/pureruby/ll/native/{driver,driver_config}.rb`
+  fallbacks selected by the same conditional in `lib/ll/setup.rb`.
+
+Both forks are vendored as submodules under `vendor/opal-oga` and
+`vendor/opal-ruby-ll` in the Moxml repository. Moxml's own `Gemfile`
+references them via `path:` source so that any consumer of Moxml under
+Opal resolves to the same fork commits Moxml was tested against.
+
+=== Wiring the forks in a downstream Gemfile
+
+Downstream libraries that run on Opal (for example
+https://github.com/plurimath/plurimath-js[plurimath-js]) must also use
+the Opal-compatible forks rather than upstream `oga` and `ruby-ll`.
+Wire them as `path:` or `git:` sources so the fork's
+`RUBY_PLATFORM == 'opal'` conditional can fire:
+
+[source,ruby]
+----
+# In your downstream gem's Gemfile (or gemspec)
+gem "moxml",    "~> 0.1.24"        # provides the :oga adapter
+gem "oga",      git: "https://github.com/lutaml/opal-oga.git",
+                ref: "<commit-sha-moxml-tests-against>"
+gem "ruby-ll",  git: "https://github.com/lutaml/opal-ruby-ll.git",
+                ref: "<commit-sha-moxml-tests-against>"
+----
+
+Pin the `ref:` to the submodule commits Moxml ships in
+`vendor/opal-oga` and `vendor/opal-ruby-ll` (recorded in
+`.gitmodules`) so your fork and Moxml's fork stay in lockstep. If you
+prefer to vendor the forks yourself, replace the `git:` source with
+`path: "vendor/opal-oga"` and `path: "vendor/opal-ruby-ll"` after
+copying them in.
+
+=== Opal build configuration
+
+Under Opal, the forks' `lib/` directory is on the load path (via the
+gem), but the pure-Ruby implementations live under `ext/pureruby/`.
+That directory must be added to Opal's load path so the
+`if RUBY_PLATFORM == 'opal'` branch in `lib/oga.rb` and
+`lib/ll/setup.rb` resolves to the pure-Ruby files instead of trying to
+load the C extension.
+
+For consumers using https://github.com/opal/opal[Opal] directly:
+
+[source,ruby]
+----
+require "opal"
+
+# Opal path: put both lib/ and ext/pureruby/ on the load path so the
+# fork's conditional requires resolve to the pure-Ruby fallback.
+%w[opal-oga opal-ruby-ll].each do |fork|
+  Opal.append_path File.expand_path("vendor/#{fork}/lib", __dir__)
+  Opal.append_path File.expand_path("vendor/#{fork}/ext/pureruby", __dir__)
+end
+
+# Moxml's Opal boot file (lib/compat/opal/moxml_boot.rb) explicitly
+# requires every module that would normally be autoloaded under CRuby.
+require "moxml_boot"
+----
+
+For consumers using https://github.com/opal/opal-compiler[Opal via
+Sprockets/Webpack], the equivalent is to add both `lib/` and
+`ext/pureruby/` from each fork to the Opal `paths` array.
+
+=== Verifying the Opal build
+
+Moxml's own Opal test suite exercises the wiring described above. To
+reproduce:
+
+[source,shell]
+----
+# One-time setup: install ragel + ruby-ll so the forks' gitignored
+# generated lexer/parser sources can be produced.
+gem install ruby-ll --no-document
+# (Install ragel via your package manager, e.g. apt-get install ragel
+#  or brew install ragel.)
+
+# Generate the gitignored outputs in the vendored forks.
+bundle exec rake vendor:prepare
+
+# Run the Opal (JavaScript) test suite.
+bundle exec rake spec:opal
+----
+
+Reference implementation: https://github.com/plurimath/plurimath-js[plurimath-js]
+is the canonical downstream consumer; its `Rakefile` and `env/` wrapper
+scripts show the full pattern end-to-end.
+
+
 == Specific adapter limitations
 
 === Ox adapter

data/Rakefile

@@ -1,9 +1,16 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-require "rspec/core/rake_task"
 
-RSpec::Core::RakeTask.new(:spec)
+# vendor:prepare must be runnable before `bundle install` (CI runs it
+# first so the path-source oga/ruby-ll forks' gitignored lexer/parser
+# outputs exist before their extconf.rb runs). Guard the rspec/opal
+# requires so the file loads with only `rake` + `bundler` available.
+begin
+  require "rspec/core/rake_task"
+  RSpec::Core::RakeTask.new(:spec)
+rescue LoadError
+end
 
 begin
   require "opal/rspec/rake_task"
@@ -17,15 +24,110 @@ begin
       File.exist?(File.join(p, "rexml", "document.rb"))
     end
     Opal.append_path rexml_lib if rexml_lib
+
+    # The Opal-compatible oga and ruby-ll forks (vendored as submodules)
+    # expose pure-Ruby implementations under ext/pureruby/. Their top-level
+    # lib/oga.rb and lib/ll/setup.rb conditionally require them when
+    # RUBY_PLATFORM == 'opal'. Both lib/ and ext/pureruby/ must be on
+    # Opal's load path so the conditional resolves correctly.
+    %w[opal-oga opal-ruby-ll].each do |fork_name|
+      fork_path = File.expand_path("vendor/#{fork_name}", __dir__)
+      Opal.append_path File.join(fork_path, "lib")
+      Opal.append_path File.join(fork_path, "ext/pureruby")
+    end
   end
 rescue LoadError
   # Opal not available or incompatible with current Ruby version
 end
 
-require "rubocop/rake_task"
+begin
+  require "rubocop/rake_task"
+  RuboCop::RakeTask.new
+rescue LoadError
+end
+
+# Regenerate the ragel / ruby-ll outputs that the Opal-compatible forks
+# (vendored as submodules under vendor/) gitignore. The forks ship the
+# grammar sources (.rl / .rll) but not the generated .rb / .c, since
+# those are large and version-controllable upstream. Both ragel and
+# ruby-ll must be on PATH; the upstream ruby-ll gem is sufficient for
+# generation (the fork is only needed at runtime).
+namespace :vendor do
+  desc "Generate ragel / ruby-ll outputs in vendored opal-oga and opal-ruby-ll"
+  task :prepare do
+    require "fileutils"
+
+    oga = File.expand_path("vendor/opal-oga", __dir__)
+    ruby_ll = File.expand_path("vendor/opal-ruby-ll", __dir__)
+
+    generators = [
+      # oga: ruby-ll grammar → Ruby parser
+      ["ruby-ll #{oga}/lib/oga/xml/parser.rll -o #{oga}/lib/oga/xml/parser.rb",
+       "#{oga}/lib/oga/xml/parser.rb",
+       "#{oga}/lib/oga/xml/parser.rll"],
+      ["ruby-ll #{oga}/lib/oga/xpath/parser.rll -o #{oga}/lib/oga/xpath/parser.rb",
+       "#{oga}/lib/oga/xpath/parser.rb",
+       "#{oga}/lib/oga/xpath/parser.rll"],
+      ["ruby-ll #{oga}/lib/oga/css/parser.rll -o #{oga}/lib/oga/css/parser.rb",
+       "#{oga}/lib/oga/css/parser.rb",
+       "#{oga}/lib/oga/css/parser.rll"],
+      # oga: ragel Ruby lexer
+      ["ragel -R -F1 #{oga}/lib/oga/xpath/lexer.rl -o #{oga}/lib/oga/xpath/lexer.rb",
+       "#{oga}/lib/oga/xpath/lexer.rb",
+       "#{oga}/lib/oga/xpath/lexer.rl"],
+      ["ragel -R -F1 #{oga}/lib/oga/css/lexer.rl -o #{oga}/lib/oga/css/lexer.rb",
+       "#{oga}/lib/oga/css/lexer.rb",
+       "#{oga}/lib/oga/css/lexer.rl"],
+      # oga: ragel C lexer for liboga
+      ["ragel -C -I #{oga}/ext/ragel -G2 #{oga}/ext/c/lexer.rl -o #{oga}/ext/c/lexer.c",
+       "#{oga}/ext/c/lexer.c",
+       "#{oga}/ext/c/lexer.rl"],
+      # ruby-ll: ruby-ll grammar → Ruby parser
+      ["ruby-ll #{ruby_ll}/lib/ll/parser.rll -o #{ruby_ll}/lib/ll/parser.rb --no-requires",
+       "#{ruby_ll}/lib/ll/parser.rb",
+       "#{ruby_ll}/lib/ll/parser.rll"],
+    ]
 
-RuboCop::RakeTask.new
+    generators.each do |cmd, output, source|
+      if File.exist?(output) && File.mtime(output) >= File.mtime(source)
+        next
+      end
 
+      FileUtils.mkdir_p(File.dirname(output))
+      sh cmd
+    end
+  end
+
+  # Bundler does not reliably compile native extensions for path-source
+  # gems. Build liboga/libll explicitly so `require "oga"` resolves.
+  desc "Compile liboga / libll native extensions for vendored forks"
+  task :compile do
+    require "fileutils"
+    require "rbconfig"
+
+    dlext = RbConfig::CONFIG["DLEXT"]
+
+    {
+      "vendor/opal-ruby-ll" => "libll",
+      "vendor/opal-oga" => "liboga",
+    }.each do |fork_path, ext_name|
+      abs_fork = File.expand_path(fork_path, __dir__)
+      lib_bundle = File.join(abs_fork, "lib", "#{ext_name}.#{dlext}")
+      ext_dir = File.join(abs_fork, "ext", "c")
+      extconf = File.join(ext_dir, "extconf.rb")
+      lib_dir = File.join(abs_fork, "lib")
+      next if File.exist?(lib_bundle)
+
+      Dir.chdir(ext_dir) do
+        sh "ruby #{extconf}"
+        sh "make"
+        FileUtils.cp("#{ext_name}.#{dlext}", lib_dir)
+      end
+    end
+  end
+end
+
+if defined?(RSpec)
 namespace :spec do
   if defined?(Opal::RSpec::RakeTask)
     desc "Run Opal (JavaScript) tests"
@@ -34,12 +136,21 @@ namespace :spec do
       server.append_path "spec"
 
       runner.default_path = "spec"
+      # `oga` and `ll/setup` must be required before moxml_boot so that
+      # the forks' Opal-aware conditional requires fire (lib/oga.rb calls
+      # `require 'oga/native/lexer'` when RUBY_PLATFORM == 'opal'; that
+      # resolves against vendor/opal-oga/ext/pureruby/, which the global
+      # Opal.append_path calls above add to the load path).
       runner.requires = %w[rexml_compat rexml/document rexml/xpath
-                           moxml/adapter/rexml spec_helper support/opal]
+                           oga ll/setup
+                           moxml_boot spec_helper support/opal]
       runner.files = Dir.glob("spec/moxml/*opal*_spec.rb") +
         Dir.glob("spec/moxml/native_attachment/opal_spec.rb") +
         Dir.glob("spec/moxml/adapter/shared_examples/*.rb")
     end
+
+    desc "Alias for spec:opal that also runs vendor:prepare"
+    task opal: "vendor:prepare"
   end
 
   desc "Validate XML fixtures are well-formed (requires xmllint)"
@@ -124,6 +235,7 @@ namespace :spec do
   task all: %i[unit adapter integration consistency examples
                performance]
 end
+end
 
 namespace :benchmark do
   desc "Run XPath performance benchmarks"

data/lib/compat/opal/moxml_boot.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# Opal doesn't support Ruby autoload. This file explicitly requires
+# all Moxml modules that would normally be lazy-loaded via autoload
+# in lib/moxml.rb. Loaded by the Opal Rakefile before spec_helper.
+
+require "moxml/version"
+require "moxml/error"
+require "moxml/native_attachment"
+require "moxml/native_attachment/opal"
+require "moxml/xml_utils"
+require "moxml/xml_utils/encoder"
+require "moxml/node"
+require "moxml/node_set"
+require "moxml/document"
+require "moxml/element"
+require "moxml/attribute"
+require "moxml/text"
+require "moxml/cdata"
+require "moxml/comment"
+require "moxml/processing_instruction"
+require "moxml/declaration"
+require "moxml/namespace"
+require "moxml/doctype"
+require "moxml/entity_reference"
+require "moxml/entity_registry"
+require "moxml/adapter"
+require "moxml/adapter/base"
+require "moxml/adapter/customized_rexml"
+require "moxml/adapter/customized_rexml/entity_reference"
+require "moxml/adapter/customized_rexml/formatter"
+require "moxml/sax"
+require "moxml/sax/handler"
+require "moxml/sax/element_handler"
+require "moxml/sax/block_handler"
+require "moxml/sax/namespace_splitter"
+require "moxml/adapter/rexml"
+require "moxml/adapter/customized_oga"
+require "moxml/adapter/customized_oga/xml_declaration"
+require "moxml/adapter/customized_oga/xml_generator"
+require "moxml/adapter/oga"
+require "moxml/document_builder"
+require "moxml/builder"
+require "moxml/context"
+require "moxml/config"
+require "moxml/xpath"
+require "moxml/xpath/engine"
+require "moxml/xpath/context"
+require "moxml/xpath/conversion"
+require "moxml/xpath/cache"
+require "moxml/xpath/lexer"
+require "moxml/xpath/parser"
+require "moxml/xpath/compiler"
+require "moxml/xpath/errors"
+require "moxml/xpath/ast/node"
+require "moxml/xpath/ruby/node"
+require "moxml/xpath/ruby/generator"

data/lib/moxml/adapter/base.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../xml_utils"
-require_relative "../document_builder"
-
 module Moxml
   module Adapter
     class Base
@@ -104,8 +101,7 @@ module Moxml
         #
         # @return [Boolean] true if SAX parsing is supported
         def sax_supported?
-          respond_to?(:sax_parse) &&
-            method(:sax_parse).owner != Moxml::Adapter::Base.singleton_class
+          method(:sax_parse).owner != Moxml::Adapter::Base.singleton_class
         end
 
         def create_document(_native_doc = nil)
@@ -212,6 +208,10 @@ namespace_validation_mode: :strict)
           wrapper.has_xml_declaration
         end
 
+        # Clear the declaration state from the native document.
+        # Called when a Declaration node is removed from a document.
+        def remove_declaration(_native_doc); end
+
         # Return the actual native node after an add_child operation.
         # Override for adapters where node identity may change (e.g., LibXML doc.root=).
         def actual_native(child_native, _parent_native)

data/lib/moxml/adapter/customized_libxml/cdata.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "node"
-
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/comment.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "node"
-
 module Moxml
   module Adapter
     module CustomizedLibxml