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,17 +137,17 @@ 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.
+          // 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.
           // eslint-disable-next-line react-compiler/react-compiler
           initialFrame.value = {
             x: layout.x,
@@ -164,6 +164,7 @@ 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,