document-session-api 0.1.2

Engine-facing document contracts: retained session traits, the accessibility projection, document capabilities, page capture, and the engine-id namespace. The half of inker an engine implements.
Documentation

Document session API

Renderer-free contracts implemented by retained Genet document engines and consumed by Inker/Pelt and Webcue. These types do not own windows, GPU devices, layout, resource loading or host placement.

DocumentSession::text_input_state() observes a focused writable native text control against current completed layout. None revokes the observation when there is no eligible editor or its layout is unavailable. Observing must not perform layout. Producers refresh after frame preparation and clear on edits, hide, viewport changes, blur, replacement and retirement as applicable.

SessionTextInputState carries input hints, password/multiline flags, UTF-16 selection offsets and a SessionTextInputRect. Coordinates are in the session's logical viewport after page zoom and scroll. The host adds window placement and applies device scale once. Field values, password values and document identities are not part of this observation. Preedit selection uses the independent UTF-8 byte offsets specified by SessionIme.

DocumentSession::selected_text() returns the plain text a host Copy or Cut should take: a focused text control's non-collapsed selection, else the retained document range. Password controls never answer, and None means nothing is selected or the session retains no selection. It is a deliberate host read, unlike the per-frame observation above, and must not perform layout.

Webcue reexports these types as TextInputState and LogicalRect, and publishes changed observations as ordered, scope-bound Event::TextInput messages. A session that does not support this observation retains the default None.