@imgly/editor-react-native 1.73.0 → 1.73.1

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

@@ -0,0 +1,138 @@
+import Foundation
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnCreate
+
+public extension PhotoEditorConfiguration {
+  /// The default `onCreate` handler.
+  internal static var defaultOnCreateHandler: OnCreate.Handler {
+    { engine, _ in
+      try await defaultOnCreate()(engine)
+    }
+  }
+
+  /// Default photo 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 `PhotoEditorConfiguration.defaultPreCreateScene`.
+  ///   - createScene: Callback to load/create the scene and load asset sources. Defaults to
+  /// `PhotoEditorConfiguration.defaultCreateScene`.
+  ///   - loadAssetSources: Callback to load any asset sources. Defaults to
+  /// `PhotoEditorConfiguration.defaultLoadAssetSources`.
+  ///   - postCreateScene: Callback to do any post scene loading tasks. Defaults to
+  ///   `PhotoEditorConfiguration.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)
+    }
+  }
+
+  /// Creates a scene from the default photo image.
+  static let defaultCreateScene: OnCreate.Callback = { engine in
+    // highlight-starter-kit-on-create-scene
+    let imageURL = Bundle(for: PhotoEditorConfiguration.self).url(forResource: "photo-ui-empty", withExtension: "png")!
+    try await engine.scene.create(fromImage: imageURL)
+    // 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.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 await engine.asset.addSource(TextAssetSource(engine: engine))
+    try engine.asset.addSource(PhotoRollAssetSource(engine: engine))
+    // highlight-starter-kit-on-load-asset-sources
+  }
+
+  /// Configures photo-specific page and crop behavior.
+  static let defaultPostCreateScene: OnCreate.Callback = { engine in
+    let page = try getSinglePage(engine)
+
+    try engine.editor.setHighlightingEnabled(page, enabled: false)
+    try engine.block.setScopeEnabled(page, key: "layer/move", enabled: false)
+
+    try engine.editor.setSettingBool("page/highlightWhenCropping", value: true)
+    try engine.editor.setSettingBool("page/allowMoveInteraction", value: true)
+    try engine.editor.setSettingBool("page/selectWhenNoBlocksSelected", value: true)
+    try engine.editor.setSettingBool("doubleClickToCropEnabled", value: false)
+  }
+
+  // MARK: - Helpers
+
+  /// Gets the single page with an image fill from the scene.
+  internal static func getSinglePage(_ engine: Engine, withImageFill: Bool = true) throws -> DesignBlockID {
+    let pages = try engine.scene.getPages()
+    guard let page = pages.first, pages.count == 1 else {
+      throw EditorError("A single page is required for this operation.")
+    }
+    if withImageFill {
+      guard try engine.block.getType(engine.block.getFill(page)) == FillType.image.rawValue else {
+        throw EditorError("A single page with an image fill is required for this operation.")
+      }
+    }
+    return page
+  }
+}

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

@@ -0,0 +1,29 @@
+import IMGLYEditor
+import IMGLYEngine
+import UniformTypeIdentifiers
+
+// MARK: - Default OnExport
+
+extension PhotoEditorConfiguration {
+  /// The default export handler.
+  ///
+  /// Exports the scene as PNG 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: .png) { 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: .png)
+      try data.write(to: url, options: [.atomic])
+      eventHandler.send(.shareFile(url))
+      // highlight-starter-kit-on-export
+    }
+  }
+}

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

@@ -0,0 +1,18 @@
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnLoaded
+
+extension PhotoEditorConfiguration {
+  /// The default `onLoaded` handler.
+  static var defaultOnLoadedHandler: OnLoaded.Handler {
+    { context, existing in
+      try await existing()
+      for try await _ in context.engine.editor.onHistoryUpdated {
+        let editMode = context.engine.editor.getEditMode()
+        let isCrop = editMode == .crop
+        try context.engine.editor.setSettingBool("page/allowResizeInteraction", value: isCrop)
+      }
+    }
+  }
+}

package/ios/StarterKits/Photo/components/CanvasMenu+Photo.swift

@@ -0,0 +1,22 @@
+import IMGLYEditor
+
+// MARK: - Canvas Menu
+
+extension PhotoEditorConfiguration {
+  /// The default canvas menu configuration.
+  static var defaultCanvasMenu: CanvasMenu.Configuration {
+    CanvasMenu.Configuration { builder in
+      // highlight-starter-kit-canvas-menu
+      builder.items { _ in
+        CanvasMenu.Buttons.selectGroup()
+        CanvasMenu.Divider()
+        CanvasMenu.Buttons.bringForward()
+        CanvasMenu.Buttons.sendBackward()
+        CanvasMenu.Divider()
+        CanvasMenu.Buttons.duplicate()
+        CanvasMenu.Buttons.delete()
+      }
+      // highlight-starter-kit-canvas-menu
+    }
+  }
+}

package/ios/StarterKits/Photo/components/Dock+Photo.swift

@@ -0,0 +1,23 @@
+import IMGLYEditor
+
+// MARK: - Dock
+
+extension PhotoEditorConfiguration {
+  /// The default dock configuration.
+  static var defaultDock: Dock.Configuration {
+    Dock.Configuration { builder in
+      // highlight-starter-kit-dock
+      builder.items { _ in
+        Dock.Buttons.adjustments() // Image adjustments
+        Dock.Buttons.filter() // Filters
+        Dock.Buttons.effect() // Effects
+        Dock.Buttons.blur() // Blur
+        Dock.Buttons.crop() // Crop tool
+        Dock.Buttons.textLibrary() // Text tools
+        Dock.Buttons.shapesLibrary() // Shapes
+        Dock.Buttons.stickersLibrary() // Stickers
+      }
+      // highlight-starter-kit-dock
+    }
+  }
+}

package/ios/StarterKits/Photo/components/InspectorBar+Photo.swift

@@ -0,0 +1,39 @@
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Inspector Bar
+
+extension PhotoEditorConfiguration {
+  /// The default inspector bar configuration.
+  static var defaultInspectorBar: InspectorBar.Configuration {
+    InspectorBar.Configuration { builder in
+      // highlight-starter-kit-inspector-bar
+      builder.items { _ in
+        InspectorBar.Buttons.replace()
+
+        InspectorBar.Buttons.editText()
+        InspectorBar.Buttons.formatText()
+        InspectorBar.Buttons.fillStroke()
+        InspectorBar.Buttons.textBackground()
+        InspectorBar.Buttons.crop()
+
+        InspectorBar.Buttons.adjustments()
+        InspectorBar.Buttons.filter()
+        InspectorBar.Buttons.effect()
+        InspectorBar.Buttons.blur()
+        InspectorBar.Buttons.shape()
+
+        InspectorBar.Buttons.selectGroup()
+        InspectorBar.Buttons.enterGroup()
+
+        InspectorBar.Buttons.layer()
+        InspectorBar.Buttons.duplicate()
+        InspectorBar.Buttons.delete()
+      }
+      builder.enabled = {
+        try $0.engine.block.getType($0.selection.block) != DesignBlockType.page.rawValue
+      }
+      // highlight-starter-kit-inspector-bar
+    }
+  }
+}

package/ios/StarterKits/Photo/components/NavigationBar+Photo.swift

@@ -0,0 +1,24 @@
+import IMGLYEditor
+
+// MARK: - Navigation Bar
+
+extension PhotoEditorConfiguration {
+  /// The default navigation bar configuration.
+  static var defaultNavigationBar: NavigationBar.Configuration {
+    NavigationBar.Configuration { builder in
+      // highlight-starter-kit-navigation-bar
+      builder.items { _ in
+        NavigationBar.ItemGroup(placement: .topBarLeading) {
+          NavigationBar.Buttons.closeEditor()
+        }
+        NavigationBar.ItemGroup(placement: .topBarTrailing) {
+          NavigationBar.Buttons.undo()
+          NavigationBar.Buttons.redo()
+          NavigationBar.Buttons.togglePreviewMode()
+          NavigationBar.Buttons.export()
+        }
+      }
+      // highlight-starter-kit-navigation-bar
+    }
+  }
+}

package/ios/StarterKits/Photo/examples/ExampleForceCrop.swift

@@ -0,0 +1,30 @@
+@_spi(Internal) import IMGLYEditor
+import IMGLYEngine
+
+// highlight-starter-kit-force-crop
+/// Example: Apply force crop in the `onLoaded` callback.
+/// Add this logic before or after the existing `onLoaded` handler in `PhotoEditorConfiguration`.
+extension PhotoEditorConfiguration {
+  static var forceCropOnLoadedHandler: OnLoaded.Handler {
+    { context, existing in
+      // Apply force crop: allow 1:1, 16:9, or 9:16
+      if let page = try context.engine.scene.getPages().first {
+        context.eventHandler.send(
+          .applyForceCrop(
+            to: page,
+            with: [
+              ForceCropPreset(sourceID: "ly.img.crop.presets", presetID: "aspect-ratio-1-1"),
+              ForceCropPreset(sourceID: "ly.img.crop.presets", presetID: "aspect-ratio-16-9"),
+              ForceCropPreset(sourceID: "ly.img.crop.presets", presetID: "aspect-ratio-9-16"),
+            ],
+            mode: .ifNeeded,
+          ),
+        )
+      }
+      // Continue with the existing onLoaded logic
+      try await existing()
+    }
+  }
+}
+
+// highlight-starter-kit-force-crop

package/ios/StarterKits/Postcard/PostcardEditorConfiguration.swift

@@ -0,0 +1,45 @@
+import IMGLYEditor
+import IMGLYEngine
+import SwiftUI
+
+// CE.SDK Starter Kit: Postcard Editor
+//
+// This starter kit provides a complete, production-ready Postcard 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 PostcardEditorConfiguration: 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/Postcard/PostcardEditorStarterKit.swift

@@ -0,0 +1,30 @@
+import IMGLYEditor
+import IMGLYEngine
+import SwiftUI
+
+// MARK: - Starter Kit View
+
+struct PostcardEditorStarterKit: 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 {
+        PostcardEditorConfiguration()
+      }
+    // highlight-starter-kit-composable
+  }
+  // highlight-starter-kit-view
+}
+
+// MARK: - Preview
+
+#Preview {
+  PostcardEditorStarterKit()
+}

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

@@ -0,0 +1,92 @@
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnChanged
+
+extension PostcardEditorConfiguration {
+  /// The default `onChanged` handler.
+  static var defaultOnChangedHandler: OnChanged.Handler {
+    { update, context, _ in
+      switch update {
+      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 == .preview {
+          guard let scene = try context.engine.block.find(byType: .scene).first else {
+            throw EditorError("No scene found.")
+          }
+
+          // 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()
+          }
+
+          // Deselect all blocks.
+          try context.engine.block.findAllSelected().forEach {
+            try context.engine.block.setSelected($0, selected: false)
+          }
+
+          if let stack = try? context.engine.block.find(byType: .stack).first {
+            let layoutAxis = state.verticalSizeClass == .compact ? "Horizontal" : "Vertical"
+            try context.engine.block.setEnum(stack, property: "stack/axis", value: layoutAxis)
+            try context.engine.block.setInt(stack, property: "stack/spacing", value: 16)
+          }
+
+          let pages = try context.engine.scene.getPages()
+          for block in pages {
+            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: true)
+            try context.engine.block.setScopeEnabled(block, key: "layer/visibility", enabled: isVisibilityEnabled)
+          }
+
+          Task {
+            // Zoom to the entire scene.
+            try await context.engine.scene.zoom(
+              to: scene,
+              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) }
+          }
+        } else {
+          try OnChanged.default(update, context)
+        }
+
+      default:
+        try OnChanged.default(update, context)
+      }
+    }
+  }
+}

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

@@ -0,0 +1,127 @@
+import Foundation
+import IMGLYEditor
+import IMGLYEngine
+
+// MARK: - Default OnCreate
+
+public extension PostcardEditorConfiguration {
+  /// The default `onCreate` handler.
+  internal static var defaultOnCreateHandler: OnCreate.Handler {
+    { engine, _ in
+      try await defaultOnCreate()(engine)
+    }
+  }
+
+  /// Default postcard 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 `PostcardEditorConfiguration.defaultPreCreateScene`.
+  ///   - createScene: Callback to load/create the scene and load asset sources. Defaults to
+  /// `PostcardEditorConfiguration.defaultCreateScene`.
+  ///   - loadAssetSources: Callback to load any asset sources. Defaults to
+  /// `PostcardEditorConfiguration.defaultLoadAssetSources`.
+  ///   - postCreateScene: Callback to do any post scene loading tasks. Defaults to
+  ///   `PostcardEditorConfiguration.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 postcard scene.
+  static let defaultCreateScene: OnCreate.Callback = { engine in
+    // highlight-starter-kit-on-create-scene
+    let sceneURL = Bundle(for: PostcardEditorConfiguration.self).url(
+      forResource: "postcard-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 postcard-specific layout and permission behavior.
+  static let defaultPostCreateScene: OnCreate.Callback = { engine in
+    if let stack = try engine.block.find(byType: .stack).first {
+      try engine.block.setEnum(stack, property: "stack/axis", value: "Horizontal")
+    }
+
+    try engine.editor.setGlobalScope(key: "editor/add", value: .defer)
+  }
+}

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

@@ -0,0 +1,29 @@
+import IMGLYEditor
+import IMGLYEngine
+import UniformTypeIdentifiers
+
+// MARK: - Default OnExport
+
+extension PostcardEditorConfiguration {
+  /// 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
+    }
+  }
+}