@onekeyfe/react-native-native-list 3.0.157-alpha.253 → 3.0.157-alpha.255

package/ios/NativeListMediaPreviewSlot.swift

@@ -0,0 +1,199 @@
+import AVFoundation
+import UIKit
+
+private final class NativeListPausedVideoView: UIView {
+  var onWindowChanged: (() -> Void)?
+  var onLayoutChanged: (() -> Void)?
+  override class var layerClass: AnyClass { AVPlayerLayer.self }
+  var playerLayer: AVPlayerLayer { layer as! AVPlayerLayer }
+  override func didMoveToWindow() { super.didMoveToWindow(); onWindowChanged?() }
+  override func layoutSubviews() { super.layoutSubviews(); onLayoutChanged?() }
+}
+
+/// Uses the same AVPlayer source semantics as native Video, always paused and muted.
+final class NativeListMediaPreviewSlot {
+  let view = UIView()
+  private let image = NativeListImageSlot()
+  private let video = NativeListPausedVideoView()
+  private var identity: String?
+  private var epoch = 0
+  private var candidateGeneration = 0
+  private var playerGeneration = 0
+  private var result: Bool?
+  private var completion: ((Bool) -> Void)?
+  private var player: AVPlayer?
+  private var itemObservation: NSKeyValueObservation?
+  private var readyObservation: NSKeyValueObservation?
+  private var resumeVideo: (() -> Void)?
+  private var lifecycleObservers: [NSObjectProtocol] = []
+  private var viewportObservations: [NSKeyValueObservation] = []
+
+  init() {
+    view.isUserInteractionEnabled = false
+    for child in [image.view, video] {
+      child.frame = view.bounds
+      child.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+      view.addSubview(child)
+    }
+    video.clipsToBounds = true
+    video.isHidden = true
+    video.onWindowChanged = { [weak self] in self?.observeViewport(); self?.updateVisibility() }
+    video.onLayoutChanged = { [weak self] in self?.updateVisibility() }
+    lifecycleObservers = [
+      NotificationCenter.default.addObserver(forName: UIApplication.willResignActiveNotification, object: nil, queue: .main) { [weak self] _ in self?.releasePlayer() },
+      NotificationCenter.default.addObserver(forName: UIApplication.didBecomeActiveNotification, object: nil, queue: .main) { [weak self] _ in self?.updateVisibility() },
+    ]
+  }
+
+  func bind(
+    _ source: [String: Any], key: String, fit: String? = nil,
+    placeholder: String = "#0000000F", probeOrder: [String] = ["image"],
+    completion: ((Bool) -> Void)? = nil
+  ) {
+    let next = NativeListImageSlot.signature([
+      "source": source, "key": key, "fit": fit ?? "", "order": probeOrder,
+      "placeholder": placeholder,
+    ])
+    self.completion = completion
+    if identity == next {
+      if let result { completion?(result) }
+      updateVisibility()
+      return
+    }
+    recycle()
+    identity = next
+    self.completion = completion
+    video.playerLayer.videoGravity = (fit ?? source.string("contentFit")) == "cover" ? .resizeAspectFill : .resizeAspect
+    probe(source, key: key, fit: fit, placeholder: placeholder, order: probeOrder, attempt: 0, token: epoch)
+  }
+
+  private func probe(
+    _ source: [String: Any], key: String, fit: String?, placeholder: String,
+    order: [String], attempt: Int, token: Int
+  ) {
+    guard token == epoch else { return }
+    candidateGeneration &+= 1
+    let candidate = candidateGeneration
+    resumeVideo = nil
+    viewportObservations.removeAll()
+    releasePlayer()
+    guard attempt < order.count else {
+      result = false
+      completion?(false)
+      return
+    }
+    let finished: (Bool) -> Void = { [weak self] loaded in
+      guard let self, self.epoch == token, self.candidateGeneration == candidate else { return }
+      if loaded {
+        guard self.result != true else { return }
+        self.result = true
+        self.completion?(true)
+      } else {
+        self.probe(source, key: key, fit: fit, placeholder: placeholder, order: order, attempt: attempt + 1, token: token)
+      }
+    }
+    if order[attempt] == "image" {
+      video.isHidden = true
+      image.view.isHidden = false
+      image.bind(source, key: key, fit: fit, placeholder: placeholder, completion: finished)
+      return
+    }
+    image.recycle()
+    image.view.isHidden = true
+    video.isHidden = false
+    guard let url = URL(string: source.string("uri")), !source.string("uri").isEmpty else { finished(false); return }
+    resumeVideo = { [weak self] in
+      guard let self, self.epoch == token, self.candidateGeneration == candidate, self.player == nil else { return }
+      self.playerGeneration &+= 1
+      let generation = self.playerGeneration
+      let asset = AVURLAsset(url: url, options: ["AVURLAssetHTTPHeaderFieldsKey": source.dictionary("headers") ?? [:]])
+      let item = AVPlayerItem(asset: asset)
+      item.preferredForwardBufferDuration = 1
+      let player = AVPlayer(playerItem: item)
+      player.isMuted = true
+      player.pause()
+      self.player = player
+      self.video.playerLayer.player = player
+      self.itemObservation = item.observe(\.status, options: [.initial, .new]) { [weak self] item, _ in
+        DispatchQueue.main.async {
+          guard let self, self.playerGeneration == generation else { return }
+          if item.status == .failed { finished(false) }
+        }
+      }
+      self.readyObservation = self.video.playerLayer.observe(\.isReadyForDisplay, options: [.initial, .new]) { [weak self] layer, _ in
+        DispatchQueue.main.async {
+          guard let self, self.playerGeneration == generation else { return }
+          if layer.isReadyForDisplay { finished(true) }
+        }
+      }
+    }
+    observeViewport()
+    updateVisibility()
+  }
+
+  private func observeViewport() {
+    viewportObservations.removeAll()
+    guard resumeVideo != nil, video.window != nil else { return }
+    var ancestor = video.superview
+    while let current = ancestor {
+      if let scrollView = current as? UIScrollView {
+        viewportObservations.append(scrollView.observe(\.contentOffset, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+        viewportObservations.append(scrollView.observe(\.bounds, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+      }
+      // Pager or host layouts may translate a retained page without scrolling it.
+      viewportObservations.append(current.layer.observe(\.transform, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+      viewportObservations.append(current.layer.observe(\.position, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+      viewportObservations.append(current.layer.observe(\.isHidden, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+      viewportObservations.append(current.layer.observe(\.opacity, options: [.new]) { [weak self] _, _ in self?.updateVisibility() })
+      ancestor = current.superview
+    }
+  }
+
+  /// Retained pager pages can have a window while lying outside its clipped viewport.
+  static func intersectsViewport(_ view: UIView) -> Bool {
+    guard let window = view.window, !view.bounds.isEmpty else { return false }
+    var visible = view.convert(view.bounds, to: window).intersection(window.bounds)
+    var ancestor: UIView? = view
+    while let current = ancestor {
+      if current.isHidden || current.alpha <= 0.01 { return false }
+      if current.clipsToBounds || current is UIScrollView {
+        visible = visible.intersection(current.convert(current.bounds, to: window))
+      }
+      if visible.isNull || visible.isEmpty { return false }
+      ancestor = current.superview
+    }
+    return true
+  }
+
+  private func updateVisibility() {
+    if Self.intersectsViewport(video) && UIApplication.shared.applicationState == .active { resumeVideo?() }
+    else { releasePlayer() }
+  }
+  private func releasePlayer() {
+    playerGeneration &+= 1
+    itemObservation = nil
+    readyObservation = nil
+    player?.pause()
+    video.playerLayer.player = nil
+    player?.replaceCurrentItem(with: nil)
+    player = nil
+  }
+  func recycle() {
+    epoch &+= 1
+    candidateGeneration &+= 1
+    resumeVideo = nil
+    viewportObservations.removeAll()
+    releasePlayer()
+    image.recycle()
+    image.view.isHidden = false
+    video.isHidden = true
+    identity = nil
+    result = nil
+    completion = nil
+  }
+  deinit {
+    lifecycleObservers.forEach(NotificationCenter.default.removeObserver)
+    player?.pause()
+    player?.replaceCurrentItem(with: nil)
+  }
+}

package/ios/NativeListMediaTileRenderer.swift

@@ -8,7 +8,7 @@ final class NativeListMediaTileCell: NativeListRendererCell {
   }
 
   private let picture = UIView()
-  private let image = NativeListImageSlot()
+  private let image = NativeListMediaPreviewSlot()
   private let network = NativeListImageSlot()
   private let errorIcon = UIImageView()
   private let title = NativeListTextLabel()
@@ -27,7 +27,7 @@ final class NativeListMediaTileCell: NativeListRendererCell {
   override var defaultCornerRadius: CGFloat { 16 }
   override var showsSelection: Bool { false }
   override var pressChangesBackground: Bool { false }
-  override var assetFields: [String] { ["image", "networkImage"] }
+  override var assetFields: [String] { ["image", "media", "networkImage"] }
   override var isHighlighted: Bool { didSet { picture.alpha = isHighlighted ? 0.8 : 1 } }
 
   override init(frame: CGRect) {
@@ -120,7 +120,8 @@ final class NativeListMediaTileCell: NativeListRendererCell {
     errorIcon.isHidden = state != "error"
     errorIcon.image = nativeListIcon(named: "ImageSquareWavesOutline")
     errorIcon.tintColor = UIColor(nativeListHex: "#00000044", fallback: .lightGray)
-    if state != "empty", state != "error", let source = item.data.dictionary("image") {
+    let media = item.data.dictionary("media")
+    if state != "empty", state != "error", let source = media?.dictionary("source") ?? item.data.dictionary("image") {
       // Legacy source-backed media had a transparent container. Clear only a fill this
       // renderer applied, so OneKeyImage keeps ownership of its own placeholder color.
       if ownsImageFill {
@@ -129,7 +130,12 @@ final class NativeListMediaTileCell: NativeListRendererCell {
       }
       image.bind(
         source, key: "\(item.key):media", fit: imageStyle["contentFit"] as? String,
-        placeholder: placeholder)
+        placeholder: placeholder, probeOrder: media?["probeOrder"] as? [String] ?? ["image"]
+      ) { [weak self] loaded in
+        self?.errorIcon.isHidden = loaded
+        self?.ownsImageFill = !loaded
+        self?.image.view.backgroundColor = loaded ? .clear : UIColor(nativeListHex: placeholder, fallback: .lightGray)
+      }
     } else {
       image.recycle()
       image.view.backgroundColor =

package/ios/NativeListModels.swift

@@ -93,6 +93,7 @@ struct NativeListConfig {
   var selectedKeys: Set<String>
   let reorderable: Bool
   let pullToRefresh: Bool
+  let refreshTriggerDistance: CGFloat?
   var refreshing: Bool
   let loadMore: Bool
   let endReachedThreshold: Double
@@ -144,7 +145,7 @@ struct NativeListConfig {
       generation: generation,
       layout: layout,
       orientation: layoutData["orientation"] as? String ?? "vertical",
-      gridColumns: min(4, max(1, layoutData["gridColumns"] as? Int ?? 1)),
+      gridColumns: min(7, max(1, layoutData["gridColumns"] as? Int ?? 1)),
       stickyHeaders: layoutData["stickyHeaders"] as? Bool ?? false,
       contentPadding: contentPadding,
       contentPaddingHorizontal: contentPaddingHorizontal,
@@ -156,6 +157,8 @@ struct NativeListConfig {
       selectedKeys: selectedKeys,
       reorderable: capabilities?["reorderable"] as? Bool ?? false,
       pullToRefresh: capabilities?["pullToRefresh"] as? Bool ?? false,
+      refreshTriggerDistance: (capabilities?["refreshTriggerDistance"] as? Double)
+        .flatMap { $0.isFinite && $0 > 0 ? CGFloat($0) : nil },
       refreshing: capabilities?["refreshing"] as? Bool ?? false,
       loadMore: capabilities?["loadMore"] as? Bool ?? false,
       endReachedThreshold: capabilities?["endReachedThreshold"] as? Double ?? 0.2,

package/ios/NativeListScrollPositionTracker.swift

@@ -0,0 +1,30 @@
+import Foundation
+
+/// A per-view hysteresis observer. A nil result means no bridge event is needed.
+struct NativeListScrollPositionTracker {
+  private var start: Double?
+  private var end: Double?
+  private var previous: Bool?
+
+  mutating func configure(json: String) {
+    start = nil
+    end = nil
+    previous = nil
+    guard let data = json.data(using: .utf8),
+          let values = try? JSONSerialization.jsonObject(with: data) as? [String: Double],
+          let start = values["start"], let end = values["end"],
+          start.isFinite, end.isFinite, start >= 0, end > start else { return }
+    self.start = start
+    self.end = end
+  }
+
+  mutating func resetDelivery() { previous = nil }
+
+  mutating func update(offset: Double) -> Bool? {
+    guard let start, let end, offset.isFinite else { return nil }
+    let next = previous == true ? offset > start : offset >= end
+    guard previous != next else { return nil }
+    previous = next
+    return next
+  }
+}

package/ios/NativeListSectionHeaderRenderer.swift

@@ -99,7 +99,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     if layout == "table" { return 28 }
     if item.data.string("presentation") == "networkSelector" { return 47 }
     if item.data.string("variant") == "history" {
-      return 16
+      return item.data.bool("titleLoading") ? 20 : 16
     }
     if item.data.string("variant") == "summary" { return 68 }
     if item.data.string("variant") == "gallery" { return 32 }
@@ -110,6 +110,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
   private let mainStack = UIStackView()
   private let titleRowStack = UIStackView()
   private let titleLabel = NativeListDottedUnderlineLabel()
+  private let titleSpinner = UIActivityIndicatorView(style: .medium)
   private let subtitleLabel = NativeListTextLabel()
   private let trailingStack = UIStackView()
   private let accessoryButtons = [NativeListAccessoryButton(type: .system)]
@@ -132,6 +133,12 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     root.axis = .horizontal
     root.alignment = .center
     root.spacing = 12
+    titleSpinner.translatesAutoresizingMaskIntoConstraints = false
+    titleSpinner.isAccessibilityElement = false
+    NSLayoutConstraint.activate([
+      titleSpinner.widthAnchor.constraint(equalToConstant: 20),
+      titleSpinner.heightAnchor.constraint(equalToConstant: 20),
+    ])
     mainStack.axis = .vertical
     mainStack.alignment = .fill
     mainStack.spacing = 2
@@ -174,6 +181,7 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     selectorTypographyRestorers = []
     currentItem = item
     currentTheme = theme
+    titleSpinner.stopAnimating()
     NSLayoutConstraint.deactivate(selectorConstraints)
     selectorConstraints = []
     root.arrangedSubviews.forEach {
@@ -244,6 +252,8 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     if style["lineGap"] != nil { mainStack.spacing = CGFloat(style.double("lineGap")) }
     if style["trailingGap"] != nil { trailingStack.spacing = CGFloat(style.double("trailingGap")) }
     applyTextStyle(item)
+    titleSpinner.color = titleLabel.textColor
+    updateTitleSpinner()
     contentInsets = UIEdgeInsets(
       top: topInset, left: leftInset, bottom: -bottomInset, right: -rightInset)
     root.alignment =
@@ -301,6 +311,18 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
   override func recycleContent() {
     checkboxControl.reset()
     currentItem = nil
+    titleSpinner.stopAnimating()
+  }
+  override func didMoveToWindow() {
+    super.didMoveToWindow()
+    updateTitleSpinner()
+  }
+  private func updateTitleSpinner() {
+    if window != nil, currentItem?.data.bool("titleLoading") == true {
+      titleSpinner.startAnimating()
+    } else {
+      titleSpinner.stopAnimating()
+    }
   }
   @objc private func titlePressed() {
     if let item = currentItem {
@@ -324,6 +346,10 @@ final class NativeListSectionHeaderCell: NativeListRendererCell {
     layout: String,
     _ checkboxState: (NativeListItem, NativeSelectionTarget?, String) -> String
   ) {
+    if item.data.bool("titleLoading") {
+      root.addArrangedSubview(titleSpinner)
+      root.setCustomSpacing(8, after: titleSpinner)
+    }
     root.addArrangedSubview(mainStack)
     let variant = item.data.string("variant")
     // OneKey patch: title help is a separate target from checkbox and value actions.

package/ios/RNCNativeListView.swift

@@ -4,6 +4,54 @@ import UIKit
 import UniformTypeIdentifiers
 
 final class NativeListView: UIView {
+  private var refreshEmittedForDrag = false
+  private var minimumDragOffset: CGFloat = 0
+  private var reactContainerSlots: [UIView] = []
+  private var containerSlotHeights: [CGFloat] = [0, 0, 0]
+  private var lastLaidOutContentHeight: CGFloat?
+  private var needsContentShrinkCorrection = false
+  private var contentShrinkCorrectionScheduled = false
+
+  @objc func mountContainerSlot(_ view: UIView, atIndex index: Int) {
+    reactContainerSlots.insert(view, at: min(index, reactContainerSlots.count))
+    collectionView.addSubview(view)
+    setNeedsLayout()
+  }
+
+  @objc func unmountContainerSlot(_ view: UIView) {
+    reactContainerSlots.removeAll { $0 === view }
+    view.removeFromSuperview()
+  }
+
+  func setContainerSlotHeightsJson(_ json: String) {
+    guard let data = json.data(using: .utf8),
+          let heights = try? JSONSerialization.jsonObject(with: data) as? [Double],
+          heights.count == 3, heights.allSatisfy({ $0.isFinite && $0 >= 0 }) else { return }
+    containerSlotHeights = heights.map { CGFloat($0) }
+    if let config { configureLayout(config) }
+    setNeedsLayout()
+  }
+
+  private func layoutContainerSlots() {
+    guard reactContainerSlots.count == 3 else { return }
+    let empty = config?.items.isEmpty ?? true
+    let header = containerSlotHeights[0]
+    let emptyHeight = empty ? containerSlotHeights[1] : 0
+    let footer = containerSlotHeights[2]
+    let paddingTop = config?.contentPaddingTop ?? 0
+    let paddingBottom = config?.contentPaddingBottom ?? 0
+    let footerY = max(paddingTop + header + emptyHeight,
+      collectionView.contentSize.height - paddingBottom - footer)
+    let positions = [paddingTop, paddingTop + header, footerY]
+    for (index, view) in reactContainerSlots.enumerated() {
+      view.isHidden = index == 1 && !empty
+      let horizontalPadding = config?.contentPaddingHorizontal ?? 0
+      view.frame = CGRect(x: horizontalPadding, y: positions[index],
+        width: max(0, collectionView.bounds.width - horizontalPadding * 2),
+        height: containerSlotHeights[index])
+    }
+  }
+
   private final class ActionAnchorRecord {
     let token: String
     weak var sourceView: UIView?
@@ -47,6 +95,26 @@ final class NativeListView: UIView {
     case end(Bool)
   }
 
+  private var scrollPositionTracker = NativeListScrollPositionTracker()
+  var onScrollPositionThresholdChange: ((Bool) -> Void)? {
+    didSet {
+      scrollPositionTracker.resetDelivery()
+      emitScrollPositionThresholdIfNeeded()
+    }
+  }
+
+  func setScrollPositionThresholdsJson(_ json: String) {
+    scrollPositionTracker.configure(json: json)
+    emitScrollPositionThresholdIfNeeded()
+  }
+
+  private func emitScrollPositionThresholdIfNeeded() {
+    guard let callback = onScrollPositionThresholdChange,
+          let next = scrollPositionTracker.update(offset: Double(max(0,
+            collectionView.contentOffset.y + collectionView.contentInset.top))) else { return }
+    callback(next)
+  }
+
   var onRowAction: ((String) -> Void)?
   var onActionAnchorInvalidated: ((String) -> Void)?
   var onSelectionDelta: ((String) -> Void)?
@@ -60,7 +128,14 @@ final class NativeListView: UIView {
   }
 
   private let flowLayout = NativeListFlowLayout()
-  private lazy var collectionView = NativeListCollectionView(frame: .zero, collectionViewLayout: flowLayout)
+  private lazy var collectionView: NativeListCollectionView = {
+    let view = NativeListCollectionView(frame: .zero, collectionViewLayout: flowLayout)
+    view.onContentLayout = { [weak self] in
+      self?.layoutContainerSlots()
+      self?.contentLayoutDidChange()
+    }
+    return view
+  }()
   private let footerContainer = UIView()
   private var footerCell: NativeListRowHost = NativeListRendererRegistry.create(.action)
   private var footerRendererKey = NativeListRendererKey.action
@@ -333,6 +408,7 @@ final class NativeListView: UIView {
       rebindRowsForLayoutDirection(config)
     }
     performPendingScrollIfNeeded()
+    layoutContainerSlots()
   }
 
   // A layout-direction change may arrive without a layout pass (semantic attribute or trait).
@@ -673,6 +749,39 @@ final class NativeListView: UIView {
     collectionView.setContentOffset(point, animated: animated)
   }
 
+  private func contentLayoutDidChange() {
+    let height = collectionView.contentSize.height
+    if config?.orientation != "horizontal",
+       let previous = lastLaidOutContentHeight, height < previous {
+      needsContentShrinkCorrection = true
+    }
+    lastLaidOutContentHeight = height
+    scheduleContentShrinkCorrection()
+  }
+
+  private func scheduleContentShrinkCorrection() {
+    guard needsContentShrinkCorrection, !contentShrinkCorrectionScheduled, !disposed else { return }
+    contentShrinkCorrectionScheduled = true
+    // Wait for the collection layout and ancestor pager inset observers to settle.
+    DispatchQueue.main.async { [weak self] in
+      guard let self else { return }
+      self.contentShrinkCorrectionScheduled = false
+      guard !self.disposed, self.needsContentShrinkCorrection,
+            !self.collectionView.isTracking, !self.collectionView.isDragging,
+            !self.collectionView.isDecelerating,
+            self.collectionView.refreshControl?.isRefreshing != true,
+            self.config?.refreshing != true else { return }
+      self.needsContentShrinkCorrection = false
+      guard self.config?.orientation != "horizontal", self.collectionView.bounds.height > 0 else { return }
+      let insets = self.collectionView.adjustedContentInset
+      let maximum = max(-insets.top,
+        self.collectionView.contentSize.height - self.collectionView.bounds.height + insets.bottom)
+      if self.collectionView.contentOffset.y > maximum {
+        self.setScrollOffset(self.collectionView.contentOffset.y, animated: false)
+      }
+    }
+  }
+
   func setRefreshing(_ refreshing: Bool) {
     guard var current = config else { return }
     current.refreshing = refreshing
@@ -681,6 +790,7 @@ final class NativeListView: UIView {
       collectionView.refreshControl?.beginRefreshing()
     } else {
       collectionView.refreshControl?.endRefreshing()
+      scheduleContentShrinkCorrection()
     }
   }
 
@@ -693,11 +803,14 @@ final class NativeListView: UIView {
     flowLayout.minimumLineSpacing = config.itemSpacing
     flowLayout.minimumInteritemSpacing = config.itemSpacing
     flowLayout.sectionInset = UIEdgeInsets(
-      top: config.contentPaddingTop,
+      top: config.contentPaddingTop + containerSlotHeights[0],
       left: config.contentPaddingHorizontal + (isRightToLeft ? indexGutter : 0),
-      bottom: config.contentPaddingBottom,
+      bottom: config.contentPaddingBottom + containerSlotHeights[2],
       right: config.contentPaddingHorizontal + (isRightToLeft ? 0 : indexGutter)
     )
+    flowLayout.minimumContainerContentHeight = config.items.isEmpty
+      ? config.contentPaddingTop + config.contentPaddingBottom + containerSlotHeights.reduce(0, +)
+      : 0
     flowLayout.stickyItemIndexes = config.stickyHeaders
       ? Set(config.items.enumerated().compactMap {
           $0.element.type == "sectionHeader" && $0.element.data.bool("sticky", default: true) && $0.element.data.string("variant") != "summary"
@@ -1347,6 +1460,7 @@ final class NativeListView: UIView {
     } else {
       collectionView.refreshControl = nil
     }
+    if !config.refreshing { scheduleContentShrinkCorrection() }
   }
 
   private func configureFooter(_ config: NativeListConfig) {
@@ -1539,6 +1653,7 @@ final class NativeListView: UIView {
           current.rowPressToggles == next.rowPressToggles,
           current.reorderable == next.reorderable,
           current.pullToRefresh == next.pullToRefresh,
+          current.refreshTriggerDistance == next.refreshTriggerDistance,
           current.refreshing == next.refreshing,
           current.loadMore == next.loadMore,
           current.endReachedThreshold == next.endReachedThreshold,
@@ -1849,6 +1964,8 @@ final class NativeListView: UIView {
     itemsByKey.removeAll()
     sectionIndexEntries.removeAll()
     pendingScrollRequest = nil
+    needsContentShrinkCorrection = false
+    lastLaidOutContentHeight = nil
     lastVisibleRange = nil
     onRowAction = nil
     onActionAnchorInvalidated = nil
@@ -1856,6 +1973,7 @@ final class NativeListView: UIView {
     onReorder = nil
     onEndReached = nil
     onVisibleRangeChanged = nil
+    onScrollPositionThresholdChange = nil
   }
 
   private func createActionAnchor(origin: NativeListActionOrigin) -> [String: Any]? {
@@ -1921,6 +2039,9 @@ final class NativeListView: UIView {
   }
 
   @objc private func refreshTriggered() {
+    guard !disposed, config?.pullToRefresh == true,
+          config?.refreshing != true, !refreshEmittedForDrag else { return }
+    refreshEmittedForDrag = true
     emit(onRowAction, ["actionKey": "nativeList.refresh"])
   }
 
@@ -2142,7 +2263,31 @@ extension NativeListView: UICollectionViewDelegateFlowLayout {
     return item.isRowPressEnabled
   }
 
+  func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
+    minimumDragOffset = 0
+    refreshEmittedForDrag = false
+  }
+
+  func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
+    defer { if !decelerate { scheduleContentShrinkCorrection() } }
+    minimumDragOffset = min(minimumDragOffset, scrollView.contentOffset.y + scrollView.contentInset.top)
+    guard let threshold = config?.refreshTriggerDistance,
+          config?.pullToRefresh == true, config?.refreshing != true,
+          minimumDragOffset <= -threshold, !refreshEmittedForDrag else { return }
+    collectionView.refreshControl?.beginRefreshing()
+    refreshTriggered()
+  }
+
+  func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
+    scheduleContentShrinkCorrection()
+  }
+
   func scrollViewDidScroll(_ scrollView: UIScrollView) {
+    if scrollView.isDragging {
+      minimumDragOffset = min(minimumDragOffset, scrollView.contentOffset.y + scrollView.contentInset.top)
+    }
+    layoutContainerSlots()
+    emitScrollPositionThresholdIfNeeded()
     invalidateActionAnchor(reason: "scroll")
     syncSectionIndexToVisibleRows()
     emitVisibleRangeIfNeeded()
@@ -2205,6 +2350,13 @@ extension NativeListView: UICollectionViewDragDelegate, UICollectionViewDropDele
 // quick tap highlighted and unhighlighted a row within one frame and the pressed background never
 // rendered. Deliver touches immediately, as Android rows do.
 private final class NativeListCollectionView: UICollectionView {
+  var onContentLayout: (() -> Void)?
+
+  override func layoutSubviews() {
+    super.layoutSubviews()
+    onContentLayout?()
+  }
+
   override init(frame: CGRect, collectionViewLayout layout: UICollectionViewLayout) {
     super.init(frame: frame, collectionViewLayout: layout)
     delaysContentTouches = false
@@ -2223,6 +2375,7 @@ private final class NativeListCollectionView: UICollectionView {
 
 final class NativeListFlowLayout: UICollectionViewFlowLayout {
   var stickyItemIndexes: Set<Int> = []
+  var minimumContainerContentHeight: CGFloat = 0
   private var horizontalAttributes: [IndexPath: UICollectionViewLayoutAttributes] = [:]
   private var horizontalContentSize: CGSize = .zero
 
@@ -2251,7 +2404,9 @@ final class NativeListFlowLayout: UICollectionViewFlowLayout {
   }
 
   override var collectionViewContentSize: CGSize {
-    scrollDirection == .horizontal ? horizontalContentSize : super.collectionViewContentSize
+    if scrollDirection == .horizontal { return horizontalContentSize }
+    let size = super.collectionViewContentSize
+    return CGSize(width: size.width, height: max(size.height, minimumContainerContentHeight))
   }
 
   override func shouldInvalidateLayout(forBoundsChange newBounds: CGRect) -> Bool {