coradoc 2.0.19 → 2.0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfb7ecfe3eb593e8a88dc23950b2e75fb5bafd4ea8f31ee7840c44e1cdaadd28
-  data.tar.gz: 1835d0ac0defa944dc45d26c967d3e9ddb0d20a599f79c85657531689c67faf0
+  metadata.gz: a4ebd4f989cb1c3bc9c6adcede592e91c6013a29bf94c3d12319e03c5c42ab38
+  data.tar.gz: d321f36297bb31aac76fe30a6195aa9cd1456c840dfb1888405c0e36f474c4b7
 SHA512:
-  metadata.gz: b1a73e74172ae6af0dd2a5426f520b546170c2a4f00910f91dd45211bccf448ca187d45b64ba94030549331008a50adaff283ca1ced17c39bb164d6a6cd9a032
-  data.tar.gz: 57efec479b5c118c4c18d99d7e0b0090046ef1c42ed17b265804f044467775fb82781bec4a7c3a119b24a428ff46ec50c642e4557488471447f5e96af48d4572
+  metadata.gz: 1bba8d765b1af164d1713f16013eddbdbc906340f37d1918777fd3ec1c6f1ec784e869155ccae100b6d4a4306bea003c4031fbf6276890608471a97d5a407bd2
+  data.tar.gz: e76a4e152ebbc25ee03732c6870fbfbdf062d8a3e0af8423b4da9486d14483952a56a3af6b25c256a6350e60e475afa89112e25931b08b47209884ceb1e8089a

data/lib/coradoc/core_model/block.rb

@@ -53,10 +53,16 @@ module Coradoc
       #   @return [String, nil] language identifier for source code blocks
       attribute :language, :string
 
+      # @!attribute callouts
+      #   @return [Array<Callout>] callout annotations attached to this
+      #     block. Empty for most block types; populated by format gems
+      #     when AsciiDoc-style `<N>` annotations follow a verbatim block.
+      attribute :callouts, Callout, collection: true, default: -> { [] }
+
       private
 
       def comparable_attributes
-        super + %i[block_semantic_type content]
+        super + %i[block_semantic_type content callouts]
       end
     end
   end

data/lib/coradoc/core_model/callout.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module CoreModel
+    # A single callout annotation attached to a verbatim block.
+    #
+    # Callouts are the AsciiDoc convention for annotating individual lines
+    # of a source/listing block: `<1>` markers appear inside the code and
+    # matching `<1> explanation` lines follow the block. Markdown has no
+    # native equivalent, so each format gem decides how to render them.
+    #
+    # The CoreModel stores each annotation as a typed Callout on its parent
+    # block, with the in-code marker `<index>` preserved in the block's
+    # `content` for verbatim round-trip.
+    class Callout < Base
+      # @!attribute index
+      #   @return [Integer, nil] 1-based callout number matching the
+      #     `<N>` marker embedded in the parent block's content.
+      attribute :index, :integer
+
+      # @!attribute content
+      #   @return [String, nil] human-readable annotation text.
+      attribute :content, :string
+
+      private
+
+      def comparable_attributes
+        super + %i[index content]
+      end
+    end
+  end
+end

data/lib/coradoc/core_model/callout_text.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module CoreModel
+    # Shared helpers for rendering Callout-annotated verbatim blocks.
+    #
+    # Both the Markdown and HTML spokes need to (a) order callouts by their
+    # numeric index and (b) strip AsciiDoc-style `<N>` markers from the
+    # raw code so they don't leak as literal text in the output format.
+    # Centralizing these operations here keeps the behavior consistent
+    # across spokes and avoids copy-paste drift.
+    module CalloutText
+      module_function
+
+      def ordered(callouts)
+        Array(callouts).sort_by { |c| c.index || Float::INFINITY }
+      end
+
+      # Removes callout markers (`<N>`) from `code` for the indices
+      # referenced by `callouts`. Returns `code` unchanged when no
+      # callouts are provided or none carry a usable index, so literal
+      # `<N>` sequences in code without callouts are preserved.
+      def strip_markers(code, callouts)
+        list = Array(callouts)
+        return code if list.empty?
+
+        indices = list.filter_map(&:index).uniq
+        return code if indices.empty?
+
+        pattern = /<\s*(?:#{indices.join('|')})\s*>/
+        code.to_s.lines(chomp: true).map { |line| line.gsub(pattern, '').rstrip }.join("\n")
+      end
+    end
+  end
+end

data/lib/coradoc/core_model/raw_inline_element.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module CoreModel
+    # Inline raw passthrough — content the source format marked as "do not
+    # process". AsciiDoc's `+++raw+++` is the canonical producer. Spokes
+    # that lack a passthrough concept (most of them) should emit the
+    # content verbatim, since the original author explicitly chose raw
+    # markup (often HTML) knowing it would be passed through.
+    class RawInlineElement < InlineElement
+      def self.format_type
+        'raw_inline'
+      end
+    end
+  end
+end

data/lib/coradoc/core_model.rb

@@ -12,6 +12,8 @@ module Coradoc
     # Autoload submodules lazily using relative paths
     autoload :Base, "#{__dir__}/core_model/base"
     autoload :ChildrenContent, "#{__dir__}/core_model/children_content"
+    autoload :Callout, "#{__dir__}/core_model/callout"
+    autoload :CalloutText, "#{__dir__}/core_model/callout_text"
     autoload :Block, "#{__dir__}/core_model/block"
     autoload :AnnotationBlock, "#{__dir__}/core_model/annotation_block"
     autoload :ListBlock, "#{__dir__}/core_model/list_block"
@@ -34,6 +36,7 @@ module Coradoc
     autoload :SpanElement, "#{__dir__}/core_model/inline_element"
     autoload :TermElement, "#{__dir__}/core_model/inline_element"
     autoload :LineBreakElement, "#{__dir__}/core_model/inline_element"
+    autoload :RawInlineElement, "#{__dir__}/core_model/raw_inline_element"
     autoload :StructuralElement, "#{__dir__}/core_model/structural_element"
     autoload :DocumentElement, "#{__dir__}/core_model/structural_element"
     autoload :SectionElement, "#{__dir__}/core_model/structural_element"

data/lib/coradoc/performance_regression.rb

@@ -23,6 +23,11 @@ module Coradoc
       def passed?
         duration < threshold
       end
+
+      def format_line
+        status = passed? ? 'PASS' : 'FAIL'
+        "  #{status} #{name}: #{duration.round(4)}s (threshold: #{threshold}s)"
+      end
     end
 
     ComparisonResult = Struct.new(:name, :duration, :baseline, keyword_init: true) do
@@ -31,6 +36,12 @@ module Coradoc
 
         (duration - baseline).abs / baseline > pct
       end
+
+      def format_line
+        status = regressed? ? 'WARN' : 'OK'
+        baseline_str = baseline ? "(baseline: #{baseline.round(4)}s)" : '(no baseline)'
+        "  #{status} #{name}: #{duration.round(4)}s #{baseline_str}"
+      end
     end
 
     class << self
@@ -50,14 +61,15 @@ module Coradoc
         { results:, failed_count: failed, total: results.size }
       end
 
-      def print_results(summary)
-        results = summary[:results]
-        results.each do |r|
-          status = r.passed? ? 'PASS' : 'FAIL'
-          puts "  #{status} #{r.name}: #{r.duration.round(4)}s (threshold: #{r.threshold}s)"
+      def print_results(summary_or_results)
+        if summary_or_results.is_a?(Hash)
+          summary = summary_or_results
+          summary[:results].each { |r| puts r.format_line }
+          puts
+          puts "#{summary[:total] - summary[:failed_count]}/#{summary[:total]} passed"
+        else
+          Array(summary_or_results).each { |r| puts r.format_line }
         end
-        puts
-        puts "#{summary[:total] - summary[:failed_count]}/#{summary[:total]} passed"
       end
 
       def compare_with_baseline(baseline_path, iterations: 3)

data/lib/coradoc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Coradoc
-  VERSION = '2.0.19'
+  VERSION = '2.0.21'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coradoc
 version: !ruby/object:Gem::Version
-  version: 2.0.19
+  version: 2.0.21
 platform: ruby
 authors:
 - Ribose Inc.
@@ -60,6 +60,8 @@ files:
 - lib/coradoc/core_model/bibliography.rb
 - lib/coradoc/core_model/bibliography_entry.rb
 - lib/coradoc/core_model/block.rb
+- lib/coradoc/core_model/callout.rb
+- lib/coradoc/core_model/callout_text.rb
 - lib/coradoc/core_model/children_content.rb
 - lib/coradoc/core_model/comment_block.rb
 - lib/coradoc/core_model/comment_line.rb
@@ -86,6 +88,7 @@ files:
 - lib/coradoc/core_model/paragraph_block.rb
 - lib/coradoc/core_model/pass_block.rb
 - lib/coradoc/core_model/quote_block.rb
+- lib/coradoc/core_model/raw_inline_element.rb
 - lib/coradoc/core_model/reviewer_block.rb
 - lib/coradoc/core_model/sidebar_block.rb
 - lib/coradoc/core_model/source_block.rb