react-native-worklets 0.11.1 → 0.12.0-nightly-20260717-55ef079be

package/src/WorkletsModule/NativeWorklets.native.ts

@@ -270,14 +270,16 @@ See https://docs.swmansion.com/react-native-worklets/docs/guides/troubleshooting
     initializer: SerializableRef<() => void>,
     useDefaultQueue: boolean,
     customQueue: object | undefined,
-    enableEventLoop: boolean
+    enableEventLoop: boolean,
+    enableLocking: boolean
   ) {
     return this.#workletsModuleProxy.createWorkletRuntime(
       name,
       initializer,
       useDefaultQueue,
       customQueue,
-      enableEventLoop
+      enableEventLoop,
+      enableLocking
     );
   }
 

package/src/WorkletsModule/workletsModuleProxy.ts

@@ -160,7 +160,8 @@ export interface WorkletsModuleProxy {
     initializer: SerializableRef<() => void>,
     useDefaultQueue: boolean,
     customQueue: object | undefined,
-    enableEventLoop: boolean
+    enableEventLoop: boolean,
+    enableLocking: boolean
   ): WorkletRuntime;
 
   scheduleOnRuntime<TValue>(

package/src/debug/jsVersion.ts

@@ -5,4 +5,4 @@
  * version used to build the native part of the library in runtime. Remember to
  * keep this in sync with the version declared in `package.json`
  */
-export const jsVersion = '0.11.1';
+export const jsVersion = '0.12.0-nightly-20260717-55ef079be';

package/src/memory/serializable.native.ts

@@ -210,8 +210,12 @@ export function createSerializable<TValue>(
       return cloneCustom(value, pack, i) as SerializableRef<TValue>;
     }
   }
-
-  return cloneUndefined() as SerializableRef<TValue>;
+  const constructorName =
+    (value as { constructor?: { name?: string } })?.constructor?.name ||
+    'unknown';
+  throw new Error(
+    `[Worklets] Cannot copy value of type \`${constructorName}\`.`
+  );
 }
 
 if (isBundleModeEnabled()) {

package/src/runtimes.native.ts

@@ -81,6 +81,7 @@ export function createWorkletRuntime(
   let queue: 'default' | object | null = 'default';
   let animationQueuePollingRate: number;
   let enableEventLoop = true;
+  let enableLocking = true;
   if (typeof nameOrConfig === 'string') {
     name = nameOrConfig;
     initializerFn = initializer;
@@ -96,7 +97,15 @@ export function createWorkletRuntime(
     animationQueuePollingRate = Math.round(
       nameOrConfig?.animationQueuePollingRate ?? 16
     );
-    enableEventLoop = nameOrConfig?.enableEventLoop ?? true;
+    enableLocking = nameOrConfig?.enableLocking ?? true;
+    if (__DEV__ && !enableLocking && nameOrConfig?.enableEventLoop) {
+      throw new Error(
+        '[Worklets] The Event Loop cannot be enabled on a runtime with locking disabled.'
+      );
+    }
+    enableEventLoop = enableLocking
+      ? (nameOrConfig?.enableEventLoop ?? true)
+      : false;
   }
 
   const useDefaultQueue = queue === 'default';
@@ -126,7 +135,8 @@ export function createWorkletRuntime(
     }),
     useDefaultQueue,
     customQueue,
-    enableEventLoop
+    enableEventLoop,
+    enableLocking
   );
 }
 

package/src/types.ts

@@ -121,18 +121,52 @@ type WorkletRuntimeConfigBase = {
    * by requestAnimationFrame. If not specified, it defaults to 16 ms.
    */
   animationQueuePollingRate?: number;
-  /**
-   * Determines whether to enable the default Event Loop or not. The Event Loop
-   * provides implementations for `setTimeout`, `setImmediate`, `setInterval`,
-   * `requestAnimationFrame`, `queueMicrotask`, `clearTimeout`, `clearInterval`,
-   * `clearImmediate`, and `cancelAnimationFrame` methods. If not specified, it
-   * defaults to `true`.
-   */
-  enableEventLoop?: boolean;
 };
 
 /** Configuration object for creating a worklet runtime. */
 export type WorkletRuntimeConfig = WorkletRuntimeConfigBase &
+  (
+    | {
+        /**
+         * Determines whether to enable the default Event Loop, which provides
+         * `setTimeout`, `setInterval`, `requestAnimationFrame` and other
+         * scheduling APIs. If not specified, it defaults to `true`. Cannot be
+         * enabled when {@link enableLocking} is set to `false`.
+         */
+        enableEventLoop?: boolean;
+        /**
+         * Determines whether access to the underlying JS runtime is
+         * synchronized with a mutex around every JSI operation. If not
+         * specified, it defaults to `true`. Can be disabled only together
+         * with the Event Loop.
+         *
+         * Runtime without locking doesn't receive HMR updates
+         * and new Custom Serializable registrations.
+         *
+         * Disable only when you can guarantee thread safety of all access to the runtime.
+         */
+        enableLocking?: true;
+      }
+    | {
+        /**
+         * The Event Loop cannot be enabled on a runtime with
+         * {@link enableLocking} set to `false`.
+         */
+        enableEventLoop?: false;
+        /**
+         * Determines whether access to the underlying JS runtime is
+         * synchronized with a mutex around every JSI operation. If not
+         * specified, it defaults to `true`. Can be disabled only together
+         * with the Event Loop.
+         *
+         * Runtime without locking doesn't receive HMR updates
+         * and new Custom Serializable registrations.
+         *
+         * Disable only when you can guarantee thread safety of all access to the runtime.
+         */
+        enableLocking: false;
+      }
+  ) &
   (
     | {
         /**