react-native-attachment-kit 1.1.1 → 1.2.2

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

@@ -490,6 +490,7 @@ extension RNAttachmentKit.RemoteImageViewerViewController : UIKit.UICollectionVi
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension RNAttachmentKit.RemoteImageViewerViewController {
+  @_Concurrency.MainActor @preconcurrency public func willCloseEventBody() -> [Swift.String : Any]
   @_Concurrency.MainActor @preconcurrency public func videoCloseSnapshot(in container: UIKit.UIView) -> (image: UIKit.UIImage, frame: CoreFoundation.CGRect)?
 }
 public struct Localizer {
@@ -703,6 +704,8 @@ extension RNAttachmentKit.MediaGalleryViewController : UIKit.UICollectionViewDat
   @_Concurrency.MainActor @preconcurrency public var sourceClipRect: CoreFoundation.CGRect?
   @_Concurrency.MainActor @preconcurrency public var sourceClipInsets: UIKit.UIEdgeInsets?
   @_Concurrency.MainActor @preconcurrency public func clipRect(in bounds: CoreFoundation.CGRect) -> CoreFoundation.CGRect?
+  @_Concurrency.MainActor @preconcurrency weak public var underView: UIKit.UIView?
+  @_Concurrency.MainActor @preconcurrency public func removeUnderLayer()
   @_Concurrency.MainActor @preconcurrency public func updateMaskView()
   @_Concurrency.MainActor @preconcurrency public var openDuration: Swift.Double
   @_Concurrency.MainActor @preconcurrency public var closeDuration: Swift.Double
@@ -832,6 +835,23 @@ public struct ReverseGeocodeError : Swift.Error {
   public static func apply(_ config: [Swift.String : Any])
   @objc deinit
 }
+public struct VideoPreviewOptions {
+  public var height: Swift.Int
+  public var bitrate: Swift.Int
+  public var maxFps: Swift.Double
+  public var maxDurationSec: Swift.Double
+  public var codec: Swift.String
+  public init()
+  public init?(any v: Any?)
+}
+public struct VideoPreviewResult {
+  public let url: Foundation.URL
+  public let width: Swift.Int
+  public let height: Swift.Int
+  public let duration: Swift.Double
+  public let fileSize: Swift.Int64
+  public let bitrate: Swift.Int
+}
 public struct VideoExportOptions {
   public var maxDurationSec: Swift.Double
   public var maxFileSizeMB: Swift.Double
@@ -839,6 +859,7 @@ public struct VideoExportOptions {
   public var defaultQuality: Swift.Int
   public var codec: Swift.String
   public var posterFormat: Swift.String
+  public var preview: RNAttachmentKit.VideoPreviewOptions?
   public init()
   public init(dictionary d: [Swift.String : Any]?)
 }
@@ -904,6 +925,7 @@ public enum VideoSendIssue {
 }
 final public class VideoExporter {
   public static let sizeMargin: Swift.Double
+  public static func tooLongText(maxDurationSec: Swift.Double, languageCode: Swift.String) -> Swift.String
   public static func sendIssue(sourceDuration: Swift.Double, sourceShortSide: CoreFoundation.CGFloat, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions) -> RNAttachmentKit.VideoSendIssue?
   public static func fittedQuality(_ want: Swift.Int, sourceShortSide: CoreFoundation.CGFloat, outputDuration: Swift.Double, options: RNAttachmentKit.VideoExportOptions) -> Swift.Int
   public enum ExportError : Foundation.LocalizedError {
@@ -920,6 +942,8 @@ final public class VideoExporter {
   final public func cancel()
   final public func export(asset: Photos.PHAsset, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions, outputDir: Foundation.URL, baseName: Swift.String, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoExportResult
   final public func export(fileURL: Foundation.URL, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions, outputDir: Foundation.URL, baseName: Swift.String, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoExportResult
+  public static func previewWorthMaking(sentShortSide: Swift.Int, sentFileSize: Swift.Int64, sentDuration: Swift.Double, options: RNAttachmentKit.VideoPreviewOptions) -> Swift.Bool
+  final public func makePreview(from source: Foundation.URL, options: RNAttachmentKit.VideoPreviewOptions, to url: Foundation.URL, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoPreviewResult
   public static func encodePoster(_ image: UIKit.UIImage, format: Swift.String, quality: CoreFoundation.CGFloat) -> (data: Foundation.Data, fileExtension: Swift.String)?
   @objc deinit
 }
@@ -937,7 +961,8 @@ public struct ViewerVideoItem {
   public var uri: Swift.String
   public var duration: Swift.Double?
   public var cacheFile: Swift.String?
-  public init(uri: Swift.String, duration: Swift.Double? = nil, cacheFile: Swift.String? = nil)
+  public var startTime: Swift.Double?
+  public init(uri: Swift.String, duration: Swift.Double? = nil, cacheFile: Swift.String? = nil, startTime: Swift.Double? = nil)
   public init?(dictionary d: Any?)
 }
 @_hasMissingDesignatedInitializers final public class VideoPrepareManager {
@@ -1002,8 +1027,19 @@ public struct AttachmentResult {
   public var videoCodec: Swift.String?
   public var videoBitrate: Swift.Int?
   public var edited: Swift.Bool?
+  public var previewURL: Foundation.URL?
+  public var previewWidth: Swift.Int?
+  public var previewHeight: Swift.Int?
+  public var previewDuration: Swift.Double?
+  public var previewFileSize: Swift.Int64?
+  public var previewBitrate: Swift.Int?
+  public var previewError: Swift.String?
+  public var previewSkipped: Swift.String?
   public var error: Swift.String?
   public var cancelled: Swift.Bool
+  public var previewPath: Swift.String? {
+    get
+  }
   public var path: Swift.String? {
     get
   }

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

@@ -490,6 +490,7 @@ extension RNAttachmentKit.RemoteImageViewerViewController : UIKit.UICollectionVi
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension RNAttachmentKit.RemoteImageViewerViewController {
+  @_Concurrency.MainActor @preconcurrency public func willCloseEventBody() -> [Swift.String : Any]
   @_Concurrency.MainActor @preconcurrency public func videoCloseSnapshot(in container: UIKit.UIView) -> (image: UIKit.UIImage, frame: CoreFoundation.CGRect)?
 }
 public struct Localizer {
@@ -703,6 +704,8 @@ extension RNAttachmentKit.MediaGalleryViewController : UIKit.UICollectionViewDat
   @_Concurrency.MainActor @preconcurrency public var sourceClipRect: CoreFoundation.CGRect?
   @_Concurrency.MainActor @preconcurrency public var sourceClipInsets: UIKit.UIEdgeInsets?
   @_Concurrency.MainActor @preconcurrency public func clipRect(in bounds: CoreFoundation.CGRect) -> CoreFoundation.CGRect?
+  @_Concurrency.MainActor @preconcurrency weak public var underView: UIKit.UIView?
+  @_Concurrency.MainActor @preconcurrency public func removeUnderLayer()
   @_Concurrency.MainActor @preconcurrency public func updateMaskView()
   @_Concurrency.MainActor @preconcurrency public var openDuration: Swift.Double
   @_Concurrency.MainActor @preconcurrency public var closeDuration: Swift.Double
@@ -832,6 +835,23 @@ public struct ReverseGeocodeError : Swift.Error {
   public static func apply(_ config: [Swift.String : Any])
   @objc deinit
 }
+public struct VideoPreviewOptions {
+  public var height: Swift.Int
+  public var bitrate: Swift.Int
+  public var maxFps: Swift.Double
+  public var maxDurationSec: Swift.Double
+  public var codec: Swift.String
+  public init()
+  public init?(any v: Any?)
+}
+public struct VideoPreviewResult {
+  public let url: Foundation.URL
+  public let width: Swift.Int
+  public let height: Swift.Int
+  public let duration: Swift.Double
+  public let fileSize: Swift.Int64
+  public let bitrate: Swift.Int
+}
 public struct VideoExportOptions {
   public var maxDurationSec: Swift.Double
   public var maxFileSizeMB: Swift.Double
@@ -839,6 +859,7 @@ public struct VideoExportOptions {
   public var defaultQuality: Swift.Int
   public var codec: Swift.String
   public var posterFormat: Swift.String
+  public var preview: RNAttachmentKit.VideoPreviewOptions?
   public init()
   public init(dictionary d: [Swift.String : Any]?)
 }
@@ -904,6 +925,7 @@ public enum VideoSendIssue {
 }
 final public class VideoExporter {
   public static let sizeMargin: Swift.Double
+  public static func tooLongText(maxDurationSec: Swift.Double, languageCode: Swift.String) -> Swift.String
   public static func sendIssue(sourceDuration: Swift.Double, sourceShortSide: CoreFoundation.CGFloat, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions) -> RNAttachmentKit.VideoSendIssue?
   public static func fittedQuality(_ want: Swift.Int, sourceShortSide: CoreFoundation.CGFloat, outputDuration: Swift.Double, options: RNAttachmentKit.VideoExportOptions) -> Swift.Int
   public enum ExportError : Foundation.LocalizedError {
@@ -920,6 +942,8 @@ final public class VideoExporter {
   final public func cancel()
   final public func export(asset: Photos.PHAsset, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions, outputDir: Foundation.URL, baseName: Swift.String, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoExportResult
   final public func export(fileURL: Foundation.URL, state: RNAttachmentKit.VideoEditState, options: RNAttachmentKit.VideoExportOptions, outputDir: Foundation.URL, baseName: Swift.String, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoExportResult
+  public static func previewWorthMaking(sentShortSide: Swift.Int, sentFileSize: Swift.Int64, sentDuration: Swift.Double, options: RNAttachmentKit.VideoPreviewOptions) -> Swift.Bool
+  final public func makePreview(from source: Foundation.URL, options: RNAttachmentKit.VideoPreviewOptions, to url: Foundation.URL, progress: @escaping (Swift.Double) -> Swift.Void) throws -> RNAttachmentKit.VideoPreviewResult
   public static func encodePoster(_ image: UIKit.UIImage, format: Swift.String, quality: CoreFoundation.CGFloat) -> (data: Foundation.Data, fileExtension: Swift.String)?
   @objc deinit
 }
@@ -937,7 +961,8 @@ public struct ViewerVideoItem {
   public var uri: Swift.String
   public var duration: Swift.Double?
   public var cacheFile: Swift.String?
-  public init(uri: Swift.String, duration: Swift.Double? = nil, cacheFile: Swift.String? = nil)
+  public var startTime: Swift.Double?
+  public init(uri: Swift.String, duration: Swift.Double? = nil, cacheFile: Swift.String? = nil, startTime: Swift.Double? = nil)
   public init?(dictionary d: Any?)
 }
 @_hasMissingDesignatedInitializers final public class VideoPrepareManager {
@@ -1002,8 +1027,19 @@ public struct AttachmentResult {
   public var videoCodec: Swift.String?
   public var videoBitrate: Swift.Int?
   public var edited: Swift.Bool?
+  public var previewURL: Foundation.URL?
+  public var previewWidth: Swift.Int?
+  public var previewHeight: Swift.Int?
+  public var previewDuration: Swift.Double?
+  public var previewFileSize: Swift.Int64?
+  public var previewBitrate: Swift.Int?
+  public var previewError: Swift.String?
+  public var previewSkipped: Swift.String?
   public var error: Swift.String?
   public var cancelled: Swift.Bool
+  public var previewPath: Swift.String? {
+    get
+  }
   public var path: Swift.String? {
     get
   }

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

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Assets.car</key>
 		<data>
-		24XBU3LEblGjGTOAqjhqZ+mB2U0=
+		g6yZrbEglkdHc1mfZaxagZ5xtQU=
 		</data>
 		<key>Base.lproj/LaunchScreen.storyboardc/01J-lp-oVM-view-Ze5-6b-2t3.nib</key>
 		<data>
@@ -30,43 +30,43 @@
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		HgBJ2YsmrBeU0DS85YgVPkDlLTs=
+		cDIKOxZMZjBEDwXWsaQcXFaOwjY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		Ed6Tp4ZdEh1Odi1mGzC5KfR3ub4=
+		5+4785ZK6wAQveUYGwxcd97v3fk=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		fkzCLPjLTpoPLvuP7U4zaR7oFNw=
+		zVq/ulFQX0DNJyim760INA2BMJY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		Ed6Tp4ZdEh1Odi1mGzC5KfR3ub4=
+		5+4785ZK6wAQveUYGwxcd97v3fk=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		CJAZ6C+TQtNC/0MyMl2L2XpFaUk=
+		myshBYtNXCHjI6pdLLGzq+k7QaY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		HgBJ2YsmrBeU0DS85YgVPkDlLTs=
+		cDIKOxZMZjBEDwXWsaQcXFaOwjY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		rXiwUUI1CzRSug3fqRG9W7EfYXU=
+		gDqNg0dOOaQZG+LnUdHe2epfM/Q=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		hA3QQl7XlEdD/dLJvtloBIYPppw=
+		bqeMNigi/6BVenv9pPCBC0cnOik=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		rXiwUUI1CzRSug3fqRG9W7EfYXU=
+		gDqNg0dOOaQZG+LnUdHe2epfM/Q=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		J5L/JxV9FT2C8tH+lGCtE16c8TY=
+		ldCLYzEJSMl9tGbvJKLqqcaexB0=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -227,7 +227,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			hcxV/4NZu79SXIpwsHu8Fo8WVAZLQfuKhITugdLFV+I=
+			t4fvHNhwvX9Xc+yxU1dNnVy6zn+bhryN6MxDfE4HVwY=
 			</data>
 		</dict>
 		<key>Base.lproj/LaunchScreen.storyboardc/01J-lp-oVM-view-Ze5-6b-2t3.nib</key>
@@ -262,70 +262,70 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			nfoRXkCuOnu5U1wnp4zqqmGx+leb8bfClaFr07ayxcM=
+			5U0ebRft0k3pT7dh7XFPPmlXrsYugnRdA4Lzrg58wbs=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			RX253JxJd5m5f5B7GitqxHUHfizHOfq8tSMHXN75o34=
+			8S9V0QeM7wYkvdneQjfZzBBJczr//bsYL3LPwAAgn0M=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			QkdK6zh16vDLhDaCCkHdYOvIw+XgvQ0vqz/xIAJJN6E=
+			b5YFkrCnQlPq+ypXoa8FpGaEy8FIGl4lF8SaDOjauKU=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			RX253JxJd5m5f5B7GitqxHUHfizHOfq8tSMHXN75o34=
+			8S9V0QeM7wYkvdneQjfZzBBJczr//bsYL3LPwAAgn0M=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			L2ZN1byGvwKOQa7qpgo/X4J+IbA2ZcksQowMoSI56W8=
+			jawPPEoY72pY1VUCBTHs7AyHVJpsM4/uD/n6ijfZ9+4=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			nfoRXkCuOnu5U1wnp4zqqmGx+leb8bfClaFr07ayxcM=
+			5U0ebRft0k3pT7dh7XFPPmlXrsYugnRdA4Lzrg58wbs=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			nN80xaeGzDuus0TMWI42dZac58SSKKddo1k17wucRI8=
+			9hRCvQHf4NkqX1nAk8jG2Vlek5vnm/aq9XSQlJzeZqU=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			vW/Wi94uUAPETo9uOKMafYZ0H7dtvllPw4YAciVQQ+4=
+			siL9Prg1AkwGbKYqi7m/6XFHFWw//eIf2qRminOoGtc=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			nN80xaeGzDuus0TMWI42dZac58SSKKddo1k17wucRI8=
+			9hRCvQHf4NkqX1nAk8jG2Vlek5vnm/aq9XSQlJzeZqU=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			xhODjv643cw/fI3FfNPDvnNvOquUgzEOleuZBFaSRuE=
+			5KpS89ua5KyMNFPf1VukiCs8RRbMX9viVdOof9j9eVI=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-attachment-kit",
-  "version": "1.1.1",
+  "version": "1.2.2",
   "description": "Native attachment kit for React Native — gallery picker, editor, image viewer and media gallery (Turbo Module)",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/index.ts

@@ -67,6 +67,23 @@ if (!RNAttachmentKitModule) {
 const eventEmitter = new NativeEventEmitter(RNAttachmentKitModule)
 
 /** 같은 화면을 중복으로 열려고 할 때 reject 하는 Error (code: "E_ALREADY_OPEN") */
+/** 네이티브 onViewerWillClose 본문 → { currentIndex, videoPositions } (예전 네이티브·다른 Android 뷰어처럼 값이 없으면 undefined) */
+function toViewerWillCloseEvent(e: any): import("./types").ViewerWillCloseEvent | undefined {
+  if (!e || typeof e.currentIndex !== 'number') return undefined
+  const out: import("./types").ViewerWillCloseEvent = { currentIndex: e.currentIndex }
+  const raw = e.videoPositions
+  if (raw && typeof raw === 'object') {
+    const positions: Record<number, number> = {}
+    let any = false
+    for (const k of Object.keys(raw)) {
+      const i = Number(k), v = raw[k]
+      if (Number.isInteger(i) && typeof v === 'number' && isFinite(v)) { positions[i] = v; any = true }
+    }
+    if (any) out.videoPositions = positions
+  }
+  return out
+}
+
 function alreadyOpenError(what: string): Error {
   const err = new Error(`${what} is already open`)
   ;(err as any).code = "E_ALREADY_OPEN"
@@ -89,7 +106,7 @@ let _editorOpen = false
 let _asyncImgProcessedSub: { remove: () => void } | null = null
 
 export type { AIConfig, AIUsageEvent, AIChargeRequiredEvent } from "./types"
-export type { VideoOptions, VideoProgressEvent, ViewerVideo, ProcessingStartEvent, ProcessingStartItem, ThumbnailOptions, SourceRect, SourceClipInsets, ViewerSourceUpdate } from "./types"
+export type { VideoOptions, VideoProgressEvent, ViewerVideo, ViewerWillCloseEvent, ProcessingStartEvent, ProcessingStartItem, ThumbnailOptions, VideoPreviewOptions, SourceRect, SourceClipInsets, ViewerSourceUpdate } from "./types"
 export type { SelectionChangeEvent, Appearance, AttachLocationResult, MapViewerOptions, ReverseGeocodeOptions, ReverseGeocodeResult, ReverseGeocodeErrorCode, AttachFileResult, AttachFileFailure, LocationThumbnailOptions, LocationThumbnailResult } from "./types"
 export type { MediaGalleryItem, MediaGalleryOptions, MediaGalleryGridSize, MediaGalleryGridSizeChangedEvent, MediaGalleryTheme, MediaGalleryViewerOptions, MediaGalleryDeleteOption, MediaGalleryItemDeletedEvent, MediaGalleryNeedPageEvent, MediaGalleryClosedEvent, MediaGalleryAppendPayload, MediaGalleryRemovePayload } from "./types"
 
@@ -379,9 +396,13 @@ const AttachmentKit: RNAttachmentKit = {
     // 네이티브 "onViewerWillClose"(iOS sendEvent / Android RCTDeviceEventEmitter) 는 앱이 콜백을 넘기지 않아도
     // 항상 구독합니다 — 이 이벤트가 와야 onPageSelected / onImageDeleted 구독을 정리할 수 있기 때문입니다
     // (예전엔 options.onViewerWillClose 가 없으면 구독을 안 해서 뷰어를 열 때마다 리스너가 누수됐음).
-    const closeHandler = () => {
+    // Android 는 같은 이벤트가 두 구독(eventEmitter·DeviceEventEmitter)으로 올 수 있어 한 번만
+    let closeSent = false
+    const closeHandler = (event?: any) => {
+      if (closeSent) return
+      closeSent = true
       if (options.onViewerWillClose) {
-        options.onViewerWillClose()
+        options.onViewerWillClose(toViewerWillCloseEvent(event))
       }
       if (subscriptionPageSelected) {
         subscriptionPageSelected.remove()

package/src/types.ts

@@ -42,6 +42,20 @@ export interface ImageResult {
   error?: string
   /** 앱이 cancelVideoProcessing 으로 취소한 동영상 (uri 없음) */
   cancelled?: boolean
+  /** 동영상: 미리보기 영상 file:// (video.preview 를 줬고 만들었을 때). 소리 없음, 저화질 mp4 (moov 앞쪽) */
+  previewUri?: string
+  previewWidth?: number
+  previewHeight?: number
+  /** 초(소수) — preview.maxDurationSec 로 잘랐으면 그 길이 */
+  previewDuration?: number
+  /** bytes */
+  previewFileSize?: number
+  /** 평균 비트레이트(bps) — 파일 크기 ÷ 길이 */
+  previewBitrate?: number
+  /** 미리보기만 실패 (전송본 uri 는 정상). "ENCODE_FAILED" */
+  previewError?: string
+  /** 일부러 만들지 않음. "SOURCE_SMALL" = 전송본이 미리보기 기준보다 작거나 같음 (짧은 변 ≤ preview.height 이거나 파일이 예상 미리보기보다 작음) */
+  previewSkipped?: string
 }
 
 /**
@@ -97,6 +111,20 @@ export interface ThumbnailOptions {
 }
 
 /** 동영상 옵션 (GalleryOptions.video). mediaType 이 "video"/"all" 일 때만 의미 */
+/** video.preview — 목록·카드용 미리보기 영상 (1.2.0). 모두 선택, 0 이하·틀린 값은 기본값 */
+export interface VideoPreviewOptions {
+  /** 짧은 변(px). 기본 360. 전송본이 이보다 작거나 같으면 만들지 않음 (previewSkipped "SOURCE_SMALL") */
+  height?: number
+  /** 평균 비트레이트(bps). 기본 450_000 */
+  bitrate?: number
+  /** 최대 fps. 기본 24. 원본이 더 낮으면 원본 그대로. iOS 만 — Android(media3 1.4.1)는 원본 fps 유지 */
+  maxFps?: number
+  /** 앞에서부터 이 길이(초)까지만. 기본 0 = 전송본 전체 */
+  maxDurationSec?: number
+  /** 기본 "h264" (호환성 때문에 h264 권장) */
+  codec?: "h264" | "hevc"
+}
+
 export interface VideoOptions {
   /** 고를 수 있는 최대 길이(초). 기본 600 (10분). 넘는 동영상은 누르면 안내만. 0 = 제한 없음 */
   maxDurationSec?: number
@@ -117,6 +145,11 @@ export interface VideoOptions {
    * onProcessingStart / onImageProcessed 의 thumbnailUri 확장자가 이 값을 따름 (webp 인코딩이 안 되는 드문 경우엔 jpg 로 대신하니, 확장자는 uri 로 확인)
    */
   posterFormat?: "webp" | "jpg"
+  /**
+   * 목록·카드용 미리보기 영상(소리 없음, 저화질 mp4, moov 앞쪽, 키프레임 1초)을 전송본과 함께 만듦 — 전송본(트림·크롭·그리기·음소거가
+   * 반영된 파일)에서 만들어 화면이 같음. 결과 previewUri 등. 없거나 false 면 예전과 같음, true 면 기본값 (1.2.0, iOS + Android)
+   */
+  preview?: boolean | VideoPreviewOptions
   /** 전송 전 변환 진행률 (동영상마다 0~1, 1% 이상 바뀔 때·최소 0.1초 간격) */
   onProgress?: (e: VideoProgressEvent) => void
   /**
@@ -161,6 +194,7 @@ export interface ViewerSourceUpdate extends SourceRect {
   sourceBorderCorners?: ('topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight')[]
   sourceClipRect?: SourceRect | null
   sourceClipInsets?: SourceClipInsets | null
+  underlayViewTag?: number | null
 }
 
 export interface GalleryOptions {
@@ -431,6 +465,23 @@ export interface ViewerVideo {
   cacheFile?: string
   width?: number
   height?: number
+  /**
+   * 초(소수). 이 페이지를 처음 열 때 이 위치부터 재생 (1.2.1). 생략·0 = 처음.
+   * 음수이거나 길이 이상이면 처음부터. 열기 애니메이션 동안은 포스터, 영상은 그 위치로 옮긴 뒤에 나타남
+   * (처음 장면이 비치지 않음). 다른 페이지로 넘겼다 돌아오면 지금처럼 처음부터. 스트리밍·캐시 파일 모두
+   */
+  startTime?: number
+}
+
+/** onViewerWillClose 인자 (1.2.1) */
+export interface ViewerWillCloseEvent {
+  /** 닫을 때 보고 있던 페이지 */
+  currentIndex: number
+  /**
+   * 동영상 페이지 번호 → 마지막 재생 위치(초, 소수). 이번에 재생한 동영상 페이지만 (사진·열지 않은 페이지는 없음).
+   * 끝까지 봤으면 길이. 하나도 없으면 생략
+   */
+  videoPositions?: Record<number, number>
 }
 
 export interface ViewerOptions {
@@ -471,8 +522,20 @@ export interface ViewerOptions {
   sourceClipRect?: SourceRect
   /** 잘라내기를 화면 가장자리 여백으로 (예: { top: 상단 바 높이, bottom: 탭 바 높이 }). 설명은 sourceClipRect 참조 */
   sourceClipInsets?: SourceClipInsets
+  /**
+   * 앱이 반투명 바 바로 아래 층에 둔 빈 뷰의 RN 태그(findNodeHandle). 열림·닫힘 동안 움직이는 사진과 원래 자리 가림 판의
+   * 사본을 이 뷰 안에 그립니다 — 바의 흐림 너머로 사진이 움직이며 바 뒤로 들어가고 나오는 게 보임
+   * (잘라내기만으로는 바 밑 부분이 안 보일 뿐). sourceClipRect/Insets 와 같이 씀. iOS + Android useOverlayViewer.
+   * 뷰 조건: 화면 크기, 자식 없음, collapsable={false}, pointerEvents="none", 리스트보다 뒤·바보다 앞 순서로 렌더.
+   * 자식이 있는 뷰를 넘기면 RN 의 자식 번호가 어긋나 앱이 죽을 수 있습니다.
+   */
+  underlayViewTag?: number
   onPageSelected?: (index: number) => void
-  onViewerWillClose?: () => void
+  /**
+   * 닫기 시작할 때. 1.2.1 부터 { currentIndex, videoPositions } 를 넘김 — 인자 없이 쓰던 코드도 그대로 동작.
+   * (Android 는 useOverlayViewer 뷰어만 videoPositions, 다른 Android 뷰어는 인자 없음)
+   */
+  onViewerWillClose?: (e?: ViewerWillCloseEvent) => void
   /**
    * 상단바에 저장/공유/삭제 아이콘 3개를 표시할지 여부. 기본값 true.
    */