@react-native-harness/metro 1.0.0 → 1.1.0-rc.2

package/dist/resolvers/tsconfig-resolver.js

@@ -1,160 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTsConfigResolver = exports.resolveWithTsConfigPaths = exports.loadTsConfigPaths = void 0;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const fs_1 = tslib_1.__importDefault(require("fs"));
-/**
- * Load tsconfig.json or jsconfig.json and extract path mappings
- */
-const loadTsConfigPaths = (projectRoot) => {
-    const configFiles = ['tsconfig.json', 'jsconfig.json'];
-    for (const configFile of configFiles) {
-        const configPath = path_1.default.join(projectRoot, configFile);
-        if (!fs_1.default.existsSync(configPath))
-            continue;
-        try {
-            const content = fs_1.default.readFileSync(configPath, 'utf8');
-            // Strip comments without touching string literals
-            const jsonContent = stripJsonComments(content);
-            const config = JSON.parse(jsonContent);
-            const compilerOptions = config.compilerOptions || {};
-            const paths = compilerOptions.paths || {};
-            const baseUrl = compilerOptions.baseUrl;
-            if (Object.keys(paths).length > 0 || baseUrl) {
-                return {
-                    paths,
-                    baseUrl: baseUrl ? path_1.default.resolve(projectRoot, baseUrl) : projectRoot,
-                    hasBaseUrl: !!baseUrl,
-                };
-            }
-        }
-        catch (error) {
-            console.warn(`Failed to parse ${configFile}:`, error);
-        }
-    }
-    return null;
-};
-exports.loadTsConfigPaths = loadTsConfigPaths;
-const stripJsonComments = (input) => {
-    let result = '';
-    let inString = false;
-    let stringChar = '';
-    let isEscaped = false;
-    let inLineComment = false;
-    let inBlockComment = false;
-    for (let i = 0; i < input.length; i += 1) {
-        const char = input[i];
-        const nextChar = input[i + 1];
-        if (inLineComment) {
-            if (char === '\n') {
-                inLineComment = false;
-                result += char;
-            }
-            continue;
-        }
-        if (inBlockComment) {
-            if (char === '*' && nextChar === '/') {
-                inBlockComment = false;
-                i += 1;
-            }
-            continue;
-        }
-        if (inString) {
-            result += char;
-            if (!isEscaped && char === stringChar) {
-                inString = false;
-                stringChar = '';
-            }
-            isEscaped = !isEscaped && char === '\\';
-            continue;
-        }
-        if (char === '"' || char === "'") {
-            inString = true;
-            stringChar = char;
-            result += char;
-            isEscaped = false;
-            continue;
-        }
-        if (char === '/' && nextChar === '/') {
-            inLineComment = true;
-            i += 1;
-            continue;
-        }
-        if (char === '/' && nextChar === '*') {
-            inBlockComment = true;
-            i += 1;
-            continue;
-        }
-        result += char;
-    }
-    return result;
-};
-/**
- * Match module name against tsconfig path pattern (supports wildcards)
- */
-const matchPattern = (pattern, moduleName) => {
-    const escapedPattern = pattern
-        .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
-        .replace(/\*/g, '(.*)');
-    const regex = new RegExp(`^${escapedPattern}$`);
-    const match = moduleName.match(regex);
-    return {
-        matched: !!match,
-        captured: match?.[1] || '',
-    };
-};
-/**
- * Resolve module using tsconfig path mappings
- * Use this directly in your custom resolver
- */
-const resolveWithTsConfigPaths = (tsConfig, context, moduleName, platform) => {
-    const { paths, baseUrl, hasBaseUrl } = tsConfig;
-    const resolveRequest = context.resolveRequest;
-    if (!resolveRequest) {
-        return null;
-    }
-    // Try path mappings first
-    for (const [pattern, targets] of Object.entries(paths)) {
-        const { matched, captured } = matchPattern(pattern, moduleName);
-        if (!matched)
-            continue;
-        // Try each target
-        for (const target of targets) {
-            const resolvedTarget = target.replace('*', captured);
-            const absolutePath = path_1.default.resolve(baseUrl, resolvedTarget);
-            try {
-                return resolveRequest(context, absolutePath, platform);
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    // Try baseUrl for non-relative imports
-    if (hasBaseUrl && !moduleName.startsWith('.') && !moduleName.startsWith('/')) {
-        const absolutePath = path_1.default.resolve(baseUrl, moduleName);
-        try {
-            return resolveRequest(context, absolutePath, platform);
-        }
-        catch {
-            // Fall through
-        }
-    }
-    return null;
-};
-exports.resolveWithTsConfigPaths = resolveWithTsConfigPaths;
-const createTsConfigResolver = (projectRoot) => {
-    const tsConfig = (0, exports.loadTsConfigPaths)(projectRoot);
-    return (context, moduleName, platform) => {
-        if (!tsConfig) {
-            return null;
-        }
-        if (!context.resolveRequest) {
-            return null;
-        }
-        const resolved = (0, exports.resolveWithTsConfigPaths)(tsConfig, context, moduleName, platform);
-        return resolved ?? null;
-    };
-};
-exports.createTsConfigResolver = createTsConfigResolver;

package/dist/resolvers/types.d.ts

@@ -1,4 +0,0 @@
-import type { CustomResolutionContext, Resolution } from 'metro-resolver';
-export type HarnessResolver = (context: CustomResolutionContext, moduleName: string, platform: string | null) => Resolution | null;
-export type MetroResolver = (context: CustomResolutionContext, moduleName: string, platform: string | null) => Resolution;
-//# sourceMappingURL=types.d.ts.map

package/dist/resolvers/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resolvers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,UAAU,GAAG,IAAI,CAAC;AACnI,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC"}

package/dist/resolvers/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -1,4 +0,0 @@
-export type NotReadOnly<T> = {
-    -readonly [K in keyof T]: T[K];
-};
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC"}

package/dist/utils.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/src/babel-transformer.ts

@@ -1,40 +0,0 @@
-import type { BabelTransformer } from 'metro-babel-transformer';
-import { rnHarnessPlugins } from '@react-native-harness/babel-preset';
-import { MetroConfig } from '@react-native/metro-config';
-
-export const getHarnessBabelTransformerPath = (
-  metroConfig: MetroConfig
-): string => {
-  const upstreamTransformerPath = metroConfig.transformer?.babelTransformerPath;
-
-  if (!upstreamTransformerPath || typeof upstreamTransformerPath !== 'string') {
-    throw new Error('Upstream transformer path is not a string');
-  }
-
-  process.env.RN_HARNESS_UPSTREAM_TRANSFORMER_PATH = upstreamTransformerPath;
-  return require.resolve('./babel-transformer.js');
-};
-
-const transform: BabelTransformer['transform'] = (args) => {
-  const { plugins } = args;
-  const upstreamTransformerPath =
-    process.env.RN_HARNESS_UPSTREAM_TRANSFORMER_PATH;
-
-  if (!upstreamTransformerPath || typeof upstreamTransformerPath !== 'string') {
-    throw new Error('Upstream transformer path is not a string');
-  }
-
-  const upstreamTransformer = require(upstreamTransformerPath);
-  const pluginsWithHarness = [
-    // Checked against @babel/core's type definitions - plugins are an array of PluginItem
-    ...((plugins as unknown[]) ?? []),
-    ...rnHarnessPlugins,
-  ];
-
-  return upstreamTransformer.transform({
-    ...args,
-    plugins: pluginsWithHarness,
-  });
-};
-
-export { transform };

package/src/errors.ts

@@ -1,6 +0,0 @@
-export class CouldNotPatchModuleSystemError extends Error {
-  constructor() {
-    super('Could not patch module system');
-    this.name = 'CouldNotPatchModuleSystemError';
-  }
-}

package/src/getHarnessSerializer.ts

@@ -1,46 +0,0 @@
-import type { MetroConfig } from 'metro-config';
-
-export type Serializer = NonNullable<
-  NonNullable<MetroConfig['serializer']>['customSerializer']
->;
-
-const getBaseSerializer = (): Serializer => {
-  const baseJSBundle = require('metro/private/DeltaBundler/Serializers/baseJSBundle');
-  const bundleToString = require('metro/private/lib/bundleToString');
-
-  return (entryPoint, prepend, graph, bundleOptions) =>
-    bundleToString(baseJSBundle(entryPoint, prepend, graph, bundleOptions));
-};
-
-const getAllFiles = require('metro/private/DeltaBundler/Serializers/getAllFiles');
-
-export const getHarnessSerializer = (): Serializer => {
-  const baseSerializer = getBaseSerializer();
-  let mainEntryPointModules = new Set<string>();
-
-  return async (entryPoint, preModules, graph, options) => {
-    if (options.modulesOnly) {
-      // This is most likely a test file
-      return baseSerializer(entryPoint, preModules, graph, {
-        ...options,
-        processModuleFilter: (mod) => {
-          if (
-            options.processModuleFilter &&
-            !options.processModuleFilter(mod)
-          ) {
-            // If the module is not allowed by the processModuleFilter, skip it
-            return false;
-          }
-
-          // If the module is in the main entry point, skip it
-          return !mainEntryPointModules.has(mod.path);
-        },
-      });
-    }
-
-    mainEntryPointModules = new Set(
-      await getAllFiles(preModules, graph, options)
-    );
-    return baseSerializer(entryPoint, preModules, graph, options);
-  };
-};

package/src/jest-globals-mock.ts

@@ -1,6 +0,0 @@
-// Mock module for @jest/globals imports
-// This module throws immediately when imported to warn users about using Jest APIs
-
-throw new Error(
-  "Importing '@jest/globals' is not supported in Harness tests. Import from 'react-native-harness' instead."
-);

package/src/manifest.ts

@@ -1,24 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import { Config as HarnessConfig } from '@react-native-harness/config';
-
-const getManifestContent = (harnessConfig: HarnessConfig): string => {
-  return `global.RN_HARNESS = { 
-    appRegistryComponentName: '${harnessConfig.appRegistryComponentName}',
-    webSocketPort: ${harnessConfig.webSocketPort},
-    disableViewFlattening: ${harnessConfig.disableViewFlattening},
-  };`;
-};
-
-export const getHarnessManifest = (harnessConfig: HarnessConfig): string => {
-  const manifestContent = getManifestContent(harnessConfig);
-  const manifestPath = path.resolve(
-    process.cwd(),
-    'node_modules/.cache/rn-harness/manifest.js'
-  );
-
-  fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
-  fs.writeFileSync(manifestPath, manifestContent);
-
-  return manifestPath;
-};

package/src/metro-cache.ts

@@ -1,24 +0,0 @@
-import { CacheStore, MetroCache } from 'metro-cache';
-import type { MixedOutput, TransformResult } from 'metro';
-import fs from 'node:fs';
-import path from 'node:path';
-import type { CacheStoresConfigT } from 'metro-config';
-
-const CACHE_ROOT = path.resolve(
-  process.cwd(),
-  'node_modules/.cache/rn-harness/metro-cache'
-);
-
-export const getHarnessCacheStores = (): ((
-  metroCache: MetroCache
-) => CacheStoresConfigT) => {
-  return ({ FileStore }) => {
-    fs.mkdirSync(CACHE_ROOT, { recursive: true });
-
-    return [
-      new FileStore({ root: CACHE_ROOT }) as CacheStore<
-        TransformResult<MixedOutput>
-      >,
-    ];
-  };
-};

package/src/resolvers/composite-resolver.ts

@@ -1,16 +0,0 @@
-import type { HarnessResolver, MetroResolver } from './types';
-
-export const createHarnessResolver = (
-  resolvers: HarnessResolver[]
-): MetroResolver => {
-  return (context, moduleName, platform) => {
-    for (const resolver of resolvers) {
-      const result = resolver(context, moduleName, platform);
-      if (result != null) {
-        return result;
-      }
-    }
-
-    return context.resolveRequest(context, moduleName, platform);
-  };
-};

package/src/resolvers/resolver.ts

@@ -1,100 +0,0 @@
-import type { MetroConfig } from '@react-native/metro-config';
-import type { Config as HarnessConfig } from '@react-native-harness/config';
-import path from 'node:path';
-import { createHarnessResolver } from './composite-resolver';
-import { createTsConfigResolver } from './tsconfig-resolver';
-import type { HarnessResolver, MetroResolver } from './types';
-
-// Safely resolves a path and strips its extension
-const getExtensionlessAbsolutePath = (basePath: string, relativePath = ''): string => {
-  const fullPath = path.resolve(basePath, relativePath);
-  const parsed = path.parse(fullPath);
-  return path.join(parsed.dir, parsed.name);
-}
-
-export const createHarnessEntryPointResolver = (harnessConfig: HarnessConfig): HarnessResolver => {
-  const rootPath = path.resolve(process.cwd());
-  const expectedEntryPoint = getExtensionlessAbsolutePath(rootPath, harnessConfig.entryPoint);
-  const resolvedHarnessPath = require.resolve('@react-native-harness/runtime/entry-point');
-
-  return (context, moduleName, _platform) => {
-    // 1. Resolve the origin path of the file making the import
-    const currentOrigin = path.resolve(context.originModulePath);
-
-    // Fast Fail: If the import isn't happening from the root directory, skip it immediately
-    if (currentOrigin !== rootPath) {
-      return null;
-    }
-
-    // 2. Resolve the module being imported and strip its extension
-    // This safely normalizes './index', './index.js', 'index.js', etc.
-    const requestedModule = getExtensionlessAbsolutePath(currentOrigin, moduleName);
-
-    // 3. String comparison
-    if (requestedModule === expectedEntryPoint) {
-      return {
-        type: 'sourceFile',
-        filePath: resolvedHarnessPath,
-      };
-    }
-
-    return null;
-  };
-};
-
-export const createJestGlobalsResolver = (): HarnessResolver => {
-  return (_context, moduleName, _platform) => {
-    // Intercept @jest/globals imports and redirect to mock module
-    if (moduleName === '@jest/globals') {
-      return {
-        type: 'sourceFile',
-        filePath: require.resolve('../jest-globals-mock'),
-      };
-    }
-
-    return null;
-  };
-};
-
-export const createJsxRuntimeResolver = (): HarnessResolver => {
-  const resolvedJsxRuntimePath = require.resolve(
-    '@react-native-harness/runtime/jsx-runtime'
-  );
-  const resolvedJsxDevRuntimePath = require.resolve(
-    '@react-native-harness/runtime/jsx-dev-runtime'
-  );
-
-  return (_context, moduleName, _platform) => {
-    if (moduleName === '@react-native-harness/runtime/jsx-runtime') {
-      return {
-        type: 'sourceFile',
-        filePath: resolvedJsxRuntimePath,
-      };
-    }
-
-    if (moduleName === '@react-native-harness/runtime/jsx-dev-runtime') {
-      return {
-        type: 'sourceFile',
-        filePath: resolvedJsxDevRuntimePath,
-      };
-    }
-
-    return null;
-  };
-};
-
-export const getHarnessResolver = (
-  metroConfig: MetroConfig,
-  harnessConfig: HarnessConfig
-): MetroResolver => {
-  const userResolver = metroConfig.resolver?.resolveRequest;
-  const resolvers: HarnessResolver[] = [
-    createHarnessEntryPointResolver(harnessConfig),
-    createJestGlobalsResolver(),
-    createJsxRuntimeResolver(),
-    createTsConfigResolver(process.cwd()),
-    userResolver,
-  ].filter((resolver): resolver is HarnessResolver => !!resolver);
-
-  return createHarnessResolver(resolvers);
-};

package/src/resolvers/tsconfig-resolver.ts

@@ -1,210 +0,0 @@
-import path from 'path';
-import fs from 'fs';
-import type { Resolution, CustomResolutionContext } from 'metro-resolver';
-import type { HarnessResolver } from './types';
-
-// This resolver is based on the Expo's implementation.
-// https://github.com/expo/expo/blob/main/packages/%40expo/cli/src/start/server/metro/withMetroMultiPlatform.ts
-// The reason to have it in Harness is that Expo doesn't set the resolveRequest function in the context.
-// In order for tsconfig's paths to work, we need to recreate this logic ourselves.
-
-export type TsConfigPaths = {
-	paths: Record<string, string[]>;
-	baseUrl: string;
-	hasBaseUrl: boolean;
-}
-
-/**
- * Load tsconfig.json or jsconfig.json and extract path mappings
- */
-export const loadTsConfigPaths = (
-	projectRoot: string
-): TsConfigPaths | null => {
-	const configFiles = ['tsconfig.json', 'jsconfig.json'];
-
-	for (const configFile of configFiles) {
-		const configPath = path.join(projectRoot, configFile);
-
-		if (!fs.existsSync(configPath)) continue;
-
-		try {
-			const content = fs.readFileSync(configPath, 'utf8');
-			// Strip comments without touching string literals
-			const jsonContent = stripJsonComments(content);
-			const config = JSON.parse(jsonContent);
-
-			const compilerOptions = config.compilerOptions || {};
-			const paths = compilerOptions.paths || {};
-			const baseUrl = compilerOptions.baseUrl;
-
-			if (Object.keys(paths).length > 0 || baseUrl) {
-				return {
-					paths,
-					baseUrl: baseUrl ? path.resolve(projectRoot, baseUrl) : projectRoot,
-					hasBaseUrl: !!baseUrl,
-				};
-			}
-		} catch (error) {
-			console.warn(`Failed to parse ${configFile}:`, error);
-		}
-	}
-
-	return null;
-};
-
-const stripJsonComments = (input: string): string => {
-	let result = '';
-	let inString = false;
-	let stringChar = '';
-	let isEscaped = false;
-	let inLineComment = false;
-	let inBlockComment = false;
-
-	for (let i = 0; i < input.length; i += 1) {
-		const char = input[i];
-		const nextChar = input[i + 1];
-
-		if (inLineComment) {
-			if (char === '\n') {
-				inLineComment = false;
-				result += char;
-			}
-			continue;
-		}
-
-		if (inBlockComment) {
-			if (char === '*' && nextChar === '/') {
-				inBlockComment = false;
-				i += 1;
-			}
-			continue;
-		}
-
-		if (inString) {
-			result += char;
-			if (!isEscaped && char === stringChar) {
-				inString = false;
-				stringChar = '';
-			}
-			isEscaped = !isEscaped && char === '\\';
-			continue;
-		}
-
-		if (char === '"' || char === "'") {
-			inString = true;
-			stringChar = char;
-			result += char;
-			isEscaped = false;
-			continue;
-		}
-
-		if (char === '/' && nextChar === '/') {
-			inLineComment = true;
-			i += 1;
-			continue;
-		}
-
-		if (char === '/' && nextChar === '*') {
-			inBlockComment = true;
-			i += 1;
-			continue;
-		}
-
-		result += char;
-	}
-
-	return result;
-};
-
-/**
- * Match module name against tsconfig path pattern (supports wildcards)
- */
-const matchPattern = (
-	pattern: string,
-	moduleName: string
-): { matched: boolean; captured: string } => {
-	const escapedPattern = pattern
-		.replace(/[.+?^${}()|[\]\\]/g, '\\$&')
-		.replace(/\*/g, '(.*)');
-
-	const regex = new RegExp(`^${escapedPattern}$`);
-	const match = moduleName.match(regex);
-
-	return {
-		matched: !!match,
-		captured: match?.[1] || '',
-	};
-};
-
-/**
- * Resolve module using tsconfig path mappings
- * Use this directly in your custom resolver
- */
-export const resolveWithTsConfigPaths = (
-	tsConfig: TsConfigPaths,
-	context: CustomResolutionContext,
-	moduleName: string,
-	platform: string | null
-): Resolution | null => {
-	const { paths, baseUrl, hasBaseUrl } = tsConfig;
-	const resolveRequest = context.resolveRequest;
-
-	if (!resolveRequest) {
-		return null;
-	}
-
-	// Try path mappings first
-	for (const [pattern, targets] of Object.entries(paths)) {
-		const { matched, captured } = matchPattern(pattern, moduleName);
-		if (!matched) continue;
-
-		// Try each target
-		for (const target of targets) {
-			const resolvedTarget = target.replace('*', captured);
-			const absolutePath = path.resolve(baseUrl, resolvedTarget);
-
-			try {
-				return resolveRequest(context, absolutePath, platform);
-			} catch {
-				continue;
-			}
-		}
-	}
-
-	// Try baseUrl for non-relative imports
-	if (hasBaseUrl && !moduleName.startsWith('.') && !moduleName.startsWith('/')) {
-		const absolutePath = path.resolve(baseUrl, moduleName);
-		try {
-			return resolveRequest(context, absolutePath, platform);
-		} catch {
-			// Fall through
-		}
-	}
-
-	return null;
-};
-
-export const createTsConfigResolver = (
-	projectRoot: string
-): HarnessResolver => {
-	const tsConfig = loadTsConfigPaths(projectRoot);
-
-	return (context, moduleName, platform) => {
-		if (!tsConfig) {
-			return null;
-		}
-
-		if (!context.resolveRequest) {
-			return null;
-		}
-
-		const resolved = resolveWithTsConfigPaths(
-			tsConfig,
-			context,
-			moduleName,
-			platform
-		);
-
-		return resolved ?? null;
-	};
-};

package/src/resolvers/types.ts

@@ -1,4 +0,0 @@
-import type { CustomResolutionContext, Resolution } from 'metro-resolver';
-
-export type HarnessResolver = (context: CustomResolutionContext, moduleName: string, platform: string | null) => Resolution | null;
-export type MetroResolver = (context: CustomResolutionContext, moduleName: string, platform: string | null) => Resolution;

package/src/utils.ts

@@ -1,3 +0,0 @@
-export type NotReadOnly<T> = {
-  -readonly [K in keyof T]: T[K];
-};