canon 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10234a14be49f993f58acac6d82bb6e8ca409d309bcd8446296f32f60ad6380f
-  data.tar.gz: 80e29ddf981d17f0fcd5812921f6ec1fbdf056b3ae673dc4d3d94c9979cddc21
+  metadata.gz: bfa3648b7c5308716c22fbdc377d875dc60d479eb0e376cfe347eb02a279d3d7
+  data.tar.gz: 87024447cc6a13eaa8cb9d1edf91d360e35d2e6cb5a1f2b7035c067050fae24a
 SHA512:
-  metadata.gz: bc63b5a8dae56a06781d8588809e8356eea618fdcdb13b933ea4c8a3c4f221201c05070a3ce100945c9f81ef6f122b73ff6ac723441aa2b3cbcc5fd31e8fee63
-  data.tar.gz: fbcb9ceb782f7847e6f2c6afba275f7d68da410d253b6f34f263b5c91803a3fbaff031de9b2dda5b8787fc37d0c82e1cea97d3ae1489d507eaad969168a107a1
+  metadata.gz: 6299802984ef5bab4c658c534105491f853c9d6cd297a5df49e5f8c83e0b36d1b01d140c1ea510002cf2916f3902035e764dcd589e4e01c5eec10c4ba76fda28
+  data.tar.gz: 42e73a1c3f80942d7ad102187b8a19148eb8a4046539eabb45561a716711fa3a51ea228e7bc372b4f675f4777db9ad964ed6c4873c19a5be9dc375af8639d92d

data/docs/advanced/verbose-mode-architecture.adoc

@@ -130,10 +130,33 @@ Each difference displays:
 * **Status indicator**: `[NORMATIVE]` (green) or `[INFORMATIVE]` (yellow)
 * **Dimension**: Which aspect differs (colorized in magenta)
 * **Location**: XPath for XML/HTML, path for JSON/YAML (colorized in blue)
+* **Reason**: When the reason contains visualized whitespace characters (░),
+  it is split across two lines with the before and after text vertically
+  aligned for easier visual comparison:
++
+[source]
+----
+Reason:  Text: "░░term2░definition░░"
+          vs.: "░term2░definition░"
+----
++
+When no visualized whitespace is present, the reason remains a single line.
 * **Expected section**: What was in File 1 (red heading, bold)
 * **Actual section**: What was in File 2 (green heading, bold)
 * **Changes summary**: Actionable description of the difference (yellow, bold)
 
+When both the Expected and Actual values are short (under 30 characters), they
+are rendered as compact single lines with aligned colons for succinctness:
+
+[source]
+----
+⊖ Expected (File 1): "term2 definition"
+⊕ Actual (File 2)  : "term2 definition"
+----
+
+For longer values, they appear on separate lines with no blank line between
+them.
+
 === Dimension-specific formats
 
 ==== Attribute presence differences

data/docs/features/match-options/html-policies.adoc

@@ -226,6 +226,9 @@ Canon::Comparison.equivalent?(html1, html2, preprocessing: :rendered)
 Pretty-prints before comparison:
 - Consistent indentation
 - One element per line
+- Whitespace-only text nodes in strip-context elements (e.g. `<div>`) are
+  removed after formatting, so differences in structural whitespace between
+  elements do not produce false normative differences
 - Good for visual diffs
 
 [source,ruby]

data/lib/canon/comparison/html_comparator.rb

@@ -393,12 +393,17 @@ module Canon
               end
             end
 
-            # For :rendered preprocessing with Nokogiri nodes
-            if preprocessing == :rendered
-              # Normalize and return
+            # For preprocessing modes that require whitespace filtering,
+            # apply the same post-parsing normalization used for string inputs.
+            # This is needed because dom_diff() pre-parses HTML5 strings into
+            # Nokogiri fragments before calling HtmlComparator, bypassing the
+            # string-input path where these filters are normally applied.
+            if %i[normalize format rendered].include?(preprocessing)
               frag = node.is_a?(Nokogiri::XML::DocumentFragment) ? node : Nokogiri::XML.fragment(node.to_html)
               normalize_html_style_script_comments(frag)
-              normalize_rendered_whitespace(frag, match_opts)
+              if preprocessing == :rendered
+                normalize_rendered_whitespace(frag, match_opts)
+              end
               remove_whitespace_only_text_nodes(frag)
               return frag
             end

data/lib/canon/diff_formatter/diff_detail_formatter.rb

@@ -14,6 +14,9 @@ module Canon
     # Formats dimension-specific detail for individual differences
     # Provides actionable, colorized output showing exactly what changed
     module DiffDetailFormatter
+      ANSI_ESCAPE = /\e\[[0-9;]*m/
+      COMPACT_DETAIL_MAX = 30
+
       class << self
         # Format all differences as a semantic diff report
         #
@@ -127,9 +130,7 @@ compact: false, expand_difference: false)
 
           # show reason if available
           if diff.respond_to?(:reason) && diff.reason
-            output << "#{colorize('Reason:', :cyan, use_color,
-                                  bold: true)}  #{colorize(diff.reason,
-                                                           :yellow, use_color)}"
+            format_reason_line(output, diff.reason, use_color)
           end
           output << ""
 
@@ -138,13 +139,7 @@ compact: false, expand_difference: false)
             diff, use_color, compact: compact, expand_difference: expand_difference
           )
 
-          output << colorize("⊖ Expected (File 1):", :red, use_color,
-                             bold: true)
-          output << "   #{detail1}"
-          output << ""
-          output << colorize("⊕ Actual (File 2):", :green, use_color,
-                             bold: true)
-          output << "   #{detail2}"
+          format_expected_actual(output, detail1, detail2, use_color)
 
           if changes && !changes.empty?
             output << ""
@@ -182,6 +177,52 @@ compact: false, expand_difference: false)
           colorize(error_msg, :red, use_color, bold: true)
         end
 
+        # Format the Reason line. When the reason contains visualized
+        # spaces (░), split into two vertically-aligned lines so the
+        # before/after text can be compared visually.
+        def format_reason_line(output, reason_text, use_color)
+          if reason_text.include?("\u2591") &&
+              reason_text.match?(/\A(Text|whitespace): .*\bvs\b/)
+            parts = reason_text.split(" vs ", 2)
+            if parts.length == 2
+              output << "#{colorize('Reason:', :cyan, use_color,
+                                    bold: true)}  #{colorize(parts[0],
+                                                             :yellow, use_color)}"
+              output << "#{' ' * 10}#{colorize("vs.: #{parts[1]}",
+                                               :yellow, use_color)}"
+              return
+            end
+          end
+          output << "#{colorize('Reason:', :cyan, use_color,
+                                bold: true)}  #{colorize(reason_text,
+                                                         :yellow, use_color)}"
+        end
+
+        # Format the Expected/Actual block. Short values (both under 30
+        # chars) are rendered as compact single lines with aligned colons;
+        # longer values use the multi-line layout without a blank line gap.
+        def format_expected_actual(output, detail1, detail2, use_color)
+          plain1 = detail1.gsub(ANSI_ESCAPE, "")
+          plain2 = detail2.gsub(ANSI_ESCAPE, "")
+
+          if plain1.length < COMPACT_DETAIL_MAX &&
+              plain2.length < COMPACT_DETAIL_MAX
+            lbl1 = colorize("\u2296 Expected (File 1)", :red, use_color,
+                            bold: true)
+            lbl2 = colorize("\u2295 Actual (File 2)  ", :green, use_color,
+                            bold: true)
+            output << "#{lbl1}: #{detail1}"
+            output << "#{lbl2}: #{detail2}"
+          else
+            output << colorize("\u2296 Expected (File 1):", :red, use_color,
+                               bold: true)
+            output << "   #{detail1}"
+            output << colorize("\u2295 Actual (File 2):", :green, use_color,
+                               bold: true)
+            output << "   #{detail2}"
+          end
+        end
+
         # Helper: Colorize text
         def colorize(text, color, use_color, bold: false)
           DiffDetailFormatterHelpers::ColorHelper.colorize(text, color,

data/lib/canon/version.rb

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

metadata

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