mml 2.2.1 → 2.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b681a8e9ba48bcb41372e146fa0f16c95eae47303df8db3eb48a9561e959ce6d
-  data.tar.gz: d0d046fceba746e66519e9c6c44b395b22d0078d06140e1db04bb0aadb29f37d
+  metadata.gz: cb306bb25f97a7fb6562b604f7f31a7301a06133efbac3011e7de508556f37a3
+  data.tar.gz: 2a928b1ffaa1d6273bd6a47825e9d7c395d395a38eb06588f906901d4cb50dbe
 SHA512:
-  metadata.gz: 5e21cda0df4bada88b50899cb98b58d78ec46f3edca237ae54f064a33038fef2b7b0f5a6ce053709c2113adc0d01ffdea6efb436ca40debb85a6c54c21dbde26
-  data.tar.gz: 9544c69937ff05d4df59cd16943c9f393df5bd8a8f3a8a9cd24ba84d3bf9cb457bf6681e24e824faa6bb72c06a30729ef42963741c4034cffbb86a65925a689e
+  metadata.gz: b7a14d5f681eaafffc8c9863b048c6cb4583385aac027d5612ea21c019de8da79690f888a268f622b244fdfb8324a5bd6ce085783759b28569a5f76f2dac8f32
+  data.tar.gz: 187c9be72bc5cd64788ae64d9208fcb035c772ba1072e7894a8bea4ae16398be5f1446ef6080ae0a269723336dbb4b157760c1bd3e7f346bceb0d334379e3a04

data/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "spec/fixtures/mml2-testsuite"]
+	path = spec/fixtures/mml2-testsuite
+	url = https://github.com/plurimath/mml2-testsuite.git
+[submodule "spec/fixtures/mml3-testsuite"]
+	path = spec/fixtures/mml3-testsuite
+	url = https://github.com/plurimath/mml3-testsuite.git
+[submodule "spec/fixtures/mmlcore-testsuite"]
+	path = spec/fixtures/mmlcore-testsuite
+	url = https://github.com/plurimath/mmlcore-testsuite.git

data/.rubocop.yml

@@ -12,3 +12,7 @@ AllCops:
   NewCops: enable
   Exclude:
     - 'vendor/**/*'
+    - 'spec/fixtures/mml2-testsuite/**/*'
+    - 'spec/fixtures/mml3-testsuite/**/*'
+    - 'spec/fixtures/mmlcore-testsuite/**/*'
+    - 'spec/tasks/**/*'

data/.rubocop_todo.yml

@@ -1,39 +1,53 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-03-31 12:25:08 UTC using RuboCop version 1.86.0.
+# on 2026-04-10 10:04:19 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
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 3
+# Offense count: 114
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
-  Exclude:
-    - 'mml.gemspec'
-    - 'spec/mml_spec.rb'
-    - 'spec/spec_helper.rb'
+  Enabled: false
 
 # Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Lint/UselessAssignment:
+  Exclude:
+    - 'lib/mml/context_configuration.rb'
+
+# Offense count: 23
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Enabled: false
+
+# Offense count: 11
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 27
+  Max: 167
 
-# Offense count: 3
-# Configuration parameters: Prefixes, AllowedPatterns.
-# Prefixes: when, with, without
-RSpec/ContextWording:
-  Exclude:
-    - 'spec/mml4_spec.rb'
-    - 'spec/mml_spec.rb'
+# Offense count: 55
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 170
 
 # Offense count: 1
-RSpec/MultipleDescribes:
+Naming/ConstantName:
   Exclude:
-    - 'spec/mml_spec.rb'
+    - 'lib/mml/v2/namespace.rb'
+
+# Offense count: 35
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 11
+
+# Offense count: 18
+RSpec/MultipleExpectations:
+  Max: 3
 
 # Offense count: 1
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
@@ -41,4 +55,9 @@ RSpec/MultipleDescribes:
 RSpec/SpecFilePathFormat:
   Exclude:
     - '**/spec/routing/**/*'
-    - 'spec/mml4_spec.rb'
+    - 'spec/mml/v3/mnone_spec.rb'
+
+# Offense count: 1
+RSpec/UnspecifiedException:
+  Exclude:
+    - 'spec/mml/v3_spec.rb'

data/CLAUDE.md

@@ -0,0 +1,79 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`mml` is a Ruby gem that provides MathML 3 and MathML 4 XML parsing and serialization. It maps MathML elements into Ruby model classes using the `lutaml-model` framework. Part of the [Plurimath](https://github.com/plurimath/mml) ecosystem.
+
+## Commands
+
+```bash
+rake                    # Run specs + rubocop (default task)
+bundle exec rspec       # Run tests
+bundle exec rspec spec/mml_spec.rb:42  # Run single test by line
+bundle exec rspec --only-failures      # Run only previously failing tests
+bundle exec rubocop     # Lint
+bundle exec rubocop -a  # Auto-fix lint issues
+bin/console             # IRB with gem loaded
+```
+
+## Versioned Architecture
+
+**MathML 3 vs MathML 4:** The gem maintains separate class hierarchies for MathML 3 (`Mml::V3::`) and MathML 4 (`Mml::V4::`). Users must reference the versioned namespace explicitly — no backward-compat aliases.
+
+```ruby
+Mml.parse(input)                    # Default: MathML 3
+Mml.parse(input, version: 3)       # Explicit MathML 3
+Mml.parse(input, version: 4)        # MathML 4 with intent/arg attributes
+```
+
+**Directory structure:**
+- `lib/mml/v3/` — MathML 3 element classes (original)
+- `lib/mml/v4/` — MathML 4 element classes (intent/arg added, deprecated attrs removed)
+
+**Key difference:** MathML 4 adds `intent`, `arg`, `displaystyle`, and `scriptlevel` attributes as universal presentation attributes for accessibility markup.
+
+**No hidden delegation:** The `Mml` module does not alias or delegate constants. Use `Mml::V3::Math`, `Mml::V4::Mi`, etc. directly.
+
+## Entry Points
+
+- `Mml.parse(input, version: N)` — parse XML, returns `Mml::V3::Math` or `Mml::V4::Math` object graph
+- `Mml::V3.parse(input)` / `Mml::V4.parse(input)` — version-specific parsing
+- `Mml::V4::Math.from_xml(input)` — directly parse with v4 classes
+- Call `to_xml` on any element to serialize back
+
+## Pattern
+
+Each MathML element is a `Mml::V3::` or `Mml::V4::` class inheriting from `Lutaml::Model::Serializable` with an `xml do...end` DSL block. Two element types:
+- **Leaf elements** (e.g., `Mi`, `Mn`, `Mo`): use `map_content to: :value` for text content
+- **Container elements** (e.g., `Math`, `Mrow`, `Mfrac`): use `mixed_content` to accept arbitrary child elements
+
+**CommonAttributes:** A `no_root` Lutaml model imported into container elements via `import_model`. It dynamically creates `#{tag}_value` attributes for each tag in `Configuration::SUPPORTED_TAGS`. Classes that receive it are listed in `Configuration::COMMON_ATTRIBUTES_CLASSES`.
+
+**Autoloading:** Each version (`lib/mml/v3.rb`, `lib/mml/v4.rb`) autoloads its element classes. `CommonAttributes` is required after all classes exist, then `update_attributes` mixes it into the configured classes.
+
+**Namespace:** Both versions use the same URI (`http://www.w3.org/1998/Math/MathML`) — MathML 4 chose backward compatibility over a new namespace.
+
+## Spec Structure
+
+- `spec/mml_spec.rb` — tests `Mml::V3` and `Mml::V4` with separate fixture directories
+- `spec/fixtures/with_namespace/` — v3 fixtures (MathML 3)
+- `spec/fixtures/with_namespace_prefix/` — v3 fixtures with namespace prefix
+- `spec/fixtures/v4/` — v4 fixtures (MathML 4 with intent attributes)
+
+Specs use the `:nokogiri` Lutaml adapter (configured in `spec_helper.rb`). Runtime uses `:ox` adapter by default.
+
+## Key Dependencies
+
+- `lutaml-model` (~ 0.8.0) — data mapper framework; all element classes inherit from `Lutaml::Model::Serializable`
+- `moxml` — XML parsing library (uses `:ox` adapter by default)
+- `canon` — XML comparison for specs
+
+## Conventions
+
+- `frozen_string_literal: true` in all files
+- RuboCop targets Ruby 3.0; inherits from Ribose OSS guides
+- CI workflows are auto-generated by Cimas — do not edit manually
+- `Gemfile.lock` is gitignored; dependencies come from the gemspec
+- Type signatures exist in `sig/mml.rbs`

data/Gemfile

@@ -1,9 +1,7 @@
 # frozen_string_literal: true
 
 source "https://rubygems.org"
-
 gemspec
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 gem "canon"
 gem "lutaml-model", github: "lutaml/lutaml-model", branch: "main"