Function pluginReact

packages/plugin-react/src/index.ts:158–253

(options: PluginReactOptions = {})

}

export const pluginReact = (options: PluginReactOptions = {}): RsbuildPlugin => ({
  name: PLUGIN_REACT_NAME,

  setup(api) {
    assertCoreVersion(api.context.version);

    const defaultOptions = {
      fastRefresh: true,
      splitChunks: true,
      enableProfiler: false,
    } satisfies PluginReactOptions;

    const finalOptions = {
      ...defaultOptions,
      ...options,
    };

    if (finalOptions.reactCompiler !== undefined) {
      assertReactCompilerVersion();
    }

    const reactRefreshPath = finalOptions.fastRefresh ? require.resolve('react-refresh') : '';

    api.modifyEnvironmentConfig((config, { mergeEnvironmentConfig }) => {
      const isDev = config.mode === 'development';
      const usingHMR = isDev && config.dev.hmr && config.output.target === 'web';

      const reactOptions: Rspack.SwcLoaderTransformConfig['react'] = {
        development: isDev,
        refresh: usingHMR && finalOptions.fastRefresh,
        runtime: 'automatic',
        ...finalOptions.swcReactOptions,
      };
      const transformOptions: Rspack.SwcLoaderTransformConfig = {
        react: reactOptions,
      };

      if (finalOptions.reactCompiler !== undefined) {
        transformOptions.reactCompiler = finalOptions.reactCompiler;
      }

      return mergeEnvironmentConfig(
        {
          tools: {
            swc: {
              jsc: {
                transform: transformOptions,
              },
            },
          },
        },
        config,
      );
    });

    if (finalOptions.swcReactOptions?.runtime === 'preserve') {
      api.modifyBundlerChain((chain) => {
        chain.module.parser.merge({