paper_trail_diff 0.1.0

data/sig/generated/paper_trail_diff/prepared_edge_loader.rbs

@@ -0,0 +1,65 @@
+# Generated from lib/paper_trail_diff/prepared_edge_loader.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Loads every historical identity that can participate in one association edge.
+  class PreparedEdgeLoader
+    EDGE_LOADERS: untyped
+
+    # : (PreparedRecordIndex, Array[untyped]) -> void
+    def initialize: (PreparedRecordIndex, Array[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]]? ]
+
+    private
+
+    @records: PreparedRecordIndex
+
+    @transaction_ids: Array[untyped]
+
+    # : (untyped, Array[untyped], untyped) -> [Hash[String, Hash[Symbol, untyped]], nil]
+    def belongs_to_edge: (untyped, Array[untyped], untyped) -> [ Hash[String, Hash[Symbol, untyped]], nil ]
+
+    # : (untyped, Array[untyped], untyped) -> [Hash[String, Hash[Symbol, untyped]], nil]
+    def child_edge: (untyped, Array[untyped], untyped) -> [ Hash[String, Hash[Symbol, untyped]], nil ]
+
+    # : (untyped, Array[untyped], untyped) -> [Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]]]
+    def habtm_edge: (untyped, Array[untyped], untyped) -> [ Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]] ]
+
+    # : (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def belongs_to_groups: (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def child_groups: (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, untyped) -> [Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]]]
+    def habtm_groups: (untyped, untyped) -> [ Hash[String, Hash[Symbol, untyped]], Hash[String, Array[untyped]] ]
+
+    # : (untyped, untyped) -> Array[untyped]
+    def habtm_rows: (untyped, untyped) -> Array[untyped]
+
+    # : (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) -> Array[untyped]
+    def live_child_ids: (untyped, Array[untyped], untyped, String) -> Array[untyped]
+
+    # : (untyped, untyped) -> untyped
+    def target_class: (untyped, untyped) -> untyped
+
+    # : (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) -> String?
+    def scalar_foreign_key: (untyped) -> String?
+
+    # : (untyped) -> Array[String?]
+    def parent_types: (untyped) -> Array[String?]
+  end
+end

data/sig/generated/paper_trail_diff/prepared_history.rbs

@@ -0,0 +1,93 @@
+# Generated from lib/paper_trail_diff/prepared_history.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Batched record states and relationship candidates for one activity range.
+  class PreparedHistory
+    DIRECT_RESOLVERS: untyped
+
+    # : (PreparedRecordIndex) -> void
+    def initialize: (PreparedRecordIndex) -> void
+
+    # : (untyped, untyped, Hash[String, Hash[Symbol, untyped]]) -> void
+    def merge_edge: (untyped, untyped, Hash[String, Hash[Symbol, untyped]]) -> void
+
+    # : (untyped, untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def edge: (untyped, untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, untyped) -> void
+    def mark_unsupported: (untyped, untyped) -> void
+
+    # : (untyped, untyped, Hash[String, Array[untyped]]) -> void
+    def register_habtm: (untyped, untyped, Hash[String, Array[untyped]]) -> void
+
+    # : (untyped, untyped, untyped, habtm_boundary: untyped) -> [bool, Array[untyped]]
+    def resolve: (untyped, untyped, untyped, habtm_boundary: untyped) -> [ bool, Array[untyped] ]
+
+    private
+
+    @edges: Hash[Array[String], Hash[String, Hash[Symbol, untyped]]]
+
+    @habtm: Hash[Array[String], Hash[String, Array[untyped]]]
+
+    @records: PreparedRecordIndex
+
+    @unsupported: Hash[Array[String], bool]
+
+    # : (untyped, untyped) -> bool
+    def supported?: (untyped, untyped) -> bool
+
+    # : (untyped) -> bool
+    def default_scoped?: (untyped) -> bool
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
+    def direct_records: (untyped, untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
+    def resolve_belongs_to: (untyped, untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]
+    def resolve_children: (untyped, untyped, untyped, untyped) -> Array[untyped]
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
+    def resolve_habtm: (untyped, untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (untyped, untyped, untyped) -> Array[untyped]?
+    def belongs_to_records: (untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (untyped, untyped, untyped) -> Array[untyped]
+    def child_records: (untyped, untyped, untyped) -> Array[untyped]
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
+    def habtm_records: (untyped, untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (untyped, untyped, untyped, untyped) -> Array[untyped]?
+    def through_records: (untyped, untyped, untyped, untyped) -> Array[untyped]?
+
+    # : (Array[untyped], untyped, untyped, untyped) -> Array[[bool, Array[untyped]]]
+    def resolve_sources: (Array[untyped], untyped, untyped, untyped) -> Array[[ bool, Array[untyped] ]]
+
+    # : (untyped, untyped, untyped) -> bool
+    def member_of?: (untyped, untyped, untyped) -> bool
+
+    # : (untyped) -> String?
+    def scalar_foreign_key: (untyped) -> String?
+
+    # : (untyped, untyped) -> untyped
+    def belongs_to_class: (untyped, untyped) -> untyped
+
+    # : (untyped, untyped) -> Array[String]
+    def owner_types: (untyped, untyped) -> Array[String]
+
+    # : (untyped) -> untyped
+    def transaction_id_for: (untyped) -> untyped
+
+    # : (Array[untyped]) -> Array[untyped]
+    def unique_records: (Array[untyped]) -> Array[untyped]
+
+    # : (untyped, untyped) -> Array[String]
+    def edge_key: (untyped, untyped) -> Array[String]
+
+    # : (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+    def merge_groups: (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+  end
+end

data/sig/generated/paper_trail_diff/prepared_history_loader.rbs

@@ -0,0 +1,67 @@
+# Generated from lib/paper_trail_diff/prepared_history_loader.rb with RBS::Inline
+
+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
+
+    # : () -> PreparedHistory
+    def call: () -> PreparedHistory
+
+    private
+
+    @edges: PreparedEdgeLoader
+
+    @history: PreparedHistory
+
+    @prepared: Hash[Array[String], Array[String]]
+
+    @record: untyped
+
+    @records: PreparedRecordIndex
+
+    @traversal: AssociationTraversal
+
+    @tree: AssociationTree
+
+    # : (untyped, Array[untyped], AssociationTree, path: String) -> void
+    def load_node: (untyped, Array[untyped], AssociationTree, path: String) -> void
+
+    # : (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def prepare_reflection: (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def prepare_through: (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+    def prepare_edge: (untyped, Array[untyped], untyped) -> Hash[String, Hash[Symbol, untyped]]
+
+    # : (untyped, Array[untyped], untyped) -> Array[untyped]
+    def unprepared_ids: (untyped, Array[untyped], untyped) -> Array[untyped]
+
+    # : (untyped, Array[untyped], untyped) -> void
+    def mark_prepared: (untyped, Array[untyped], untyped) -> void
+
+    # : (untyped, untyped, Hash[String, Hash[Symbol, untyped]]) -> void
+    def mark_unsupported: (untyped, untyped, Hash[String, Hash[Symbol, untyped]]) -> void
+
+    # : (untyped) -> bool
+    def deferred_macro?: (untyped) -> bool
+
+    # : (Hash[String, Hash[Symbol, untyped]]) -> void
+    def load_groups: (Hash[String, Hash[Symbol, untyped]]) -> void
+
+    # : (untyped, Array[untyped]) -> void
+    def load_records: (untyped, Array[untyped]) -> void
+
+    # : (untyped) -> bool
+    def versioned?: (untyped) -> bool
+
+    # : (untyped, untyped) -> Array[String]
+    def edge_key: (untyped, untyped) -> Array[String]
+
+    # : (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+    def merge_groups: (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+  end
+end

data/sig/generated/paper_trail_diff/prepared_record_index.rbs

@@ -0,0 +1,84 @@
+# Generated from lib/paper_trail_diff/prepared_record_index.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Immutable scalar state from a PaperTrail version or live-record fallback.
+  class PreparedRecordState
+    # : (untyped) -> void
+    def initialize: (untyped) -> void
+
+    # : () -> untyped
+    def instantiate: () -> untyped
+
+    @attributes: Hash[untyped, untyped]
+
+    @model_class: 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
+
+    # : (untyped) -> untyped
+    def record_before: (untyped) -> untyped
+
+    # : () -> Array[untyped]
+    def records: () -> Array[untyped]
+
+    private
+
+    @live: PreparedRecordState?
+
+    @states: Hash[untyped, PreparedRecordState?]
+
+    # : (untyped, untyped) -> bool
+    def eligible?: (untyped, untyped) -> bool
+
+    # : (untyped, untyped) -> bool
+    def same_transaction?: (untyped, untyped) -> bool
+
+    # : (untyped) -> PreparedRecordState?
+    def state_for: (untyped) -> PreparedRecordState?
+  end
+
+  # Request-scoped scalar history loaded once per model identity.
+  class PreparedRecordIndex
+    # : (untyped) -> void
+    def initialize: (untyped) -> void
+
+    # : (untyped, Array[untyped]) -> void
+    def load: (untyped, Array[untyped]) -> void
+
+    # : (untyped, untyped, untyped) -> untyped
+    def record_before: (untyped, untyped, untyped) -> untyped
+
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def records_for: (untyped, Array[untyped]) -> Array[untyped]
+
+    # : (untyped, untyped) -> bool
+    def loaded?: (untyped, untyped) -> bool
+
+    private
+
+    @series: Hash[Array[String], PreparedRecordSeries]
+
+    @start_time: untyped
+
+    # : (untyped, untyped) -> Array[String]
+    def identity: (untyped, untyped) -> Array[String]
+
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def missing_ids: (untyped, Array[untyped]) -> Array[untyped]
+
+    # : (untyped, untyped, Hash[String, Array[untyped]], Hash[String, untyped]) -> void
+    def add_series: (untyped, untyped, Hash[String, Array[untyped]], Hash[String, untyped]) -> void
+
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def versions_for: (untyped, Array[untyped]) -> Array[untyped]
+
+    # : (untyped, Array[untyped]) -> Array[untyped]
+    def live_records_for: (untyped, Array[untyped]) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/snapshot.rbs

@@ -0,0 +1,69 @@
+# Generated from lib/paper_trail_diff/snapshot.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Immutable identity shared by snapshots and stable-record changes.
+  class RecordReference
+    attr_reader type: String
+
+    attr_reader id: untyped
+
+    # : (type: String, id: untyped) -> void
+    def initialize: (type: String, id: untyped) -> void
+
+    # : (reference_key) -> untyped
+    def []: (reference_key) -> untyped
+
+    # : (reference_key) -> untyped
+    def fetch: (reference_key) -> untyped
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # A normalized association in a bounded record snapshot tree.
+  class AssociationSnapshot
+    COLLECTION_KINDS: untyped
+
+    SUPPORTED_KINDS: untyped
+
+    # : (Symbol) -> bool
+    def self.collection_kind?: (Symbol) -> bool
+
+    attr_reader kind: Symbol
+
+    attr_reader records: Array[RecordSnapshot]
+
+    # : (kind: Symbol, records: Array[RecordSnapshot]) -> void
+    def initialize: (kind: Symbol, records: Array[RecordSnapshot]) -> void
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # An immutable, ActiveRecord-independent representation of a reified record.
+  class RecordSnapshot
+    attr_reader type: String
+
+    attr_reader id: untyped
+
+    attr_reader identity: Array[untyped]
+
+    attr_reader attributes: Hash[String, untyped]
+
+    attr_reader associations: Hash[String, AssociationSnapshot]
+
+    # : (type: String, id: untyped, attributes: snapshot_attributes, ?associations: snapshot_associations) -> void
+    def initialize: (type: String, id: untyped, attributes: snapshot_attributes, ?associations: snapshot_associations) -> void
+
+    # : () -> RecordReference
+    def reference: () -> RecordReference
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+
+    private
+
+    # : (Hash[untyped, untyped]) -> Hash[String, untyped]
+    def normalize_hash: (Hash[untyped, untyped]) -> Hash[String, untyped]
+  end
+end

data/sig/generated/paper_trail_diff/snapshot_normalizer.rbs

@@ -0,0 +1,76 @@
+# Generated from lib/paper_trail_diff/snapshot_normalizer.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Reuses immutable nodes whose normalized state did not change at a selected path.
+  class SnapshotPool
+    def initialize: () -> untyped
+
+    # : (String, RecordSnapshot) -> RecordSnapshot
+    def record: (String, RecordSnapshot) -> RecordSnapshot
+
+    # : (String, AssociationSnapshot) -> AssociationSnapshot
+    def association: (String, AssociationSnapshot) -> AssociationSnapshot
+
+    private
+
+    @associations: Hash[String, AssociationSnapshot]
+
+    @records: Hash[Array[untyped], RecordSnapshot]
+
+    # : (RecordSnapshot, RecordSnapshot) -> bool
+    def equivalent_record?: (RecordSnapshot, RecordSnapshot) -> bool
+  end
+
+  # Converts an ActiveRecord graph into immutable, persistence-independent snapshots.
+  class SnapshotNormalizer
+    # : (tree: AssociationTree, ignore_policy: IgnorePolicy, traversal: AssociationTraversal, ?pool: SnapshotPool) -> void
+    def initialize: (tree: AssociationTree, ignore_policy: IgnorePolicy, traversal: AssociationTraversal, ?pool: SnapshotPool) -> void
+
+    # : (untyped, reifier: untyped) -> RecordSnapshot?
+    def call: (untyped, reifier: untyped) -> RecordSnapshot?
+
+    # Normalizes one member of an already selected association branch.
+    # : (untyped, tree: AssociationTree, path: String, incoming: untyped, reifier: untyped) -> RecordSnapshot?
+    def call_child: (untyped, tree: AssociationTree, path: String, incoming: untyped, reifier: untyped) -> RecordSnapshot?
+
+    # Normalizes scalar attributes without traversing or loading associations.
+    # : (untyped, tree: AssociationTree, path: String) -> snapshot_attributes
+    def attributes_for: (untyped, tree: AssociationTree, path: String) -> snapshot_attributes
+
+    private
+
+    @ignore_policy: IgnorePolicy
+
+    @pool: SnapshotPool
+
+    @structural_columns: Hash[String, Array[String]]
+
+    @traversal: AssociationTraversal
+
+    @tree: AssociationTree
+
+    # : (untyped, AssociationTree, String, untyped, Array[untyped]) -> RecordSnapshot?
+    def normalize_record: (untyped, AssociationTree, String, untyped, Array[untyped]) -> RecordSnapshot?
+
+    # : (untyped, Array[untyped], String) -> snapshot_attributes
+    def normalized_attributes: (untyped, Array[untyped], String) -> snapshot_attributes
+
+    # : (untyped, Array[untyped], String) -> Array[String]
+    def excluded_attributes: (untyped, Array[untyped], String) -> Array[String]
+
+    # : (Array[untyped]) -> Array[String]
+    def relationship_columns: (Array[untyped]) -> Array[String]
+
+    # : (untyped, AssociationTree, String, untyped, Array[untyped]) -> Hash[String, AssociationSnapshot]
+    def normalize_associations: (untyped, AssociationTree, String, untyped, Array[untyped]) -> Hash[String, AssociationSnapshot]
+
+    # : (untyped, untyped, AssociationTree, String, untyped) -> AssociationSnapshot
+    def association_snapshot: (untyped, untyped, AssociationTree, String, untyped) -> AssociationSnapshot
+
+    # : (Array[untyped], AssociationTree, String, untyped) -> Array[RecordSnapshot]
+    def normalize_children: (Array[untyped], AssociationTree, String, untyped) -> Array[RecordSnapshot]
+
+    # : (untyped, AssociationTree, String) -> Array[untyped]
+    def reflections_for: (untyped, AssociationTree, String) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/step.rbs

@@ -0,0 +1,18 @@
+# Generated from lib/paper_trail_diff/step.rb with RBS::Inline
+
+module PaperTrailDiff
+  # One adjacent transition in a PaperTrail timeline.
+  class Step
+    attr_reader from_version: untyped
+
+    attr_reader to_version: untyped
+
+    attr_reader diff: Diff
+
+    # : (from_version: untyped, to_version: untyped, diff: Diff) -> void
+    def initialize: (from_version: untyped, to_version: untyped, diff: Diff) -> void
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+end

data/sig/generated/paper_trail_diff/support.rbs

@@ -0,0 +1,30 @@
+# Generated from lib/paper_trail_diff/support.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Internal helpers for isolating and serializing values held by result objects.
+  module Support
+    # : (untyped) -> untyped
+    def self?.immutable_copy: (untyped) -> untyped
+
+    # : (Hash[untyped, untyped]) -> Hash[untyped, untyped]
+    def self?.immutable_hash: (Hash[untyped, untyped]) -> Hash[untyped, untyped]
+
+    # : (untyped) -> untyped
+    def self?.serialize: (untyped) -> untyped
+
+    # : (untyped) -> Array[untyped]
+    def self?.chronological_version_key: (untyped) -> Array[untyped]
+
+    # : (untyped, untyped) -> Integer
+    def self?.compare_versions: (untyped, untyped) -> Integer
+
+    # : (String, String) -> String
+    def self?.association_path: (String, String) -> String
+
+    # : (untyped) -> untyped
+    def self?.duplicate_and_freeze: (untyped) -> untyped
+
+    # : (untyped) -> bool
+    def self?.paper_trail_diff_value?: (untyped) -> bool
+  end
+end

data/sig/generated/paper_trail_diff/timeline_builder.rbs

@@ -0,0 +1,31 @@
+# Generated from lib/paper_trail_diff/timeline_builder.rb with RBS::Inline
+
+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
+
+    # : () -> Array[Step]
+    def build: () -> Array[Step]
+
+    # : () -> Analysis
+    def analyze: () -> Analysis
+
+    private
+
+    @from: untyped
+
+    @record: untyped
+
+    @snapshotter: untyped
+
+    @to: untyped
+
+    # : (Array[untyped]) -> [Array[Step], RecordSnapshot?, RecordSnapshot?]
+    def compare_history: (Array[untyped]) -> [ Array[Step], RecordSnapshot?, RecordSnapshot? ]
+
+    # : () -> Array[untyped]
+    def selected_versions: () -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/timeline_snapshot_provider.rbs

@@ -0,0 +1,17 @@
+# Generated from lib/paper_trail_diff/timeline_snapshot_provider.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Gives TimelineBuilder one-argument access to a range-prepared snapshot store.
+  class TimelineSnapshotProvider
+    # : (HistoricalSnapshotStore) -> void
+    def initialize: (HistoricalSnapshotStore) -> void
+
+    # : (untyped, Array[untyped]) -> void
+    def prepare: (untyped, Array[untyped]) -> void
+
+    # : (untyped) -> RecordSnapshot?
+    def call: (untyped) -> RecordSnapshot?
+
+    @store: HistoricalSnapshotStore
+  end
+end

data/sig/generated/paper_trail_diff/value_objects.rbs

@@ -0,0 +1,87 @@
+# Generated from lib/paper_trail_diff/value_objects.rb with RBS::Inline
+
+module PaperTrailDiff
+  # A directional change between two structured values.
+  class ValueChange
+    attr_reader from: untyped
+
+    attr_reader to: untyped
+
+    # : (from: untyped, to: untyped) -> void
+    def initialize: (from: untyped, to: untyped) -> void
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # Attribute and nested-association changes for a record whose identity did not change.
+  class RecordChange
+    attr_reader record: RecordReference
+
+    attr_reader attributes: Hash[String, ValueChange]
+
+    attr_reader associations: Hash[String, ToOneAssociationDiff | CollectionAssociationDiff]
+
+    # : (record: RecordSnapshot, attributes: attribute_changes, ?associations: association_diffs) -> void
+    def initialize: (record: RecordSnapshot, attributes: attribute_changes, ?associations: association_diffs) -> void
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # Relationship and associated-record changes for belongs_to or has_one.
+  class ToOneAssociationDiff
+    attr_reader kind: Symbol
+
+    attr_reader relationship: ValueChange?
+
+    attr_reader changed: RecordChange?
+
+    # : (kind: Symbol, relationship: ValueChange?, changed: RecordChange?) -> void
+    def initialize: (kind: Symbol, relationship: ValueChange?, changed: RecordChange?) -> void
+
+    # : () -> bool
+    def empty?: () -> bool
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # Membership and associated-record changes for has_many.
+  class CollectionAssociationDiff
+    attr_reader kind: Symbol
+
+    attr_reader added: Array[RecordSnapshot]
+
+    attr_reader removed: Array[RecordSnapshot]
+
+    attr_reader changed: Array[RecordChange]
+
+    # : (kind: Symbol, added: Array[RecordSnapshot], removed: Array[RecordSnapshot], changed: Array[RecordChange]) -> void
+    def initialize: (kind: Symbol, added: Array[RecordSnapshot], removed: Array[RecordSnapshot], changed: Array[RecordChange]) -> void
+
+    # : () -> bool
+    def empty?: () -> bool
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # The complete structured difference between two normalized endpoints.
+  class Diff
+    attr_reader record_presence_change: ValueChange?
+
+    attr_reader attributes: Hash[String, ValueChange]
+
+    attr_reader associations: Hash[String, ToOneAssociationDiff | CollectionAssociationDiff]
+
+    # : (?record_presence_change: ValueChange?, ?attributes: attribute_changes, ?associations: association_diffs) -> void
+    def initialize: (?record_presence_change: ValueChange?, ?attributes: attribute_changes, ?associations: association_diffs) -> void
+
+    # : () -> bool
+    def empty?: () -> bool
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+end

data/sig/generated/paper_trail_diff/version.rbs

@@ -0,0 +1,5 @@
+# Generated from lib/paper_trail_diff/version.rb with RBS::Inline
+
+module PaperTrailDiff
+  VERSION: ::String
+end

data/sig/generated/paper_trail_diff/version_range.rbs

@@ -0,0 +1,35 @@
+# Generated from lib/paper_trail_diff/version_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Selects an inclusive, chronological range from a record's root versions.
+  class VersionRange
+    # : (untyped, from: untyped, to: untyped) -> void
+    def initialize: (untyped, from: untyped, to: untyped) -> void
+
+    # : () -> Array[untyped]
+    def select: () -> Array[untyped]
+
+    # : () -> Array[untyped]
+    def select_through_latest: () -> Array[untyped]
+
+    private
+
+    @from: untyped
+
+    @record: untyped
+
+    @to: untyped
+
+    # : () -> untyped
+    def versions_relation: () -> untyped
+
+    # : (untyped, ?through: untyped) -> Array[untyped]
+    def select_relation: (untyped, ?through: untyped) -> Array[untyped]
+
+    # : (untyped, untyped, boundary: Symbol) -> void
+    def validate_boundary!: (untyped, untyped, boundary: Symbol) -> void
+
+    # : (untyped, untyped) -> bool
+    def valid_boundary?: (untyped, untyped) -> bool
+  end
+end