Add JSMode pragma option (facebook#52822)

Summary:

Adds an additional pragma allowing tests to specify which mode JS should run in. By default this new JS mode will match the regular selected mode, and only shows up in the title if it differs.

### View ###

| (index) | Task name                                                 | Latency average (ns)   | Latency median (ns)        | Throughput average (ops/s) | Throughput median (ops/s) | Samples |
| ------- | --------------------------------------------------------- | ---------------------- | -------------------------- | -------------------------- | ------------------------- | ------- |
| 0       | 'render 100 uncollapsable views'                          | '22196658.83 ± 0.55%'  | '22105506.50 ± 14452.50'   | '45 ± 0.52%'               | '45'                      | 64      |
| 1       | 'render 1000 uncollapsable views'                         | '261264120.72 ± 0.51%' | '260129906.50 ± 4932.50'   | '4 ± 0.47%'                | '4'                       | 64      |
| 2       | 'render 100 views with large amount of props and styles'  | '46221879.73 ± 1.32%'  | '45766943.00 ± 175.00'     | '22 ± 0.96%'               | '22'                      | 64      |
| 3       | 'render 1000 views with large amount of props and styles' | '511129295.53 ± 1.11%' | '507136026.50 ± 110.50'    | '2 ± 0.85%'                | '2'                       | 64      |
| 4       | 'render 1500 views with large amount of props and styles' | '809121466.03 ± 0.98%' | '805250386.00 ± 124858.00' | '1 ± 0.75%'                | '1'                       | 64      |

### View (mode 🚀, jsMode 🐛) ###

| (index) | Task name                                                 | Latency average (ns)   | Latency median (ns)        | Throughput average (ops/s) | Throughput median (ops/s) | Samples |
| ------- | --------------------------------------------------------- | ---------------------- | -------------------------- | -------------------------- | ------------------------- | ------- |
| 0       | 'render 100 uncollapsable views'                          | '10159906.01 ± 1.31%'  | '9852036.00'               | '99 ± 1.17%'               | '102'                     | 99      |
| 1       | 'render 1000 uncollapsable views'                         | '140887334.83 ± 1.46%' | '139692094.50 ± 95652.50'  | '7 ± 1.14%'                | '7'                       | 64      |
| 2       | 'render 100 views with large amount of props and styles'  | '23331150.55 ± 1.60%'  | '22600244.50 ± 24962.50'   | '43 ± 1.34%'               | '44'                      | 64      |
| 3       | 'render 1000 views with large amount of props and styles' | '273211225.98 ± 1.41%' | '272005374.00 ± 115394.00' | '4 ± 1.20%'                | '4'                       | 64      |
| 4       | 'render 1500 views with large amount of props and styles' | '442607142.55 ± 1.20%' | '434820116.00 ± 455811.00' | '2 ± 1.04%'                | '2'                       | 64      |


### View (mode 🚀) ###

| (index) | Task name                                                 | Latency average (ns)   | Latency median (ns)        | Throughput average (ops/s) | Throughput median (ops/s) | Samples |
| ------- | --------------------------------------------------------- | ---------------------- | -------------------------- | -------------------------- | ------------------------- | ------- |
| 0       | 'render 100 uncollapsable views'                          | '4104493.33 ± 2.08%'   | '3923198.00 ± 110.00'      | '248 ± 1.32%'              | '255'                     | 244     |
| 1       | 'render 1000 uncollapsable views'                         | '87679050.92 ± 1.28%'  | '87123912.50 ± 5743.50'    | '11 ± 1.26%'               | '11'                      | 64      |
| 2       | 'render 100 views with large amount of props and styles'  | '14064648.78 ± 1.90%'  | '13587137.00 ± 6355.00'    | '71 ± 1.50%'               | '74'                      | 72      |
| 3       | 'render 1000 views with large amount of props and styles' | '184107829.77 ± 0.77%' | '183228851.00 ± 53144.00'  | '5 ± 0.77%'                | '5'                       | 64      |
| 4       | 'render 1500 views with large amount of props and styles' | '317639710.20 ± 1.17%' | '310442132.00 ± 366431.00' | '3 ± 1.11%'                | '3'                       | 64      |

Changelog: [Internal]

Differential Revision: D78912257

Author: sbuggay

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

@@ -14,6 +14,7 @@ import type {HermesVariant} from '../runner/utils';
 
 import {
   FantomTestConfigHermesVariant,
+  FantomTestConfigJsMode,
   FantomTestConfigMode,
 } from '../runner/getFantomTestConfigs';
 import {getOverrides} from './getFantomTestConfigs';
@@ -29,6 +30,15 @@ function formatFantomMode(mode: FantomTestConfigMode): string {
   }
 }
 
+function formatFantomJsMode(mode: FantomTestConfigJsMode): string {
+  switch (mode) {
+    case FantomTestConfigJsMode.Development:
+      return 'jsMode 🐛';
+    case FantomTestConfigJsMode.Optimized:
+      return 'jsMode 🚀';
+  }
+}
+
 function formatFantomHermesVariant(hermesVariant: HermesVariant): string {
   switch (hermesVariant) {
     case FantomTestConfigHermesVariant.Hermes:
@@ -61,6 +71,16 @@ export default function formatFantomConfig(config: FantomTestConfig): string {
     parts.push(formatFantomMode(overrides.mode));
   }
 
+  // Show if the jsMode is different from the mode
+  if (
+    (config.jsMode === FantomTestConfigJsMode.Optimized &&
+      config.mode !== FantomTestConfigMode.Optimized) ||
+    (config.jsMode === FantomTestConfigJsMode.Development &&
+      config.mode === FantomTestConfigMode.Optimized)
+  ) {
+    parts.push(formatFantomJsMode(config.jsMode));
+  }
+
   if (overrides.hermesVariant) {
     parts.push(formatFantomHermesVariant(overrides.hermesVariant));
   }

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

@@ -26,6 +26,11 @@ export enum FantomTestConfigMode {
   Optimized,
 }
 
+export enum FantomTestConfigJsMode {
+  Development,
+  Optimized,
+}
+
 export type FantomTestConfigCommonFeatureFlags = Partial<{
   [key in keyof CommonFeatureFlags]: CommonFeatureFlags[key]['defaultValue'],
 }>;
@@ -46,12 +51,14 @@ export type FantomTestConfigFeatureFlags = {
 
 export type FantomTestConfig = {
   mode: FantomTestConfigMode,
+  jsMode: FantomTestConfigJsMode,
   hermesVariant: HermesVariant,
   flags: FantomTestConfigFeatureFlags,
 };
 
 export type PartialFantomTestConfig = {
   mode?: FantomTestConfigMode,
+  jsMode?: FantomTestConfigJsMode,
   hermesVariant?: HermesVariant,
   flags?: Partial<FantomTestConfigFeatureFlags>,
 };
@@ -61,6 +68,9 @@ export const FantomTestConfigHermesVariant = HermesVariant;
 export const DEFAULT_MODE: FantomTestConfigMode =
   FantomTestConfigMode.DevelopmentWithSource;
 
+export const DEFAULT_JS_MODE: FantomTestConfigJsMode =
+  FantomTestConfigJsMode.Development;
+
 export const DEFAULT_HERMES_VARIANT: HermesVariant = HermesVariant.Hermes;
 
 export const DEFAULT_FEATURE_FLAGS: FantomTestConfigFeatureFlags = {
@@ -84,6 +94,7 @@ const MAX_FANTOM_CONFIGURATION_VARIATIONS = 12;
 
 const VALID_FANTOM_PRAGMAS = [
   'fantom_mode',
+  'fantom_js_mode',
   'fantom_flags',
   'fantom_hermes_variant',
   'fantom_react_fb_flags',
@@ -131,6 +142,7 @@ export function getOverrides(
  * /**
  *  * @flow strict-local
  *  * @fantom_mode opt
+ *  * @fantom_js_mode dev
  *  * @fantom_hermes_variant static_hermes_stable
  *  * @fantom_flags commonTestFlag:true
  *  * @fantom_flags jsOnlyTestFlag:true
@@ -163,6 +175,7 @@ export default function getFantomTestConfigs(
 
   const config: FantomTestConfig = {
     mode: DEFAULT_MODE,
+    jsMode: DEFAULT_JS_MODE,
     hermesVariant: DEFAULT_HERMES_VARIANT,
     flags: {
       common: {
@@ -217,6 +230,39 @@ export default function getFantomTestConfigs(
     }
   }
 
+  const maybeJsMode = pragmas.fantom_js_mode;
+
+  if (maybeJsMode != null) {
+    if (Array.isArray(maybeJsMode)) {
+      throw new Error('Expected a single value for @fantom_js_mode');
+    }
+
+    const jsMode = maybeJsMode;
+
+    switch (jsMode) {
+      case 'dev':
+        config.jsMode = FantomTestConfigJsMode.Development;
+        break;
+      case 'opt':
+        config.jsMode = FantomTestConfigJsMode.Optimized;
+        break;
+      case '*':
+        configVariations.push([
+          {jsMode: FantomTestConfigJsMode.Development},
+          {jsMode: FantomTestConfigJsMode.Optimized},
+        ]);
+        break;
+      default:
+        throw new Error(`Invalid Fantom jsMode: ${jsMode}`);
+    }
+  } else {
+    // If not set, match the native mode
+    config.jsMode =
+      config.mode === FantomTestConfigMode.Optimized
+        ? FantomTestConfigJsMode.Optimized
+        : FantomTestConfigJsMode.Development;
+  }
+
   const maybeHermesVariant = pragmas.fantom_hermes_variant;
 
   if (maybeHermesVariant != null) {
@@ -378,6 +424,7 @@ function getConfigurationVariations(
   for (const currentConfigVariation of currentConfigVariations) {
     const currentConfigWithVariation = {
       mode: currentConfigVariation.mode ?? config.mode,
+      jsMode: currentConfigVariation.jsMode ?? config.jsMode,
       hermesVariant:
         currentConfigVariation.hermesVariant ?? config.hermesVariant,
       flags: {

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

@@ -24,7 +24,10 @@ import entrypointTemplate from './entrypoint-template';
 import * as EnvironmentOptions from './EnvironmentOptions';
 import formatFantomConfig from './formatFantomConfig';
 import getFantomTestConfigs from './getFantomTestConfigs';
-import {FantomTestConfigMode} from './getFantomTestConfigs';
+import {
+  FantomTestConfigJsMode,
+  FantomTestConfigMode,
+} from './getFantomTestConfigs';
 import {
   getInitialSnapshotData,
   updateSnapshotsAndGetJestSnapshotResult,
@@ -317,12 +320,14 @@ module.exports = async function runTest(
       path.basename(testJSBundlePath, '.js') + '.map',
     );
 
+    const devMode = testConfig.jsMode !== FantomTestConfigJsMode.Optimized;
+
     await Metro.runBuild(metroConfig, {
       entry: entrypointPath,
       out: testJSBundlePath,
       platform: 'android',
-      minify: testConfig.mode === FantomTestConfigMode.Optimized,
-      dev: testConfig.mode !== FantomTestConfigMode.Optimized,
+      minify: !devMode,
+      dev: devMode,
       sourceMap: true,
       sourceMapUrl: sourceMapPath,
     });