@react-native/babel-preset 0.73.0

package/BUCK

@@ -0,0 +1,23 @@
+load("@fbsource//tools/build_defs/third_party:yarn_defs.bzl", "yarn_workspace")
+
+oncall("react_native")
+
+yarn_workspace(
+    name = "yarn-workspace",
+    srcs = glob(
+        ["src/**/*.js"],
+        exclude = [
+            "**/__fixtures__/**",
+            "**/__flowtests__/**",
+            "**/__mocks__/**",
+            "**/__server_snapshot_tests__/**",
+            "**/__tests__/**",
+            "**/.*",
+            "**/.*/**",
+            "**/.*/.*",
+            "**/*.xcodeproj/**",
+            "**/*.xcworkspace/**",
+        ],
+    ),
+    visibility = ["PUBLIC"],
+)

package/README.md

@@ -0,0 +1,41 @@
+# @react-native/babel-preset
+
+Babel presets for [React Native](https://reactnative.dev) applications. React Native itself uses this Babel preset by default when transforming your app's source code.
+
+If you wish to use a custom Babel configuration by writing a `babel.config.js` file in your project's root directory, you must specify all the plugins necessary to transform your code. React Native does not apply its default Babel configuration in this case. So, to make your life easier, you can use this preset to get the default configuration and then specify more plugins that run before it.
+
+## Usage
+
+As mentioned above, you only need to use this preset if you are writing a custom `babel.config.js` file.
+
+### Installation
+
+Install `@react-native/babel-preset` in your app:
+
+with `npm`:
+
+```sh
+npm i @react-native/babel-preset --save-dev
+```
+
+or with `yarn`:
+
+```sh
+yarn add -D @react-native/babel-preset
+```
+
+### Configuring Babel
+
+Then, create a file called `babel.config.js` in your project's root directory. The existence of this `babel.config.js` file will tell React Native to use your custom Babel configuration instead of its own. Then load this preset:
+
+```
+{
+  "presets": ["module:@react-native/babel-preset"]
+}
+```
+
+You can further customize your Babel configuration by specifying plugins and other options. See [Babel's `babel.config.js` documentation](https://babeljs.io/docs/en/config-files/) to learn more.
+
+## Help and Support
+
+If you get stuck configuring Babel, please ask a question on Stack Overflow or find a consultant for help. If you discover a bug, please open up an issue.

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@react-native/babel-preset",
+  "version": "0.73.0",
+  "description": "Babel preset for React Native applications",
+  "main": "src/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:facebook/react-native.git",
+    "directory": "packages/react-native-babel-preset"
+  },
+  "scripts": {
+    "prepare-release": "test -d build && rm -rf src.real && mv src src.real && mv build src",
+    "cleanup-release": "test ! -e build && mv src build && mv src.real src"
+  },
+  "keywords": [
+    "babel",
+    "preset",
+    "react-native"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@babel/core": "^7.20.0",
+    "@babel/plugin-proposal-async-generator-functions": "^7.0.0",
+    "@babel/plugin-proposal-class-properties": "^7.0.0",
+    "@babel/plugin-proposal-export-default-from": "^7.0.0",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.0.0",
+    "@babel/plugin-proposal-numeric-separator": "^7.0.0",
+    "@babel/plugin-proposal-object-rest-spread": "^7.0.0",
+    "@babel/plugin-proposal-optional-catch-binding": "^7.0.0",
+    "@babel/plugin-proposal-optional-chaining": "^7.0.0",
+    "@babel/plugin-syntax-dynamic-import": "^7.0.0",
+    "@babel/plugin-syntax-export-default-from": "^7.0.0",
+    "@babel/plugin-syntax-flow": "^7.18.0",
+    "@babel/plugin-syntax-nullish-coalescing-operator": "^7.0.0",
+    "@babel/plugin-syntax-optional-chaining": "^7.0.0",
+    "@babel/plugin-transform-arrow-functions": "^7.0.0",
+    "@babel/plugin-transform-async-to-generator": "^7.0.0",
+    "@babel/plugin-transform-block-scoping": "^7.0.0",
+    "@babel/plugin-transform-classes": "^7.0.0",
+    "@babel/plugin-transform-computed-properties": "^7.0.0",
+    "@babel/plugin-transform-destructuring": "^7.0.0",
+    "@babel/plugin-transform-flow-strip-types": "^7.0.0",
+    "@babel/plugin-transform-function-name": "^7.0.0",
+    "@babel/plugin-transform-literals": "^7.0.0",
+    "@babel/plugin-transform-modules-commonjs": "^7.0.0",
+    "@babel/plugin-transform-named-capturing-groups-regex": "^7.0.0",
+    "@babel/plugin-transform-parameters": "^7.0.0",
+    "@babel/plugin-transform-react-display-name": "^7.0.0",
+    "@babel/plugin-transform-react-jsx": "^7.0.0",
+    "@babel/plugin-transform-react-jsx-self": "^7.0.0",
+    "@babel/plugin-transform-react-jsx-source": "^7.0.0",
+    "@babel/plugin-transform-runtime": "^7.0.0",
+    "@babel/plugin-transform-shorthand-properties": "^7.0.0",
+    "@babel/plugin-transform-spread": "^7.0.0",
+    "@babel/plugin-transform-sticky-regex": "^7.0.0",
+    "@babel/plugin-transform-typescript": "^7.5.0",
+    "@babel/plugin-transform-unicode-regex": "^7.0.0",
+    "@babel/template": "^7.0.0",
+    "babel-plugin-transform-flow-enums": "^0.0.2",
+    "react-refresh": "^0.4.0"
+  },
+  "peerDependencies": {
+    "@babel/core": "*"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/src/configs/hmr.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+'use strict';
+
+module.exports = function () {
+  return {
+    plugins: [require('react-refresh/babel')],
+  };
+};

package/src/configs/lazy-imports.js

@@ -0,0 +1,93 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+// This is the set of modules that React Native publicly exports and that we
+// want to require lazily. Keep this list in sync with
+// react-native/index.js (though having extra entries here is fairly harmless).
+
+'use strict';
+
+module.exports = new Set([
+  'AccessibilityInfo',
+  'ActivityIndicator',
+  'Button',
+  'DatePickerIOS',
+  'DrawerLayoutAndroid',
+  'FlatList',
+  'Image',
+  'ImageBackground',
+  'InputAccessoryView',
+  'KeyboardAvoidingView',
+  'Modal',
+  'Pressable',
+  'ProgressBarAndroid',
+  'ProgressViewIOS',
+  'SafeAreaView',
+  'ScrollView',
+  'SectionList',
+  'Slider',
+  'Switch',
+  'RefreshControl',
+  'StatusBar',
+  'Text',
+  'TextInput',
+  'Touchable',
+  'TouchableHighlight',
+  'TouchableNativeFeedback',
+  'TouchableOpacity',
+  'TouchableWithoutFeedback',
+  'View',
+  'VirtualizedList',
+  'VirtualizedSectionList',
+
+  // APIs
+  'ActionSheetIOS',
+  'Alert',
+  'Animated',
+  'Appearance',
+  'AppRegistry',
+  'AppState',
+  'AsyncStorage',
+  'BackHandler',
+  'Clipboard',
+  'DeviceInfo',
+  'Dimensions',
+  'Easing',
+  'ReactNative',
+  'I18nManager',
+  'InteractionManager',
+  'Keyboard',
+  'LayoutAnimation',
+  'Linking',
+  'LogBox',
+  'NativeEventEmitter',
+  'PanResponder',
+  'PermissionsAndroid',
+  'PixelRatio',
+  'PushNotificationIOS',
+  'Settings',
+  'Share',
+  'StyleSheet',
+  'Systrace',
+  'ToastAndroid',
+  'TVEventHandler',
+  'UIManager',
+  'ReactNative',
+  'UTFSequence',
+  'Vibration',
+
+  // Plugins
+  'RCTDeviceEventEmitter',
+  'RCTNativeAppEventEmitter',
+  'NativeModules',
+  'Platform',
+  'processColor',
+  'requireNativeComponent',
+]);

package/src/configs/main.js

@@ -0,0 +1,215 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+'use strict';
+
+const passthroughSyntaxPlugins = require('../passthrough-syntax-plugins');
+const lazyImports = require('./lazy-imports');
+
+function isTypeScriptSource(fileName) {
+  return !!fileName && fileName.endsWith('.ts');
+}
+
+function isTSXSource(fileName) {
+  return !!fileName && fileName.endsWith('.tsx');
+}
+
+const defaultPlugins = [
+  [require('@babel/plugin-syntax-flow')],
+  [require('babel-plugin-transform-flow-enums')],
+  [require('@babel/plugin-transform-block-scoping')],
+  [
+    require('@babel/plugin-proposal-class-properties'),
+    // use `this.foo = bar` instead of `this.defineProperty('foo', ...)`
+    {loose: true},
+  ],
+  [require('@babel/plugin-syntax-dynamic-import')],
+  [require('@babel/plugin-syntax-export-default-from')],
+  ...passthroughSyntaxPlugins,
+  [require('@babel/plugin-transform-unicode-regex')],
+];
+
+const getPreset = (src, options) => {
+  const transformProfile =
+    (options && options.unstable_transformProfile) || 'default';
+  const isHermesStable = transformProfile === 'hermes-stable';
+  const isHermesCanary = transformProfile === 'hermes-canary';
+  const isHermes = isHermesStable || isHermesCanary;
+
+  const isNull = src == null;
+  const hasClass = isNull || src.indexOf('class') !== -1;
+
+  const extraPlugins = [];
+  if (!options.useTransformReactJSXExperimental) {
+    extraPlugins.push([
+      require('@babel/plugin-transform-react-jsx'),
+      {runtime: 'automatic'},
+    ]);
+  }
+
+  if (!options || !options.disableImportExportTransform) {
+    extraPlugins.push(
+      [require('@babel/plugin-proposal-export-default-from')],
+      [
+        require('@babel/plugin-transform-modules-commonjs'),
+        {
+          strict: false,
+          strictMode: false, // prevent "use strict" injections
+          lazy:
+            options && options.lazyImportExportTransform != null
+              ? options.lazyImportExportTransform
+              : importSpecifier => lazyImports.has(importSpecifier),
+          allowTopLevelThis: true, // dont rewrite global `this` -> `undefined`
+        },
+      ],
+    );
+  }
+
+  if (hasClass) {
+    extraPlugins.push([require('@babel/plugin-transform-classes')]);
+  }
+
+  // TODO(gaearon): put this back into '=>' indexOf bailout
+  // and patch react-refresh to not depend on this transform.
+  extraPlugins.push([require('@babel/plugin-transform-arrow-functions')]);
+
+  if (!isHermes) {
+    extraPlugins.push([require('@babel/plugin-transform-computed-properties')]);
+    extraPlugins.push([require('@babel/plugin-transform-parameters')]);
+    extraPlugins.push([
+      require('@babel/plugin-transform-shorthand-properties'),
+    ]);
+    extraPlugins.push([
+      require('@babel/plugin-proposal-optional-catch-binding'),
+    ]);
+    extraPlugins.push([require('@babel/plugin-transform-function-name')]);
+    extraPlugins.push([require('@babel/plugin-transform-literals')]);
+    extraPlugins.push([require('@babel/plugin-proposal-numeric-separator')]);
+    extraPlugins.push([require('@babel/plugin-transform-sticky-regex')]);
+  } else {
+    extraPlugins.push([
+      require('@babel/plugin-transform-named-capturing-groups-regex'),
+    ]);
+  }
+  if (!isHermesCanary) {
+    extraPlugins.push([
+      require('@babel/plugin-transform-destructuring'),
+      {useBuiltIns: true},
+    ]);
+  }
+  if (!isHermes && (isNull || hasClass || src.indexOf('...') !== -1)) {
+    extraPlugins.push(
+      [require('@babel/plugin-transform-spread')],
+      [
+        require('@babel/plugin-proposal-object-rest-spread'),
+        // Assume no dependence on getters or evaluation order. See https://github.com/babel/babel/pull/11520
+        {loose: true, useBuiltIns: true},
+      ],
+    );
+  }
+  if (isNull || src.indexOf('async') !== -1) {
+    extraPlugins.push([
+      require('@babel/plugin-proposal-async-generator-functions'),
+    ]);
+    extraPlugins.push([require('@babel/plugin-transform-async-to-generator')]);
+  }
+  if (
+    isNull ||
+    src.indexOf('React.createClass') !== -1 ||
+    src.indexOf('createReactClass') !== -1
+  ) {
+    extraPlugins.push([require('@babel/plugin-transform-react-display-name')]);
+  }
+  if (!isHermes && (isNull || src.indexOf('?.') !== -1)) {
+    extraPlugins.push([
+      require('@babel/plugin-proposal-optional-chaining'),
+      {loose: true},
+    ]);
+  }
+  if (!isHermes && (isNull || src.indexOf('??') !== -1)) {
+    extraPlugins.push([
+      require('@babel/plugin-proposal-nullish-coalescing-operator'),
+      {loose: true},
+    ]);
+  }
+
+  if (options && options.dev && !options.useTransformReactJSXExperimental) {
+    extraPlugins.push([require('@babel/plugin-transform-react-jsx-source')]);
+    extraPlugins.push([require('@babel/plugin-transform-react-jsx-self')]);
+  }
+
+  if (!options || options.enableBabelRuntime !== false) {
+    // Allows configuring a specific runtime version to optimize output
+    const isVersion = typeof options?.enableBabelRuntime === 'string';
+
+    extraPlugins.push([
+      require('@babel/plugin-transform-runtime'),
+      {
+        helpers: true,
+        regenerator: !isHermes,
+        ...(isVersion && {version: options.enableBabelRuntime}),
+      },
+    ]);
+  }
+
+  return {
+    comments: false,
+    compact: true,
+    overrides: [
+      // the flow strip types plugin must go BEFORE class properties!
+      // there'll be a test case that fails if you don't.
+      {
+        plugins: [require('@babel/plugin-transform-flow-strip-types')],
+      },
+      {
+        plugins: defaultPlugins,
+      },
+      {
+        test: isTypeScriptSource,
+        plugins: [
+          [
+            require('@babel/plugin-transform-typescript'),
+            {
+              isTSX: false,
+              allowNamespaces: true,
+            },
+          ],
+        ],
+      },
+      {
+        test: isTSXSource,
+        plugins: [
+          [
+            require('@babel/plugin-transform-typescript'),
+            {
+              isTSX: true,
+              allowNamespaces: true,
+            },
+          ],
+        ],
+      },
+      {
+        plugins: extraPlugins,
+      },
+    ],
+  };
+};
+
+module.exports = options => {
+  if (options.withDevTools == null) {
+    const env = process.env.BABEL_ENV || process.env.NODE_ENV;
+    if (!env || env === 'development') {
+      return getPreset(null, {...options, dev: true});
+    }
+  }
+  return getPreset(null, options);
+};
+
+module.exports.getPreset = getPreset;

package/src/index.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+'use strict';
+
+const main = require('./configs/main');
+
+module.exports = function (babel, options) {
+  return main(options);
+};
+
+module.exports.getPreset = main.getPreset;
+module.exports.passthroughSyntaxPlugins = require('./passthrough-syntax-plugins');

package/src/passthrough-syntax-plugins.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+'use strict';
+
+// This list of syntax plugins is used for two purposes:
+// 1. Enabling experimental syntax features in the INPUT to the Metro Babel
+//    transformer, regardless of whether we actually transform them.
+// 2. Enabling these same features in parser passes that consume the OUTPUT of
+//    the Metro Babel transformer.
+const passthroughSyntaxPlugins = [
+  [require('@babel/plugin-syntax-nullish-coalescing-operator')],
+  [require('@babel/plugin-syntax-optional-chaining')],
+];
+
+module.exports = passthroughSyntaxPlugins;