Merge pull request #171 from swiftwasm/katei/add-availability-attr

Use availability guarded APIs under @available for Xcode development

Author: kateinoigakukun

.github/workflows/test.yml

@@ -26,3 +26,12 @@ jobs:
           SWIFT_VERSION=${{ matrix.toolchain }} make bootstrap
           echo ${{ matrix.toolchain }} > .swift-version
           make test
+  native-build:
+    # Check native build to make it easy to develop applications by Xcode
+    name: Build for native target
+    runs-on: macos-11
+    steps:
+      - uses: actions/checkout@v2
+      - run: swift build
+        env:
+          DEVELOPER_DIR: /Applications/Xcode_13.2.1.app/Contents/Developer/

Sources/JavaScriptEventLoop/JavaScriptEventLoop.swift

@@ -1,8 +1,11 @@
 import JavaScriptKit
 import _CJavaScriptEventLoop
 
+// NOTE: `@available` annotations are semantically wrong, but they make it easier to develop applications targeting WebAssembly in Xcode.
+
 #if compiler(>=5.5)
 
+@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
 public final class JavaScriptEventLoop: SerialExecutor, @unchecked Sendable {
 
     /// A function that queues a given closure as a microtask into JavaScript event loop.
@@ -94,6 +97,7 @@ public final class JavaScriptEventLoop: SerialExecutor, @unchecked Sendable {
     }
 }
 
+@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
 public extension JSPromise {
     /// Wait for the promise to complete, returning (or throwing) its result.
     var value: JSValue {

Sources/JavaScriptEventLoop/JobQueue.swift

@@ -5,11 +5,14 @@
 import _CJavaScriptEventLoop
 
 #if compiler(>=5.5)
+
+@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
 struct QueueState: Sendable {
     fileprivate var headJob: UnownedJob? = nil
     fileprivate var isSpinning: Bool = false
 }
 
+@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
 extension JavaScriptEventLoop {
 
     func insertJobQueue(job newJob: UnownedJob) {
@@ -55,6 +58,7 @@ extension JavaScriptEventLoop {
     }
 }
 
+@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
 fileprivate extension UnownedJob {
     private func asImpl() -> UnsafeMutablePointer<_CJavaScriptEventLoop.Job> {
         unsafeBitCast(self, to: UnsafeMutablePointer<_CJavaScriptEventLoop.Job>.self)