plurimath 0.11.11 → 0.11.13

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

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

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

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

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class SansSerifBoldItalic < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in a bold italic 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: "bi", scr: "sans-serif",
                                        options: options)

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

@@ -5,6 +5,12 @@ module Plurimath
     module Function
       class FontStyle
         class SansSerifItalic < FontStyle
+          # --- Catalog documentation (see Plurimath::Documentation) ---
+          DESCRIPTION = "Renders its argument in an italic 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: "i", scr: "sans-serif",
                                        options: options)

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

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

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

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

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

@@ -20,6 +20,10 @@ module Plurimath
         autoload :SansSerifItalic, "#{__dir__}/font_style/sans-serif-italic"
         autoload :Script, "#{__dir__}/font_style/script"
 
+        # Font styles wrap a single visible argument, so the catalog lists them
+        # as unary (overriding BinaryFunction's :binary) to match the site.
+        CATALOG_TYPE = :unary
+
         def to_asciimath(options:)
           parameter_one&.to_asciimath(options: options)
         end

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Frac < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A fraction with a numerator over a denominator."
+        REFERENCE = "https://en.wikipedia.org/wiki/Fraction"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         attr_accessor :options
 
         FUNCTION = {

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

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

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

@@ -4,6 +4,18 @@ module Plurimath
   module Math
     module Function
       class Glb < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The greatest lower bound (infimum) operator."
+        REFERENCE = "https://en.wikipedia.org/wiki/Infimum_and_supremum"
+        EXAMPLE = -> { new(sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          latexmath: {
+            status: :limited,
+            notes: ["The operator name is emitted as plain math letters, not an operator command."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Hom < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The collection of morphisms from one object to another."
+        REFERENCE = "https://en.wikipedia.org/wiki/Morphism"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_omml_without_math_tag(display_style, options:)
           array = []
           array << r_element("hom", rpr_tag: false) unless hide_function_name

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Inf < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The infimum operator, carrying a subscript and superscript."
+        REFERENCE = "https://en.wikipedia.org/wiki/Infimum_and_supremum"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           first_value = "_(#{parameter_one.to_asciimath(options: options)})" if parameter_one
           second_value = "^(#{parameter_two.to_asciimath(options: options)})" if parameter_two

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

@@ -4,7 +4,11 @@ module Plurimath
   module Math
     module Function
       class Int < TernaryFunction
-        attr_accessor :options
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An integral of an expression, with optional lower and upper limits."
+        REFERENCE = "https://en.wikipedia.org/wiki/Integral"
+        EXAMPLE = -> { new(sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
 
         FUNCTION = {
           name: "integral",
@@ -13,6 +17,8 @@ module Plurimath
           third_value: "integrand",
         }.freeze
 
+        attr_accessor :options
+
         def initialize(parameter_one = nil,
                        parameter_two = nil,
                        parameter_three = nil,

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

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Intent < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An expression carrying an `intent` annotation for MathML accessibility semantics."
+        REFERENCE = "https://www.w3.org/TR/mathml4/#mixing_intent"
+        EXAMPLE = -> { new(expr(sym("x")), Text.new("variable")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["The intent string is emitted as a visible function argument instead of metadata."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["The intent string is emitted as a visible function argument instead of metadata."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["The MathML intent annotation is omitted; only the expression is emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_mathml_without_math_tag(intent, options:)
           first_value = parameter_one.to_mathml_without_math_tag(intent,
                                                                  options: options)
@@ -11,6 +31,21 @@ module Plurimath
           first_value
         end
 
+        # The intent string is metadata, not content: OMML has no slot for it,
+        # so only the wrapped content is written. The inherited BinaryFunction
+        # rendering wrapped both parameters in an <m:r>, nesting runs (invalid
+        # OMML) and printing the intent text as a visible run.
+        def to_omml_without_math_tag(display_style, options:)
+          return [] unless parameter_one
+
+          parameter_one.insert_t_tag(display_style, options: options)
+        end
+
+        # Same leak as OMML: the inherited rendering printed the intent text.
+        def to_html(options:)
+          "<i>#{parameter_one.to_html(options: options)}</i>" if parameter_one
+        end
+
         def to_unicodemath(options:)
           first_value = "(#{parameter_two.to_unicodemath(options: options)}#{parameter_one.to_unicodemath(options: options)})" if parameter_one || parameter_two
           "ⓘ#{first_value}"

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Ker < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The kernel of a homomorphism or linear map."
+        REFERENCE = "https://en.wikipedia.org/wiki/Kernel_(algebra)"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_omml_without_math_tag(display_style, options:)
           array = []
           array << r_element("ker", rpr_tag: false) unless hide_function_name

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

@@ -4,6 +4,18 @@ module Plurimath
   module Math
     module Function
       class Lcm < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The least common multiple operator."
+        REFERENCE = "https://en.wikipedia.org/wiki/Least_common_multiple"
+        EXAMPLE = -> { new(sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          latexmath: {
+            status: :limited,
+            notes: ["The operator name is emitted as plain math letters, not an operator command."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def validate_function_formula
           false
         end

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

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

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Lim < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The limit operator, carrying a subscript and superscript."
+        REFERENCE = "https://en.wikipedia.org/wiki/Limit_(mathematics)"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "limit",
           first_value: "limit subscript",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Liminf < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The limit inferior of a sequence."
+        REFERENCE = "https://en.wikipedia.org/wiki/Limit_inferior_and_limit_superior"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_omml_without_math_tag(display_style, options:)
           array = []
           array << r_element("liminf", rpr_tag: false) unless hide_function_name

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Limits < TernaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Lower and upper bounds forced below and above an operator, as with LaTeX's \\limits."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/munderover"
+        EXAMPLE = -> { new(Int.new, sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "function apply",
           first_value: "base",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Limsup < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The limit superior of a sequence."
+        REFERENCE = "https://en.wikipedia.org/wiki/Limit_inferior_and_limit_superior"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_omml_without_math_tag(display_style, options:)
           array = []
           array << r_element("limsup", rpr_tag: false) unless hide_function_name

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

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

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Log < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The logarithm operator, carrying a subscript and superscript."
+        REFERENCE = "https://en.wikipedia.org/wiki/Logarithm"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "function apply",
           first_value: "subscript",

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Longdiv < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Sets its argument under a long-division bracket."
+        REFERENCE = "https://en.wikipedia.org/wiki/Long_division"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           asciimath_value(options: options)
         end

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

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

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

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

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Mbox < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Typesets its argument in a single-line text box."
+        REFERENCE = "https://latexref.xyz/_005cmbox-_0026-_005cmakebox.html"
+        EXAMPLE = -> { new("x") }
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           Text.new(parameter_one).to_asciimath(options: options)
         end

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

@@ -4,6 +4,25 @@ module Plurimath
   module Math
     module Function
       class Menclose < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        # Menclose wraps a single visible expression, so the catalog lists it as
+        # unary (overriding BinaryFunction's :binary) to match the site.
+        CATALOG_TYPE = :unary
+        DESCRIPTION = "An expression wrapped in an enclosing notation, such as a box, circle, or strike."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/menclose"
+        EXAMPLE = -> { new("box", sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["The enclosure notation is omitted; only the enclosed expression is emitted."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["The enclosure notation is omitted; only the enclosed expression is emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "enclosure",
           first_value: "enclosure type",

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

@@ -4,6 +4,28 @@ module Plurimath
   module Math
     module Function
       class Merror < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        # MathML-only element: it has no AsciiMath/LaTeX form, so those render
+        # empty — accepted for the catalog (no page vanishes).
+        DESCRIPTION = "Displays its argument as a MathML error message."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/merror"
+        EXAMPLE = -> { new(sym("x")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :unavailable,
+            notes: ["No AsciiMath representation of the error expression is emitted."],
+          },
+          latexmath: {
+            status: :unavailable,
+            notes: ["No LaTeX representation of the error expression is emitted."],
+          },
+          omml: {
+            status: :unavailable,
+            notes: ["Only an empty OMML document is emitted; the error expression is omitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_asciimath(**); end
 
         def to_latex(**); end

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

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

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

@@ -4,6 +4,29 @@ module Plurimath
   module Math
     module Function
       class Mlabeledtr < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        # parameter_one is the row content, parameter_two the label (e.g. an
+        # equation number). Only MathML and UnicodeMath are overridden; the
+        # other formats fall back to the generic binary rendering.
+        DESCRIPTION = "A table row carrying a label, such as an equation number."
+        REFERENCE = "https://www.w3.org/TR/MathML3/chapter3.html#presm.mlabeledtr"
+        EXAMPLE = -> { new(sym("x"), Text.new("1")) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["A generic function expression is emitted instead of a labeled table row."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["A generic mlabeledtr macro is emitted instead of equation-label notation."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["The row content and label are flattened; labeled table-row structure is omitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_mathml_without_math_tag(intent, options:)
           table = ox_element("mtable")
           mlabeledtr = ox_element(class_name)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Mod < BinaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The modulo operation between two operands."
+        REFERENCE = "https://en.wikipedia.org/wiki/Modulo"
+        EXAMPLE = -> { new(sym("x"), sym("y")) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "mod",
           first_value: "base",

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

@@ -4,6 +4,26 @@ module Plurimath
   module Math
     module Function
       class Msgroup < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "Groups elementary-math rows so their positions shift together."
+        REFERENCE = "https://www.w3.org/TR/mathml4/#presm_msgroup"
+        EXAMPLE = -> { new([sym("x")]) }
+        CATALOG_FORMAT_LIMITATIONS = {
+          asciimath: {
+            status: :limited,
+            notes: ["Elementary-math grouping is omitted; only the group contents are emitted."],
+          },
+          latexmath: {
+            status: :limited,
+            notes: ["Elementary-math grouping is omitted; only the group contents are emitted."],
+          },
+          omml: {
+            status: :limited,
+            notes: ["Elementary-math grouping is omitted; only the group contents are emitted."],
+          },
+        }.freeze
+        # --- end catalog documentation ---
+
         def to_asciimath(options:)
           parameter_one.map do |param|
             param.to_asciimath(options: options)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Multiscript < TernaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "A base carrying prescripts set before it, optionally alongside postscripts after it."
+        REFERENCE = "https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mmultiscripts"
+        EXAMPLE = -> { new(PowerBase.new(sym("x"), sym("y"), sym("z")), [sym("a")], [sym("b")]) }
+        # --- end catalog documentation ---
+
         FUNCTION = {
           name: "multiscript",
           first_value: "base",

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

@@ -4,6 +4,17 @@ module Plurimath
   module Math
     module Function
       class Nary < Core
+        extend Documentation
+
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        # The page slug is "n-ary" rather than the derived "nary".
+        CATALOG_NAME = "n-ary"
+        CATALOG_TYPE = :binary
+        DESCRIPTION = "A large n-ary operator, such as an integral, sum, or product, carrying optional lower and upper limits and an operand."
+        REFERENCE = "https://www.unicode.org/notes/tn28/UTN28-PlainTextMath-v3.2.pdf"
+        EXAMPLE = -> { new(sym("v"), sym("x"), sym("y"), sym("z")) }
+        # --- end catalog documentation ---
+
         attr_accessor :parameter_one, :parameter_two, :parameter_three,
                       :parameter_four, :options
 

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Norm < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "The norm of its argument, written between double bars."
+        REFERENCE = "https://en.wikipedia.org/wiki/Norm_(mathematics)"
+        EXAMPLE = -> { new(sym("x")) }
+        # --- end catalog documentation ---
+
         attr_accessor :open_paren, :close_paren
 
         def to_asciimath(options:)

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

@@ -4,6 +4,12 @@ module Plurimath
   module Math
     module Function
       class Obrace < UnaryFunction
+        # --- Catalog documentation (see Plurimath::Documentation) ---
+        DESCRIPTION = "An overbrace spanning 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 = {})