introduce async mode

Author: madsodgaard

Sources/JExtractSwiftLib/SwiftTypes/SwiftEffectSpecifier.swift

@@ -14,4 +14,5 @@
 
 enum SwiftEffectSpecifier: Equatable {
   case `throws`
+  case async
 }

Sources/JExtractSwiftLib/SwiftTypes/SwiftFunctionSignature.swift

@@ -246,7 +246,7 @@ extension SwiftFunctionSignature {
       effectSpecifiers.append(.throws)
     }
     if let asyncSpecifier = signature.effectSpecifiers?.asyncSpecifier {
-      throw SwiftFunctionTranslationError.async(asyncSpecifier)
+      effectSpecifiers.append(.async)
     }
 
     let parameters = try signature.parameterClause.parameters.map { param in
@@ -331,7 +331,7 @@ extension SwiftFunctionSignature {
       effectSpecifiers.append(.throws)
     }
     if let asyncSpecifier = decl.effectSpecifiers?.asyncSpecifier {
-      throw SwiftFunctionTranslationError.async(asyncSpecifier)
+      effectSpecifiers.append(.async)
     }
     return effectSpecifiers
   }

Sources/SwiftJavaConfigurationShared/Configuration.swift

@@ -46,6 +46,7 @@ public struct Configuration: Codable {
   public var effectiveUnsignedNumbersMode: JExtractUnsignedIntegerMode {
     unsignedNumbersMode ?? .default
   }
+
   public var minimumInputAccessLevelMode: JExtractMinimumAccessLevelMode?
   public var effectiveMinimumInputAccessLevelMode: JExtractMinimumAccessLevelMode {
     minimumInputAccessLevelMode ?? .default
@@ -56,6 +57,11 @@ public struct Configuration: Codable {
     memoryManagementMode ?? .default
   }
 
+  public var asyncMode: JExtractAsyncMode?
+  public var effectiveAsyncMode: JExtractAsyncMode {
+    asyncMode ?? .default
+  }
+
   // ==== java 2 swift ---------------------------------------------------------
 
   /// The Java class path that should be passed along to the swift-java tool.

Sources/SwiftJavaConfigurationShared/JExtract/JExtractAsyncMode.swift

@@ -0,0 +1,34 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2025 Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+/// Configures how Swift `async` functions should be extracted by jextract.
+public enum JExtractAsyncMode: String, Codable {
+  /// Extract Swift `async` APIs as Java functions that return `CompletableFuture`s.
+  case completableFuture
+
+  /// Extract Swift `async` APIs as Java functions that return `Future`s.
+  ///
+  /// This mode is useful for platforms that do not have `CompletableFuture` support, such as
+  /// Android 23 and below.
+  ///
+  /// - Note: Prefer using the `completableFuture` mode instead, if possible.
+  case future
+}
+
+
+extension JExtractAsyncMode {
+  public static var `default`: Self {
+    .completableFuture
+  }
+}

Sources/SwiftJavaConfigurationShared/JExtract/JExtractGenerationMode.swift

@@ -0,0 +1,22 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2025 Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+/// Determines which source generation mode JExtract should be using: JNI or Foreign Function and Memory.
+public enum JExtractGenerationMode: String, Codable {
+  /// Foreign Value and Memory API
+  case ffm
+
+  /// Java Native Interface
+  case jni
+}

Sources/SwiftJavaConfigurationShared/JExtract/JExtractMemoryManagementMode.swift

@@ -0,0 +1,34 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2025 Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+/// Configures how memory should be managed by the user
+public enum JExtractMemoryManagementMode: String, Codable {
+  /// Force users to provide an explicit `SwiftArena` to all calls that require them.
+  case explicit
+
+  /// Provide both explicit `SwiftArena` support
+  /// and a default global automatic `SwiftArena` that will deallocate memory when the GC decides to.
+  case allowGlobalAutomatic
+
+  public static var `default`: Self {
+    .explicit
+  }
+
+  public var requiresGlobalArena: Bool {
+    switch self {
+    case .explicit: false
+    case .allowGlobalAutomatic: true
+    }
+  }
+}

Sources/SwiftJavaConfigurationShared/JExtract/JExtractMinimumAccessLevelMode.swift

@@ -0,0 +1,26 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2025 Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+/// The minimum access level which
+public enum JExtractMinimumAccessLevelMode: String, Codable {
+  case `public`
+  case `package`
+  case `internal`
+}
+
+extension JExtractMinimumAccessLevelMode {
+  public static var `default`: Self {
+    .public
+  }
+}

Sources/SwiftJavaConfigurationShared/GenerationMode.swift renamed to Sources/SwiftJavaConfigurationShared/JExtract/JExtractUnsignedIntegerMode.swift

@@ -12,15 +12,6 @@
 //
 //===----------------------------------------------------------------------===//
 
-/// Determines which source generation mode JExtract should be using: JNI or Foreign Function and Memory.
-public enum JExtractGenerationMode: String, Codable {
-  /// Foreign Value and Memory API
-  case ffm
-
-  /// Java Native Interface
-  case jni
-}
-
 /// Configures how Swift unsigned integers should be extracted by jextract.
 public enum JExtractUnsignedIntegerMode: String, Codable {
   /// Treat unsigned Swift integers as their signed equivalents in Java signatures,
@@ -51,6 +42,7 @@ public enum JExtractUnsignedIntegerMode: String, Codable {
 //  case widenOrAnnotate
 }
 
+
 extension JExtractUnsignedIntegerMode {
   public var needsConversion: Bool {
     switch self {
@@ -63,38 +55,3 @@ extension JExtractUnsignedIntegerMode {
     .annotate
   }
 }
-
-/// The minimum access level which
-public enum JExtractMinimumAccessLevelMode: String, Codable {
-  case `public`
-  case `package`
-  case `internal`
-}
-
-extension JExtractMinimumAccessLevelMode {
-  public static var `default`: Self {
-    .public
-  }
-}
-
-
-/// Configures how memory should be managed by the user
-public enum JExtractMemoryManagementMode: String, Codable {
-  /// Force users to provide an explicit `SwiftArena` to all calls that require them.
-  case explicit
-
-  /// Provide both explicit `SwiftArena` support
-  /// and a default global automatic `SwiftArena` that will deallocate memory when the GC decides to.
-  case allowGlobalAutomatic
-
-  public static var `default`: Self {
-    .explicit
-  }
-
-  public var requiresGlobalArena: Bool {
-    switch self {
-    case .explicit: false
-    case .allowGlobalAutomatic: true
-    }
-  }
-}