refactor: remove getQueriesForElement alias

Author: mdjastrzebski

src/__tests__/within.test.tsx

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Text, TextInput, View } from 'react-native';
 
-import { getQueriesForElement, render, within } from '..';
+import { render, within } from '..';
 
 test('within() exposes basic queries', async () => {
   const rootQueries = await render(
@@ -80,6 +80,3 @@ test('within() exposes a11y queries', async () => {
   await expect(secondQueries.findAllByA11yHint('Same Hint')).resolves.toHaveLength(1);
 });
 
-test('getQueriesForElement is alias to within', () => {
-  expect(getQueriesForElement).toBe(within);
-});

src/pure.ts

@@ -4,7 +4,7 @@ export { fireEvent } from './fire-event';
 export { render } from './render';
 export { waitFor } from './wait-for';
 export { waitForElementToBeRemoved } from './wait-for-element-to-be-removed';
-export { within, getQueriesForElement } from './within';
+export { within } from './within';
 
 export { configure, resetToDefaults } from './config';
 export { isHiddenFromAccessibility, isInaccessible } from './helpers/accessibility';

website/docs/14.x/docs/api/misc/other.mdx

@@ -1,14 +1,12 @@
 # Other helpers
 
-## `within`, `getQueriesForElement` {#within}
+## `within` {#within}
 
 ```jsx
 function within(element: HostElement): Queries {}
-
-function getQueriesForElement(element: HostElement): Queries {}
 ```
 
-`within` (also available as `getQueriesForElement` alias) performs [queries](docs/api/queries) scoped to given element.
+`within` performs [queries](docs/api/queries) scoped to given element.
 
 :::note
 Please note that additional `render` specific operations like `rerender`, `unmount`, `debug`, `toJSON` are _not_ included.

website/docs/14.x/docs/migration/v14.mdx

@@ -264,6 +264,34 @@ await rerender(<MyComponent />);
 
 **Note:** This change is included in the step-by-step migration guide for async `render` above.
 
+### `getQueriesForElement` export removed
+
+In v14, the `getQueriesForElement` export alias for `within` has been removed. You must use `within` instead.
+
+**What changed:**
+
+- `getQueriesForElement` is no longer exported from the main package
+- `within` is the only exported function for scoped queries
+- `getQueriesForElement` remains available internally but is not part of the public API
+
+**Migration:**
+
+Replace all `getQueriesForElement` imports and usage with `within`:
+
+```ts
+// Before (v13)
+import { getQueriesForElement } from '@testing-library/react-native';
+
+const queries = getQueriesForElement(element);
+
+// After (v14)
+import { within } from '@testing-library/react-native';
+
+const queries = within(element);
+```
+
+**Note:** `getQueriesForElement` was just an alias for `within`, so the functionality is identical - only the import needs to change.
+
 ### `renderHook` is now async by default
 
 In v14, `renderHook` is now async by default and returns a Promise. This change makes it compatible with React 19, React Suspense, and `React.use()`.