expo-modules-core 57.0.7 → 57.0.9

package/CHANGELOG.md

@@ -10,6 +10,25 @@
 
 ### 💡 Others
 
+## 57.0.9 — 2026-08-04
+
+### 🎉 New features
+
+- [iOS] Added module lifecycle hooks that replace the `OnCreate`, `OnDestroy`, `OnStartObserving` and `OnStopObserving` DSL components: `didCreate`, `willDestroy`, `didStartListening` and `didStopListening`. ([#47542](https://github.com/expo/expo/pull/47542) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Turn `getModule(implementing:)` into a public function. ([#47337](https://github.com/expo/expo/pull/47337) by [@Ubax](https://github.com/Ubax))
+
+### 🐛 Bug fixes
+
+- [Android] Fixed hosted Compose views missing layout after reattachment or in-place configuration changes. ([#48370](https://github.com/expo/expo/issues/48370) by [@lujjjh](https://github.com/lujjjh))
+- [iOS] Fixed infinite recursion and `EXC_BAD_ACCESS` when encoding native `Date` values to JavaScript. ([#48239](https://github.com/expo/expo/issues/48239), [#48240](https://github.com/expo/expo/pull/48240) by [@samuelcorsan](https://github.com/samuelcorsan))
+- [iOS] Fixed a stack overflow crash when converting to JavaScript a `Convertible` value that keeps the default `convertResult` implementation, such as `CMTime`. The value now converts to `undefined` and logs a warning. ([#48266](https://github.com/expo/expo/pull/48266) by [@tsapeta](https://github.com/tsapeta))
+
+## 57.0.8 — 2026-07-29
+
+### 🎉 New features
+
+- Added a `layoutRoot` prop to Expo views that marks the shadow node with the `RootNodeKind` trait, so `measure()` reports coordinates relative to that node — for views that dispatch touch events from their own root view, like `RNHostView` in `@expo/ui`. ([#48217](https://github.com/expo/expo/pull/48217) by [@intergalacticspacehighway](https://github.com/intergalacticspacehighway))
+
 ## 57.0.7 — 2026-07-22
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

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

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

@@ -2,6 +2,7 @@ package expo.modules.kotlin.views
 
 import android.annotation.SuppressLint
 import android.content.Context
+import android.content.res.Configuration
 import android.util.Log
 import android.view.View
 import android.view.ViewGroup
@@ -113,6 +114,15 @@ abstract class ExpoComposeView<T : ComposeProps>(
     }
   }
 
+  override fun dispatchConfigurationChanged(newConfig: Configuration) {
+    super.dispatchConfigurationChanged(newConfig)
+    // React Native owns this view's bounds and may not schedule another Android layout pass
+    // when a configuration change leaves its Yoga layout unchanged.
+    if (withHostingView && isAttachedToWindow && isLaidOut) {
+      requestLayout()
+    }
+  }
+
   /**
    * Validates that this non-hosting Compose view has a valid Compose parent.
    *
@@ -193,6 +203,15 @@ abstract class ExpoComposeView<T : ComposeProps>(
     if (withHostingView) {
       clipChildren = false
       clipToPadding = false
+      addOnAttachStateChangeListener(
+        OnAttachAfterDetachmentListener(
+          onAttachAfterDetachment = {
+            // Restore the Android layout pass after a real detach. The listener deliberately
+            // ignores the first attach and React Native's same-loop reparenting.
+            requestLayout()
+          }
+        )
+      )
       addComposeView()
     } else {
       this.visibility = GONE

package/common/cpp/fabric/ExpoViewShadowNode.h

@@ -69,6 +69,21 @@ private:
         this->traits_.unset(react::ShadowNodeTraits::Trait::ForceFlattenView);
       }
     }
+
+    {
+      // Views that dispatch touch events from their own root view (e.g. RNHostView) set
+      // `layoutRoot` so that `measure()` reports coordinates relative to this node instead of
+      // the surface root, matching the coordinate space of the dispatched touches. The same
+      // reason React Native's <Modal> shadow node sets this trait.
+      auto it = viewProps.propsMap.find("layoutRoot");
+      bool layoutRoot = (it != viewProps.propsMap.end()) && it->second.getBool();
+
+      if (layoutRoot) {
+        this->traits_.set(react::ShadowNodeTraits::Trait::RootNodeKind);
+      } else {
+        this->traits_.unset(react::ShadowNodeTraits::Trait::RootNodeKind);
+      }
+    }
   }
 };
 

package/ios/Core/Arguments/Convertibles.swift

@@ -169,4 +169,13 @@ extension Date: Convertible {
     }
     throw Conversions.ConvertingException<Date>(value)
   }
+
+  public static func convertResult(_ result: Any, appContext: AppContext) throws -> Any {
+    if let date = result as? Date {
+      let formatter = ISO8601DateFormatter()
+      formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+      return formatter.string(from: date)
+    }
+    return result
+  }
 }

package/ios/Core/DynamicTypes/DynamicConvertibleType.swift

@@ -101,7 +101,12 @@ internal struct DynamicConvertibleType: AnyDynamicType {
       return result
     }
     if let result = value as? AnyArgument {
-      return try type(of: result).getDynamicType().castToJS(result, appContext: appContext)
+      let dynamicType = type(of: result).getDynamicType()
+      // A `Convertible` that keeps the default `convertResult` returns the value unchanged,
+      // so redispatching it into the same dynamic type would recurse until the stack overflows.
+      if !dynamicType.equals(self) {
+        return try dynamicType.castToJS(result, appContext: appContext)
+      }
     }
     return try Conversions.unknownToJavaScriptValue(value, appContext: appContext)
   }

package/ios/Core/ModuleHolder.swift

@@ -1,8 +1,6 @@
 import ExpoModulesJSI
 
-/**
- Holds a reference to the module instance and caches its definition.
- */
+/// Holds a reference to the module instance and caches its definition.
 public final class ModuleHolder {
   /**
    Name of the module.
@@ -70,7 +68,8 @@ public final class ModuleHolder {
   private static func buildDefinition(for module: AnyModule) -> ModuleDefinition {
     let userDefinition = module.definition()
     let synthesized = module._synthesizedDefinition()
-    let definition = synthesized.isEmpty
+    let definition =
+      synthesized.isEmpty
       ? userDefinition
       : ModuleDefinition(definitions: synthesized + userDefinition.rawDefinitions)
 
@@ -141,6 +140,8 @@ public final class ModuleHolder {
       // (the direct-JSI path). A no-op for modules that don't use the macro.
       try module._decorateModule(object: object, in: appContext.runtime)
 
+      try installListeningHooks(on: object, in: appContext.runtime)
+
       return object
     } catch {
       log.error("Building the module object failed: \(error)")
@@ -171,9 +172,37 @@ public final class ModuleHolder {
   // MARK: Deallocation
 
   deinit {
+    module.willDestroy()
     post(event: .moduleDestroy)
   }
 
+  // MARK: - Privates
+
+  /// Installs host functions that the JavaScript `EventEmitter` implementation calls when
+  /// the number of listeners for an event switches between zero and non-zero. They notify
+  /// the module through the `didStartListening` and `didStopListening` lifecycle hooks.
+  @JavaScriptActor
+  private func installListeningHooks(on object: borrowing JavaScriptObject, in runtime: JavaScriptRuntime) {
+    let startListening = runtime.createFunction("__expo_onStartListeningToEvent") {
+      [weak module = self.module] _, arguments in
+      guard let module, arguments.count > 0 else {
+        return .undefined
+      }
+      module.didStartListening(event: try arguments[0].asString())
+      return .undefined
+    }
+    let stopListening = runtime.createFunction("__expo_onStopListeningToEvent") {
+      [weak module = self.module] _, arguments in
+      guard let module, arguments.count > 0 else {
+        return .undefined
+      }
+      module.didStopListening(event: try arguments[0].asString())
+      return .undefined
+    }
+    object.defineProperty("__expo_onStartListeningToEvent", value: startListening.asValue(), options: [])
+    object.defineProperty("__expo_onStopListeningToEvent", value: stopListening.asValue(), options: [])
+  }
+
   // MARK: - Exceptions
 
   internal class ModuleNotFoundException: GenericException<String> {

package/ios/Core/ModuleRegistry.swift

@@ -19,13 +19,21 @@ public final class ModuleRegistry: Sequence {
     if preventModuleOverriding {
       overrideDisallowModules.insert(holder.name)
     }
-    registry.withLock { registry in
+    let didRegister = registry.withLock { registry -> Bool in
       // if overriding is disallowed for this module and the module already registered, don't re-register
       if overrideDisallowModules.contains(holder.name) && registry[holder.name] != nil {
-        log.info("Not re-registering module '\(holder.name)' since a previous registration specified preventModuleOverriding: true")
-        return
+        log.info(
+          "Not re-registering module '\(holder.name)' since a previous registration specified preventModuleOverriding: true"
+        )
+        return false
       }
       registry[holder.name] = holder
+      return true
+    }
+    if didRegister {
+      // Call the `didCreate` lifecycle hook only after the holder is in the registry, so the module
+      // can already look itself up (e.g. through `withEventTarget`). Rejected registrations don't get it.
+      holder.module.didCreate()
     }
   }
 
@@ -37,7 +45,9 @@ public final class ModuleRegistry: Sequence {
       log.error("Unable to register a module '\(module)', the app context is unavailable")
       return
     }
-    register(holder: ModuleHolder(appContext: appContext, module: module, name: name), preventModuleOverriding: preventModuleOverriding)
+    register(
+      holder: ModuleHolder(appContext: appContext, module: module, name: name),
+      preventModuleOverriding: preventModuleOverriding)
   }
 
   /**
@@ -48,7 +58,8 @@ public final class ModuleRegistry: Sequence {
       log.error("Unable to register a module '\(moduleType)', the app context is unavailable")
       return
     }
-    register(module: moduleType.init(appContext: appContext), name: name, preventModuleOverriding: preventModuleOverriding)
+    register(
+      module: moduleType.init(appContext: appContext), name: name, preventModuleOverriding: preventModuleOverriding)
   }
 
   /**
@@ -98,7 +109,7 @@ public final class ModuleRegistry: Sequence {
     }
   }
 
-  internal func getModule<ModuleProtocol>(implementing protocol: ModuleProtocol.Type) -> ModuleProtocol? {
+  public func getModule<ModuleProtocol>(implementing protocol: ModuleProtocol.Type) -> ModuleProtocol? {
     return registry.withLock { registry in
       for holder in registry.values {
         if let module = holder.module as? ModuleProtocol {

package/ios/Core/Modules/Module.swift

@@ -2,15 +2,16 @@
 
 import ExpoModulesJSI
 
-/**
- `BaseModule` is just a stub class that fulfils `AnyModule` protocol requirement of public default initializer,
- but doesn't implement that protocol explicitly, though — it would have to provide a definition which would require
- other modules to use `override` keyword in the function returning the definition.
- */
+/// `BaseModule` is just a stub class that fulfils `AnyModule` protocol requirement of public default initializer,
+/// but doesn't implement that protocol explicitly, though — it would have to provide a definition which would require
+/// other modules to use `override` keyword in the function returning the definition.
 open class BaseModule {
   public private(set) weak var appContext: AppContext?
 
-  @available(*, unavailable, message: "Module's initializer cannot be overriden, use \"onCreate\" definition component instead.")
+  @available(
+    *, unavailable,
+    message: "Module's initializer cannot be overridden, override the \"didCreate\" lifecycle hook instead."
+  )
   public init() {}
 
   required public init(appContext: AppContext) {
@@ -23,6 +24,29 @@ open class BaseModule {
   public func sendEvent(_ eventName: String, _ body: [String: Any?] = [:]) {
     appContext?.eventEmitter?.sendEvent(withName: eventName, body: body)
   }
+
+  // MARK: - Lifecycle hooks
+
+  // No-op defaults for the `AnyModule` lifecycle hooks. They are declared here as `open`
+  // class methods rather than only as protocol-extension defaults, so that they dispatch
+  // dynamically: a subclass override is called even when the `Module` conformance comes
+  // from an ancestor that doesn't implement the hook itself.
+
+  /// A lifecycle hook that is called once the module is initialized and registered in the app context.
+  /// An equivalent of the `OnCreate` DSL component.
+  open func didCreate() {}
+
+  /// A lifecycle hook that is called when the module is about to be deallocated.
+  /// An equivalent of the `OnDestroy` DSL component.
+  open func willDestroy() {}
+
+  /// A lifecycle hook that is called when the first JavaScript listener for the given event is added.
+  /// An equivalent of the `OnStartObserving` DSL component.
+  open func didStartListening(event: String) {}
+
+  /// A lifecycle hook that is called when the last JavaScript listener for the given event is removed.
+  /// An equivalent of the `OnStopObserving` DSL component.
+  open func didStopListening(event: String) {}
 }
 
 extension BaseModule: EventEmitter {
@@ -40,7 +64,5 @@ extension BaseModule: EventEmitter {
   }
 }
 
-/**
- An alias for `AnyModule` extended by the `BaseModule` class that provides public default initializer.
- */
+/// An alias for `AnyModule` extended by the `BaseModule` class that provides public default initializer.
 public typealias Module = AnyModule & BaseModule

package/ios/Core/Protocols/AnyModule.swift

@@ -1,8 +1,6 @@
 import ExpoModulesJSI
 
-/**
- A protocol for any type-erased module that provides functions used by the core.
- */
+/// A protocol for any type-erased module that provides functions used by the core.
 public protocol AnyModule: AnyObject, AnyArgument {
   /**
    The default initializer. Must be public, but the module class does *not* need to
@@ -35,10 +33,26 @@ public protocol AnyModule: AnyObject, AnyArgument {
   /// (leading underscore). Modules that don't use the macro fall back to the default no-op.
   @JavaScriptActor
   func _decorateModule(object: borrowing JavaScriptObject, in runtime: JavaScriptRuntime) throws
+
+  /// A lifecycle hook that is called once the module is initialized and registered in the app context.
+  /// An equivalent of the `OnCreate` DSL component.
+  func didCreate()
+
+  /// A lifecycle hook that is called when the module is about to be deallocated.
+  /// An equivalent of the `OnDestroy` DSL component.
+  func willDestroy()
+
+  /// A lifecycle hook that is called when the first JavaScript listener for the given event is added.
+  /// An equivalent of the `OnStartObserving` DSL component.
+  func didStartListening(event: String)
+
+  /// A lifecycle hook that is called when the last JavaScript listener for the given event is removed.
+  /// An equivalent of the `OnStopObserving` DSL component.
+  func didStopListening(event: String)
 }
 
-public extension AnyModule {
-  static var _jsName: String {
+extension AnyModule {
+  public static var _jsName: String {
     return String(describing: self)
   }
 
@@ -46,14 +60,28 @@ public extension AnyModule {
   /// through `@JS` members don't have to write an empty `definition()` of their own. Modules that use
   /// the DSL provide their own.
   @ModuleDefinitionBuilder
-  func definition() -> ModuleDefinition {}
+  public func definition() -> ModuleDefinition {}
 
-  func _synthesizedDefinition() -> [AnyDefinition] {
+  public func _synthesizedDefinition() -> [AnyDefinition] {
     return []
   }
 
   @JavaScriptActor
-  func _decorateModule(object: borrowing JavaScriptObject, in runtime: JavaScriptRuntime) throws {
+  public func _decorateModule(object: borrowing JavaScriptObject, in runtime: JavaScriptRuntime) throws {
     // No-op by default — only `@ExpoModule`-macro modules synthesize a real implementation.
   }
+
+  // No-op defaults of the lifecycle hooks for modules that conform without inheriting
+  // `BaseModule`, e.g. plain `@ExpoModule` classes whose conformance comes from the macro's
+  // extension. These defaults are statically bound into the conformance witness, so
+  // `BaseModule` descendants are backed by its dynamically-dispatched open methods instead,
+  // which take precedence during witness resolution.
+
+  public func didCreate() {}
+
+  public func willDestroy() {}
+
+  public func didStartListening(event: String) {}
+
+  public func didStopListening(event: String) {}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-core",
-  "version": "57.0.7",
+  "version": "57.0.9",
   "description": "The core of Expo Modules architecture",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -66,7 +66,7 @@
     "@types/invariant": "^2.2.33",
     "expo-module-scripts": "56.0.3"
   },
-  "gitHead": "a4789f1e53353f4929b0baddcfe5a7c622b99c71",
+  "gitHead": "fb5049481ebd5cadd499c4d1f1d5e47f9ac678be",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",