mml 2.2.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efbc2e4b8156916d34e524d2f7b6456168f8ef4a0c0c2ade8fbfb2b02bdc2efb
-  data.tar.gz: 8f826d13adfc7f0b556aa5ab6f32f8e8390bf06002a76570845605af7282058a
+  metadata.gz: b681a8e9ba48bcb41372e146fa0f16c95eae47303df8db3eb48a9561e959ce6d
+  data.tar.gz: d0d046fceba746e66519e9c6c44b395b22d0078d06140e1db04bb0aadb29f37d
 SHA512:
-  metadata.gz: 694df3fcc6b3611d6bac5b5c380b420b91823e697b219ba93a5d9ec22c70d910f8ecef6fef6c419b1acf80660d726259056717380faf8e77d235879b056e3c85
-  data.tar.gz: 72b8f2d1960adec6a3777e43c792cf3d1d3aa4658be47e5bdbf9f7e5cd428ac1dbd3990d7c1685ae4f6ed1a90566b80932046c15424bf4b6a94efa4e39360a29
+  metadata.gz: 5e21cda0df4bada88b50899cb98b58d78ec46f3edca237ae54f064a33038fef2b7b0f5a6ce053709c2113adc0d01ffdea6efb436ca40debb85a6c54c21dbde26
+  data.tar.gz: 9544c69937ff05d4df59cd16943c9f393df5bd8a8f3a8a9cd24ba84d3bf9cb457bf6681e24e824faa6bb72c06a30729ef42963741c4034cffbb86a65925a689e

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-03-31 03:44:08 UTC using RuboCop version 1.86.0.
+# on 2026-03-31 12:25:08 UTC using RuboCop version 1.86.0.
 # 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

data/README.adoc

@@ -39,15 +39,16 @@ $ gem install mml
 ----
 require "mml"
 
-# Parse MathML (defaults to MathML 3)
-math = Mml.parse('<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi></math>')
+# Parse MathML with explicit version
+math = Mml.parse('<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi></math>', version: 3)
+math4 = Mml.parse(input, version: 4)
 
 # Serialize back to XML
 math.to_xml
-# => "<math xmlns=\"http://www.w3.org/1998/Math/MathML\"><mi>x</mi></math>"
 
-# Parse with explicit version
-math4 = Mml.parse(input, version: 4)
+# Or use versioned modules directly
+Mml::V3::Math.from_xml(input)
+Mml::V4::Math.from_xml(input)
 ----
 
 == MathML version architecture
@@ -60,7 +61,7 @@ for backward compatibility.
 ----
                    ┌───────────────────────────────────────────┐
                    │                   Mml                     │
-                   │  (aliases Mml::V3 for backward compat)    │
+                   │  parse() delegates to V3 or V4            │
                    └────────────────────┬──────────────────────┘
                                         │
                     ┌───────────────────┴────────────────────┐
@@ -97,7 +98,8 @@ for backward compatibility.
 Mml.parse(input)              # Default: MathML 3 (Mml::V3)
 Mml.parse(input, version: 3)  # Explicit MathML 3
 Mml.parse(input, version: 4)  # MathML 4 with intent/arg attributes
-Mml::V4.parse(input)          # Direct v4 parsing (no default fallback)
+Mml::V3.parse(input)          # Direct v3 parsing
+Mml::V4.parse(input)          # Direct v4 parsing
 ----
 
 === Key differences between MathML 3 and MathML 4
@@ -114,49 +116,60 @@ Mml::V4.parse(input)          # Direct v4 parsing (no default fallback)
 |Deprecated (recognized but hidden) |`<mlabeledtr>`, `<none>` removed from `CommonAttributes` but classes still exist
 |===
 
-=== Migration from MathML 3 to MathML 4
+=== Migration from previous versions
 
-==== For gem users (upgrading parsing)
+==== require and configuration
 
-If you currently parse MathML and want to use MathML 4 features:
+The `Mml` module no longer aliases versioned constants. Use the explicit version
+namespace:
 
 [source,ruby]
 ----
-# Change this:
-math = Mml.parse(input)
+# Before (no longer supported)
+require "mml/configuration"
+Mml::Configuration.adapter = :nokogiri
+Mml::Configuration.custom_models = { Mi => MyCustomMi }
+Mml::Math.new(...)
+
+# After — explicit version
+require "mml"
+Mml::V3::Configuration.adapter = :nokogiri
+Mml::V3::Configuration.custom_models = { Mi => MyCustomMi }
+Mml::V3::Math.new(...)
 
-# To this:
-math = Mml.parse(input, version: 4)
+# Or for MathML 4
+Mml::V4::Configuration.adapter = :nokogiri
+Mml::V4::Configuration.custom_models = { Mi => MyCustomMi }
+Mml::V4::Math.new(...)
 ----
 
-==== For gem users (upgrading serialized output)
+==== Element class references
 
-If you serialize MathML 4 documents and want to ensure compatibility:
+All element classes live under their version namespace:
 
 [source,ruby]
 ----
-# MathML 4 serialization removes deprecated attributes from XML output
-math = Mml.parse(input, version: 4)
-math.to_xml  # No fontfamily, fontweight, color, groupalign, etc. in output
-----
-
-==== For gem extenders (adding custom elements)
+# Before (no longer supported)
+Mml::Mi.new(value: "x")
+Mml::Mrow.new(mi_value: [...])
 
-Custom elements registered via `Configuration.custom_models` are version-specific:
+# After
+Mml::V3::Mi.new(value: "x")
+Mml::V3::Mrow.new(mi_value: [...])
 
-[source,ruby]
-----
-# Register a custom element for MathML 4 only
-Mml::V4::Configuration.custom_models = { Mi => MyCustomMiV4 }
+# Or for MathML 4
+Mml::V4::Mi.new(value: "x", intent: "$x")
+Mml::V4::Mrow.new(mi_value: [...])
 ----
 
-CommonAttributes is version-specific. Elements that exist only in v4 (like `<a>`)
-are automatically handled:
+==== Parsing
+
+`Mml.parse` still works with a `version:` keyword, defaulting to version 3:
 
 [source,ruby]
 ----
-# The <a> element is only in v4 CommonAttributes
-Mml::V4::Mrow.new(a_value: [Mml::V4::A.new(href: "https://...")])
+Mml.parse(input)              # unchanged — defaults to MathML 3
+Mml.parse(input, version: 4)  # use MathML 4
 ----
 
 == Parsing and serialization
@@ -166,13 +179,16 @@ Mml::V4::Mrow.new(a_value: [Mml::V4::A.new(href: "https://...")])
 [source,ruby]
 ----
 # Default namespace
-Mml.parse('<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi></math>')
+Mml::V3.parse('<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi></math>')
 
 # Prefixed namespace
-Mml.parse('<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML"><mml:mi>x</mml:mi></mml:math>')
+Mml::V3.parse('<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML"><mml:mi>x</mml:mi></mml:math>')
 
 # No namespace (namespace injected internally)
-Mml.parse("<math><mi>x</mi></math>", namespace_exist: false)
+Mml::V3.parse("<math><mi>x</mi></math>", namespace_exist: false)
+
+# MathML 4
+Mml::V4.parse(input)
 ----
 
 === Serialization
@@ -225,13 +241,13 @@ Token elements hold text content in the `value` attribute:
 
 [source,ruby]
 ----
-Mml::Mi.new(value: "x")
-Mml::Mn.new(value: "42")
-Mml::Mo.new(value: "+")
-Mml::Ms.new(value: "text")
-Mml::Mtext.new(value: "label")
-Mml::Mspace.new(width: "1em")
-Mml::Mglyph.new(alt: "symbol")
+Mml::V3::Mi.new(value: "x")
+Mml::V3::Mn.new(value: "42")
+Mml::V3::Mo.new(value: "+")
+Mml::V3::Ms.new(value: "text")
+Mml::V3::Mtext.new(value: "label")
+Mml::V3::Mspace.new(width: "1em")
+Mml::V3::Mglyph.new(alt: "symbol")
 ----
 
 === Container elements
@@ -240,10 +256,10 @@ Container elements hold child elements via `#{tag}_value` collection attributes:
 
 [source,ruby]
 ----
-Mml::Mrow.new(
-  mi_value: [Mml::Mi.new(value: "x")],
-  mo_value: [Mml::Mo.new(value: "+")],
-  mn_value: [Mml::Mn.new(value: "1")],
+Mml::V3::Mrow.new(
+  mi_value: [Mml::V3::Mi.new(value: "x")],
+  mo_value: [Mml::V3::Mo.new(value: "+")],
+  mn_value: [Mml::V3::Mn.new(value: "1")],
 )
 # => <mrow><mi>x</mi><mo>+</mo><mn>1</mn></mrow>
 ----
@@ -254,10 +270,10 @@ Build an expression tree by nesting elements:
 
 [source,ruby]
 ----
-Mml::Math.new(
+Mml::V3::Math.new(
   mfrac_value: [
-    Mml::Mfrac.new(
-      mi_value: [Mml::Mi.new(value: "a"), Mml::Mi.new(value: "b")],
+    Mml::V3::Mfrac.new(
+      mi_value: [Mml::V3::Mi.new(value: "a"), Mml::V3::Mi.new(value: "b")],
     ),
   ],
 )
@@ -268,12 +284,12 @@ Mml::Math.new(
 
 [source,ruby]
 ----
-Mml::Mtable.new(
+Mml::V3::Mtable.new(
   mtr_value: [
-    Mml::Mtr.new(
+    Mml::V3::Mtr.new(
       mtd_value: [
-        Mml::Mtd.new(mi_value: [Mml::Mi.new(value: "a")]),
-        Mml::Mtd.new(mi_value: [Mml::Mi.new(value: "b")]),
+        Mml::V3::Mtd.new(mi_value: [Mml::V3::Mi.new(value: "a")]),
+        Mml::V3::Mtd.new(mi_value: [Mml::V3::Mi.new(value: "b")]),
       ],
     ),
   ],
@@ -339,13 +355,17 @@ Three input forms are supported:
 
 == Configuration
 
+Configuration is version-specific. Use the namespace matching your target version:
+
 [source,ruby]
 ----
 # Switch XML adapter (default: :ox, also supports :nokogiri)
-Mml::Configuration.adapter = :nokogiri
+Mml::V3::Configuration.adapter = :nokogiri
+Mml::V4::Configuration.adapter = :nokogiri
 
 # Register custom model replacements
-Mml::Configuration.custom_models = { Mi => MyCustomMi }
+Mml::V3::Configuration.custom_models = { Mi => MyCustomMi }
+Mml::V4::Configuration.custom_models = { Mi => MyCustomMi }
 ----
 
 == Development

data/lib/mml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mml
-  VERSION = "2.2.0"
+  VERSION = "2.2.1"
 end

data/lib/mml.rb

@@ -1,38 +1,18 @@
 # frozen_string_literal: true
 
-require "mml/v3"
-
 module Mml
   class Error < StandardError; end
 
-  # Delegate undefined constants to Mml::V3 for backward compatibility.
-  # Lazily loads Mml::V4 when referenced.
-  def self.const_missing(name)
-    if name == :V4
-      require "mml/v4"
-      Mml::V4
-    elsif Mml::V3.const_defined?(name)
-      Mml::V3.const_get(name)
-    else
-      raise NameError, "uninitialized constant Mml::#{name}"
-    end
-  end
+  autoload :V3, "mml/v3"
+  autoload :V4, "mml/v4"
 
   module_function
 
   def parse(input, namespace_exist: true, version: 3)
     case version
     when 3 then Mml::V3.parse(input, namespace_exist: namespace_exist)
-    when 4
-      require "mml/v4"
-      Mml::V4.parse(input, namespace_exist: namespace_exist)
+    when 4 then Mml::V4.parse(input, namespace_exist: namespace_exist)
     else raise Error, "Unsupported MathML version: #{version}"
     end
   end
-
-  # Backward compatibility: Mml aliases Mml::V3
-  Configuration = Mml::V3::Configuration
-
-  # Explicitly define Math to avoid collision with Ruby built-in Math module
-  Math = Mml::V3::Math
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mml
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model