Add useScreenDimensions hook

[ahmedawaad1804]

Summary:

Add useScreenDimensions, a screen equivalent of useWindowDimensions.

Components that need screen metrics currently have to read Dimensions.get('screen') and manage a change subscription manually. This hook returns width, height, scale, and fontScale, updates when those metrics change, and removes its subscription on unmount.

One motivating use case is drawer sizing on iPhone Duo, where a component may need screen dimensions rather than the current application window dimensions.

Includes public exports, TypeScript declarations, the generated API snapshot, and tests.

Changelog:

[GENERAL] [ADDED] - Add useScreenDimensions hook for automatically updating screen metrics in React components.

Test Plan:

Passed:

• yarn test packages/react-native/Libraries/Utilities/__tests__/useScreenDimensions-test.js --runInBand — all 8 tests passed.
• yarn build-types — regenerated TypeScript declarations and the public API snapshot.
• yarn test-generated-typescript
• yarn test-typescript-legacy
• yarn flow-check — no errors.
• ESLint and Prettier checks on all changed source files.
• git diff --check

Tests cover initial screen metrics, changes to each metric, ignoring window-only changes, updates between render and subscription, and subscription cleanup on unmount.

Native device behavior, including drawer sizing on iPhone Duo.

[meta-cla]

Hi @ahmedawaad1804!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

[github-actions]

Warning

JavaScript API change detected

This PR commits an update to ReactNativeApi.d.ts, indicating a change to React Native's public JavaScript API.

• Please include a clear changelog message.
• This change will be subject to additional review.

This change was flagged as: POTENTIALLY_NON_BREAKING

[meta-cla]

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

[Abbondanzo]

A quick nit--can you switch to using useSyncExternalStore instead? That should handle the tearing that you had set up in the hook body