paper_trail_diff 0.2.0 → 0.3.1

data/sig/generated/paper_trail_diff/live_graph_collector.rbs

@@ -0,0 +1,27 @@
+# Generated from lib/paper_trail_diff/live_graph_collector.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Flattens an already-preloaded, explicitly bounded live association graph.
+  class LiveGraphCollector
+    # : (tree: AssociationTree, traversal: AssociationTraversal) -> void
+    def initialize: (tree: AssociationTree, traversal: AssociationTraversal) -> void
+
+    # : (Array[untyped]) -> Array[untyped]
+    def call: (Array[untyped]) -> Array[untyped]
+
+    private
+
+    @traversal: AssociationTraversal
+
+    @tree: AssociationTree
+
+    # : (Array[untyped], AssociationTree, path: String, into: Hash[Array[untyped], untyped]) -> void
+    def collect: (Array[untyped], AssociationTree, path: String, into: Hash[Array[untyped], untyped]) -> void
+
+    # : (untyped, Array[untyped], AssociationTree, path: String, into: Hash[Array[untyped], untyped]) -> void
+    def collect_group: (untyped, Array[untyped], AssociationTree, path: String, into: Hash[Array[untyped], untyped]) -> void
+
+    # : (Array[untyped], untyped) -> Array[untyped]
+    def children_for: (Array[untyped], untyped) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/paper_trail_adapter.rbs

@@ -3,20 +3,24 @@
 module PaperTrailDiff
   # PaperTrail/ActiveRecord boundary that produces plain record snapshots.
   class PaperTrailAdapter
-    # : (associations: Array[String | Symbol], ignore: ignore_option) -> void
-    def initialize: (associations: Array[String | Symbol], ignore: ignore_option) -> void
+    # : (associations: Array[String | Symbol], ignore: ignore_option, ?reload_live_endpoints: bool) -> void
+    def initialize: (associations: Array[String | Symbol], ignore: ignore_option, ?reload_live_endpoints: bool) -> void
 
     # : (untyped, untyped) -> Diff
     def compare: (untyped, untyped) -> Diff
 
-    # : (untyped, from: untyped, to: untyped) -> Array[Step]
-    def timeline: (untyped, from: untyped, to: untyped) -> Array[Step]
+    # Compares independent pairs and returns immutable results keyed by item identity.
+    # : (Array[comparison_input]) -> comparison_results
+    def compare_many: (Array[comparison_input]) -> comparison_results
 
-    # : (untyped, from: untyped, to: untyped) -> Array[ActivityStep]
-    def activity_timeline: (untyped, from: untyped, to: untyped) -> Array[ActivityStep]
+    # : (untyped, from: untyped, to: untyped, within: untyped) -> Array[Step]
+    def timeline: (untyped, from: untyped, to: untyped, within: untyped) -> Array[Step]
 
-    # : (untyped, from: untyped, to: untyped, ?activity: bool) -> Analysis
-    def analyze: (untyped, from: untyped, to: untyped, ?activity: bool) -> Analysis
+    # : (untyped, from: untyped, to: untyped, within: untyped) -> Array[ActivityStep]
+    def activity_timeline: (untyped, from: untyped, to: untyped, within: untyped) -> Array[ActivityStep]
+
+    # : (untyped, from: untyped, to: untyped, within: untyped, ?activity: bool) -> Analysis
+    def analyze: (untyped, from: untyped, to: untyped, within: untyped, ?activity: bool) -> Analysis
 
     private
 
@@ -28,6 +32,10 @@ module PaperTrailDiff
 
     @ignore_policy: IgnorePolicy
 
+    @instrumentation_payload: Hash[Symbol, untyped]
+
+    @live_endpoints: LiveEndpointProvider
+
     @normalizer: SnapshotNormalizer
 
     @snapshot_pool: SnapshotPool
@@ -42,8 +50,8 @@ module PaperTrailDiff
     # : () -> ActivitySnapshotProvider
     def build_activity_snapshotter: () -> ActivitySnapshotProvider
 
-    # : (untyped, from: untyped, to: untyped) -> ActivityTimelineBuilder
-    def activity_builder: (untyped, from: untyped, to: untyped) -> ActivityTimelineBuilder
+    # : (untyped, from: untyped, to: untyped, within: untyped) -> ActivityTimelineBuilder
+    def activity_builder: (untyped, from: untyped, to: untyped, within: untyped) -> ActivityTimelineBuilder
 
     # : (untyped) -> void
     def reject_live_habtm_activity!: (untyped) -> void
@@ -63,6 +71,9 @@ module PaperTrailDiff
     # : (untyped) -> RecordSnapshot
     def live_snapshot: (untyped) -> RecordSnapshot
 
+    # : (untyped) -> RecordSnapshot
+    def normalize_live_snapshot: (untyped) -> RecordSnapshot
+
     # : (untyped, historical: bool) -> void
     def prepare_traversal!: (untyped, historical: bool) -> void
 

data/sig/generated/paper_trail_diff/preloaded_endpoint_batch_loader.rbs

@@ -0,0 +1,24 @@
+# Generated from lib/paper_trail_diff/preloaded_endpoint_batch_loader.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Validates and reuses caller-owned live records without issuing association queries.
+  class PreloadedEndpointBatchLoader
+    # : (tree: AssociationTree, traversal: AssociationTraversal) -> void
+    def initialize: (tree: AssociationTree, traversal: AssociationTraversal) -> void
+
+    # : (Array[untyped]) -> Hash[identity, untyped]
+    def call: (Array[untyped]) -> Hash[identity, untyped]
+
+    private
+
+    @traversal: AssociationTraversal
+
+    @tree: AssociationTree
+
+    # : (untyped, AssociationTree, path: String) -> void
+    def validate_record: (untyped, AssociationTree, path: String) -> void
+
+    # : (untyped, AssociationTree, String, untyped) -> void
+    def validate_association: (untyped, AssociationTree, String, untyped) -> void
+  end
+end

data/sig/generated/paper_trail_diff/prepared_edge_loader.rbs

@@ -5,8 +5,8 @@ module PaperTrailDiff
   class PreparedEdgeLoader
     EDGE_LOADERS: untyped
 
-    # : (PreparedRecordIndex, Array[untyped]) -> void
-    def initialize: (PreparedRecordIndex, Array[untyped]) -> void
+    # : (PreparedRecordIndex, Array[untyped], ?start_at: untyped) -> void
+    def initialize: (PreparedRecordIndex, Array[untyped], ?start_at: untyped) -> void
 
     # : (untyped, Array[untyped], untyped) -> [Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]]?]
     def call: (untyped, Array[untyped], untyped) -> [ Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]]? ]
@@ -15,6 +15,8 @@ module PaperTrailDiff
 
     @records: PreparedRecordIndex
 
+    @start_at: untyped
+
     @transaction_ids: Array[untyped]
 
     # : (untyped, Array[untyped], untyped) -> [Hash[String, Hash[Symbol, untyped]], nil]
@@ -41,11 +43,17 @@ module PaperTrailDiff
     # : (Array[untyped], untyped) -> Array[untyped]
     def membership_ids: (Array[untyped], untyped) -> Array[untyped]
 
-    # : (untyped, Array[untyped], untyped, String) -> Array[untyped]
-    def historical_child_ids: (untyped, Array[untyped], untyped, String) -> Array[untyped]
+    # : (untyped, Array[untyped], untyped, String) -> Hash[String, Array[untyped]]
+    def historical_child_ids: (untyped, Array[untyped], untyped, String) -> Hash[String, Array[untyped]]
+
+    # : (untyped, Array[untyped], untyped, String) -> untyped
+    def historical_child_relation: (untyped, Array[untyped], untyped, String) -> untyped
+
+    # : (untyped) -> VersionAssociationCandidateScope
+    def child_candidate_scope: (untyped) -> VersionAssociationCandidateScope
 
-    # : (untyped, Array[untyped], untyped, String) -> Array[untyped]
-    def live_child_ids: (untyped, Array[untyped], untyped, String) -> Array[untyped]
+    # : (untyped, Array[untyped], untyped, String) -> Hash[String, Array[untyped]]
+    def live_child_ids: (untyped, Array[untyped], untyped, String) -> Hash[String, Array[untyped]]
 
     # : (untyped, untyped) -> untyped
     def target_class: (untyped, untyped) -> untyped
@@ -53,8 +61,14 @@ module PaperTrailDiff
     # : (Hash[String, Hash[Symbol, untyped]], untyped, untyped) -> void
     def add_identity: (Hash[String, Hash[Symbol, untyped]], untyped, untyped) -> void
 
-    # : (untyped, Array[untyped]) -> Hash[String, Hash[Symbol, untyped]]
-    def group_for: (untyped, Array[untyped]) -> Hash[String, Hash[Symbol, untyped]]
+    # : (untyped, Array[untyped], ?owners: Hash[String, Array[untyped]]?) -> Hash[String, Hash[Symbol, untyped]]
+    def group_for: (untyped, Array[untyped], ?owners: Hash[String, Array[untyped]]?) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (Array[Array[untyped]]) -> Hash[String, Array[untyped]]
+    def group_ids_by_owner: (Array[Array[untyped]]) -> Hash[String, Array[untyped]]
+
+    # : (Hash[String, Array[untyped]], Hash[String, Array[untyped]]) -> Hash[String, Array[untyped]]
+    def merge_owners: (Hash[String, Array[untyped]], Hash[String, Array[untyped]]) -> Hash[String, Array[untyped]]
 
     # : (untyped) -> String?
     def scalar_foreign_key: (untyped) -> String?

data/sig/generated/paper_trail_diff/prepared_history.rbs

@@ -20,6 +20,9 @@ module PaperTrailDiff
     # : (untyped, untyped, Hash[String, Array[untyped]]) -> void
     def register_habtm: (untyped, untyped, Hash[String, Array[untyped]]) -> void
 
+    # : (untyped, untyped, untyped) -> [Hash[untyped, untyped], Hash[untyped, untyped]]?
+    def record_transition: (untyped, untyped, untyped) -> [ Hash[untyped, untyped], Hash[untyped, untyped] ]?
+
     # : (untyped, untyped, untyped, habtm_boundary: untyped) -> [bool, Array[untyped]]
     def resolve: (untyped, untyped, untyped, habtm_boundary: untyped) -> [ bool, Array[untyped] ]
 
@@ -57,6 +60,9 @@ module PaperTrailDiff
     # : (untyped, untyped, untyped) -> Array[untyped]
     def child_records: (untyped, untyped, untyped) -> Array[untyped]
 
+    # : (Hash[Symbol, untyped], untyped) -> Array[untyped]
+    def child_ids_for: (Hash[Symbol, untyped], untyped) -> Array[untyped]
+
     # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
     def habtm_records: (untyped, untyped, untyped, untyped) -> Array[untyped]?
 

data/sig/generated/paper_trail_diff/prepared_history_loader.rbs

@@ -3,8 +3,8 @@
 module PaperTrailDiff
   # Expands the explicit association tree into a request-scoped PreparedHistory.
   class PreparedHistoryLoader
-    # : (untyped, root_versions: Array[untyped], tree: AssociationTree, traversal: AssociationTraversal) -> void
-    def initialize: (untyped, root_versions: Array[untyped], tree: AssociationTree, traversal: AssociationTraversal) -> void
+    # : (untyped, root_versions: Array[untyped], tree: AssociationTree, traversal: AssociationTraversal, ?root_ids: Array[untyped], ?start_at: untyped, ?live_records: Array[untyped]) -> void
+    def initialize: (untyped, root_versions: Array[untyped], tree: AssociationTree, traversal: AssociationTraversal, ?root_ids: Array[untyped], ?start_at: untyped, ?live_records: Array[untyped]) -> void
 
     # : () -> PreparedHistory
     def call: () -> PreparedHistory
@@ -21,6 +21,8 @@ module PaperTrailDiff
 
     @records: PreparedRecordIndex
 
+    @root_ids: Array[untyped]
+
     @traversal: AssociationTraversal
 
     @tree: AssociationTree

data/sig/generated/paper_trail_diff/prepared_record_index.rbs

@@ -3,23 +3,58 @@
 module PaperTrailDiff
   # Immutable scalar state from a PaperTrail version or live-record fallback.
   class PreparedRecordState
+    attr_reader model_class: untyped
+
+    attr_reader attributes: Hash[untyped, untyped]
+
     # : (untyped) -> void
     def initialize: (untyped) -> void
 
+    # : (untyped, Hash[untyped, untyped]) -> PreparedRecordState
+    def self.from_attributes: (untyped, Hash[untyped, untyped]) -> PreparedRecordState
+
     # : () -> untyped
     def instantiate: () -> untyped
 
-    @attributes: Hash[untyped, untyped]
+    private
+
+    # : (untyped, Hash[untyped, untyped]) -> void
+    def initialize_attributes: (untyped, Hash[untyped, untyped]) -> void
+  end
+
+  # Extracts a version's scalar state without constructing a disposable AR object.
+  class PreparedVersionStateLoader
+    # : () -> void
+    def initialize: () -> void
+
+    # : (untyped) -> PreparedRecordState?
+    def call: (untyped) -> PreparedRecordState?
+
+    private
+
+    @attribute_names: Hash[untyped, Array[String]]
+
+    @serializers: Hash[untyped, untyped]
+
+    # : (Hash[untyped, untyped]) -> Hash[String, untyped]
+    def stringify_keys: (Hash[untyped, untyped]) -> Hash[String, untyped]
 
-    @model_class: untyped
+    # : (untyped, Hash[String, untyped]) -> untyped
+    def reification_class: (untyped, Hash[String, untyped]) -> untyped
+
+    # : (untyped, Hash[String, untyped]) -> bool
+    def direct_attributes?: (untyped, Hash[String, untyped]) -> bool
+
+    # : (untyped) -> untyped
+    def object_attribute_serializer: (untyped) -> untyped
   end
 
   # Versions and live fallback for one model identity.
   class PreparedRecordSeries
     attr_reader versions: Array[untyped]
 
-    # : (versions: Array[untyped], live: PreparedRecordState?) -> void
-    def initialize: (versions: Array[untyped], live: PreparedRecordState?) -> void
+    # : (versions: Array[untyped], live: PreparedRecordState?, ?state_loader: PreparedVersionStateLoader) -> void
+    def initialize: (versions: Array[untyped], live: PreparedRecordState?, ?state_loader: PreparedVersionStateLoader) -> void
 
     # : (untyped) -> untyped
     def record_before: (untyped) -> untyped
@@ -27,12 +62,22 @@ module PaperTrailDiff
     # : () -> Array[untyped]
     def records: () -> Array[untyped]
 
+    # : (untyped) -> [Hash[untyped, untyped], Hash[untyped, untyped]]?
+    def transition: (untyped) -> [ Hash[untyped, untyped], Hash[untyped, untyped] ]?
+
     private
 
     @live: PreparedRecordState?
 
+    @state_loader: PreparedVersionStateLoader
+
     @states: Hash[untyped, PreparedRecordState?]
 
+    @version_positions: Hash[String, Integer]
+
+    # : (Integer) -> PreparedRecordState?
+    def state_after: (Integer) -> PreparedRecordState?
+
     # : (untyped, untyped) -> bool
     def eligible?: (untyped, untyped) -> bool
 
@@ -45,8 +90,8 @@ module PaperTrailDiff
 
   # Request-scoped scalar history loaded once per model identity.
   class PreparedRecordIndex
-    # : (untyped) -> void
-    def initialize: (untyped) -> void
+    # : (untyped, ?live_records: Array[untyped]) -> void
+    def initialize: (untyped, ?live_records: Array[untyped]) -> void
 
     # : (untyped, Array[untyped]) -> void
     def load: (untyped, Array[untyped]) -> void
@@ -54,6 +99,9 @@ module PaperTrailDiff
     # : (untyped, untyped, untyped) -> untyped
     def record_before: (untyped, untyped, untyped) -> untyped
 
+    # : (untyped, untyped, untyped) -> [Hash[untyped, untyped], Hash[untyped, untyped]]?
+    def transition: (untyped, untyped, untyped) -> [ Hash[untyped, untyped], Hash[untyped, untyped] ]?
+
     # : (untyped, Array[untyped]) -> Array[untyped]
     def records_for: (untyped, Array[untyped]) -> Array[untyped]
 
@@ -62,10 +110,14 @@ module PaperTrailDiff
 
     private
 
+    @seeded_live_records: Hash[Array[String], untyped]
+
     @series: Hash[Array[String], PreparedRecordSeries]
 
     @start_time: untyped
 
+    @state_loader: PreparedVersionStateLoader
+
     # : (untyped, untyped) -> Array[String]
     def identity: (untyped, untyped) -> Array[String]
 
@@ -78,6 +130,9 @@ module PaperTrailDiff
     # : (untyped, Array[untyped]) -> Array[untyped]
     def versions_for: (untyped, Array[untyped]) -> Array[untyped]
 
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def available_live_records: (untyped, Array[untyped]) -> Array[untyped]
+
     # : (untyped, Array[untyped]) -> Array[untyped]
     def live_records_for: (untyped, Array[untyped]) -> Array[untyped]
   end

data/sig/generated/paper_trail_diff/snapshot.rbs

@@ -26,6 +26,16 @@ module PaperTrailDiff
 
     SUPPORTED_KINDS: untyped
 
+    # Non-semantic memoization shared by structurally adjacent snapshots. The
+    # cached value is derived only from frozen records and is itself immutable.
+    class IdentityIndexCache
+      # : () -> void
+      def initialize: () -> void
+
+      # : (Array[RecordSnapshot]) -> CollectionIdentityIndex
+      def index: (Array[RecordSnapshot]) -> CollectionIdentityIndex
+    end
+
     # : (Symbol) -> bool
     def self.collection_kind?: (Symbol) -> bool
 
@@ -33,11 +43,36 @@ module PaperTrailDiff
 
     attr_reader records: Array[RecordSnapshot]
 
-    # : (kind: Symbol, records: Array[RecordSnapshot]) -> void
-    def initialize: (kind: Symbol, records: Array[RecordSnapshot]) -> void
+    # : (kind: Symbol, records: Array[RecordSnapshot], ?identity_index_cache: untyped, ?transition: CollectionTransition?) -> void
+    def initialize: (kind: Symbol, records: Array[RecordSnapshot], ?identity_index_cache: untyped, ?transition: CollectionTransition?) -> void
+
+    # Builds a structurally adjacent collection snapshot for internal activity carry-forward.
+    # : (Array[RecordSnapshot], before: RecordSnapshot?, after: RecordSnapshot?, membership_preserved: bool) -> AssociationSnapshot
+    def transition_to: (Array[RecordSnapshot], before: RecordSnapshot?, after: RecordSnapshot?, membership_preserved: bool) -> AssociationSnapshot
+
+    # : (AssociationSnapshot) -> CollectionTransition?
+    def transition_from: (AssociationSnapshot) -> CollectionTransition?
+
+    # : (untyped, untyped) -> Integer?
+    def position: (untyped, untyped) -> Integer?
+
+    # : (untyped) -> Integer?
+    def position_for_id: (untyped) -> Integer?
+
+    # : () -> void
+    def validate_unique_identities!: () -> void
 
     # : () -> Hash[Symbol, untyped]
     def to_h: () -> Hash[Symbol, untyped]
+
+    private
+
+    @identity_index_cache: untyped
+
+    @transition: CollectionTransition?
+
+    # : () -> CollectionIdentityIndex
+    def identity_index: () -> CollectionIdentityIndex
   end
 
   # An immutable, ActiveRecord-independent representation of a reified record.

data/sig/generated/paper_trail_diff/support.rbs

@@ -21,9 +21,15 @@ module PaperTrailDiff
     # : (String, String) -> String
     def self?.association_path: (String, String) -> String
 
+    # : (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+    def self?.merge_record_groups: (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+
     # : (untyped) -> untyped
     def self?.duplicate_and_freeze: (untyped) -> untyped
 
+    # : (Hash[String, Array[untyped]]?, Hash[String, Array[untyped]]?) -> Hash[String, Array[untyped]]?
+    def self?.merge_record_owners: (Hash[String, Array[untyped]]?, Hash[String, Array[untyped]]?) -> Hash[String, Array[untyped]]?
+
     # : (untyped) -> bool
     def self?.paper_trail_diff_value?: (untyped) -> bool
   end

data/sig/generated/paper_trail_diff/time_activity_timeline_builder.rbs

@@ -0,0 +1,46 @@
+# Generated from lib/paper_trail_diff/time_activity_timeline_builder.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Builds activity views for mutations selected by a wall-clock range.
+  class TimeActivityTimelineBuilder
+    # : (untyped, range: TimelineRange, tree: AssociationTree, snapshotter: untyped) -> void
+    def initialize: (untyped, range: TimelineRange, tree: AssociationTree, snapshotter: untyped) -> void
+
+    # : () -> Array[ActivityStep]
+    def build: () -> Array[ActivityStep]
+
+    # : () -> Analysis
+    def analyze: () -> Analysis
+
+    private
+
+    @range: TimelineRange
+
+    @record: untyped
+
+    @snapshotter: untyped
+
+    @tree: AssociationTree
+
+    # : () -> [ActivityHistory, Array[untyped]]
+    def history_and_versions: () -> [ ActivityHistory, Array[untyped] ]
+
+    # : (Array[untyped]) -> void
+    def prepare_history: (Array[untyped]) -> void
+
+    # : (Array[untyped]) -> Array[ActivityEvent]
+    def collect_events: (Array[untyped]) -> Array[ActivityEvent]
+
+    # : (Array[ActivityEvent]) -> bool
+    def time_events?: (Array[ActivityEvent]) -> bool
+
+    # : (ActivityEvent, Array[ActivityEvent]) -> bool
+    def later_event?: (ActivityEvent, Array[ActivityEvent]) -> bool
+
+    # : (Array[untyped], Hash[Array[untyped], RecordSnapshot?]) -> Array[Step]
+    def root_steps: (Array[untyped], Hash[Array[untyped], RecordSnapshot?]) -> Array[Step]
+
+    # : (untyped) -> Array[untyped]
+    def version_key: (untyped) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/time_range.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/time_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Validates and applies a finite wall-clock range without loading model state.
+  class TimeRange
+    attr_reader begin_time: Time
+
+    attr_reader end_time: Time
+
+    # : (untyped) -> void
+    def initialize: (untyped) -> void
+
+    # : () -> bool
+    def exclude_end?: () -> bool
+
+    # : (untyped) -> bool
+    def include?: (untyped) -> bool
+
+    # : (untyped) -> untyped
+    def scope: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def trailing_scope: (untyped) -> untyped
+
+    private
+
+    @exclude_end: bool
+
+    # : () -> Range[Time]
+    def query_range: () -> Range[Time]
+
+    # : (untyped, boundary: Symbol) -> Time
+    def coerce_time: (untyped, boundary: Symbol) -> Time
+
+    # : (untyped) -> Time
+    def time_value: (untyped) -> Time
+
+    # : () -> void
+    def validate_order!: () -> void
+  end
+end

data/sig/generated/paper_trail_diff/time_version_range.rbs

@@ -0,0 +1,27 @@
+# Generated from lib/paper_trail_diff/time_version_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Selects in-range root versions plus one later reconstruction boundary.
+  class TimeVersionRange
+    # : (untyped, time_range: TimeRange) -> void
+    def initialize: (untyped, time_range: TimeRange) -> void
+
+    # : (?context_required: bool) -> Array[untyped]
+    def select: (?context_required: bool) -> Array[untyped]
+
+    private
+
+    @record: untyped
+
+    @time_range: TimeRange
+
+    # : () -> untyped
+    def versions_relation: () -> untyped
+
+    # : (untyped) -> untyped
+    def trailing_version: (untyped) -> untyped
+
+    # : (Array[untyped]) -> Array[untyped]
+    def ordered: (Array[untyped]) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/timeline_builder.rbs

@@ -3,8 +3,8 @@
 module PaperTrailDiff
   # Selects and compares a chronological slice of a record's version history.
   class TimelineBuilder
-    # : (untyped, from: untyped, to: untyped, snapshotter: untyped) -> void
-    def initialize: (untyped, from: untyped, to: untyped, snapshotter: untyped) -> void
+    # : (untyped, from: untyped, to: untyped, snapshotter: untyped, ?within: untyped) -> void
+    def initialize: (untyped, from: untyped, to: untyped, snapshotter: untyped, ?within: untyped) -> void
 
     # : () -> Array[Step]
     def build: () -> Array[Step]
@@ -14,17 +14,18 @@ module PaperTrailDiff
 
     private
 
-    @from: untyped
+    @range: TimelineRange
 
     @record: untyped
 
     @snapshotter: untyped
 
-    @to: untyped
-
     # : (Array[untyped]) -> [Array[Step], RecordSnapshot?, RecordSnapshot?]
     def compare_history: (Array[untyped]) -> [ Array[Step], RecordSnapshot?, RecordSnapshot? ]
 
+    # : () -> [Array[Step], nil, nil]
+    def empty_history: () -> [ Array[Step], nil, nil ]
+
     # : () -> Array[untyped]
     def selected_versions: () -> Array[untyped]
   end

data/sig/generated/paper_trail_diff/timeline_range.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/timeline_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Chooses explicit-version or wall-clock selection for one timeline request.
+  class TimelineRange
+    attr_reader from: untyped
+
+    attr_reader to: untyped
+
+    attr_reader time_range: TimeRange?
+
+    # : (untyped, from: untyped, to: untyped, within: untyped) -> void
+    def initialize: (untyped, from: untyped, to: untyped, within: untyped) -> void
+
+    # : (?context_required: bool) -> Array[untyped]
+    def select: (?context_required: bool) -> Array[untyped]
+
+    # : () -> bool
+    def time?: () -> bool
+
+    # : () -> Time?
+    def begin_time: () -> Time?
+
+    # : (untyped) -> bool
+    def include?: (untyped) -> bool
+
+    private
+
+    @from: untyped
+
+    @record: untyped
+
+    @to: untyped
+
+    # : (untyped) -> TimeRange?
+    def build_time_range: (untyped) -> TimeRange?
+
+    # : () -> void
+    def validate_mode!: () -> void
+  end
+end

data/sig/generated/paper_trail_diff/version_association_candidate_scope.rbs

@@ -0,0 +1,32 @@
+# Generated from lib/paper_trail_diff/version_association_candidate_scope.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Selects association activity from a boundary forward plus the state at that boundary.
+  class VersionAssociationCandidateScope
+    # : (untyped, untyped, ?end_at: untyped) -> void
+    def initialize: (untyped, untyped, ?end_at: untyped) -> void
+
+    # : (untyped) -> untyped
+    def call: (untyped) -> untyped
+
+    private
+
+    @end_at: untyped
+
+    @start_at: untyped
+
+    @version_class: untyped
+
+    # : () -> String
+    def candidate_condition: () -> String
+
+    # : (String, String) -> String
+    def activity_condition: (String, String) -> String
+
+    # : (String, String) -> String
+    def column: (String, String) -> String
+
+    # : (String) -> String
+    def compact_sql: (String) -> String
+  end
+end