iOS Safari·Android Chrome 가상 키보드 viewport/caret visibility 실기기 trace 수집

[developer-1px]

배경

#17 조사에서 모바일 viewport·가상 키보드·caret visibility는 jsdom/desktop Playwright만으로 닫을 수 없다고 정리했다. visualViewport 기반 정책은 구현할 수 있지만, iOS Safari/Android Chrome/Gboard/WebView의 실제 focus/keyboard/selection/scroll 순서는 별도 trace가 필요하다.

수집할 scenario

• iOS Safari: focus, typing, Enter, composition/update, toolbar command 후 visual viewport/caret rect/scroll 변화.
• Android Chrome + Gboard: long document/list에서 Enter 후 caret이 keyboard 위로 올라오는지.
• Android WebView: same scenario.
• iOS Safari: 16px 미만 focus target이 있을 때 auto-zoom 여부와 현재 editor CSS의 회피 여부.
• URL bar collapse/visualViewport.offsetTop이 non-zero인 상태의 caret reveal.

기록할 evidence

• user agent, device, OS, browser, keyboard.
• window.innerHeight, visualViewport.height, visualViewport.offsetTop, page scroll.
• focused canonical selection, native selection rect, overlay caret rect.
• beforeinput/input/composition/focus/blur/resize/scroll ordering.
• debug recorder raw trace 또는 최소 재현 HTML.

완료 기준

• iOS Safari trace가 저장된다.
• Android Chrome + Gboard trace가 저장된다.
• Android WebView 또는 대체 사유가 기록된다.
• trace 결과가 visualViewport 기반 mobile caret reveal와 viewport debug trace 구현 #77 구현 fixture 또는 보류 근거로 연결된다.

근거

• 모바일 viewport·가상 키보드·scroll/caret visibility 실패 조사 #17
• visualViewport 기반 mobile caret reveal와 viewport debug trace 구현 #77
• [lexical] Bug Fix: keep caret above the on-screen keyboard after Enter facebook/lexical#8486
• [lexical-playground] Fix: Prevent auto-zoom when focusing in the editor in iOS Safari facebook/lexical#8480
• ProseMirror Android write-up

[developer-1px]

현재 agent 환경에서는 이 이슈의 완료 기준을 충족할 수 없습니다.

완료 기준은 iOS Safari, Android Chrome+Gboard, Android WebView의 실제 visualViewport, virtual keyboard, focus/selection/scroll ordering trace 저장을 요구합니다. Desktop Playwright, jsdom, synthetic viewport resize로는 iOS URL bar collapse, OS keyboard reveal, WebView viewport behavior, Gboard composition/scroll ordering을 증명할 수 없습니다.

필요한 다음 입력:

• iOS Safari: focus, typing, Enter, composition/update, toolbar command 후 visualViewport/caret rect/scroll trace
• Android Chrome+Gboard: long document/list에서 Enter 후 caret reveal trace
• Android WebView: same scenario 또는 대체 사유
• iOS Safari auto-zoom: 16px 미만 focus target 여부와 editor CSS 회피 여부
• 각 trace의 user agent/device/OS/browser/keyboard, window.innerHeight, visualViewport.height/offsetTop, scroll, native/canonical selection, caret rect, event ordering

trace가 들어오면 #77 구현 fixture로 승격할지, 보류 근거로 남길지 판단할 수 있습니다.

[developer-1px]

Update after PR #126:

Added this issue to the repo-tracked manual trace collection contract.

• Manifest: tests/fixtures/manual-editor-traces/manifest.json
• Sample convention: tests/fixtures/manual-editor-traces/README.md
• Contract doc: docs/editor-manual-trace-collection.md
• CI guard: packages/editable/manualTraceCorpus.test.ts

Required scenarios now tracked in the manifest:

• ios-keyboard-viewport-caret
• android-keyboard-viewport-caret
• android-webview-keyboard-viewport-caret

Current status: still collecting. This issue should stay open until real mobile traces capture visual/layout viewport changes, caret rects, scroll positions, keyboard state, selection, and the obscured-caret decision.

[developer-1px]

Current environment check:

• No Android device path is available here: adb is not installed/available.
• No iOS device/simulator target was listed through xcrun in this environment.
• Desktop viewport emulation would not prove the required virtual-keyboard visual viewport/caret behavior.

Conclusion: #78 still requires real iOS Safari / Android Chrome / Android WebView viewport-caret traces or user-provided samples matching tests/fixtures/manual-editor-traces/manifest.json.

[developer-1px]

Update after PR #129:

Added a standalone manual trace recorder for this issue:

• Tool: tools/evidence/manual-trace-recorder.html
• Usage doc: tools/evidence/README.md
• Evidence doc: docs/editor-evidence-capture-tools.md

Target fixture paths:

• tests/fixtures/manual-editor-traces/issue-78/ios-keyboard-viewport-caret.json
• tests/fixtures/manual-editor-traces/issue-78/android-keyboard-viewport-caret.json
• tests/fixtures/manual-editor-traces/issue-78/android-webview-keyboard-viewport-caret.json

After capture, add the sample entry to tests/fixtures/manual-editor-traces/manifest.json. Refs PR #129.

[developer-1px]

Update after PR #130:

Added an evidence coverage CLI:

• pnpm run evidence:status prints current evidence coverage.
• pnpm run evidence:check fails until all required clipboard/trace evidence is present.

Current #78 status from the CLI: missing ios-keyboard-viewport-caret, android-keyboard-viewport-caret, and android-webview-keyboard-viewport-caret trace samples.

Refs PR #130.