expo-modules-core 3.0.23 → 3.0.24

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 3.0.24 — 2025-11-03
+
+### 🎉 New features
+
+- [iOS] Added `subscriberDidRegister` function to AppDelegate subscribers. ([#40684](https://github.com/expo/expo/pull/40684) by [@tsapeta](https://github.com/tsapeta))
+
+### 🐛 Bug fixes
+
+- [iOS] Fix `Either` conversion in `Record` ([#40655](https://github.com/expo/expo/pull/40655) by [@vonovak](https://github.com/vonovak))
+
 ## 3.0.23 — 2025-10-28
 
 ### 🎉 New features
@@ -25,6 +35,7 @@
 ### 💡 Others
 
 - [iOS] Removed some runtime type checks for dynamic types. ([#40611](https://github.com/expo/expo/pull/40611) by [@tsapeta](https://github.com/tsapeta))
+- [iOS] Added base props support for SwiftUI integration. ([#40492](https://github.com/expo/expo/pull/40492) by [@kudo](https://github.com/kudo))
 
 ## 3.0.22 — 2025-10-20
 

package/android/build.gradle

@@ -29,7 +29,7 @@ if (shouldIncludeCompose) {
 }
 
 group = 'host.exp.exponent'
-version = '3.0.23'
+version = '3.0.24'
 
 def isExpoModulesCoreTests = {
   Gradle gradle = getGradle()
@@ -79,7 +79,7 @@ android {
   defaultConfig {
     consumerProguardFiles 'proguard-rules.pro'
     versionCode 1
-    versionName "3.0.23"
+    versionName "3.0.24"
     buildConfigField "String", "EXPO_MODULES_CORE_VERSION", "\"${versionName}\""
     buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled.toString()
 

package/ios/Api/Builders/ViewDefinitionBuilder.swift

@@ -15,7 +15,7 @@ public struct ViewDefinitionBuilder<ViewType: UIView> {
   }
 
   /**
-   Accepts `Events` definition element of `View`.
+   Accepts `ViewName` definition element of `View`.
    */
   public static func buildExpression(_ element: ViewNameDefinition) -> AnyViewDefinitionElement {
     return element

package/ios/AppDelegates/ExpoAppDelegateSubscriber.swift

@@ -24,6 +24,14 @@ open class BaseExpoAppDelegateSubscriber: UIResponder {
 @objc(EXAppDelegateSubscriberProtocol)
 public protocol ExpoAppDelegateSubscriberProtocol: UIApplicationDelegate {
   @objc optional func customizeRootView(_ rootView: UIView)
+
+  /**
+   Function that is called automatically by the `ExpoAppDelegate` once the subscriber is successfully registered.
+   If the subscriber is loaded from the modules provider, it is executed just before the main code of the app,
+   thus even before any other `UIApplicationDelegate` function. Use it if your subscriber needs to run some code as early as possible,
+   but keep in mind that this affects the application loading time.
+   */
+  @objc optional func subscriberDidRegister()
 }
 
 /**

package/ios/AppDelegates/ExpoAppDelegateSubscriberRepository.swift

@@ -32,6 +32,7 @@ public class ExpoAppDelegateSubscriberRepository: NSObject {
       fatalError("Given app delegate subscriber `\(String(describing: subscriber))` is already registered.")
     }
     _subscribers.append(subscriber)
+    subscriber.subscriberDidRegister?()
   }
 
   @objc

package/ios/Core/Arguments/Either.swift

@@ -15,6 +15,11 @@ protocol AnyEither: AnyArgument {
    A dynamic either type for the current either type.
    */
   static func getDynamicType() -> any AnyDynamicType
+
+  /**
+   The underlying type-erased value.
+   */
+  var value: Any? { get }
 }
 
 /*

package/ios/Core/DynamicTypes/DynamicEitherType.swift

@@ -40,6 +40,23 @@ internal struct DynamicEitherType<EitherType: AnyEither>: AnyDynamicType {
     throw NeitherTypeException(types)
   }
 
+  func convertResult<ResultType>(_ result: ResultType, appContext: AppContext) throws -> Any {
+    guard let either = result as? EitherType else {
+      throw Conversions.CastingException<EitherType>(result)
+    }
+
+    let types = eitherType.dynamicTypes()
+
+    // Try each type - one should succeed
+    for type in types {
+      if let converted = try? type.convertResult(either.value, appContext: appContext) {
+        return converted
+      }
+    }
+
+    throw NeitherTypeException(types)
+  }
+
   var description: String {
     let types = eitherType.dynamicTypes()
     return "Either<\(types.map(\.description).joined(separator: ", "))>"

package/ios/Core/Records/Record.swift

@@ -68,12 +68,25 @@ public extension Record {
   }
 }
 
+/**
+ Recursively collects all children from a Mirror, including inherited properties from superclasses.
+ */
+internal func allMirrorChildren(_ mirror: Mirror) -> [Mirror.Child] {
+  var children: [Mirror.Child] = Array(mirror.children)
+  if let superclassMirror = mirror.superclassMirror {
+    children.append(contentsOf: allMirrorChildren(superclassMirror))
+  }
+  return children
+}
+
 /**
  Returns an array of fields found in record's mirror. If the field is missing the `key`,
  it gets assigned to the property label, so after all it's safe to enforce unwrapping it (using `key!`).
+ This function now supports inheritance by recursively traversing the superclass hierarchy.
  */
 internal func fieldsOf(_ record: Record) -> [AnyFieldInternal] {
-  return Mirror(reflecting: record).children.compactMap { (label: String?, value: Any) in
+  let mirror = Mirror(reflecting: record)
+  return allMirrorChildren(mirror).compactMap { (label: String?, value: Any) in
     guard var field = value as? AnyFieldInternal, let key = field.key ?? convertLabelToKey(label) else {
       return nil
     }

package/ios/Core/Views/SwiftUI/SwiftUIViewDefinition.swift

@@ -113,7 +113,7 @@ extension ExpoSwiftUI {
     }
 
     public override func getSupportedPropNames() -> [String] {
-      return dummyPropsMirror.children.compactMap { (label: String?, value: Any) in
+      return allMirrorChildren(dummyPropsMirror).compactMap { (label: String?, value: Any) in
         guard let field = value as? AnyFieldInternal else {
           return nil
         }
@@ -122,14 +122,13 @@ extension ExpoSwiftUI {
     }
 
     public override func getSupportedEventNames() -> [String] {
-      let builtInEventNames = [GLOBAL_EVENT_NAME]
-      let propEventNames: [String] = dummyPropsMirror.children.compactMap { (label: String?, value: Any) in
+      let propEventNames: [String] = allMirrorChildren(dummyPropsMirror).compactMap { (label: String?, value: Any) in
         guard let event = value as? EventDispatcher else {
           return nil
         }
         return event.customName ?? convertLabelToKey(label)
       }
-      return builtInEventNames + propEventNames
+      return propEventNames
     }
   }
 }

package/ios/Core/Views/SwiftUI/SwiftUIViewDefinitionBuilder.swift

@@ -10,6 +10,13 @@ extension ExpoSwiftUI {
       return elements
     }
 
+    /**
+     Accepts `ViewName` definition element of `View`.
+     */
+    public static func buildExpression(_ element: ViewNameDefinition) -> AnyViewDefinitionElement {
+      return element
+    }
+
     /**
      Accepts functions as a view definition elements.
      */

package/ios/Core/Views/SwiftUI/SwiftUIViewProps.swift

@@ -15,7 +15,7 @@ extension ExpoSwiftUI {
     /**
      An array of views passed by React as children.
      */
-    @Field public var children: [any AnyChild]?
+    public var children: [any AnyChild]?
 
     public internal(set) weak var appContext: AppContext?
 
@@ -37,7 +37,8 @@ extension ExpoSwiftUI {
         dispatcher(GLOBAL_EVENT_NAME, payload)
       }
 
-      Mirror(reflecting: self).children.forEach { (label: String?, value: Any) in
+      let mirror = Mirror(reflecting: self)
+      allMirrorChildren(mirror).forEach { (label: String?, value: Any) in
         guard let event = value as? EventDispatcher else {
           return
         }

package/ios/Tests/FunctionSpec.swift

@@ -334,6 +334,10 @@ class FunctionSpec: ExpoSpec {
             p.resolve(SharedString("Test with Promise"))
           }
 
+          Function("withEither") { (either: Either<Bool, String>) in
+            return either
+          }
+
           AsyncFunction("withURLAsync") {
             return TestURLRecord.defaultURL
           }
@@ -504,7 +508,17 @@ class FunctionSpec: ExpoSpec {
         expect(result.kind) == .string
         expect(result.getString()) == "Test with Promise"
       }
-      
+
+      it("accepts and returns Either value") {
+        let stringResult = try runtime.eval("expo.modules.TestModule.withEither('test string')")
+        expect(stringResult.kind) == .string
+        expect(stringResult.getString()) == "test string"
+
+        let boolResult = try runtime.eval("expo.modules.TestModule.withEither(true)")
+        expect(boolResult.kind) == .bool
+        expect(boolResult.getBool()) == true
+      }
+
       // For async tests, this is a safe way to repeatedly evaluate JS
       // and catch both Swift and ObjC exceptions
       func safeBoolEval(_ js: String) -> Bool {

package/ios/Tests/RecordSpec.swift

@@ -45,6 +45,31 @@ class RecordSpec: ExpoSpec {
       expect(record.toDictionary()["b"] as? Int).to(equal(dict["b"]! as! Int))
     }
 
+    it("works back and forth with Either") {
+      struct TestRecord: Record {
+        @Field var stringValue: Either<Bool, String>?
+        @Field var boolValue: Either<Bool, String>?
+        @Field var intValue: Either<Int, String>?
+        @Field var nilValue: Either<Int, String>?
+      }
+      let dict: [String: Any] = [
+        "stringValue": "custom",
+        "boolValue": true,
+        "intValue": 42,
+      ]
+      let record = try TestRecord(from: dict, appContext: appContext)
+      expect(record.stringValue?.get() as String?).to(equal("custom"))
+      expect(record.boolValue?.get() as Bool?).to(equal(true))
+      expect(record.intValue?.get() as Int?).to(equal(42))
+      expect(record.nilValue).to(beNil())
+
+      let asDict = record.toDictionary(appContext: appContext)
+      expect(asDict["stringValue"] as? String).to(equal("custom"))
+      expect(asDict["boolValue"] as? Bool).to(equal(true))
+      expect(asDict["intValue"] as? Int).to(equal(42))
+      expect(asDict["nilValue"] as? Int).to(beNil())
+    }
+
     it("works back and forth with a keyed field") {
       struct TestRecord: Record {
         @Field("key") var a: String?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-core",
-  "version": "3.0.23",
+  "version": "3.0.24",
   "description": "The core of Expo Modules architecture",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -65,5 +65,5 @@
     "@testing-library/react-native": "^13.2.0",
     "expo-module-scripts": "^5.0.7"
   },
-  "gitHead": "f1475b7bd0e8fdec0c0027be89c4c8d650d10805"
+  "gitHead": "1bba12a43e14a442f2cf1c73fe21968e0ef097c1"
 }