Module text_input_session 

Platform text-input session: soft-keyboard visibility hooks.

Platforms with an on-screen keyboard (Android, iOS, some Linux shells) install a PlatformTextInputHandler so the framework can tell them when editable text gains or loses focus. The text-field focus manager (crate::text_field_focus) fires these notifications:

• a text field requests the keyboard → notify_text_input_focus_gained → show_keyboard
• focus was explicitly cleared, or the focused field left the composition → notify_text_input_focus_lost → hide_keyboard

Focus requests show the keyboard when the field’s show_keyboard_on_focus option is true. A pointer tap always requests it, including on an already-focused field. The user may have dismissed the keyboard (e.g. Android back gesture) without the framework knowing, and tapping the field again must bring it back. Platform show/hide calls are expected to be idempotent. hide_keyboard is only forwarded when the framework previously requested the keyboard, so repeated stale-focus checks do not spam the platform.

The handler is stored per AppContext, like the focus state itself, so multiple app instances in one process do not observe each other’s keyboards.

Traits

PlatformTextInputHandler

Callbacks a platform installs to control its on-screen keyboard.

Functions

clear_platform_text_input_handler

Removes the installed platform soft-keyboard handler, if any.

notify_app_paused

Notifies the framework that the host app was paused (backgrounded — e.g. Android onPause).

notify_app_resumed

Notifies the framework that the host app resumed (foregrounded — e.g. Android onResume).

set_platform_text_input_handler

Installs the platform soft-keyboard handler for the current app context.