Core: V4 write direction wrappers

api/src/main/java/org/apache/iceberg/ManifestFile.java

@@ -186,6 +186,26 @@ default boolean hasDeletedFiles() {
   /** Returns the total number of rows in all files with status DELETED in the manifest file. */
   Long deletedRowsCount();
 
+  /**
+   * Returns the number of files with status REPLACED in the manifest file, or null if not tracked.
+   *
+   * <p>REPLACED files are the prior-state entries of v4 REPLACED/MODIFIED pairs and are not live.
+   * Returns null for manifest files written by pre-v4 writers.
+   */
+  default Integer replacedFilesCount() {
+    return null;
+  }
+
+  /**
+   * Returns the total number of rows in all files with status REPLACED in the manifest file, or
+   * null if not tracked.
+   *
+   * <p>Returns null for manifest files written by pre-v4 writers.
+   */
+  default Long replacedRowsCount() {
+    return null;
+  }
+
   /**
    * Returns a list of {@link PartitionFieldSummary partition field summaries}.
    *