expo-modules-jsi 58.0.6 → 58.0.8

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 58.0.8
+
+### Patch Changes
+
+- [iOS] Add `decodableKinds` to `JavaScriptDecodable`: the kinds of JavaScript value (`JavaScriptValueKinds`) that `decode` can accept, so code that picks between several types can skip the ones that can't match. ([#50905](https://github.com/expo/expo/pull/50905) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Fix crash reports symbolicated on the device showing no function names for `ExpoModulesJSI` frames. ([#50698](https://github.com/expo/expo/pull/50698) by [@tsapeta](https://github.com/tsapeta))
+- Return strings, objects and arrays from host functions and host object getters without cloning the engine handle, and build short ASCII strings from JS inline. ([#50937](https://github.com/expo/expo/pull/50937) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Add `JavaScriptRuntime.cached(_:_:)` with typed `JavaScriptRuntime.Cache.Key`s, to create a value once per runtime and reuse it, for example a JavaScript constructor or a property name. A lookup reads one array slot, about 5× faster than the string-keyed `JavaScriptPropNameID.cached(_:_:)`. ([#50888](https://github.com/expo/expo/pull/50888) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Add `JavaScriptValue.withUnownedValue(in:_:)`, and give the owning `JavaScriptDecodable.decode` a default that borrows the value and decodes it through the `JavaScriptUnownedValue` overload, so a conformer can implement only that one. Arrays, dictionaries, dates, records and enums now decode unowned values without copying them first. ([#50960](https://github.com/expo/expo/pull/50960) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Add `JavaScriptArray.mapUnowned(_:)`, `JavaScriptObject.withUnownedProperty(_:_:)`, and `isArray()` and `getArray(in:)` on `JavaScriptUnownedValue`. Arrays, dictionaries and dates now decode through their unowned overload without copying the value or wrapping each element in a `JavaScriptValue`, and their owning decodes forward to it. ([#50980](https://github.com/expo/expo/pull/50980) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Keep checkout paths out of the Swift compilation cache key so modules importing ExpoModulesCore can reuse cached compilation results across checkouts and worktrees. ([#50354](https://github.com/expo/expo/pull/50354) by [@janicduplessis](https://github.com/janicduplessis))
+
+## 58.0.7
+
+### Patch Changes
+
+- Bump precompiled artifacts due to ABI breakage in expo-modules-jsi@58.0.6. ([#50881](https://github.com/expo/expo/pull/50881) by [@kitten](https://github.com/kitten))
+- [iOS] Add conversions between JavaScript values and free-form `Any`, `[Any]` and `[String: Any]` values. ([#50660](https://github.com/expo/expo/pull/50660) by [@tsapeta](https://github.com/tsapeta))
+
 ## 58.0.6
 
 ### Patch Changes

package/apple/Benchmarks/FreeFormBenchmarks.swift

@@ -0,0 +1,61 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+import ExpoModulesJSI
+import Testing
+
+/// Benchmarks for the free-form (`Any`) conversions. Each pair compares the dedicated fast path for
+/// `[String: Any]` against the generic path that converts through `Any` and casts, on the same
+/// attributes-like object of string, number and boolean values.
+extension JSIBenchmarks {
+  private static let attributesSource = """
+    ({ screen: 'home', build: 'release', region: 'eu', retries: 3, latency: 12.5, cached: true, visible: false, count: 42 })
+    """
+
+  @Test
+  func `decode free-form dictionary`() async throws {
+    try await benchmarkCase { runtime in
+      let value = try runtime.eval(Self.attributesSource)
+      try benchmark("JavaScriptValue.decodeAnyDictionary(_:in:)", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try JavaScriptValue.decodeAnyDictionary(value, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `decode free-form dictionary through the generic path`() async throws {
+    try await benchmarkCase { runtime in
+      let value = try runtime.eval(Self.attributesSource)
+      try benchmark("JavaScriptValue.decodeAny(_:as: [String: Any].self, in:)", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try JavaScriptValue.decodeAny(value, as: [String: Any].self, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `encode free-form dictionary`() async throws {
+    try await benchmarkCase { runtime in
+      let attributes = try JavaScriptValue.decodeAnyDictionary(runtime.eval(Self.attributesSource), in: runtime)
+      try benchmark("JavaScriptValue.encodeAnyDictionary(_:in:)", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try JavaScriptValue.encodeAnyDictionary(attributes, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `encode free-form dictionary through the generic path`() async throws {
+    try await benchmarkCase { runtime in
+      let attributes: Any = try JavaScriptValue.decodeAnyDictionary(runtime.eval(Self.attributesSource), in: runtime)
+      try benchmark("JavaScriptValue.encodeAny(_:in:): [String: Any]", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try JavaScriptValue.encodeAny(attributes, in: runtime)
+        }
+      }
+    }
+  }
+}

package/apple/Benchmarks/RuntimeCacheBenchmarks.swift

@@ -0,0 +1,71 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+import ExpoModulesJSI
+import Testing
+
+private let answerPropNameKey = JavaScriptRuntime.Cache.Key<JavaScriptPropNameID>()
+
+/// Benchmarks for values cached per runtime with ``JavaScriptRuntime/cached(_:_:)``, read against
+/// the string-keyed ``JavaScriptPropNameID/cached(_:_:)`` registry.
+extension JSIBenchmarks {
+  @Test
+  func `runtime cache hit`() async throws {
+    try await benchmarkCase { runtime in
+      _ = runtime.cached(answerPropNameKey) { JavaScriptPropNameID(runtime, string: "answer") }
+      try benchmark("JavaScriptRuntime.cached(_:_:): hit", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = runtime.cached(answerPropNameKey) { JavaScriptPropNameID(runtime, string: "answer") }
+        }
+      }
+    }
+  }
+
+  @Test
+  func `object property by runtime-cached PropNameID`() async throws {
+    try await benchmarkCase { runtime in
+      let object = try runtime.eval("({ answer: 42 })").getObject()
+      try benchmark("JavaScriptObject.getProperty(_:): runtime-cached PropNameID", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = object.getProperty(runtime.cached(answerPropNameKey) { JavaScriptPropNameID(runtime, string: "answer") })
+        }
+      }
+    }
+  }
+
+  @Test
+  func `string-keyed PropNameID cache hit`() async throws {
+    try await benchmarkCase { runtime in
+      try benchmark("JavaScriptPropNameID.cached(_:_:): hit", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = JavaScriptPropNameID.cached(runtime, "answer")
+        }
+      }
+    }
+  }
+
+  @Test
+  func `object property by string-keyed cached PropNameID`() async throws {
+    try await benchmarkCase { runtime in
+      let object = try runtime.eval("({ answer: 42 })").getObject()
+      try benchmark("JavaScriptObject.getProperty(_:): string-cached PropNameID", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = object.getProperty(.cached(runtime, "answer"))
+        }
+      }
+    }
+  }
+
+  @Test
+  func `object property by prebuilt PropNameID`() async throws {
+    try await benchmarkCase { runtime in
+      let object = try runtime.eval("({ answer: 42 })").getObject()
+      let propName = JavaScriptPropNameID(runtime, string: "answer")
+      try benchmark("JavaScriptObject.getProperty(_:): prebuilt PropNameID", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = object.getProperty(propName)
+        }
+      }
+      withExtendedLifetime(propName) {}
+    }
+  }
+}

package/apple/Benchmarks/UnownedDecodeBenchmarks.swift

@@ -0,0 +1,121 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+import ExpoModulesJSI
+import Foundation
+import Testing
+
+/// Decoding from a borrowed `JavaScriptUnownedValue`, the path a `@JS` argument takes, and from an owning
+/// `JavaScriptValue`, the path a nested value takes. A type without its own unowned decode copies the
+/// value into an owning `JavaScriptValue` first.
+extension JSIBenchmarks {
+  @Test
+  func `unowned decode of an array`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(in: runtime, with: try runtime.eval("[1, 2, 3, 4, 5, 6, 7, 8]"))
+      try benchmark("[Double].decode(unowned): 8 elements", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [Double].decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `unowned decode of a dictionary`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(in: runtime, with: try runtime.eval("({ a: 1, b: 2, c: 3, d: 4 })"))
+      try benchmark("[String: Double].decode(unowned): 4 entries", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [String: Double].decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `unowned decode of a date`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(in: runtime, with: try runtime.eval("1700000000000"))
+      try benchmark("Date.decode(unowned): number", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try Date.decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `owning decode of an array`() async throws {
+    try await benchmarkCase { runtime in
+      let value = try runtime.eval("[1, 2, 3, 4, 5, 6, 7, 8]")
+      try benchmark("[Double].decode(owning): 8 elements", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [Double].decode(value, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `owning decode of a dictionary`() async throws {
+    try await benchmarkCase { runtime in
+      let value = try runtime.eval("({ a: 1, b: 2, c: 3, d: 4 })")
+      try benchmark("[String: Double].decode(owning): 4 entries", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [String: Double].decode(value, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `owning decode of nested arrays`() async throws {
+    try await benchmarkCase { runtime in
+      let value = try runtime.eval("[[1, 2], [3, 4], [5, 6], [7, 8]]")
+      try benchmark("[[Double]].decode(owning): 4 x 2 elements", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [[Double]].decode(value, in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `unowned decode of nested arrays`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(
+        in: runtime,
+        with: try runtime.eval("[[1, 2], [3, 4], [5, 6], [7, 8]]")
+      )
+      try benchmark("[[Double]].decode(unowned): 4 x 2 elements", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try [[Double]].decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `unowned decode of a date string`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(in: runtime, with: try runtime.eval("'2026-10-02T12:00:00Z'"))
+      try benchmark("Date.decode(unowned): ISO string", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try Date.decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+
+  @Test
+  func `unowned decode of a date object`() async throws {
+    try await benchmarkCase { runtime in
+      let buffer = JavaScriptValuesBuffer.allocate(in: runtime, with: try runtime.eval("new Date(1700000000000)"))
+      try benchmark("Date.decode(unowned): Date object", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try Date.decode(buffer.unownedValue(at: 0), in: runtime)
+        }
+      }
+    }
+  }
+}