feat(repack)!: enable package exports by default in getResolveOptions

Metro has resolved package exports by default since React Native 0.79, and
React Native 0.87+ depends on them, so getResolveOptions now defaults
enablePackageExports to true. Pass false to resolve through main fields only.

Also fix ReanimatedPlugin's warning filter, which no longer matched the
setUpTests message from Reanimated 4's Jest utilities after it gained a
[Reanimated] prefix.

Author: dannyhw

.changeset/reanimated-warning-filter.md

@@ -0,0 +1,5 @@
+---
+'@callstack/repack-plugin-reanimated': patch
+---
+
+Fix `ReanimatedPlugin` not hiding the `setUpTests` / `Critical dependency: require function` warning from Reanimated 4's Jest utilities, whose message is now prefixed with `[Reanimated] `.

.changeset/v6-package-exports-default.md

@@ -0,0 +1,5 @@
+---
+'@callstack/repack': major
+---
+
+`getResolveOptions()` now enables package exports by default (`enablePackageExports: true`), matching Metro's default since React Native 0.79. Pass `enablePackageExports: false` to keep resolving through main fields only.

packages/plugin-reanimated/src/plugin.ts

@@ -4,12 +4,14 @@ import semver, { type SemVer } from 'semver';
 import type { Compiler as WebpackCompiler } from 'webpack';
 import { createReanimatedModuleRules } from './rules.js';
 
+// Reanimated 4 prefixes the message with `[Reanimated] `
 const REANIMATED_SETUP_TESTS_WARNING =
-  /'`setUpTests` is available only in Jest environment\.'/;
+  /`setUpTests` is available only in Jest environment\./;
 const WORKLETS_CRITICAL_DEPENDENCY_WARNING =
   /Critical dependency: require function is used in a way in which dependencies cannot be statically extracted/;
-const WORKLETS_INITIALIZERS_MODULE =
-  /react-native-(?:worklets|reanimated)[\\/].*initializers(?:\.[cm]?[jt]sx?)?/;
+// Modules that call `require` dynamically to load Jest-only dependencies
+const WORKLETS_DYNAMIC_REQUIRE_MODULE =
+  /react-native-(?:worklets|reanimated)[\\/].*(?:initializers|jestUtils)/;
 
 type WarningLike = {
   message?: unknown;
@@ -101,7 +103,7 @@ export class ReanimatedPlugin {
       return (
         REANIMATED_SETUP_TESTS_WARNING.test(warningText) ||
         (WORKLETS_CRITICAL_DEPENDENCY_WARNING.test(warningText) &&
-          WORKLETS_INITIALIZERS_MODULE.test(warningText))
+          WORKLETS_DYNAMIC_REQUIRE_MODULE.test(warningText))
       );
     });
   }

packages/repack/src/utils/__tests__/getResolveOptions.test.ts

@@ -42,6 +42,18 @@ describe('getResolveOptions', () => {
     expect(result.extensions).not.toContain('.android.js');
   });
 
+  it('should enable package exports by default', () => {
+    const result = getResolveOptions('ios');
+    expect(result.exportsFields).toEqual(['exports']);
+    expect(result.conditionNames).toEqual(['react-native']);
+  });
+
+  it('should disable package exports when enablePackageExports is false', () => {
+    const result = getResolveOptions('ios', { enablePackageExports: false });
+    expect(result.exportsFields).toEqual([]);
+    expect(result.conditionNames).toEqual([]);
+  });
+
   it('should use actual platform value when provided', () => {
     const result = getResolveOptions('ios');
     expect(result).toBeDefined();

packages/repack/src/utils/getResolveOptions.ts

@@ -15,7 +15,7 @@ interface GetResolveOptionsResult {
  */
 export interface ResolveOptions {
   /**
-   * Whether to enable Package Exports support. Defaults to `false`.
+   * Whether to enable Package Exports support. Defaults to `true`, matching Metro.
    */
   enablePackageExports?: boolean;
   /**
@@ -28,8 +28,8 @@ export interface ResolveOptions {
  * Get Webpack's resolve options to properly resolve JavaScript files:
  * - resolve platform extensions (e.g. `file.ios.js`)
  * - resolve native extensions (e.g. `file.native.js`)
- * - optionally use package exports (`exports` field in `package.json`) instead of
- *   main fields (e.g. `main` or `browser` or `react-native`)
+ * - use package exports (`exports` field in `package.json`) before main fields
+ *   (e.g. `main` or `browser` or `react-native`), unless disabled
  *
  * @param platform Target application platform.
  * @param options Additional options that can modify resolution behaviour.
@@ -48,7 +48,7 @@ export interface ResolveOptions {
  *   return {
  *     resolve: {
  *       ...Repack.getResolveOptions(platform, {
- *         enablePackageExports: false,
+ *         enablePackageExports: true,
  *         preferNativePlatform: true
  *       }),
  *     },
@@ -78,7 +78,7 @@ export function getResolveOptions(
   ) as ResolveOptions | undefined;
 
   const preferNativePlatform = _options?.preferNativePlatform ?? true;
-  const enablePackageExports = _options?.enablePackageExports ?? false;
+  const enablePackageExports = _options?.enablePackageExports ?? true;
 
   let extensions = ['.js', '.jsx', '.ts', '.tsx', '.json'];
 

website/src/latest/api/utils/get-resolve-options.md

@@ -28,12 +28,12 @@ Target application platform (e.g. `ios` or `android`).
 ### options.enablePackageExports
 
 - Type: `boolean`
-- Default: `false`
+- Default: `true`
 
 Whether to enable Package Exports support. When enabled, uses the `exports` field in `package.json` instead of main fields.
 
 :::warning
-React Native 0.88 requires `enablePackageExports: true` in your Re.Pack resolver configuration. Its `react-native/setup-env` and `react-native/react-private-interface` entry points, as well as `@react-native/asset-utils`, use package exports.
+React Native 0.88 requires package exports, so don't set `enablePackageExports: false` there. Its `react-native/setup-env` and `react-native/react-private-interface` entry points, as well as `@react-native/asset-utils`, use package exports.
 
 Enabling package exports can change how existing dependencies resolve. For more details, please refer to the [Module Resolution guide](/docs/features/module-resolution).
 :::

website/src/latest/docs/features/module-resolution.md

@@ -22,9 +22,7 @@ import * as Repack from "@callstack/repack";
 export default (env) => {
   return {
     resolve: {
-      ...Repack.getResolveOptions(env.platform, {
-        enablePackageExports: true,
-      }),
+      ...Repack.getResolveOptions(env.platform),
     },
   };
 };
@@ -105,7 +103,7 @@ Main fields are `package.json` properties that point to a package's entry file.
 
 :::
 
-When resolving a package's entry point, Re.Pack checks these fields in `package.json` in order:
+When a package has no `exports` field, or [package exports](#package-exports-conditional-exports) are disabled, Re.Pack resolves its entry point by checking these fields in `package.json` in order:
 
 1. `react-native` — React Native-specific entry point
 2. `browser` — Browser-compatible entry point
@@ -146,15 +144,15 @@ Modern packages use the `exports` field in `package.json` to define entry points
 
 :::caution
 
-Package exports support is **disabled by default** (`enablePackageExports: false`) to maintain backwards compatibility with existing React Native projects. React Native 0.87 requires it for `@react-native/asset-utils`, and 0.88 also for `react-native/setup-env` and `react-native/react-private-interface`. Enable it explicitly for React Native 0.87 and newer, or whenever your dependencies require it. The configuration templates used by `@callstack/repack-init` enable it.
+Package exports support is **enabled by default** (`enablePackageExports: true`), matching Metro's default since React Native 0.79. React Native 0.87 requires it for `@react-native/asset-utils`, and 0.88 also for `react-native/setup-env` and `react-native/react-private-interface`, so only disable it if your React Native version and dependencies don't need it.
 
 :::
 
-### Enabling package exports
+### Disabling package exports
 
 ```ts
 Repack.getResolveOptions({
-  enablePackageExports: true,
+  enablePackageExports: false,
 });
 ```
 
@@ -277,7 +275,7 @@ export default (env) => {
 
 1. **Check the package's `package.json`** — Look at `main`, `react-native`, `browser`, and `exports` fields
 2. **Verify platform extensions** — Ensure platform-specific files use correct naming (`.ios.js`, not `.iOS.js`)
-3. **Check `enablePackageExports`** — Some modern packages require this to be `true`
+3. **Check `enablePackageExports`** — Some modern packages require this to be `true` (the default)
 
 ### Platform-specific files not being picked up
 
@@ -287,7 +285,7 @@ export default (env) => {
 
 ### Package exports compatibility issues
 
-When enabling `enablePackageExports`, some packages may resolve differently:
+With `enablePackageExports` enabled, some packages may resolve differently than with main fields only:
 
 1. **Compare with Metro** — Test the same import in a Metro-bundled project
 2. **Check condition order** — The `react-native` condition should take precedence

website/src/latest/docs/migration-guides/repack-v5.mdx

@@ -28,6 +28,19 @@ Update the Re.Pack plugins you use (`@callstack/repack-plugin-*`) to the same ma
 
 React Native 0.82 removed the legacy architecture, so Re.Pack's native module is now built only as a TurboModule. If your app still sets `newArchEnabled=false`, migrate it to the [New Architecture](https://reactnative.dev/architecture/landing-page) before upgrading.
 
+## Package exports are enabled by default
+
+`getResolveOptions()` now sets `enablePackageExports` to `true` by default, matching Metro's default since React Native 0.79. Configs that already pass `enablePackageExports: true` don't need changes. If your project relies on main-field resolution, opt out explicitly:
+
+```diff
+  resolve: {
+-   ...Repack.getResolveOptions(),
++   ...Repack.getResolveOptions({ enablePackageExports: false }),
+  },
+```
+
+See [Module Resolution](/docs/features/module-resolution#package-exports-conditional-exports) for how package exports change resolution.
+
 ## Module Federation V1 was removed
 
 `ModuleFederationPluginV1` is no longer available, and `Repack.plugins.ModuleFederationPlugin` now points to [`ModuleFederationPluginV2`](/api/plugins/module-federation-v2). Follow [Migrating from V1](/docs/features/module-federation#migrating-from-v1) to move your configs to Module Federation 2.0.