Add ios_assume_nonnull flag to react native codegen library (#31543)

Summary:
Pull Request resolved: #31543

Changelog:
[iOS][Added] - Description

When compiling iOS apps with flag `-Wnullability-completeness` (like Lightspeed app and soon Instagram), Objective-C headers are required to either have full *explicit* nullability annotations on all members of its public API, or none at all; partially annotated headers will fail to build that module.

RN native modules are currently generated with *partial* annotations.  This works today because most apps are not compiled with `-Wnullability-completeness` turned on. But when we flip the switch for Instagram, the app doesn't build due to importing these RN partially annotated modules.

JavsScript Flow types are implied nonnull, and the current RN codegen translates Flow's [maybe/optional](https://flow.org/en/docs/types/maybe/) type to Obj-C `_Nullable` annotation, and everything else without an explicit Obj-C annotation. However this creates a mismatch with the Obj-C type system, where the implied default is *unannotated*, which is handled differently from nonnull when built with the nullability compiler flags.

There is a simple Obj-C macro that automatically adds *explicit nonnull* annotations to all members in a header: `NS_ASSUME_NONNULL_BEGIN` / `NS_ASSUME_NONNULL_END`. If we add this to *all* RN-generated headers, however, we run into issues:
1) We may erroneously assume any previously-unannotated header was meant to be nonnull and cause future bugs
2) Another compiler flag (`-Wnullable-to-nonnull-conversion`) statically analyzes Obj-C implementation code to prevent us from ever passing null to one of these headers. Much existing Obj-C code will break here, and it's ambiguous if these are true or false positives because of the first point.

Instead, in this diff we add a new BUCK flag `ios_assume_nonnull` to let module authors opt into automatic nonnull for unannotated members so that Obj-C headers are generated correctly in alignment with Flow's type system. We can migrate all libraries individually as needed and eventually make this the RN native codegen default.

Reviewed By: RSNara

Differential Revision: D28396446

fbshipit-source-id: ad3a3a97ab19183df4ef504b1c3140596c8f69ca

Author: Erich Graham

Libraries/BUCK

@@ -12,6 +12,7 @@ rn_codegen(
     name = "FBReactNativeSpec",
     android_package_name = "com.facebook.fbreact.specs",
     codegen_modules = True,
+    ios_assume_nonnull = False,
     library_labels = ["supermodule:xplat/default/public.react_native.infra"],
     native_module_spec_name = "FBReactNativeSpec",
 )
@@ -20,5 +21,6 @@ rn_codegen(
 rn_codegen(
     name = "FBReactNativeComponentSpec",
     codegen_components = True,
+    ios_assume_nonnull = False,
     library_labels = ["supermodule:xplat/default/public.react_native.infra"],
 )

packages/react-native-codegen/BUCK

@@ -29,6 +29,7 @@ rn_codegen_components(
 rn_codegen_modules(
     name = "FBReactNativeTestSpec",
     android_package_name = "com.facebook.fbreact.specs",
+    ios_assume_nonnull = False,
     schema_target = ":codegen_tests_schema",
 )
 

packages/react-native-codegen/DEFS.bzl

@@ -105,6 +105,7 @@ def rn_codegen_cli():
 def rn_codegen_modules(
         name,
         android_package_name,
+        ios_assume_nonnull,
         library_labels = [],
         schema_target = ""):
     generate_fixtures_rule_name = "{}-codegen-modules".format(name)
@@ -118,11 +119,12 @@ def rn_codegen_modules(
     fb_native.genrule(
         name = generate_fixtures_rule_name,
         srcs = native.glob(["src/generators/**/*.js"]),
-        cmd = "$(exe {generator_script}) $(location {schema_target}) {library_name} $OUT {android_package_name}".format(
+        cmd = "$(exe {generator_script}) $(location {schema_target}) {library_name} $OUT {android_package_name} {ios_assume_nonnull}".format(
             generator_script = react_native_root_target("packages/react-native-codegen:generate_all_from_schema"),
             schema_target = schema_target,
             library_name = name,
             android_package_name = android_package_name,
+            ios_assume_nonnull = ios_assume_nonnull,
         ),
         out = "codegenfiles-{}".format(name),
         labels = ["codegen_rule"],

packages/react-native-codegen/e2e/__tests__/modules/GenerateModuleObjCpp-test.js

@@ -38,13 +38,19 @@ function getModules(): SchemaType {
 describe('GenerateModuleObjCpp', () => {
   it('can generate a header file NativeModule specs', () => {
     const libName = 'RNCodegenModuleFixtures';
-    const output = generator.generate(libName, getModules());
+    const output = generator.generate(libName, getModules(), undefined, false);
+    expect(output.get(libName + '.h')).toMatchSnapshot();
+  });
+
+  it('can generate a header file NativeModule specs with assume nonnull enabled', () => {
+    const libName = 'RNCodegenModuleFixtures';
+    const output = generator.generate(libName, getModules(), undefined, true);
     expect(output.get(libName + '.h')).toMatchSnapshot();
   });
 
   it('can generate an implementation file NativeModule specs', () => {
     const libName = 'RNCodegenModuleFixtures';
-    const output = generator.generate(libName, getModules());
+    const output = generator.generate(libName, getModules(), undefined, false);
     expect(output.get(libName + '-generated.mm')).toMatchSnapshot();
   });
 });