plurimath 0.11.11 → 0.11.13

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

@@ -4,7 +4,11 @@ module Plurimath
   module Math
     module Function
       class Oint < TernaryFunction
-        attr_accessor :options
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The contour integral of a function along a closed path."
+        REFERENCE = "https://en.wikipedia.org/wiki/Contour_integration"
+        EXAMPLE = -> { new(sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
 
         FUNCTION = {
           name: "contour integral",
@@ -12,6 +16,8 @@ module Plurimath
           second_value: "supscript",
         }.freeze
 
+        attr_accessor :options
+
         def initialize(parameter_one = nil,
                        parameter_two = nil,
                        parameter_three = nil,

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Over < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A fraction formed with the LaTeX \\over primitive."
+        REFERENCE = "https://en.wikipedia.org/wiki/Fraction"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "over",
           first_value: "numerator",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Overleftrightarrow < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A left-right arrow 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/overset.rb

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Overset < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An expression set as an overscript above a base."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mover"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         attr_accessor :options
 
         FUNCTION = {

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Phantom < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Reserves the space of its argument without rendering it."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mphantom"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           Array.new(asciimath_value(options: options)&.length, '\ ').join.to_s
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Power < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A base raised to an exponent."
+        REFERENCE = "https://en.wikipedia.org/wiki/Exponentiation"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "superscript",
           first_value: "base",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class PowerBase < TernaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A base bearing both a subscript and a superscript."
+        REFERENCE = "https://en.wikipedia.org/wiki/Subscript_and_superscript"
+        EXAMPLE = -> { new(sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "subsup",
           first_value: "base",

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

@@ -4,7 +4,11 @@ module Plurimath
   module Math
     module Function
       class Prod < TernaryFunction
-        attr_accessor :options
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The product of a sequence of terms over an index range."
+        REFERENCE = "https://en.wikipedia.org/wiki/Product_(mathematics)"
+        EXAMPLE = -> { new(sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
 
         FUNCTION = {
           name: "prod",
@@ -12,6 +16,8 @@ module Plurimath
           second_value: "supscript",
         }.freeze
 
+        attr_accessor :options
+
         def evaluate(evaluator)
           if parameter_one.nil? || parameter_two.nil? || parameter_three.nil?
             evaluator.unsupported(self)

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

@@ -23,7 +23,7 @@ module Plurimath
           [mr]
         end
 
-        def to_html
+        def to_html(**)
           "<i>#{parameter_one}</i>"
         end
 

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Root < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A root of a radicand with an explicit index (degree)."
+        REFERENCE = "https://en.wikipedia.org/wiki/Nth_root"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "root",
           first_value: "radicand",

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

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Rule < TernaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A typographic rule — a filled rectangle used for spacing or lines, as in LaTeX's rule."
+        REFERENCE = "https://latexref.xyz/_005crule.html"
+        EXAMPLE = -> { new(sym("5pt"), sym("5pt"), sym("5pt")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :unavailable,
+            notes: ["No AsciiMath representation is emitted."],
+          },
+          mathml: {
+            status: :unavailable,
+            notes: ["Only an empty MathML placeholder is emitted; the rule geometry is omitted."],
+          },
+          omml: {
+            status: :unavailable,
+            notes: ["Only an empty OMML placeholder is emitted; the rule geometry is omitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "rule",
           first_value: "first argument",

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

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Scarries < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Marks carries or borrows over a row in elementary arithmetic layout."
+        REFERENCE = "https://www.w3.org/TR/mathml4/#presm_mscarries"
+        EXAMPLE = -> { new(sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["Carry positioning is omitted; only the carried expression is emitted."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["Carry positioning is omitted; only the carried expression is emitted."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["Carry positioning is omitted; only the carried expression is emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           asciimath_value(options: options)
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sec < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The secant 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/sech.rb

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sech < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic secant 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/semantics.rb

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Semantics < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A presentation expression paired with its semantic annotations."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/semantics"
+        EXAMPLE = -> { new(sym("x"), [{ "annotation-xml": [sym("x")] }]) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["Semantic annotations are omitted; only the presentation expression is emitted."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["Semantic annotations are omitted; only the presentation expression is emitted."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["Semantic annotations are omitted; only the presentation expression is emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "semantics",
           first_value: "first argument",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sin < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The sine 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/sinh.rb

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sinh < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic sine 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/sqrt.rb

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sqrt < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The square root of a radicand."
+        REFERENCE = "https://en.wikipedia.org/wiki/Square_root"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :options
 
         def to_mathml_without_math_tag(intent, options:)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Stackrel < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An expression stacked above another, typically over a relation."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mover"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "stackrel",
           first_value: "above",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Substack < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Stacks multiple lines within a subscript or superscript, as under a summation."
+        REFERENCE = "https://en.wikibooks.org/wiki/LaTeX/Advanced_Mathematics"
+        EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "substack",
           first_value: "above",

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

@@ -4,7 +4,11 @@ module Plurimath
   module Math
     module Function
       class Sum < TernaryFunction
-        attr_accessor :options
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The summation of a sequence of terms over an index range."
+        REFERENCE = "https://en.wikipedia.org/wiki/Summation"
+        EXAMPLE = -> { new(sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
 
         FUNCTION = {
           name: "summation",
@@ -13,6 +17,8 @@ module Plurimath
           third_value: "term",
         }.freeze
 
+        attr_accessor :options
+
         def evaluate(evaluator)
           if parameter_one.nil? || parameter_two.nil? || parameter_three.nil?
             evaluator.unsupported(self)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Sup < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The supremum (least upper bound) of a set."
+        REFERENCE = "https://en.wikipedia.org/wiki/Infimum_and_supremum"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_mathml_without_math_tag(intent, options:)
           mo_tag = ox_element("mo") << "sup"
           first_value = mathml_value(intent, options: options)

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Align < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Aligns a sequence of equations at designated alignment points, one equation per row."
+          REFERENCE = "https://en.wikibooks.org/wiki/LaTeX/Advanced_Mathematics"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "[",
                          close_paren = "]",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Array < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Lays out entries in a matrix-like grid with per-column alignment."
+          REFERENCE = "https://en.wikibooks.org/wiki/LaTeX/Mathematics"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")], { columnalign: "center" })])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value = [],
                          open_paren = "[",
                          close_paren = "]",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Bmatrix < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "A matrix enclosed in square brackets (curly braces in its capitalized Bmatrix form)."
+          REFERENCE = "https://en.wikipedia.org/wiki/Matrix_(mathematics)"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "[",
                          close_paren = "]",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Cases < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Selects among alternative expressions by condition, as in a piecewise definition."
+          REFERENCE = "https://en.wikipedia.org/wiki/Piecewise_function"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+          # --- end catalog documentation ---
+
           def initialize(value = [],
                          open_paren = "{",
                          close_paren = ":}",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Eqarray < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Aligns an array of equations across multiple columns."
+          REFERENCE = "https://www.unicode.org/notes/tn28/UTN28-PlainTextMath-v3.2.pdf"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value = [],
                          open_paren = "",
                          close_paren = "",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Matrix < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "A matrix of rows and columns without enclosing delimiters."
+          REFERENCE = "https://en.wikipedia.org/wiki/Matrix_(mathematics)"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value = [],
                          open_paren = "(",
                          close_paren = ")",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Multline < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Splits a single long equation across several lines."
+          REFERENCE = "https://en.wikibooks.org/wiki/LaTeX/Advanced_Mathematics"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "[",
                          close_paren = "]",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Pmatrix < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "A matrix enclosed in parentheses."
+          REFERENCE = "https://en.wikipedia.org/wiki/Matrix_(mathematics)"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "(",
                          close_paren = ")",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Split < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Splits a single equation across aligned lines within another display."
+          REFERENCE = "https://en.wikibooks.org/wiki/LaTeX/Advanced_Mathematics"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])], nil, nil) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "[",
                          close_paren = "]",

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class Table
         class Vmatrix < Table
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "A matrix enclosed in single vertical bars, denoting a determinant; its capitalized Vmatrix form uses double bars for a norm."
+          REFERENCE = "https://en.wikipedia.org/wiki/Determinant"
+          EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+          # --- end catalog documentation ---
+
           def initialize(value,
                          open_paren = "|",
                          close_paren = "|",

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

@@ -4,6 +4,8 @@ module Plurimath
   module Math
     module Function
       class Table < Core
+        extend Documentation
+
         autoload :Align, "#{__dir__}/table/align"
         autoload :Array, "#{__dir__}/table/array"
         autoload :Bmatrix, "#{__dir__}/table/bmatrix"
@@ -15,6 +17,14 @@ module Plurimath
         autoload :Split, "#{__dir__}/table/split"
         autoload :Vmatrix, "#{__dir__}/table/vmatrix"
 
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        # Declared once on the base and inherited by every matrix subclass.
+        CATALOG_TYPE = :unary
+        DESCRIPTION = "Arranges rows and cells into a two-dimensional table or matrix."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mtable"
+        EXAMPLE = -> { new([Tr.new([Td.new([sym("x")])])]) }
+        # --- end catalog documentation ---
+
         attr_accessor :value, :open_paren, :close_paren, :options
 
         SIMPLE_TABLES = %w[array align split].freeze

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Tan < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The tangent 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/tanh.rb

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Tanh < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The hyperbolic tangent 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/ternary_function.rb

@@ -4,6 +4,10 @@ module Plurimath
   module Math
     module Function
       class TernaryFunction < Core
+        extend Documentation
+
+        CATALOG_TYPE = :ternary
+
         attr_accessor :parameter_one, :parameter_two, :parameter_three,
                       :hide_function_name
 

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Text < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Typesets its argument as literal text."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mtext"
+        EXAMPLE = -> { new("x") }
+        # --- end catalog documentation ---
+
         PARSER_REGEX = %r{unicode\[:(?<unicode>\w{1,})\]}
 
         def initialize(parameter_one = "", lang: nil)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Tilde < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A tilde 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/ubrace.rb

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

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

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

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

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