feat: real key-event typing in send_keys/type

[4EYES44]

feat: real key-event typing in send_keys/type

Summary

Element.send_keys (and therefore Driver.type) now dispatches real CDP key events — keyDown + keyUp per character with correct code, key, windowsVirtualKeyCode, and Shift-wrapping for shifted characters — instead of a single synthetic char event per character. Characters without a physical key (emoji, non-Latin scripts, IME input) fall back to Input.insertText. The public API is unchanged.

Problem

The previous send_keys implemented typing as one Input.dispatchKeyEvent("char", text=char) per character. That synthetic event:

• Carries no code / windowsVirtualKeyCode, so pages that read event.code or event.keyCode see empty/zero values.
• Does not produce a keydown/keyup pair, so listeners on those events (very common — captchas, masked inputs, JS frameworks, "press Enter to submit") never fire.
• Breaks bypass_insecure_connection_warning(), which relies on typing thisisunsafe into Chrome's SSL interstitial — the interstitial listens for real key events and ignores char-only dispatch.

Solution

New botasaurus_driver/core/keys.py centralizes key-event dispatch:

• KEYBOARD_LAYOUT / SHIFT_CHARS / VK_CODES maps resolve each character to its physical-key code, Windows VK code, and whether Shift is required.
• resolve_key(char) → key info, or None for unmapped characters.
• dispatch_key(tab, char) emits the rawKeyDown-Shift (if needed) → keyDown-with-text → keyUp → Shift-keyUp sequence with faithful unmodified_text/text.
• type_text(tab, text) walks the string, routing unmapped chars to Input.insertText, and collapsing \r\n to a single Enter.

Element.send_keys now calls keys.type_text(self._tab, text).

Behavior

• Mapped printable chars (ASCII + common Latin) → real keydown/keyup with correct code/keyCode, Shift held for capitals and symbols.
• \n, \r, and \r\n → one Enter (NumpadEnter/Enter code, VK 13); CRLF counts as a single Enter.
• \t → Tab.
• Unmapped chars (e.g. 你好, 👋, IME output) → Input.insertText(char), the standard CDP primitive for non-keypress text insertion — no fabricated VK codes.
• bypass_insecure_connection_warning() works again because thisisunsafe now produces real key events the interstitial accepts.

Testing

demo_typing.py is a self-contained gate script (no external deps beyond the driver) that launches a browser against a local HTML harness page which captures every keyboard event, then asserts:

1. keydown/keypress/keyup ordering and count for "ab".
2. code is never empty for any mapped printable character.
3. keyCode fidelity for a sample of letters/digits/symbols (matches VK_CODES).
4. Shift state: capitals and shifted symbols arrive with Shift modifier, lowercase without; Shift is pressed before and released after the key.
5. Newline contract: \n, \r, and \r\n each produce exactly one Enter.
6. Unicode round-trip: 你好 👋 reaches the input via insertText and the final .value matches.
7. Final input value equals the typed text for a mixed string.
8. bypass_insecure_connection_warning() succeeds against a bad-SSL page.

Run with: python demo_typing.py (exits non-zero on any failure).

Compatibility

• No public API change: driver.type(selector, text) and element.send_keys(text) signatures and behavior from the caller's perspective are identical.
• No new dependencies; uses the existing cdp.input_ primitives already imported by the driver.
• Pure additive change to event fidelity; existing scripts that worked before continue to work, and scripts that previously failed on keydown-listening pages now work.

Out of scope

• Human-like typing cadence (Gaussian timing, word-boundary pauses, fatigue) — intentionally not included here; this PR is about event fidelity, not timing. A separate follow-up can add cadence behind an opt-in.
• Mouse / scroll humanization — unrelated.
• Public type_human API — not introduced; send_keys is fixed in place per the "fix the existing API" approach.

Files

• botasaurus_driver/core/keys.py (new, 124 lines) — key maps + dispatch.
• botasaurus_driver/core/element.py (+2/-3) — send_keys calls keys.type_text.
• demo_typing.py (new, 386 lines) — gate script.
• README.md (+7) — short note next to the type example.