[ismaelsousa]

No more guessing the Preview’s upright resolution

The existing currentResolution describes the Preview stream in its native, unrotated orientation. To align UI with the image users actually see, apps have had to infer its upright size and keep resolution and rotation in sync themselves.

This PR adds onPreviewResolution to <Camera />. It reports upright stream dimensions directly as the Preview configuration changes:

<Camera
  resizeMode="contain"
  onPreviewResolution={({ width, height }) => {
    setPreviewAspectRatio(width / height)
  }}
/>

Android	iOS
upright-res-android-1.mov	upright-reso.mp4
PiP-android-1.mov	PiP.mp4
adaptative-controls.mp4	adapative-controls-android-2.mov

Same Preview, same resize mode. Using its reported upright ratio moves the frame and controls into alignment with the visible image.

Why it matters

• Controls and overlays can follow the image, rather than a guessed frame or the black bars created by contain.
• Responsive layouts and picture-in-picture can preserve the Preview’s upright aspect ratio through orientation changes.
• Apps can define the correct touch area and avoid sending tap-to-focus requests from letterboxed regions. Such requests can fail on affected devices. This PR enables that boundary; it does not automatically filter taps.

Guessed	Using onPreviewResolution

What changed

• <Camera onPreviewResolution> provides upright dimensions for the common layout use case.
• <Camera onPreviewConfigurationChanged> exposes the complete configuration when needed.
• Lower-level users can read CameraPreviewOutput.currentConfiguration or subscribe through onConfigurationChanged. Its resolution remains in native, unrotated pixels alongside rotationDegrees.
• Android tracks Preview configuration as interface orientation changes; iOS observes connection and stream-format changes.
• Preview Lab demonstrates upright dimensions, adaptive controls, and picture-in-picture. Nitro-generated bindings are included in the diff.

Compatibility

Android is supported. On iOS, upright resolution requires iOS 17.0+; onPreviewResolution is not called on earlier versions.

Fixes #4236

[vercel]

@ismaelsousa is attempting to deploy a commit to the Margelo Team on Vercel.

A member of the Team first needs to authorize it.

[ismaelsousa]

Adding tests to cover the new feature