@react-native-harness/runtime 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/runHarnessTestsInModule.js

@@ -0,0 +1,57 @@
+import { collectTests } from './collector/functions.js';
+import { runSuite } from './runner/runSuite.js';
+import { getEmitter } from './utils/emitter.js';
+const metroRequire = global.__r;
+/**
+ * Patches the require function to clear the module cache for the first module that's going to be required after patching.
+ * @returns A function to unpatch the require function.
+ */
+const patchRequire = () => {
+    let wasRootModuleRequired = false;
+    global.__r = (moduleId) => {
+        if (!wasRootModuleRequired) {
+            // The first module that's going to be required after patching will be the module with tests.
+            // We need to clear the module cache for this module, so it ends up re-evaluated. 
+            const module = metroRequire.getModules().get(moduleId);
+            if (module) {
+                module.hasError = false;
+                module.error = undefined;
+                module.isInitialized = false;
+            }
+        }
+        wasRootModuleRequired = true;
+        return metroRequire(moduleId);
+    };
+    return () => {
+        global.__r = metroRequire;
+    };
+};
+/**
+ * Runs tests from a specific module programmatically and returns the results.
+ *
+ * @param moduleId The require.resolveWeak call to the module, returning the module ID
+ * @returns The result of the test suite execution
+ */
+export const runHarnessTestsInModule = async (loader) => {
+    // 1. Collect tests by executing the loader
+    // This expects the loader to call describe/it/test functions which register to the global collector
+    const { testSuite } = await collectTests(async () => {
+        const unpatchRequire = patchRequire();
+        try {
+            await loader();
+        }
+        finally {
+            unpatchRequire();
+        }
+    });
+    // 2. Prepare the runner context
+    // We use a local emitter as we are not reporting to the CLI bridge,
+    // but the runner internals expect an emitter.
+    const events = getEmitter();
+    const context = {
+        events,
+        testFilePath: 'unknown',
+    };
+    // 3. Run the collected suite
+    return runSuite(testSuite, context);
+};

package/dist/runner/context.d.ts

@@ -0,0 +1,10 @@
+export type HarnessContext = {
+    testFilePath: string;
+    runner: string;
+};
+declare global {
+    var HARNESS_CONTEXT: HarnessContext;
+}
+export declare const getHarnessContext: () => HarnessContext;
+export declare const setHarnessContext: (context: HarnessContext) => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/runner/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runner/context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,eAAe,EAAE,cAAc,CAAC;CACrC;AAED,eAAO,MAAM,iBAAiB,QAAO,cAEpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,cAAc,KAAG,IAE3D,CAAC"}

package/dist/runner/context.js

@@ -0,0 +1,6 @@
+export const getHarnessContext = () => {
+    return globalThis['HARNESS_CONTEXT'];
+};
+export const setHarnessContext = (context) => {
+    globalThis['HARNESS_CONTEXT'] = context;
+};

package/dist/runner/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/runner/factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa,QAAO,UAsBhC,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/runner/factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,eAAO,MAAM,aAAa,QAAO,UA2BhC,CAAC"}

package/dist/runner/factory.js

@@ -1,10 +1,15 @@
 import { getEmitter } from '../utils/emitter.js';
 import { runSuite } from './runSuite.js';
+import { setHarnessContext } from './context.js';
 export const getTestRunner = () => {
     const events = getEmitter();
     return {
         events,
-        run: async (testSuite, testFilePath) => {
+        run: async ({ testSuite, testFilePath, runner }) => {
+            setHarnessContext({
+                testFilePath,
+                runner,
+            });
             const result = await runSuite(testSuite, {
                 events,
                 testFilePath,

package/dist/runner/index.d.ts

@@ -1,4 +1,5 @@
 export type { TestRunnerEventsEmitter, TestRunner, TestRunnerContext, } from './types.js';
 export { TestExecutionError } from './errors.js';
 export { getTestRunner } from './factory.js';
+export { getHarnessContext, setHarnessContext, type HarnessContext, } from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}

package/dist/runner/index.js

@@ -1,2 +1,3 @@
 export { TestExecutionError } from './errors.js';
 export { getTestRunner } from './factory.js';
+export { getHarnessContext, setHarnessContext, } from './context.js';

package/dist/runner/runSuite.d.ts

@@ -1,4 +1,7 @@
 import type { TestSuite, TestSuiteResult } from '@react-native-harness/bridge';
 import { TestRunnerContext } from './types.js';
+declare global {
+    var HARNESS_TEST_PATH: string;
+}
 export declare const runSuite: (suite: TestSuite, context: TestRunnerContext) => Promise<TestSuiteResult>;
 //# sourceMappingURL=runSuite.d.ts.map

package/dist/runner/runSuite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runSuite.d.ts","sourceRoot":"","sources":["../../src/runner/runSuite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EACT,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsH/C,eAAO,MAAM,QAAQ,GACnB,OAAO,SAAS,EAChB,SAAS,iBAAiB,KACzB,OAAO,CAAC,eAAe,CAoIzB,CAAC"}
+{"version":3,"file":"runSuite.d.ts","sourceRoot":"","sources":["../../src/runner/runSuite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EACT,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,iBAAiB,EAAE,MAAM,CAAC;CAC/B;AAsHD,eAAO,MAAM,QAAQ,GACnB,OAAO,SAAS,EAChB,SAAS,iBAAiB,KACzB,OAAO,CAAC,eAAe,CAoIzB,CAAC"}

package/dist/runner/types.d.ts

@@ -5,9 +5,14 @@ export type TestRunnerContext = {
     events: TestRunnerEventsEmitter;
     testFilePath: string;
 };
+export type RunTestsOptions = {
+    testSuite: TestSuite;
+    testFilePath: string;
+    runner: string;
+};
 export type TestRunner = {
     events: TestRunnerEventsEmitter;
-    run: (testSuite: TestSuite, testFilePath: string) => Promise<TestSuiteResult>;
+    run: (options: RunTestsOptions) => Promise<TestSuiteResult>;
     dispose: () => void;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,uBAAuB,CAAC;IAChC,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9E,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,uBAAuB,CAAC;IAChC,GAAG,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC"}

package/dist/screen/index.d.ts

@@ -0,0 +1,50 @@
+import { type ViewInfo } from '../NativeHarness.js';
+/**
+ * Represents an element found on screen with its position and dimensions.
+ * This can be used with userEvent.tap() to interact with the element.
+ */
+export type ElementReference = ViewInfo;
+export type Screen = {
+    /**
+     * Finds an element by its testID (accessibilityIdentifier on iOS, tag on Android).
+     * @throws Error if no element is found with the given testID.
+     */
+    findByTestId: (testId: string) => ElementReference;
+    /**
+     * Finds all elements by testID (accessibilityIdentifier on iOS, tag on Android).
+     * @throws Error if no elements are found with the given testID.
+     */
+    findAllByTestId: (testId: string) => ElementReference[];
+    /**
+     * Queries for an element by its testID without throwing.
+     * Returns null if no element is found.
+     */
+    queryByTestId: (testId: string) => ElementReference | null;
+    /**
+     * Queries for all elements by testID without throwing.
+     * Returns an empty array if no elements are found.
+     */
+    queryAllByTestId: (testId: string) => ElementReference[];
+    /**
+     * Finds an element by its accessibility label.
+     * @throws Error if no element is found with the given label.
+     */
+    findByAccessibilityLabel: (label: string) => ElementReference;
+    /**
+     * Finds all elements by accessibility label.
+     * @throws Error if no elements are found with the given label.
+     */
+    findAllByAccessibilityLabel: (label: string) => ElementReference[];
+    /**
+     * Queries for an element by its accessibility label without throwing.
+     * Returns null if no element is found.
+     */
+    queryByAccessibilityLabel: (label: string) => ElementReference | null;
+    /**
+     * Queries for all elements by accessibility label without throwing.
+     * Returns an empty array if no elements are found.
+     */
+    queryAllByAccessibilityLabel: (label: string) => ElementReference[];
+};
+export declare const screen: Screen;
+//# sourceMappingURL=index.d.ts.map

package/dist/screen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/screen/index.ts"],"names":[],"mappings":"AAAA,OAAsB,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC,MAAM,MAAM,MAAM,GAAG;IACnB;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAEnD;;;OAGG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IAExD;;;OAGG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAAC;IAE3D;;;OAGG;IACH,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IAEzD;;;OAGG;IACH,wBAAwB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAE9D;;;OAGG;IACH,2BAA2B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IAEnE;;;OAGG;IACH,yBAAyB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAAC;IAEtE;;;OAGG;IACH,4BAA4B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;CACrE,CAAC;AA0DF,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/screen/index.js

@@ -0,0 +1,46 @@
+import NativeHarness from '../NativeHarness.js';
+const createScreen = () => {
+    return {
+        findByTestId: (testId) => {
+            const result = NativeHarness.queryByTestId(testId);
+            if (!result) {
+                throw new Error(`Unable to find element with testID: ${testId}`);
+            }
+            return result;
+        },
+        findAllByTestId: (testId) => {
+            const results = NativeHarness.queryAllByTestId(testId);
+            if (results.length === 0) {
+                throw new Error(`Unable to find any elements with testID: ${testId}`);
+            }
+            return results;
+        },
+        queryByTestId: (testId) => {
+            return NativeHarness.queryByTestId(testId);
+        },
+        queryAllByTestId: (testId) => {
+            return NativeHarness.queryAllByTestId(testId);
+        },
+        findByAccessibilityLabel: (label) => {
+            const result = NativeHarness.queryByAccessibilityLabel(label);
+            if (!result) {
+                throw new Error(`Unable to find element with accessibility label: ${label}`);
+            }
+            return result;
+        },
+        findAllByAccessibilityLabel: (label) => {
+            const results = NativeHarness.queryAllByAccessibilityLabel(label);
+            if (results.length === 0) {
+                throw new Error(`Unable to find any elements with accessibility label: ${label}`);
+            }
+            return results;
+        },
+        queryByAccessibilityLabel: (label) => {
+            return NativeHarness.queryByAccessibilityLabel(label);
+        },
+        queryAllByAccessibilityLabel: (label) => {
+            return NativeHarness.queryAllByAccessibilityLabel(label);
+        },
+    };
+};
+export const screen = createScreen();