@shortkitsdk/react-native 0.2.46 → 0.2.48

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -252,7 +252,8 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public var shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)?
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil, shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -592,6 +593,7 @@ public enum VideoCarouselCellLongPressState : Swift.String {
   @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
   @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func prependSeedItem(_ input: ShortKitSDK.FeedInput, scrollToId: Swift.String, animated: Swift.Bool = false)
   @_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()
@@ -757,7 +759,7 @@ public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
   }
 }
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil, contentId: Swift.String? = nil)
   case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
@@ -1309,8 +1311,12 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig, items: [ShortKitSDK.WidgetInput] = [])
   @_Concurrency.MainActor @preconcurrency final public func configure(with inputs: [ShortKitSDK.WidgetInput])
   @_Concurrency.MainActor @preconcurrency final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor @preconcurrency final public var onContentHeightChange: ((CoreFoundation.CGFloat) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public func appendItems(_ inputs: [ShortKitSDK.WidgetInput])
+  @_Concurrency.MainActor @preconcurrency final public func parentScrollViewDidScroll(_ scrollView: UIKit.UIScrollView)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidAppear(_ animated: Swift.Bool)
+  @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @objc deinit
 }
@@ -1319,6 +1325,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDataS
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, cellForItemAt indexPath: Foundation.IndexPath) -> UIKit.UICollectionViewCell
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDelegate {
+  @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
@@ -1326,15 +1333,26 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
-public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
-  case singleVisibleRotating
-  case allVisibleSimultaneous
-  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+public enum GridSide : Swift.Equatable, Swift.Sendable {
+  case left
+  case right
+  public static func == (a: ShortKitSDK.GridSide, b: ShortKitSDK.GridSide) -> Swift.Bool
   public func hash(into hasher: inout Swift.Hasher)
   public var hashValue: Swift.Int {
     get
   }
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  case gridAlternating(startSide: ShortKitSDK.GridSide = .left)
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+}
+public enum WidgetLayout : Swift.Equatable, Swift.Sendable {
+  case carousel
+  case grid(columns: Swift.Int, cellAspectRatio: CoreFoundation.CGFloat, scrollable: Swift.Bool = true)
+  public static func == (a: ShortKitSDK.WidgetLayout, b: ShortKitSDK.WidgetLayout) -> Swift.Bool
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1349,7 +1367,10 @@ public struct WidgetConfig {
   public var filter: ShortKitSDK.FeedFilter?
   public var playbackMode: ShortKitSDK.WidgetPlaybackMode
   public var previewDuration: Foundation.TimeInterval
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0)
+  public var layout: ShortKitSDK.WidgetLayout
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0, layout: ShortKitSDK.WidgetLayout = .carousel)
+  public func gridCellHeight(forContainerWidth width: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat?
+  public func preferredGridHeight(forContainerWidth width: CoreFoundation.CGFloat, itemCount: Swift.Int) -> CoreFoundation.CGFloat?
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1397,4 +1418,4 @@ extension ShortKitSDK.ContentSignal : Swift.Hashable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Equatable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Hashable {}
 extension ShortKitSDK.ShortKitPlayerView : Swift.Sendable {}
-extension ShortKitSDK.WidgetPlaybackMode : Swift.Hashable {}
+extension ShortKitSDK.GridSide : Swift.Hashable {}

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -252,7 +252,8 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public var shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)?
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil, shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -592,6 +593,7 @@ public enum VideoCarouselCellLongPressState : Swift.String {
   @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
   @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func prependSeedItem(_ input: ShortKitSDK.FeedInput, scrollToId: Swift.String, animated: Swift.Bool = false)
   @_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()
@@ -757,7 +759,7 @@ public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
   }
 }
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil, contentId: Swift.String? = nil)
   case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
@@ -1309,8 +1311,12 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig, items: [ShortKitSDK.WidgetInput] = [])
   @_Concurrency.MainActor @preconcurrency final public func configure(with inputs: [ShortKitSDK.WidgetInput])
   @_Concurrency.MainActor @preconcurrency final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor @preconcurrency final public var onContentHeightChange: ((CoreFoundation.CGFloat) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public func appendItems(_ inputs: [ShortKitSDK.WidgetInput])
+  @_Concurrency.MainActor @preconcurrency final public func parentScrollViewDidScroll(_ scrollView: UIKit.UIScrollView)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidAppear(_ animated: Swift.Bool)
+  @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @objc deinit
 }
@@ -1319,6 +1325,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDataS
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, cellForItemAt indexPath: Foundation.IndexPath) -> UIKit.UICollectionViewCell
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDelegate {
+  @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
@@ -1326,15 +1333,26 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
-public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
-  case singleVisibleRotating
-  case allVisibleSimultaneous
-  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+public enum GridSide : Swift.Equatable, Swift.Sendable {
+  case left
+  case right
+  public static func == (a: ShortKitSDK.GridSide, b: ShortKitSDK.GridSide) -> Swift.Bool
   public func hash(into hasher: inout Swift.Hasher)
   public var hashValue: Swift.Int {
     get
   }
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  case gridAlternating(startSide: ShortKitSDK.GridSide = .left)
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+}
+public enum WidgetLayout : Swift.Equatable, Swift.Sendable {
+  case carousel
+  case grid(columns: Swift.Int, cellAspectRatio: CoreFoundation.CGFloat, scrollable: Swift.Bool = true)
+  public static func == (a: ShortKitSDK.WidgetLayout, b: ShortKitSDK.WidgetLayout) -> Swift.Bool
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1349,7 +1367,10 @@ public struct WidgetConfig {
   public var filter: ShortKitSDK.FeedFilter?
   public var playbackMode: ShortKitSDK.WidgetPlaybackMode
   public var previewDuration: Foundation.TimeInterval
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0)
+  public var layout: ShortKitSDK.WidgetLayout
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0, layout: ShortKitSDK.WidgetLayout = .carousel)
+  public func gridCellHeight(forContainerWidth width: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat?
+  public func preferredGridHeight(forContainerWidth width: CoreFoundation.CGFloat, itemCount: Swift.Int) -> CoreFoundation.CGFloat?
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1397,4 +1418,4 @@ extension ShortKitSDK.ContentSignal : Swift.Hashable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Equatable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Hashable {}
 extension ShortKitSDK.ShortKitPlayerView : Swift.Sendable {}
-extension ShortKitSDK.WidgetPlaybackMode : Swift.Hashable {}
+extension ShortKitSDK.GridSide : Swift.Hashable {}

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/_CodeSignature/CodeResources

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		HFe8gphNyV4HnieYCOqvkvgE3bY=
+		Cs7ninGkaeEsM46te6eSIHLmgXg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		SUdG/HxqdZ4xrQciGk0YP4IH5dg=
+		L4Yg0s3aa+1c1XmIAIrZHRzYNvQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		kMD88dAC4/UAXQveBEVyu416rZk=
+		xMdmv+0U00NSsruJaWmSIlom1bs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		VOTbFDsFlUk+zeSbdHV3CUJ4sbs=
+		e4GSx25gJNPA97uJPptjGkB+1g8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		kMD88dAC4/UAXQveBEVyu416rZk=
+		xMdmv+0U00NSsruJaWmSIlom1bs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		SUdG/HxqdZ4xrQciGk0YP4IH5dg=
+		L4Yg0s3aa+1c1XmIAIrZHRzYNvQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		S7MSFMJ213kJdVpeQfSzi4JI0aY=
+		g3mOfZ7sq0WA/rCy1I1B8ntNpzg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		fULOA1HVzJwVPDNXTIp5uNMx9R8=
+		K8qZOgsF77WMl7JAckFKEsGFisY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		S7MSFMJ213kJdVpeQfSzi4JI0aY=
+		g3mOfZ7sq0WA/rCy1I1B8ntNpzg=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			maGtk3nXMXwSSS9I07IQx70kOJspiS/8npTQ661BsnE=
+			OM/xe+QFfJO/Y6F1c3XeAySS607jBv1mZew38xHGSeo=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			4q40ucTr1qUkFbVYoihDDoBnnICmQ/lO/7JH1WKQzcw=
+			qEThIeJI38a6bWOqTKor6D7LUQTR1NR/NVm4xO0++M8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			dKQ8XFw0Is3GUAQat76xrMwYPR/5ZRiZoANThtyA56Q=
+			2XjILmglehGYxwR3tJ2Vlb0ip+L8Igt8zYaTWlGrKtA=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			4q40ucTr1qUkFbVYoihDDoBnnICmQ/lO/7JH1WKQzcw=
+			qEThIeJI38a6bWOqTKor6D7LUQTR1NR/NVm4xO0++M8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			maGtk3nXMXwSSS9I07IQx70kOJspiS/8npTQ661BsnE=
+			OM/xe+QFfJO/Y6F1c3XeAySS607jBv1mZew38xHGSeo=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E1GiseiMFLYmROiZwBW1bJ9EOsVO+0XjhLoQF9rW+Gk=
+			IqrEjcGhpsa/eVvO9xNR6I4ClHEmtNIAgl+HBAiWs3c=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			T8grir+EcdMC7s5ILrY4dZfCi++IEzyJW4sMxHJ6QYc=
+			9bw32+hb0vR9RAp330KHre34L3QC/CXfwZB6ZH1uSUE=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E1GiseiMFLYmROiZwBW1bJ9EOsVO+0XjhLoQF9rW+Gk=
+			IqrEjcGhpsa/eVvO9xNR6I4ClHEmtNIAgl+HBAiWs3c=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shortkitsdk/react-native",
-  "version": "0.2.46",
+  "version": "0.2.48",
   "description": "ShortKit React Native SDK — short-form video feed",
   "react-native": "src/index",
   "source": "src/index",

package/src/ShortKitCommands.ts

@@ -66,3 +66,42 @@ export const ShortKitCommands = {
   },
   cancelDownload: () => NativeShortKitModule?.cancelDownload(),
 } as const;
+
+/**
+ * Push a host-registered RN component onto the active feed's navigation
+ * controller with a native parallax-push animation.
+ *
+ * Only works when the feed was presented with a `feedMask` (the mask wraps
+ * the feed in a UINavigationController on iOS). Silently no-ops otherwise.
+ *
+ * Call this from an overlay component's author-tap or similar handler:
+ *
+ * ```tsx
+ * import { pushFeedScreen } from '@shortkitsdk/react-native';
+ *
+ * // In your overlay:
+ * pushFeedScreen('ProfileScreen', { author: item.author });
+ * ```
+ *
+ * The target component must be registered with AppRegistry:
+ * ```ts
+ * AppRegistry.registerComponent('ProfileScreen', () => ProfileScreen);
+ * ```
+ */
+export function pushFeedScreen(
+  componentName: string,
+  props?: Record<string, unknown>
+): void {
+  NativeShortKitModule?.pushFeedScreen(componentName, JSON.stringify(props ?? {}));
+}
+
+/**
+ * Pop the screen most recently pushed via `pushFeedScreen` from the feed
+ * modal's navigation stack with a native slide-back animation.
+ *
+ * Call this from within a component registered with AppRegistry and rendered
+ * via `pushFeedScreen` — typically wired to a back button or `navigation.goBack()`.
+ */
+export function popFeedScreen(): void {
+  NativeShortKitModule?.popFeedScreen();
+}

package/src/index.ts

@@ -53,6 +53,11 @@ export { registerOverlayComponent } from './ShortKitOverlaySurface';
 export { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
 export { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 export { registerFeedMaskComponent } from './ShortKitFeedMaskSurface';
+export { pushFeedScreen, popFeedScreen } from './ShortKitCommands';
+/** @internal Escape hatch — only use when ShortKitProvider is already initialized by the host app. */
+export { ShortKitInitContext } from './ShortKitContext';
+/** @internal Serialization helpers for use with NativeShortKitModule.preloadFeed in custom surface roots. */
+export { serializeFeedConfig, serializeFeedInputs } from './serialization';
 export type {
   OverlayProps,
   CarouselOverlayProps,

package/src/specs/NativeShortKitModule.ts

@@ -319,6 +319,10 @@ export interface Spec extends TurboModule {
   downloadVideo(itemId: string, mode: string, overlayMode: string): Promise<string>;
   cancelDownload(): void;
 
+  // --- Push navigation ---
+  pushFeedScreen(componentName: string, propsJSON: string): void;
+  popFeedScreen(): void;
+
   // --- Carousel accessors ---
   getCarouselActiveIndex(): Int32;
   getCarouselVideoCount(): Int32;