paper_trail_diff 0.4.0 → 0.6.0

data/sig/generated/paper_trail_diff/version_scope_filter.rbs

@@ -0,0 +1,22 @@
+# Generated from lib/paper_trail_diff/version_scope_filter.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies a caller's version filter to a range, naming which of its versions
+  # count as selected mutations. The unfiltered versions stay available to the
+  # caller, because the one that reveals the last selected mutation is drawn
+  # from them.
+  class VersionScopeFilter
+    # : (untyped) -> void
+    def initialize: (untyped) -> void
+
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def call: (untyped, Array[untyped]) -> Array[untyped]
+
+    private
+
+    @scope: untyped
+
+    # : (untyped) -> untyped
+    def validated: (untyped) -> untyped
+  end
+end

data/sig/generated/paper_trail_diff.rbs

@@ -1,7 +1,9 @@
 # Generated from lib/paper_trail_diff.rb with RBS::Inline
 
-# Structured version comparison for PaperTrail.
+# Structured version comparison for PaperTrail. Each method is a thin,
+# documented entry point, so this reads as an API listing rather than logic.
 module PaperTrailDiff
+  # rubocop:disable Metrics/ModuleLength
   DEFAULT_IGNORED_ATTRIBUTES: untyped
 
   SUPPORTED_ASSOCIATION_MACROS: untyped
@@ -15,16 +17,24 @@ module PaperTrailDiff
   def self.compare_many: (Array[comparison_input], ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> comparison_results
 
   # Compares every adjacent reconstructed state in an inclusive version range.
-  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
-  def self.timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?version_scope: untyped) -> Array[Step]
+  def self.timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?version_scope: untyped) -> Array[Step]
 
   # Compares adjacent root and selected-descendant activity boundaries.
-  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
-  def self.activity_timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
+  # `reload_live_endpoints:` applies only when `to:` is a current record; the
+  # other range forms never read live state.
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool, ?version_scope: untyped) -> Array[ActivityStep]
+  def self.activity_timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool, ?version_scope: untyped) -> Array[ActivityStep]
 
   # Builds an endpoint diff and root-checkpoint timeline while normalizing each version once.
-  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
-  def self.analyze: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool, ?version_scope: untyped) -> Analysis
+  def self.analyze: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool, ?version_scope: untyped) -> Analysis
+
+  # Analyzes many roots over one shared time window, preparing their selected
+  # history once for the batch instead of once per record. Roots with no
+  # versions in the window return an empty `Analysis`.
+  # : (Array[untyped], ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool, ?version_scope: untyped) -> Hash[identity, Analysis]
+  def self.analyze_many: (Array[untyped], ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool, ?version_scope: untyped) -> Hash[identity, Analysis]
 
   # Returns the association macros this release can normalize.
   # : () -> Array[Symbol]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paper_trail_diff
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Alex Williams
@@ -65,9 +65,13 @@ files:
 - lib/paper_trail_diff/activity_timeline_builder.rb
 - lib/paper_trail_diff/activity_version_collector.rb
 - lib/paper_trail_diff/analysis.rb
+- lib/paper_trail_diff/analysis_batch.rb
 - lib/paper_trail_diff/association_diff_traversal.rb
 - lib/paper_trail_diff/association_discovery.rb
 - lib/paper_trail_diff/association_traversal.rb
+- lib/paper_trail_diff/batch_boundary_resolver.rb
+- lib/paper_trail_diff/batched_root_analyzer.rb
+- lib/paper_trail_diff/batched_root_versions.rb
 - lib/paper_trail_diff/branch_snapshot_refresher.rb
 - lib/paper_trail_diff/collection_comparator.rb
 - lib/paper_trail_diff/collection_identity_index.rb
@@ -92,6 +96,8 @@ files:
 - lib/paper_trail_diff/prepared_history.rb
 - lib/paper_trail_diff/prepared_history_loader.rb
 - lib/paper_trail_diff/prepared_record_index.rb
+- lib/paper_trail_diff/root_version_plan.rb
+- lib/paper_trail_diff/root_version_selection.rb
 - lib/paper_trail_diff/snapshot.rb
 - lib/paper_trail_diff/snapshot_normalizer.rb
 - lib/paper_trail_diff/snapshot_traversal.rb
@@ -106,10 +112,12 @@ files:
 - lib/paper_trail_diff/traversal.rb
 - lib/paper_trail_diff/traversal_emitter.rb
 - lib/paper_trail_diff/traversal_entry.rb
+- lib/paper_trail_diff/traversal_preparer.rb
 - lib/paper_trail_diff/value_objects.rb
 - lib/paper_trail_diff/version.rb
 - lib/paper_trail_diff/version_association_candidate_scope.rb
 - lib/paper_trail_diff/version_range.rb
+- lib/paper_trail_diff/version_scope_filter.rb
 - sig/generated/paper_trail_diff.rbs
 - sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs
 - sig/generated/paper_trail_diff/activity_boundary.rbs
@@ -133,9 +141,13 @@ files:
 - sig/generated/paper_trail_diff/activity_timeline_builder.rbs
 - sig/generated/paper_trail_diff/activity_version_collector.rbs
 - sig/generated/paper_trail_diff/analysis.rbs
+- sig/generated/paper_trail_diff/analysis_batch.rbs
 - sig/generated/paper_trail_diff/association_diff_traversal.rbs
 - sig/generated/paper_trail_diff/association_discovery.rbs
 - sig/generated/paper_trail_diff/association_traversal.rbs
+- sig/generated/paper_trail_diff/batch_boundary_resolver.rbs
+- sig/generated/paper_trail_diff/batched_root_analyzer.rbs
+- sig/generated/paper_trail_diff/batched_root_versions.rbs
 - sig/generated/paper_trail_diff/branch_snapshot_refresher.rbs
 - sig/generated/paper_trail_diff/collection_comparator.rbs
 - sig/generated/paper_trail_diff/collection_identity_index.rbs
@@ -160,6 +172,8 @@ files:
 - sig/generated/paper_trail_diff/prepared_history.rbs
 - sig/generated/paper_trail_diff/prepared_history_loader.rbs
 - sig/generated/paper_trail_diff/prepared_record_index.rbs
+- sig/generated/paper_trail_diff/root_version_plan.rbs
+- sig/generated/paper_trail_diff/root_version_selection.rbs
 - sig/generated/paper_trail_diff/snapshot.rbs
 - sig/generated/paper_trail_diff/snapshot_normalizer.rbs
 - sig/generated/paper_trail_diff/snapshot_traversal.rbs
@@ -174,21 +188,23 @@ files:
 - sig/generated/paper_trail_diff/traversal.rbs
 - sig/generated/paper_trail_diff/traversal_emitter.rbs
 - sig/generated/paper_trail_diff/traversal_entry.rbs
+- sig/generated/paper_trail_diff/traversal_preparer.rbs
 - sig/generated/paper_trail_diff/value_objects.rbs
 - sig/generated/paper_trail_diff/version.rbs
 - sig/generated/paper_trail_diff/version_association_candidate_scope.rbs
 - sig/generated/paper_trail_diff/version_range.rbs
+- sig/generated/paper_trail_diff/version_scope_filter.rbs
 homepage: https://github.com/aheathwilliams/paper_trail_diff
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/aheathwilliams/paper_trail_diff/issues
-  changelog_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.4.0/CHANGELOG.md
-  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.4.0/README.md
+  changelog_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.6.0/CHANGELOG.md
+  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.6.0/README.md
   homepage_uri: https://github.com/aheathwilliams/paper_trail_diff
   rubygems_mfa_required: 'true'
-  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.4.0
+  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.6.0
 rdoc_options: []
 require_paths:
 - lib