expo-modules-core 56.0.14 → 56.0.15

package/CHANGELOG.md

@@ -10,6 +10,19 @@
 
 ### 💡 Others
 
+## 56.0.15 — 2026-06-05
+
+### 🐛 Bug fixes
+
+- [iOS] Propagate async-function promise construction 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))
+- [iOS] Read iPad-specific supported orientations from `UISupportedInterfaceOrientations~ipad`. ([#46281](https://github.com/expo/expo/issues/46281) by [@bryandent](https://github.com/bryandent)) ([#46306](https://github.com/expo/expo/pull/46306) by [@mvincentong](https://github.com/mvincentong))
+- [android] Fix nested `Host` double-composing children. ([#46304](https://github.com/expo/expo/pull/46304) by [@nishan](https://github.com/intergalacticspacehighway))
+- [iOS] Throw an actionable error when a worklet is used but `react-native-worklets`'s native adapter isn't linked, instead of a misleading "not an instance of Worklet" failure. ([#46571](https://github.com/expo/expo/pull/46571) by [@chrfalch](https://github.com/chrfalch))
+
+### 💡 Others
+
+- Native view config attributes now carry a `process` function that unwraps shared objects to their registry id, so callers can pass shared objects directly as view props instead of unwrapping them manually. ([#46212](https://github.com/expo/expo/pull/46212) by [@tsapeta](https://github.com/tsapeta))
+
 ## 56.0.14 — 2026-05-29
 
 _This version does not introduce any user-facing changes._
@@ -20,10 +33,6 @@ _This version does not introduce any user-facing changes._
 
 - [Android] Create Compose props without View. ([#46256](https://github.com/expo/expo/pull/46256) by [@jakex7](https://github.com/jakex7))
 
-### 💡 Others
-
-- Native view config attributes now carry a `process` function that unwraps shared objects to their registry id, so callers can pass shared objects directly as view props instead of unwrapping them manually. ([#46212](https://github.com/expo/expo/pull/46212) by [@tsapeta](https://github.com/tsapeta))
-
 ## 56.0.12 — 2026-05-21
 
 ### 🐛 Bug fixes

package/ExpoModulesCore.podspec

@@ -119,7 +119,7 @@ Pod::Spec.new do |s|
     s.static_framework = true
     s.header_dir     = 'ExpoModulesCore'
     s.source_files = 'ios/**/*.{h,m,mm,swift,cpp}', 'common/cpp/**/*.{h,cpp}'
-    s.exclude_files = ['ios/Tests', 'ios/Worklets', 'ios/WorkletsAdapter']
+    s.exclude_files = ['ios/Tests', 'ios/Worklets', 'ios/WorkletsTests', 'ios/WorkletsAdapter']
     s.compiler_flags = compiler_flags
     s.private_header_files = ['ios/**/*+Private.h', 'ios/**/Swift.h']
   end

package/ExpoModulesWorklets.podspec

@@ -31,4 +31,11 @@ Pod::Spec.new do |s|
 
   s.source_files = 'ios/Worklets/**/*.{h,m,mm,swift,cpp}'
   s.private_header_files = 'ios/Worklets/**/*+Private.h'
+
+  s.test_spec 'Tests' do |test_spec|
+    # ExpoModulesCore requires React-hermes or React-jsc in tests, add ExpoModulesTestCore for the underlying dependencies
+    test_spec.dependency 'ExpoModulesTestCore'
+
+    test_spec.source_files = 'ios/WorkletsTests/**/*.{m,swift}'
+  end
 end

package/android/build.gradle

@@ -27,7 +27,7 @@ if (shouldIncludeCompose) {
 }
 
 group = 'host.exp.exponent'
-version = '56.0.14'
+version = '56.0.15'
 
 def isExpoModulesCoreTests = {
   Gradle gradle = getGradle()
@@ -94,7 +94,7 @@ android {
   defaultConfig {
     consumerProguardFiles 'proguard-rules.pro'
     versionCode 1
-    versionName "56.0.14"
+    versionName "56.0.15"
     buildConfigField "String", "EXPO_MODULES_CORE_VERSION", "\"${versionName}\""
     buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", "true"
 

package/android/src/compose/expo/modules/kotlin/views/ExpoComposeView.kt

@@ -128,6 +128,8 @@ abstract class ExpoComposeView<T : ComposeProps>(
     recomposeScope = currentRecomposeScope
     for (index in 0..<this.size) {
       val child = getChildAt(index) as? ExpoComposeView<*> ?: continue
+      // Hosting children render themselves via their own ComposeView; skip to avoid double-rendering.
+      if (child.shouldUseAndroidLayout) continue
       key(child) {
         with(composableScope ?: ComposableScope()) {
           with(child) {
@@ -143,6 +145,7 @@ abstract class ExpoComposeView<T : ComposeProps>(
     recomposeScope = currentRecomposeScope
     for (index in 0..<this.size) {
       val child = getChildAt(index) as? ExpoComposeView<*> ?: continue
+      if (child.shouldUseAndroidLayout) continue
       if (!filter(child)) {
         continue
       }
@@ -160,6 +163,7 @@ abstract class ExpoComposeView<T : ComposeProps>(
   fun Child(composableScope: ComposableScope, index: Int) {
     recomposeScope = currentRecomposeScope
     val child = getChildAt(index) as? ExpoComposeView<*> ?: return
+    if (child.shouldUseAndroidLayout) return
     key(child) {
       with(composableScope) {
         with(child) {

package/ios/AppDelegates/ExpoAppDelegateSubscriberManager.swift

@@ -462,9 +462,7 @@ public class ExpoAppDelegateSubscriberManager: NSObject {
    */
   @objc
   public static func application(_ application: UIApplication, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask {
-    let deviceOrientationMask = allowedOrientations(for: UIDevice.current.userInterfaceIdiom)
-    let universalOrientationMask = allowedOrientations(for: .unspecified)
-    let infoPlistOrientations = deviceOrientationMask.isEmpty ? universalOrientationMask : deviceOrientationMask
+    let infoPlistOrientations = allowedOrientations(for: UIDevice.current.userInterfaceIdiom)
 
     let parsedSubscribers = ExpoAppDelegateSubscriberRepository.subscribers.filter {
       $0.responds(to: #selector(UIApplicationDelegate.application(_:supportedInterfaceOrientationsFor:)))
@@ -483,14 +481,28 @@ public class ExpoAppDelegateSubscriberManager: NSObject {
 }
 
 #if os(iOS)
-private func allowedOrientations(for userInterfaceIdiom: UIUserInterfaceIdiom) -> UIInterfaceOrientationMask {
-  // For now only iPad-specific orientations are supported
-  let deviceString = userInterfaceIdiom == .pad ? "~pad" : ""
-  var mask: UIInterfaceOrientationMask = []
-  guard let orientations = Bundle.main.infoDictionary?["UISupportedInterfaceOrientations\(deviceString)"] as? [String] else {
+func allowedOrientations(
+  for userInterfaceIdiom: UIUserInterfaceIdiom,
+  infoDictionary: [String: Any]? = Bundle.main.infoDictionary
+) -> UIInterfaceOrientationMask {
+  // For now only iPad-specific orientations are supported. When the `~ipad` key is absent,
+  // fall back to the universal `UISupportedInterfaceOrientations` key, matching how UIKit
+  // resolves device-specific keys. We additionally fall back when `~ipad` is present but
+  // resolves to no orientations, treating a malformed entry as if it were absent.
+  if userInterfaceIdiom == .pad,
+    let mask = orientationMask(forKey: "UISupportedInterfaceOrientations~ipad", in: infoDictionary),
+    !mask.isEmpty {
     return mask
   }
+  return orientationMask(forKey: "UISupportedInterfaceOrientations", in: infoDictionary) ?? []
+}
 
+private func orientationMask(forKey key: String, in infoDictionary: [String: Any]?) -> UIInterfaceOrientationMask? {
+  guard let orientations = infoDictionary?[key] as? [String] else {
+    return nil
+  }
+
+  var mask: UIInterfaceOrientationMask = []
   for orientation in orientations {
     switch orientation {
     case "UIInterfaceOrientationPortrait":

package/ios/Core/AppContext.swift

@@ -529,8 +529,8 @@ public final class AppContext: NSObject, EXAppContextProtocol, @unchecked Sendab
    */
   @JavaScriptActor
   private func installModuleClasses(in runtime: JavaScriptRuntime) throws {
-    let coreObject = runtime.global().getPropertyAsObject(EXGlobalCoreObjectPropertyName)
-    let sharedObjectClass = coreObject.getPropertyAsObject("SharedObject")
+    let coreObject = try runtime.global().getPropertyAsObject(EXGlobalCoreObjectPropertyName)
+    let sharedObjectClass = try coreObject.getPropertyAsObject("SharedObject")
     let sharedObjectBaseProto = sharedObjectClass.getProperty("prototype")
 
     // Stored as JavaScriptValue (a class) because JavaScriptObject is ~Copyable

package/ios/Core/Conversions.swift

@@ -218,7 +218,7 @@ public struct Conversions {
         memcpy(arrayBuffer.data(), baseAddress, data.count)
       }
     }
-    let uint8ArrayCtor = runtime.global().getPropertyAsFunction("Uint8Array")
+    let uint8ArrayCtor = try runtime.global().getPropertyAsFunction("Uint8Array")
     return try uint8ArrayCtor.callAsConstructor(arrayBuffer.asValue())
   }
 

package/ios/Core/DynamicTypes/DynamicSharedObjectType.swift

@@ -95,7 +95,7 @@ private func getBaseSharedType(_ appContext: AppContext, nativeType: AnySharedOb
 
 private func newBaseSharedObject(_ appContext: AppContext, nativeType: AnySharedObject.Type) throws -> JavaScriptObject? {
   let jsClass = try getBaseSharedType(appContext, nativeType: nativeType)
-  let prototype = jsClass.asObject().getPropertyAsObject("prototype")
+  let prototype = try jsClass.asObject().getPropertyAsObject("prototype")
   return try appContext.runtime.createObject(prototype: prototype)
 }
 

package/ios/Core/Functions/AsyncFunctionDefinition.swift

@@ -186,7 +186,7 @@ public class AsyncFunctionDefinition<Args, FirstArgType, ReturnType>: AnyAsyncFu
       guard let appContext else {
         throw Exceptions.AppContextLost()
       }
-      let promise = JavaScriptPromise(try appContext.runtime)
+      let promise = try JavaScriptPromise(appContext.runtime)
       let promiseValue = promise.asValue()
 
       self.call(appContext, this: this, arguments: arguments) { [promise] result in
@@ -209,5 +209,3 @@ public class AsyncFunctionDefinition<Args, FirstArgType, ReturnType>: AnyAsyncFu
     return self
   }
 }
-
-

package/ios/JS/ExpoRuntimeInstaller.swift

@@ -30,7 +30,7 @@ internal class ExpoRuntimeInstaller: EXJavaScriptRuntimeManager {
    */
   @JavaScriptActor
   internal func installExpoModulesHostObject() throws {
-    let coreObject = runtime.global().getPropertyAsObject(EXGlobalCoreObjectPropertyName)
+    let coreObject = try runtime.global().getPropertyAsObject(EXGlobalCoreObjectPropertyName)
 
     if coreObject.hasProperty("modules") {
       // Host object already installed

package/ios/Platform/Platform.h

@@ -16,6 +16,7 @@
 @compatibility_alias UIWindow NSWindow;
 @compatibility_alias UIHostingController NSHostingController;
 @compatibility_alias UIImage NSImage;
+@compatibility_alias UIImageView NSImageView;
 
 #ifndef UIApplication
 @compatibility_alias UIApplication NSApplication;

package/ios/Platform/Platform.swift

@@ -14,6 +14,7 @@ public typealias UIHostingController = NSHostingController
 public typealias UIViewRepresentable = NSViewRepresentable
 public typealias UILabel = NSLabel
 public typealias UIImage = NSImage
+public typealias UIImageView = NSImageView
 public typealias UIPasteboard = NSPasteboard
 
 extension UIApplication {

package/ios/Worklets/Core/DynamicSerializableType.swift

@@ -28,6 +28,10 @@ internal struct DynamicSerializableType: AnyDynamicType {
       }
     }
     guard let jsSerializable else {
+      // Adapter not linked → the extractor returns nil for every value; give an actionable error.
+      if WorkletsProviderRegistry.shared == nil {
+        throw WorkletsNotInstalledException()
+      }
       throw NotSerializableException(innerType)
     }
     return Serializable(jsSerializable)

package/ios/Worklets/Core/Worklet.swift

@@ -46,3 +46,13 @@ internal final class NotWorkletException: GenericException<SerializableValueType
     "Expected Serializable of type Worklet but got \(param)"
   }
 }
+
+/// Thrown when a worklet operation is attempted but the `react-native-worklets` native
+/// adapter isn't linked (its provider is `nil`). Replaces misleading lower-level errors.
+internal final class WorkletsNotInstalledException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "This feature requires `react-native-worklets`, but its native adapter isn't linked — usually " +
+    "because the package isn't installed (it's an optional peer dependency of libraries like Expo UI " +
+    "and Reanimated). Install it with `npx expo install react-native-worklets`, then rebuild the app."
+  }
+}

package/ios/WorkletsTests/WorkletRuntimeIntegrationTests.swift

@@ -0,0 +1,27 @@
+// Copyright 2025-present 650 Industries. All rights reserved.
+
+import Testing
+
+import ExpoModulesCore
+import ExpoModulesWorklets
+
+/**
+ Runtime-level checks for the worklets integration wiring.
+
+ Note: these run under `use_expo_modules_tests!`, which does not link companion pods, so the
+ worklets adapter — and therefore `WorkletsProviderRegistry.shared` — is intentionally absent
+ here (the same state as an app without `react-native-worklets`). Whether the adapter is
+ correctly autolinked is guarded by the JS test `WorkletsAdapterAutolinking-test.ts`; the
+ consumer-side behaviour when it's missing is covered by `WorkletsNotInstalledTests`.
+ */
+@Suite("WorkletRuntimeIntegration", .serialized)
+struct WorkletRuntimeIntegrationTests {
+  @Test
+  func `UI worklet runtime factory registers on the app context`() {
+    // `WorkletIntegration.register()` installs the core-side hook (normally invoked via +load)
+    // that turns a worklet runtime pointer into a usable runtime. Guards the factory wiring onto
+    // AppContext; it does not require the adapter to be linked.
+    WorkletIntegration.register()
+    #expect(AppContext.uiRuntimeFactory != nil)
+  }
+}

package/ios/WorkletsTests/WorkletsNotInstalledTests.swift

@@ -0,0 +1,33 @@
+// Copyright 2025-present 650 Industries. All rights reserved.
+
+import Testing
+
+@testable import ExpoModulesCore
+@testable import ExpoModulesWorklets
+
+/**
+ The `use_expo_modules_tests!` harness does not link companion pods, so the worklets adapter
+ never registers `WorkletsProviderRegistry.shared`. That nil-provider state is exactly an app
+ where `react-native-worklets` isn't installed — so this is the right place to assert that a
+ worklet operation fails with the actionable `WorkletsNotInstalledException` rather than a
+ misleading lower-level error (e.g. "not an instance of Worklet").
+ */
+@Suite("WorkletsNotInstalled", .serialized)
+@JavaScriptActor
+struct WorkletsNotInstalledTests {
+  @Test
+  func `converting a worklet argument reports that worklets are not installed`() throws {
+    // Only meaningful while the adapter is unlinked (the default in this test harness).
+    try #require(WorkletsProviderRegistry.shared == nil)
+
+    let appContext = AppContext.create()
+    let runtime = try appContext.runtime
+    // Any JS value works — with the adapter unlinked, extraction returns nil for everything.
+    let jsValue = try runtime.eval("42")
+    let dynamicType = DynamicSerializableType(innerType: Worklet.self)
+
+    #expect(throws: WorkletsNotInstalledException.self) {
+      _ = try dynamicType.cast(jsValue: jsValue, appContext: appContext)
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-core",
-  "version": "56.0.14",
+  "version": "56.0.15",
   "description": "The core of Expo Modules architecture",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "dependencies": {
     "@expo/expo-modules-macros-plugin": "~0.0.9",
-    "expo-modules-jsi": "~56.0.7",
+    "expo-modules-jsi": "~56.0.8",
     "invariant": "^2.2.4"
   },
   "peerDependencies": {
@@ -64,9 +64,9 @@
     "@testing-library/react-native": "^13.3.0",
     "@types/react": "~19.2.0",
     "@types/invariant": "^2.2.33",
-    "expo-module-scripts": "56.0.2"
+    "expo-module-scripts": "56.0.3"
   },
-  "gitHead": "a7adc95c1747db1e92655feba56d0e62660098db",
+  "gitHead": "175f1e78e3444ca99ddea473faea6777a0656668",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/spm.config.json

@@ -46,6 +46,7 @@
           "headerPattern": "**/*.h",
           "exclude": [
             "Tests/**",
+            "WorkletsTests/**",
             "Worklets/**",
             "WorkletsAdapter/**"
           ],
@@ -87,6 +88,7 @@
           "exclude": [
             "JSI/**",
             "Tests/**",
+            "WorkletsTests/**",
             "BridgeModule/**",
             "Views/**",
             "Worklets/**",