react-native-worklets 0.7.2 → 0.8.0-bundle-mode-preview-1

package/lib/typescript/initializers/initializers.native.d.ts

@@ -13,5 +13,6 @@
  */
 export declare function getMemorySafeCapturableConsole(): typeof console;
 export declare function setupConsole(boundCapturableConsole: typeof console): void;
+export declare function setupSerializer(): void;
 export declare function init(): void;
 //# sourceMappingURL=initializers.native.d.ts.map

package/lib/typescript/initializers/initializers.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initializers.native.d.ts","sourceRoot":"","sources":["../../../src/initializers/initializers.native.ts"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,OAAO,CA8B/D;AAED,wBAAgB,YAAY,CAAC,sBAAsB,EAAE,OAAO,OAAO,QAWlE;AAID,wBAAgB,IAAI,SAcnB"}
+{"version":3,"file":"initializers.native.d.ts","sourceRoot":"","sources":["../../../src/initializers/initializers.native.ts"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,OAAO,CA8B/D;AAED,wBAAgB,YAAY,CAAC,sBAAsB,EAAE,OAAO,OAAO,QAWlE;AAED,wBAAgB,eAAe,SAG9B;AAID,wBAAgB,IAAI,SAcnB"}

package/lib/typescript/initializers/workletRuntimeEntry.native.d.ts

@@ -8,7 +8,7 @@
  * error is caught in C++ code.
  *
  * This function has no effect on the RN Runtime beside setting the
- * `_WORKLETS_BUNDLE_MODE` flag.
+ * `_WORKLETS_BUNDLE_MODE_ENABLED` flag.
  */
 export declare function bundleModeInit(): void;
 //# sourceMappingURL=workletRuntimeEntry.native.d.ts.map

package/lib/typescript/memory/bundleUnpacker.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundleUnpacker.native.d.ts","sourceRoot":"","sources":["../../../src/memory/bundleUnpacker.native.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhE,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CA4BT;AAiCD,UAAU,cAAe,SAAQ,eAAe;IAC9C,MAAM,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"bundleUnpacker.native.d.ts","sourceRoot":"","sources":["../../../src/memory/bundleUnpacker.native.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhE,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CA4BT;AA+BD,UAAU,cAAe,SAAQ,eAAe;IAC9C,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/lib/typescript/memory/synchronizableUnpacker.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synchronizableUnpacker.native.d.ts","sourceRoot":"","sources":["../../../src/memory/synchronizableUnpacker.native.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE,wBAAgB,iBAAiB,SAyDhC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAC1C,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC,KACzC,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"synchronizableUnpacker.native.d.ts","sourceRoot":"","sources":["../../../src/memory/synchronizableUnpacker.native.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE,wBAAgB,iBAAiB,SAmDhC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAC1C,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC,KACzC,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/lib/typescript/platformChecker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platformChecker.d.ts","sourceRoot":"","sources":["../../src/platformChecker.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,EAAE,OAAsC,CAAC;AAC7D,eAAO,MAAM,MAAM,EAAE,OAA+B,CAAC;AACrD,eAAO,MAAM,UAAU,EAAE,OAAmC,CAAC;AAC7D,eAAO,MAAM,iBAAiB,EAAE,OAAyC,CAAC"}
+{"version":3,"file":"platformChecker.d.ts","sourceRoot":"","sources":["../../src/platformChecker.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,EAAE,OAAsC,CAAC;AAC7D,eAAO,MAAM,MAAM,EAAE,OAAyD,CAAC;AAC/E,eAAO,MAAM,UAAU,EAAE,OACK,CAAC;AAC/B,eAAO,MAAM,iBAAiB,EAAE,OAAyC,CAAC"}

package/lib/typescript/runtimeKind.d.ts

@@ -22,4 +22,35 @@ export declare enum RuntimeKind {
  * @returns The kind of the current runtime.
  */
 export declare function getRuntimeKind(): RuntimeKind;
+/**
+ * Checks if the current runtime is the [React Native
+ * Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds/#rn-runtime).
+ *
+ * @returns `true` if the current runtime is the React Native Runtime, `false`
+ *   otherwise.
+ */
+export declare function isRNRuntime(): boolean;
+/**
+ * Checks if the current runtime is a [Worklet
+ * Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds/#worklet-runtime).
+ *
+ * @returns `true` if the current runtime is a Worklet Runtime, `false`
+ *   otherwise.
+ */
+export declare function isWorkletRuntime(): boolean;
+/**
+ * Checks if the current runtime is the [UI
+ * Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds/#ui-runtime).
+ *
+ * @returns `true` if the current runtime is the UI Runtime, `false` otherwise.
+ */
+export declare function isUIRuntime(): boolean;
+/**
+ * Checks if the current runtime is a [Worker
+ * Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds/#worker-runtime).
+ *
+ * @returns `true` if the current runtime is a Worker Runtime, `false`
+ *   otherwise.
+ */
+export declare function isWorkerRuntime(): boolean;
 //# sourceMappingURL=runtimeKind.d.ts.map

package/lib/typescript/runtimeKind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeKind.d.ts","sourceRoot":"","sources":["../../src/runtimeKind.ts"],"names":[],"mappings":"AAEA,oBAAY,WAAW;IACrB;;;OAGG;IACH,WAAW,IAAI;IACf;;;OAGG;IACH,EAAE,IAAI;IACN,wDAAwD;IACxD,MAAM,IAAI;CACX;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C"}
+{"version":3,"file":"runtimeKind.d.ts","sourceRoot":"","sources":["../../src/runtimeKind.ts"],"names":[],"mappings":"AAEA,oBAAY,WAAW;IACrB;;;OAGG;IACH,WAAW,IAAI;IACf;;;OAGG;IACH,EAAE,IAAI;IACN,wDAAwD;IACxD,MAAM,IAAI;CACX;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAGrC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAGrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC"}

package/lib/typescript/runtimes.d.ts

@@ -3,4 +3,5 @@ export declare function createWorkletRuntime(config?: WorkletRuntimeConfig): Wor
 export declare function createWorkletRuntime(name?: string, initializer?: () => void): WorkletRuntime;
 export declare function runOnRuntime<Args extends unknown[], ReturnValue>(workletRuntime: WorkletRuntime, worklet: (...args: Args) => ReturnValue): WorkletFunction<Args, ReturnValue>;
 export declare function scheduleOnRuntime<Args extends unknown[], ReturnValue>(workletRuntime: WorkletRuntime, worklet: (...args: Args) => ReturnValue, ...args: Args): void;
+export declare function runOnRuntimeSync<Args extends unknown[], ReturnValue>(workletRuntime: WorkletRuntime, worklet: (...args: Args) => ReturnValue, ...args: Args): ReturnValue;
 //# sourceMappingURL=runtimes.d.ts.map

package/lib/typescript/runtimes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimes.d.ts","sourceRoot":"","sources":["../../src/runtimes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAAC;AAElB,wBAAgB,oBAAoB,CAClC,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,IAAI,GACvB,cAAc,CAAC;AAMlB,wBAAgB,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAC9D,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,GACtC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EACnE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,IAAI,CAAC"}
+{"version":3,"file":"runtimes.d.ts","sourceRoot":"","sources":["../../src/runtimes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAAC;AAElB,wBAAgB,oBAAoB,CAClC,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,IAAI,GACvB,cAAc,CAAC;AAMlB,wBAAgB,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAC9D,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,GACtC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EACnE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,IAAI,CAAC;AAMR,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAClE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,WAAW,CAAC"}

package/lib/typescript/runtimes.native.d.ts

@@ -41,8 +41,8 @@ export declare function createWorkletRuntime(name?: string, initializer?: () =>
  *   or another [Worker
  *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#worker-runtime),
  *   unless the [Bundle
- *   Mode](https://docs.swmansion.com/react-native-worklets/docs/experimental/bundleMode)
- *   is enabled.
+ *   Mode](https://docs.swmansion.com/react-native-worklets/docs/bundleMode/) is
+ *   enabled.
  *
  * @param workletRuntime - The runtime to schedule the worklet on.
  * @param worklet - The worklet to schedule.
@@ -56,4 +56,22 @@ export declare function scheduleOnRuntime<Args extends unknown[], ReturnValue>(w
  *   Schedule a worklet to execute on the background queue.
  */
 export declare function runOnRuntime<Args extends unknown[], ReturnValue>(workletRuntime: WorkletRuntime, worklet: (...args: Args) => ReturnValue): WorkletFunction<Args, ReturnValue>;
+/**
+ * Lets you run a function synchronously on a [Worker
+ * Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#worker-runtime).
+ *
+ * - This function cannot be called from the [UI
+ *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#ui-runtime).
+ *   or another [Worker
+ *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#worker-runtime),
+ *   unless the [Bundle
+ *   Mode](https://docs.swmansion.com/react-native-worklets/docs/bundleMode/) is
+ *   enabled.
+ *
+ * @param workletRuntime - The runtime to run the worklet on.
+ * @param worklet - The worklet to run.
+ * @param args - The arguments to pass to the worklet.
+ * @returns The return value of the worklet.
+ */
+export declare function runOnRuntimeSync<Args extends unknown[], ReturnValue>(workletRuntime: WorkletRuntime, worklet: (...args: Args) => ReturnValue, ...args: Args): ReturnValue;
 //# sourceMappingURL=runtimes.native.d.ts.map

package/lib/typescript/runtimes.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimes.native.d.ts","sourceRoot":"","sources":["../../src/runtimes.native.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAIjB;;;;;;;;GAQG;AAEH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAAC;AAElB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,IAAI,GACvB,cAAc,CAAC;AAqDlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EACnE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,IAAI,CAAC;AAiCR;;;;GAIG;AAGH,wBAAgB,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAC9D,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,GACtC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC"}
+{"version":3,"file":"runtimes.native.d.ts","sourceRoot":"","sources":["../../src/runtimes.native.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAIjB;;;;;;;;GAQG;AAEH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAAC;AAElB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,IAAI,GACvB,cAAc,CAAC;AAsDlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EACnE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,IAAI,CAAC;AAiCR;;;;GAIG;AAGH,wBAAgB,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAC9D,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,GACtC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAmBtC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,WAAW,EAClE,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,EACvC,GAAG,IAAI,EAAE,IAAI,GACZ,WAAW,CAgBb"}

package/lib/typescript/threads.native.d.ts

@@ -14,7 +14,7 @@ export declare const callMicrotasks: typeof callMicrotasksOnUIThread;
  *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#ui-runtime)
  *   or a [Worker
  *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#worker-runtime),
- *   unless you have the [Bundle Mode](/docs/experimental/bundleMode) enabled.
+ *   unless you have the [Bundle Mode](/docs/bundleMode/) enabled.
  *
  * @param fun - A reference to a function you want to schedule on the [UI
  *   Runtime](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/runtimeKinds#ui-runtime).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-worklets",
-  "version": "0.7.2",
+  "version": "0.8.0-bundle-mode-preview-1",
   "description": "The React Native multithreading library",
   "keywords": [
     "react-native",
@@ -36,7 +36,8 @@
     "type:check:src:web": "yarn tsc --noEmit --project tsconfig.web.json",
     "type:check:app": "yarn workspace common-app type:check",
     "type:check:plugin": "yarn workspace babel-plugin-worklets type:check",
-    "type:check:tests": "../../scripts/test-ts.sh __typetests__"
+    "type:check:tests": "../../scripts/test-ts.sh __typetests__",
+    "tree-shake:check:web": "yarn is-tree-shakable --resolution web"
   },
   "repository": {
     "type": "git",
@@ -65,13 +66,14 @@
     "@babel/plugin-transform-unicode-regex": "7.27.1",
     "@babel/preset-typescript": "7.27.1",
     "convert-source-map": "2.0.0",
+    "is-tree-shakable": "0.4.1",
     "semver": "7.7.3"
   },
   "devDependencies": {
     "@babel/cli": "7.28.3",
     "@babel/core": "7.28.4",
-    "@react-native-community/cli": "20.0.0",
-    "@react-native/eslint-config": "0.83.1",
+    "@react-native-community/cli": "20.1.0",
+    "@react-native/eslint-config": "0.83.0",
     "@types/jest": "30.0.0",
     "@types/node": "24.7.0",
     "@types/react": "19.2.2",
@@ -82,8 +84,8 @@
     "knip": "5.61.3",
     "madge": "8.0.0",
     "prettier": "3.6.2",
-    "react": "19.2.0",
-    "react-native": "0.83.1",
+    "react": "19.2.3",
+    "react-native": "0.84.0-rc.2",
     "react-native-builder-bob": "0.40.13",
     "typescript": "5.8.3"
   },

package/plugin/index.d.ts

@@ -1,13 +1,122 @@
 export interface PluginOptions {
+  /**
+   * Enables the [Bundle
+   * Mode](https://docs.swmansion.com/react-native-worklets/docs/experimental/bundle-mode).
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#bundle-mode}
+   *
+   * - Defaults to `false`.
+   */
   bundleMode?: boolean;
+  /**
+   * Turning on this option suppresses a helpful warning when you use [inline
+   * shared
+   * values](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/glossary#animations-in-inline-styling).
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#disableinlinestyleswarning}
+   *
+   * - Defaults to `false`.
+   */
   disableInlineStylesWarning?: boolean;
+  /**
+   * This option turns off the source map generation for worklets. Mostly used
+   * for testing purposes.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#disablesourcemaps}
+   *
+   * - Defaults to `false`.
+   */
   disableSourceMaps?: boolean;
+  /**
+   * Disables [Worklet Classes
+   * support](https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/about#experimental-worklet-classes).
+   * You might need to disable this feature when using [Custom
+   * Serializables](https://docs.swmansion.com/react-native-worklets/docs/memory/registerCustomSerializable).
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#disableworkletclasses}
+   *
+   * - Defaults to `false`.
+   */
   disableWorkletClasses?: boolean;
+  /**
+   * This is a list of Babel plugins that will be used when transforming
+   * worklets' code with Worklets Babel Plugin.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#extraplugins}
+   *
+   * - Defaults to an empty array `[]`.
+   */
   extraPlugins?: string[];
+  /**
+   * This is a list of Babel presets that will be used when transforming
+   * worklets' code with Worklets Babel Plugin.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#extrapresets}
+   *
+   * - Defaults to an empty array `[]`.
+   */
   extraPresets?: string[];
+  /**
+   * This is a list of identifiers (objects) that will not be copied to the UI
+   * thread if a worklet requires them.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#globals}
+   *
+   * - Defaults to an empty array `[]`.
+   */
   globals?: string[];
+  /**
+   * This option comes in handy for Web apps. Because Babel ordinarily doesn't
+   * get information about the target platform, it includes worklet data in
+   * the bundle that only Native apps find relevant. If you enable this
+   * option, your bundle size will be smaller.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#omitnativeonlydata}
+   *
+   * - Defaults to `false`.
+   */
   omitNativeOnlyData?: boolean;
+  /**
+   * This option dictates the passed file location for a worklet's source map.
+   * If you enable this option, the file paths will be relative to
+   * `process.cwd` (the current directory where Babel executes). This can be
+   * handy for Jest test snapshots to ensure consistent results across
+   * machines.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#relativesourcelocation}
+   *
+   * - Defaults to `false`.
+   */
   relativeSourceLocation?: boolean;
+  /**
+   * This option makes it so no global identifiers are implicitly captured in
+   * worklets' closures between runtimes.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#strictglobal}
+   *
+   * Defaults to `false`.
+   */
+  strictGlobal?: boolean;
+  /**
+   * This option can also be useful for Web apps. In Reanimated, there are
+   * numerous checks to determine the right function implementation for a
+   * specific target platform. Enabling this option changes all the checks
+   * that identify if the target is a Web app to `true`. This alteration can
+   * aid in tree-shaking and contribute to reducing the bundle size.
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#substitutewebplatformchecks}
+   *
+   * - Defaults to `false`.
+   */
   substituteWebPlatformChecks?: boolean;
+  /**
+   * This option allows you to register modules as safe to use on Worklet
+   * Runtimes in the [Bundle
+   * Mode](https://docs.swmansion.com/react-native-worklets/docs/experimental/bundle-mode).
+   *
+   * {@link https://docs.swmansion.com/react-native-worklets/docs/worklets-babel-plugin/plugin-options#workletizablemodules}
+   *
+   * - Defaults to an empty array `[]`.
+   */
   workletizableModules?: string[];
 }

package/plugin/index.js

@@ -277,7 +277,7 @@ var require_types = __commonJS({
       return (0, types_12.isObjectExpression)(node);
     }
     exports2.workletClassFactorySuffix = "__classFactory";
-    exports2.generatedWorkletsDir = "__generatedWorklets";
+    exports2.generatedWorkletsDir = ".worklets";
   }
 });
 
@@ -411,10 +411,15 @@ var require_globals = __commonJS({
     exports2.initializeGlobals = initializeGlobals;
     exports2.addCustomGlobals = addCustomGlobals;
     var notCapturedIdentifiers = [
+      // Based on https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects
+      // Note that objects' properties don't need to be listed since we always only capture the whole object,
+      // e.g. `global.__ErrorUtils` or `Intl.DateTimeFormat`.
+      // Value properties
       "globalThis",
       "Infinity",
       "NaN",
       "undefined",
+      // Function properties
       "eval",
       "isFinite",
       "isNaN",
@@ -426,10 +431,12 @@ var require_globals = __commonJS({
       "encodeURIComponent",
       "escape",
       "unescape",
+      // Fundamental objects
       "Object",
       "Function",
       "Boolean",
       "Symbol",
+      // Error objects
       "Error",
       "AggregateError",
       "EvalError",
@@ -439,12 +446,15 @@ var require_globals = __commonJS({
       "TypeError",
       "URIError",
       "InternalError",
+      // Numbers and dates
       "Number",
       "BigInt",
       "Math",
       "Date",
+      // Text processing
       "String",
       "RegExp",
+      // Indexed collections
       "Array",
       "Int8Array",
       "Uint8Array",
@@ -457,17 +467,21 @@ var require_globals = __commonJS({
       "BigUint64Array",
       "Float32Array",
       "Float64Array",
+      // Keyed collections
       "Map",
       "Set",
       "WeakMap",
       "WeakSet",
+      // Structured data
       "ArrayBuffer",
       "SharedArrayBuffer",
       "DataView",
       "Atomics",
       "JSON",
+      // Managing memory
       "WeakRef",
       "FinalizationRegistry",
+      // Control abstraction objects
       "Iterator",
       "AsyncIterator",
       "Promise",
@@ -476,9 +490,12 @@ var require_globals = __commonJS({
       "Generator",
       "AsyncGenerator",
       "AsyncFunction",
+      // Reflection
       "Reflect",
       "Proxy",
+      // Internationalization
       "Intl",
+      // Other stuff
       "null",
       "this",
       "global",
@@ -488,7 +505,12 @@ var require_globals = __commonJS({
       "console",
       "performance",
       "arguments",
+      // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/arguments
       "require",
+      "fetch",
+      "XMLHttpRequest",
+      "WebSocket",
+      // Run loop
       "queueMicrotask",
       "requestAnimationFrame",
       "cancelAnimationFrame",
@@ -498,7 +520,9 @@ var require_globals = __commonJS({
       "clearImmediate",
       "setInterval",
       "clearInterval",
+      // Hermes
       "HermesInternal",
+      // Worklets
       "_WORKLET"
     ];
     exports2.outsideBindingsToCaptureFromGlobalScope = /* @__PURE__ */ new Set([
@@ -511,8 +535,10 @@ var require_globals = __commonJS({
     function initializeState(state) {
       state.workletNumber = 1;
       state.classesToWorkletize = [];
-      initializeGlobals();
-      addCustomGlobals(state);
+      if (!state.opts.strictGlobal) {
+        initializeGlobals();
+        addCustomGlobals(state);
+      }
     }
     exports2.defaultGlobals = new Set(notCapturedIdentifiers.concat(notCapturedIdentifiers_DEPRECATED));
     function initializeGlobals() {
@@ -561,7 +587,7 @@ var require_closure = __commonJS({
             binding = idPath.scope.getBinding(name);
           }
           if (!binding) {
-            if (globals_12.globals.has(name)) {
+            if (state.opts.strictGlobal || globals_12.globals.has(name)) {
               return;
             }
             capturedNames.add(name);
@@ -614,11 +640,16 @@ var require_closure = __commonJS({
       return imported.path.parentPath.node.source.value.startsWith(".");
     }
     function isAllowedForRelativeImports(filename, workletizableModules) {
-      return !!filename && (filename.includes("react-native-worklets") || !!(workletizableModules === null || workletizableModules === void 0 ? void 0 : workletizableModules.some((module3) => filename.includes(module3))));
+      return !!filename && (alwaysAllowed.some((module3) => filename.includes(module3)) || !!(workletizableModules === null || workletizableModules === void 0 ? void 0 : workletizableModules.some((module3) => filename.includes(module3))));
     }
     function isWorkletizableModule(source, workletizableModules) {
-      return source.startsWith("react-native-worklets") || !!(workletizableModules === null || workletizableModules === void 0 ? void 0 : workletizableModules.some((module3) => source.startsWith(module3)));
+      return alwaysAllowed.some((module3) => source.startsWith(module3)) || !!(workletizableModules === null || workletizableModules === void 0 ? void 0 : workletizableModules.some((module3) => source.startsWith(module3)));
     }
+    var alwaysAllowed = [
+      "react-native-worklets",
+      "react-native/Libraries/Core/setUpXHR"
+      // for networking
+    ];
   }
 });
 
@@ -979,6 +1010,7 @@ var require_workletFactory = __commonJS({
             (0, types_12.newExpression)((0, types_12.memberExpression)((0, types_12.identifier)("global"), (0, types_12.identifier)("Error")), []),
             (0, types_12.numericLiteral)(lineOffset),
             (0, types_12.numericLiteral)(-27)
+            // the placement of opening bracket after Exception in line that defined '_e' variable
           ]))
         ]));
         statements.push((0, types_12.expressionStatement)((0, types_12.assignmentExpression)("=", (0, types_12.memberExpression)((0, types_12.identifier)(reactName), (0, types_12.identifier)("__stackDetails"), false), (0, types_12.identifier)("_e"))));
@@ -1124,6 +1156,7 @@ var require_workletSubstitution = __commonJS({
     }
     function processWorklet(path, state) {
       path.traverse({
+        // @ts-expect-error TypeScript doesn't like this syntax here.
         [types_2.WorkletizableFunction](subPath, passedState) {
           processIfWithWorkletDirective(subPath, passedState);
         }
@@ -1180,7 +1213,14 @@ var require_objectWorklets = __commonJS({
           (0, workletSubstitution_12.processWorklet)(property, state);
         } else if (property.isObjectProperty()) {
           const value = property.get("value");
-          tryProcessingNode(value, state, true, false);
+          tryProcessingNode(
+            value,
+            state,
+            true,
+            // acceptWorkletizableFunction
+            false
+            // acceptObject
+          );
         } else {
           throw new Error(`[Reanimated] '${property.type}' as to-be workletized argument is not supported for object hooks.`);
         }
@@ -1213,10 +1253,12 @@ var require_autoworkletization = __commonJS({
       "useDerivedValue",
       "useAnimatedScrollHandler",
       "useAnimatedReaction",
+      // animations' callbacks
       "withTiming",
       "withSpring",
       "withDecay",
       "withRepeat",
+      // scheduling functions
       "runOnUI",
       "executeOnUIRuntimeSync",
       "scheduleOnUI",
@@ -1301,7 +1343,7 @@ var require_bundleMode = __commonJS({
       }
       const object = left.get("object");
       const property = left.get("property");
-      if (!object.isIdentifier() || object.node.name !== "globalThis" || !property.isIdentifier() || property.node.name !== "_WORKLETS_BUNDLE_MODE") {
+      if (!object.isIdentifier() || object.node.name !== "globalThis" || !property.isIdentifier() || property.node.name !== "_WORKLETS_BUNDLE_MODE_ENABLED") {
         return;
       }
       const right = expressionPath.get("right");
@@ -1474,7 +1516,15 @@ var require_class = __commonJS({
       stack.delete(current.name);
     }
     function isOutsideDependency(identifierPath, bindingIdentifiers, functionPath) {
-      return identifierPath.isReferencedIdentifier() && !(identifierPath.node.name in bindingIdentifiers) && !functionPath.scope.hasOwnBinding(identifierPath.node.name) && functionPath.scope.hasReference(identifierPath.node.name);
+      return (
+        // We don't care about identifiers that were just declared.
+        identifierPath.isReferencedIdentifier() && // We don't care about identifiers that are bound in the scope.
+        !(identifierPath.node.name in bindingIdentifiers) && // This I don't exactly understand, but the function identifier itself isn't in `bindingIdentifiers`,
+        // but it return true on `hasOwnBinding`.
+        !functionPath.scope.hasOwnBinding(identifierPath.node.name) && // `hasReference` returns true for global identifiers, like `Object`,
+        // we don't want to include those.
+        functionPath.scope.hasReference(identifierPath.node.name)
+      );
     }
     function isWorkletizableClass(classPath, state) {
       var _a;

package/scripts/worklets_utils.rb

@@ -8,18 +8,18 @@ end
 
 def worklets_find_config()
   result = {
-    :bundle_mode => nil,
+    :bundle_mode_flag => nil,
+    :dynamic_frameworks_worklets_dir => nil,
+    :feature_flags_flag => nil,
+    :fetch_preview_flag => nil,
     :is_reanimated_example_app => nil,
     :is_tvos_target => nil,
     :react_native_version => nil,
     :react_native_minor_version => nil,
     :react_native_node_modules_dir => nil,
     :react_native_common_dir => nil,
-    :dynamic_frameworks_worklets_dir => nil,
   }
 
-  result[:bundle_mode] = ENV["WORKLETS_BUNDLE_MODE"] == "1"
-
   react_native_node_modules_dir = File.join(File.dirname(`cd "#{Pod::Config.instance.installation_root.to_s}" && node --print "require.resolve('react-native/package.json')"`), '..')
   react_native_json = worklets_try_to_parse_react_native_package_json(react_native_node_modules_dir)
 
@@ -51,6 +51,11 @@ def worklets_find_config()
   react_native_worklets_dir_relative = Pathname.new(react_native_worklets_dir_absolute).relative_path_from(pods_root).to_s
   result[:dynamic_frameworks_worklets_dir] = react_native_worklets_dir_relative
 
+  feature_flags = worklets_get_static_feature_flags()
+  result[:feature_flags_flag] = worklets_get_static_feature_flags_flag(feature_flags)
+  result[:bundle_mode_flag] = worklets_get_flag_from_feature_flags(feature_flags, 'BUNDLE_MODE_ENABLED')
+  result[:fetch_preview_flag] = worklets_get_flag_from_feature_flags(feature_flags, 'FETCH_PREVIEW_ENABLED')
+  
   return result
 end
 
@@ -67,6 +72,14 @@ def worklets_assert_new_architecture_enabled(new_arch_enabled)
   end
 end
 
+def worklets_get_flag_from_feature_flags(feature_flags, flag_name)
+  if feature_flags[flag_name] == 'true'
+    return "-DWORKLETS_#{flag_name}"
+  else
+    return ''
+  end
+end
+
 def worklets_get_static_feature_flags()
   feature_flags = {}
 
@@ -89,6 +102,9 @@ def worklets_get_static_feature_flags()
       end
     end
   end
+  return feature_flags
+end
 
-  return feature_flags.map { |key, value| "[#{key}:#{value}]" }.join('')
+def worklets_get_static_feature_flags_flag(feature_flags)
+  return "-DWORKLETS_FEATURE_FLAGS=\"#{feature_flags.map { |key, value| "[#{key}:#{value}]" }.join('')}\""
 end

package/src/WorkletsModule/NativeWorklets.native.ts

@@ -26,6 +26,11 @@ class NativeWorklets implements IWorkletsModule {
       globalThis.__RUNTIME_KIND === RuntimeKind.ReactNative
     ) {
       WorkletsTurboModule?.installTurboModule();
+      if (__DEV__ && globalThis._WORKLETS_BUNDLE_MODE_ENABLED) {
+        console.log(
+          '[Worklets] Bundle mode initialization: Downloaded the bundle for Worklet Runtimes.'
+        );
+      }
     }
     if (global.__workletsModuleProxy === undefined) {
       throw new WorkletsError(
@@ -177,10 +182,8 @@ See https://docs.swmansion.com/react-native-worklets/docs/guides/troubleshooting
     return this.#workletsModuleProxy.scheduleOnUI(serializable);
   }
 
-  executeOnUIRuntimeSync<TValue, TReturn>(
-    serializable: SerializableRef<TValue>
-  ): TReturn {
-    return this.#workletsModuleProxy.executeOnUIRuntimeSync(serializable);
+  runOnUISync<TValue, TReturn>(worklet: SerializableRef<TValue>): TReturn {
+    return this.#workletsModuleProxy.runOnUISync(worklet);
   }
 
   createWorkletRuntime(
@@ -209,6 +212,13 @@ See https://docs.swmansion.com/react-native-worklets/docs/guides/troubleshooting
     );
   }
 
+  runOnRuntimeSync<TValue, TReturn>(
+    workletRuntime: WorkletRuntime,
+    worklet: SerializableRef<TValue>
+  ): TReturn {
+    return this.#workletsModuleProxy.runOnRuntimeSync(workletRuntime, worklet);
+  }
+
   createSynchronizable<TValue>(value: TValue): SynchronizableRef<TValue> {
     return this.#workletsModuleProxy.createSynchronizable(value);
   }

package/src/WorkletsModule/workletsModuleProxy.ts

@@ -83,9 +83,7 @@ export interface WorkletsModuleProxy {
 
   scheduleOnUI<TValue>(serializable: SerializableRef<TValue>): void;
 
-  executeOnUIRuntimeSync<TValue, TReturn>(
-    serializable: SerializableRef<TValue>
-  ): TReturn;
+  runOnUISync<TValue, TReturn>(serializable: SerializableRef<TValue>): TReturn;
 
   createWorkletRuntime(
     name: string,
@@ -100,6 +98,11 @@ export interface WorkletsModuleProxy {
     worklet: SerializableRef<TValue>
   ): void;
 
+  runOnRuntimeSync<TValue, TReturn>(
+    workletRuntime: WorkletRuntime,
+    worklet: SerializableRef<TValue>
+  ): TReturn;
+
   reportFatalErrorOnJS(
     message: string,
     stack: string,