chore: split and improve onLayoutWorklet comments

Split the single block comment into two focused comments — one per
branch — so readers understand each path independently. Add ref
safety comment on measureInWindow call. Remove debug console.log.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: thomasvo

src/components/KeyboardAvoidingView/index.tsx

@@ -137,24 +137,18 @@ const KeyboardAvoidingView = forwardRef<
           initialFrame.value === null ||
           behavior !== "height"
         ) {
+          // When the keyboard is open in height mode, storing the shrunk
+          // frame would cause a feedback loop (resize → recalculate →
+          // resize), so that case falls through to the else-if below.
           // eslint-disable-next-line react-compiler/react-compiler
           initialFrame.value = layout;
         } else if (automaticOffset) {
-          // The if-branch above skips layout updates in height mode while
-          // the keyboard is open to prevent a feedback loop (shrunk height
-          // stored → animatedStyle recalculates → view resizes → repeat).
-          // But automaticOffset uses measureInWindow which can return stale
-          // y=0 during modal animation — the corrected y arrives on the
-          // next onLayout (when the view resizes for the keyboard) and
-          // would be dropped without this branch. So accept position
-          // updates but keep the original height.
-          // eslint-disable-next-line react-compiler/react-compiler
-          initialFrame.value = {
-            x: layout.x,
-            y: layout.y,
-            width: layout.width,
-            height: initialFrame.value.height,
-          };
+          // automaticOffset uses measureInWindow, which may return stale
+          // y=0 during modal animation. The corrected y arrives on a
+          // later onLayout that falls through here. Accept the corrected
+          // position but preserve the original height to avoid the same
+          // feedback loop.
+          initialFrame.value = { ...layout, height: initialFrame.value.height };
         }
       },
       [behavior, automaticOffset],
@@ -164,13 +158,9 @@ const KeyboardAvoidingView = forwardRef<
         const layout = e.nativeEvent.layout;
 
         if (automaticOffset) {
+          // ref is always set here — onLayout only fires after mount
           internalRef.current?.measureInWindow((x, y) => {
-            runOnUI(onLayoutWorklet)({
-              x,
-              y,
-              width: layout.width,
-              height: layout.height,
-            });
+            runOnUI(onLayoutWorklet)({ ...layout, x, y });
           });
         } else {
           runOnUI(onLayoutWorklet)(layout);