expo-modules-jsi 56.0.7 → 56.0.8

package/CHANGELOG.md

@@ -10,6 +10,18 @@
 
 ### 💡 Others
 
+## 56.0.8 — 2026-06-05
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed the xcframework build failing with a `sed` error when building in an environment that uses GNU `sed` instead of BSD `sed` (e.g. a Nix shell). ([#46389](https://github.com/expo/expo/pull/46389) by [@niteshbalusu11](https://github.com/niteshbalusu11))
+- [iOS] Propagate `JavaScriptPromise` setup failures instead of trapping the app. ([#46106](https://github.com/expo/expo/issues/46106) by [@qutrek](https://github.com/qutrek)) ([#46145](https://github.com/expo/expo/pull/46145) by [@mvincentong](https://github.com/mvincentong))
+- Fix build framework for macOS ([#46413](https://github.com/expo/expo/pull/46413) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+- Fix build framework for Mac Catalyst ([#46289](https://github.com/expo/expo/pull/46289) by [@theeket](https://github.com/theeket))
+- [iOS] Throw instead of aborting when `getPropertyAsFunction` targets a missing or non-callable property. ([#46437](https://github.com/expo/expo/pull/46437) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Throw instead of aborting when `getPropertyAsObject` targets a non-object property. ([#46438](https://github.com/expo/expo/pull/46438) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Include the Swift toolchain version in the xcframework cache key so upgrading Xcode rebuilds slices instead of reusing ones built by an older compiler. ([#46523](https://github.com/expo/expo/pull/46523) by [@tsapeta](https://github.com/tsapeta))
+
 ## 56.0.7 — 2026-05-20
 
 ### 🐛 Bug fixes

package/CLAUDE.md

@@ -60,3 +60,7 @@ struct JavaScriptRuntimeTests {
 Tests are in `apple/Tests/` and each file covers one type. Some suites use the global actor `@JavaScriptActor` for executor isolation.
 
 Run them with `pnpm test` from the package root, which calls `apple/scripts/test.sh`. The script needs an installed host app's `Pods` directory (defaults to `$EXPO_ROOT_DIR/apps/bare-expo/ios/Pods`); override with `PODS_ROOT`. It symlinks React / hermesvm / ReactNativeDependencies xcframeworks into `apple/.test-frameworks/` so SPM can resolve them as relative-path binary targets, generates the `jsi` modulemap, and runs `xcodebuild test` against an iOS Simulator (override with `DESTINATION`). Extra args pass through to xcodebuild — e.g. `pnpm test -only-testing TestName`.
+
+## Formatting
+
+Swift sources are formatted with swift-format. From the package root, `pnpm swift:format` rewrites files in place and `pnpm swift:lint` checks without modifying; both delegate to the repo-root `scripts/swift-format.sh`, which reads the repo-root `.swift-format` config and only touches tracked `.swift` files. CI enforces this via `.github/workflows/swift-format.yml`, which pins a specific swift-format version — mismatched local versions can produce different output, so prefer the pinned one. Style conventions beyond what the formatter enforces live in [`guides/Swift Style Guide.md`](../../guides/Swift%20Style%20Guide.md) at the repo root.

package/apple/Package.swift

@@ -1,8 +1,8 @@
 // swift-tools-version: 6.2
 // The swift-tools-version declares the minimum version of Swift required to build this package.
 
-import PackageDescription
 import Foundation
+import PackageDescription
 
 let packageDir = URL(fileURLWithPath: #filePath).deletingLastPathComponent().path
 let podsRoot = resolvePodsRoot()
@@ -17,7 +17,8 @@ let podsRoot = resolvePodsRoot()
 // `REACT_NATIVE_PATH` is exported by Xcode for hosts that build RN from a
 // non-npm location, e.g. Expo Go.
 let publicHeaders = "\(podsRoot)/Headers/Public"
-let reactNative = ProcessInfo.processInfo.environment["RN_ROOT"]
+let reactNative =
+  ProcessInfo.processInfo.environment["RN_ROOT"]
   ?? ProcessInfo.processInfo.environment["REACT_NATIVE_PATH"]
   ?? "\(podsRoot)/../../node_modules/react-native"
 let headerSearchPaths = [
@@ -72,7 +73,7 @@ let package = Package(
       name: "ExpoModulesJSI",
       type: .dynamic,
       targets: ["ExpoModulesJSI"],
-    ),
+    )
   ],
   dependencies: [],
   targets: [
@@ -80,7 +81,7 @@ let package = Package(
     .target(
       name: "ExpoModulesJSI",
       dependencies: [
-        "ExpoModulesJSI-Cxx",
+        "ExpoModulesJSI-Cxx"
       ],
       swiftSettings: [
         .interoperabilityMode(.Cxx),
@@ -115,7 +116,7 @@ let package = Package(
         // builds without those static libs being available here.
         .unsafeFlags([
           "-Xlinker", "-undefined", "-Xlinker", "dynamic_lookup",
-        ]),
+        ])
       ],
     ),
 
@@ -124,7 +125,7 @@ let package = Package(
       name: "ExpoModulesJSI-Cxx",
       dependencies: [],
       cxxSettings: [
-        .unsafeFlags(cxxIncludeFlags),
+        .unsafeFlags(cxxIncludeFlags)
       ],
     ),
 
@@ -147,10 +148,12 @@ func resolvePodsRoot() -> String {
   if let explicit = env["PODS_ROOT"] {
     return explicit
   }
-  let repoRoot = env["EXPO_ROOT_DIR"] ?? URL(fileURLWithPath: packageDir)
-    .deletingLastPathComponent() // expo-modules-jsi
-    .deletingLastPathComponent() // packages
-    .deletingLastPathComponent() // repo root
+  let repoRoot =
+    env["EXPO_ROOT_DIR"]
+    ?? URL(fileURLWithPath: packageDir)
+    .deletingLastPathComponent()  // expo-modules-jsi
+    .deletingLastPathComponent()  // packages
+    .deletingLastPathComponent()  // repo root
     .path
   return "\(repoRoot)/apps/bare-expo/ios/Pods"
 }
@@ -171,7 +174,8 @@ func resolveTestFrameworks() -> (binaryTargets: [Target], dependencies: [Target.
   let binaryTargets: [Target] = available.map({
     .binaryTarget(name: $0, path: ".test-frameworks/\($0).xcframework")
   })
-  let dependencies: [Target.Dependency] = ["ExpoModulesJSI"]
+  let dependencies: [Target.Dependency] =
+    ["ExpoModulesJSI"]
     + available.map({ .target(name: $0) })
   return (binaryTargets, dependencies)
 }

package/apple/Sources/ExpoModulesJSI/Contexts/CleanupContext.swift

@@ -1,9 +1,7 @@
 // Copyright 2025-present 650 Industries. All rights reserved.
 
-/**
- A box that holds a cleanup closure and invokes it on deallocation.
- Used to bridge Swift closures to C++ cleanup callbacks via `Unmanaged` pointers.
- */
+/// A box that holds a cleanup closure and invokes it on deallocation.
+/// Used to bridge Swift closures to C++ cleanup callbacks via `Unmanaged` pointers.
 internal final class CleanupContext: Sendable {
   let cleanup: @Sendable () -> Void
 

package/apple/Sources/ExpoModulesJSI/Contexts/HostFunctionContext.swift

@@ -1,6 +1,4 @@
-/**
- Context that captures Swift values to pass them to JSI host function as an unmanaged pointer for interoperability with C++.
- */
+/// Context that captures Swift values to pass them to JSI host function as an unmanaged pointer for interoperability with C++.
 internal final class HostFunctionContext: Sendable {
   weak let runtime: JavaScriptRuntime?
   let name: String?

package/apple/Sources/ExpoModulesJSI/Contexts/HostObjectContext.swift

@@ -1,6 +1,4 @@
-/**
- Context that captures Swift types to pass them to JSI host object as an unmanaged pointer for interoperability with C++.
- */
+/// Context that captures Swift types to pass them to JSI host object as an unmanaged pointer for interoperability with C++.
 internal final class HostObjectContext: Sendable {
   typealias Getter = @JavaScriptActor (_ propertyName: String) throws -> JavaScriptValue
   typealias Setter = @JavaScriptActor (_ propertyName: String, _ value: JavaScriptValue) throws -> Void

package/apple/Sources/ExpoModulesJSI/Extensions/Task+immediate.swift

@@ -1,3 +1,5 @@
+// swift-format-ignore-file: AlwaysUseLowerCamelCase
+
 // `Task.immediate` is a pretty useful API that lets us immediately switch from synchronous to asynchronous context.
 // Read the proposal for more: https://github.com/swiftlang/swift-evolution/blob/main/proposals/0472-task-start-synchronously-on-caller-context.md
 // Unfortunately, it is available only as of Apple OS 26.0 and there are no plans to backport it yet.

package/apple/Sources/ExpoModulesJSI/Protocols/JSIRepresentable.swift

@@ -1,18 +1,12 @@
 import CoreGraphics
-internal import jsi
 internal import ExpoModulesJSI_Cxx
+internal import jsi
 
-/**
- A type whose values can be represented as `facebook.jsi.Value`.
- */
+/// A type whose values can be represented as `facebook.jsi.Value`.
 internal protocol JSIRepresentable: JavaScriptRepresentable, Sendable, ~Copyable {
-  /**
-   Creates an instance of this type from the given `facebook.jsi.Value` in `facebook.jsi.IRuntime`.
-   */
+  /// Creates an instance of this type from the given `facebook.jsi.Value` in `facebook.jsi.IRuntime`.
   static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Self
-  /**
-   Creates a JSI value representing this value in the given JSI runtime.
-   */
+  /// Creates a JSI value representing this value in the given JSI runtime.
   func toJSIValue(in runtime: facebook.jsi.IRuntime) -> facebook.jsi.Value
 }
 
@@ -52,11 +46,13 @@ extension Bool: JSIRepresentable {
 internal protocol JSIRepresentableNumber: JSIRepresentable {}
 
 extension JSIRepresentableNumber {
-  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Int where Self: FixedWidthInteger {
+  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Int
+  where Self: FixedWidthInteger {
     return Int(value.getNumber())
   }
 
-  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Double where Self: BinaryFloatingPoint {
+  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Double
+  where Self: BinaryFloatingPoint {
     return value.getNumber()
   }
 
@@ -79,7 +75,9 @@ extension UInt8: JSIRepresentableNumber {}
 extension UInt16: JSIRepresentableNumber {}
 extension UInt32: JSIRepresentableNumber {}
 extension UInt64: JSIRepresentableNumber {}
+#if arch(arm64) || (!os(macOS) && !targetEnvironment(macCatalyst))
 extension Float16: JSIRepresentableNumber {}
+#endif
 extension Float32: JSIRepresentableNumber {}
 extension Float64: JSIRepresentableNumber {}
 extension CGFloat: JSIRepresentableNumber {}
@@ -108,7 +106,7 @@ extension Optional: JSIRepresentable where Wrapped: JSIRepresentable {
 }
 
 extension Array: JSIRepresentable where Element: JSIRepresentable {
-  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Array<Element> {
+  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> [Element] {
     let jsiArray = value.getObject(runtime).getArray(runtime)
     let size = jsiArray.size(runtime)
     var result: Self = []
@@ -132,7 +130,7 @@ extension Array: JSIRepresentable where Element: JSIRepresentable {
 }
 
 extension Dictionary: JSIRepresentable where Key == String, Value: JSIRepresentable {
-  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> Dictionary<Key, Value> {
+  static func fromJSIValue(_ value: borrowing facebook.jsi.Value, in runtime: facebook.jsi.IRuntime) -> [Key: Value] {
     let object = value.getObject(runtime)
     let propertyNames = object.getPropertyNames(runtime)
     let size = propertyNames.size(runtime)
@@ -141,7 +139,12 @@ extension Dictionary: JSIRepresentable where Key == String, Value: JSIRepresenta
     for index in 0..<size {
       let jsiKey = propertyNames.getValueAtIndex(runtime, index)
       let key = String.fromJSIValue(jsiKey, in: runtime)
+      #if os(macOS)
+      // TODO: remove when bumping to react-native-macos 0.85
+      let jsiValue = expo.getProperty(runtime, object, key)
+      #else
       let jsiValue = object.getProperty(runtime, jsiKey)
+      #endif
 
       result[key] = Value.fromJSIValue(jsiValue, in: runtime)
     }

package/apple/Sources/ExpoModulesJSI/Protocols/JavaScriptRepresentable.swift

@@ -2,17 +2,11 @@ internal import jsi
 
 // MARK: - JavaScriptRepresentable
 
-/**
- A type whose values can be represented in the JS runtime.
- */
+/// A type whose values can be represented in the JS runtime.
 public protocol JavaScriptRepresentable: Sendable, ~Copyable {
-  /**
-   Creates an instance of this type from the given JS value.
-   */
+  /// Creates an instance of this type from the given JS value.
   static func fromJavaScriptValue(_ value: JavaScriptValue) -> Self
-  /**
-   Creates a JS value representing this value in the given runtime.
-   */
+  /// Creates a JS value representing this value in the given runtime.
   func toJavaScriptValue(in runtime: JavaScriptRuntime) -> JavaScriptValue
 }
 

package/apple/Sources/ExpoModulesJSI/Protocols/JavaScriptThrowable.swift

@@ -1,33 +1,27 @@
-/**
- A protocol that native error types can conform to in order to control
- how they are represented when thrown into the JavaScript world.
-
- When a native function throws an error that conforms to this protocol,
- a JavaScript `Error` object is created with the specified `message`
- and `code`.
-
- Types that don't conform to this protocol are still throwable, but
- will use a generic error representation.
-
- ```swift
- struct MyError: JavaScriptThrowable {
-   var message: String { "Something went wrong" }
-   var code: String { "ERR_MY_ERROR" }
- }
- ```
- */
+/// A protocol that native error types can conform to in order to control
+/// how they are represented when thrown into the JavaScript world.
+///
+/// When a native function throws an error that conforms to this protocol,
+/// a JavaScript `Error` object is created with the specified `message`
+/// and `code`.
+///
+/// Types that don't conform to this protocol are still throwable, but
+/// will use a generic error representation.
+///
+/// ```swift
+/// struct MyError: JavaScriptThrowable {
+///   var message: String { "Something went wrong" }
+///   var code: String { "ERR_MY_ERROR" }
+/// }
+/// ```
 public protocol JavaScriptThrowable: Error, Sendable {
-  /**
-   The error message describing what went wrong. Defaults to the debug description of the
-   conforming type, which typically includes richer context (class name, origin, cause chain)
-   than a plain description. Override to provide a custom user-facing message.
-   */
+  /// The error message describing what went wrong. Defaults to the debug description of the
+  /// conforming type, which typically includes richer context (class name, origin, cause chain)
+  /// than a plain description. Override to provide a custom user-facing message.
   var message: String { get }
 
-  /**
-   An error code for programmatic error handling in JavaScript.
-   Return an empty string to omit the `code` property from the JS error.
-   */
+  /// An error code for programmatic error handling in JavaScript.
+  /// Return an empty string to omit the `code` property from the JS error.
   var code: String { get }
 }
 

package/apple/Sources/ExpoModulesJSI/Protocols/JavaScriptType.swift

@@ -1,35 +1,27 @@
-/**
- Protocol conformed by the types that represent any JavaScript values.
- */
+/// Protocol conformed by the types that represent any JavaScript values.
 public protocol JavaScriptType: Sendable, ~Copyable {
   associatedtype Ref
 
-  /**
-   Returns a value that this instance represents as a `JavaScriptValue`.
-   */
+  /// Returns a value that this instance represents as a `JavaScriptValue`.
   func asValue() -> JavaScriptValue
 
-  /**
-   Creates a reference to this non-copyable JS value. Ownership on the value is transferred (is consumed) to the reference.
-   The original type and value are preserved; Referencing `JavaScriptFunction` and then dereferencing returns exactly the same struct.
-   */
+  /// Creates a reference to this non-copyable JS value. Ownership on the value is transferred (is consumed) to the reference.
+  /// The original type and value are preserved; Referencing `JavaScriptFunction` and then dereferencing returns exactly the same struct.
   consuming func ref() -> JavaScriptRef<Self>
 
-  /**
-   Creates a reference to a copy of this JS value. Ownership is **not transferred** (is borrowed) as the ref owns its copy.
-   The original type and value are **not preserved**, meaning that dereferencing will return a `JavaScriptValue`.
-   */
+  /// Creates a reference to a copy of this JS value. Ownership is **not transferred** (is borrowed) as the ref owns its copy.
+  /// The original type and value are **not preserved**, meaning that dereferencing will return a `JavaScriptValue`.
   borrowing func refToValue() -> JavaScriptValue.Ref
 }
 
-public extension JavaScriptType where Self: ~Copyable {
-  typealias Ref = JavaScriptRef<Self>
+extension JavaScriptType where Self: ~Copyable {
+  public typealias Ref = JavaScriptRef<Self>
 
-  consuming func ref() -> JavaScriptRef<Self> {
+  public consuming func ref() -> JavaScriptRef<Self> {
     return JavaScriptRef(self)
   }
 
-  borrowing func refToValue() -> JavaScriptValue.Ref {
+  public borrowing func refToValue() -> JavaScriptValue.Ref {
     return JavaScriptRef(self.asValue())
   }
 }

package/apple/Sources/ExpoModulesJSI/Runtime/JavaScriptActor.swift

@@ -1,17 +1,13 @@
 import Foundation
 
-/**
- Name of the JavaScript thread created by React Native. Copied from `RCTJSThreadManager.mm`.
- */
+/// Name of the JavaScript thread created by React Native. Copied from `RCTJSThreadManager.mm`.
 private let jsThreadName = "com.facebook.react.runtime.JavaScript"
 
-/**
- Global actor that is used to isolate the code that should only be executed from the JavaScript thread.
- Theoretically it does not act as a real actor; it uses a serial executor that executes jobs **synchronously**
- without hopping to the proper thread. Meaning that running these jobs on the JavaScript thread must be ensured
- externally before switching to the isolated context, e.g. using `schedule` function on `JavaScriptRuntime`
- or enforcing the isolation with `JavaScriptActor.assumeIsolated`.
- */
+/// Global actor that is used to isolate the code that should only be executed from the JavaScript thread.
+/// Theoretically it does not act as a real actor; it uses a serial executor that executes jobs **synchronously**
+/// without hopping to the proper thread. Meaning that running these jobs on the JavaScript thread must be ensured
+/// externally before switching to the isolated context, e.g. using `schedule` function on `JavaScriptRuntime`
+/// or enforcing the isolation with `JavaScriptActor.assumeIsolated`.
 @globalActor
 public actor JavaScriptActor: GlobalActor {
   public static let shared = JavaScriptActor()
@@ -24,13 +20,11 @@ public actor JavaScriptActor: GlobalActor {
     return executor.asUnownedSerialExecutor()
   }
 
-  /**
-   An equivalent of `MainActor.assumeIsolated`, but for the `JavaScriptActor`. Assumes that the currently executing
-   synchronous function is actually executing on the JavaScript thread and invokes an isolated version of the operation,
-   allowing synchronous access to JavaScript runtime state without hopping through asynchronous boundaries.
-
-   See https://stackoverflow.com/a/79346971 for more information about the implementation.
-   */
+  /// An equivalent of `MainActor.assumeIsolated`, but for the `JavaScriptActor`. Assumes that the currently executing
+  /// synchronous function is actually executing on the JavaScript thread and invokes an isolated version of the operation,
+  /// allowing synchronous access to JavaScript runtime state without hopping through asynchronous boundaries.
+  ///
+  /// See https://stackoverflow.com/a/79346971 for more information about the implementation.
   public static func assumeIsolated<T: ~Copyable>(_ operation: @JavaScriptActor () throws -> T) rethrows -> T {
     typealias YesActor = @JavaScriptActor () throws -> T
     typealias NoActor = () throws -> T
@@ -45,33 +39,25 @@ public actor JavaScriptActor: GlobalActor {
     }
   }
 
-  /**
-   Stops program execution if the actor's executor is not isolating the current context.
-   */
+  /// Stops program execution if the actor's executor is not isolating the current context.
   public static func checkIsolated() {
     shared.executor.checkIsolated()
   }
 }
 
-/**
- Executor for the `JavaScriptActor` that executes given jobs synchronously and immediately.
- - Note: It does not ensure that given jobs are executed on the JavaScript thread; it must be done externally.
- */
+/// Executor for the `JavaScriptActor` that executes given jobs synchronously and immediately.
+/// - Note: It does not ensure that given jobs are executed on the JavaScript thread; it must be done externally.
 internal class JavaScriptExecutor: SerialExecutor, @unchecked Sendable {
   func enqueue(_ job: UnownedJob) {
     job.runSynchronously(on: self.asUnownedSerialExecutor())
   }
 
-  /**
-   Converts the executor to the optimized form of borrowed executor reference.
-   */
+  /// Converts the executor to the optimized form of borrowed executor reference.
   func asUnownedSerialExecutor() -> UnownedSerialExecutor {
     return UnownedSerialExecutor(ordinary: self)
   }
 
-  /**
-   Stops program execution if the executor is not isolating the current context.
-   */
+  /// Stops program execution if the executor is not isolating the current context.
   func checkIsolated() {
     // Using `assert` instead of `precondition` because this check is a heuristic based on
     // thread name, not a precise isolation guarantee. Worklet runtimes legitimately run on
@@ -79,19 +65,16 @@ internal class JavaScriptExecutor: SerialExecutor, @unchecked Sendable {
     assert(isIsolatingCurrentContext() == true, "JavaScriptActor operations must be run on the JavaScript thread")
   }
 
-  /**
-   Checks whether the executor isolates the current context, i.e. the current thread is a JavaScript thread.
-   The condition is also met when running tests and in single threaded environments.
-   */
+  /// Checks whether the executor isolates the current context, i.e. the current thread is a JavaScript thread.
+  /// The condition is also met when running tests and in single threaded environments.
   func isIsolatingCurrentContext() -> Bool? {
     // We must be careful as it relies on the thread name given by React Native.
-    return Thread.current.name == jsThreadName || !Thread.isMultiThreaded() || ProcessInfo.processInfo.processName == "xctest"
+    return Thread.current.name == jsThreadName || !Thread.isMultiThreaded()
+      || ProcessInfo.processInfo.processName == "xctest"
   }
 }
 
-/**
- An actor that is dedicated for the specific runtime.
- */
+/// An actor that is dedicated for the specific runtime.
 internal actor JavaScriptRuntimeActor {
   private weak let runtime: JavaScriptRuntime?
   nonisolated private let executor: JavaScriptExecutor
@@ -110,9 +93,7 @@ internal actor JavaScriptRuntimeActor {
   }
 }
 
-/**
- Serial executor dedicated for the specific runtime.
- */
+/// Serial executor dedicated for the specific runtime.
 internal final class JavaScriptRuntimeExecutor: JavaScriptExecutor, @unchecked Sendable {
   private weak let runtime: JavaScriptRuntime?
 

package/apple/Sources/ExpoModulesJSI/Runtime/JavaScriptNativeState.swift

@@ -1,9 +1,7 @@
-internal import jsi
 internal import ExpoModulesJSI_Cxx
+internal import jsi
 
-/**
- Base class for JS object's native state.
- */
+/// Base class for JS object's native state.
 open class JavaScriptNativeState {
   // Stored as an opaque pointer to avoid ARC retaining the bridged C++ type,
   // which could cause memory leaks due to unbalanced reference counting.
@@ -43,17 +41,13 @@ open class JavaScriptNativeState {
     self.pointee = expo.NativeState(ptr, deallocate)
   }
 
-  /**
-   Checks whether the underlying native state has already been released.
-   */
+  /// Checks whether the underlying native state has already been released.
   public var isReleased: Bool {
     return pointee == nil
   }
 
-  /**
-   Sets a deallocator, a closure that is invoked when this native state is no longer attached to any JS object.
-   Replaces any previously set deallocator.
-   */
+  /// Sets a deallocator, a closure that is invoked when this native state is no longer attached to any JS object.
+  /// Replaces any previously set deallocator.
   public func setDeallocator(_ deallocator: @escaping Deallocator) throws(NativeStateReleasedError) {
     if isReleased {
       throw NativeStateReleasedError()
@@ -61,10 +55,8 @@ open class JavaScriptNativeState {
     self.deallocator = deallocator
   }
 
-  /**
-   Turns given C++ `expo.NativeState` into its Swift counterpart.
-   May return `nil` if the native state is of unrelated type.
-   */
+  /// Turns given C++ `expo.NativeState` into its Swift counterpart.
+  /// May return `nil` if the native state is of unrelated type.
   internal static func from(cxx nativeState: expo.NativeState) -> Self? {
     // Get the opaque pointer stored by the C++ native state.
     let context = nativeState.getContext()

package/apple/Sources/ExpoModulesJSI/Runtime/JavaScriptPropNameID.swift

@@ -1,31 +1,23 @@
 internal import jsi
 
-/**
- Represents something that can be a JS property key.
- */
+/// Represents something that can be a JS property key.
 public final class JavaScriptPropNameID: JavaScriptType {
   private weak let runtime: JavaScriptRuntime?
   internal let pointee: facebook.jsi.PropNameID
 
-  /**
-   Creates a PropNameID from existing `facebook.jsi.PropNameID`.
-   */
+  /// Creates a PropNameID from existing `facebook.jsi.PropNameID`.
   internal init(_ runtime: JavaScriptRuntime, _ pointee: consuming facebook.jsi.PropNameID) {
     self.runtime = runtime
     self.pointee = pointee
   }
 
-  /**
-   Creates a PropNameID from the string.
-   */
+  /// Creates a PropNameID from the string.
   public init(_ runtime: JavaScriptRuntime, string: String) {
     self.runtime = runtime
     self.pointee = facebook.jsi.PropNameID.forUtf8(runtime.pointee, string, string.count)
   }
 
-  /**
-   Copies the data in a PropNameID as UTF8 into a string.
-   */
+  /// Copies the data in a PropNameID as UTF8 into a string.
   public func utf8() -> String {
     guard let runtime else {
       FatalError.runtimeLost()
@@ -33,9 +25,7 @@ public final class JavaScriptPropNameID: JavaScriptType {
     return String(pointee.utf8(runtime.pointee))
   }
 
-  /**
-   Copies the data in a PropNameID as UTF16 into a string.
-   */
+  /// Copies the data in a PropNameID as UTF16 into a string.
   public func utf16() -> String {
     guard let runtime else {
       FatalError.runtimeLost()