Skip to content

docs(events): document the delivery channel for browser view events - #5

Open
Klo1337 wants to merge 1 commit into
mafia2online:mainfrom
Klo1337:docs/browser-view-events
Open

docs(events): document the delivery channel for browser view events#5
Klo1337 wants to merge 1 commit into
mafia2online:mainfrom
Klo1337:docs/browser-view-events

Conversation

@Klo1337

@Klo1337 Klo1337 commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

The client contract declares the Browser*Event payload interfaces (BrowserInputFocusChangeEvent, BrowserCursorChangeEvent, …), but they are not in EventMap and Web.on does not receive them, so the reference gives no way to find out how to subscribe.

Verified on a live server (build 1.0.0-3a40a8f): they are dispatched to the shared Events.on table under camelCase names derived from the payload interface (browserInputFocusChange, browserCursorChange), with the payload object as a single argument; a parallel Web.on(viewId, ...) subscription with the same names never fires.

This adds a short section to the events guide documenting the channel, the viewId filtering caveat, and the main practical use (browserInputFocusChange as the reliable hotkey gate while typing into CEF).

If the intended design is different (e.g. these belong in EventMap), happy to rework the wording.

The client contract declares Browser*Event payloads, but they are absent
from EventMap and Web.on does not receive them, so there is no way to
discover the delivery channel from the reference. Verified on a live
server: they arrive in the shared Events.on table under camelCase names
(browserInputFocusChange, browserCursorChange, ...) with the payload as a
single argument. Documents that, with the viewId filtering caveat and the
input-focus use case.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant