Merge branch 'main' into nc/internal-mirror

Author: cortinico

docs/_integration-with-existing-apps-kotlin.md

@@ -424,7 +424,7 @@ class MyReactActivity : ReactActivity() {
 </TabItem>
 </Tabs>
 
-As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.77-stable/template/android/app/src/main/java/com/helloworld/MainApplication.kt)
+As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.80-stable/template/android/app/src/main/java/com/helloworld/MainActivity.kt)
 
 Whenever you create a new Activity, you need to add it to your `AndroidManifest.xml` file. You also need set the theme of `MyReactActivity` to `Theme.AppCompat.Light.NoActionBar` (or to any non-ActionBar theme) as otherwise your application will render an ActionBar on top of your React Native screen:
 

docs/layout-props.md

@@ -661,6 +661,21 @@ It works similarly to `height` in CSS, but in React Native you must use points o
 
 ---
 
+### `isolation`
+
+`isolation` lets you form a [stacking context](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_positioned_layout/Stacking_context). This prop is only available on the [New Architecture](/architecture/landing-page).
+
+There are two values:
+
+- `auto` (default): Does nothing.
+- `isolate`: Forms a stacking context.
+
+| Type                    | Required |
+| ----------------------- | -------- |
+| enum('auto', 'isolate') | No       |
+
+---
+
 ### `justifyContent`
 
 `justifyContent` aligns children in the main direction. For example, if children are flowing vertically, `justifyContent` controls how they align vertically. It works like `justify-content` in CSS (default: flex-start). See https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content for more details.

docs/safeareaview.md

@@ -3,6 +3,8 @@ id: safeareaview
 title: SafeAreaView
 ---
 
+> **Deprecated.** Use [react-native-safe-area-context](https://github.com/AppAndFlow/react-native-safe-area-context) instead.
+
 The purpose of `SafeAreaView` is to render content within the safe area boundaries of a device. It is currently only applicable to iOS devices with iOS version 11 or later.
 
 `SafeAreaView` renders nested content and automatically applies padding to reflect the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. Moreover, and most importantly, Safe Area's paddings reflect the physical limitation of the screen, such as rounded corners or camera notches (i.e. the sensor housing area on iPhone 13).

docs/the-new-architecture/using-codegen.md

@@ -39,7 +39,7 @@ npx @react-native-community/cli@latest init SampleApp --version 0.76.0
       "modules": {
         "TestModule": {
           "className": "<iOS-class-implementing-the-RCTModuleProvider-protocol>",
-          "unstableRequiresMainQueueSetup": false
+          "unstableRequiresMainQueueSetup": false,
           "conformsToProtocols": ["RCTImageURLLoader", "RCTURLRequestHandler", "RCTImageDataDecoder"],
         }
       },
@@ -54,7 +54,7 @@ npx @react-native-community/cli@latest init SampleApp --version 0.76.0
 
 You can add this snippet to your app and customize the various fields:
 
-- `name:` Name of the codegen config. This will customize the codgen output: the filenames, and the code.
+- `name:` Name of the codegen config. This will customize the codegen output: the filenames, and the code.
 - `type:`
   - `modules:` Only generate code for modules.
   - `components:` Only generate code for components.

docs/turbo-native-modules-ios.md

@@ -139,10 +139,11 @@ Modify the `package.json` as it follows:
        "javaPackageName": "com.sampleapp.specs"
      }
      // highlight-add-start
-     "ios":
+     "ios": {
         "modulesProvider": {
           "NativeLocalStorage": "RCTNativeLocalStorage"
         }
+    },
      // highlight-add-end
    },
 

website/contributing/how-to-contribute-code.md

@@ -32,6 +32,7 @@ Now you are set up to run several commands:
 - `yarn test-ios` runs the iOS test suite (macOS required).
 - `yarn build` builds all configured packages — in general, this command only needs to be run by CI ahead of publishing.
   - Packages which require a build are configured in [scripts/build/config.js](https://github.com/facebook/react-native/blob/main/scripts/build/config.js).
+- `yarn build-types` generates TypeScript types for the public API and updates the snapshot.
 
 ## Testing your Changes
 
@@ -70,11 +71,12 @@ Code-level contributions to React Native generally come in the form of [a pull r
 3. If you've changed APIs, update the documentation.
 4. Ensure the test suite passes, either locally or on CI once you opened a pull request.
 5. Make sure your code lints (for example via `yarn lint --fix`).
-6. Push the changes to your fork.
-7. Create a pull request to the React Native repository.
-8. Review and address comments on your pull request.
-9. A bot may comment with suggestions. Generally we ask you to resolve these first before a maintainer will review your code.
-10. If you haven't already, submit the [Contributor License Agreement ("CLA")](#contributor-license-agreement).
+6. Verify if your code modifies the JS public API with `yarn build-types --validate`. If so, regenerate the snapshot using `yarn build-types`.
+7. Push the changes to your fork.
+8. Create a pull request to the React Native repository.
+9. Review and address comments on your pull request.
+10. A bot may comment with suggestions. Generally we ask you to resolve these first before a maintainer will review your code.
+11. If you haven't already, submit the [Contributor License Agreement ("CLA")](#contributor-license-agreement).
 
 If all goes well, your pull request will be merged. If it is not merged, maintainers will do their best to explain their reasoning.
 

website/versioned_docs/version-0.76/_integration-with-existing-apps-kotlin.md

@@ -424,7 +424,7 @@ class MyReactActivity : ReactActivity() {
 </TabItem>
 </Tabs>
 
-As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.76-stable/template/android/app/src/main/java/com/helloworld/MainApplication.kt)
+As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.76-stable/template/android/app/src/main/java/com/helloworld/MainActivity.kt)
 
 Whenever you create a new Activity, you need to add it to your `AndroidManifest.xml` file. You also need set the theme of `MyReactActivity` to `Theme.AppCompat.Light.NoActionBar` (or to any non-ActionBar theme) as otherwise your application will render an ActionBar on top of your React Native screen:
 

website/versioned_docs/version-0.76/layout-props.md

@@ -651,6 +651,21 @@ It works similarly to `height` in CSS, but in React Native you must use points o
 
 ---
 
+### `isolation`
+
+`isolation` lets you form a [stacking context](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_positioned_layout/Stacking_context). This prop is only available on the [New Architecture](/architecture/landing-page).
+
+There are two values:
+
+- `auto` (default): Does nothing.
+- `isolate`: Forms a stacking context.
+
+| Type                    | Required |
+| ----------------------- | -------- |
+| enum('auto', 'isolate') | No       |
+
+---
+
 ### `justifyContent`
 
 `justifyContent` aligns children in the main direction. For example, if children are flowing vertically, `justifyContent` controls how they align vertically. It works like `justify-content` in CSS (default: flex-start). See https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content for more details.

website/versioned_docs/version-0.77/_integration-with-existing-apps-kotlin.md

@@ -424,7 +424,7 @@ class MyReactActivity : ReactActivity() {
 </TabItem>
 </Tabs>
 
-As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.77-stable/template/android/app/src/main/java/com/helloworld/MainApplication.kt)
+As usual, here the [MainActivity.kt Community template file as reference](https://github.com/react-native-community/template/blob/0.77-stable/template/android/app/src/main/java/com/helloworld/MainActivity.kt)
 
 Whenever you create a new Activity, you need to add it to your `AndroidManifest.xml` file. You also need set the theme of `MyReactActivity` to `Theme.AppCompat.Light.NoActionBar` (or to any non-ActionBar theme) as otherwise your application will render an ActionBar on top of your React Native screen:
 

website/versioned_docs/version-0.77/layout-props.md

@@ -661,6 +661,21 @@ It works similarly to `height` in CSS, but in React Native you must use points o
 
 ---
 
+### `isolation`
+
+`isolation` lets you form a [stacking context](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_positioned_layout/Stacking_context). This prop is only available on the [New Architecture](/architecture/landing-page).
+
+There are two values:
+
+- `auto` (default): Does nothing.
+- `isolate`: Forms a stacking context.
+
+| Type                    | Required |
+| ----------------------- | -------- |
+| enum('auto', 'isolate') | No       |
+
+---
+
 ### `justifyContent`
 
 `justifyContent` aligns children in the main direction. For example, if children are flowing vertically, `justifyContent` controls how they align vertically. It works like `justify-content` in CSS (default: flex-start). See https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content for more details.