@react-native-harness/runtime 1.1.0-rc.2 → 1.1.0-rc.3

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/client/getWSServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWSServer.d.ts","sourceRoot":"","sources":["../../src/client/getWSServer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,QAAO,MAM9B,CAAC"}
+{"version":3,"file":"getWSServer.d.ts","sourceRoot":"","sources":["../../src/client/getWSServer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,QAAO,MAK9B,CAAC"}

package/dist/client/getWSServer.js

@@ -1,8 +1,7 @@
+import { HARNESS_BRIDGE_PATH } from '@react-native-harness/bridge';
 import { getDevServerUrl } from '../utils/dev-server.js';
-import { WS_SERVER_PORT } from '../constants.js';
 export const getWSServer = () => {
-    const devServerUrl = getDevServerUrl();
-    const hostname = devServerUrl.split('://')[1].split(':')[0];
-    const port = global.RN_HARNESS?.webSocketPort || WS_SERVER_PORT;
-    return `ws://${hostname}:${port}`;
+    const devServerUrl = new URL(getDevServerUrl());
+    const protocol = devServerUrl.protocol === 'https:' ? 'wss:' : 'ws:';
+    return `${protocol}//${devServerUrl.host}${HARNESS_BRIDGE_PATH}`;
 };

package/dist/globals.d.ts

@@ -1,7 +1,6 @@
 import type { ImageSnapshotOptions } from '@react-native-harness/bridge';
 export type HarnessGlobal = {
     appRegistryComponentName: string;
-    webSocketPort?: number;
     disableViewFlattening?: boolean;
 };
 declare global {

package/dist/globals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,UAAU,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,QAAQ;QAChB;;;WAGG;QACH,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpE;CACF;AAED,eAAO,MAAM,gBAAgB,QAAO,aAQnC,CAAC"}
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,UAAU,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,QAAQ;QAChB;;;WAGG;QACH,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpE;CACF;AAED,eAAO,MAAM,gBAAgB,QAAO,aAQnC,CAAC"}

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