metanorma-document 0.2.12 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d75a3afa9e8f16619cd88b2bf610d81ecd5b6e4d7bc9b507a26c347832d01536
-  data.tar.gz: 2739411b950f3871a28eec551346ee5ded7f643c9f76438574f68d1314fc398b
+  metadata.gz: 05125b6d3a480509e630600c04a152707d7af1cf32423a3906b99032fbb18fcd
+  data.tar.gz: 1c45b49ac852306fca98f05fc59cb0f790a5b814a6a3b8b56cfd6960b9cc726c
 SHA512:
-  metadata.gz: 29980c2343686ad9ec1ebb5c582f6483a280c1ff0d7edd5354597ccb5241db71269a01c955ec2c19e215ec2eeaa0675c93563eae33b446926dad6781ed15d2d2
-  data.tar.gz: d6e50bf824ba8f7ea1efabb168743dfd79e3e655547434f9328ba8cea817bce57012f85809940cfd2c9a995784204c846d2964375132978de4cdadebb68efde9
+  metadata.gz: 9ebfc36533344fd420cc2286357b77d4fe94213c8f31a0defdd7c4b06af6938e0258472bd279bd275f6a85f34a2c991a4fd12cd90d0b212e5ae9780506353600
+  data.tar.gz: 66b5e24551fd844cb8ad9368a10468509e0b3a7cc15836b5400d57024513da889c76f2571fc0d97cfdfacfacca7e72e6fe8d5d6f92c5bb54bc0a7d57d08d43ad

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-07-17 09:09:03 UTC using RuboCop version 1.86.1.
+# on 2026-07-18 16:00:24 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -11,67 +11,13 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'metanorma-document.gemspec'
 
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_argument, with_fixed_indentation
-Layout/ArgumentAlignment:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_element, with_fixed_indentation
-Layout/ArrayAlignment:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/span_element_bug01_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: either, start_of_block, start_of_line
-Layout/BlockAlignment:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: special_inside_parentheses, consistent, align_brackets
-Layout/FirstArrayElementIndentation:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/span_element_bug01_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
-# Offense count: 700
+# Offense count: 703
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: aligned, indented, indented_relative_to_receiver
-Layout/MultilineMethodCallIndentation:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
 # Offense count: 2
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -129,18 +75,18 @@ Lint/UnusedMethodArgument:
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 11
+# Offense count: 12
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 47
+  Max: 76
 
 # Offense count: 3
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 86
+# Offense count: 84
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
@@ -155,7 +101,7 @@ Metrics/MethodLength:
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 69
+# Offense count: 68
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
@@ -195,24 +141,11 @@ Naming/PredicatePrefix:
     - 'lib/metanorma/html/base_renderer.rb'
     - 'lib/metanorma/html/drops/biblio_entry_drop.rb'
 
-# Offense count: 1
-# Configuration parameters: MinSize.
-Performance/CollectionLiteralInLoop:
-  Exclude:
-    - 'lib/metanorma/html/standard_renderer.rb'
-
 # Offense count: 1
 Performance/MapMethodChain:
   Exclude:
     - 'spec/metanorma/flavor_roots/flavor_roots_spec.rb'
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowRegexpMatch.
-Performance/RedundantEqualityComparisonBlock:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/fmt_stem_element_bug03_spec.rb'
-
 # Offense count: 7
 RSpec/BeforeAfterAll:
   Exclude:
@@ -234,15 +167,6 @@ RSpec/ContextWording:
 RSpec/DescribeClass:
   Enabled: false
 
-# Offense count: 8
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: SkipBlocks, EnforcedStyle, OnlyStaticConstants.
-# SupportedStyles: described_class, explicit
-RSpec/DescribedClass:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-    - 'spec/metanorma/document/components/inline/xref_element_bug04_spec.rb'
-
 # Offense count: 234
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
@@ -254,10 +178,11 @@ RSpec/LeakyConstantDeclaration:
     - 'spec/metanorma/html/renderer/class_ownership_spec.rb'
     - 'spec/metanorma/html/renderer/liquid_templates_spec.rb'
 
-# Offense count: 4
+# Offense count: 5
 RSpec/MultipleDescribes:
   Exclude:
     - 'spec/metanorma/document_spec.rb'
+    - 'spec/metanorma/html/flavor_registry_spec.rb'
     - 'spec/metanorma/mirror/handlers/remaining_handlers_spec.rb'
     - 'spec/metanorma/mirror/serialization_spec.rb'
     - 'spec/metanorma/standard_document/sections_spec.rb'
@@ -274,7 +199,7 @@ RSpec/NamedSubject:
   Exclude:
     - 'spec/metanorma/flavor_roots/flavor_roots_spec.rb'
 
-# Offense count: 1061
+# Offense count: 1076
 # Configuration parameters: AllowedPatterns.
 # AllowedPatterns: ^expect_, ^assert_
 RSpec/NoExpectationExample:
@@ -286,17 +211,6 @@ RSpec/NoExpectationExample:
 RSpec/SpecFilePathFormat:
   Enabled: false
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
-# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
-# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
-# FunctionalMethods: let, let!, subject, watch
-# AllowedMethods: lambda, proc, it
-Style/BlockDelimiters:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
 # Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
 Style/ComparableClamp:
@@ -304,24 +218,3 @@ Style/ComparableClamp:
     - 'lib/metanorma/html/iso_renderer.rb'
     - 'lib/metanorma/html/renderers/section_renderer.rb'
     - 'lib/metanorma/html/standard_renderer.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/PredicateWithKind:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/fmt_stem_element_bug03_spec.rb'
-
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/SelectByKind:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInArguments:
-  Exclude:
-    - 'spec/metanorma/document/components/inline/semantic_content_bug05_spec.rb'
-    - 'spec/metanorma/document/components/inline/xref_element_bug04_spec.rb'

data/README.adoc

@@ -275,7 +275,7 @@ Metanorma::Mirror.build_default_registry
 
 === Metadata Service
 
-`Metanorma::Mirror::Metadata` is a standalone service that extracts document metadata (title, etc.) from a parsed bibdata object. It is consumed by both the forward pipeline (`Output::Pipeline::AttachMetadata`) and the forward transformer (`MetanormaToMirror#extract_root_title`), keeping title-extraction logic in one place rather than duplicated across the Handlers layer.
+`Metanorma::Mirror::Metadata` is a standalone service that extracts document metadata (title, etc.) from a parsed bibdata object. It is consumed by both the forward pipeline (`Output::Pipeline::AttachMetadata`) and the forward transformer (`Transformer#extract_root_title`), keeping title-extraction logic in one place rather than duplicated across the Handlers layer.
 
 [source,ruby]
 Metanorma::Mirror::Metadata.title_from_bibdata(doc.bibdata)

data/lib/metanorma/document/components/inline/semx_element.rb

@@ -6,14 +6,13 @@ module Metanorma
       module Inline
         # <semx> wraps a rendered-display slice of an inline element.
         #
-        # Known limitation (BUGS.sts 06, filed upstream against
-        # lutaml-model): when this element is parsed nested inside
-        # another mixed_content parent, the direct text content of
-        # <semx> may be captured by the parent's text attribute rather
-        # than by SemxElement#text. Standalone parsing works correctly.
-        # See TODO.bugs/06-nested-mixed-content-text-ownership.md and
-        # https://github.com/lutaml/lutaml-model bug
-        # "nested-mixed-content-text-ownership".
+        # History: BUGS.sts 06 reported that direct text content of
+        # <semx> was captured by the parent's text attribute rather
+        # than SemxElement#text when parsed nested. Verified
+        # non-reproducible at lutaml-model commit 38f90b7a (which
+        # added regression coverage for nested mixed_content text
+        # ownership in PR lutaml/lutaml-model#732). Likely resolved
+        # upstream between metanorma-document 0.2.9 and current HEAD.
         class SemxElement < Lutaml::Model::Serializable
           attribute :element_attr, :string
           attribute :source, :string

data/lib/metanorma/document/version.rb

@@ -2,7 +2,7 @@
 
 module Metanorma
   module Document
-    VERSION = "0.2.12"
+    VERSION = "0.3.0"
     Version = VERSION
   end
 end

data/lib/metanorma/html/base_renderer.rb

@@ -11,6 +11,8 @@ module Metanorma
       autoload :BlockRenderer, "metanorma/html/renderers/block_renderer"
       autoload :SectionRenderer, "metanorma/html/renderers/section_renderer"
       autoload :PubidRenderer, "metanorma/html/renderers/pubid_renderer"
+      autoload :ElementOrderTraversal,
+               "metanorma/html/renderers/element_order_traversal"
     end
 
     class BaseRenderer
@@ -84,16 +86,13 @@ module Metanorma
       end
 
       class RendererContext
+        include RendererDelegation
+
         def initialize(renderer)
           @renderer = renderer
         end
 
-        def safe_attr(...)        = @renderer.safe_attr(...)
-        def escape_html(...)      = @renderer.escape_html(...)
-        def extract_block_label(...)= @renderer.extract_block_label(...)
-        def extract_plain_text(...)= @renderer.extract_plain_text(...)
         def render_paragraph(...) = @renderer.render_paragraph(...)
-        def render_mixed_inline(...)= @renderer.render_mixed_inline(...)
         def render_inline_element(...)= @renderer.render_inline_element(...)
         def render_unordered_list(...)= @renderer.render_unordered_list(...)
         def render_ordered_list(...)= @renderer.render_ordered_list(...)
@@ -107,7 +106,6 @@ module Metanorma
         def render_image(...)       = @renderer.render_image(...)
         def render_stem_content(...)= @renderer.render_stem_content(...)
         def register_figure_entry(...)= @renderer.register_figure_entry(...)
-        def render_liquid(...) = @renderer.render_liquid(...)
         def render_note_children(...) = @renderer.render_note_children(...)
         def render_simple_children(...) = @renderer.render_simple_children(...)
         def render_full_block_children(...) = @renderer.render_full_block_children(...)
@@ -134,22 +132,6 @@ module Metanorma
 
       # --- Flavor configuration hooks ---
 
-      FLAVOR_MAP = {
-        "IsoDocument" => :iso,
-        "IecDocument" => :iec,
-        "IeeeDocument" => :ieee,
-        "IetfDocument" => :ietf,
-        "ItuDocument" => :itu,
-        "IhoDocument" => :iho,
-        "BipmDocument" => :bipm,
-        "OgcDocument" => :ogc,
-        "OimlDocument" => :oiml,
-        "CcDocument" => :cc,
-        "IccDocument" => :icc,
-        "RiboseDocument" => :ribose,
-        "PdfaDocument" => :pdfa,
-      }.freeze
-
       def theme
         @theme ||= resolve_theme
       end
@@ -162,9 +144,15 @@ module Metanorma
       def flavor_name
         return nil unless defined?(@document) && @document
 
-        @document.class.name&.split("::")&.detect do |ns|
-          FLAVOR_MAP.key?(ns)
-        end&.then { |ns| FLAVOR_MAP[ns] }
+        Metanorma::Html::Generator.flavors.name_for(@document.class)
+      end
+
+      # Pubid module for the current document's flavor, or nil if the
+      # flavor has no Pubid support. Queries the shared FlavorRegistry.
+      def pubid_module
+        return nil unless defined?(@document) && @document
+
+        Metanorma::Html::Generator.flavors.pubid_module_for(@document.class)
       end
 
       def flavor_publishers(_doc_id)
@@ -460,12 +448,8 @@ module Metanorma
         xml_mapping = node.class.mappings_for(:xml, node.lutaml_register)
 
         if node.element_order.is_a?(Array) && xml_mapping
-          element_to_attr = {}
-          xml_mapping.mapping_elements_hash.each_value do |rule_or_array|
-            Array(rule_or_array).each do |rule|
-              element_to_attr[rule.name.to_s] = rule.to
-            end
-          end
+          element_to_attr =
+            Renderers::ElementOrderTraversal.element_to_attr_map(xml_mapping)
 
           indices = Hash.new(0)
           node.element_order.each do |el|
@@ -624,50 +608,40 @@ module Metanorma
                              :render_index
       register_inline_render Metanorma::Document::Components::Blocks::NoteBlock,
                              :render_note_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtNameElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtTitleElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtXrefLabelElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtFnLabelElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtConceptElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtAnnotationStartElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtAnnotationEndElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtAnnotationBodyElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::VariantTitleElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::LocalizedStringElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::TitleWithAnnotationElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::BiblioTagElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::NameWithIdElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::DisplayTextElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtFootnoteContainerElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtFnBodyElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtPreferredElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtDefinitionElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtTermsourceElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtAdmittedElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtIdentifierElement,
-                             :render_mixed_inline
-      register_inline_render Metanorma::Document::Components::Inline::FmtSourcecodeElement,
-                             :render_mixed_inline
+
+      # Transparent inline wrappers: element classes whose render
+      # semantics are "iterate mixed_content and render each child".
+      # Grouped here so adding a new transparent wrapper is one entry,
+      # not another register_inline_render line. Classes with a more
+      # specific handler register themselves above.
+      TRANSPARENT_INLINE_WRAPPERS = [
+        Metanorma::Document::Components::Inline::FmtNameElement,
+        Metanorma::Document::Components::Inline::FmtTitleElement,
+        Metanorma::Document::Components::Inline::FmtXrefLabelElement,
+        Metanorma::Document::Components::Inline::FmtFnLabelElement,
+        Metanorma::Document::Components::Inline::FmtConceptElement,
+        Metanorma::Document::Components::Inline::FmtAnnotationStartElement,
+        Metanorma::Document::Components::Inline::FmtAnnotationEndElement,
+        Metanorma::Document::Components::Inline::FmtAnnotationBodyElement,
+        Metanorma::Document::Components::Inline::VariantTitleElement,
+        Metanorma::Document::Components::Inline::LocalizedStringElement,
+        Metanorma::Document::Components::Inline::TitleWithAnnotationElement,
+        Metanorma::Document::Components::Inline::BiblioTagElement,
+        Metanorma::Document::Components::Inline::NameWithIdElement,
+        Metanorma::Document::Components::Inline::DisplayTextElement,
+        Metanorma::Document::Components::Inline::FmtFootnoteContainerElement,
+        Metanorma::Document::Components::Inline::FmtFnBodyElement,
+        Metanorma::Document::Components::Inline::FmtPreferredElement,
+        Metanorma::Document::Components::Inline::FmtDefinitionElement,
+        Metanorma::Document::Components::Inline::FmtTermsourceElement,
+        Metanorma::Document::Components::Inline::FmtAdmittedElement,
+        Metanorma::Document::Components::Inline::FmtIdentifierElement,
+        Metanorma::Document::Components::Inline::FmtSourcecodeElement,
+      ].freeze
+
+      TRANSPARENT_INLINE_WRAPPERS.each do |klass|
+        register_inline_render klass, :render_mixed_inline
+      end
 
       def lookup_dispatch(type_class, registry_method)
         self.class.ancestors.each do |ancestor|

data/lib/metanorma/html/component/base.rb

@@ -4,6 +4,8 @@ module Metanorma
   module Html
     module Component
       class Base
+        include Metanorma::Html::RendererDelegation
+
         attr_reader :renderer
 
         def initialize(renderer)
@@ -38,18 +40,9 @@ module Metanorma
           raise NotImplementedError, "#{self.class}#render not implemented"
         end
 
-        def escape_html(...) = renderer.escape_html(...)
-        def render_mixed_inline(...) = renderer.render_mixed_inline(...)
         def render_mixed_content_in_order(...) = renderer.render_mixed_content_in_order(...)
         def element_attrs(...) = renderer.element_attrs(...)
-        def safe_attr(obj, method_name) = renderer.safe_attr(obj, method_name)
-        def extract_plain_text(node) = renderer.extract_plain_text(node)
         def extract_text_value(val) = renderer.extract_text_value(val)
-        def render_liquid(...) = renderer.render_liquid(...)
-
-        def extract_block_label(block, default)
-          renderer.extract_block_label(block, default)
-        end
 
         def self.register_in(registry)
           handled_classes.each do |klass|

data/lib/metanorma/html/flavor.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Html
+    # A flavor ties together the four concepts that identify a Metanorma
+    # document variant:
+    # - a symbolic name (used for theme loading, CSS class names)
+    # - a model class (the typed root class for the flavor)
+    # - a renderer class (the HTML renderer that handles the flavor)
+    # - an optional Pubid module (for parsing identifiers like ISO/IEC/etc.)
+    #
+    # Flavor centralizes flavor identity so BaseRenderer, PubidRenderer,
+    # and Generator all read from the same source of truth. Adding a new
+    # flavor is one Flavor entry in the registry, not three coordinated
+    # edits across three files.
+    class Flavor
+      attr_reader :name, :model_class, :renderer_class, :pubid_module
+
+      def initialize(name:, model_class:, renderer_class:, pubid_module: nil)
+        @name = name
+        @model_class = model_class
+        @renderer_class = renderer_class
+        @pubid_module = pubid_module
+      end
+
+      # Match by ancestry: a document whose class is the flavor's model
+      # class, or any descendant of it, belongs to this flavor. Walks
+      # parent classes via is_a? to support subclassing.
+      def matches?(document_class)
+        return false unless document_class.is_a?(Class)
+
+        # `<=` returns nil for unrelated classes; coerce to boolean.
+        !!(document_class <= model_class)
+      end
+
+      def pubid_module_const
+        return nil unless pubid_module
+
+        Object.const_get(pubid_module.to_s)
+      rescue NameError
+        nil
+      end
+    end
+  end
+end

data/lib/metanorma/html/flavor_registry.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Html
+    # Registry of known flavors. Queried by:
+    # - Generator — to pick the renderer for a document
+    # - BaseRenderer — to resolve flavor_name for theme loading
+    # - PubidRenderer — to resolve the Pubid module
+    #
+    # Single source of truth for flavor identity. Adding a flavor is
+    # one Flavor entry via #register.
+    class FlavorRegistry
+      include Enumerable
+
+      def initialize
+        @flavors = []
+      end
+
+      def register(flavor)
+        @flavors << flavor
+        self
+      end
+
+      def each(&)
+        @flavors.each(&)
+      end
+
+      # Returns the most-specific Flavor whose model_class matches the
+      # given document class (by ancestry). Most-specific = registered
+      # last. We scan in reverse so general flavors (registered first)
+      # only match if no more specific flavor does.
+      def find_for(document_class)
+        @flavors.reverse_each.find { |f| f.matches?(document_class) }
+      end
+
+      def name_for(document_class)
+        find_for(document_class)&.name
+      end
+
+      def renderer_for(document_class)
+        find_for(document_class)&.renderer_class
+      end
+
+      def pubid_module_for(document_class)
+        find_for(document_class)&.pubid_module_const
+      end
+    end
+  end
+end