@imgly/editor-react-native 1.77.0 → 1.80.0-rc.0

package/android/build.gradle

@@ -143,7 +143,7 @@ repositories {
 }
 
 dependencies {
-    api "ly.img:editor:1.77.0"
+    api "ly.img:editor:1.80.0-rc.0"
 
     implementation "androidx.activity:activity-ktx:1.9.0"
     implementation "androidx.appcompat:appcompat:1.7.1"

package/android/src/main/kotlin/ly/img/editor/configuration/photo/callback/OnCreate.kt

@@ -102,6 +102,7 @@ suspend fun PhotoConfigurationBuilder.onLoadAssetSources() {
             "ly.img.text.styles",
             "ly.img.text.curves",
             "ly.img.text.components",
+            "ly.img.image",
         )
         sourceIds.forEach { id ->
             launch {

package/android/src/main/kotlin/ly/img/editor/configuration/video/callback/OnExport.kt

@@ -3,7 +3,9 @@ package ly.img.editor.configuration.video.callback
 import kotlinx.coroutines.CancellationException
 import ly.img.editor.configuration.video.VideoConfigurationBuilder
 import ly.img.editor.configuration.video.model.ExportStatus
+import ly.img.engine.ExportVideoOptions
 import ly.img.engine.MimeType
+import ly.img.engine.VideoBitrate
 import java.nio.ByteBuffer
 
 /**
@@ -63,6 +65,8 @@ suspend fun VideoConfigurationBuilder.onExportByteBuffer(): ByteBuffer {
                 exportStatus = ExportStatus.Loading(progress = newProgress)
             }
         },
+        // videoBitrate: VideoBitrate.Auto derives a bounded bitrate from the resolution/framerate.
+        options = ExportVideoOptions(videoBitrate = VideoBitrate.Auto),
     )
 }
 // highlight-starter-kit-on-export-byte-buffer

package/android/src/main/kotlin/ly/img/editor/reactnative/module/builder/EditorBuilder.kt

@@ -435,7 +435,7 @@ object EditorBuilderDefaults {
     }
 
     private suspend fun saveScene(scene: String): Uri = withContext(Dispatchers.IO) {
-        val file = File.createTempFile("cesdk_export_scene_" + UUID.randomUUID().toString(), ".scene")
+        val file = File.createTempFile("cesdk_export_scene_" + UUID.randomUUID().toString(), ".imgly")
         file.writeText(scene)
         Uri.fromFile(file)
     }

package/android/src/main/kotlin/ly/img/editor/reactnative/module/model/EditorSourceType.kt

@@ -7,7 +7,7 @@ import android.os.Parcelable
 enum class EditorSourceType(
     val value: String,
 ) : Parcelable {
-    /** A `.scene` file. */
+    /** A scene file (`.imgly` or the legacy `.scene`). */
     SCENE("scene"),
 
     /** An image file, e.g. `.png`. */

package/ios/Extensions/String+.swift

@@ -3,5 +3,7 @@ import Foundation
 /// An extension to allow throwing strings.
 extension String: LocalizedError {
   /// The error description.
-  public var errorDescription: String? { self }
+  public var errorDescription: String? {
+    self
+  }
 }

package/ios/Helper/ExportHelper.swift

@@ -22,7 +22,9 @@ class ExportHelper {
   /// - Returns: The file `URL`.
   func saveScene(_ scene: String) throws -> URL? {
     let fileName = "cesdk_export_scene_" + UUID().uuidString
-    let url = FileManager.default.temporaryDirectory.appendingPathComponent(fileName, conformingTo: .plainText)
+    let url = FileManager.default.temporaryDirectory
+      .appendingPathComponent(fileName)
+      .appendingPathExtension("imgly")
     if let data = scene.data(using: .utf8) {
       try data.write(to: url, options: [.atomic])
       return url

package/ios/Model/EditorBuilder.swift

@@ -19,7 +19,7 @@ public enum EditorBuilder {
     _ settings: EditorSettings,
     _ preset: EditorPreset?,
     _ metadata: [String: Any]?,
-    _ result: @escaping EditorBuilderResult
+    _ result: @escaping EditorBuilderResult,
   ) -> UIViewController
 
   /// The default design editor.
@@ -99,7 +99,9 @@ public enum EditorBuilder {
                   let editorResult = try await OnExport.exportVideo(engine, eventHandler, .mp4)
                   result(.success(editorResult))
                 } catch {
-                  if error is CancellationError { return }
+                  if error is CancellationError {
+                    return
+                  }
                   result(.failure(error))
                 }
               }
@@ -175,11 +177,10 @@ public enum EditorBuilder {
     _ settings: EditorSettings,
     _ preset: EditorPreset?,
     _ metadata: [String: Any]?,
-    _ result: @escaping EditorBuilderResult
+    _ result: @escaping EditorBuilderResult,
   ) -> some View) -> Builder {
     { settings, preset, metadata, result in
-      let hostingController = UIHostingController(rootView: contentProvider(settings, preset, metadata, result))
-      return hostingController
+      UIHostingController(rootView: contentProvider(settings, preset, metadata, result))
     }
   }
 }
@@ -194,10 +195,11 @@ extension EditorBuilder {
     // Identify this engine as React-Native-hosted so v4 licenses scoped to
     // `host: react-native` validate. Hardcoded (not customer-configurable).
     let host = "react-native"
-    if let url = URL(string: settings.baseUri) {
-      return EngineSettings(license: settings.license, userID: settings.userId, baseURL: url, host: host)
-    } else {
-      return EngineSettings(license: settings.license, userID: settings.userId, host: host)
-    }
+    return EngineSettings(
+      license: settings.license,
+      userID: settings.userId,
+      baseURL: URL(string: settings.baseUri),
+      host: host,
+    )
   }
 }

package/ios/Model/EditorSettings.swift

@@ -22,8 +22,7 @@
   public static func fromDictionary(_ dictionary: [String: Any]) -> EditorSettings? {
     do {
       let data = try JSONSerialization.data(withJSONObject: dictionary, options: [])
-      let settings = try JSONDecoder().decode(EditorSettings.self, from: data)
-      return settings
+      return try JSONDecoder().decode(EditorSettings.self, from: data)
     } catch {
       print("Error decoding dictionary: \(error)")
       return nil

package/ios/StarterKits/Apparel/ApparelEditorConfiguration.swift

@@ -15,32 +15,48 @@ public final class ApparelEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Settings
 
   /// The zoom padding for the canvas.
-  override public var zoomPadding: CGFloat? { 16 }
+  override public var zoomPadding: CGFloat? {
+    16
+  }
 
   // MARK: - EditorConfiguration — Callbacks
 
   /// The `onCreate` handler.
-  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+  override public var onCreate: OnCreate.Handler? {
+    Self.defaultOnCreateHandler
+  }
 
   /// The `onChanged` handler.
-  override public var onChanged: OnChanged.Handler? { Self.defaultOnChangedHandler }
+  override public var onChanged: OnChanged.Handler? {
+    Self.defaultOnChangedHandler
+  }
 
   /// The export handler.
   ///
   /// Default: Exports the scene as PDF and opens the system share sheet.
-  override public var onExport: OnExport.Handler? { Self.defaultOnExportHandler }
+  override public var onExport: OnExport.Handler? {
+    Self.defaultOnExportHandler
+  }
 
   // MARK: - EditorConfiguration — UI Components
 
   /// The navigation bar configuration.
-  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+  override public var navigationBar: NavigationBar.Configuration? {
+    Self.defaultNavigationBar
+  }
 
   /// The dock configuration.
-  override public var dock: Dock.Configuration? { Self.defaultDock }
+  override public var dock: Dock.Configuration? {
+    Self.defaultDock
+  }
 
   /// The inspector bar configuration.
-  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+  override public var inspectorBar: InspectorBar.Configuration? {
+    Self.defaultInspectorBar
+  }
 
   /// The canvas menu configuration.
-  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+  override public var canvasMenu: CanvasMenu.Configuration? {
+    Self.defaultCanvasMenu
+  }
 }

package/ios/StarterKits/Design/DesignEditorConfiguration.swift

@@ -15,29 +15,43 @@ public final class DesignEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Settings
 
   /// The zoom padding for the canvas.
-  override public var zoomPadding: CGFloat? { 16 }
+  override public var zoomPadding: CGFloat? {
+    16
+  }
 
   // MARK: - EditorConfiguration — Callbacks
 
   /// The `onCreate` handler.
-  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+  override public var onCreate: OnCreate.Handler? {
+    Self.defaultOnCreateHandler
+  }
 
   /// The export handler.
   ///
   /// Default: Exports the scene as PDF and opens the system share sheet.
-  override public var onExport: OnExport.Handler? { Self.defaultOnExportHandler }
+  override public var onExport: OnExport.Handler? {
+    Self.defaultOnExportHandler
+  }
 
   // MARK: - EditorConfiguration — UI Components
 
   /// The navigation bar configuration.
-  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+  override public var navigationBar: NavigationBar.Configuration? {
+    Self.defaultNavigationBar
+  }
 
   /// The dock configuration.
-  override public var dock: Dock.Configuration? { Self.defaultDock }
+  override public var dock: Dock.Configuration? {
+    Self.defaultDock
+  }
 
   /// The inspector bar configuration.
-  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+  override public var inspectorBar: InspectorBar.Configuration? {
+    Self.defaultInspectorBar
+  }
 
   /// The canvas menu configuration.
-  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+  override public var canvasMenu: CanvasMenu.Configuration? {
+    Self.defaultCanvasMenu
+  }
 }

package/ios/StarterKits/Photo/PhotoEditorConfiguration.swift

@@ -14,35 +14,53 @@ public final class PhotoEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Settings
 
   /// The zoom padding for the canvas.
-  override public var zoomPadding: CGFloat? { 0 }
+  override public var zoomPadding: CGFloat? {
+    0
+  }
 
   // MARK: - EditorConfiguration — Callbacks
 
   /// The `onCreate` handler.
-  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+  override public var onCreate: OnCreate.Handler? {
+    Self.defaultOnCreateHandler
+  }
 
   /// The `onLoaded` handler.
-  override public var onLoaded: OnLoaded.Handler? { Self.defaultOnLoadedHandler }
+  override public var onLoaded: OnLoaded.Handler? {
+    Self.defaultOnLoadedHandler
+  }
 
   /// The `onChanged` handler.
-  override public var onChanged: OnChanged.Handler? { Self.defaultOnChangedHandler }
+  override public var onChanged: OnChanged.Handler? {
+    Self.defaultOnChangedHandler
+  }
 
   /// The export handler.
   ///
   /// Default: Exports the scene as PNG and opens the system share sheet.
-  override public var onExport: OnExport.Handler? { Self.defaultOnExportHandler }
+  override public var onExport: OnExport.Handler? {
+    Self.defaultOnExportHandler
+  }
 
   // MARK: - EditorConfiguration — UI Components
 
   /// The navigation bar configuration.
-  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+  override public var navigationBar: NavigationBar.Configuration? {
+    Self.defaultNavigationBar
+  }
 
   /// The dock configuration.
-  override public var dock: Dock.Configuration? { Self.defaultDock }
+  override public var dock: Dock.Configuration? {
+    Self.defaultDock
+  }
 
   /// The inspector bar configuration.
-  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+  override public var inspectorBar: InspectorBar.Configuration? {
+    Self.defaultInspectorBar
+  }
 
   /// The canvas menu configuration.
-  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+  override public var canvasMenu: CanvasMenu.Configuration? {
+    Self.defaultCanvasMenu
+  }
 }

package/ios/StarterKits/Photo/callbacks/OnCreate+Photo.swift

@@ -84,6 +84,7 @@ public extension PhotoEditorConfiguration {
       "ly.img.sticker", "ly.img.vector.shape", "ly.img.filter", "ly.img.color.palette",
       "ly.img.effect", "ly.img.blur", "ly.img.typeface", "ly.img.crop.presets",
       "ly.img.page.presets", "ly.img.text", "ly.img.text.styles", "ly.img.text.curves", "ly.img.text.components",
+      "ly.img.image",
     ]
     try await withThrowingTaskGroup(of: String.self) { group in
       for id in defaultSourceIDs {

package/ios/StarterKits/Postcard/PostcardEditorConfiguration.swift

@@ -14,32 +14,48 @@ public final class PostcardEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Settings
 
   /// The zoom padding for the canvas.
-  override public var zoomPadding: CGFloat? { 16 }
+  override public var zoomPadding: CGFloat? {
+    16
+  }
 
   // MARK: - EditorConfiguration — Callbacks
 
   /// The `onCreate` handler.
-  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+  override public var onCreate: OnCreate.Handler? {
+    Self.defaultOnCreateHandler
+  }
 
   /// The `onChanged` handler.
-  override public var onChanged: OnChanged.Handler? { Self.defaultOnChangedHandler }
+  override public var onChanged: OnChanged.Handler? {
+    Self.defaultOnChangedHandler
+  }
 
   /// The export handler.
   ///
   /// Default: Exports the scene as PDF and opens the system share sheet.
-  override public var onExport: OnExport.Handler? { Self.defaultOnExportHandler }
+  override public var onExport: OnExport.Handler? {
+    Self.defaultOnExportHandler
+  }
 
   // MARK: - EditorConfiguration — UI Components
 
   /// The navigation bar configuration.
-  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+  override public var navigationBar: NavigationBar.Configuration? {
+    Self.defaultNavigationBar
+  }
 
   /// The dock configuration.
-  override public var dock: Dock.Configuration? { Self.defaultDock }
+  override public var dock: Dock.Configuration? {
+    Self.defaultDock
+  }
 
   /// The inspector bar configuration.
-  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+  override public var inspectorBar: InspectorBar.Configuration? {
+    Self.defaultInspectorBar
+  }
 
   /// The canvas menu configuration.
-  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+  override public var canvasMenu: CanvasMenu.Configuration? {
+    Self.defaultCanvasMenu
+  }
 }

package/ios/StarterKits/Postcard/components/DockButtons+Postcard.swift

@@ -6,13 +6,24 @@ import SwiftUI
 
 extension Dock.Buttons.ID {
   /// The id of the ``Dock/Buttons/designColors(action:title:icon:isEnabled:isVisible:)`` button.
-  static var designColors: EditorComponentID { "ly.img.component.dock.button.postcard.designColors" }
+  static var designColors: EditorComponentID {
+    "ly.img.component.dock.button.postcard.designColors"
+  }
+
   /// The id of the ``Dock/Buttons/greetingColors(action:title:icon:isEnabled:isVisible:)`` button.
-  static var greetingColors: EditorComponentID { "ly.img.component.dock.button.postcard.namedColors" }
+  static var greetingColors: EditorComponentID {
+    "ly.img.component.dock.button.postcard.namedColors"
+  }
+
   /// The id of the ``Dock/Buttons/greetingFont(action:title:icon:isEnabled:isVisible:)`` button.
-  static var greetingFont: EditorComponentID { "ly.img.component.dock.button.postcard.greetingFont" }
+  static var greetingFont: EditorComponentID {
+    "ly.img.component.dock.button.postcard.greetingFont"
+  }
+
   /// The id of the ``Dock/Buttons/greetingSize(action:title:icon:isEnabled:isVisible:)`` button.
-  static var greetingSize: EditorComponentID { "ly.img.component.dock.button.postcard.greetingSize" }
+  static var greetingSize: EditorComponentID {
+    "ly.img.component.dock.button.postcard.greetingSize"
+  }
 }
 
 // MARK: - Dock Buttons

package/ios/StarterKits/Video/VideoEditorConfiguration.swift

@@ -14,7 +14,9 @@ public final class VideoEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Settings
 
   /// The zoom padding for the canvas.
-  override public var zoomPadding: CGFloat? { 1 }
+  override public var zoomPadding: CGFloat? {
+    1
+  }
 
   /// The asset library configuration.
   ///
@@ -28,27 +30,41 @@ public final class VideoEditorConfiguration: EditorConfiguration {
   // MARK: - EditorConfiguration — Callbacks
 
   /// The `onCreate` handler.
-  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+  override public var onCreate: OnCreate.Handler? {
+    Self.defaultOnCreateHandler
+  }
 
   /// The export handler.
   ///
   /// Default: Exports the current page as MP4 and opens the system share sheet.
-  override public var onExport: OnExport.Handler? { Self.defaultOnExportHandler }
+  override public var onExport: OnExport.Handler? {
+    Self.defaultOnExportHandler
+  }
 
   // MARK: - EditorConfiguration — UI Components
 
   /// The navigation bar configuration.
-  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+  override public var navigationBar: NavigationBar.Configuration? {
+    Self.defaultNavigationBar
+  }
 
   /// The dock configuration.
-  override public var dock: Dock.Configuration? { Self.defaultDock }
+  override public var dock: Dock.Configuration? {
+    Self.defaultDock
+  }
 
   /// The inspector bar configuration.
-  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+  override public var inspectorBar: InspectorBar.Configuration? {
+    Self.defaultInspectorBar
+  }
 
   /// The canvas menu configuration.
-  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+  override public var canvasMenu: CanvasMenu.Configuration? {
+    Self.defaultCanvasMenu
+  }
 
   /// The bottom panel configuration.
-  override public var bottomPanel: BottomPanel.Configuration? { Self.defaultBottomPanel }
+  override public var bottomPanel: BottomPanel.Configuration? {
+    Self.defaultBottomPanel
+  }
 }

package/ios/StarterKits/Video/callbacks/OnExport+Video.swift

@@ -16,7 +16,12 @@ extension VideoEditorConfiguration {
       }
       eventHandler.send(.exportProgress(.relative(0)))
       let mimeType: MIMEType = .mp4
-      let stream = try await engine.block.exportVideo(page, mimeType: mimeType) { _ in }
+      // videoBitrate: .auto derives a bounded bitrate from the resolution/framerate.
+      let stream = try await engine.block.exportVideo(
+        page,
+        mimeType: mimeType,
+        options: VideoExportOptions(videoBitrate: .auto),
+      ) { _ in }
 
       var lastReportedProgress = 0
       for try await export in stream {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imgly/editor-react-native",
-  "version": "1.77.0",
+  "version": "1.80.0-rc.0",
   "description": "CreativeEditor SDK for React Native - enable photo, video and design editing for your users on iOS and Android.",
   "react-native": "index.js",
   "source": "index.js",

package/src/NativeIMGLYEditor.ts

@@ -96,7 +96,7 @@ export class EditorSettingsModel implements EditorSettings {
    * sources (stickers, filters, and more).
    */
   baseUri: string =
-    'https://cdn.img.ly/packages/imgly/cesdk-react-native/1.77.0/assets';
+    'https://cdn.img.ly/packages/imgly/cesdk-react-native/1.80.0-rc.0/assets';
 
   /**
    * Unique ID tied to your application's user.
@@ -115,7 +115,7 @@ export class EditorSettingsModel implements EditorSettings {
  * loaded into the editor.
  */
 export enum SourceType {
-  /** A `.scene` file. */
+  /** A scene file (`.imgly` or the legacy `.scene`). */
   SCENE = 'scene',
 
   /** An image, e.g. `.png`. */