plurimath 0.8.11 → 0.8.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2125384d29ad98d919d7fd71cebaf3e5fdc6ffc1aa8df386f3b63f20754ae6bb
-  data.tar.gz: 64a002bc99ed60eada7e7a59df1f0bfa083eaa4427efdb0ec2fbe615db33f851
+  metadata.gz: 4c68ac69d198de23d6a021dd5d33b68cd942f95de739f92d870e70826445da59
+  data.tar.gz: 361960657e4a8a5e38a11b237744e33b9f7aa5c5eced8582f9ec9de1ca95a7b0
 SHA512:
-  metadata.gz: a88aae5ca0beb6e36de8f3e025241cb291cb2d8c44faeeb2325ea4a2276ca6c93b32176484d7698a6818cf5f05e76f3a8b0fad829ed657f417a7fda183726ba9
-  data.tar.gz: fb521143940cab36ef15320d65aad971e56e150776229809fa9bdd1014847ac36cfef09fc55f2e182338ee2e1e2a6d13f086eb0a285d01e51b847df1c07cbe53
+  metadata.gz: 8e5af5caafefef2bde39dd2330b8291bce8a3831f891141360fb5b15c6c170576023551d3aa284b08026ae2a70d67ff43a268c12002502b72387521fde0c8b78
+  data.tar.gz: 34f049ad3c1c8ce77b9abfe0def2c29ca20c06876b0ed81f92096837d10d0e1a2fd8bf51cb5c99b73e6eb3733f7a6635ab8200406cd71cbc8278c0faaa5ce672

data/README.adoc

@@ -61,16 +61,91 @@ Or install it yourself with:
 $ gem install plurimath
 ----
 
-== Usage
+== Command Line Interface (CLI) usage
+
+=== General
+
+Plurimath provides a Command Line Interface (CLI) tool for converting between
+different math formats.
+
+NOTE: Before continuing please ensure you have the gem installed.
+
+To convert math equations between formats, use the following command followed by
+appropriate options.
+
+[source,bash]
+----
+plurimath convert [options]
+----
+
+Options available are:
+
+`-i`, `--input <INPUT>`::
+Specifies the input math equation. Should be provided within double quotes.
+
+`-f`, `--input-format <FORMAT>`::
+Specifies the input format of the equation. Defaults to `asciimath`.
+
+`-p`, `--file-path <FILE_PATH>`::
+Reads input from a file instead of the command line input. Use this for larger
+inputs or when input contains special characters.
+
+`-t`, `--output-format <FORMAT>`::
+Specifies the output format type. Defaults to `mathml`.
+
+`-m`, `--math-rendering`::
+Renders the converted equation as a math zone display tree. Boolean option
+(`true`, `false`).
+
+`-d`, `--display-style`::
+Specifies the DisplayStyle for OMML and MathML outputs only. Boolean option
+(`true`, `false`).
+
+`-s`, `--split-on-linebreak`::
+Splits MathML and OMML output into multiple equations. Boolean option (`true`,
+`false`).
+
+
+=== Convert an AsciiMath equation to MathML
+
+[source,bash]
+----
+plurimath convert -i "sqrt(x^2 + y^2)" -f asciimath -t mathml
+----
+
+=== Convert an OMML equation to MathML with DisplayStyle
+
+[source,bash]
+----
+plurimath convert -i "equation" -f omml -t mathml -d true
+----
+
+=== Convert equations from a file and output as UnicodeMath
+
+[source,bash]
+----
+plurimath convert -e <file_path> -t unicodemath
+----
+
+For more detailed information and additional options, use:
+
+[source,bash]
+----
+plurimath help convert
+----
+
+
+== Ruby API
+
 
 The central data model in Plurimath is the `Plurimath::Formula` class, which
 allows you to transform any math representation language into any other
 representation language.
 
 
-=== Conversion Examples
+=== Conversion examples
 
-==== AsciiMath Formula Example
+==== AsciiMath Formula example
 
 [source,ruby]
 ----
@@ -78,7 +153,7 @@ asciimath = "sin(1)"
 formula = Plurimath::Math.parse(asciimath, :asciimath)
 ----
 
-==== MathML Formula Example
+==== MathML Formula example
 
 [source,ruby]
 ----
@@ -93,7 +168,7 @@ MATHML
 formula = Plurimath::Math.parse(mathml, :mathml)
 ----
 
-==== LaTeX Formula Example
+==== LaTeX Formula example
 
 [source,ruby]
 ----
@@ -101,7 +176,7 @@ latex = "\\sin{1}"
 formula = Plurimath::Math.parse(latex, :latex)
 ----
 
-==== UnicodeMath Formula Example
+==== UnicodeMath Formula example
 
 [source,ruby]
 ----
@@ -109,7 +184,7 @@ unicodemath = "sin(1)"
 formula = Plurimath::Math.parse(unicodemath, :unicodemath)
 ----
 
-==== OMML Formula Example
+==== OMML Formula example
 
 [source,ruby]
 ----
@@ -137,13 +212,14 @@ OMML
 formula = Plurimath::Math.parse(omml, :omml)
 ----
 
-=== Converting to Other Formats
+
+=== Converting to other formats
 
 Once you have a `Plurimath::Math::Formula` object, you can convert it to
 AsciiMath, MathML, LaTeX, UnicodeMath, or OMML by calling the respective
 conversion function on the `Formula` object.
 
-==== AsciiMath Output Conversion
+==== AsciiMath output conversion
 
 [source,ruby]
 ----
@@ -157,7 +233,7 @@ that LaTeX does. During conversion from LaTeX to AsciiMath, if a symbol is not
 supported in AsciiMath, the LaTeX symbol will be returned.
 
 
-==== LaTeX Output Conversion
+==== LaTeX output conversion
 
 [source,ruby]
 ----
@@ -165,7 +241,7 @@ formula.to_latex
 # => "\\sin1"
 ----
 
-==== MathML Output Conversion
+==== MathML output conversion
 
 [source,ruby]
 ----
@@ -173,7 +249,7 @@ formula.to_mathml
 # => "<math xmlns='http://www.w3.org/1998/Math/MathML'><mstyle displaystyle='true'><mi>sin</mi><mn>1</mn></mstyle></math>"
 ----
 
-==== UnicodeMath Output Conversion
+==== UnicodeMath output conversion
 
 [source,ruby]
 ----
@@ -181,7 +257,7 @@ formula.to_unicodemath
 # => "sin(1)"
 ----
 
-==== OMML Output Conversion
+==== OMML output conversion
 
 [source,ruby]
 ----
@@ -189,7 +265,8 @@ formula.to_omml
 # => "<m:oMathPara xmlns:m=\"http://schemas.openxmlformats.org/officeDocument/2006/math\"><m:oMath><m:f><m:fPr><m:ctrlPr /></m:fPr><m:num><m:r><m:t>sin</m:t></m:r></m:num><m:den><m:r><m:t>1</m:t></m:r></m:den></m:f></m:oMath></m:oMathPara>"
 ----
 
-== Handling Complex Mathematical Expressions
+
+==== Complex mathematical expressions
 
 Plurimath is capable of handling complex mathematical expressions with nested
 functions and operators.
@@ -197,9 +274,7 @@ functions and operators.
 This feature is particularly useful for application that requires consistent and
 accurate conversion of intricate mathematical content.
 
-=== Example of a Complex Expression
-
-Consider the following complex LaTeX expression:
+Example. Consider the following complex LaTeX expression:
 
 [source,latex]
 ----
@@ -232,13 +307,14 @@ omml = formula.to_omml
 
 
 
+== Math parse trees
 
-== Displaying the Math Parse Tree
+=== General
 
 Plurimath allows you to display the math parse tree both as `Formula` objects
 and in the math language of expression.
 
-=== Displaying as Formula Objects
+=== Displaying as Formula objects
 
 You can display the parse tree as `Formula` objects to understand the structure
 of the parsed mathematical expression.
@@ -246,14 +322,11 @@ of the parsed mathematical expression.
 [source,ruby]
 ----
 formula = Plurimath::Math.parse("sin(1)", :asciimath)
-formula.to_display(:asciimath)
-# |_ Math zone
-#   |_ "sin(1)"
-#      |_ "sin" function apply
-#         |_ "1" argument
+formula.to_display(:formula)
+# ...
 ----
 
-=== Displaying in the Math Language of Expression
+=== Displaying in the math language of expression
 
 You can also display the parse tree in the math language of expression to see
 how the expression is represented in that language.
@@ -261,11 +334,25 @@ how the expression is represented in that language.
 [source,ruby]
 ----
 formula = Plurimath::Math.parse("sin(1)", :asciimath)
+formula.to_display(:asciimath)
+# |_ Math zone
+#   |_ "sin(1)"
+#      |_ "sin" function apply
+#         |_ "1" argument
+
 formula.to_display(:latex)
 # |_ Math zone
 #   |_ "\\sin1"
 #      |_ "sin" function apply
 #         |_ "1" argument
+
+formula.to_display(:mathml)
+# |_ Math zone
+#   |_ "<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle displaystyle="true"><mrow><mi>sin</mi><mrow><mo>(</mo><mn>1</mn><mo>)</mo></mrow></mrow></mstyle></math>"
+#      |_ "<mrow><mi>sin</mi><mrow><mo>(</mo><mn>1</mn><mo>)</mo></mrow></mrow>" function apply
+#         |_ "sin" function name
+#         |_ "<mrow><mo>(</mo><mn>1</mn><mo>)</mo></mrow>" argument
+#            |_ "<mtext>1</mtext>" text
 ----
 
 // == Integration
@@ -311,11 +398,11 @@ h = 6.62607015 xx 10^(-34) "unitsml(kg*m^2*s^(-1))"
 
 ==== Step-by-Step Customization
 
-. **Parse the UnitsML Expression**
-. **Customize and Convert to AsciiMath**
-. **Customize and Convert to MathML**
-. **Customize and Convert to UnicodeMath**
-. **Customize and Convert to OMML**
+. Parse the UnitsML Expression
+. Customize and Convert to AsciiMath
+. Customize and Convert to MathML
+. Customize and Convert to UnicodeMath
+. Customize and Convert to OMML
 
 ==== Parse the UnitsML Expression
 
@@ -341,7 +428,7 @@ puts asciimath
 # Output: 'h = 6.62607015 xx 10^(-34) "unitsml(kg*m^2*s^(-1))"'
 ----
 
-==== Customize and Convert to MathML
+==== Customize and convert to MathML
 
 To customize the MathML output, you can use additional attributes and options:
 
@@ -353,7 +440,7 @@ puts mathml
 # Output: "<math xmlns='http://www.w3.org/1998/Math/MathML'><mrow><mi>h</mi><mo>=</mo><mn>6.62607015</mn><mo>×</mo><msup><mn>10</mn><mrow><mo>−</mo><mn>34</mn></mrow></msup><mtext>kg·m²·s⁻¹</mtext></mrow></math>"
 ----
 
-==== Customize and Convert to UnicodeMath
+==== Customize and convert to UnicodeMath
 
 Similarly, customize the UnicodeMath output:
 
@@ -365,7 +452,7 @@ puts unicodemath
 # Output: 'h = 6.62607015 × 10^(−34) kg·m²·s⁻¹'
 ----
 
-==== Customize and Convert to OMML
+==== Customize and convert to OMML
 
 For OMML output, you can customize the XML structure:
 
@@ -377,7 +464,7 @@ puts omml
 # Output: "<m:oMathPara xmlns:m='http://schemas.openxmlformats.org/officeDocument/2006/math'><m:oMath><m:r><m:t>h</m:t></m:r><m:r><m:t>=</m:t></m:r><m:r><m:t>6.62607015</m:t></m:r><m:r><m:t>×</m:t></m:r><m:sSup><m:sSupPr><m:ctrlPr /></m:sSupPr><m:e><m:r><m:t>10</m:t></m:r></m:e><m:sup><m:r><m:t>−34</m:t></m:r></m:sup></m:sSup><m:r><m:t>kg·m²·s⁻¹</m:t></m:r></m:oMath></m:oMathPara>"
 ----
 
-=== Complete Example Code with Customization
+=== Complete example code with customization
 
 Here's the complete code for parsing, converting, and customizing the UnitsML
 expression between different formats:
@@ -434,7 +521,7 @@ as a text string of `"__{symbol-name}"`. Plurimath can recognize it, but other
 renderers or processors would treat it as a single symbol, which is accurate.
 
 
-=== Example of Compatibility Wrapper
+=== Usage of the compatibility wrapper
 
 For a symbol like `backepsilon`.
 
@@ -466,12 +553,13 @@ In MathML:
 <mi>∍</mi>
 ----
 
-== XML Engines
 
-**Plurimath** supports two XML engines:
+== XML engines
+
+Plurimath supports two XML engines:
 
+. **Ox**: (default) A fast XML parser
 . **Oga**: A pure Ruby XML parser
-. **Ox**: A fast XML parser
 
 By default, **Ox** is used.
 
@@ -479,12 +567,13 @@ To switch to **Oga**, use the following syntax:
 
 [source,ruby]
 ----
-require "plurimath/xml_engines/oga" = load files related to Oga
-Plurimath.xml_engine = Plurimath::XmlEngine::Oga = set Oga as Plurimath XML engine
+require "plurimath/xml_engines/oga"
+Plurimath.xml_engine = Plurimath::XmlEngine::Oga
 ----
 
 You can switch back to **Ox** similarly.
 
+
 === Supported content
 
 === General

data/exe/plurimath

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "plurimath/cli"
+
+Plurimath::Cli.start(ARGV)

data/lib/plurimath/cli.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Plurimath
+  self.autoload :Math, "plurimath/math"
+
+  class Cli < Thor
+    desc "convert", "Convert between math formats"
+
+    option :input,
+           aliases: "-i",
+           desc: "Input value should be in quoted string"
+
+    option :input_format,
+           aliases: "-f",
+           default: "asciimath",
+           desc: "Input format should be in quoted string => \"asciimath\""
+
+    option :file_path,
+           aliases: "-p",
+           desc: "Reads input from a file instead of the command line input. Use this for larger inputs or when input contains special characters.",
+           force: :boolean
+
+    option :output_format,
+           aliases: "-t",
+           default: "mathml",
+           desc: "Convert to language type, Output format should be in quoted string"
+
+    option :math_rendering,
+           aliases: "-m",
+           force: :boolean,
+           default: 'false',
+           desc: "Render converted equation as math zone display tree, Boolean only"
+
+    option :display_style,
+           aliases: "-d",
+           desc: "DisplayStyle is only supported for OMML and MathML conversion, Boolean only",
+           force: :boolean
+
+    option :split_on_linebreak,
+           aliases: "-s",
+           desc: "Splits only MathML and OMML equations into multiple equations, Boolean only",
+           force: :boolean
+
+    def convert
+      input          = options[:input]
+      input_string   = options[:file_path] ? File.read(options[:file_path]) : input
+      warn_and_exit("missing generator argument --input or --file-input") unless input_string
+
+      input_format   = options[:input_format]
+      output_format  = options[:output_format]
+      formula        = Plurimath::Math.parse(input_string, input_format)
+      return puts formula.to_display(output_format.to_sym) if YAML.safe_load(options[:math_rendering])
+
+      display_style  = options[:display_style]
+      split          = options[:split_on_linebreak]
+      style          = display_style.to_s.empty? ? "true" : display_style
+      output_text = case output_format
+                    when "unicodemath"
+                      formula.to_unicodemath
+                    when "asciimath"
+                      formula.to_asciimath
+                    when "mathml"
+                      formula.to_mathml(display_style: style, split_on_linebreak: split)
+                    when "latex"
+                      formula.to_latex
+                    when "omml"
+                      formula.to_omml(display_style: style, split_on_linebreak: split)
+                    else
+                      warn_and_exit("Invalid output format: #{output_format}")
+                    end
+
+      puts output_text
+    end
+
+    no_commands do
+      def warn_and_exit(message)
+        warn(message)
+        exit 1
+      end
+    end
+  end
+end

data/lib/plurimath/latex/parser.rb

@@ -8,17 +8,10 @@ module Plurimath
     class Parser
       attr_accessor :text
 
+      TEXT_REGEX = %r(\\(?:mbox|text){[^}]+})
+
       def initialize(text)
-        enti = HTMLEntities.new
-        text = enti.encode(enti.decode(text), :hexadecimal)
-        text = text
-          .gsub(/((?<!\\) )|\n+/, "")
-          .gsub(/\\\\ /, "\\\\\\\\")
-          .gsub(/&#x26;/, "&")
-          .gsub(/&#x22;/, "\"")
-          .gsub(/(?<!\\\\)\\&#xa;/, "\\ ")
-          .gsub(/&#xa;/, "")
-        @text = text
+        @text = pre_processing(text)
       end
 
       def parse
@@ -28,6 +21,26 @@ module Plurimath
 
         Math::Formula.new(formula)
       end
+
+      private
+
+      def pre_processing(text)
+        text_functions = text.scan(TEXT_REGEX)
+        enti = HTMLEntities.new
+        text = enti.encode(enti.decode(text), :hexadecimal)
+        text = gsub_space_and_unicodes(text)
+        text.gsub(TEXT_REGEX) { |str| text_functions.shift }
+      end
+
+      def gsub_space_and_unicodes(text)
+        text
+          .gsub(/((?<!\\) )|\n+/, "")
+          .gsub(/\\\\ /, "\\\\\\\\")
+          .gsub(/&#x26;/, "&")
+          .gsub(/&#x22;/, "\"")
+          .gsub(/(?<!\\\\)\\&#xa;/, "\\ ")
+          .gsub(/&#xa;/, "")
+      end
     end
   end
 end

data/lib/plurimath/math/core.rb

@@ -116,6 +116,16 @@ module Plurimath
         options[:array] << field&.to_omml_math_zone(hashed[:function_spacing], hashed[:last], hashed[:indent], display_style: display_style)
       end
 
+      def unicodemath_fields_to_print(field, options = {})
+        return if field.nil?
+
+        hashed = common_math_zone_conversion(field, options)
+        options[:array] << "#{hashed[:spacing]}|_ \"#{field&.to_unicodemath}\"#{hashed[:field_name]}\n"
+        return unless Utility.validate_math_zone(field, lang: :unicodemath)
+
+        options[:array] << field&.to_unicodemath_math_zone(hashed[:function_spacing], hashed[:last], hashed[:indent])
+      end
+
       def dump_mathml(field, intent = false)
         dump_ox_nodes(field.to_mathml_without_math_tag(intent)).gsub(/\n\s*/, "")
       end

data/lib/plurimath/math/formula.rb

@@ -10,6 +10,7 @@ module Plurimath
         latex
         mathml
         asciimath
+        unicodemath
       ].freeze
       POWER_BASE_CLASSES = %w[powerbase power base].freeze
       DERIVATIVE_CONSTS = [
@@ -165,6 +166,8 @@ module Plurimath
                       "  |_ \"#{to_mathml.gsub(/\n\s*/, "")}\"\n#{to_mathml_math_zone("     ").join}"
                     when :omml
                       "  |_ \"#{to_omml.gsub(/\n\s*/, "")}\"\n#{to_omml_math_zone("     ", display_style: displaystyle).join}"
+                    when :unicodemath
+                      "  |_ \"#{to_unicodemath}\"\n#{to_unicodemath_math_zone("     ").join}"
                     end
         <<~MATHZONE.sub(/\n$/, "")
         |_ Math zone
@@ -200,6 +203,13 @@ module Plurimath
         end
       end
 
+      def to_unicodemath_math_zone(spacing = "", last = false, indent = true)
+        filtered_values(value, lang: :unicodemath).map.with_index(1) do |object, index|
+          last = index == @values.length
+          object.to_unicodemath_math_zone(new_space(spacing, indent), last, indent)
+        end
+      end
+
       def extract_class_name_from_text
         return unless value.length < 2 && value.first.is_a?(Function::Text)
 

data/lib/plurimath/math/function/binary_function.rb

@@ -100,6 +100,15 @@ module Plurimath
           new_arr
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          parameters = self.class::FUNCTION
+          new_spacing = gsub_spacing(spacing, last)
+          new_arr = ["#{spacing}\"#{to_unicodemath}\" #{parameters[:name]}\n"]
+          unicodemath_fields_to_print(parameter_one, { spacing: new_spacing, field_name: parameters[:first_value], additional_space: "|  |_ " , array: new_arr })
+          unicodemath_fields_to_print(parameter_two, { spacing: new_spacing, field_name: parameters[:second_value], additional_space: "   |_ " , array: new_arr })
+          new_arr
+        end
+
         protected
 
         def latex_wrapped(field)

data/lib/plurimath/math/function/fenced.rb

@@ -31,7 +31,7 @@ module Plurimath
         def to_mathml_without_math_tag(intent)
           first_value = ox_element("mo", attributes: options&.dig(:open_paren)) << (mathml_paren(parameter_one, intent) || "")
           third_value = ox_element("mo", attributes: options&.dig(:close_paren)) << (mathml_paren(parameter_three, intent) || "")
-          mrow_value = mathml_value(intent).insert(0, first_value) << third_value
+          mrow_value = Array(mathml_value(intent)).insert(0, first_value) << third_value
           fenced = Utility.update_nodes(ox_element("mrow"), mrow_value)
           intentify(
             fenced,
@@ -93,22 +93,22 @@ module Plurimath
 
         def to_asciimath_math_zone(spacing, last = false, indent = true)
           filtered_values(parameter_two, lang: :asciimath).map.with_index(1) do |object, index|
-            last = index == @values.length
-            object.to_asciimath_math_zone(spacing, last, indent)
+            new_last = index == @values.length && last
+            object.to_asciimath_math_zone(spacing, new_last, indent)
           end
         end
 
         def to_latex_math_zone(spacing, last = false, indent = true)
           filtered_values(parameter_two, lang: :latex).map.with_index(1) do |object, index|
-            last = index == @values.length
-            object.to_latex_math_zone(spacing, last, indent)
+            new_last = index == @values.length && last
+            object.to_latex_math_zone(spacing, new_last, indent)
           end
         end
 
         def to_mathml_math_zone(spacing, last = false, indent = true)
           filtered_values(parameter_two, lang: :mathml).map.with_index(1) do |object, index|
-            last = index == @values.length
-            object.to_mathml_math_zone(spacing, last, indent)
+            new_last = index == @values.length && last
+            object.to_mathml_math_zone(spacing, new_last, indent)
           end
         end
 
@@ -118,6 +118,13 @@ module Plurimath
           end
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, indent = true)
+          filtered_values(parameter_two, lang: :unicodemath).map.with_index(1) do |object, index|
+            new_last = index == @values.length && last
+            object.to_unicodemath_math_zone(spacing, new_last, indent)
+          end
+        end
+
         def line_breaking(obj)
           field_values = result(Array(parameter_two))
           return unless field_values.length > 1
@@ -254,7 +261,7 @@ module Plurimath
         end
 
         def binomial_coefficient?(value)
-          parameter_two.first.is_a?(Frac) &&
+          parameter_two&.first&.is_a?(Frac) &&
             parameter_two&.first&.options&.dig(:choose)
         end
 

data/lib/plurimath/math/function/font_style.rb

@@ -120,6 +120,16 @@ module Plurimath
           end
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          new_spacing = gsub_spacing(spacing, last)
+          new_arr = [
+            "#{spacing}\"#{dump_unicodemath(self)}\" function apply\n",
+            "#{new_spacing}|_ \"#{font_family(unicode: true)}\" font family\n",
+          ]
+          unicodemath_fields_to_print(parameter_one, { spacing: new_spacing, field_name: "argument", additional_space: "|  |_ ", array: new_arr })
+          new_arr
+        end
+
         def line_breaking(obj)
           parameter_one&.line_breaking(obj)
           return unless obj.value_exist?

data/lib/plurimath/math/function/left.rb

@@ -59,6 +59,10 @@ module Plurimath
           "#{spacing}\"#{dump_ox_nodes(t_tag).gsub(/\s+/, "")}\" left\n"
         end
 
+        def to_unicodemath_math_zone(spacing = "", _, _)
+          "#{spacing}\"#{parameter_one}\" left\n"
+        end
+        
         protected
 
         def left_paren

data/lib/plurimath/math/function/msgroup.rb

@@ -57,6 +57,13 @@ module Plurimath
           ]
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, indent = true)
+          [
+            "#{spacing}\"msgroup\" function apply\n",
+            Formula.new(parameter_one).to_unicodemath_math_zone(gsub_spacing(spacing, last), last, indent),
+          ]
+        end
+
         def to_unicodemath
           parameter_one.map(&:to_unicodemath).join
         end

data/lib/plurimath/math/function/right.rb

@@ -59,6 +59,10 @@ module Plurimath
           "#{spacing}\"#{dump_ox_nodes(t_tag).gsub(/\s+/, "")}\" right\n"
         end
 
+        def to_unicodemath_math_zone(spacing = "", _, _)
+          "#{spacing}\"#{parameter_one}\" right\n"
+        end
+        
         protected
 
         def right_paren

data/lib/plurimath/math/function/table.rb

@@ -117,6 +117,13 @@ module Plurimath
           ]
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, indent = true)
+          [
+            "#{spacing}\"table\" function apply\n",
+            Formula.new(value).to_unicodemath_math_zone(gsub_spacing(spacing, last), last, indent),
+          ]
+        end
+
         protected
 
         def mathml_parenthesis(field, intent)

data/lib/plurimath/math/function/td.rb

@@ -76,6 +76,20 @@ module Plurimath
           ]
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          [
+            "#{spacing}\"td\" function apply\n",
+            Formula.new(parameter_one).to_unicodemath_math_zone(gsub_spacing(spacing, last), last),
+          ]
+        end
+
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          [
+            "#{spacing}\"td\" function apply\n",
+            Formula.new(parameter_one).to_unicodemath_math_zone(gsub_spacing(spacing, last), last),
+          ]
+        end
+        
         def omml_content(display_style)
           parameter_one&.map { |val| val.insert_t_tag(display_style) }
         end

data/lib/plurimath/math/function/ternary_function.rb

@@ -101,6 +101,16 @@ module Plurimath
           new_arr
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          parameters = self.class::FUNCTION
+          new_spacing = gsub_spacing(spacing, last)
+          new_arr = ["#{spacing}\"#{to_unicodemath}\" #{parameters[:name]}\n"]
+          unicodemath_fields_to_print(parameter_one, { spacing: new_spacing, field_name: parameters[:first_value], additional_space: "|  |_ ", array: new_arr })
+          unicodemath_fields_to_print(parameter_two, { spacing: new_spacing, field_name: parameters[:second_value], additional_space: "  |_ ", array: new_arr })
+          unicodemath_fields_to_print(parameter_three, { spacing: new_spacing, field_name: parameters[:third_value], additional_space: "   |_ ", array: new_arr })
+          new_arr
+        end
+
         protected
 
         def latex_wrapped(field)

data/lib/plurimath/math/function/text.rb

@@ -71,6 +71,10 @@ module Plurimath
           parameter_one
         end
 
+        def to_unicodemath_math_zone(spacing, _, _)
+          "#{spacing}#{to_unicodemath} text\n"
+        end
+        
         protected
 
         def symbol_value(unicode)

data/lib/plurimath/math/function/tr.rb

@@ -80,6 +80,13 @@ module Plurimath
           ]
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, indent = true)
+          [
+            "#{spacing}\"tr\" function apply\n",
+            Formula.new(parameter_one).to_unicodemath_math_zone(gsub_spacing(spacing, last), last, indent),
+          ]
+        end
+
         def remove_hline(first_value)
           row_lines = first_value.first.parameter_one
           row_lines.shift if row_lines.first.is_a?(Math::Symbols::Hline)

data/lib/plurimath/math/function/unary_function.rb

@@ -110,6 +110,16 @@ module Plurimath
           new_arr
         end
 
+        def to_unicodemath_math_zone(spacing, last = false, _)
+          new_spacing = gsub_spacing(spacing, last)
+          new_arr = [
+            "#{spacing}\"#{to_unicodemath}\" function apply\n",
+            "#{new_spacing}|_ \"#{class_name}\" function name\n",
+          ]
+          unicodemath_fields_to_print(parameter_one, { spacing: new_spacing, field_name: "argument", additional_space: "   |_ " , array: new_arr })
+          new_arr
+        end
+
         def custom_array_line_breaking(obj)
           parameter_value = result(parameter_one)
           if parameter_value.size > 1

data/lib/plurimath/math/symbols/pi.rb

@@ -3,12 +3,12 @@ module Plurimath
     module Symbols
       class Pi < Symbol
         INPUT = {
-          unicodemath: [["pi", "&#x3c0;"], parsing_wrapper(["uppi"])],
-          asciimath: [["pi", "&#x3c0;"], parsing_wrapper(["uppi"])],
-          mathml: [["&#x3c0;"]],
-          latex: [["pi", "uppi", "&#x3c0;"]],
-          omml: [["&#x3c0;"]],
-          html: ["&#x3C0;"],
+          unicodemath: ["pi", "&#x3c0;", "&#x1d70b;", parsing_wrapper(["uppi"])],
+          asciimath: ["pi", "&#x3c0;", "&#x1d70b;", parsing_wrapper(["uppi"])],
+          mathml: ["&#x3c0;", "&#x1d70b;"],
+          latex: ["pi", "uppi", "&#x3c0;", "&#x1d70b;"],
+          omml: ["&#x3c0;", "&#x1d70b;"],
+          html: ["&#x3C0;", "&#x1d70b;"],
         }.freeze
 
         # output methods

data/lib/plurimath/math/symbols/symbol.rb

@@ -127,6 +127,10 @@ module Plurimath
           "#{spacing}\"#{dump_mathml(self)}\" text\n"
         end
 
+        def to_unicodemath_math_zone(spacing = "", last = false, indent = true)
+          "#{spacing}\"#{to_unicodemath}\" text\n"
+        end
+
         def paren?
           false
         end

data/lib/plurimath/math/symbols/theta.rb

@@ -3,12 +3,12 @@ module Plurimath
     module Symbols
       class Theta < Symbol
         INPUT = {
-          unicodemath: [["theta", "&#x3b8;"], parsing_wrapper(["uptheta"])],
-          asciimath: [["theta", "&#x3b8;"], parsing_wrapper(["uptheta"])],
-          mathml: ["&#x3b8;"],
-          latex: [["uptheta", "theta", "&#x3b8;"]],
-          omml: ["&#x3b8;"],
-          html: ["&#x3b8;"],
+          unicodemath: ["theta", "&#x3b8;", "&#x1d703;", parsing_wrapper(["uptheta"])],
+          asciimath: ["theta", "&#x3b8;", "&#x1d703;", parsing_wrapper(["uptheta"])],
+          mathml: ["&#x3b8;", "&#x1d703;"],
+          latex: ["uptheta", "theta", "&#x3b8;", "&#x1d703;"],
+          omml: ["&#x3b8;", "&#x1d703;"],
+          html: ["&#x3b8;", "&#x1d703;"],
         }.freeze
 
         # output methods

data/lib/plurimath/mathml/parser.rb

@@ -19,6 +19,7 @@ module Plurimath
         notation
         bevelled
         rowlines
+        intent
         accent
         height
         frame

data/lib/plurimath/mathml/transform.rb

@@ -383,6 +383,7 @@ module Plurimath
                        height
                        accent
                        height
+                       intent
                        width
                        index
                        depth

data/lib/plurimath/unicode_math/parsing_rules/sub_sup.rb

@@ -59,7 +59,7 @@ module Plurimath
           (operator.absent? >> naryand_values >> naryand_recursion.as(:naryand_recursion).maybe) |
             (slashed_operator >> naryand_recursion.as(:naryand_recursion).maybe)
         end
-        
+
         rule(:baseless_sub) do
           (invisible_space? >> base_syntax >> op_size_overrides_symbols.absent? >> (operator_symbols.maybe >> baseless_sub_values(:sub_script))) |
             (invisible_space? >> base_syntax >> op_size_overrides_symbols.absent? >> (operator_symbols >> recursive_baseless_sub_exp.maybe)) |
@@ -220,8 +220,8 @@ module Plurimath
           (operator_symbols.as(:expr) >> (((mini_sub_sup | sub_or_sup) >> space?) >> bracketed_soperand.maybe)) |
             (operator_symbols.as(:expr) >> bracketed_soperand) |
             (((primes | prefixed_primes).as(:symbol).as(:first_value) >> repeated_accent_symbols).as(:accents) >> (sub_or_sup.maybe >> space? >> bracketed_soperand).maybe) |
-            bracketed_soperand >> operator_symbols.absent? >> sub_sup_values.as(:expr).maybe |
-            sub_sup_binary_absent >> operator_symbols.absent? >> sub_sup_values.as(:expr).maybe |
+            bracketed_soperand >> str("−").absent? >> operator_symbols.absent? >> sub_sup_values.as(:expr).maybe |
+            sub_sup_binary_absent >> str("−").absent? >> operator_symbols.absent? >> sub_sup_values.as(:expr).maybe |
             bracketed_soperand |
             prefixed_primes |
             primes |

data/lib/plurimath/unicode_math/transform.rb

@@ -172,7 +172,7 @@ module Plurimath
                         else
                           (Constants::NARY_CLASSES.invert[nary_class.to_s] || Constants::NARY_SYMBOLS[nary_class.to_sym] || nary_class)
                         end
-        Utility.get_class(nary_function).new 
+        Utility.get_class(nary_function).new
       end
 
       rule(ordinary_negated_operator: simple(:operator)) do
@@ -518,6 +518,12 @@ module Plurimath
         [Utility.symbols_class(symbol, lang: :unicodemath), sup_script]
       end
 
+      rule(combined_symbols: simple(:combined_symbols),
+           exp: simple(:exp)) do
+        symbol = Constants::COMBINING_SYMBOLS[combined_symbols.to_sym]
+        [Utility.symbols_class(symbol, lang: :unicodemath), exp]
+      end
+
       rule(operator: simple(:operator),
            sub_script: simple(:sub_script)) do
         [Utility.symbols_class(operator, lang: :unicodemath), sub_script]
@@ -1531,17 +1537,6 @@ module Plurimath
         )
       end
 
-      rule(unary_functions: simple(:unary),
-           first_value: simple(:first_value)) do
-        if Constants::UNDEF_UNARY_FUNCTIONS.include?(unary.to_s)
-          Math::Formula.new([
-            Utility.symbols_class(unary, lang: :unicodemath),
-            first_value,
-          ])
-        else
-          Utility.get_class(unary).new(first_value)
-        end
-      end
 
       rule(unary_functions: simple(:unary),
            first_value: simple(:first_value)) do
@@ -1550,6 +1545,8 @@ module Plurimath
             Utility.symbols_class(unary, lang: :unicodemath),
             first_value,
           ])
+        elsif unary == "mod"
+          Math::Function::Mod.new(nil, first_value)
         else
           Utility.get_class(unary).new(first_value)
         end
@@ -3126,6 +3123,17 @@ module Plurimath
         [fenced] + naryand_recursion
       end
 
+      rule(open_paren: simple(:open_paren),
+           unary_subsup: simple(:unary_subsup),
+           exp: simple(:exp),
+           close_paren: simple(:close_paren)) do
+        Math::Function::Fenced.new(
+          open_paren.is_a?(Slice) ? Utility.symbols_class(open_paren, lang: :unicodemath) : open_paren,
+          [unary_subsup, exp],
+          close_paren.is_a?(Slice) ? Utility.symbols_class(close_paren, lang: :unicodemath) : close_paren,
+        )
+      end
+
       rule(open_paren: simple(:open_paren),
            factor: simple(:factor),
            close_paren: simple(:close_paren),
@@ -3949,6 +3957,18 @@ module Plurimath
         )
       end
 
+      rule(open_paren: simple(:open_paren),
+           factor: sequence(:factor),
+           operand: simple(:operand),
+           exp: simple(:exp),
+           close_paren: simple(:close_paren)) do
+        Math::Function::Fenced.new(
+          Utility.symbols_class(open_paren, lang: :unicodemath),
+          factor + [operand, exp],
+          Utility.symbols_class(close_paren, lang: :unicodemath),
+        )
+      end
+
       rule(open_paren: simple(:open_paren),
            pre_subscript: simple(:pre_sub),
            pre_supscript: simple(:pre_sup),

data/lib/plurimath/utility.rb

@@ -482,7 +482,14 @@ module Plurimath
       end
 
       def join_attr_value(attrs, value, unicode_only: false, lang: :mathml)
-        if value.any?(String)
+        if attrs&.is_a?(Hash) && attrs.key?(:intent)
+          [
+            Math::Function::Intent.new(
+              filter_values(join_attr_value(nil, value, unicode_only: unicode_only, lang: lang)),
+              Math::Function::Text.new(attrs[:intent]),
+            )
+          ]
+        elsif value.any?(String)
           new_value = mathml_unary_classes(value, unicode_only: unicode_only, lang: lang)
           array_value = Array(new_value)
           attrs.nil? ? array_value : join_attr_value(attrs, array_value, unicode_only: unicode_only)

data/lib/plurimath/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Plurimath
-  VERSION = "0.8.11"
+  VERSION = "0.8.12"
 end

data/plurimath.gemspec

@@ -26,5 +26,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.add_dependency 'twitter_cldr'
   spec.add_dependency 'parslet'
+  spec.add_dependency 'thor'
   spec.add_dependency 'ox'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plurimath
 version: !ruby/object:Gem::Version
-  version: 0.8.11
+  version: 0.8.12
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-07-18 00:00:00.000000000 Z
+date: 2024-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: twitter_cldr
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: ox
   requirement: !ruby/object:Gem::Requirement
@@ -55,7 +69,8 @@ dependencies:
 description: Converts LaTeX math into MathML.
 email:
 - open.source@ribose.com
-executables: []
+executables:
+- plurimath
 extensions: []
 extra_rdoc_files: []
 files:
@@ -79,12 +94,14 @@ files:
 - UnitsML-Supported-Data.adoc
 - bin/console
 - bin/setup
+- exe/plurimath
 - lib/plurimath.rb
 - lib/plurimath/asciimath.rb
 - lib/plurimath/asciimath/constants.rb
 - lib/plurimath/asciimath/parse.rb
 - lib/plurimath/asciimath/parser.rb
 - lib/plurimath/asciimath/transform.rb
+- lib/plurimath/cli.rb
 - lib/plurimath/formatter/localized_number.rb
 - lib/plurimath/formatter/number_data_reader.rb
 - lib/plurimath/formatter/number_formatter.rb