plurimath 0.11.12 → 0.11.13

data/lib/plurimath/math/formula/class_tree.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Plurimath
+  module Math
+    class Formula
+      # The stored model composition, independent of language rendering and its
+      # filtering. Only model content fields are visited; formatting options,
+      # source text, XML objects and rendering caches are deliberately omitted.
+      class ClassTree
+        UNCERTAINTY_FIELDS = %i[
+          value category magnitude coverage_factor coverage_probability lower
+          upper interval_kind notation unit
+        ].freeze
+
+        def render(formula)
+          lines = []
+          append(formula, nil, 0, lines, {})
+          lines.join("\n")
+        end
+
+        private
+
+        def append(object, label, depth, lines, ancestors)
+          prefix = "#{'  ' * depth}#{"#{label}: " if label}"
+          unless object.is_a?(Core) || object.is_a?(::Array)
+            lines << "#{prefix}#{literal(object)}"
+            return
+          end
+
+          if ancestors.key?(object.object_id)
+            lines << "#{prefix}<cycle: #{object.class.name}>"
+            return
+          end
+
+          ancestors[object.object_id] = true
+          begin
+            if object.is_a?(::Array)
+              append_array(object, label, depth, lines, ancestors)
+            else
+              lines << "#{prefix}#{object.class.name}"
+              fields(object).each do |field|
+                append(object.public_send(field), field, depth + 1,
+                       lines, ancestors)
+              end
+            end
+          ensure
+            ancestors.delete(object.object_id)
+          end
+        end
+
+        def append_array(array, label, depth, lines, ancestors)
+          if array.empty?
+            lines << "#{'  ' * depth}#{label}: []"
+          else
+            array.each_with_index do |child, index|
+              append(child, "#{label}[#{index}]", depth, lines, ancestors)
+            end
+          end
+        end
+
+        def fields(object)
+          case object
+          when Function::Table
+            %i[value open_paren close_paren]
+          when Function::Uncertainty
+            UNCERTAINTY_FIELDS
+          else
+            parameters = Core::ALL_PARAMETERS.select do |field|
+              object.respond_to?(field)
+            end
+            return parameters unless parameters.empty?
+            return [:value] if object.respond_to?(:value)
+            return [:text] if object.respond_to?(:text)
+
+            []
+          end
+        end
+
+        def literal(object)
+          case object
+          when String, ::Symbol, Numeric, true, false, nil
+            object.inspect
+          else
+            # Never delegate to arbitrary #inspect: that can expose internal
+            # state or memory addresses in otherwise deterministic output.
+            "<#{object.class.name}>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plurimath/math/formula.rb

@@ -5,6 +5,7 @@ module Plurimath
     class Formula < Core
       autoload :Mrow, "#{__dir__}/formula/mrow"
       autoload :Mstyle, "#{__dir__}/formula/mstyle"
+      autoload :ClassTree, "#{__dir__}/formula/class_tree"
 
       include Mathml::FormulaTransformation
 
@@ -13,7 +14,7 @@ module Plurimath
 
       POWER_BASE_CLASSES = %w[powerbase power base].freeze
       DERIVATIVE_CONSTS  = ["&#x1d451;", "&#x2145;", "&#x2146;", "d"].freeze
-      MATH_ZONE_TYPES    = %i[omml latex mathml asciimath unicodemath].freeze
+      MATH_ZONE_TYPES    = %i[omml latex mathml asciimath unicodemath formula].freeze
       OMML_NAMESPACES    = {
         "xmlns:m": "http://schemas.openxmlformats.org/officeDocument/2006/math",
         "xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
@@ -195,13 +196,23 @@ formatter: nil, unitsml: {})
       end
 
       def to_display(type = nil, formatter: nil, unitsml: {},
-unary_function_spacing: true)
+unary_function_spacing: true, tree: :display)
+        unless %i[display semantic].include?(tree)
+          raise ArgumentError, "Unknown display tree: #{tree.inspect}"
+        end
+        if tree == :display && type.downcase.to_sym == :formula
+          return ClassTree.new.render(self)
+        end
+
         options = {
           formatter: formatter,
           unitsml: unitsml,
           unary_function_spacing: unary_function_spacing,
         }
         options[:formula] ||= self
+        if tree == :semantic
+          return SemanticTree.new(type.downcase.to_sym, options).render(self)
+        end
         return type_error!(type) unless MATH_ZONE_TYPES.include?(type.downcase.to_sym)
 
         math_zone = case type
@@ -402,6 +413,36 @@ options:)
           ],
         )
       end
+
+      # Render this formula to a binary image string via the optional `lasem`
+      # gem (https://github.com/plurimath/lasem-ruby).
+      #
+      # +format+ is the output image format, one of :svg, :png, :pdf, :ps.
+      #
+      # Remaining keyword options are split between the two stages:
+      #   * to_mathml options (forwarded to #to_mathml): :intent, :formatter,
+      #     :unitsml, :split_on_linebreak, :display_style,
+      #     :unary_function_spacing. When :display_style is omitted the
+      #     formula's own displaystyle is used.
+      #   * lasem geometry options (forwarded to the renderer): :ppi, :zoom,
+      #     :width, :height, :offset_x, :offset_y. Omit them for lasem defaults.
+      # Unrecognized keyword options are ignored.
+      #
+      # Raises a Plurimath::Errors rendering error (RenderingUnavailable,
+      # UnsupportedRenderFormat, or RenderingFailed) when lasem / its native
+      # extension is unavailable, the format is unsupported, or rendering fails.
+      # A malformed formula surfaces as Plurimath::Math::ParseError from
+      # #to_mathml, not as a rendering error. Note: :split_on_linebreak emits
+      # multiple <math> roots,
+      # which lasem cannot render as a single document.
+      def render(format: :svg, **opts)
+        mathml = to_mathml(**opts.slice(*Renderer::MATHML_OPTIONS).compact)
+        Renderer.render(
+          mathml,
+          format: format,
+          **opts.slice(*Renderer::LASEM_OPTIONS),
+        )
+      end
       # Attributes end
 
       protected

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Abs < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The absolute value of an expression."
+        REFERENCE = "https://en.wikipedia.org/wiki/Absolute_value"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :open_paren, :close_paren
 
         def to_mathml_without_math_tag(intent, options:)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Arccos < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The inverse cosine (arccosine) function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Inverse_trigonometric_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Arcsin < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The inverse sine (arcsine) function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Inverse_trigonometric_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Arctan < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The inverse tangent (arctangent) function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Inverse_trigonometric_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Arg < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An expression given an `arg` name for reference from an ancestor MathML `intent` annotation."
+        REFERENCE = "https://www.w3.org/TR/mathml4/#mixing_intent"
+        EXAMPLE = -> { new(sym("x"), sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["The argument name is emitted as visible content instead of an arg annotation."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["The argument name is emitted as visible content instead of an arg annotation."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["The argument name is emitted as visible content instead of an arg annotation."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_mathml_without_math_tag(intent, options:)
           first_value = parameter_one.to_mathml_without_math_tag(intent,
                                                                  options: options)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Bar < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An overbar (vinculum) over an expression."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mover"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :attributes
 
         def initialize(parameter_one = nil, attributes = {})

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Base < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A base carrying a subscript."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/msub"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         attr_accessor :options
 
         FUNCTION = {

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

@@ -4,6 +4,10 @@ module Plurimath
   module Math
     module Function
       class BinaryFunction < Core
+        extend Documentation
+
+        CATALOG_TYPE = :binary
+
         attr_accessor :parameter_one, :parameter_two, :hide_function_name
 
         def initialize(parameter_one = nil, parameter_two = nil)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Cancel < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Strikes its argument through with a diagonal line."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/menclose"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_mathml_without_math_tag(intent, options:)
           cancel_tag = XmlHelper.ox_element(
             "menclose",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Ceil < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The ceiling of a value, rounded up to an integer."
+        REFERENCE = "https://en.wikipedia.org/wiki/Floor_and_ceiling_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :open_paren, :close_paren
 
         def to_latex(options:)

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

@@ -4,6 +4,18 @@ module Plurimath
   module Math
     module Function
       class Color < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An expression rendered in a specified color."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mstyle"
+        EXAMPLE = -> { new(sym("red"), sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          omml: {
+            status: :limited,
+            notes: ["Color styling is omitted; only the expression is emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         attr_accessor :options
 
         FUNCTION = {

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Cos < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The cosine function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Sine_and_cosine"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Cosh < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic cosine function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Hyperbolic_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Cot < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The cotangent function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Trigonometric_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Coth < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic cotangent function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Hyperbolic_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Csc < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The cosecant function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Trigonometric_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Csch < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic cosecant function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Hyperbolic_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Ddot < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A double-dot accent over an expression."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mover"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :attributes
 
         def initialize(parameter_one = nil, attributes = {})

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Deg < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The degree of a polynomial."
+        REFERENCE = "https://en.wikipedia.org/wiki/Degree_of_a_polynomial"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Det < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The determinant of a matrix."
+        REFERENCE = "https://en.wikipedia.org/wiki/Determinant"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Dim < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The dimension of a vector space."
+        REFERENCE = "https://en.wikipedia.org/wiki/Dimension_(vector_space)"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Dot < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A single-dot accent over an expression."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mover"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :attributes
 
         def initialize(parameter_one = nil, attributes = {})

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Exp < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The exponential function."
+        REFERENCE = "https://en.wikipedia.org/wiki/Exponential_function"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Fenced < TernaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Content enclosed by a pair of delimiters (fences), such as parentheses or brackets."
+        REFERENCE = "https://en.wikipedia.org/wiki/Bracket_(mathematics)"
+        EXAMPLE = -> { new(Math::Symbols::Paren::Lround.new, [sym("x")], Math::Symbols::Paren::Rround.new) }
+        # --- end catalog documentation ---
+
         include Mathml::FormulaTransformation
 
         attr_accessor :options

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Floor < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The floor of a value, rounded down to an integer."
+        REFERENCE = "https://en.wikipedia.org/wiki/Floor_and_ceiling_functions"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :open_paren, :close_paren
 
         def to_latex(options:)

data/lib/plurimath/math/function/font_style/bold-fraktur.rb

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class BoldFraktur < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold Fraktur (blackletter) font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def to_omml_without_math_tag(display_style, options:)
             font_styles(display_style, sty: "b", scr: "fraktur",
                                        options: options)

data/lib/plurimath/math/function/font_style/bold-italic.rb

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class BoldItalic < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold italic font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def to_omml_without_math_tag(display_style, options:)
             font_styles(display_style, sty: "bi", options: options)
           end

data/lib/plurimath/math/function/font_style/bold-sans-serif.rb

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class BoldSansSerif < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold sans-serif font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def to_omml_without_math_tag(display_style, options:)
             font_styles(display_style, sty: "b", scr: "sans-serif",
                                        options: options)

data/lib/plurimath/math/function/font_style/bold-script.rb

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class BoldScript < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold script (calligraphic) font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def to_omml_without_math_tag(display_style, options:)
             font_styles(display_style, sty: "b", scr: "script",
                                        options: options)

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class Bold < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def initialize(parameter_one,
                          parameter_two = "bold")
             super

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class DoubleStruck < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a double-struck (blackboard bold) font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def initialize(parameter_one,
                          parameter_two = "double-struck")
             super

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class Fraktur < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a Fraktur (blackletter) font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def initialize(parameter_one,
                          parameter_two = "fraktur")
             super

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class Italic < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in an italic font."
+          REFERENCE = "https://en.wikipedia.org/wiki/Mathematical_Alphanumeric_Symbols"
+          EXAMPLE = -> { new(sym("x")) }
+          # --- end catalog documentation ---
+
           def initialize(parameter_one,
                          parameter_two = "italic")
             super