@react-native-harness/runtime 1.1.0 → 1.2.0-rc.1

package/dist/NativeHarness.d.ts

@@ -0,0 +1,41 @@
+import { type TurboModule } from 'react-native';
+/**
+ * Represents the position and dimensions of a view in screen coordinates (points/dp).
+ */
+export interface ViewInfo {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface Spec extends TurboModule {
+    /**
+     * Simulates a native tap at the specified screen coordinates.
+     * Returns a promise that resolves when the tap action is complete.
+     */
+    simulateTap(x: number, y: number): Promise<void>;
+    /**
+     * Finds a view by its testID (accessibilityIdentifier on iOS, tag on Android).
+     * Returns null if no view is found.
+     */
+    queryByTestId(testId: string): ViewInfo | null;
+    /**
+     * Finds all views by testID (accessibilityIdentifier on iOS, tag on Android).
+     * Returns an empty array if no views are found.
+     */
+    queryAllByTestId(testId: string): ViewInfo[];
+    /**
+     * Finds a view by its accessibility label.
+     * Returns null if no view is found.
+     */
+    queryByAccessibilityLabel(label: string): ViewInfo | null;
+    /**
+     * Finds all views by accessibility label.
+     * Returns an empty array if no views are found.
+     */
+    queryAllByAccessibilityLabel(label: string): ViewInfo[];
+}
+export type HarnessModule = Spec;
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeHarness.d.ts.map

package/dist/NativeHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHarness.d.ts","sourceRoot":"","sources":["../src/NativeHarness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,IAAK,SAAQ,WAAW;IAChC;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE/C;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE7C;;;OAGG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE1D;;;OAGG;IACH,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;CACzD;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC;;AAEjC,wBAAiE"}

package/dist/NativeHarness.js

@@ -0,0 +1,2 @@
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('Harness');

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const WS_SERVER_PORT = 3001;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,OAAO,CAAC"}

package/dist/constants.js

@@ -0,0 +1 @@
+export const WS_SERVER_PORT = 3001;

package/dist/expect/context.d.ts

@@ -0,0 +1,20 @@
+type HarnessExpectError = {
+    name?: string;
+    message?: string;
+    stack?: string;
+};
+export type HarnessExpectTestState = {
+    result?: {
+        state: 'pass' | 'fail';
+        errors?: HarnessExpectError[];
+    };
+    promises?: Promise<unknown>[];
+    onFinished?: Array<() => void | Promise<void>>;
+};
+declare global {
+    var HARNESS_EXPECT_TEST_STATE: HarnessExpectTestState | undefined;
+}
+export declare const getCurrentExpectTestState: () => HarnessExpectTestState | undefined;
+export declare const setCurrentExpectTestState: (state: HarnessExpectTestState | undefined) => void;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/expect/context.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,yBAAyB,EAAE,sBAAsB,GAAG,SAAS,CAAC;CACnE;AAED,eAAO,MAAM,yBAAyB,QAClC,sBAAsB,GACtB,SAEH,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,sBAAsB,GAAG,SAAS,KACxC,IAEF,CAAC"}

package/dist/expect/context.js

@@ -0,0 +1,6 @@
+export const getCurrentExpectTestState = () => {
+    return globalThis.HARNESS_EXPECT_TEST_STATE;
+};
+export const setCurrentExpectTestState = (state) => {
+    globalThis.HARNESS_EXPECT_TEST_STATE = state;
+};

package/dist/expect/errors.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessExpectTestState } from './context.js';
+export declare const flushExpectTestState: (state: HarnessExpectTestState) => Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/expect/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/expect/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAgD3D,eAAO,MAAM,oBAAoB,GAC/B,OAAO,sBAAsB,KAC5B,OAAO,CAAC,IAAI,CAyBd,CAAC"}

package/dist/expect/errors.js

@@ -0,0 +1,45 @@
+const formatErrorMessage = (error) => {
+    if (error instanceof Error) {
+        return `${error.name}: ${error.message}`;
+    }
+    if (error && typeof error === 'object') {
+        const maybeError = error;
+        if (maybeError.name || maybeError.message) {
+            return [maybeError.name, maybeError.message].filter(Boolean).join(': ');
+        }
+    }
+    return String(error);
+};
+const createExpectError = (errors, title) => {
+    const message = [title, ...errors.map(formatErrorMessage)]
+        .filter(Boolean)
+        .join('\n\n');
+    const error = new Error(message);
+    const firstError = errors.find((value) => !!value && typeof value === 'object');
+    if (firstError?.name) {
+        error.name = firstError.name;
+    }
+    if (firstError?.stack) {
+        error.stack = firstError.stack.replace(/^([^\n]+)(\n|$)/, `${error.name}: ${message}$2`);
+    }
+    return error;
+};
+export const flushExpectTestState = async (state) => {
+    if (state.promises?.length) {
+        const results = await Promise.allSettled(state.promises);
+        const rejected = results
+            .filter((result) => result.status === 'rejected')
+            .map((result) => result.reason);
+        if (rejected.length > 0) {
+            throw createExpectError(rejected);
+        }
+    }
+    for (const hook of state.onFinished ?? []) {
+        await hook();
+    }
+    const softErrors = state.result?.errors ?? [];
+    if (softErrors.length === 0) {
+        return;
+    }
+    throw createExpectError(softErrors, 'Soft assertion failures:');
+};

package/dist/expect/expect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect/expect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAS5E,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,OAAO,YAAY,CAAC;AAGpB,wBAAgB,YAAY,IAAI,YAAY,CAwF3C;AAED,QAAA,MAAM,YAAY,EAAE,YAA6B,CAAC;AAQlD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,YAAY,IAAI,MAAM,EAAE,CAAC;AAExC,YAAY,EACV,SAAS,EACT,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,QAAQ,GACT,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect/expect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAS5E,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,OAAO,YAAY,CAAC;AAGpB,wBAAgB,YAAY,IAAI,YAAY,CAkG3C;AAED,QAAA,MAAM,YAAY,EAAE,YAA6B,CAAC;AAQlD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,YAAY,IAAI,MAAM,EAAE,CAAC;AAExC,YAAY,EACV,SAAS,EACT,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,QAAQ,GACT,MAAM,gBAAgB,CAAC"}

package/dist/expect/expect.js

@@ -3,13 +3,18 @@
 import { addCustomEqualityTesters, ASYMMETRIC_MATCHERS_OBJECT, customMatchers, getState, GLOBAL_EXPECT, setState, } from '@vitest/expect';
 import * as chai from 'chai';
 // Setup additional matchers
+import { getCurrentExpectTestState } from './context.js';
 import './setup.js';
 import { toMatchImageSnapshot } from './matchers/toMatchImageSnapshot.js';
 export function createExpect() {
     const expect = ((value, message) => {
         const { assertionCalls } = getState(expect);
         setState({ assertionCalls: assertionCalls + 1 }, expect);
-        return chai.expect(value, message);
+        const assertion = chai.expect(value, message);
+        const currentTest = getCurrentExpectTestState();
+        return currentTest && assertion.withTest
+            ? assertion.withTest(currentTest)
+            : assertion;
     });
     Object.assign(expect, chai.expect);
     Object.assign(expect, globalThis[ASYMMETRIC_MATCHERS_OBJECT]);

package/dist/render/queries.d.ts

@@ -0,0 +1,7 @@
+import { HostInstance } from 'react-native';
+export declare const setRoot: (rootInstance: HostInstance) => void;
+declare const queryByTestId: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default | null, queryAllByTestId: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[], getByTestId: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default | null, getAllByTestId: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[], findByTestId: (params: string) => Promise<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>, findAllByTestId: (params: string) => Promise<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[]>;
+declare const queryById: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default | null, queryAllById: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[], getId: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default | null, getAllById: (params: string) => import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[], findById: (params: string) => Promise<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>, findAllById: (params: string) => Promise<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default[]>;
+export { queryByTestId, queryAllByTestId, getByTestId, getAllByTestId, findByTestId, findAllByTestId, };
+export { queryById, queryAllById, getId, getAllById, findById, findAllById };
+//# sourceMappingURL=queries.d.ts.map

package/dist/render/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/render/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,eAAO,MAAM,OAAO,GAAI,cAAc,YAAY,SAEjD,CAAC;AA6IF,QAAA,MACW,aAAa,8HACV,gBAAgB,yHACrB,WAAW,8HACR,cAAc,yHAChB,YAAY,gIACT,eAAe,gIAG3B,CAAC;AACF,QAAA,MACW,SAAS,8HACN,YAAY,yHACjB,KAAK,8HACF,UAAU,yHACZ,QAAQ,gIACL,WAAW,gIAC+B,CAAC;AAExD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/dist/render/queries.js

@@ -0,0 +1,99 @@
+// import { store } from '../ui/state.js';
+import { waitUntil } from '../waitFor.js';
+let root = null;
+export const setRoot = (rootInstance) => {
+    root = rootInstance;
+};
+const getRoot = () => {
+    const container = root;
+    if (!container) {
+        throw new Error('You need to render a component first!');
+    }
+    const ownerDocument = container.ownerDocument;
+    if (!ownerDocument) {
+        throw new Error('This feature is supported in React Native 0.82 and later!');
+    }
+    return ownerDocument.getRootNode();
+};
+const findNodeByPredicate = (predicate) => {
+    const queue = [getRoot()];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        if (predicate(node)) {
+            return node;
+        }
+        for (const child of node.children) {
+            queue.push(child);
+        }
+    }
+    return null;
+};
+const findNodesByPredicate = (predicate) => {
+    const nodes = [];
+    const queue = [getRoot()];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        if (predicate(node)) {
+            nodes.push(node);
+        }
+        for (const child of node.children) {
+            queue.push(child);
+        }
+    }
+    return nodes;
+};
+const getFiberOfHostInstance = (hostInstance) => {
+    // This should be considered as 'reaching into the implementation details' of React Native.
+    // Not perfect, but it's the only way to get the props of the host instance.
+    return (hostInstance
+        .__internalInstanceHandle || null);
+};
+const getPropsOfHostInstance = (hostInstance) => {
+    return getFiberOfHostInstance(hostInstance)?.memoizedProps || {};
+};
+const findBy = (predicate, options) => {
+    return waitUntil(() => findNodeByPredicate(predicate), options);
+};
+const findAllBy = (predicate, options) => {
+    return waitUntil(() => {
+        const nodes = findNodesByPredicate(predicate);
+        if (nodes.length === 0) {
+            return null;
+        }
+        return nodes;
+    }, options);
+};
+const queryBy = (predicate) => {
+    return findNodeByPredicate(predicate);
+};
+const queryAllBy = (predicate) => {
+    return findNodesByPredicate(predicate);
+};
+const getBy = (predicate) => {
+    const node = queryBy(predicate);
+    if (!node) {
+        throw new Error(`No node found with predicate ${predicate}`);
+    }
+    return node;
+};
+const getAllBy = (predicate) => {
+    const nodes = queryAllBy(predicate);
+    if (nodes.length === 0) {
+        throw new Error(`No nodes found with predicate ${predicate}`);
+    }
+    return nodes;
+};
+const createQueries = (predicate) => {
+    return {
+        findBy: (params) => findBy((node) => predicate(node, params)),
+        findAllBy: (params) => findAllBy((node) => predicate(node, params)),
+        queryBy: (params) => queryBy((node) => predicate(node, params)),
+        queryAllBy: (params) => queryAllBy((node) => predicate(node, params)),
+        getBy: (params) => getBy((node) => predicate(node, params)),
+        getAllBy: (params) => getAllBy((node) => predicate(node, params)),
+    };
+};
+const { queryBy: queryByTestId, queryAllBy: queryAllByTestId, getBy: getByTestId, getAllBy: getAllByTestId, findBy: findByTestId, findAllBy: findAllByTestId, } = createQueries((node, testId) => getPropsOfHostInstance(node).testID === testId);
+const { queryBy: queryById, queryAllBy: queryAllById, getBy: getId, getAllBy: getAllById, findBy: findById, findAllBy: findAllById, } = createQueries((node, id) => node.id === id);
+export { queryByTestId, queryAllByTestId, getByTestId, getAllByTestId, findByTestId, findAllByTestId, };
+export { queryById, queryAllById, getId, getAllById, findById, findAllById };

package/dist/runHarnessTestsInModule.d.ts

@@ -0,0 +1,9 @@
+import type { TestSuiteResult } from '@react-native-harness/bridge';
+/**
+ * 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 declare const runHarnessTestsInModule: (loader: () => unknown) => Promise<TestSuiteResult>;
+//# sourceMappingURL=runHarnessTestsInModule.d.ts.map

package/dist/runHarnessTestsInModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runHarnessTestsInModule.d.ts","sourceRoot":"","sources":["../src/runHarnessTestsInModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,8BAA8B,CAAC;AAoCtC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,OAAO,KACpB,OAAO,CAAC,eAAe,CAuBzB,CAAC"}

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/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;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"}
+{"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;AAQtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,iBAAiB,EAAE,MAAM,CAAC;CAC/B;AA+HD,eAAO,MAAM,QAAQ,GACnB,OAAO,SAAS,EAChB,SAAS,iBAAiB,KACzB,OAAO,CAAC,eAAe,CAoIzB,CAAC"}

package/dist/runner/runSuite.js

@@ -1,3 +1,5 @@
+import { setCurrentExpectTestState, } from '../expect/context.js';
+import { flushExpectTestState } from '../expect/errors.js';
 import { runHooks } from './hooks.js';
 import { getTestExecutionError } from './errors.js';
 const runTest = async (test, suite, context) => {
@@ -45,12 +47,20 @@ const runTest = async (test, suite, context) => {
             });
             return result;
         }
-        // Run all beforeEach hooks from the current suite and its parents
-        await runHooks(suite, 'beforeEach');
-        // Run the actual test
-        await test.fn();
-        // Run all afterEach hooks from the current suite and its parents
-        await runHooks(suite, 'afterEach');
+        const expectTestState = {};
+        setCurrentExpectTestState(expectTestState);
+        try {
+            // Run all beforeEach hooks from the current suite and its parents
+            await runHooks(suite, 'beforeEach');
+            // Run the actual test
+            await test.fn();
+            // Run all afterEach hooks from the current suite and its parents
+            await runHooks(suite, 'afterEach');
+            await flushExpectTestState(expectTestState);
+        }
+        finally {
+            setCurrentExpectTestState(undefined);
+        }
         const duration = Date.now() - startTime;
         const result = {
             name: test.name,

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();