canon 0.3.49 → 0.3.50

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f3f2bed07760530a3f122f18e184ac0e925db9d6551bacc46ef896552fb79ce
-  data.tar.gz: 4de5e38b9be98f354a843bb3fdd1c725534fab28f6078cbf95a7c278d0c2596b
+  metadata.gz: 6bbfa0c65294f7a3ad7d77b678dab6fc1b9f5c0fc67bf55faba3371e6cfc6614
+  data.tar.gz: 28b3106753c227ad6973a2698ede0315d3e8812feed6af1cbccdf5cf08636184
 SHA512:
-  metadata.gz: '002904526d2626e462005b4a3627540a1d6587c458b60adb871ad03134054485c2712707579106f727fa00066b213d8db903f96be5d695470aed08ec82157461'
-  data.tar.gz: 537566ace8ff29b3124bbd9fd2789250d95d539de60b0e8ba89a3d5ebf83dee871fe0e7525d8d76381286f8adf71886957a3c4a29b1887f861fc0201b44bd862
+  metadata.gz: 9d3c4a330ec9224eff5a8c84bd677ea1fc72500b06099c188b3c7b30e6b096d3897f8308a40fc003067887dd4f45986464c8786b8bee8096614035dc8189c8ea
+  data.tar.gz: 84549e0eb08a383bf14934b8b22f58e3ad4aeac8aaaeb56ce80c87d1127df9d3ebc7d2f17763cf6cfd1dda65702e90d2379e0ba5d64193f250bd1f409d292aa3

data/lib/canon/diff_formatter/by_line/xml_formatter.rb

@@ -118,6 +118,13 @@ module Canon
           after = diff_node.serialized_after&.split("\n") || []
           fmt = diff_node.formatting?
           lines = []
+          header = parent_chain(diff_node.path)
+          if header
+            lines << Canon::Diff::DiffLine.new(
+              line_number: nil, new_position: nil,
+              content: header, type: :location_header
+            )
+          end
           require "diff/lcs" unless defined?(::Diff::LCS)
 
           ::Diff::LCS.sdiff(before, after).each do |change|
@@ -156,6 +163,27 @@ module Canon
           lines
         end
 
+        # Display chain of a DiffNode's ancestor elements, e.g.
+        # "bibitem > formattedref" — gives the blank-numbered
+        # unlocated lines a readable home (#86).
+        def parent_chain(path)
+          return nil if path.nil?
+
+          segments = path.split("/").reject(&:empty?)
+          return nil if segments.length < 2
+
+          chain = segments[0...-1].filter_map do |seg|
+            seg[/\A(?:\{[^}]+\})?([a-zA-Z0-9_:-]+)/, 1]
+          end
+          # Comparator paths repeat the element name before the node
+          # segment ("formattedref/formattedref/text()") — collapse
+          # consecutive repeats for display.
+          collapsed = chain.each_with_object([]) do |name, acc|
+            acc << name unless acc.last == name
+          end
+          collapsed.join(" > ")
+        end
+
         # The nearest preceding node (in @differences walk order)
         # that the enricher DID locate.
         def preceding_located(diff_node)
@@ -225,6 +253,9 @@ module Canon
               new_num = (diff_line.new_position || diff_line.line_number)&.+(1)
               output << format_unified_line(old_num, new_num, " ",
                                             diff_line.content)
+            when :location_header
+              output << format_location_header(diff_line.content)
+
             when :removed
               line_num = diff_line.line_number&.+(1)
               formatting = diff_line.formatting?
@@ -992,6 +1023,18 @@ module Canon
           end
         end
 
+        # Dimmed section header for unlocated-node contexts (#86):
+        # "⋯ in bibitem > formattedref"
+        def format_location_header(chain)
+          blank = " " * @line_num_width
+          text = "    ⋯ in #{chain}"
+          if @use_color
+            "#{blank}|#{blank}  | #{colorize(text, :light_black)}"
+          else
+            "#{blank}|#{blank}  | #{text}"
+          end
+        end
+
         def format_unified_line(old_num, new_num, marker, content, color = nil,
 informative: false, formatting: false)
           old_str = old_num ? "%#{@line_num_width}d" % old_num : " " * @line_num_width

data/lib/canon/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Canon
-  VERSION = "0.3.49"
+  VERSION = "0.3.50"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: canon
 version: !ruby/object:Gem::Version
-  version: 0.3.49
+  version: 0.3.50
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs