react-native-attachment-kit 1.1.2 → 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 {
@@ -834,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
@@ -841,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]?)
 }
@@ -906,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 {
@@ -922,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
 }
@@ -939,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 {
@@ -1004,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 {
@@ -834,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
@@ -841,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]?)
 }
@@ -906,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 {
@@ -922,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
 }
@@ -939,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 {
@@ -1004,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>
-		mHgBXSRar3by2sly8QkYcG6C3UU=
+		cDIKOxZMZjBEDwXWsaQcXFaOwjY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		48bN+CmMmI2fYY7cip2dEc3a1Hk=
+		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>
-		48bN+CmMmI2fYY7cip2dEc3a1Hk=
+		5+4785ZK6wAQveUYGwxcd97v3fk=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		2uVysiM0Im1jxTaeChoidRvnOWI=
+		myshBYtNXCHjI6pdLLGzq+k7QaY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		mHgBXSRar3by2sly8QkYcG6C3UU=
+		cDIKOxZMZjBEDwXWsaQcXFaOwjY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		oWhA5PRZoNYFRGImJ63eYJr7f4k=
+		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>
-		oWhA5PRZoNYFRGImJ63eYJr7f4k=
+		gDqNg0dOOaQZG+LnUdHe2epfM/Q=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		1KLGAb8IsB2H7iDi1K4E+iXZ/yg=
+		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>
-			iv0FOpabpFXN5cHvliBcJFsiT0Cw+Pq9ybvnzfZCbpk=
+			5U0ebRft0k3pT7dh7XFPPmlXrsYugnRdA4Lzrg58wbs=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			aZ4YAPm1DpNtur5dhJWeONfZ7fglNFXFIXofhCW8eb8=
+			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>
-			aZ4YAPm1DpNtur5dhJWeONfZ7fglNFXFIXofhCW8eb8=
+			8S9V0QeM7wYkvdneQjfZzBBJczr//bsYL3LPwAAgn0M=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			B1ZtnW/xPks/lSm457umvJhXC3ZPV7BEFUTMP9aI18k=
+			jawPPEoY72pY1VUCBTHs7AyHVJpsM4/uD/n6ijfZ9+4=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			iv0FOpabpFXN5cHvliBcJFsiT0Cw+Pq9ybvnzfZCbpk=
+			5U0ebRft0k3pT7dh7XFPPmlXrsYugnRdA4Lzrg58wbs=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			NlaF0PcQyduneps06dOb7PT6UI0qYxZFpMzw8tjg2yY=
+			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>
-			NlaF0PcQyduneps06dOb7PT6UI0qYxZFpMzw8tjg2yY=
+			9hRCvQHf4NkqX1nAk8jG2Vlek5vnm/aq9XSQlJzeZqU=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			VyZGnU0wV4c9WCy/0s/x5bF3+Zp8ISI8WvkakI2A8MM=
+			5KpS89ua5KyMNFPf1VukiCs8RRbMX9viVdOof9j9eVI=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-attachment-kit",
-  "version": "1.1.2",
+  "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
   /**
@@ -432,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 {
@@ -481,7 +531,11 @@ export interface ViewerOptions {
    */
   underlayViewTag?: number
   onPageSelected?: (index: number) => void
-  onViewerWillClose?: () => void
+  /**
+   * 닫기 시작할 때. 1.2.1 부터 { currentIndex, videoPositions } 를 넘김 — 인자 없이 쓰던 코드도 그대로 동작.
+   * (Android 는 useOverlayViewer 뷰어만 videoPositions, 다른 Android 뷰어는 인자 없음)
+   */
+  onViewerWillClose?: (e?: ViewerWillCloseEvent) => void
   /**
    * 상단바에 저장/공유/삭제 아이콘 3개를 표시할지 여부. 기본값 true.
    */