react-native-attachment-kit 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.0.2 — 2026-10-09
+
+Android:
+- Overlay image viewer (`useOverlayViewer`) open/close animations are 50ms shorter: open 250→200ms (photo zoom now follows `openDuration` instead of a fixed 250ms), close 200→150ms.
+
+## 1.0.1 — 2026-10-09
+
+New:
+- `appearance: 'system' | 'light' | 'dark'` option — global default via `init(key, { appearance })`, per-call override on every `open*`. `'system'` (default) follows the device setting.
+- `AttachmentKit.setDefaults({ languageCode, themeColor, appearance })` / `AttachmentKit.getDefaults()` — change global defaults any time after `init`.
+
+Android fixes:
+- Picker → editor no longer flashes the wrong theme when the app forces `appearance: 'light' | 'dark'` that differs from the device setting. The night mode is now set in `attachBaseContext` instead of `onCreate`, so AppCompat no longer draws the screen once and then recreates it. Same fix in `CropActivity`, `ProfileCropActivity`, `DrawingActivity`, `ImageViewerActivity`.
+- Fixed crash `UninitializedPropertyAccessException: lateinit property viewPager` in `ImageEditorActivity.finish()` when the editor was recreated (theme recreate above, system dark-mode switch, or process restore). `finish()` now closes immediately if the screen was never set up, and the editor's photo list (`EditorDataHolder`) is cleared only when the editor really closes and only if it still holds that editor's list.
+- Editor open/close/pull-to-dismiss background now uses the theme color `@color/editor_background` instead of hard-coded black. In light mode the editor used to fade in black and then flash to white when the photo pager appeared.
+- Tapping a photo in the picker no longer blinks the grid cell before the zoom animation. The cell is now hidden right after the editor draws its first frame (the editor's overlay photo covers the cell at that moment), instead of when the picker launches the editor.
+- Pull-to-dismiss in the editor now slides the selection badge away with the top bar (it used to stay floating on screen while the photo was dragged).
+- Picker grid spacing reduced from 4dp to 1dp between cells (same as iOS).
+- Guard against sending the same photo twice after editing (multi-select): the selection returned from the editor is mapped back to original URIs and de-duplicated, the editor keeps only original URIs in its selection, and `sendSelectedImagesNow()` de-duplicates after mapping to edited files.
+
 ## 1.0.0 — 2026-10-02
 
 Renamed from `react-native-turbo-image-picker` 2.0.8 (source 1.2.43 + the 2026-10-02 grid-menu and Android expand-position fixes) to `react-native-attachment-kit`. **JS API, options, event names and type names are unchanged** — apps only change the import path.

package/README.md

@@ -69,7 +69,8 @@ import AttachmentKit from 'react-native-attachment-kit';
 // Pass your license key (if you have one to remove the watermark) and default configurations
 AttachmentKit.init("", { 
   languageCode: 'en', 
-  themeColor: '#ff0000' 
+  themeColor: '#ff0000',
+  appearance: 'system', // 'system' (default, follows the device) | 'light' | 'dark'
 }).catch(console.error);
 
 // Step 2: Open Image Picker
@@ -137,6 +138,15 @@ Initializes the module with a license key and global defaults.
 | `licenseKey` | `string` | Your license key. Pass `""` for evaluation (watermark shown). |
 | `options.themeColor` | `string` | Global default theme color (hex). |
 | `options.languageCode` | `string` | Global default language code. |
+| `options.appearance` | `'system' \| 'light' \| 'dark'` | Global default screen mode. `'system'` (default) follows the device setting; `'light'` / `'dark'` force it. Every `open*` call also accepts `appearance` to override per call. |
+
+### `AttachmentKit.setDefaults(options)` / `AttachmentKit.getDefaults()`
+
+Changes the global defaults (`languageCode`, `themeColor`, `appearance`) at any time after `init` — e.g. right after the user changes the app's theme or language. Only the values you pass are changed.
+
+```ts
+AttachmentKit.setDefaults({ appearance: 'dark' })
+```
 
 ---
 

package/android/src/newarch/java/com/rnattachmentkit/RNAttachmentKitModule.kt

@@ -199,6 +199,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
 
     override fun openEditor(options: ReadableMap, promise: Promise) {
         val activity = getCurrentActivity()
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
         if (activity == null) {
             promise.reject(E_NO_ACTIVITY, "Activity doesn't exist")
             return
@@ -274,6 +275,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         // 편집기/크롭 등 다른 화면들은 TurboImagePickerConfig.languageCode(전역)로 로케일을 잡는데,
         // 그동안 JS가 넘긴 languageCode를 여기에 반영하는 코드가 없어서 항상 기본값 "en"이었습니다.
         TurboImagePickerConfig.languageCode = languageCode
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
         
         val themeColor = if (options.hasKey("themeColor")) {
             options.getString("themeColor")
@@ -461,6 +463,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         // 설정된 언어를 따릅니다.
         val viewerLanguageCode = if (options.hasKey("languageCode")) (options.getString("languageCode") ?: "en") else "en"
         TurboImagePickerConfig.languageCode = viewerLanguageCode
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
 
         var startX = -1f
         var startY = -1f

package/android/src/oldarch/java/com/rnattachmentkit/RNAttachmentKitModule.kt

@@ -137,6 +137,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
     @ReactMethod
     override fun openEditor(options: ReadableMap, promise: Promise) {
         val activity = getCurrentActivity()
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
         if (activity == null) {
             promise.reject(E_NO_ACTIVITY, "Activity doesn't exist")
             return
@@ -212,6 +213,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         // 편집기/크롭 등 다른 화면들은 TurboImagePickerConfig.languageCode(전역)로 로케일을 잡는데,
         // 그동안 JS가 넘긴 languageCode를 여기에 반영하는 코드가 없어서 항상 기본값 "en"이었습니다.
         TurboImagePickerConfig.languageCode = languageCode
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
         
         val themeColor = if (options.hasKey("themeColor")) {
             options.getString("themeColor")
@@ -458,6 +460,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         // 설정된 언어를 따릅니다.
         val viewerLanguageCode = if (options.hasKey("languageCode")) (options.getString("languageCode") ?: "en") else "en"
         TurboImagePickerConfig.languageCode = viewerLanguageCode
+        TurboImagePickerConfig.updateAppearance(if (options.hasKey("appearance")) options.getString("appearance") else null)
         
         val openDuration = if (options.hasKey("openDuration")) options.getInt("openDuration") else defaultAnimationConfig["viewerOpen"] ?: 250
         val closeDuration = if (options.hasKey("closeDuration")) options.getInt("closeDuration") else defaultAnimationConfig["viewerClose"] ?: 200

package/ios/RNAttachmentKit.swift

@@ -22,6 +22,16 @@ import SDWebImageWebPCoder
 
 @objc(RNAttachmentKit)
 class RNAttachmentKit: RCTEventEmitter {
+
+    /// RN 옵션 appearance: "light" | "dark" | "system"(기본, 생략) → 화면 강제 모드.
+    /// "system" 이면 기기 설정을 따릅니다 (.unspecified).
+    static func interfaceStyle(_ options: NSDictionary?) -> UIUserInterfaceStyle {
+        switch (options?["appearance"] as? String)?.lowercased() {
+        case "dark": return .dark
+        case "light": return .light
+        default: return .unspecified
+        }
+    }
     
     public static var shared: RNAttachmentKit?
     
@@ -286,6 +296,7 @@ class RNAttachmentKit: RCTEventEmitter {
             self.zoomAnimator.sourceImage = nil
             
             viewerVC.modalPresentationStyle = .custom
+            viewerVC.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
             viewerVC.transitioningDelegate = self
             
             self.activeViewerVC = viewerVC
@@ -452,6 +463,7 @@ class RNAttachmentKit: RCTEventEmitter {
                 editorVC.allAssets = [asset]
                 editorVC.currentIndex = 0
                 editorVC.modalPresentationStyle = .fullScreen
+                editorVC.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
                 editorVC.singlePhotoMode = true
                 if let color = themeColor {
                     editorVC.themeColor = color
@@ -502,6 +514,7 @@ class RNAttachmentKit: RCTEventEmitter {
                             editorVC.standaloneImage = image
                             editorVC.currentIndex = 0
                             editorVC.modalPresentationStyle = .fullScreen
+                            editorVC.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
                             editorVC.singlePhotoMode = true
                             if let color = themeColor {
                                 editorVC.themeColor = color
@@ -648,6 +661,7 @@ class RNAttachmentKit: RCTEventEmitter {
                         editorVC.disableCrop = true
                         editorVC.croppedImages = [0: croppedImage]
                         editorVC.modalPresentationStyle = .overFullScreen
+                        editorVC.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
                         
                         if let hex = currentGallery.themeColorHex, let color = UIColor(hexString: hex) {
                             editorVC.themeColor = color
@@ -829,6 +843,7 @@ class RNAttachmentKit: RCTEventEmitter {
 
             let navigationController = UINavigationController(rootViewController: galleryVC)
             navigationController.modalPresentationStyle = .custom
+            navigationController.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
             navigationController.transitioningDelegate = galleryVC.customTransitioningDelegate
             
             // navigationController.view.backgroundColor 설정 제거 (투명한 탑바 지원을 위함)
@@ -1613,6 +1628,7 @@ fileprivate extension RNAttachmentKit {
         }
         
         editorVC.modalPresentationStyle = .overFullScreen
+        editorVC.overrideUserInterfaceStyle = RNAttachmentKit.interfaceStyle(options)
         editorVC.singlePhotoMode = !isMultiSelect
         // selectionMode 'multi' + 최대 1장: 편집 화면에서 다른 사진을 선택하면 기존 선택과 교체
         editorVC.replaceSelectionWhenFull = currentGallery.forceMultiMode && currentGallery.maxSelection == 1

package/ios/RNAttachmentKit.xcframework/ios-arm64/RNAttachmentKit.framework/Headers/RNAttachmentKit-Swift.h

@@ -374,6 +374,31 @@ extern "C" {
 
 @class NSCoder;
 @class UITraitCollection;
+/// 바 뒤 화면 하단을 아래로 갈수록 진하게 흐리게(+아주 옅게 어둡게) 덮는 배경. 터치는 통과.
+SWIFT_CLASS("_TtC15RNAttachmentKit18AttachMenuBackdrop")
+@interface AttachMenuBackdrop : UIView
+- (nonnull instancetype)initWithFrame:(CGRect)frame OBJC_DESIGNATED_INITIALIZER;
+- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder SWIFT_UNAVAILABLE;
+- (void)layoutSubviews;
+- (void)didMoveToWindow;
+- (void)traitCollectionDidChange:(UITraitCollection * _Nullable)previousTraitCollection;
+@end
+
+SWIFT_CLASS("_TtC15RNAttachmentKit13AttachMenuBar")
+@interface AttachMenuBar : UIView
+- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder SWIFT_UNAVAILABLE;
+- (void)didMoveToWindow;
+- (void)layoutSubviews;
+- (void)traitCollectionDidChange:(UITraitCollection * _Nullable)previousTraitCollection;
+- (nonnull instancetype)initWithFrame:(CGRect)frame SWIFT_UNAVAILABLE;
+@end
+
+@class UITabBar;
+@class UITabBarItem;
+@interface AttachMenuBar (SWIFT_EXTENSION(RNAttachmentKit)) <UITabBarDelegate>
+- (void)tabBar:(UITabBar * _Nonnull)tabBar didSelectItem:(UITabBarItem * _Nonnull)item;
+@end
+
 @class NSString;
 @class NSBundle;
 SWIFT_CLASS("_TtC15RNAttachmentKit25GalleryBaseViewController")
@@ -414,6 +439,13 @@ SWIFT_AVAILABILITY(ios,introduced=15.0)
 - (void)collectionView:(UICollectionView * _Nonnull)collectionView cancelPrefetchingForItemsAtIndexPaths:(NSArray<NSIndexPath *> * _Nonnull)indexPaths;
 @end
 
+@class UIDocumentPickerViewController;
+@class NSURL;
+@interface GalleryBaseViewController (SWIFT_EXTENSION(RNAttachmentKit)) <UIDocumentPickerDelegate>
+- (void)documentPicker:(UIDocumentPickerViewController * _Nonnull)controller didPickDocumentsAtURLs:(NSArray<NSURL *> * _Nonnull)urls;
+- (void)documentPickerWasCancelled:(UIDocumentPickerViewController * _Nonnull)controller;
+@end
+
 @class UIImagePickerController;
 @interface GalleryBaseViewController (SWIFT_EXTENSION(RNAttachmentKit)) <UIImagePickerControllerDelegate, UINavigationControllerDelegate>
 - (void)imagePickerController:(UIImagePickerController * _Nonnull)picker didFinishPickingMediaWithInfo:(NSDictionary<UIImagePickerControllerInfoKey, id> * _Nonnull)info;
@@ -445,6 +477,12 @@ SWIFT_CLASS("_TtC15RNAttachmentKit21GalleryViewController")
 - (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER;
 @end
 
+@class UIGestureRecognizer;
+@class UITouch;
+@interface GalleryViewController (SWIFT_EXTENSION(RNAttachmentKit)) <UIGestureRecognizerDelegate>
+- (BOOL)gestureRecognizer:(UIGestureRecognizer * _Nonnull)gestureRecognizer shouldReceiveTouch:(UITouch * _Nonnull)touch SWIFT_WARN_UNUSED_RESULT;
+@end
+
 @protocol UIViewControllerAnimatedTransitioning;
 SWIFT_CLASS("_TtC15RNAttachmentKit29ImageEditorTransitionDelegate")
 @interface ImageEditorTransitionDelegate : NSObject <UIViewControllerTransitioningDelegate>
@@ -475,7 +513,6 @@ SWIFT_CLASS("_TtC15RNAttachmentKit25ImageEditorViewController")
 - (void)collectionView:(UICollectionView * _Nonnull)cv cancelPrefetchingForItemsAtIndexPaths:(NSArray<NSIndexPath *> * _Nonnull)indexPaths;
 @end
 
-@class UIGestureRecognizer;
 @interface ImageEditorViewController (SWIFT_EXTENSION(RNAttachmentKit)) <UIGestureRecognizerDelegate>
 - (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer * _Nonnull)gestureRecognizer SWIFT_WARN_UNUSED_RESULT;
 - (BOOL)gestureRecognizer:(UIGestureRecognizer * _Nonnull)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer * _Nonnull)otherGestureRecognizer SWIFT_WARN_UNUSED_RESULT;