asciichem 0.27.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4602bf349585d9d81483e3561d970efd6bb06f3196d30a0a3017df316699664f
-  data.tar.gz: ea4c38d2af66b75ce2024c5cb1cc866af19584af2edba92b09cc264a7e48037e
+  metadata.gz: 8fb92ff1cd35eeb546372b2ac9c3cf97b908971409e9a1d473b575479464e356
+  data.tar.gz: 2cc3be9f85b7ca2d7e3fe773e981073b6a755344cc6b593b1940666653fb52e7
 SHA512:
-  metadata.gz: 4dad38021607a88a0f37b90a2320b228d47b6e6197b7102eb48616ea94486ccfc16f953c2c233446ca216eefa1d76aebd0c88b1d40edcb2f582abb56c062e79f
-  data.tar.gz: 4fc1f074a3b182e2d22c263f09044d873a9d96ba1e627e89780e42977a00aedd0e7142590df6aa645e405e7dcbca89076e505abccc3e1e37be99dddfca527372
+  metadata.gz: 6d2f065122017d83a4e0fdb5a9da9db50a9dbd321e335a9f49bce5c3d253e78ae11f7ae33899ad4ce60fa28b9053a085f4cac7acefbd22999c88287fc0d38d2d
+  data.tar.gz: 369b73e26be9c6234fd36c6a2e5d14b53a8746a5fa44c7bc5949297cc17978e6a135e4f003a90641ad7e63a2ce4dd400e05107bb79157628028f14bc68104ac2

data/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to AsciiChem are documented here.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.28.0] - 2026-09-14
+
+### Changed
+- Embedded-math MathML now crosses through the mml gem
+  (plurimath/mml) in both directions: Plurimath output is parsed
+  into a typed Mml::V3 graph and re-serialized by the framework
+  before grafting - replacing xpath surgery on the raw string.
+  mml (~> 2.3) is now a direct dependency (previously transitive
+  via plurimath).
+- New spec contract: every emitted MathML (and every shared-corpus
+  golden) parses back through Mml.parse - output is valid per the
+  typed MathML contract model, not just well-formed XML.
+
 ## [0.27.0] - 2026-09-14
 
 ### Added
@@ -505,3 +518,13 @@ This project follows [Semantic Versioning](https://semver.org/).
 [0.3.0]: https://github.com/asciichem/asciichem-ruby/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/asciichem/asciichem-ruby/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/asciichem/asciichem-ruby/releases/tag/v0.1.0
+    ### Changed
+- Embedded-math MathML now crosses through the mml gem (plurimath/mml)
+  in both directions: Plurimath output is parsed into a typed
+  Mml::V3 graph and re-serialized by the framework before grafting —
+  replacing xpath surgery on the raw string. mml (~> 2.3) is now a
+  direct dependency (previously transitive via plurimath).
+- New spec contract: every emitted MathML (and every shared-corpus
+  golden) parses back through Mml.parse — output is valid per the
+  typed MathML contract model, not just well-formed XML.
+

data/asciichem.gemspec

@@ -36,6 +36,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "chemicalml", "~> 0.3.0"
   spec.add_dependency "elkrb", "~> 1.0"
   spec.add_dependency "lutaml-model", ">= 0.8", "< 2"
+  spec.add_dependency "mml", "~> 2.3"
   spec.add_dependency "nokogiri", "~> 1.16"
   spec.add_dependency "parslet", "~> 2.0"
   spec.add_dependency "relaton-bib", ">= 0.1", "< 2"

data/lib/asciichem/formatter/mathml.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "nokogiri"
+require "mml"
 
 module AsciiChem
   module Formatter
@@ -196,17 +197,27 @@ module AsciiChem
       end
 
       def visit_embedded_math(em)
-        # Strip the outer <math> wrapper so the embedded fragment slots
-        # into our surrounding <mrow>.
-        fragment = em.formula.to_mathml
-        parsed = Nokogiri::XML(fragment)
-        math = parsed.at_xpath("//m:math", m: MATHML_NS)
-        return el("mrow") unless math
-
-        # Detach children into a fresh <mrow>.
+        # Embedded math crosses through the mml gem in both directions:
+        # Plurimath's MathML string is parsed into a typed Mml::V3
+        # graph (the MathML contract model), and each top-level child
+        # is re-serialized by the framework before grafting — never
+        # ad-hoc xpath surgery on the string.
+        math = Mml.parse(em.formula.to_mathml, version: 3)
         mrow = el("mrow")
-        math.children.each { |c| mrow.add_child(c.dup) }
+        math.element_order.each do |entry|
+          next unless entry.respond_to?(:name)
+
+          attr_name = xml_element_attribute(math.class, entry.name)
+          next unless attr_name
+
+          Array(math.public_send(attr_name)).each do |child|
+            fragment = Nokogiri::XML::DocumentFragment.parse(child.to_xml)
+            fragment.children.each { |node| mrow.add_child(node) }
+          end
+        end
         mrow
+      rescue Mml::Error, Lutaml::Model::Error, Nokogiri::XML::SyntaxError
+        el("mrow")
       end
 
       def visit_text(text)
@@ -309,6 +320,14 @@ module AsciiChem
 
       private
 
+      # Symbol of the model attribute an XML child element name maps
+      # to on a Mml class (e.g. "mstyle" => :mstyle_value), via the
+      # lutaml-model XML mapping — no name-munging.
+      def xml_element_attribute(klass, element_name)
+        rule = klass.mappings_for(:xml).elements.find { |r| r.name == element_name }
+        rule&.to
+      end
+
       def render_node(node)
         node.accept(self)
       end

data/lib/asciichem/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AsciiChem
-  VERSION = "0.27.0"
+  VERSION = "0.28.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciichem
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Ribose Inc.
@@ -57,6 +57,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
+- !ruby/object:Gem::Dependency
+  name: mml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement