portal

type OpenOptions struct {
	// WantScreenCast, when true, also negotiates ScreenCast.SelectSources
	// on the same session handle, which is what gives
	// NotifyPointerMotionAbsolute a coordinate space (Session.Streams).
	// When false, only RemoteDesktop devices are selected: relative
	// pointer motion and keyboard events work, but absolute positioning
	// does not (there is no stream to address).
	WantScreenCast bool

	// RemoteDesktopRestoreToken/ScreenCastRestoreToken, when non-empty,
	// are passed back to the portal so a previously-granted consent can be
	// restored without a fresh prompt (W3). A rejected/expired token
	// degrades to a fresh consent prompt automatically: see Open.
	RemoteDesktopRestoreToken string
	ScreenCastRestoreToken    string

	// ConsentTimeout overrides ConsentTimeout when non-zero.
	ConsentTimeout time.Duration
}

type RequestCaller interface {
	// Request invokes path's iface.method(args...), which per the XDG
	// portal convention must return an org.freedesktop.portal.Request
	// object path, and waits (bounded by ctx) for that Request's Response
	// signal, returning its response code and results.
	Request(ctx context.Context, path dbus.ObjectPath, iface, method string, args ...interface{}) (code uint32, results map[string]dbus.Variant, err error)
	// Call invokes a plain (non-Request) D-Bus method on path and returns
	// its raw reply body.
	Call(ctx context.Context, path dbus.ObjectPath, iface, method string, args ...interface{}) ([]interface{}, error)
	// Close releases the underlying D-Bus connection.
	Close() error
}

type Session struct {
	Streams []Stream

	// RemoteDesktopRestoreToken/ScreenCastRestoreToken are the restore
	// tokens the portal returned from this Start call, when persist_mode
	// was honoured. Empty when the compositor does not support restore
	// tokens or none was granted.
	RemoteDesktopRestoreToken string
	ScreenCastRestoreToken    string
	// contains filtered or unexported fields
}

type Stream struct {
	NodeID uint32
	X, Y   int
	W, H   int
}