@shortkitsdk/react-native 0.2.12 → 0.2.15

package/ios/{ShortKitSDK.xcframework → ShortKitSDK.xcframework.dev-backup}/ios-arm64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface

@@ -203,6 +203,7 @@ public struct FeedConfig : Swift.Codable {
   public var scrollAxis: ShortKitSDK.ScrollAxis
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
   public var carouselOverlay: ShortKitSDK.CarouselOverlayMode
+  public var videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var muteOnStart: Swift.Bool
@@ -211,7 +212,7 @@ public struct FeedConfig : Swift.Codable {
   public var coldStartEnabled: 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, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public 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, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
@@ -240,6 +241,17 @@ extension ShortKitSDK.CarouselOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum VideoCarouselOverlayMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.VideoCarouselOverlay)
+}
+extension ShortKitSDK.VideoCarouselOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.VideoCarouselOverlayMode, rhs: ShortKitSDK.VideoCarouselOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.VideoCarouselOverlayMode : Swift.Codable {
+  public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
+}
 public enum SurveyOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.SurveyOverlay)
@@ -409,12 +421,14 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
 public enum FeedInput : Swift.Sendable {
   case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
   case adSlot(ShortKitSDK.AdSlot)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case survey(ShortKitSDK.SurveyItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselItem)
   public var isContent: Swift.Bool {
     get
   }
@@ -427,6 +441,9 @@ public enum FeedItem : Swift.Sendable {
   public var isSurvey: Swift.Bool {
     get
   }
+  public var isVideoCarousel: Swift.Bool {
+    get
+  }
   public var isNonVideo: Swift.Bool {
     get
   }
@@ -442,6 +459,9 @@ public enum FeedItem : Swift.Sendable {
   public var surveyItem: ShortKitSDK.SurveyItem? {
     get
   }
+  public var videoCarouselItem: ShortKitSDK.VideoCarouselItem? {
+    get
+  }
   public var id: Swift.String {
     get
   }
@@ -545,6 +565,19 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
   public init(startTime: Swift.Double, endTime: Swift.Double, text: Swift.String)
   public static func == (a: ShortKitSDK.VTTCue, b: ShortKitSDK.VTTCue) -> Swift.Bool
 }
+public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let id: Swift.String
+  public let videos: [ShortKitSDK.ContentItem]
+  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 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
+}
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
@@ -554,6 +587,8 @@ public protocol CarouselOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ImageCarouselItem)
   func resetState()
   var wantsNativeImagePrefetch: Swift.Bool { get }
+  func activatePlayback()
+  func updateActiveImage(index: Swift.Int)
 }
 extension ShortKitSDK.CarouselOverlay {
   public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
@@ -563,6 +598,8 @@ extension ShortKitSDK.CarouselOverlay {
   public var wantsNativeImagePrefetch: Swift.Bool {
     get
   }
+  public func activatePlayback()
+  public func updateActiveImage(index: Swift.Int)
 }
 final public class CellContent : Combine.ObservableObject {
   @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
@@ -592,6 +629,19 @@ public protocol SurveyOverlay : AnyObject {
   func configure(with item: ShortKitSDK.SurveyItem)
   func resetState()
 }
+public protocol VideoCarouselOverlay : AnyObject {
+  func configure(with item: ShortKitSDK.VideoCarouselItem)
+  func updateActiveVideo(index: Swift.Int, item: ShortKitSDK.ContentItem)
+  func resetState()
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func activatePlayback()
+  func deactivatePlayback()
+}
+extension ShortKitSDK.VideoCarouselOverlay {
+  public func attach(player: ShortKitSDK.ShortKitPlayer)
+  public func activatePlayback()
+  public func deactivatePlayback()
+}
 public struct PlayerTime : Swift.Equatable, Swift.Sendable {
   public let current: Swift.Double
   public let duration: Swift.Double

package/ios/{ShortKitSDK.xcframework → ShortKitSDK.xcframework.dev-backup}/ios-arm64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface

@@ -203,6 +203,7 @@ public struct FeedConfig : Swift.Codable {
   public var scrollAxis: ShortKitSDK.ScrollAxis
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
   public var carouselOverlay: ShortKitSDK.CarouselOverlayMode
+  public var videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var muteOnStart: Swift.Bool
@@ -211,7 +212,7 @@ public struct FeedConfig : Swift.Codable {
   public var coldStartEnabled: 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, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public 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, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
@@ -240,6 +241,17 @@ extension ShortKitSDK.CarouselOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum VideoCarouselOverlayMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.VideoCarouselOverlay)
+}
+extension ShortKitSDK.VideoCarouselOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.VideoCarouselOverlayMode, rhs: ShortKitSDK.VideoCarouselOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.VideoCarouselOverlayMode : Swift.Codable {
+  public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
+}
 public enum SurveyOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.SurveyOverlay)
@@ -409,12 +421,14 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
 public enum FeedInput : Swift.Sendable {
   case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
   case adSlot(ShortKitSDK.AdSlot)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case survey(ShortKitSDK.SurveyItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselItem)
   public var isContent: Swift.Bool {
     get
   }
@@ -427,6 +441,9 @@ public enum FeedItem : Swift.Sendable {
   public var isSurvey: Swift.Bool {
     get
   }
+  public var isVideoCarousel: Swift.Bool {
+    get
+  }
   public var isNonVideo: Swift.Bool {
     get
   }
@@ -442,6 +459,9 @@ public enum FeedItem : Swift.Sendable {
   public var surveyItem: ShortKitSDK.SurveyItem? {
     get
   }
+  public var videoCarouselItem: ShortKitSDK.VideoCarouselItem? {
+    get
+  }
   public var id: Swift.String {
     get
   }
@@ -545,6 +565,19 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
   public init(startTime: Swift.Double, endTime: Swift.Double, text: Swift.String)
   public static func == (a: ShortKitSDK.VTTCue, b: ShortKitSDK.VTTCue) -> Swift.Bool
 }
+public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let id: Swift.String
+  public let videos: [ShortKitSDK.ContentItem]
+  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 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
+}
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
@@ -554,6 +587,8 @@ public protocol CarouselOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ImageCarouselItem)
   func resetState()
   var wantsNativeImagePrefetch: Swift.Bool { get }
+  func activatePlayback()
+  func updateActiveImage(index: Swift.Int)
 }
 extension ShortKitSDK.CarouselOverlay {
   public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
@@ -563,6 +598,8 @@ extension ShortKitSDK.CarouselOverlay {
   public var wantsNativeImagePrefetch: Swift.Bool {
     get
   }
+  public func activatePlayback()
+  public func updateActiveImage(index: Swift.Int)
 }
 final public class CellContent : Combine.ObservableObject {
   @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
@@ -592,6 +629,19 @@ public protocol SurveyOverlay : AnyObject {
   func configure(with item: ShortKitSDK.SurveyItem)
   func resetState()
 }
+public protocol VideoCarouselOverlay : AnyObject {
+  func configure(with item: ShortKitSDK.VideoCarouselItem)
+  func updateActiveVideo(index: Swift.Int, item: ShortKitSDK.ContentItem)
+  func resetState()
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func activatePlayback()
+  func deactivatePlayback()
+}
+extension ShortKitSDK.VideoCarouselOverlay {
+  public func attach(player: ShortKitSDK.ShortKitPlayer)
+  public func activatePlayback()
+  public func deactivatePlayback()
+}
 public struct PlayerTime : Swift.Equatable, Swift.Sendable {
   public let current: Swift.Double
   public let duration: Swift.Double

package/ios/ShortKitSDK.xcframework.dev-backup/ios-arm64-simulator/ShortKitSDK.framework/_CodeSignature/CodeResources

@@ -0,0 +1,168 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>Headers/ShortKitSDK-Swift.h</key>
+		<data>
+		3bbpoSImjQOVLQbSfh6sAEp9NqY=
+		</data>
+		<key>Info.plist</key>
+		<data>
+		Ley678FJu8DKkhiCwrDCSa/fREc=
+		</data>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
+		<data>
+		UXy9TKZ3jOo1h3yIihNnV4dQp7U=
+		</data>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
+		<data>
+		yxz4ANQUVWM4+pNexcbMhEtvg30=
+		</data>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
+		<data>
+		DK7MvgzrcSHBHViTj0Ef3+LnBmc=
+		</data>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
+		<data>
+		yxz4ANQUVWM4+pNexcbMhEtvg30=
+		</data>
+		<key>Modules/module.modulemap</key>
+		<data>
+		QthRxkVp/MRBzYVNLtX05t2Csso=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict>
+		<key>Headers/ShortKitSDK-Swift.h</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			V+jQ2eNebJRtNpq31u6WQqjInnpmCU26LytMq5YTXJk=
+			</data>
+		</dict>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			xc/3beYtE9m0Lo6S3wpA6SlO9HYbjsJ985rl98j1eIY=
+			</data>
+		</dict>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			9qbyNESX9aF8c95D7gm8GHd/uU6E3/oxbLjeUhcWqYg=
+			</data>
+		</dict>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			UyIgXF6hWtTcHaIdLiGNttWuQWMuQqJ9FVoBTa0cDds=
+			</data>
+		</dict>
+		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			9qbyNESX9aF8c95D7gm8GHd/uU6E3/oxbLjeUhcWqYg=
+			</data>
+		</dict>
+		<key>Modules/module.modulemap</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			K4gZcRkdlvQBo5cnduiRMooPuUS6dWAP1E7dBJRuHL4=
+			</data>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/package.json

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

package/src/ShortKitCarouselOverlaySurface.tsx

@@ -1,6 +1,7 @@
-import React, { useMemo } from 'react';
+import React, { useState, useEffect, useMemo } from 'react';
 import { AppRegistry } from 'react-native';
 import type { CarouselOverlayProps, ImageCarouselItem } from './types';
+import NativeShortKitModule from './specs/NativeShortKitModule';
 
 const _carouselRegistry = new Map<string, React.ComponentType<CarouselOverlayProps>>();
 
@@ -24,7 +25,30 @@ export function registerCarouselOverlayComponent(
   });
 }
 
+/** Subscribe to a named native event, filtered by surfaceId. */
+function useOverlayEvent<T extends { surfaceId: string }>(
+  eventName: string,
+  surfaceId: string | undefined,
+  handler: (event: T) => void,
+) {
+  useEffect(() => {
+    if (!surfaceId) return;
+
+    let sub: { remove: () => void } | undefined;
+    const emitter = NativeShortKitModule?.[eventName as keyof typeof NativeShortKitModule];
+    if (typeof emitter === 'function') {
+      sub = (emitter as (cb: (e: T) => void) => { remove: () => void })((e: T) => {
+        if (e.surfaceId !== surfaceId) return;
+        handler(e);
+      });
+    }
+
+    return () => sub?.remove();
+  }, [surfaceId]);
+}
+
 interface RawCarouselSurfaceProps {
+  surfaceId?: string;
   item?: string;
 }
 
@@ -38,6 +62,31 @@ function CarouselSurfaceInner(props: InnerProps) {
     return null;
   }
 
+  const sid = props.surfaceId;
+
+  const [isActive, setIsActive] = useState(false);
+  const [activeImageIndex, setActiveImageIndex] = useState(0);
+
+  // isActive delivered via onOverlayFullState (same event as video overlay)
+  useOverlayEvent<{
+    surfaceId: string;
+    isActive: boolean;
+    playerState: string;
+    isMuted: boolean;
+    playbackRate: number;
+    captionsEnabled: boolean;
+    activeCue: string | null;
+    feedScrollPhase: string | null;
+  }>('onOverlayFullState', sid, (e) => {
+    setIsActive(e.isActive);
+  });
+
+  // activeImageIndex delivered via dedicated event
+  useOverlayEvent<{ surfaceId: string; activeImageIndex: number }>(
+    'onCarouselActiveImageChanged', sid,
+    (e) => setActiveImageIndex(e.activeImageIndex),
+  );
+
   const item: ImageCarouselItem | null = useMemo(() => {
     if (!props.item) {
       return null;
@@ -51,5 +100,11 @@ function CarouselSurfaceInner(props: InnerProps) {
 
   if (!item) return null;
 
-  return <Component item={item} />;
+  return (
+    <Component
+      item={item}
+      isActive={isActive}
+      activeImageIndex={activeImageIndex}
+    />
+  );
 }

package/src/ShortKitContext.ts

@@ -54,3 +54,14 @@ export interface ShortKitContextValue {
 }
 
 export const ShortKitContext = createContext<ShortKitContextValue | null>(null);
+
+/**
+ * Lightweight context that only signals "a ShortKitProvider is mounted".
+ * Components that need the provider but don't consume player state (e.g.
+ * ShortKitFeed, ShortKitWidget) should subscribe to this instead of
+ * ShortKitContext to avoid re-rendering on every TIME/PLAYER_STATE dispatch.
+ *
+ * The value is set once in ShortKitProvider and never changes, so
+ * subscribers never re-render from this context.
+ */
+export const ShortKitInitContext = createContext<boolean>(false);

package/src/ShortKitFeed.tsx

@@ -1,12 +1,13 @@
 import React, { useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, forwardRef } from 'react';
 import { View, StyleSheet } from 'react-native';
-import type { ShortKitFeedProps, FeedInput, FeedFilter, ShortKitFeedHandle } from './types';
+import type { ShortKitFeedProps, FeedInput, FeedFilter, ShortKitFeedHandle, ShortKitRefreshState } from './types';
 import ShortKitFeedView from './specs/ShortKitFeedViewNativeComponent';
 import NativeShortKitModule from './specs/NativeShortKitModule';
-import { ShortKitContext } from './ShortKitContext';
+import { ShortKitInitContext } from './ShortKitContext';
 import { deserializeContentItem, serializeFeedConfig, serializeFeedInputs } from './serialization';
 import { registerOverlayComponent } from './ShortKitOverlaySurface';
 import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
+import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 
 function generateFeedId(): string {
   return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
@@ -38,17 +39,24 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     onFormatChange,
     onContentTapped,
     onDismiss,
-    onRefreshRequested,
+    onRefreshStateChanged,
     onDidFetchContentItems,
     onRemainingContentCountChange,
     onFeedReady,
   } = props;
 
-  const context = useContext(ShortKitContext);
-  if (!context) {
+  const isInitialized = useContext(ShortKitInitContext);
+  if (!isInitialized) {
     throw new Error('ShortKitFeed must be used within a ShortKitProvider');
   }
 
+  // ⚡ TEMP — remove after verifying. Should only log on mount, not on every swipe/time update.
+  const renderCount = useRef(0);
+  renderCount.current++;
+  if (renderCount.current <= 3 || renderCount.current % 100 === 0) {
+    console.log(`[SK:Feed] render #${renderCount.current}`);
+  }
+
   // Stable feed instance ID — survives re-renders and React fast refresh
   const feedIdRef = useRef(generateFeedId());
   const feedId = feedIdRef.current;
@@ -103,7 +111,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (config?.carouselOverlay && config.carouselOverlay !== 'none') {
       registerCarouselOverlayComponent(config.carouselOverlay.name, config.carouselOverlay.component);
     }
-  }, [config?.overlay, config?.carouselOverlay]);
+    if (config?.videoCarouselOverlay && config.videoCarouselOverlay !== 'none') {
+      registerVideoCarouselOverlayComponent(config.videoCarouselOverlay.name, config.videoCarouselOverlay.component);
+    }
+  }, [config?.overlay, config?.carouselOverlay, config?.videoCarouselOverlay]);
 
   const serializedConfig = useMemo(
     () => (config ? serializeFeedConfig(config) : '{}'),
@@ -180,10 +191,14 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
       );
     }
 
-    if (onRefreshRequested) {
+    if (onRefreshStateChanged) {
       subscriptions.push(
-        NativeShortKitModule.onRefreshRequested(() => {
-          onRefreshRequested();
+        NativeShortKitModule.onRefreshStateChanged((event) => {
+          const state: ShortKitRefreshState =
+            event.status === 'pulling'
+              ? { status: 'pulling', progress: event.progress }
+              : { status: event.status as 'idle' | 'triggered' | 'refreshing' };
+          onRefreshStateChanged(state);
         }),
       );
     }
@@ -213,7 +228,7 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     onFormatChange,
     onContentTapped,
     onDismiss,
-    onRefreshRequested,
+    onRefreshStateChanged,
     onDidFetchContentItems,
   ]);