@shortkitsdk/react-native 0.2.34 → 0.2.36

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

@@ -556,6 +556,14 @@ public enum ShortKitFeedLifecycle {
     get
   }
 }
+public enum VideoCarouselCellLongPressState : Swift.String {
+  case began, ended, cancelled
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    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)?
@@ -567,6 +575,13 @@ public enum ShortKitFeedLifecycle {
     public let pageIndex: Swift.Int
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
+  public struct VideoCarouselCellLongPressPayload {
+    public let id: Swift.String
+    public let index: Swift.Int
+    public let pageIndex: Swift.Int
+    public let state: ShortKitSDK.VideoCarouselCellLongPressState
+  }
+  @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellLongPress: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellLongPressPayload) -> 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 {
@@ -893,12 +908,13 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
 public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.VideoCarouselVideoInput]
+  public let initialPageIndex: Swift.Int?
   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, videos: [ShortKitSDK.VideoCarouselVideoInput], 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, videos: [ShortKitSDK.VideoCarouselVideoInput], initialPageIndex: Swift.Int? = 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.VideoCarouselInput, b: ShortKitSDK.VideoCarouselInput) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -906,12 +922,16 @@ public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendabl
 public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.ContentItem]
+  public let initialPageIndex: Swift.Int?
   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, videos: [ShortKitSDK.ContentItem], 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, videos: [ShortKitSDK.ContentItem], initialPageIndex: Swift.Int? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public var clampedInitialPageIndex: Swift.Int {
+    get
+  }
   public static func == (a: ShortKitSDK.VideoCarouselItem, b: ShortKitSDK.VideoCarouselItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -1165,6 +1185,7 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public func setMaxBitrate(_ bps: Swift.Int)
   final public func setCaptionsEnabled(_ enabled: Swift.Bool)
   final public func selectCaptionTrack(language: Swift.String)
+  final public func setFeedScrollEnabled(_ enabled: Swift.Bool)
   final public func dismissLiveRoom()
   final public func seekThumbnail(at time: Swift.Double) -> UIKit.UIImage?
   @objc deinit
@@ -1279,6 +1300,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 final public var onCardTap: ((Swift.String, Swift.Int) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public var onModalFeedPresented: ((ShortKitSDK.ShortKitFeedViewController) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public var onModalFeedDismissed: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency final public var active: Swift.Bool {
     get
     set
@@ -1355,6 +1378,9 @@ extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
 extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.Equatable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.Hashable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.RawRepresentable {}
 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

@@ -556,6 +556,14 @@ public enum ShortKitFeedLifecycle {
     get
   }
 }
+public enum VideoCarouselCellLongPressState : Swift.String {
+  case began, ended, cancelled
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    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)?
@@ -567,6 +575,13 @@ public enum ShortKitFeedLifecycle {
     public let pageIndex: Swift.Int
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
+  public struct VideoCarouselCellLongPressPayload {
+    public let id: Swift.String
+    public let index: Swift.Int
+    public let pageIndex: Swift.Int
+    public let state: ShortKitSDK.VideoCarouselCellLongPressState
+  }
+  @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellLongPress: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellLongPressPayload) -> 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 {
@@ -893,12 +908,13 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
 public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.VideoCarouselVideoInput]
+  public let initialPageIndex: Swift.Int?
   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, videos: [ShortKitSDK.VideoCarouselVideoInput], 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, videos: [ShortKitSDK.VideoCarouselVideoInput], initialPageIndex: Swift.Int? = 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.VideoCarouselInput, b: ShortKitSDK.VideoCarouselInput) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -906,12 +922,16 @@ public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendabl
 public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.ContentItem]
+  public let initialPageIndex: Swift.Int?
   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, videos: [ShortKitSDK.ContentItem], 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, videos: [ShortKitSDK.ContentItem], initialPageIndex: Swift.Int? = nil, title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public var clampedInitialPageIndex: Swift.Int {
+    get
+  }
   public static func == (a: ShortKitSDK.VideoCarouselItem, b: ShortKitSDK.VideoCarouselItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -1165,6 +1185,7 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public func setMaxBitrate(_ bps: Swift.Int)
   final public func setCaptionsEnabled(_ enabled: Swift.Bool)
   final public func selectCaptionTrack(language: Swift.String)
+  final public func setFeedScrollEnabled(_ enabled: Swift.Bool)
   final public func dismissLiveRoom()
   final public func seekThumbnail(at time: Swift.Double) -> UIKit.UIImage?
   @objc deinit
@@ -1279,6 +1300,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 final public var onCardTap: ((Swift.String, Swift.Int) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public var onModalFeedPresented: ((ShortKitSDK.ShortKitFeedViewController) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public var onModalFeedDismissed: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency final public var active: Swift.Bool {
     get
     set
@@ -1355,6 +1378,9 @@ extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
 extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.Equatable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.Hashable {}
+extension ShortKitSDK.VideoCarouselCellLongPressState : Swift.RawRepresentable {}
 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>
-		kXOjURx+Z1d6/6VN46mtXJY4tGs=
+		WQrFujyFbopBKGGWbEKoC1woXeM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		IFMuyXGMCXuNezRhYjKHLUu9xA4=
+		mwN55YBG0lFbYyqh8rFLlhydUhg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		v3GW9Gub1dJiosTgJ/z5NwmgWnY=
+		VtQKD6iU2DxNLUgN8Nm9hVEd+LA=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		0oQnp4oNo+Ztwgww53FIZhz0zfM=
+		RYBSyi3j5xH2WhtxZngr8vlpDDM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		v3GW9Gub1dJiosTgJ/z5NwmgWnY=
+		VtQKD6iU2DxNLUgN8Nm9hVEd+LA=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		IFMuyXGMCXuNezRhYjKHLUu9xA4=
+		mwN55YBG0lFbYyqh8rFLlhydUhg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		Duv2bgxehsG2ZV4wnlh7s8/WzFk=
+		l/8aNIdTZYrYfdGjeCunQev+z2s=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		Cu/J3KUQmcbxz8bCf9NQZ5aVBTM=
+		dK384fZQxXLFp6AahpyFqGJOfnY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		Duv2bgxehsG2ZV4wnlh7s8/WzFk=
+		l/8aNIdTZYrYfdGjeCunQev+z2s=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			N/7VIAsF7mG+qU52BV03Pbvk+uQA/UoDg7z3aLRvEm4=
+			lPV80dTyQRi3R5Al7WxpvZYLMH1fLtDMRPj8kH++RCs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			HHpbkQ91Av7qOwHoz6asjSQ4d9TzPj7Lg+sxPVOhA30=
+			rf7zOX3BNWSgC2Lvt4rs/pTvzoqY4r2easqa7IcD/BY=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			pbR9S11lEANUEhT1e5NkK796Tecps3q6SosOoeuApuQ=
+			U33t59L18Q9DqIsgOyi6pcHV+IuHxLRdntw2IQW1DLo=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			HHpbkQ91Av7qOwHoz6asjSQ4d9TzPj7Lg+sxPVOhA30=
+			rf7zOX3BNWSgC2Lvt4rs/pTvzoqY4r2easqa7IcD/BY=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			N/7VIAsF7mG+qU52BV03Pbvk+uQA/UoDg7z3aLRvEm4=
+			lPV80dTyQRi3R5Al7WxpvZYLMH1fLtDMRPj8kH++RCs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			6nFBIiTjaP5xmdLc7I/x9j4ASiT2UjNnxKmRYUGmLXw=
+			c3dj4IBlPLhIqbUCIQDEpGHL5WE7f1b16++z2hPOOTU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Yx9LmEqOq+aeF+mSiKZyfw0FW/BySAPRrQMVzDyEiUU=
+			kFhyC63KxDPM8/iRTzRd5M1FO7ojEQzF0migxa4EIpU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			6nFBIiTjaP5xmdLc7I/x9j4ASiT2UjNnxKmRYUGmLXw=
+			c3dj4IBlPLhIqbUCIQDEpGHL5WE7f1b16++z2hPOOTU=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/ShortKitWidgetNativeView.swift

@@ -25,12 +25,24 @@ import ShortKitSDK
         }
     }
 
-    /// Stable per-instance widget identifier set by the JS wrapper. Echoed
+    /// Stable per-instance widget identifier set by the JS wrapper when the
+    /// host has wired `onCardTap` and wants to handle taps itself. Echoed
     /// back on `onWidgetCardTap` events so the JS wrapper can route the
-    /// global emit to the correct `<ShortKitWidget>` instance when more than
-    /// one is mounted simultaneously.
+    /// global emit to the correct `<ShortKitWidget>` instance when more
+    /// than one is mounted simultaneously. Presence of this id signals
+    /// "host takes over taps" — the native side wires `vc.onCardTap`
+    /// which makes the SDK skip its built-in modal-present path.
     @objc public var widgetId: String?
 
+    /// Stable per-instance modal-feed identifier set by the JS wrapper when
+    /// the host has wired per-feed callbacks (e.g.
+    /// `feedConfig.onDidFetchContentItems`) and wants to receive scoped
+    /// events from the SDK's built-in modal feed. Independent from
+    /// `widgetId` — the host can wire modal callbacks WITHOUT taking over
+    /// taps. Used as the `feedId` under which the modal feed VC is
+    /// registered with the bridge on present.
+    @objc public var modalFeedId: String?
+
     /// Mirrors `ShortKitWidgetViewController.active`. Hosts use this to
     /// release the widget's pool tile when it shouldn't be playing
     /// (e.g. inactive tab, scrolled off-screen). Defaults to `true` so
@@ -172,6 +184,21 @@ import ShortKitSDK
             }
         }
 
+        // Register the SDK's built-in modal feed VC with the bridge under
+        // the JS-supplied `modalFeedId` so per-feed callbacks wired on the
+        // widget's `feedConfig` (e.g. `onDidFetchContentItems`) get scoped
+        // attribution. The JS wrapper supplies this id only when at least
+        // one such callback is set; absent it, the modal still presents
+        // and runs normally — events just emit with empty feedId.
+        if let id = modalFeedId {
+            vc.onModalFeedPresented = { feedVC in
+                ShortKitBridge.shared?.registerFeed(id: id, viewController: feedVC)
+            }
+            vc.onModalFeedDismissed = {
+                ShortKitBridge.shared?.unregisterFeed(id: id)
+            }
+        }
+
         parentVC.addChild(vc)
         vc.view.frame = bounds
         vc.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]

package/ios/ShortKitWidgetNativeViewManager.mm

@@ -24,6 +24,7 @@ RCT_EXPORT_MODULE(ShortKitWidgetView)
 RCT_EXPORT_VIEW_PROPERTY(config, NSString)
 RCT_EXPORT_VIEW_PROPERTY(items, NSString)
 RCT_EXPORT_VIEW_PROPERTY(widgetId, NSString)
+RCT_EXPORT_VIEW_PROPERTY(modalFeedId, NSString)
 RCT_EXPORT_VIEW_PROPERTY(active, BOOL)
 RCT_EXPORT_VIEW_PROPERTY(feedItems, NSString)
 

package/package.json

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

package/src/ShortKitCommands.ts

@@ -28,6 +28,26 @@ export const ShortKitCommands = {
     NativeShortKitModule?.sendContentSignal(signal),
   setMaxBitrate: (bitrate: number) =>
     NativeShortKitModule?.setMaxBitrate(bitrate),
+  /**
+   * Toggle feed scroll while an overlay-owned gesture is in flight.
+   *
+   * Hosts use this to grant exclusive priority to an in-flight gesture in
+   * an overlay (e.g. a horizontal scrubber drag) so the feed's pan
+   * recognizer can't steal the touch mid-drag. Pair the call: pass
+   * `false` when the host gesture starts (RN PanResponder grant), `true`
+   * when it ends or is cancelled (release / terminate).
+   *
+   * iOS: toggles the active feed view controller's
+   * `collectionView.panGestureRecognizer.isEnabled`. No-op when no feed
+   * VC is currently active.
+   *
+   * Android: fans out across every registered feed (including any masked
+   * underlay), toggling each `ViewPager2.isUserInputEnabled`. Intentional
+   * divergence from iOS — broader fan-out is simpler and has the same
+   * user-visible effect since only the active feed is interactable.
+   */
+  setFeedScrollEnabled: (enabled: boolean) =>
+    NativeShortKitModule?.setFeedScrollEnabled(enabled),
   prefetchStoryboard: (playbackId: string) =>
     NativeShortKitModule?.prefetchStoryboard(playbackId),
   getStoryboardData: (playbackId: string): Promise<string | null> =>

package/src/ShortKitFeed.tsx

@@ -47,6 +47,7 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     onFeedReady,
     onCarouselActiveVideoCompleted,
     onVideoCarouselCellTap,
+    onVideoCarouselCellLongPress,
     debugPanel,
   } = props;
 
@@ -126,6 +127,26 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     return () => subscription.remove();
   }, [feedId, onVideoCarouselCellTap]);
 
+  // Subscribe to per-feed video-carousel cell long-press events
+  useEffect(() => {
+    if (!NativeShortKitModule || !onVideoCarouselCellLongPress) return;
+
+    const subscription = NativeShortKitModule.onVideoCarouselCellLongPress((event) => {
+      if (event.feedId === feedId) {
+        // Bridge emits `state` as plain `string` (codegen constraint);
+        // the native side only ever emits these three values.
+        onVideoCarouselCellLongPress({
+          id: event.id,
+          index: event.index,
+          pageIndex: event.pageIndex,
+          state: event.state as 'began' | 'ended' | 'cancelled',
+        });
+      }
+    });
+
+    return () => subscription.remove();
+  }, [feedId, onVideoCarouselCellLongPress]);
+
   // Register overlay components before native view mounts.
   // useLayoutEffect fires after commit but before paint — before
   // didMoveToWindow/onAttachedToWindow on the native view.

package/src/ShortKitPlayer.tsx

@@ -1,5 +1,5 @@
 import React, { useLayoutEffect, useMemo } from 'react';
-import { View, StyleSheet } from 'react-native';
+import { Platform, View, StyleSheet } from 'react-native';
 import type { ShortKitPlayerProps } from './types';
 import ShortKitPlayerView from './specs/ShortKitPlayerViewNativeComponent';
 import { serializePlayerConfig } from './serialization';
@@ -8,6 +8,11 @@ import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurfa
 import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 import { registerFeedMaskComponent } from './ShortKitFeedMaskSurface';
 
+// One-time dev warning when ShortKitPlayer is rendered on Android. The
+// Android SDK was scoped down to feed-only in #246; the JS surface stays
+// for iOS but renders an empty container on Android.
+let didWarnAndroidPlayerUnavailable = false;
+
 /**
  * Single-video player component. Displays one video with thumbnail fallback
  * and optional overlay. Wraps a native Fabric view.
@@ -75,6 +80,20 @@ export function ShortKitPlayer(props: ShortKitPlayerProps) {
   // is fully invisible to hit testing.
   const nativeTouchPassthrough = clickAction === 'none';
 
+  // Android: the native ViewManager backing ShortKitPlayer was removed in
+  // #246 (feed-only scope-down). The JS surface stays so cross-platform
+  // host code compiles, but renders an empty container.
+  if (Platform.OS === 'android') {
+    if (__DEV__ && !didWarnAndroidPlayerUnavailable) {
+      didWarnAndroidPlayerUnavailable = true;
+      // eslint-disable-next-line no-console
+      console.warn(
+        '[ShortKit] <ShortKitPlayer> is not supported on Android — rendering an empty container.',
+      );
+    }
+    return <View style={[styles.container, style]} />;
+  }
+
   return (
     <View
       style={[styles.container, style]}

package/src/ShortKitWidget.tsx

@@ -1,5 +1,5 @@
 import React, { useContext, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
-import { View, StyleSheet } from 'react-native';
+import { Platform, View, StyleSheet } from 'react-native';
 import type { ShortKitWidgetProps } from './types';
 import ShortKitWidgetView from './specs/ShortKitWidgetViewNativeComponent';
 import NativeShortKitModule from './specs/NativeShortKitModule';
@@ -10,6 +10,11 @@ import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurfa
 import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 import { registerFeedMaskComponent } from './ShortKitFeedMaskSurface';
 
+// One-time dev warning when ShortKitWidget is rendered on Android. The
+// Android SDK was scoped down to feed-only in #246; the JS surface stays
+// for iOS but renders an empty container on Android.
+let didWarnAndroidWidgetUnavailable = false;
+
 // Local UUID generator. We don't pull in a runtime dep just for this; a
 // timestamp + random suffix is more than unique enough to disambiguate
 // concurrently-mounted widgets within a single app session.
@@ -31,28 +36,36 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
     throw new Error('ShortKitWidget must be used within a ShortKitProvider');
   }
 
-  // Stable widget ID for the lifetime of this component, ONLY when the host
-  // wires `onCardTap`. Skipping it when unset means the native side leaves
-  // `widgetVC.onCardTap` nil, which means the SDK's existing
-  // `clickAction: 'feed'` modal-presentation path stays intact for hosts
-  // that don't opt in. Backwards compatible.
+  // Stable widget ID, generated only when the host wires `onCardTap`.
+  // Presence on the native side signals "host handles taps" and the SDK
+  // skips its built-in modal-presentation path. Backwards compatible —
+  // hosts who don't wire `onCardTap` see no behavior change.
   const widgetId = useMemo(
     () => (onCardTap ? generateWidgetId() : undefined),
-    // We deliberately compute this once per "host wired callback" lifetime,
-    // not per render. The boolean test on first render is what matters; if
-    // the host swaps onCardTap from set → unset later we keep the same
-    // widgetId (harmless — no events will fire because the JS subscription
-    // below tears down). Going the other way (unset → set), we generate a
-    // fresh id then.
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [Boolean(onCardTap)],
   );
 
-  // Keep a stable ref to the latest onCardTap so the subscription doesn't
-  // need to tear down + rebuild every time the host re-renders with a new
-  // closure identity.
+  // Stable modal-feed ID, generated only when the host wires per-feed
+  // callbacks on the expanded modal feed (currently
+  // `feedConfig.onDidFetchContentItems`). Independent from `widgetId` —
+  // hosts can subscribe to modal events without taking over taps. The
+  // native side registers the modal feed VC under this id so emits get
+  // scoped back to this widget's callbacks.
+  const onDidFetchContentItems = config?.feedConfig?.onDidFetchContentItems;
+  const modalFeedId = useMemo(
+    () => (onDidFetchContentItems ? generateWidgetId() : undefined),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [Boolean(onDidFetchContentItems)],
+  );
+
+  // Keep stable refs to the latest callbacks so subscriptions don't need to
+  // tear down + rebuild every time the host re-renders with a new closure
+  // identity.
   const onCardTapRef = useRef(onCardTap);
   onCardTapRef.current = onCardTap;
+  const onDidFetchContentItemsRef = useRef(onDidFetchContentItems);
+  onDidFetchContentItemsRef.current = onDidFetchContentItems;
 
   useLayoutEffect(() => {
     if (config?.overlay && config.overlay !== 'none') {
@@ -88,6 +101,26 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
     return () => subscription.remove();
   }, [widgetId, onCardTap]);
 
+  // Subscribe to `onDidFetchContentItems` scoped to this widget's modal
+  // feed. Native side registers the modal feed VC under `modalFeedId` on
+  // present and emits with that feedId; filter to it and route to the
+  // host callback wired on `feedConfig.onDidFetchContentItems`.
+  useEffect(() => {
+    if (!NativeShortKitModule || !modalFeedId || !onDidFetchContentItems) return;
+
+    const subscription = NativeShortKitModule.onDidFetchContentItems((event) => {
+      if (event.feedId !== modalFeedId) return;
+      try {
+        const items = JSON.parse(event.items);
+        onDidFetchContentItemsRef.current?.(items);
+      } catch {
+        // ignore malformed JSON
+      }
+    });
+
+    return () => subscription.remove();
+  }, [modalFeedId, onDidFetchContentItems]);
+
   const serializedConfig = useMemo(() => {
     return serializeWidgetConfig(config ?? {});
   }, [config]);
@@ -105,6 +138,20 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
     return JSON.stringify(feedItems);
   }, [feedItems]);
 
+  // Android: the native ViewManager backing ShortKitWidget was removed in
+  // #246 (feed-only scope-down). The JS surface stays so cross-platform
+  // host code compiles, but renders an empty container.
+  if (Platform.OS === 'android') {
+    if (__DEV__ && !didWarnAndroidWidgetUnavailable) {
+      didWarnAndroidWidgetUnavailable = true;
+      // eslint-disable-next-line no-console
+      console.warn(
+        '[ShortKit] <ShortKitWidget> is not supported on Android — rendering an empty container.',
+      );
+    }
+    return <View style={[styles.container, style]} />;
+  }
+
   return (
     <View style={[styles.container, style]}>
       <ShortKitWidgetView
@@ -112,6 +159,7 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
         config={serializedConfig}
         items={serializedItems}
         widgetId={widgetId}
+        modalFeedId={modalFeedId}
         active={active}
         feedItems={serializedFeedItems}
       />

package/src/specs/NativeShortKitModule.ts

@@ -127,6 +127,14 @@ type VideoCarouselCellTapEvent = Readonly<{
   pageIndex: Int32;
 }>;
 
+type VideoCarouselCellLongPressEvent = Readonly<{
+  feedId: string;
+  id: string;
+  index: Int32;
+  pageIndex: Int32;
+  state: string;     // "began" | "ended" | "cancelled" — string for codegen compat
+}>;
+
 type WidgetCardTapEvent = Readonly<{
   widgetId: string;
   playbackId: string;
@@ -292,6 +300,7 @@ export interface Spec extends TurboModule {
   selectCaptionTrack(language: string): void;
   sendContentSignal(signal: string): void;
   setMaxBitrate(bitrate: Double): void;
+  setFeedScrollEnabled(enabled: boolean): void;
 
   // --- Custom feed ---
   setFeedItems(feedId: string, items: string, startAtId: string | null): void;
@@ -336,6 +345,7 @@ export interface Spec extends TurboModule {
   readonly onDidFetchContentItems: EventEmitter<DidFetchContentItemsEvent>;
   readonly onFeedReady: EventEmitter<FeedReadyEvent>;
   readonly onVideoCarouselCellTap: EventEmitter<VideoCarouselCellTapEvent>;
+  readonly onVideoCarouselCellLongPress: EventEmitter<VideoCarouselCellLongPressEvent>;
   readonly onWidgetCardTap: EventEmitter<WidgetCardTapEvent>;
 
   // --- Overlay per-surface events ---

package/src/specs/ShortKitWidgetViewNativeComponent.ts

@@ -5,11 +5,23 @@ export interface NativeProps extends ViewProps {
   config: string;
   items?: string;
   /**
-   * Stable per-instance widget identifier. Used to route the global
-   * `NativeShortKitModule.onWidgetCardTap` event back to the originating
-   * `<ShortKitWidget>` when multiple widgets are mounted.
+   * Stable per-instance widget identifier. Set only when the host has
+   * wired `onCardTap` — its presence signals "host handles taps" to the
+   * native side. Echoed back on `onWidgetCardTap` events so the JS
+   * wrapper can route the global emit to the correct `<ShortKitWidget>`
+   * instance when more than one is mounted.
    */
   widgetId?: string;
+  /**
+   * Stable per-instance modal-feed identifier. Set only when the host
+   * has wired per-feed callbacks (e.g.
+   * `feedConfig.onDidFetchContentItems`). The native side registers the
+   * SDK's built-in modal feed VC with the bridge under this id so events
+   * fired by the modal can be scoped back to the correct widget's
+   * callbacks. Independent from `widgetId` — a host can wire modal
+   * callbacks without taking over taps.
+   */
+  modalFeedId?: string;
   /**
    * Whether the widget is currently allowed to play. Defaults to true on
    * the native side. Hosts use this to release the widget's pool tile