Add granular control with pragma modes (#52894)

Summary:
Pull Request resolved: #52894

Adds the following boolean pragma modes for more granular control:

```
fantom_native_opt true|false
fantom_js_opt true|false
fantom_js_bytecode true|false
```

Previously these were all set together with `fantom_mode`. These modes are mutually exclusive with `fantom_mode`.

Changelog: [Internal]

Reviewed By: rubennorte

Differential Revision: D79151687

fbshipit-source-id: 59c3f20bccb570c0293ffd037609946a1a9bbb8f

Author: sbuggay

private/react-native-fantom/__docs__/README.md

@@ -132,9 +132,27 @@ Available pragmas:
   - Possible values:
     - `dev`: development, default for tests.
     - `opt`: optimized and using Hermes bytecode, default for benchmarks.
+- `@fantom_native_opt`: used to define the compilation mode for native code.
+  - Example: `@fantom_native_opt true`
+  - Possible values:
+    - `true`: optimized native code
+    - `false`: development native code
+- `@fantom_js_opt`: used to define the compilation mode for the JS bundle.
+  - Example: `@fantom_js_opt true`
+  - Possible values:
+    - `true`: optimized JS bundle
+    - `false`: development JS bundle
+- `@fantom_js_bytecode`: used to define if the JS bundle should use bytecode.
+  - Example: `@fantom_js_bytecode true`
+  - Possible values:
+    - `true`: using Hermes bytecode
+    - `false`: not using Hermes bytecode
 - `@fantom_react_fb_flags`: used to set overrides for internal React flags set
   in ReactNativeInternalFeatureFlags (Meta use only)
 
+Setting `@fantom_mode` is mutually exclusive with setting any of
+`@fantom_native_opt`, `@fantom_js_opt`, and `@fantom_js_bytecode`.
+
 For all pragmas, except non-boolean feature flags, you can use a wildcard (`*`)
 as value to run the test with all possible values for that pragma. For example,
 this test:

private/react-native-fantom/runner/getFantomTestConfigs.js

@@ -79,6 +79,9 @@ const MAX_FANTOM_CONFIGURATION_VARIATIONS = 12;
 
 const VALID_FANTOM_PRAGMAS = [
   'fantom_mode',
+  'fantom_native_opt',
+  'fantom_js_opt',
+  'fantom_js_bytecode',
   'fantom_flags',
   'fantom_hermes_variant',
   'fantom_react_fb_flags',
@@ -230,6 +233,56 @@ export default function getFantomTestConfigs(
       config.isJsOptimized = true;
       config.isJsBytecode = true;
     }
+
+    // Allow the benchmark regex to override these to true, but if the mode isn't set
+    // allow granular control with pragmas. Checking for both of them being set is handled by
+    // verifyFantomPragmas().
+    if (pragmas.fantom_native_opt !== undefined) {
+      if (pragmas.fantom_native_opt === '*') {
+        configVariations.push([
+          {
+            isNativeOptimized: false,
+          },
+          {
+            isNativeOptimized: true,
+          },
+        ]);
+      } else {
+        config.isNativeOptimized = parseFantomBoolean(
+          pragmas.fantom_native_opt,
+        );
+      }
+    }
+
+    if (pragmas.fantom_js_opt !== undefined) {
+      if (pragmas.fantom_js_opt === '*') {
+        configVariations.push([
+          {
+            isJsOptimized: false,
+          },
+          {
+            isJsOptimized: true,
+          },
+        ]);
+      } else {
+        config.isJsOptimized = parseFantomBoolean(pragmas.fantom_js_opt);
+      }
+    }
+
+    if (pragmas.fantom_js_bytecode !== undefined) {
+      if (pragmas.fantom_js_bytecode === '*') {
+        configVariations.push([
+          {
+            isJsBytecode: false,
+          },
+          {
+            isJsBytecode: true,
+          },
+        ]);
+      } else {
+        config.isJsBytecode = parseFantomBoolean(pragmas.fantom_js_bytecode);
+      }
+    }
   }
 
   const maybeHermesVariant = pragmas.fantom_hermes_variant;
@@ -460,7 +513,30 @@ function parseFeatureFlagValue<T: boolean | number | string>(
   }
 }
 
+function parseFantomBoolean(pragmaValue: string | Array<string>): boolean {
+  if (Array.isArray(pragmaValue)) {
+    throw new Error(`Expected a single value, got ${pragmaValue.join(', ')}`);
+  }
+
+  if (pragmaValue !== 'true' && pragmaValue !== 'false') {
+    throw new Error(`Expected a boolean, got ${pragmaValue}`);
+  }
+
+  return pragmaValue === 'true';
+}
+
 function verifyFantomPragmas(pragmas: DocblockPragmas): void {
+  if (
+    'fantom_mode' in pragmas &&
+    ('fantom_native_opt' in pragmas ||
+      'fantom_js_opt' in pragmas ||
+      'fantom_js_bytecode' in pragmas)
+  ) {
+    throw new Error(
+      'Cannot set @fantom_mode with @fantom_native_opt, @fantom_js_opt, or @fantom_js_bytecode',
+    );
+  }
+
   for (const pragma of Object.keys(pragmas)) {
     if (
       pragma.startsWith('fantom_') &&

private/react-native-fantom/src/__tests__/FantomModeDevBytecode-itest.js

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ *
+ * @fantom_js_bytecode true
+ * @flow strict-local
+ * @format
+ */
+
+describe('"@fantom_js_bytecode" in docblock', () => {
+  it('should use development builds', () => {
+    expect(__DEV__).toBe(true);
+  });
+});