metanorma-document 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc7125fd4984bbedebb8d471fc29d0d34d5b56b7de1ec518570bc27f8e0671d5
-  data.tar.gz: bc63e4f58ba6053d66df6a2671737c0ce051057ef4e0b14fc51154d050ca0c67
+  metadata.gz: d03f7b4977f3220a59c871eb1e62e2f00042fd2b56164a41ed6361b18ddb1fd2
+  data.tar.gz: 274a96e49ab7923362edbcf4733214f7fdca6aa75699623da8c065c8958d5cb3
 SHA512:
-  metadata.gz: 45e13915f1b88579d06b94968c5a7f469fdbf77b6980cf3cb68d6747bb9fd1a87d111c8388d2f0f337ba5ccde71aa96c7f755ca6d0080f8ccafa154a15ed7075
-  data.tar.gz: 1a6ab72e96afe880682ffb9646273e794dec60ce1a2e208d794054fe99ea38c6adf09672678a8234ebf805b800ab491bfa01332efcd663b65c403e8cd617712c
+  metadata.gz: 06a95eb083a619c0eb43c0acd394e171fa812d2e9eb9b592fa0f551568f6eae25f5ec824e787354d8e1c2bb95ad10aedaa10615e0bcb31b2a022bde8f212025a
+  data.tar.gz: da8eb0c5a86def7f9cd05e173957404a1ca047270d4ee12043cf696687e9ae9a38b01c91fbec7097af074ed3df697e75bf46d934d9a22d1ed0b74a957ee29b1d

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-04-22 12:28:09 UTC using RuboCop version 1.86.1.
+# on 2026-05-06 04:06:53 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
@@ -13,114 +13,220 @@ Gemspec/RequiredRubyVersion:
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-Layout/ClosingParenthesisIndentation:
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/component/index_term_collector.rb'
 
-# Offense count: 1
+# Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
-Layout/FirstArgumentIndentation:
+Layout/EmptyLineAfterGuardClause:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/generator.rb'
+    - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
 
-# Offense count: 580
+# Offense count: 11
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: empty_lines, empty_lines_except_namespace, empty_lines_special, no_empty_lines, beginning_only, ending_only
+Layout/EmptyLinesAroundClassBody:
+  Exclude:
+    - 'lib/metanorma/html/bipm_renderer.rb'
+    - 'lib/metanorma/html/cc_renderer.rb'
+    - 'lib/metanorma/html/iec_renderer.rb'
+    - 'lib/metanorma/html/ieee_renderer.rb'
+    - 'lib/metanorma/html/ietf_renderer.rb'
+    - 'lib/metanorma/html/iho_renderer.rb'
+    - 'lib/metanorma/html/itu_renderer.rb'
+    - 'lib/metanorma/html/ogc_renderer.rb'
+    - 'lib/metanorma/html/oiml_renderer.rb'
+    - 'lib/metanorma/html/pdfa_renderer.rb'
+    - 'lib/metanorma/html/ribose_renderer.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
+  Exclude:
+    - 'lib/metanorma/html/bipm_renderer.rb'
+    - 'lib/metanorma/html/generator.rb'
+    - 'lib/metanorma/html/iho_renderer.rb'
+    - 'lib/metanorma/html/theme.rb'
+
+# Offense count: 718
 # 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
+# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: symmetrical, new_line, same_line
-Layout/MultilineMethodCallBraceLayout:
+# Configuration parameters: AllowForAlignment, EnforcedStyleForExponentOperator, EnforcedStyleForRationalLiterals.
+# SupportedStylesForExponentOperator: space, no_space
+# SupportedStylesForRationalLiterals: space, no_space
+Layout/SpaceAroundOperators:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/bipm_renderer.rb'
+    - 'lib/metanorma/html/iho_renderer.rb'
+    - 'lib/metanorma/html/theme.rb'
 
-# Offense count: 2
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/metanorma/html/renderer/class_ownership_spec.rb'
+
+# Offense count: 4
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
-    - 'lib/metanorma/html/index_generator.rb'
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/base_renderer.rb'
 
-# Offense count: 2
+# Offense count: 3
 # Configuration parameters: AllowComments, AllowEmptyLambdas.
 Lint/EmptyBlock:
   Exclude:
+    - 'lib/metanorma/html/drops/formula_drop.rb'
     - 'spec/metanorma/iso_document/metadata/title_roundtrip_spec.rb'
 
+# Offense count: 2
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/metanorma/html/drops/block_element_drop.rb'
+    - 'lib/metanorma/html/drops/footnote_drop.rb'
+
 # Offense count: 1
-# Configuration parameters: AllowedPatterns.
-# AllowedPatterns: (?-mix:(exactly|at_least|at_most)\(\d+\)\.times)
-Lint/UnreachableLoop:
+Lint/StructNewOverride:
+  Exclude:
+    - 'lib/metanorma/html/component/index_term_collector.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/component/index_section.rb'
+    - 'lib/metanorma/html/generator.rb'
 
 # Offense count: 1
 Lint/UselessConstantScoping:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/base_renderer.rb'
 
-# Offense count: 26
+# Offense count: 85
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
-  Exclude:
-    - 'lib/metanorma/document/components/lists/list_item.rb'
-    - 'lib/metanorma/html/index_generator.rb'
-    - 'lib/metanorma/html/renderer.rb'
-    - 'lib/metanorma/html/transformer.rb'
+  Enabled: false
 
-# Offense count: 11
+# Offense count: 22
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 139
+  Max: 66
 
 # Offense count: 2
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 31
+# Offense count: 64
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
     - 'lib/metanorma/document/components/lists/list_item.rb'
-    - 'lib/metanorma/html/index_generator.rb'
-    - 'lib/metanorma/html/renderer.rb'
-    - 'lib/metanorma/html/transformer.rb'
+    - 'lib/metanorma/html/base_renderer.rb'
+    - 'lib/metanorma/html/bipm_renderer.rb'
+    - 'lib/metanorma/html/component/index_term_collector.rb'
+    - 'lib/metanorma/html/drops/example_drop.rb'
+    - 'lib/metanorma/html/drops/figure_drop.rb'
+    - 'lib/metanorma/html/drops/formula_drop.rb'
+    - 'lib/metanorma/html/drops/note_drop.rb'
+    - 'lib/metanorma/html/generator.rb'
+    - 'lib/metanorma/html/iso_renderer.rb'
+    - 'lib/metanorma/html/ogc_renderer.rb'
+    - 'lib/metanorma/html/standard_renderer.rb'
+    - 'lib/metanorma/html/theme.rb'
     - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
 
-# Offense count: 33
+# Offense count: 89
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 141
+  Max: 104
 
-# Offense count: 24
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 7
+
+# Offense count: 55
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
     - 'lib/metanorma/document/components/lists/list_item.rb'
-    - 'lib/metanorma/html/index_generator.rb'
-    - 'lib/metanorma/html/renderer.rb'
-    - 'lib/metanorma/html/transformer.rb'
+    - 'lib/metanorma/html/base_renderer.rb'
+    - 'lib/metanorma/html/bipm_renderer.rb'
+    - 'lib/metanorma/html/component/index_term_collector.rb'
+    - 'lib/metanorma/html/drops/example_drop.rb'
+    - 'lib/metanorma/html/drops/figure_drop.rb'
+    - 'lib/metanorma/html/drops/formula_drop.rb'
+    - 'lib/metanorma/html/drops/note_drop.rb'
+    - 'lib/metanorma/html/generator.rb'
+    - 'lib/metanorma/html/iso_renderer.rb'
+    - 'lib/metanorma/html/ogc_renderer.rb'
+    - 'lib/metanorma/html/standard_renderer.rb'
+    - 'lib/metanorma/html/theme.rb'
+    - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
 
-# Offense count: 1
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, BlockForwardingName.
+# SupportedStyles: anonymous, explicit
+Naming/BlockForwarding:
+  Exclude:
+    - 'lib/metanorma/html/component/footnote_collector.rb'
+
+# Offense count: 22
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/base_renderer.rb'
+    - 'lib/metanorma/html/component/footnote_collector.rb'
+    - 'lib/metanorma/html/drops/sourcecode_drop.rb'
+    - 'lib/metanorma/html/iso_renderer.rb'
+    - 'spec/metanorma/html/renderer/footnote_collector_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/metanorma/html/base_renderer.rb'
 
-# Offense count: 10
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'lib/metanorma/html/standard_renderer.rb'
+
+# Offense count: 13
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Exclude:
     - 'spec/metanorma/document_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'
     - 'spec/metanorma/iso_document/metadata/title_roundtrip_spec.rb'
     - 'spec/metanorma/iso_document/roundtrip/bipm_roundtrip_spec.rb'
     - 'spec/metanorma/iso_document/roundtrip/cc_roundtrip_spec.rb'
@@ -131,36 +237,108 @@ RSpec/DescribeClass:
     - 'spec/metanorma/iso_document/roundtrip/oiml_collection_roundtrip_spec.rb'
     - 'spec/metanorma/iso_document/roundtrip/oiml_roundtrip_spec.rb'
 
-# Offense count: 1
+# Offense count: 4
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
-  Max: 6
+  Max: 8
+
+# Offense count: 1
+RSpec/LeakyConstantDeclaration:
+  Exclude:
+    - 'spec/metanorma/html/renderer/class_ownership_spec.rb'
 
 # Offense count: 1
 RSpec/MultipleDescribes:
   Exclude:
     - 'spec/metanorma/document_spec.rb'
 
-# Offense count: 279
+# Offense count: 286
 # Configuration parameters: AllowedPatterns.
 # AllowedPatterns: ^expect_, ^assert_
 RSpec/NoExpectationExample:
   Enabled: false
 
-# Offense count: 16
+# Offense count: 25
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
 # SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
   Enabled: false
 
 # Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowOnlyRestArgument, UseAnonymousForwarding, RedundantRestArgumentNames, RedundantKeywordRestArgumentNames, RedundantBlockArgumentNames.
+# RedundantRestArgumentNames: args, arguments
+# RedundantKeywordRestArgumentNames: kwargs, options, opts
+# RedundantBlockArgumentNames: blk, block, proc
+Style/ArgumentsForwarding:
+  Exclude:
+    - 'lib/metanorma/html/component/footnote_collector.rb'
+
+# 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:
+    - 'lib/metanorma/iso_document/metadata/iso_bibliographic_item.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+Style/ComparableClamp:
+  Exclude:
+    - 'lib/metanorma/html/base_renderer.rb'
+    - 'lib/metanorma/html/iso_renderer.rb'
+    - 'lib/metanorma/html/standard_renderer.rb'
+
+# Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
-Style/IdenticalConditionalBranches:
+# Configuration parameters: InverseMethods, InverseBlocks.
+Style/InverseMethods:
   Exclude:
-    - 'lib/metanorma/html/index_generator.rb'
+    - 'lib/metanorma/html/component/index_term_collector.rb'
 
 # Offense count: 1
-# Configuration parameters: Max.
-Style/SafeNavigationChainLength:
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: literals, strict
+Style/MutableConstant:
+  Exclude:
+    - 'lib/metanorma/html/base_renderer.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/NegatedIfElseCondition:
+  Exclude:
+    - 'lib/metanorma/iso_document/metadata/iso_localized_title.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantRegexpArgument:
+  Exclude:
+    - 'lib/metanorma/html/bipm_renderer.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/RescueModifier:
+  Exclude:
+    - 'lib/metanorma/html/generator.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: ConvertCodeThatCanStartToReturnNil, AllowedMethods, MaxChainLength.
+# AllowedMethods: present?, blank?, presence, try, try!
+Style/SafeNavigation:
+  Exclude:
+    - 'lib/metanorma/html/bipm_renderer.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
   Exclude:
-    - 'lib/metanorma/html/renderer.rb'
+    - 'lib/metanorma/html/component/footnote_collector.rb'
+    - 'lib/metanorma/html/component/index_term_collector.rb'

data/README.adoc

@@ -75,6 +75,34 @@ BaseRenderer                  # Core HTML rendering, document assembly, CSS/JS p
     └── RiboseRenderer        # Ribose-specific formatting
 ....
 
+===== Drop Pattern
+
+Block elements (notes, examples, sourcecode, formulas, figures, admonitions) use the Drop pattern:
+
+[source,ruby]
+# A Drop captures rendered content via RendererContext, then passes
+# data to a Liquid template. The renderer never emits HTML directly.
+def render_note(note, **_opts)
+  drop = Drops::NoteDrop.from_model(note, renderer: renderer_context)
+  @output << render_liquid("_note.html.liquid", { "block" => drop })
+end
+
+Each Drop class inherits from `BlockElementDrop` and implements `.from_model(model, renderer:)` which:
+
+. Captures child content via `renderer.capture_output { ... }`
+. Returns a new Drop instance with pre-rendered HTML strings
+. The Liquid template reads Drop attributes and outputs final HTML
+
+`RendererContext` is a facade that exposes only the rendering methods Drops need, maintaining encapsulation.
+
+===== Class Name Ownership
+
+The HTML renderer owns its class names entirely. **No XML-originated class names appear in the HTML output.**
+
+* Block-level classes (`note-block`, `formula`, `figure`, etc.) are assigned by the renderer based on what it's rendering
+* Inline span classes use `SPAN_ROLE_CLASSES` to map XML span roles to HTML-specific names (e.g., `boldtitle` → `title-text`, `citesec` → `xref-section`)
+* The XML's `class_attr` is read as **input only** to determine semantic role, never emitted directly
+
 ==== Presentation XML
 
 The HTML renderer expects **presentation XML** (not source XML). Presentation XML contains `fmt-*` display elements (`fmt-title`, `fmt-xref`, `fmt-link`, `fmt-concept`, `fmt-definition`, `fmt-preferred`, etc.) alongside semantic elements. The renderer prioritizes `fmt-*` elements for rendering, falling back to semantic elements when display elements are absent.
@@ -107,8 +135,15 @@ HTML structure is defined in `.liquid` templates under `lib/metanorma/html/templ
 `_header.html.liquid` :: Sticky header with publisher logos
 `_footer.html.liquid` :: Footer with copyright
 `_cover.html.liquid` :: Cover page layout
+`_iso_cover.html.liquid` :: ISO-specific cover page
 `_footnotes.html.liquid` :: Footnotes section
 `_doc_title.html.liquid` :: Document title rendering
+`_note.html.liquid` :: Note block
+`_example.html.liquid` :: Example block
+`_sourcecode.html.liquid` :: Source code block
+`_formula.html.liquid` :: Formula block
+`_figure.html.liquid` :: Figure block
+`_admonition.html.liquid` :: Admonition block
 
 Templates use `Liquid::LocalFileSystem` for partials (prefixed with `_`). The `render_liquid` method handles template caching via `TEMPLATE_CACHE`.
 
@@ -151,26 +186,32 @@ Renderer instance methods:
 `theme` :: Returns the `Theme` instance (override in subclasses).
 `render_liquid(template_name, assigns)` :: Renders a Liquid template with caching.
 
- == Document Flavors
+== Document Flavors
+
+The gem provides a hierarchy of document flavors:
+
+* BasicDocument - Basic document model
+* StandardDocument - Standard document model (extends BasicDocument)
+* IsoDocument - ISO standard document model (extends StandardDocument)
+* IecDocument - IEC standard document model
+* IeeeDocument - IEEE standard document model
+* IetfDocument - IETF standard document model
+* IhoDocument - IHO standard document model
+* OimlDocument - OIML standard document model
+* BipmDocument - BIPM standard document model
+* ItuDocument - ITU standard document model
+* OgcDocument - OGC standard document model
+* CcDocument - CC standard document model
+* RiboseDocument - Ribose standard document model
+
+== Supported XML Formats
 
- The gem provides a hierarchy of document flavors:
+This library targets the modern Metanorma XML format which uses `<metanorma>` as the root element.
 
- * BasicDocument - Basic document model
- * StandardDocument - Standard document model (extends BasicDocument)
- * IsoDocument - ISO standard document model (extends StandardDocument)
- * IecDocument - IEC standard document model
- * IeeeDocument - IEEE standard document model
- * IetfDocument - IETF standard document model
- * IhoDocument - IHO standard document model
- * OimlDocument - OIML standard document model
- * BipmDocument - BIPM standard document model
- * ItuDocument - ITU standard document model
- * OgcDocument - OGC standard document model
- * CcDocument - CC standard document model
- * RiboseDocument - Ribose standard document model
+Legacy XML formats that use flavor-specific root elements (e.g. `<iso-standard>`, `<m3d-standard>`, `<csa-standard>`, `<un-standard>`) are *not supported*.
 
- == Supported XML Formats
+== Documentation
 
- This library targets the modern Metanorma XML format which uses `<metanorma>` as the root element.
+Detailed architecture documentation is in the `docs/` directory:
 
- Legacy XML formats that use flavor-specific root elements (e.g. `<iso-standard>`, `<m3d-standard>`, `<csa-standard>`, `<un-standard>`) are *not supported*.
+* xref:docs/html-renderer.adoc[HTML Renderer Architecture] — renderer pipeline, drop pattern, class name ownership, template system

data/data/stylesheets/components/bibliography.css

@@ -12,7 +12,7 @@
   border-bottom: 1px solid var(--color-border);
 }
 .norm-ref-entry:last-child { border-bottom-color: transparent; }
-.std-doc-number { font-weight: 500; color: var(--mn-primary); font-family: var(--font-sans); }
-.std-year { font-weight: 500; }
+.ref-doc-number { font-weight: 500; color: var(--mn-primary); font-family: var(--font-sans); }
+.ref-year { font-weight: 500; }
 .biblio-link { color: inherit; text-decoration: none; }
 .biblio-link:hover { color: var(--mn-primary); text-decoration: underline; }

data/data/stylesheets/components/inline.css

@@ -1,8 +1,8 @@
 /* === Inline Elements === */
 .fn-marker { vertical-align: super; font-size: 0.78em; color: var(--mn-primary); font-family: var(--font-sans); }
 .small-caps { font-variant: small-caps; letter-spacing: 0.03em; }
-.obligation { font-style: italic; color: var(--mn-accent); }
-.bold-title { font-weight: 700; }
+.obligation-text { font-style: italic; color: var(--mn-accent); }
+.title-text { font-weight: 700; }
 
 /* Math container — hover dropdown for source formats */
 .math-container { position: relative; display: inline; }
@@ -30,28 +30,27 @@
   border-radius: 2px; transition: background 0.15s, color 0.15s;
 }
 .stem-copy-btn:hover { background: var(--mn-primary-light); color: var(--mn-primary); }
-.nonboldtitle { font-weight: 400; }
+.subtitle-text { font-weight: 400; }
 
-.citesec, .citefig, .citetbl, .citeapp {
+.xref-section, .xref-fig, .xref-table, .xref-app {
   color: var(--mn-primary);
   text-decoration: underline;
   text-decoration-color: rgba(40,56,138,0.2);
   cursor: pointer;
 }
-.citesec:hover, .citefig:hover, .citetbl:hover, .citeapp:hover {
+.xref-section:hover, .xref-fig:hover, .xref-table:hover, .xref-app:hover {
   color: var(--mn-accent);
 }
 
-.doc-subtitle { font-weight: 400; }
-.doc-part-number { font-weight: 500; }
-.doc-part-title { font-style: italic; }
-.doc-publisher, .doc-publisher-name { font-weight: 500; }
-.std-doc-number { font-weight: 500; }
-.std-year { font-weight: 500; }
+.ref-part-number { font-weight: 500; }
+.ref-title { font-style: italic; }
+.ref-publisher, .ref-publisher-name { font-weight: 500; }
+.ref-doc-number { font-weight: 500; }
+.ref-year { font-weight: 500; }
 .xref-label { font-weight: 600; }
 a.xref { color: var(--mn-primary); text-decoration: none; border-bottom: 1px solid var(--mn-primary-light); }
 a.xref:hover { border-bottom-color: var(--mn-primary); }
-.doc-content a.xref .element-name { font-style: italic; }
+.doc-content a.xref .element-label { font-style: italic; }
 
 .kbd-hint {
   display: inline-block;