coradoc-adoc 2.0.31 → 2.0.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22eb5a515f97c8954148e99ef280dd4bb8ac3bed03d59d745291dc3d7ac302c2
-  data.tar.gz: 0435ded18a2f7895426d1de9aba45c5c3ccaeea442c287fb1f5cd6d14581b117
+  metadata.gz: 451e2ccdd5dbbd4771079ee9bdc1041c3ee0d3ff74847237d7f3d4aea5064031
+  data.tar.gz: 9f161020aca1c07565f9f20c510114b562925cbfb55d4666db14f1d61a68ed81
 SHA512:
-  metadata.gz: cc35eb17f93b7c78fc2f935cf71ef18d76af08eb36a52ab7040d90e735c72a4d1f990339fc414803ccbf767d0b57bf636be79d76940fa8a091e52bcd37091544
-  data.tar.gz: 8c93968c63d400dfb86d0855c6bb1a2ebc6bbe200a85b07da5d2861771baeacf2beb11cd811c136e912fae302d0003c8aa822f12c73ef2ae5d127ced9caea829
+  metadata.gz: 20150d6a118ae76db46737ca68c47b87a1195cd716ee88700de2afdb06094dd3edee9c66a5b224702e20c6333d28c4082d9840e24b590210154abe46643aad7a
+  data.tar.gz: a881fc61dd3bce4e276f3db93fd250d3cf0cd0ab18a2e93a296887a416070b43b0da61972818e79ff0d7c00bd9f4af6320bb8cae8976402fff8519943ce05299

data/lib/coradoc/asciidoc/reference_materializers/navigation.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module ReferenceMaterializers
+      # Render a navigation edge as a first-class CrossReferenceElement
+      # — the model-driven xref node the AsciiDoc serializer already
+      # knows how to emit (never a raw macro string). Materializing for
+      # AsciiDoc fills in the visible text from the authored label or
+      # the resolved target's title.
+      class Navigation < Coradoc::Reference::Materializer::Base
+        class << self
+          def kind
+            :navigation
+          end
+
+          def presentation
+            :any
+          end
+
+          def format
+            :asciidoc
+          end
+        end
+
+        def materialize(edge:, result:, **)
+          text = display_text(edge, result)
+          Coradoc::CoreModel::CrossReferenceElement.new(
+            target: xref_target(edge.address),
+            content: text,
+            children: [
+              Coradoc::CoreModel::TextElement.new(content: text)
+            ]
+          )
+        end
+
+        private
+
+        def xref_target(address)
+          [address.target, address.fragment].compact.join('#')
+        end
+
+        def display_text(edge, result)
+          return edge.label if edge.label && !edge.label.empty?
+          return result.target.title if result.is_a?(Coradoc::Reference::Result::Resolved) && result.target&.title
+
+          edge.address.to_s
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/reference_materializers.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    # Materializers rendering resolved reference Edges into
+    # AsciiDoc-shaped CoreModel nodes. They live in the format gem
+    # (not coradoc core) so format knowledge stays at the spoke of the
+    # hub-and-spoke architecture; registration is a load-time side
+    # effect via the Materializer registry's global extension point.
+    module ReferenceMaterializers
+      autoload :Navigation, "#{__dir__}/reference_materializers/navigation"
+    end
+  end
+end
+
+Coradoc::Reference::Materializer::Registry.register_global(
+  Coradoc::AsciiDoc::ReferenceMaterializers::Navigation
+)

data/lib/coradoc/asciidoc/version.rb

@@ -2,6 +2,6 @@
 
 module Coradoc
   module AsciiDoc
-    VERSION = '2.0.31'
+    VERSION = '2.0.32'
   end
 end

data/lib/coradoc/asciidoc.rb

@@ -94,6 +94,12 @@ module Coradoc
           document.to_adoc
         end
       end
+
+      # AsciiDoc round-trips include:: directives natively — graph-mode
+      # documents serialize losslessly, no hydration required.
+      def preserves_unresolved_includes?
+        true
+      end
     end
 
     # Backward-compatible aliases for model classes
@@ -152,3 +158,7 @@ Coradoc.register_format(:asciidoc, Coradoc::AsciiDoc,
 # Backward-compatibility: Coradoc::Model is now Coradoc::AsciiDoc::Model
 # This alias is provided for legacy code that hasn't been updated
 Coradoc::Model = Coradoc::AsciiDoc::Model unless defined?(Coradoc::Model)
+
+# Reference materializers for format: :asciidoc. Required (not autoloaded)
+# because registration is a load-time side effect, like register_format.
+require 'coradoc/asciidoc/reference_materializers'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coradoc-adoc
 version: !ruby/object:Gem::Version
-  version: 2.0.31
+  version: 2.0.32
 platform: ruby
 authors:
 - Ribose Inc.
@@ -235,6 +235,8 @@ files:
 - lib/coradoc/asciidoc/parser/table.rb
 - lib/coradoc/asciidoc/parser/term.rb
 - lib/coradoc/asciidoc/parser/text.rb
+- lib/coradoc/asciidoc/reference_materializers.rb
+- lib/coradoc/asciidoc/reference_materializers/navigation.rb
 - lib/coradoc/asciidoc/serializer.rb
 - lib/coradoc/asciidoc/serializer/adoc_serializer.rb
 - lib/coradoc/asciidoc/serializer/element_registry.rb