Bump to v0.11.0, update CHANGELOG.md & Example (#143)

I had to remove SwiftWasm 5.3 and 5.4 from CI because OpenCombine/OpenCombine#225 is reproducible with all code, not just OpenCombine, with old toolchains when Xcode 13.1 is installed.

I've also updated `Example` code to try using `fetch` with `async`/`await` and a section with a simple guide for this to `README.md`

Node.js and npm dependencies together with webpack.js config in `Example` directory were also updated.

* Bump to v0.11.0, update `CHANGELOG.md` & `Example`

* Add simple `async`/`await` guide to `README.md`

* Use `wasm-5.5-SNAPSHOT-2021-11-20-a`

* Update `CHANGELOG.md`

* Update `.swift-version`

* Add acknowledgements to `CHANGELOG.md`

Author: MaxDesiatov

.swift-version

@@ -1 +1 @@
-wasm-5.3.0-RELEASE
+wasm-5.5-SNAPSHOT-2021-11-20-a

CHANGELOG.md

@@ -1,3 +1,39 @@
+# 0.11.0 (22 November 2021)
+
+This release adds support for `async`/`await` and SwiftWasm 5.5. Use the new `value` async property
+on a `JSPromise` instance to `await` for its result. You'll have to add a dependency on the new
+`JavaScriptEventLoop` target in your `Package.swift`, `import JavaScriptEventLoop`, and call 
+`JavaScriptEventLoop.installGlobalExecutor()` in your code before you start using `await` and `Task`
+APIs.
+
+Additionally, manual memory management API of `JSClosure` has been removed to improve usability.
+This significantly bumps minimum browser version requirements for users of apps depending on
+JavaScriptKit. Previous manual memory management mode is still available though with a special
+compiler flags, see [`README.md`](./README.md) for more details.
+
+This new release of JavaScriptKit may work with SwiftWasm 5.4 and 5.3, but is no longer tested with
+those versions due to compatibility issues introduced on macOS by latest versions of Xcode.
+
+Many thanks to [@j-f1](https://github.com/j-f1), [@kateinoigakukun](https://github.com/kateinoigakukun), 
+and [@PatrickPijnappel](https://github.com/PatrickPijnappel) for their contributions to this release!
+
+**Closed issues:**
+
+- Enchancement: Add a link to the docs  ([#136](https://github.com/swiftwasm/JavaScriptKit/issues/136))
+- Use `FinalizationRegistry` to auto-deinit `JSClosure` ([#131](https://github.com/swiftwasm/JavaScriptKit/issues/131))
+- `make test` crashes due to `JSClosure` memory issues ([#129](https://github.com/swiftwasm/JavaScriptKit/issues/129))
+- Avoid manual memory management with `JSClosure` ([#106](https://github.com/swiftwasm/JavaScriptKit/issues/106))
+
+**Merged pull requests:**
+
+- Fix recursion in `JSTypedArray` initializer ([#142](https://github.com/swiftwasm/JavaScriptKit/pull/142)) via [@PatrickPijnappel](https://github.com/PatrickPijnappel)
+- Experimental global executor cooperating with JS event loop ([#141](https://github.com/swiftwasm/JavaScriptKit/pull/141)) via [@kateinoigakukun](https://github.com/kateinoigakukun)
+- Update NPM dependencies of `Example` project ([#140](https://github.com/swiftwasm/JavaScriptKit/pull/140)) via [@MaxDesiatov](https://github.com/MaxDesiatov)
+- Refactor `JSClosure` to leverage `FinalizationRegistry` ([#128](https://github.com/swiftwasm/JavaScriptKit/pull/128)) via [@j-f1](https://github.com/j-f1)
+- Test with the latest 5.5 snapshot ([#138](https://github.com/swiftwasm/JavaScriptKit/pull/138)) via [@MaxDesiatov](https://github.com/MaxDesiatov)
+- Test with multiple toolchain versions ([#135](https://github.com/swiftwasm/JavaScriptKit/pull/135)) via [@kateinoigakukun](https://github.com/kateinoigakukun)
+- Gardening tests ([#133](https://github.com/swiftwasm/JavaScriptKit/pull/133)) via [@kateinoigakukun](https://github.com/kateinoigakukun)
+
 # 0.10.1 (29 April 2021)
 
 This is a minor patch release that includes updates to our dependencies and minor documentation

Example/JavaScriptKitExample/Package.swift

@@ -10,5 +10,13 @@ let package = Package(
         ),
     ],
     dependencies: [.package(name: "JavaScriptKit", path: "../../")],
-    targets: [.target(name: "JavaScriptKitExample", dependencies: ["JavaScriptKit"])]
+    targets: [
+        .target(
+            name: "JavaScriptKitExample",
+            dependencies: [
+                "JavaScriptKit",
+                .product(name: "JavaScriptEventLoop", package: "JavaScriptKit")
+            ]
+        )
+    ]
 )

Example/JavaScriptKitExample/Sources/JavaScriptKitExample/main.swift

@@ -1,4 +1,5 @@
 import JavaScriptKit
+import JavaScriptEventLoop
 
 let alert = JSObject.global.alert.function!
 let document = JSObject.global.document
@@ -8,10 +9,40 @@ divElement.innerText = "Hello, world"
 _ = document.body.appendChild(divElement)
 
 var buttonElement = document.createElement("button")
-buttonElement.innerText = "Click me!"
-let listener = JSClosure { _ in
+buttonElement.innerText = "Alert demo"
+buttonElement.onclick = .object(JSClosure { _ in
     alert("Swift is running on browser!")
-}
-buttonElement.onclick = .object(listener)
+    return .undefined
+})
 
 _ = document.body.appendChild(buttonElement)
+
+private let jsFetch = JSObject.global.fetch.function!
+func fetch(_ url: String) -> JSPromise {
+    JSPromise(jsFetch(url).object!)!
+}
+
+JavaScriptEventLoop.installGlobalExecutor()
+
+struct Response: Decodable {
+    let uuid: String
+}
+
+var asyncButtonElement = document.createElement("button")
+asyncButtonElement.innerText = "Fetch UUID demo"
+asyncButtonElement.onclick = .object(JSClosure { _ in
+    Task {
+        do {
+            let response = try await fetch("https://httpbin.org/uuid").value
+            let json = try await JSPromise(response.json().object!)!.value
+            let parsedResponse = try JSValueDecoder().decode(Response.self, from: json)
+            alert(parsedResponse.uuid)
+        } catch {
+            print(error)
+        }
+    }
+
+    return .undefined
+})
+
+_ = document.body.appendChild(asyncButtonElement)

Example/package-lock.json

@@ -9,9 +9,9 @@
     "javascript-kit-swift": "file:.."
   },
   "devDependencies": {
-    "webpack": "^4.44.2",
-    "webpack-cli": "^3.3.12",
-    "webpack-dev-server": "^3.11.0"
+    "webpack": "^5.64.2",
+    "webpack-cli": "^4.9.1",
+    "webpack-dev-server": "^4.5.0"
   },
   "scripts": {
     "build": "webpack",

Example/package.json

@@ -9,11 +9,15 @@ module.exports = {
         path: outputPath,
     },
     devServer: {
-        inline: true,
-        watchContentBase: true,
-        contentBase: [
-            path.join(__dirname, "public"),
-            path.join(__dirname, "dist"),
+        static: [
+            {
+                directory: path.join(__dirname, "public"),
+                watch: true,
+            },
+            {
+                directory: path.join(__dirname, "dist"),
+                watch: true,
+            },
         ],
     },
 };

Example/webpack.config.js

@@ -53,7 +53,69 @@ let swiftPet: Pet = try JSValueDecoder().decode(from: jsPet)
 JSObject.global.alert!("Swift is running in the browser!")
 ```
 
-### Usage in a browser application
+### `async`/`await`
+
+Starting with SwiftWasm 5.5 you can use `async`/`await` with `JSPromise` objects. This requires
+a few additional steps though (you can skip these steps if your app depends on
+[Tokamak](https://tokamak.dev)):
+
+1. Make sure that your target depends on `JavaScriptEventLoop` in your `Packages.swift`:
+
+```swift
+.target(
+    name: "JavaScriptKitExample",
+    dependencies: [
+        "JavaScriptKit",
+        .product(name: "JavaScriptEventLoop", package: "JavaScriptKit")
+    ]
+)
+```
+
+2. Add an explicit import in the code that executes **before* you start using `await` and/or `Task`
+APIs (most likely in `main.swift`):
+
+```swift
+import JavaScriptEventLoop
+```
+
+3. Run this function **before* you start using `await` and/or `Task` APIs (again, most likely in
+`main.swift`):
+
+```swift
+JavaScriptEventLoop.installGlobalExecutor()
+```
+
+## Requirements 
+
+### For developers
+
+- macOS 11 and Xcode 13.0. *Xcode 13.1 is currently not supported.*
+- [Swift 5.4 or later](https://swift.org/download/) and Ubuntu 18.04 if you'd like to use Linux.
+  Other Linux distributions are currently not supported.
+
+### For users of apps depending 
+
+Any recent browser that [supports WebAssembly](https://caniuse.com/#feat=wasm) and required 
+JavaScript features should work, which currently includes:
+
+- Edge 84+
+- Firefox 79+
+- Chrome 84+
+- Desktop Safari 14.1+
+- Mobile Safari 14.8+
+
+If you need to support older browser versions, you'll have to build with
+`JAVASCRIPTKIT_WITHOUT_WEAKREFS` flag, passing `-Xswiftc -DJAVASCRIPTKIT_WITHOUT_WEAKREFS` flags
+when compiling. This should lower browser requirements to these versions:
+
+- Edge 16+
+- Firefox 61+
+- Chrome 66+
+- (Mobile) Safari 12+
+
+Not all of these versions are tested on regular basis though, compatibility reports are very welcome!
+
+## Usage in a browser application
 
 The easiest way to get started with JavaScriptKit in your browser app is with [the `carton`
 bundler](https://carton.dev).
@@ -104,7 +166,7 @@ You can also build your project with webpack.js and a manually installed SwiftWa
 see the following sections and the [Example](https://github.com/swiftwasm/JavaScriptKit/tree/main/Example)
 directory for more information in this more advanced use case.
 
-### Manual toolchain installation
+## Manual toolchain installation
 
 This library only supports [`swiftwasm/swift`](https://github.com/swiftwasm/swift) toolchain distribution.
 The toolchain can be installed via [`swiftenv`](https://github.com/kylef/swiftenv), in
@@ -115,18 +177,18 @@ especially if you change anything in the JavaScript runtime parts. This is becau
 embedded in `carton` and currently can't be replaced dynamically with the JavaScript code you've
 updated locally.
 
-Just pass a toolchain archive URL for [the latest SwiftWasm 5.3
-snapshot](https://github.com/swiftwasm/swift/releases) appropriate for your platform:
+Just pass a toolchain archive URL for [the latest SwiftWasm 5.5
+release](https://github.com/swiftwasm/swift/releases) appropriate for your platform:
 
 ```sh
-$ swiftenv install https://github.com/swiftwasm/swift/releases/download/swift-wasm-5.3.0-RELEASE/swift-wasm-5.3.0-RELEASE-macos_x86_64.pkg
+$ swiftenv install https://github.com/swiftwasm/swift/releases/download/swift-wasm-5.5.0-RELEASE/swift-wasm-5.5.0-RELEASE-macos_x86_64.pkg
 ```
 
 You can also use the `install-toolchain.sh` helper script that uses a hardcoded toolchain snapshot:
 
 ```sh
 $ ./scripts/install-toolchain.sh
 $ swift --version
-Swift version 5.3 (swiftlang-5.3.0)
-Target: x86_64-apple-darwin19.6.0
+Swift version 5.5 (swiftlang-5.5.0)
+Target: arm64-apple-darwin20.6.0
 ```

IntegrationTests/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "javascript-kit-swift",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "A runtime library of JavaScriptKit which is Swift framework to interact with JavaScript through WebAssembly.",
   "main": "Runtime/lib/index.js",
   "files": [