deprecate instead of removing option

dannyhw · dannyhw · commit ac7f6da59083 · 2025-07-22T13:06:51.000+01:00
diff --git a/code/frameworks/react-native-web-vite/src/types.ts b/code/frameworks/react-native-web-vite/src/types.ts
@@ -9,6 +9,12 @@ import type { BabelOptions, Options as ReactOptions } from 'vite-plugin-rnw';
 
 export type FrameworkOptions = FrameworkOptionsBase & {
   pluginReactOptions?: Omit<ReactOptions, 'babel'> & { babel?: BabelOptions };
+  /**
+   * @deprecated These options will be ignored. Use `pluginReactOptions` now for everything and
+   *   override includes in order to transpile node_modules pluginBabelOptions will be removed in
+   *   the next major version. To configure babel, use `pluginReactOptions.babel`.
+   */
+  pluginBabelOptions?: Record<string, unknown>;
 };
 
 type FrameworkName = CompatibleString<'@storybook/react-native-web-vite'>;
diff --git a/docs/get-started/frameworks/react-native-web-vite.mdx b/docs/get-started/frameworks/react-native-web-vite.mdx
@@ -144,24 +144,12 @@ const config: StorybookConfig = {
           presets: Array<string | [string, any]>,
           // ... other compatible babel options
         }
-        include: Array<string|RegExp>,
-        exclude: Array<string|RegExp>,
+        include: Array<string|RegExp>, 
+        
+        // default excludes: /\/node_modules\/(?!react-native|@react-native|expo|@expo)/;
+        exclude: Array<string|RegExp>, 
         // ... other compatible @vitejs/plugin-react options
       }
-
-      // these options are used to configure transpilation of node_modules via babel
-      // in most cases, you don't need to configure these options, but they are available if you need them
-      pluginBabelOptions: {
-        include: Array<string|RegExp>, // default: [/node_modules\/(react-native|@react-native)/]
-        exclude: Array<string|RegExp>, // default: undefined
-        presets: Array<string|[string, any]>,
-        plugins: Array<string|[string, any]>,
-        presetReact?: {
-          runtime?: 'automatic' | 'classic'; // default: 'automatic'
-          importSource?: string; // default: 'react'
-        };
-        // ... other compatible vite-plugin-babel options
-      }
     },
   },
 };
@@ -210,6 +198,26 @@ const main: StorybookConfig = {
 }
 ```
 
+#### Example configuration to transpile additional node_modules
+
+Lets say you need to transpile a library called `my-library` that is not included in the default excludes.
+You can do so by overriding the `exclude` option.
+
+```ts title=".storybook/main.ts"
+const main: StorybookConfig = {
+  // ... rest of config
+
+  framework: {
+    name: "@storybook/react-native-web-vite",
+    options: {
+      pluginReactOptions: {
+        exclude: /\/node_modules\/(?!react-native|@react-native|expo|@expo|my-library)/;
+      },
+    },
+  },
+}
+```
+
 #### `builder`
 
 Type: `Record<string, any>`
