react-native-photo-video-editor 0.2.2 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.3.1
+
+- Reduce Android large-video memory pressure with a heap-aware preview sample-buffer target (up to 16 MiB), size-first buffering, and release of preview samples/decoders during export. Restore the paused preview after export cancellation or failure.
+
+## 0.3.0
+
+- Breaking API change: migrate `initialStickerId: 'brand'` to `initialStickerIds: ['brand']`.
+- Replace `initialStickerId` with `initialStickerIds` and add a top-right control on the selected default sticker to cycle through default stickers on Android and iOS. Swaps preserve transforms and support undo/redo; the button is enabled only for multiple IDs.
+- Place the swap control on the sticker’s top-right corner, above the scale control, so it follows dragging and rotation.
+- Remove dummy sticker data from the example; default stickers are supplied by the caller.
+
 ## 0.2.2
 
 - Add `initialStickerId` to place a matching `stickerAssets` image at the center when opening the photo or video editor on Android and iOS.

package/README.md

@@ -57,18 +57,28 @@ See [API](docs/api.md), [architecture](docs/architecture.md), [photo editor](doc
 For local work, run `yarn`, then `yarn typecheck`, `yarn lint`, `yarn test`, and `yarn prepare`. See [CONTRIBUTING.md](CONTRIBUTING.md). MIT licensed; see [LICENSE](LICENSE).
 
 To place a sticker at the center automatically when opening either editor, pass
-`initialStickerId` matching exactly one entry in `stickerAssets`:
+`initialStickerIds` containing unique IDs from `stickerAssets`:
 
 ```ts
 await openPhotoEditor({
   source: { uri: photoUri, type: 'photo' },
-  stickerAssets: [{ id: 'brand', uri: 'https://example.com/brand-sticker.png' }],
-  initialStickerId: 'brand',
+  stickerAssets: [
+    { id: 'brand', uri: 'https://example.com/brand-sticker.png' },
+    { id: 'alternate', uri: 'https://example.com/alternate.png' },
+  ],
+  initialStickerIds: ['brand', 'alternate'],
 });
 ```
 
-The sticker starts at the center of the media and can be moved, resized, or
-removed. The same option works with `openVideoEditor` and `openEditor`, even if
+The first sticker starts at the center of the media and can be moved, resized, or
+removed. The “Switch default sticker” control at the selected default sticker’s top-right
+corner, above its bottom-right scale control, cycles through the IDs in
+order and wraps around, replacing the current default sticker while preserving
+its transforms. Switching is undoable. After deletion, use Undo to restore the sticker and its
+controls. The swap control is disabled for one ID and appears only on the selected
+default sticker. Failed swaps leave the existing sticker in place. The same option works with `openVideoEditor` and `openEditor`, even if
 `features.stickers` hides the sticker picker. Omit it to start without a sticker.
 An unknown or duplicate ID rejects with `E_INVALID_OPTIONS`; an unreadable image
 rejects with `E_SOURCE_UNREADABLE`. HTTPS and local sticker URIs are supported.
+
+Migration: replace `initialStickerId: 'brand'` with `initialStickerIds: ['brand']`.

package/android/src/main/java/com/photovideoeditor/editor/PhotoVideoEditorActivity.kt

@@ -188,13 +188,32 @@ class PhotoVideoEditorActivity : Activity() {
     if (!isFinishing) insertInitialSticker()
   }
 
-  private fun insertInitialSticker() {
-    val id = request.optString("initialStickerId").takeIf { it.isNotBlank() } ?: return
+  private val initialStickerIds: List<String> by lazy {
+    val ids = request.optJSONArray("initialStickerIds")
+    if (ids == null) emptyList() else (0 until ids.length()).map { ids.optString(it) }.filter { it.isNotBlank() }.distinct()
+  }
+  private val initialStickerLayerId = java.util.UUID.randomUUID().toString()
+  private val initialStickerPaths = mutableMapOf<String, String>()
+  private var initialStickerLoading = false
+
+  private fun currentInitialSticker(): PhotoLayer? =
+    (photoSession?.layerStack?.layers ?: videoSession?.layerStack?.layers)?.firstOrNull { it.id == initialStickerLayerId }
+
+  private fun switchInitialSticker() {
+    if (initialStickerLoading || initialStickerIds.size < 2) return
+    val currentIndex = initialStickerIds.indexOf(currentInitialSticker()?.stickerId)
+    insertInitialSticker((currentIndex + 1) % initialStickerIds.size)
+  }
+
+  private fun insertInitialSticker(index: Int = 0) {
+    if (initialStickerLoading) return
+    val id = initialStickerIds.getOrNull(index) ?: return
     val asset = runtimeStickerAssets().firstOrNull { it.id == id } ?: return
+    initialStickerLoading = true
     window.setFlags(android.view.WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE, android.view.WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE)
     Thread {
       val path = try {
-        val localPath = if (asset.uri.startsWith("https://", ignoreCase = true)) {
+        val localPath = initialStickerPaths[id] ?: if (asset.uri.startsWith("https://", ignoreCase = true)) {
           val output = File.createTempFile("pve_initial_sticker_", ".img", cacheDir)
           val connection = java.net.URL(asset.uri).openConnection().apply {
             connectTimeout = 10_000
@@ -210,20 +229,31 @@ class PhotoVideoEditorActivity : Activity() {
         }
       } catch (_: Exception) { null }
       runOnUiThread {
+        initialStickerLoading = false
         window.clearFlags(android.view.WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE)
         if (isFinishing || isDestroyed) return@runOnUiThread
         if (path == null) {
-          finishWithError("The initial sticker could not be loaded.", "E_SOURCE_UNREADABLE")
+          if (initialStickerPaths.isEmpty()) finishWithError("The initial sticker could not be loaded.", "E_SOURCE_UNREADABLE")
+          else Toast.makeText(this, "Could not load this sticker. Try again.", Toast.LENGTH_SHORT).show()
           return@runOnUiThread
         }
+        initialStickerPaths[id] = path
         window.decorView.post {
           if (isFinishing || isDestroyed) return@post
-          val layer = newSticker(stickerId = id, stickerUri = Uri.fromFile(File(path)).toString())
+          val uri = Uri.fromFile(File(path)).toString()
+          val fresh = newSticker(stickerId = id, stickerUri = uri)
+          val layer = currentInitialSticker()?.copy(stickerId = id, stickerUri = uri, overlayAspectRatio = fresh.overlayAspectRatio)
+            ?: fresh.copy(id = initialStickerLayerId)
+          val replace: (List<PhotoLayer>) -> List<PhotoLayer> = { layers ->
+            if (layers.any { it.id == initialStickerLayerId }) layers.map { if (it.id == initialStickerLayerId) layer else it }
+            else layers + layer
+          }
           if (mediaType == "photo") {
-            photoSession?.layerStack?.commit { it + layer }
+            photoSession?.layerStack?.commit(replace)
+            onLayerStackChanged()
             selectLayer(layer.id)
           } else videoSession?.let { session ->
-            session.layerStack.commit { it + layer }
+            session.layerStack.commit(replace)
             onVideoLayerStackChanged()
             selectVideoLayer(layer.id, session)
           }
@@ -320,6 +350,9 @@ class PhotoVideoEditorActivity : Activity() {
     previewContainer.addView(overlay, FrameLayout.LayoutParams(MATCH, MATCH))
 
     val layers = LayerOverlayView(this)
+    layers.swappableLayerId = initialStickerLayerId
+    layers.stickerSwapEnabled = initialStickerIds.size > 1
+    layers.onStickerSwap = { switchInitialSticker() }
     layerOverlay = layers
     previewContainer.addView(layers, FrameLayout.LayoutParams(MATCH, MATCH))
 
@@ -1501,6 +1534,9 @@ class PhotoVideoEditorActivity : Activity() {
       if (videoCropMode) videoCropOverlay.restore(videoMediaBounds(session, playerView, false), session.state.crop)
     }
     val layerOverlay = LayerOverlayView(this)
+    layerOverlay.swappableLayerId = initialStickerLayerId
+    layerOverlay.stickerSwapEnabled = initialStickerIds.size > 1
+    layerOverlay.onStickerSwap = { switchInitialSticker() }
     videoLayerOverlay = layerOverlay
     preview.addView(layerOverlay, FrameLayout.LayoutParams(MATCH, MATCH))
     layerOverlay.onLayerDelete = { id ->
@@ -2254,7 +2290,7 @@ class PhotoVideoEditorActivity : Activity() {
       finishWithError("Nothing to export.", "E_INTERNAL")
       return
     }
-    session.player.pause()
+    session.stopPreviewForExport()
     videoExportProgressView.visibility = View.VISIBLE
     val exporter = VideoExporter(applicationContext)
     videoExporter = exporter
@@ -2285,11 +2321,13 @@ class PhotoVideoEditorActivity : Activity() {
         runOnUiThread {
           videoExporter = null
           videoExportProgressView.visibility = View.GONE
+          session.restorePreviewAfterExport()
           Toast.makeText(this, error.message ?: "Unable to export the video.", Toast.LENGTH_LONG).show()
         }
       }
       )
     } catch (error: Exception) {
+      session.restorePreviewAfterExport()
       videoExporter = null
       videoExportProgressView.visibility = View.GONE
       Toast.makeText(this, error.message ?: "Unable to export the video.", Toast.LENGTH_LONG).show()
@@ -2298,6 +2336,7 @@ class PhotoVideoEditorActivity : Activity() {
 
   private fun cancelVideoExport() {
     videoExporter?.cancel()
+    videoSession?.restorePreviewAfterExport()
     videoExporter = null
     videoExportProgressView.visibility = View.GONE
   }

package/android/src/main/java/com/photovideoeditor/photo/ui/LayerOverlayView.kt

@@ -28,6 +28,11 @@ class LayerOverlayView(context: Context) : View(context) {
     set(value) { field = value; invalidate() }
   var selectedLayerId: String? = null
     set(value) { field = value; invalidate() }
+  var swappableLayerId: String? = null
+    set(value) { field = value; invalidate() }
+  var stickerSwapEnabled = false
+    set(value) { field = value; invalidate() }
+  var onStickerSwap: (() -> Unit)? = null
   var onLayerDelete: ((String) -> Unit)? = null
   var onLayerTapped: ((String?) -> Unit)? = null
   var onLayerDoubleTapped: ((String) -> Unit)? = null
@@ -71,6 +76,10 @@ class LayerOverlayView(context: Context) : View(context) {
     }
     drawControl(canvas, -half.first, -half.second, R.drawable.ic_close, Color.rgb(255, 100, 115))
     drawControl(canvas, half.first, half.second, R.drawable.ic_fullscreen, Color.rgb(167, 139, 250))
+    if (selected.type == LayerType.STICKER && selected.id == swappableLayerId) {
+      drawControl(canvas, half.first, -half.second, R.drawable.ic_swap_sticker,
+        if (stickerSwapEnabled && !selected.locked) Color.rgb(167, 139, 250) else Color.GRAY)
+    }
     canvas.restore()
   }
 
@@ -92,6 +101,17 @@ class LayerOverlayView(context: Context) : View(context) {
         if (selected != null && !selected.locked) {
           val handle = handlePoint(selected)
           val center = centerOf(selected)
+          if (selected.type == LayerType.STICKER && selected.id == swappableLayerId) {
+            val swap = swapPoint(selected)
+            val swapDistance = hypot(event.x - swap.first, event.y - swap.second)
+            val deleteDistance = hypot(event.x - (2 * center.first - handle.first), event.y - (2 * center.second - handle.second))
+            val scaleDistance = hypot(event.x - handle.first, event.y - handle.second)
+            if (swapDistance <= handleTouchRadius && swapDistance <= deleteDistance && swapDistance <= scaleDistance) {
+              resetGesture()
+              if (stickerSwapEnabled) onStickerSwap?.invoke()
+              return true
+            }
+          }
           if (hypot(event.x - (2 * center.first - handle.first), event.y - (2 * center.second - handle.second)) <= handleTouchRadius) {
             onLayerDelete?.invoke(selected.id); resetGesture(); return true
           }
@@ -225,6 +245,12 @@ class LayerOverlayView(context: Context) : View(context) {
     return Pair(center.first + (half.first * cos(radians) - half.second * sin(radians)).toFloat(), center.second + (half.first * sin(radians) + half.second * cos(radians)).toFloat())
   }
 
+  private fun swapPoint(layer: PhotoLayer): Pair<Float, Float> {
+    val center = centerOf(layer); val half = selectionHalfExtents(layer)
+    val radians = Math.toRadians(layer.rotationDegrees.toDouble())
+    return Pair(center.first + (half.first * cos(radians) + half.second * sin(radians)).toFloat(), center.second + (half.first * sin(radians) - half.second * cos(radians)).toFloat())
+  }
+
   private fun isHandleHit(layer: PhotoLayer, x: Float, y: Float): Boolean {
     val handle = handlePoint(layer)
     return hypot(x - handle.first, y - handle.second) <= handleTouchRadius

package/android/src/main/java/com/photovideoeditor/video/render/VideoBufferBudget.kt

@@ -0,0 +1,10 @@
+package com.photovideoeditor.video.render
+
+/** Leave heap space for the host React Native app, decoded frames, and editor bitmaps. */
+internal object VideoBufferBudget {
+  private const val MIB = 1024L * 1024L
+
+  // A target rather than a hard heap cap: Media3 can finish a sample after reaching it.
+  fun targetBytes(maxHeapBytes: Long): Int =
+    (maxHeapBytes / 16).coerceIn(2 * MIB, 16 * MIB).toInt()
+}

package/android/src/main/java/com/photovideoeditor/video/render/VideoEditSession.kt

@@ -6,6 +6,7 @@ import androidx.media3.common.MediaItem
 import androidx.media3.common.PlaybackException
 import androidx.media3.common.Player
 import androidx.media3.exoplayer.ExoPlayer
+import androidx.media3.exoplayer.DefaultLoadControl
 import com.photovideoeditor.photo.render.PhotoLayerStack
 import java.io.File
 
@@ -21,7 +22,17 @@ class VideoEditSession(context: Context, val sourceUri: String) {
     private set
   var sourceHeight = 0
     private set
-  val player: ExoPlayer = ExoPlayer.Builder(context).build()
+  // Bound compressed samples independently of bitrate/duration. Time-first buffering
+  // can otherwise exhaust the host app's heap on high-bitrate camera footage.
+  val player: ExoPlayer = ExoPlayer.Builder(context)
+    .setLoadControl(DefaultLoadControl.Builder()
+      .setTargetBufferBytes(VideoBufferBudget.targetBytes(Runtime.getRuntime().maxMemory()))
+      .setBufferDurationsMs(2_000, 5_000, 500, 1_000)
+      .setPrioritizeTimeOverSizeThresholds(false)
+      .setBackBuffer(0, false)
+      .build())
+    .build()
+  private var previewStoppedForExport = false
 
   /** Text/sticker/shape overlays. Reuses the photo layer model/stack — see `PhotoLayer.startMs`/`endMs` for timing. */
   val layerStack = PhotoLayerStack()
@@ -133,6 +144,21 @@ class VideoEditSession(context: Context, val sourceUri: String) {
     }
   }
 
+  /** Pause alone retains samples and decoders; stop releases them while retaining the playlist/position. */
+  fun stopPreviewForExport() {
+    if (previewStoppedForExport) return
+    previewStoppedForExport = true
+    player.pause()
+    player.stop()
+  }
+
+  /** Export failure/cancellation returns to the same paused preview. */
+  fun restorePreviewAfterExport() {
+    if (!previewStoppedForExport) return
+    previewStoppedForExport = false
+    player.prepare()
+  }
+
   fun release() {
     onClipsReady = null
     onPlaybackError = null

package/android/src/main/res/drawable/ic_swap_sticker.xml

@@ -0,0 +1,3 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:width="24dp" android:height="24dp" android:viewportWidth="24" android:viewportHeight="24">
+    <path android:fillColor="#FFFFFFFF" android:pathData="M7,7h11l-3,-3 1.4,-1.4L22,8l-5.6,5.4L15,12l3,-3H7zM17,17H6l3,3 -1.4,1.4L2,16l5.6,-5.4L9,12l-3,3h11z" />
+</vector>

package/ios/Editor/PhotoVideoEditorViewController.swift

@@ -15,7 +15,10 @@ final class PhotoVideoEditorViewController: UIViewController {
   private let features: [String: Any]
   private let theme: [String: Any]
   private let exportOptions: [String: Any]
-  private let initialStickerId: String?
+  private let initialStickerIds: [String]
+  private let initialStickerLayerID = UUID().uuidString
+  private var initialStickerImages: [String: (URL, UIImage)] = [:]
+  private var initialStickerLoading = false
   private let stickerAssets: [[String: Any]]
   var completion: ((PhotoVideoEditorOutcome) -> Void)?
 
@@ -119,7 +122,7 @@ final class PhotoVideoEditorViewController: UIViewController {
     theme: [String: Any] = [:],
     exportOptions: [String: Any] = [:],
     stickerAssets: [[String: Any]] = [],
-    initialStickerId: String? = nil
+    initialStickerIds: [String] = []
   ) {
     self.uri = uri
     self.mediaType = mediaType
@@ -127,7 +130,7 @@ final class PhotoVideoEditorViewController: UIViewController {
     self.theme = theme
     self.exportOptions = exportOptions
     self.stickerAssets = stickerAssets
-    self.initialStickerId = initialStickerId
+    self.initialStickerIds = initialStickerIds
     super.init(nibName: nil, bundle: nil)
     modalPresentationStyle = .fullScreen
   }
@@ -160,21 +163,68 @@ final class PhotoVideoEditorViewController: UIViewController {
     insertInitialSticker()
   }
 
-  private func insertInitialSticker() {
-    guard let id = initialStickerId,
-          let asset = consumerStickerAssets().first(where: { $0.id == id }) else { return }
+  private func currentInitialSticker() -> PhotoLayer? {
+    (photoSession?.layerStack.layers ?? videoSession?.layerStack.layers ?? []).first { $0.id == initialStickerLayerID }
+  }
+
+  private func switchInitialSticker() {
+    guard !initialStickerLoading, initialStickerIds.count > 1 else { return }
+    let currentID = currentInitialSticker()?.stickerId
+    let currentIndex = currentID.flatMap { initialStickerIds.firstIndex(of: $0) } ?? -1
+    insertInitialSticker(index: (currentIndex + 1) % initialStickerIds.count)
+  }
+
+  private func insertInitialSticker(index: Int = 0) {
+    guard !initialStickerLoading, initialStickerIds.indices.contains(index) else { return }
+    let id = initialStickerIds[index]
+    guard let asset = consumerStickerAssets().first(where: { $0.id == id }) else { return }
+    initialStickerLoading = true
     view.isUserInteractionEnabled = false
-    let loader = OnlineStickerSheetViewController()
-    loader.loadRuntimeSticker(.init(id: id, uri: asset.uri)) { [weak self, loader] url, image in
-      _ = loader // Keep the loader alive until its download finishes.
+    let apply: (URL?, UIImage?) -> Void = { [weak self] url, image in
       guard let self else { return }
+      self.initialStickerLoading = false
       self.view.isUserInteractionEnabled = true
       guard let url, let image else {
-        self.completion?(.failure(code: "E_SOURCE_UNREADABLE", message: "The initial sticker could not be loaded."))
+        if self.initialStickerImages.isEmpty {
+          self.completion?(.failure(code: "E_SOURCE_UNREADABLE", message: "The initial sticker could not be loaded."))
+        } else {
+          let alert = UIAlertController(title: "Couldn't load sticker", message: "Please try again.", preferredStyle: .alert)
+          alert.addAction(UIAlertAction(title: "OK", style: .default))
+          self.present(alert, animated: true)
+        }
         return
       }
+      self.initialStickerImages[id] = (url, image)
       self.view.layoutIfNeeded()
-      self.handlePickedImage(url, image: image, purpose: self.mediaType == "photo" ? .photoSticker : .videoSticker)
+      var layer = self.currentInitialSticker() ?? self.newSticker()
+      layer.id = self.initialStickerLayerID
+      layer.stickerId = id
+      layer.stickerUri = url.absoluteString
+      layer.overlayAspectRatio = max(image.size.width, 1) / max(image.size.height, 1)
+      let replace: ([PhotoLayer]) -> [PhotoLayer] = { layers in
+        if layers.contains(where: { $0.id == self.initialStickerLayerID }) {
+          return layers.map { $0.id == self.initialStickerLayerID ? layer : $0 }
+        }
+        return layers + [layer]
+      }
+      if let session = self.photoSession {
+        session.layerStack.commit(replace)
+        self.onLayerStackChanged()
+        self.selectLayer(layer.id)
+      } else if let session = self.videoSession {
+        session.layerStack.commit(replace)
+        self.onVideoLayerStackChanged()
+        self.selectVideoLayer(layer.id, session: session)
+      }
+    }
+    if let cached = initialStickerImages[id] {
+      apply(cached.0, cached.1)
+    } else {
+      let loader = OnlineStickerSheetViewController()
+      loader.loadRuntimeSticker(.init(id: id, uri: asset.uri)) { [loader] url, image in
+        _ = loader // Keep the loader alive until its download finishes.
+        apply(url, image)
+      }
     }
   }
 
@@ -233,7 +283,10 @@ final class PhotoVideoEditorViewController: UIViewController {
       overlay.bottomAnchor.constraint(equalTo: preview.bottomAnchor),
     ])
 
-    let layers = LayerOverlayView()
+    let layers = LayerOverlayView(frame: .zero)
+    layers.swappableLayerID = initialStickerLayerID
+    layers.stickerSwapEnabled = initialStickerIds.count > 1
+    layers.onStickerSwap = { [weak self] in self?.switchInitialSticker() }
     layerOverlay = layers
     preview.addSubview(layers)
     layers.translatesAutoresizingMaskIntoConstraints = false
@@ -1568,7 +1621,10 @@ final class PhotoVideoEditorViewController: UIViewController {
       let scale = bounds.width/max(fitted.width,0.001)
       playerView.transform = CGAffineTransform(translationX:bounds.midX-fitted.midX,y:bounds.midY-fitted.midY).scaledBy(x:scale,y:scale)
     }
-    let videoLayers = LayerOverlayView()
+    let videoLayers = LayerOverlayView(frame: .zero)
+    videoLayers.swappableLayerID = initialStickerLayerID
+    videoLayers.stickerSwapEnabled = initialStickerIds.count > 1
+    videoLayers.onStickerSwap = { [weak self] in self?.switchInitialSticker() }
     videoLayerOverlay = videoLayers
     preview.addSubview(videoLayers)
     videoLayers.translatesAutoresizingMaskIntoConstraints = false

package/ios/Photo/UI/LayerOverlayView.swift

@@ -8,6 +8,9 @@ final class LayerOverlayView: UIView {
   var maxScale: CGFloat = 8
   var layers: [PhotoLayer] = [] { didSet { setNeedsDisplay() } }
   var selectedLayerID: String? { didSet { setNeedsDisplay() } }
+  var swappableLayerID: String? { didSet { setNeedsDisplay() } }
+  var stickerSwapEnabled = false { didSet { setNeedsDisplay() } }
+  var onStickerSwap: (() -> Void)?
   var onLayerDelete: ((String) -> Void)?
   var onLayerTapped: ((String?) -> Void)?
   var onLayerDoubleTapped: ((String) -> Void)?
@@ -52,6 +55,9 @@ final class LayerOverlayView: UIView {
     }
     drawControl(context, point: CGPoint(x: -half.width, y: -half.height), symbol: "xmark", tint: .systemRed)
     drawControl(context, point: CGPoint(x: half.width, y: half.height), symbol: "arrow.up.left.and.arrow.down.right", tint: DesignTokens.primary)
+    if layer.type == .sticker && layer.id == swappableLayerID {
+      drawControl(context, point: CGPoint(x: half.width, y: -half.height), symbol: "arrow.left.arrow.right", tint: stickerSwapEnabled && !layer.locked ? DesignTokens.primary : .gray)
+    }
     context.restoreGState()
   }
 
@@ -80,6 +86,14 @@ final class LayerOverlayView: UIView {
     if let selected, !selected.locked {
       let center = center(of: selected); let handle = handlePoint(selected)
       let deletePoint = CGPoint(x: center.x * 2 - handle.x, y: center.y * 2 - handle.y)
+      if selected.type == .sticker && selected.id == swappableLayerID {
+        let swapDistance = distance(swapPoint(selected), point)
+        if swapDistance <= handleTouchRadius && swapDistance <= distance(deletePoint, point) && swapDistance <= distance(handle, point) {
+          resetGesture()
+          if stickerSwapEnabled { onStickerSwap?() }
+          return
+        }
+      }
       if distance(deletePoint, point) <= handleTouchRadius { onLayerDelete?(selected.id); resetGesture(); return }
     }
     let handleHit = selected.flatMap { !$0.locked && isHandleHit($0, point) ? $0 : nil }
@@ -178,6 +192,10 @@ final class LayerOverlayView: UIView {
     let center = center(of: layer); let half = selectionHalfExtents(layer); let radians = layer.rotationDegrees * .pi / 180
     return CGPoint(x: center.x + half.width * cos(radians) - half.height * sin(radians), y: center.y + half.width * sin(radians) + half.height * cos(radians))
   }
+  private func swapPoint(_ layer: PhotoLayer) -> CGPoint {
+    let center = center(of: layer); let half = selectionHalfExtents(layer); let radians = layer.rotationDegrees * .pi / 180
+    return CGPoint(x: center.x + half.width * cos(radians) + half.height * sin(radians), y: center.y + half.width * sin(radians) - half.height * cos(radians))
+  }
   private func isHandleHit(_ layer: PhotoLayer, _ point: CGPoint) -> Bool { distance(handlePoint(layer), point) <= handleTouchRadius }
   private func hitTest(_ point: CGPoint) -> PhotoLayer? {
     for layer in layers.reversed() where layer.visible {

package/ios/PhotoVideoEditor.swift

@@ -31,7 +31,7 @@ public class PhotoVideoEditorSwift: NSObject {
       theme: payload["theme"] as? [String: Any] ?? [:],
       exportOptions: payload["export"] as? [String: Any] ?? [:],
       stickerAssets: payload["stickerAssets"] as? [[String: Any]] ?? [],
-      initialStickerId: payload["initialStickerId"] as? String
+      initialStickerIds: payload["initialStickerIds"] as? [String] ?? []
     )
     controller.completion = { [weak self, weak controller] outcome in
       guard let self else { return }

package/lib/module/index.js

@@ -39,10 +39,13 @@ function normalizeOptions(input) {
   positive(output.frameRate, 'export.frameRate');
   if (input.source.type === 'photo' && output.videoFormat !== undefined) invalid('videoFormat is only valid for video sources.');
   if (input.source.type === 'video' && output.imageFormat !== undefined) invalid('imageFormat is only valid for photo sources.');
-  if (input.initialStickerId !== undefined) {
-    if (typeof input.initialStickerId !== 'string' || !input.initialStickerId.trim()) invalid('initialStickerId must be a non-empty string.');
-    const matches = Array.isArray(input.stickerAssets) ? input.stickerAssets.filter(asset => asset?.id === input.initialStickerId) : [];
-    if (matches.length !== 1 || typeof matches[0]?.uri !== 'string' || !matches[0].uri.trim()) invalid('initialStickerId must match exactly one stickerAssets entry with a non-empty uri.');
+  if (input.initialStickerIds !== undefined) {
+    if (!Array.isArray(input.initialStickerIds) || input.initialStickerIds.some(id => typeof id !== 'string' || !id.trim())) invalid('initialStickerIds must be an array of non-empty strings.');
+    if (new Set(input.initialStickerIds).size !== input.initialStickerIds.length) invalid('initialStickerIds must contain unique IDs.');
+    for (const id of input.initialStickerIds) {
+      const matches = Array.isArray(input.stickerAssets) ? input.stickerAssets.filter(asset => asset?.id === id) : [];
+      if (matches.length !== 1 || typeof matches[0]?.uri !== 'string' || !matches[0].uri.trim()) invalid('Each initialStickerIds entry must match exactly one stickerAssets entry with a non-empty uri.');
+    }
   }
   const features = {
     ...defaultFeatures,

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativePhotoVideoEditor","PhotoVideoEditorError","normalizeEditorError","addEditorEventListener","addExportProgressListener","EDITOR_PROJECT_SCHEMA_VERSION","mediaTypes","Set","qualities","imageFormats","videoFormats","defaultFeatures","crop","rotate","trim","filters","text","stickers","draw","overlays","invalid","message","positive","value","name","undefined","Number","isFinite","normalizeOptions","input","source","uri","has","type","output","export","quality","imageFormat","videoFormat","maxWidth","maxHeight","videoBitrate","frameRate","initialStickerId","matches","Array","isArray","stickerAssets","filter","asset","id","length","features","preserveMetadata","saveToGallery","openEditor","options","JSON","parse","stringify","error","openPhotoEditor","openVideoEditor","cancelExport","jobId","isAvailable"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativePhotoVideoEditor","PhotoVideoEditorError","normalizeEditorError","addEditorEventListener","addExportProgressListener","EDITOR_PROJECT_SCHEMA_VERSION","mediaTypes","Set","qualities","imageFormats","videoFormats","defaultFeatures","crop","rotate","trim","filters","text","stickers","draw","overlays","invalid","message","positive","value","name","undefined","Number","isFinite","normalizeOptions","input","source","uri","has","type","output","export","quality","imageFormat","videoFormat","maxWidth","maxHeight","videoBitrate","frameRate","initialStickerIds","Array","isArray","some","id","size","length","matches","stickerAssets","filter","asset","features","preserveMetadata","saveToGallery","openEditor","options","JSON","parse","stringify","error","openPhotoEditor","openVideoEditor","cancelExport","jobId","isAvailable"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAIZ,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,YAAS,CAAC;AAEjB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,aAAU,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAU,CAAC;AACjD,mBAAmB,YAAS,CAAC;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAW,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAW,CAAC;AA0F/C,mEAAmE;AACnE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAUvB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AACD,0FAA0F;AAC1F,wBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnE;AACD,4EAA4E;AAC5E,wBAAgB,WAAW,IAAI,OAAO,CAErC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAIZ,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,YAAS,CAAC;AAEjB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,aAAU,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAU,CAAC;AACjD,mBAAmB,YAAS,CAAC;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAW,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAW,CAAC;AA8F/C,mEAAmE;AACnE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAUvB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AACD,0FAA0F;AAC1F,wBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnE;AACD,4EAA4E;AAC5E,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/lib/typescript/src/types.d.ts

@@ -62,7 +62,7 @@ export interface EditorOptions {
     /** Native UI theme. */ theme?: EditorTheme;
     /** Export preferences. */ export?: ExportOptions;
     /** Requests saving to the gallery. Currently ignored by the placeholder. */ saveToGallery?: boolean;
-    /** ID in stickerAssets to insert at the media center when the editor opens. */ initialStickerId?: string;
+    /** Ordered, unique IDs in stickerAssets. The first starts centered; the sticker’s top-right control cycles through the rest. */ initialStickerIds?: string[];
     /** Consumer-provided stickers offered by the Stickers tool, in addition to the small built-in set and end-user uploads. */ stickerAssets?: StickerAsset[];
     /** Consumer-provided fonts selectable from the Text tool. */ fonts?: FontAsset[];
 }

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-photo-video-editor",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Native photo and video editor for React Native, powered by Kotlin and Swift.",
   "main": "./lib/module/index.js",
   "module": "./lib/module/index.js",

package/src/index.ts

@@ -72,25 +72,29 @@ function normalizeOptions(input: EditorOptions): EditorOptions {
     invalid('videoFormat is only valid for video sources.');
   if (input.source.type === 'video' && output.imageFormat !== undefined)
     invalid('imageFormat is only valid for photo sources.');
-  if (input.initialStickerId !== undefined) {
+  if (input.initialStickerIds !== undefined) {
     if (
-      typeof input.initialStickerId !== 'string' ||
-      !input.initialStickerId.trim()
+      !Array.isArray(input.initialStickerIds) ||
+      input.initialStickerIds.some((id) => typeof id !== 'string' || !id.trim())
     )
-      invalid('initialStickerId must be a non-empty string.');
-    const matches = Array.isArray(input.stickerAssets)
-      ? input.stickerAssets.filter(
-          (asset) => asset?.id === input.initialStickerId
-        )
-      : [];
+      invalid('initialStickerIds must be an array of non-empty strings.');
     if (
-      matches.length !== 1 ||
-      typeof matches[0]?.uri !== 'string' ||
-      !matches[0].uri.trim()
+      new Set(input.initialStickerIds).size !== input.initialStickerIds.length
     )
-      invalid(
-        'initialStickerId must match exactly one stickerAssets entry with a non-empty uri.'
-      );
+      invalid('initialStickerIds must contain unique IDs.');
+    for (const id of input.initialStickerIds) {
+      const matches = Array.isArray(input.stickerAssets)
+        ? input.stickerAssets.filter((asset) => asset?.id === id)
+        : [];
+      if (
+        matches.length !== 1 ||
+        typeof matches[0]?.uri !== 'string' ||
+        !matches[0].uri.trim()
+      )
+        invalid(
+          'Each initialStickerIds entry must match exactly one stickerAssets entry with a non-empty uri.'
+        );
+    }
   }
   const features = { ...defaultFeatures, ...input.features };
   if (input.source.type === 'photo') {

package/src/types.ts

@@ -70,7 +70,7 @@ export interface EditorOptions {
   /** Native UI theme. */ theme?: EditorTheme;
   /** Export preferences. */ export?: ExportOptions;
   /** Requests saving to the gallery. Currently ignored by the placeholder. */ saveToGallery?: boolean;
-  /** ID in stickerAssets to insert at the media center when the editor opens. */ initialStickerId?: string;
+  /** Ordered, unique IDs in stickerAssets. The first starts centered; the sticker’s top-right control cycles through the rest. */ initialStickerIds?: string[];
   /** Consumer-provided stickers offered by the Stickers tool, in addition to the small built-in set and end-user uploads. */ stickerAssets?: StickerAsset[];
   /** Consumer-provided fonts selectable from the Text tool. */ fonts?: FontAsset[];
 }