expo-modules-core 56.0.8 → 56.0.9

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 56.0.9 — 2026-05-15
+
+### 🎉 New features
+
+- Added single-payload overloads for `SharedObject.emit` on iOS and Android. The iOS API also accepts an already-converted `JavaScriptValue` payload to skip the native-to-JS conversion step. ([#45596](https://github.com/expo/expo/pull/45596) by [@tsapeta](https://github.com/tsapeta))
+
 ## 56.0.8 — 2026-05-13
 
 ### 🐛 Bug fixes
@@ -28,6 +34,7 @@
 ### 💡 Others
 
 - [iOS] `AppContext.setRuntime` now takes the native React `RuntimeScheduler` pointer and a dispatch trampoline alongside the runtime pointer. ([#45636](https://github.com/expo/expo/pull/45636) by [@tsapeta](https://github.com/tsapeta))
+- Deprecated `SharedObject.emit(event:arguments:)` (iOS) and the `vararg` `emit` (Android) in favor of the new single-payload overloads. Existing single-argument call sites keep working unchanged. ([#45596](https://github.com/expo/expo/pull/45596) by [@tsapeta](https://github.com/tsapeta))
 
 ## 56.0.5 — 2026-05-08
 

package/android/build.gradle

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

package/android/src/main/cpp/decorators/JSPropertiesDecorator.h

@@ -1,5 +1,7 @@
 // Copyright © 2021-present 650 Industries, Inc. (aka Expo)
 
+#pragma once
+
 #include "../ExpoHeader.pch"
 
 #include "../MethodMetadata.h"

package/android/src/main/cpp/fabric/AndroidExpoViewState.h

@@ -1,3 +1,5 @@
+#pragma once
+
 #include "../ExpoHeader.pch"
 #include "ExpoViewState.h"
 

package/android/src/main/cpp/fabric/ExpoComponentDescriptorFactory.cpp

@@ -0,0 +1,31 @@
+// Copyright 2018-present 650 Industries. All rights reserved.
+
+#include "ExpoComponentDescriptorFactory.h"
+#include "AndroidExpoViewComponentDescriptor.h"
+
+namespace react = facebook::react;
+
+namespace expo {
+
+StatePropMapType statePropMap = {};
+
+react::ComponentDescriptor::Unique concreteExpoComponentDescriptorConstructor(
+  const react::ComponentDescriptorParameters &parameters
+) {
+  auto descriptor = std::make_unique<AndroidExpoViewComponentDescriptor>(
+    parameters,
+    react::RawPropsParser(/*useRawPropsJsiValue=*/true)
+  );
+
+  if (statePropMap.contains(std::static_pointer_cast<std::string const>(parameters.flavor))) {
+    descriptor->setStateProps(
+      statePropMap.at(
+        std::static_pointer_cast<std::string const>(parameters.flavor)
+      )
+    );
+  }
+
+  return descriptor;
+}
+
+} // namespace expo

package/android/src/main/cpp/fabric/ExpoComponentDescriptorFactory.h

@@ -0,0 +1,23 @@
+// Copyright 2018-present 650 Industries. All rights reserved.
+
+#pragma once
+
+#include <react/renderer/core/ComponentDescriptor.h>
+#include "../types/FrontendConverter.h"
+
+namespace react = facebook::react;
+
+namespace expo {
+
+using StatePropMapType = std::unordered_map<
+  react::ComponentDescriptor::Flavor,
+  std::unordered_map<std::string, std::shared_ptr<FrontendConverter>>
+>;
+
+extern StatePropMapType statePropMap;
+
+react::ComponentDescriptor::Unique concreteExpoComponentDescriptorConstructor(
+  const react::ComponentDescriptorParameters &parameters
+);
+
+} // namespace expo

package/android/src/main/cpp/fabric/FabricComponentsRegistry.cpp

@@ -1,38 +1,16 @@
 // Copyright 2018-present 650 Industries. All rights reserved.
 
 #include "FabricComponentsRegistry.h"
+#include "ExpoComponentDescriptorFactory.h"
 #include "../types/FrontendConverterProvider.h"
+#include <CoreComponentsRegistry.h>
+#include <react/renderer/componentregistry/ComponentDescriptorProvider.h>
 
 namespace jni = facebook::jni;
 namespace react = facebook::react;
 
 namespace expo {
 
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Wextern-initializer"
-// Clang think that we don't need to initialize the extern variable here, but we do.
-extern StatePropMapType statePropMap = {};
-#pragma clang diagnostic pop
-
-AndroidExpoViewComponentDescriptor::Unique concreteExpoComponentDescriptorConstructor(
-  const react::ComponentDescriptorParameters &parameters
-) {
-  auto descriptor = std::make_unique<AndroidExpoViewComponentDescriptor>(
-    parameters,
-    react::RawPropsParser(/*useRawPropsJsiValue=*/true)
-  );
-
-  if (statePropMap.contains(std::static_pointer_cast<std::string const>(parameters.flavor))) {
-    descriptor->setStateProps(
-      statePropMap.at(
-        std::static_pointer_cast<std::string const>(parameters.flavor)
-      )
-    );
-  }
-
-  return descriptor;
-}
-
 // static
 void FabricComponentsRegistry::registerNatives() {
   registerHybrid({

package/android/src/main/cpp/fabric/FabricComponentsRegistry.h

@@ -3,29 +3,12 @@
 #pragma once
 
 #include "../ExpoHeader.pch"
-#include <CoreComponentsRegistry.h>
-#include <react/renderer/componentregistry/ComponentDescriptorProvider.h>
-
 #include "../types/ExpectedType.h"
-#include "../types/FrontendConverter.h"
-#include "AndroidExpoViewComponentDescriptor.h"
 
 namespace jni = facebook::jni;
-namespace react = facebook::react;
 
 namespace expo {
 
-typedef std::unordered_map<
-  AndroidExpoViewComponentDescriptor::Flavor,
-  std::unordered_map<std::string, std::shared_ptr<FrontendConverter>>
-> StatePropMapType;
-
-extern StatePropMapType statePropMap;
-
-AndroidExpoViewComponentDescriptor::Unique concreteExpoComponentDescriptorConstructor(
-  const react::ComponentDescriptorParameters &parameters
-);
-
 class FabricComponentsRegistry : public jni::HybridClass<FabricComponentsRegistry> {
 public:
   static auto constexpr

package/android/src/main/java/expo/modules/kotlin/sharedobjects/SharedObject.kt

@@ -41,20 +41,42 @@ open class SharedObject(runtime: Runtime? = null) {
       )
   }
 
-  fun emit(eventName: String, vararg args: Any?) {
+  /**
+   * Emits an event with no payload to the associated JavaScript object.
+   */
+  fun emit(event: String) {
+    emitInternal(event, emptyArray())
+  }
+
+  /**
+   * Emits an event with a single payload to the associated JavaScript object.
+   */
+  fun emit(event: String, payload: Any?) {
+    emitInternal(event, arrayOf(payload))
+  }
+
+  @Deprecated(
+    "Multi-argument event emission is deprecated. Use `emit(event)` or `emit(event, payload)` and pass a single payload (typically a Map/Bundle) instead.",
+    ReplaceWith("emit(event, args)")
+  )
+  fun emit(event: String, vararg args: Any?) {
+    emitInternal(event, args)
+  }
+
+  private fun emitInternal(event: String, payload: Array<out Any?>) {
     val jsObject = getJavaScriptObject() ?: return
     val jniInterop = runtime?.jsiContext ?: return
     try {
       JNIUtils.emitEvent(
         jsObject,
         jniInterop,
-        eventName,
-        args
+        event,
+        payload
           .map { JSTypeConverterProvider.convertToJSValue(it, useExperimentalConverter = true) }
           .toTypedArray()
       )
     } catch (e: Throwable) {
-      logger.error("Unable to send event '$eventName' by shared object of type ${this::class.java.simpleName}", e)
+      logger.error("Unable to send event '$event' by shared object of type ${this::class.java.simpleName}", e)
     }
   }
 

package/ios/Core/ExpoModulesMacros.swift

@@ -1,8 +1,6 @@
-
-/**
- Declares macro signatures whose implementations are provided by the `@expo/expo-modules-macros-plugin` binary.
- Keep in sync with `@expo/expo-modules-macros-plugin/apple/Sources/ExpoModulesOptimized/ExpoModulesOptimized.swift`.
- */
+// Declares macro signatures whose implementations are provided by the `ExpoModulesMacros` compiler
+// plugin shipped in the `@expo/expo-modules-macros-plugin` package. Keep the `#externalMacro`
+// module/type names below in sync with the macro implementations in that package.
 
 // MARK: - Macro declarations
 
@@ -25,3 +23,64 @@
 @attached(peer, names: arbitrary)
 public macro OptimizedFunction() =
   #externalMacro(module: "ExpoModulesMacros", type: "OptimizedFunctionAttachedMacro")
+
+/// Marker macro applied to module / shared-object members that should be exposed to JavaScript.
+/// The accompanying `@ExpoModule` and `@SharedObject` macros discover `@JS`-marked declarations
+/// and generate the matching `Function` / `AsyncFunction` / `Property` / `Constructor` registrations.
+///
+/// Usage:
+///
+///     @JS
+///     func greet(name: String) -> String { ... }
+///
+///     @JS("doWork")
+///     func performWork() async throws { ... }
+///
+///     @JS
+///     var status: String { "ok" }
+@attached(peer)
+public macro JS(_ jsName: String? = nil) =
+  #externalMacro(module: "ExpoModulesMacros", type: "JSMacro")
+
+/// Member macro applied to a `Module` subclass. Scans the class body for declarations
+/// marked with `@JS` and synthesizes a framework-internal `_exposedDefinition()` method.
+/// `expo-modules-core` calls it automatically and merges the result into the module's
+/// definition, so the user doesn't have to reference it from `definition()`.
+///
+/// Usage:
+///
+///     @ExpoModule
+///     public final class MyModule: Module {
+///       public func definition() -> ModuleDefinition {
+///         Name("MyModule")
+///       }
+///
+///       @JS
+///       func greet(name: String) -> String { "Hi, \(name)" }
+///     }
+@attached(member, names: named(_exposedDefinition), named(appContext), named(init))
+public macro ExpoModule(_ name: String? = nil, classes: [Any.Type] = []) =
+  #externalMacro(module: "ExpoModulesMacros", type: "ExpoModuleMacro")
+
+/// Member macro applied to a `SharedObject` subclass. Scans the class body for declarations
+/// marked with `@JS` (including a single `@JS init(...)` for the JS constructor) and
+/// synthesizes a `_exposedClassDefinition()` static method returning a `ClassDefinition`.
+/// The companion `@ExpoModule(classes: [Foo.self])` wires the class into the module's
+/// exposed surface.
+///
+/// Usage:
+///
+///     @SharedObject
+///     final class Cache: SharedObject {
+///       @JS
+///       init(name: String) { self.name = name }
+///
+///       @JS
+///       func get(_ key: String) -> String? { ... }
+///
+///       @JS
+///       var size: Int { 42 }
+///     }
+@attached(member, names: named(_exposedClassDefinition))
+public macro SharedObject(_ name: String? = nil) =
+  #externalMacro(module: "ExpoModulesMacros", type: "SharedObjectMacro")

package/ios/Core/ModuleHolder.swift

@@ -46,10 +46,28 @@ public final class ModuleHolder {
     self.appContext = appContext
     self._name = name
     self.module = module
-    self.definition = module.definition()
+    self.definition = ModuleHolder.buildDefinition(for: module)
     post(event: .moduleCreate)
   }
 
+  /// Combines the user-authored definition with the entries synthesized by the
+  /// `@ExpoModule` macro on this module's class (if any). The macro emits a
+  /// `_exposedDefinition()` method returning an `[AnyDefinition]` array of the
+  /// `Function` / `Property` / `Constructor` entries it generated from `@JS`
+  /// members. Those entries are prepended to the user's definitions and the
+  /// whole list is fed back through `ModuleDefinition.init` so the merged
+  /// result is rebucketed (into `functions`, `properties`, etc.) just like a
+  /// hand-written definition. Modules that don't use the macro fall through
+  /// the empty-exposed fast path and return the user's definition unchanged.
+  private static func buildDefinition(for module: AnyModule) -> ModuleDefinition {
+    let userDefinition = module.definition()
+    let exposed = module._exposedDefinition()
+    if exposed.isEmpty {
+      return userDefinition
+    }
+    return ModuleDefinition(definitions: exposed + userDefinition.rawDefinitions)
+  }
+
   // MARK: Constants
 
   /**

package/ios/Core/Modules/ModuleDefinition.swift

@@ -29,10 +29,17 @@ public final class ModuleDefinition: ObjectDefinition {
 
   let eventObservers: [AnyEventObservingDefinition]
 
+  /// The raw list of definitions used to construct this module. Retained so
+  /// that `ModuleHolder` can merge in the entries synthesized by the
+  /// `@ExpoModule` macro without losing the user-authored ones.
+  let rawDefinitions: [AnyDefinition]
+
   /**
    Initializer that is called by the `ModuleDefinitionBuilder` results builder.
    */
   override init(definitions: [AnyDefinition]) {
+    self.rawDefinitions = definitions
+
     self.name = definitions
       .compactMap { $0 as? ModuleNameDefinition }
       .last?

package/ios/Core/Protocols/AnyModule.swift

@@ -14,4 +14,16 @@ public protocol AnyModule: AnyObject, AnyArgument {
    */
   @ModuleDefinitionBuilder
   func definition() -> ModuleDefinition
+
+  /// Returns definitions synthesized from `@JS`-annotated members by the `@ExpoModule` macro.
+  /// Framework-internal: the leading underscore signals this is not part of the public API and
+  /// should only be called by `expo-modules-core` itself. Modules that don't use the macro fall
+  /// back to the default empty implementation.
+  func _exposedDefinition() -> [AnyDefinition]
+}
+
+public extension AnyModule {
+  func _exposedDefinition() -> [AnyDefinition] {
+    return []
+  }
 }

package/ios/Core/SharedObjects/SharedObject.swift

@@ -66,66 +66,87 @@ open class SharedObject: AnySharedObject {
   public func getJavaScriptObject() -> JavaScriptObject? {
     return appContext?.sharedObjectRegistry.toJavaScriptObject(self)
   }
-}
 
-// Unfortunately the `emit` function needs to be defined in the extension.
-// When put in the class, pack expansion is crashing with `EXC_BAD_ACCESS` code.
-// See https://github.com/apple/swift/issues/72381 for more details.
-public extension SharedObject { // swiftlint:disable:this no_grouping_extension
-  // Parameter packs feature requires Swift 5.9 (Xcode 15.0), but some CIs and EAS images may still use older versions.
-  // As of April 29, all submissions must be made with Xcode 15, so hopefully we can remove this condition soon.
-  // No one should use <15.0 these days.
-  #if swift(>=5.9)
   /**
-   Schedules an event with the given name and arguments to be emitted to the associated JavaScript object.
+   Schedules an event with the given name and a pre-converted JavaScript payload to be emitted
+   to the associated JavaScript object. This is the lowest-level emit overload — use it when the
+   value is already a `JavaScriptValue` to skip the native-to-JS conversion step.
    */
-  func emit<each A: AnyArgument>(event: String, arguments: repeat each A) {
+  public func emit(event: String, payload: JavaScriptValue) {
     guard let appContext, let runtime = try? appContext.runtime else {
       log.warn("Trying to send event '\(event)' to \(type(of: self)), but the JS runtime has been lost")
       return
     }
+    guard let jsValue = getJavaScriptValue() else {
+      log.warn("Trying to send event '\(event)' to JS, but the JS object is no longer associated with the native instance")
+      return
+    }
+    runtime.schedule {
+      dispatch(event: event, payload: payload, to: jsValue, in: runtime)
+    }
+  }
 
-    // Collect arguments and their dynamic types from parameter pack
-    var argumentPairs: [(AnyArgument, AnyDynamicType)] = []
-    repeat argumentPairs.append((each arguments, ~(each A).self))
+  /**
+   Schedules an event with the given name to be emitted to the associated JavaScript object.
+   */
+  public func emit(event: String) {
+    emit(event: event, payload: .undefined)
+  }
 
-    // Schedule the event to be asynchronously emitted from the runtime's thread
-    runtime.schedule { [weak self, weak appContext] in
-      guard let appContext, let runtime = try? appContext.runtime, let jsValue = self?.getJavaScriptValue() else {
-        log.warn("Trying to send event '\(event)' to \(type(of: self)), but the JS object is no longer associated with the native instance")
+  /**
+   Schedules an event with the given name and payload to be emitted to the associated JavaScript object.
+   */
+  public func emit<P: AnyArgument>(event: String, payload: sending P) {
+    guard let appContext, let runtime = try? appContext.runtime else {
+      log.warn("Trying to send event '\(event)' to \(type(of: self)), but the JS runtime has been lost")
+      return
+    }
+    guard let jsValue = getJavaScriptValue() else {
+      log.warn("Trying to send event '\(event)' to JS, but the JS object is no longer associated with the native instance")
+      return
+    }
+    runtime.schedule { [weak appContext] in
+      guard let appContext else {
         return
       }
-
-      // Convert native arguments to JS, just like function results
-      let jsArguments: [JavaScriptValue]
       do {
-        jsArguments = try argumentPairs.map { argument, dynamicType in
-          try dynamicType.convertToJS(argument, appContext: appContext)
-        }
+        let jsPayload = try (~P.self).castToJS(payload, appContext: appContext, in: runtime)
+        dispatch(event: event, payload: jsPayload, to: jsValue, in: runtime)
       } catch {
-        log.warn("Failed to convert arguments for event '\(event)' on \(type(of: self)); the event will not be emitted: \(error)")
+        log.warn("Failed to convert payload for event '\(event)' on \(P.self); the event will not be emitted: \(error)")
         return
       }
+    }
+  }
 
-      let argumentsBuffer = JavaScriptValuesBuffer.copying(in: runtime, values: jsArguments)
-
-      runtime.withUnsafePointee { runtimePtr in
-        jsValue.withUnsafePointee { objectPtr in
-          JSUtils.emitEvent(
-            event,
-            runtimePointer: runtimePtr,
-            objectPointer: objectPtr,
-            argumentsPointer: argumentsBuffer.rawBaseAddress,
-            argumentCount: UInt(argumentsBuffer.count)
-          )
-        }
+  /**
+   Backwards-compatible overload that forwards to `emit(event:payload:)`. Existing single-argument
+   call sites keep working unchanged; the parameter has been renamed to `payload` to make the
+   single-payload semantics explicit, so callers should migrate the label.
+   */
+  @available(*, deprecated, renamed: "emit(event:payload:)", message: "Use `emit(event:payload:)` and pass a single value (typically a dictionary). Multi-argument event emission is no longer supported.")
+  public func emit<P: AnyArgument>(event: String, arguments: sending P) {
+    emit(event: event, payload: arguments)
+  }
+}
+
+/**
+ Sends a pre-converted event payload to the given JavaScript object via the JSI emitter helper.
+ Must run on the JS thread; the public `emit` overloads schedule onto the runtime before calling in.
+ */
+@JavaScriptActor
+private func dispatch(event: String, payload: JavaScriptValue, to value: JavaScriptValue, in runtime: JavaScriptRuntime) {
+  runtime.withUnsafePointee { runtimePtr in
+    value.withUnsafePointee { objectPtr in
+      payload.withUnsafePointee { payloadPtr in
+        JSUtils.emitEvent(
+          event,
+          runtimePointer: runtimePtr,
+          objectPointer: objectPtr,
+          argumentsPointer: payloadPtr,
+          argumentCount: 1
+        )
       }
     }
   }
-  #else // swift(>=5.9)
-  @available(*, unavailable, message: "Unavailable in Xcode <15.0")
-  public func emit(event: String, arguments: AnyArgument...) {
-    fatalError("Emitting events to JS requires at least Xcode 15.0")
-  }
-  #endif // swift(<5.9)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-core",
-  "version": "56.0.8",
+  "version": "56.0.9",
   "description": "The core of Expo Modules architecture",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -46,8 +46,8 @@
     "preset": "expo-module-scripts"
   },
   "dependencies": {
-    "@expo/expo-modules-macros-plugin": "~0.0.8",
-    "expo-modules-jsi": "~56.0.4",
+    "@expo/expo-modules-macros-plugin": "~0.0.9",
+    "expo-modules-jsi": "~56.0.5",
     "invariant": "^2.2.4"
   },
   "peerDependencies": {
@@ -66,7 +66,7 @@
     "@types/invariant": "^2.2.33",
     "expo-module-scripts": "56.0.2"
   },
-  "gitHead": "51c27fce31a5b3a877a4b05d832dabf4a99db5e1",
+  "gitHead": "f26be3dd9396bf7c399a1d607865d0fabdbc0d64",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",