paper_trail_diff 0.4.0 → 0.5.0

data/sig/generated/paper_trail_diff/traversal_preparer.rbs

@@ -0,0 +1,22 @@
+# Generated from lib/paper_trail_diff/traversal_preparer.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Checks that a model can be traversed before any reconstruction starts, and
+  # that association tracking is actually available when history is involved.
+  class TraversalPreparer
+    # : (tree: AssociationTree, traversal: AssociationTraversal) -> void
+    def initialize: (tree: AssociationTree, traversal: AssociationTraversal) -> void
+
+    # : (untyped, historical: bool) -> void
+    def call: (untyped, historical: bool) -> void
+
+    private
+
+    @traversal: AssociationTraversal
+
+    @tree: AssociationTree
+
+    # : () -> void
+    def ensure_association_tracking!: () -> void
+  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
@@ -19,13 +21,21 @@ module PaperTrailDiff
   def self.timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> 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) -> Array[ActivityStep]
+  def self.activity_timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> 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
 
+  # 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) -> Hash[identity, Analysis]
+  def self.analyze_many: (Array[untyped], ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Hash[identity, Analysis]
+
   # Returns the association macros this release can normalize.
   # : () -> Array[Symbol]
   def self.supported_association_macros: () -> 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.5.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
@@ -106,6 +110,7 @@ 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
@@ -133,9 +138,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
@@ -174,6 +183,7 @@ 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
@@ -184,11 +194,11 @@ licenses:
 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.5.0/CHANGELOG.md
+  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.5.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.5.0
 rdoc_options: []
 require_paths:
 - lib