metanorma-document 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2f0bcb971c3831683b2786c9596f336f6c80597b8747ed05fb7f195eb6dc492
-  data.tar.gz: bf6154b258dda4bc3e5c6eb8073001d214ee6268f2b5747bb9f73683950f6fa7
+  metadata.gz: '08953283a82f46382002daac11ebb5befc241c798702b21d189db6943ba91f46'
+  data.tar.gz: 56e998c5b5b02599f863c29136491711f0dcb2b78da77c5c81bdc62967619e70
 SHA512:
-  metadata.gz: 74d4cf3024d3096c93df42af04695cbf01581e82ef3e4ac5771900e1fc729bba43f53a5070f748d640755c69a4c54df4cc242558407e26ccad67be91ceac4faa
-  data.tar.gz: 821daad319b1f3a38457082d3719af6cc23c7f7843bae9eb50841784b9c4a4f8466b9b75ef61aaf3c0079f2081b91194292a3a574cf15b5e2f12f73a01d1f902
+  metadata.gz: acdce24a10e9919a5dd2396ed6c51a30387686671f3ec8e17125bfea76adaba020709007ff36cbbc9697e0a5c95e02155a4c8993f95406e895a2958d2d7b7bd6
+  data.tar.gz: 3d59fb7d487a8ac32042f4827054c1f2bd301359073bf27840a215f8eae267b91130232124041cec706662e189503b0206c8449cccf57dc562ff2cc6d1104598

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-06 10:09:39 UTC using RuboCop version 1.86.1.
+# on 2026-05-06 16:15:52 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,13 +11,14 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'metanorma-document.gemspec'
 
-# Offense count: 1
+# Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, IndentationWidth.
 # SupportedStyles: with_first_argument, with_fixed_indentation
 Layout/ArgumentAlignment:
   Exclude:
     - 'lib/metanorma/html/component/index_term_collector.rb'
+    - 'spec/metanorma/html/renderer/architecture_spec.rb'
 
 # Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
@@ -54,7 +55,7 @@ Layout/ExtraSpacing:
     - 'lib/metanorma/html/iho_renderer.rb'
     - 'lib/metanorma/html/theme.rb'
 
-# Offense count: 809
+# Offense count: 801
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
@@ -92,12 +93,14 @@ Lint/EmptyBlock:
     - 'lib/metanorma/html/drops/formula_drop.rb'
     - 'spec/metanorma/iso_document/metadata/title_roundtrip_spec.rb'
 
-# Offense count: 2
+# Offense count: 4
 # Configuration parameters: AllowedParentClasses.
 Lint/MissingSuper:
   Exclude:
     - 'lib/metanorma/html/drops/block_element_drop.rb'
+    - 'lib/metanorma/html/drops/figure_list_entry_drop.rb'
     - 'lib/metanorma/html/drops/footnote_drop.rb'
+    - 'lib/metanorma/html/drops/toc_entry_drop.rb'
 
 # Offense count: 1
 Lint/StructNewOverride:
@@ -118,7 +121,7 @@ Lint/UselessConstantScoping:
   Exclude:
     - 'lib/metanorma/html/base_renderer.rb'
 
-# Offense count: 80
+# Offense count: 78
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
@@ -134,7 +137,7 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 60
+# Offense count: 58
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
@@ -153,7 +156,7 @@ Metrics/CyclomaticComplexity:
     - 'lib/metanorma/html/theme.rb'
     - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
 
-# Offense count: 85
+# Offense count: 84
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 75
@@ -163,7 +166,7 @@ Metrics/MethodLength:
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 54
+# Offense count: 53
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
@@ -182,15 +185,16 @@ Metrics/PerceivedComplexity:
     - 'lib/metanorma/html/theme.rb'
     - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
 
-# Offense count: 2
+# Offense count: 4
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, BlockForwardingName.
 # SupportedStyles: anonymous, explicit
 Naming/BlockForwarding:
   Exclude:
+    - 'lib/metanorma/html/base_renderer.rb'
     - 'lib/metanorma/html/component/footnote_collector.rb'
 
-# Offense count: 39
+# Offense count: 28
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
@@ -219,11 +223,12 @@ Naming/PredicatePrefix:
   Exclude:
     - 'lib/metanorma/html/standard_renderer.rb'
 
-# Offense count: 14
+# Offense count: 15
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Exclude:
     - 'spec/metanorma/document_spec.rb'
+    - 'spec/metanorma/html/renderer/architecture_spec.rb'
     - 'spec/metanorma/html/renderer/class_ownership_spec.rb'
     - 'spec/metanorma/html/renderer/dead_code_removal_spec.rb'
     - 'spec/metanorma/html/renderer/section_rendering_spec.rb'
@@ -253,7 +258,12 @@ RSpec/MultipleDescribes:
   Exclude:
     - 'spec/metanorma/document_spec.rb'
 
-# Offense count: 303
+# Offense count: 1
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 7
+
+# Offense count: 322
 # Configuration parameters: AllowedPatterns.
 # AllowedPatterns: ^expect_, ^assert_
 RSpec/NoExpectationExample:
@@ -265,7 +275,7 @@ RSpec/NoExpectationExample:
 RSpec/SpecFilePathFormat:
   Enabled: false
 
-# Offense count: 2
+# Offense count: 4
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowOnlyRestArgument, UseAnonymousForwarding, RedundantRestArgumentNames, RedundantKeywordRestArgumentNames, RedundantBlockArgumentNames.
 # RedundantRestArgumentNames: args, arguments
@@ -273,6 +283,7 @@ RSpec/SpecFilePathFormat:
 # RedundantBlockArgumentNames: blk, block, proc
 Style/ArgumentsForwarding:
   Exclude:
+    - 'lib/metanorma/html/base_renderer.rb'
     - 'lib/metanorma/html/component/footnote_collector.rb'
 
 # Offense count: 1

data/lib/metanorma/document/version.rb

@@ -2,7 +2,7 @@
 
 module Metanorma
   module Document
-    VERSION = "0.2.3"
+    VERSION = "0.2.5"
     Version = VERSION
   end
 end

data/lib/metanorma/html/base_renderer.rb

@@ -83,33 +83,37 @@ module Metanorma
       # --- Public API ---
 
       # Facade object for Drops to call renderer methods without exposing
-      # the full private interface. Delegates to the renderer internally.
+      # the full private interface. Delegates via method_missing with an
+      # explicit allowlist — adding new delegations only requires updating
+      # DELEGATED_METHODS, not writing a new one-liner.
       class RendererContext
+        DELEGATED_METHODS = %i[
+          safe_attr escape_html extract_block_label extract_plain_text
+          capture_output render_paragraph render_mixed_inline
+          render_inline_element render_unordered_list render_ordered_list
+          render_definition_list render_sourcecode render_table
+          render_figure render_quote render_formula render_note
+          render_image render_stem_content register_figure_entry
+          render_liquid
+        ].freeze
+
         def initialize(renderer)
           @renderer = renderer
         end
 
-        def safe_attr(obj, method_name) = @renderer.send(:safe_attr, obj, method_name)
-        def escape_html(text) = @renderer.send(:escape_html, text)
-        def extract_block_label(block, default) = @renderer.send(:extract_block_label, block, default)
-        def extract_plain_text(node) = @renderer.send(:extract_plain_text, node)
-        def capture_output(&) = @renderer.send(:capture_output, &)
-        def render_paragraph(p) = @renderer.send(:render_paragraph, p)
-        def render_mixed_inline(node) = @renderer.send(:render_mixed_inline, node)
-        def render_inline_element(el) = @renderer.send(:render_inline_element, el)
-        def render_unordered_list(ul) = @renderer.send(:render_unordered_list, ul)
-        def render_ordered_list(ol) = @renderer.send(:render_ordered_list, ol)
-        def render_definition_list(dl) = @renderer.send(:render_definition_list, dl)
-        def render_sourcecode(sc) = @renderer.send(:render_sourcecode, sc)
-        def render_table(t) = @renderer.send(:render_table, t)
-        def render_figure(f) = @renderer.send(:render_figure, f)
-        def render_quote(q) = @renderer.send(:render_quote, q)
-        def render_formula(f) = @renderer.send(:render_formula, f)
-        def render_note(n) = @renderer.send(:render_note, n)
-        def render_image(img) = @renderer.send(:render_image, img)
-        def render_stem_content(stem) = @renderer.send(:render_stem_content, stem)
-        def register_figure_entry(...) = @renderer.send(:register_figure_entry, ...)
-        def render_liquid(template_name, assigns) = @renderer.send(:render_liquid, template_name, assigns)
+        def respond_to_missing?(method_name, include_private = false)
+          DELEGATED_METHODS.include?(method_name) || super
+        end
+
+        private
+
+        def method_missing(method_name, *args, **kwargs, &block)
+          if DELEGATED_METHODS.include?(method_name)
+            @renderer.public_send(method_name, *args, **kwargs, &block)
+          else
+            super
+          end
+        end
       end
 
       def renderer_context
@@ -265,41 +269,17 @@ module Metanorma
       # --- ToC generation ---
 
       def build_toc_html(entries)
-        top_lines = []
-        main_lines = if entries.empty?
-                       ["<li class=\"toc-empty\">No entries</li>"]
-                     else
-                       entries.map do |e|
-                         id = e[:id].to_s
-                         text = escape_html(e[:text].to_s)
-                         lvl = e[:level]
-                         "<li class=\"toc-level-#{lvl}\"><a href=\"##{id}\" class=\"toc-link\" data-target=\"#{id}\">#{text}</a></li>"
-                       end
-                     end
-
-        # List of Figures — at top of sidebar
-        unless @figure_entries.empty?
-          top_lines << "<li class=\"toc-list-header\" data-list=\"figures\"><button class=\"toc-list-toggle\" aria-expanded=\"false\"><svg width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\"><rect x=\"1\" y=\"2\" width=\"14\" height=\"12\" rx=\"1\"/><circle cx=\"5\" cy=\"6.5\" r=\"1.5\"/><path d=\"M1 12l4-4 2 2 3-3 5 5\"/></svg> Figures <span class=\"toc-list-count\">(#{@figure_entries.size})</span></button></li>"
-          @figure_entries.each do |f|
-            id = f[:id].to_s
-            text = escape_html(f[:text].to_s)
-            top_lines << "<li class=\"toc-list-item toc-figures\" style=\"display:none\"><a href=\"##{id}\" class=\"toc-link\" data-target=\"#{id}\">#{text}</a></li>"
-          end
-        end
-
-        # List of Tables — at top of sidebar
-        unless @table_entries.empty?
-          top_lines << "<li class=\"toc-list-header\" data-list=\"tables\"><button class=\"toc-list-toggle\" aria-expanded=\"false\"><svg width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\"><rect x=\"1\" y=\"2\" width=\"14\" height=\"12\" rx=\"1\"/><line x1=\"1\" y1=\"6\" x2=\"15\" y2=\"6\"/><line x1=\"1\" y1=\"10\" x2=\"15\" y2=\"10\"/><line x1=\"7\" y1=\"2\" x2=\"7\" y2=\"14\"/></svg> Tables <span class=\"toc-list-count\">(#{@table_entries.size})</span></button></li>"
-          @table_entries.each do |t|
-            id = t[:id].to_s
-            text = escape_html(t[:text].to_s)
-            top_lines << "<li class=\"toc-list-item toc-tables\" style=\"display:none\"><a href=\"##{id}\" class=\"toc-link\" data-target=\"#{id}\">#{text}</a></li>"
-          end
-        end
-
-        top_lines << "<li class=\"toc-divider\"></li>" unless top_lines.empty?
-
-        (top_lines + main_lines).join("\n")
+        entry_drops = entries.map { |e| Drops::TocEntryDrop.new(e) }
+        figure_drops = @figure_entries.map { |f| Drops::FigureListEntryDrop.new(f) }
+        table_drops = @table_entries.map { |t| Drops::FigureListEntryDrop.new(t) }
+        has_special_lists = !@figure_entries.empty? || !@table_entries.empty?
+
+        render_liquid("_toc.html.liquid", {
+                        "entries" => entry_drops,
+                        "figures" => figure_drops,
+                        "tables" => table_drops,
+                        "has_special_lists" => has_special_lists,
+                      })
       end
 
       # --- Scripts ---
@@ -496,7 +476,7 @@ module Metanorma
         return escape_html(node) if node.is_a?(String)
 
         method = lookup_dispatch(node.class, :render_registry)
-        method ? send(method, node, **) : ""
+        method ? public_send(method, node, **) : ""
       end
 
       # Dispatch to the appropriate inline render method via type registry.
@@ -506,7 +486,7 @@ module Metanorma
 
         method = lookup_dispatch(element.class, :inline_registry)
         if method
-          send(method, element)
+          public_send(method, element)
         elsif element.is_a?(Lutaml::Model::Serializable) && element.mixed?
           render_mixed_inline(element)
         end
@@ -587,13 +567,11 @@ module Metanorma
       register_inline_render Metanorma::Document::Components::Inline::FmtIdentifierElement, :render_mixed_inline
       register_inline_render Metanorma::Document::Components::Inline::FmtSourcecodeElement, :render_mixed_inline
 
-      private
-
       def lookup_dispatch(type_class, registry_method)
         self.class.ancestors.each do |ancestor|
-          next unless ancestor.respond_to?(registry_method)
+          next unless ancestor.is_a?(Class) && (ancestor == BaseRenderer || ancestor < BaseRenderer)
 
-          registry = ancestor.send(registry_method)
+          registry = ancestor.public_send(registry_method)
           method_name = registry[type_class]
           return method_name if method_name
         end
@@ -982,7 +960,7 @@ module Metanorma
             # Apply optional filter (used by semx to skip semantic attrs)
             next if allow_filter && !allow_filter.include?(attr_name)
 
-            coll = node.send(attr_name)
+            coll = node.public_send(attr_name)
             obj = if coll.is_a?(Array)
                     idx = indices[attr_name]
                     indices[attr_name] += 1
@@ -1076,8 +1054,9 @@ module Metanorma
 
       def raw_content_node?(node)
         node.is_a?(Lutaml::Model::Serializable) &&
-          node.respond_to?(:content) &&
           node.content.is_a?(String)
+      rescue NoMethodError
+        false
       end
 
       # Iterate element_order directly, preserving whitespace text nodes
@@ -1103,15 +1082,6 @@ module Metanorma
             end
           end
         end
-      rescue StandardError
-        node.each_mixed_content do |child|
-          case child
-          when String
-            @output << escape_html(child)
-          else
-            render_inline_element(child)
-          end
-        end
       end
 
       # Inline adapter methods for registry dispatch
@@ -1207,17 +1177,14 @@ module Metanorma
       end
 
       def render_inline_collections(node)
-        # Fallback: render text and inline collections sequentially
         texts = node.text
         if texts.is_a?(Array)
           texts.each do |t|
-            @output << if t.is_a?(Metanorma::Document::Components::Inline::MathElement)
-                         t.content.to_s
-                       elsif t.is_a?(Metanorma::Document::Components::Inline::AsciimathElement)
-                         %(<span class="stem">#{escape_html(Array(t.text).join)}</span>)
-                       else
-                         escape_html(t.to_s)
-                       end
+            if t.is_a?(String)
+              @output << escape_html(t)
+            else
+              render_inline_element(t)
+            end
           end
         elsif texts.is_a?(String)
           @output << escape_html(texts)
@@ -1464,7 +1431,7 @@ module Metanorma
               return stem.math.to_xml
             rescue StandardError
               math_items = Array(stem.math)
-              return math_items.map { |m| m.respond_to?(:content) ? m.content.to_s : m.to_s }.join
+              return math_items.map { |m| m.is_a?(Lutaml::Model::Serializable) ? m.content.to_s : m.to_s }.join
             end
           end
           if stem.asciimath
@@ -1499,34 +1466,36 @@ module Metanorma
         parts.join
       end
 
-      BLOCK_TYPES = Set[
-        Metanorma::Document::Components::Paragraphs::ParagraphBlock,
-        Metanorma::Document::Components::Tables::TableBlock,
-        Metanorma::Document::Components::Lists::UnorderedList,
-        Metanorma::Document::Components::Lists::OrderedList,
-        Metanorma::Document::Components::Lists::DefinitionList,
-        Metanorma::Document::Components::AncillaryBlocks::FigureBlock,
-        Metanorma::Document::Components::Blocks::NoteBlock,
-        Metanorma::Document::Components::AncillaryBlocks::ExampleBlock,
-        Metanorma::Document::Components::AncillaryBlocks::SourcecodeBlock,
-        Metanorma::Document::Components::AncillaryBlocks::FormulaBlock,
-        Metanorma::Document::Components::MultiParagraph::QuoteBlock,
-        Metanorma::Document::Components::MultiParagraph::AdmonitionBlock,
-        Metanorma::Document::Components::Sections::HierarchicalSection,
-        Metanorma::Document::Components::Sections::BasicSection,
-        Metanorma::Document::Components::Sections::ContentSection,
-      ].freeze
+      BLOCK_TYPES = {
+        Metanorma::Document::Components::Paragraphs::ParagraphBlock => true,
+        Metanorma::Document::Components::Tables::TableBlock => true,
+        Metanorma::Document::Components::Lists::UnorderedList => true,
+        Metanorma::Document::Components::Lists::OrderedList => true,
+        Metanorma::Document::Components::Lists::DefinitionList => true,
+        Metanorma::Document::Components::AncillaryBlocks::FigureBlock => true,
+        Metanorma::Document::Components::Blocks::NoteBlock => true,
+        Metanorma::Document::Components::AncillaryBlocks::ExampleBlock => true,
+        Metanorma::Document::Components::AncillaryBlocks::SourcecodeBlock => true,
+        Metanorma::Document::Components::AncillaryBlocks::FormulaBlock => true,
+        Metanorma::Document::Components::MultiParagraph::QuoteBlock => true,
+        Metanorma::Document::Components::MultiParagraph::AdmonitionBlock => true,
+        Metanorma::Document::Components::Sections::HierarchicalSection => true,
+        Metanorma::Document::Components::Sections::BasicSection => true,
+        Metanorma::Document::Components::Sections::ContentSection => true,
+      }.freeze
 
       def html_class_for_span(xml_class)
         SPAN_ROLE_CLASSES[xml_class] || "span-#{xml_class}"
       end
 
       def block_element?(obj)
-        BLOCK_TYPES.any? { |type| obj.is_a?(type) }
+        BLOCK_TYPES[obj.class] || BLOCK_TYPES.any? { |type, _| obj.is_a?(type) }
       end
 
       def safe_attr(obj, method_name)
-        obj.public_send(method_name) if obj.respond_to?(method_name)
+        obj.public_send(method_name)
+      rescue NoMethodError
+        nil
       end
 
       def collect_index_term(element)

data/lib/metanorma/html/drops/figure_list_entry_drop.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Html
+    module Drops
+      class FigureListEntryDrop < Liquid::Drop
+        def initialize(entry)
+          @entry = entry
+        end
+
+        def id = @entry[:id]
+        def text = @entry[:text]
+      end
+    end
+  end
+end

data/lib/metanorma/html/drops/toc_entry_drop.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Html
+    module Drops
+      class TocEntryDrop < Liquid::Drop
+        def initialize(entry)
+          @entry = entry
+        end
+
+        def id = @entry[:id]
+        def text = @entry[:text]
+        def level = @entry[:level]
+      end
+    end
+  end
+end

data/lib/metanorma/html/drops.rb

@@ -11,6 +11,8 @@ module Metanorma
       autoload :SourcecodeDrop, "metanorma/html/drops/sourcecode_drop"
       autoload :FormulaDrop, "metanorma/html/drops/formula_drop"
       autoload :FigureDrop, "metanorma/html/drops/figure_drop"
+      autoload :TocEntryDrop, "metanorma/html/drops/toc_entry_drop"
+      autoload :FigureListEntryDrop, "metanorma/html/drops/figure_list_entry_drop"
     end
   end
 end

data/lib/metanorma/html/iso_renderer.rb

@@ -133,7 +133,7 @@ module Metanorma
 
       # Extract document type from ext.doctype.
       def extract_doctype(bibdata)
-        return nil unless bibdata.respond_to?(:ext)
+        return nil unless bibdata.is_a?(Metanorma::IsoDocument::Metadata::IsoBibliographicItem)
 
         ext = bibdata.ext
         return nil unless ext
@@ -154,8 +154,6 @@ module Metanorma
         val.strip.empty? ? nil : val
       end
 
-      private
-
       # --- Top-level document rendering ---
 
       def render_document(doc, **_opts)

data/lib/metanorma/html/standard_renderer.rb

@@ -19,8 +19,6 @@ module Metanorma
       register_render Metanorma::StandardDocument::Sections::FloatingTitle, :render_floating_title
       register_render Metanorma::StandardDocument::Blocks::AmendBlock, :render_amend_block
 
-      private
-
       # --- Top-level document rendering ---
 
       def render_standard_document(doc, **_opts)
@@ -50,7 +48,7 @@ module Metanorma
         end
 
         # Index section from indexsect element (presentation XML)
-        if doc.respond_to?(:indexsect) && doc.indexsect
+        if doc.is_a?(Metanorma::IsoDocument::Root) && doc.indexsect
           render(doc.indexsect)
         end
 

data/lib/metanorma/html/templates/_toc.html.liquid

@@ -0,0 +1,27 @@
+{% for fig in figures %}
+<li class="toc-list-header" data-list="figures"><button class="toc-list-toggle" aria-expanded="false"><svg width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="1" y="2" width="14" height="12" rx="1"/><circle cx="5" cy="6.5" r="1.5"/><path d="M1 12l4-4 2 2 3-3 5 5"/></svg> Figures <span class="toc-list-count">({{ figures.size }})</span></button></li>
+{% break %}
+{% endfor %}
+{% for fig in figures %}
+<li class="toc-list-item toc-figures" style="display:none"><a href="#{{ fig.id }}" class="toc-link" data-target="{{ fig.id }}">{{ fig.text | escape }}</a></li>
+{% endfor %}
+
+{% for tbl in tables %}
+<li class="toc-list-header" data-list="tables"><button class="toc-list-toggle" aria-expanded="false"><svg width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="1" y="2" width="14" height="12" rx="1"/><line x1="1" y1="6" x2="15" y2="6"/><line x1="1" y1="10" x2="15" y2="10"/><line x1="7" y1="2" x2="7" y2="14"/></svg> Tables <span class="toc-list-count">({{ tables.size }})</span></button></li>
+{% break %}
+{% endfor %}
+{% for tbl in tables %}
+<li class="toc-list-item toc-tables" style="display:none"><a href="#{{ tbl.id }}" class="toc-link" data-target="{{ tbl.id }}">{{ tbl.text | escape }}</a></li>
+{% endfor %}
+
+{% if has_special_lists %}
+<li class="toc-divider"></li>
+{% endif %}
+
+{% if entries.size == 0 %}
+<li class="toc-empty">No entries</li>
+{% else %}
+{% for entry in entries %}
+<li class="toc-level-{{ entry.level }}"><a href="#{{ entry.id }}" class="toc-link" data-target="{{ entry.id }}">{{ entry.text | escape }}</a></li>
+{% endfor %}
+{% endif %}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-document
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.5
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-06 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -486,10 +486,12 @@ files:
 - lib/metanorma/html/drops/block_element_drop.rb
 - lib/metanorma/html/drops/example_drop.rb
 - lib/metanorma/html/drops/figure_drop.rb
+- lib/metanorma/html/drops/figure_list_entry_drop.rb
 - lib/metanorma/html/drops/footnote_drop.rb
 - lib/metanorma/html/drops/formula_drop.rb
 - lib/metanorma/html/drops/note_drop.rb
 - lib/metanorma/html/drops/sourcecode_drop.rb
+- lib/metanorma/html/drops/toc_entry_drop.rb
 - lib/metanorma/html/generator.rb
 - lib/metanorma/html/icc_renderer.rb
 - lib/metanorma/html/iec_renderer.rb
@@ -516,6 +518,7 @@ files:
 - lib/metanorma/html/templates/_iso_doc_title.html.liquid
 - lib/metanorma/html/templates/_note.html.liquid
 - lib/metanorma/html/templates/_sourcecode.html.liquid
+- lib/metanorma/html/templates/_toc.html.liquid
 - lib/metanorma/html/templates/document.html.liquid
 - lib/metanorma/html/theme.rb
 - lib/metanorma/html/whitespace_patch.rb