porrima 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12e94d3fff8b491f17f5cb13beb41d396496816c54995c16be69b3aebdba875f
-  data.tar.gz: df24fab43b8358f2fcc522b548a1ead14ef53faf365a6601d0bc10c3a798aeed
+  metadata.gz: 9cb36f8d5f52c2bd1c4ec9b43223de3fea75b17b4059402ce5659fc14bc5fe9e
+  data.tar.gz: 68e095935908555e20d8f76f4a4eaa559a7ebd909be5c72d074e6bce9ab84f45
 SHA512:
-  metadata.gz: 24a68e804a09990a553b353e9ca2c547f64ca72cb382a121212ee1222f44b75d17b0ed07ca499a4200539279d245484723e602b43a3bb1972c51cbd86251b81c
-  data.tar.gz: b61f20f0ea9d25c231e30b1efd01a91152f7e3e76bd69edd3dec00c634c27123fcb15c9d2e4c66a33f35a2207d0b0c72d800cc2c605578ca42b15823a975824c
+  metadata.gz: 8ec0cc6a0a47b1cd2570d33377fee475a3c45e3f787d67e598ef19bedace1a99624fc4ad1e7771f7fe338c6fa6a82092db7d76304155d4069209f9a344b387f2
+  data.tar.gz: e7a8308c5d1829640d1db2fb6fee7497140201968cc7e0ebcab5e066bd657ce1f512e5fa9d76bfdf059919d8142879665fad76d1407b8d47d4d5ddd4af7fa212

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.0 — 2026-09-24
+
+- Add sparse cell and ordered slide difference APIs without application dependencies.
+
+## 0.2.1 — 2026-09-21
+
+- Add a deterministic side-by-side diff demo image and regeneration task.
+
 ## 0.2.0 — 2026-09-15
 
 - Add zero-based merge output regions for conflict marker blocks.

data/README.md

@@ -26,12 +26,15 @@ Porrima turns two or three texts into structured edits, hunks, patches, and
 merge conflicts. Its core performs no I/O, knows nothing about Git, and leaves
 color, width, truncation, caching, and other display policy to the caller.
 
+![Porrima side-by-side diff](docs/media/screenshot.png)
+
 ## Features
 
 - Linear-space Myers diff for lines and inline word or character refinement
 - Context hunks, change statistics, gutter marks, and paired rows
 - Unified diff output with strict patch parsing, application, and reversal
 - Three-way merge with structured conflicts, output regions, and immutable resolution
+- Sparse sheet cell changes and ordered slide changes without application dependencies
 - CLI output as unified text or JSON
 - No runtime dependencies
 
@@ -71,6 +74,31 @@ puts diff.to_unified(old_name: "a/example", new_name: "b/example")
 | `Porrima::Inline.refine(before, after)` | Word- or character-level spans |
 | `Porrima::Patch.parse(text)` | Parsed unified file diffs |
 | `Porrima::Merge.three_way(...)` | Structured three-way merge result |
+| `Porrima::Structured.sheet(before, after)` | Changed cells in row/column order |
+| `Porrima::Structured.slides(before, after)` | Added, removed, or modified slide positions |
+
+### Structured data
+
+`Structured.sheet` accepts sparse sheets with `row_count`, `column_count`, and
+`each_in(top, left, bottom, right)`, such as `Denebola::Sheet` returned by
+`Rukbat::Workbook#sheet`. It returns only changed cells, with zero-based
+`row` and `column`, `kind`, `before`, and `after`. A missing cell is `nil`.
+
+`Structured.slides` accepts two ordered arrays. Pass a block to compare a
+projection of each slide, while the results retain the original slide values:
+
+```ruby
+before = old_deck.slides
+after = new_deck.slides
+changes = Porrima::Structured.slides(before, after) do |slide|
+  [slide.layout, slide.slots.transform_values(&:text), slide.notes]
+end
+```
+
+Each change has `kind`, zero-based `old_index`/`new_index`, and `before`/`after`.
+An absent side has a `nil` index and value. Choose a projection that includes
+everything relevant to your comparison; for exact Markdown changes, compare
+the decks' source text with `Porrima.diff`.
 
 ### Diff result
 

data/lib/porrima/structured.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Porrima
+  module Structured
+    CellChange = Struct.new(:kind, :row, :column, :before, :after, keyword_init: true)
+    SlideChange = Struct.new(:kind, :old_index, :new_index, :before, :after, keyword_init: true)
+
+    module_function
+
+    # Coordinates are zero-based, matching the sparse sheet's each_in points.
+    def sheet(before, after)
+      old_cells = cells(before)
+      new_cells = cells(after)
+      (old_cells.keys | new_cells.keys).sort.filter_map do |row, column|
+        position = [row, column]
+        old_present = old_cells.key?(position)
+        new_present = new_cells.key?(position)
+        old_value = old_cells[position]
+        new_value = new_cells[position]
+        next if old_present && new_present && old_value == new_value
+
+        kind = old_present ? (new_present ? :modified : :removed) : :added
+        CellChange.new(kind: kind, row: row, column: column, before: old_value, after: new_value).freeze
+      end.freeze
+    end
+
+    # The block selects the content used to align slides. Without it, values
+    # themselves are compared. Positions are zero-based, matching Deck#slide.
+    def slides(before, after, &identity)
+      identity ||= ->(slide) { slide }
+      ids = {}
+      old_ids = slide_ids(before, ids, identity)
+      new_ids = slide_ids(after, ids, identity)
+      Porrima.diff(old_ids, new_ids).rows.filter_map do |row|
+        next if row.kind == :equal
+
+        old_index = row.old_line && row.old_line - 1
+        new_index = row.new_line && row.new_line - 1
+        SlideChange.new(kind: row.kind, old_index: old_index, new_index: new_index,
+          before: old_index && before[old_index], after: new_index && after[new_index]).freeze
+      end.freeze
+    end
+
+    def cells(sheet)
+      entries = {}
+      return entries if sheet.row_count.zero? || sheet.column_count.zero?
+
+      sheet.each_in(0, 0, sheet.row_count - 1, sheet.column_count - 1) do |point, value|
+        entries[[point.row, point.column]] = value
+      end
+      entries
+    end
+    private_class_method :cells
+
+    def slide_ids(slides, ids, identity)
+      slides.map { |slide| ids[identity.call(slide)] ||= ids.length.to_s }
+    end
+    private_class_method :slide_ids
+  end
+end

data/lib/porrima/version.rb

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

data/lib/porrima.rb

@@ -11,6 +11,7 @@ require_relative "porrima/diff"
 require_relative "porrima/patch"
 require_relative "porrima/inline"
 require_relative "porrima/merge"
+require_relative "porrima/structured"
 
 module Porrima
   module_function

data/sig/porrima.rbs

@@ -134,6 +134,27 @@ module Porrima
     def self.conflict_inline: (Conflict) -> { ours: Array[Span], theirs: Array[Span] }
   end
 
+  module Structured
+    class CellChange < Struct[untyped]
+      attr_accessor kind: :added | :modified | :removed
+      attr_accessor row: Integer
+      attr_accessor column: Integer
+      attr_accessor before: untyped
+      attr_accessor after: untyped
+      def self.new: (kind: (:added | :modified | :removed), row: Integer, column: Integer, before: untyped, after: untyped) -> instance
+    end
+    class SlideChange < Struct[untyped]
+      attr_accessor kind: :added | :modified | :removed
+      attr_accessor old_index: Integer?
+      attr_accessor new_index: Integer?
+      attr_accessor before: untyped
+      attr_accessor after: untyped
+      def self.new: (kind: (:added | :modified | :removed), old_index: Integer?, new_index: Integer?, before: untyped, after: untyped) -> instance
+    end
+    def self.sheet: (untyped before, untyped after) -> Array[CellChange]
+    def self.slides: (Array[untyped] before, Array[untyped] after) ?{ (untyped) -> untyped } -> Array[SlideChange]
+  end
+
   def self.diff: (lines, lines, ?context: Integer, ?budget: Budget?) -> Diff
   def self.edits: (lines, lines, ?budget: Budget?) -> Array[Edit]
   def self.hunks: (lines, lines, ?context: Integer, ?budget: Budget?) -> Array[Hunk]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: porrima
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -34,6 +34,7 @@ files:
 - lib/porrima/merge.rb
 - lib/porrima/myers.rb
 - lib/porrima/patch.rb
+- lib/porrima/structured.rb
 - lib/porrima/unified.rb
 - lib/porrima/version.rb
 - sig/porrima.rbs