@shortkitsdk/react-native 0.2.27 → 0.2.29

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

@@ -442,6 +442,15 @@ public enum ShortKitDownloadError : Swift.Error {
   public typealias Body = Swift.Never
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
+public enum ShortKitFeedLifecycle {
+  case automatic
+  case manual
+  public static func == (a: ShortKitSDK.ShortKitFeedLifecycle, b: ShortKitSDK.ShortKitFeedLifecycle) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency public var debugPanelFactory: ((_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView)?
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
@@ -454,8 +463,12 @@ public enum ShortKitDownloadError : Swift.Error {
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onFeedTransition: ((ShortKitSDK.FeedTransitionEvent) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var isActiveSurface: Swift.Bool {
+    get
+  }
   @_Concurrency.MainActor @preconcurrency public var seedThumbnail: UIKit.UIImage?
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil, lifecycle: ShortKitSDK.ShortKitFeedLifecycle = .automatic)
   @_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])
@@ -465,6 +478,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_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)
+  @available(*, deprecated, message: "Pass lifecycle: .manual to ShortKitFeedViewController's initializer instead.")
   @_Concurrency.MainActor @preconcurrency public func setBridgeManaged()
   @_Concurrency.MainActor @preconcurrency public func activate()
   @_Concurrency.MainActor @preconcurrency public func deactivate()
@@ -472,6 +486,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public var supportedInterfaceOrientations: UIKit.UIInterfaceOrientationMask {
     @objc get
   }
+  @_Concurrency.MainActor public func refresh()
   @objc deinit
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public var canBecomeFirstResponder: Swift.Bool {
     @objc get
@@ -939,6 +954,9 @@ public struct FeedTransitionEvent : Swift.Equatable, Swift.Sendable {
   public let from: ShortKitSDK.ContentItem?
   public let to: ShortKitSDK.ContentItem?
   public let direction: ShortKitSDK.FeedTransitionEvent.Direction
+  public let fromFeedItem: ShortKitSDK.FeedItem?
+  public let toFeedItem: ShortKitSDK.FeedItem?
+  public init(phase: ShortKitSDK.FeedTransitionEvent.Phase, from: ShortKitSDK.ContentItem?, to: ShortKitSDK.ContentItem?, direction: ShortKitSDK.FeedTransitionEvent.Direction, fromFeedItem: ShortKitSDK.FeedItem? = nil, toFeedItem: ShortKitSDK.FeedItem? = nil)
   public static func == (a: ShortKitSDK.FeedTransitionEvent, b: ShortKitSDK.FeedTransitionEvent) -> Swift.Bool
 }
 public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
@@ -1141,8 +1159,8 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig)
-  @_Concurrency.MainActor @preconcurrency final public func configure(with items: [ShortKitSDK.ContentItem])
+  @_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 @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 viewWillDisappear(_ animated: Swift.Bool)
@@ -1175,6 +1193,9 @@ public struct WidgetConfig {
   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)
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
+public enum WidgetInput : Swift.Sendable {
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+}
 extension ShortKitSDK.AdQuartile : Swift.Equatable {}
 extension ShortKitSDK.AdQuartile : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
@@ -1187,6 +1208,8 @@ extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}

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

@@ -442,6 +442,15 @@ public enum ShortKitDownloadError : Swift.Error {
   public typealias Body = Swift.Never
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
+public enum ShortKitFeedLifecycle {
+  case automatic
+  case manual
+  public static func == (a: ShortKitSDK.ShortKitFeedLifecycle, b: ShortKitSDK.ShortKitFeedLifecycle) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency public var debugPanelFactory: ((_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView)?
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
@@ -454,8 +463,12 @@ public enum ShortKitDownloadError : Swift.Error {
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onFeedTransition: ((ShortKitSDK.FeedTransitionEvent) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var isActiveSurface: Swift.Bool {
+    get
+  }
   @_Concurrency.MainActor @preconcurrency public var seedThumbnail: UIKit.UIImage?
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
+  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil, lifecycle: ShortKitSDK.ShortKitFeedLifecycle = .automatic)
   @_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])
@@ -465,6 +478,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_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)
+  @available(*, deprecated, message: "Pass lifecycle: .manual to ShortKitFeedViewController's initializer instead.")
   @_Concurrency.MainActor @preconcurrency public func setBridgeManaged()
   @_Concurrency.MainActor @preconcurrency public func activate()
   @_Concurrency.MainActor @preconcurrency public func deactivate()
@@ -472,6 +486,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public var supportedInterfaceOrientations: UIKit.UIInterfaceOrientationMask {
     @objc get
   }
+  @_Concurrency.MainActor public func refresh()
   @objc deinit
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public var canBecomeFirstResponder: Swift.Bool {
     @objc get
@@ -939,6 +954,9 @@ public struct FeedTransitionEvent : Swift.Equatable, Swift.Sendable {
   public let from: ShortKitSDK.ContentItem?
   public let to: ShortKitSDK.ContentItem?
   public let direction: ShortKitSDK.FeedTransitionEvent.Direction
+  public let fromFeedItem: ShortKitSDK.FeedItem?
+  public let toFeedItem: ShortKitSDK.FeedItem?
+  public init(phase: ShortKitSDK.FeedTransitionEvent.Phase, from: ShortKitSDK.ContentItem?, to: ShortKitSDK.ContentItem?, direction: ShortKitSDK.FeedTransitionEvent.Direction, fromFeedItem: ShortKitSDK.FeedItem? = nil, toFeedItem: ShortKitSDK.FeedItem? = nil)
   public static func == (a: ShortKitSDK.FeedTransitionEvent, b: ShortKitSDK.FeedTransitionEvent) -> Swift.Bool
 }
 public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
@@ -1141,8 +1159,8 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
-  @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig)
-  @_Concurrency.MainActor @preconcurrency final public func configure(with items: [ShortKitSDK.ContentItem])
+  @_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 @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 viewWillDisappear(_ animated: Swift.Bool)
@@ -1175,6 +1193,9 @@ public struct WidgetConfig {
   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)
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
+public enum WidgetInput : Swift.Sendable {
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+}
 extension ShortKitSDK.AdQuartile : Swift.Equatable {}
 extension ShortKitSDK.AdQuartile : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
@@ -1187,6 +1208,8 @@ extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}

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

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		vTgqqfDJyF8GYp6hOl5ygsKZXpc=
+		SGnC4k70E9DgpOqahVfG8CzDvZA=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		1CWbP83M4niqwACjutv+h5bAQI8=
+		BO1VUECw+jNellCun0jhxv3t30k=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		SY4J8Ap5bvNmlGr2eHB/mIEc9/4=
+		CBxkj0soc11JQFMNAKh03fEskOQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		Jifa8RGekCm+oLvj1vexV+qHBxg=
+		Egfd+TPgbG9XhezyyhpOkJ9bZWs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		SY4J8Ap5bvNmlGr2eHB/mIEc9/4=
+		CBxkj0soc11JQFMNAKh03fEskOQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		1CWbP83M4niqwACjutv+h5bAQI8=
+		BO1VUECw+jNellCun0jhxv3t30k=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		RSB+lYIOsHV+EHcf6nw6updgwoE=
+		KDzWlPhZbTYIibjJVtICWSKv9cs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		4SaiyfqnnCuP3NHBedJ86U5WUvk=
+		CbLKbJe6jCpRFjhJ5MJ7F7Um93M=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		RSB+lYIOsHV+EHcf6nw6updgwoE=
+		KDzWlPhZbTYIibjJVtICWSKv9cs=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			6osxQFoWx1z1shKfM1SJVKzrEMvwpavL4nz8CXhPCf0=
+			fHbFQio59u+N64dapbLRpLdCd4VatCDVkbn5qTzHCxc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			1/jxH+/lRA97UGj3ZA78cxyVLWeDthh0KFAHyutYAGs=
+			Ct1MN9BrXD/Rkc+lJb6iANMaf9f+RwWB4+pYW/i+3Ek=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			1ZNQBox7b3AwcLy9/eOdX9J9kLPO6aiDoKklf4b+uDw=
+			aLVo05BXMvhibMAdWTtKpK4Ezm91V9IJz/GAm9WDhLw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			1/jxH+/lRA97UGj3ZA78cxyVLWeDthh0KFAHyutYAGs=
+			Ct1MN9BrXD/Rkc+lJb6iANMaf9f+RwWB4+pYW/i+3Ek=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			6osxQFoWx1z1shKfM1SJVKzrEMvwpavL4nz8CXhPCf0=
+			fHbFQio59u+N64dapbLRpLdCd4VatCDVkbn5qTzHCxc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			LcZQmnn2zALd1t49D1Ky9DkTE/qLtiA/Y8X7G8X0tpA=
+			4rQvWmFNy7cluozJQCGW3y7OdbgvVQco8KNNJ5gFrhc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			rFL1rnzbA6I/ynZT99TT87vcqERbX/oj+lvvjIITisM=
+			mVc5JWN6Fy34JoJsotmdTST52bcYpwdaOl1WZGL42xs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			LcZQmnn2zALd1t49D1Ky9DkTE/qLtiA/Y8X7G8X0tpA=
+			4rQvWmFNy7cluozJQCGW3y7OdbgvVQco8KNNJ5gFrhc=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/ShortKitWidgetNativeView.swift

@@ -6,7 +6,7 @@ import ShortKitSDK
 ///
 /// Props (set by RCTViewManager):
 /// - `config`: JSON string with WidgetConfig values
-/// - `items`: JSON string with ContentItem array
+/// - `items`: JSON string with WidgetInput array (compact playback-ID form)
 @objc public class ShortKitWidgetNativeView: UIView {
 
     // MARK: - Props
@@ -29,6 +29,7 @@ import ShortKitSDK
 
     private var widgetVC: ShortKitWidgetViewController?
     private var parsedConfig: WidgetConfig?
+    private var parsedItems: [WidgetInput] = []
 
     // MARK: - Lifecycle
 
@@ -60,7 +61,9 @@ import ShortKitSDK
 
         let widgetConfig = parsedConfig ?? WidgetConfig()
 
-        let vc = ShortKitWidgetViewController(shortKit: sdk, config: widgetConfig)
+        // Pass items at construction so the VC never races the server fetch —
+        // analogous to the feed's `feedItems` prop wiring.
+        let vc = ShortKitWidgetViewController(shortKit: sdk, config: widgetConfig, items: parsedItems)
         self.widgetVC = vc
 
         parentVC.addChild(vc)
@@ -68,11 +71,6 @@ import ShortKitSDK
         vc.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
         addSubview(vc.view)
         vc.didMove(toParent: parentVC)
-
-        // If items were already set, apply them
-        if let json = items, let contentItems = Self.parseContentItems(json) {
-            vc.configure(with: contentItems)
-        }
     }
 
     private func removeWidgetVC() {
@@ -95,8 +93,11 @@ import ShortKitSDK
     }
 
     private func applyItems() {
-        guard let json = items, let contentItems = Self.parseContentItems(json) else { return }
-        widgetVC?.configure(with: contentItems)
+        parsedItems = items.flatMap { Self.parseWidgetInputs($0) } ?? []
+        // Post-mount updates: push items through the public API.
+        if let vc = widgetVC {
+            vc.configure(with: parsedItems)
+        }
     }
 
     // MARK: - Parsing
@@ -140,6 +141,11 @@ import ShortKitSDK
             return ShortKitBridge.parseFeedFilter(filterStr)
         }()
 
+        let feedConfig: FeedConfig = {
+            guard let feedConfigStr = obj["feedConfig"] as? String else { return FeedConfig() }
+            return ShortKitBridge.parseFeedConfig(feedConfigStr)
+        }()
+
         return WidgetConfig(
             cardCount: cardCount,
             cardSpacing: cardSpacing,
@@ -150,13 +156,28 @@ import ShortKitSDK
             rotationInterval: rotationInterval / 1000.0, // JS sends ms, iOS expects seconds
             clickAction: clickAction,
             cardOverlay: overlayMode,
+            feedConfig: feedConfig,
             filter: filter
         )
     }
 
-    private static func parseContentItems(_ json: String) -> [ContentItem]? {
-        guard let data = json.data(using: .utf8) else { return nil }
-        return try? JSONDecoder().decode([ContentItem].self, from: data)
+    /// Parse a JSON array of `WidgetInput` values (compact playback-ID form).
+    /// Mirrors the JS `WidgetInput` type: `{ type: 'video'; playbackId: string; origin?: string; fallbackUrl?: string }`.
+    private static func parseWidgetInputs(_ json: String) -> [WidgetInput]? {
+        guard let data = json.data(using: .utf8),
+              let arr = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]] else {
+            return nil
+        }
+        return arr.compactMap { obj -> WidgetInput? in
+            guard let type = obj["type"] as? String, type == "video",
+                  let playbackId = obj["playbackId"] as? String else { return nil }
+            let origin: ContentOrigin = {
+                guard let s = obj["origin"] as? String else { return .other }
+                return s == "ios_upload" ? .iosUpload : .other
+            }()
+            let fallbackUrl = obj["fallbackUrl"] as? String
+            return .video(playbackId: playbackId, origin: origin, fallbackUrl: fallbackUrl)
+        }
     }
 
     // MARK: - Helpers

package/package.json

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

package/src/ShortKitFeed.tsx

@@ -76,6 +76,9 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     applyFilter: (filter: FeedFilter | null) => {
       NativeShortKitModule?.applyFilter(feedId, filter ? JSON.stringify(filter) : null);
     },
+    refresh: () => {
+      NativeShortKitModule?.refresh(feedId);
+    },
   }), [feedId]);
 
   // Subscribe to per-feed remaining content count events
@@ -160,6 +163,11 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onLoop) {
       subscriptions.push(
         NativeShortKitModule.onDidLoop((event) => {
+          // Filter to this feed instance — onDidLoop is fired from the
+          // shared player's global Combine publisher. The native bridge
+          // tags the emit with the active surface's feedId; reject events
+          // that don't match. Accept empty feedId for forward-compat.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onLoop({ contentId: event.contentId, loopCount: event.loopCount });
         }),
       );
@@ -168,6 +176,16 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onFeedTransition) {
       subscriptions.push(
         NativeShortKitModule.onFeedTransition((event) => {
+          // Filter to this feed instance — `player.feedTransition` is a
+          // singleton publisher on the shared player; the native bridge now
+          // tags the emit with the active surface's feedId. Without this
+          // filter, every <ShortKitFeed> consumer receives every transition,
+          // which caused cross-tab state pollution (e.g., sibling tabs'
+          // onCurrentItemIdChange handlers firing on the active tab's
+          // scroll, leaking that item ID into their own startAtItemId).
+          // Accept empty feedId as a fallback for older native builds that
+          // don't tag the emit yet — same pattern as other callbacks here.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onFeedTransition({
             phase: event.phase as 'began' | 'ended',
             from: deserializeContentItem(event.fromItem ?? null),
@@ -181,6 +199,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onFormatChange) {
       subscriptions.push(
         NativeShortKitModule.onFormatChange((event) => {
+          // Filter to this feed instance — onFormatChange fires from the
+          // shared player's global publisher; bridge tags with active
+          // surface's feedId. Reject events addressed to other feeds.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onFormatChange({
             contentId: event.contentId,
             fromBitrate: event.fromBitrate,
@@ -195,6 +217,9 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onContentTapped) {
       subscriptions.push(
         NativeShortKitModule.onContentTapped((event) => {
+          // Filter to this feed instance — ShortKitDelegate is a singleton
+          // (bridge); native side tags with active surface's feedId.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onContentTapped(event.contentId, event.index);
         }),
       );
@@ -226,6 +251,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onDidFetchContentItems) {
       subscriptions.push(
         NativeShortKitModule.onDidFetchContentItems((event) => {
+          // Filter to this feed instance — ShortKitDelegate is a singleton
+          // (bridge); native side tags with active surface's feedId (at
+          // delegate call time, before any Task/await suspension).
+          if (event.feedId !== feedId && event.feedId !== '') return;
           try {
             const items = JSON.parse(event.items);
             onDidFetchContentItems(items);
@@ -239,6 +268,11 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onCarouselActiveVideoCompleted) {
       subscriptions.push(
         NativeShortKitModule.onCarouselActiveVideoCompleted((event) => {
+          // Filter to this feed instance — overlay events were previously
+          // unscoped per-feed; native side now tags with active surface's
+          // feedId. surfaceId continues to identify the React overlay host
+          // (separate concern from feedId).
+          if (event.feedId !== feedId && event.feedId !== '') return;
           try {
             onCarouselActiveVideoCompleted({
               surfaceId: event.surfaceId,

package/src/ShortKitPlayer.tsx

@@ -1,7 +1,11 @@
-import React, { useMemo } from 'react';
+import React, { useLayoutEffect, useMemo } from 'react';
 import { View, StyleSheet } from 'react-native';
 import type { ShortKitPlayerProps } from './types';
 import ShortKitPlayerView from './specs/ShortKitPlayerViewNativeComponent';
+import { serializePlayerConfig } from './serialization';
+import { registerOverlayComponent } from './ShortKitOverlaySurface';
+import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
+import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 
 /**
  * Single-video player component. Displays one video with thumbnail fallback
@@ -19,21 +23,27 @@ export function ShortKitPlayer(props: ShortKitPlayerProps) {
 
   const clickAction = config?.clickAction ?? 'feed';
 
+  useLayoutEffect(() => {
+    if (config?.overlay && config.overlay !== 'none') {
+      registerOverlayComponent(config.overlay.name, config.overlay.component);
+    }
+    if (config?.feedConfig) {
+      const fc = config.feedConfig;
+      if (fc.overlay && fc.overlay !== 'none') {
+        registerOverlayComponent(fc.overlay.name, fc.overlay.component);
+      }
+      if (fc.carouselOverlay && fc.carouselOverlay !== 'none') {
+        registerCarouselOverlayComponent(fc.carouselOverlay.name, fc.carouselOverlay.component);
+      }
+      if (fc.videoCarouselOverlay && fc.videoCarouselOverlay !== 'none') {
+        registerVideoCarouselOverlayComponent(fc.videoCarouselOverlay.name, fc.videoCarouselOverlay.component);
+      }
+    }
+  }, [config?.overlay, config?.feedConfig]);
+
   const serializedConfig = useMemo(() => {
-    const cfg = config ?? {};
-    return JSON.stringify({
-      cornerRadius: cfg.cornerRadius ?? 12,
-      clickAction: clickAction,
-      autoplay: cfg.autoplay ?? true,
-      loop: cfg.loop ?? true,
-      muteOnStart: cfg.muteOnStart ?? true,
-      overlay: cfg.overlay
-        ? typeof cfg.overlay === 'string'
-          ? cfg.overlay
-          : { type: 'custom' }
-        : 'none',
-    });
-  }, [config, clickAction]);
+    return serializePlayerConfig(config ?? {});
+  }, [config]);
 
   const serializedItem = useMemo(() => {
     if (!contentItem) return undefined;

package/src/ShortKitWidget.tsx

@@ -1,8 +1,12 @@
-import React, { useContext, useMemo } from 'react';
+import React, { useContext, useLayoutEffect, useMemo } from 'react';
 import { View, StyleSheet } from 'react-native';
 import type { ShortKitWidgetProps } from './types';
 import ShortKitWidgetView from './specs/ShortKitWidgetViewNativeComponent';
 import { ShortKitInitContext } from './ShortKitContext';
+import { serializeWidgetConfig } from './serialization';
+import { registerOverlayComponent } from './ShortKitOverlaySurface';
+import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
+import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 
 /**
  * Horizontal carousel widget component. Displays a row of video cards
@@ -18,24 +22,26 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
     throw new Error('ShortKitWidget must be used within a ShortKitProvider');
   }
 
+  useLayoutEffect(() => {
+    if (config?.overlay && config.overlay !== 'none') {
+      registerOverlayComponent(config.overlay.name, config.overlay.component);
+    }
+    if (config?.feedConfig) {
+      const fc = config.feedConfig;
+      if (fc.overlay && fc.overlay !== 'none') {
+        registerOverlayComponent(fc.overlay.name, fc.overlay.component);
+      }
+      if (fc.carouselOverlay && fc.carouselOverlay !== 'none') {
+        registerCarouselOverlayComponent(fc.carouselOverlay.name, fc.carouselOverlay.component);
+      }
+      if (fc.videoCarouselOverlay && fc.videoCarouselOverlay !== 'none') {
+        registerVideoCarouselOverlayComponent(fc.videoCarouselOverlay.name, fc.videoCarouselOverlay.component);
+      }
+    }
+  }, [config?.overlay, config?.feedConfig]);
+
   const serializedConfig = useMemo(() => {
-    const cfg = config ?? {};
-    return JSON.stringify({
-      cardCount: cfg.cardCount ?? 3,
-      cardSpacing: cfg.cardSpacing ?? 8,
-      cornerRadius: cfg.cornerRadius ?? 12,
-      autoplay: cfg.autoplay ?? true,
-      muteOnStart: cfg.muteOnStart ?? true,
-      loop: cfg.loop ?? true,
-      rotationInterval: cfg.rotationInterval ?? 10000,
-      clickAction: cfg.clickAction ?? 'feed',
-      overlay: cfg.overlay
-        ? typeof cfg.overlay === 'string'
-          ? cfg.overlay
-          : { type: 'custom' }
-        : 'none',
-      filter: cfg.filter ? JSON.stringify(cfg.filter) : undefined,
-    });
+    return serializeWidgetConfig(config ?? {});
   }, [config]);
 
   const serializedItems = useMemo(() => {

package/src/index.ts

@@ -16,6 +16,7 @@ export type {
   PlayerConfig,
   PlayerClickAction,
   WidgetConfig,
+  WidgetInput,
 
   ContentItem,
   CarouselImage,

package/src/serialization.ts

@@ -4,6 +4,9 @@ import type {
   FeedInput,
   PlayerState,
   PlayerTime,
+  WidgetConfig,
+  PlayerConfig,
+  OverlayConfig,
   VideoCarouselVideoInput,
 } from './types';
 
@@ -130,3 +133,38 @@ export function serializeFeedInputs(items: FeedInput[]): string {
   });
   return JSON.stringify(serialized);
 }
+
+function serializeOverlay(overlay: OverlayConfig | undefined): string | { type: 'custom'; name: string } {
+  if (!overlay || overlay === 'none') return 'none';
+  return { type: 'custom', name: overlay.name };
+}
+
+export function serializeWidgetConfig(config: WidgetConfig): string {
+  const cfg = config ?? {};
+  return JSON.stringify({
+    cardCount: cfg.cardCount ?? 3,
+    cardSpacing: cfg.cardSpacing ?? 8,
+    cornerRadius: cfg.cornerRadius ?? 12,
+    autoplay: cfg.autoplay ?? true,
+    muteOnStart: cfg.muteOnStart ?? true,
+    loop: cfg.loop ?? true,
+    rotationInterval: cfg.rotationInterval ?? 10000,
+    clickAction: cfg.clickAction ?? 'feed',
+    overlay: serializeOverlay(cfg.overlay),
+    filter: cfg.filter ? JSON.stringify(cfg.filter) : undefined,
+    feedConfig: cfg.feedConfig ? serializeFeedConfig(cfg.feedConfig) : undefined,
+  });
+}
+
+export function serializePlayerConfig(config: PlayerConfig): string {
+  const cfg = config ?? {};
+  return JSON.stringify({
+    cornerRadius: cfg.cornerRadius ?? 12,
+    clickAction: cfg.clickAction ?? 'feed',
+    autoplay: cfg.autoplay ?? true,
+    loop: cfg.loop ?? true,
+    muteOnStart: cfg.muteOnStart ?? true,
+    overlay: serializeOverlay(cfg.overlay),
+    feedConfig: cfg.feedConfig ? serializeFeedConfig(cfg.feedConfig) : undefined,
+  });
+}