@imgly/editor-react-native 1.73.0 → 1.73.1

package/android/src/main/kotlin/ly/img/editor/configuration/video/iconPack/CheckCircleOutline.kt

@@ -0,0 +1,79 @@
+package ly.img.editor.configuration.video.iconPack
+
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.PathFillType.Companion.NonZero
+import androidx.compose.ui.graphics.SolidColor
+import androidx.compose.ui.graphics.StrokeCap.Companion.Butt
+import androidx.compose.ui.graphics.StrokeJoin.Companion.Miter
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.graphics.vector.ImageVector.Builder
+import androidx.compose.ui.graphics.vector.path
+import androidx.compose.ui.unit.dp
+
+/**
+ * Check-circle with outline icon
+ */
+val IconPack.CheckCircleOutline: ImageVector
+    get() {
+        if (checkCircleOutline != null) {
+            return checkCircleOutline!!
+        }
+        checkCircleOutline = Builder(
+            name = "CheckCircleOutline",
+            defaultWidth = 24.0.dp,
+            defaultHeight = 24.0.dp,
+            viewportWidth = 24.0f,
+            viewportHeight = 24.0f,
+        ).apply {
+            path(
+                fill = SolidColor(Color(0xFF46464F)),
+                stroke = null,
+                strokeLineWidth = 0.0f,
+                strokeLineCap = Butt,
+                strokeLineJoin = Miter,
+                strokeLineMiter = 4.0f,
+                pathFillType = NonZero,
+            ) {
+                moveTo(10.6f, 16.6f)
+                lineTo(17.65f, 9.55f)
+                lineTo(16.25f, 8.15f)
+                lineTo(10.6f, 13.8f)
+                lineTo(7.75f, 10.95f)
+                lineTo(6.35f, 12.35f)
+                lineTo(10.6f, 16.6f)
+                close()
+                moveTo(12.0f, 22.0f)
+                curveTo(10.6167f, 22.0f, 9.3167f, 21.7373f, 8.1f, 21.212f)
+                curveTo(6.8833f, 20.6867f, 5.825f, 19.9743f, 4.925f, 19.075f)
+                curveTo(4.025f, 18.175f, 3.3127f, 17.1167f, 2.788f, 15.9f)
+                curveTo(2.2633f, 14.6833f, 2.0007f, 13.3833f, 2.0f, 12.0f)
+                curveTo(2.0f, 10.6167f, 2.2627f, 9.3167f, 2.788f, 8.1f)
+                curveTo(3.3133f, 6.8833f, 4.0257f, 5.825f, 4.925f, 4.925f)
+                curveTo(5.825f, 4.025f, 6.8833f, 3.3127f, 8.1f, 2.788f)
+                curveTo(9.3167f, 2.2633f, 10.6167f, 2.0007f, 12.0f, 2.0f)
+                curveTo(13.3833f, 2.0f, 14.6833f, 2.2627f, 15.9f, 2.788f)
+                curveTo(17.1167f, 3.3133f, 18.175f, 4.0257f, 19.075f, 4.925f)
+                curveTo(19.975f, 5.825f, 20.6877f, 6.8833f, 21.213f, 8.1f)
+                curveTo(21.7383f, 9.3167f, 22.0007f, 10.6167f, 22.0f, 12.0f)
+                curveTo(22.0f, 13.3833f, 21.7373f, 14.6833f, 21.212f, 15.9f)
+                curveTo(20.6867f, 17.1167f, 19.9743f, 18.175f, 19.075f, 19.075f)
+                curveTo(18.175f, 19.975f, 17.1167f, 20.6877f, 15.9f, 21.213f)
+                curveTo(14.6833f, 21.7383f, 13.3833f, 22.0007f, 12.0f, 22.0f)
+                close()
+                moveTo(12.0f, 20.0f)
+                curveTo(14.2333f, 20.0f, 16.125f, 19.225f, 17.675f, 17.675f)
+                curveTo(19.225f, 16.125f, 20.0f, 14.2333f, 20.0f, 12.0f)
+                curveTo(20.0f, 9.7667f, 19.225f, 7.875f, 17.675f, 6.325f)
+                curveTo(16.125f, 4.775f, 14.2333f, 4.0f, 12.0f, 4.0f)
+                curveTo(9.7667f, 4.0f, 7.875f, 4.775f, 6.325f, 6.325f)
+                curveTo(4.775f, 7.875f, 4.0f, 9.7667f, 4.0f, 12.0f)
+                curveTo(4.0f, 14.2333f, 4.775f, 16.125f, 6.325f, 17.675f)
+                curveTo(7.875f, 19.225f, 9.7667f, 20.0f, 12.0f, 20.0f)
+                close()
+            }
+        }
+            .build()
+        return checkCircleOutline!!
+    }
+
+private var checkCircleOutline: ImageVector? = null

package/android/src/main/kotlin/ly/img/editor/configuration/video/iconPack/ErrorOutline.kt

@@ -0,0 +1,92 @@
+package ly.img.editor.configuration.video.iconPack
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.PathFillType.Companion.NonZero
+import androidx.compose.ui.graphics.SolidColor
+import androidx.compose.ui.graphics.StrokeCap.Companion.Butt
+import androidx.compose.ui.graphics.StrokeJoin.Companion.Miter
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.graphics.vector.ImageVector.Builder
+import androidx.compose.ui.graphics.vector.path
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+
+/**
+ * Error with outline icon
+ */
+val IconPack.ErrorOutline: ImageVector
+    get() {
+        if (errorOutline != null) {
+            return errorOutline!!
+        }
+        errorOutline = Builder(
+            name = "ErrorOutline",
+            defaultWidth = 24.0.dp,
+            defaultHeight = 24.0.dp,
+            viewportWidth = 24.0f,
+            viewportHeight = 24.0f,
+        ).apply {
+            path(
+                fill = SolidColor(Color(0xFF49454F)),
+                stroke = null,
+                strokeLineWidth = 0.0f,
+                strokeLineCap = Butt,
+                strokeLineJoin = Miter,
+                strokeLineMiter = 4.0f,
+                pathFillType = NonZero,
+            ) {
+                moveTo(12.0f, 17.0f)
+                curveTo(12.2833f, 17.0f, 12.521f, 16.904f, 12.713f, 16.712f)
+                curveTo(12.9043f, 16.5207f, 13.0f, 16.2833f, 13.0f, 16.0f)
+                curveTo(13.0f, 15.7167f, 12.9043f, 15.479f, 12.713f, 15.287f)
+                curveTo(12.521f, 15.0957f, 12.2833f, 15.0f, 12.0f, 15.0f)
+                curveTo(11.7167f, 15.0f, 11.4793f, 15.0957f, 11.288f, 15.287f)
+                curveTo(11.096f, 15.479f, 11.0f, 15.7167f, 11.0f, 16.0f)
+                curveTo(11.0f, 16.2833f, 11.096f, 16.5207f, 11.288f, 16.712f)
+                curveTo(11.4793f, 16.904f, 11.7167f, 17.0f, 12.0f, 17.0f)
+                close()
+                moveTo(11.0f, 13.0f)
+                horizontalLineTo(13.0f)
+                verticalLineTo(7.0f)
+                horizontalLineTo(11.0f)
+                verticalLineTo(13.0f)
+                close()
+                moveTo(12.0f, 22.0f)
+                curveTo(10.6167f, 22.0f, 9.3167f, 21.7373f, 8.1f, 21.212f)
+                curveTo(6.8833f, 20.6873f, 5.825f, 19.975f, 4.925f, 19.075f)
+                curveTo(4.025f, 18.175f, 3.3127f, 17.1167f, 2.788f, 15.9f)
+                curveTo(2.2627f, 14.6833f, 2.0f, 13.3833f, 2.0f, 12.0f)
+                curveTo(2.0f, 10.6167f, 2.2627f, 9.3167f, 2.788f, 8.1f)
+                curveTo(3.3127f, 6.8833f, 4.025f, 5.825f, 4.925f, 4.925f)
+                curveTo(5.825f, 4.025f, 6.8833f, 3.3123f, 8.1f, 2.787f)
+                curveTo(9.3167f, 2.2623f, 10.6167f, 2.0f, 12.0f, 2.0f)
+                curveTo(13.3833f, 2.0f, 14.6833f, 2.2623f, 15.9f, 2.787f)
+                curveTo(17.1167f, 3.3123f, 18.175f, 4.025f, 19.075f, 4.925f)
+                curveTo(19.975f, 5.825f, 20.6873f, 6.8833f, 21.212f, 8.1f)
+                curveTo(21.7373f, 9.3167f, 22.0f, 10.6167f, 22.0f, 12.0f)
+                curveTo(22.0f, 13.3833f, 21.7373f, 14.6833f, 21.212f, 15.9f)
+                curveTo(20.6873f, 17.1167f, 19.975f, 18.175f, 19.075f, 19.075f)
+                curveTo(18.175f, 19.975f, 17.1167f, 20.6873f, 15.9f, 21.212f)
+                curveTo(14.6833f, 21.7373f, 13.3833f, 22.0f, 12.0f, 22.0f)
+                close()
+                moveTo(12.0f, 20.0f)
+                curveTo(14.2333f, 20.0f, 16.125f, 19.225f, 17.675f, 17.675f)
+                curveTo(19.225f, 16.125f, 20.0f, 14.2333f, 20.0f, 12.0f)
+                curveTo(20.0f, 9.7667f, 19.225f, 7.875f, 17.675f, 6.325f)
+                curveTo(16.125f, 4.775f, 14.2333f, 4.0f, 12.0f, 4.0f)
+                curveTo(9.7667f, 4.0f, 7.875f, 4.775f, 6.325f, 6.325f)
+                curveTo(4.775f, 7.875f, 4.0f, 9.7667f, 4.0f, 12.0f)
+                curveTo(4.0f, 14.2333f, 4.775f, 16.125f, 6.325f, 17.675f)
+                curveTo(7.875f, 19.225f, 9.7667f, 20.0f, 12.0f, 20.0f)
+                close()
+            }
+        }.build()
+        return errorOutline!!
+    }
+
+private var errorOutline: ImageVector? = null
+
+@Preview
+@Composable
+private fun Preview() = IconPack.ErrorOutline.IconPreview()

package/android/src/main/kotlin/ly/img/editor/configuration/video/iconPack/IconPack.kt

@@ -0,0 +1,14 @@
+package ly.img.editor.configuration.video.iconPack
+
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.graphics.vector.ImageVector
+
+/**
+ * Icon pack of the starter kit to access all the icons.
+ */
+object IconPack
+
+@Composable
+internal fun ImageVector.IconPreview() = Icon(this, contentDescription = null, tint = MaterialTheme.colorScheme.onPrimary)

package/android/src/main/kotlin/ly/img/editor/configuration/video/model/ExportStatus.kt

@@ -0,0 +1,39 @@
+package ly.img.editor.configuration.video.model
+
+import androidx.annotation.FloatRange
+import ly.img.engine.MimeType
+import java.io.File
+
+/**
+ * The export status of the starter kit.
+ */
+sealed interface ExportStatus {
+    /**
+     * State when the export is active.
+     *
+     * @param progress the progress of the export.
+     */
+    data class Loading(
+        @FloatRange(from = 0.0, to = 1.0) val progress: Float,
+    ) : ExportStatus
+
+    /**
+     * State when the export is successfully completed.
+     *
+     * @param file the file where the exported content is written to.
+     * @param mimeType the mime type of the exported content.
+     */
+    data class Success(
+        val file: File,
+        val mimeType: MimeType = MimeType.MP4,
+    ) : ExportStatus
+
+    /**
+     * State when the export is completed with an exception.
+     *
+     * @param exception the exception that was thrown during the export.
+     */
+    data class Error(
+        val exception: Exception,
+    ) : ExportStatus
+}

package/ios/IMGLYEditorModule.swift

@@ -82,7 +82,15 @@ import UIKit
       .first as? UIWindowScene {
       if let rootViewController = windowScene.windows
         .filter(\.isKeyWindow).first?.rootViewController {
-        rootViewController.present(presentationController, animated: true, completion: nil)
+        // Walk up the presentation chain to the topmost view controller.
+        // Presenting on a VC that is already presenting another VC silently
+        // no-ops in UIKit, which leaves the SDK Promise hanging forever when
+        // the host app uses react-native-screens / Expo Router / RN <Modal>.
+        var topViewController: UIViewController = rootViewController
+        while let presented = topViewController.presentedViewController {
+          topViewController = presented
+        }
+        topViewController.present(presentationController, animated: true, completion: nil)
       }
     }
   }

package/ios/StarterKits/Apparel/ApparelEditorConfiguration.swift

@@ -0,0 +1,46 @@
+import CoreGraphics
+import IMGLYEditor
+import IMGLYEngine
+import SwiftUI
+
+// CE.SDK Starter Kit: Apparel Editor
+//
+// This starter kit provides a complete, production-ready Apparel Editor configuration
+// with all configuration code inline and fully documented. Copy this file into your
+// project and customize it to match your needs.
+
+// MARK: - Configuration
+
+public final class ApparelEditorConfiguration: EditorConfiguration {
+  // MARK: - EditorConfiguration — Settings
+
+  /// The zoom padding for the canvas.
+  override public var zoomPadding: CGFloat? { 16 }
+
+  // MARK: - EditorConfiguration — Callbacks
+
+  /// The `onCreate` handler.
+  override public var onCreate: OnCreate.Handler? { Self.defaultOnCreateHandler }
+
+  /// The `onChanged` handler.
+  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 }
+
+  // MARK: - EditorConfiguration — UI Components
+
+  /// The navigation bar configuration.
+  override public var navigationBar: NavigationBar.Configuration? { Self.defaultNavigationBar }
+
+  /// The dock configuration.
+  override public var dock: Dock.Configuration? { Self.defaultDock }
+
+  /// The inspector bar configuration.
+  override public var inspectorBar: InspectorBar.Configuration? { Self.defaultInspectorBar }
+
+  /// The canvas menu configuration.
+  override public var canvasMenu: CanvasMenu.Configuration? { Self.defaultCanvasMenu }
+}

package/ios/StarterKits/Apparel/ApparelEditorStarterKit.swift

@@ -0,0 +1,30 @@
+import IMGLYEditor
+import IMGLYEngine
+import SwiftUI
+
+// MARK: - Starter Kit View
+
+struct ApparelEditorStarterKit: View {
+  // Provide `EngineSettings` with your license and an optional userId.
+  let settings = EngineSettings(
+    license: secrets.licenseKey, // Use nil for evaluation mode with watermark
+    userID: "<your unique user id>",
+  )
+
+  // highlight-starter-kit-view
+  var body: some View {
+    // highlight-starter-kit-composable
+    Editor(settings)
+      .imgly.configuration {
+        ApparelEditorConfiguration()
+      }
+    // highlight-starter-kit-composable
+  }
+  // highlight-starter-kit-view
+}
+
+// MARK: - Preview
+
+#Preview {
+  ApparelEditorStarterKit()
+}

package/ios/StarterKits/Apparel/callbacks/OnChanged+Apparel.swift

@@ -0,0 +1,116 @@
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnChanged
+
+extension ApparelEditorConfiguration {
+  /// The default `onChanged` handler.
+  static var defaultOnChangedHandler: OnChanged.Handler {
+    { update, context, _ in
+      switch update {
+      case let .gestureActive(_, newValue):
+        try Self.showOutline(newValue, engine: context.engine)
+
+      case let .page(_, newValue):
+        // Deselect all blocks.
+        try context.engine.block.findAllSelected().forEach {
+          try context.engine.block.setSelected($0, selected: false)
+        }
+
+        // Reset history.
+        let oldHistory = context.engine.editor.getActiveHistory()
+        let newHistory = context.engine.editor.createHistory()
+        context.engine.editor.setActiveHistory(newHistory)
+        context.engine.editor.destroyHistory(oldHistory)
+        try context.engine.editor.addUndoStep()
+
+        if let stack = try? context.engine.block.find(byType: .stack).first {
+          try context.engine.block.setEnum(stack, property: "stack/axis", value: "Depth")
+        }
+
+        let pages = try context.engine.scene.getPages()
+        for (i, block) in pages.enumerated() {
+          let isVisibilityEnabled = try context.engine.block.isScopeEnabled(block, key: "layer/visibility")
+          try context.engine.block.setScopeEnabled(block, key: "layer/visibility", enabled: true)
+          try context.engine.block.setVisible(block, visible: i == newValue)
+          try context.engine.block.setScopeEnabled(block, key: "layer/visibility", enabled: isVisibilityEnabled)
+        }
+
+      case let .viewMode(_, state):
+        if state.editorViewMode == .edit {
+          try Self.setupPage(context)
+        } else if state.editorViewMode == .preview {
+          guard let scene = try context.engine.block.find(byType: .scene).first
+          else { throw EditorError("No scene found.") }
+
+          Task {
+            // Disable camera clamping.
+            if try context.engine.scene.unstable_isCameraZoomClampingEnabled(scene) {
+              try context.engine.scene.unstable_disableCameraZoomClamping()
+            }
+            if try context.engine.scene.unstable_isCameraPositionClampingEnabled(scene) {
+              try context.engine.scene.unstable_disableCameraPositionClamping()
+            }
+
+            // Zoom to the backdrop image.
+            try await context.engine.scene.zoom(
+              to: Self.getBackdropImage(engine: context.engine),
+              paddingLeft: Float(state.insets?.leading ?? 0),
+              paddingTop: Float(state.insets?.top ?? 0),
+              paddingRight: Float(state.insets?.trailing ?? 0),
+              paddingBottom: Float(state.insets?.bottom ?? 0),
+            )
+
+            // Deselect all blocks.
+            let selectedBlocks = context.engine.block.findAllSelected()
+            try selectedBlocks.forEach { try context.engine.block.setSelected($0, selected: false) }
+
+            try Self.setupPage(context)
+          }
+        } else {
+          try OnChanged.default(update, context)
+        }
+
+      default:
+        try OnChanged.default(update, context)
+      }
+    }
+  }
+
+  // MARK: - Helpers
+
+  /// Gets the backdrop image from the scene.
+  /// The backdrop image is the only image that is a direct child of the scene block.
+  static func getBackdropImage(engine: Engine) throws -> DesignBlockID {
+    guard let scene = try engine.scene.get() else { throw EditorError("No scene found.") }
+    let childIDs = try engine.block.getChildren(scene)
+    let imageID = try childIDs.first {
+      guard try engine.block.getType($0) == DesignBlockType.graphic.rawValue,
+            try engine.block.supportsFill($0)
+      else {
+        return false
+      }
+      return try engine.block.getType(try engine.block.getFill($0)) == FillType.image.rawValue
+    }
+    guard let imageID else {
+      throw EditorError("No backdrop image found.")
+    }
+    return imageID
+  }
+
+  /// Configures the current page for proper apparel editing.
+  static func setupPage(_ context: OnChanged.Context) throws {
+    guard let page = try context.engine.scene.getCurrentPage() else {
+      throw EditorError("No scene found.")
+    }
+
+    let fillChangeEnabled = try context.engine.block.isScopeEnabled(page, key: "fill/change")
+    let layerClippingEnabled = try context.engine.block.isScopeEnabled(page, key: "layer/clipping")
+    try context.engine.editor.setSettingBool("page/dimOutOfPageAreas", value: false)
+    try context.engine.block.setClipped(page, clipped: true)
+    try context.engine.block.setBool(page, property: "fill/enabled", value: false)
+    try showOutline(false, engine: context.engine)
+    try context.engine.block.setScopeEnabled(page, key: "fill/change", enabled: fillChangeEnabled)
+    try context.engine.block.setScopeEnabled(page, key: "layer/clipping", enabled: layerClippingEnabled)
+  }
+}

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

@@ -0,0 +1,197 @@
+import CoreGraphics
+import Foundation
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnCreate
+
+public extension ApparelEditorConfiguration {
+  /// The default `onCreate` handler.
+  internal static var defaultOnCreateHandler: OnCreate.Handler {
+    { engine, _ in
+      try await defaultOnCreate()(engine)
+    }
+  }
+
+  /// Default apparel editor specific `OnCreate.Callback` implementation with solution specific settings, scene
+  /// and editor creation setup.
+  /// - Parameters:
+  ///   - preCreateScene: Callback to do any pre scene loading tasks such as applying settings.
+  ///   Defaults to `ApparelEditorConfiguration.defaultPreCreateScene`.
+  ///   - createScene: Callback to load/create the scene and load asset sources. Defaults to
+  /// `ApparelEditorConfiguration.defaultCreateScene`.
+  ///   - loadAssetSources: Callback to load any asset sources. Defaults to
+  /// `ApparelEditorConfiguration.defaultLoadAssetSources`.
+  ///   - postCreateScene: Callback to do any post scene loading tasks. Defaults to
+  ///   `ApparelEditorConfiguration.defaultPostCreateScene`.
+  /// - Returns: A composed `OnCreate.Callback`that sequentially executes all three initialization phases.
+  static func defaultOnCreate(
+    preCreateScene: @escaping OnCreate.Callback = defaultPreCreateScene,
+    createScene: @escaping OnCreate.Callback = defaultCreateScene,
+    loadAssetSources: @escaping OnCreate.Callback = defaultLoadAssetSources,
+    postCreateScene: @escaping OnCreate.Callback = defaultPostCreateScene,
+  ) -> OnCreate.Callback {
+    { engine in
+      try await preCreateScene(engine)
+      try await createScene(engine)
+      try await loadAssetSources(engine)
+      try await postCreateScene(engine)
+    }
+  }
+
+  /// Configures engine settings before scene loading.
+  ///
+  /// Sets editor role, touch gestures, camera clamping, and global scopes.
+  static let defaultPreCreateScene: OnCreate.Callback = { engine in
+    try engine.editor.setRole("Adopter")
+    try engine.editor.setSettingEnum("camera/clamping/overshootMode", value: "Center")
+
+    let highlightColor: IMGLYEngine.Color = try engine.editor.getSettingColor("highlightColor")
+    try engine.editor.setSettingColor("placeholderHighlightColor", color: highlightColor)
+
+    try engine.editor.setSettingBool("touch/dragStartCanSelect", value: false)
+    try engine.editor.setSettingEnum("touch/pinchAction", value: "Zoom")
+    try engine.editor.setSettingEnum("touch/rotateAction", value: "None")
+
+    try ([
+      "appearance/adjustments", "appearance/filter", "appearance/effect",
+      "appearance/blur", "appearance/shadow",
+      "editor/select",
+      "fill/change", "fill/changeType",
+      "layer/crop", "layer/move", "layer/resize", "layer/rotate", "layer/flip",
+      "layer/opacity", "layer/blendMode", "layer/visibility", "layer/clipping",
+      "lifecycle/destroy", "lifecycle/duplicate",
+      "stroke/change", "shape/change",
+      "text/edit", "text/character",
+    ]).forEach { scope in
+      try engine.editor.setGlobalScope(key: scope, value: .defer)
+    }
+  }
+
+  /// Loads the built-in empty apparel scene.
+  static let defaultCreateScene: OnCreate.Callback = { engine in
+    // highlight-starter-kit-on-create-scene
+    let sceneURL = Bundle(for: ApparelEditorConfiguration.self).url(
+      forResource: "apparel-ui-b-empty",
+      withExtension: "scene",
+    )!
+    try await engine.scene.load(from: sceneURL)
+    // highlight-starter-kit-on-create-scene
+  }
+
+  /// Registers all default and demo asset sources, plus text and photo roll sources.
+  static let defaultLoadAssetSources: OnCreate.Callback = { engine in
+    // highlight-starter-kit-on-load-asset-sources
+    let assetSources: [String: URL] = [
+      Engine.DefaultAssetSource.sticker.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.vectorPath.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.filterLut.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.filterDuotone.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.colorsDefaultPalette.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.effect.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.blur.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.typeface.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.cropPresets.rawValue: Engine.assetBaseURL,
+      Engine.DefaultAssetSource.pagePresets.rawValue: Engine.assetBaseURL,
+
+      Engine.DemoAssetSource.image.rawValue: Engine.assetBaseURL,
+      Engine.DemoAssetSource.textComponents.rawValue: Engine.assetBaseURL,
+    ]
+
+    try await withThrowingTaskGroup(of: Void.self) { group in
+      for assetSource in assetSources {
+        group.addTask {
+          try await engine.populateAssetSource(id: assetSource.key, baseURL: assetSource.value)
+        }
+      }
+      try await group.waitForAll()
+    }
+
+    try engine.asset.addLocalSource(
+      sourceID: Engine.DemoAssetSource.imageUpload.rawValue,
+      supportedMimeTypes: Engine.DemoAssetSource.imageUpload.mimeTypes,
+    )
+
+    try await engine.asset.addSource(TextAssetSource(engine: engine))
+    try engine.asset.addSource(PhotoRollAssetSource(engine: engine))
+    // highlight-starter-kit-on-load-asset-sources
+  }
+
+  /// Configures apparel-specific outline and page clipping behavior.
+  static let defaultPostCreateScene: OnCreate.Callback = { engine in
+    guard let scene = try engine.block.find(byType: .scene).first,
+          let page = try engine.scene.getPages().first
+    else {
+      return
+    }
+
+    // Add outline block for apparel shape visualization.
+    _ = try ApparelEditorConfiguration.addOutline(
+      "always-on-top-page-outline", for: page, to: scene, engine: engine,
+    )
+    try ApparelEditorConfiguration.showOutline(false, engine: engine)
+
+    // Temporarily enable scopes to configure page clipping.
+    let isFillChangeEnabled = try engine.block.isScopeEnabled(page, key: "fill/change")
+    let isLayerClippingEnabled = try engine.block.isScopeEnabled(page, key: "layer/clipping")
+    try engine.block.setScopeEnabled(page, key: "fill/change", enabled: true)
+    try engine.block.setScopeEnabled(page, key: "layer/clipping", enabled: true)
+
+    // Configure page appearance and clipping for apparel editing.
+    try engine.editor.setSettingBool("page/dimOutOfPageAreas", value: false)
+    try engine.block.setClipped(page, clipped: true)
+    try engine.block.setBool(page, property: "fill/enabled", value: false)
+    try ApparelEditorConfiguration.showOutline(false, engine: engine)
+
+    // Restore original scope states.
+    try engine.block.setScopeEnabled(page, key: "fill/change", enabled: isFillChangeEnabled)
+    try engine.block.setScopeEnabled(page, key: "layer/clipping", enabled: isLayerClippingEnabled)
+  }
+
+  // MARK: - Helpers
+
+  /// Adds an outline block for apparel shape visualization.
+  internal static func addOutline(
+    _ name: String? = nil,
+    for id: DesignBlockID,
+    to parent: DesignBlockID,
+    engine: Engine,
+  ) throws -> DesignBlockID {
+    let outline = try engine.block.create(.graphic)
+    let rect = try engine.block.createShape(.rect)
+    try engine.block.setShape(outline, shape: rect)
+
+    let height = try engine.block.getHeight(id)
+    let width = try engine.block.getWidth(id)
+
+    if let name {
+      try engine.block.setName(outline, name: name)
+    }
+    try engine.block.setHeightMode(outline, mode: .absolute)
+    try engine.block.setHeight(outline, value: height)
+    try engine.block.setWidthMode(outline, mode: .absolute)
+    try engine.block.setWidth(outline, value: width)
+    try engine.block.appendChild(to: parent, child: outline)
+
+    try engine.block.setBool(outline, property: "fill/enabled", value: false)
+    try engine.block.setBool(outline, property: "stroke/enabled", value: true)
+    try engine.block.setStrokeStyle(outline, style: .dotted)
+    try engine.block.setStrokeWidth(outline, width: 1.0)
+    try engine.block.setBlendMode(outline, mode: .difference)
+    try engine.block.setScopeEnabled(outline, key: "editor/select", enabled: false)
+    if let color = Color(cgColor: CGColor.imgly.white) {
+      try engine.block.setColor(outline, property: "stroke/color", color: color)
+    }
+    return outline
+  }
+
+  /// Shows or hides the outline block.
+  internal static func showOutline(_ isVisible: Bool, engine: Engine) throws {
+    guard let outline = engine.block.find(byName: "always-on-top-page-outline").first else {
+      throw EditorError("No outline block was found.")
+    }
+    try engine.block.setVisible(outline, visible: isVisible)
+    // Workaround: Trigger opacity to force refresh on "fast" devices.
+    try engine.block.setOpacity(outline, value: isVisible ? 1 : 0)
+  }
+}

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

@@ -0,0 +1,29 @@
+import IMGLYEditor
+import IMGLYEngine
+import UniformTypeIdentifiers
+
+// MARK: - Default OnExport
+
+extension ApparelEditorConfiguration {
+  /// The default export handler.
+  ///
+  /// Exports the scene as PDF and opens the system share sheet.
+  static var defaultOnExportHandler: OnExport.Handler {
+    { engine, eventHandler, _ in
+      // highlight-starter-kit-on-export
+      guard let scene = try engine.scene.get() else {
+        throw EditorError("No scene was found.")
+      }
+      let data = try await engine.block.export(scene, mimeType: .pdf) { engine in
+        try engine.scene.getPages().forEach {
+          try engine.block.setScopeEnabled($0, key: "layer/visibility", enabled: true)
+          try engine.block.setVisible($0, visible: true)
+        }
+      }
+      let url = FileManager.default.temporaryDirectory.appendingPathComponent("Export", conformingTo: .pdf)
+      try data.write(to: url, options: [.atomic])
+      eventHandler.send(.shareFile(url))
+      // highlight-starter-kit-on-export
+    }
+  }
+}