@shortkitsdk/react-native 0.2.5 → 0.2.11

package/ios/ShortKitSDK.xcframework/ios-arm64/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/arm64-apple-ios.private.swiftinterface

@@ -1,12 +1,13 @@
 // swift-interface-format-version: 1.0
 // swift-compiler-version: Apple Swift version 6.1 effective-5.10 (swiftlang-6.1.0.110.21 clang-1700.0.13.3)
-// swift-module-flags: -target arm64-apple-ios16.0 -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
+// swift-module-flags: -target arm64-apple-ios15.0 -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
 // swift-module-flags-ignorable:  -interface-compiler-version 6.1
 import AVFoundation
 import Combine
 import CoreGraphics
 import Foundation
 import Network
+import QuartzCore
 import Swift
 import SwiftUI
 import UIKit
@@ -159,7 +160,6 @@ final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
   final public func pause()
   final public func resume()
-  public static func selectTargets(currentIndex: Swift.Int, feedItems: [ShortKitSDK.FeedItem], cache: any ShortKitSDK.SegmentCacheProtocol, maxCount: Swift.Int) -> [ShortKitSDK.ContentItem]
   @objc deinit
 }
 public enum FeedHeight : Swift.Codable, Swift.Equatable, Swift.Sendable {
@@ -178,6 +178,17 @@ public enum FeedSource : Swift.String, Swift.Codable, Swift.Equatable, Swift.Sen
     get
   }
 }
+public struct FeedFilter : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public var tags: [Swift.String]?
+  public var section: Swift.String?
+  public var author: Swift.String?
+  public var contentType: Swift.String?
+  public var metadata: [Swift.String : Swift.String]?
+  public init(tags: [Swift.String]? = nil, section: Swift.String? = nil, author: Swift.String? = nil, contentType: Swift.String? = nil, metadata: [Swift.String : Swift.String]? = nil)
+  public static func == (a: ShortKitSDK.FeedFilter, b: ShortKitSDK.FeedFilter) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
 public struct FeedConfig : Swift.Codable {
   public var feedHeight: ShortKitSDK.FeedHeight
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
@@ -185,9 +196,12 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var muteOnStart: Swift.Bool
+  public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
   public var coldStartEnabled: Swift.Bool
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool? = nil)
+  public var filter: ShortKitSDK.FeedFilter?
+  public var preload: ShortKitSDK.FeedPreload?
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
@@ -195,6 +209,9 @@ public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
 }
+extension ShortKitSDK.VideoOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ShortKitPlayer, ShortKitSDK.CellContent) -> Content) -> ShortKitSDK.VideoOverlayMode where Content : SwiftUICore.View
+}
 extension ShortKitSDK.VideoOverlayMode : Swift.Equatable {
   public static func == (lhs: ShortKitSDK.VideoOverlayMode, rhs: ShortKitSDK.VideoOverlayMode) -> Swift.Bool
 }
@@ -238,23 +255,37 @@ extension ShortKitSDK.AdOverlayMode : Swift.Codable {
 public protocol ShortKitDelegate : AnyObject {
   func shortKitDidRequestRefresh(_ shortKit: ShortKitSDK.ShortKit)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
 extension ShortKitSDK.ShortKitDelegate {
   public func shortKitDidRequestRefresh(_ shortKit: ShortKitSDK.ShortKit)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
+}
+@_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
+  @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit)
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig)
+  @_Concurrency.MainActor @preconcurrency public func makeCoordinator() -> ShortKitSDK.ShortKitFeedView.Coordinator
   @_Concurrency.MainActor @preconcurrency public func makeUIViewController(context: ShortKitSDK.ShortKitFeedView.Context) -> ShortKitSDK.ShortKitFeedViewController
   @_Concurrency.MainActor @preconcurrency public func updateUIViewController(_ uiViewController: ShortKitSDK.ShortKitFeedViewController, context: ShortKitSDK.ShortKitFeedView.Context)
+  @_hasMissingDesignatedInitializers final public class Coordinator {
+    weak final public var feedViewController: ShortKitSDK.ShortKitFeedViewController?
+    @objc deinit
+  }
   public typealias Body = Swift.Never
-  public typealias Coordinator = Swift.Void
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor @preconcurrency public var onRemainingContentCountChange: ((Swift.Int) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func applyFilter(_ filter: ShortKitSDK.FeedFilter?)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLoad()
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillDisappear(_ animated: Swift.Bool)
@@ -356,12 +387,13 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let author: Swift.String?
   public let articleUrl: Swift.String?
   public let commentCount: Swift.Int?
+  public var fallbackUrl: Swift.String?
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
-public enum CustomFeedItem : Swift.Sendable {
-  case video(playbackId: Swift.String)
+public enum FeedInput : Swift.Sendable {
+  case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
@@ -414,14 +446,13 @@ extension ShortKitSDK.FeedItem : Swift.Codable {
 public struct ImageCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let images: [ShortKitSDK.CarouselImage]
-  public let autoScrollInterval: Swift.Double?
   public let caption: Swift.String?
   public let title: Swift.String?
   public let description: Swift.String?
   public let author: Swift.String?
   public let section: Swift.String?
   public let articleUrl: Swift.String?
-  public init(id: Swift.String, images: [ShortKitSDK.CarouselImage], autoScrollInterval: Swift.Double? = nil, caption: Swift.String? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public init(id: Swift.String, images: [ShortKitSDK.CarouselImage], caption: Swift.String? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
   public static func == (a: ShortKitSDK.ImageCarouselItem, b: ShortKitSDK.ImageCarouselItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -503,30 +534,49 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public protocol CarouselOverlay : AnyObject {
+  var cachedImage: ((Swift.String) -> UIKit.UIImage?)? { get set }
   func configure(with item: ShortKitSDK.ImageCarouselItem)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
+  var wantsNativeImagePrefetch: Swift.Bool { get }
+}
+extension ShortKitSDK.CarouselOverlay {
+  public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
+    get
+    set
+  }
+  public var wantsNativeImagePrefetch: Swift.Bool {
+    get
+  }
+}
+final public class CellContent : Combine.ObservableObject {
+  @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
+    get
+    @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
+    set
+    @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
+    _modify
+  }
+  final public var $item: Combine.Published<ShortKitSDK.ContentItem?>.Publisher {
+    get
+    @available(iOS 14.0, tvOS 14.0, watchOS 7.0, macOS 11.0, *)
+    set
+  }
+  public init()
+  public typealias ObjectWillChangePublisher = Combine.ObservableObjectPublisher
+  @objc deinit
 }
 public protocol FeedOverlay : AnyObject {
   func attach(player: ShortKitSDK.ShortKitPlayer)
   func configure(with item: ShortKitSDK.ContentItem)
-  func resetPlaybackProgress()
   func activatePlayback()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
   var onAutoAdvance: (() -> Swift.Void)? { get set }
   func configure(with item: ShortKitSDK.SurveyItem)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public struct PlayerTime : Swift.Equatable, Swift.Sendable {
   public let current: Swift.Double
@@ -582,6 +632,11 @@ public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
   public let toResolution: Swift.String
   public static func == (a: ShortKitSDK.FormatChangeEvent, b: ShortKitSDK.FormatChangeEvent) -> Swift.Bool
 }
+public enum FeedScrollPhase : Swift.Equatable, Swift.Sendable {
+  case dragging(from: Swift.String)
+  case settled
+  public static func == (a: ShortKitSDK.FeedScrollPhase, b: ShortKitSDK.FeedScrollPhase) -> Swift.Bool
+}
 public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   case positive
   case negative
@@ -607,6 +662,9 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var feedTransition: Combine.AnyPublisher<ShortKitSDK.FeedTransitionEvent, Swift.Never> {
     get
   }
+  final public var feedScrollPhase: Combine.AnyPublisher<ShortKitSDK.FeedScrollPhase, Swift.Never> {
+    get
+  }
   final public var formatChange: Combine.AnyPublisher<ShortKitSDK.FormatChangeEvent, Swift.Never> {
     get
   }
@@ -631,6 +689,9 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var remainingContentCount: Combine.AnyPublisher<Swift.Int, Swift.Never> {
     get
   }
+  final public var feedReady: Combine.AnyPublisher<Swift.Void, Swift.Never> {
+    get
+  }
   final public var currentItemValue: ShortKitSDK.ContentItem? {
     get
   }
@@ -690,13 +751,13 @@ public enum ShortKitVersion {
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
-  public init(apiKey: Swift.String, config: ShortKitSDK.FeedConfig, embedId: Swift.String? = nil, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, feedItems: [ShortKitSDK.CustomFeedItem]? = nil)
-  final public func fetchContent(limit: Swift.Int = 10) async throws -> [ShortKitSDK.ContentItem]
+  final public var loadingViewProvider: (() -> UIKit.UIView)?
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil)
+  final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
+  final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
   final public func setUserId(_ id: Swift.String)
   final public func clearUserId()
-  @_Concurrency.MainActor final public func setFeedItems(_ items: [ShortKitSDK.CustomFeedItem])
-  @_Concurrency.MainActor final public func appendFeedItems(_ items: [ShortKitSDK.CustomFeedItem])
-  @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.CustomFeedItem])
+  @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
   @objc deinit
 }

package/ios/ShortKitSDK.xcframework/ios-arm64/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/arm64-apple-ios.swiftinterface

@@ -1,12 +1,13 @@
 // swift-interface-format-version: 1.0
 // swift-compiler-version: Apple Swift version 6.1 effective-5.10 (swiftlang-6.1.0.110.21 clang-1700.0.13.3)
-// swift-module-flags: -target arm64-apple-ios16.0 -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
+// swift-module-flags: -target arm64-apple-ios15.0 -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
 // swift-module-flags-ignorable:  -interface-compiler-version 6.1
 import AVFoundation
 import Combine
 import CoreGraphics
 import Foundation
 import Network
+import QuartzCore
 import Swift
 import SwiftUI
 import UIKit
@@ -159,7 +160,6 @@ final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
   final public func pause()
   final public func resume()
-  public static func selectTargets(currentIndex: Swift.Int, feedItems: [ShortKitSDK.FeedItem], cache: any ShortKitSDK.SegmentCacheProtocol, maxCount: Swift.Int) -> [ShortKitSDK.ContentItem]
   @objc deinit
 }
 public enum FeedHeight : Swift.Codable, Swift.Equatable, Swift.Sendable {
@@ -178,6 +178,17 @@ public enum FeedSource : Swift.String, Swift.Codable, Swift.Equatable, Swift.Sen
     get
   }
 }
+public struct FeedFilter : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public var tags: [Swift.String]?
+  public var section: Swift.String?
+  public var author: Swift.String?
+  public var contentType: Swift.String?
+  public var metadata: [Swift.String : Swift.String]?
+  public init(tags: [Swift.String]? = nil, section: Swift.String? = nil, author: Swift.String? = nil, contentType: Swift.String? = nil, metadata: [Swift.String : Swift.String]? = nil)
+  public static func == (a: ShortKitSDK.FeedFilter, b: ShortKitSDK.FeedFilter) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
 public struct FeedConfig : Swift.Codable {
   public var feedHeight: ShortKitSDK.FeedHeight
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
@@ -185,9 +196,12 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var muteOnStart: Swift.Bool
+  public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
   public var coldStartEnabled: Swift.Bool
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool? = nil)
+  public var filter: ShortKitSDK.FeedFilter?
+  public var preload: ShortKitSDK.FeedPreload?
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
@@ -195,6 +209,9 @@ public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
 }
+extension ShortKitSDK.VideoOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ShortKitPlayer, ShortKitSDK.CellContent) -> Content) -> ShortKitSDK.VideoOverlayMode where Content : SwiftUICore.View
+}
 extension ShortKitSDK.VideoOverlayMode : Swift.Equatable {
   public static func == (lhs: ShortKitSDK.VideoOverlayMode, rhs: ShortKitSDK.VideoOverlayMode) -> Swift.Bool
 }
@@ -238,23 +255,37 @@ extension ShortKitSDK.AdOverlayMode : Swift.Codable {
 public protocol ShortKitDelegate : AnyObject {
   func shortKitDidRequestRefresh(_ shortKit: ShortKitSDK.ShortKit)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
 extension ShortKitSDK.ShortKitDelegate {
   public func shortKitDidRequestRefresh(_ shortKit: ShortKitSDK.ShortKit)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
+}
+@_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
+  @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit)
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig)
+  @_Concurrency.MainActor @preconcurrency public func makeCoordinator() -> ShortKitSDK.ShortKitFeedView.Coordinator
   @_Concurrency.MainActor @preconcurrency public func makeUIViewController(context: ShortKitSDK.ShortKitFeedView.Context) -> ShortKitSDK.ShortKitFeedViewController
   @_Concurrency.MainActor @preconcurrency public func updateUIViewController(_ uiViewController: ShortKitSDK.ShortKitFeedViewController, context: ShortKitSDK.ShortKitFeedView.Context)
+  @_hasMissingDesignatedInitializers final public class Coordinator {
+    weak final public var feedViewController: ShortKitSDK.ShortKitFeedViewController?
+    @objc deinit
+  }
   public typealias Body = Swift.Never
-  public typealias Coordinator = Swift.Void
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor @preconcurrency public var onRemainingContentCountChange: ((Swift.Int) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func applyFilter(_ filter: ShortKitSDK.FeedFilter?)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLoad()
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillDisappear(_ animated: Swift.Bool)
@@ -356,12 +387,13 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let author: Swift.String?
   public let articleUrl: Swift.String?
   public let commentCount: Swift.Int?
+  public var fallbackUrl: Swift.String?
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
-public enum CustomFeedItem : Swift.Sendable {
-  case video(playbackId: Swift.String)
+public enum FeedInput : Swift.Sendable {
+  case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
@@ -414,14 +446,13 @@ extension ShortKitSDK.FeedItem : Swift.Codable {
 public struct ImageCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let images: [ShortKitSDK.CarouselImage]
-  public let autoScrollInterval: Swift.Double?
   public let caption: Swift.String?
   public let title: Swift.String?
   public let description: Swift.String?
   public let author: Swift.String?
   public let section: Swift.String?
   public let articleUrl: Swift.String?
-  public init(id: Swift.String, images: [ShortKitSDK.CarouselImage], autoScrollInterval: Swift.Double? = nil, caption: Swift.String? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public init(id: Swift.String, images: [ShortKitSDK.CarouselImage], caption: Swift.String? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
   public static func == (a: ShortKitSDK.ImageCarouselItem, b: ShortKitSDK.ImageCarouselItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -503,30 +534,49 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public protocol CarouselOverlay : AnyObject {
+  var cachedImage: ((Swift.String) -> UIKit.UIImage?)? { get set }
   func configure(with item: ShortKitSDK.ImageCarouselItem)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
+  var wantsNativeImagePrefetch: Swift.Bool { get }
+}
+extension ShortKitSDK.CarouselOverlay {
+  public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
+    get
+    set
+  }
+  public var wantsNativeImagePrefetch: Swift.Bool {
+    get
+  }
+}
+final public class CellContent : Combine.ObservableObject {
+  @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
+    get
+    @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
+    set
+    @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
+    _modify
+  }
+  final public var $item: Combine.Published<ShortKitSDK.ContentItem?>.Publisher {
+    get
+    @available(iOS 14.0, tvOS 14.0, watchOS 7.0, macOS 11.0, *)
+    set
+  }
+  public init()
+  public typealias ObjectWillChangePublisher = Combine.ObservableObjectPublisher
+  @objc deinit
 }
 public protocol FeedOverlay : AnyObject {
   func attach(player: ShortKitSDK.ShortKitPlayer)
   func configure(with item: ShortKitSDK.ContentItem)
-  func resetPlaybackProgress()
   func activatePlayback()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
   var onAutoAdvance: (() -> Swift.Void)? { get set }
   func configure(with item: ShortKitSDK.SurveyItem)
   func resetState()
-  func fadeOutForTransition()
-  func restoreFromTransition()
 }
 public struct PlayerTime : Swift.Equatable, Swift.Sendable {
   public let current: Swift.Double
@@ -582,6 +632,11 @@ public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
   public let toResolution: Swift.String
   public static func == (a: ShortKitSDK.FormatChangeEvent, b: ShortKitSDK.FormatChangeEvent) -> Swift.Bool
 }
+public enum FeedScrollPhase : Swift.Equatable, Swift.Sendable {
+  case dragging(from: Swift.String)
+  case settled
+  public static func == (a: ShortKitSDK.FeedScrollPhase, b: ShortKitSDK.FeedScrollPhase) -> Swift.Bool
+}
 public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   case positive
   case negative
@@ -607,6 +662,9 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var feedTransition: Combine.AnyPublisher<ShortKitSDK.FeedTransitionEvent, Swift.Never> {
     get
   }
+  final public var feedScrollPhase: Combine.AnyPublisher<ShortKitSDK.FeedScrollPhase, Swift.Never> {
+    get
+  }
   final public var formatChange: Combine.AnyPublisher<ShortKitSDK.FormatChangeEvent, Swift.Never> {
     get
   }
@@ -631,6 +689,9 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var remainingContentCount: Combine.AnyPublisher<Swift.Int, Swift.Never> {
     get
   }
+  final public var feedReady: Combine.AnyPublisher<Swift.Void, Swift.Never> {
+    get
+  }
   final public var currentItemValue: ShortKitSDK.ContentItem? {
     get
   }
@@ -690,13 +751,13 @@ public enum ShortKitVersion {
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
-  public init(apiKey: Swift.String, config: ShortKitSDK.FeedConfig, embedId: Swift.String? = nil, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, feedItems: [ShortKitSDK.CustomFeedItem]? = nil)
-  final public func fetchContent(limit: Swift.Int = 10) async throws -> [ShortKitSDK.ContentItem]
+  final public var loadingViewProvider: (() -> UIKit.UIView)?
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil)
+  final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
+  final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
   final public func setUserId(_ id: Swift.String)
   final public func clearUserId()
-  @_Concurrency.MainActor final public func setFeedItems(_ items: [ShortKitSDK.CustomFeedItem])
-  @_Concurrency.MainActor final public func appendFeedItems(_ items: [ShortKitSDK.CustomFeedItem])
-  @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.CustomFeedItem])
+  @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
   @objc deinit
 }

package/ios/ShortKitSDK.xcframework/ios-arm64-simulator/ShortKitSDK.framework/Headers/ShortKitSDK-Swift.h

@@ -337,6 +337,7 @@ SWIFT_CLASS("_TtC11ShortKitSDK26ShortKitFeedViewController")
 @interface ShortKitFeedViewController : UIViewController
 - (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder SWIFT_UNAVAILABLE;
 - (void)viewDidLoad;
+- (void)viewDidLayoutSubviews;
 - (void)viewWillAppear:(BOOL)animated;
 - (void)viewDidAppear:(BOOL)animated;
 - (void)viewWillDisappear:(BOOL)animated;
@@ -364,7 +365,7 @@ SWIFT_CLASS("_TtC11ShortKitSDK26ShortKitFeedViewController")
 
 /// Public single-video player view controller.
 /// Starts in thumbnail-only mode and borrows an AVPlayer from the shared
-/// <code>TilePlayerPool</code> when activated. Call <code>activate()</code> when the tile becomes
+/// <code>PlayerPool</code> tile slots when activated. Call <code>activate()</code> when the tile becomes
 /// visible and <code>deactivate()</code> when it scrolls offscreen.
 SWIFT_CLASS("_TtC11ShortKitSDK28ShortKitPlayerViewController")
 @interface ShortKitPlayerViewController : UIViewController