Reset master to testing content

internal/atspi/echo_focus.go

@@ -0,0 +1,69 @@
+// Copyright (c) 2026 Storm Dragon
+// Authors: Storm Dragon, Angus Kola
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+package atspi
+
+// IsEchoEditField requires positive editable metadata. Text roles alone also
+// describe labels and read-only documents; terminals are not edit fields.
+func IsEchoEditField(snapshot Snapshot) bool {
+	return snapshot.Editable && !snapshot.ReadOnly && !snapshot.Defunct &&
+		snapshot.Role != "password text" && snapshot.Role != "terminal"
+}
+
+type echoFocus struct {
+	object, origin, window ObjectID
+	epoch                  uint64
+	editable               bool
+}
+
+// EditFieldFocused reads copied metadata only. The GLib owner publishes it;
+// foreground epochs reject stale focus even before queued events are consumed.
+func (adapter *Adapter) EditFieldFocused() bool {
+	focus := adapter.echoFocus.Load()
+	foreground := adapter.Foreground()
+	return !adapter.secure.Load() && focus != nil && focus.editable &&
+		focus.epoch == foreground.Epoch && (!foreground.Client.Known || foreground.Client.Window != 0)
+}
+
+func (adapter *Adapter) observeEchoFocus(event Event) {
+	if event.ForegroundMismatch || event.Foreground.Epoch != adapter.Foreground().Epoch {
+		return
+	}
+	current := adapter.echoFocus.Load()
+	if event.Type == WindowActivatedEvent && !event.Source.Focused {
+		if current != nil && event.Window != current.window {
+			adapter.echoFocus.Store(nil)
+		}
+		return
+	}
+	gain := event.Type == FocusEvent || event.Type == FocusedStateEvent && event.Detail1 != 0 ||
+		event.Type == WindowActivatedEvent && event.Source.Focused
+	if !gain && (current == nil || current.object != event.Source.ID()) {
+		return
+	}
+	if !event.Source.ID().Valid() {
+		return
+	}
+	origin := NewObjectID(event.Source.BusName, event.OriginPath)
+	if !gain && current != nil {
+		origin = current.origin
+	}
+	adapter.echoFocus.Store(&echoFocus{object: event.Source.ID(), origin: origin,
+		window: event.Window, epoch: event.Foreground.Epoch,
+		editable: IsEchoEditField(event.Source) && event.Source.Focused})
+}
+
+// Retire before filtering focus losses or dead objects out of speech delivery.
+func (adapter *Adapter) retireEchoFocus(kind string, detail int, source ObjectID) {
+	current := adapter.echoFocus.Load()
+	if current == nil {
+		return
+	}
+	matched := source == current.object || source == current.origin || source == current.window
+	if (kind == FocusedStateEvent && detail == 0 || kind == DefunctStateEvent && detail != 0 ||
+		kind == WindowDestroyedEvent || kind == WindowDeactivatedEvent) && matched ||
+		(kind == FocusEvent || kind == FocusedStateEvent && detail != 0) && source.BusName == current.object.BusName {
+		adapter.echoFocus.Store(nil)
+	}
+}