React Native Reanimated Files

Key changes

WeakRef on Worklet Runtimes

Worklet Runtimes now support WeakRef. This required enabling Hermes' own microtask queue when the runtime is created, and draining it from C++.

• feat(Worklets): WeakRef on Worklet Runtimes by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10085
• refactor(worklets): consolidate scheduling API for microtask policies by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10100
• refactor(Worklets): move microtasks call to C++ by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10175

Bundle Mode script loading on par with React Native

Bundle Mode used to load the script through in-memory copies. On iOS the whole bundle stayed resident in a std::string for the app's lifetime, and on Android a dev-server bundle passed through a Java String and two more copies over JNI. Local bundles are now mmapped and Android dev-server downloads stream to a cache file, the same way React Native's own loaders work. Dev-server fetches now also check the HTTP status and surface the error message Metro returns. In development on Android, initialization reuses the bundle React Native has already downloaded.

• feat(Worklets): bring Bundle Mode script loading on par with React Native by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10087
• feat(Worklets): reuse React Native's downloaded dev bundle on Android by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10088

enableLocking option in createWorkletRuntime

createWorkletRuntime accepts a new enableLocking option, which creates a Worklet Runtime without mutex guards. It is meant for advanced use cases, where you can guarantee thread-safety of the runtime.

• feat(Worklets): add enableLocking option to createWorkletRuntime by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/9940

Other changes

• feat(Worklets): Descriptive warning in createSerializable by @tshmieldev in https://github.com/software-mansion/react-native-reanimated/pull/9993
• fix: Adjust createSerializableInaccessibleObject to the Release createSerializable behavior by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10013
• fix(Worklets): RetainingSerializable race condition by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10113
• fix(Worklets): web scheduleOnUI implementation on errors by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10167
• fix(Worklets): Jest mocks missing APIs by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10183
• fix(Worklets): UI loop not pausing when the app is backgrounded by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10196
• fix(Worklets): missing autorelease drain on detached worklet threads by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10192
• refactor(worklets): remove deprecated WorkletRuntime sync API by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10091
• docs(worklets): document WorkletRuntime schedule and runSync API by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10097
• chore(Worklets): remove leftover RCTBundleConsumer imports by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/10086
• chore(Worklets): amend bun patching instructions by @tjzel in https://github.com/software-mansion/react-native-reanimated/pull/9992

Full Changelog: https://github.com/software-mansion/react-native-reanimated/compare/worklets-0.11.3...worklets-0.12.0